# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001 Python Software Foundation

# This file is distributed under the same license as the Python package.

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

#

# Translators:

# python-doc bot, 2025

# 99 <wh2099@pm.me>, 2026

# Freesand Leo <yuqinju@163.com>, 2026

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.15\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2026-05-17 14:51+0000\n"

"PO-Revision-Date: 2025-09-16 00:00+0000\n"

"Last-Translator: Freesand Leo <yuqinju@163.com>, 2026\n"

"Language-Team: Chinese (China) (https://app.transifex.com/python-doc/teams/5390/zh_CN/)\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Language: zh_CN\n"

"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../c-api/float.rst:6

msgid "Floating-Point Objects"

msgstr "浮点数对象"

#: ../../c-api/float.rst:13

msgid ""

"This subtype of :c:type:`PyObject` represents a Python floating-point "

"object."

msgstr "这个 :c:type:`PyObject` 的子类型代表一个 Python 浮点数对象。"

#: ../../c-api/float.rst:18

msgid ""

"This instance of :c:type:`PyTypeObject` represents the Python floating-point"

" type. This is the same object as :class:`float` in the Python layer."

msgstr ""

"这个 :c:type:`PyTypeObject` 实例代表 Python 浮点数类型。这与 Python 层面的 :class:`float` "

"是同一个对象。"

#: ../../c-api/float.rst:24

msgid ""

"Return true if its argument is a :c:type:`PyFloatObject` or a subtype of "

":c:type:`PyFloatObject`. This function always succeeds."

msgstr ""

"如果它的参数是一个 :c:type:`PyFloatObject` 或者 :c:type:`PyFloatObject` 的子类型则返回真值。 "

"此函数总是会成功执行。"

#: ../../c-api/float.rst:30

msgid ""

"Return true if its argument is a :c:type:`PyFloatObject`, but not a subtype "

"of :c:type:`PyFloatObject`. This function always succeeds."

msgstr ""

"如果它的参数是一个 :c:type:`PyFloatObject` 但不是 :c:type:`PyFloatObject` 的子类型则返回真值。 "

"此函数总是会成功执行。"

#: ../../c-api/float.rst:36

msgid ""

"Create a :c:type:`PyFloatObject` object based on the string value in *str*, "

"or ``NULL`` on failure."

msgstr "根据字符串 *str* 的值创建一个 :c:type:`PyFloatObject`，失败时返回 ``NULL``。"

#: ../../c-api/float.rst:42

msgid ""

"Create a :c:type:`PyFloatObject` object from *v*, or ``NULL`` on failure."

msgstr "根据 *v* 创建一个 :c:type:`PyFloatObject` 对象，失败时返回 ``NULL``。"

#: ../../c-api/float.rst:47

msgid ""

"Return a C :c:expr:`double` representation of the contents of *pyfloat*. If"

" *pyfloat* is not a Python floating-point object but has a "

":meth:`~object.__float__` method, this method will first be called to "

"convert *pyfloat* into a float. If :meth:`!__float__` is not defined then it"

" falls back to :meth:`~object.__index__`. This method returns ``-1.0`` upon "

"failure, so one should call :c:func:`PyErr_Occurred` to check for errors."

msgstr ""

"返回 *pyfloat* 的内容的 C :c:expr:`double` 表示形式。如果 *pyfloat* 不是一个 Python 浮点数对象但是具有"

" :meth:`~object.__float__` 方法，则会先调用此方法来将 *pyfloat* 转换为浮点数。如果 "

":meth:`!__float__` 未定义则将回退至 :meth:`~object.__index__`。此方法在失败时将返回 "

"``-1.0``，因此开发者应当调用 :c:func:`PyErr_Occurred` 来检测错误。"

#: ../../c-api/float.rst:54

msgid "Use :meth:`~object.__index__` if available."

msgstr "如果可能将使用 :meth:`~object.__index__`。"

#: ../../c-api/float.rst:60

msgid ""

"Return a C :c:expr:`double` representation of the contents of *pyfloat*, but"

" without error checking."

msgstr "返回 *pyfloat* 的 C :c:expr:`double` 表示形式，但不带错误检测。"

#: ../../c-api/float.rst:66

msgid ""

"Return a structseq instance which contains information about the precision, "

"minimum and maximum values of a float. It's a thin wrapper around the header"

" file :file:`float.h`."

msgstr ""

"返回一个 structseq 实例，其中包含有关 float 的精度、最小值和最大值的信息。它是头文件 :file:`float.h` 的一个简单包装。"

#: ../../c-api/float.rst:73

msgid ""

"Return the maximum representable finite float *DBL_MAX* as C "

":c:expr:`double`."

msgstr "返回 C :c:expr:`double` 形式的最大可表示有限浮点数 *DBL_MAX*。"

#: ../../c-api/float.rst:78

msgid ""

"Return the minimum normalized positive float *DBL_MIN* as C "

":c:expr:`double`."

msgstr "返回 C :c:expr:`double` 形式的最小正规化正浮点数 *DBL_MIN*。"

#: ../../c-api/float.rst:83

msgid ""

"This macro expands to a constant expression of type :c:expr:`double`, that "

"represents the positive infinity."

msgstr "这个宏会扩展为一个 :c:expr:`double` 类型的常量表达式，它代表正无穷大。"

#: ../../c-api/float.rst:86

msgid ""

"It is equivalent to the :c:macro:`!INFINITY` macro from the C11 standard "

"``<math.h>`` header."

msgstr "这等价于 C11 标准 ``<math.h>`` 头文件中的 :c:macro:`!INFINITY` 宏。"

#: ../../c-api/float.rst:94

msgid ""

"This macro expands to a constant expression of type :c:expr:`double`, that "

"represents a quiet not-a-number (qNaN) value."

msgstr ""

"这个宏会扩展为一个 :c:expr:`double` 类型的常量表达式，它代表一个 quiet not-a-number (qNaN) 值。"

#: ../../c-api/float.rst:97

msgid ""

"On most platforms, this is equivalent to the :c:macro:`!NAN` macro from the "

"C11 standard ``<math.h>`` header."

msgstr "在大多数平台上，这等价于 C11 标准 ``<math.h>`` 头文件中的 :c:macro:`!NAN` 宏。"

#: ../../c-api/float.rst:103

msgid "Equivalent to :c:macro:`!INFINITY`."

msgstr "等价于 :c:macro:`!INFINITY`。"

#: ../../c-api/float.rst:110

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:115

msgid "High precision (long double) definition of :data:`~math.e` constant."

msgstr "高精度 (long double) 的 :data:`~math.e` 常量定义。"

#: ../../c-api/float.rst:122

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:127

msgid "High precision (long double) definition of :data:`~math.pi` constant."

msgstr "高精度 (long double) 的 :data:`~math.pi` 常量定义。"

#: ../../c-api/float.rst:134

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:141

msgid "Return :data:`math.nan` from a function."

msgstr "从一个函数返回 :data:`math.nan`。"

#: ../../c-api/float.rst:143

msgid ""

"On most platforms, this is equivalent to ``return PyFloat_FromDouble(NAN)``."

msgstr "在大多数平台上，这等价于 ``return PyFloat_FromDouble(NAN)``。"

#: ../../c-api/float.rst:148

msgid ""

"Return :data:`math.inf` or :data:`-math.inf <math.inf>` from a function, "

"depending on the sign of *sign*."

msgstr ""

"从一个函数返回 :data:`math.inf` 或 :data:`-math.inf <math.inf>`，具体取决于 *sign* 的符号值。"

#: ../../c-api/float.rst:151

msgid "On most platforms, this is equivalent to the following::"

msgstr "在大多数平台上，这等价于以下代码::"

#: ../../c-api/float.rst:153

msgid "return PyFloat_FromDouble(copysign(INFINITY, sign));"

msgstr "return PyFloat_FromDouble(copysign(INFINITY, sign));"

#: ../../c-api/float.rst:158

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 "如果给定的浮点数 *X* 为有限值，即为规格数、非规格数或零，而不是无穷大或 NaN 则返回 ``1``。否则返回 ``0``。"

#: ../../c-api/float.rst:162

msgid "Use :c:macro:`!isfinite` instead."

msgstr "改用 :c:macro:`!isfinite`。"

#: ../../c-api/float.rst:168

msgid ""

"Return ``1`` if the given floating-point number *X* is positive or negative "

"infinity. Return ``0`` otherwise."

msgstr "如果给定的浮点数 *X* 为正或负无穷大则返回 ``1``。否则返回 ``0``。"

#: ../../c-api/float.rst:171

msgid "Use :c:macro:`!isinf` instead."

msgstr "改用 :c:macro:`!isinf`。"

#: ../../c-api/float.rst:177

msgid ""

"Return ``1`` if the given floating-point number *X* is a not-a-number (NaN) "

"value. Return ``0`` otherwise."

msgstr "如果给定的浮点数 *X* 为非数字 (NaN) 值则返回 ``1``。否则返回 ``0``。"

#: ../../c-api/float.rst:180

msgid "Use :c:macro:`!isnan` instead."

msgstr "改用 :c:macro:`!isnan`。"

#: ../../c-api/float.rst:185

msgid "Pack and Unpack functions"

msgstr "打包与解包函数"

#: ../../c-api/float.rst:187

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 "

"bytes string from a C :c:expr:`double`, and the Unpack routines produce a C "

":c:expr:`double` from such a bytes string. The suffix (2, 4 or 8) specifies "

"the number of bytes in the bytes string:"

msgstr ""

#: ../../c-api/float.rst:193

msgid "The 2-byte format is the IEEE 754 binary16 half-precision format."

msgstr ""

#: ../../c-api/float.rst:194

msgid "The 4-byte format is the IEEE 754 binary32 single-precision format."

msgstr ""

#: ../../c-api/float.rst:195

msgid "The 8-byte format is the IEEE 754 binary64 double-precision format."

msgstr ""

#: ../../c-api/float.rst:197

msgid ""

"The NaN type may not be preserved on some platforms while unpacking "

"(signaling NaNs become quiet NaNs), for example on x86 systems in 32-bit "

"mode."

msgstr ""

#: ../../c-api/float.rst:200

msgid ""

"It's assumed that the :c:expr:`double` type has the IEEE 754 binary64 double"

" precision format. What happens if it's not true is partly accidental "

"(alas). 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 less precision, or smaller dynamic range, not all values can be "

"unpacked. The packing of special numbers like INFs and NaNs (if such things"

" exist on the platform) may not be handled correctly, and attempting to "

"unpack a bytes string containing an IEEE INF or NaN may raise an exception."

msgstr ""

#: ../../c-api/float.rst:212

msgid "Pack functions"

msgstr "打包函数"

#: ../../c-api/float.rst:214

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 format (exponent last, at ``p+1``, ``p+3``, or ``p+6`` and ``p+7``), "

"zero if you want big-endian format (exponent first, at *p*). Use the "

":c:macro:`!PY_LITTLE_ENDIAN` constant to select the native endian: it is "

"equal to ``0`` on big endian processor, or ``1`` on little endian processor."

msgstr ""

#: ../../c-api/float.rst:221

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:226

msgid "Pack a C double as the IEEE 754 binary16 half-precision format."

msgstr "将 C double 打包为 IEEE 754 binary16 半精度格式。"

#: ../../c-api/float.rst:230

msgid "Pack a C double as the IEEE 754 binary32 single precision format."

msgstr "将 C double 打包为 IEEE 754 binary32 单精度格式。"

#: ../../c-api/float.rst:234

msgid "Pack a C double as the IEEE 754 binary64 double precision format."

msgstr "将 C double 打包为 IEEE 754 binary64 双精度格式。"

#: ../../c-api/float.rst:237

msgid "This function always succeeds in CPython."

msgstr ""

#: ../../c-api/float.rst:241

msgid "Unpack functions"

msgstr "解包函数"

#: ../../c-api/float.rst:243

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 (exponent last, at ``p+1``, ``p+3`` or ``p+6`` and ``p+7``), zero if "

"big-endian (exponent first, at *p*). Use the :c:macro:`!PY_LITTLE_ENDIAN` "

"constant to select the native endian: it is equal to ``0`` on big endian "

"processor, or ``1`` on little endian processor."

msgstr ""

#: ../../c-api/float.rst:250

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:`OverflowError`)."

msgstr ""

"返回值：解包后的 double。出错时，返回值为 ``-1.0`` 且 :c:func:`PyErr_Occurred` 为真值 "

"(并且会设置一个异常，最大可能为 :exc:`OverflowError`)。"

#: ../../c-api/float.rst:255

msgid "These functions always succeed in CPython."

msgstr ""

#: ../../c-api/float.rst:259

msgid "Unpack the IEEE 754 binary16 half-precision format as a C double."

msgstr "将 IEEE 754 binary16 半精度格式解包为 C double。"

#: ../../c-api/float.rst:263

msgid "Unpack the IEEE 754 binary32 single precision format as a C double."

msgstr "将 IEEE 754 binary32 单精度格式解包为 C double。"

#: ../../c-api/float.rst:267

msgid "Unpack the IEEE 754 binary64 double precision format as a C double."

msgstr "将 IEEE 754 binary64 双精度格式解包为 C double。"

#: ../../c-api/float.rst:8

msgid "object"

msgstr "object -- 对象"

#: ../../c-api/float.rst:8

msgid "floating-point"

msgstr "浮点数"