sync with cpython 9543c2ef

Author: github-actions[bot]

c-api/float.po

@@ -9,7 +9,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-11-13 00:15+0000\n"
+"POT-Creation-Date: 2025-11-19 00:14+0000\n"
 "PO-Revision-Date: 2025-11-07 05:06+0000\n"
 "Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -143,61 +143,101 @@ msgstr ""
 "集。"
 
 #: ../../c-api/float.rst:101
+msgid "Equivalent to :c:macro:`!INFINITY`."
+msgstr ""
+
+#: ../../c-api/float.rst:103
+msgid "The macro is :term:`soft deprecated`."
+msgstr ""
+
+#: ../../c-api/float.rst:109
 msgid ""
 "The definition (accurate for a :c:expr:`double` type) of the :data:`math.e` "
 "constant."
 msgstr ":data:`math.e` 常數的定義（對 :c:expr:`double` 型別而言是準確的）。"
 
-#: ../../c-api/float.rst:106
+#: ../../c-api/float.rst:114
 msgid "High precision (long double) definition of :data:`~math.e` constant."
 msgstr "高精度（long double）定義的 :data:`~math.e` 常數。"
 
-#: ../../c-api/float.rst:111
+#: ../../c-api/float.rst:119
 msgid ""
 "The definition (accurate for a :c:expr:`double` type) of the :data:`math.pi` "
 "constant."
 msgstr ":data:`math.pi` 常數的定義（對 :c:expr:`double` 型別而言是準確的）。"
 
-#: ../../c-api/float.rst:116
+#: ../../c-api/float.rst:124
 msgid "High precision (long double) definition of :data:`~math.pi` constant."
 msgstr "高精度（long double）定義的 :data:`~math.pi` 常數。"
 
-#: ../../c-api/float.rst:121
+#: ../../c-api/float.rst:129
 msgid ""
 "The definition (accurate for a :c:expr:`double` type) of the :data:`math."
 "tau` constant."
 msgstr ":data:`math.tau` 常數的定義（對 :c:expr:`double` 型別而言是準確的）。"
 
-#: ../../c-api/float.rst:128
+#: ../../c-api/float.rst:136
 msgid "Return :data:`math.nan` from a function."
 msgstr "從函式回傳 :data:`math.nan`。"
 
-#: ../../c-api/float.rst:130
+#: ../../c-api/float.rst:138
 msgid ""
 "On most platforms, this is equivalent to ``return PyFloat_FromDouble(NAN)``."
 msgstr "在大多數平台上，這相當於 ``return PyFloat_FromDouble(NAN)``。"
 
-#: ../../c-api/float.rst:135
+#: ../../c-api/float.rst:143
 msgid ""
 "Return :data:`math.inf` or :data:`-math.inf <math.inf>` from a function, "
 "depending on the sign of *sign*."
 msgstr ""
 "根據 *sign* 的正負號，從函式回傳 :data:`math.inf` 或 :data:`-math.inf <math."
 "inf>`。"
 
-#: ../../c-api/float.rst:138
+#: ../../c-api/float.rst:146
 msgid "On most platforms, this is equivalent to the following::"
 msgstr "在大多數平台上，這相當於以下內容： ::"
 
-#: ../../c-api/float.rst:140
+#: ../../c-api/float.rst:148
 msgid "return PyFloat_FromDouble(copysign(INFINITY, sign));"
 msgstr "return PyFloat_FromDouble(copysign(INFINITY, sign));"
 
-#: ../../c-api/float.rst:144
+#: ../../c-api/float.rst:153
+msgid ""
+"Return ``1`` if the given floating-point number *X* is finite, that is, it "
+"is normal, subnormal or zero, but not infinite or NaN. Return ``0`` "
+"otherwise."
+msgstr ""
+
+#: ../../c-api/float.rst:157
+msgid ""
+"The macro is :term:`soft deprecated`.  Use :c:macro:`!isfinite` instead."
+msgstr ""
+
+#: ../../c-api/float.rst:163
+msgid ""
+"Return ``1`` if the given floating-point number *X* is positive or negative "
+"infinity.  Return ``0`` otherwise."
+msgstr ""
+
+#: ../../c-api/float.rst:166
+msgid "The macro is :term:`soft deprecated`.  Use :c:macro:`!isinf` instead."
+msgstr ""
+
+#: ../../c-api/float.rst:172
+msgid ""
+"Return ``1`` if the given floating-point number *X* is a not-a-number (NaN) "
+"value.  Return ``0`` otherwise."
+msgstr ""
+
+#: ../../c-api/float.rst:175
+msgid "The macro is :term:`soft deprecated`.  Use :c:macro:`!isnan` instead."
+msgstr ""
+
+#: ../../c-api/float.rst:180
 msgid "Pack and Unpack functions"
 msgstr "打包和解包函式"
 
-#: ../../c-api/float.rst:146
+#: ../../c-api/float.rst:182
 msgid ""
 "The pack and unpack functions provide an efficient platform-independent way "
 "to store floating-point values as byte strings. The Pack routines produce a "
@@ -209,7 +249,7 @@ msgstr ""
 "例程從 C :c:expr:`double` 產生位元組字串，而解包例程則從這樣的位元組字串產生 "
 "C :c:expr:`double`。後綴（2、4 或 8）標示了位元組字串中的位元組數。"
 
-#: ../../c-api/float.rst:152
+#: ../../c-api/float.rst:188
 msgid ""
 "On platforms that appear to use IEEE 754 formats these functions work by "
 "copying bits. On other platforms, the 2-byte format is identical to the IEEE "
@@ -226,15 +266,15 @@ msgstr ""
 "格式相同。儘管如此，INF 和 NaN（如果這些東西在平台上存在）的打包並未正確處"
 "理，並且嘗試解包包含 IEEE INF 或 NaN 的位元組字串將引發例外。"
 
-#: ../../c-api/float.rst:161
+#: ../../c-api/float.rst:197
 msgid ""
 "Note that NaNs type may not be preserved on IEEE platforms (signaling NaN "
 "become quiet NaN), for example on x86 systems in 32-bit mode."
 msgstr ""
 "請注意，在 IEEE 平台上可能無法保留 NaN 型別（「訊號型 NaN (signaling NaN)」會"
 "變成「安靜型 NaN (quiet NaN)」），例如在 32 位元模式的 x86 系統上。"
 
-#: ../../c-api/float.rst:164
+#: ../../c-api/float.rst:200
 msgid ""
 "On non-IEEE platforms with more precision, or larger dynamic range, than "
 "IEEE 754 supports, not all values can be packed; on non-IEEE platforms with "
@@ -245,11 +285,11 @@ msgstr ""
 "有值；在非 IEEE 平台上，如果精度較低或動態範圍較小，則無法解包所有值。在這種"
 "案例下發生的情況在某種程度上是偶然的（唉）。"
 
-#: ../../c-api/float.rst:172
+#: ../../c-api/float.rst:208
 msgid "Pack functions"
 msgstr "打包函式"
 
-#: ../../c-api/float.rst:174
+#: ../../c-api/float.rst:210
 msgid ""
 "The pack routines write 2, 4 or 8 bytes, starting at *p*. *le* is an :c:expr:"
 "`int` argument, non-zero if you want the bytes string in little-endian "
@@ -264,43 +304,43 @@ msgstr ""
 "零。可以使用 :c:macro:`PY_BIG_ENDIAN` 常數來使用原生端序：在大端序處理器上它"
 "等於 ``1``，在小端序處理器上它等於 ``0``。"
 
-#: ../../c-api/float.rst:181
+#: ../../c-api/float.rst:217
 msgid ""
 "Return value: ``0`` if all is OK, ``-1`` if error (and an exception is set, "
 "most likely :exc:`OverflowError`)."
 msgstr ""
 "回傳值：如果一切正常則為 ``0``，如果發生錯誤則為 ``-1``\\ （並且會設定一個例"
 "外，最有可能是 :exc:`OverflowError`）。"
 
-#: ../../c-api/float.rst:184
+#: ../../c-api/float.rst:220
 msgid "There are two problems on non-IEEE platforms:"
 msgstr "在非 IEEE 平台上有兩個問題："
 
-#: ../../c-api/float.rst:186
+#: ../../c-api/float.rst:222
 msgid "What this does is undefined if *x* is a NaN or infinity."
 msgstr "如果 *x* 是 NaN 或無窮大，則這樣做是未定義的。"
 
-#: ../../c-api/float.rst:187
+#: ../../c-api/float.rst:223
 msgid "``-0.0`` and ``+0.0`` produce the same bytes string."
 msgstr "``-0.0`` 和 ``+0.0`` 會產生同樣的位元組字串。"
 
-#: ../../c-api/float.rst:191
+#: ../../c-api/float.rst:227
 msgid "Pack a C double as the IEEE 754 binary16 half-precision format."
 msgstr "將 C double 打包為 IEEE 754 binary16 半精度格式。"
 
-#: ../../c-api/float.rst:195
+#: ../../c-api/float.rst:231
 msgid "Pack a C double as the IEEE 754 binary32 single precision format."
 msgstr "將 C double 打包為 IEEE 754 binary32 單精度格式。"
 
-#: ../../c-api/float.rst:199
+#: ../../c-api/float.rst:235
 msgid "Pack a C double as the IEEE 754 binary64 double precision format."
 msgstr "將 C double 打包為 IEEE 754 binary64 雙精度格式。"
 
-#: ../../c-api/float.rst:203
+#: ../../c-api/float.rst:239
 msgid "Unpack functions"
 msgstr "解包函式"
 
-#: ../../c-api/float.rst:205
+#: ../../c-api/float.rst:241
 msgid ""
 "The unpack routines read 2, 4 or 8 bytes, starting at *p*.  *le* is an :c:"
 "expr:`int` argument, non-zero if the bytes string is in little-endian format "
@@ -315,7 +355,7 @@ msgstr ""
 "使用 :c:macro:`PY_BIG_ENDIAN` 常數來使用原生端序：在大端序處理器上它等於 "
 "``1``，在小端序處理器上它等於 ``0``。"
 
-#: ../../c-api/float.rst:212
+#: ../../c-api/float.rst:248
 msgid ""
 "Return value: The unpacked double.  On error, this is ``-1.0`` and :c:func:"
 "`PyErr_Occurred` is true (and an exception is set, most likely :exc:"
@@ -325,22 +365,22 @@ msgstr ""
 "`PyErr_Occurred` 為 true（並且會設置一個例外，最有可能是 :exc:"
 "`OverflowError`）。"
 
-#: ../../c-api/float.rst:216
+#: ../../c-api/float.rst:252
 msgid ""
 "Note that on a non-IEEE platform this will refuse to unpack a bytes string "
 "that represents a NaN or infinity."
 msgstr ""
 "請注意，在非 IEEE 平台上，這將拒絕解包會表示為 NaN 或無窮大的位元組字串。"
 
-#: ../../c-api/float.rst:221
+#: ../../c-api/float.rst:257
 msgid "Unpack the IEEE 754 binary16 half-precision format as a C double."
 msgstr "將 IEEE 754 binary16 半精度格式解包為 C double。"
 
-#: ../../c-api/float.rst:225
+#: ../../c-api/float.rst:261
 msgid "Unpack the IEEE 754 binary32 single precision format as a C double."
 msgstr "將 IEEE 754 binary32 單精度格式解包為 C double。"
 
-#: ../../c-api/float.rst:229
+#: ../../c-api/float.rst:265
 msgid "Unpack the IEEE 754 binary64 double precision format as a C double."
 msgstr "將 IEEE 754 binary64 雙精度格式解包為 C double。"