# 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`"