# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001-2023, Python Software Foundation

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

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

#

# Translators:

# 汪心禾 <wangxinhe06@gmail.com>, 2019

# Alpha Du <alphanow@gmail.com>, 2019

# Lordran <xuzhaoyang1990@live.cn>, 2019

# zeroswan <zeroswan@outlook.com>, 2020

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

#

#, fuzzy

msgid ""

msgstr ""

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

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

"POT-Creation-Date: 2023-02-24 14:40+0000\n"

"PO-Revision-Date: 2019-09-01 03:41+0000\n"

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

"Language-Team: Chinese (China) (https://www.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"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:6

msgid "Importing Modules"

msgstr "导入模块"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:16

msgid ""

"This is a simplified interface to :c:func:`PyImport_ImportModuleEx` below, "

"leaving the *globals* and *locals* arguments set to ``NULL`` and *level* set"

" to 0. When the *name* argument contains a dot (when it specifies a "

"submodule of a package), the *fromlist* argument is set to the list "

"``['*']`` so that the return value is the named module rather than the top-"

"level package containing it as would otherwise be the case. (Unfortunately,"

" this has an additional side effect when *name* in fact specifies a "

"subpackage instead of a submodule: the submodules specified in the package's"

" ``__all__`` variable are loaded.) Return a new reference to the imported "

"module, or ``NULL`` with an exception set on failure. A failing import of a"

" module doesn't leave the module in :data:`sys.modules`."

msgstr ""

"这是下面 :c:func:`PyImport_ImportModuleEx` 的简化版接口，将 *globals* 和 *locals* 参数设为 "

"``NULL`` 并将 *level* 设为 0。 当 *name* 参数包含一个点号（即指定了一个包的子模块）时，*fromlist* "

"参数会被设为列表 ``['*']`` 这样返回值将为所指定的模块而不像在其他情况下那样为包含模块的最高层级包。 （不幸的是，这在 *name* "

"实际上是指定一个子包而非子模块时将有一个额外的副作用：在包的 ``__all__`` 变量中指定的子模块会被加载。） "

"返回一个对所导入模块的新引用，或是在导入失败时返回 ``NULL`` 并设置一个异常。 模块导入失败同模块不会留 在 "

":data:`sys.modules` 中。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:28

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:89

msgid "This function always uses absolute imports."

msgstr "该函数总是使用绝对路径导入。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:33

msgid ""

"This function is a deprecated alias of :c:func:`PyImport_ImportModule`."

msgstr "该函数是 :c:func:`PyImport_ImportModule` 的一个被遗弃的别名。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:35

msgid ""

"This function used to fail immediately when the import lock was held by "

"another thread. In Python 3.3 though, the locking scheme switched to per-"

"module locks for most purposes, so this function's special behaviour isn't "

"needed anymore."

msgstr ""

"在导入锁被另一线程掌控时此函数会立即失败。 但是从 Python 3.3 "

"起，锁方案在大多数情况下都已切换为针对每个模块加锁，所以此函数的特殊行为已无必要。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:46

msgid ""

"Import a module. This is best described by referring to the built-in Python"

" function :func:`__import__`."

msgstr "导入一个模块。 请参阅内置 Python 函数 :func:`__import__` 获取完善的相关描述。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:49

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:65

msgid ""

"The return value is a new reference to the imported module or top-level "

"package, or ``NULL`` with an exception set on failure. Like for "

":func:`__import__`, the return value when a submodule of a package was "

"requested is normally the top-level package, unless a non-empty *fromlist* "

"was given."

msgstr ""

"返回值是一个对所导入模块或最高层级包的新引用，或是在导入失败时则为 ``NULL`` 并设置一个异常。 与 :func:`__import__` "

"类似，当请求一个包的子模块时返回值通常为该最高层级包，除非给出了一个非空的 *fromlist*。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:55

msgid ""

"Failing imports remove incomplete module objects, like with "

":c:func:`PyImport_ImportModule`."

msgstr "导入失败将移动不完整的模块对象，就像 :c:func:`PyImport_ImportModule` 那样。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:61

msgid ""

"Import a module. This is best described by referring to the built-in Python"

" function :func:`__import__`, as the standard :func:`__import__` function "

"calls this function directly."

msgstr ""

"导入一个模块。 关于此函数的最佳说明请参考内置 Python 函数 :func:`__import__`，因为标准 :func:`__import__`"

" 函数会直接调用此函数。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:75

msgid ""

"Similar to :c:func:`PyImport_ImportModuleLevelObject`, but the name is a "

"UTF-8 encoded string instead of a Unicode object."

msgstr ""

"类似于 :c:func:`PyImport_ImportModuleLevelObject`，但其名称为 UTF-8 编码的字符串而不是 Unicode"

" 对象。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:78

msgid "Negative values for *level* are no longer accepted."

msgstr "不再接受 *level* 为负数值。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:83

msgid ""

"This is a higher-level interface that calls the current \"import hook "

"function\" (with an explicit *level* of 0, meaning absolute import). It "

"invokes the :func:`__import__` function from the ``__builtins__`` of the "

"current globals. This means that the import is done using whatever import "

"hooks are installed in the current environment."

msgstr ""

"这是一个调用了当前“导入钩子函数”的更高层级接口（显式指定 *level* 为 0，表示绝对导入）。 它将发起调用当前全局作用域下 "

"``__builtins__`` 中的 :func:`__import__` 函数。 这意味着将使用当前环境下安装的任何导入钩子来完成导入。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:94

msgid ""

"Reload a module. Return a new reference to the reloaded module, or ``NULL``"

" with an exception set on failure (the module still exists in this case)."

msgstr "重载一个模块。 返回一个指向被重载模块的新引用，或者在失败时返回 ``NULL`` 并设置一个异常（在此情况下模块仍然会存在）。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:100

msgid ""

"Return the module object corresponding to a module name. The *name* "

"argument may be of the form ``package.module``. First check the modules "

"dictionary if there's one there, and if not, create a new one and insert it "

"in the modules dictionary. Return ``NULL`` with an exception set on failure."

msgstr ""

"返回对应于某个模块名称的模块对象。 *name* 参数的形式可以为 ``package.module``。 如果存在 modules "

"字典则首先检查该字典，如果找不到，则创建一个新模块并将其插入到 modules 字典。 在失败时返回 ``NULL`` 并设置一个异常。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:107

msgid ""

"This function does not load or import the module; if the module wasn't "

"already loaded, you will get an empty module object. Use "

":c:func:`PyImport_ImportModule` or one of its variants to import a module. "

"Package structures implied by a dotted name for *name* are not created if "

"not already present."

msgstr ""

"此函数不会加载或导入指定模块；如果模块还未被加载，你将得到一个空的模块对象。 请使用 :c:func:`PyImport_ImportModule` "

"或它的某个变体形式来导入模块。 *name* 使用带点号名称的包结构如果尚不存在则不会被创建。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:117

msgid ""

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

"encoded string instead of a Unicode object."

msgstr ""

"类似于 :c:func:`PyImport_AddModuleObject`，但其名称为 UTF-8 编码的字符串而不是 Unicode "

"对象。object."

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:125

msgid ""

"Given a module name (possibly of the form ``package.module``) and a code "

"object read from a Python bytecode file or obtained from the built-in "

"function :func:`compile`, load the module. Return a new reference to the "

"module object, or ``NULL`` with an exception set if an error occurred. "

"*name* is removed from :attr:`sys.modules` in error cases, even if *name* "

"was already in :attr:`sys.modules` on entry to "

":c:func:`PyImport_ExecCodeModule`. Leaving incompletely initialized modules"

" in :attr:`sys.modules` is dangerous, as imports of such modules have no way"

" to know that the module object is an unknown (and probably damaged with "

"respect to the module author's intents) state."

msgstr ""

"给定一个模块名称（可能为 ``package.module`` 形式）和一个从 Pyhon 字节码文件读取或从内置函数 :func:`compile` "

"获取的代码对象，加载该模块。 返回对该模块对象的新引用，或者如果发生错误则返回 ``NULL`` 并设置一个异常。 在发生错误的情况下 *name* "

"会从 :attr:`sys.modules` 中被移除，即使 *name* 在进入 :c:func:`PyImport_ExecCodeModule` "

"时已存在于 :attr:`sys.modules` 中。 在 :attr:`sys.modules` "

"中保留未完全初始化的模块是危险的，因为导入这样的模块没有办法知道模块对象是否处于一种未知的（对于模块作业的意图来说可能是已损坏的）状态。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:135

msgid ""

"The module's :attr:`__spec__` and :attr:`__loader__` will be set, if not set"

" already, with the appropriate values. The spec's loader will be set to the"

" module's ``__loader__`` (if set) and to an instance of "

":class:`SourceFileLoader` otherwise."

msgstr ""

"模块的 :attr:`__spec__` 和 :attr:`__loader__` 如果尚未设置的话，将被设置为适当的值。 相应 spec "

"的加载器（如果已设置）将被设为模块的 ``__loader__`` 而在其他情况下设为 :class:`SourceFileLoader` 的实例。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:140

msgid ""

"The module's :attr:`__file__` attribute will be set to the code object's "

":c:member:`co_filename`. If applicable, :attr:`__cached__` will also be "

"set."

msgstr ""

"模块的 :attr:`__file__` 属性将被设为代码对象的 :c:member:`co_filename`。 "

"如果适用，:attr:`__cached__` 也将被设置。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:144

msgid ""

"This function will reload the module if it was already imported. See "

":c:func:`PyImport_ReloadModule` for the intended way to reload a module."

msgstr "如果模块已被导入则此函数将重载它。 请参阅 :c:func:`PyImport_ReloadModule` 了解重载模块的预定方式。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:147

msgid ""

"If *name* points to a dotted name of the form ``package.module``, any "

"package structures not already created will still not be created."

msgstr "如果 *name* 指向一个形式为 ``package.module`` 的带点号的名称，则任何尚未创建的包结构仍然不会被创建。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:150

msgid ""

"See also :c:func:`PyImport_ExecCodeModuleEx` and "

":c:func:`PyImport_ExecCodeModuleWithPathnames`."

msgstr ""

"另请参阅 :c:func:`PyImport_ExecCodeModuleEx` 和 "

":c:func:`PyImport_ExecCodeModuleWithPathnames`。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:156

msgid ""

"Like :c:func:`PyImport_ExecCodeModule`, but the :attr:`__file__` attribute "

"of the module object is set to *pathname* if it is non-``NULL``."

msgstr ""

"类似于 :c:func:`PyImport_ExecCodeModule`，但如果 *pathname* 不为 ``NULL`` 则会被设为模块对象的 "

":attr:`__file__` 属性的值。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:159

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

msgstr "参见 :c:func:`PyImport_ExecCodeModuleWithPathnames`。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:164

msgid ""

"Like :c:func:`PyImport_ExecCodeModuleEx`, but the :attr:`__cached__` "

"attribute of the module object is set to *cpathname* if it is non-``NULL``."

" Of the three functions, this is the preferred one to use."

msgstr ""

"类似于 :c:func:`PyImport_ExecCodeModuleEx`，但如果 *cpathname* 不为 ``NULL`` "

"则会被设为模块对象的 :attr:`__cached__` 值。 在三个函数中，这是推荐使用的一个。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:173

msgid ""

"Like :c:func:`PyImport_ExecCodeModuleObject`, but *name*, *pathname* and "

"*cpathname* are UTF-8 encoded strings. Attempts are also made to figure out "

"what the value for *pathname* should be from *cpathname* if the former is "

"set to ``NULL``."

msgstr ""

"类似于 :c:func:`PyImport_ExecCodeModuleObject`，但 *name*, *pathname* 和 "

"*cpathname* 为 UTF-8 编码的字符串。如果 *pathname* 也被设为 ``NULL`` 则还会尝试根据 *cpathname* "

"推断出前者的值。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:179

msgid ""

"Uses :func:`imp.source_from_cache()` in calculating the source path if only "

"the bytecode path is provided."

msgstr "如果只提供了字节码路径则会使用 :func:`imp.source_from_cache()` 来计算源路径。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:186

msgid ""

"Return the magic number for Python bytecode files (a.k.a. :file:`.pyc` "

"file). The magic number should be present in the first four bytes of the "

"bytecode file, in little-endian byte order. Returns ``-1`` on error."

msgstr ""

"返回 Python 字节码文件（即 :file:`.pyc` 文件）的魔数。 此魔数应当存在于字节码文件的开头四个字节中，按照小端字节序。 出错时返回 "

"``-1``。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:190

msgid "Return value of ``-1`` upon failure."

msgstr "失败时返回值 ``-1``。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:196

msgid ""

"Return the magic tag string for :pep:`3147` format Python bytecode file "

"names. Keep in mind that the value at ``sys.implementation.cache_tag`` is "

"authoritative and should be used instead of this function."

msgstr ""

"针对 :pep:`3147` 格式的 Python 字节码文件名返回魔术标签字符串。 请记住在 "

"``sys.implementation.cache_tag`` 上的值是应当被用来代替此函数的更权威的值。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:204

msgid ""

"Return the dictionary used for the module administration (a.k.a. "

"``sys.modules``). Note that this is a per-interpreter variable."

msgstr "返回用于模块管理的字典 (即 ``sys.modules``)。 请注意这是针对每个解释器的变量。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:209

msgid ""

"Return the already imported module with the given name. If the module has "

"not been imported yet then returns ``NULL`` but does not set an error. "

"Returns ``NULL`` and sets an error if the lookup failed."

msgstr "返回给定名称的已导入模块。 如果模块尚未导入则返回 ``NULL`` 但不会设置错误。 如果查找失败则返回 ``NULL`` 并设置错误。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:217

msgid ""

"Return a finder object for a :data:`sys.path`/:attr:`pkg.__path__` item "

"*path*, possibly by fetching it from the :data:`sys.path_importer_cache` "

"dict. If it wasn't yet cached, traverse :data:`sys.path_hooks` until a hook"

" is found that can handle the path item. Return ``None`` if no hook could; "

"this tells our caller that the :term:`path based finder` could not find a "

"finder for this path item. Cache the result in "

":data:`sys.path_importer_cache`. Return a new reference to the finder "

"object."

msgstr ""

"返回针对一个 :data:`sys.path`/:attr:`pkg.__path__` 中条目 *path* 的查找器对象，可能会通过 "

":data:`sys.path_importer_cache` 字典来获取。 如果它尚未被缓存，则会遍历 :data:`sys.path_hooks` "

"直至找到一个能处理该 path 条目的钩子。 如果没有可用的钩子则返回 ``None``；这将告知调用方 :term:`path based "

"finder` 无法为该 path 条目找到查找器。 结果将缓存到 :data:`sys.path_importer_cache`。 "

"返回一个指向查找器对象的新引用。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:228

msgid "Initialize the import mechanism. For internal use only."

msgstr ""

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:233

msgid "Empty the module table. For internal use only."

msgstr ""

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:238

msgid "Finalize the import mechanism. For internal use only."

msgstr ""

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:243

msgid ""

"Load a frozen module named *name*. Return ``1`` for success, ``0`` if the "

"module is not found, and ``-1`` with an exception set if the initialization "

"failed. To access the imported module on a successful load, use "

":c:func:`PyImport_ImportModule`. (Note the misnomer --- this function would"

" reload the module if it was already imported.)"

msgstr ""

"加载名称为 *name* 的已冻结模块。 成功时返回 ``1``，如果未找到模块则返回 ``0``，如果初始化失败则返回 ``-1`` 并设置一个异常。"

" 要在加载成功后访问被导入的模块，请使用 :c:func:`PyImport_ImportModule`。 （请注意此名称有误导性 --- "

"如果模块已被导入此函数将重载它。）"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:251

msgid "The ``__file__`` attribute is no longer set on the module."

msgstr "``__file__`` 属性将不再在模块上设置。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:257

msgid ""

"Similar to :c:func:`PyImport_ImportFrozenModuleObject`, but the name is a "

"UTF-8 encoded string instead of a Unicode object."

msgstr ""

"类似于 :c:func:`PyImport_ImportFrozenModuleObject`，但其名称为 UTF-8 编码的字符串而不是 "

"Unicode 对象。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:265

msgid ""

"This is the structure type definition for frozen module descriptors, as "

"generated by the :program:`freeze` utility (see :file:`Tools/freeze/` in the"

" Python source distribution). Its definition, found in "

":file:`Include/import.h`, is::"

msgstr ""

"这是针对已冻结模块描述器的结构类型定义，与由 :program:`freeze` 工具所生成的一致 (请参看 Python 源代码发行版中的 "

":file:`Tools/freeze/`)。 其定义可在 :file:`Include/import.h` 中找到::"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:279

msgid ""

"This pointer is initialized to point to an array of :c:type:`struct _frozen`"

" records, terminated by one whose members are all ``NULL`` or zero. When a "

"frozen module is imported, it is searched in this table. Third-party code "

"could play tricks with this to provide a dynamically created collection of "

"frozen modules."

msgstr ""

"该指针被初始化为指向 :c:type:`struct _frozen` 数组，以 ``NULL`` 或者 0 "

"作为结束标记。当一个冻结模块被导入，首先要在这个表中搜索。第三方库可以以此来提供动态创建的冻结模块集合。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:287

msgid ""

"Add a single module to the existing table of built-in modules. This is a "

"convenience wrapper around :c:func:`PyImport_ExtendInittab`, returning "

"``-1`` if the table could not be extended. The new module can be imported "

"by the name *name*, and uses the function *initfunc* as the initialization "

"function called on the first attempted import. This should be called before"

" :c:func:`Py_Initialize`."

msgstr ""

"向现有的内置模块表添加一个模块。 这是对 :c:func:`PyImport_ExtendInittab` 的便捷包装，如果无法扩展表则返回 "

"``-1``。 新的模块可使用名称 *name* 来导入，并使用函数 *initfunc* 作为在第一次尝试导入时调用的初始化函数。 此函数应当在 "

":c:func:`Py_Initialize` 之前调用。"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:297

msgid ""

"Structure describing a single entry in the list of built-in modules. Each "

"of these structures gives the name and initialization function for a module "

"built into the interpreter. The name is an ASCII encoded string. Programs "

"which embed Python may use an array of these structures in conjunction with "

":c:func:`PyImport_ExtendInittab` to provide additional built-in modules. The"

" structure is defined in :file:`Include/import.h` as::"

msgstr ""

"描述内置模块列表中的一个条目的结构体。 每个结构体都给出了内置在解释器中的某个模块的名称和初始化函数。 名称是一个 ASCII 编码的字符串。 嵌入了 "

"Python 的程序可以使用该结构体的数组来与 :c:func:`PyImport_ExtendInittab` 相结合以提供额外的内置模块。 "

"该结构体在 :file:`Include/import.h` 中被定义为::"

#: /home/runner/work/docspush-transifex/docspush-transifex/cpython/Doc/c-api/import.rst:312

msgid ""

"Add a collection of modules to the table of built-in modules. The *newtab* "

"array must end with a sentinel entry which contains ``NULL`` for the "

":attr:`name` field; failure to provide the sentinel value can result in a "

"memory fault. Returns ``0`` on success or ``-1`` if insufficient memory "

"could be allocated to extend the internal table. In the event of failure, "

"no modules are added to the internal table. This should be called before "

":c:func:`Py_Initialize`."

msgstr ""