# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2022, Python Software Foundation
# This file is distributed under the same license as the Python package.
#
# Translators:
# Ching-Lung Chuang, 2015
msgid ""
msgstr ""
"Project-Id-Version: Python 3.12\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-07-29 00:03+0000\n"
"PO-Revision-Date: 2018-05-23 14:06+0000\n"
"Last-Translator: Adrian Liaw \n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
"tw)\n"
"Language: zh_TW\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=1; plural=0;\n"
#: ../../c-api/import.rst:6
msgid "Importing Modules"
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`."
msgstr ""
#: ../../c-api/import.rst:28 ../../c-api/import.rst:89
msgid "This function always uses absolute imports."
msgstr ""
#: ../../c-api/import.rst:33
msgid "This function is a deprecated alias of :c:func:`PyImport_ImportModule`."
msgstr ""
#: ../../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 ""
#: ../../c-api/import.rst:46
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
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
msgid ""
"Failing imports remove incomplete module objects, like with :c:func:"
"`PyImport_ImportModule`."
msgstr ""
#: ../../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 ""
#: ../../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-api/import.rst:78
msgid "Negative values for *level* are no longer accepted."
msgstr ""
#: ../../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 ""
#: ../../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 ""
#: ../../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 ""
#: ../../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-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-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 :data:`sys.modules` in error cases, even if *name* "
"was already in :data:`sys.modules` on entry to :c:func:"
"`PyImport_ExecCodeModule`. Leaving incompletely initialized modules in :"
"data:`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 ""
#: ../../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:`~importlib."
"machinery.SourceFileLoader` otherwise."
msgstr ""
#: ../../c-api/import.rst:140
msgid ""
"The module's :attr:`__file__` attribute will be set to the code object's :"
"attr:`!co_filename`. If applicable, :attr:`__cached__` will also be set."
msgstr ""
#: ../../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-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 ""
#: ../../c-api/import.rst:150
msgid ""
"See also :c:func:`PyImport_ExecCodeModuleEx` and :c:func:"
"`PyImport_ExecCodeModuleWithPathnames`."
msgstr ""
#: ../../c-api/import.rst:153
msgid ""
"The setting of :attr:`__cached__` and :attr:`__loader__` is deprecated. See :"
"class:`~importlib.machinery.ModuleSpec` for alternatives."
msgstr ""
#: ../../c-api/import.rst:161
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
msgid "See also :c:func:`PyImport_ExecCodeModuleWithPathnames`."
msgstr " :c:func:`PyImport_ExecCodeModuleWithPathnames`\\ "
#: ../../c-api/import.rst:169
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
msgid ""
"Setting :attr:`__cached__` is deprecated. See :class:`~importlib.machinery."
"ModuleSpec` for alternatives."
msgstr ""
#: ../../c-api/import.rst:182
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
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
msgid "No longer uses the removed :mod:`!imp` module."
msgstr " :mod:`!imp` "
#: ../../c-api/import.rst:197
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
msgid "Return value of ``-1`` upon failure."
msgstr " ``-1``"
#: ../../c-api/import.rst:207
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
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
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
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 ""
#: ../../c-api/import.rst:239
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 ""
#: ../../c-api/import.rst:247
msgid "The ``__file__`` attribute is no longer set on the module."
msgstr ""
#: ../../c-api/import.rst:253
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
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
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
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 "
"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-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-api/import.rst:297
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
msgid "The module name, as an ASCII encoded string."
msgstr ""
#: ../../c-api/import.rst:314
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:"
"member:`~_inittab.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 must be called "
"before :c:func:`Py_Initialize`."
msgstr ""
#: ../../c-api/import.rst:321
msgid ""
"If Python is initialized multiple times, :c:func:`PyImport_AppendInittab` "
"or :c:func:`PyImport_ExtendInittab` must be called before each Python "
"initialization."
msgstr ""
#: ../../c-api/import.rst:11
msgid "package variable"
msgstr "package variable"
#: ../../c-api/import.rst:11
msgid "__all__"
msgstr "__all__"
#: ../../c-api/import.rst:11
msgid "__all__ (package variable)"
msgstr "__all__"
#: ../../c-api/import.rst:11
msgid "modules (in module sys)"
msgstr "modulessys "
#: ../../c-api/import.rst:44 ../../c-api/import.rst:123
msgid "built-in function"
msgstr "built-in function"
#: ../../c-api/import.rst:44
msgid "__import__"
msgstr "__import__"
#: ../../c-api/import.rst:123
msgid "compile"
msgstr "compile"
#: ../../c-api/import.rst:259
msgid "freeze utility"
msgstr "freeze utility"