sync with cpython 94ad6826

Author: github-actions[bot]

c-api/import.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-12-07 00:03+0000\n"
+"POT-Creation-Date: 2024-02-06 00:03+0000\n"
 "PO-Revision-Date: 2018-05-23 14:06+0000\n"
 "Last-Translator: Adrian Liaw <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -25,73 +25,60 @@ msgstr "引入模組"
 
 #: ../../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`."
+"This is a wrapper around :c:func:`PyImport_Import()` which takes a :c:expr:"
+"`const char *` as an argument instead of a :c:expr:`PyObject *`."
 msgstr ""
 
-#: ../../c-api/import.rst:28 ../../c-api/import.rst:89
-msgid "This function always uses absolute imports."
-msgstr ""
-
-#: ../../c-api/import.rst:33
+#: ../../c-api/import.rst:21
 msgid "This function is a deprecated alias of :c:func:`PyImport_ImportModule`."
 msgstr ""
 
-#: ../../c-api/import.rst:35
+#: ../../c-api/import.rst:23
 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 ""
 
-#: ../../c-api/import.rst:46
+#: ../../c-api/import.rst:34
 msgid ""
 "Import a module.  This is best described by referring to the built-in Python "
 "function :func:`__import__`."
 msgstr ""
 
-#: ../../c-api/import.rst:49 ../../c-api/import.rst:65
+#: ../../c-api/import.rst:37 ../../c-api/import.rst:53
 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 ""
 
-#: ../../c-api/import.rst:55
+#: ../../c-api/import.rst:43
 msgid ""
 "Failing imports remove incomplete module objects, like with :c:func:"
 "`PyImport_ImportModule`."
 msgstr ""
 
-#: ../../c-api/import.rst:61
+#: ../../c-api/import.rst:49
 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 ""
 
-#: ../../c-api/import.rst:75
+#: ../../c-api/import.rst:63
 msgid ""
 "Similar to :c:func:`PyImport_ImportModuleLevelObject`, but the name is a "
 "UTF-8 encoded string instead of a Unicode object."
 msgstr ""
 
-#: ../../c-api/import.rst:78
+#: ../../c-api/import.rst:66
 msgid "Negative values for *level* are no longer accepted."
 msgstr ""
 
-#: ../../c-api/import.rst:83
+#: ../../c-api/import.rst:71
 msgid ""
 "This is a higher-level interface that calls the current \"import hook "
 "function\" (with an explicit *level* of 0, meaning absolute import).  It "
@@ -100,21 +87,25 @@ msgid ""
 "hooks are installed in the current environment."
 msgstr ""
 
-#: ../../c-api/import.rst:94
+#: ../../c-api/import.rst:77
+msgid "This function always uses absolute imports."
+msgstr ""
+
+#: ../../c-api/import.rst:82
 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 ""
 
-#: ../../c-api/import.rst:100
+#: ../../c-api/import.rst:88
 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 ""
 
-#: ../../c-api/import.rst:107
+#: ../../c-api/import.rst:95
 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:"
@@ -123,13 +114,13 @@ msgid ""
 "already present."
 msgstr ""
 
-#: ../../c-api/import.rst:117
+#: ../../c-api/import.rst:105
 msgid ""
 "Similar to :c:func:`PyImport_AddModuleObject`, but the name is a UTF-8 "
 "encoded string instead of a Unicode object."
 msgstr ""
 
-#: ../../c-api/import.rst:125
+#: ../../c-api/import.rst:113
 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 "
@@ -143,118 +134,118 @@ msgid ""
 "to the module author's intents) state."
 msgstr ""
 
-#: ../../c-api/import.rst:135
+#: ../../c-api/import.rst:123
 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:`~importlib."
 "machinery.SourceFileLoader` otherwise."
 msgstr ""
 
-#: ../../c-api/import.rst:140
+#: ../../c-api/import.rst:128
 msgid ""
 "The module's :attr:`__file__` attribute will be set to the code object's :"
 "attr:`~codeobject.co_filename`.  If applicable, :attr:`__cached__` will also "
 "be set."
 msgstr ""
 
-#: ../../c-api/import.rst:144
+#: ../../c-api/import.rst:132
 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-api/import.rst:147
+#: ../../c-api/import.rst:135
 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 ""
 
-#: ../../c-api/import.rst:150
+#: ../../c-api/import.rst:138
 msgid ""
 "See also :c:func:`PyImport_ExecCodeModuleEx` and :c:func:"
 "`PyImport_ExecCodeModuleWithPathnames`."
 msgstr ""
 
-#: ../../c-api/import.rst:153
+#: ../../c-api/import.rst:141
 msgid ""
 "The setting of :attr:`__cached__` and :attr:`__loader__` is deprecated. See :"
 "class:`~importlib.machinery.ModuleSpec` for alternatives."
 msgstr ""
 
-#: ../../c-api/import.rst:161
+#: ../../c-api/import.rst:149
 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-api/import.rst:164
+#: ../../c-api/import.rst:152
 msgid "See also :c:func:`PyImport_ExecCodeModuleWithPathnames`."
 msgstr "也請見 :c:func:`PyImport_ExecCodeModuleWithPathnames`\\ 。"
 
-#: ../../c-api/import.rst:169
+#: ../../c-api/import.rst:157
 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-api/import.rst:175
+#: ../../c-api/import.rst:163
 msgid ""
 "Setting :attr:`__cached__` is deprecated. See :class:`~importlib.machinery."
 "ModuleSpec` for alternatives."
 msgstr ""
 
-#: ../../c-api/import.rst:182
+#: ../../c-api/import.rst:170
 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-api/import.rst:188
+#: ../../c-api/import.rst:176
 msgid ""
 "Uses :func:`!imp.source_from_cache()` in calculating the source path if only "
 "the bytecode path is provided."
 msgstr ""
 
-#: ../../c-api/import.rst:191
+#: ../../c-api/import.rst:179
 msgid "No longer uses the removed :mod:`!imp` module."
 msgstr "不再使用已被移除的 :mod:`!imp` 模組。"
 
-#: ../../c-api/import.rst:197
+#: ../../c-api/import.rst:185
 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 ""
 
-#: ../../c-api/import.rst:201
+#: ../../c-api/import.rst:189
 msgid "Return value of ``-1`` upon failure."
 msgstr "當失敗時回傳 ``-1``。"
 
-#: ../../c-api/import.rst:207
+#: ../../c-api/import.rst:195
 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 ""
 
-#: ../../c-api/import.rst:215
+#: ../../c-api/import.rst:203
 msgid ""
 "Return the dictionary used for the module administration (a.k.a. ``sys."
 "modules``).  Note that this is a per-interpreter variable."
 msgstr ""
 
-#: ../../c-api/import.rst:220
+#: ../../c-api/import.rst:208
 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 ""
 
-#: ../../c-api/import.rst:228
+#: ../../c-api/import.rst:216
 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` "
@@ -265,7 +256,7 @@ msgid ""
 "path_importer_cache`. Return a new reference to the finder object."
 msgstr ""
 
-#: ../../c-api/import.rst:239
+#: ../../c-api/import.rst:227
 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 "
@@ -274,31 +265,31 @@ msgid ""
 "the module if it was already imported.)"
 msgstr ""
 
-#: ../../c-api/import.rst:247
+#: ../../c-api/import.rst:235
 msgid "The ``__file__`` attribute is no longer set on the module."
 msgstr ""
 
-#: ../../c-api/import.rst:253
+#: ../../c-api/import.rst:241
 msgid ""
 "Similar to :c:func:`PyImport_ImportFrozenModuleObject`, but the name is a "
 "UTF-8 encoded string instead of a Unicode object."
 msgstr ""
 
-#: ../../c-api/import.rst:261
+#: ../../c-api/import.rst:249
 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 ""
 
-#: ../../c-api/import.rst:273
+#: ../../c-api/import.rst:261
 msgid ""
 "The new ``is_package`` field indicates whether the module is a package or "
 "not. This replaces setting the ``size`` field to a negative value."
 msgstr ""
 
-#: ../../c-api/import.rst:279
+#: ../../c-api/import.rst:267
 msgid ""
 "This pointer is initialized to point to an array of :c:struct:`_frozen` "
 "records, terminated by one whose members are all ``NULL`` or zero.  When a "
@@ -307,7 +298,7 @@ msgid ""
 "frozen modules."
 msgstr ""
 
-#: ../../c-api/import.rst:287
+#: ../../c-api/import.rst:275
 msgid ""
 "Add a single module to the existing table of built-in modules.  This is a "
 "convenience wrapper around :c:func:`PyImport_ExtendInittab`, returning "
@@ -317,19 +308,19 @@ msgid ""
 "before :c:func:`Py_Initialize`."
 msgstr ""
 
-#: ../../c-api/import.rst:297
+#: ../../c-api/import.rst:285
 msgid ""
 "Structure describing a single entry in the list of built-in modules. "
 "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 consists of two members:"
 msgstr ""
 
-#: ../../c-api/import.rst:305
+#: ../../c-api/import.rst:293
 msgid "The module name, as an ASCII encoded string."
 msgstr ""
 
-#: ../../c-api/import.rst:314
+#: ../../c-api/import.rst:302
 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 :c:"
@@ -340,7 +331,7 @@ msgid ""
 "before :c:func:`Py_Initialize`."
 msgstr ""
 
-#: ../../c-api/import.rst:321
+#: ../../c-api/import.rst:309
 msgid ""
 "If Python is initialized multiple times, :c:func:`PyImport_AppendInittab` "
 "or :c:func:`PyImport_ExtendInittab` must be called before each Python "
@@ -363,18 +354,18 @@ msgstr "__all__（套件變數）"
 msgid "modules (in module sys)"
 msgstr "modules（sys 模組中）"
 
-#: ../../c-api/import.rst:44 ../../c-api/import.rst:123
+#: ../../c-api/import.rst:32 ../../c-api/import.rst:111
 msgid "built-in function"
 msgstr "built-in function（內建函式）"
 
-#: ../../c-api/import.rst:44
+#: ../../c-api/import.rst:32
 msgid "__import__"
 msgstr "__import__"
 
-#: ../../c-api/import.rst:123
+#: ../../c-api/import.rst:111
 msgid "compile"
 msgstr "compile（編譯）"
 
-#: ../../c-api/import.rst:259
+#: ../../c-api/import.rst:247
 msgid "freeze utility"
 msgstr "freeze utility（凍結工具）"