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

# 99 <wh2099@pm.me>, 2026

# python-doc bot, 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-08 18:34+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/module.rst:6

msgid "Module Objects"

msgstr "模块对象"

#: ../../c-api/module.rst:14

msgid ""

"This instance of :c:type:`PyTypeObject` represents the Python module type. "

"This is exposed to Python programs as :py:class:`types.ModuleType`."

msgstr ""

"这个 :c:type:`PyTypeObject` 的实例代表 Python 模块类型。它作为 :py:class:`types.ModuleType`"

" 被暴露给 Python 程序。"

#: ../../c-api/module.rst:20

msgid ""

"Return true if *p* is a module object, or a subtype of a module object. This"

" function always succeeds."

msgstr "当 *p* 为模块类型的对象，或是模块子类型的对象时返回真值。该函数永远有返回值。"

#: ../../c-api/module.rst:26

msgid ""

"Return true if *p* is a module object, but not a subtype of "

":c:data:`PyModule_Type`. This function always succeeds."

msgstr "当 *p* 为模块类型的对象且不是 :c:data:`PyModule_Type` 的子类型的对象时返回真值。该函数永远有返回值。"

#: ../../c-api/module.rst:39

msgid ""

"Return a new module object with :attr:`module.__name__` set to *name*. The "

"module's :attr:`!__name__`, :attr:`~module.__doc__`, "

":attr:`~module.__package__` and :attr:`~module.__loader__` attributes are "

"filled in (all but :attr:`!__name__` are set to ``None``). The caller is "

"responsible for setting a :attr:`~module.__file__` attribute."

msgstr ""

"返回一个新的模块对象，该对象的 :attr:`module.__name__` 将设为 *name*。模块的 :attr:`!__name__`, "

":attr:`~module.__doc__`, :attr:`~module.__package__` 和 "

":attr:`~module.__loader__` 属性将被填充 (除 :attr:`!__name__` 外全都设为 ``None``)。 "

"调用方要负责设置 :attr:`~module.__file__` 属性。"

#: ../../c-api/module.rst:45 ../../c-api/module.rst:819

#: ../../c-api/module.rst:850

msgid "Return ``NULL`` with an exception set on error."

msgstr "当发生错误时将返回 ``NULL`` 并设置一个异常。"

#: ../../c-api/module.rst:49

msgid ""

":attr:`~module.__package__` and :attr:`~module.__loader__` are now set to "

"``None``."

msgstr ""

"现在 :attr:`~module.__package__` 和 :attr:`~module.__loader__` 将被设为 ``None``。"

#: ../../c-api/module.rst:56

msgid ""

"Similar to :c:func:`PyModule_NewObject`, but the name is a UTF-8 encoded "

"string instead of a Unicode object."

msgstr "这类似于 :c:func:`PyModule_NewObject`，但其名称为 UTF-8 编码的字符串而不是 Unicode 对象。"

#: ../../c-api/module.rst:64

msgid ""

"Return the dictionary object that implements *module*'s namespace; this "

"object is the same as the :attr:`~object.__dict__` attribute of the module "

"object. If *module* is not a module object (or a subtype of a module "

"object), :exc:`SystemError` is raised and ``NULL`` is returned."

msgstr ""

"返回实现 *module* 的命名空间的字典对象；此对象与模块对象的 :attr:`~object.__dict__` 属性相同。如果 *module*"

" 不是一个模块对象（或模块对象的子类型），则会引发 :exc:`SystemError` 并返回 ``NULL``。"

#: ../../c-api/module.rst:69

msgid ""

"It is recommended extensions use other ``PyModule_*`` and ``PyObject_*`` "

"functions rather than directly manipulate a module's "

":attr:`~object.__dict__`."

msgstr ""

"建议扩展使用其他 ``PyModule_*`` 和 ``PyObject_*`` 函数而不是直接操纵模块的 "

":attr:`~object.__dict__` 属性。"

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

msgid ""

"The returned reference is borrowed from the module; it is valid until the "

"module is destroyed."

msgstr "返回的引用是从模块借入的；它将保持可用直到模块被销毁。"

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

msgid ""

"Return *module*'s :attr:`~module.__name__` value. If the module does not "

"provide one, or if it is not a string, :exc:`SystemError` is raised and "

"``NULL`` is returned."

msgstr ""

"返回 *module* 的 :attr:`~module.__name__` 值。如果模块未提供该值，或者如果它不是一个字符串，则会引发 "

":exc:`SystemError` 并返回 ``NULL``。"

#: ../../c-api/module.rst:92

msgid ""

"Similar to :c:func:`PyModule_GetNameObject` but return the name encoded to "

"``'utf-8'``."

msgstr "类似于 :c:func:`PyModule_GetNameObject` 但返回 ``'utf-8'`` 编码的名称。"

#: ../../c-api/module.rst:95

msgid ""

"The returned buffer is only valid until the module is renamed or destroyed. "

"Note that Python code may rename a module by setting its "

":py:attr:`~module.__name__` attribute."

msgstr ""

"返回的缓冲区将保持可用直到模块被重命名或销毁。请注意 Python 代码可能会通过设置其 :py:attr:`~module.__name__` "

"属性来重命名一个模块。"

#: ../../c-api/module.rst:101

msgid ""

"Return a pointer to the :c:type:`PyModuleDef` struct from which the module "

"was created, or ``NULL`` if the module wasn't created from a definition."

msgstr ""

"返回指向模块创建所使用的 :c:type:`PyModuleDef` 结构体的指针，或者如果模块不是使用结构体定义创建的则返回 ``NULL``。"

#: ../../c-api/module.rst:104

msgid ""

"On error, return ``NULL`` with an exception set. Use "

":c:func:`PyErr_Occurred` to tell this case apart from a missing "

":c:type:`!PyModuleDef`."

msgstr ""

"出错时，返回 ``NULL`` 并设置一个异常。使用 :c:func:`PyErr_Occurred` 将这种情况与缺少 "

":c:type:`!PyModuleDef` 区分开来。"

#: ../../c-api/module.rst:115

msgid ""

"Return the name of the file from which *module* was loaded using *module*'s "

":attr:`~module.__file__` attribute. If this is not defined, or if it is not"

" a string, raise :exc:`SystemError` and return ``NULL``; otherwise return a "

"reference to a Unicode object."

msgstr ""

"返回使用 *module* 的 :attr:`~module.__file__` 属性所加载的 *module* 所对应的文件名。 "

"如果未定义该属性，或者如果它不是一个字符串，则会引发 :exc:`SystemError` 并返回 ``NULL``；在其他情况下将返回一个指向 "

"Unicode 对象的引用。"

#: ../../c-api/module.rst:125

msgid ""

"Similar to :c:func:`PyModule_GetFilenameObject` but return the filename "

"encoded to 'utf-8'."

msgstr "类似于 :c:func:`PyModule_GetFilenameObject` 但会返回编码为 'utf-8' 的文件名。"

#: ../../c-api/module.rst:128

msgid ""

"The returned buffer is only valid until the module's "

":py:attr:`~module.__file__` attribute is reassigned or the module is "

"destroyed."

msgstr "返回的缓冲区将保持可用直到模块的 :py:attr:`~module.__file__` 属性被重新赋值或模块被销毁。"

#: ../../c-api/module.rst:131

msgid ""

":c:func:`PyModule_GetFilename` raises :exc:`UnicodeEncodeError` on "

"unencodable filenames, use :c:func:`PyModule_GetFilenameObject` instead."

msgstr ""

":c:func:`PyModule_GetFilename` 对于不可编码的文件名会引发 :exc:`UnicodeEncodeError`，请改用 "

":c:func:`PyModule_GetFilenameObject` 函数。"

#: ../../c-api/module.rst:140

msgid "Module definition"

msgstr "模块定义"

#: ../../c-api/module.rst:142

msgid ""

"Modules created using the C API are typically defined using an array of "

":c:type:`PySlot` structs, which provides a \"description\" of how a module "

"should be created. See :ref:`capi-slots` for more information on slots in "

"general."

msgstr ""

"使用 C API 创建的模块通常是用 :c:type:`PySlot` 结构体的数组来定义的，它提供了一个模块应当如何被创建的“描述”。 请参阅 "

":ref:`capi-slots` 获取有关槽位的更多通用信息。"

#: ../../c-api/module.rst:149

msgid ""

"Previously, a :c:type:`PyModuleDef` struct was necessary to define modules. "

"The older way of defining modules is still available: consult either the "

":ref:`pymoduledef` section or earlier versions of this documentation if you "

"plan to support earlier Python versions."

msgstr ""

#: ../../c-api/module.rst:154

msgid ""

"The slots array is usually used to define an extension module's “main” "

"module object (see :ref:`extension-modules` for details). It can also be "

"used to :ref:`create extension modules dynamically <module-from-slots>`."

msgstr ""

#: ../../c-api/module.rst:159

msgid ""

"Unless specified otherwise, the same slot ID may not be repeated in an array"

" of slots."

msgstr ""

#: ../../c-api/module.rst:164

msgid "Metadata slots"

msgstr ""

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

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` for the name of the new module, as a NUL-"

"terminated UTF8-encoded ``const char *``."

msgstr ""

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

msgid ""

"Note that modules are typically created using a "

":py:class:`~importlib.machinery.ModuleSpec`, and when they are, the name "

"from the spec will be used instead of :c:data:`!Py_mod_name`. However, it is"

" still recommended to include this slot for introspection and debugging "

"purposes."

msgstr ""

#: ../../c-api/module.rst:179

msgid ""

"Use :c:member:`PyModuleDef.m_name` instead to support previous versions."

msgstr ""

#: ../../c-api/module.rst:183

msgid ""

":c:type:`Slot ID <PySlot.sl_id>` for the docstring of the new module, as a "

"NUL-terminated UTF8-encoded ``const char *``."

msgstr ""

#: ../../c-api/module.rst:186

msgid "Usually it is set to a variable created with :c:macro:`PyDoc_STRVAR`."

msgstr ""

#: ../../c-api/module.rst:190

msgid ""

"Use :c:member:`PyModuleDef.m_doc` instead to support previous versions."

msgstr ""

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

msgid "Feature slots"

msgstr ""

#: ../../c-api/module.rst:198

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` whose value points to a "

":c:struct:`PyABIInfo` structure describing the ABI that the extension is "

"using."

msgstr ""

#: ../../c-api/module.rst:202

msgid ""

"A suitable :c:struct:`!PyABIInfo` variable can be defined using the "

":c:macro:`PyABIInfo_VAR` macro, as in:"

msgstr ""

#: ../../c-api/module.rst:205

msgid ""

"PyABIInfo_VAR(abi_info);\n"

"\n"

"static PySlot mymodule_slots[] = {\n"

" PySlot_DATA(Py_mod_abi, &abi_info),\n"

" ...\n"

"};"

msgstr ""

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

msgid ""

"When creating a module, Python checks the value of this slot using "

":c:func:`PyABIInfo_Check`."

msgstr ""

#: ../../c-api/module.rst:217

msgid ""

"This slot is required, except for modules created from "

":c:struct:`PyModuleDef`."

msgstr ""

#: ../../c-api/module.rst:224 ../../c-api/module.rst:254

msgid ":c:member:`Slot ID <PySlot.sl_id>` whose value is one of:"

msgstr ""

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

msgid "The module does not support being imported in subinterpreters."

msgstr "该模块不支持在子解释器中导入。"

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

msgid ""

"The module supports being imported in subinterpreters, but only when they "

"share the main interpreter's GIL. (See :ref:`isolating-extensions-howto`.)"

msgstr ""

"该模块支持在子解释器中导入，但是它们必须要共享主解释器的 GIL。 （参见 :ref:`isolating-extensions-howto`。）"

#: ../../c-api/module.rst:240

msgid ""

"The module supports being imported in subinterpreters, even when they have "

"their own GIL. (See :ref:`isolating-extensions-howto`.)"

msgstr "该模块支持在子解释器中导入，即使它们有自己的 GIL。 （参见 :ref:`isolating-extensions-howto`。）"

#: ../../c-api/module.rst:244

msgid ""

"This slot determines whether or not importing this module in a "

"subinterpreter will fail."

msgstr "此槽位决定在子解释器中导入此模块是否会失败。"

#: ../../c-api/module.rst:247

msgid ""

"If ``Py_mod_multiple_interpreters`` is not specified, the import machinery "

"defaults to ``Py_MOD_MULTIPLE_INTERPRETERS_SUPPORTED``."

msgstr ""

"如果未指定 ``Py_mod_multiple_interpreters``，则导入机制默认为 "

"``Py_MOD_MULTIPLE_INTERPRETERS_SUPPORTED`` 值。"

#: ../../c-api/module.rst:260

msgid ""

"The module depends on the presence of the global interpreter lock (GIL), and"

" may access global state without synchronization."

msgstr "这个模块依赖于全局解释器锁 (GIL) 的存在，并可在无需同步的情况下访问全局状态。"

#: ../../c-api/module.rst:265

msgid "The module is safe to run without an active GIL."

msgstr "这个模块可以在不激活 GIL 的情况下安全运行。"

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

msgid ""

"This slot is ignored by Python builds not configured with "

":option:`--disable-gil`. Otherwise, it determines whether or not importing "

"this module will cause the GIL to be automatically enabled. See "

":ref:`whatsnew313-free-threaded-cpython` for more detail."

msgstr ""

"这个槽位会被未配置 :option:`--disable-gil` 的 Python 构建版所忽略。在其他情况下，它将决定导入此模块是否会导致 GIL "

"被自动启用。请参阅 :ref:`whatsnew313-free-threaded-cpython` 了解详情。"

#: ../../c-api/module.rst:272

msgid ""

"If ``Py_mod_gil`` is not specified, the import machinery defaults to "

"``Py_MOD_GIL_USED``."

msgstr "如果未指定 ``Py_mod_gil``，则导入机制默认为 ``Py_MOD_GIL_USED``。"

#: ../../c-api/module.rst:279

msgid "Creation and initialization slots"

msgstr ""

#: ../../c-api/module.rst:283

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` for a function that creates the module "

"object itself. The function must have the signature:"

msgstr ""

#: ../../c-api/module.rst:291

msgid "The function will be called with:"

msgstr ""

#: ../../c-api/module.rst:293

msgid ""

"*spec*: a ``ModuleSpec``-like object, meaning that any attributes defined "

"for :py:class:`importlib.machinery.ModuleSpec` have matching semantics. "

"However, any of the attributes may be missing."

msgstr ""

#: ../../c-api/module.rst:296

msgid ""

"*def*: ``NULL``, or the module definition if the module is created from one."

msgstr ""

#: ../../c-api/module.rst:298

msgid ""

"The function should return a new module object, or set an error and return "

"``NULL``."

msgstr ""

#: ../../c-api/module.rst:301

msgid ""

"This function should be kept minimal. In particular, it should not call "

"arbitrary Python code, as trying to import the same module again may result "

"in an infinite loop."

msgstr "此函数应当保持最小化。特别地，它不应当调用任意 Python 代码，因为尝试再次导入同一个模块可能会导致无限循环。"

#: ../../c-api/module.rst:305

msgid ""

"If ``Py_mod_create`` is not specified, the import machinery will create a "

"normal module object using :c:func:`PyModule_New`. The name is taken from "

"*spec*, not the definition, to allow extension modules to dynamically adjust"

" to their place in the module hierarchy and be imported under different "

"names through symlinks, all while sharing a single module definition."

msgstr ""

"如果未指定 ``Py_mod_create``，导入机制将使用 :c:func:`PyModule_New` 创建一个普通的模块对象。名称是获取自 "

"*spec* 而非定义，以允许扩展模块动态地调整它们在模块层级结构中的位置并通过符号链接以不同的名称被导入，同时共享同一个模块定义。"

#: ../../c-api/module.rst:311

msgid ""

"There is no requirement for the returned object to be an instance of "

":c:type:`PyModule_Type`. However, some slots may only be used with "

":c:type:`!PyModule_Type` instances; in particular:"

msgstr ""

#: ../../c-api/module.rst:316

msgid ":c:macro:`Py_mod_exec`,"

msgstr ""

#: ../../c-api/module.rst:317

msgid ""

":ref:`module state slots <ext-module-state-slots>` (``Py_mod_state_*``),"

msgstr ""

#: ../../c-api/module.rst:318

msgid ":c:macro:`Py_mod_token`."

msgstr ""

#: ../../c-api/module.rst:324

msgid ""

"The *slots* argument may be a ``ModuleSpec``-like object, rather than a true"

" :py:class:`~importlib.machinery.ModuleSpec` instance. Note that previous "

"versions of CPython did not enforce this."

msgstr ""

#: ../../c-api/module.rst:328

msgid ""

"The *def* argument may now be ``NULL``, since modules are not necessarily "

"made from definitions."

msgstr ""

#: ../../c-api/module.rst:333

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` for a function that will :dfn:`execute`, "

"or initialize, the module. This function does the equivalent to executing "

"the code of a Python module: typically, it adds classes and constants to the"

" module. The signature of the function is:"

msgstr ""

#: ../../c-api/module.rst:343

msgid ""

"See the :ref:`capi-module-support-functions` section for some useful "

"functions to call."

msgstr ""

#: ../../c-api/module.rst:346

msgid ""

"For backwards compatibility, the :c:type:`PyModuleDef.m_slots` array may "

"contain multiple :c:macro:`!Py_mod_exec` slots; these are processed in the "

"order they appear in the array. Elsewhere (that is, in arguments to "

":c:func:`PyModule_FromSlotsAndSpec` and in return values of "

":samp:`PyModExport_{<name>}`), repeating the slot is not allowed."

msgstr ""

#: ../../c-api/module.rst:357

msgid ""

"Repeated ``Py_mod_exec`` slots are disallowed, except in "

":c:type:`PyModuleDef.m_slots`."

msgstr ""

#: ../../c-api/module.rst:362

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` for a table of module-level functions, as"

" an array of :c:type:`PyMethodDef` values suitable as the *functions* "

"argument to :c:func:`PyModule_AddFunctions`."

msgstr ""

#: ../../c-api/module.rst:366

msgid ""

"Like other slot IDs, a slots array may only contain one "

":c:macro:`!Py_mod_methods` entry. To add functions from multiple "

":c:type:`PyMethodDef` arrays, call :c:func:`PyModule_AddFunctions` in the "

":c:macro:`Py_mod_exec` function."

msgstr ""

#: ../../c-api/module.rst:371

msgid ""

"The table must be statically allocated (or otherwise guaranteed to outlive "

"the module object)."

msgstr ""

#: ../../c-api/module.rst:376

msgid ""

"Use :c:member:`PyModuleDef.m_methods` instead to support previous versions."

msgstr ""

#: ../../c-api/module.rst:381

msgid "Module state"

msgstr ""

#: ../../c-api/module.rst:383

msgid ""

"Extension modules can have *module state* -- a piece of memory that is "

"allocated on module creation, and freed when the module object is "

"deallocated. The module state is specified using :ref:`dedicated slots <ext-"

"module-state-slots>`."

msgstr ""

#: ../../c-api/module.rst:388

msgid ""

"A typical use of module state is storing an exception type -- or indeed "

"*any* type object defined by the module --"

msgstr ""

#: ../../c-api/module.rst:391

msgid ""

"Unlike the module's Python attributes, Python code cannot replace or delete "

"data stored in module state."

msgstr ""

#: ../../c-api/module.rst:394

msgid ""

"Keeping per-module information in attributes and module state, rather than "

"in static globals, makes module objects *isolated* and safer for use in "

"multiple sub-interpreters. It also helps Python do an orderly clean-up when "

"it shuts down."

msgstr ""

#: ../../c-api/module.rst:399

msgid ""

"Extensions that keep references to Python objects as part of module state "

"must implement :c:macro:`Py_mod_state_traverse` and "

":c:macro:`Py_mod_state_clear` functions to avoid reference leaks."

msgstr ""

#: ../../c-api/module.rst:403

msgid ""

"To retrieve the state from a given module, use the following functions:"

msgstr ""

#: ../../c-api/module.rst:407

msgid ""

"Return the \"state\" of the module, that is, a pointer to the block of "

"memory allocated at module creation time, or ``NULL``. See "

":c:macro:`Py_mod_state_size`."

msgstr ""

#: ../../c-api/module.rst:411

msgid ""

"On error, return ``NULL`` with an exception set. Use "

":c:func:`PyErr_Occurred` to tell this case apart from missing module state."

msgstr ""

#: ../../c-api/module.rst:418

msgid ""

"Set *\\*result* to the size of *module*'s state, as specified using "

":c:macro:`Py_mod_state_size` (or :c:member:`PyModuleDef.m_size`), and return"

" 0."

msgstr ""

#: ../../c-api/module.rst:422

msgid "On error, set *\\*result* to -1, and return -1 with an exception set."

msgstr ""

#: ../../c-api/module.rst:431

msgid "Slots for defining module state"

msgstr ""

#: ../../c-api/module.rst:433

msgid ""

"The following :c:member:`slot IDs <PySlot.sl_id>` are available for "

"defining the module state."

msgstr ""

#: ../../c-api/module.rst:438

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` for the size of the module state, in "

"bytes."

msgstr ""

#: ../../c-api/module.rst:441

msgid ""

"Setting the value to a non-negative value means that the module can be re-"

"initialized and specifies the additional amount of memory it requires for "

"its state."

msgstr ""

#: ../../c-api/module.rst:445

msgid "See :PEP:`3121` for more details."

msgstr "请参阅 :PEP:`3121` 了解详情。"

#: ../../c-api/module.rst:447

msgid ""

"Use :c:func:`PyModule_GetStateSize` to retrieve the size of a given module."

msgstr ""

#: ../../c-api/module.rst:451 ../../c-api/module.rst:474

msgid ""

"Use :c:member:`PyModuleDef.m_size` instead to support previous versions."

msgstr ""

#: ../../c-api/module.rst:455

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` for a traversal function to call during "

"GC traversal of the module object."

msgstr ""

#: ../../c-api/module.rst:458

msgid ""

"The signature of the function, and meanings of the arguments, is similar as "

"for :c:member:`PyTypeObject.tp_traverse`:"

msgstr ""

#: ../../c-api/module.rst:465 ../../c-api/module.rst:487

#: ../../c-api/module.rst:515

msgid ""

"This function is not called if the module state was requested but is not "

"allocated yet. This is the case immediately after the module is created and "

"before the module is executed (:c:data:`Py_mod_exec` function). More "

"precisely, this function is not called if the state size "

"(:c:data:`Py_mod_state_size`) is greater than 0 and the module state (as "

"returned by :c:func:`PyModule_GetState`) is ``NULL``."

msgstr ""

#: ../../c-api/module.rst:478

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` for a clear function to call during GC "

"clearing of the module object."

msgstr ""

#: ../../c-api/module.rst:481 ../../c-api/module.rst:509

msgid "The signature of the function is:"

msgstr ""

#: ../../c-api/module.rst:494

msgid ""

"Like :c:member:`PyTypeObject.tp_clear`, this function is not *always* called"

" before a module is deallocated. For example, when reference counting is "

"enough to determine that an object is no longer used, the cyclic garbage "

"collector is not involved and the :c:macro:`Py_mod_state_free` function is "

"called directly."

msgstr ""

#: ../../c-api/module.rst:502

msgid ""

"Use :c:member:`PyModuleDef.m_clear` instead to support previous versions."

msgstr ""

#: ../../c-api/module.rst:506

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` for a function to call during "

"deallocation of the module object."

msgstr ""

#: ../../c-api/module.rst:524

msgid ""

"Use :c:member:`PyModuleDef.m_free` instead to support previous versions."

msgstr ""

#: ../../c-api/module.rst:530

msgid "Module token"

msgstr ""

#: ../../c-api/module.rst:532

msgid ""

"Each module may have an associated *token*: a pointer-sized value intended "

"to identify of the module state's memory layout. This means that if you have"

" a module object, but you are not sure if it “belongs” to your extension, "

"you can check using code like this:"

msgstr ""

#: ../../c-api/module.rst:537

msgid ""

"PyObject *module = <the module in question>\n"

"\n"

"void *module_token;\n"

"if (PyModule_GetToken(module, &module_token) < 0) {\n"

" return NULL;\n"

"}\n"

"if (module_token != your_token) {\n"

" PyErr_SetString(PyExc_ValueError, \"unexpected module\")\n"

" return NULL;\n"

"}\n"

"\n"

"// This module's state has the expected memory layout; it's safe to cast\n"

"struct my_state state = (struct my_state*)PyModule_GetState(module)"

msgstr ""

#: ../../c-api/module.rst:553

msgid ""

"A module's token -- and the *your_token* value to use in the above code -- "

"is:"

msgstr ""

#: ../../c-api/module.rst:555

msgid ""

"For modules created with :c:type:`PyModuleDef`: the address of that "

":c:type:`PyModuleDef`;"

msgstr ""

#: ../../c-api/module.rst:557

msgid ""

"For modules defined with the :c:macro:`Py_mod_token` slot: the value of that"

" slot;"

msgstr ""

#: ../../c-api/module.rst:559

msgid ""

"For modules created from an ``PyModExport_*`` :ref:`export hook <extension-"

"export-hook>`: the slots array that the export hook returned (unless "

"overridden with :c:macro:`Py_mod_token`)."

msgstr ""

#: ../../c-api/module.rst:565

msgid ":c:member:`Slot ID <PySlot.sl_id>` for the module token."

msgstr ""

#: ../../c-api/module.rst:567

msgid ""

"If you use this slot to set the module token (rather than rely on the "

"default), you must ensure that:"

msgstr ""

#: ../../c-api/module.rst:570

msgid ""

"The pointer outlives the class, so it's not reused for something else while "

"the class exists."

msgstr "指针的寿命比类长，所以当类存在时，指针不能用于其他用途。"

#: ../../c-api/module.rst:572

msgid ""

"It \"belongs\" to the extension module where the class lives, so it will not"

" clash with other extensions."

msgstr "它“属于”类所在的扩展模块，因此它不会与其他扩展冲突。"

#: ../../c-api/module.rst:574

msgid ""

"If the token points to a :c:type:`PyModuleDef` struct, the module should "

"behave as if it was created from that :c:type:`PyModuleDef`. In particular, "

"the module state must have matching layout and semantics."

msgstr ""

#: ../../c-api/module.rst:578

msgid ""

"Modules created from :c:type:`PyModuleDef` always use the address of the "

":c:type:`PyModuleDef` as the token. This means that :c:macro:`!Py_mod_token`"

" cannot be used in :c:member:`PyModuleDef.m_slots`."

msgstr ""

#: ../../c-api/module.rst:587

msgid "Set *\\*result* to the module token for *module* and return 0."

msgstr ""

#: ../../c-api/module.rst:589

msgid "On error, set *\\*result* to NULL, and return -1 with an exception set."

msgstr ""

#: ../../c-api/module.rst:593

msgid "See also :c:func:`PyType_GetModuleByToken`."

msgstr ""

#: ../../c-api/module.rst:599

msgid "Creating extension modules dynamically"

msgstr "动态创建扩展模块"

#: ../../c-api/module.rst:601

msgid ""

"The following functions may be used to create an extension module "

"dynamically, rather than from an extension's :ref:`export hook <extension-"

"export-hook>`."

msgstr ""

#: ../../c-api/module.rst:606

msgid ""

"Create a new module object, given an array of :ref:`slots "

"<pymoduledef_slot>` and the :py:class:`~importlib.machinery.ModuleSpec` "

"*spec*."

msgstr ""

#: ../../c-api/module.rst:609

msgid ""

"The *slots* argument must point to an array of :c:type:`PySlot` structures, "

"terminated by an entry with slot ID of 0 (typically written as "

":c:macro:`PySlot_END`). The array must include a :c:data:`Py_mod_abi` entry."

msgstr ""

#: ../../c-api/module.rst:614

msgid ""

"The *spec* argument may be any ``ModuleSpec``-like object, as described in "

":c:macro:`Py_mod_create` documentation. Currently, the *spec* must have a "

"``name`` attribute."

msgstr ""

#: ../../c-api/module.rst:618

msgid ""

"On success, return the new module. On error, return ``NULL`` with an "

"exception set."

msgstr ""

#: ../../c-api/module.rst:621

msgid ""

"Note that this does not process the module's execution slot "

"(:c:data:`Py_mod_exec`). Both :c:func:`!PyModule_FromSlotsAndSpec` and "

":c:func:`PyModule_Exec` must be called to fully initialize a module. (See "

"also :ref:`multi-phase-initialization`.)"

msgstr ""

#: ../../c-api/module.rst:631

msgid "Execute the :c:data:`Py_mod_exec` slot(s) of *module*."

msgstr ""

#: ../../c-api/module.rst:633

msgid "On success, return 0. On error, return -1 with an exception set."

msgstr ""

#: ../../c-api/module.rst:636

msgid ""

"For clarity: If *module* has no slots, for example if it uses :ref:`legacy "

"single-phase initialization <single-phase-initialization>`, this function "

"does nothing and returns 0."

msgstr ""

#: ../../c-api/module.rst:647

msgid "Module definition struct"

msgstr ""

#: ../../c-api/module.rst:649

msgid ""

"Traditionally, extension modules were defined using a *module definition* as"

" the “description\" of how a module should be created. Rather than using an "

"array of :ref:`slots <pymoduledef_slot>` directly, the definition has "

"dedicated members for most common functionality, and allows additional slots"

" as an extension mechanism."

msgstr ""

#: ../../c-api/module.rst:655

msgid ""

"This way of defining modules is still available and there are no plans to "

"remove it."

msgstr ""

#: ../../c-api/module.rst:660

msgid ""

"The module definition struct, which holds information needed to create a "

"module object."

msgstr ""

#: ../../c-api/module.rst:663

msgid ""

"This structure must be statically allocated (or be otherwise guaranteed to "

"be valid while any modules created from it exist). Usually, there is only "

"one variable of this type for each extension module defined this way."

msgstr ""

#: ../../c-api/module.rst:668

msgid ""

"The struct, including all members, is part of the :ref:`Stable ABI <stable-"

"abi>` for non-free-threaded builds (``abi3``). In the Stable ABI for free-"

"threaded builds (``abi3t``), this struct is opaque, and unusable in "

"practice; see :ref:`pymoduledef_slot` for a replacement."

msgstr ""

#: ../../c-api/module.rst:676

msgid "Always initialize this member to :c:macro:`PyModuleDef_HEAD_INIT`:"

msgstr ""

#: ../../c-api/module.rst:682

msgid "The type of :c:member:`!PyModuleDef.m_base`."

msgstr ""

#: ../../c-api/module.rst:684

msgid ""

"The struct is part of the :ref:`Stable ABI <stable-abi>` for non-free-"

"threaded builds (``abi3``). In the Stable ABI for Free-Threaded Builds "

"(``abi3t``), this struct is opaque, and unusable in practice."

msgstr ""

#: ../../c-api/module.rst:691

msgid "The required initial value for :c:member:`!PyModuleDef.m_base`."

msgstr ""

#: ../../c-api/module.rst:695

msgid "Corresponds to the :c:macro:`Py_mod_name` slot."

msgstr ""

#: ../../c-api/module.rst:699

msgid ""

"These members correspond to the :c:macro:`Py_mod_doc` slot. Setting this to "

"NULL is equivalent to omitting the slot."

msgstr ""

#: ../../c-api/module.rst:704

msgid ""

"Corresponds to the :c:macro:`Py_mod_state_size` slot. Setting this to zero "

"is equivalent to omitting the slot."

msgstr ""

#: ../../c-api/module.rst:707

msgid ""

"When using :ref:`legacy single-phase initialization <single-phase-"

"initialization>` or when creating modules dynamically using "

":c:func:`PyModule_Create` or :c:func:`PyModule_Create2`, :c:member:`!m_size`"

" may be set to -1. This indicates that the module does not support sub-"

"interpreters, because it has global state."

msgstr ""

#: ../../c-api/module.rst:715

msgid ""

"Corresponds to the :c:macro:`Py_mod_methods` slot. Setting this to NULL is "

"equivalent to omitting the slot."

msgstr ""

#: ../../c-api/module.rst:720

msgid ""

"An array of additional slots, terminated by a ``{0, NULL}`` entry. Note that"

" the entries use the older :c:type:`PyModuleDef_Slot` structure, rather than"

" :c:type:`PySlot`."

msgstr ""

#: ../../c-api/module.rst:724

msgid ""

"If the array contains slots corresponding to :c:type:`PyModuleDef` members, "

"the values must match. For example, if you use :c:macro:`Py_mod_name` in "

":c:member:`!m_slots`, :c:member:`PyModuleDef.m_name` must be set to the same"

" pointer (not just an equal string)."

msgstr ""

#: ../../c-api/module.rst:732

msgid ""

"Prior to version 3.5, this member was always set to ``NULL``, and was "

"defined as:"

msgstr "在 3.5 版之前，此成员总是被设为 ``NULL``，并被定义为："

#: ../../c-api/module.rst:741

msgid "Older structure defining additional slots of a module."

msgstr ""

#: ../../c-api/module.rst:743

msgid ""

"Note that a :c:type:`!PyModuleDef_Slot` array may be included in a "

":c:type:`!PySlot` array using :c:macro:`Py_mod_slots`, and vice versa using "

":c:macro:`Py_slot_subslots`."

msgstr ""

#: ../../c-api/module.rst:747

msgid ""

"Each :c:type:`!PyModuleDef_Slot` structure ``modslot`` is interpreted as the"

" following :c:type:`PySlot` structure::"

msgstr ""

#: ../../c-api/module.rst:750

msgid ""

"(PySlot){\n"

" .sl_id=modslot.slot,\n"

" .sl_flags=PySlot_INTPTR | sub_static,\n"

" .sl_ptr=modslot.value\n"

"}"

msgstr ""

#: ../../c-api/module.rst:756

msgid ""

"where ``sub_static`` is ``PySlot_STATIC`` if the slot requires the flag "

"(such as for :c:macro:`Py_mod_methods`), or if this flag is present on the "

"\"parent\" :c:macro:`!Py_mod_slots` slot (if any)."

msgstr ""

#: ../../c-api/module.rst:762

msgid "Corresponds to :c:member:`PySlot.sl_id`."

msgstr ""

#: ../../c-api/module.rst:766

msgid "Corresponds to :c:member:`PySlot.sl_ptr`."

msgstr ""

#: ../../c-api/module.rst:774

msgid ""

"These members correspond to the :c:macro:`Py_mod_state_traverse`, "

":c:macro:`Py_mod_state_clear`, and :c:macro:`Py_mod_state_free` slots, "

"respectively."

msgstr ""

#: ../../c-api/module.rst:778

msgid ""

"Setting these members to NULL is equivalent to omitting the corresponding "

"slots."

msgstr ""

#: ../../c-api/module.rst:783

msgid ""

":c:member:`m_traverse`, :c:member:`m_clear` and :c:member:`m_free` functions"

" are no longer called before the module state is allocated."

msgstr ""

#: ../../c-api/module.rst:789

msgid "The type of ``PyModuleDef`` objects."

msgstr "``PyModuleDef`` 对象的类型。"

#: ../../c-api/module.rst:794

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` that works like "

":c:macro:`Py_slot_subslots`, except it specifies an array of "

":c:type:`PyModuleDef_Slot` structures."

msgstr ""

#: ../../c-api/module.rst:802

msgid ""

"The following API can be used to create modules from a "