# 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
# Freesand Leo <yuqinju@163.com>, 2025
# 99 <wh2099@pm.me>, 2026
# 
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-04-23 15:47+0000\n"
"PO-Revision-Date: 2025-09-16 00:00+0000\n"
"Last-Translator: 99 <wh2099@pm.me>, 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/allocation.rst:6
msgid "Allocating objects on the heap"
msgstr ""

#: ../../c-api/allocation.rst:17
msgid ""
"Initialize a newly allocated object *op* with its type and initial "
"reference.  Returns the initialized object.  Other fields of the object are "
"not initialized.  Despite its name, this function is unrelated to the "
"object's :meth:`~object.__init__` method (:c:member:`~PyTypeObject.tp_init` "
"slot).  Specifically, this function does **not** call the object's "
":meth:`!__init__` method."
msgstr ""
"为新分配的对象 *op* 初始化它的类型和初始引用。返回初始化后的对象。对象的其他字段不会被初始化。虽然被如此命名，但该函数与对象的 "
":meth:`~object.__init__` 方法 (:c:member:`~PyTypeObject.tp_init` 槽位) 无关。 "
"具体而言，该函数 **不会** 调用对象的 :meth:`!__init__` 方法。"

#: ../../c-api/allocation.rst:24
msgid ""
"In general, consider this function to be a low-level routine. Use "
":c:member:`~PyTypeObject.tp_alloc` where possible. For implementing "
":c:member:`!tp_alloc` for your type, prefer :c:func:`PyType_GenericAlloc` or"
" :c:func:`PyObject_New`."
msgstr ""
"一般来说，可将该函数视为一个低层级的例程。如有可能请使用 :c:member:`~PyTypeObject.tp_alloc`。要为你的类型实现 "
":c:member:`!tp_alloc`，推荐使用 :c:func:`PyType_GenericAlloc` 或 "
":c:func:`PyObject_New` 函数。"

#: ../../c-api/allocation.rst:31
msgid ""
"This function only initializes the object's memory corresponding to the "
"initial :c:type:`PyObject` structure.  It does not zero the rest."
msgstr "该函数只初始化与初始 :c:type:`PyObject` 结构体相对应的对象内存。它不会为其余内存写入零值。"

#: ../../c-api/allocation.rst:37
msgid ""
"This does everything :c:func:`PyObject_Init` does, and also initializes the "
"length information for a variable-size object."
msgstr "它的功能和 :c:func:`PyObject_Init` 一样，并且会初始化变量大小对象的长度信息。"

#: ../../c-api/allocation.rst:42
msgid ""
"This function only initializes some of the object's memory.  It does not "
"zero the rest."
msgstr "该函数只初始化对象的部分内存。它不会为其余内存写入零值。"

#: ../../c-api/allocation.rst:48
msgid ""
"Allocates a new Python object using the C structure type *TYPE* and the "
"Python type object *typeobj* (``PyTypeObject*``) by calling "
":c:func:`PyObject_Malloc` to allocate memory and initializing it like "
":c:func:`PyObject_Init`.  The caller will own the only reference to the "
"object (i.e. its reference count will be one)."
msgstr ""
"使用 C 结构类型 *TYPE* 和 Python 类型对象 *typeobj* (``PyTypeObject*``) 分配一个新的 Python "
"对象，通过调用 :c:func:`PyObject_Malloc` 来分配内存并像 :c:func:`PyObject_Init` 那样对其进行初始化。"
" 调用方将拥有对该对象的唯一引用（即其引用计数将为一）。"

#: ../../c-api/allocation.rst:54 ../../c-api/allocation.rst:107
msgid ""
"Avoid calling this directly to allocate memory for an object; call the "
"type's :c:member:`~PyTypeObject.tp_alloc` slot instead."
msgstr "请避免直接调用此函数为对象分配内存；而应调用类型的 :c:member:`~PyTypeObject.tp_alloc` 槽位。"

#: ../../c-api/allocation.rst:57 ../../c-api/allocation.rst:110
msgid ""
"When populating a type's :c:member:`~PyTypeObject.tp_alloc` slot, "
":c:func:`PyType_GenericAlloc` is preferred over a custom function that "
"simply calls this macro."
msgstr ""
"在填充类型的 :c:member:`~PyTypeObject.tp_alloc` 槽位时，推荐使用 "
":c:func:`PyType_GenericAlloc` 而不是使用简单调用此宏的自定义函数。"

#: ../../c-api/allocation.rst:61
msgid ""
"This macro does not call :c:member:`~PyTypeObject.tp_alloc`, "
":c:member:`~PyTypeObject.tp_new` (:meth:`~object.__new__`), or "
":c:member:`~PyTypeObject.tp_init` (:meth:`~object.__init__`)."
msgstr ""
"这个宏不会调用 :c:member:`~PyTypeObject.tp_alloc`, :c:member:`~PyTypeObject.tp_new`"
" (:meth:`~object.__new__`) 或 :c:member:`~PyTypeObject.tp_init` "
"(:meth:`~object.__init__`) 方法。"

#: ../../c-api/allocation.rst:65
msgid ""
"This cannot be used for objects with :c:macro:`Py_TPFLAGS_HAVE_GC` set in "
":c:member:`~PyTypeObject.tp_flags`; use :c:macro:`PyObject_GC_New` instead."
msgstr ""
"这不能被用于在 :c:member:`~PyTypeObject.tp_flags` 中设置了 "
":c:macro:`Py_TPFLAGS_HAVE_GC` 的对象；请改用 :c:macro:`PyObject_GC_New`。"

#: ../../c-api/allocation.rst:68
msgid ""
"Memory allocated by this macro must be freed with :c:func:`PyObject_Free` "
"(usually called via the object's :c:member:`~PyTypeObject.tp_free` slot)."
msgstr ""
"由此宏分配的内存必须用 :c:func:`PyObject_Free` 来释放（一般是通过对象的 "
":c:member:`~PyTypeObject.tp_free` 槽位进行调用）。"

#: ../../c-api/allocation.rst:73 ../../c-api/allocation.rst:123
msgid ""
"The returned memory is not guaranteed to have been completely zeroed before "
"it was initialized."
msgstr "返回的内存并不保证在其初始化之前被完全置为零值。"

#: ../../c-api/allocation.rst:78 ../../c-api/allocation.rst:128
msgid ""
"This macro does not construct a fully initialized object of the given type; "
"it merely allocates memory and prepares it for further initialization by "
":c:member:`~PyTypeObject.tp_init`.  To construct a fully initialized object,"
" call *typeobj* instead.  For example::"
msgstr ""
"此宏并不会构造给定类型的完全初始化的对象；它只是分配内存并准备好由 :c:member:`~PyTypeObject.tp_init` "
"来进一步初始化。要构造完全初始化的对象，应改为调用 *typeobj*。例如::"

#: ../../c-api/allocation.rst:83
msgid "PyObject *foo = PyObject_CallNoArgs((PyObject *)&PyFoo_Type);"
msgstr "PyObject *foo = PyObject_CallNoArgs((PyObject *)&PyFoo_Type);"

#: ../../c-api/allocation.rst:87 ../../c-api/allocation.rst:137
#: ../../c-api/allocation.rst:184 ../../c-api/allocation.rst:186
#: ../../c-api/allocation.rst:188
msgid ":c:func:`PyObject_Free`"
msgstr ":c:func:`PyObject_Free`"

#: ../../c-api/allocation.rst:88
msgid ":c:macro:`PyObject_GC_New`"
msgstr ":c:macro:`PyObject_GC_New`"

#: ../../c-api/allocation.rst:89 ../../c-api/allocation.rst:139
msgid ":c:func:`PyType_GenericAlloc`"
msgstr ":c:func:`PyType_GenericAlloc`"

#: ../../c-api/allocation.rst:90 ../../c-api/allocation.rst:140
msgid ":c:member:`~PyTypeObject.tp_alloc`"
msgstr ":c:member:`~PyTypeObject.tp_alloc`"

#: ../../c-api/allocation.rst:95
msgid "Like :c:macro:`PyObject_New` except:"
msgstr "与 :c:macro:`PyObject_New` 相似，但："

#: ../../c-api/allocation.rst:97
msgid ""
"It allocates enough memory for the *TYPE* structure plus *size* "
"(``Py_ssize_t``) fields of the size given by the "
":c:member:`~PyTypeObject.tp_itemsize` field of *typeobj*."
msgstr ""
"它将分配足够容纳 *TYPE* 结构加上由 *typeobj* 的 :c:member:`~PyTypeObject.tp_itemsize` "
"字段所给出的大小的 *size* (``Py_ssize_t``) 个字段的内存。"

#: ../../c-api/allocation.rst:100
msgid "The memory is initialized like :c:func:`PyObject_InitVar`."
msgstr "该内存将像 :c:func:`PyObject_InitVar` 一样被初始化。"

#: ../../c-api/allocation.rst:102
msgid ""
"This is useful for implementing objects like tuples, which are able to "
"determine their size at construction time.  Embedding the array of fields "
"into the same allocation decreases the number of allocations, improving the "
"memory management efficiency."
msgstr "这适用于实现像元组那样的对象，它能够在构造时确定其大小。将字段数组嵌入到同一分配块中可减少分配次数，从而提高内存管理效率。"

#: ../../c-api/allocation.rst:114
msgid ""
"This cannot be used for objects with :c:macro:`Py_TPFLAGS_HAVE_GC` set in "
":c:member:`~PyTypeObject.tp_flags`; use :c:macro:`PyObject_GC_NewVar` "
"instead."
msgstr ""
"这不能被用于在 :c:member:`~PyTypeObject.tp_flags` 中设置了 "
":c:macro:`Py_TPFLAGS_HAVE_GC` 的对象；请改用 :c:macro:`PyObject_GC_NewVar`。"

#: ../../c-api/allocation.rst:118
msgid ""
"Memory allocated by this function must be freed with :c:func:`PyObject_Free`"
" (usually called via the object's :c:member:`~PyTypeObject.tp_free` slot)."
msgstr ""
"由此函数分配的内存必须用 :c:func:`PyObject_Free` 来释放（一般是通过对象的 "
":c:member:`~PyTypeObject.tp_free` 槽位进行调用）。"

#: ../../c-api/allocation.rst:133
msgid ""
"PyObject *list_instance = PyObject_CallNoArgs((PyObject *)&PyList_Type);"
msgstr ""
"PyObject *list_instance = PyObject_CallNoArgs((PyObject *)&PyList_Type);"

#: ../../c-api/allocation.rst:138
msgid ":c:macro:`PyObject_GC_NewVar`"
msgstr ":c:macro:`PyObject_GC_NewVar`"

#: ../../c-api/allocation.rst:145
msgid ""
"Object which is visible in Python as ``None``.  This should only be accessed"
" using the :c:macro:`Py_None` macro, which evaluates to a pointer to this "
"object."
msgstr ""
"在 Python 中表现为 ``None`` 的对象。只应通过 :c:macro:`Py_None` 宏来访问它，该宏的求值结果为指向该对象的指针。"

#: ../../c-api/allocation.rst:152
msgid ":ref:`moduleobjects`"
msgstr ":ref:`moduleobjects`"

#: ../../c-api/allocation.rst:153
msgid "To allocate and create extension modules."
msgstr "分配内存和创建扩展模块"

#: ../../c-api/allocation.rst:157
msgid "Soft-deprecated aliases"
msgstr ""

#: ../../c-api/allocation.rst:161
msgid ""
"These are aliases to existing functions and macros. They exist solely for "
"backwards compatibility."
msgstr ""

#: ../../c-api/allocation.rst:169
msgid "Soft-deprecated alias"
msgstr ""

#: ../../c-api/allocation.rst:170
msgid "Function"
msgstr "函数"

#: ../../c-api/allocation.rst:172
msgid ":c:macro:`PyObject_New`"
msgstr ":c:macro:`PyObject_New`"

#: ../../c-api/allocation.rst:174
msgid ":c:macro:`PyObject_NewVar`"
msgstr ":c:macro:`PyObject_NewVar`"

#: ../../c-api/allocation.rst:176
msgid ":c:func:`PyObject_Init`"
msgstr ":c:func:`PyObject_Init`"

#: ../../c-api/allocation.rst:178
msgid ":c:func:`PyObject_InitVar`"
msgstr ":c:func:`PyObject_InitVar`"

#: ../../c-api/allocation.rst:180
msgid ":c:func:`PyObject_Malloc`"
msgstr ":c:func:`PyObject_Malloc`"

#: ../../c-api/allocation.rst:182
msgid ":c:func:`PyObject_Realloc`"
msgstr ":c:func:`PyObject_Realloc`"