11# SOME DESCRIPTIVE TITLE.
2- # Copyright (C) 2001-2024 , Python Software Foundation
2+ # Copyright (C) 2001-2025 , Python Software Foundation
33# This file is distributed under the same license as the Python package.
44# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
55#
66# Translators:
7- # Rafael Fontenelle <rffontenelle@gmail.com>,2024
7+ # Rafael Fontenelle <rffontenelle@gmail.com>,2025
88#
99#, fuzzy
1010msgid ""
1111msgstr ""
1212"Project-Id-Version :Python 3.12\n "
1313"Report-Msgid-Bugs-To :\n "
14- "POT-Creation-Date :2024-08-16 14:48 +0000\n "
14+ "POT-Creation-Date :2025-03-21 14:55 +0000\n "
1515"PO-Revision-Date :2024-05-11 00:32+0000\n "
16- "Last-Translator :Rafael Fontenelle <rffontenelle@gmail.com>,2024 \n "
16+ "Last-Translator :Rafael Fontenelle <rffontenelle@gmail.com>,2025 \n "
1717"Language-Team :Chinese (China) (https://app.transifex.com/python-doc/teams/5390/zh_CN/)\n "
1818"MIME-Version :1.0\n "
1919"Content-Type :text/plain; charset=UTF-8\n "
@@ -166,7 +166,7 @@ msgid ""
166166"retrieved from the resulting value using :c:func:`PyLong_AsVoidPtr`."
167167msgstr "从指针 *p* 创建一个 Python 整数。可以使用 :c:func:`PyLong_AsVoidPtr` 返回的指针值。"
168168
169- #: ../../c-api/long.rst:123 ../../c-api/long.rst:141
169+ #: ../../c-api/long.rst:123 ../../c-api/long.rst:151
170170msgid ""
171171"Return a C :c:expr:`long` representation of *obj*. If *obj* is not an "
172172"instance of :c:type:`PyLongObject`, first call its :meth:`~object.__index__`"
@@ -181,23 +181,36 @@ msgid ""
181181":c:expr:`long`."
182182msgstr "如果 *obj* 的值超出了 :c:expr:`long` 的取值范围则会引发 :exc:`OverflowError`。"
183183
184- #: ../../c-api/long.rst:130 ../../c-api/long.rst:150 ../../c-api/long.rst:171
185- #: ../../c-api/long.rst:191 ../../c-api/long.rst:214
184+ #: ../../c-api/long.rst:130 ../../c-api/long.rst:160 ../../c-api/long.rst:181
185+ #: ../../c-api/long.rst:201 ../../c-api/long.rst:224
186186msgid ""
187187"Returns ``-1`` on error. Use :c:func:`PyErr_Occurred` to disambiguate."
188188msgstr "出错则返回 ``-1`` 。请用 :c:func:`PyErr_Occurred` 找出具体问题。"
189189
190- #: ../../c-api/long.rst:132 ../../c-api/long.rst:152 ../../c-api/long.rst:173
191- #: ../../c-api/long.rst:195 ../../c-api/long.rst:279 ../../c-api/long.rst:299
190+ #: ../../c-api/long.rst:132 ../../c-api/long.rst:162 ../../c-api/long.rst:183
191+ #: ../../c-api/long.rst:205 ../../c-api/long.rst:289 ../../c-api/long.rst:309
192192msgid "Use :meth:`~object.__index__` if available."
193193msgstr "如果可能将使用 :meth:`~object.__index__`。"
194194
195- #: ../../c-api/long.rst:135 ../../c-api/long.rst:155 ../../c-api/long.rst:176
196- #: ../../c-api/long.rst:198 ../../c-api/long.rst:282 ../../c-api/long.rst:302
195+ #: ../../c-api/long.rst:135 ../../c-api/long.rst:165 ../../c-api/long.rst:186
196+ #: ../../c-api/long.rst:208 ../../c-api/long.rst:292 ../../c-api/long.rst:312
197197msgid "This function will no longer use :meth:`~object.__int__`."
198198msgstr "此函数将不再使用 :meth:`~object.__int__`。"
199199
200- #: ../../c-api/long.rst:145
200+ #: ../../c-api/long.rst:142
201+ msgid ""
202+ "A :term:`soft deprecated` alias. Exactly equivalent to the preferred "
203+ "``PyLong_AsLong``. In particular, it can fail with :exc:`OverflowError` or "
204+ "another exception."
205+ msgstr ""
206+ "一个已经 :term:`soft deprecated` 的别名。 完全等价于推荐使用的 ``PyLong_AsLong``。 特别地,它可能因 "
207+ ":exc:`OverflowError` 或其他异常而失败。"
208+
209+ #: ../../c-api/long.rst:146
210+ msgid "The function is soft deprecated."
211+ msgstr "此函数已被软弃用。"
212+
213+ #: ../../c-api/long.rst:155
201214msgid ""
202215"If the value of *obj* is greater than :c:macro:`LONG_MAX` or less than "
203216":c:macro:`LONG_MIN`, set *\\ *overflow* to ``1`` or ``-1``, respectively, and"
@@ -208,7 +221,7 @@ msgstr ""
208221"分别置为 ``1`` 或 ``-1``,并返回 ``-1``;否则,将 *\\ *overflow* 置为 ``0``。 如果发生其他异常则按常规把 "
209222"*\\ *overflow* 置为 ``0`` 并返回 ``-1``。"
210223
211- #: ../../c-api/long.rst:164 ../../c-api/long.rst:182
224+ #: ../../c-api/long.rst:174 ../../c-api/long.rst:192
212225msgid ""
213226"Return a C :c:expr:`long long` representation of *obj*. If *obj* is not an "
214227"instance of :c:type:`PyLongObject`, first call its :meth:`~object.__index__`"
@@ -217,13 +230,13 @@ msgstr ""
217230"返回 *obj* 的 C :c:expr:`long long` 表示形式。 如果 *obj* 不是 :c:type:`PyLongObject` "
218231"的实例,则会先调用其 :meth:`~object.__index__` 方法(如果存在)将其转换为 :c:type:`PyLongObject`。"
219232
220- #: ../../c-api/long.rst:168
233+ #: ../../c-api/long.rst:178
221234msgid ""
222235"Raise :exc:`OverflowError` if the value of *obj* is out of range for a "
223236":c:expr:`long long`."
224237msgstr "如果 *obj* 值超出 :c:expr:`long long` 的取值范围则会引发 :exc:`OverflowError`。"
225238
226- #: ../../c-api/long.rst:186
239+ #: ../../c-api/long.rst:196
227240msgid ""
228241"If the value of *obj* is greater than :c:macro:`LLONG_MAX` or less than "
229242":c:macro:`LLONG_MIN`, set *\\ *overflow* to ``1`` or ``-1``, respectively, "
@@ -234,90 +247,90 @@ msgstr ""
234247"*\\ *overflow* 分别置为 ``1`` 或 ``-1``,并返回 ``-1``;否则,将 *\\ *overflow* 置为 ``0``。 "
235248"如果发生其他异常则按常规把 *\\ *overflow* 置为 ``0`` 并返回 ``-1``。"
236249
237- #: ../../c-api/long.rst:208
250+ #: ../../c-api/long.rst:218
238251msgid ""
239252"Return a C :c:type:`Py_ssize_t` representation of *pylong*. *pylong* must "
240253"be an instance of :c:type:`PyLongObject`."
241254msgstr ""
242255"返回 *pylong* 的 C 语言 :c:type:`Py_ssize_t` 形式。*pylong* 必须是 "
243256":c:type:`PyLongObject` 的实例。"
244257
245- #: ../../c-api/long.rst:211
258+ #: ../../c-api/long.rst:221
246259msgid ""
247260"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a "
248261":c:type:`Py_ssize_t`."
249262msgstr ""
250263"如果 *pylong* 的值超出了 :c:type:`Py_ssize_t` 的取值范围则会引发 :exc:`OverflowError`。"
251264
252- #: ../../c-api/long.rst:223
265+ #: ../../c-api/long.rst:233
253266msgid ""
254267"Return a C :c:expr:`unsigned long` representation of *pylong*. *pylong* "
255268"must be an instance of :c:type:`PyLongObject`."
256269msgstr ""
257270"返回 *pylong* 的 C :c:expr:`unsigned long` 表示形式。 *pylong* 必须是 "
258271":c:type:`PyLongObject` 的实例。"
259272
260- #: ../../c-api/long.rst:226
273+ #: ../../c-api/long.rst:236
261274msgid ""
262275"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a "
263276":c:expr:`unsigned long`."
264277msgstr ""
265278"如果 *pylong* 的值超出了 :c:expr:`unsigned long` 的取值范围则会引发 :exc:`OverflowError`。"
266279
267- #: ../../c-api/long.rst:229
280+ #: ../../c-api/long.rst:239
268281msgid ""
269282"Returns ``(unsigned long)-1`` on error. Use :c:func:`PyErr_Occurred` to "
270283"disambiguate."
271284msgstr "出错时返回 ``(unsigned long)-1`` ,请利用 :c:func:`PyErr_Occurred` 辨别具体问题。"
272285
273- #: ../../c-api/long.rst:239
286+ #: ../../c-api/long.rst:249
274287msgid ""
275288"Return a C :c:type:`size_t` representation of *pylong*. *pylong* must be an"
276289" instance of :c:type:`PyLongObject`."
277290msgstr ""
278291"返回 *pylong* 的 C 语言 :c:type:`size_t` 形式。*pylong* 必须是 :c:type:`PyLongObject` "
279292"的实例。"
280293
281- #: ../../c-api/long.rst:242
294+ #: ../../c-api/long.rst:252
282295msgid ""
283296"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a "
284297":c:type:`size_t`."
285298msgstr "如果 *pylong* 的值超出了 :c:type:`size_t` 的取值范围则会引发 :exc:`OverflowError`。"
286299
287- #: ../../c-api/long.rst:245
300+ #: ../../c-api/long.rst:255
288301msgid ""
289302"Returns ``(size_t)-1`` on error. Use :c:func:`PyErr_Occurred` to "
290303"disambiguate."
291304msgstr "出错时返回 ``(size_t)-1`` ,请利用 :c:func:`PyErr_Occurred` 辨别具体问题。"
292305
293- #: ../../c-api/long.rst:254
306+ #: ../../c-api/long.rst:264
294307msgid ""
295308"Return a C :c:expr:`unsigned long long` representation of *pylong*. "
296309"*pylong* must be an instance of :c:type:`PyLongObject`."
297310msgstr ""
298311"返回 *pylong* 的 C :c:expr:`unsigned long long` 表示形式。 *pylong* 必须是 "
299312":c:type:`PyLongObject` 的实例。"
300313
301- #: ../../c-api/long.rst:257
314+ #: ../../c-api/long.rst:267
302315msgid ""
303316"Raise :exc:`OverflowError` if the value of *pylong* is out of range for an "
304317":c:expr:`unsigned long long`."
305318msgstr ""
306319"如果 *pylong* 的值超出 :c:expr:`unsigned long long` 的取值范围则会引发 "
307320":exc:`OverflowError`。"
308321
309- #: ../../c-api/long.rst:260
322+ #: ../../c-api/long.rst:270
310323msgid ""
311324"Returns ``(unsigned long long)-1`` on error. Use :c:func:`PyErr_Occurred` to"
312325" disambiguate."
313326msgstr "出错时返回 ``(unsigned long long)-1``,请利用 :c:func:`PyErr_Occurred` 辨别具体问题。"
314327
315- #: ../../c-api/long.rst:263
328+ #: ../../c-api/long.rst:273
316329msgid ""
317330"A negative *pylong* now raises :exc:`OverflowError`, not :exc:`TypeError`."
318331msgstr "现在 *pylong* 为负值会触发 :exc:`OverflowError`,而不是 :exc:`TypeError`。"
319332
320- #: ../../c-api/long.rst:269
333+ #: ../../c-api/long.rst:279
321334msgid ""
322335"Return a C :c:expr:`unsigned long` representation of *obj*. If *obj* is not"
323336" an instance of :c:type:`PyLongObject`, first call its "
@@ -328,20 +341,20 @@ msgstr ""
328341":c:type:`PyLongObject` 的实例,则会先调用其 :meth:`~object.__index__` 方法(如果存在)将其转换为 "
329342":c:type:`PyLongObject`。"
330343
331- #: ../../c-api/long.rst:273
344+ #: ../../c-api/long.rst:283
332345msgid ""
333346"If the value of *obj* is out of range for an :c:expr:`unsigned long`, return"
334347" the reduction of that value modulo ``ULONG_MAX + 1``."
335348msgstr ""
336349"如果 *obj* 的值超出了 :c:expr:`unsigned long` 的取值范围,则返回该值对 ``ULONG_MAX + 1`` 求模的余数。"
337350
338- #: ../../c-api/long.rst:276
351+ #: ../../c-api/long.rst:286
339352msgid ""
340353"Returns ``(unsigned long)-1`` on error. Use :c:func:`PyErr_Occurred` to "
341354"disambiguate."
342355msgstr "出错时返回 ``(unsigned long)-1``,请利用 :c:func:`PyErr_Occurred` 辨别具体问题。"
343356
344- #: ../../c-api/long.rst:288
357+ #: ../../c-api/long.rst:298
345358msgid ""
346359"Return a C :c:expr:`unsigned long long` representation of *obj*. If *obj* "
347360"is not an instance of :c:type:`PyLongObject`, first call its "
@@ -352,40 +365,40 @@ msgstr ""
352365":c:type:`PyLongObject` 的实例,则会先调用其 :meth:`~object.__index__` 方法(如果存在)将其转换为 "
353366":c:type:`PyLongObject`。"
354367
355- #: ../../c-api/long.rst:293
368+ #: ../../c-api/long.rst:303
356369msgid ""
357370"If the value of *obj* is out of range for an :c:expr:`unsigned long long`, "
358371"return the reduction of that value modulo ``ULLONG_MAX + 1``."
359372msgstr ""
360373"如果 *obj* 的值超出了 :c:expr:`unsigned long long` 的取值范围,则返回该值对 ``ULLONG_MAX + 1`` "
361374"求模的余数。"
362375
363- #: ../../c-api/long.rst:296
376+ #: ../../c-api/long.rst:306
364377msgid ""
365378"Returns ``(unsigned long long)-1`` on error. Use :c:func:`PyErr_Occurred` "
366379"to disambiguate."
367380msgstr "出错时返回 ``(unsigned long long)-1``,请利用 :c:func:`PyErr_Occurred` 辨别具体问题。"
368381
369- #: ../../c-api/long.rst:308
382+ #: ../../c-api/long.rst:318
370383msgid ""
371384"Return a C :c:expr:`double` representation of *pylong*. *pylong* must be an"
372385" instance of :c:type:`PyLongObject`."
373386msgstr ""
374387"返回 *pylong* 的 C :c:expr:`double` 表示形式。 *pylong* 必须是 :c:type:`PyLongObject` "
375388"的实例。"
376389
377- #: ../../c-api/long.rst:311
390+ #: ../../c-api/long.rst:321
378391msgid ""
379392"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a "
380393":c:expr:`double`."
381394msgstr "如果 *pylong* 的值超出了 :c:expr:`double` 的取值范围则会引发 :exc:`OverflowError`。"
382395
383- #: ../../c-api/long.rst:314
396+ #: ../../c-api/long.rst:324
384397msgid ""
385398"Returns ``-1.0`` on error. Use :c:func:`PyErr_Occurred` to disambiguate."
386399msgstr "出错时返回 ``-1.0`` ,请利用 :c:func:`PyErr_Occurred` 辨别具体问题。"
387400
388- #: ../../c-api/long.rst:319
401+ #: ../../c-api/long.rst:329
389402msgid ""
390403"Convert a Python integer *pylong* to a C :c:expr:`void` pointer. If *pylong*"
391404" cannot be converted, an :exc:`OverflowError` will be raised. This is only "
@@ -396,12 +409,12 @@ msgstr ""
396409":exc:`OverflowError`。 这只是为了保证将通过 :c:func:`PyLong_FromVoidPtr` 创建的值产生一个可用的 "
397410":c:expr:`void` 指针。"
398411
399- #: ../../c-api/long.rst:324
412+ #: ../../c-api/long.rst:334
400413msgid ""
401414"Returns ``NULL`` on error. Use :c:func:`PyErr_Occurred` to disambiguate."
402415msgstr "出错时返回 ``NULL``,请利用 :c:func:`PyErr_Occurred` 辨别具体问题。"
403416
404- #: ../../c-api/long.rst:329
417+ #: ../../c-api/long.rst:339
405418msgid ""
406419"On success, return a read only :term:`named tuple`, that holds information "
407420"about Python's internal representation of integers. See :data:`sys.int_info`"
@@ -410,15 +423,15 @@ msgstr ""
410423"成功时,返回一个只读的 :term:`named tuple`,它保存着有关 Python 内部整数表示形式的信息。 请参阅 "
411424":data:`sys.int_info` 了解关于单独字段的描述。"
412425
413- #: ../../c-api/long.rst:333
426+ #: ../../c-api/long.rst:343
414427msgid "On failure, return ``NULL`` with an exception set."
415428msgstr "当失败时,将返回 ``NULL`` 并设置一个异常。"
416429
417- #: ../../c-api/long.rst:340
430+ #: ../../c-api/long.rst:350
418431msgid "Return 1 if *op* is compact, 0 otherwise."
419432msgstr "如果 *op* 为紧凑形式则返回 1,否则返回 0。"
420433
421- #: ../../c-api/long.rst:342
434+ #: ../../c-api/long.rst:352
422435msgid ""
423436"This function makes it possible for performance-critical code to implement a"
424437" “fast path” for small integers. For compact values use "
@@ -431,23 +444,23 @@ msgstr ""
431444"<PyLong_AsSize_t>` 函数或者 :c:func:`调用 <PyObject_CallMethod>` "
432445":meth:`int.to_bytes`。"
433446
434- #: ../../c-api/long.rst:348
447+ #: ../../c-api/long.rst:358
435448msgid "The speedup is expected to be negligible for most users."
436449msgstr "此项加速对于大多数用户来说是可以忽略的。"
437450
438- #: ../../c-api/long.rst:350
451+ #: ../../c-api/long.rst:360
439452msgid ""
440453"Exactly what values are considered compact is an implementation detail and "
441454"is subject to change."
442455msgstr "具体有哪些值会被视为紧凑形式属于实现细节并可能发生改变。"
443456
444- #: ../../c-api/long.rst:355
457+ #: ../../c-api/long.rst:368
445458msgid ""
446459"If *op* is compact, as determined by :c:func:`PyUnstable_Long_IsCompact`, "
447460"return its value."
448461msgstr "如果 *op* 为紧凑形式,如 :c:func:`PyUnstable_Long_IsCompact` 所确定的,则返回它的值。"
449462
450- #: ../../c-api/long.rst:358
463+ #: ../../c-api/long.rst:371
451464msgid "Otherwise, the return value is undefined."
452465msgstr "在其他情况下,返回值是未定义的。"
453466
@@ -467,19 +480,19 @@ msgstr "integer"
467480msgid "LONG_MAX (C macro)"
468481msgstr "LONG_MAX (C 宏)"
469482
470- #: ../../c-api/long.rst:119 ../../c-api/long.rst:161 ../../c-api/long.rst:204
471- #: ../../c-api/long.rst:219 ../../c-api/long.rst:235 ../../c-api/long.rst:251
483+ #: ../../c-api/long.rst:119 ../../c-api/long.rst:171 ../../c-api/long.rst:214
484+ #: ../../c-api/long.rst:229 ../../c-api/long.rst:245 ../../c-api/long.rst:261
472485msgid "OverflowError (built-in exception)"
473486msgstr "OverflowError (内置异常)"
474487
475- #: ../../c-api/long.rst:204
488+ #: ../../c-api/long.rst:214
476489msgid "PY_SSIZE_T_MAX (C macro)"
477490msgstr "PY_SSIZE_T_MAX (C 宏)"
478491
479- #: ../../c-api/long.rst:219
492+ #: ../../c-api/long.rst:229
480493msgid "ULONG_MAX (C macro)"
481494msgstr "ULONG_MAX (C 宏)"
482495
483- #: ../../c-api/long.rst:235
496+ #: ../../c-api/long.rst:245
484497msgid "SIZE_MAX (C macro)"
485498msgstr "SIZE_MAX (C 宏)"