From 8c4ac2463c2c1a1ca738217af047014bd034243a Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Fri, 19 Jul 2024 01:07:19 +0000 Subject: [PATCH 01/28] sync with cpython 001584da --- library/functions.po | 5 +++-- library/unittest.po | 6 +++--- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/library/functions.po b/library/functions.po index afc1672055..19280c8052 100644 --- a/library/functions.po +++ b/library/functions.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-08 00:03+0000\n" +"POT-Creation-Date: 2024-07-19 01:06+0000\n" "PO-Revision-Date: 2024-05-06 17:06+0800\n" "Last-Translator: KNChiu \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -2423,8 +2423,9 @@ msgstr "" "`shutil`。" #: ../../library/functions.rst:1443 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``open`` with arguments ``file``, " +"Raises an :ref:`auditing event ` ``open`` with arguments ``path``, " "``mode``, ``flags``." msgstr "" "引發一個附帶引數 ``file``、``model``、``flags`` 的\\ :ref:`稽核事件 " diff --git a/library/unittest.po b/library/unittest.po index 1de72adb03..37618350e1 100644 --- a/library/unittest.po +++ b/library/unittest.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-19 01:06+0000\n" "PO-Revision-Date: 2022-10-16 06:03+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -2729,8 +2729,8 @@ msgstr "" #: ../../library/unittest.rst:2311 msgid "" -"Calling ``main`` actually returns an instance of the ``TestProgram`` class. " -"This stores the result of the tests run as the ``result`` attribute." +"Calling ``main`` returns an object with the ``result`` attribute that " +"contains the result of the tests run as a :class:`unittest.TestResult`." msgstr "" #: ../../library/unittest.rst:2314 From a4dbab78080fc01a8e02dee59347b5a621da5d17 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Sat, 20 Jul 2024 00:05:10 +0000 Subject: [PATCH 02/28] sync with cpython 8bd47132 --- c-api/arg.po | 14 +- c-api/float.po | 14 +- c-api/marshal.po | 4 +- c-api/module.po | 104 +++--- c-api/number.po | 10 +- faq/design.po | 8 +- faq/library.po | 8 +- faq/programming.po | 6 +- library/2to3.po | 6 +- library/aifc.po | 4 +- library/array.po | 8 +- library/audioop.po | 4 +- library/cgi.po | 10 +- library/cgitb.po | 4 +- library/chunk.po | 4 +- library/collections.abc.po | 4 +- library/colorsys.po | 5 +- library/configparser.po | 4 +- library/crypt.po | 4 +- library/decimal.po | 25 +- library/dis.po | 4 +- library/email.utils.po | 6 +- library/exceptions.po | 6 +- library/fractions.po | 4 +- library/functions.po | 20 +- library/imghdr.po | 4 +- library/importlib.po | 6 +- library/importlib.resources.abc.po | 4 +- library/itertools.po | 21 +- library/locale.po | 6 +- library/mailcap.po | 4 +- library/marshal.po | 8 +- library/math.po | 10 +- library/msilib.po | 4 +- library/nis.po | 4 +- library/os.path.po | 8 +- library/ossaudiodev.po | 4 +- library/pipes.po | 4 +- library/pkgutil.po | 11 +- library/profile.po | 4 +- library/random.po | 14 +- library/readline.po | 93 ++--- library/resource.po | 4 +- library/select.po | 4 +- library/sndhdr.po | 4 +- library/socket.po | 4 +- library/spwd.po | 4 +- library/sqlite3.po | 4 +- library/statistics.po | 5 +- library/stdtypes.po | 31 +- library/string.po | 9 +- library/sunau.po | 4 +- library/telnetlib.po | 4 +- library/threading.po | 8 +- library/time.po | 14 +- library/typing.po | 10 +- library/unittest.mock.po | 581 +++++++++++++++-------------- library/uu.po | 4 +- library/webbrowser.po | 4 +- library/xdrlib.po | 4 +- reference/datamodel.po | 15 +- reference/expressions.po | 12 +- reference/lexical_analysis.po | 25 +- tutorial/floatingpoint.po | 14 +- tutorial/introduction.po | 5 +- tutorial/stdlib.po | 5 +- tutorial/stdlib2.po | 8 +- using/configure.po | 6 +- whatsnew/2.1.po | 6 +- whatsnew/2.2.po | 4 +- whatsnew/2.3.po | 10 +- whatsnew/2.6.po | 4 +- whatsnew/2.7.po | 20 +- whatsnew/3.1.po | 14 +- whatsnew/3.11.po | 5 +- whatsnew/3.2.po | 4 +- whatsnew/3.3.po | 6 +- whatsnew/3.6.po | 4 +- whatsnew/3.7.po | 4 +- whatsnew/3.8.po | 4 +- 80 files changed, 722 insertions(+), 654 deletions(-) diff --git a/c-api/arg.po b/c-api/arg.po index 1b009dd683..a4fa9fe958 100644 --- a/c-api/arg.po +++ b/c-api/arg.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 00:04+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2022-10-16 03:21+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -552,7 +552,8 @@ msgid "``f`` (:class:`float`) [float]" msgstr "``f`` (:class:`float`) [float]" #: ../../c-api/arg.rst:283 -msgid "Convert a Python floating point number to a C :c:expr:`float`." +#, fuzzy +msgid "Convert a Python floating-point number to a C :c:expr:`float`." msgstr "將一個 Python 浮點數轉換成 C 的 :c:type::c:expr:`float`。" #: ../../c-api/arg.rst:285 ../../c-api/arg.rst:609 @@ -560,7 +561,8 @@ msgid "``d`` (:class:`float`) [double]" msgstr "``d`` (:class:`float`) [double]" #: ../../c-api/arg.rst:286 -msgid "Convert a Python floating point number to a C :c:expr:`double`." +#, fuzzy +msgid "Convert a Python floating-point number to a C :c:expr:`double`." msgstr "將一個 Python 浮點數轉換成 C 的 :c:type::c:expr:`double`。" #: ../../c-api/arg.rst:288 @@ -1039,11 +1041,13 @@ msgstr "" "`str`。" #: ../../c-api/arg.rst:610 -msgid "Convert a C :c:expr:`double` to a Python floating point number." +#, fuzzy +msgid "Convert a C :c:expr:`double` to a Python floating-point number." msgstr "將一個 C 的 :c:expr:`double` 轉換成 Python 浮點數。" #: ../../c-api/arg.rst:613 -msgid "Convert a C :c:expr:`float` to a Python floating point number." +#, fuzzy +msgid "Convert a C :c:expr:`float` to a Python floating-point number." msgstr "將一個 C 的 :c:expr:`float` 轉換成 Python 浮點數。" #: ../../c-api/arg.rst:615 diff --git a/c-api/float.po b/c-api/float.po index 17030a1fec..9aef11e532 100644 --- a/c-api/float.po +++ b/c-api/float.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-07-22 00:04+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2017-09-22 18:26+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -21,17 +21,18 @@ msgstr "" "Plural-Forms: nplurals=1; plural=0;\n" #: ../../c-api/float.rst:6 -msgid "Floating Point Objects" +#, fuzzy +msgid "Floating-Point Objects" msgstr "浮點數（Floating Point）物件" #: ../../c-api/float.rst:13 msgid "" -"This subtype of :c:type:`PyObject` represents a Python floating point object." +"This subtype of :c:type:`PyObject` represents a Python floating-point object." msgstr "" #: ../../c-api/float.rst:18 msgid "" -"This instance of :c:type:`PyTypeObject` represents the Python floating point " +"This instance of :c:type:`PyTypeObject` represents the Python floating-point " "type. This is the same object as :class:`float` in the Python layer." msgstr "" @@ -61,7 +62,7 @@ msgstr "" #: ../../c-api/float.rst:47 msgid "" "Return a C :c:expr:`double` representation of the contents of *pyfloat*. If " -"*pyfloat* is not a Python floating point object but has a :meth:`~object." +"*pyfloat* is not a Python floating-point object but has a :meth:`~object." "__float__` method, this method will first be called to convert *pyfloat* " "into a float. If :meth:`!__float__` is not defined then it falls back to :" "meth:`~object.__index__`. This method returns ``-1.0`` upon failure, so one " @@ -217,5 +218,6 @@ msgid "object" msgstr "object（物件）" #: ../../c-api/float.rst:8 -msgid "floating point" +#, fuzzy +msgid "floating-point" msgstr "floating point（浮點）" diff --git a/c-api/marshal.po b/c-api/marshal.po index c7ee1f1f9d..536fc0744c 100644 --- a/c-api/marshal.po +++ b/c-api/marshal.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-06-03 00:16+0000\n" +"POT-Creation-Date: 2024-07-20 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-" @@ -39,7 +39,7 @@ msgstr "" msgid "" "The module supports two versions of the data format: version 0 is the " "historical version, version 1 shares interned strings in the file, and upon " -"unmarshalling. Version 2 uses a binary format for floating point numbers. " +"unmarshalling. Version 2 uses a binary format for floating-point numbers. " "``Py_MARSHAL_VERSION`` indicates the current file format (currently 2)." msgstr "" diff --git a/c-api/module.po b/c-api/module.po index f8dcc54cc6..538fd60d58 100644 --- a/c-api/module.po +++ b/c-api/module.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-15 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 14:32+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -51,7 +51,7 @@ msgid "" msgstr "" #: ../../c-api/module.rst:46 ../../c-api/module.rst:270 -#: ../../c-api/module.rst:443 +#: ../../c-api/module.rst:445 msgid "Return ``NULL`` with an exception set on error." msgstr "" @@ -378,27 +378,27 @@ msgid "" "*value* pointer of this slot must point to a function of the signature:" msgstr "" -#: ../../c-api/module.rst:347 +#: ../../c-api/module.rst:348 msgid "" "The function receives a :py:class:`~importlib.machinery.ModuleSpec` " "instance, as defined in :PEP:`451`, and the module definition. It should " "return a new module object, or set an error and return ``NULL``." msgstr "" -#: ../../c-api/module.rst:352 +#: ../../c-api/module.rst:353 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 "" -#: ../../c-api/module.rst:356 +#: ../../c-api/module.rst:357 msgid "" "Multiple ``Py_mod_create`` slots may not be specified in one module " "definition." msgstr "" -#: ../../c-api/module.rst:359 +#: ../../c-api/module.rst:360 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 " @@ -407,7 +407,7 @@ msgid "" "through symlinks, all while sharing a single module definition." msgstr "" -#: ../../c-api/module.rst:365 +#: ../../c-api/module.rst:366 msgid "" "There is no requirement for the returned object to be an instance of :c:type:" "`PyModule_Type`. Any type can be used, as long as it supports setting and " @@ -417,7 +417,7 @@ msgid "" "``Py_mod_create``." msgstr "" -#: ../../c-api/module.rst:374 +#: ../../c-api/module.rst:375 msgid "" "Specifies a function that is called to *execute* the module. This is " "equivalent to executing the code of a Python module: typically, this " @@ -425,59 +425,59 @@ msgid "" "function is:" msgstr "" -#: ../../c-api/module.rst:382 +#: ../../c-api/module.rst:384 msgid "" "If multiple ``Py_mod_exec`` slots are specified, they are processed in the " "order they appear in the *m_slots* array." msgstr "" -#: ../../c-api/module.rst:387 +#: ../../c-api/module.rst:389 msgid "Specifies one of the following values:" msgstr "" -#: ../../c-api/module.rst:393 +#: ../../c-api/module.rst:395 msgid "The module does not support being imported in subinterpreters." msgstr "" -#: ../../c-api/module.rst:397 +#: ../../c-api/module.rst:399 msgid "" "The module supports being imported in subinterpreters, but only when they " "share the main interpreter's GIL. (See :ref:`isolating-extensions-howto`.)" msgstr "" -#: ../../c-api/module.rst:403 +#: ../../c-api/module.rst:405 msgid "" "The module supports being imported in subinterpreters, even when they have " "their own GIL. (See :ref:`isolating-extensions-howto`.)" msgstr "" -#: ../../c-api/module.rst:407 +#: ../../c-api/module.rst:409 msgid "" "This slot determines whether or not importing this module in a " "subinterpreter will fail." msgstr "" -#: ../../c-api/module.rst:410 +#: ../../c-api/module.rst:412 msgid "" "Multiple ``Py_mod_multiple_interpreters`` slots may not be specified in one " "module definition." msgstr "" -#: ../../c-api/module.rst:413 +#: ../../c-api/module.rst:415 msgid "" "If ``Py_mod_multiple_interpreters`` is not specified, the import machinery " "defaults to ``Py_MOD_MULTIPLE_INTERPRETERS_NOT_SUPPORTED``." msgstr "" -#: ../../c-api/module.rst:418 +#: ../../c-api/module.rst:420 msgid "See :PEP:`489` for more details on multi-phase initialization." msgstr "" -#: ../../c-api/module.rst:421 +#: ../../c-api/module.rst:423 msgid "Low-level module creation functions" msgstr "" -#: ../../c-api/module.rst:423 +#: ../../c-api/module.rst:425 msgid "" "The following functions are called under the hood when using multi-phase " "initialization. They can be used directly, for example when creating module " @@ -485,14 +485,14 @@ msgid "" "``PyModule_ExecDef`` must be called to fully initialize a module." msgstr "" -#: ../../c-api/module.rst:430 +#: ../../c-api/module.rst:432 msgid "" "Create a new module object, given the definition in *def* and the ModuleSpec " "*spec*. This behaves like :c:func:`PyModule_FromDefAndSpec2` with " "*module_api_version* set to :c:macro:`PYTHON_API_VERSION`." msgstr "" -#: ../../c-api/module.rst:438 +#: ../../c-api/module.rst:440 msgid "" "Create a new module object, given the definition in *def* and the ModuleSpec " "*spec*, assuming the API version *module_api_version*. If that version does " @@ -500,24 +500,24 @@ msgid "" "emitted." msgstr "" -#: ../../c-api/module.rst:447 +#: ../../c-api/module.rst:449 msgid "" "Most uses of this function should be using :c:func:`PyModule_FromDefAndSpec` " "instead; only use this if you are sure you need it." msgstr "" -#: ../../c-api/module.rst:454 +#: ../../c-api/module.rst:456 msgid "Process any execution slots (:c:data:`Py_mod_exec`) given in *def*." msgstr "" -#: ../../c-api/module.rst:460 +#: ../../c-api/module.rst:462 msgid "" "Set the docstring for *module* to *docstring*. This function is called " "automatically when creating a module from ``PyModuleDef``, using either " "``PyModule_Create`` or ``PyModule_FromDefAndSpec``." msgstr "" -#: ../../c-api/module.rst:469 +#: ../../c-api/module.rst:471 msgid "" "Add the functions from the ``NULL`` terminated *functions* array to " "*module*. Refer to the :c:type:`PyMethodDef` documentation for details on " @@ -529,11 +529,11 @@ msgid "" "``PyModule_FromDefAndSpec``." msgstr "" -#: ../../c-api/module.rst:481 +#: ../../c-api/module.rst:483 msgid "Support functions" msgstr "" -#: ../../c-api/module.rst:483 +#: ../../c-api/module.rst:485 msgid "" "The module initialization function (if using single phase initialization) or " "a function called from a module execution slot (if using multi-phase " @@ -541,72 +541,72 @@ msgid "" "module state:" msgstr "" -#: ../../c-api/module.rst:490 +#: ../../c-api/module.rst:492 msgid "" "Add an object to *module* as *name*. This is a convenience function which " "can be used from the module's initialization function." msgstr "" -#: ../../c-api/module.rst:493 +#: ../../c-api/module.rst:495 msgid "" "On success, return ``0``. On error, raise an exception and return ``-1``." msgstr "" -#: ../../c-api/module.rst:495 +#: ../../c-api/module.rst:497 msgid "" "Return ``-1`` if *value* is ``NULL``. It must be called with an exception " "raised in this case." msgstr "" -#: ../../c-api/module.rst:498 ../../c-api/module.rst:547 +#: ../../c-api/module.rst:500 ../../c-api/module.rst:549 msgid "Example usage::" msgstr "用法範例： ::" -#: ../../c-api/module.rst:512 ../../c-api/module.rst:565 +#: ../../c-api/module.rst:514 ../../c-api/module.rst:567 msgid "" "The example can also be written without checking explicitly if *obj* is " "``NULL``::" msgstr "" -#: ../../c-api/module.rst:524 ../../c-api/module.rst:581 +#: ../../c-api/module.rst:526 ../../c-api/module.rst:583 msgid "" "Note that ``Py_XDECREF()`` should be used instead of ``Py_DECREF()`` in this " "case, since *obj* can be ``NULL``." msgstr "" -#: ../../c-api/module.rst:532 +#: ../../c-api/module.rst:534 msgid "" "Similar to :c:func:`PyModule_AddObjectRef`, but steals a reference to " "*value* on success (if it returns ``0``)." msgstr "" -#: ../../c-api/module.rst:535 +#: ../../c-api/module.rst:537 msgid "" "The new :c:func:`PyModule_AddObjectRef` function is recommended, since it is " "easy to introduce reference leaks by misusing the :c:func:" "`PyModule_AddObject` function." msgstr "" -#: ../../c-api/module.rst:541 +#: ../../c-api/module.rst:543 msgid "" "Unlike other functions that steal references, ``PyModule_AddObject()`` only " "releases the reference to *value* **on success**." msgstr "" -#: ../../c-api/module.rst:544 +#: ../../c-api/module.rst:546 msgid "" "This means that its return value must be checked, and calling code must :c:" "func:`Py_DECREF` *value* manually on error." msgstr "" -#: ../../c-api/module.rst:587 +#: ../../c-api/module.rst:589 msgid "" "Add an integer constant to *module* as *name*. This convenience function " "can be used from the module's initialization function. Return ``-1`` with an " "exception set on error, ``0`` on success." msgstr "" -#: ../../c-api/module.rst:594 +#: ../../c-api/module.rst:596 msgid "" "Add a string constant to *module* as *name*. This convenience function can " "be used from the module's initialization function. The string *value* must " @@ -614,7 +614,7 @@ msgid "" "on success." msgstr "" -#: ../../c-api/module.rst:602 +#: ../../c-api/module.rst:604 msgid "" "Add an int constant to *module*. The name and the value are taken from " "*macro*. For example ``PyModule_AddIntMacro(module, AF_INET)`` adds the int " @@ -622,11 +622,11 @@ msgid "" "with an exception set on error, ``0`` on success." msgstr "" -#: ../../c-api/module.rst:610 +#: ../../c-api/module.rst:612 msgid "Add a string constant to *module*." msgstr "" -#: ../../c-api/module.rst:614 +#: ../../c-api/module.rst:616 msgid "" "Add a type object to *module*. The type object is finalized by calling " "internally :c:func:`PyType_Ready`. The name of the type object is taken from " @@ -634,25 +634,25 @@ msgid "" "``-1`` with an exception set on error, ``0`` on success." msgstr "" -#: ../../c-api/module.rst:624 +#: ../../c-api/module.rst:626 msgid "Module lookup" msgstr "" -#: ../../c-api/module.rst:626 +#: ../../c-api/module.rst:628 msgid "" "Single-phase initialization creates singleton modules that can be looked up " "in the context of the current interpreter. This allows the module object to " "be retrieved later with only a reference to the module definition." msgstr "" -#: ../../c-api/module.rst:630 +#: ../../c-api/module.rst:632 msgid "" "These functions will not work on modules created using multi-phase " "initialization, since multiple such modules can be created from a single " "definition." msgstr "" -#: ../../c-api/module.rst:635 +#: ../../c-api/module.rst:637 msgid "" "Returns the module object that was created from *def* for the current " "interpreter. This method requires that the module object has been attached " @@ -661,18 +661,18 @@ msgid "" "to the interpreter state yet, it returns ``NULL``." msgstr "" -#: ../../c-api/module.rst:642 +#: ../../c-api/module.rst:644 msgid "" "Attaches the module object passed to the function to the interpreter state. " "This allows the module object to be accessible via :c:func:" "`PyState_FindModule`." msgstr "" -#: ../../c-api/module.rst:645 +#: ../../c-api/module.rst:647 msgid "Only effective on modules created using single-phase initialization." msgstr "" -#: ../../c-api/module.rst:647 +#: ../../c-api/module.rst:649 msgid "" "Python calls ``PyState_AddModule`` automatically after importing a module, " "so it is unnecessary (but harmless) to call it from module initialization " @@ -683,15 +683,15 @@ msgid "" "state updates)." msgstr "" -#: ../../c-api/module.rst:655 ../../c-api/module.rst:666 +#: ../../c-api/module.rst:657 ../../c-api/module.rst:668 msgid "The caller must hold the GIL." msgstr "" -#: ../../c-api/module.rst:657 +#: ../../c-api/module.rst:659 msgid "Return ``-1`` with an exception set on error, ``0`` on success." msgstr "" -#: ../../c-api/module.rst:663 +#: ../../c-api/module.rst:665 msgid "" "Removes the module object created from *def* from the interpreter state. " "Return ``-1`` with an exception set on error, ``0`` on success." diff --git a/c-api/number.po b/c-api/number.po index 90f6bc63ec..d058488140 100644 --- a/c-api/number.po +++ b/c-api/number.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-09 00:15+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 14:07+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -66,8 +66,8 @@ msgstr "" msgid "" "Return a reasonable approximation for the mathematical value of *o1* divided " "by *o2*, or ``NULL`` on failure. The return value is \"approximate\" " -"because binary floating point numbers are approximate; it is not possible to " -"represent all real numbers in base two. This function can return a floating " +"because binary floating-point numbers are approximate; it is not possible to " +"represent all real numbers in base two. This function can return a floating-" "point value when passed two integers. This is the equivalent of the Python " "expression ``o1 / o2``." msgstr "" @@ -185,8 +185,8 @@ msgstr "" msgid "" "Return a reasonable approximation for the mathematical value of *o1* divided " "by *o2*, or ``NULL`` on failure. The return value is \"approximate\" " -"because binary floating point numbers are approximate; it is not possible to " -"represent all real numbers in base two. This function can return a floating " +"because binary floating-point numbers are approximate; it is not possible to " +"represent all real numbers in base two. This function can return a floating-" "point value when passed two integers. The operation is done *in-place* when " "*o1* supports it. This is the equivalent of the Python statement ``o1 /= " "o2``." diff --git a/faq/design.po b/faq/design.po index 3645b9db97..cf5c264897 100644 --- a/faq/design.po +++ b/faq/design.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-03-14 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2023-08-31 11:34+0800\n" "Last-Translator: Steven Hsu \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -132,9 +132,10 @@ msgstr "" "運算來說，Python 和 C、Java 等很多受歡迎的語言有一樣的行為。" #: ../../faq/design.rst:72 +#, fuzzy msgid "" "Many numbers that can be written easily in decimal notation cannot be " -"expressed exactly in binary floating-point. For example, after::" +"expressed exactly in binary floating point. For example, after::" msgstr "" "很多數字可以簡單地寫成十進位表示，但卻無法簡單地變成二進制表示。比方說，在以" "下程式碼執行後： ::" @@ -159,8 +160,9 @@ msgid "" msgstr "53 位元的精度讓 Python 可以有 15 至 16 小數位的準確度。" #: ../../faq/design.rst:90 +#, fuzzy msgid "" -"For a fuller explanation, please see the :ref:`floating point arithmetic " +"For a fuller explanation, please see the :ref:`floating-point arithmetic " "` chapter in the Python tutorial." msgstr "" "要更完全的解釋可以查閱在 Python 教學的\\ :ref:`浮點運算 `\\ 一" diff --git a/faq/library.po b/faq/library.po index 5044972444..15431ddb76 100644 --- a/faq/library.po +++ b/faq/library.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-16 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2023-02-18 13:22+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1083,7 +1083,8 @@ msgid "" msgstr "標準模組 :mod:`random` 實作了一個隨機數生成器。用法很簡單： ::" #: ../../faq/library.rst:828 -msgid "This returns a random floating point number in the range [0, 1)." +#, fuzzy +msgid "This returns a random floating-point number in the range [0, 1)." msgstr "這將回傳 [0, 1) 範圍內的隨機浮點數。" #: ../../faq/library.rst:830 @@ -1096,7 +1097,8 @@ msgid "``randrange(a, b)`` chooses an integer in the range [a, b)." msgstr "``randrange(a, b)`` 會選擇 [a, b) 範圍內的一個整數。" #: ../../faq/library.rst:833 -msgid "``uniform(a, b)`` chooses a floating point number in the range [a, b)." +#, fuzzy +msgid "``uniform(a, b)`` chooses a floating-point number in the range [a, b)." msgstr "``uniform(a, b)`` 會選擇 [a, b) 範圍內的浮點數。" #: ../../faq/library.rst:834 diff --git a/faq/programming.po b/faq/programming.po index 4afa15c02c..6e1156327b 100644 --- a/faq/programming.po +++ b/faq/programming.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-14 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2024-04-25 14:17+0800\n" "Last-Translator: KNChiu \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1248,8 +1248,8 @@ msgstr "如何將字串轉換為數字？" #, fuzzy msgid "" "For integers, use the built-in :func:`int` type constructor, e.g. " -"``int('144') == 144``. Similarly, :func:`float` converts to floating-point, " -"e.g. ``float('144') == 144.0``." +"``int('144') == 144``. Similarly, :func:`float` converts to a floating-" +"point number, e.g. ``float('144') == 144.0``." msgstr "" "對於整數，使用內置的 int 型別構造函式，例如``int('144') == 144``。同樣，:" "func:`float` 轉換為浮點數，例如``浮動（'144'）== 144.0``。" diff --git a/library/2to3.po b/library/2to3.po index 25a7febf58..9cd36fd958 100644 --- a/library/2to3.po +++ b/library/2to3.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-15 20:43+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 14:37+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -32,7 +32,7 @@ msgid "" "library, so it is possible to write your own fixers for 2to3." msgstr "" -#: ../../library/2to3.rst:19 +#: ../../library/2to3.rst:14 msgid "" "The ``lib2to3`` module was marked pending for deprecation in Python 3.9 " "(raising :exc:`PendingDeprecationWarning` on import) and fully deprecated in " @@ -628,7 +628,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/lib2to3/`" msgstr "**原始碼：**\\ :source:`Lib/lib2to3/`" -#: ../../library/2to3.rst:482 +#: ../../library/2to3.rst:473 msgid "" "Python 3.9 switched to a PEG parser (see :pep:`617`) while lib2to3 is using " "a less flexible LL(1) parser. Python 3.10 includes new language syntax that " diff --git a/library/aifc.po b/library/aifc.po index 96e5d62e0f..c7c6c1d8af 100644 --- a/library/aifc.po +++ b/library/aifc.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-09 00:15+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2022-05-22 01:57+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -27,7 +27,7 @@ msgstr ":mod:`aifc` --- 讀寫 AIFF 與 AIFC 檔案" msgid "**Source code:** :source:`Lib/aifc.py`" msgstr "**原始碼：**\\ :source:`Lib/aifc.py`" -#: ../../library/aifc.rst:19 +#: ../../library/aifc.rst:16 msgid "" "The :mod:`aifc` module is deprecated (see :pep:`PEP 594 <594#aifc>` for " "details)." diff --git a/library/array.po b/library/array.po index 724cf87fe8..adf333f5ac 100644 --- a/library/array.po +++ b/library/array.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2021-11-23 18:40+0800\n" "Last-Translator: Benson Chen \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -28,9 +28,10 @@ msgid ":mod:`!array` --- Efficient arrays of numeric values" msgstr ":mod:`!array` --- 高效率的數值型陣列" #: ../../library/array.rst:11 +#, fuzzy msgid "" "This module defines an object type which can compactly represent an array of " -"basic values: characters, integers, floating point numbers. Arrays are " +"basic values: characters, integers, floating-point numbers. Arrays are " "sequence types and behave very much like lists, except that the type of " "objects stored in them is constrained. The type is specified at object " "creation time by using a :dfn:`type code`, which is a single character. The " @@ -468,6 +469,7 @@ msgstr "" "陣列轉為 Unicode 字串。" #: ../../library/array.rst:247 +#, fuzzy msgid "" "The string representation of array objects has the form ``array(typecode, " "initializer)``. The *initializer* is omitted if the array is empty, " @@ -476,7 +478,7 @@ msgid "" "be converted back to an array with the same type and value using :func:" "`eval`, so long as the :class:`~array.array` class has been imported using " "``from array import array``. Variables ``inf`` and ``nan`` must also be " -"defined if it contains corresponding floating point values. Examples::" +"defined if it contains corresponding floating-point values. Examples::" msgstr "" "陣列物件的字串表示形式為 ``array(typecode, initializer)``。若為空陣列則參數 " "*initializer* 被省略，若 *typecode* 是 ``'u'`` 將被表示為 Unicode 字串，其他" diff --git a/library/audioop.po b/library/audioop.po index 032fa9a3ea..331d6daf61 100644 --- a/library/audioop.po +++ b/library/audioop.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-09 00:15+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2022-05-22 02:00+0800\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -23,7 +23,7 @@ msgstr "" msgid ":mod:`audioop` --- Manipulate raw audio data" msgstr ":mod:`audioop` --- 操作原始聲音檔案" -#: ../../library/audioop.rst:11 +#: ../../library/audioop.rst:8 msgid "" "The :mod:`audioop` module is deprecated (see :pep:`PEP 594 <594#audioop>` " "for details)." diff --git a/library/cgi.po b/library/cgi.po index b2ee19aca6..25de814c82 100644 --- a/library/cgi.po +++ b/library/cgi.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-16 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2022-05-22 02:01+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -27,7 +27,7 @@ msgstr ":mod:`cgi` --- 通用閘道器介面支援" msgid "**Source code:** :source:`Lib/cgi.py`" msgstr "**原始碼：**\\ :source:`Lib/cgi.py`" -#: ../../library/cgi.rst:27 +#: ../../library/cgi.rst:18 msgid "" "The :mod:`cgi` module is deprecated (see :pep:`PEP 594 <594#cgi>` for " "details and alternatives)." @@ -370,7 +370,7 @@ msgid "" "parameters are passed to :func:`urllib.parse.parse_qs` unchanged." msgstr "" -#: ../../library/cgi.rst:307 +#: ../../library/cgi.rst:303 msgid "" "This function, like the rest of the :mod:`cgi` module, is deprecated. It can " "be replaced by calling :func:`urllib.parse.parse_qs` directly on the desired " @@ -410,7 +410,7 @@ msgstr "" msgid "Added the *separator* parameter." msgstr "新增 *separator* 參數。" -#: ../../library/cgi.rst:337 +#: ../../library/cgi.rst:332 msgid "" "This function, like the rest of the :mod:`cgi` module, is deprecated. It can " "be replaced with the functionality in the :mod:`email` package (e.g. :class:" @@ -424,7 +424,7 @@ msgid "" "and a dictionary of parameters." msgstr "" -#: ../../library/cgi.rst:355 +#: ../../library/cgi.rst:345 msgid "" "This function, like the rest of the :mod:`cgi` module, is deprecated. It can " "be replaced with the functionality in the :mod:`email` package, which " diff --git a/library/cgitb.po b/library/cgitb.po index a176be020e..8ae8ec4c0d 100644 --- a/library/cgitb.po +++ b/library/cgitb.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-09 00:15+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2022-05-22 02:02+0800\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -27,7 +27,7 @@ msgstr ":mod:`cgitb` --- CGI 腳本的回溯 (traceback) 管理程式" msgid "**Source code:** :source:`Lib/cgitb.py`" msgstr "**原始碼：**\\ :source:`Lib/cgitb.py`" -#: ../../library/cgitb.rst:22 +#: ../../library/cgitb.rst:19 msgid "" "The :mod:`cgitb` module is deprecated (see :pep:`PEP 594 <594#cgitb>` for " "details)." diff --git a/library/chunk.po b/library/chunk.po index 2ed762c85b..23d9a59322 100644 --- a/library/chunk.po +++ b/library/chunk.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-09 00:15+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2022-05-22 02:03+0800\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -27,7 +27,7 @@ msgstr ":mod:`chunk` --- 讀取 IFF 分塊資料" msgid "**Source code:** :source:`Lib/chunk.py`" msgstr "**原始碼：**\\ :source:`Lib/chunk.py`" -#: ../../library/chunk.rst:23 +#: ../../library/chunk.rst:20 msgid "" "The :mod:`chunk` module is deprecated (see :pep:`PEP 594 <594#chunk>` for " "details)." diff --git a/library/collections.abc.po b/library/collections.abc.po index fae3cb4e53..cbc39fdca9 100644 --- a/library/collections.abc.po +++ b/library/collections.abc.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 14:41+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -506,7 +506,7 @@ msgstr "" msgid "The index() method added support for *stop* and *start* arguments." msgstr "" -#: ../../library/collections.abc.rst:281 +#: ../../library/collections.abc.rst:277 msgid "" "The :class:`ByteString` ABC has been deprecated. For use in typing, prefer a " "union, like ``bytes | bytearray``, or :class:`collections.abc.Buffer`. For " diff --git a/library/colorsys.po b/library/colorsys.po index 055afa0fd7..f1fe5ebabc 100644 --- a/library/colorsys.po +++ b/library/colorsys.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2022-02-15 20:58+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -29,12 +29,13 @@ msgid "**Source code:** :source:`Lib/colorsys.py`" msgstr "**原始碼：**\\ :source:`Lib/colorsys.py`" #: ../../library/colorsys.rst:13 +#, fuzzy msgid "" "The :mod:`colorsys` module defines bidirectional conversions of color values " "between colors expressed in the RGB (Red Green Blue) color space used in " "computer monitors and three other coordinate systems: YIQ, HLS (Hue " "Lightness Saturation) and HSV (Hue Saturation Value). Coordinates in all of " -"these color spaces are floating point values. In the YIQ space, the Y " +"these color spaces are floating-point values. In the YIQ space, the Y " "coordinate is between 0 and 1, but the I and Q coordinates can be positive " "or negative. In all other spaces, the coordinates are all between 0 and 1." msgstr "" diff --git a/library/configparser.po b/library/configparser.po index 1dbf75df8f..1551d3fb1a 100644 --- a/library/configparser.po +++ b/library/configparser.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-14 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 14:41+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -931,7 +931,7 @@ msgstr "" #: ../../library/configparser.rst:1155 msgid "" "A convenience method which coerces the *option* in the specified *section* " -"to a floating point number. See :meth:`get` for explanation of *raw*, " +"to a floating-point number. See :meth:`get` for explanation of *raw*, " "*vars* and *fallback*." msgstr "" diff --git a/library/crypt.po b/library/crypt.po index 7d1e2ec368..e7cd1918e2 100644 --- a/library/crypt.po +++ b/library/crypt.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-16 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 14:42+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -26,7 +26,7 @@ msgstr ":mod:`crypt` --- 用於檢查 Unix 密碼的函式" msgid "**Source code:** :source:`Lib/crypt.py`" msgstr "**原始碼：**\\ :source:`Lib/crypt.py`" -#: ../../library/crypt.rst:24 +#: ../../library/crypt.rst:19 msgid "" "The :mod:`crypt` module is deprecated (see :pep:`PEP 594 <594#crypt>` for " "details and alternatives). The :mod:`hashlib` module is a potential " diff --git a/library/decimal.po b/library/decimal.po index 4bc9950c75..cf2c412b65 100644 --- a/library/decimal.po +++ b/library/decimal.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-14 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 14:43+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -19,7 +19,8 @@ msgstr "" "Plural-Forms: nplurals=1; plural=0;\n" #: ../../library/decimal.rst:2 -msgid ":mod:`!decimal` --- Decimal fixed point and floating point arithmetic" +#, fuzzy +msgid ":mod:`!decimal` --- Decimal fixed-point and floating-point arithmetic" msgstr ":mod:`!decimal` --- 十進位固定點和浮點運算" #: ../../library/decimal.rst:15 @@ -29,7 +30,7 @@ msgstr "**原始碼：**\\ :source:`Lib/decimal.py`" #: ../../library/decimal.rst:33 msgid "" "The :mod:`decimal` module provides support for fast correctly rounded " -"decimal floating point arithmetic. It offers several advantages over the :" +"decimal floating-point arithmetic. It offers several advantages over the :" "class:`float` datatype:" msgstr "" @@ -188,7 +189,7 @@ msgstr "" #: ../../library/decimal.rst:209 msgid "" "Decimals interact well with much of the rest of Python. Here is a small " -"decimal floating point flying circus:" +"decimal floating-point flying circus:" msgstr "" #: ../../library/decimal.rst:241 @@ -289,7 +290,7 @@ msgstr "" #: ../../library/decimal.rst:376 msgid "" -"If *value* is a :class:`float`, the binary floating point value is " +"If *value* is a :class:`float`, the binary floating-point value is " "losslessly converted to its exact decimal equivalent. This conversion can " "often require 53 or more digits of precision. For example, " "``Decimal(float('1.1'))`` converts to " @@ -336,7 +337,7 @@ msgstr "" #: ../../library/decimal.rst:406 msgid "" -"Decimal floating point objects share many properties with the other built-in " +"Decimal floating-point objects share many properties with the other built-in " "numeric types such as :class:`float` and :class:`int`. All of the usual " "math operations and special methods apply. Likewise, decimal objects can be " "copied, pickled, printed, used as dictionary keys, used as set elements, " @@ -384,7 +385,7 @@ msgstr "" #: ../../library/decimal.rst:448 msgid "" -"In addition to the standard numeric properties, decimal floating point " +"In addition to the standard numeric properties, decimal floating-point " "objects also have a number of specialized methods:" msgstr "" @@ -1759,7 +1760,7 @@ msgid "The following table summarizes the hierarchy of signals::" msgstr "" #: ../../library/decimal.rst:1745 -msgid "Floating Point Notes" +msgid "Floating-Point Notes" msgstr "" #: ../../library/decimal.rst:1749 @@ -1779,7 +1780,7 @@ msgid "" "The effects of round-off error can be amplified by the addition or " "subtraction of nearly offsetting quantities resulting in loss of " "significance. Knuth provides two instructive examples where rounded " -"floating point arithmetic with insufficient precision causes the breakdown " +"floating-point arithmetic with insufficient precision causes the breakdown " "of the associative and distributive properties of addition:" msgstr "" @@ -1864,7 +1865,7 @@ msgid "" "In addition to the two signed zeros which are distinct yet equal, there are " "various representations of zero with differing precisions yet equivalent in " "value. This takes a bit of getting used to. For an eye accustomed to " -"normalized floating point representations, it is not immediately obvious " +"normalized floating-point representations, it is not immediately obvious " "that the following calculation returns a value equal to zero:" msgstr "" @@ -2015,7 +2016,7 @@ msgstr "" #: ../../library/decimal.rst:2174 msgid "" -"A. Yes, any binary floating point number can be exactly expressed as a " +"A. Yes, any binary floating-point number can be exactly expressed as a " "Decimal though an exact conversion may take more precision than intuition " "would suggest:" msgstr "" @@ -2071,7 +2072,7 @@ msgid "" "A. Yes. In the CPython and PyPy3 implementations, the C/CFFI versions of " "the decimal module integrate the high speed `libmpdec `_ library for arbitrary precision " -"correctly rounded decimal floating point arithmetic [#]_. ``libmpdec`` uses " +"correctly rounded decimal floating-point arithmetic [#]_. ``libmpdec`` uses " "`Karatsuba multiplication `_ for medium-sized numbers and the `Number Theoretic " "Transform \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1587,7 +1587,7 @@ msgid "``INTRINSIC_ASYNC_GEN_WRAP``" msgstr "``INTRINSIC_ASYNC_GEN_WRAP``" #: ../../library/dis.rst:1595 -msgid "Wraps an aync generator value" +msgid "Wraps an async generator value" msgstr "" #: ../../library/dis.rst:1597 diff --git a/library/email.utils.po b/library/email.utils.po index a5dabf0f2b..5f859dc179 100644 --- a/library/email.utils.po +++ b/library/email.utils.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -42,7 +42,7 @@ msgid "" "ignored." msgstr "" -#: ../../library/email.utils.rst:26 +#: ../../library/email.utils.rst:25 msgid "The *isdst* parameter." msgstr "" @@ -167,7 +167,7 @@ msgstr "" #: ../../library/email.utils.rst:151 msgid "" -"Optional *timeval* if given is a floating point time value as accepted by :" +"Optional *timeval* if given is a floating-point time value as accepted by :" "func:`time.gmtime` and :func:`time.localtime`, otherwise the current time is " "used." msgstr "" diff --git a/library/exceptions.po b/library/exceptions.po index f76ca76a44..a8aa0b3b9e 100644 --- a/library/exceptions.po +++ b/library/exceptions.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-06 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2024-03-12 20:57+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -565,8 +565,8 @@ msgid "" "represented. This cannot occur for integers (which would rather raise :exc:" "`MemoryError` than give up). However, for historical reasons, OverflowError " "is sometimes raised for integers that are outside a required range. " -"Because of the lack of standardization of floating point exception handling " -"in C, most floating point operations are not checked." +"Because of the lack of standardization of floating-point exception handling " +"in C, most floating-point operations are not checked." msgstr "" #: ../../library/exceptions.rst:421 diff --git a/library/fractions.po b/library/fractions.po index 9f1b234e18..20873cd4c6 100644 --- a/library/fractions.po +++ b/library/fractions.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2016-01-31 07:18+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -47,7 +47,7 @@ msgid "" "class:`Fraction` instance with the same value. The next two versions accept " "either a :class:`float` or a :class:`decimal.Decimal` instance, and return " "a :class:`Fraction` instance with exactly the same value. Note that due to " -"the usual issues with binary floating-point (see :ref:`tut-fp-issues`), the " +"the usual issues with binary floating point (see :ref:`tut-fp-issues`), the " "argument to ``Fraction(1.1)`` is not exactly equal to 11/10, and so " "``Fraction(1.1)`` does *not* return ``Fraction(11, 10)`` as one might " "expect. (But see the documentation for the :meth:`limit_denominator` method " diff --git a/library/functions.po b/library/functions.po index 19280c8052..004d0a45b7 100644 --- a/library/functions.po +++ b/library/functions.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-19 01:06+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2024-05-06 17:06+0800\n" "Last-Translator: KNChiu \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -398,9 +398,10 @@ msgid ":func:`__import__`" msgstr ":func:`__import__`" #: ../../library/functions.rst:59 +#, fuzzy msgid "" "Return the absolute value of a number. The argument may be an integer, a " -"floating point number, or an object implementing :meth:`~object.__abs__`. If " +"floating-point number, or an object implementing :meth:`~object.__abs__`. If " "the argument is a complex number, its magnitude is returned." msgstr "" "回傳一個數的絕對值，引數可以是整數、浮點數或有實現 :meth:`~object.__abs__` 的" @@ -1081,11 +1082,12 @@ msgstr "" "中。" #: ../../library/functions.rst:538 +#, fuzzy msgid "" "Take two (non-complex) numbers as arguments and return a pair of numbers " "consisting of their quotient and remainder when using integer division. " "With mixed operand types, the rules for binary arithmetic operators apply. " -"For integers, the result is the same as ``(a // b, a % b)``. For floating " +"For integers, the result is the same as ``(a // b, a % b)``. For floating-" "point numbers the result is ``(q, a % b)``, where *q* is usually ``math." "floor(a / b)`` but may be 1 less than that. In any case ``q * b + a % b`` " "is very close to *a*, if ``a % b`` is non-zero it has the same sign as *b*, " @@ -1354,7 +1356,8 @@ msgstr "" "*iterable* 中元素的互補函式。" #: ../../library/functions.rst:717 -msgid "Return a floating point number constructed from a number or a string." +#, fuzzy +msgid "Return a floating-point number constructed from a number or a string." msgstr "回傳從數字或字串生成的浮點數。" #: ../../library/functions.rst:734 @@ -1381,9 +1384,10 @@ msgstr "" "示正無窮大。" #: ../../library/functions.rst:758 +#, fuzzy msgid "" -"Otherwise, if the argument is an integer or a floating point number, a " -"floating point number with the same value (within Python's floating point " +"Otherwise, if the argument is an integer or a floating-point number, a " +"floating-point number with the same value (within Python's floating-point " "precision) is returned. If the argument is outside the range of a Python " "float, an :exc:`OverflowError` will be raised." msgstr "" @@ -1692,7 +1696,7 @@ msgid "" "If the argument defines :meth:`~object.__int__`, ``int(x)`` returns ``x." "__int__()``. If the argument defines :meth:`~object.__index__`, it returns " "``x.__index__()``. If the argument defines :meth:`~object.__trunc__`, it " -"returns ``x.__trunc__()``. For floating point numbers, this truncates " +"returns ``x.__trunc__()``. For floating-point numbers, this truncates " "towards zero." msgstr "" "回傳一個使用數字或字串 *x* 建構的整數物件，或者在沒有引數時回傳 ``0``。如果 " @@ -2938,7 +2942,7 @@ msgstr "" msgid "" "For some use cases, there are good alternatives to :func:`sum`. The " "preferred, fast way to concatenate a sequence of strings is by calling ``''." -"join(sequence)``. To add floating point values with extended precision, " +"join(sequence)``. To add floating-point values with extended precision, " "see :func:`math.fsum`\\. To concatenate a series of iterables, consider " "using :func:`itertools.chain`." msgstr "" diff --git a/library/imghdr.po b/library/imghdr.po index 8c3cf55379..02f6e0f911 100644 --- a/library/imghdr.po +++ b/library/imghdr.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-07-17 17:39+0800\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2022-05-22 02:06+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -27,7 +27,7 @@ msgstr ":mod:`imghdr` --- 推測圖片種類" msgid "**Source code:** :source:`Lib/imghdr.py`" msgstr "**原始碼：**\\ :source:`Lib/imghdr.py`" -#: ../../library/imghdr.rst:13 +#: ../../library/imghdr.rst:10 msgid "" "The :mod:`imghdr` module is deprecated (see :pep:`PEP 594 <594#imghdr>` for " "details and alternatives)." diff --git a/library/importlib.po b/library/importlib.po index 0777be88b4..eca2d80194 100644 --- a/library/importlib.po +++ b/library/importlib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 00:04+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:04+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -894,7 +894,7 @@ msgid "" "with this ABC should only be returned when the specified module is a package." msgstr "" -#: ../../library/importlib.rst:685 ../../library/importlib.rst:795 +#: ../../library/importlib.rst:683 ../../library/importlib.rst:793 msgid "Use :class:`importlib.resources.abc.TraversableResources` instead." msgstr "" @@ -957,7 +957,7 @@ msgid "" "resources.as_file`." msgstr "" -#: ../../library/importlib.rst:737 +#: ../../library/importlib.rst:735 msgid "Use :class:`importlib.resources.abc.Traversable` instead." msgstr "" diff --git a/library/importlib.resources.abc.po b/library/importlib.resources.abc.po index 1ad092708b..0bf49a9636 100644 --- a/library/importlib.resources.abc.po +++ b/library/importlib.resources.abc.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -65,7 +65,7 @@ msgid "" "with this ABC should only be returned when the specified module is a package." msgstr "" -#: ../../library/importlib.resources.abc.rst:48 +#: ../../library/importlib.resources.abc.rst:46 msgid "Use :class:`importlib.resources.abc.TraversableResources` instead." msgstr "" diff --git a/library/itertools.po b/library/itertools.po index e6f6d956c8..c1b868fca8 100644 --- a/library/itertools.po +++ b/library/itertools.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-02 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2024-07-09 13:34+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -42,8 +42,8 @@ msgid "" "efficiently in pure Python." msgstr "" "這個模組標準化了快速且高效率利用記憶體的核心工具集，這些工具本身或組合使用都" -"很有用。它們共同構成了一個「疊代器代數 (iterator algebra)」，使得在純 " -"Python 中簡潔且高效地建構專用工具成為可能。" +"很有用。它們共同構成了一個「疊代器代數 (iterator algebra)」，使得在純 Python " +"中簡潔且高效地建構專用工具成為可能。" #: ../../library/itertools.rst:29 msgid "" @@ -561,8 +561,8 @@ msgid "" "If the input elements are unique, there will be no repeated values within " "each combination." msgstr "" -"元素是根據它們的位置（而非值）來決定其唯一性。如果輸入的元素都是獨特" -"的，則每個組合內將不會有重複的值。" +"元素是根據它們的位置（而非值）來決定其唯一性。如果輸入的元素都是獨特的，則每" +"個組合內將不會有重複的值。" #: ../../library/itertools.rst:263 msgid "" @@ -597,8 +597,8 @@ msgid "" "If the input elements are unique, the generated combinations will also be " "unique." msgstr "" -"元素是根據它們的位置（而非值）來決定其唯一性。如果輸入的元素都是獨特" -"的，生成的組合也將是獨特的。" +"元素是根據它們的位置（而非值）來決定其唯一性。如果輸入的元素都是獨特的，生成" +"的組合也將是獨特的。" #: ../../library/itertools.rst:305 msgid "" @@ -619,8 +619,9 @@ msgstr "" "產生連續的資料點，或與 :func:`zip` 一起使用來增加序列號。大致等價於： ::" #: ../../library/itertools.rst:332 +#, fuzzy msgid "" -"When counting with floating point numbers, better accuracy can sometimes be " +"When counting with floating-point numbers, better accuracy can sometimes be " "achieved by substituting multiplicative code such as: ``(start + step * i " "for i in count())``." msgstr "" @@ -682,8 +683,8 @@ msgid "" msgstr "" "建立一個疊代器，回傳 *iterable* 中連續的鍵和群組。*key* 是一個為每個元素計算" "鍵值的函式。如果其未指定或為 ``None``，則 *key* 預設為一個識別性函式 " -"(identity function)，並回傳未被更改的元素。一般來說，可疊代物件需要已經用相" -"同的鍵函式進行排序。" +"(identity function)，並回傳未被更改的元素。一般來說，可疊代物件需要已經用相同" +"的鍵函式進行排序。" #: ../../library/itertools.rst:406 msgid "" diff --git a/library/locale.po b/library/locale.po index 12cb2ebde4..0140286513 100644 --- a/library/locale.po +++ b/library/locale.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:05+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -608,7 +608,7 @@ msgstr "" #: ../../library/locale.rst:436 msgid "" "Formats a number *val* according to the current :const:`LC_NUMERIC` setting. " -"The format follows the conventions of the ``%`` operator. For floating " +"The format follows the conventions of the ``%`` operator. For floating-" "point values, the decimal point is modified if appropriate. If *grouping* " "is ``True``, also takes the grouping into account." msgstr "" @@ -651,7 +651,7 @@ msgstr "" #: ../../library/locale.rst:468 msgid "" -"Formats a floating point number using the same format as the built-in " +"Formats a floating-point number using the same format as the built-in " "function ``str(float)``, but takes the decimal point into account." msgstr "" diff --git a/library/mailcap.po b/library/mailcap.po index 84dd53fe96..021a6a6ef9 100644 --- a/library/mailcap.po +++ b/library/mailcap.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-15 20:43+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2015-12-09 17:51+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -26,7 +26,7 @@ msgstr ":mod:`mailcap` --- Mailcap 檔案處理" msgid "**Source code:** :source:`Lib/mailcap.py`" msgstr "**原始碼：**\\ :source:`Lib/mailcap.py`" -#: ../../library/mailcap.rst:14 +#: ../../library/mailcap.rst:10 msgid "" "The :mod:`mailcap` module is deprecated (see :pep:`PEP 594 <594#mailcap>` " "for details). The :mod:`mimetypes` module provides an alternative." diff --git a/library/marshal.po b/library/marshal.po index 01e9a4f860..df164a415e 100644 --- a/library/marshal.po +++ b/library/marshal.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-20 00:04+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2023-04-24 21:28+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -71,11 +71,12 @@ msgstr "" "unmarshal 來自不受信任的或來源未經驗證的資料。" #: ../../library/marshal.rst:39 +#, fuzzy msgid "" "Not all Python object types are supported; in general, only objects whose " "value is independent from a particular invocation of Python can be written " "and read by this module. The following types are supported: booleans, " -"integers, floating point numbers, complex numbers, strings, bytes, " +"integers, floating-point numbers, complex numbers, strings, bytes, " "bytearrays, tuples, lists, sets, frozensets, dictionaries, and code objects, " "where it should be understood that tuples, lists, sets, frozensets and " "dictionaries are only supported as long as the values contained therein are " @@ -218,10 +219,11 @@ msgid "In addition, the following constants are defined:" msgstr "此外，還定義了以下常數：" #: ../../library/marshal.rst:122 +#, fuzzy msgid "" "Indicates the format that the module uses. Version 0 is the historical " "format, version 1 shares interned strings and version 2 uses a binary format " -"for floating point numbers. Version 3 adds support for object instancing and " +"for floating-point numbers. Version 3 adds support for object instancing and " "recursion. The current version is 4." msgstr "" "表示 module 所使用的格式。第 0 版為歷史格式，第 1 版共享了駐留字串 (interned " diff --git a/library/math.po b/library/math.po index d6dfe0e852..3ea2875b4f 100644 --- a/library/math.po +++ b/library/math.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-03-14 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2024-04-26 15:15+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -163,8 +163,9 @@ msgstr "" "``0.5 <= abs(m) < 1``。此函式用於以可攜的方式「分割」浮點數內部表示法。" #: ../../library/math.rst:110 +#, fuzzy msgid "" -"Return an accurate floating point sum of values in the iterable. Avoids " +"Return an accurate floating-point sum of values in the iterable. Avoids " "loss of precision by tracking multiple intermediate partial sums." msgstr "" "回傳可疊代物件（iterable）中所有值的精確浮點數和。透過追蹤過程中多個部分和" @@ -183,9 +184,10 @@ msgstr "" "程中同一部分和重複捨入，並使其最低有效位不如預期。" #: ../../library/math.rst:119 +#, fuzzy msgid "" "For further discussion and two alternative approaches, see the `ASPN " -"cookbook recipes for accurate floating point summation `_\\." msgstr "" @@ -418,7 +420,7 @@ msgstr "" #: ../../library/math.rst:291 msgid "" -"On platforms using IEEE 754 binary floating-point, the result of this " +"On platforms using IEEE 754 binary floating point, the result of this " "operation is always exactly representable: no rounding error is introduced." msgstr "" diff --git a/library/msilib.po b/library/msilib.po index d441ba059f..66e0e47ca3 100644 --- a/library/msilib.po +++ b/library/msilib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-09 00:15+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:06+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -26,7 +26,7 @@ msgstr ":mod:`msilib` --- 讀寫 Microsoft Installer 檔案" msgid "**Source code:** :source:`Lib/msilib/__init__.py`" msgstr "**原始碼：**\\ :source:`Lib/msilib/__init__.py`" -#: ../../library/msilib.rst:19 +#: ../../library/msilib.rst:16 msgid "" "The :mod:`msilib` module is deprecated (see :pep:`PEP 594 <594#msilib>` for " "details)." diff --git a/library/nis.po b/library/nis.po index 03a190b32b..02a77493b4 100644 --- a/library/nis.po +++ b/library/nis.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-02-13 00:17+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2016-11-19 00:32+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -22,7 +22,7 @@ msgstr "" msgid ":mod:`nis` --- Interface to Sun's NIS (Yellow Pages)" msgstr ":mod:`nis` --- Sun NIS (Yellow Pages) 介面" -#: ../../library/nis.rst:16 +#: ../../library/nis.rst:13 msgid "" "The :mod:`nis` module is deprecated (see :pep:`PEP 594 <594#nis>` for " "details)." diff --git a/library/os.path.po b/library/os.path.po index 9717189910..86f390bdbf 100644 --- a/library/os.path.po +++ b/library/os.path.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2023-07-13 14:06+0800\n" "Last-Translator: Po-Chuan Chen \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -268,8 +268,9 @@ msgstr "" "``%name%`` 形式的展開。" #: ../../library/os.path.rst:201 +#, fuzzy msgid "" -"Return the time of last access of *path*. The return value is a floating " +"Return the time of last access of *path*. The return value is a floating-" "point number giving the number of seconds since the epoch (see the :mod:" "`time` module). Raise :exc:`OSError` if the file does not exist or is " "inaccessible." @@ -278,9 +279,10 @@ msgstr "" "模組）以來的秒數。如果檔案不存在或無法存取，則引發 :exc:`OSError`。" #: ../../library/os.path.rst:208 +#, fuzzy msgid "" "Return the time of last modification of *path*. The return value is a " -"floating point number giving the number of seconds since the epoch (see " +"floating-point number giving the number of seconds since the epoch (see " "the :mod:`time` module). Raise :exc:`OSError` if the file does not exist or " "is inaccessible." msgstr "" diff --git a/library/ossaudiodev.po b/library/ossaudiodev.po index 32e2bf2bed..4195725dd1 100644 --- a/library/ossaudiodev.po +++ b/library/ossaudiodev.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 00:04+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2022-05-22 02:10+0800\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -23,7 +23,7 @@ msgstr "" msgid ":mod:`ossaudiodev` --- Access to OSS-compatible audio devices" msgstr ":mod:`ossaudiodev` --- 對 OSS 相容聲音裝置的存取" -#: ../../library/ossaudiodev.rst:12 +#: ../../library/ossaudiodev.rst:9 msgid "" "The :mod:`ossaudiodev` module is deprecated (see :pep:`PEP 594 " "<594#ossaudiodev>` for details)." diff --git a/library/pipes.po b/library/pipes.po index 92d04cb5c7..148c36d340 100644 --- a/library/pipes.po +++ b/library/pipes.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-02-13 00:17+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2022-05-22 02:11+0800\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -27,7 +27,7 @@ msgstr ":mod:`pipes` --- shell pipelines 介面" msgid "**Source code:** :source:`Lib/pipes.py`" msgstr "**原始碼：**\\ :source:`Lib/pipes.py`" -#: ../../library/pipes.rst:17 +#: ../../library/pipes.rst:13 msgid "" "The :mod:`pipes` module is deprecated (see :pep:`PEP 594 <594#pipes>` for " "details). Please use the :mod:`subprocess` module instead." diff --git a/library/pkgutil.po b/library/pkgutil.po index 00ad3502a6..087bfa6e08 100644 --- a/library/pkgutil.po +++ b/library/pkgutil.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2024-03-08 16:07+0000\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -56,14 +56,15 @@ msgstr "" "錄時，這會非常有用。" #: ../../library/pkgutil.rst:33 +#, fuzzy msgid "" "It also looks for :file:`\\*.pkg` files beginning where ``*`` matches the " "*name* argument. This feature is similar to :file:`\\*.pth` files (see the :" "mod:`site` module for more information), except that it doesn't special-case " "lines starting with ``import``. A :file:`\\*.pkg` file is trusted at face " -"value: apart from checking for duplicates, all entries found in a :file:`\\*." -"pkg` file are added to the path, regardless of whether they exist on the " -"filesystem. (This is a feature.)" +"value: apart from skipping blank lines and ignoring comments, all entries " +"found in a :file:`\\*.pkg` file are added to the path, regardless of whether " +"they exist on the filesystem (this is a feature)." msgstr "" "它還會尋找 :file:`\\*.pkg` 檔案，其中開頭的 ``*`` 與 *name* 引數相符。此功能" "類似於 :file:`\\*.pth` 檔案（更多資訊請參閱 :mod:`site` 模組），但他不特別處" @@ -121,7 +122,7 @@ msgstr "" msgid "Updated to be based on :pep:`451`" msgstr "基於 :pep:`451` 來更新" -#: ../../library/pkgutil.rst:68 ../../library/pkgutil.rst:104 +#: ../../library/pkgutil.rst:67 ../../library/pkgutil.rst:103 msgid "Use :func:`importlib.util.find_spec` instead." msgstr "改用 :func:`importlib.util.find_spec`。" diff --git a/library/profile.po b/library/profile.po index 39f604d1ad..e7c1e71113 100644 --- a/library/profile.po +++ b/library/profile.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-14 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:08+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -929,7 +929,7 @@ msgid "" "function that you choose (see :ref:`profile-calibration`). For most " "machines, a timer that returns a lone integer value will provide the best " "results in terms of low overhead during profiling. (:func:`os.times` is " -"*pretty* bad, as it returns a tuple of floating point values). If you want " +"*pretty* bad, as it returns a tuple of floating-point values). If you want " "to substitute a better timer in the cleanest fashion, derive a class and " "hardwire a replacement dispatch method that best handles your timer call, " "along with the appropriate calibration constant." diff --git a/library/random.po b/library/random.po index 09192af648..fba004e39f 100644 --- a/library/random.po +++ b/library/random.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2023-01-23 22:47+0800\n" "Last-Translator: Allen Wu \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -345,10 +345,11 @@ msgstr "" "`ValueError`。" #: ../../library/random.rst:195 +#, fuzzy msgid "" "For a given seed, the :func:`choices` function with equal weighting " "typically produces a different sequence than repeated calls to :func:" -"`choice`. The algorithm used by :func:`choices` uses floating point " +"`choice`. The algorithm used by :func:`choices` uses floating-point " "arithmetic for internal consistency and speed. The algorithm used by :func:" "`choice` defaults to integer arithmetic with repeated selections to avoid " "small biases from round-off error." @@ -501,13 +502,15 @@ msgstr "" "實踐所示；這些方程式中的大多數都可以在任意統計文本中找到。" #: ../../library/random.rst:295 +#, fuzzy msgid "" -"Return the next random floating point number in the range ``0.0 <= X < 1.0``" +"Return the next random floating-point number in the range ``0.0 <= X < 1.0``" msgstr "回傳範圍 ``0.0 <= X < 1.0`` 中的下一個隨機浮點數" #: ../../library/random.rst:300 +#, fuzzy msgid "" -"Return a random floating point number *N* such that ``a <= N <= b`` for ``a " +"Return a random floating-point number *N* such that ``a <= N <= b`` for ``a " "<= b`` and ``b <= N <= a`` for ``b < a``." msgstr "" "回傳一個隨機浮點數 *N*，當 ``a <= b`` 時確保 N 為 ``a <= N <= b`` 、``b < " @@ -522,8 +525,9 @@ msgstr "" "a) * random()`` 中的浮點捨入。" #: ../../library/random.rst:310 +#, fuzzy msgid "" -"Return a random floating point number *N* such that ``low <= N <= high`` and " +"Return a random floating-point number *N* such that ``low <= N <= high`` and " "with the specified *mode* between those bounds. The *low* and *high* bounds " "default to zero and one. The *mode* argument defaults to the midpoint " "between the bounds, giving a symmetric distribution." diff --git a/library/readline.po b/library/readline.po index b5ee15bb42..800ce560dc 100644 --- a/library/readline.po +++ b/library/readline.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:09+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -66,76 +66,83 @@ msgid "" "keybindings and TAB completion::" msgstr "" -#: ../../library/readline.rst:49 +#: ../../library/readline.rst:47 +msgid "" +"Also note that different libraries may use different history file formats. " +"When switching the underlying library, existing history files may become " +"unusable." +msgstr "" + +#: ../../library/readline.rst:53 msgid "Init file" msgstr "" -#: ../../library/readline.rst:51 +#: ../../library/readline.rst:55 msgid "The following functions relate to the init file and user configuration:" msgstr "" -#: ../../library/readline.rst:56 +#: ../../library/readline.rst:60 msgid "" "Execute the init line provided in the *string* argument. This calls :c:func:" "`rl_parse_and_bind` in the underlying library." msgstr "" -#: ../../library/readline.rst:62 +#: ../../library/readline.rst:66 msgid "" "Execute a readline initialization file. The default filename is the last " "filename used. This calls :c:func:`rl_read_init_file` in the underlying " "library." msgstr "" -#: ../../library/readline.rst:67 +#: ../../library/readline.rst:71 msgid "Line buffer" msgstr "" -#: ../../library/readline.rst:69 +#: ../../library/readline.rst:73 msgid "The following functions operate on the line buffer:" msgstr "" -#: ../../library/readline.rst:74 +#: ../../library/readline.rst:78 msgid "" "Return the current contents of the line buffer (:c:data:`rl_line_buffer` in " "the underlying library)." msgstr "" -#: ../../library/readline.rst:80 +#: ../../library/readline.rst:84 msgid "" "Insert text into the line buffer at the cursor position. This calls :c:func:" "`rl_insert_text` in the underlying library, but ignores the return value." msgstr "" -#: ../../library/readline.rst:87 +#: ../../library/readline.rst:91 msgid "" "Change what's displayed on the screen to reflect the current contents of the " "line buffer. This calls :c:func:`rl_redisplay` in the underlying library." msgstr "" -#: ../../library/readline.rst:92 +#: ../../library/readline.rst:96 msgid "History file" msgstr "" -#: ../../library/readline.rst:94 +#: ../../library/readline.rst:98 msgid "The following functions operate on a history file:" msgstr "" -#: ../../library/readline.rst:99 +#: ../../library/readline.rst:103 msgid "" "Load a readline history file, and append it to the history list. The default " "filename is :file:`~/.history`. This calls :c:func:`read_history` in the " "underlying library." msgstr "" -#: ../../library/readline.rst:106 +#: ../../library/readline.rst:110 msgid "" "Save the history list to a readline history file, overwriting any existing " "file. The default filename is :file:`~/.history`. This calls :c:func:" "`write_history` in the underlying library." msgstr "" -#: ../../library/readline.rst:113 +#: ../../library/readline.rst:117 msgid "" "Append the last *nelements* items of history to a file. The default " "filename is :file:`~/.history`. The file must already exist. This calls :c:" @@ -143,7 +150,7 @@ msgid "" "if Python was compiled for a version of the library that supports it." msgstr "" -#: ../../library/readline.rst:125 +#: ../../library/readline.rst:129 msgid "" "Set or return the desired number of lines to save in the history file. The :" "func:`write_history_file` function uses this value to truncate the history " @@ -151,72 +158,72 @@ msgid "" "Negative values imply unlimited history file size." msgstr "" -#: ../../library/readline.rst:133 +#: ../../library/readline.rst:137 msgid "History list" msgstr "" -#: ../../library/readline.rst:135 +#: ../../library/readline.rst:139 msgid "The following functions operate on a global history list:" msgstr "" -#: ../../library/readline.rst:140 +#: ../../library/readline.rst:144 msgid "" "Clear the current history. This calls :c:func:`clear_history` in the " "underlying library. The Python function only exists if Python was compiled " "for a version of the library that supports it." msgstr "" -#: ../../library/readline.rst:147 +#: ../../library/readline.rst:151 msgid "" "Return the number of items currently in the history. (This is different " "from :func:`get_history_length`, which returns the maximum number of lines " "that will be written to a history file.)" msgstr "" -#: ../../library/readline.rst:154 +#: ../../library/readline.rst:158 msgid "" "Return the current contents of history item at *index*. The item index is " "one-based. This calls :c:func:`history_get` in the underlying library." msgstr "" -#: ../../library/readline.rst:160 +#: ../../library/readline.rst:164 msgid "" "Remove history item specified by its position from the history. The position " "is zero-based. This calls :c:func:`remove_history` in the underlying " "library." msgstr "" -#: ../../library/readline.rst:167 +#: ../../library/readline.rst:171 msgid "" "Replace history item specified by its position with *line*. The position is " "zero-based. This calls :c:func:`replace_history_entry` in the underlying " "library." msgstr "" -#: ../../library/readline.rst:174 +#: ../../library/readline.rst:178 msgid "" "Append *line* to the history buffer, as if it was the last line typed. This " "calls :c:func:`add_history` in the underlying library." msgstr "" -#: ../../library/readline.rst:180 +#: ../../library/readline.rst:184 msgid "" "Enable or disable automatic calls to :c:func:`add_history` when reading " "input via readline. The *enabled* argument should be a Boolean value that " "when true, enables auto history, and that when false, disables auto history." msgstr "" -#: ../../library/readline.rst:188 +#: ../../library/readline.rst:192 msgid "" "Auto history is enabled by default, and changes to this do not persist " "across multiple sessions." msgstr "" -#: ../../library/readline.rst:193 +#: ../../library/readline.rst:197 msgid "Startup hooks" msgstr "" -#: ../../library/readline.rst:198 +#: ../../library/readline.rst:202 msgid "" "Set or remove the function invoked by the :c:data:`rl_startup_hook` callback " "of the underlying library. If *function* is specified, it will be used as " @@ -225,7 +232,7 @@ msgid "" "readline prints the first prompt." msgstr "" -#: ../../library/readline.rst:207 +#: ../../library/readline.rst:211 msgid "" "Set or remove the function invoked by the :c:data:`rl_pre_input_hook` " "callback of the underlying library. If *function* is specified, it will be " @@ -236,11 +243,11 @@ msgid "" "of the library that supports it." msgstr "" -#: ../../library/readline.rst:219 +#: ../../library/readline.rst:223 msgid "Completion" msgstr "" -#: ../../library/readline.rst:221 +#: ../../library/readline.rst:225 msgid "" "The following functions relate to implementing a custom word completion " "function. This is typically operated by the Tab key, and can suggest and " @@ -250,7 +257,7 @@ msgid "" "custom completer, a different set of word delimiters should be set." msgstr "" -#: ../../library/readline.rst:231 +#: ../../library/readline.rst:235 msgid "" "Set or remove the completer function. If *function* is specified, it will " "be used as the new completer function; if omitted or ``None``, any completer " @@ -260,7 +267,7 @@ msgid "" "starting with *text*." msgstr "" -#: ../../library/readline.rst:238 +#: ../../library/readline.rst:242 msgid "" "The installed completer function is invoked by the *entry_func* callback " "passed to :c:func:`rl_completion_matches` in the underlying library. The " @@ -268,19 +275,19 @@ msgid "" "`rl_attempted_completion_function` callback of the underlying library." msgstr "" -#: ../../library/readline.rst:247 +#: ../../library/readline.rst:251 msgid "" "Get the completer function, or ``None`` if no completer function has been " "set." msgstr "" -#: ../../library/readline.rst:252 +#: ../../library/readline.rst:256 msgid "" "Get the type of completion being attempted. This returns the :c:data:" "`rl_completion_type` variable in the underlying library as an integer." msgstr "" -#: ../../library/readline.rst:260 +#: ../../library/readline.rst:264 msgid "" "Get the beginning or ending index of the completion scope. These indexes are " "the *start* and *end* arguments passed to the :c:data:" @@ -290,7 +297,7 @@ msgid "" "differently than libreadline." msgstr "" -#: ../../library/readline.rst:271 +#: ../../library/readline.rst:275 msgid "" "Set or get the word delimiters for completion. These determine the start of " "the word to be considered for completion (the completion scope). These " @@ -298,7 +305,7 @@ msgid "" "in the underlying library." msgstr "" -#: ../../library/readline.rst:279 +#: ../../library/readline.rst:283 msgid "" "Set or remove the completion display function. If *function* is specified, " "it will be used as the new completion display function; if omitted or " @@ -309,11 +316,11 @@ msgid "" "each time matches need to be displayed." msgstr "" -#: ../../library/readline.rst:292 +#: ../../library/readline.rst:296 msgid "Example" msgstr "範例" -#: ../../library/readline.rst:294 +#: ../../library/readline.rst:298 msgid "" "The following example demonstrates how to use the :mod:`readline` module's " "history reading and writing functions to automatically load and save a " @@ -322,19 +329,19 @@ msgid "" "sessions from the user's :envvar:`PYTHONSTARTUP` file. ::" msgstr "" -#: ../../library/readline.rst:314 +#: ../../library/readline.rst:318 msgid "" "This code is actually automatically run when Python is run in :ref:" "`interactive mode ` (see :ref:`rlcompleter-config`)." msgstr "" -#: ../../library/readline.rst:317 +#: ../../library/readline.rst:321 msgid "" "The following example achieves the same goal but supports concurrent " "interactive sessions, by only appending the new history. ::" msgstr "" -#: ../../library/readline.rst:338 +#: ../../library/readline.rst:342 msgid "" "The following example extends the :class:`code.InteractiveConsole` class to " "support history save/restore. ::" diff --git a/library/resource.po b/library/resource.po index 295114249c..b151ccb1a3 100644 --- a/library/resource.po +++ b/library/resource.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:09+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -338,7 +338,7 @@ msgstr "" #: ../../library/resource.rst:307 msgid "" "The fields :attr:`ru_utime` and :attr:`ru_stime` of the return value are " -"floating point values representing the amount of time spent executing in " +"floating-point values representing the amount of time spent executing in " "user mode and the amount of time spent executing in system mode, " "respectively. The remaining values are integers. Consult the :manpage:" "`getrusage(2)` man page for detailed information about these values. A brief " diff --git a/library/select.po b/library/select.po index af5a1b1f5e..0c7381ffae 100644 --- a/library/select.po +++ b/library/select.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:09+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -186,7 +186,7 @@ msgstr "" msgid "" "Empty iterables are allowed, but acceptance of three empty iterables is " "platform-dependent. (It is known to work on Unix but not on Windows.) The " -"optional *timeout* argument specifies a time-out as a floating point number " +"optional *timeout* argument specifies a time-out as a floating-point number " "in seconds. When the *timeout* argument is omitted the function blocks " "until at least one file descriptor is ready. A time-out value of zero " "specifies a poll and never blocks." diff --git a/library/sndhdr.po b/library/sndhdr.po index 5bcb12ae95..190dec9d0f 100644 --- a/library/sndhdr.po +++ b/library/sndhdr.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-09 00:15+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2022-06-11 15:40+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -30,7 +30,7 @@ msgstr ":mod:`sndhdr` --- 判定聲音檔案的型別" msgid "**Source code:** :source:`Lib/sndhdr.py`" msgstr "**原始碼：**\\ :source:`Lib/sndhdr.py`" -#: ../../library/sndhdr.rst:20 +#: ../../library/sndhdr.rst:17 msgid "" "The :mod:`sndhdr` module is deprecated (see :pep:`PEP 594 <594#sndhdr>` for " "details and alternatives)." diff --git a/library/socket.po b/library/socket.po index cc24f7ca2c..cf7238e2a0 100644 --- a/library/socket.po +++ b/library/socket.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-22 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:10+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -2128,7 +2128,7 @@ msgstr "" #: ../../library/socket.rst:1919 msgid "" "Set a timeout on blocking socket operations. The *value* argument can be a " -"nonnegative floating point number expressing seconds, or ``None``. If a non-" +"nonnegative floating-point number expressing seconds, or ``None``. If a non-" "zero value is given, subsequent socket operations will raise a :exc:" "`timeout` exception if the timeout period *value* has elapsed before the " "operation has completed. If zero is given, the socket is put in non-" diff --git a/library/spwd.po b/library/spwd.po index a590ec74ea..c5adb4d9a7 100644 --- a/library/spwd.po +++ b/library/spwd.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 00:04+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2022-05-22 02:14+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -23,7 +23,7 @@ msgstr "" msgid ":mod:`spwd` --- The shadow password database" msgstr ":mod:`spwd` --- shadow 密碼資料庫" -#: ../../library/spwd.rst:12 +#: ../../library/spwd.rst:9 msgid "" "The :mod:`spwd` module is deprecated (see :pep:`PEP 594 <594#spwd>` for " "details and alternatives)." diff --git a/library/sqlite3.po b/library/sqlite3.po index c6509c134b..2c2888e6f0 100644 --- a/library/sqlite3.po +++ b/library/sqlite3.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:10+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -630,7 +630,7 @@ msgid "" "version of the SQLite library." msgstr "" -#: ../../library/sqlite3.rst:550 ../../library/sqlite3.rst:560 +#: ../../library/sqlite3.rst:547 ../../library/sqlite3.rst:557 msgid "" "This constant used to reflect the version number of the ``pysqlite`` " "package, a third-party library which used to upstream changes to :mod:`!" diff --git a/library/statistics.po b/library/statistics.po index c25832393f..0534ce3b72 100644 --- a/library/statistics.po +++ b/library/statistics.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2023-07-22 21:15+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -101,7 +101,8 @@ msgid ":func:`fmean`" msgstr ":func:`fmean`" #: ../../library/statistics.rst:76 -msgid "Fast, floating point arithmetic mean, with optional weighting." +#, fuzzy +msgid "Fast, floating-point arithmetic mean, with optional weighting." msgstr "快速浮點數算數平均數，可調整權重。" #: ../../library/statistics.rst:77 diff --git a/library/stdtypes.po b/library/stdtypes.po index 15704cc43d..5e9fda170a 100644 --- a/library/stdtypes.po +++ b/library/stdtypes.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-06 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2022-06-12 15:22+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -368,15 +368,16 @@ msgid "Numeric Types --- :class:`int`, :class:`float`, :class:`complex`" msgstr "數值型別 --- :class:`int`、:class:`float`、:class:`complex`" #: ../../library/stdtypes.rst:216 +#, fuzzy msgid "" -"There are three distinct numeric types: :dfn:`integers`, :dfn:`floating " +"There are three distinct numeric types: :dfn:`integers`, :dfn:`floating-" "point numbers`, and :dfn:`complex numbers`. In addition, Booleans are a " -"subtype of integers. Integers have unlimited precision. Floating point " +"subtype of integers. Integers have unlimited precision. Floating-point " "numbers are usually implemented using :c:expr:`double` in C; information " -"about the precision and internal representation of floating point numbers " +"about the precision and internal representation of floating-point numbers " "for the machine on which your program is running is available in :data:`sys." "float_info`. Complex numbers have a real and imaginary part, which are each " -"a floating point number. To extract these parts from a complex number *z*, " +"a floating-point number. To extract these parts from a complex number *z*, " "use ``z.real`` and ``z.imag``. (The standard library includes the additional " "numeric types :mod:`fractions.Fraction`, for rationals, and :mod:`decimal." "Decimal`, for floating-point numbers with user-definable precision.)" @@ -390,11 +391,12 @@ msgstr "" "而 :mod:`decimal.Decimal` 表示可由使用者制定精度的浮點數。）" #: ../../library/stdtypes.rst:238 +#, fuzzy msgid "" "Numbers are created by numeric literals or as the result of built-in " "functions and operators. Unadorned integer literals (including hex, octal " "and binary numbers) yield integers. Numeric literals containing a decimal " -"point or an exponent sign yield floating point numbers. Appending ``'j'`` " +"point or an exponent sign yield floating-point numbers. Appending ``'j'`` " "or ``'J'`` to a numeric literal yields an imaginary number (a complex number " "with a zero real part) which you can add to an integer or float to get a " "complex number with real and imaginary parts." @@ -2143,7 +2145,7 @@ msgstr "" msgid "" "The `linspace recipe `_ shows how to implement a lazy version of range " -"suitable for floating point applications." +"suitable for floating-point applications." msgstr "" #: ../../library/stdtypes.rst:1511 @@ -3208,7 +3210,7 @@ msgid "``'e'``" msgstr "``'e'``" #: ../../library/stdtypes.rst:2436 ../../library/stdtypes.rst:3655 -msgid "Floating point exponential format (lowercase)." +msgid "Floating-point exponential format (lowercase)." msgstr "" #: ../../library/stdtypes.rst:2438 ../../library/stdtypes.rst:3657 @@ -3216,7 +3218,7 @@ msgid "``'E'``" msgstr "``'E'``" #: ../../library/stdtypes.rst:2438 ../../library/stdtypes.rst:3657 -msgid "Floating point exponential format (uppercase)." +msgid "Floating-point exponential format (uppercase)." msgstr "" #: ../../library/stdtypes.rst:2440 ../../library/stdtypes.rst:3659 @@ -3225,7 +3227,7 @@ msgstr "``'f'``" #: ../../library/stdtypes.rst:2440 ../../library/stdtypes.rst:2442 #: ../../library/stdtypes.rst:3659 ../../library/stdtypes.rst:3661 -msgid "Floating point decimal format." +msgid "Floating-point decimal format." msgstr "" #: ../../library/stdtypes.rst:2442 ../../library/stdtypes.rst:3661 @@ -3238,7 +3240,7 @@ msgstr "``'g'``" #: ../../library/stdtypes.rst:2444 ../../library/stdtypes.rst:3663 msgid "" -"Floating point format. Uses lowercase exponential format if exponent is less " +"Floating-point format. Uses lowercase exponential format if exponent is less " "than -4 or not less than precision, decimal format otherwise." msgstr "" @@ -3248,7 +3250,7 @@ msgstr "``'G'``" #: ../../library/stdtypes.rst:2448 ../../library/stdtypes.rst:3667 msgid "" -"Floating point format. Uses uppercase exponential format if exponent is less " +"Floating-point format. Uses uppercase exponential format if exponent is less " "than -4 or not less than precision, decimal format otherwise." msgstr "" @@ -4371,7 +4373,7 @@ msgstr "" #: ../../library/stdtypes.rst:3889 msgid "" -"Note that, as with floating point numbers, ``v is w`` does *not* imply ``v " +"Note that, as with floating-point numbers, ``v is w`` does *not* imply ``v " "== w`` for memoryview objects." msgstr "" @@ -6537,7 +6539,8 @@ msgid "integer" msgstr "integer（整數）" #: ../../library/stdtypes.rst:208 ../../library/stdtypes.rst:229 -msgid "floating point" +#, fuzzy +msgid "floating-point" msgstr "floating point（浮點數）" #: ../../library/stdtypes.rst:208 ../../library/stdtypes.rst:229 diff --git a/library/string.po b/library/string.po index 79d707cd95..aa813380da 100644 --- a/library/string.po +++ b/library/string.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2024-03-10 15:57+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -568,9 +568,10 @@ msgid "Added the ``','`` option (see also :pep:`378`)." msgstr "新增 ``','`` 選項（請見 :pep:`378`\\ ）。" #: ../../library/string.rst:420 +#, fuzzy msgid "" "The ``'_'`` option signals the use of an underscore for a thousands " -"separator for floating point presentation types and for integer presentation " +"separator for floating-point presentation types and for integer presentation " "type ``'d'``. For integer presentation types ``'b'``, ``'o'``, ``'x'``, and " "``'X'``, underscores will be inserted every 4 digits. For other " "presentation types, specifying this option is an error." @@ -732,9 +733,9 @@ msgstr "" #: ../../library/string.rst:493 msgid "" "In addition to the above presentation types, integers can be formatted with " -"the floating point presentation types listed below (except ``'n'`` and " +"the floating-point presentation types listed below (except ``'n'`` and " "``None``). When doing so, :func:`float` is used to convert the integer to a " -"floating point number before formatting." +"floating-point number before formatting." msgstr "" #: ../../library/string.rst:498 diff --git a/library/sunau.po b/library/sunau.po index a3cd5ba496..1a7f604acb 100644 --- a/library/sunau.po +++ b/library/sunau.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 00:04+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:11+0000\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -28,7 +28,7 @@ msgstr ":mod:`sunau` --- 讀寫 Sun AU 檔案" msgid "**Source code:** :source:`Lib/sunau.py`" msgstr "**原始碼：**\\ :source:`Lib/sunau.py`" -#: ../../library/sunau.rst:15 +#: ../../library/sunau.rst:12 msgid "" "The :mod:`sunau` module is deprecated (see :pep:`PEP 594 <594#sunau>` for " "details)." diff --git a/library/telnetlib.po b/library/telnetlib.po index 493d92cb5f..3b749d1a64 100644 --- a/library/telnetlib.po +++ b/library/telnetlib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-09 00:15+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2022-05-22 02:15+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -27,7 +27,7 @@ msgstr ":mod:`telnetlib` --- Telnet 客戶端" msgid "**Source code:** :source:`Lib/telnetlib.py`" msgstr "**原始碼：**\\ :source:`Lib/telnetlib.py`" -#: ../../library/telnetlib.rst:17 +#: ../../library/telnetlib.rst:14 msgid "" "The :mod:`telnetlib` module is deprecated (see :pep:`PEP 594 " "<594#telnetlib>` for details and alternatives)." diff --git a/library/threading.po b/library/threading.po index 16198340d3..184b52aab8 100644 --- a/library/threading.po +++ b/library/threading.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-23 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:12+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -542,7 +542,7 @@ msgstr "" #: ../../library/threading.rst:411 msgid "" "When the *timeout* argument is present and not ``None``, it should be a " -"floating point number specifying a timeout for the operation in seconds (or " +"floating-point number specifying a timeout for the operation in seconds (or " "fractions thereof). As :meth:`~Thread.join` always returns ``None``, you " "must call :meth:`~Thread.is_alive` after :meth:`~Thread.join` to decide " "whether a timeout happened -- if the thread is still alive, the :meth:" @@ -1023,7 +1023,7 @@ msgstr "" #: ../../library/threading.rst:792 msgid "" "When the *timeout* argument is present and not ``None``, it should be a " -"floating point number specifying a timeout for the operation in seconds (or " +"floating-point number specifying a timeout for the operation in seconds (or " "fractions thereof)." msgstr "" @@ -1298,7 +1298,7 @@ msgstr "" #: ../../library/threading.rst:1019 msgid "" "When the timeout argument is present and not ``None``, it should be a " -"floating point number specifying a timeout for the operation in seconds, or " +"floating-point number specifying a timeout for the operation in seconds, or " "fractions thereof." msgstr "" diff --git a/library/time.po b/library/time.po index 62e9fb733d..37188c7ac1 100644 --- a/library/time.po +++ b/library/time.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2024-07-09 08:33+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -117,9 +117,10 @@ msgstr "" "度。例如，在大多數 Unix 系統上，時鐘每秒只「跳」50 次或 100 次。" #: ../../library/time.rst:71 +#, fuzzy msgid "" "On the other hand, the precision of :func:`.time` and :func:`sleep` is " -"better than their Unix equivalents: times are expressed as floating point " +"better than their Unix equivalents: times are expressed as floating-point " "numbers, :func:`.time` returns the most accurate time available (using Unix :" "c:func:`!gettimeofday` where available), and :func:`sleep` will accept a " "time with a nonzero fraction (Unix :c:func:`!select` is used to implement " @@ -445,11 +446,12 @@ msgstr "" "制在 1970 年到 2038 年之間。" #: ../../library/time.rst:273 +#, fuzzy msgid "" "This is the inverse function of :func:`localtime`. Its argument is the :" "class:`struct_time` or full 9-tuple (since the dst flag is needed; use " "``-1`` as the dst flag if it is unknown) which expresses the time in *local* " -"time, not UTC. It returns a floating point number, for compatibility with :" +"time, not UTC. It returns a floating-point number, for compatibility with :" "func:`.time`. If the input value cannot be represented as a valid time, " "either :exc:`OverflowError` or :exc:`ValueError` will be raised (which " "depends on whether the invalid value is caught by Python or the underlying C " @@ -534,7 +536,7 @@ msgstr "" #: ../../library/time.rst:360 msgid "" "Suspend execution of the calling thread for the given number of seconds. The " -"argument may be a floating point number to indicate a more precise sleep " +"argument may be a floating-point number to indicate a more precise sleep " "time." msgstr "" @@ -1064,7 +1066,7 @@ msgstr "" #: ../../library/time.rst:645 msgid "" -"Return the time in seconds since the epoch_ as a floating point number. The " +"Return the time in seconds since the epoch_ as a floating-point number. The " "handling of `leap seconds`_ is platform dependent. On Windows and most Unix " "systems, the leap seconds are not counted towards the time in seconds since " "the epoch_. This is commonly referred to as `Unix time \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -2079,7 +2079,7 @@ msgstr "" msgid "Using keyword arguments::" msgstr "" -#: ../../library/typing.rst:2211 +#: ../../library/typing.rst:2208 msgid "" "The keyword-argument syntax is deprecated in 3.11 and will be removed in " "3.13. It may also be unsupported by static type checkers." @@ -3103,7 +3103,7 @@ msgstr "" msgid "Aliases to other concrete types" msgstr "" -#: ../../library/typing.rst:3216 +#: ../../library/typing.rst:3213 msgid "" "The ``typing.io`` namespace is deprecated and will be removed. These types " "should be directly imported from ``typing`` instead." @@ -3123,7 +3123,7 @@ msgid "" "``Match[bytes]``." msgstr "" -#: ../../library/typing.rst:3231 +#: ../../library/typing.rst:3228 msgid "" "The ``typing.re`` namespace is deprecated and will be removed. These types " "should be directly imported from ``typing`` instead." @@ -3178,7 +3178,7 @@ msgid "" "class:`memoryview` of byte sequences." msgstr "" -#: ../../library/typing.rst:3278 +#: ../../library/typing.rst:3277 msgid "" "Prefer :class:`collections.abc.Buffer`, or a union like ``bytes | bytearray " "| memoryview``." diff --git a/library/unittest.mock.po b/library/unittest.mock.po index 755f7e9c4e..b3b98b612e 100644 --- a/library/unittest.mock.po +++ b/library/unittest.mock.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-21 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2024-02-19 21:27+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -846,7 +846,18 @@ msgstr "" "由於 mock 屬性的儲存方式，你無法直接將 :class:`PropertyMock` 附加到 mock 物" "件。但是你可以將其附加到 mock 型別的物件： ::" -#: ../../library/unittest.mock.rst:862 +#: ../../library/unittest.mock.rst:861 +msgid "" +"If an :exc:`AttributeError` is raised by :class:`PropertyMock`, it will be " +"interpreted as a missing descriptor and :meth:`~object.__getattr__` will be " +"called on the parent mock::" +msgstr "" + +#: ../../library/unittest.mock.rst:871 +msgid "See :meth:`~object.__getattr__` for details." +msgstr "" + +#: ../../library/unittest.mock.rst:876 msgid "" "An asynchronous version of :class:`MagicMock`. The :class:`AsyncMock` object " "will behave so the object is recognized as an async function, and the result " @@ -855,7 +866,7 @@ msgstr "" ":class:`MagicMock` 的非同步版本。:class:`AsyncMock` 物件的表現將被視為非同步" "函式，並且呼叫的結果是一個可等待物件。" -#: ../../library/unittest.mock.rst:872 +#: ../../library/unittest.mock.rst:886 msgid "" "The result of ``mock()`` is an async function which will have the outcome of " "``side_effect`` or ``return_value`` after it has been awaited:" @@ -863,19 +874,19 @@ msgstr "" "``mock()`` 的結果是一個非同步函式，在它被等待後將具有 ``side_effect`` 或 " "``return_value`` 的結果：" -#: ../../library/unittest.mock.rst:875 +#: ../../library/unittest.mock.rst:889 msgid "" "if ``side_effect`` is a function, the async function will return the result " "of that function," msgstr "如果 ``side_effect`` 是一個函式，非同步函式將回傳該函式的結果，" -#: ../../library/unittest.mock.rst:877 +#: ../../library/unittest.mock.rst:891 msgid "" "if ``side_effect`` is an exception, the async function will raise the " "exception," msgstr "如果 ``side_effect`` 是一個例外，則非同步函式將引發該例外，" -#: ../../library/unittest.mock.rst:879 +#: ../../library/unittest.mock.rst:893 msgid "" "if ``side_effect`` is an iterable, the async function will return the next " "value of the iterable, however, if the sequence of result is exhausted, " @@ -884,7 +895,7 @@ msgstr "" "如果 ``side_effect`` 是一個可疊代物件，非同步函式將回傳可疊代物件的下一個值，" "但如果結果序列耗盡，將立即引發 ``StopAsyncIteration``，" -#: ../../library/unittest.mock.rst:882 +#: ../../library/unittest.mock.rst:896 msgid "" "if ``side_effect`` is not defined, the async function will return the value " "defined by ``return_value``, hence, by default, the async function returns a " @@ -893,7 +904,7 @@ msgstr "" "如果 ``side_effect`` 沒有被定義，非同步函式將回傳由 ``return_value`` 定義的" "值，因此在預設情況下，非同步函式回傳一個新的 :class:`AsyncMock` 物件。" -#: ../../library/unittest.mock.rst:887 +#: ../../library/unittest.mock.rst:901 msgid "" "Setting the *spec* of a :class:`Mock` or :class:`MagicMock` to an async " "function will result in a coroutine object being returned after calling." @@ -901,7 +912,7 @@ msgstr "" "將 :class:`Mock` 或 :class:`MagicMock` 的 *spec* 設定為非同步函式將導致在呼叫" "後回傳一個協程物件。" -#: ../../library/unittest.mock.rst:899 +#: ../../library/unittest.mock.rst:913 msgid "" "Setting the *spec* of a :class:`Mock`, :class:`MagicMock`, or :class:" "`AsyncMock` to a class with asynchronous and synchronous functions will " @@ -916,7 +927,7 @@ msgstr "" "`MagicMock`\\ ）或 :class:`Mock`\\ （如果上代 mock 為 :class:`Mock`\\ ）。所" "有非同步函式將被設定為 :class:`AsyncMock`。" -#: ../../library/unittest.mock.rst:927 +#: ../../library/unittest.mock.rst:941 msgid "" "Assert that the mock was awaited at least once. Note that this is separate " "from the object having been called, the ``await`` keyword must be used:" @@ -924,25 +935,25 @@ msgstr "" "斷言 mock 至少被等待過一次。請注意這與物件是否被呼叫是分開的，``await`` 關鍵" "字必須被使用：" -#: ../../library/unittest.mock.rst:946 +#: ../../library/unittest.mock.rst:960 msgid "Assert that the mock was awaited exactly once." msgstr "斷言 mock 正好被等待了一次。" -#: ../../library/unittest.mock.rst:962 +#: ../../library/unittest.mock.rst:976 msgid "Assert that the last await was with the specified arguments." msgstr "斷言最後一次等待使用了指定的引數。" -#: ../../library/unittest.mock.rst:979 +#: ../../library/unittest.mock.rst:993 msgid "" "Assert that the mock was awaited exactly once and with the specified " "arguments." msgstr "斷言 mock 只被等待了一次並使用了指定的引數。" -#: ../../library/unittest.mock.rst:996 +#: ../../library/unittest.mock.rst:1010 msgid "Assert the mock has ever been awaited with the specified arguments." msgstr "斷言 mock 曾經被使用指定的引數等待過。" -#: ../../library/unittest.mock.rst:1012 +#: ../../library/unittest.mock.rst:1026 msgid "" "Assert the mock has been awaited with the specified calls. The :attr:" "`await_args_list` list is checked for the awaits." @@ -950,7 +961,7 @@ msgstr "" "斷言 mock 已被使用指定的呼叫進行等待。:attr:`await_args_list` 串列將被檢查以" "確認等待的內容。" -#: ../../library/unittest.mock.rst:1015 +#: ../../library/unittest.mock.rst:1029 msgid "" "If *any_order* is false then the awaits must be sequential. There can be " "extra calls before or after the specified awaits." @@ -958,7 +969,7 @@ msgstr "" "如果 *any_order* 為 false，則等待必須按照順序。指定的等待之前或之後可以有額外" "的呼叫。" -#: ../../library/unittest.mock.rst:1019 +#: ../../library/unittest.mock.rst:1033 msgid "" "If *any_order* is true then the awaits can be in any order, but they must " "all appear in :attr:`await_args_list`." @@ -966,11 +977,11 @@ msgstr "" "如果 *any_order* 為 true，則等待可以以任何順序出現，但它們必須全部出現在 :" "attr:`await_args_list` 中。" -#: ../../library/unittest.mock.rst:1039 +#: ../../library/unittest.mock.rst:1053 msgid "Assert that the mock was never awaited." msgstr "斷言 mock 從未被等待。" -#: ../../library/unittest.mock.rst:1046 +#: ../../library/unittest.mock.rst:1060 msgid "" "See :func:`Mock.reset_mock`. Also sets :attr:`await_count` to 0, :attr:" "`await_args` to None, and clears the :attr:`await_args_list`." @@ -978,12 +989,12 @@ msgstr "" "參見 :func:`Mock.reset_mock`。同時將 :attr:`await_count` 設定為 0，:attr:" "`await_args` 設定為 None，並清除 :attr:`await_args_list`。" -#: ../../library/unittest.mock.rst:1051 +#: ../../library/unittest.mock.rst:1065 msgid "" "An integer keeping track of how many times the mock object has been awaited." msgstr "一個整數，用來記錄 mock 物件已被等待的次數。" -#: ../../library/unittest.mock.rst:1066 +#: ../../library/unittest.mock.rst:1080 msgid "" "This is either ``None`` (if the mock hasn’t been awaited), or the arguments " "that the mock was last awaited with. Functions the same as :attr:`Mock." @@ -992,7 +1003,7 @@ msgstr "" "這可能是 ``None``\\ （如果 mock 尚未被等待），或者是上次等待 mock 時使用的引" "數。與 :attr:`Mock.call_args` 的功能相同。" -#: ../../library/unittest.mock.rst:1084 +#: ../../library/unittest.mock.rst:1098 msgid "" "This is a list of all the awaits made to the mock object in sequence (so the " "length of the list is the number of times it has been awaited). Before any " @@ -1001,11 +1012,11 @@ msgstr "" "這是一個按照順序記錄 mock 物件所有等待的串列（因此串列的長度表示該物件已被等" "待的次數）。在進行任何等待之前，此串列為空。" -#: ../../library/unittest.mock.rst:1103 +#: ../../library/unittest.mock.rst:1117 msgid "Calling" msgstr "呼叫" -#: ../../library/unittest.mock.rst:1105 +#: ../../library/unittest.mock.rst:1119 msgid "" "Mock objects are callable. The call will return the value set as the :attr:" "`~Mock.return_value` attribute. The default return value is a new Mock " @@ -1017,7 +1028,7 @@ msgstr "" "的回傳值是一個新的 Mock 物件；它會在第一次存取回傳值時（無論是顯式存取還是透" "過呼叫 Mock）被建立，但是這個回傳值會被儲存，之後每次都回傳同一個值。" -#: ../../library/unittest.mock.rst:1111 +#: ../../library/unittest.mock.rst:1125 msgid "" "Calls made to the object will be recorded in the attributes like :attr:" "`~Mock.call_args` and :attr:`~Mock.call_args_list`." @@ -1025,7 +1036,7 @@ msgstr "" "對物件的呼叫會被記錄在如 :attr:`~Mock.call_args` 和 :attr:`~Mock." "call_args_list` 等屬性中。" -#: ../../library/unittest.mock.rst:1114 +#: ../../library/unittest.mock.rst:1128 msgid "" "If :attr:`~Mock.side_effect` is set then it will be called after the call " "has been recorded, so if :attr:`side_effect` raises an exception the call is " @@ -1034,7 +1045,7 @@ msgstr "" "如果 :attr:`~Mock.side_effect` 被設定，那麼在呼叫被記錄後它才會被呼叫，所以如" "果 :attr:`side_effect` 引發例外，呼叫仍然會被記錄。" -#: ../../library/unittest.mock.rst:1118 +#: ../../library/unittest.mock.rst:1132 msgid "" "The simplest way to make a mock raise an exception when called is to make :" "attr:`~Mock.side_effect` an exception class or instance:" @@ -1042,7 +1053,7 @@ msgstr "" "呼叫 mock 時引發例外的最簡單方式是將 :attr:`~Mock.side_effect` 設定為例外類別" "或實例：" -#: ../../library/unittest.mock.rst:1136 +#: ../../library/unittest.mock.rst:1150 msgid "" "If :attr:`side_effect` is a function then whatever that function returns is " "what calls to the mock return. The :attr:`side_effect` function is called " @@ -1053,7 +1064,7 @@ msgstr "" "傳的值。:attr:`side_effect` 函式會使用與 mock 相同的引數被呼叫。這讓你可以根" "據輸入動態地變更呼叫的回傳值：" -#: ../../library/unittest.mock.rst:1152 +#: ../../library/unittest.mock.rst:1166 msgid "" "If you want the mock to still return the default return value (a new mock), " "or any set return value, then there are two ways of doing this. Either " @@ -1064,7 +1075,7 @@ msgstr "" "值，有兩種方法可以實現。從 :attr:`side_effect` 內部回傳 :attr:`mock." "return_value`，或回傳 :data:`DEFAULT`：" -#: ../../library/unittest.mock.rst:1171 +#: ../../library/unittest.mock.rst:1185 msgid "" "To remove a :attr:`side_effect`, and return to the default behaviour, set " "the :attr:`side_effect` to ``None``:" @@ -1072,7 +1083,7 @@ msgstr "" "要刪除 :attr:`side_effect`，並恢復預設行為，將 :attr:`side_effect` 設為 " "``None``：" -#: ../../library/unittest.mock.rst:1185 +#: ../../library/unittest.mock.rst:1199 msgid "" "The :attr:`side_effect` can also be any iterable object. Repeated calls to " "the mock will return values from the iterable (until the iterable is " @@ -1081,23 +1092,23 @@ msgstr "" ":attr:`side_effect` 也可以是任何可疊代的物件。對 mock 的重複呼叫將從可疊代物" "件中回傳值（直到疊代物件耗盡並引發 :exc:`StopIteration` 為止）：" -#: ../../library/unittest.mock.rst:1201 +#: ../../library/unittest.mock.rst:1215 msgid "" "If any members of the iterable are exceptions they will be raised instead of " "returned::" msgstr "如果可疊代物件中的任何成員是例外，則它們將被引發而不是被回傳： ::" -#: ../../library/unittest.mock.rst:1219 +#: ../../library/unittest.mock.rst:1233 msgid "Deleting Attributes" msgstr "刪除屬性" -#: ../../library/unittest.mock.rst:1221 +#: ../../library/unittest.mock.rst:1235 msgid "" "Mock objects create attributes on demand. This allows them to pretend to be " "objects of any type." msgstr "Mock 物件會在需要時建立屬性。這使得它們可以假裝成任何種類的物件。" -#: ../../library/unittest.mock.rst:1224 +#: ../../library/unittest.mock.rst:1238 msgid "" "You may want a mock object to return ``False`` to a :func:`hasattr` call, or " "raise an :exc:`AttributeError` when an attribute is fetched. You can do this " @@ -1108,7 +1119,7 @@ msgstr "" "提取時引發 :exc:`AttributeError`。你可以通過將物件提供為 mock 的 :attr:" "`spec` 來實現這一點，但這並不總是那麼好用。" -#: ../../library/unittest.mock.rst:1228 +#: ../../library/unittest.mock.rst:1242 msgid "" "You \"block\" attributes by deleting them. Once deleted, accessing an " "attribute will raise an :exc:`AttributeError`." @@ -1116,11 +1127,11 @@ msgstr "" "你可以通過刪除屬性來「阻擋」它們。一旦刪除，再次存取該屬性將會引發 :exc:" "`AttributeError`。" -#: ../../library/unittest.mock.rst:1245 +#: ../../library/unittest.mock.rst:1259 msgid "Mock names and the name attribute" msgstr "Mock 名稱與名稱屬性" -#: ../../library/unittest.mock.rst:1247 +#: ../../library/unittest.mock.rst:1261 msgid "" "Since \"name\" is an argument to the :class:`Mock` constructor, if you want " "your mock object to have a \"name\" attribute you can't just pass it in at " @@ -1131,17 +1142,17 @@ msgstr "" "擁有 \"name\" 屬性，你不能在建立時直接傳遞它。有兩種替代方法。其中一個選擇是" "使用 :meth:`~Mock.configure_mock`： ::" -#: ../../library/unittest.mock.rst:1257 +#: ../../library/unittest.mock.rst:1271 msgid "" "A simpler option is to simply set the \"name\" attribute after mock " "creation::" msgstr "更簡單的方法是在 mock 建立後直接設定 \"name\" 屬性： ::" -#: ../../library/unittest.mock.rst:1264 +#: ../../library/unittest.mock.rst:1278 msgid "Attaching Mocks as Attributes" msgstr "如同屬性一般附加 mock" -#: ../../library/unittest.mock.rst:1266 +#: ../../library/unittest.mock.rst:1280 msgid "" "When you attach a mock as an attribute of another mock (or as the return " "value) it becomes a \"child\" of that mock. Calls to the child are recorded " @@ -1157,7 +1168,7 @@ msgstr "" "mock 附加到記錄所有對子代的呼叫的上代並允許你對 mock 間的呼叫順序進行斷言非常" "有用：" -#: ../../library/unittest.mock.rst:1284 +#: ../../library/unittest.mock.rst:1298 msgid "" "The exception to this is if the mock has a name. This allows you to prevent " "the \"parenting\" if for some reason you don't want it to happen." @@ -1165,7 +1176,7 @@ msgstr "" "如果 mock 有 name 引數，則上述規則會有例外。這使你可以防止「親屬關係 " "(parenting)」的建立，假設因為某些原因你不希望這種狀況發生。" -#: ../../library/unittest.mock.rst:1295 +#: ../../library/unittest.mock.rst:1309 msgid "" "Mocks created for you by :func:`patch` are automatically given names. To " "attach mocks that have names to a parent you use the :meth:`~Mock." @@ -1174,7 +1185,7 @@ msgstr "" "由 :func:`patch` 為你建立的 mock 會自動被賦予名稱。若要將具有名稱的 mock 附加" "到上代，你可以使用 :meth:`~Mock.attach_mock` 方法： ::" -#: ../../library/unittest.mock.rst:1313 +#: ../../library/unittest.mock.rst:1327 msgid "" "The only exceptions are magic methods and attributes (those that have " "leading and trailing double underscores). Mock doesn't create these but " @@ -1188,11 +1199,11 @@ msgstr "" "魔術方法卻獲得一個新的 Mock 物件時，會讓直譯器\\ *非常*\\ 困惑。如果你需要魔" "術方法的支援，請參閱\\ :ref:`魔術方法 `。" -#: ../../library/unittest.mock.rst:1322 +#: ../../library/unittest.mock.rst:1336 msgid "The patchers" msgstr "Patchers" -#: ../../library/unittest.mock.rst:1324 +#: ../../library/unittest.mock.rst:1338 msgid "" "The patch decorators are used for patching objects only within the scope of " "the function they decorate. They automatically handle the unpatching for " @@ -1203,17 +1214,17 @@ msgstr "" "patch 的中止，即使有異常被引發也是如此。所有這些函式也可以在 with 陳述式中使" "用，或者作為類別裝飾器使用。" -#: ../../library/unittest.mock.rst:1331 +#: ../../library/unittest.mock.rst:1345 msgid "patch" msgstr "patch" -#: ../../library/unittest.mock.rst:1335 +#: ../../library/unittest.mock.rst:1349 msgid "" "The key is to do the patching in the right namespace. See the section `where " "to patch`_." msgstr "關鍵是要在正確的命名空間進行 patch。請參閱 `where to patch`_ 一節。" -#: ../../library/unittest.mock.rst:1339 +#: ../../library/unittest.mock.rst:1353 msgid "" ":func:`patch` acts as a function decorator, class decorator or a context " "manager. Inside the body of the function or with statement, the *target* is " @@ -1224,7 +1235,7 @@ msgstr "" "內部，*目標*\\ 會被 patch 成一個\\ *新的*\\ 物件。當函式或 with 陳述式結束" "時，patch 就會被解除。" -#: ../../library/unittest.mock.rst:1344 +#: ../../library/unittest.mock.rst:1358 msgid "" "If *new* is omitted, then the target is replaced with an :class:`AsyncMock` " "if the patched object is an async function or a :class:`MagicMock` " @@ -1238,7 +1249,7 @@ msgstr "" "用且省略了 *new*，則所建立的 mock 會作為額外的引數傳遞給被裝飾的函式。如果 :" "func:`patch` 作為情境管理器使用，則所建立的 mock 將由情境管理器回傳。" -#: ../../library/unittest.mock.rst:1352 +#: ../../library/unittest.mock.rst:1366 msgid "" "*target* should be a string in the form ``'package.module.ClassName'``. The " "*target* is imported and the specified object replaced with the *new* " @@ -1251,7 +1262,7 @@ msgstr "" "`patch` 的環境中引入。target 在執行被裝飾的函式時被引入，而不是在裝飾器作用" "時 (decoration time)。" -#: ../../library/unittest.mock.rst:1358 +#: ../../library/unittest.mock.rst:1372 msgid "" "The *spec* and *spec_set* keyword arguments are passed to the :class:" "`MagicMock` if patch is creating one for you." @@ -1259,7 +1270,7 @@ msgstr "" "*spec* 和 *spec_set* 關鍵字引數會傳遞給 :class:`MagicMock`，如果 patch 正在為" "你建立一個。" -#: ../../library/unittest.mock.rst:1361 +#: ../../library/unittest.mock.rst:1375 msgid "" "In addition you can pass ``spec=True`` or ``spec_set=True``, which causes " "patch to pass in the object being mocked as the spec/spec_set object." @@ -1267,7 +1278,7 @@ msgstr "" "此外，你還可以傳遞 ``spec=True`` 或 ``spec_set=True``，這將導致 patch 將被 " "mock 的物件作為 spec/spec_set 物件傳遞。" -#: ../../library/unittest.mock.rst:1364 +#: ../../library/unittest.mock.rst:1378 msgid "" "*new_callable* allows you to specify a different class, or callable object, " "that will be called to create the *new* object. By default :class:" @@ -1277,7 +1288,7 @@ msgstr "" "*new* 物件。預設情況下，對於非同步函式使用 :class:`AsyncMock`，而對於其他情況" "則使用 :class:`MagicMock`。" -#: ../../library/unittest.mock.rst:1368 +#: ../../library/unittest.mock.rst:1382 msgid "" "A more powerful form of *spec* is *autospec*. If you set ``autospec=True`` " "then the mock will be created with a spec from the object being replaced. " @@ -1295,7 +1306,7 @@ msgstr "" "mock，它們的回傳值（即 'instance'）將具有與類別相同的規格。請參閱 :func:" "`create_autospec` 函式和 :ref:`auto-speccing`。" -#: ../../library/unittest.mock.rst:1378 +#: ../../library/unittest.mock.rst:1392 msgid "" "Instead of ``autospec=True`` you can pass ``autospec=some_object`` to use an " "arbitrary object as the spec instead of the one being replaced." @@ -1303,7 +1314,7 @@ msgstr "" "你可以用 ``autospec=some_object`` 替代 ``autospec=True``，以使用任意物件作為" "規格，而不是被替換的物件。" -#: ../../library/unittest.mock.rst:1381 +#: ../../library/unittest.mock.rst:1395 msgid "" "By default :func:`patch` will fail to replace attributes that don't exist. " "If you pass in ``create=True``, and the attribute doesn't exist, patch will " @@ -1319,7 +1330,7 @@ msgstr "" "行環境建立的屬性的測試時非常有用。此功能預設為關閉，因為這可能會相當危險。開" "啟這個功能後，你可以對於實際上不存在的 API 撰寫會通過的測試！" -#: ../../library/unittest.mock.rst:1391 +#: ../../library/unittest.mock.rst:1405 msgid "" "If you are patching builtins in a module then you don't need to pass " "``create=True``, it will be added by default." @@ -1327,7 +1338,7 @@ msgstr "" "如果你正在 patch 模組中的內建函式，那麼你不需要傳遞 ``create=True``，它預設會" "被加入。" -#: ../../library/unittest.mock.rst:1395 +#: ../../library/unittest.mock.rst:1409 msgid "" "Patch can be used as a :class:`TestCase` class decorator. It works by " "decorating each test method in the class. This reduces the boilerplate code " @@ -1343,7 +1354,7 @@ msgstr "" "是 ``'test'``，這與 :mod:`unittest` 尋找測試的方式相匹配。你可以通過設定 " "``patch.TEST_PREFIX`` 來指定別的前綴。" -#: ../../library/unittest.mock.rst:1402 +#: ../../library/unittest.mock.rst:1416 msgid "" "Patch can be used as a context manager, with the with statement. Here the " "patching applies to the indented block after the with statement. If you use " @@ -1354,7 +1365,7 @@ msgstr "" "的縮排區塊。如果你使用 \"as\"，則被 patch 的物件將被綁定到 \"as\" 後面的名" "稱；如果 :func:`patch` 正在為你建立一個 mock 物件，這會非常有用。" -#: ../../library/unittest.mock.rst:1407 +#: ../../library/unittest.mock.rst:1421 msgid "" ":func:`patch` takes arbitrary keyword arguments. These will be passed to :" "class:`AsyncMock` if the patched object is asynchronous, to :class:" @@ -1364,7 +1375,7 @@ msgstr "" "傳遞給 :class:`AsyncMock`，如果是同步的則會傳遞給 :class:`MagicMock`，或如果" "指定了 *new_callable*，則傳遞給它。" -#: ../../library/unittest.mock.rst:1411 +#: ../../library/unittest.mock.rst:1425 msgid "" "``patch.dict(...)``, ``patch.multiple(...)`` and ``patch.object(...)`` are " "available for alternate use-cases." @@ -1372,14 +1383,14 @@ msgstr "" "``patch.dict(...)``、``patch.multiple(...)`` 和 ``patch.object(...)`` 可用於" "其餘的使用情境。" -#: ../../library/unittest.mock.rst:1414 +#: ../../library/unittest.mock.rst:1428 msgid "" ":func:`patch` as function decorator, creating the mock for you and passing " "it into the decorated function::" msgstr "" ":func:`patch` 作為函式裝飾器，為你建立 mock 並將其傳遞給被裝飾的函式： ::" -#: ../../library/unittest.mock.rst:1424 +#: ../../library/unittest.mock.rst:1438 msgid "" "Patching a class replaces the class with a :class:`MagicMock` *instance*. If " "the class is instantiated in the code under test then it will be the :attr:" @@ -1389,7 +1400,7 @@ msgstr "" "測試的程式碼中實例化，那麼它將是會被使用的 mock 的 :attr:`~Mock." "return_value`。" -#: ../../library/unittest.mock.rst:1428 +#: ../../library/unittest.mock.rst:1442 msgid "" "If the class is instantiated multiple times you could use :attr:`~Mock." "side_effect` to return a new mock each time. Alternatively you can set the " @@ -1398,7 +1409,7 @@ msgstr "" "如果該類別被實例化多次，你可以使用 :attr:`~Mock.side_effect` 來每次回傳一個新" "的 mock。 或者你可以將 *return_value* 設定成你想要的任何值。" -#: ../../library/unittest.mock.rst:1432 +#: ../../library/unittest.mock.rst:1446 msgid "" "To configure return values on methods of *instances* on the patched class " "you must do this on the :attr:`return_value`. For example::" @@ -1406,7 +1417,7 @@ msgstr "" "若要配置被 patch 的類別的\\ *實例*\\ 方法的回傳值，你必須在 :attr:" "`return_value` 上進行配置。 例如： ::" -#: ../../library/unittest.mock.rst:1446 +#: ../../library/unittest.mock.rst:1460 msgid "" "If you use *spec* or *spec_set* and :func:`patch` is replacing a *class*, " "then the return value of the created mock will have the same spec. ::" @@ -1414,7 +1425,7 @@ msgstr "" "如果你使用 *spec* 或 *spec_set* 且 :func:`patch` 正在取代一個\\ *類別*，那麼" "被建立的 mock 的回傳值將具有相同的規格。： ::" -#: ../../library/unittest.mock.rst:1456 +#: ../../library/unittest.mock.rst:1470 msgid "" "The *new_callable* argument is useful where you want to use an alternative " "class to the default :class:`MagicMock` for the created mock. For example, " @@ -1424,13 +1435,13 @@ msgstr "" "*new_callable* 引數非常有用。例如，如果你想要一個 :class:`NonCallableMock` 被" "使用： ::" -#: ../../library/unittest.mock.rst:1469 +#: ../../library/unittest.mock.rst:1483 msgid "" "Another use case might be to replace an object with an :class:`io.StringIO` " "instance::" msgstr "另一個用法是用一個 :class:`io.StringIO` 實例替換一個物件： ::" -#: ../../library/unittest.mock.rst:1482 +#: ../../library/unittest.mock.rst:1496 msgid "" "When :func:`patch` is creating a mock for you, it is common that the first " "thing you need to do is to configure the mock. Some of that configuration " @@ -1441,7 +1452,7 @@ msgstr "" "一些配置可以在對 patch 的呼叫中完成。你傳遞到呼叫中的任何關鍵字都將用於在被建" "立的 mock 上設定屬性： ::" -#: ../../library/unittest.mock.rst:1494 +#: ../../library/unittest.mock.rst:1508 msgid "" "As well as attributes on the created mock attributes, like the :attr:`~Mock." "return_value` and :attr:`~Mock.side_effect`, of child mocks can also be " @@ -1454,7 +1465,7 @@ msgstr "" "數傳入，但是以它們作為鍵的字典仍然可以使用 ``**`` 擴充為一個 :func:`patch` 呼" "叫： ::" -#: ../../library/unittest.mock.rst:1510 +#: ../../library/unittest.mock.rst:1524 msgid "" "By default, attempting to patch a function in a module (or a method or an " "attribute in a class) that does not exist will fail with :exc:" @@ -1463,7 +1474,7 @@ msgstr "" "預設情況下，嘗試 patch 模組中不存在的函式（或類別中的方法或屬性）將會失敗，並" "引發 :exc:`AttributeError`： ::" -#: ../../library/unittest.mock.rst:1522 +#: ../../library/unittest.mock.rst:1536 msgid "" "but adding ``create=True`` in the call to :func:`patch` will make the " "previous example work as expected::" @@ -1471,18 +1482,18 @@ msgstr "" "但是在對 :func:`patch` 的呼叫中增加 ``create=True`` 將使前面的範例按照預期運" "作： ::" -#: ../../library/unittest.mock.rst:1533 +#: ../../library/unittest.mock.rst:1547 msgid "" ":func:`patch` now returns an :class:`AsyncMock` if the target is an async " "function." msgstr "" "如果目標是一個非同步函式，:func:`patch` 現在會回傳一個 :class:`AsyncMock`。" -#: ../../library/unittest.mock.rst:1537 +#: ../../library/unittest.mock.rst:1551 msgid "patch.object" msgstr "patch.object" -#: ../../library/unittest.mock.rst:1541 +#: ../../library/unittest.mock.rst:1555 msgid "" "patch the named member (*attribute*) on an object (*target*) with a mock " "object." @@ -1490,7 +1501,7 @@ msgstr "" "使用一個 mock 物件 patch 一個物件（\\ *目標*\\ ）上的命名成員（\\ *屬性" "*\\ ）。" -#: ../../library/unittest.mock.rst:1544 +#: ../../library/unittest.mock.rst:1558 msgid "" ":func:`patch.object` can be used as a decorator, class decorator or a " "context manager. Arguments *new*, *spec*, *create*, *spec_set*, *autospec* " @@ -1503,7 +1514,7 @@ msgstr "" "`patch` 中的引數具有相同的意義。與 :func:`patch` 一樣，:func:`patch.object` " "接受任意關鍵字引數來配置它所建立的 mock 物件。" -#: ../../library/unittest.mock.rst:1550 +#: ../../library/unittest.mock.rst:1564 msgid "" "When used as a class decorator :func:`patch.object` honours ``patch." "TEST_PREFIX`` for choosing which methods to wrap." @@ -1511,7 +1522,7 @@ msgstr "" "當作為類別裝飾器使用時，:func:`patch.object` 會遵循 ``patch.TEST_PREFIX`` 來" "選擇要包裝的方法。" -#: ../../library/unittest.mock.rst:1553 +#: ../../library/unittest.mock.rst:1567 msgid "" "You can either call :func:`patch.object` with three arguments or two " "arguments. The three argument form takes the object to be patched, the " @@ -1520,7 +1531,7 @@ msgstr "" "你可以使用三個引數或兩個引數來呼叫 :func:`patch.object`。三個引數的形式接受要" "被 patch 的物件、屬性名稱和要替換掉屬性的物件。" -#: ../../library/unittest.mock.rst:1557 +#: ../../library/unittest.mock.rst:1571 msgid "" "When calling with the two argument form you omit the replacement object, and " "a mock is created for you and passed in as an extra argument to the " @@ -1529,7 +1540,7 @@ msgstr "" "當使用兩個引數的形式呼叫時，你會省略要替換的物件，一個 mock 會為你建立並將其" "作為額外的引數傳遞給被裝飾的函式：" -#: ../../library/unittest.mock.rst:1568 +#: ../../library/unittest.mock.rst:1582 msgid "" "*spec*, *create* and the other arguments to :func:`patch.object` have the " "same meaning as they do for :func:`patch`." @@ -1537,17 +1548,17 @@ msgstr "" "*spec*、*create* 和 :func:`patch.object` 的其他引數與在 :func:`patch` 中的引" "數具有相同的意義。" -#: ../../library/unittest.mock.rst:1573 +#: ../../library/unittest.mock.rst:1587 msgid "patch.dict" msgstr "patch.dict" -#: ../../library/unittest.mock.rst:1577 +#: ../../library/unittest.mock.rst:1591 msgid "" "Patch a dictionary, or dictionary like object, and restore the dictionary to " "its original state after the test." msgstr "Patch 字典或類字典的物件，並在測試後將字典回復到其原本的狀態。" -#: ../../library/unittest.mock.rst:1580 +#: ../../library/unittest.mock.rst:1594 msgid "" "*in_dict* can be a dictionary or a mapping like container. If it is a " "mapping then it must at least support getting, setting and deleting items " @@ -1556,13 +1567,13 @@ msgstr "" "*in_dict* 可以是一個字典或一個類對映的容器。如果它是一個對映，那麼它至少必須" "支援獲取、設定、刪除項目以及對鍵的疊代。" -#: ../../library/unittest.mock.rst:1584 +#: ../../library/unittest.mock.rst:1598 msgid "" "*in_dict* can also be a string specifying the name of the dictionary, which " "will then be fetched by importing it." msgstr "*in_dict* 也可以是指定字典名稱的字串，然後透過 import 來取得該字典。" -#: ../../library/unittest.mock.rst:1587 +#: ../../library/unittest.mock.rst:1601 msgid "" "*values* can be a dictionary of values to set in the dictionary. *values* " "can also be an iterable of ``(key, value)`` pairs." @@ -1570,31 +1581,31 @@ msgstr "" "*values* 可以是要設定的值的字典。*values* 也可以是 ``(key, value)`` 對 " "(pairs) 的可疊代物件。" -#: ../../library/unittest.mock.rst:1590 +#: ../../library/unittest.mock.rst:1604 msgid "" "If *clear* is true then the dictionary will be cleared before the new values " "are set." msgstr "如果 *clear* 為 true，則在設定新值之前字典將被清除。" -#: ../../library/unittest.mock.rst:1593 +#: ../../library/unittest.mock.rst:1607 msgid "" ":func:`patch.dict` can also be called with arbitrary keyword arguments to " "set values in the dictionary." msgstr "也可以使用任意關鍵字引數呼叫 :func:`patch.dict` 以在字典中設定值。" -#: ../../library/unittest.mock.rst:1598 +#: ../../library/unittest.mock.rst:1612 msgid "" ":func:`patch.dict` now returns the patched dictionary when used as a context " "manager." msgstr ":func:`patch.dict` 現在在做為情境管理器使用時回傳被 patch 的字典。" -#: ../../library/unittest.mock.rst:1601 +#: ../../library/unittest.mock.rst:1615 msgid "" ":func:`patch.dict` can be used as a context manager, decorator or class " "decorator:" msgstr ":func:`patch.dict` 可以做為情境管理器、裝飾器或類別裝飾器使用：" -#: ../../library/unittest.mock.rst:1612 +#: ../../library/unittest.mock.rst:1626 msgid "" "When used as a class decorator :func:`patch.dict` honours ``patch." "TEST_PREFIX`` (default to ``'test'``) for choosing which methods to wrap:" @@ -1602,7 +1613,7 @@ msgstr "" "當作為類別裝飾器使用時，:func:`patch.dict` 會遵循 ``patch.TEST_PREFIX``\\ " "（預設為 ``'test'``\\ ）來選擇要包裝的方法：" -#: ../../library/unittest.mock.rst:1623 +#: ../../library/unittest.mock.rst:1637 msgid "" "If you want to use a different prefix for your test, you can inform the " "patchers of the different prefix by setting ``patch.TEST_PREFIX``. For more " @@ -1612,7 +1623,7 @@ msgstr "" "patcher 使用不同的前綴。請參閱 :ref:`test-prefix` 以得知如何修改前綴的更多內" "容。" -#: ../../library/unittest.mock.rst:1627 +#: ../../library/unittest.mock.rst:1641 msgid "" ":func:`patch.dict` can be used to add members to a dictionary, or simply let " "a test change a dictionary, and ensure the dictionary is restored when the " @@ -1621,13 +1632,13 @@ msgstr "" ":func:`patch.dict` 可用於在字典中新增成員，或單純地讓測試更改字典，並確保在測" "試結束時將字典回復原狀。" -#: ../../library/unittest.mock.rst:1648 +#: ../../library/unittest.mock.rst:1662 msgid "" "Keywords can be used in the :func:`patch.dict` call to set values in the " "dictionary:" msgstr "可以在 :func:`patch.dict` 呼叫中使用關鍵字來設定字典中的值：" -#: ../../library/unittest.mock.rst:1658 +#: ../../library/unittest.mock.rst:1672 msgid "" ":func:`patch.dict` can be used with dictionary like objects that aren't " "actually dictionaries. At the very minimum they must support item getting, " @@ -1642,11 +1653,11 @@ msgstr "" "__delitem__` 以及 :meth:`~container.__iter__` 或 :meth:`~object." "__contains__`。" -#: ../../library/unittest.mock.rst:1688 +#: ../../library/unittest.mock.rst:1702 msgid "patch.multiple" msgstr "patch.multiple" -#: ../../library/unittest.mock.rst:1692 +#: ../../library/unittest.mock.rst:1706 msgid "" "Perform multiple patches in a single call. It takes the object to be patched " "(either as an object or a string to fetch the object by importing) and " @@ -1655,7 +1666,7 @@ msgstr "" "在一次呼叫中執行多個 patch。它接受被 patch 的物件（作為物件或透過 import 取得" "物件的字串）和 patch 的關鍵字引數： ::" -#: ../../library/unittest.mock.rst:1699 +#: ../../library/unittest.mock.rst:1713 msgid "" "Use :data:`DEFAULT` as the value if you want :func:`patch.multiple` to " "create mocks for you. In this case the created mocks are passed into a " @@ -1666,7 +1677,7 @@ msgstr "" "值。在這種情況下，被建立的 mock 會透過關鍵字傳遞到被裝飾的函式中，並且當 :" "func:`patch.multiple` 作為情境管理器時會回傳字典。" -#: ../../library/unittest.mock.rst:1704 +#: ../../library/unittest.mock.rst:1718 msgid "" ":func:`patch.multiple` can be used as a decorator, class decorator or a " "context manager. The arguments *spec*, *spec_set*, *create*, *autospec* and " @@ -1678,7 +1689,7 @@ msgstr "" "`patch` 中的引數具有相同的意義。這些引數將應用於由 :func:`patch.multiple` 完" "成的\\ *所有* patch。" -#: ../../library/unittest.mock.rst:1709 +#: ../../library/unittest.mock.rst:1723 msgid "" "When used as a class decorator :func:`patch.multiple` honours ``patch." "TEST_PREFIX`` for choosing which methods to wrap." @@ -1686,7 +1697,7 @@ msgstr "" "當作為類別裝飾器使用時，:func:`patch.multiple` 遵循 ``patch.TEST_PREFIX`` 來" "選擇要包裝的方法。" -#: ../../library/unittest.mock.rst:1712 +#: ../../library/unittest.mock.rst:1726 msgid "" "If you want :func:`patch.multiple` to create mocks for you, then you can " "use :data:`DEFAULT` as the value. If you use :func:`patch.multiple` as a " @@ -1697,7 +1708,7 @@ msgstr "" "`DEFAULT` 作為值。如果你使用 :func:`patch.multiple` 作為裝飾器，那麼被建立的 " "mock 將透過關鍵字傳遞到被裝飾的函式中。： ::" -#: ../../library/unittest.mock.rst:1726 +#: ../../library/unittest.mock.rst:1740 msgid "" ":func:`patch.multiple` can be nested with other ``patch`` decorators, but " "put arguments passed by keyword *after* any of the standard arguments " @@ -1706,7 +1717,7 @@ msgstr "" ":func:`patch.multiple` 可以與其他 ``patch`` 裝飾器巢狀使用，但需要將透過關鍵" "字傳遞的引數放在 :func:`patch` 建立的任何標準引數\\ *之後*： ::" -#: ../../library/unittest.mock.rst:1738 +#: ../../library/unittest.mock.rst:1752 msgid "" "If :func:`patch.multiple` is used as a context manager, the value returned " "by the context manager is a dictionary where created mocks are keyed by " @@ -1715,11 +1726,11 @@ msgstr "" "如果 :func:`patch.multiple` 作為情境管理器使用，則情境管理器回傳的值是一個字" "典，其中被建立的 mock 會按名稱作為其鍵值： ::" -#: ../../library/unittest.mock.rst:1752 +#: ../../library/unittest.mock.rst:1766 msgid "patch methods: start and stop" msgstr "patch 方法：啟動與停止" -#: ../../library/unittest.mock.rst:1754 +#: ../../library/unittest.mock.rst:1768 msgid "" "All the patchers have :meth:`start` and :meth:`stop` methods. These make it " "simpler to do patching in ``setUp`` methods or where you want to do multiple " @@ -1729,7 +1740,7 @@ msgstr "" "法中進行 patch 或在你想要在沒有巢狀使用裝飾器或 with 陳述式的情況下進行多個 " "patch 時變得更簡單。" -#: ../../library/unittest.mock.rst:1758 +#: ../../library/unittest.mock.rst:1772 msgid "" "To use them call :func:`patch`, :func:`patch.object` or :func:`patch.dict` " "as normal and keep a reference to the returned ``patcher`` object. You can " @@ -1740,7 +1751,7 @@ msgstr "" "`patch.dict` ，並保留對回傳的 ``patcher`` 物件的參照。之後你就可以呼叫 :meth:" "`start` 將 patch 準備就緒，並呼叫 :meth:`stop` 來取消 patch。" -#: ../../library/unittest.mock.rst:1762 +#: ../../library/unittest.mock.rst:1776 msgid "" "If you are using :func:`patch` to create a mock for you then it will be " "returned by the call to ``patcher.start``. ::" @@ -1748,7 +1759,7 @@ msgstr "" "如果你使用 :func:`patch` 為你建立 mock，那麼它將透過呼叫 ``patcher.start`` 回" "傳。： ::" -#: ../../library/unittest.mock.rst:1776 +#: ../../library/unittest.mock.rst:1790 msgid "" "A typical use case for this might be for doing multiple patches in the " "``setUp`` method of a :class:`TestCase`::" @@ -1756,7 +1767,7 @@ msgstr "" "一個典型的用法是在一個 :class:`TestCase` 的 ``setUp`` 方法中執行多個 " "patch： ::" -#: ../../library/unittest.mock.rst:1798 +#: ../../library/unittest.mock.rst:1812 msgid "" "If you use this technique you must ensure that the patching is \"undone\" by " "calling ``stop``. This can be fiddlier than you might think, because if an " @@ -1767,38 +1778,38 @@ msgstr "" "你想像的還要複雜一點，因為如果有例外在 ``setUp`` 中被引發，則 ``tearDown`` 就" "不會被呼叫。:meth:`unittest.TestCase.addCleanup` 會讓這稍微簡單一點： ::" -#: ../../library/unittest.mock.rst:1813 +#: ../../library/unittest.mock.rst:1827 msgid "" "As an added bonus you no longer need to keep a reference to the ``patcher`` " "object." msgstr "作為額外的好處，你不再需要保留對 ``patcher`` 物件的參照。" -#: ../../library/unittest.mock.rst:1816 +#: ../../library/unittest.mock.rst:1830 msgid "" "It is also possible to stop all patches which have been started by using :" "func:`patch.stopall`." msgstr "也可以使用 :func:`patch.stopall` 來停止所有已啟動的 patch。" -#: ../../library/unittest.mock.rst:1821 +#: ../../library/unittest.mock.rst:1835 msgid "Stop all active patches. Only stops patches started with ``start``." msgstr "停止所有運作的 patch。只停止以 ``start`` 啟動的 patch。" -#: ../../library/unittest.mock.rst:1827 +#: ../../library/unittest.mock.rst:1841 msgid "patch builtins" msgstr "patch 內建函式" -#: ../../library/unittest.mock.rst:1828 +#: ../../library/unittest.mock.rst:1842 msgid "" "You can patch any builtins within a module. The following example patches " "builtin :func:`ord`::" msgstr "" "你可以 patch 模組內的任何內建函式。以下範例 patch 內建函式 :func:`ord`： ::" -#: ../../library/unittest.mock.rst:1843 +#: ../../library/unittest.mock.rst:1857 msgid "TEST_PREFIX" msgstr "TEST_PREFIX" -#: ../../library/unittest.mock.rst:1845 +#: ../../library/unittest.mock.rst:1859 msgid "" "All of the patchers can be used as class decorators. When used in this way " "they wrap every test method on the class. The patchers recognise methods " @@ -1809,7 +1820,7 @@ msgstr "" "個測試方法。Patcher 將 ``'test'`` 開頭的方法認定為測試方法。這與 :class:" "`unittest.TestLoader` 預設尋找測試方法的方式相同。" -#: ../../library/unittest.mock.rst:1850 +#: ../../library/unittest.mock.rst:1864 msgid "" "It is possible that you want to use a different prefix for your tests. You " "can inform the patchers of the different prefix by setting ``patch." @@ -1818,21 +1829,21 @@ msgstr "" "你可能會想為你的測試使用不同的前綴。你可以透過設定 ``patch.TEST_PREFIX`` 來告" "知 patcher 使用不同的前綴： ::" -#: ../../library/unittest.mock.rst:1873 +#: ../../library/unittest.mock.rst:1887 msgid "Nesting Patch Decorators" msgstr "巢狀使用 Patch 裝飾器" -#: ../../library/unittest.mock.rst:1875 +#: ../../library/unittest.mock.rst:1889 msgid "" "If you want to perform multiple patches then you can simply stack up the " "decorators." msgstr "如果你想執行多個 patch，那麼你可以簡單地堆疊裝飾器。" -#: ../../library/unittest.mock.rst:1878 +#: ../../library/unittest.mock.rst:1892 msgid "You can stack up multiple patch decorators using this pattern:" msgstr "你可以使用這個模式來堆疊多個 patch 裝飾器：" -#: ../../library/unittest.mock.rst:1894 +#: ../../library/unittest.mock.rst:1908 msgid "" "Note that the decorators are applied from the bottom upwards. This is the " "standard way that Python applies decorators. The order of the created mocks " @@ -1841,11 +1852,11 @@ msgstr "" "請注意，裝飾器是從底部向上應用的。這是 Python 應用裝飾器的標準方式。被建立的 " "mock 傳遞到測試函式中的順序與此順序相同。" -#: ../../library/unittest.mock.rst:1902 +#: ../../library/unittest.mock.rst:1916 msgid "Where to patch" msgstr "該 patch 何處" -#: ../../library/unittest.mock.rst:1904 +#: ../../library/unittest.mock.rst:1918 msgid "" ":func:`patch` works by (temporarily) changing the object that a *name* " "points to with another one. There can be many names pointing to any " @@ -1856,7 +1867,7 @@ msgstr "" "有許多 name 指向任何單一物件，因此為了使 patch 起作用，你必須確保你 patch 了" "被測試系統使用的 name。" -#: ../../library/unittest.mock.rst:1909 +#: ../../library/unittest.mock.rst:1923 msgid "" "The basic principle is that you patch where an object is *looked up*, which " "is not necessarily the same place as where it is defined. A couple of " @@ -1865,12 +1876,12 @@ msgstr "" "基本原則是在物件\\ *被查找*\\ 的位置進行 patch，該位置不一定與其被定義的位置" "相同。幾個範例將有助於闡明這一點。" -#: ../../library/unittest.mock.rst:1913 +#: ../../library/unittest.mock.rst:1927 msgid "" "Imagine we have a project that we want to test with the following structure::" msgstr "想像一下，我們想要測試一個專案，其結構如下： ::" -#: ../../library/unittest.mock.rst:1922 +#: ../../library/unittest.mock.rst:1936 msgid "" "Now we want to test ``some_function`` but we want to mock out ``SomeClass`` " "using :func:`patch`. The problem is that when we import module b, which we " @@ -1885,7 +1896,7 @@ msgstr "" "那麼它對我們的測試就不會有任何影響；模組 b 已經有了一個\\ *真實的*\\ " "``SomeClass`` 的參照 ，看起來我們的 patch 並沒有任何效果。" -#: ../../library/unittest.mock.rst:1929 +#: ../../library/unittest.mock.rst:1943 msgid "" "The key is to patch out ``SomeClass`` where it is used (or where it is " "looked up). In this case ``some_function`` will actually look up " @@ -1896,7 +1907,7 @@ msgstr "" "``some_function`` 實際上會在我們 import 它的模組 b 中查找 ``SomeClass``。這裡" "的 patch 應該長得像這樣： ::" -#: ../../library/unittest.mock.rst:1935 +#: ../../library/unittest.mock.rst:1949 msgid "" "However, consider the alternative scenario where instead of ``from a import " "SomeClass`` module b does ``import a`` and ``some_function`` uses ``a." @@ -1909,11 +1920,11 @@ msgstr "" "形式都很常見。在這種情況下，我們想要 patch 的類別正在其模組中被查找，因此我們" "必須 patch ``a.SomeClass``： ::" -#: ../../library/unittest.mock.rst:1944 +#: ../../library/unittest.mock.rst:1958 msgid "Patching Descriptors and Proxy Objects" msgstr "Patch 描述器與代理物件 (Proxy Objects)" -#: ../../library/unittest.mock.rst:1946 +#: ../../library/unittest.mock.rst:1960 msgid "" "Both patch_ and patch.object_ correctly patch and restore descriptors: class " "methods, static methods and properties. You should patch these on the " @@ -1928,15 +1939,15 @@ msgstr "" "web/20200603181648/http://www.voidspace.org.uk/python/weblog/ " "arch_d7_2010_12_04.shtml#e1198>`_。" -#: ../../library/unittest.mock.rst:1954 +#: ../../library/unittest.mock.rst:1968 msgid "MagicMock and magic method support" msgstr "MagicMock 以及魔術方法支援" -#: ../../library/unittest.mock.rst:1959 +#: ../../library/unittest.mock.rst:1973 msgid "Mocking Magic Methods" msgstr "Mock 魔術方法" -#: ../../library/unittest.mock.rst:1961 +#: ../../library/unittest.mock.rst:1975 msgid "" ":class:`Mock` supports mocking the Python protocol methods, also known as :" "term:`\"magic methods\" `. This allows mock objects to replace " @@ -1945,7 +1956,7 @@ msgstr "" ":class:`Mock` 支援 mock Python 協定方法，其也被稱作 :term:`\"魔術方法\" " "`。這允許 mock 物件替換容器或實作 Python 協定的其他物件。" -#: ../../library/unittest.mock.rst:1965 +#: ../../library/unittest.mock.rst:1979 msgid "" "Because magic methods are looked up differently from normal methods [#]_, " "this support has been specially implemented. This means that only specific " @@ -1956,7 +1967,7 @@ msgstr "" "代表著僅有特定的魔術方法被此方式支援。現在已支援清單中已經\\ *幾乎*\\ 包含了" "所有魔術方法。如果你需要 mock 任何魔術方法而其尚未被支援，請讓我們知道。" -#: ../../library/unittest.mock.rst:1970 +#: ../../library/unittest.mock.rst:1984 msgid "" "You mock magic methods by setting the method you are interested in to a " "function or a mock instance. If you are using a function then it *must* take " @@ -1965,13 +1976,13 @@ msgstr "" "你可以透過將你感興趣的方法設定為函式或 mock 實例來 mock 魔術方法。如果你使用" "函式，那麼它\\ *必須*\\ 將 ``self`` 作為第一個引數 [#]_。" -#: ../../library/unittest.mock.rst:1993 +#: ../../library/unittest.mock.rst:2007 msgid "" "One use case for this is for mocking objects used as context managers in a :" "keyword:`with` statement:" msgstr "一個用法是在 :keyword:`with` 陳述式中 mock 作為情境管理器使用的物件：" -#: ../../library/unittest.mock.rst:2005 +#: ../../library/unittest.mock.rst:2019 msgid "" "Calls to magic methods do not appear in :attr:`~Mock.method_calls`, but they " "are recorded in :attr:`~Mock.mock_calls`." @@ -1979,7 +1990,7 @@ msgstr "" "對魔術方法的呼叫並不會出現在 :attr:`~Mock.method_calls` 中，它們會被記錄在 :" "attr:`~Mock.mock_calls` 內。" -#: ../../library/unittest.mock.rst:2010 +#: ../../library/unittest.mock.rst:2024 msgid "" "If you use the *spec* keyword argument to create a mock then attempting to " "set a magic method that isn't in the spec will raise an :exc:" @@ -1988,23 +1999,23 @@ msgstr "" "如果你使用\\ *spec*\\ 關鍵字引數來建立一個 mock，則嘗試設定規格中未包含的魔術" "方法將引發一個 :exc:`AttributeError`。" -#: ../../library/unittest.mock.rst:2013 +#: ../../library/unittest.mock.rst:2027 msgid "The full list of supported magic methods is:" msgstr "已支援的魔術方法的完整列表是：" -#: ../../library/unittest.mock.rst:2015 +#: ../../library/unittest.mock.rst:2029 msgid "``__hash__``, ``__sizeof__``, ``__repr__`` and ``__str__``" msgstr "``__hash__``、``__sizeof__``、 ``__repr__`` 和 ``__str__``" -#: ../../library/unittest.mock.rst:2016 +#: ../../library/unittest.mock.rst:2030 msgid "``__dir__``, ``__format__`` and ``__subclasses__``" msgstr "``__dir__``、 ``__format__`` 和 ``__subclasses__``" -#: ../../library/unittest.mock.rst:2017 +#: ../../library/unittest.mock.rst:2031 msgid "``__round__``, ``__floor__``, ``__trunc__`` and ``__ceil__``" msgstr "``__round__``、``__floor__``、``__trunc__`` 和 ``__ceil__``" -#: ../../library/unittest.mock.rst:2018 +#: ../../library/unittest.mock.rst:2032 msgid "" "Comparisons: ``__lt__``, ``__gt__``, ``__le__``, ``__ge__``, ``__eq__`` and " "``__ne__``" @@ -2012,7 +2023,7 @@ msgstr "" "比較方法：``__lt__``、``__gt__``、``__le__``、``__ge__``、``__eq__`` 和 " "``__ne__``" -#: ../../library/unittest.mock.rst:2020 +#: ../../library/unittest.mock.rst:2034 msgid "" "Container methods: ``__getitem__``, ``__setitem__``, ``__delitem__``, " "``__contains__``, ``__len__``, ``__iter__``, ``__reversed__`` and " @@ -2022,18 +2033,18 @@ msgstr "" "``__contains__``、``__len__``、``__iter__``、``__reversed__`` 和 " "``__missing__``" -#: ../../library/unittest.mock.rst:2023 +#: ../../library/unittest.mock.rst:2037 msgid "" "Context manager: ``__enter__``, ``__exit__``, ``__aenter__`` and " "``__aexit__``" msgstr "" "情境管理器：``__enter__``、``__exit__``、``__aenter__`` 和 ``__aexit__``" -#: ../../library/unittest.mock.rst:2024 +#: ../../library/unittest.mock.rst:2038 msgid "Unary numeric methods: ``__neg__``, ``__pos__`` and ``__invert__``" msgstr "一元數值方法：``__neg__``、``__pos__`` 和 ``__invert__``" -#: ../../library/unittest.mock.rst:2025 +#: ../../library/unittest.mock.rst:2039 msgid "" "The numeric methods (including right hand and in-place variants): " "``__add__``, ``__sub__``, ``__mul__``, ``__matmul__``, ``__truediv__``, " @@ -2045,18 +2056,18 @@ msgstr "" "``__mod__``、``__divmod__``、``__lshift__``、``__rshift__``、``__and__``、" "``__xor__``、``__or__`` 和 ``__pow__``" -#: ../../library/unittest.mock.rst:2029 +#: ../../library/unittest.mock.rst:2043 msgid "" "Numeric conversion methods: ``__complex__``, ``__int__``, ``__float__`` and " "``__index__``" msgstr "" "數值轉換方法：``__complex__``、``__int__``、``__float__`` 和 ``__index__``" -#: ../../library/unittest.mock.rst:2031 +#: ../../library/unittest.mock.rst:2045 msgid "Descriptor methods: ``__get__``, ``__set__`` and ``__delete__``" msgstr "描述器方法：``__get__``、``__set__`` 和 ``__delete__``" -#: ../../library/unittest.mock.rst:2032 +#: ../../library/unittest.mock.rst:2046 msgid "" "Pickling: ``__reduce__``, ``__reduce_ex__``, ``__getinitargs__``, " "``__getnewargs__``, ``__getstate__`` and ``__setstate__``" @@ -2064,19 +2075,19 @@ msgstr "" "Pickling：``__reduce__``、``__reduce_ex__``、``__getinitargs__``、" "``__getnewargs__``、``__getstate__`` 和 ``__setstate__``" -#: ../../library/unittest.mock.rst:2034 +#: ../../library/unittest.mock.rst:2048 msgid "File system path representation: ``__fspath__``" msgstr "檔案系統路徑表示法：``__fspath__``" -#: ../../library/unittest.mock.rst:2035 +#: ../../library/unittest.mock.rst:2049 msgid "Asynchronous iteration methods: ``__aiter__`` and ``__anext__``" msgstr "非同步疊代方法：``__aiter__`` 和 ``__anext__``" -#: ../../library/unittest.mock.rst:2037 +#: ../../library/unittest.mock.rst:2051 msgid "Added support for :func:`os.PathLike.__fspath__`." msgstr "新增對於 :func:`os.PathLike.__fspath__` 的支援。" -#: ../../library/unittest.mock.rst:2040 +#: ../../library/unittest.mock.rst:2054 msgid "" "Added support for ``__aenter__``, ``__aexit__``, ``__aiter__`` and " "``__anext__``." @@ -2084,7 +2095,7 @@ msgstr "" "新增對於 ``__aenter__``、``__aexit__``、``__aiter__`` 和 ``__anext__`` 的支" "援。" -#: ../../library/unittest.mock.rst:2044 +#: ../../library/unittest.mock.rst:2058 msgid "" "The following methods exist but are *not* supported as they are either in " "use by mock, can't be set dynamically, or can cause problems:" @@ -2092,21 +2103,21 @@ msgstr "" "以下方法存在，但「不」被支援，因為它們在被 mock 使用時，會無法動態設定，或可" "能導致問題：" -#: ../../library/unittest.mock.rst:2047 +#: ../../library/unittest.mock.rst:2061 msgid "``__getattr__``, ``__setattr__``, ``__init__`` and ``__new__``" msgstr "``__getattr__``、``__setattr__``、``__init__`` 和 ``__new__``" -#: ../../library/unittest.mock.rst:2048 +#: ../../library/unittest.mock.rst:2062 msgid "" "``__prepare__``, ``__instancecheck__``, ``__subclasscheck__``, ``__del__``" msgstr "" "``__prepare__``、``__instancecheck__``、``__subclasscheck__``、``__del__``" -#: ../../library/unittest.mock.rst:2053 +#: ../../library/unittest.mock.rst:2067 msgid "Magic Mock" msgstr "Magic Mock" -#: ../../library/unittest.mock.rst:2055 +#: ../../library/unittest.mock.rst:2069 msgid "" "There are two ``MagicMock`` variants: :class:`MagicMock` and :class:" "`NonCallableMagicMock`." @@ -2114,7 +2125,7 @@ msgstr "" "``MagicMock`` 有兩個變體：:class:`MagicMock` 和 :class:" "`NonCallableMagicMock`。" -#: ../../library/unittest.mock.rst:2060 +#: ../../library/unittest.mock.rst:2074 msgid "" "``MagicMock`` is a subclass of :class:`Mock` with default implementations of " "most of the :term:`magic methods `. You can use ``MagicMock`` " @@ -2123,11 +2134,11 @@ msgstr "" "``MagicMock`` 是 :class:`Mock` 的子類別，其預設具有大多數\\ :term:`魔術方法 " "`\\ 的實作。你可以使用 ``MagicMock``，而無需自行配置魔術方法。" -#: ../../library/unittest.mock.rst:2064 +#: ../../library/unittest.mock.rst:2078 msgid "The constructor parameters have the same meaning as for :class:`Mock`." msgstr "建構函式參數的意義與 :class:`Mock` 中的參數相同。" -#: ../../library/unittest.mock.rst:2066 +#: ../../library/unittest.mock.rst:2080 msgid "" "If you use the *spec* or *spec_set* arguments then *only* magic methods that " "exist in the spec will be created." @@ -2135,11 +2146,11 @@ msgstr "" "如果你使用 *spec* 或 *spec_set* 引數，那麼\\ *只有*\\ 規格中存在的魔術方法會" "被建立。" -#: ../../library/unittest.mock.rst:2072 +#: ../../library/unittest.mock.rst:2086 msgid "A non-callable version of :class:`MagicMock`." msgstr ":class:`MagicMock` 的不可呼叫版本。" -#: ../../library/unittest.mock.rst:2074 +#: ../../library/unittest.mock.rst:2088 msgid "" "The constructor parameters have the same meaning as for :class:`MagicMock`, " "with the exception of *return_value* and *side_effect* which have no meaning " @@ -2148,7 +2159,7 @@ msgstr "" "建構函式參數的意義與 :class:`MagicMock` 中的參數相同，但 *return_value* 和 " "*side_effect* 除外，它們對不可呼叫的 mock 來說沒有任何意義。" -#: ../../library/unittest.mock.rst:2078 +#: ../../library/unittest.mock.rst:2092 msgid "" "The magic methods are setup with :class:`MagicMock` objects, so you can " "configure them and use them in the usual way:" @@ -2156,7 +2167,7 @@ msgstr "" "魔術方法是使用 :class:`MagicMock` 物件設定的，因此你可以配置它們並以一般的方" "法來使用它們：" -#: ../../library/unittest.mock.rst:2088 +#: ../../library/unittest.mock.rst:2102 msgid "" "By default many of the protocol methods are required to return objects of a " "specific type. These methods are preconfigured with a default return value, " @@ -2168,83 +2179,83 @@ msgstr "" "值，因此如果你對回傳值不感興趣，則無需執行任何操作即可使用它們。如果你想更改" "預設值，你仍然可以手動\\ *設定*\\ 回傳值。" -#: ../../library/unittest.mock.rst:2094 +#: ../../library/unittest.mock.rst:2108 msgid "Methods and their defaults:" msgstr "方法及其預設值：" -#: ../../library/unittest.mock.rst:2096 +#: ../../library/unittest.mock.rst:2110 msgid "``__lt__``: :data:`NotImplemented`" msgstr "``__lt__``：:data:`NotImplemented`" -#: ../../library/unittest.mock.rst:2097 +#: ../../library/unittest.mock.rst:2111 msgid "``__gt__``: :data:`!NotImplemented`" msgstr "``__gt__``：:data:`!NotImplemented`" -#: ../../library/unittest.mock.rst:2098 +#: ../../library/unittest.mock.rst:2112 msgid "``__le__``: :data:`!NotImplemented`" msgstr "``__le__``：:data:`!NotImplemented`" -#: ../../library/unittest.mock.rst:2099 +#: ../../library/unittest.mock.rst:2113 msgid "``__ge__``: :data:`!NotImplemented`" msgstr "``__ge__``：:data:`!NotImplemented`" -#: ../../library/unittest.mock.rst:2100 +#: ../../library/unittest.mock.rst:2114 msgid "``__int__``: ``1``" msgstr "``__int__``：``1``" -#: ../../library/unittest.mock.rst:2101 +#: ../../library/unittest.mock.rst:2115 msgid "``__contains__``: ``False``" msgstr "``__contains__``：``False``" -#: ../../library/unittest.mock.rst:2102 +#: ../../library/unittest.mock.rst:2116 msgid "``__len__``: ``0``" msgstr "``__len__``：``0``" -#: ../../library/unittest.mock.rst:2103 +#: ../../library/unittest.mock.rst:2117 msgid "``__iter__``: ``iter([])``" msgstr "``__iter__``：``iter([])``" -#: ../../library/unittest.mock.rst:2104 +#: ../../library/unittest.mock.rst:2118 msgid "``__exit__``: ``False``" msgstr "``__exit__``：``False``" -#: ../../library/unittest.mock.rst:2105 +#: ../../library/unittest.mock.rst:2119 msgid "``__aexit__``: ``False``" msgstr "``__aexit__``：``False``" -#: ../../library/unittest.mock.rst:2106 +#: ../../library/unittest.mock.rst:2120 msgid "``__complex__``: ``1j``" msgstr "``__complex__``：``1j``" -#: ../../library/unittest.mock.rst:2107 +#: ../../library/unittest.mock.rst:2121 msgid "``__float__``: ``1.0``" msgstr "``__float__``：``1.0``" -#: ../../library/unittest.mock.rst:2108 +#: ../../library/unittest.mock.rst:2122 msgid "``__bool__``: ``True``" msgstr "``__bool__``：``True``" -#: ../../library/unittest.mock.rst:2109 +#: ../../library/unittest.mock.rst:2123 msgid "``__index__``: ``1``" msgstr "``__index__``：``1``" -#: ../../library/unittest.mock.rst:2110 +#: ../../library/unittest.mock.rst:2124 msgid "``__hash__``: default hash for the mock" msgstr "``__hash__``：mock 的預設雜湊" -#: ../../library/unittest.mock.rst:2111 +#: ../../library/unittest.mock.rst:2125 msgid "``__str__``: default str for the mock" msgstr "``__str__``：mock 的預設字串" -#: ../../library/unittest.mock.rst:2112 +#: ../../library/unittest.mock.rst:2126 msgid "``__sizeof__``: default sizeof for the mock" msgstr "``__sizeof__``：mock 的預設 sizeof" -#: ../../library/unittest.mock.rst:2114 +#: ../../library/unittest.mock.rst:2128 msgid "For example:" msgstr "舉例來說：" -#: ../../library/unittest.mock.rst:2126 +#: ../../library/unittest.mock.rst:2140 msgid "" "The two equality methods, :meth:`!__eq__` and :meth:`!__ne__`, are special. " "They do the default equality comparison on identity, using the :attr:`~Mock." @@ -2255,14 +2266,14 @@ msgstr "" "`~Mock.side_effect` 屬性對識別性 (identity) 進行預設的相等比較，除非你變更它" "們的回傳值以回傳其他內容： ::" -#: ../../library/unittest.mock.rst:2140 +#: ../../library/unittest.mock.rst:2154 msgid "" "The return value of :meth:`MagicMock.__iter__` can be any iterable object " "and isn't required to be an iterator:" msgstr "" ":meth:`MagicMock.__iter__` 的回傳值可以是任何可疊代物件，且不需是一個疊代器：" -#: ../../library/unittest.mock.rst:2150 +#: ../../library/unittest.mock.rst:2164 msgid "" "If the return value *is* an iterator, then iterating over it once will " "consume it and subsequent iterations will result in an empty list:" @@ -2270,7 +2281,7 @@ msgstr "" "如果回傳值\\ *是*\\ 一個疊代器，那麼對其進行一次疊代將消耗它，並且後續疊代將" "產生一個空串列：" -#: ../../library/unittest.mock.rst:2159 +#: ../../library/unittest.mock.rst:2173 msgid "" "``MagicMock`` has all of the supported magic methods configured except for " "some of the obscure and obsolete ones. You can still set these up if you " @@ -2279,33 +2290,33 @@ msgstr "" "``MagicMock`` 配置了所有支援的魔術方法，除了一些少見和過時的方法。如果你想" "要，你仍然可以設定這些魔術方法。" -#: ../../library/unittest.mock.rst:2162 +#: ../../library/unittest.mock.rst:2176 msgid "" "Magic methods that are supported but not setup by default in ``MagicMock`` " "are:" msgstr "``MagicMock`` 中支援但預設未設置的魔術方法包含：" -#: ../../library/unittest.mock.rst:2164 +#: ../../library/unittest.mock.rst:2178 msgid "``__subclasses__``" msgstr "``__subclasses__``" -#: ../../library/unittest.mock.rst:2165 +#: ../../library/unittest.mock.rst:2179 msgid "``__dir__``" msgstr "``__dir__``" -#: ../../library/unittest.mock.rst:2166 +#: ../../library/unittest.mock.rst:2180 msgid "``__format__``" msgstr "``__format__``" -#: ../../library/unittest.mock.rst:2167 +#: ../../library/unittest.mock.rst:2181 msgid "``__get__``, ``__set__`` and ``__delete__``" msgstr "``__get__``、``__set__`` 和 ``__delete__``" -#: ../../library/unittest.mock.rst:2168 +#: ../../library/unittest.mock.rst:2182 msgid "``__reversed__`` and ``__missing__``" msgstr "``__reversed__`` 和 ``__missing__``" -#: ../../library/unittest.mock.rst:2169 +#: ../../library/unittest.mock.rst:2183 msgid "" "``__reduce__``, ``__reduce_ex__``, ``__getinitargs__``, ``__getnewargs__``, " "``__getstate__`` and ``__setstate__``" @@ -2313,11 +2324,11 @@ msgstr "" "``__reduce__``、``__reduce_ex__``、``__getinitargs__``、``__getnewargs__``、" "``__getstate__`` 和 ``__setstate__``" -#: ../../library/unittest.mock.rst:2171 +#: ../../library/unittest.mock.rst:2185 msgid "``__getformat__``" msgstr "``__getformat__``" -#: ../../library/unittest.mock.rst:2175 +#: ../../library/unittest.mock.rst:2189 msgid "" "Magic methods *should* be looked up on the class rather than the instance. " "Different versions of Python are inconsistent about applying this rule. The " @@ -2326,27 +2337,27 @@ msgstr "" "魔術方法\\ *應該*\\ 在類別而不是實例上被查找。不同版本的 Python 對於這條規則" "的適用並不一致。支援的協定方法應適用於所有支援的 Python 版本。" -#: ../../library/unittest.mock.rst:2179 +#: ../../library/unittest.mock.rst:2193 msgid "" "The function is basically hooked up to the class, but each ``Mock`` instance " "is kept isolated from the others." msgstr "該函式基本上與類別掛鉤，但每個 ``Mock`` 實例都與其他實例保持隔離。" -#: ../../library/unittest.mock.rst:2184 +#: ../../library/unittest.mock.rst:2198 msgid "Helpers" msgstr "輔助函式" -#: ../../library/unittest.mock.rst:2187 +#: ../../library/unittest.mock.rst:2201 msgid "sentinel" msgstr "sentinel（哨兵）" -#: ../../library/unittest.mock.rst:2191 +#: ../../library/unittest.mock.rst:2205 msgid "" "The ``sentinel`` object provides a convenient way of providing unique " "objects for your tests." msgstr "``哨兵``\\ 物件提供了一種為你的測試提供獨特物件的便利方式。" -#: ../../library/unittest.mock.rst:2194 +#: ../../library/unittest.mock.rst:2208 msgid "" "Attributes are created on demand when you access them by name. Accessing the " "same attribute will always return the same object. The objects returned have " @@ -2355,7 +2366,7 @@ msgstr "" "當你使用名稱存取屬性時，屬性會根據需要被建立。存取相同的屬性將始終回傳相同的" "物件。回傳的物件會具有合適的 repr，讓測試失敗的訊息是可閱讀的。" -#: ../../library/unittest.mock.rst:2198 +#: ../../library/unittest.mock.rst:2212 msgid "" "The ``sentinel`` attributes now preserve their identity when they are :mod:" "`copied ` or :mod:`pickled `." @@ -2363,7 +2374,7 @@ msgstr "" "``哨兵``\\ 屬性現在當被\\ :mod:`複製 `\\ 或\\ :mod:`序列化 `\\ " "時會保留其識別性。" -#: ../../library/unittest.mock.rst:2202 +#: ../../library/unittest.mock.rst:2216 msgid "" "Sometimes when testing you need to test that a specific object is passed as " "an argument to another method, or returned. It can be common to create named " @@ -2374,18 +2385,18 @@ msgstr "" "名的哨兵物件來測試這一點是常見的。:data:`sentinel` 提供了一種此類建立和測試物" "件識別性的便利方式。" -#: ../../library/unittest.mock.rst:2207 +#: ../../library/unittest.mock.rst:2221 msgid "" "In this example we monkey patch ``method`` to return ``sentinel." "some_object``:" msgstr "" "在這個例子中，我們 monkey patch ``method`` 以回傳 ``sentinel.some_object``：" -#: ../../library/unittest.mock.rst:2219 +#: ../../library/unittest.mock.rst:2233 msgid "DEFAULT" msgstr "DEFAULT" -#: ../../library/unittest.mock.rst:2224 +#: ../../library/unittest.mock.rst:2238 msgid "" "The :data:`DEFAULT` object is a pre-created sentinel (actually ``sentinel." "DEFAULT``). It can be used by :attr:`~Mock.side_effect` functions to " @@ -2395,11 +2406,11 @@ msgstr "" "DEFAULT``\\ ）。它可以被 :attr:`~Mock.side_effect` 函式使用來表示正常的回傳值" "應該被使用。" -#: ../../library/unittest.mock.rst:2230 +#: ../../library/unittest.mock.rst:2244 msgid "call" msgstr "call" -#: ../../library/unittest.mock.rst:2234 +#: ../../library/unittest.mock.rst:2248 msgid "" ":func:`call` is a helper object for making simpler assertions, for comparing " "with :attr:`~Mock.call_args`, :attr:`~Mock.call_args_list`, :attr:`~Mock." @@ -2411,7 +2422,7 @@ msgstr "" "簡單的斷言的輔助物件。:func:`call` 也可以與 :meth:`~Mock.assert_has_calls` 一" "起使用。" -#: ../../library/unittest.mock.rst:2247 +#: ../../library/unittest.mock.rst:2261 msgid "" "For a call object that represents multiple calls, :meth:`call_list` returns " "a list of all the intermediate calls as well as the final call." @@ -2419,7 +2430,7 @@ msgstr "" "對於表示多個呼叫的 call 物件，:meth:`call_list` 回傳所有中間呼叫以及最終呼叫" "的串列。" -#: ../../library/unittest.mock.rst:2251 +#: ../../library/unittest.mock.rst:2265 msgid "" "``call_list`` is particularly useful for making assertions on \"chained " "calls\". A chained call is multiple calls on a single line of code. This " @@ -2430,13 +2441,13 @@ msgstr "" "在單行程式碼進行的多次呼叫。這會導致 mock 上的 :attr:`~Mock.mock_calls` 中出" "現多個項目。手動建構呼叫序列會相當單調乏味。" -#: ../../library/unittest.mock.rst:2256 +#: ../../library/unittest.mock.rst:2270 msgid "" ":meth:`~call.call_list` can construct the sequence of calls from the same " "chained call:" msgstr ":meth:`~call.call_list` 可以從同一個鍊接呼叫建構呼叫序列：" -#: ../../library/unittest.mock.rst:2273 +#: ../../library/unittest.mock.rst:2287 msgid "" "A ``call`` object is either a tuple of (positional args, keyword args) or " "(name, positional args, keyword args) depending on how it was constructed. " @@ -2450,7 +2461,7 @@ msgstr "" "趣，但是 :attr:`Mock.call_args`、:attr:`Mock.call_args_list` 和 :attr:`Mock." "mock_calls` 屬性中的 ``call`` 物件可以被內省以取得它們包含的各個引數。" -#: ../../library/unittest.mock.rst:2280 +#: ../../library/unittest.mock.rst:2294 msgid "" "The ``call`` objects in :attr:`Mock.call_args` and :attr:`Mock." "call_args_list` are two-tuples of (positional args, keyword args) whereas " @@ -2462,7 +2473,7 @@ msgstr "" "（位置引數, 關鍵字引數）的二元組，而 :attr:`Mock.mock_calls` 中的 ``call`` 物" "件以及你自己建立的 ``call`` 物件是（名稱, 位置引數, 關鍵字引數）的三元組。" -#: ../../library/unittest.mock.rst:2285 +#: ../../library/unittest.mock.rst:2299 msgid "" "You can use their \"tupleness\" to pull out the individual arguments for " "more complex introspection and assertions. The positional arguments are a " @@ -2472,11 +2483,11 @@ msgstr "" "你可以利用它們作為元組的特性來提取單個引數，以進行更複雜的內省和斷言。位置引" "數是一個元組（如果沒有位置引數則為空元組），關鍵字引數是一個字典：" -#: ../../library/unittest.mock.rst:2318 +#: ../../library/unittest.mock.rst:2332 msgid "create_autospec" msgstr "create_autospec" -#: ../../library/unittest.mock.rst:2322 +#: ../../library/unittest.mock.rst:2336 msgid "" "Create a mock object using another object as a spec. Attributes on the mock " "will use the corresponding attribute on the *spec* object as their spec." @@ -2484,13 +2495,13 @@ msgstr "" "使用另一個物件作為規格建立一個 mock 物件。Mock 上的屬性將使用 *spec* 物件上的" "對應屬性作為其規格。" -#: ../../library/unittest.mock.rst:2326 +#: ../../library/unittest.mock.rst:2340 msgid "" "Functions or methods being mocked will have their arguments checked to " "ensure that they are called with the correct signature." msgstr "被 mock 的函式或方法將檢查其引數，以確保他們被使用正確的簽名來呼叫。" -#: ../../library/unittest.mock.rst:2329 +#: ../../library/unittest.mock.rst:2343 msgid "" "If *spec_set* is ``True`` then attempting to set attributes that don't exist " "on the spec object will raise an :exc:`AttributeError`." @@ -2498,7 +2509,7 @@ msgstr "" "如果 *spec_set* 為 ``True``，則嘗試設定規格物件上不存在的屬性將引發 :exc:" "`AttributeError`。" -#: ../../library/unittest.mock.rst:2332 +#: ../../library/unittest.mock.rst:2346 msgid "" "If a class is used as a spec then the return value of the mock (the instance " "of the class) will have the same spec. You can use a class as the spec for " @@ -2509,7 +2520,7 @@ msgstr "" "可以透過傳遞 ``instance=True`` 來使用一個類別作為一個實例物件的規格。只有當 " "mock 的實例是可呼叫物件時，回傳的 mock 才會是可呼叫物件。" -#: ../../library/unittest.mock.rst:2337 +#: ../../library/unittest.mock.rst:2351 msgid "" ":func:`create_autospec` also takes arbitrary keyword arguments that are " "passed to the constructor of the created mock." @@ -2517,7 +2528,7 @@ msgstr "" ":func:`create_autospec` 也接受任意的關鍵字引數，這些引數會傳遞給已建立的 " "mock 的建構函式。" -#: ../../library/unittest.mock.rst:2340 +#: ../../library/unittest.mock.rst:2354 msgid "" "See :ref:`auto-speccing` for examples of how to use auto-speccing with :func:" "`create_autospec` and the *autospec* argument to :func:`patch`." @@ -2525,7 +2536,7 @@ msgstr "" "請參閱 :ref:`auto-speccing` 以得知如何以 :func:`create_autospec` 使用自動規格" "以及如何在 :func:`patch` 中使用 *autospec* 引數的範例。" -#: ../../library/unittest.mock.rst:2346 +#: ../../library/unittest.mock.rst:2360 msgid "" ":func:`create_autospec` now returns an :class:`AsyncMock` if the target is " "an async function." @@ -2533,11 +2544,11 @@ msgstr "" "如果目標是一個非同步函式，:func:`create_autospec` 現在會回傳一個 :class:" "`AsyncMock`。" -#: ../../library/unittest.mock.rst:2351 +#: ../../library/unittest.mock.rst:2365 msgid "ANY" msgstr "ANY" -#: ../../library/unittest.mock.rst:2355 +#: ../../library/unittest.mock.rst:2369 msgid "" "Sometimes you may need to make assertions about *some* of the arguments in a " "call to mock, but either not care about some of the arguments or want to " @@ -2547,7 +2558,7 @@ msgstr "" "有時你可能需要對 mock 的呼叫中的\\ *某些*\\ 引數進行斷言，但你不在意其他的某" "些引數，或想將它們單獨從 :attr:`~Mock.call_args` 中取出並進行更加複雜的斷言。" -#: ../../library/unittest.mock.rst:2360 +#: ../../library/unittest.mock.rst:2374 msgid "" "To ignore certain arguments you can pass in objects that compare equal to " "*everything*. Calls to :meth:`~Mock.assert_called_with` and :meth:`~Mock." @@ -2557,24 +2568,24 @@ msgstr "" "麼內容，對 :meth:`~Mock.assert_used_with` 和 :meth:`~Mock." "assert_used_once_with` 的呼叫都會成功。" -#: ../../library/unittest.mock.rst:2369 +#: ../../library/unittest.mock.rst:2383 msgid "" ":data:`ANY` can also be used in comparisons with call lists like :attr:" "`~Mock.mock_calls`:" msgstr "" ":data:`ANY` 也可以用來與呼叫串列進行比較，例如 :attr:`~Mock.mock_calls`：" -#: ../../library/unittest.mock.rst:2379 +#: ../../library/unittest.mock.rst:2393 msgid "" ":data:`ANY` is not limited to comparisons with call objects and so can also " "be used in test assertions::" msgstr ":data:`ANY` 不只能與呼叫物件比較，其也可以在測試斷言中使用： ::" -#: ../../library/unittest.mock.rst:2390 +#: ../../library/unittest.mock.rst:2404 msgid "FILTER_DIR" msgstr "FILTER_DIR" -#: ../../library/unittest.mock.rst:2394 +#: ../../library/unittest.mock.rst:2408 msgid "" ":data:`FILTER_DIR` is a module level variable that controls the way mock " "objects respond to :func:`dir`. The default is ``True``, which uses the " @@ -2587,7 +2598,7 @@ msgstr "" "你不喜歡這個過濾方式，或由於診斷意圖而需要將其關閉，請設定 ``mock.FILTER_DIR " "= False``。" -#: ../../library/unittest.mock.rst:2400 +#: ../../library/unittest.mock.rst:2414 msgid "" "With filtering on, ``dir(some_mock)`` shows only useful attributes and will " "include any dynamically created attributes that wouldn't normally be shown. " @@ -2599,7 +2610,7 @@ msgstr "" "的任何動態建立的屬性。如果 mock 是使用 *spec*\\ （或 *autospec*\\ ）來建立" "的，那麼源頭的所有屬性都會顯示，即使它們尚未被存取：" -#: ../../library/unittest.mock.rst:2427 +#: ../../library/unittest.mock.rst:2441 msgid "" "Many of the not-very-useful (private to :class:`Mock` rather than the thing " "being mocked) underscore and double underscore prefixed attributes have been " @@ -2611,7 +2622,7 @@ msgstr "" "雙底線前綴屬性已從在 :class:`Mock` 上呼叫 :func:`dir` 的結果中濾除。如果你不" "喜歡這種特性，可以透過設定模組級別開關 :data:`FILTER_DIR` 來將其關閉：" -#: ../../library/unittest.mock.rst:2448 +#: ../../library/unittest.mock.rst:2462 msgid "" "Alternatively you can just use ``vars(my_mock)`` (instance members) and " "``dir(type(my_mock))`` (type members) to bypass the filtering irrespective " @@ -2621,11 +2632,11 @@ msgstr "" "``dir(type(my_mock))``\\ （型別成員）來略過過濾，而不考慮 :const:`mock." "FILTER_DIR`。" -#: ../../library/unittest.mock.rst:2454 +#: ../../library/unittest.mock.rst:2468 msgid "mock_open" msgstr "mock_open" -#: ../../library/unittest.mock.rst:2458 +#: ../../library/unittest.mock.rst:2472 msgid "" "A helper function to create a mock to replace the use of :func:`open`. It " "works for :func:`open` called directly or used as a context manager." @@ -2633,7 +2644,7 @@ msgstr "" "用於建立取代 :func:`open` 用途的 mock 的輔助函式。它適用於直接呼叫或用作情境" "管理器的 :func:`open`。" -#: ../../library/unittest.mock.rst:2461 +#: ../../library/unittest.mock.rst:2475 msgid "" "The *mock* argument is the mock object to configure. If ``None`` (the " "default) then a :class:`MagicMock` will be created for you, with the API " @@ -2642,7 +2653,7 @@ msgstr "" "*mock* 引數是要配置的 mock 物件。如果其為 ``None``\\ （預設值），那麼就會為你" "建立一個 :class:`MagicMock`，其 API 限制在標準檔案處理上可用的方法或屬性。" -#: ../../library/unittest.mock.rst:2465 +#: ../../library/unittest.mock.rst:2479 msgid "" "*read_data* is a string for the :meth:`~io.IOBase.read`, :meth:`~io.IOBase." "readline`, and :meth:`~io.IOBase.readlines` methods of the file handle to " @@ -2662,7 +2673,7 @@ msgstr "" "org>`_ 上的其中一個記憶體內檔案系統 (in-memory filesystem) 套件可以提供用於測" "試的真實檔案系統。" -#: ../../library/unittest.mock.rst:2475 +#: ../../library/unittest.mock.rst:2489 msgid "" "Added :meth:`~io.IOBase.readline` and :meth:`~io.IOBase.readlines` support. " "The mock of :meth:`~io.IOBase.read` changed to consume *read_data* rather " @@ -2672,11 +2683,11 @@ msgstr "" "meth:`~io.IOBase.read` 的 mock 更改為消耗 *read_data* 而不是在每次呼叫時回傳" "它。" -#: ../../library/unittest.mock.rst:2480 +#: ../../library/unittest.mock.rst:2494 msgid "*read_data* is now reset on each call to the *mock*." msgstr "現在，每次呼叫 *mock* 時都會重置 *read_data*。" -#: ../../library/unittest.mock.rst:2483 +#: ../../library/unittest.mock.rst:2497 msgid "" "Added :meth:`~container.__iter__` to implementation so that iteration (such " "as in for loops) correctly consumes *read_data*." @@ -2684,7 +2695,7 @@ msgstr "" "新增 :meth:`~container.__iter__` 到實作中，以便使疊代（例如在 for 迴圈中）正" "確地消耗 *read_data*。" -#: ../../library/unittest.mock.rst:2487 +#: ../../library/unittest.mock.rst:2501 msgid "" "Using :func:`open` as a context manager is a great way to ensure your file " "handles are closed properly and is becoming common::" @@ -2692,7 +2703,7 @@ msgstr "" "使用 :func:`open` 作為情境管理器是確保檔案處理正確關閉的好方式，且這種方式正" "在變得普遍： ::" -#: ../../library/unittest.mock.rst:2493 +#: ../../library/unittest.mock.rst:2507 msgid "" "The issue is that even if you mock out the call to :func:`open` it is the " "*returned object* that is used as a context manager (and has :meth:`~object." @@ -2702,7 +2713,7 @@ msgstr "" "回傳物件*\\ （且其 :meth:`~object.__enter__` 和 :meth:`~ object.__exit__` 已" "被呼叫）。" -#: ../../library/unittest.mock.rst:2497 +#: ../../library/unittest.mock.rst:2511 msgid "" "Mocking context managers with a :class:`MagicMock` is common enough and " "fiddly enough that a helper function is useful. ::" @@ -2710,15 +2721,15 @@ msgstr "" "使用 :class:`MagicMock` mock 情境管理器相當常見並且精細，因此輔助函式就非常有" "用： ::" -#: ../../library/unittest.mock.rst:2514 +#: ../../library/unittest.mock.rst:2528 msgid "And for reading files::" msgstr "以及讀取檔案： ::" -#: ../../library/unittest.mock.rst:2527 +#: ../../library/unittest.mock.rst:2541 msgid "Autospeccing" msgstr "Autospeccing（自動規格）" -#: ../../library/unittest.mock.rst:2529 +#: ../../library/unittest.mock.rst:2543 msgid "" "Autospeccing is based on the existing :attr:`spec` feature of mock. It " "limits the api of mocks to the api of an original object (the spec), but it " @@ -2732,11 +2743,11 @@ msgstr "" "有與規格的屬性相同的 api。此外，被 mock 的函式/方法具有與原始的函式/方法相同" "的呼叫簽名，因此如果它們被不正確地呼叫，就會引發 :exc:`TypeError`。" -#: ../../library/unittest.mock.rst:2536 +#: ../../library/unittest.mock.rst:2550 msgid "Before I explain how auto-speccing works, here's why it is needed." msgstr "在解釋自動規格如何運作之前，我們先解釋為什麼需要它。" -#: ../../library/unittest.mock.rst:2538 +#: ../../library/unittest.mock.rst:2552 msgid "" ":class:`Mock` is a very powerful and flexible object, but it suffers from a " "flaw which is general to mocking. If you refactor some of your code, rename " @@ -2749,7 +2760,7 @@ msgstr "" "實物件的程式碼測試仍然會通過。這意味著即使你的程式碼壞了，但測試仍可以全部通" "過。" -#: ../../library/unittest.mock.rst:2546 +#: ../../library/unittest.mock.rst:2560 msgid "" "Before 3.5, tests with a typo in the word assert would silently pass when " "they should raise an error. You can still achieve this behavior by passing " @@ -2758,7 +2769,7 @@ msgstr "" "在 3.5 之前，當測試應該引發錯誤時，斷言單字中存在拼字錯誤的測驗會默默地通過。" "你仍可以透過將 ``unsafe=True`` 傳遞給 Mock 來實作此行為。" -#: ../../library/unittest.mock.rst:2549 +#: ../../library/unittest.mock.rst:2563 msgid "" "Note that this is another reason why you need integration tests as well as " "unit tests. Testing everything in isolation is all fine and dandy, but if " @@ -2768,7 +2779,7 @@ msgstr "" "謹記這是你需要有整合測試和單元測試的另一個原因。單獨測試所有內容都很好，但如" "果你不測試你的單元是如何「連接在一起」的，那麼測試還是有機會發現很多錯誤。" -#: ../../library/unittest.mock.rst:2554 +#: ../../library/unittest.mock.rst:2568 msgid "" ":mod:`mock` already provides a feature to help with this, called speccing. " "If you use a class or instance as the :attr:`spec` for a mock then you can " @@ -2778,13 +2789,13 @@ msgstr "" "類別或實例作為 mock 的 :attr:`spec`，那麼你在 mock 上只能存取真實類別中存在的" "屬性：" -#: ../../library/unittest.mock.rst:2565 +#: ../../library/unittest.mock.rst:2579 msgid "" "The spec only applies to the mock itself, so we still have the same issue " "with any methods on the mock:" msgstr "該規格僅適用於 mock 本身，因此在 mock 上的任何方法仍然有相同的問題：" -#: ../../library/unittest.mock.rst:2574 +#: ../../library/unittest.mock.rst:2588 msgid "" "Auto-speccing solves this problem. You can either pass ``autospec=True`` to :" "func:`patch` / :func:`patch.object` or use the :func:`create_autospec` " @@ -2802,11 +2813,11 @@ msgstr "" "的），所以你可以將它與非常複雜或深度巢狀使用的物件（例如連續引用的模組）一起" "使用，而不會過於影響性能。" -#: ../../library/unittest.mock.rst:2583 +#: ../../library/unittest.mock.rst:2597 msgid "Here's an example of it in use::" msgstr "這是一個正在使用的例子： ::" -#: ../../library/unittest.mock.rst:2593 +#: ../../library/unittest.mock.rst:2607 msgid "" "You can see that :class:`request.Request` has a spec. :class:`request." "Request` takes two arguments in the constructor (one of which is *self*). " @@ -2816,13 +2827,13 @@ msgstr "" "構函式中接受兩個引數（其中之一是 *self*\\ ）。如果我們錯誤地呼叫它，會發生以" "下情況： ::" -#: ../../library/unittest.mock.rst:2602 +#: ../../library/unittest.mock.rst:2616 msgid "" "The spec also applies to instantiated classes (i.e. the return value of " "specced mocks)::" msgstr "此規格也適用於實例化的類別（即有規格的 mock 的回傳值）： ::" -#: ../../library/unittest.mock.rst:2609 +#: ../../library/unittest.mock.rst:2623 msgid "" ":class:`Request` objects are not callable, so the return value of " "instantiating our mocked out :class:`request.Request` is a non-callable " @@ -2833,7 +2844,7 @@ msgstr "" "`request.Request` 的回傳值是不可呼叫的 mock。規格到位後，斷言中的任何拼字錯誤" "都會引發正確的錯誤： ::" -#: ../../library/unittest.mock.rst:2621 +#: ../../library/unittest.mock.rst:2635 msgid "" "In many cases you will just be able to add ``autospec=True`` to your " "existing :func:`patch` calls and then be protected against bugs due to typos " @@ -2842,7 +2853,7 @@ msgstr "" "在許多情況下，你只需要將 ``autospec=True`` 新增至現有的 :func:`patch` 呼叫" "中，然後就可以防止因拼字錯誤和 api 變更而導致的錯誤。" -#: ../../library/unittest.mock.rst:2625 +#: ../../library/unittest.mock.rst:2639 msgid "" "As well as using *autospec* through :func:`patch` there is a :func:" "`create_autospec` for creating autospecced mocks directly:" @@ -2850,7 +2861,7 @@ msgstr "" "除了透過 :func:`patch` 使用 *autospec* 之外，還有一個 :func:" "`create_autospec` 用於直接建立有自動規格的 mock：" -#: ../../library/unittest.mock.rst:2633 +#: ../../library/unittest.mock.rst:2647 msgid "" "This isn't without caveats and limitations however, which is why it is not " "the default behaviour. In order to know what attributes are available on the " @@ -2867,7 +2878,7 @@ msgstr "" "描述器，那麼你可能無法使用 autospec。換句話說，設計你的物件讓內省是安全的 " "[#]_ 會比較好。" -#: ../../library/unittest.mock.rst:2642 +#: ../../library/unittest.mock.rst:2656 msgid "" "A more serious problem is that it is common for instance attributes to be " "created in the :meth:`~object.__init__` method and not to exist on the class " @@ -2878,7 +2889,7 @@ msgstr "" "而其根本不存在於類別中。*autospec* 無法知道任何動態建立的屬性，並將 api 限制" "為可見的屬性。： ::" -#: ../../library/unittest.mock.rst:2659 +#: ../../library/unittest.mock.rst:2673 msgid "" "There are a few different ways of resolving this problem. The easiest, but " "not necessarily the least annoying, way is to simply set the required " @@ -2890,7 +2901,7 @@ msgstr "" "在 mock 上設定所需的屬性。因為雖然 *autospec* 不允許你取得規格中不存在的屬" "性，但是它不會阻止你設定它們： ::" -#: ../../library/unittest.mock.rst:2670 +#: ../../library/unittest.mock.rst:2684 msgid "" "There is a more aggressive version of both *spec* and *autospec* that *does* " "prevent you setting non-existent attributes. This is useful if you want to " @@ -2901,7 +2912,7 @@ msgstr "" "屬性。如果你想確保你的程式碼僅能\\ *設定*\\ 有效的屬性，那麼這會很有用，但顯" "然它也順便阻止了這個特殊情況：" -#: ../../library/unittest.mock.rst:2683 +#: ../../library/unittest.mock.rst:2697 msgid "" "Probably the best way of solving the problem is to add class attributes as " "default values for instance members initialised in :meth:`~object.__init__`. " @@ -2913,7 +2924,7 @@ msgstr "" "的實例成員的預設值。請注意，如果你僅在 :meth:`!__init__` 中設定預設屬性，那麼" "透過類別屬性（當然在實例之間共用）提供它們也會更快。例如：" -#: ../../library/unittest.mock.rst:2694 +#: ../../library/unittest.mock.rst:2708 msgid "" "This brings up another issue. It is relatively common to provide a default " "value of ``None`` for members that will later be an object of a different " @@ -2929,7 +2940,7 @@ msgstr "" "他型別的成員，因此自動規格不會對設定為 ``None`` 的成員使用規格。這些會只是普" "通的 mock（通常是 MagicMocks）：" -#: ../../library/unittest.mock.rst:2709 +#: ../../library/unittest.mock.rst:2723 msgid "" "If modifying your production classes to add defaults isn't to your liking " "then there are more options. One of these is simply to use an instance as " @@ -2945,7 +2956,7 @@ msgstr "" "你使用替代物件作為規格。值得慶幸的是 :func:`patch` 支援這一點 - 你可以簡單地" "將替代物件作為 *autospec* 引數傳遞： ::" -#: ../../library/unittest.mock.rst:2730 +#: ../../library/unittest.mock.rst:2744 msgid "" "This only applies to classes or already instantiated objects. Calling a " "mocked class to create a mock instance *does not* create a real instance. It " @@ -2954,11 +2965,11 @@ msgstr "" "這只適用於類別或已經實例化的物件。呼叫一個被 mock 的類別來建立一個 mock 實例" "\\ *不會*\\ 建立真的實例。它僅查找屬性及對 :func:`dir` 的呼叫。" -#: ../../library/unittest.mock.rst:2735 +#: ../../library/unittest.mock.rst:2749 msgid "Sealing mocks" msgstr "密封 mock" -#: ../../library/unittest.mock.rst:2744 +#: ../../library/unittest.mock.rst:2758 msgid "" "Seal will disable the automatic creation of mocks when accessing an " "attribute of the mock being sealed or any of its attributes that are already " @@ -2967,7 +2978,7 @@ msgstr "" "當存取被密封的 mock 的屬性或其任何已經遞迴 mock 的屬性時，seal 將停用 mock 的" "自動建立。" -#: ../../library/unittest.mock.rst:2747 +#: ../../library/unittest.mock.rst:2761 msgid "" "If a mock instance with a name or a spec is assigned to an attribute it " "won't be considered in the sealing chain. This allows one to prevent seal " @@ -2976,28 +2987,28 @@ msgstr "" "如果將具有名稱或規格的 mock 實例指派給屬性，則不會出現在密封鏈中。這表示可藉" "由固定 mock 物件的一部分來防止密封。： ::" -#: ../../library/unittest.mock.rst:2763 +#: ../../library/unittest.mock.rst:2777 msgid "" "Order of precedence of :attr:`side_effect`, :attr:`return_value` and *wraps*" msgstr ":attr:`side_effect`、:attr:`return_value` 和 *wraps* 的優先順序" -#: ../../library/unittest.mock.rst:2765 +#: ../../library/unittest.mock.rst:2779 msgid "The order of their precedence is:" msgstr "它們的優先順序是：" -#: ../../library/unittest.mock.rst:2767 +#: ../../library/unittest.mock.rst:2781 msgid ":attr:`~Mock.side_effect`" msgstr ":attr:`~Mock.side_effect`" -#: ../../library/unittest.mock.rst:2768 +#: ../../library/unittest.mock.rst:2782 msgid ":attr:`~Mock.return_value`" msgstr ":attr:`~Mock.return_value`" -#: ../../library/unittest.mock.rst:2769 +#: ../../library/unittest.mock.rst:2783 msgid "*wraps*" msgstr "*wraps*" -#: ../../library/unittest.mock.rst:2771 +#: ../../library/unittest.mock.rst:2785 msgid "" "If all three are set, mock will return the value from :attr:`~Mock." "side_effect`, ignoring :attr:`~Mock.return_value` and the wrapped object " @@ -3009,7 +3020,7 @@ msgstr "" "略 :attr:`~Mock.return_value` 和被包裝物件。如果設定了任兩項，則優先順序較高" "的一項將回傳該值。無論先設定哪個順序，優先順序都保持不變。" -#: ../../library/unittest.mock.rst:2789 +#: ../../library/unittest.mock.rst:2803 msgid "" "As ``None`` is the default value of :attr:`~Mock.side_effect`, if you " "reassign its value back to ``None``, the order of precedence will be checked " @@ -3020,7 +3031,7 @@ msgstr "" "``None``，則會檢查 :attr:`~Mock.return_value` 和被包裝物件之間的優先順序，忽" "略 :attr:`~Mock.side_effect`。" -#: ../../library/unittest.mock.rst:2798 +#: ../../library/unittest.mock.rst:2812 msgid "" "If the value being returned by :attr:`~Mock.side_effect` is :data:`DEFAULT`, " "it is ignored and the order of precedence moves to the successor to obtain " @@ -3029,7 +3040,7 @@ msgstr "" "如果 :attr:`~Mock.side_effect` 回傳的值是 :data:`DEFAULT`，它將被忽略，並且優" "先順序被移動到後面一個以獲得要回傳的值。" -#: ../../library/unittest.mock.rst:2807 +#: ../../library/unittest.mock.rst:2821 msgid "" "When :class:`Mock` wraps an object, the default value of :attr:`~Mock." "return_value` will be :data:`DEFAULT`." @@ -3037,13 +3048,13 @@ msgstr "" "當 :class:`Mock` 包裝一個物件時，:attr:`~Mock.return_value` 的預設值將為 :" "data:`DEFAULT`。" -#: ../../library/unittest.mock.rst:2816 +#: ../../library/unittest.mock.rst:2830 msgid "" "The order of precedence will ignore this value and it will move to the last " "successor which is the wrapped object." msgstr "優先順序將忽略該值，並將移動到最後一個，即被包裝物件。" -#: ../../library/unittest.mock.rst:2819 +#: ../../library/unittest.mock.rst:2833 msgid "" "As the real call is being made to the wrapped object, creating an instance " "of this mock will return the real instance of the class. The positional " @@ -3052,7 +3063,7 @@ msgstr "" "當對被包裝物件進行真正的呼叫時，建立此 mock 的實例將回傳該類別的真實實例。必" "須傳遞被包裝物件所需的位置引數（如果存在）。" -#: ../../library/unittest.mock.rst:2837 +#: ../../library/unittest.mock.rst:2851 msgid "" "But if you assign ``None`` to it, this will not be ignored as it is an " "explicit assignment. So, the order of precedence will not move to the " @@ -3061,13 +3072,13 @@ msgstr "" "但如果你為其賦予 ``None`` 則不會被忽略，因為它是明確賦值。因此，優先順序不會" "移至被包裝物件。" -#: ../../library/unittest.mock.rst:2845 +#: ../../library/unittest.mock.rst:2859 msgid "" "Even if you set all three at once when initializing the mock, the order of " "precedence remains the same:" msgstr "即使你在初始化 mock 時同時設定所有三個，優先順序也保持不變：" -#: ../../library/unittest.mock.rst:2862 +#: ../../library/unittest.mock.rst:2876 msgid "" "If :attr:`~Mock.side_effect` is exhausted, the order of precedence will not " "cause a value to be obtained from the successors. Instead, ``StopIteration`` " diff --git a/library/uu.po b/library/uu.po index 78351d83bf..55c9f76f32 100644 --- a/library/uu.po +++ b/library/uu.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-09 00:15+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2022-05-22 02:22+0800\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -27,7 +27,7 @@ msgstr ":mod:`xdrlib` --- uuencode 檔案的編碼與解碼" msgid "**Source code:** :source:`Lib/uu.py`" msgstr "**原始碼：**\\ :source:`Lib/uu.py`" -#: ../../library/uu.rst:16 +#: ../../library/uu.rst:12 msgid "" "The :mod:`uu` module is deprecated (see :pep:`PEP 594 <594#uu-and-the-uu-" "encoding>` for details). :mod:`base64` is a modern alternative." diff --git a/library/webbrowser.po b/library/webbrowser.po index 0de224a135..858bf34473 100644 --- a/library/webbrowser.po +++ b/library/webbrowser.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2017-09-22 18:27+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -358,7 +358,7 @@ msgid "" "versions 35 and below." msgstr "" -#: ../../library/webbrowser.rst:176 +#: ../../library/webbrowser.rst:174 msgid ":class:`MacOSX` is deprecated, use :class:`MacOSXOSAScript` instead." msgstr "" diff --git a/library/xdrlib.po b/library/xdrlib.po index 436b12ba1c..3f33dc21c5 100644 --- a/library/xdrlib.po +++ b/library/xdrlib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 00:04+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2016-01-31 07:33+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -26,7 +26,7 @@ msgstr ":mod:`xdrlib` --- XDR 資料的編碼與解碼" msgid "**Source code:** :source:`Lib/xdrlib.py`" msgstr "**原始碼：**\\ :source:`Lib/xdrlib.py`" -#: ../../library/xdrlib.rst:17 +#: ../../library/xdrlib.rst:14 msgid "" "The :mod:`xdrlib` module is deprecated (see :pep:`PEP 594 <594#xdrlib>` for " "details)." diff --git a/reference/datamodel.po b/reference/datamodel.po index 0b7331a85f..7be8d85739 100644 --- a/reference/datamodel.po +++ b/reference/datamodel.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-27 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:17+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -253,7 +253,7 @@ msgstr "" #: ../../reference/datamodel.rst:218 msgid "" -"Python distinguishes between integers, floating point numbers, and complex " +"Python distinguishes between integers, floating-point numbers, and complex " "numbers:" msgstr "" @@ -311,13 +311,13 @@ msgstr ":class:`numbers.Real` (:class:`float`)" #: ../../reference/datamodel.rst:267 msgid "" -"These represent machine-level double precision floating point numbers. You " +"These represent machine-level double precision floating-point numbers. You " "are at the mercy of the underlying machine architecture (and C or Java " "implementation) for the accepted range and handling of overflow. Python does " -"not support single-precision floating point numbers; the savings in " +"not support single-precision floating-point numbers; the savings in " "processor and memory usage that are usually the reason for using these are " "dwarfed by the overhead of using objects in Python, so there is no reason to " -"complicate the language with two kinds of floating point numbers." +"complicate the language with two kinds of floating-point numbers." msgstr "" #: ../../reference/datamodel.rst:277 @@ -327,7 +327,7 @@ msgstr ":class:`numbers.Complex` (:class:`complex`)" #: ../../reference/datamodel.rst:283 msgid "" "These represent complex numbers as a pair of machine-level double precision " -"floating point numbers. The same caveats apply as for floating point " +"floating-point numbers. The same caveats apply as for floating-point " "numbers. The real and imaginary parts of a complex number ``z`` can be " "retrieved through the read-only attributes ``z.real`` and ``z.imag``." msgstr "" @@ -4037,7 +4037,8 @@ msgid "True" msgstr "True" #: ../../reference/datamodel.rst:261 -msgid "floating point" +#, fuzzy +msgid "floating-point" msgstr "floating point（浮點）" #: ../../reference/datamodel.rst:261 ../../reference/datamodel.rst:279 diff --git a/reference/expressions.po b/reference/expressions.po index 7f6fb4a506..67f38ead1a 100644 --- a/reference/expressions.po +++ b/reference/expressions.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-14 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:17+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -58,7 +58,7 @@ msgstr "" #: ../../reference/expressions.rst:36 msgid "" -"otherwise, if either argument is a floating point number, the other is " +"otherwise, if either argument is a floating-point number, the other is " "converted to floating point;" msgstr "" @@ -184,8 +184,8 @@ msgstr "" #: ../../reference/expressions.rst:141 msgid "" "Evaluation of a literal yields an object of the given type (string, bytes, " -"integer, floating point number, complex number) with the given value. The " -"value may be approximated in the case of floating point and imaginary " +"integer, floating-point number, complex number) with the given value. The " +"value may be approximated in the case of floating-point and imaginary " "(complex) literals. See section :ref:`literals` for details." msgstr "" @@ -1401,7 +1401,7 @@ msgid "" "The ``%`` (modulo) operator yields the remainder from the division of the " "first argument by the second. The numeric arguments are first converted to " "a common type. A zero right argument raises the :exc:`ZeroDivisionError` " -"exception. The arguments may be floating point numbers, e.g., ``3.14%0.7`` " +"exception. The arguments may be floating-point numbers, e.g., ``3.14%0.7`` " "equals ``0.34`` (since ``3.14`` equals ``4*0.7 + 0.34``.) The modulo " "operator always yields a result with the same sign as its second operand (or " "zero); the absolute value of the result is strictly smaller than the " @@ -1435,7 +1435,7 @@ msgstr "" msgid "" "The floor division operator, the modulo operator, and the :func:`divmod` " "function are not defined for complex numbers. Instead, convert to a " -"floating point number using the :func:`abs` function if appropriate." +"floating-point number using the :func:`abs` function if appropriate." msgstr "" #: ../../reference/expressions.rst:1385 diff --git a/reference/lexical_analysis.po b/reference/lexical_analysis.po index 359e24c79e..9ea78730fe 100644 --- a/reference/lexical_analysis.po +++ b/reference/lexical_analysis.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 00:04+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:17+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1052,7 +1052,7 @@ msgstr "" #: ../../reference/lexical_analysis.rst:885 msgid "" -"There are three types of numeric literals: integers, floating point numbers, " +"There are three types of numeric literals: integers, floating-point numbers, " "and imaginary numbers. There are no complex literals (complex numbers can " "be formed by adding a real number and an imaginary number)." msgstr "" @@ -1102,26 +1102,28 @@ msgid "Underscores are now allowed for grouping purposes in literals." msgstr "" #: ../../reference/lexical_analysis.rst:947 -msgid "Floating point literals" -msgstr "" +#, fuzzy +msgid "Floating-point literals" +msgstr "floating point literal（浮點數常數）" #: ../../reference/lexical_analysis.rst:949 msgid "" -"Floating point literals are described by the following lexical definitions:" +"Floating-point literals are described by the following lexical definitions:" msgstr "" #: ../../reference/lexical_analysis.rst:959 msgid "" "Note that the integer and exponent parts are always interpreted using radix " "10. For example, ``077e010`` is legal, and denotes the same number as " -"``77e10``. The allowed range of floating point literals is implementation-" +"``77e10``. The allowed range of floating-point literals is implementation-" "dependent. As in integer literals, underscores are supported for digit " "grouping." msgstr "" #: ../../reference/lexical_analysis.rst:964 -msgid "Some examples of floating point literals::" -msgstr "" +#, fuzzy +msgid "Some examples of floating-point literals::" +msgstr "floating point literal（浮點數常數）" #: ../../reference/lexical_analysis.rst:977 msgid "Imaginary literals" @@ -1134,9 +1136,9 @@ msgstr "" #: ../../reference/lexical_analysis.rst:984 msgid "" "An imaginary literal yields a complex number with a real part of 0.0. " -"Complex numbers are represented as a pair of floating point numbers and have " +"Complex numbers are represented as a pair of floating-point numbers and have " "the same restrictions on their range. To create a complex number with a " -"nonzero real part, add a floating point number to it, e.g., ``(3+4j)``. " +"nonzero real part, add a floating-point number to it, e.g., ``(3+4j)``. " "Some examples of imaginary literals::" msgstr "" @@ -1538,7 +1540,8 @@ msgid "integer literal" msgstr "integer literal（整數常數）" #: ../../reference/lexical_analysis.rst:881 -msgid "floating point literal" +#, fuzzy +msgid "floating-point literal" msgstr "floating point literal（浮點數常數）" #: ../../reference/lexical_analysis.rst:881 diff --git a/tutorial/floatingpoint.po b/tutorial/floatingpoint.po index faa143c4b4..6311bf8eea 100644 --- a/tutorial/floatingpoint.po +++ b/tutorial/floatingpoint.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-04 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2023-06-22 14:43+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -24,7 +24,8 @@ msgstr "" "X-Generator: Poedit 3.3.1\n" #: ../../tutorial/floatingpoint.rst:10 -msgid "Floating Point Arithmetic: Issues and Limitations" +#, fuzzy +msgid "Floating-Point Arithmetic: Issues and Limitations" msgstr "浮點數運算：問題與限制" #: ../../tutorial/floatingpoint.rst:16 @@ -153,8 +154,9 @@ msgstr "" "（在大部分的系統上）現在能選擇其中最短的數並簡單地顯示為 ``0.1``。" #: ../../tutorial/floatingpoint.rst:91 +#, fuzzy msgid "" -"Note that this is in the very nature of binary floating-point: this is not a " +"Note that this is in the very nature of binary floating point: this is not a " "bug in Python, and it is not a bug in your code either. You'll see the same " "kind of thing in all languages that support your hardware's floating-point " "arithmetic (although some languages may not *display* the difference by " @@ -213,12 +215,13 @@ msgid "" msgstr "或者，可以使用 :func:`round` 函式來比較粗略的近似值：" #: ../../tutorial/floatingpoint.rst:147 +#, fuzzy msgid "" "Binary floating-point arithmetic holds many surprises like this. The " "problem with \"0.1\" is explained in precise detail below, in the " "\"Representation Error\" section. See `Examples of Floating Point Problems " "`_ for " -"a pleasant summary of how binary floating-point works and the kinds of " +"a pleasant summary of how binary floating point works and the kinds of " "problems commonly encountered in practice. Also see `The Perils of Floating " "Point `_ for a more complete " "account of other common surprises." @@ -231,9 +234,10 @@ msgstr "" "（浮點數的風險） `_。" #: ../../tutorial/floatingpoint.rst:156 +#, fuzzy msgid "" "As that says near the end, \"there are no easy answers.\" Still, don't be " -"unduly wary of floating-point! The errors in Python float operations are " +"unduly wary of floating point! The errors in Python float operations are " "inherited from the floating-point hardware, and on most machines are on the " "order of no more than 1 part in 2\\*\\*53 per operation. That's more than " "adequate for most tasks, but you do need to keep in mind that it's not " diff --git a/tutorial/introduction.po b/tutorial/introduction.po index 46d04b3cfb..861c59108a 100644 --- a/tutorial/introduction.po +++ b/tutorial/introduction.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 00:04+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2022-10-16 03:20+0800\n" "Last-Translator: Steven Hsu \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -573,11 +573,12 @@ msgstr "" "數量必須維持一致。" #: ../../tutorial/introduction.rst:544 +#, fuzzy msgid "" "The :func:`print` function writes the value of the argument(s) it is given. " "It differs from just writing the expression you want to write (as we did " "earlier in the calculator examples) in the way it handles multiple " -"arguments, floating point quantities, and strings. Strings are printed " +"arguments, floating-point quantities, and strings. Strings are printed " "without quotes, and a space is inserted between items, so you can format " "things nicely, like this::" msgstr "" diff --git a/tutorial/stdlib.po b/tutorial/stdlib.po index 25080cb3a9..307ec65bb6 100644 --- a/tutorial/stdlib.po +++ b/tutorial/stdlib.po @@ -14,7 +14,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-07-17 17:39+0800\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2022-01-31 18:14+0800\n" "Last-Translator: Phil Lin \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -156,9 +156,10 @@ msgid "Mathematics" msgstr "數學相關" #: ../../tutorial/stdlib.rst:140 +#, fuzzy msgid "" "The :mod:`math` module gives access to the underlying C library functions " -"for floating point math::" +"for floating-point math::" msgstr ":mod:`math` 模組提供了 C 函式庫中底層的浮點數運算的函式： ::" #: ../../tutorial/stdlib.rst:149 diff --git a/tutorial/stdlib2.po b/tutorial/stdlib2.po index 77eb9b1d8e..2709dbd809 100644 --- a/tutorial/stdlib2.po +++ b/tutorial/stdlib2.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-13 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2021-06-19 14:24+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -338,13 +338,15 @@ msgstr "" "行排序的應用程式來說，這會很有用： ::" #: ../../tutorial/stdlib2.rst:356 -msgid "Decimal Floating Point Arithmetic" +#, fuzzy +msgid "Decimal Floating-Point Arithmetic" msgstr "十進制 (Decimal) 浮點數運算" #: ../../tutorial/stdlib2.rst:358 +#, fuzzy msgid "" "The :mod:`decimal` module offers a :class:`~decimal.Decimal` datatype for " -"decimal floating point arithmetic. Compared to the built-in :class:`float` " +"decimal floating-point arithmetic. Compared to the built-in :class:`float` " "implementation of binary floating point, the class is especially helpful for" msgstr "" ":mod:`decimal` 模組提供了一個 :class:`~decimal.Decimal` 資料類型，用於十進制" diff --git a/using/configure.po b/using/configure.po index 427caf8fa1..528f124905 100644 --- a/using/configure.po +++ b/using/configure.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-16 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -39,8 +39,8 @@ msgstr "" #: ../../using/configure.rst:17 msgid "" -"Support for `IEEE 754 `_ floating " -"point numbers and `floating point Not-a-Number (NaN) `_ floating-" +"point numbers and `floating-point Not-a-Number (NaN) `_." msgstr "" diff --git a/whatsnew/2.1.po b/whatsnew/2.1.po index 9a8cf65f8c..f12ad36803 100644 --- a/whatsnew/2.1.po +++ b/whatsnew/2.1.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 00:04+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:19+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -807,9 +807,9 @@ msgstr "" #: ../../whatsnew/2.1.rst:646 msgid "" "Various functions in the :mod:`time` module, such as :func:`~time.asctime` " -"and :func:`~time.localtime`, require a floating point argument containing " +"and :func:`~time.localtime`, require a floating-point argument containing " "the time in seconds since the epoch. The most common use of these functions " -"is to work with the current time, so the floating point argument has been " +"is to work with the current time, so the floating-point argument has been " "made optional; when a value isn't provided, the current time will be used. " "For example, log file entries usually need a string containing the current " "time; in Python 2.1, ``time.asctime()`` can be used, instead of the " diff --git a/whatsnew/2.2.po b/whatsnew/2.2.po index 2e677d9394..2902503b16 100644 --- a/whatsnew/2.2.po +++ b/whatsnew/2.2.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-27 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:19+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1516,7 +1516,7 @@ msgstr "" msgid "" "The :func:`pow` built-in function no longer supports 3 arguments when " "floating-point numbers are supplied. ``pow(x, y, z)`` returns ``(x**y) % " -"z``, but this is never useful for floating point numbers, and the final " +"z``, but this is never useful for floating-point numbers, and the final " "result varies unpredictably depending on the platform. A call such as " "``pow(2.0, 8.0, 7.0)`` will now raise a :exc:`TypeError` exception." msgstr "" diff --git a/whatsnew/2.3.po b/whatsnew/2.3.po index 5626a58b50..9741856903 100644 --- a/whatsnew/2.3.po +++ b/whatsnew/2.3.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 00:04+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:19+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -650,9 +650,9 @@ msgstr "" msgid "" "When encoding a Unicode string into a byte string, unencodable characters " "may be encountered. So far, Python has allowed specifying the error " -"processing as either \"strict\" (raising :exc:`UnicodeError`), \"ignore\" " -"(skipping the character), or \"replace\" (using a question mark in the " -"output string), with \"strict\" being the default behavior. It may be " +"processing as either \"strict\" (raising :exc:`UnicodeError`), " +"\"ignore\" (skipping the character), or \"replace\" (using a question mark " +"in the output string), with \"strict\" being the default behavior. It may be " "desirable to specify alternative processing of such errors, such as " "inserting an XML character reference or HTML entity reference into the " "converted string." @@ -1513,7 +1513,7 @@ msgstr "" #: ../../whatsnew/2.3.rst:1384 msgid "" "Application developers should enable this feature only if all their " -"libraries work properly when confronted with floating point time stamps, or " +"libraries work properly when confronted with floating-point time stamps, or " "if they use the tuple API. If used, the feature should be activated on an " "application level instead of trying to enable it on a per-use basis." msgstr "" diff --git a/whatsnew/2.6.po b/whatsnew/2.6.po index 065c5ca865..f015d0b354 100644 --- a/whatsnew/2.6.po +++ b/whatsnew/2.6.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 00:04+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:20+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -3435,7 +3435,7 @@ msgstr "" msgid "" "Several functions return information about the platform's floating-point " "support. :c:func:`PyFloat_GetMax` returns the maximum representable " -"floating point value, and :c:func:`PyFloat_GetMin` returns the minimum " +"floating-point value, and :c:func:`PyFloat_GetMin` returns the minimum " "positive value. :c:func:`PyFloat_GetInfo` returns an object containing more " "information from the :file:`float.h` file, such as ``\"mant_dig\"`` (number " "of digits in the mantissa), ``\"epsilon\"`` (smallest difference between 1.0 " diff --git a/whatsnew/2.7.po b/whatsnew/2.7.po index bf6f479020..b5a0b8a6f8 100644 --- a/whatsnew/2.7.po +++ b/whatsnew/2.7.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-27 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:20+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1253,7 +1253,7 @@ msgid "" "now produces sensible results based on the numeric values of the operands. " "Previously such comparisons would fall back to Python's default rules for " "comparing objects, which produced arbitrary results based on their type. " -"Note that you still cannot combine :class:`!Decimal` and floating-point in " +"Note that you still cannot combine :class:`!Decimal` and floating point in " "other operations such as addition, since you should be explicitly choosing " "how to convert between float and :class:`!Decimal`. (Fixed by Mark " "Dickinson; :issue:`2531`.)" @@ -2379,14 +2379,14 @@ msgid "" "ElementTree's code for converting trees to a string has been significantly " "reworked, making it roughly twice as fast in many cases. The :meth:" "`ElementTree.write() ` and :meth:" -"`Element.write` methods now have a *method* parameter that can be \"xml\" " -"(the default), \"html\", or \"text\". HTML mode will output empty elements " -"as ```` instead of ````, and text mode will skip over " -"elements and only output the text chunks. If you set the :attr:`~xml.etree." -"ElementTree.Element.tag` attribute of an element to ``None`` but leave its " -"children in place, the element will be omitted when the tree is written out, " -"so you don't need to do more extensive rearrangement to remove a single " -"element." +"`Element.write` methods now have a *method* parameter that can be " +"\"xml\" (the default), \"html\", or \"text\". HTML mode will output empty " +"elements as ```` instead of ````, and text mode will " +"skip over elements and only output the text chunks. If you set the :attr:" +"`~xml.etree.ElementTree.Element.tag` attribute of an element to ``None`` but " +"leave its children in place, the element will be omitted when the tree is " +"written out, so you don't need to do more extensive rearrangement to remove " +"a single element." msgstr "" #: ../../whatsnew/2.7.rst:2044 diff --git a/whatsnew/3.1.po b/whatsnew/3.1.po index 5c60e35ffb..c0463d6bf8 100644 --- a/whatsnew/3.1.po +++ b/whatsnew/3.1.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 00:04+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:20+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -221,9 +221,9 @@ msgstr "（由 Mark Dickinson 貢獻；:issue:`4707`。）" #: ../../whatsnew/3.1.rst:208 msgid "" -"Python now uses David Gay's algorithm for finding the shortest floating " +"Python now uses David Gay's algorithm for finding the shortest floating-" "point representation that doesn't change its value. This should help " -"mitigate some of the confusion surrounding binary floating point numbers." +"mitigate some of the confusion surrounding binary floating-point numbers." msgstr "" #: ../../whatsnew/3.1.rst:213 @@ -233,7 +233,7 @@ msgid "" "equivalent, an expression like ``float('1.1')`` evaluates to the nearest " "representable value which is ``0x1.199999999999ap+0`` in hex or " "``1.100000000000000088817841970012523233890533447265625`` in decimal. That " -"nearest value was and still is used in subsequent floating point " +"nearest value was and still is used in subsequent floating-point " "calculations." msgstr "" @@ -245,7 +245,7 @@ msgid "" "using 17 digits was that it relied on IEEE-754 guarantees to assure that " "``eval(repr(1.1))`` would round-trip exactly to its original value. The " "disadvantage is that many people found the output to be confusing (mistaking " -"intrinsic limitations of binary floating point representation as being a " +"intrinsic limitations of binary floating-point representation as being a " "problem with Python itself)." msgstr "" @@ -266,7 +266,7 @@ msgstr "" #: ../../whatsnew/3.1.rst:239 msgid "" -"The new algorithm depends on certain features in the underlying floating " +"The new algorithm depends on certain features in the underlying floating-" "point implementation. If the required features are not found, the old " "algorithm will continue to be used. Also, the text pickle protocols assure " "cross-platform portability by using the old algorithm." @@ -697,7 +697,7 @@ msgstr "" #: ../../whatsnew/3.1.rst:553 msgid "" -"The new floating point string representations can break existing doctests. " +"The new floating-point string representations can break existing doctests. " "For example::" msgstr "" diff --git a/whatsnew/3.11.po b/whatsnew/3.11.po index 62774f916b..3faf8f4aaa 100644 --- a/whatsnew/3.11.po +++ b/whatsnew/3.11.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-18 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2023-05-28 18:21+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -4009,8 +4009,9 @@ msgstr "" "於 :issue:`46656`、:issue:`45440` 和 :issue:`46640` 中貢獻。）" #: ../../whatsnew/3.11.rst:2140 +#, fuzzy msgid "" -"Support for `IEEE 754 `_ floating " +"Support for `IEEE 754 `_ floating-" "point numbers. (Contributed by Victor Stinner in :issue:`46917`.)" msgstr "" "對 `IEEE 754 `_ 浮點數的支援（由 " diff --git a/whatsnew/3.2.po b/whatsnew/3.2.po index a6936a0252..684f8b234a 100644 --- a/whatsnew/3.2.po +++ b/whatsnew/3.2.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:20+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1407,7 +1407,7 @@ msgid "" "been relaxed. It is still unsupported (and ill-advised) to have implicit " "mixing in arithmetic expressions such as ``Decimal('1.1') + float('1.1')`` " "because the latter loses information in the process of constructing the " -"binary float. However, since existing floating point value can be converted " +"binary float. However, since existing floating-point value can be converted " "losslessly to either a decimal or rational representation, it makes sense to " "add them to the constructor and to support mixed-type comparisons." msgstr "" diff --git a/whatsnew/3.3.po b/whatsnew/3.3.po index 4dc4ea82bf..dc5f59f128 100644 --- a/whatsnew/3.3.po +++ b/whatsnew/3.3.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 00:04+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:20+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1515,7 +1515,7 @@ msgstr "由 Stefan Krah 編寫的 C 模組和 libmpdec。" #: ../../whatsnew/3.3.rst:1099 msgid "" "The new C version of the decimal module integrates the high speed libmpdec " -"library for arbitrary precision correctly rounded decimal floating point " +"library for arbitrary precision correctly rounded decimal floating-point " "arithmetic. libmpdec conforms to IBM's General Decimal Arithmetic " "Specification." msgstr "" @@ -1524,7 +1524,7 @@ msgstr "" msgid "" "Performance gains range from 10x for database applications to 100x for " "numerically intensive applications. These numbers are expected gains for " -"standard precisions used in decimal floating point arithmetic. Since the " +"standard precisions used in decimal floating-point arithmetic. Since the " "precision is user configurable, the exact figures may vary. For example, in " "integer bignum arithmetic the differences can be significantly higher." msgstr "" diff --git a/whatsnew/3.6.po b/whatsnew/3.6.po index f85fa0b51f..f380ef8255 100644 --- a/whatsnew/3.6.po +++ b/whatsnew/3.6.po @@ -4,7 +4,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-27 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-07-15 18:56+0800\n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" "tw)\n" @@ -329,7 +329,7 @@ msgstr "" msgid "" "The :ref:`string formatting ` language also now has support for " "the ``'_'`` option to signal the use of an underscore for a thousands " -"separator for floating point presentation types and for integer presentation " +"separator for floating-point presentation types and for integer presentation " "type ``'d'``. For integer presentation types ``'b'``, ``'o'``, ``'x'``, and " "``'X'``, underscores will be inserted every 4 digits::" msgstr "" diff --git a/whatsnew/3.7.po b/whatsnew/3.7.po index f53e98b051..60abd1fada 100644 --- a/whatsnew/3.7.po +++ b/whatsnew/3.7.po @@ -4,7 +4,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-14 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: 2018-07-15 18:56+0800\n" "Last-Translator: \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -467,7 +467,7 @@ msgstr "" #: ../../whatsnew/3.7.rst:341 msgid "" "The resolution of clocks in modern systems can exceed the limited precision " -"of a floating point number returned by the :func:`time.time` function and " +"of a floating-point number returned by the :func:`time.time` function and " "its variants. To avoid loss of precision, :pep:`564` adds six new " "\"nanosecond\" variants of the existing timer functions to the :mod:`time` " "module:" diff --git a/whatsnew/3.8.po b/whatsnew/3.8.po index ad8fe18135..fa0fb7888a 100644 --- a/whatsnew/3.8.po +++ b/whatsnew/3.8.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-16 00:03+0000\n" +"POT-Creation-Date: 2024-07-20 00:03+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1475,7 +1475,7 @@ msgstr "statistics" #: ../../whatsnew/3.8.rst:1195 msgid "" -"Added :func:`statistics.fmean` as a faster, floating point variant of :func:" +"Added :func:`statistics.fmean` as a faster, floating-point variant of :func:" "`statistics.mean()`. (Contributed by Raymond Hettinger and Steven D'Aprano " "in :issue:`35904`.)" msgstr "" From eeb59af88c810bdc842c3102901574645f63f5ee Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Sun, 21 Jul 2024 00:05:29 +0000 Subject: [PATCH 03/28] sync with cpython 966eff9c --- library/ast.po | 380 +++++++++++++++--------------- library/email.compat32-message.po | 212 ++++++++--------- library/xml.etree.elementtree.po | 194 +++++++-------- 3 files changed, 393 insertions(+), 393 deletions(-) diff --git a/library/ast.po b/library/ast.po index b9d1641bcf..48644a8ec5 100644 --- a/library/ast.po +++ b/library/ast.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-16 00:03+0000\n" +"POT-Creation-Date: 2024-07-21 00:04+0000\n" "PO-Revision-Date: 2018-05-23 14:38+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -359,7 +359,7 @@ msgid "" msgstr "" "一個 f 字串，包含一系列 :class:`FormattedValue` 和 :class:`Constant` 節點。" -#: ../../library/ast.rst:313 +#: ../../library/ast.rst:311 msgid "" "A list or tuple. ``elts`` holds a list of nodes representing the elements. " "``ctx`` is :class:`Store` if the container is an assignment target (i.e. " @@ -368,11 +368,11 @@ msgstr "" "串列或元組。``elts`` 保存表示元素的節點串列。如果容器是賦值目標（即 ``(x," "y)=something`` ），則 ``ctx`` 是 :class:`Store`，否則是 :class:`Load`。" -#: ../../library/ast.rst:339 +#: ../../library/ast.rst:337 msgid "A set. ``elts`` holds a list of nodes representing the set's elements." msgstr "一個集合。``elts`` 保存表示集合之元素的節點串列。" -#: ../../library/ast.rst:354 +#: ../../library/ast.rst:352 msgid "" "A dictionary. ``keys`` and ``values`` hold lists of nodes representing the " "keys and the values respectively, in matching order (what would be returned " @@ -382,7 +382,7 @@ msgstr "" "節點串列（為呼叫 :code:`dictionary.keys()` 和 :code:`dictionary.values()` 時" "將回傳的內容）。" -#: ../../library/ast.rst:358 +#: ../../library/ast.rst:356 msgid "" "When doing dictionary unpacking using dictionary literals the expression to " "be expanded goes in the ``values`` list, with a ``None`` at the " @@ -391,17 +391,17 @@ msgstr "" "當使用字典文本進行字典解包 (unpack) 時，要擴充的運算式位於 ``values`` 串列" "中，在 ``keys`` 中的相應位置有一個 ``None``。" -#: ../../library/ast.rst:376 +#: ../../library/ast.rst:374 msgid "Variables" msgstr "變數" -#: ../../library/ast.rst:380 +#: ../../library/ast.rst:378 msgid "" "A variable name. ``id`` holds the name as a string, and ``ctx`` is one of " "the following types." msgstr "一個變數名稱。``id`` 將名稱以字串形式保存，且 ``ctx`` 是以下型別之一。" -#: ../../library/ast.rst:388 +#: ../../library/ast.rst:386 msgid "" "Variable references can be used to load the value of a variable, to assign a " "new value to it, or to delete it. Variable references are given a context to " @@ -410,7 +410,7 @@ msgstr "" "變數參照可用於載入變數的值、為其分配新值或刪除它。變數參照被賦予情境 " "(context) 來區分這些情況。" -#: ../../library/ast.rst:421 +#: ../../library/ast.rst:419 msgid "" "A ``*var`` variable reference. ``value`` holds the variable, typically a :" "class:`Name` node. This type must be used when building a :class:`Call` node " @@ -419,11 +419,11 @@ msgstr "" "一個 ``*var`` 變數參照。``value`` 保存變數，通常是一個 :class:`Name` 節點。在" "使用 ``*args`` 建置 :class:`Call` 節點時必須使用此型別。" -#: ../../library/ast.rst:446 +#: ../../library/ast.rst:444 msgid "Expressions" msgstr "運算式" -#: ../../library/ast.rst:450 +#: ../../library/ast.rst:448 msgid "" "When an expression, such as a function call, appears as a statement by " "itself with its return value not used or stored, it is wrapped in this " @@ -436,14 +436,14 @@ msgstr "" "`Constant`、:class:`Name`、:class:`Lambda`、:class:`Yield` 或 :class:" "`YieldFrom`" -#: ../../library/ast.rst:469 +#: ../../library/ast.rst:467 msgid "" "A unary operation. ``op`` is the operator, and ``operand`` any expression " "node." msgstr "" "一元運算 (unary operation)。``op`` 是運算子，``operand`` 是任何運算式節點。" -#: ../../library/ast.rst:478 +#: ../../library/ast.rst:476 msgid "" "Unary operator tokens. :class:`Not` is the ``not`` keyword, :class:`Invert` " "is the ``~`` operator." @@ -451,7 +451,7 @@ msgstr "" "一元運算子標記。 :class:`Not` 是 ``not`` 關鍵字、:class:`Invert` 是 ``~`` 運" "算子。" -#: ../../library/ast.rst:492 +#: ../../library/ast.rst:490 msgid "" "A binary operation (like addition or division). ``op`` is the operator, and " "``left`` and ``right`` are any expression nodes." @@ -459,11 +459,11 @@ msgstr "" "二元運算 (binary operation)（如加法或除法）。 ``op`` 是運算子、``left`` 和 " "``right`` 是任意運算式節點。" -#: ../../library/ast.rst:519 +#: ../../library/ast.rst:517 msgid "Binary operator tokens." msgstr "二元運算子 token。" -#: ../../library/ast.rst:524 +#: ../../library/ast.rst:522 msgid "" "A boolean operation, 'or' or 'and'. ``op`` is :class:`Or` or :class:`And`. " "``values`` are the values involved. Consecutive operations with the same " @@ -474,15 +474,15 @@ msgstr "" "有所涉及的值。使用同一運算子的連續操作（例如 ``a or b or c``\\ ）會被折疊為具" "有多個值的一個節點。" -#: ../../library/ast.rst:529 +#: ../../library/ast.rst:527 msgid "This doesn't include ``not``, which is a :class:`UnaryOp`." msgstr "這不包括 ``not``，它是一個 :class:`UnaryOp`。" -#: ../../library/ast.rst:545 +#: ../../library/ast.rst:543 msgid "Boolean operator tokens." msgstr "布林運算子 token。" -#: ../../library/ast.rst:550 +#: ../../library/ast.rst:548 msgid "" "A comparison of two or more values. ``left`` is the first value in the " "comparison, ``ops`` the list of operators, and ``comparators`` the list of " @@ -491,11 +491,11 @@ msgstr "" "兩個或多個值的比較。``left`` 是比較中的第一個值、``ops`` 是運算子串列、" "``comparators`` 是要比較的第一個元素之後值的串列。" -#: ../../library/ast.rst:579 +#: ../../library/ast.rst:577 msgid "Comparison operator tokens." msgstr "比較運算子 token。" -#: ../../library/ast.rst:584 +#: ../../library/ast.rst:582 msgid "" "A function call. ``func`` is the function, which will often be a :class:" "`Name` or :class:`Attribute` object. Of the arguments:" @@ -503,25 +503,25 @@ msgstr "" "一個函式呼叫。``func`` 是該函式，通常是一個 :class:`Name` 或 :class:" "`Attribute` 物件。而在引數中：" -#: ../../library/ast.rst:587 +#: ../../library/ast.rst:585 msgid "``args`` holds a list of the arguments passed by position." msgstr "``args`` 保存按位置傳遞的引數串列。" -#: ../../library/ast.rst:588 +#: ../../library/ast.rst:586 msgid "" "``keywords`` holds a list of :class:`.keyword` objects representing " "arguments passed by keyword." msgstr "" "``keywords`` 保存一個 :class:`.keyword` 物件串列，表示透過關鍵字傳遞的引數。" -#: ../../library/ast.rst:591 +#: ../../library/ast.rst:589 msgid "" "When creating a ``Call`` node, ``args`` and ``keywords`` are required, but " "they can be empty lists." msgstr "" "建立 ``Call`` 節點時會需要 ``args`` 和 ``keywords``，但它們可以是空串列。" -#: ../../library/ast.rst:615 +#: ../../library/ast.rst:613 msgid "" "A keyword argument to a function call or class definition. ``arg`` is a raw " "string of the parameter name, ``value`` is a node to pass in." @@ -529,7 +529,7 @@ msgstr "" "函式呼叫或類別定義的關鍵字引數。``arg`` 是參數名稱的原始字串，``value`` 是要" "傳入的節點。" -#: ../../library/ast.rst:621 +#: ../../library/ast.rst:619 msgid "" "An expression such as ``a if b else c``. Each field holds a single node, so " "in the following example, all three are :class:`Name` nodes." @@ -537,7 +537,7 @@ msgstr "" "像是 ``a if b else c`` 之類的運算式。每個欄位都保存一個節點，因此在以下範例" "中，所有三個都是 :class:`Name` 節點。" -#: ../../library/ast.rst:636 +#: ../../library/ast.rst:634 msgid "" "Attribute access, e.g. ``d.keys``. ``value`` is a node, typically a :class:" "`Name`. ``attr`` is a bare string giving the name of the attribute, and " @@ -548,7 +548,7 @@ msgstr "" "``attr`` 是一個屬性名稱的字串，``ctx`` 根據屬性的作用方式可能是 :class:" "`Load`、:class:`Store` 或 :class:`Del`。" -#: ../../library/ast.rst:653 +#: ../../library/ast.rst:651 msgid "" "A named expression. This AST node is produced by the assignment expressions " "operator (also known as the walrus operator). As opposed to the :class:" @@ -559,11 +559,11 @@ msgstr "" "運算子）產生。相對於 :class:`Assign` 節點之第一個引數可為多個節點，在這種情況" "下 ``target`` 和 ``value`` 都必須是單個節點。" -#: ../../library/ast.rst:669 +#: ../../library/ast.rst:667 msgid "Subscripting" msgstr "下標 (Subscripting)" -#: ../../library/ast.rst:673 +#: ../../library/ast.rst:671 msgid "" "A subscript, such as ``l[1]``. ``value`` is the subscripted object (usually " "sequence or mapping). ``slice`` is an index, slice or key. It can be a :" @@ -575,7 +575,7 @@ msgstr "" "下標執行的操作不同，``ctx`` 可以是 :class:`Load`、:class:`Store` 或 :class:" "`Del`。" -#: ../../library/ast.rst:697 +#: ../../library/ast.rst:695 msgid "" "Regular slicing (on the form ``lower:upper`` or ``lower:upper:step``). Can " "occur only inside the *slice* field of :class:`Subscript`, either directly " @@ -584,11 +584,11 @@ msgstr "" "常規切片（形式為 ``lower:upper`` 或 ``lower:upper:step``\\ ）。只能直接或者或" "者作為 :class:`Tuple` 的元素出現在 :class:`Subscript` 的 *slice* 欄位內。" -#: ../../library/ast.rst:714 +#: ../../library/ast.rst:712 msgid "Comprehensions" msgstr "綜合運算式 (comprehensions)" -#: ../../library/ast.rst:721 +#: ../../library/ast.rst:719 msgid "" "List and set comprehensions, generator expressions, and dictionary " "comprehensions. ``elt`` (or ``key`` and ``value``) is a single node " @@ -597,11 +597,11 @@ msgstr "" "串列和集合綜合運算、生成器運算式和字典綜合運算。``elt``\\ （或 ``key`` 和 " "``value``\\ ）是單個節點，表示各個項目會被求值 (evaluate) 的部分。" -#: ../../library/ast.rst:725 +#: ../../library/ast.rst:723 msgid "``generators`` is a list of :class:`comprehension` nodes." msgstr "``generators`` 是一個 :class:`comprehension` 節點的串列。" -#: ../../library/ast.rst:767 +#: ../../library/ast.rst:765 msgid "" "One ``for`` clause in a comprehension. ``target`` is the reference to use " "for each element - typically a :class:`Name` or :class:`Tuple` node. " @@ -612,7 +612,7 @@ msgstr "" "class:`Name` 或 :class:`Tuple` 節點。``iter`` 是要疊代的物件。``ifs`` 是測試" "運算式的串列：每個 ``for`` 子句可以有多個 ``ifs``。" -#: ../../library/ast.rst:772 +#: ../../library/ast.rst:770 msgid "" "``is_async`` indicates a comprehension is asynchronous (using an ``async " "for`` instead of ``for``). The value is an integer (0 or 1)." @@ -620,17 +620,17 @@ msgstr "" "``is_async`` 表示綜合運算式是非同步的（使用 ``async for`` 而不是 ``for`` ）。" "該值為整數（0 或 1）。" -#: ../../library/ast.rst:841 +#: ../../library/ast.rst:839 msgid "Statements" msgstr "陳述式" -#: ../../library/ast.rst:845 +#: ../../library/ast.rst:843 msgid "" "An assignment. ``targets`` is a list of nodes, and ``value`` is a single " "node." msgstr "一個賦值。``targets`` 是節點串列，``value`` 是單個節點。" -#: ../../library/ast.rst:847 +#: ../../library/ast.rst:845 msgid "" "Multiple nodes in ``targets`` represents assigning the same value to each. " "Unpacking is represented by putting a :class:`Tuple` or :class:`List` within " @@ -639,13 +639,13 @@ msgstr "" "``targets`` 中的多個節點表示為每個節點分配相同的值。解包是透過在 ``targets`` " "中放置一個 :class:`Tuple` 或 :class:`List` 來表示的。" -#: ../../library/ast.rst:853 ../../library/ast.rst:1165 -#: ../../library/ast.rst:1370 ../../library/ast.rst:1895 +#: ../../library/ast.rst:851 ../../library/ast.rst:1163 +#: ../../library/ast.rst:1368 ../../library/ast.rst:1893 msgid "" "``type_comment`` is an optional string with the type annotation as a comment." msgstr "``type_comment`` 是一個可選字串，其中的註解為型別註釋。" -#: ../../library/ast.rst:883 +#: ../../library/ast.rst:881 msgid "" "An assignment with a type annotation. ``target`` is a single node and can be " "a :class:`Name`, a :class:`Attribute` or a :class:`Subscript`. " @@ -656,7 +656,7 @@ msgstr "" "`Attribute` 或 :class:`Subscript`。``annotation`` 是註釋，例如 :class:" "`Constant` 或 :class:`Name` 節點。``value`` 是單個可選節點。" -#: ../../library/ast.rst:888 +#: ../../library/ast.rst:886 msgid "" "``simple`` is always either 0 (indicating a \"complex\" target) or 1 " "(indicating a \"simple\" target). A \"simple\" target consists solely of a :" @@ -669,7 +669,7 @@ msgstr "" "被視為是複雜的。只有簡單目標會出現在模組和類別的 :attr:`__annotations__` 字典" "中。" -#: ../../library/ast.rst:942 +#: ../../library/ast.rst:940 msgid "" "Augmented assignment, such as ``a += 1``. In the following example, " "``target`` is a :class:`Name` node for ``x`` (with the :class:`Store` " @@ -680,7 +680,7 @@ msgstr "" "是 ``x`` 的 :class:`Name` 節點（帶有 :class:`Store` 情境），``op`` 是 :class:" "`Add`，``value`` 是一個值為 1 的 :class:`Constant`。" -#: ../../library/ast.rst:947 +#: ../../library/ast.rst:945 msgid "" "The ``target`` attribute cannot be of class :class:`Tuple` or :class:`List`, " "unlike the targets of :class:`Assign`." @@ -688,7 +688,7 @@ msgstr "" "與 :class:`Assign` 的目標不同，``target`` 屬性不能屬於 :class:`Tuple` 或 :" "class:`List` 類別。" -#: ../../library/ast.rst:964 +#: ../../library/ast.rst:962 msgid "" "A ``raise`` statement. ``exc`` is the exception object to be raised, " "normally a :class:`Call` or :class:`Name`, or ``None`` for a standalone " @@ -698,7 +698,7 @@ msgstr "" "class:`Name`，若是獨立的 ``raise`` 則為 ``None``。``cause`` 是 ``raise x " "from y`` 中的可選部分 ``y``。" -#: ../../library/ast.rst:981 +#: ../../library/ast.rst:979 msgid "" "An assertion. ``test`` holds the condition, such as a :class:`Compare` node. " "``msg`` holds the failure message." @@ -706,7 +706,7 @@ msgstr "" "一個斷言 (assertion)。``test`` 保存條件，例如 :class:`Compare` 節點。``msg`` " "保存失敗訊息。" -#: ../../library/ast.rst:997 +#: ../../library/ast.rst:995 msgid "" "Represents a ``del`` statement. ``targets`` is a list of nodes, such as :" "class:`Name`, :class:`Attribute` or :class:`Subscript` nodes." @@ -714,11 +714,11 @@ msgstr "" "代表一個 ``del`` 陳述式。``targets`` 是節點串列，例如 :class:`Name`、:class:" "`Attribute` 或 :class:`Subscript` 節點。" -#: ../../library/ast.rst:1015 +#: ../../library/ast.rst:1013 msgid "A ``pass`` statement." msgstr "一個 ``pass`` 陳述式。" -#: ../../library/ast.rst:1028 +#: ../../library/ast.rst:1026 msgid "" "A :ref:`type alias ` created through the :keyword:`type` " "statement. ``name`` is the name of the alias, ``type_params`` is a list of :" @@ -729,21 +729,21 @@ msgstr "" "aliases>`。``name`` 是別名的名稱、``type_params`` 是\\ :ref:`型別參數 (type " "parameter) ` 的串列、``value`` 是型別別名的值。" -#: ../../library/ast.rst:1046 +#: ../../library/ast.rst:1044 msgid "" "Other statements which are only applicable inside functions or loops are " "described in other sections." msgstr "其他僅適用於函式或迴圈內部的陳述式將在其他部分中描述。" -#: ../../library/ast.rst:1050 +#: ../../library/ast.rst:1048 msgid "Imports" msgstr "引入 (imports)" -#: ../../library/ast.rst:1054 +#: ../../library/ast.rst:1052 msgid "An import statement. ``names`` is a list of :class:`alias` nodes." msgstr "一個 import 陳述式。``names`` 是 :class:`alias` 節點的串列。" -#: ../../library/ast.rst:1071 +#: ../../library/ast.rst:1069 msgid "" "Represents ``from x import y``. ``module`` is a raw string of the 'from' " "name, without any leading dots, or ``None`` for statements such as ``from . " @@ -754,7 +754,7 @@ msgstr "" "點 (dot)，或者對於諸如 ``from . import foo`` 之類的陳述式則為 ``None``。" "``level`` 是一個整數，保存相對引入的級別（0 表示絕對引入）。" -#: ../../library/ast.rst:1093 +#: ../../library/ast.rst:1091 msgid "" "Both parameters are raw strings of the names. ``asname`` can be ``None`` if " "the regular name is to be used." @@ -762,17 +762,17 @@ msgstr "" "這兩個參數都是名稱的原始字串。如果要使用常規名稱，``asname`` 可以為 " "``None``。" -#: ../../library/ast.rst:1110 +#: ../../library/ast.rst:1108 msgid "Control flow" msgstr "流程控制" -#: ../../library/ast.rst:1113 +#: ../../library/ast.rst:1111 msgid "" "Optional clauses such as ``else`` are stored as an empty list if they're not " "present." msgstr "諸如 ``else`` 之類的可選子句如果不存在，則將被儲存為空串列。" -#: ../../library/ast.rst:1118 +#: ../../library/ast.rst:1116 msgid "" "An ``if`` statement. ``test`` holds a single node, such as a :class:" "`Compare` node. ``body`` and ``orelse`` each hold a list of nodes." @@ -780,7 +780,7 @@ msgstr "" "一個 ``if`` 陳述式。``test`` 保存單個節點，例如 :class:`Compare` 節點。" "``body`` 和 ``orelse`` 各自保存一個節點串列。" -#: ../../library/ast.rst:1121 +#: ../../library/ast.rst:1119 msgid "" "``elif`` clauses don't have a special representation in the AST, but rather " "appear as extra :class:`If` nodes within the ``orelse`` section of the " @@ -789,7 +789,7 @@ msgstr "" "``elif`` 子句在 AST 中沒有特殊表示，而是在前一個子句的 ``orelse`` 部分中作為" "額外的 :class:`If` 節點出現。" -#: ../../library/ast.rst:1156 +#: ../../library/ast.rst:1154 msgid "" "A ``for`` loop. ``target`` holds the variable(s) the loop assigns to, as a " "single :class:`Name`, :class:`Tuple`, :class:`List`, :class:`Attribute` or :" @@ -804,17 +804,17 @@ msgstr "" "行的節點串列。如果迴圈正常完成，則執行 ``orelse`` 中的內容，而不是透過 " "``break`` 陳述式執行。" -#: ../../library/ast.rst:1191 +#: ../../library/ast.rst:1189 msgid "" "A ``while`` loop. ``test`` holds the condition, such as a :class:`Compare` " "node." msgstr "一個 ``while`` 迴圈。``test`` 保存條件，例如 :class:`Compare` 節點。" -#: ../../library/ast.rst:1218 +#: ../../library/ast.rst:1216 msgid "The ``break`` and ``continue`` statements." msgstr "``break`` 和 ``continue`` 陳述式。" -#: ../../library/ast.rst:1253 +#: ../../library/ast.rst:1251 msgid "" "``try`` blocks. All attributes are list of nodes to execute, except for " "``handlers``, which is a list of :class:`ExceptHandler` nodes." @@ -822,7 +822,7 @@ msgstr "" "``try`` 區塊。除 ``handlers`` 是 :class:`ExceptHandler` 節點的串列外，其他所" "有屬性都是要執行之節點的串列。" -#: ../../library/ast.rst:1299 +#: ../../library/ast.rst:1297 msgid "" "``try`` blocks which are followed by ``except*`` clauses. The attributes are " "the same as for :class:`Try` but the :class:`ExceptHandler` nodes in " @@ -832,7 +832,7 @@ msgstr "" "``handlers`` 中的 :class:`ExceptHandler` 節點被直譯 (interpret) 為 " "``except*`` 區塊而不是 ``except``。" -#: ../../library/ast.rst:1331 +#: ../../library/ast.rst:1329 msgid "" "A single ``except`` clause. ``type`` is the exception type it will match, " "typically a :class:`Name` node (or ``None`` for a catch-all ``except:`` " @@ -844,7 +844,7 @@ msgstr "" "``name`` 是用於保存例外的名稱之原始字串，如果子句沒有 ``as foo`` ，則為 " "``None``。``body`` 是節點串列。" -#: ../../library/ast.rst:1365 +#: ../../library/ast.rst:1363 msgid "" "A ``with`` block. ``items`` is a list of :class:`withitem` nodes " "representing the context managers, and ``body`` is the indented block inside " @@ -853,7 +853,7 @@ msgstr "" "一個 ``with`` 區塊。``items`` 是表示情境管理器的 :class:`withitem` 節點串列，" "``body`` 是情境內的縮進區塊。" -#: ../../library/ast.rst:1375 +#: ../../library/ast.rst:1373 msgid "" "A single context manager in a ``with`` block. ``context_expr`` is the " "context manager, often a :class:`Call` node. ``optional_vars`` is a :class:" @@ -864,11 +864,11 @@ msgstr "" "class:`Call` 節點。``Optional_vars`` 是 ``as foo`` 部分的 :class:`Name`、:" "class:`Tuple` 或 :class:`List`，或者如果不使用則為 ``None`` 。" -#: ../../library/ast.rst:1408 +#: ../../library/ast.rst:1406 msgid "Pattern matching" msgstr "模式匹配 (pattern matching)" -#: ../../library/ast.rst:1413 +#: ../../library/ast.rst:1411 msgid "" "A ``match`` statement. ``subject`` holds the subject of the match (the " "object that is being matched against the cases) and ``cases`` contains an " @@ -877,7 +877,7 @@ msgstr "" "一個 ``match`` 陳述式。``subject`` 保存匹配的主題（與案例匹配的物件），" "``cases`` 包含具有不同案例的 :class:`match_case` 節點的可疊代物件。" -#: ../../library/ast.rst:1421 +#: ../../library/ast.rst:1419 msgid "" "A single case pattern in a ``match`` statement. ``pattern`` contains the " "match pattern that the subject will be matched against. Note that the :class:" @@ -888,13 +888,13 @@ msgstr "" "請注意，為模式生成的 :class:`AST` 節點與為運算式生成的節點不同，即使它們共享" "相同的語法。" -#: ../../library/ast.rst:1426 +#: ../../library/ast.rst:1424 msgid "" "The ``guard`` attribute contains an expression that will be evaluated if the " "pattern matches the subject." msgstr "``guard`` 屬性包含一個運算式，如果模式與主題匹配，則將對該運算式求值。" -#: ../../library/ast.rst:1429 +#: ../../library/ast.rst:1427 msgid "" "``body`` contains a list of nodes to execute if the pattern matches and the " "result of evaluating the guard expression is true." @@ -902,7 +902,7 @@ msgstr "" "``body`` 包含一個節點串列，如果模式匹配並且為防護運算式 (guard expression) 的" "求值 (evaluate) 結果為真，則會執行該節點串列。" -#: ../../library/ast.rst:1474 +#: ../../library/ast.rst:1472 msgid "" "A match literal or value pattern that compares by equality. ``value`` is an " "expression node. Permitted value nodes are restricted as described in the " @@ -912,7 +912,7 @@ msgstr "" "以相等性進行比較的匹配文本或值的模式。``value`` 是一個運算式節點。允許值節點" "受到匹配陳述式文件中所述的限制。如果匹配主題等於求出值，則此模式成功。" -#: ../../library/ast.rst:1503 +#: ../../library/ast.rst:1501 msgid "" "A match literal pattern that compares by identity. ``value`` is the " "singleton to be compared against: ``None``, ``True``, or ``False``. This " @@ -922,7 +922,7 @@ msgstr "" "``True`` 或 ``False`` 進行比較的單例 (singleton)。如果匹配主題是給定的常數，" "則此模式成功。" -#: ../../library/ast.rst:1530 +#: ../../library/ast.rst:1528 msgid "" "A match sequence pattern. ``patterns`` contains the patterns to be matched " "against the subject elements if the subject is a sequence. Matches a " @@ -932,7 +932,7 @@ msgstr "" "匹配序列模式。如果主題是一個序列，``patterns`` 包含與主題元素匹配的模式。如果" "子模式之一是 ``MatchStar`` 節點，則匹配可變長度序列，否則匹配固定長度序列。" -#: ../../library/ast.rst:1563 +#: ../../library/ast.rst:1561 msgid "" "Matches the rest of the sequence in a variable length match sequence " "pattern. If ``name`` is not ``None``, a list containing the remaining " @@ -942,7 +942,7 @@ msgstr "" "以可變長度匹配序列模式匹配序列的其餘部分。如果 ``name`` 不是 ``None``，則如果" "整體序列模式成功，則包含其餘序列元素的串列將綁定到該名稱。" -#: ../../library/ast.rst:1605 +#: ../../library/ast.rst:1603 msgid "" "A match mapping pattern. ``keys`` is a sequence of expression nodes. " "``patterns`` is a corresponding sequence of pattern nodes. ``rest`` is an " @@ -954,7 +954,7 @@ msgstr "" "列。``rest`` 是一個可選名稱，可以指定它來捕獲剩餘的對映元素。允許的鍵運算式受" "到匹配陳述式文件中所述的限制。" -#: ../../library/ast.rst:1611 +#: ../../library/ast.rst:1609 msgid "" "This pattern succeeds if the subject is a mapping, all evaluated key " "expressions are present in the mapping, and the value corresponding to each " @@ -966,7 +966,7 @@ msgstr "" "應的子模式匹配，則此模式成功。如果 ``rest`` 不是 ``None``，則如果整體對映模式" "成功，則包含其餘對映元素的字典將綁定到該名稱。" -#: ../../library/ast.rst:1653 +#: ../../library/ast.rst:1651 msgid "" "A match class pattern. ``cls`` is an expression giving the nominal class to " "be matched. ``patterns`` is a sequence of pattern nodes to be matched " @@ -981,7 +981,7 @@ msgstr "" "``kwd_attrs`` 是要匹配的附加屬性序列（在類別模式中指定為關鍵字引數），" "``kwd_patterns`` 是相應的模式（在類別模式中指定為關鍵字的值）。" -#: ../../library/ast.rst:1660 +#: ../../library/ast.rst:1658 msgid "" "This pattern succeeds if the subject is an instance of the nominated class, " "all positional patterns match the corresponding class-defined attributes, " @@ -990,7 +990,7 @@ msgstr "" "如果主題是指定類別的實例，所有位置模式都與相應的類別定義屬性匹配，並且任何指" "定的關鍵字屬性與其相應模式匹配，則此模式成功。" -#: ../../library/ast.rst:1664 +#: ../../library/ast.rst:1662 msgid "" "Note: classes may define a property that returns self in order to match a " "pattern node against the instance being matched. Several builtin types are " @@ -999,7 +999,7 @@ msgstr "" "注意：類別可以定義一個回傳 self 的特性 (property)，以便將模式節點與正在匹配的" "實例進行匹配。一些內建型別也以這種方式匹配，如同匹配陳述式文件中所述。" -#: ../../library/ast.rst:1719 +#: ../../library/ast.rst:1717 msgid "" "A match \"as-pattern\", capture pattern or wildcard pattern. ``pattern`` " "contains the match pattern that the subject will be matched against. If the " @@ -1010,7 +1010,7 @@ msgstr "" "(wildcard pattern)。``pattern`` 包含主題將與之匹配的匹配模式。如果模式為 " "``None``，則該節點代表捕獲模式（即裸名 (bare name)）並且始終會成功。" -#: ../../library/ast.rst:1724 +#: ../../library/ast.rst:1722 msgid "" "The ``name`` attribute contains the name that will be bound if the pattern " "is successful. If ``name`` is ``None``, ``pattern`` must also be ``None`` " @@ -1019,7 +1019,7 @@ msgstr "" "``name`` 屬性包含模式成功時將綁定的名稱。如果 ``name`` 為 ``None``，則 " "``pattern`` 也必須為 ``None``，並且節點代表通配模式。" -#: ../../library/ast.rst:1762 +#: ../../library/ast.rst:1760 msgid "" "A match \"or-pattern\". An or-pattern matches each of its subpatterns in " "turn to the subject, until one succeeds. The or-pattern is then deemed to " @@ -1031,17 +1031,17 @@ msgstr "" "到成功為止，然後 or 模式就會被認為是成功的。如果沒有一個子模式成功，則 or 模" "式將失敗。 ``patterns`` 屬性包含將與主題進行匹配的匹配模式節點串列。" -#: ../../library/ast.rst:1797 +#: ../../library/ast.rst:1795 msgid "Type parameters" msgstr "型別參數 (type parameters)" -#: ../../library/ast.rst:1799 +#: ../../library/ast.rst:1797 msgid "" ":ref:`Type parameters ` can exist on classes, functions, and " "type aliases." msgstr ":ref:`型別參數 `\\ 可以存在於類別、函式和型別別名上。" -#: ../../library/ast.rst:1804 +#: ../../library/ast.rst:1802 msgid "" "A :class:`typing.TypeVar`. ``name`` is the name of the type variable. " "``bound`` is the bound or constraints, if any. If ``bound`` is a :class:" @@ -1051,39 +1051,39 @@ msgstr "" "存在的）界限 (bound) 或約束 (constraint)。如果 ``bound`` 是一個 :class:" "`Tuple`，它代表約束；否則它代表界限。" -#: ../../library/ast.rst:1829 +#: ../../library/ast.rst:1827 msgid "" "A :class:`typing.ParamSpec`. ``name`` is the name of the parameter " "specification." msgstr "A :class:`typing.ParamSpec`。``name`` 是參數規範的名稱。" -#: ../../library/ast.rst:1854 +#: ../../library/ast.rst:1852 msgid "" "A :class:`typing.TypeVarTuple`. ``name`` is the name of the type variable " "tuple." msgstr "一個 :class:`typing.TypeVarTuple`。``name`` 是型別變數元組的名稱。" -#: ../../library/ast.rst:1879 +#: ../../library/ast.rst:1877 msgid "Function and class definitions" msgstr "函式和類別定義" -#: ../../library/ast.rst:1883 +#: ../../library/ast.rst:1881 msgid "A function definition." msgstr "一個函式定義。" -#: ../../library/ast.rst:1885 +#: ../../library/ast.rst:1883 msgid "``name`` is a raw string of the function name." msgstr "``name`` 是函式名稱的原始字串。" -#: ../../library/ast.rst:1886 +#: ../../library/ast.rst:1884 msgid "``args`` is an :class:`arguments` node." msgstr "``args`` 是一個 :class:`arguments` 節點。" -#: ../../library/ast.rst:1887 +#: ../../library/ast.rst:1885 msgid "``body`` is the list of nodes inside the function." msgstr "``body`` 是函式內節點的串列。" -#: ../../library/ast.rst:1888 +#: ../../library/ast.rst:1886 msgid "" "``decorator_list`` is the list of decorators to be applied, stored outermost " "first (i.e. the first in the list will be applied last)." @@ -1091,20 +1091,20 @@ msgstr "" "``decorator_list`` 是要應用的裝飾器串列，在最外層者會被儲存在首位（即串列中首" "位將會是最後一個被應用的那個）。" -#: ../../library/ast.rst:1890 +#: ../../library/ast.rst:1888 msgid "``returns`` is the return annotation." msgstr "``returns`` 是回傳註釋。" -#: ../../library/ast.rst:1891 ../../library/ast.rst:2068 +#: ../../library/ast.rst:1889 ../../library/ast.rst:2066 msgid "``type_params`` is a list of :ref:`type parameters `." msgstr "``type_params`` 是\\ :ref:`型別參數 `\\ 的串列。" -#: ../../library/ast.rst:1897 ../../library/ast.rst:2097 -#: ../../library/ast.rst:2108 +#: ../../library/ast.rst:1895 ../../library/ast.rst:2095 +#: ../../library/ast.rst:2106 msgid "Added ``type_params``." msgstr "新增了 ``type_params``。" -#: ../../library/ast.rst:1903 +#: ../../library/ast.rst:1901 msgid "" "``lambda`` is a minimal function definition that can be used inside an " "expression. Unlike :class:`FunctionDef`, ``body`` holds a single node." @@ -1112,17 +1112,17 @@ msgstr "" "``lambda`` 是可以在運算式內使用的最小函式定義。與 :class:`FunctionDef` 不同，" "``body`` 保存單個節點。" -#: ../../library/ast.rst:1927 +#: ../../library/ast.rst:1925 msgid "The arguments for a function." msgstr "函式的引數。" -#: ../../library/ast.rst:1929 +#: ../../library/ast.rst:1927 msgid "" "``posonlyargs``, ``args`` and ``kwonlyargs`` are lists of :class:`arg` nodes." msgstr "" "``posonlyargs``、``args`` 和 ``kwonlyargs`` 是 :class:`arg` 節點的串列。" -#: ../../library/ast.rst:1930 +#: ../../library/ast.rst:1928 msgid "" "``vararg`` and ``kwarg`` are single :class:`arg` nodes, referring to the " "``*args, **kwargs`` parameters." @@ -1130,7 +1130,7 @@ msgstr "" "``vararg`` 和 ``kwarg`` 是單個 :class:`arg` 節點，指的是 ``*args, **kwargs`` " "參數。" -#: ../../library/ast.rst:1932 +#: ../../library/ast.rst:1930 msgid "" "``kw_defaults`` is a list of default values for keyword-only arguments. If " "one is ``None``, the corresponding argument is required." @@ -1138,7 +1138,7 @@ msgstr "" "``kw_defaults`` 是僅限關鍵字引數的預設值串列。如果其中某個為 ``None``，則相應" "參數就會是必要的。" -#: ../../library/ast.rst:1934 +#: ../../library/ast.rst:1932 msgid "" "``defaults`` is a list of default values for arguments that can be passed " "positionally. If there are fewer defaults, they correspond to the last n " @@ -1147,7 +1147,7 @@ msgstr "" "``defaults`` 是可以按位置傳遞的引數的預設值串列。如果預設值較少，則它們對應於" "最後 n 個引數。" -#: ../../library/ast.rst:1941 +#: ../../library/ast.rst:1939 msgid "" "A single argument in a list. ``arg`` is a raw string of the argument name; " "``annotation`` is its annotation, such as a :class:`Name` node." @@ -1155,16 +1155,16 @@ msgstr "" "串列中的單個引數。``arg`` 是引數名稱的原始字串，``annotation`` 是它的註釋，例" "如 :class:`Name` 節點。" -#: ../../library/ast.rst:1946 +#: ../../library/ast.rst:1944 msgid "" "``type_comment`` is an optional string with the type annotation as a comment" msgstr "``type_comment`` 是一個可選字串，其註解為型別註釋" -#: ../../library/ast.rst:1991 +#: ../../library/ast.rst:1989 msgid "A ``return`` statement." msgstr "一個 ``return`` 陳述式。" -#: ../../library/ast.rst:2006 +#: ../../library/ast.rst:2004 msgid "" "A ``yield`` or ``yield from`` expression. Because these are expressions, " "they must be wrapped in a :class:`Expr` node if the value sent back is not " @@ -1173,24 +1173,24 @@ msgstr "" "一個 ``yield`` 或 ``yield from`` 運算式。因為這些是運算式，所以如果不使用發送" "回來的值，則必須將它們包裝在 :class:`Expr` 節點中。" -#: ../../library/ast.rst:2031 +#: ../../library/ast.rst:2029 msgid "" "``global`` and ``nonlocal`` statements. ``names`` is a list of raw strings." msgstr "``global`` 和 ``nonlocal`` 陳述式。``names`` 是原始字串的串列。" -#: ../../library/ast.rst:2058 +#: ../../library/ast.rst:2056 msgid "A class definition." msgstr "一個類別定義。" -#: ../../library/ast.rst:2060 +#: ../../library/ast.rst:2058 msgid "``name`` is a raw string for the class name" msgstr "``name`` 是類別名的原始字串" -#: ../../library/ast.rst:2061 +#: ../../library/ast.rst:2059 msgid "``bases`` is a list of nodes for explicitly specified base classes." msgstr "``bases`` 是被顯式指定的基底類別節點串列。" -#: ../../library/ast.rst:2062 +#: ../../library/ast.rst:2060 msgid "" "``keywords`` is a list of :class:`.keyword` nodes, principally for " "'metaclass'. Other keywords will be passed to the metaclass, as per " @@ -1200,27 +1200,27 @@ msgstr "" "別）。如 `PEP-3115 `_ 所述，其他關鍵字將被" "傳遞到 metaclass。" -#: ../../library/ast.rst:2065 +#: ../../library/ast.rst:2063 msgid "" "``body`` is a list of nodes representing the code within the class " "definition." msgstr "``body`` 是表示類別定義中程式碼的節點串列。" -#: ../../library/ast.rst:2067 +#: ../../library/ast.rst:2065 msgid "``decorator_list`` is a list of nodes, as in :class:`FunctionDef`." msgstr "``decorator_list`` 是一個節點串列，如 :class:`FunctionDef` 中所示。" -#: ../../library/ast.rst:2101 +#: ../../library/ast.rst:2099 msgid "Async and await" msgstr "async 和 await" -#: ../../library/ast.rst:2105 +#: ../../library/ast.rst:2103 msgid "" "An ``async def`` function definition. Has the same fields as :class:" "`FunctionDef`." msgstr "一個 ``async def`` 函式定義。與 :class:`FunctionDef` 具有相同的欄位。" -#: ../../library/ast.rst:2114 +#: ../../library/ast.rst:2112 msgid "" "An ``await`` expression. ``value`` is what it waits for. Only valid in the " "body of an :class:`AsyncFunctionDef`." @@ -1228,7 +1228,7 @@ msgstr "" "一個 ``await`` 運算式。``value`` 是它等待的東西。僅在 :class:" "`AsyncFunctionDef` 主體 (body) 中有效。" -#: ../../library/ast.rst:2148 +#: ../../library/ast.rst:2146 msgid "" "``async for`` loops and ``async with`` context managers. They have the same " "fields as :class:`For` and :class:`With`, respectively. Only valid in the " @@ -1237,7 +1237,7 @@ msgstr "" "``async for`` 迴圈和 ``async with`` 情境管理器。它們分別具有與 :class:`For` " "和 :class:`With` 相同的欄位。僅在 :class:`AsyncFunctionDef` 主體中有效。" -#: ../../library/ast.rst:2153 +#: ../../library/ast.rst:2151 msgid "" "When a string is parsed by :func:`ast.parse`, operator nodes (subclasses of :" "class:`ast.operator`, :class:`ast.unaryop`, :class:`ast.cmpop`, :class:`ast." @@ -1250,11 +1250,11 @@ msgstr "" "boolop` 和 :class:`ast.expr_context`\\ ）將是單例。對其中之一的更改將反映在所" "有其他出現的相同值中（例如 :class:`ast.Add`\\ ）。" -#: ../../library/ast.rst:2161 +#: ../../library/ast.rst:2159 msgid ":mod:`ast` Helpers" msgstr ":mod:`ast` 輔助程式" -#: ../../library/ast.rst:2163 +#: ../../library/ast.rst:2161 msgid "" "Apart from the node classes, the :mod:`ast` module defines these utility " "functions and classes for traversing abstract syntax trees:" @@ -1262,7 +1262,7 @@ msgstr "" "除了節點類別之外，:mod:`ast` 模組還定義了這些用於遍歷 (traverse) 抽象語法樹的" "實用函式和類別：" -#: ../../library/ast.rst:2168 +#: ../../library/ast.rst:2166 msgid "" "Parse the source into an AST node. Equivalent to ``compile(source, " "filename, mode, ast.PyCF_ONLY_AST)``." @@ -1270,7 +1270,7 @@ msgstr "" "將原始碼剖析為 AST 節點。相當於 ``compile(source, filename, mode, ast." "PyCF_ONLY_AST)``。" -#: ../../library/ast.rst:2171 +#: ../../library/ast.rst:2169 msgid "" "If ``type_comments=True`` is given, the parser is modified to check and " "return type comments as specified by :pep:`484` and :pep:`526`. This is " @@ -1289,7 +1289,7 @@ msgstr "" "``None``。此外，``# type: ignore`` 註釋的位置將作為 :class:`Module` 的 " "``type_ignores`` 屬性回傳（否則它始終是一個空串列）。" -#: ../../library/ast.rst:2181 +#: ../../library/ast.rst:2179 msgid "" "In addition, if ``mode`` is ``'func_type'``, the input syntax is modified to " "correspond to :pep:`484` \"signature type comments\", e.g. ``(str, int) -> " @@ -1299,7 +1299,7 @@ msgstr "" "名型別註解 (signature type comments)」而被修改，例如 ``(str, int) -> " "List[str]``。" -#: ../../library/ast.rst:2185 +#: ../../library/ast.rst:2183 msgid "" "Setting ``feature_version`` to a tuple ``(major, minor)`` will result in a " "\"best-effort\" attempt to parse using that Python version's grammar. For " @@ -1319,12 +1319,12 @@ msgstr "" "能保證剖析（或剖析的成功）與在與 ``feature_version`` 對應的 Python 版本上運行" "時相同。" -#: ../../library/ast.rst:2195 +#: ../../library/ast.rst:2193 msgid "" "If source contains a null character (``\\0``), :exc:`ValueError` is raised." msgstr "如果來源包含 null 字元 (``\\0``)，則會引發 :exc:`ValueError`。" -#: ../../library/ast.rst:2198 +#: ../../library/ast.rst:2196 msgid "" "Note that successfully parsing source code into an AST object doesn't " "guarantee that the source code provided is valid Python code that can be " @@ -1338,14 +1338,14 @@ msgstr "" "原始的 ``return 42`` 為 return 陳述式生成一個有效的 AST 節點，但它不能單獨編" "譯（它需要位於函式節點內）。" -#: ../../library/ast.rst:2205 +#: ../../library/ast.rst:2203 msgid "" "In particular, :func:`ast.parse` won't do any scoping checks, which the " "compilation step does." msgstr "" "特別是 :func:`ast.parse` 不會執行任何範圍檢查，而編譯步驟才會執行此操作。" -#: ../../library/ast.rst:2209 +#: ../../library/ast.rst:2207 msgid "" "It is possible to crash the Python interpreter with a sufficiently large/" "complex string due to stack depth limitations in Python's AST compiler." @@ -1353,11 +1353,11 @@ msgstr "" "由於 Python AST 編譯器中的堆疊 (stack) 深度限制，太大或太複雜的字串可能會導" "致 Python 直譯器崩潰。" -#: ../../library/ast.rst:2213 +#: ../../library/ast.rst:2211 msgid "Added ``type_comments``, ``mode='func_type'`` and ``feature_version``." msgstr "新增 ``type_comments``、``mode='func_type'`` 與 ``feature_version``。" -#: ../../library/ast.rst:2219 +#: ../../library/ast.rst:2217 msgid "" "Unparse an :class:`ast.AST` object and generate a string with code that " "would produce an equivalent :class:`ast.AST` object if parsed back with :" @@ -1366,7 +1366,7 @@ msgstr "" "反剖析 :class:`ast.AST` 物件並生成一個帶有程式碼的字串，如果使用 :func:`ast." "parse` 剖析回來，該程式碼將生成等效的 :class:`ast.AST` 物件。" -#: ../../library/ast.rst:2224 +#: ../../library/ast.rst:2222 msgid "" "The produced code string will not necessarily be equal to the original code " "that generated the :class:`ast.AST` object (without any compiler " @@ -1375,13 +1375,13 @@ msgstr "" "生成的程式碼字串不一定等於生成 :class:`ast.AST` 物件的原始程式碼（沒有任何編" "譯器最佳化，例如常數元組/凍結集合）。" -#: ../../library/ast.rst:2229 +#: ../../library/ast.rst:2227 msgid "" "Trying to unparse a highly complex expression would result with :exc:" "`RecursionError`." msgstr "嘗試剖析高度複雜的運算式會導致 :exc:`RecursionError`。" -#: ../../library/ast.rst:2237 +#: ../../library/ast.rst:2235 msgid "" "Evaluate an expression node or a string containing only a Python literal or " "container display. The string or node provided may only consist of the " @@ -1392,7 +1392,7 @@ msgstr "" "能包含以下 Python 文本結構：字串、位元組、數字、元組、串列、字典、集合、布林" "值、``None`` 和 ``Ellipsis``。" -#: ../../library/ast.rst:2242 +#: ../../library/ast.rst:2240 msgid "" "This can be used for evaluating strings containing Python values without the " "need to parse the values oneself. It is not capable of evaluating " @@ -1401,7 +1401,7 @@ msgstr "" "這可用於為包含 Python 值的字串求值，而無需自己剖析這些值。它無法計算任意複雜" "的運算式，例如涉及運算子或索引。" -#: ../../library/ast.rst:2247 +#: ../../library/ast.rst:2245 msgid "" "This function had been documented as \"safe\" in the past without defining " "what that meant. That was misleading. This is specifically designed not to " @@ -1418,13 +1418,13 @@ msgstr "" "盡或 C 堆疊耗盡，從而導致行程崩潰。某些輸入也可能會出現 CPU 消耗過多而導致拒" "絕服務的情況。因此不建議在不受信任的資料上呼叫它。" -#: ../../library/ast.rst:2257 +#: ../../library/ast.rst:2255 msgid "" "It is possible to crash the Python interpreter due to stack depth " "limitations in Python's AST compiler." msgstr "由於 Python AST 編譯器的堆疊深度限制，Python 直譯器可能會崩潰。" -#: ../../library/ast.rst:2260 +#: ../../library/ast.rst:2258 msgid "" "It can raise :exc:`ValueError`, :exc:`TypeError`, :exc:`SyntaxError`, :exc:" "`MemoryError` and :exc:`RecursionError` depending on the malformed input." @@ -1432,19 +1432,19 @@ msgstr "" "它可能會引發 :exc:`ValueError`、:exc:`TypeError`、:exc:`SyntaxError`、:exc:" "`MemoryError` 和 :exc:`RecursionError`，具體取決於格式錯誤的輸入。" -#: ../../library/ast.rst:2264 +#: ../../library/ast.rst:2262 msgid "Now allows bytes and set literals." msgstr "現在允許位元組和集合文本 (set literal)。" -#: ../../library/ast.rst:2267 +#: ../../library/ast.rst:2265 msgid "Now supports creating empty sets with ``'set()'``." msgstr "現在支援使用 ``'set()'`` 建立空集合。" -#: ../../library/ast.rst:2270 +#: ../../library/ast.rst:2268 msgid "For string inputs, leading spaces and tabs are now stripped." msgstr "對於字串輸入，前導空格和定位字元 (tab) 現在已被去除。" -#: ../../library/ast.rst:2276 +#: ../../library/ast.rst:2274 msgid "" "Return the docstring of the given *node* (which must be a :class:" "`FunctionDef`, :class:`AsyncFunctionDef`, :class:`ClassDef`, or :class:" @@ -1456,11 +1456,11 @@ msgstr "" "件字串則為 ``None``。如果 *clean* 為 true，則使用 :func:`inspect.cleandoc` 清" "理文件字串的縮排。" -#: ../../library/ast.rst:2282 +#: ../../library/ast.rst:2280 msgid ":class:`AsyncFunctionDef` is now supported." msgstr "目前已支援 :class:`AsyncFunctionDef`。" -#: ../../library/ast.rst:2288 +#: ../../library/ast.rst:2286 msgid "" "Get source code segment of the *source* that generated *node*. If some " "location information (:attr:`~ast.AST.lineno`, :attr:`~ast.AST.end_lineno`, :" @@ -1471,7 +1471,7 @@ msgstr "" "lineno`、:attr:`~ast.AST.end_lineno`、:attr:`~ast.AST.col_offset` 或 :attr:" "`~ast.AST.end_col_offset`\\ ）遺漏，則回傳 ``None``。" -#: ../../library/ast.rst:2292 +#: ../../library/ast.rst:2290 msgid "" "If *padded* is ``True``, the first line of a multi-line statement will be " "padded with spaces to match its original position." @@ -1479,7 +1479,7 @@ msgstr "" "如果 *padded* 為 ``True``，則多列陳述式的第一列將用空格填充 (padded) 以匹配其" "原始位置。" -#: ../../library/ast.rst:2300 +#: ../../library/ast.rst:2298 msgid "" "When you compile a node tree with :func:`compile`, the compiler expects :" "attr:`~ast.AST.lineno` and :attr:`~ast.AST.col_offset` attributes for every " @@ -1493,7 +1493,7 @@ msgstr "" "要存在。填入生成的節點相當繁瑣，因此該輔助工具透過將這些屬性設定為父節點的" "值，在尚未設定的地方遞迴地新增這些屬性。它從 *node* 開始遞迴地作用。" -#: ../../library/ast.rst:2309 +#: ../../library/ast.rst:2307 msgid "" "Increment the line number and end line number of each node in the tree " "starting at *node* by *n*. This is useful to \"move code\" to a different " @@ -1502,7 +1502,7 @@ msgstr "" "將樹中從 *node* 開始的每個節點的列號和結束列號增加 *n*。這對於「移動程式碼」" "到檔案中的不同位置很有用。" -#: ../../library/ast.rst:2316 +#: ../../library/ast.rst:2314 msgid "" "Copy source location (:attr:`~ast.AST.lineno`, :attr:`~ast.AST.col_offset`, :" "attr:`~ast.AST.end_lineno`, and :attr:`~ast.AST.end_col_offset`) from " @@ -1512,7 +1512,7 @@ msgstr "" "attr:`~ast.AST.end_lineno` 和 :attr:`~ast.AST.end_col_offset` ）從 " "*old_node* 複製到 *new_node*，並回傳 *new_node* 。" -#: ../../library/ast.rst:2323 +#: ../../library/ast.rst:2321 msgid "" "Yield a tuple of ``(fieldname, value)`` for each field in ``node._fields`` " "that is present on *node*." @@ -1520,7 +1520,7 @@ msgstr "" "為 *node* 上存在的 ``node._fields`` 中的每個欄位生成一個 ``(fieldname, " "value)`` 元組。" -#: ../../library/ast.rst:2329 +#: ../../library/ast.rst:2327 msgid "" "Yield all direct child nodes of *node*, that is, all fields that are nodes " "and all items of fields that are lists of nodes." @@ -1528,7 +1528,7 @@ msgstr "" "生成 *node* 的所有直接子節點，即作為節點的所有欄位以及作為節點串列欄位的所有" "項目。" -#: ../../library/ast.rst:2335 +#: ../../library/ast.rst:2333 msgid "" "Recursively yield all descendant nodes in the tree starting at *node* " "(including *node* itself), in no specified order. This is useful if you " @@ -1537,7 +1537,7 @@ msgstr "" "遞迴地生成樹中從 *node* 開始的所有後代節點（包括 *node* 本身），不按指定順" "序。如果你只想就地修改節點而不關心情境，這非常有用。" -#: ../../library/ast.rst:2342 +#: ../../library/ast.rst:2340 msgid "" "A node visitor base class that walks the abstract syntax tree and calls a " "visitor function for every node found. This function may return a value " @@ -1546,13 +1546,13 @@ msgstr "" "節點訪問者基底類別，它遍歷抽象語法樹並為找到的每個節點呼叫訪問者函式。該函式" "可能會回傳一個由 :meth:`visit` 方法轉發的值。" -#: ../../library/ast.rst:2346 +#: ../../library/ast.rst:2344 msgid "" "This class is meant to be subclassed, with the subclass adding visitor " "methods." msgstr "這個類別應該被子類別化，子類別新增訪問者方法。" -#: ../../library/ast.rst:2351 +#: ../../library/ast.rst:2349 msgid "" "Visit a node. The default implementation calls the method called :samp:" "`self.visit_{classname}` where *classname* is the name of the node class, " @@ -1562,11 +1562,11 @@ msgstr "" "*classname* 是節點類別的名稱，或者在該方法不存在時呼叫 :meth:" "`generic_visit`。" -#: ../../library/ast.rst:2357 +#: ../../library/ast.rst:2355 msgid "This visitor calls :meth:`visit` on all children of the node." msgstr "該訪問者對該節點的所有子節點呼叫 :meth:`visit`。" -#: ../../library/ast.rst:2359 +#: ../../library/ast.rst:2357 msgid "" "Note that child nodes of nodes that have a custom visitor method won't be " "visited unless the visitor calls :meth:`generic_visit` or visits them itself." @@ -1574,11 +1574,11 @@ msgstr "" "請注意，除非訪問者呼叫 :meth:`generic_visit` 或訪問它們本身，否則不會訪問具有" "自定義訪問者方法的節點之子節點。" -#: ../../library/ast.rst:2365 +#: ../../library/ast.rst:2363 msgid "Handles all constant nodes." msgstr "處理所有常數節點。" -#: ../../library/ast.rst:2367 +#: ../../library/ast.rst:2365 msgid "" "Don't use the :class:`NodeVisitor` if you want to apply changes to nodes " "during traversal. For this a special visitor exists (:class:" @@ -1588,7 +1588,7 @@ msgstr "" "`NodeVisitor`。為此，有個允許修改的特殊遍歷訪問者工具 :class:" "`NodeTransformer`。" -#: ../../library/ast.rst:2373 +#: ../../library/ast.rst:2371 msgid "" "Methods :meth:`!visit_Num`, :meth:`!visit_Str`, :meth:`!visit_Bytes`, :meth:" "`!visit_NameConstant` and :meth:`!visit_Ellipsis` are deprecated now and " @@ -1599,13 +1599,13 @@ msgstr "" "visit_NameConstant` 和 :meth:`!visit_Ellipsis` 方法現已棄用，並且不會在未來的" "Python 版本中被呼叫。新增 :meth:`visit_Constant` 方法來處理所有常數節點。" -#: ../../library/ast.rst:2381 +#: ../../library/ast.rst:2379 msgid "" "A :class:`NodeVisitor` subclass that walks the abstract syntax tree and " "allows modification of nodes." msgstr "一個 :class:`NodeVisitor` 子類別，它會遍歷抽象語法樹並允許修改節點。" -#: ../../library/ast.rst:2384 +#: ../../library/ast.rst:2382 msgid "" "The :class:`NodeTransformer` will walk the AST and use the return value of " "the visitor methods to replace or remove the old node. If the return value " @@ -1617,7 +1617,7 @@ msgstr "" "點。如果訪問者方法的回傳值為 ``None``，則該節點將從其位置中刪除，否則將被替換" "為回傳值。回傳值可能是原始節點，在這種情況下不會發生替換。" -#: ../../library/ast.rst:2390 +#: ../../library/ast.rst:2388 msgid "" "Here is an example transformer that rewrites all occurrences of name lookups " "(``foo``) to ``data['foo']``::" @@ -1625,7 +1625,7 @@ msgstr "" "下面是一個示範用的 transformer，它將查找所有出現名稱 (``foo``) 並改寫為 " "``data['foo']``： ::" -#: ../../library/ast.rst:2402 +#: ../../library/ast.rst:2400 msgid "" "Keep in mind that if the node you're operating on has child nodes you must " "either transform the child nodes yourself or call the :meth:`~ast." @@ -1634,7 +1634,7 @@ msgstr "" "請記住，如果你正在操作的節點有子節點，你必須自己轉換子節點或先呼叫該節點的 :" "meth:`~ast.NodeVisitor.generic_visit` 方法。" -#: ../../library/ast.rst:2406 +#: ../../library/ast.rst:2404 msgid "" "For nodes that were part of a collection of statements (that applies to all " "statement nodes), the visitor may also return a list of nodes rather than " @@ -1643,7 +1643,7 @@ msgstr "" "對於屬於陳述式總集 (collection) 一部分的節點（適用於所有陳述式節點），訪問者" "還可以回傳節點串列，而不僅僅是單個節點。" -#: ../../library/ast.rst:2410 +#: ../../library/ast.rst:2408 msgid "" "If :class:`NodeTransformer` introduces new nodes (that weren't part of " "original tree) without giving them location information (such as :attr:`~ast." @@ -1654,11 +1654,11 @@ msgstr "" "它們提供位置資訊（例如 :attr:`~ast.AST.lineno`\\ ），則應使用新的子樹呼叫 :" "func:`fix_missing_locations` 以重新計算位置資訊： ::" -#: ../../library/ast.rst:2418 +#: ../../library/ast.rst:2416 msgid "Usually you use the transformer like this::" msgstr "你通常會像這樣使用 transformer： ::" -#: ../../library/ast.rst:2425 +#: ../../library/ast.rst:2423 msgid "" "Return a formatted dump of the tree in *node*. This is mainly useful for " "debugging purposes. If *annotate_fields* is true (by default), the returned " @@ -1674,7 +1674,7 @@ msgstr "" "潔。預設情況下，不會傾印列號和行偏移量等屬性。如果需要，可以設定 " "*include_attributes* 為 true。" -#: ../../library/ast.rst:2433 +#: ../../library/ast.rst:2431 msgid "" "If *indent* is a non-negative integer or string, then the tree will be " "pretty-printed with that indent level. An indent level of 0, negative, or " @@ -1688,21 +1688,21 @@ msgstr "" "（預設值）代表選擇單列表示。使用正整數縮排可以在每個級別縮排相同數量的空格。" "如果 *indent* 是一個字串（例如 ``\"\\t\"``\\ ），則該字串用於縮排每個級別。" -#: ../../library/ast.rst:2440 +#: ../../library/ast.rst:2438 msgid "Added the *indent* option." msgstr "新增 *indent* 選項。" -#: ../../library/ast.rst:2447 +#: ../../library/ast.rst:2445 msgid "Compiler Flags" msgstr "編譯器旗標" -#: ../../library/ast.rst:2449 +#: ../../library/ast.rst:2447 msgid "" "The following flags may be passed to :func:`compile` in order to change " "effects on the compilation of a program:" msgstr "可以將以下旗標傳遞給 :func:`compile` 以變更對程式的編譯效果：" -#: ../../library/ast.rst:2454 +#: ../../library/ast.rst:2452 msgid "" "Enables support for top-level ``await``, ``async for``, ``async with`` and " "async comprehensions." @@ -1710,13 +1710,13 @@ msgstr "" "啟用對最高階 ``await``、``async for``、``async with`` 和非同步綜合運算的支" "援。" -#: ../../library/ast.rst:2461 +#: ../../library/ast.rst:2459 msgid "" "Generates and returns an abstract syntax tree instead of returning a " "compiled code object." msgstr "生成並回傳抽象語法樹，而不是回傳已編譯的程式碼物件。" -#: ../../library/ast.rst:2466 +#: ../../library/ast.rst:2464 msgid "" "Enables support for :pep:`484` and :pep:`526` style type comments (``# type: " "``, ``# type: ignore ``)." @@ -1724,43 +1724,43 @@ msgstr "" "啟用對 :pep:`484` 和 :pep:`526` 樣式型別註釋的支援 (``# type: ``, ``# " "type: ignore ``)。" -#: ../../library/ast.rst:2475 +#: ../../library/ast.rst:2473 msgid "Command-Line Usage" msgstr "命令列用法" -#: ../../library/ast.rst:2479 +#: ../../library/ast.rst:2477 msgid "" "The :mod:`ast` module can be executed as a script from the command line. It " "is as simple as:" msgstr ":mod:`ast` 模組可以作為腳本從命令列執行，可以像這樣簡單地做到：" -#: ../../library/ast.rst:2486 +#: ../../library/ast.rst:2484 msgid "The following options are accepted:" msgstr "以下選項可被接受：" -#: ../../library/ast.rst:2492 +#: ../../library/ast.rst:2490 msgid "Show the help message and exit." msgstr "顯示幫助訊息並退出。" -#: ../../library/ast.rst:2497 +#: ../../library/ast.rst:2495 msgid "" "Specify what kind of code must be compiled, like the *mode* argument in :" "func:`parse`." msgstr "指定必須編譯哪種類型的程式碼，像是 :func:`parse` 中的 *mode* 引數。" -#: ../../library/ast.rst:2502 +#: ../../library/ast.rst:2500 msgid "Don't parse type comments." msgstr "不要剖析型別註解。" -#: ../../library/ast.rst:2506 +#: ../../library/ast.rst:2504 msgid "Include attributes such as line numbers and column offsets." msgstr "包括列號和行偏移量等屬性。" -#: ../../library/ast.rst:2511 +#: ../../library/ast.rst:2509 msgid "Indentation of nodes in AST (number of spaces)." msgstr "AST 中節點的縮進（空格數）。" -#: ../../library/ast.rst:2513 +#: ../../library/ast.rst:2511 msgid "" "If :file:`infile` is specified its contents are parsed to AST and dumped to " "stdout. Otherwise, the content is read from stdin." @@ -1768,7 +1768,7 @@ msgstr "" "如果指定了 :file:`infile`，則其內容將被剖析為 AST 並傾印 (dump) 到 stdout。否" "則會從 stdin 讀取內容。" -#: ../../library/ast.rst:2519 +#: ../../library/ast.rst:2517 msgid "" "`Green Tree Snakes `_, an external " "documentation resource, has good details on working with Python ASTs." @@ -1776,7 +1776,7 @@ msgstr "" "`Green Tree Snakes `_ 是一個外部文件" "資源，提供了有關使用 Python AST 的詳細資訊。" -#: ../../library/ast.rst:2522 +#: ../../library/ast.rst:2520 msgid "" "`ASTTokens `_ " "annotates Python ASTs with the positions of tokens and text in the source " @@ -1787,7 +1787,7 @@ msgstr "" "用生成它們的原始碼中的標記和文本的位置來註釋 Python AST。這對於進行原始碼轉換" "的工具很有幫助。" -#: ../../library/ast.rst:2527 +#: ../../library/ast.rst:2525 msgid "" "`leoAst.py `_ unifies the token-based and parse-tree-based views of python programs " @@ -1797,7 +1797,7 @@ msgstr "" "py>`_ 透過在 token 和 ast 節點之間插入雙向鏈結，統一了 python 程式的基於 " "token 和基於剖析樹的視圖。" -#: ../../library/ast.rst:2532 +#: ../../library/ast.rst:2530 msgid "" "`LibCST `_ parses code as a Concrete Syntax " "Tree that looks like an ast tree and keeps all formatting details. It's " @@ -1807,7 +1807,7 @@ msgstr "" "(Concrete Syntax Tree)，看起來像 ast 樹並保留所有格式詳細資訊。它對於建置自動" "重構 (codemod) 應用程式和 linter 非常有用。" -#: ../../library/ast.rst:2537 +#: ../../library/ast.rst:2535 msgid "" "`Parso `_ is a Python parser that supports " "error recovery and round-trip parsing for different Python versions (in " diff --git a/library/email.compat32-message.po b/library/email.compat32-message.po index 80875bfdba..dc2b6d2860 100644 --- a/library/email.compat32-message.po +++ b/library/email.compat32-message.po @@ -5,7 +5,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-10-20 00:03+0000\n" +"POT-Creation-Date: 2024-07-21 00:04+0000\n" "PO-Revision-Date: 2018-07-15 18:56+0800\n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" "tw)\n" @@ -21,7 +21,7 @@ msgid "" "`~email.policy.compat32` API" msgstr "" -#: ../../library/email.compat32-message.rst:12 +#: ../../library/email.compat32-message.rst:13 msgid "" "The :class:`Message` class is very similar to the :class:`~email.message." "EmailMessage` class, without the methods added by that class, and with the " @@ -31,11 +31,11 @@ msgid "" "legacy code." msgstr "" -#: ../../library/email.compat32-message.rst:19 +#: ../../library/email.compat32-message.rst:20 msgid "The philosophy and structure of the two classes is otherwise the same." msgstr "" -#: ../../library/email.compat32-message.rst:21 +#: ../../library/email.compat32-message.rst:22 msgid "" "This document describes the behavior under the default (for :class:" "`Message`) policy :attr:`~email.policy.Compat32`. If you are going to use " @@ -43,7 +43,7 @@ msgid "" "class instead." msgstr "" -#: ../../library/email.compat32-message.rst:25 +#: ../../library/email.compat32-message.rst:26 msgid "" "An email message consists of *headers* and a *payload*. Headers must be :" "rfc:`5322` style names and values, where the field name and value are " @@ -55,7 +55,7 @@ msgid "" "`message/rfc822`." msgstr "" -#: ../../library/email.compat32-message.rst:34 +#: ../../library/email.compat32-message.rst:35 msgid "" "The conceptual model provided by a :class:`Message` object is that of an " "ordered dictionary of headers with additional methods for accessing both " @@ -65,7 +65,7 @@ msgid "" "methods must be used to access them." msgstr "" -#: ../../library/email.compat32-message.rst:41 +#: ../../library/email.compat32-message.rst:42 msgid "" "The :class:`Message` pseudo-dictionary is indexed by the header names, which " "must be ASCII values. The values of the dictionary are strings that are " @@ -79,11 +79,11 @@ msgid "" "mimetype:`multipart/\\*` and :mimetype:`message/rfc822`)." msgstr "" -#: ../../library/email.compat32-message.rst:52 +#: ../../library/email.compat32-message.rst:53 msgid "Here are the methods of the :class:`Message` class:" msgstr "" -#: ../../library/email.compat32-message.rst:57 +#: ../../library/email.compat32-message.rst:58 msgid "" "If *policy* is specified (it must be an instance of a :mod:`~email.policy` " "class) use the rules it specifies to update and serialize the representation " @@ -93,11 +93,11 @@ msgid "" "`~email.policy` documentation." msgstr "" -#: ../../library/email.compat32-message.rst:64 +#: ../../library/email.compat32-message.rst:65 msgid "The *policy* keyword argument was added." msgstr "新增 *policy* 關鍵字引數。" -#: ../../library/email.compat32-message.rst:69 +#: ../../library/email.compat32-message.rst:70 msgid "" "Return the entire message flattened as a string. When optional *unixfrom* " "is true, the envelope header is included in the returned string. *unixfrom* " @@ -110,15 +110,15 @@ msgid "" "*policy* will be passed to the ``Generator``." msgstr "" -#: ../../library/email.compat32-message.rst:79 -#: ../../library/email.compat32-message.rst:121 +#: ../../library/email.compat32-message.rst:80 +#: ../../library/email.compat32-message.rst:122 msgid "" "Flattening the message may trigger changes to the :class:`Message` if " "defaults need to be filled in to complete the transformation to a string " "(for example, MIME boundaries may be generated or modified)." msgstr "" -#: ../../library/email.compat32-message.rst:83 +#: ../../library/email.compat32-message.rst:84 msgid "" "Note that this method is provided as a convenience and may not always format " "the message the way you want. For example, by default it does not do the " @@ -128,7 +128,7 @@ msgid "" "method directly. For example::" msgstr "" -#: ../../library/email.compat32-message.rst:97 +#: ../../library/email.compat32-message.rst:98 msgid "" "If the message object contains binary data that is not encoded according to " "RFC standards, the non-compliant data will be replaced by unicode \"unknown " @@ -136,17 +136,17 @@ msgid "" "generator.BytesGenerator`.)" msgstr "" -#: ../../library/email.compat32-message.rst:102 +#: ../../library/email.compat32-message.rst:103 msgid "the *policy* keyword argument was added." msgstr "新增 *policy* 關鍵字引數。" -#: ../../library/email.compat32-message.rst:107 +#: ../../library/email.compat32-message.rst:108 msgid "" "Equivalent to :meth:`.as_string()`. Allows ``str(msg)`` to produce a string " "containing the formatted message." msgstr "" -#: ../../library/email.compat32-message.rst:113 +#: ../../library/email.compat32-message.rst:114 msgid "" "Return the entire message flattened as a bytes object. When optional " "*unixfrom* is true, the envelope header is included in the returned string. " @@ -156,7 +156,7 @@ msgid "" "specified *policy* will be passed to the ``BytesGenerator``." msgstr "" -#: ../../library/email.compat32-message.rst:125 +#: ../../library/email.compat32-message.rst:126 msgid "" "Note that this method is provided as a convenience and may not always format " "the message the way you want. For example, by default it does not do the " @@ -166,13 +166,13 @@ msgid "" "flatten` method directly. For example::" msgstr "" -#: ../../library/email.compat32-message.rst:145 +#: ../../library/email.compat32-message.rst:146 msgid "" "Equivalent to :meth:`.as_bytes()`. Allows ``bytes(msg)`` to produce a bytes " "object containing the formatted message." msgstr "" -#: ../../library/email.compat32-message.rst:153 +#: ../../library/email.compat32-message.rst:154 msgid "" "Return ``True`` if the message's payload is a list of sub-\\ :class:" "`Message` objects, otherwise return ``False``. When :meth:`is_multipart` " @@ -183,18 +183,18 @@ msgid "" "return ``True`` when the :class:`Message` is of type ``message/rfc822``.)" msgstr "" -#: ../../library/email.compat32-message.rst:165 +#: ../../library/email.compat32-message.rst:166 msgid "" "Set the message's envelope header to *unixfrom*, which should be a string." msgstr "" -#: ../../library/email.compat32-message.rst:170 +#: ../../library/email.compat32-message.rst:171 msgid "" "Return the message's envelope header. Defaults to ``None`` if the envelope " "header was never set." msgstr "" -#: ../../library/email.compat32-message.rst:176 +#: ../../library/email.compat32-message.rst:177 msgid "" "Add the given *payload* to the current payload, which must be ``None`` or a " "list of :class:`Message` objects before the call. After the call, the " @@ -203,14 +203,14 @@ msgid "" "instead." msgstr "" -#: ../../library/email.compat32-message.rst:182 +#: ../../library/email.compat32-message.rst:183 msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " "class its functionality is replaced by :meth:`~email.message.EmailMessage." "set_content` and the related ``make`` and ``add`` methods." msgstr "" -#: ../../library/email.compat32-message.rst:190 +#: ../../library/email.compat32-message.rst:191 msgid "" "Return the current payload, which will be a list of :class:`Message` objects " "when :meth:`is_multipart` is ``True``, or a string when :meth:`is_multipart` " @@ -218,7 +218,7 @@ msgid "" "modify the message's payload in place." msgstr "" -#: ../../library/email.compat32-message.rst:195 +#: ../../library/email.compat32-message.rst:196 msgid "" "With optional argument *i*, :meth:`get_payload` will return the *i*-th " "element of the payload, counting from zero, if :meth:`is_multipart` is " @@ -228,7 +228,7 @@ msgid "" "exc:`TypeError` is raised." msgstr "" -#: ../../library/email.compat32-message.rst:202 +#: ../../library/email.compat32-message.rst:203 msgid "" "Optional *decode* is a flag indicating whether the payload should be decoded " "or not, according to the :mailheader:`Content-Transfer-Encoding` header. " @@ -244,7 +244,7 @@ msgid "" "or :class:`~email.errors.InvalidBase64CharactersDefect`, respectively)." msgstr "" -#: ../../library/email.compat32-message.rst:216 +#: ../../library/email.compat32-message.rst:217 msgid "" "When *decode* is ``False`` (the default) the body is returned as a string " "without decoding the :mailheader:`Content-Transfer-Encoding`. However, for " @@ -255,28 +255,28 @@ msgid "" "the email package, the body is decoded using the default ASCII charset." msgstr "" -#: ../../library/email.compat32-message.rst:225 +#: ../../library/email.compat32-message.rst:226 msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " "class its functionality is replaced by :meth:`~email.message.EmailMessage." "get_content` and :meth:`~email.message.EmailMessage.iter_parts`." msgstr "" -#: ../../library/email.compat32-message.rst:233 +#: ../../library/email.compat32-message.rst:234 msgid "" "Set the entire message object's payload to *payload*. It is the client's " "responsibility to ensure the payload invariants. Optional *charset* sets " "the message's default character set; see :meth:`set_charset` for details." msgstr "" -#: ../../library/email.compat32-message.rst:237 +#: ../../library/email.compat32-message.rst:238 msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " "class its functionality is replaced by :meth:`~email.message.EmailMessage." "set_content`." msgstr "" -#: ../../library/email.compat32-message.rst:244 +#: ../../library/email.compat32-message.rst:245 msgid "" "Set the character set of the payload to *charset*, which can either be a :" "class:`~email.charset.Charset` instance (see :mod:`email.charset`), a string " @@ -287,7 +287,7 @@ msgid "" "Anything else will generate a :exc:`TypeError`." msgstr "" -#: ../../library/email.compat32-message.rst:252 +#: ../../library/email.compat32-message.rst:253 msgid "" "If there is no existing :mailheader:`MIME-Version` header one will be " "added. If there is no existing :mailheader:`Content-Type` header, one will " @@ -304,26 +304,26 @@ msgid "" "not modified." msgstr "" -#: ../../library/email.compat32-message.rst:266 +#: ../../library/email.compat32-message.rst:267 msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " "class its functionality is replaced by the *charset* parameter of the :meth:" "`email.emailmessage.EmailMessage.set_content` method." msgstr "" -#: ../../library/email.compat32-message.rst:274 +#: ../../library/email.compat32-message.rst:275 msgid "" "Return the :class:`~email.charset.Charset` instance associated with the " "message's payload." msgstr "" -#: ../../library/email.compat32-message.rst:277 +#: ../../library/email.compat32-message.rst:278 msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " "class it always returns ``None``." msgstr "" -#: ../../library/email.compat32-message.rst:282 +#: ../../library/email.compat32-message.rst:283 msgid "" "The following methods implement a mapping-like interface for accessing the " "message's :rfc:`2822` headers. Note that there are some semantic " @@ -336,19 +336,19 @@ msgid "" "deleted and then re-added are always appended to the end of the header list." msgstr "" -#: ../../library/email.compat32-message.rst:292 +#: ../../library/email.compat32-message.rst:293 msgid "" "These semantic differences are intentional and are biased toward maximal " "convenience." msgstr "" -#: ../../library/email.compat32-message.rst:295 +#: ../../library/email.compat32-message.rst:296 msgid "" "Note that in all cases, any envelope header present in the message is not " "included in the mapping interface." msgstr "" -#: ../../library/email.compat32-message.rst:298 +#: ../../library/email.compat32-message.rst:299 msgid "" "In a model generated from bytes, any header values that (in contravention of " "the RFCs) contain non-ASCII bytes will, when retrieved through this " @@ -356,25 +356,25 @@ msgid "" "charset of ``unknown-8bit``." msgstr "" -#: ../../library/email.compat32-message.rst:306 +#: ../../library/email.compat32-message.rst:307 msgid "Return the total number of headers, including duplicates." msgstr "" -#: ../../library/email.compat32-message.rst:311 +#: ../../library/email.compat32-message.rst:312 msgid "" "Return ``True`` if the message object has a field named *name*. Matching is " "done case-insensitively and *name* should not include the trailing colon. " "Used for the ``in`` operator, e.g.::" msgstr "" -#: ../../library/email.compat32-message.rst:321 +#: ../../library/email.compat32-message.rst:322 msgid "" "Return the value of the named header field. *name* should not include the " "colon field separator. If the header is missing, ``None`` is returned; a :" "exc:`KeyError` is never raised." msgstr "" -#: ../../library/email.compat32-message.rst:325 +#: ../../library/email.compat32-message.rst:326 msgid "" "Note that if the named field appears more than once in the message's " "headers, exactly which of those field values will be returned is undefined. " @@ -382,59 +382,59 @@ msgid "" "headers." msgstr "" -#: ../../library/email.compat32-message.rst:333 +#: ../../library/email.compat32-message.rst:334 msgid "" "Add a header to the message with field name *name* and value *val*. The " "field is appended to the end of the message's existing fields." msgstr "" -#: ../../library/email.compat32-message.rst:336 +#: ../../library/email.compat32-message.rst:337 msgid "" "Note that this does *not* overwrite or delete any existing header with the " "same name. If you want to ensure that the new header is the only one " "present in the message with field name *name*, delete the field first, e.g.::" msgstr "" -#: ../../library/email.compat32-message.rst:346 +#: ../../library/email.compat32-message.rst:347 msgid "" "Delete all occurrences of the field with name *name* from the message's " "headers. No exception is raised if the named field isn't present in the " "headers." msgstr "" -#: ../../library/email.compat32-message.rst:353 +#: ../../library/email.compat32-message.rst:354 msgid "Return a list of all the message's header field names." msgstr "" -#: ../../library/email.compat32-message.rst:358 +#: ../../library/email.compat32-message.rst:359 msgid "Return a list of all the message's field values." msgstr "" -#: ../../library/email.compat32-message.rst:363 +#: ../../library/email.compat32-message.rst:364 msgid "" "Return a list of 2-tuples containing all the message's field headers and " "values." msgstr "" -#: ../../library/email.compat32-message.rst:369 +#: ../../library/email.compat32-message.rst:370 msgid "" "Return the value of the named header field. This is identical to :meth:" "`~object.__getitem__` except that optional *failobj* is returned if the " "named header is missing (defaults to ``None``)." msgstr "" -#: ../../library/email.compat32-message.rst:373 +#: ../../library/email.compat32-message.rst:374 msgid "Here are some additional useful methods:" msgstr "" -#: ../../library/email.compat32-message.rst:378 +#: ../../library/email.compat32-message.rst:379 msgid "" "Return a list of all the values for the field named *name*. If there are no " "such named headers in the message, *failobj* is returned (defaults to " "``None``)." msgstr "" -#: ../../library/email.compat32-message.rst:385 +#: ../../library/email.compat32-message.rst:386 msgid "" "Extended header setting. This method is similar to :meth:`__setitem__` " "except that additional header parameters can be provided as keyword " @@ -442,7 +442,7 @@ msgid "" "value for the header." msgstr "" -#: ../../library/email.compat32-message.rst:390 +#: ../../library/email.compat32-message.rst:391 msgid "" "For each item in the keyword argument dictionary *_params*, the key is taken " "as the parameter name, with underscores converted to dashes (since dashes " @@ -459,30 +459,30 @@ msgid "" "``None``." msgstr "" -#: ../../library/email.compat32-message.rst:404 +#: ../../library/email.compat32-message.rst:405 msgid "Here's an example::" msgstr "以下是個範例： ::" -#: ../../library/email.compat32-message.rst:408 +#: ../../library/email.compat32-message.rst:409 msgid "This will add a header that looks like ::" msgstr "" -#: ../../library/email.compat32-message.rst:412 +#: ../../library/email.compat32-message.rst:413 msgid "An example with non-ASCII characters::" msgstr "" -#: ../../library/email.compat32-message.rst:417 +#: ../../library/email.compat32-message.rst:418 msgid "Which produces ::" msgstr "" -#: ../../library/email.compat32-message.rst:424 +#: ../../library/email.compat32-message.rst:425 msgid "" "Replace a header. Replace the first header found in the message that " "matches *_name*, retaining header order and field name case. If no matching " "header was found, a :exc:`KeyError` is raised." msgstr "" -#: ../../library/email.compat32-message.rst:431 +#: ../../library/email.compat32-message.rst:432 msgid "" "Return the message's content type. The returned string is coerced to lower " "case of the form :mimetype:`maintype/subtype`. If there was no :mailheader:" @@ -492,7 +492,7 @@ msgid "" "return a value." msgstr "" -#: ../../library/email.compat32-message.rst:438 +#: ../../library/email.compat32-message.rst:439 msgid "" ":rfc:`2045` defines a message's default type to be :mimetype:`text/plain` " "unless it appears inside a :mimetype:`multipart/digest` container, in which " @@ -501,19 +501,19 @@ msgid "" "the default type be :mimetype:`text/plain`." msgstr "" -#: ../../library/email.compat32-message.rst:447 +#: ../../library/email.compat32-message.rst:448 msgid "" "Return the message's main content type. This is the :mimetype:`maintype` " "part of the string returned by :meth:`get_content_type`." msgstr "" -#: ../../library/email.compat32-message.rst:453 +#: ../../library/email.compat32-message.rst:454 msgid "" "Return the message's sub-content type. This is the :mimetype:`subtype` part " "of the string returned by :meth:`get_content_type`." msgstr "" -#: ../../library/email.compat32-message.rst:459 +#: ../../library/email.compat32-message.rst:460 msgid "" "Return the default content type. Most messages have a default content type " "of :mimetype:`text/plain`, except for messages that are subparts of :" @@ -521,14 +521,14 @@ msgid "" "content type of :mimetype:`message/rfc822`." msgstr "" -#: ../../library/email.compat32-message.rst:467 +#: ../../library/email.compat32-message.rst:468 msgid "" "Set the default content type. *ctype* should either be :mimetype:`text/" "plain` or :mimetype:`message/rfc822`, although this is not enforced. The " "default content type is not stored in the :mailheader:`Content-Type` header." msgstr "" -#: ../../library/email.compat32-message.rst:475 +#: ../../library/email.compat32-message.rst:476 msgid "" "Return the message's :mailheader:`Content-Type` parameters, as a list. The " "elements of the returned list are 2-tuples of key/value pairs, as split on " @@ -538,22 +538,22 @@ msgid "" "`get_param` and is unquoted if optional *unquote* is ``True`` (the default)." msgstr "" -#: ../../library/email.compat32-message.rst:483 +#: ../../library/email.compat32-message.rst:484 msgid "" "Optional *failobj* is the object to return if there is no :mailheader:" "`Content-Type` header. Optional *header* is the header to search instead " "of :mailheader:`Content-Type`." msgstr "" -#: ../../library/email.compat32-message.rst:487 -#: ../../library/email.compat32-message.rst:525 +#: ../../library/email.compat32-message.rst:488 +#: ../../library/email.compat32-message.rst:526 msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " "class its functionality is replaced by the *params* property of the " "individual header objects returned by the header access methods." msgstr "" -#: ../../library/email.compat32-message.rst:495 +#: ../../library/email.compat32-message.rst:496 msgid "" "Return the value of the :mailheader:`Content-Type` header's parameter " "*param* as a string. If the message has no :mailheader:`Content-Type` " @@ -561,13 +561,13 @@ msgid "" "(defaults to ``None``)." msgstr "" -#: ../../library/email.compat32-message.rst:500 +#: ../../library/email.compat32-message.rst:501 msgid "" "Optional *header* if given, specifies the message header to use instead of :" "mailheader:`Content-Type`." msgstr "" -#: ../../library/email.compat32-message.rst:503 +#: ../../library/email.compat32-message.rst:504 msgid "" "Parameter keys are always compared case insensitively. The return value can " "either be a string, or a 3-tuple if the parameter was :rfc:`2231` encoded. " @@ -577,7 +577,7 @@ msgid "" "``us-ascii`` charset. You can usually ignore ``LANGUAGE``." msgstr "" -#: ../../library/email.compat32-message.rst:511 +#: ../../library/email.compat32-message.rst:512 msgid "" "If your application doesn't care whether the parameter was encoded as in :" "rfc:`2231`, you can collapse the parameter value by calling :func:`email." @@ -586,14 +586,14 @@ msgid "" "value is a tuple, or the original string unquoted if it isn't. For example::" msgstr "" -#: ../../library/email.compat32-message.rst:521 +#: ../../library/email.compat32-message.rst:522 msgid "" "In any case, the parameter value (either the returned string, or the " "``VALUE`` item in the 3-tuple) is always unquoted, unless *unquote* is set " "to ``False``." msgstr "" -#: ../../library/email.compat32-message.rst:534 +#: ../../library/email.compat32-message.rst:535 msgid "" "Set a parameter in the :mailheader:`Content-Type` header. If the parameter " "already exists in the header, its value will be replaced with *value*. If " @@ -602,14 +602,14 @@ msgid "" "value will be appended as per :rfc:`2045`." msgstr "" -#: ../../library/email.compat32-message.rst:540 +#: ../../library/email.compat32-message.rst:541 msgid "" "Optional *header* specifies an alternative header to :mailheader:`Content-" "Type`, and all parameters will be quoted as necessary unless optional " "*requote* is ``False`` (the default is ``True``)." msgstr "" -#: ../../library/email.compat32-message.rst:544 +#: ../../library/email.compat32-message.rst:545 msgid "" "If optional *charset* is specified, the parameter will be encoded according " "to :rfc:`2231`. Optional *language* specifies the RFC 2231 language, " @@ -617,18 +617,18 @@ msgid "" "strings." msgstr "" -#: ../../library/email.compat32-message.rst:549 +#: ../../library/email.compat32-message.rst:550 msgid "" "If *replace* is ``False`` (the default) the header is moved to the end of " "the list of headers. If *replace* is ``True``, the header will be updated " "in place." msgstr "" -#: ../../library/email.compat32-message.rst:553 +#: ../../library/email.compat32-message.rst:554 msgid "``replace`` keyword was added." msgstr "" -#: ../../library/email.compat32-message.rst:558 +#: ../../library/email.compat32-message.rst:559 msgid "" "Remove the given parameter completely from the :mailheader:`Content-Type` " "header. The header will be re-written in place without the parameter or its " @@ -637,14 +637,14 @@ msgid "" "mailheader:`Content-Type`." msgstr "" -#: ../../library/email.compat32-message.rst:567 +#: ../../library/email.compat32-message.rst:568 msgid "" "Set the main type and subtype for the :mailheader:`Content-Type` header. " "*type* must be a string in the form :mimetype:`maintype/subtype`, otherwise " "a :exc:`ValueError` is raised." msgstr "" -#: ../../library/email.compat32-message.rst:571 +#: ../../library/email.compat32-message.rst:572 msgid "" "This method replaces the :mailheader:`Content-Type` header, keeping all the " "parameters in place. If *requote* is ``False``, this leaves the existing " @@ -652,20 +652,20 @@ msgid "" "default)." msgstr "" -#: ../../library/email.compat32-message.rst:576 +#: ../../library/email.compat32-message.rst:577 msgid "" "An alternative header can be specified in the *header* argument. When the :" "mailheader:`Content-Type` header is set a :mailheader:`MIME-Version` header " "is also added." msgstr "" -#: ../../library/email.compat32-message.rst:580 +#: ../../library/email.compat32-message.rst:581 msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " "class its functionality is replaced by the ``make_`` and ``add_`` methods." msgstr "" -#: ../../library/email.compat32-message.rst:587 +#: ../../library/email.compat32-message.rst:588 msgid "" "Return the value of the ``filename`` parameter of the :mailheader:`Content-" "Disposition` header of the message. If the header does not have a " @@ -675,7 +675,7 @@ msgid "" "always be unquoted as per :func:`email.utils.unquote`." msgstr "" -#: ../../library/email.compat32-message.rst:598 +#: ../../library/email.compat32-message.rst:599 msgid "" "Return the value of the ``boundary`` parameter of the :mailheader:`Content-" "Type` header of the message, or *failobj* if either the header is missing, " @@ -683,7 +683,7 @@ msgid "" "unquoted as per :func:`email.utils.unquote`." msgstr "" -#: ../../library/email.compat32-message.rst:606 +#: ../../library/email.compat32-message.rst:607 msgid "" "Set the ``boundary`` parameter of the :mailheader:`Content-Type` header to " "*boundary*. :meth:`set_boundary` will always quote *boundary* if " @@ -691,7 +691,7 @@ msgid "" "object has no :mailheader:`Content-Type` header." msgstr "" -#: ../../library/email.compat32-message.rst:611 +#: ../../library/email.compat32-message.rst:612 msgid "" "Note that using this method is subtly different than deleting the old :" "mailheader:`Content-Type` header and adding a new one with the new boundary " @@ -701,28 +701,28 @@ msgid "" "the original :mailheader:`Content-Type` header." msgstr "" -#: ../../library/email.compat32-message.rst:621 +#: ../../library/email.compat32-message.rst:622 msgid "" "Return the ``charset`` parameter of the :mailheader:`Content-Type` header, " "coerced to lower case. If there is no :mailheader:`Content-Type` header, or " "if that header has no ``charset`` parameter, *failobj* is returned." msgstr "" -#: ../../library/email.compat32-message.rst:625 +#: ../../library/email.compat32-message.rst:626 msgid "" "Note that this method differs from :meth:`get_charset` which returns the :" "class:`~email.charset.Charset` instance for the default encoding of the " "message body." msgstr "" -#: ../../library/email.compat32-message.rst:631 +#: ../../library/email.compat32-message.rst:632 msgid "" "Return a list containing the character set names in the message. If the " "message is a :mimetype:`multipart`, then the list will contain one element " "for each subpart in the payload, otherwise, it will be a list of length 1." msgstr "" -#: ../../library/email.compat32-message.rst:635 +#: ../../library/email.compat32-message.rst:636 msgid "" "Each item in the list will be a string which is the value of the ``charset`` " "parameter in the :mailheader:`Content-Type` header for the represented " @@ -731,7 +731,7 @@ msgid "" "then that item in the returned list will be *failobj*." msgstr "" -#: ../../library/email.compat32-message.rst:645 +#: ../../library/email.compat32-message.rst:646 msgid "" "Return the lowercased value (without parameters) of the message's :" "mailheader:`Content-Disposition` header if it has one, or ``None``. The " @@ -739,7 +739,7 @@ msgid "" "the message follows :rfc:`2183`." msgstr "" -#: ../../library/email.compat32-message.rst:654 +#: ../../library/email.compat32-message.rst:655 msgid "" "The :meth:`walk` method is an all-purpose generator which can be used to " "iterate over all the parts and subparts of a message object tree, in depth-" @@ -747,13 +747,13 @@ msgid "" "in a ``for`` loop; each iteration returns the next subpart." msgstr "" -#: ../../library/email.compat32-message.rst:659 +#: ../../library/email.compat32-message.rst:660 msgid "" "Here's an example that prints the MIME type of every part of a multipart " "message structure:" msgstr "" -#: ../../library/email.compat32-message.rst:685 +#: ../../library/email.compat32-message.rst:686 msgid "" "``walk`` iterates over the subparts of any part where :meth:`is_multipart` " "returns ``True``, even though ``msg.get_content_maintype() == 'multipart'`` " @@ -761,21 +761,21 @@ msgid "" "``_structure`` debug helper function:" msgstr "" -#: ../../library/email.compat32-message.rst:712 +#: ../../library/email.compat32-message.rst:713 msgid "" "Here the ``message`` parts are not ``multiparts``, but they do contain " "subparts. ``is_multipart()`` returns ``True`` and ``walk`` descends into the " "subparts." msgstr "" -#: ../../library/email.compat32-message.rst:717 +#: ../../library/email.compat32-message.rst:718 msgid "" ":class:`Message` objects can also optionally contain two instance " "attributes, which can be used when generating the plain text of a MIME " "message." msgstr "" -#: ../../library/email.compat32-message.rst:723 +#: ../../library/email.compat32-message.rst:724 msgid "" "The format of a MIME document allows for some text between the blank line " "following the headers, and the first multipart boundary string. Normally, " @@ -785,7 +785,7 @@ msgid "" "can become visible." msgstr "" -#: ../../library/email.compat32-message.rst:730 +#: ../../library/email.compat32-message.rst:731 msgid "" "The *preamble* attribute contains this leading extra-armor text for MIME " "documents. When the :class:`~email.parser.Parser` discovers some text after " @@ -797,26 +797,26 @@ msgid "" "parser` and :mod:`email.generator` for details." msgstr "" -#: ../../library/email.compat32-message.rst:740 +#: ../../library/email.compat32-message.rst:741 msgid "" "Note that if the message object has no preamble, the *preamble* attribute " "will be ``None``." msgstr "" -#: ../../library/email.compat32-message.rst:746 +#: ../../library/email.compat32-message.rst:747 msgid "" "The *epilogue* attribute acts the same way as the *preamble* attribute, " "except that it contains text that appears between the last boundary and the " "end of the message." msgstr "" -#: ../../library/email.compat32-message.rst:750 +#: ../../library/email.compat32-message.rst:751 msgid "" "You do not need to set the epilogue to the empty string in order for the :" "class:`~email.generator.Generator` to print a newline at the end of the file." msgstr "" -#: ../../library/email.compat32-message.rst:757 +#: ../../library/email.compat32-message.rst:758 msgid "" "The *defects* attribute contains a list of all the problems found when " "parsing this message. See :mod:`email.errors` for a detailed description of " diff --git a/library/xml.etree.elementtree.po b/library/xml.etree.elementtree.po index 9d460925a9..866ac71811 100644 --- a/library/xml.etree.elementtree.po +++ b/library/xml.etree.elementtree.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-12 00:03+0000\n" +"POT-Creation-Date: 2024-07-21 00:04+0000\n" "PO-Revision-Date: 2018-05-23 16:16+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -677,7 +677,7 @@ msgid "" msgstr "" #: ../../library/xml.etree.elementtree.rst:647 -#: ../../library/xml.etree.elementtree.rst:1515 +#: ../../library/xml.etree.elementtree.rst:1516 msgid "If you need a fully populated element, look for \"end\" events instead." msgstr "" @@ -686,7 +686,7 @@ msgid "The *parser* argument." msgstr "*parser* 引數。" #: ../../library/xml.etree.elementtree.rst:652 -#: ../../library/xml.etree.elementtree.rst:1519 +#: ../../library/xml.etree.elementtree.rst:1520 msgid "The ``comment`` and ``pi`` events were added." msgstr "新增 *context* 與 *check_hostname* 事件。" @@ -752,7 +752,7 @@ msgstr "" #: ../../library/xml.etree.elementtree.rst:713 #: ../../library/xml.etree.elementtree.rst:740 -#: ../../library/xml.etree.elementtree.rst:1192 +#: ../../library/xml.etree.elementtree.rst:1193 msgid "Added the *short_empty_elements* parameter." msgstr "新增 *short_empty_elements* 參數。" @@ -892,13 +892,13 @@ msgstr "新增 *base_url* 與 *max_depth* 參數。" msgid "Element Objects" msgstr "Element 物件" -#: ../../library/xml.etree.elementtree.rst:875 +#: ../../library/xml.etree.elementtree.rst:876 msgid "" "Element class. This class defines the Element interface, and provides a " "reference implementation of this interface." msgstr "" -#: ../../library/xml.etree.elementtree.rst:878 +#: ../../library/xml.etree.elementtree.rst:879 msgid "" "The element name, attribute names, and attribute values can be either " "bytestrings or Unicode strings. *tag* is the element name. *attrib* is an " @@ -906,13 +906,13 @@ msgid "" "additional attributes, given as keyword arguments." msgstr "" -#: ../../library/xml.etree.elementtree.rst:886 +#: ../../library/xml.etree.elementtree.rst:887 msgid "" "A string identifying what kind of data this element represents (the element " "type, in other words)." msgstr "" -#: ../../library/xml.etree.elementtree.rst:893 +#: ../../library/xml.etree.elementtree.rst:894 msgid "" "These attributes can be used to hold additional data associated with the " "element. Their values are usually strings but may be any application-" @@ -923,7 +923,7 @@ msgid "" "the XML data" msgstr "" -#: ../../library/xml.etree.elementtree.rst:905 +#: ../../library/xml.etree.elementtree.rst:906 msgid "" "the *a* element has ``None`` for both *text* and *tail* attributes, the *b* " "element has *text* ``\"1\"`` and *tail* ``\"4\"``, the *c* element has " @@ -931,17 +931,17 @@ msgid "" "``None`` and *tail* ``\"3\"``." msgstr "" -#: ../../library/xml.etree.elementtree.rst:910 +#: ../../library/xml.etree.elementtree.rst:911 msgid "" "To collect the inner text of an element, see :meth:`itertext`, for example " "``\"\".join(element.itertext())``." msgstr "" -#: ../../library/xml.etree.elementtree.rst:913 +#: ../../library/xml.etree.elementtree.rst:914 msgid "Applications may store arbitrary objects in these attributes." msgstr "" -#: ../../library/xml.etree.elementtree.rst:918 +#: ../../library/xml.etree.elementtree.rst:919 msgid "" "A dictionary containing the element's attributes. Note that while the " "*attrib* value is always a real mutable Python dictionary, an ElementTree " @@ -950,59 +950,59 @@ msgid "" "implementations, use the dictionary methods below whenever possible." msgstr "" -#: ../../library/xml.etree.elementtree.rst:924 +#: ../../library/xml.etree.elementtree.rst:925 msgid "The following dictionary-like methods work on the element attributes." msgstr "" -#: ../../library/xml.etree.elementtree.rst:929 +#: ../../library/xml.etree.elementtree.rst:930 msgid "" "Resets an element. This function removes all subelements, clears all " "attributes, and sets the text and tail attributes to ``None``." msgstr "" -#: ../../library/xml.etree.elementtree.rst:935 +#: ../../library/xml.etree.elementtree.rst:936 msgid "Gets the element attribute named *key*." msgstr "" -#: ../../library/xml.etree.elementtree.rst:937 +#: ../../library/xml.etree.elementtree.rst:938 msgid "" "Returns the attribute value, or *default* if the attribute was not found." msgstr "" -#: ../../library/xml.etree.elementtree.rst:942 +#: ../../library/xml.etree.elementtree.rst:943 msgid "" "Returns the element attributes as a sequence of (name, value) pairs. The " "attributes are returned in an arbitrary order." msgstr "" -#: ../../library/xml.etree.elementtree.rst:948 +#: ../../library/xml.etree.elementtree.rst:949 msgid "" "Returns the elements attribute names as a list. The names are returned in " "an arbitrary order." msgstr "" -#: ../../library/xml.etree.elementtree.rst:954 +#: ../../library/xml.etree.elementtree.rst:955 msgid "Set the attribute *key* on the element to *value*." msgstr "" -#: ../../library/xml.etree.elementtree.rst:956 +#: ../../library/xml.etree.elementtree.rst:957 msgid "The following methods work on the element's children (subelements)." msgstr "" -#: ../../library/xml.etree.elementtree.rst:961 +#: ../../library/xml.etree.elementtree.rst:962 msgid "" "Adds the element *subelement* to the end of this element's internal list of " "subelements. Raises :exc:`TypeError` if *subelement* is not an :class:" "`Element`." msgstr "" -#: ../../library/xml.etree.elementtree.rst:968 +#: ../../library/xml.etree.elementtree.rst:969 msgid "" "Appends *subelements* from a sequence object with zero or more elements. " "Raises :exc:`TypeError` if a subelement is not an :class:`Element`." msgstr "" -#: ../../library/xml.etree.elementtree.rst:976 +#: ../../library/xml.etree.elementtree.rst:977 msgid "" "Finds the first subelement matching *match*. *match* may be a tag name or " "a :ref:`path `. Returns an element instance or " @@ -1011,7 +1011,7 @@ msgid "" "expression into the given namespace." msgstr "" -#: ../../library/xml.etree.elementtree.rst:985 +#: ../../library/xml.etree.elementtree.rst:986 msgid "" "Finds all matching subelements, by tag name or :ref:`path `. Returns a list containing all matching elements in document " @@ -1020,7 +1020,7 @@ msgid "" "expression into the given namespace." msgstr "" -#: ../../library/xml.etree.elementtree.rst:994 +#: ../../library/xml.etree.elementtree.rst:995 msgid "" "Finds text for the first subelement matching *match*. *match* may be a tag " "name or a :ref:`path `. Returns the text content of the " @@ -1031,13 +1031,13 @@ msgid "" "into the given namespace." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1005 +#: ../../library/xml.etree.elementtree.rst:1006 msgid "" "Inserts *subelement* at the given position in this element. Raises :exc:" "`TypeError` if *subelement* is not an :class:`Element`." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1011 +#: ../../library/xml.etree.elementtree.rst:1012 msgid "" "Creates a tree :term:`iterator` with the current element as the root. The " "iterator iterates over this element and all elements below it, in document " @@ -1046,7 +1046,7 @@ msgid "" "structure is modified during iteration, the result is undefined." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1022 +#: ../../library/xml.etree.elementtree.rst:1023 msgid "" "Finds all matching subelements, by tag name or :ref:`path `. Returns an iterable yielding all matching elements in document " @@ -1054,44 +1054,44 @@ msgid "" "name." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1033 +#: ../../library/xml.etree.elementtree.rst:1034 msgid "" "Creates a text iterator. The iterator loops over this element and all " "subelements, in document order, and returns all inner text." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1041 +#: ../../library/xml.etree.elementtree.rst:1042 msgid "" "Creates a new element object of the same type as this element. Do not call " "this method, use the :func:`SubElement` factory function instead." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1047 +#: ../../library/xml.etree.elementtree.rst:1048 msgid "" "Removes *subelement* from the element. Unlike the find\\* methods this " "method compares elements based on the instance identity, not on tag value or " "contents." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1051 +#: ../../library/xml.etree.elementtree.rst:1052 msgid "" ":class:`Element` objects also support the following sequence type methods " "for working with subelements: :meth:`~object.__delitem__`, :meth:`~object." "__getitem__`, :meth:`~object.__setitem__`, :meth:`~object.__len__`." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1056 +#: ../../library/xml.etree.elementtree.rst:1057 msgid "" "Caution: Elements with no subelements will test as ``False``. Testing the " "truth value of an Element is deprecated and will raise an exception in " "Python 3.14. Use specific ``len(elem)`` or ``elem is None`` test instead.::" msgstr "" -#: ../../library/xml.etree.elementtree.rst:1068 +#: ../../library/xml.etree.elementtree.rst:1069 msgid "Testing the truth value of an Element emits :exc:`DeprecationWarning`." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1071 +#: ../../library/xml.etree.elementtree.rst:1072 msgid "" "Prior to Python 3.8, the serialisation order of the XML attributes of " "elements was artificially made predictable by sorting the attributes by " @@ -1100,7 +1100,7 @@ msgid "" "attributes were originally parsed or created by user code." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1077 +#: ../../library/xml.etree.elementtree.rst:1078 msgid "" "In general, user code should try not to depend on a specific ordering of " "attributes, given that the `XML Information Set `_ writer. Arguments are the " "same as for the :func:`canonicalize` function. This class does not build a " @@ -1336,11 +1336,11 @@ msgid "" "using the *write* function." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1356 +#: ../../library/xml.etree.elementtree.rst:1357 msgid "XMLParser Objects" msgstr "XMLParser 物件" -#: ../../library/xml.etree.elementtree.rst:1361 +#: ../../library/xml.etree.elementtree.rst:1362 msgid "" "This class is the low-level building block of the module. It uses :mod:`xml." "parsers.expat` for efficient, event-based parsing of XML. It can be fed XML " @@ -1351,25 +1351,25 @@ msgid "" "XML file." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1369 +#: ../../library/xml.etree.elementtree.rst:1370 msgid "" "Parameters are now :ref:`keyword-only `. The *html* " "argument no longer supported." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1376 +#: ../../library/xml.etree.elementtree.rst:1377 msgid "" "Finishes feeding data to the parser. Returns the result of calling the " "``close()`` method of the *target* passed during construction; by default, " "this is the toplevel document element." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1383 +#: ../../library/xml.etree.elementtree.rst:1384 msgid "Feeds data to the parser. *data* is encoded data." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1388 -#: ../../library/xml.etree.elementtree.rst:1466 +#: ../../library/xml.etree.elementtree.rst:1389 +#: ../../library/xml.etree.elementtree.rst:1467 msgid "" "Triggers parsing of any previously fed unparsed data, which can be used to " "ensure more immediate feedback, in particular with Expat >=2.6.0. The " @@ -1379,15 +1379,15 @@ msgid "" "xmlparser.SetReparseDeferralEnabled` for details." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1395 -#: ../../library/xml.etree.elementtree.rst:1473 +#: ../../library/xml.etree.elementtree.rst:1396 +#: ../../library/xml.etree.elementtree.rst:1474 msgid "" "Note that :meth:`flush` has been backported to some prior releases of " "CPython as a security fix. Check for availability of :meth:`flush` using :" "func:`hasattr` if used in code running across a variety of Python versions." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1403 +#: ../../library/xml.etree.elementtree.rst:1404 msgid "" ":meth:`XMLParser.feed` calls *target*\\'s ``start(tag, attrs_dict)`` method " "for each opening tag, its ``end(tag)`` method for each closing tag, and data " @@ -1398,11 +1398,11 @@ msgid "" "of an XML file::" msgstr "" -#: ../../library/xml.etree.elementtree.rst:1447 +#: ../../library/xml.etree.elementtree.rst:1448 msgid "XMLPullParser Objects" msgstr "XMLPullParser 物件" -#: ../../library/xml.etree.elementtree.rst:1451 +#: ../../library/xml.etree.elementtree.rst:1452 msgid "" "A pull parser suitable for non-blocking applications. Its input-side API is " "similar to that of :class:`XMLParser`, but instead of pushing calls to a " @@ -1414,11 +1414,11 @@ msgid "" "If *events* is omitted, only ``\"end\"`` events are reported." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1462 +#: ../../library/xml.etree.elementtree.rst:1463 msgid "Feed the given bytes data to the parser." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1482 +#: ../../library/xml.etree.elementtree.rst:1483 msgid "" "Signal the parser that the data stream is terminated. Unlike :meth:" "`XMLParser.close`, this method always returns :const:`None`. Any events not " @@ -1426,7 +1426,7 @@ msgid "" "`read_events`." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1489 +#: ../../library/xml.etree.elementtree.rst:1490 msgid "" "Return an iterator over the events which have been encountered in the data " "fed to the parser. The iterator yields ``(event, elem)`` pairs, where " @@ -1435,25 +1435,25 @@ msgid "" "follows." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1495 +#: ../../library/xml.etree.elementtree.rst:1496 msgid "``start``, ``end``: the current Element." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1496 +#: ../../library/xml.etree.elementtree.rst:1497 msgid "``comment``, ``pi``: the current comment / processing instruction" msgstr "" -#: ../../library/xml.etree.elementtree.rst:1497 +#: ../../library/xml.etree.elementtree.rst:1498 msgid "" "``start-ns``: a tuple ``(prefix, uri)`` naming the declared namespace " "mapping." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1499 +#: ../../library/xml.etree.elementtree.rst:1500 msgid "``end-ns``: :const:`None` (this may change in a future version)" msgstr "" -#: ../../library/xml.etree.elementtree.rst:1501 +#: ../../library/xml.etree.elementtree.rst:1502 msgid "" "Events provided in a previous call to :meth:`read_events` will not be " "yielded again. Events are consumed from the internal queue only when they " @@ -1462,7 +1462,7 @@ msgid "" "results." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1509 +#: ../../library/xml.etree.elementtree.rst:1510 msgid "" ":class:`XMLPullParser` only guarantees that it has seen the \">\" character " "of a starting tag when it emits a \"start\" event, so the attributes are " @@ -1471,11 +1471,11 @@ msgid "" "be present." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1524 +#: ../../library/xml.etree.elementtree.rst:1525 msgid "Exceptions" msgstr "例外" -#: ../../library/xml.etree.elementtree.rst:1528 +#: ../../library/xml.etree.elementtree.rst:1529 msgid "" "XML parse error, raised by the various parsing methods in this module when " "parsing fails. The string representation of an instance of this exception " @@ -1483,22 +1483,22 @@ msgid "" "following attributes available:" msgstr "" -#: ../../library/xml.etree.elementtree.rst:1535 +#: ../../library/xml.etree.elementtree.rst:1536 msgid "" "A numeric error code from the expat parser. See the documentation of :mod:" "`xml.parsers.expat` for the list of error codes and their meanings." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1540 +#: ../../library/xml.etree.elementtree.rst:1541 msgid "" "A tuple of *line*, *column* numbers, specifying where the error occurred." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1543 +#: ../../library/xml.etree.elementtree.rst:1544 msgid "Footnotes" msgstr "註解" -#: ../../library/xml.etree.elementtree.rst:1544 +#: ../../library/xml.etree.elementtree.rst:1545 msgid "" "The encoding string included in XML output should conform to the appropriate " "standards. For example, \"UTF-8\" is valid, but \"UTF8\" is not. See " From 87433630394812b8eead49df3b1d14378a45952d Mon Sep 17 00:00:00 2001 From: Matt Wang Date: Sun, 21 Jul 2024 23:56:22 +0800 Subject: [PATCH 04/28] fix: resolve fuzzy entries --- .scripts/poetry.lock | 20 ++++----- README.rst | 2 +- c-api/arg.po | 4 -- c-api/float.po | 6 +-- faq/design.po | 6 +-- faq/library.po | 2 - library/array.po | 2 - library/colorsys.po | 3 +- library/decimal.po | 1 - library/functions.po | 7 +-- library/itertools.po | 1 - library/marshal.po | 4 +- library/math.po | 2 - library/os.path.po | 2 - library/pkgutil.po | 7 ++- library/random.po | 4 -- library/statistics.po | 1 - library/stdtypes.po | 11 ++--- library/string.po | 1 - library/time.po | 2 - reference/datamodel.po | 3 +- reference/lexical_analysis.po | 9 ++-- tutorial/floatingpoint.po | 4 -- tutorial/introduction.po | 1 - tutorial/stdlib.po | 1 - tutorial/stdlib2.po | 4 +- whatsnew/3.11.po | 1 - whatsnew/3.12.po | 81 +++++++++++++++++++++++------------ 28 files changed, 84 insertions(+), 108 deletions(-) diff --git a/.scripts/poetry.lock b/.scripts/poetry.lock index 79717e7837..3130809ce1 100644 --- a/.scripts/poetry.lock +++ b/.scripts/poetry.lock @@ -1,14 +1,14 @@ -# This file is automatically @generated by Poetry 1.8.2 and should not be changed by hand. +# This file is automatically @generated by Poetry 1.8.3 and should not be changed by hand. [[package]] name = "certifi" -version = "2024.6.2" +version = "2024.7.4" description = "Python package for providing Mozilla's CA Bundle." optional = false python-versions = ">=3.6" files = [ - {file = "certifi-2024.6.2-py3-none-any.whl", hash = "sha256:ddc6c8ce995e6987e7faf5e3f1b02b302836a0e5d98ece18392cb1a36c72ad56"}, - {file = "certifi-2024.6.2.tar.gz", hash = "sha256:3cd43f1c6fa7dedc5899d69d3ad0398fd018ad1a17fba83ddaf78aa46c747516"}, + {file = "certifi-2024.7.4-py3-none-any.whl", hash = "sha256:c198e21b1289c2ab85ee4e67bb4b4ef3ead0892059901a8d5b622f24a1101e90"}, + {file = "certifi-2024.7.4.tar.gz", hash = "sha256:5a1e7645bc0ec61a09e26c36f6106dd4cf40c6db3a1fb6352b0244e7fb057c7b"}, ] [[package]] @@ -173,13 +173,13 @@ files = [ [[package]] name = "hstspreload" -version = "2024.6.1" +version = "2024.7.1" description = "Chromium HSTS Preload list as a Python package" optional = false python-versions = ">=3.6" files = [ - {file = "hstspreload-2024.6.1-py3-none-any.whl", hash = "sha256:561e2382ca0a2faf789709c3e5a6b5f482bfece996fb1963a7cfe5d812e4bd04"}, - {file = "hstspreload-2024.6.1.tar.gz", hash = "sha256:64be485ffe18b83680b2ddf82214937e87e76c458599dde99f2d81459f7be7de"}, + {file = "hstspreload-2024.7.1-py3-none-any.whl", hash = "sha256:028d6b78161cb2e463ced76662fbcfa0da19b28d43d9573f4237cdda8c082822"}, + {file = "hstspreload-2024.7.1.tar.gz", hash = "sha256:61c8d80c646c44732e0614a15a36ab1c6249635be23fa9bf6aefc9039b774c24"}, ] [[package]] @@ -483,13 +483,13 @@ yaml = ["ruamel.yaml (==0.17.21)"] [[package]] name = "urllib3" -version = "2.2.1" +version = "2.2.2" description = "HTTP library with thread-safe connection pooling, file post, and more." optional = false python-versions = ">=3.8" files = [ - {file = "urllib3-2.2.1-py3-none-any.whl", hash = "sha256:450b20ec296a467077128bff42b73080516e71b56ff59a60a02bef2232c4fa9d"}, - {file = "urllib3-2.2.1.tar.gz", hash = "sha256:d0570876c61ab9e520d776c38acbbb5b05a776d3f9ff98a5c8fd5162a444cf19"}, + {file = "urllib3-2.2.2-py3-none-any.whl", hash = "sha256:a448b2f64d686155468037e1ace9f2d2199776e17f0a46610480d311f73e3472"}, + {file = "urllib3-2.2.2.tar.gz", hash = "sha256:dd505485549a7a552833da5e6063639d0d177c04f23bc3864e41e5dc5f612168"}, ] [package.extras] diff --git a/README.rst b/README.rst index f8f6716c7c..385d4ee165 100644 --- a/README.rst +++ b/README.rst @@ -178,7 +178,7 @@ the PSF for inclusion in the documentation. cd ../cpython/Doc/build/html python3 -m http.server - + 你也可以執行下列指令請瀏覽器打開編譯出來的文件\ 以確認整份文件的語意通暢（翻譯別的檔案時將 library/math 換成別的檔名）： diff --git a/c-api/arg.po b/c-api/arg.po index a4fa9fe958..7c5dfeaf2b 100644 --- a/c-api/arg.po +++ b/c-api/arg.po @@ -552,7 +552,6 @@ msgid "``f`` (:class:`float`) [float]" msgstr "``f`` (:class:`float`) [float]" #: ../../c-api/arg.rst:283 -#, fuzzy msgid "Convert a Python floating-point number to a C :c:expr:`float`." msgstr "將一個 Python 浮點數轉換成 C 的 :c:type::c:expr:`float`。" @@ -561,7 +560,6 @@ msgid "``d`` (:class:`float`) [double]" msgstr "``d`` (:class:`float`) [double]" #: ../../c-api/arg.rst:286 -#, fuzzy msgid "Convert a Python floating-point number to a C :c:expr:`double`." msgstr "將一個 Python 浮點數轉換成 C 的 :c:type::c:expr:`double`。" @@ -1041,12 +1039,10 @@ msgstr "" "`str`。" #: ../../c-api/arg.rst:610 -#, fuzzy msgid "Convert a C :c:expr:`double` to a Python floating-point number." msgstr "將一個 C 的 :c:expr:`double` 轉換成 Python 浮點數。" #: ../../c-api/arg.rst:613 -#, fuzzy msgid "Convert a C :c:expr:`float` to a Python floating-point number." msgstr "將一個 C 的 :c:expr:`float` 轉換成 Python 浮點數。" diff --git a/c-api/float.po b/c-api/float.po index 9aef11e532..df086b405b 100644 --- a/c-api/float.po +++ b/c-api/float.po @@ -21,9 +21,8 @@ msgstr "" "Plural-Forms: nplurals=1; plural=0;\n" #: ../../c-api/float.rst:6 -#, fuzzy msgid "Floating-Point Objects" -msgstr "浮點數（Floating Point）物件" +msgstr "浮點數（Floating-Point）物件" #: ../../c-api/float.rst:13 msgid "" @@ -218,6 +217,5 @@ msgid "object" msgstr "object（物件）" #: ../../c-api/float.rst:8 -#, fuzzy msgid "floating-point" -msgstr "floating point（浮點）" +msgstr "floating-point（浮點）" diff --git a/faq/design.po b/faq/design.po index cf5c264897..09ffc22728 100644 --- a/faq/design.po +++ b/faq/design.po @@ -132,13 +132,12 @@ msgstr "" "運算來說，Python 和 C、Java 等很多受歡迎的語言有一樣的行為。" #: ../../faq/design.rst:72 -#, fuzzy msgid "" "Many numbers that can be written easily in decimal notation cannot be " "expressed exactly in binary floating point. For example, after::" msgstr "" -"很多數字可以簡單地寫成十進位表示，但卻無法簡單地變成二進制表示。比方說，在以" -"下程式碼執行後： ::" +"很多數字可以簡單地寫成十進位表示，但卻無法簡單地以二進制浮點數表示。比方說，" +"在以下程式碼執行後： ::" #: ../../faq/design.rst:77 msgid "" @@ -160,7 +159,6 @@ msgid "" msgstr "53 位元的精度讓 Python 可以有 15 至 16 小數位的準確度。" #: ../../faq/design.rst:90 -#, fuzzy msgid "" "For a fuller explanation, please see the :ref:`floating-point arithmetic " "` chapter in the Python tutorial." diff --git a/faq/library.po b/faq/library.po index 15431ddb76..1d43b77073 100644 --- a/faq/library.po +++ b/faq/library.po @@ -1083,7 +1083,6 @@ msgid "" msgstr "標準模組 :mod:`random` 實作了一個隨機數生成器。用法很簡單： ::" #: ../../faq/library.rst:828 -#, fuzzy msgid "This returns a random floating-point number in the range [0, 1)." msgstr "這將回傳 [0, 1) 範圍內的隨機浮點數。" @@ -1097,7 +1096,6 @@ msgid "``randrange(a, b)`` chooses an integer in the range [a, b)." msgstr "``randrange(a, b)`` 會選擇 [a, b) 範圍內的一個整數。" #: ../../faq/library.rst:833 -#, fuzzy msgid "``uniform(a, b)`` chooses a floating-point number in the range [a, b)." msgstr "``uniform(a, b)`` 會選擇 [a, b) 範圍內的浮點數。" diff --git a/library/array.po b/library/array.po index adf333f5ac..0ca003ede8 100644 --- a/library/array.po +++ b/library/array.po @@ -28,7 +28,6 @@ msgid ":mod:`!array` --- Efficient arrays of numeric values" msgstr ":mod:`!array` --- 高效率的數值型陣列" #: ../../library/array.rst:11 -#, fuzzy msgid "" "This module defines an object type which can compactly represent an array of " "basic values: characters, integers, floating-point numbers. Arrays are " @@ -469,7 +468,6 @@ msgstr "" "陣列轉為 Unicode 字串。" #: ../../library/array.rst:247 -#, fuzzy msgid "" "The string representation of array objects has the form ``array(typecode, " "initializer)``. The *initializer* is omitted if the array is empty, " diff --git a/library/colorsys.po b/library/colorsys.po index f1fe5ebabc..cf65fe4766 100644 --- a/library/colorsys.po +++ b/library/colorsys.po @@ -29,7 +29,6 @@ msgid "**Source code:** :source:`Lib/colorsys.py`" msgstr "**原始碼：**\\ :source:`Lib/colorsys.py`" #: ../../library/colorsys.rst:13 -#, fuzzy msgid "" "The :mod:`colorsys` module defines bidirectional conversions of color values " "between colors expressed in the RGB (Red Green Blue) color space used in " @@ -42,7 +41,7 @@ msgstr "" ":mod:`colorsys` 模組 (module) 定義了電腦顯示器所用的 RGB （紅綠藍）色彩空間與" "三種其他色彩座標系統：YIQ、HLS (色相、亮度、飽和度) 和 HSV (色相、 飽和度、 " "明度) 所表示的顏色值之間的雙向轉換。所有這些色彩空間的座標都使用浮點數值 " -"(floating point) 來表示。在 YIQ 空間中，Y 座標值為 0 和 1 之間，而 I 和 Q 座" +"(floating-point) 來表示。在 YIQ 空間中，Y 座標值為 0 和 1 之間，而 I 和 Q 座" "標均可以為正數或負數。在所有其他空間中，座標值均為 0 和 1 之間。" #: ../../library/colorsys.rst:23 diff --git a/library/decimal.po b/library/decimal.po index cf2c412b65..2d135597ae 100644 --- a/library/decimal.po +++ b/library/decimal.po @@ -19,7 +19,6 @@ msgstr "" "Plural-Forms: nplurals=1; plural=0;\n" #: ../../library/decimal.rst:2 -#, fuzzy msgid ":mod:`!decimal` --- Decimal fixed-point and floating-point arithmetic" msgstr ":mod:`!decimal` --- 十進位固定點和浮點運算" diff --git a/library/functions.po b/library/functions.po index 004d0a45b7..527eee9156 100644 --- a/library/functions.po +++ b/library/functions.po @@ -398,7 +398,6 @@ msgid ":func:`__import__`" msgstr ":func:`__import__`" #: ../../library/functions.rst:59 -#, fuzzy msgid "" "Return the absolute value of a number. The argument may be an integer, a " "floating-point number, or an object implementing :meth:`~object.__abs__`. If " @@ -1082,7 +1081,6 @@ msgstr "" "中。" #: ../../library/functions.rst:538 -#, fuzzy msgid "" "Take two (non-complex) numbers as arguments and return a pair of numbers " "consisting of their quotient and remainder when using integer division. " @@ -1356,7 +1354,6 @@ msgstr "" "*iterable* 中元素的互補函式。" #: ../../library/functions.rst:717 -#, fuzzy msgid "Return a floating-point number constructed from a number or a string." msgstr "回傳從數字或字串生成的浮點數。" @@ -1384,7 +1381,6 @@ msgstr "" "示正無窮大。" #: ../../library/functions.rst:758 -#, fuzzy msgid "" "Otherwise, if the argument is an integer or a floating-point number, a " "floating-point number with the same value (within Python's floating-point " @@ -2427,12 +2423,11 @@ msgstr "" "`shutil`。" #: ../../library/functions.rst:1443 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``open`` with arguments ``path``, " "``mode``, ``flags``." msgstr "" -"引發一個附帶引數 ``file``、``model``、``flags`` 的\\ :ref:`稽核事件 " +"引發一個附帶引數 ``path``、``model``、``path`` 的\\ :ref:`稽核事件 " "` ``open``。" #: ../../library/functions.rst:1445 diff --git a/library/itertools.po b/library/itertools.po index c1b868fca8..25846730cc 100644 --- a/library/itertools.po +++ b/library/itertools.po @@ -619,7 +619,6 @@ msgstr "" "產生連續的資料點，或與 :func:`zip` 一起使用來增加序列號。大致等價於： ::" #: ../../library/itertools.rst:332 -#, fuzzy msgid "" "When counting with floating-point numbers, better accuracy can sometimes be " "achieved by substituting multiplicative code such as: ``(start + step * i " diff --git a/library/marshal.po b/library/marshal.po index df164a415e..d589f81336 100644 --- a/library/marshal.po +++ b/library/marshal.po @@ -71,7 +71,6 @@ msgstr "" "unmarshal 來自不受信任的或來源未經驗證的資料。" #: ../../library/marshal.rst:39 -#, fuzzy msgid "" "Not all Python object types are supported; in general, only objects whose " "value is independent from a particular invocation of Python can be written " @@ -87,7 +86,7 @@ msgid "" msgstr "" "不是所有 Python 物件型別都有支援；一般來說，此 module 只能寫入和讀取不依賴於" "特定 Python 調用 (invocation) 的物件。下列型別是有支援的：布林 (boolean)、整" -"數、浮點數 (floating point number)、複數、字串、位元組串 (bytes)、位元組陣列 " +"數、浮點數 (floating-point number)、複數、字串、位元組串 (bytes)、位元組陣列 " "(bytearray)、元組 (tuple)、list、集合 (set)、凍結集合 (frozenset)、" "dictionary 和程式碼物件，需要了解的一點是元組、list、集合、凍結集合和 " "dictionary 只在其所包含的值也屬於這些型別時才會支援。單例 (singleton) 物件 :" @@ -219,7 +218,6 @@ msgid "In addition, the following constants are defined:" msgstr "此外，還定義了以下常數：" #: ../../library/marshal.rst:122 -#, fuzzy msgid "" "Indicates the format that the module uses. Version 0 is the historical " "format, version 1 shares interned strings and version 2 uses a binary format " diff --git a/library/math.po b/library/math.po index 3ea2875b4f..9567206bfd 100644 --- a/library/math.po +++ b/library/math.po @@ -163,7 +163,6 @@ msgstr "" "``0.5 <= abs(m) < 1``。此函式用於以可攜的方式「分割」浮點數內部表示法。" #: ../../library/math.rst:110 -#, fuzzy msgid "" "Return an accurate floating-point sum of values in the iterable. Avoids " "loss of precision by tracking multiple intermediate partial sums." @@ -184,7 +183,6 @@ msgstr "" "程中同一部分和重複捨入，並使其最低有效位不如預期。" #: ../../library/math.rst:119 -#, fuzzy msgid "" "For further discussion and two alternative approaches, see the `ASPN " "cookbook recipes for accurate floating-point summation ``. If loaded from a file, they are written as ````." +"Modules built into the interpreter are written like this: ````. If loaded from a file, they are written as ````." msgstr "" #: ../../library/stdtypes.rst:5303 @@ -6539,9 +6537,8 @@ msgid "integer" msgstr "integer（整數）" #: ../../library/stdtypes.rst:208 ../../library/stdtypes.rst:229 -#, fuzzy msgid "floating-point" -msgstr "floating point（浮點數）" +msgstr "floating-point（浮點數）" #: ../../library/stdtypes.rst:208 ../../library/stdtypes.rst:229 msgid "complex number" diff --git a/library/string.po b/library/string.po index aa813380da..ac55687fce 100644 --- a/library/string.po +++ b/library/string.po @@ -568,7 +568,6 @@ msgid "Added the ``','`` option (see also :pep:`378`)." msgstr "新增 ``','`` 選項（請見 :pep:`378`\\ ）。" #: ../../library/string.rst:420 -#, fuzzy msgid "" "The ``'_'`` option signals the use of an underscore for a thousands " "separator for floating-point presentation types and for integer presentation " diff --git a/library/time.po b/library/time.po index 37188c7ac1..9dca845d26 100644 --- a/library/time.po +++ b/library/time.po @@ -117,7 +117,6 @@ msgstr "" "度。例如，在大多數 Unix 系統上，時鐘每秒只「跳」50 次或 100 次。" #: ../../library/time.rst:71 -#, fuzzy msgid "" "On the other hand, the precision of :func:`.time` and :func:`sleep` is " "better than their Unix equivalents: times are expressed as floating-point " @@ -446,7 +445,6 @@ msgstr "" "制在 1970 年到 2038 年之間。" #: ../../library/time.rst:273 -#, fuzzy msgid "" "This is the inverse function of :func:`localtime`. Its argument is the :" "class:`struct_time` or full 9-tuple (since the dst flag is needed; use " diff --git a/reference/datamodel.po b/reference/datamodel.po index 7be8d85739..6bd3810027 100644 --- a/reference/datamodel.po +++ b/reference/datamodel.po @@ -4037,9 +4037,8 @@ msgid "True" msgstr "True" #: ../../reference/datamodel.rst:261 -#, fuzzy msgid "floating-point" -msgstr "floating point（浮點）" +msgstr "floating-point（浮點）" #: ../../reference/datamodel.rst:261 ../../reference/datamodel.rst:279 msgid "number" diff --git a/reference/lexical_analysis.po b/reference/lexical_analysis.po index 9ea78730fe..27e020ae40 100644 --- a/reference/lexical_analysis.po +++ b/reference/lexical_analysis.po @@ -1102,9 +1102,8 @@ msgid "Underscores are now allowed for grouping purposes in literals." msgstr "" #: ../../reference/lexical_analysis.rst:947 -#, fuzzy msgid "Floating-point literals" -msgstr "floating point literal（浮點數常數）" +msgstr "浮點數常數 (Floating-point literals)" #: ../../reference/lexical_analysis.rst:949 msgid "" @@ -1121,9 +1120,8 @@ msgid "" msgstr "" #: ../../reference/lexical_analysis.rst:964 -#, fuzzy msgid "Some examples of floating-point literals::" -msgstr "floating point literal（浮點數常數）" +msgstr "一些浮點數常數的範例： ::" #: ../../reference/lexical_analysis.rst:977 msgid "Imaginary literals" @@ -1540,9 +1538,8 @@ msgid "integer literal" msgstr "integer literal（整數常數）" #: ../../reference/lexical_analysis.rst:881 -#, fuzzy msgid "floating-point literal" -msgstr "floating point literal（浮點數常數）" +msgstr "floating-point literal（浮點數常數）" #: ../../reference/lexical_analysis.rst:881 msgid "hexadecimal literal" diff --git a/tutorial/floatingpoint.po b/tutorial/floatingpoint.po index 6311bf8eea..a33ba891ee 100644 --- a/tutorial/floatingpoint.po +++ b/tutorial/floatingpoint.po @@ -24,7 +24,6 @@ msgstr "" "X-Generator: Poedit 3.3.1\n" #: ../../tutorial/floatingpoint.rst:10 -#, fuzzy msgid "Floating-Point Arithmetic: Issues and Limitations" msgstr "浮點數運算：問題與限制" @@ -154,7 +153,6 @@ msgstr "" "（在大部分的系統上）現在能選擇其中最短的數並簡單地顯示為 ``0.1``。" #: ../../tutorial/floatingpoint.rst:91 -#, fuzzy msgid "" "Note that this is in the very nature of binary floating point: this is not a " "bug in Python, and it is not a bug in your code either. You'll see the same " @@ -215,7 +213,6 @@ msgid "" msgstr "或者，可以使用 :func:`round` 函式來比較粗略的近似值：" #: ../../tutorial/floatingpoint.rst:147 -#, fuzzy msgid "" "Binary floating-point arithmetic holds many surprises like this. The " "problem with \"0.1\" is explained in precise detail below, in the " @@ -234,7 +231,6 @@ msgstr "" "（浮點數的風險） `_。" #: ../../tutorial/floatingpoint.rst:156 -#, fuzzy msgid "" "As that says near the end, \"there are no easy answers.\" Still, don't be " "unduly wary of floating point! The errors in Python float operations are " diff --git a/tutorial/introduction.po b/tutorial/introduction.po index 861c59108a..0ad011b70a 100644 --- a/tutorial/introduction.po +++ b/tutorial/introduction.po @@ -573,7 +573,6 @@ msgstr "" "數量必須維持一致。" #: ../../tutorial/introduction.rst:544 -#, fuzzy msgid "" "The :func:`print` function writes the value of the argument(s) it is given. " "It differs from just writing the expression you want to write (as we did " diff --git a/tutorial/stdlib.po b/tutorial/stdlib.po index 307ec65bb6..f19a3e9e74 100644 --- a/tutorial/stdlib.po +++ b/tutorial/stdlib.po @@ -156,7 +156,6 @@ msgid "Mathematics" msgstr "數學相關" #: ../../tutorial/stdlib.rst:140 -#, fuzzy msgid "" "The :mod:`math` module gives access to the underlying C library functions " "for floating-point math::" diff --git a/tutorial/stdlib2.po b/tutorial/stdlib2.po index 2709dbd809..b98765cf32 100644 --- a/tutorial/stdlib2.po +++ b/tutorial/stdlib2.po @@ -338,12 +338,10 @@ msgstr "" "行排序的應用程式來說，這會很有用： ::" #: ../../tutorial/stdlib2.rst:356 -#, fuzzy msgid "Decimal Floating-Point Arithmetic" -msgstr "十進制 (Decimal) 浮點數運算" +msgstr "十進制浮點數運算 (Decimal Floating-Point Arithmetic)" #: ../../tutorial/stdlib2.rst:358 -#, fuzzy msgid "" "The :mod:`decimal` module offers a :class:`~decimal.Decimal` datatype for " "decimal floating-point arithmetic. Compared to the built-in :class:`float` " diff --git a/whatsnew/3.11.po b/whatsnew/3.11.po index 3faf8f4aaa..1e0b7ecf50 100644 --- a/whatsnew/3.11.po +++ b/whatsnew/3.11.po @@ -4009,7 +4009,6 @@ msgstr "" "於 :issue:`46656`、:issue:`45440` 和 :issue:`46640` 中貢獻。）" #: ../../whatsnew/3.11.rst:2140 -#, fuzzy msgid "" "Support for `IEEE 754 `_ floating-" "point numbers. (Contributed by Victor Stinner in :issue:`46917`.)" diff --git a/whatsnew/3.12.po b/whatsnew/3.12.po index ad791293bb..bdf15d700b 100644 --- a/whatsnew/3.12.po +++ b/whatsnew/3.12.po @@ -1,4 +1,4 @@ -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # @@ -10,7 +10,8 @@ msgstr "" "POT-Creation-Date: 2024-06-13 00:03+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" -"Language-Team: LANGUAGE \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" @@ -34,6 +35,8 @@ msgid "" "Python 3.12 was released on October 2, 2023. For full details, see the :ref:" "`changelog `." msgstr "" +"本文介紹了 Python 3.12 與 3.11 相比的新功能。 Python 3.12 於 2023 年 10 月 2 " +"日發布。完整詳請請見 :ref:`changelog `。" #: ../../whatsnew/3.12.rst:54 msgid ":pep:`693` -- Python 3.12 Release Schedule" @@ -83,6 +86,7 @@ msgid "" ":ref:`PEP 695 `, type parameter syntax and the :keyword:" "`type` statement" msgstr "" +":ref:`PEP 695 `，型別參數語法和 :keyword:`type` 陳述式" #: ../../whatsnew/3.12.rst:94 msgid "New grammar features:" @@ -116,7 +120,7 @@ msgstr "" #: ../../whatsnew/3.12.rst:106 msgid "Python data model improvements:" -msgstr "" +msgstr "Python 資料模型改進：" #: ../../whatsnew/3.12.rst:108 msgid "" @@ -141,6 +145,7 @@ msgid "" "A :ref:`command-line interface ` has been added to the :mod:" "`sqlite3` module" msgstr "" +"一個\\ :ref:`命令列介面 `\\ 已被加入 :mod:`sqlite3` 模組中" #: ../../whatsnew/3.12.rst:117 msgid "" @@ -153,12 +158,13 @@ msgid "" "The :mod:`asyncio` package has had a number of performance improvements, " "with some benchmarks showing a 75% speed up." msgstr "" +":mod:`asyncio` 套件進行了許多效能改進，一些基準測試顯示速度提高了 75%。" #: ../../whatsnew/3.12.rst:121 msgid "" "A :ref:`command-line interface ` has been added to the :mod:`uuid` " "module" -msgstr "" +msgstr "一個\\ :ref:`命令列介面 `\\ 已被加入 :mod:`uuid` 模組中" #: ../../whatsnew/3.12.rst:123 msgid "" @@ -184,7 +190,7 @@ msgstr "C API 改進：" #: ../../whatsnew/3.12.rst:136 msgid ":ref:`PEP 697 `, unstable C API tier" -msgstr "" +msgstr ":ref:`PEP 697 `，不穩定 C API 層" #: ../../whatsnew/3.12.rst:137 msgid ":ref:`PEP 683 `, immortal objects" @@ -192,7 +198,7 @@ msgstr "" #: ../../whatsnew/3.12.rst:139 msgid "CPython implementation improvements:" -msgstr "" +msgstr "CPython 實作改進：" #: ../../whatsnew/3.12.rst:141 msgid ":ref:`PEP 709 `, comprehension inlining" @@ -224,7 +230,7 @@ msgstr ":ref:`PEP 698 `、:func:`typing.override` 裝飾器" #: ../../whatsnew/3.12.rst:151 msgid "Important deprecations, removals or restrictions:" -msgstr "" +msgstr "重要的棄用、刪除或限制：" #: ../../whatsnew/3.12.rst:153 msgid "" @@ -256,6 +262,9 @@ msgid "" "removed, along with several :class:`unittest.TestCase` `method aliases " "`_." msgstr "" +":mod:`!asynchat`、:mod:`!asyncore` 和 :mod:`!imp` 模組以及幾個 :class:" +"`unittest.TestCase` 的\\ `方法別名 `_\\ " +"已被刪除。" #: ../../whatsnew/3.12.rst:176 ../../whatsnew/3.12.rst:1973 msgid "New Features" @@ -263,7 +272,7 @@ msgstr "新增特性" #: ../../whatsnew/3.12.rst:181 msgid "PEP 695: Type Parameter Syntax" -msgstr "" +msgstr "PEP 695：型別參數語法" #: ../../whatsnew/3.12.rst:183 msgid "" @@ -288,7 +297,7 @@ msgstr "" #: ../../whatsnew/3.12.rst:206 msgid "Type aliases can also be :ref:`generic `::" -msgstr "" +msgstr "型別別名也可以是\\ :ref:`泛型 `： ::" #: ../../whatsnew/3.12.rst:210 msgid "" @@ -1089,6 +1098,8 @@ msgid "" "Add a default of ``lambd=1.0`` to :func:`random.expovariate`. (Contributed " "by Raymond Hettinger in :gh:`100234`.)" msgstr "" +"將預設值 ``lambd=1.0`` 加入至 :func:`random.expovariate` 中。（由 Raymond " +"Hettinger 在 :gh:`100234` 中貢獻。）" #: ../../whatsnew/3.12.rst:839 msgid "shutil" @@ -1237,6 +1248,8 @@ msgid "" ":func:`tempfile.mkdtemp` now always returns an absolute path, even if the " "argument provided to the *dir* parameter is a relative path." msgstr "" +":func:`tempfile.mkdtemp` 現在總是會傳回絕對路徑，即使提供給 *dir* 參數的引數" +"是相對路徑。" #: ../../whatsnew/3.12.rst:935 msgid "" @@ -1580,6 +1593,7 @@ msgid "" "Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka in :gh:" "`90953`.)" msgstr "" +"改用 :class:`ast.Constant`。（由 Serhiy Storchaka 在 :gh:`90953` 中貢獻。）" #: ../../whatsnew/3.12.rst:1174 ../../whatsnew/3.12.rst:1417 msgid ":mod:`asyncio`:" @@ -1864,10 +1878,11 @@ msgid "" "The following modules and APIs have been deprecated in earlier Python " "releases, and will be removed in Python 3.13." msgstr "" +"以下模組和 API 在早期的 Python 版本中已被棄用，並將在 Python 3.13 中刪除。" #: ../../whatsnew/3.12.rst:1350 msgid "Modules (see :pep:`594`):" -msgstr "" +msgstr "模組（參見:pep:`594`）：" #: ../../whatsnew/3.12.rst:1352 msgid ":mod:`aifc`" @@ -2089,7 +2104,7 @@ msgstr ":mod:`collections.abc`: :class:`!collections.abc.ByteString`。" #: ../../whatsnew/3.12.rst:1430 msgid ":mod:`email`: the *isdst* parameter in :func:`email.utils.localtime`." -msgstr "" +msgstr ":mod:`email`：:func:`email.utils.localtime` 中的 *isdst* 參數。" #: ../../whatsnew/3.12.rst:1432 msgid ":mod:`importlib.abc`:" @@ -2097,7 +2112,7 @@ msgstr ":mod:`importlib.abc`：" #: ../../whatsnew/3.12.rst:1438 msgid ":mod:`itertools`: Support for copy, deepcopy, and pickle operations." -msgstr "" +msgstr ":mod:`itertools`：支援複製、深度複製 (deepcopy) 和 pickle 操作。" #: ../../whatsnew/3.12.rst:1440 msgid ":mod:`pkgutil`:" @@ -2136,14 +2151,16 @@ msgid "" ":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`xml." "etree.ElementTree.Element`." msgstr "" +":mod:`xml.etree.ElementTree`：測試 :class:`xml.etree.ElementTree.Element` 的" +"真值。" #: ../../whatsnew/3.12.rst:1456 msgid "The ``__package__`` and ``__cached__`` attributes on module objects." -msgstr "" +msgstr "模組物件上的 ``__package__`` 和 ``__cached__`` 屬性。" #: ../../whatsnew/3.12.rst:1458 msgid "The :attr:`~codeobject.co_lnotab` attribute of code objects." -msgstr "" +msgstr "程式碼物件的 :attr:`~codeobject.co_lnotab` 屬性。" #: ../../whatsnew/3.12.rst:1461 ../../whatsnew/3.12.rst:2399 msgid "Pending Removal in Python 3.15" @@ -2167,10 +2184,12 @@ msgid "" "The following APIs were deprecated in earlier Python versions and will be " "removed, although there is currently no date scheduled for their removal." msgstr "" +"以下 API 在早期 Python 版本中已棄用，並將被刪除，但目前還沒有計劃刪除它們的日" +"期。" #: ../../whatsnew/3.12.rst:1477 msgid ":mod:`array`'s ``'u'`` format code (:gh:`57281`)" -msgstr "" +msgstr ":mod:`array` 的 ``'u'`` 格式碼 (:gh:`57281`)" #: ../../whatsnew/3.12.rst:1479 msgid ":class:`typing.Text` (:gh:`92332`)" @@ -2218,6 +2237,8 @@ msgid "" ":class:`configparser.ParsingError` no longer has a ``filename`` attribute or " "argument. Use the ``source`` attribute and argument instead." msgstr "" +":class:`configparser.ParsingError` 不再具有 ``filename`` 屬性或引數。請改用 " +"``source`` 屬性和引數。" #: ../../whatsnew/3.12.rst:1511 msgid "" @@ -2332,13 +2353,15 @@ msgstr "importlib" msgid "" "Many previously deprecated cleanups in :mod:`importlib` have now been " "completed:" -msgstr "" +msgstr "現已完成清理 :mod:`importlib` 中許多過去已經棄用的東西：" #: ../../whatsnew/3.12.rst:1584 msgid "" "References to, and support for :meth:`!module_repr()` has been removed. " "(Contributed by Barry Warsaw in :gh:`97850`.)" msgstr "" +"對 :meth:`!module_repr()` 的參照和支援已刪除。（由 Barry Warsaw 在 :gh:" +"`97850` 中貢獻。）" #: ../../whatsnew/3.12.rst:1587 msgid "" @@ -2611,7 +2634,7 @@ msgstr "移除許多 :mod:`unittest` 中被棄用已久的功能：" #: ../../whatsnew/3.12.rst:1723 msgid "A number of :class:`~unittest.TestCase` method aliases:" -msgstr "" +msgstr "許多 :class:`~unittest.TestCase` 方法別名：" #: ../../whatsnew/3.12.rst:1726 msgid "Deprecated alias" @@ -2623,7 +2646,7 @@ msgstr "方法名稱" #: ../../whatsnew/3.12.rst:1726 msgid "Deprecated in" -msgstr "" +msgstr "已棄用於" #: ../../whatsnew/3.12.rst:1728 msgid "``failUnless``" @@ -2857,7 +2880,7 @@ msgstr "" #: ../../whatsnew/3.12.rst:1817 msgid "Changes in the Python API" -msgstr "" +msgstr "Python API 的變更" #: ../../whatsnew/3.12.rst:1819 msgid "" @@ -3103,7 +3126,7 @@ msgstr "" #: ../../whatsnew/3.12.rst:1988 msgid "Extra storage for code objects (:pep:`523`):" -msgstr "" +msgstr "程式碼物件的額外儲存 (:pep:`523`)：" #: ../../whatsnew/3.12.rst:1990 msgid "" @@ -3125,7 +3148,7 @@ msgstr "``PyUnstable_Code_SetExtra()``\\ （自 ``_PyCode_SetExtra`` 重新命 msgid "" "The original names will continue to be available until the respective API " "changes." -msgstr "" +msgstr "原始名稱將可繼續使用，直到相應的 API 發生變更。" #: ../../whatsnew/3.12.rst:1997 msgid "(Contributed by Petr Viktorin in :gh:`101101`.)" @@ -3142,6 +3165,8 @@ msgid "" ":c:member:`PyType_Spec.basicsize` can be zero or negative to specify " "inheriting or extending the base class size." msgstr "" +":c:member:`PyType_Spec.basicsize` 可以為零或負數來指定繼承或擴充基底類別大" +"小。" #: ../../whatsnew/3.12.rst:2004 msgid "" @@ -3325,7 +3350,7 @@ msgstr "" #: ../../whatsnew/3.12.rst:2108 msgid "``_Py_IMMORTAL_REFCNT``: The reference count that defines an object" -msgstr "" +msgstr "``_Py_IMMORTAL_REFCNT``：定義物件的參照計數" #: ../../whatsnew/3.12.rst:2109 msgid "as immortal." @@ -3338,11 +3363,11 @@ msgstr "" #: ../../whatsnew/3.12.rst:2111 msgid "``PyObject_HEAD_INIT`` This will now initialize reference count to" -msgstr "" +msgstr "``PyObject_HEAD_INIT`` 這現在將初始化參照計數" #: ../../whatsnew/3.12.rst:2112 msgid "``_Py_IMMORTAL_REFCNT`` when used with ``Py_BUILD_CORE``." -msgstr "" +msgstr "``_Py_IMMORTAL_REFCNT``\\ （與 ``Py_BUILD_CORE`` 一起使用時）。" #: ../../whatsnew/3.12.rst:2113 msgid "``SSTATE_INTERNED_IMMORTAL`` An identifier for interned unicode objects" @@ -3622,7 +3647,7 @@ msgstr "" #: ../../whatsnew/3.12.rst:2282 msgid "Deprecate global configuration variable:" -msgstr "" +msgstr "棄用全域配置變數：" #: ../../whatsnew/3.12.rst:2284 ../../whatsnew/3.12.rst:2369 msgid ":c:var:`Py_DebugFlag`: use :c:member:`PyConfig.parser_debug`" @@ -3878,7 +3903,7 @@ msgstr "" #: ../../whatsnew/3.12.rst:2367 msgid "Global configuration variables:" -msgstr "" +msgstr "全域配置變數：" #: ../../whatsnew/3.12.rst:2392 msgid "" @@ -3888,10 +3913,12 @@ msgstr "" ":c:func:`Py_InitializeFromConfig` API 應改為與 :c:type:`PyConfig` 一起使用。" #: ../../whatsnew/3.12.rst:2395 +#, fuzzy msgid "" "Creating :c:data:`immutable types ` with mutable " "bases (:gh:`95388`)." msgstr "" +"建立具有可變基底的\\ `不可變型別 ` (:gh:`95388`)。" #: ../../whatsnew/3.12.rst:2401 msgid "" @@ -4115,7 +4142,7 @@ msgstr "" #: ../../whatsnew/3.12.rst:2472 msgid "Notable changes in 3.12.4" -msgstr "" +msgstr "3.12.4 中的明顯變更" #: ../../whatsnew/3.12.rst:2475 msgid "ipaddress" From cc5e1d96a3088cd2f5a8691d76eac70ee7ec81f9 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Mon, 22 Jul 2024 00:05:10 +0000 Subject: [PATCH 05/28] sync with cpython 9343c6d3 --- library/multiprocessing.po | 601 ++++++++++++++++++------------------- library/statistics.po | 213 ++++++------- 2 files changed, 404 insertions(+), 410 deletions(-) diff --git a/library/multiprocessing.po b/library/multiprocessing.po index 9af6c2dc48..ddb2cda61e 100644 --- a/library/multiprocessing.po +++ b/library/multiprocessing.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-15 00:03+0000\n" +"POT-Creation-Date: 2024-07-22 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:06+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1481,7 +1481,7 @@ msgid "" msgstr "" #: ../../library/multiprocessing.rst:1337 -#: ../../library/multiprocessing.rst:1886 +#: ../../library/multiprocessing.rst:1875 msgid "The :meth:`~threading.Condition.wait_for` method was added." msgstr "" @@ -1643,21 +1643,6 @@ msgstr "" #: ../../library/multiprocessing.rst:1471 msgid "" -"If the SIGINT signal generated by :kbd:`Ctrl-C` arrives while the main " -"thread is blocked by a call to :meth:`BoundedSemaphore.acquire`, :meth:`Lock." -"acquire`, :meth:`RLock.acquire`, :meth:`Semaphore.acquire`, :meth:`Condition." -"acquire` or :meth:`Condition.wait` then the call will be immediately " -"interrupted and :exc:`KeyboardInterrupt` will be raised." -msgstr "" - -#: ../../library/multiprocessing.rst:1477 -msgid "" -"This differs from the behaviour of :mod:`threading` where SIGINT will be " -"ignored while the equivalent blocking calls are in progress." -msgstr "" - -#: ../../library/multiprocessing.rst:1482 -msgid "" "Some of this package's functionality requires a functioning shared semaphore " "implementation on the host operating system. Without one, the :mod:" "`multiprocessing.synchronize` module will be disabled, and attempts to " @@ -1665,32 +1650,32 @@ msgid "" "additional information." msgstr "" -#: ../../library/multiprocessing.rst:1490 +#: ../../library/multiprocessing.rst:1479 msgid "Shared :mod:`ctypes` Objects" msgstr "" -#: ../../library/multiprocessing.rst:1492 +#: ../../library/multiprocessing.rst:1481 msgid "" "It is possible to create shared objects using shared memory which can be " "inherited by child processes." msgstr "" -#: ../../library/multiprocessing.rst:1497 +#: ../../library/multiprocessing.rst:1486 msgid "" "Return a :mod:`ctypes` object allocated from shared memory. By default the " "return value is actually a synchronized wrapper for the object. The object " "itself can be accessed via the *value* attribute of a :class:`Value`." msgstr "" -#: ../../library/multiprocessing.rst:1501 -#: ../../library/multiprocessing.rst:1588 +#: ../../library/multiprocessing.rst:1490 +#: ../../library/multiprocessing.rst:1577 msgid "" "*typecode_or_type* determines the type of the returned object: it is either " "a ctypes type or a one character typecode of the kind used by the :mod:" "`array` module. *\\*args* is passed on to the constructor for the type." msgstr "" -#: ../../library/multiprocessing.rst:1505 +#: ../../library/multiprocessing.rst:1494 msgid "" "If *lock* is ``True`` (the default) then a new recursive lock object is " "created to synchronize access to the value. If *lock* is a :class:`Lock` " @@ -1700,32 +1685,32 @@ msgid "" "\"process-safe\"." msgstr "" -#: ../../library/multiprocessing.rst:1512 +#: ../../library/multiprocessing.rst:1501 msgid "" "Operations like ``+=`` which involve a read and write are not atomic. So " "if, for instance, you want to atomically increment a shared value it is " "insufficient to just do ::" msgstr "" -#: ../../library/multiprocessing.rst:1518 +#: ../../library/multiprocessing.rst:1507 msgid "" "Assuming the associated lock is recursive (which it is by default) you can " "instead do ::" msgstr "" -#: ../../library/multiprocessing.rst:1524 -#: ../../library/multiprocessing.rst:1614 -#: ../../library/multiprocessing.rst:1629 +#: ../../library/multiprocessing.rst:1513 +#: ../../library/multiprocessing.rst:1603 +#: ../../library/multiprocessing.rst:1618 msgid "Note that *lock* is a keyword-only argument." msgstr "" -#: ../../library/multiprocessing.rst:1528 +#: ../../library/multiprocessing.rst:1517 msgid "" "Return a ctypes array allocated from shared memory. By default the return " "value is actually a synchronized wrapper for the array." msgstr "" -#: ../../library/multiprocessing.rst:1531 +#: ../../library/multiprocessing.rst:1520 msgid "" "*typecode_or_type* determines the type of the elements of the returned " "array: it is either a ctypes type or a one character typecode of the kind " @@ -1735,7 +1720,7 @@ msgid "" "initialize the array and whose length determines the length of the array." msgstr "" -#: ../../library/multiprocessing.rst:1538 +#: ../../library/multiprocessing.rst:1527 msgid "" "If *lock* is ``True`` (the default) then a new lock object is created to " "synchronize access to the value. If *lock* is a :class:`Lock` or :class:" @@ -1745,28 +1730,28 @@ msgid "" "safe\"." msgstr "" -#: ../../library/multiprocessing.rst:1545 +#: ../../library/multiprocessing.rst:1534 msgid "Note that *lock* is a keyword only argument." msgstr "" -#: ../../library/multiprocessing.rst:1547 +#: ../../library/multiprocessing.rst:1536 msgid "" "Note that an array of :data:`ctypes.c_char` has *value* and *raw* attributes " "which allow one to use it to store and retrieve strings." msgstr "" -#: ../../library/multiprocessing.rst:1552 +#: ../../library/multiprocessing.rst:1541 msgid "The :mod:`multiprocessing.sharedctypes` module" msgstr "" -#: ../../library/multiprocessing.rst:1557 +#: ../../library/multiprocessing.rst:1546 msgid "" "The :mod:`multiprocessing.sharedctypes` module provides functions for " "allocating :mod:`ctypes` objects from shared memory which can be inherited " "by child processes." msgstr "" -#: ../../library/multiprocessing.rst:1563 +#: ../../library/multiprocessing.rst:1552 msgid "" "Although it is possible to store a pointer in shared memory remember that " "this will refer to a location in the address space of a specific process. " @@ -1775,11 +1760,11 @@ msgid "" "may cause a crash." msgstr "" -#: ../../library/multiprocessing.rst:1571 +#: ../../library/multiprocessing.rst:1560 msgid "Return a ctypes array allocated from shared memory." msgstr "" -#: ../../library/multiprocessing.rst:1573 +#: ../../library/multiprocessing.rst:1562 msgid "" "*typecode_or_type* determines the type of the elements of the returned " "array: it is either a ctypes type or a one character typecode of the kind " @@ -1789,40 +1774,40 @@ msgid "" "initialize the array and whose length determines the length of the array." msgstr "" -#: ../../library/multiprocessing.rst:1580 +#: ../../library/multiprocessing.rst:1569 msgid "" "Note that setting and getting an element is potentially non-atomic -- use :" "func:`Array` instead to make sure that access is automatically synchronized " "using a lock." msgstr "" -#: ../../library/multiprocessing.rst:1586 +#: ../../library/multiprocessing.rst:1575 msgid "Return a ctypes object allocated from shared memory." msgstr "" -#: ../../library/multiprocessing.rst:1592 +#: ../../library/multiprocessing.rst:1581 msgid "" "Note that setting and getting the value is potentially non-atomic -- use :" "func:`Value` instead to make sure that access is automatically synchronized " "using a lock." msgstr "" -#: ../../library/multiprocessing.rst:1596 +#: ../../library/multiprocessing.rst:1585 msgid "" "Note that an array of :data:`ctypes.c_char` has ``value`` and ``raw`` " "attributes which allow one to use it to store and retrieve strings -- see " "documentation for :mod:`ctypes`." msgstr "" -#: ../../library/multiprocessing.rst:1602 +#: ../../library/multiprocessing.rst:1591 msgid "" "The same as :func:`RawArray` except that depending on the value of *lock* a " "process-safe synchronization wrapper may be returned instead of a raw ctypes " "array." msgstr "" -#: ../../library/multiprocessing.rst:1606 -#: ../../library/multiprocessing.rst:1622 +#: ../../library/multiprocessing.rst:1595 +#: ../../library/multiprocessing.rst:1611 msgid "" "If *lock* is ``True`` (the default) then a new lock object is created to " "synchronize access to the value. If *lock* is a :class:`~multiprocessing." @@ -1832,121 +1817,121 @@ msgid "" "not necessarily be \"process-safe\"." msgstr "" -#: ../../library/multiprocessing.rst:1618 +#: ../../library/multiprocessing.rst:1607 msgid "" "The same as :func:`RawValue` except that depending on the value of *lock* a " "process-safe synchronization wrapper may be returned instead of a raw ctypes " "object." msgstr "" -#: ../../library/multiprocessing.rst:1633 +#: ../../library/multiprocessing.rst:1622 msgid "" "Return a ctypes object allocated from shared memory which is a copy of the " "ctypes object *obj*." msgstr "" -#: ../../library/multiprocessing.rst:1638 +#: ../../library/multiprocessing.rst:1627 msgid "" "Return a process-safe wrapper object for a ctypes object which uses *lock* " "to synchronize access. If *lock* is ``None`` (the default) then a :class:" "`multiprocessing.RLock` object is created automatically." msgstr "" -#: ../../library/multiprocessing.rst:1642 +#: ../../library/multiprocessing.rst:1631 msgid "" "A synchronized wrapper will have two methods in addition to those of the " "object it wraps: :meth:`get_obj` returns the wrapped object and :meth:" "`get_lock` returns the lock object used for synchronization." msgstr "" -#: ../../library/multiprocessing.rst:1646 +#: ../../library/multiprocessing.rst:1635 msgid "" "Note that accessing the ctypes object through the wrapper can be a lot " "slower than accessing the raw ctypes object." msgstr "" -#: ../../library/multiprocessing.rst:1649 +#: ../../library/multiprocessing.rst:1638 msgid "Synchronized objects support the :term:`context manager` protocol." msgstr "" -#: ../../library/multiprocessing.rst:1653 +#: ../../library/multiprocessing.rst:1642 msgid "" "The table below compares the syntax for creating shared ctypes objects from " "shared memory with the normal ctypes syntax. (In the table ``MyStruct`` is " "some subclass of :class:`ctypes.Structure`.)" msgstr "" -#: ../../library/multiprocessing.rst:1658 +#: ../../library/multiprocessing.rst:1647 msgid "ctypes" msgstr "ctypes" -#: ../../library/multiprocessing.rst:1658 +#: ../../library/multiprocessing.rst:1647 msgid "sharedctypes using type" msgstr "" -#: ../../library/multiprocessing.rst:1658 +#: ../../library/multiprocessing.rst:1647 msgid "sharedctypes using typecode" msgstr "" -#: ../../library/multiprocessing.rst:1660 +#: ../../library/multiprocessing.rst:1649 msgid "c_double(2.4)" msgstr "c_double(2.4)" -#: ../../library/multiprocessing.rst:1660 +#: ../../library/multiprocessing.rst:1649 msgid "RawValue(c_double, 2.4)" msgstr "RawValue(c_double, 2.4)" -#: ../../library/multiprocessing.rst:1660 +#: ../../library/multiprocessing.rst:1649 msgid "RawValue('d', 2.4)" msgstr "RawValue('d', 2.4)" -#: ../../library/multiprocessing.rst:1661 +#: ../../library/multiprocessing.rst:1650 msgid "MyStruct(4, 6)" msgstr "MyStruct(4, 6)" -#: ../../library/multiprocessing.rst:1661 +#: ../../library/multiprocessing.rst:1650 msgid "RawValue(MyStruct, 4, 6)" msgstr "RawValue(MyStruct, 4, 6)" -#: ../../library/multiprocessing.rst:1662 +#: ../../library/multiprocessing.rst:1651 msgid "(c_short * 7)()" msgstr "(c_short * 7)()" -#: ../../library/multiprocessing.rst:1662 +#: ../../library/multiprocessing.rst:1651 msgid "RawArray(c_short, 7)" msgstr "RawArray(c_short, 7)" -#: ../../library/multiprocessing.rst:1662 +#: ../../library/multiprocessing.rst:1651 msgid "RawArray('h', 7)" msgstr "RawArray('h', 7)" -#: ../../library/multiprocessing.rst:1663 +#: ../../library/multiprocessing.rst:1652 msgid "(c_int * 3)(9, 2, 8)" msgstr "(c_int * 3)(9, 2, 8)" -#: ../../library/multiprocessing.rst:1663 +#: ../../library/multiprocessing.rst:1652 msgid "RawArray(c_int, (9, 2, 8))" msgstr "RawArray(c_int, (9, 2, 8))" -#: ../../library/multiprocessing.rst:1663 +#: ../../library/multiprocessing.rst:1652 msgid "RawArray('i', (9, 2, 8))" msgstr "RawArray('i', (9, 2, 8))" -#: ../../library/multiprocessing.rst:1667 +#: ../../library/multiprocessing.rst:1656 msgid "" "Below is an example where a number of ctypes objects are modified by a child " "process::" msgstr "" -#: ../../library/multiprocessing.rst:1705 +#: ../../library/multiprocessing.rst:1694 msgid "The results printed are ::" msgstr "" -#: ../../library/multiprocessing.rst:1718 +#: ../../library/multiprocessing.rst:1707 msgid "Managers" msgstr "" -#: ../../library/multiprocessing.rst:1720 +#: ../../library/multiprocessing.rst:1709 msgid "" "Managers provide a way to create data which can be shared between different " "processes, including sharing over a network between processes running on " @@ -1955,7 +1940,7 @@ msgid "" "proxies." msgstr "" -#: ../../library/multiprocessing.rst:1729 +#: ../../library/multiprocessing.rst:1718 msgid "" "Returns a started :class:`~multiprocessing.managers.SyncManager` object " "which can be used for sharing objects between processes. The returned " @@ -1963,31 +1948,31 @@ msgid "" "will create shared objects and return corresponding proxies." msgstr "" -#: ../../library/multiprocessing.rst:1737 +#: ../../library/multiprocessing.rst:1726 msgid "" "Manager processes will be shutdown as soon as they are garbage collected or " "their parent process exits. The manager classes are defined in the :mod:" "`multiprocessing.managers` module:" msgstr "" -#: ../../library/multiprocessing.rst:1743 +#: ../../library/multiprocessing.rst:1732 msgid "Create a BaseManager object." msgstr "" -#: ../../library/multiprocessing.rst:1745 +#: ../../library/multiprocessing.rst:1734 msgid "" "Once created one should call :meth:`start` or ``get_server()." "serve_forever()`` to ensure that the manager object refers to a started " "manager process." msgstr "" -#: ../../library/multiprocessing.rst:1748 +#: ../../library/multiprocessing.rst:1737 msgid "" "*address* is the address on which the manager process listens for new " "connections. If *address* is ``None`` then an arbitrary one is chosen." msgstr "" -#: ../../library/multiprocessing.rst:1751 +#: ../../library/multiprocessing.rst:1740 msgid "" "*authkey* is the authentication key which will be used to check the validity " "of incoming connections to the server process. If *authkey* is ``None`` " @@ -1995,19 +1980,19 @@ msgid "" "it must be a byte string." msgstr "" -#: ../../library/multiprocessing.rst:1756 +#: ../../library/multiprocessing.rst:1745 msgid "" "*serializer* must be ``'pickle'`` (use :mod:`pickle` serialization) or " "``'xmlrpclib'`` (use :mod:`xmlrpc.client` serialization)." msgstr "" -#: ../../library/multiprocessing.rst:1759 +#: ../../library/multiprocessing.rst:1748 msgid "" "*ctx* is a context object, or ``None`` (use the current context). See the :" "func:`get_context` function." msgstr "" -#: ../../library/multiprocessing.rst:1762 +#: ../../library/multiprocessing.rst:1751 msgid "" "*shutdown_timeout* is a timeout in seconds used to wait until the process " "used by the manager completes in the :meth:`shutdown` method. If the " @@ -2015,54 +2000,54 @@ msgid "" "also times out, the process is killed." msgstr "" -#: ../../library/multiprocessing.rst:1767 +#: ../../library/multiprocessing.rst:1756 msgid "Added the *shutdown_timeout* parameter." msgstr "新增 *shutdown_timeout* 參數。" -#: ../../library/multiprocessing.rst:1772 +#: ../../library/multiprocessing.rst:1761 msgid "" "Start a subprocess to start the manager. If *initializer* is not ``None`` " "then the subprocess will call ``initializer(*initargs)`` when it starts." msgstr "" -#: ../../library/multiprocessing.rst:1777 +#: ../../library/multiprocessing.rst:1766 msgid "" "Returns a :class:`Server` object which represents the actual server under " "the control of the Manager. The :class:`Server` object supports the :meth:" "`serve_forever` method::" msgstr "" -#: ../../library/multiprocessing.rst:1786 +#: ../../library/multiprocessing.rst:1775 msgid ":class:`Server` additionally has an :attr:`address` attribute." msgstr "" -#: ../../library/multiprocessing.rst:1790 +#: ../../library/multiprocessing.rst:1779 msgid "Connect a local manager object to a remote manager process::" msgstr "" -#: ../../library/multiprocessing.rst:1798 +#: ../../library/multiprocessing.rst:1787 msgid "" "Stop the process used by the manager. This is only available if :meth:" "`start` has been used to start the server process." msgstr "" -#: ../../library/multiprocessing.rst:1801 +#: ../../library/multiprocessing.rst:1790 msgid "This can be called multiple times." msgstr "" -#: ../../library/multiprocessing.rst:1805 +#: ../../library/multiprocessing.rst:1794 msgid "" "A classmethod which can be used for registering a type or callable with the " "manager class." msgstr "" -#: ../../library/multiprocessing.rst:1808 +#: ../../library/multiprocessing.rst:1797 msgid "" "*typeid* is a \"type identifier\" which is used to identify a particular " "type of shared object. This must be a string." msgstr "" -#: ../../library/multiprocessing.rst:1811 +#: ../../library/multiprocessing.rst:1800 msgid "" "*callable* is a callable used for creating objects for this type " "identifier. If a manager instance will be connected to the server using " @@ -2070,14 +2055,14 @@ msgid "" "then this can be left as ``None``." msgstr "" -#: ../../library/multiprocessing.rst:1817 +#: ../../library/multiprocessing.rst:1806 msgid "" "*proxytype* is a subclass of :class:`BaseProxy` which is used to create " "proxies for shared objects with this *typeid*. If ``None`` then a proxy " "class is created automatically." msgstr "" -#: ../../library/multiprocessing.rst:1821 +#: ../../library/multiprocessing.rst:1810 msgid "" "*exposed* is used to specify a sequence of method names which proxies for " "this typeid should be allowed to access using :meth:`BaseProxy." @@ -2088,7 +2073,7 @@ msgid "" "method and whose name does not begin with ``'_'``.)" msgstr "" -#: ../../library/multiprocessing.rst:1830 +#: ../../library/multiprocessing.rst:1819 msgid "" "*method_to_typeid* is a mapping used to specify the return type of those " "exposed methods which should return a proxy. It maps method names to typeid " @@ -2098,22 +2083,22 @@ msgid "" "returned by the method will be copied by value." msgstr "" -#: ../../library/multiprocessing.rst:1837 +#: ../../library/multiprocessing.rst:1826 msgid "" "*create_method* determines whether a method should be created with name " "*typeid* which can be used to tell the server process to create a new shared " "object and return a proxy for it. By default it is ``True``." msgstr "" -#: ../../library/multiprocessing.rst:1841 +#: ../../library/multiprocessing.rst:1830 msgid ":class:`BaseManager` instances also have one read-only property:" msgstr "" -#: ../../library/multiprocessing.rst:1845 +#: ../../library/multiprocessing.rst:1834 msgid "The address used by the manager." msgstr "" -#: ../../library/multiprocessing.rst:1847 +#: ../../library/multiprocessing.rst:1836 msgid "" "Manager objects support the context management protocol -- see :ref:" "`typecontextmanager`. :meth:`~contextmanager.__enter__` starts the server " @@ -2121,173 +2106,173 @@ msgid "" "object. :meth:`~contextmanager.__exit__` calls :meth:`shutdown`." msgstr "" -#: ../../library/multiprocessing.rst:1853 +#: ../../library/multiprocessing.rst:1842 msgid "" "In previous versions :meth:`~contextmanager.__enter__` did not start the " "manager's server process if it was not already started." msgstr "" -#: ../../library/multiprocessing.rst:1858 +#: ../../library/multiprocessing.rst:1847 msgid "" "A subclass of :class:`BaseManager` which can be used for the synchronization " "of processes. Objects of this type are returned by :func:`multiprocessing." "Manager`." msgstr "" -#: ../../library/multiprocessing.rst:1862 +#: ../../library/multiprocessing.rst:1851 msgid "" "Its methods create and return :ref:`multiprocessing-proxy_objects` for a " "number of commonly used data types to be synchronized across processes. This " "notably includes shared lists and dictionaries." msgstr "" -#: ../../library/multiprocessing.rst:1868 +#: ../../library/multiprocessing.rst:1857 msgid "" "Create a shared :class:`threading.Barrier` object and return a proxy for it." msgstr "" -#: ../../library/multiprocessing.rst:1875 +#: ../../library/multiprocessing.rst:1864 msgid "" "Create a shared :class:`threading.BoundedSemaphore` object and return a " "proxy for it." msgstr "" -#: ../../library/multiprocessing.rst:1880 +#: ../../library/multiprocessing.rst:1869 msgid "" "Create a shared :class:`threading.Condition` object and return a proxy for " "it." msgstr "" -#: ../../library/multiprocessing.rst:1883 +#: ../../library/multiprocessing.rst:1872 msgid "" "If *lock* is supplied then it should be a proxy for a :class:`threading." "Lock` or :class:`threading.RLock` object." msgstr "" -#: ../../library/multiprocessing.rst:1891 +#: ../../library/multiprocessing.rst:1880 msgid "" "Create a shared :class:`threading.Event` object and return a proxy for it." msgstr "" -#: ../../library/multiprocessing.rst:1895 +#: ../../library/multiprocessing.rst:1884 msgid "" "Create a shared :class:`threading.Lock` object and return a proxy for it." msgstr "" -#: ../../library/multiprocessing.rst:1899 +#: ../../library/multiprocessing.rst:1888 msgid "Create a shared :class:`Namespace` object and return a proxy for it." msgstr "" -#: ../../library/multiprocessing.rst:1903 +#: ../../library/multiprocessing.rst:1892 msgid "Create a shared :class:`queue.Queue` object and return a proxy for it." msgstr "" -#: ../../library/multiprocessing.rst:1907 +#: ../../library/multiprocessing.rst:1896 msgid "" "Create a shared :class:`threading.RLock` object and return a proxy for it." msgstr "" -#: ../../library/multiprocessing.rst:1911 +#: ../../library/multiprocessing.rst:1900 msgid "" "Create a shared :class:`threading.Semaphore` object and return a proxy for " "it." msgstr "" -#: ../../library/multiprocessing.rst:1916 +#: ../../library/multiprocessing.rst:1905 msgid "Create an array and return a proxy for it." msgstr "" -#: ../../library/multiprocessing.rst:1920 +#: ../../library/multiprocessing.rst:1909 msgid "" "Create an object with a writable ``value`` attribute and return a proxy for " "it." msgstr "" -#: ../../library/multiprocessing.rst:1927 +#: ../../library/multiprocessing.rst:1916 msgid "Create a shared :class:`dict` object and return a proxy for it." msgstr "" -#: ../../library/multiprocessing.rst:1932 +#: ../../library/multiprocessing.rst:1921 msgid "Create a shared :class:`list` object and return a proxy for it." msgstr "" -#: ../../library/multiprocessing.rst:1934 +#: ../../library/multiprocessing.rst:1923 msgid "" "Shared objects are capable of being nested. For example, a shared container " "object such as a shared list can contain other shared objects which will all " "be managed and synchronized by the :class:`SyncManager`." msgstr "" -#: ../../library/multiprocessing.rst:1941 +#: ../../library/multiprocessing.rst:1930 msgid "A type that can register with :class:`SyncManager`." msgstr "" -#: ../../library/multiprocessing.rst:1943 +#: ../../library/multiprocessing.rst:1932 msgid "" "A namespace object has no public methods, but does have writable attributes. " "Its representation shows the values of its attributes." msgstr "" -#: ../../library/multiprocessing.rst:1946 +#: ../../library/multiprocessing.rst:1935 msgid "" "However, when using a proxy for a namespace object, an attribute beginning " "with ``'_'`` will be an attribute of the proxy and not an attribute of the " "referent:" msgstr "" -#: ../../library/multiprocessing.rst:1963 +#: ../../library/multiprocessing.rst:1952 msgid "Customized managers" msgstr "" -#: ../../library/multiprocessing.rst:1965 +#: ../../library/multiprocessing.rst:1954 msgid "" "To create one's own manager, one creates a subclass of :class:`BaseManager` " "and uses the :meth:`~BaseManager.register` classmethod to register new types " "or callables with the manager class. For example::" msgstr "" -#: ../../library/multiprocessing.rst:1990 +#: ../../library/multiprocessing.rst:1979 msgid "Using a remote manager" msgstr "" -#: ../../library/multiprocessing.rst:1992 +#: ../../library/multiprocessing.rst:1981 msgid "" "It is possible to run a manager server on one machine and have clients use " "it from other machines (assuming that the firewalls involved allow it)." msgstr "" -#: ../../library/multiprocessing.rst:1995 +#: ../../library/multiprocessing.rst:1984 msgid "" "Running the following commands creates a server for a single shared queue " "which remote clients can access::" msgstr "" -#: ../../library/multiprocessing.rst:2007 +#: ../../library/multiprocessing.rst:1996 msgid "One client can access the server as follows::" msgstr "" -#: ../../library/multiprocessing.rst:2017 +#: ../../library/multiprocessing.rst:2006 msgid "Another client can also use it::" msgstr "" -#: ../../library/multiprocessing.rst:2028 +#: ../../library/multiprocessing.rst:2017 msgid "" "Local processes can also access that queue, using the code from above on the " "client to access it remotely::" msgstr "" -#: ../../library/multiprocessing.rst:2053 +#: ../../library/multiprocessing.rst:2042 msgid "Proxy Objects" msgstr "" -#: ../../library/multiprocessing.rst:2055 +#: ../../library/multiprocessing.rst:2044 msgid "" "A proxy is an object which *refers* to a shared object which lives " "(presumably) in a different process. The shared object is said to be the " "*referent* of the proxy. Multiple proxy objects may have the same referent." msgstr "" -#: ../../library/multiprocessing.rst:2059 +#: ../../library/multiprocessing.rst:2048 msgid "" "A proxy object has methods which invoke corresponding methods of its " "referent (although not every method of the referent will necessarily be " @@ -2295,14 +2280,14 @@ msgid "" "its referent can:" msgstr "" -#: ../../library/multiprocessing.rst:2077 +#: ../../library/multiprocessing.rst:2066 msgid "" "Notice that applying :func:`str` to a proxy will return the representation " "of the referent, whereas applying :func:`repr` will return the " "representation of the proxy." msgstr "" -#: ../../library/multiprocessing.rst:2081 +#: ../../library/multiprocessing.rst:2070 msgid "" "An important feature of proxy objects is that they are picklable so they can " "be passed between processes. As such, a referent can contain :ref:" @@ -2310,11 +2295,11 @@ msgid "" "lists, dicts, and other :ref:`multiprocessing-proxy_objects`:" msgstr "" -#: ../../library/multiprocessing.rst:2097 +#: ../../library/multiprocessing.rst:2086 msgid "Similarly, dict and list proxies may be nested inside one another::" msgstr "" -#: ../../library/multiprocessing.rst:2110 +#: ../../library/multiprocessing.rst:2099 msgid "" "If standard (non-proxy) :class:`list` or :class:`dict` objects are contained " "in a referent, modifications to those mutable values will not be propagated " @@ -2325,53 +2310,53 @@ msgid "" "assign the modified value to the container proxy::" msgstr "" -#: ../../library/multiprocessing.rst:2129 +#: ../../library/multiprocessing.rst:2118 msgid "" "This approach is perhaps less convenient than employing nested :ref:" "`multiprocessing-proxy_objects` for most use cases but also demonstrates a " "level of control over the synchronization." msgstr "" -#: ../../library/multiprocessing.rst:2135 +#: ../../library/multiprocessing.rst:2124 msgid "" "The proxy types in :mod:`multiprocessing` do nothing to support comparisons " "by value. So, for instance, we have:" msgstr "" -#: ../../library/multiprocessing.rst:2143 +#: ../../library/multiprocessing.rst:2132 msgid "" "One should just use a copy of the referent instead when making comparisons." msgstr "" -#: ../../library/multiprocessing.rst:2147 +#: ../../library/multiprocessing.rst:2136 msgid "Proxy objects are instances of subclasses of :class:`BaseProxy`." msgstr "" -#: ../../library/multiprocessing.rst:2151 +#: ../../library/multiprocessing.rst:2140 msgid "Call and return the result of a method of the proxy's referent." msgstr "" -#: ../../library/multiprocessing.rst:2153 +#: ../../library/multiprocessing.rst:2142 msgid "" "If ``proxy`` is a proxy whose referent is ``obj`` then the expression ::" msgstr "" -#: ../../library/multiprocessing.rst:2157 +#: ../../library/multiprocessing.rst:2146 msgid "will evaluate the expression ::" msgstr "" -#: ../../library/multiprocessing.rst:2161 +#: ../../library/multiprocessing.rst:2150 msgid "in the manager's process." msgstr "" -#: ../../library/multiprocessing.rst:2163 +#: ../../library/multiprocessing.rst:2152 msgid "" "The returned value will be a copy of the result of the call or a proxy to a " "new shared object -- see documentation for the *method_to_typeid* argument " "of :meth:`BaseManager.register`." msgstr "" -#: ../../library/multiprocessing.rst:2167 +#: ../../library/multiprocessing.rst:2156 msgid "" "If an exception is raised by the call, then is re-raised by :meth:" "`_callmethod`. If some other exception is raised in the manager's process " @@ -2379,79 +2364,79 @@ msgid "" "meth:`_callmethod`." msgstr "" -#: ../../library/multiprocessing.rst:2172 +#: ../../library/multiprocessing.rst:2161 msgid "" "Note in particular that an exception will be raised if *methodname* has not " "been *exposed*." msgstr "" -#: ../../library/multiprocessing.rst:2175 +#: ../../library/multiprocessing.rst:2164 msgid "An example of the usage of :meth:`_callmethod`:" msgstr "" -#: ../../library/multiprocessing.rst:2191 +#: ../../library/multiprocessing.rst:2180 msgid "Return a copy of the referent." msgstr "" -#: ../../library/multiprocessing.rst:2193 +#: ../../library/multiprocessing.rst:2182 msgid "If the referent is unpicklable then this will raise an exception." msgstr "" -#: ../../library/multiprocessing.rst:2197 +#: ../../library/multiprocessing.rst:2186 msgid "Return a representation of the proxy object." msgstr "" -#: ../../library/multiprocessing.rst:2201 +#: ../../library/multiprocessing.rst:2190 msgid "Return the representation of the referent." msgstr "" -#: ../../library/multiprocessing.rst:2205 +#: ../../library/multiprocessing.rst:2194 msgid "Cleanup" msgstr "" -#: ../../library/multiprocessing.rst:2207 +#: ../../library/multiprocessing.rst:2196 msgid "" "A proxy object uses a weakref callback so that when it gets garbage " "collected it deregisters itself from the manager which owns its referent." msgstr "" -#: ../../library/multiprocessing.rst:2210 +#: ../../library/multiprocessing.rst:2199 msgid "" "A shared object gets deleted from the manager process when there are no " "longer any proxies referring to it." msgstr "" -#: ../../library/multiprocessing.rst:2215 +#: ../../library/multiprocessing.rst:2204 msgid "Process Pools" msgstr "" -#: ../../library/multiprocessing.rst:2220 +#: ../../library/multiprocessing.rst:2209 msgid "" "One can create a pool of processes which will carry out tasks submitted to " "it with the :class:`Pool` class." msgstr "" -#: ../../library/multiprocessing.rst:2225 +#: ../../library/multiprocessing.rst:2214 msgid "" "A process pool object which controls a pool of worker processes to which " "jobs can be submitted. It supports asynchronous results with timeouts and " "callbacks and has a parallel map implementation." msgstr "" -#: ../../library/multiprocessing.rst:2229 +#: ../../library/multiprocessing.rst:2218 msgid "" "*processes* is the number of worker processes to use. If *processes* is " "``None`` then the number returned by :func:`os.cpu_count` is used." msgstr "" -#: ../../library/multiprocessing.rst:2232 -#: ../../library/multiprocessing.rst:2793 +#: ../../library/multiprocessing.rst:2221 +#: ../../library/multiprocessing.rst:2782 msgid "" "If *initializer* is not ``None`` then each worker process will call " "``initializer(*initargs)`` when it starts." msgstr "" -#: ../../library/multiprocessing.rst:2235 +#: ../../library/multiprocessing.rst:2224 msgid "" "*maxtasksperchild* is the number of tasks a worker process can complete " "before it will exit and be replaced with a fresh worker process, to enable " @@ -2459,7 +2444,7 @@ msgid "" "which means worker processes will live as long as the pool." msgstr "" -#: ../../library/multiprocessing.rst:2240 +#: ../../library/multiprocessing.rst:2229 msgid "" "*context* can be used to specify the context used for starting the worker " "processes. Usually a pool is created using the function :func:" @@ -2467,13 +2452,13 @@ msgid "" "both cases *context* is set appropriately." msgstr "" -#: ../../library/multiprocessing.rst:2246 +#: ../../library/multiprocessing.rst:2235 msgid "" "Note that the methods of the pool object should only be called by the " "process which created the pool." msgstr "" -#: ../../library/multiprocessing.rst:2250 +#: ../../library/multiprocessing.rst:2239 msgid "" ":class:`multiprocessing.pool` objects have internal resources that need to " "be properly managed (like any other resource) by using the pool as a context " @@ -2481,22 +2466,22 @@ msgid "" "to do this can lead to the process hanging on finalization." msgstr "" -#: ../../library/multiprocessing.rst:2255 +#: ../../library/multiprocessing.rst:2244 msgid "" "Note that it is **not correct** to rely on the garbage collector to destroy " "the pool as CPython does not assure that the finalizer of the pool will be " "called (see :meth:`object.__del__` for more information)." msgstr "" -#: ../../library/multiprocessing.rst:2259 +#: ../../library/multiprocessing.rst:2248 msgid "Added the *maxtasksperchild* parameter." msgstr "新增 *maxtasksperchild* 參數。" -#: ../../library/multiprocessing.rst:2262 +#: ../../library/multiprocessing.rst:2251 msgid "Added the *context* parameter." msgstr "新增 *context* 參數。" -#: ../../library/multiprocessing.rst:2267 +#: ../../library/multiprocessing.rst:2256 msgid "" "Worker processes within a :class:`Pool` typically live for the complete " "duration of the Pool's work queue. A frequent pattern found in other systems " @@ -2507,7 +2492,7 @@ msgid "" "ability to the end user." msgstr "" -#: ../../library/multiprocessing.rst:2277 +#: ../../library/multiprocessing.rst:2266 msgid "" "Call *func* with arguments *args* and keyword arguments *kwds*. It blocks " "until the result is ready. Given this blocks, :meth:`apply_async` is better " @@ -2515,14 +2500,14 @@ msgid "" "executed in one of the workers of the pool." msgstr "" -#: ../../library/multiprocessing.rst:2284 +#: ../../library/multiprocessing.rst:2273 msgid "" "A variant of the :meth:`apply` method which returns a :class:" "`~multiprocessing.pool.AsyncResult` object." msgstr "" -#: ../../library/multiprocessing.rst:2287 -#: ../../library/multiprocessing.rst:2318 +#: ../../library/multiprocessing.rst:2276 +#: ../../library/multiprocessing.rst:2307 msgid "" "If *callback* is specified then it should be a callable which accepts a " "single argument. When the result becomes ready *callback* is applied to it, " @@ -2530,60 +2515,60 @@ msgid "" "applied instead." msgstr "" -#: ../../library/multiprocessing.rst:2292 -#: ../../library/multiprocessing.rst:2323 +#: ../../library/multiprocessing.rst:2281 +#: ../../library/multiprocessing.rst:2312 msgid "" "If *error_callback* is specified then it should be a callable which accepts " "a single argument. If the target function fails, then the *error_callback* " "is called with the exception instance." msgstr "" -#: ../../library/multiprocessing.rst:2296 -#: ../../library/multiprocessing.rst:2327 +#: ../../library/multiprocessing.rst:2285 +#: ../../library/multiprocessing.rst:2316 msgid "" "Callbacks should complete immediately since otherwise the thread which " "handles the results will get blocked." msgstr "" -#: ../../library/multiprocessing.rst:2301 +#: ../../library/multiprocessing.rst:2290 msgid "" "A parallel equivalent of the :func:`map` built-in function (it supports only " "one *iterable* argument though, for multiple iterables see :meth:`starmap`). " "It blocks until the result is ready." msgstr "" -#: ../../library/multiprocessing.rst:2305 +#: ../../library/multiprocessing.rst:2294 msgid "" "This method chops the iterable into a number of chunks which it submits to " "the process pool as separate tasks. The (approximate) size of these chunks " "can be specified by setting *chunksize* to a positive integer." msgstr "" -#: ../../library/multiprocessing.rst:2309 +#: ../../library/multiprocessing.rst:2298 msgid "" "Note that it may cause high memory usage for very long iterables. Consider " "using :meth:`imap` or :meth:`imap_unordered` with explicit *chunksize* " "option for better efficiency." msgstr "" -#: ../../library/multiprocessing.rst:2315 +#: ../../library/multiprocessing.rst:2304 msgid "" "A variant of the :meth:`.map` method which returns a :class:" "`~multiprocessing.pool.AsyncResult` object." msgstr "" -#: ../../library/multiprocessing.rst:2332 +#: ../../library/multiprocessing.rst:2321 msgid "A lazier version of :meth:`.map`." msgstr "" -#: ../../library/multiprocessing.rst:2334 +#: ../../library/multiprocessing.rst:2323 msgid "" "The *chunksize* argument is the same as the one used by the :meth:`.map` " "method. For very long iterables using a large value for *chunksize* can " "make the job complete **much** faster than using the default value of ``1``." msgstr "" -#: ../../library/multiprocessing.rst:2339 +#: ../../library/multiprocessing.rst:2328 msgid "" "Also if *chunksize* is ``1`` then the :meth:`!next` method of the iterator " "returned by the :meth:`imap` method has an optional *timeout* parameter: " @@ -2591,65 +2576,65 @@ msgid "" "result cannot be returned within *timeout* seconds." msgstr "" -#: ../../library/multiprocessing.rst:2346 +#: ../../library/multiprocessing.rst:2335 msgid "" "The same as :meth:`imap` except that the ordering of the results from the " "returned iterator should be considered arbitrary. (Only when there is only " "one worker process is the order guaranteed to be \"correct\".)" msgstr "" -#: ../../library/multiprocessing.rst:2352 +#: ../../library/multiprocessing.rst:2341 msgid "" "Like :meth:`~multiprocessing.pool.Pool.map` except that the elements of the " "*iterable* are expected to be iterables that are unpacked as arguments." msgstr "" -#: ../../library/multiprocessing.rst:2356 +#: ../../library/multiprocessing.rst:2345 msgid "" "Hence an *iterable* of ``[(1,2), (3, 4)]`` results in ``[func(1,2), " "func(3,4)]``." msgstr "" -#: ../../library/multiprocessing.rst:2363 +#: ../../library/multiprocessing.rst:2352 msgid "" "A combination of :meth:`starmap` and :meth:`map_async` that iterates over " "*iterable* of iterables and calls *func* with the iterables unpacked. " "Returns a result object." msgstr "" -#: ../../library/multiprocessing.rst:2371 +#: ../../library/multiprocessing.rst:2360 msgid "" "Prevents any more tasks from being submitted to the pool. Once all the " "tasks have been completed the worker processes will exit." msgstr "" -#: ../../library/multiprocessing.rst:2376 +#: ../../library/multiprocessing.rst:2365 msgid "" "Stops the worker processes immediately without completing outstanding work. " "When the pool object is garbage collected :meth:`terminate` will be called " "immediately." msgstr "" -#: ../../library/multiprocessing.rst:2382 +#: ../../library/multiprocessing.rst:2371 msgid "" "Wait for the worker processes to exit. One must call :meth:`close` or :meth:" "`terminate` before using :meth:`join`." msgstr "" -#: ../../library/multiprocessing.rst:2385 +#: ../../library/multiprocessing.rst:2374 msgid "" "Pool objects now support the context management protocol -- see :ref:" "`typecontextmanager`. :meth:`~contextmanager.__enter__` returns the pool " "object, and :meth:`~contextmanager.__exit__` calls :meth:`terminate`." msgstr "" -#: ../../library/multiprocessing.rst:2393 +#: ../../library/multiprocessing.rst:2382 msgid "" "The class of the result returned by :meth:`Pool.apply_async` and :meth:`Pool." "map_async`." msgstr "" -#: ../../library/multiprocessing.rst:2398 +#: ../../library/multiprocessing.rst:2387 msgid "" "Return the result when it arrives. If *timeout* is not ``None`` and the " "result does not arrive within *timeout* seconds then :exc:`multiprocessing." @@ -2657,41 +2642,41 @@ msgid "" "exception will be reraised by :meth:`get`." msgstr "" -#: ../../library/multiprocessing.rst:2405 +#: ../../library/multiprocessing.rst:2394 msgid "Wait until the result is available or until *timeout* seconds pass." msgstr "" -#: ../../library/multiprocessing.rst:2409 +#: ../../library/multiprocessing.rst:2398 msgid "Return whether the call has completed." msgstr "" -#: ../../library/multiprocessing.rst:2413 +#: ../../library/multiprocessing.rst:2402 msgid "" "Return whether the call completed without raising an exception. Will raise :" "exc:`ValueError` if the result is not ready." msgstr "" -#: ../../library/multiprocessing.rst:2416 +#: ../../library/multiprocessing.rst:2405 msgid "" "If the result is not ready, :exc:`ValueError` is raised instead of :exc:" "`AssertionError`." msgstr "" -#: ../../library/multiprocessing.rst:2420 +#: ../../library/multiprocessing.rst:2409 msgid "The following example demonstrates the use of a pool::" msgstr "" -#: ../../library/multiprocessing.rst:2447 +#: ../../library/multiprocessing.rst:2436 msgid "Listeners and Clients" msgstr "" -#: ../../library/multiprocessing.rst:2452 +#: ../../library/multiprocessing.rst:2441 msgid "" "Usually message passing between processes is done using queues or by using :" "class:`~Connection` objects returned by :func:`~multiprocessing.Pipe`." msgstr "" -#: ../../library/multiprocessing.rst:2456 +#: ../../library/multiprocessing.rst:2445 msgid "" "However, the :mod:`multiprocessing.connection` module allows some extra " "flexibility. It basically gives a high level message oriented API for " @@ -2700,46 +2685,46 @@ msgid "" "multiple connections at the same time." msgstr "" -#: ../../library/multiprocessing.rst:2465 +#: ../../library/multiprocessing.rst:2454 msgid "" "Send a randomly generated message to the other end of the connection and " "wait for a reply." msgstr "" -#: ../../library/multiprocessing.rst:2468 +#: ../../library/multiprocessing.rst:2457 msgid "" "If the reply matches the digest of the message using *authkey* as the key " "then a welcome message is sent to the other end of the connection. " "Otherwise :exc:`~multiprocessing.AuthenticationError` is raised." msgstr "" -#: ../../library/multiprocessing.rst:2474 +#: ../../library/multiprocessing.rst:2463 msgid "" "Receive a message, calculate the digest of the message using *authkey* as " "the key, and then send the digest back." msgstr "" -#: ../../library/multiprocessing.rst:2477 +#: ../../library/multiprocessing.rst:2466 msgid "" "If a welcome message is not received, then :exc:`~multiprocessing." "AuthenticationError` is raised." msgstr "" -#: ../../library/multiprocessing.rst:2482 +#: ../../library/multiprocessing.rst:2471 msgid "" "Attempt to set up a connection to the listener which is using address " "*address*, returning a :class:`~Connection`." msgstr "" -#: ../../library/multiprocessing.rst:2485 +#: ../../library/multiprocessing.rst:2474 msgid "" "The type of the connection is determined by *family* argument, but this can " "generally be omitted since it can usually be inferred from the format of " "*address*. (See :ref:`multiprocessing-address-formats`)" msgstr "" -#: ../../library/multiprocessing.rst:2489 -#: ../../library/multiprocessing.rst:2524 +#: ../../library/multiprocessing.rst:2478 +#: ../../library/multiprocessing.rst:2513 msgid "" "If *authkey* is given and not ``None``, it should be a byte string and will " "be used as the secret key for an HMAC-based authentication challenge. No " @@ -2748,26 +2733,26 @@ msgid "" "`multiprocessing-auth-keys`." msgstr "" -#: ../../library/multiprocessing.rst:2497 +#: ../../library/multiprocessing.rst:2486 msgid "" "A wrapper for a bound socket or Windows named pipe which is 'listening' for " "connections." msgstr "" -#: ../../library/multiprocessing.rst:2500 +#: ../../library/multiprocessing.rst:2489 msgid "" "*address* is the address to be used by the bound socket or named pipe of the " "listener object." msgstr "" -#: ../../library/multiprocessing.rst:2505 +#: ../../library/multiprocessing.rst:2494 msgid "" "If an address of '0.0.0.0' is used, the address will not be a connectable " "end point on Windows. If you require a connectable end-point, you should use " "'127.0.0.1'." msgstr "" -#: ../../library/multiprocessing.rst:2509 +#: ../../library/multiprocessing.rst:2498 msgid "" "*family* is the type of socket (or named pipe) to use. This can be one of " "the strings ``'AF_INET'`` (for a TCP socket), ``'AF_UNIX'`` (for a Unix " @@ -2781,49 +2766,49 @@ msgid "" "using :func:`tempfile.mkstemp`." msgstr "" -#: ../../library/multiprocessing.rst:2520 +#: ../../library/multiprocessing.rst:2509 msgid "" "If the listener object uses a socket then *backlog* (1 by default) is passed " "to the :meth:`~socket.socket.listen` method of the socket once it has been " "bound." msgstr "" -#: ../../library/multiprocessing.rst:2532 +#: ../../library/multiprocessing.rst:2521 msgid "" "Accept a connection on the bound socket or named pipe of the listener object " "and return a :class:`~Connection` object. If authentication is attempted and " "fails, then :exc:`~multiprocessing.AuthenticationError` is raised." msgstr "" -#: ../../library/multiprocessing.rst:2539 +#: ../../library/multiprocessing.rst:2528 msgid "" "Close the bound socket or named pipe of the listener object. This is called " "automatically when the listener is garbage collected. However it is " "advisable to call it explicitly." msgstr "" -#: ../../library/multiprocessing.rst:2543 +#: ../../library/multiprocessing.rst:2532 msgid "Listener objects have the following read-only properties:" msgstr "" -#: ../../library/multiprocessing.rst:2547 +#: ../../library/multiprocessing.rst:2536 msgid "The address which is being used by the Listener object." msgstr "" -#: ../../library/multiprocessing.rst:2551 +#: ../../library/multiprocessing.rst:2540 msgid "" "The address from which the last accepted connection came. If this is " "unavailable then it is ``None``." msgstr "" -#: ../../library/multiprocessing.rst:2554 +#: ../../library/multiprocessing.rst:2543 msgid "" "Listener objects now support the context management protocol -- see :ref:" "`typecontextmanager`. :meth:`~contextmanager.__enter__` returns the " "listener object, and :meth:`~contextmanager.__exit__` calls :meth:`close`." msgstr "" -#: ../../library/multiprocessing.rst:2561 +#: ../../library/multiprocessing.rst:2550 msgid "" "Wait till an object in *object_list* is ready. Returns the list of those " "objects in *object_list* which are ready. If *timeout* is a float then the " @@ -2832,32 +2817,32 @@ msgid "" "zero timeout." msgstr "" -#: ../../library/multiprocessing.rst:2567 +#: ../../library/multiprocessing.rst:2556 msgid "" "For both POSIX and Windows, an object can appear in *object_list* if it is" msgstr "" -#: ../../library/multiprocessing.rst:2570 +#: ../../library/multiprocessing.rst:2559 msgid "a readable :class:`~multiprocessing.connection.Connection` object;" msgstr "" -#: ../../library/multiprocessing.rst:2571 +#: ../../library/multiprocessing.rst:2560 msgid "a connected and readable :class:`socket.socket` object; or" msgstr "" -#: ../../library/multiprocessing.rst:2572 +#: ../../library/multiprocessing.rst:2561 msgid "" "the :attr:`~multiprocessing.Process.sentinel` attribute of a :class:" "`~multiprocessing.Process` object." msgstr "" -#: ../../library/multiprocessing.rst:2575 +#: ../../library/multiprocessing.rst:2564 msgid "" "A connection or socket object is ready when there is data available to be " "read from it, or the other end has been closed." msgstr "" -#: ../../library/multiprocessing.rst:2578 +#: ../../library/multiprocessing.rst:2567 msgid "" "**POSIX**: ``wait(object_list, timeout)`` almost equivalent ``select." "select(object_list, [], [], timeout)``. The difference is that, if :func:" @@ -2865,7 +2850,7 @@ msgid "" "an error number of ``EINTR``, whereas :func:`wait` will not." msgstr "" -#: ../../library/multiprocessing.rst:2584 +#: ../../library/multiprocessing.rst:2573 msgid "" "**Windows**: An item in *object_list* must either be an integer handle which " "is waitable (according to the definition used by the documentation of the " @@ -2875,46 +2860,46 @@ msgid "" "handles.)" msgstr "" -#: ../../library/multiprocessing.rst:2594 +#: ../../library/multiprocessing.rst:2583 msgid "**Examples**" msgstr "" -#: ../../library/multiprocessing.rst:2596 +#: ../../library/multiprocessing.rst:2585 msgid "" "The following server code creates a listener which uses ``'secret " "password'`` as an authentication key. It then waits for a connection and " "sends some data to the client::" msgstr "" -#: ../../library/multiprocessing.rst:2615 +#: ../../library/multiprocessing.rst:2604 msgid "" "The following code connects to the server and receives some data from the " "server::" msgstr "" -#: ../../library/multiprocessing.rst:2632 +#: ../../library/multiprocessing.rst:2621 msgid "" "The following code uses :func:`~multiprocessing.connection.wait` to wait for " "messages from multiple processes at once::" msgstr "" -#: ../../library/multiprocessing.rst:2671 +#: ../../library/multiprocessing.rst:2660 msgid "Address Formats" msgstr "" -#: ../../library/multiprocessing.rst:2673 +#: ../../library/multiprocessing.rst:2662 msgid "" "An ``'AF_INET'`` address is a tuple of the form ``(hostname, port)`` where " "*hostname* is a string and *port* is an integer." msgstr "" -#: ../../library/multiprocessing.rst:2676 +#: ../../library/multiprocessing.rst:2665 msgid "" "An ``'AF_UNIX'`` address is a string representing a filename on the " "filesystem." msgstr "" -#: ../../library/multiprocessing.rst:2679 +#: ../../library/multiprocessing.rst:2668 msgid "" "An ``'AF_PIPE'`` address is a string of the form :samp:`r'\\\\\\\\\\\\.\\" "\\pipe\\\\\\\\{PipeName}'`. To use :func:`Client` to connect to a named " @@ -2923,17 +2908,17 @@ msgid "" "instead." msgstr "" -#: ../../library/multiprocessing.rst:2684 +#: ../../library/multiprocessing.rst:2673 msgid "" "Note that any string beginning with two backslashes is assumed by default to " "be an ``'AF_PIPE'`` address rather than an ``'AF_UNIX'`` address." msgstr "" -#: ../../library/multiprocessing.rst:2691 +#: ../../library/multiprocessing.rst:2680 msgid "Authentication keys" msgstr "" -#: ../../library/multiprocessing.rst:2693 +#: ../../library/multiprocessing.rst:2682 msgid "" "When one uses :meth:`Connection.recv `, the data received " "is automatically unpickled. Unfortunately unpickling data from an untrusted " @@ -2941,7 +2926,7 @@ msgid "" "use the :mod:`hmac` module to provide digest authentication." msgstr "" -#: ../../library/multiprocessing.rst:2699 +#: ../../library/multiprocessing.rst:2688 msgid "" "An authentication key is a byte string which can be thought of as a " "password: once a connection is established both ends will demand proof that " @@ -2949,7 +2934,7 @@ msgid "" "using the same key does **not** involve sending the key over the connection.)" msgstr "" -#: ../../library/multiprocessing.rst:2705 +#: ../../library/multiprocessing.rst:2694 msgid "" "If authentication is requested but no authentication key is specified then " "the return value of ``current_process().authkey`` is used (see :class:" @@ -2960,17 +2945,17 @@ msgid "" "setting up connections between themselves." msgstr "" -#: ../../library/multiprocessing.rst:2713 +#: ../../library/multiprocessing.rst:2702 msgid "" "Suitable authentication keys can also be generated by using :func:`os." "urandom`." msgstr "" -#: ../../library/multiprocessing.rst:2717 +#: ../../library/multiprocessing.rst:2706 msgid "Logging" msgstr "" -#: ../../library/multiprocessing.rst:2719 +#: ../../library/multiprocessing.rst:2708 msgid "" "Some support for logging is available. Note, however, that the :mod:" "`logging` package does not use process shared locks so it is possible " @@ -2978,27 +2963,27 @@ msgid "" "mixed up." msgstr "" -#: ../../library/multiprocessing.rst:2726 +#: ../../library/multiprocessing.rst:2715 msgid "" "Returns the logger used by :mod:`multiprocessing`. If necessary, a new one " "will be created." msgstr "" -#: ../../library/multiprocessing.rst:2729 +#: ../../library/multiprocessing.rst:2718 msgid "" "When first created the logger has level :const:`logging.NOTSET` and no " "default handler. Messages sent to this logger will not by default propagate " "to the root logger." msgstr "" -#: ../../library/multiprocessing.rst:2733 +#: ../../library/multiprocessing.rst:2722 msgid "" "Note that on Windows child processes will only inherit the level of the " "parent process's logger -- any other customization of the logger will not be " "inherited." msgstr "" -#: ../../library/multiprocessing.rst:2740 +#: ../../library/multiprocessing.rst:2729 msgid "" "This function performs a call to :func:`get_logger` but in addition to " "returning the logger created by get_logger, it adds a handler which sends " @@ -3007,25 +2992,25 @@ msgid "" "``level`` argument." msgstr "" -#: ../../library/multiprocessing.rst:2746 +#: ../../library/multiprocessing.rst:2735 msgid "Below is an example session with logging turned on::" msgstr "" -#: ../../library/multiprocessing.rst:2761 +#: ../../library/multiprocessing.rst:2750 msgid "For a full table of logging levels, see the :mod:`logging` module." msgstr "" -#: ../../library/multiprocessing.rst:2765 +#: ../../library/multiprocessing.rst:2754 msgid "The :mod:`multiprocessing.dummy` module" msgstr "" -#: ../../library/multiprocessing.rst:2770 +#: ../../library/multiprocessing.rst:2759 msgid "" ":mod:`multiprocessing.dummy` replicates the API of :mod:`multiprocessing` " "but is no more than a wrapper around the :mod:`threading` module." msgstr "" -#: ../../library/multiprocessing.rst:2775 +#: ../../library/multiprocessing.rst:2764 msgid "" "In particular, the ``Pool`` function provided by :mod:`multiprocessing." "dummy` returns an instance of :class:`ThreadPool`, which is a subclass of :" @@ -3033,7 +3018,7 @@ msgid "" "worker threads rather than worker processes." msgstr "" -#: ../../library/multiprocessing.rst:2783 +#: ../../library/multiprocessing.rst:2772 msgid "" "A thread pool object which controls a pool of worker threads to which jobs " "can be submitted. :class:`ThreadPool` instances are fully interface " @@ -3043,18 +3028,18 @@ msgid "" "pool.Pool.terminate` manually." msgstr "" -#: ../../library/multiprocessing.rst:2790 +#: ../../library/multiprocessing.rst:2779 msgid "" "*processes* is the number of worker threads to use. If *processes* is " "``None`` then the number returned by :func:`os.cpu_count` is used." msgstr "" -#: ../../library/multiprocessing.rst:2796 +#: ../../library/multiprocessing.rst:2785 msgid "" "Unlike :class:`Pool`, *maxtasksperchild* and *context* cannot be provided." msgstr "" -#: ../../library/multiprocessing.rst:2800 +#: ../../library/multiprocessing.rst:2789 msgid "" "A :class:`ThreadPool` shares the same interface as :class:`Pool`, which is " "designed around a pool of processes and predates the introduction of the :" @@ -3064,7 +3049,7 @@ msgid "" "is not understood by any other libraries." msgstr "" -#: ../../library/multiprocessing.rst:2807 +#: ../../library/multiprocessing.rst:2796 msgid "" "Users should generally prefer to use :class:`concurrent.futures." "ThreadPoolExecutor`, which has a simpler interface that was designed around " @@ -3073,69 +3058,69 @@ msgid "" "`asyncio`." msgstr "" -#: ../../library/multiprocessing.rst:2817 +#: ../../library/multiprocessing.rst:2806 msgid "Programming guidelines" msgstr "" -#: ../../library/multiprocessing.rst:2819 +#: ../../library/multiprocessing.rst:2808 msgid "" "There are certain guidelines and idioms which should be adhered to when " "using :mod:`multiprocessing`." msgstr "" -#: ../../library/multiprocessing.rst:2824 +#: ../../library/multiprocessing.rst:2813 msgid "All start methods" msgstr "" -#: ../../library/multiprocessing.rst:2826 +#: ../../library/multiprocessing.rst:2815 msgid "The following applies to all start methods." msgstr "" -#: ../../library/multiprocessing.rst:2828 +#: ../../library/multiprocessing.rst:2817 msgid "Avoid shared state" msgstr "" -#: ../../library/multiprocessing.rst:2830 +#: ../../library/multiprocessing.rst:2819 msgid "" "As far as possible one should try to avoid shifting large amounts of data " "between processes." msgstr "" -#: ../../library/multiprocessing.rst:2833 +#: ../../library/multiprocessing.rst:2822 msgid "" "It is probably best to stick to using queues or pipes for communication " "between processes rather than using the lower level synchronization " "primitives." msgstr "" -#: ../../library/multiprocessing.rst:2837 +#: ../../library/multiprocessing.rst:2826 msgid "Picklability" msgstr "" -#: ../../library/multiprocessing.rst:2839 +#: ../../library/multiprocessing.rst:2828 msgid "Ensure that the arguments to the methods of proxies are picklable." msgstr "" -#: ../../library/multiprocessing.rst:2841 +#: ../../library/multiprocessing.rst:2830 msgid "Thread safety of proxies" msgstr "" -#: ../../library/multiprocessing.rst:2843 +#: ../../library/multiprocessing.rst:2832 msgid "" "Do not use a proxy object from more than one thread unless you protect it " "with a lock." msgstr "" -#: ../../library/multiprocessing.rst:2846 +#: ../../library/multiprocessing.rst:2835 msgid "" "(There is never a problem with different processes using the *same* proxy.)" msgstr "" -#: ../../library/multiprocessing.rst:2848 +#: ../../library/multiprocessing.rst:2837 msgid "Joining zombie processes" msgstr "" -#: ../../library/multiprocessing.rst:2850 +#: ../../library/multiprocessing.rst:2839 msgid "" "On POSIX when a process finishes but has not been joined it becomes a " "zombie. There should never be very many because each time a new process " @@ -3146,11 +3131,11 @@ msgid "" "explicitly join all the processes that you start." msgstr "" -#: ../../library/multiprocessing.rst:2858 +#: ../../library/multiprocessing.rst:2847 msgid "Better to inherit than pickle/unpickle" msgstr "" -#: ../../library/multiprocessing.rst:2860 +#: ../../library/multiprocessing.rst:2849 msgid "" "When using the *spawn* or *forkserver* start methods many types from :mod:" "`multiprocessing` need to be picklable so that child processes can use " @@ -3160,11 +3145,11 @@ msgid "" "inherit it from an ancestor process." msgstr "" -#: ../../library/multiprocessing.rst:2868 +#: ../../library/multiprocessing.rst:2857 msgid "Avoid terminating processes" msgstr "" -#: ../../library/multiprocessing.rst:2870 +#: ../../library/multiprocessing.rst:2859 msgid "" "Using the :meth:`Process.terminate ` " "method to stop a process is liable to cause any shared resources (such as " @@ -3172,18 +3157,18 @@ msgid "" "become broken or unavailable to other processes." msgstr "" -#: ../../library/multiprocessing.rst:2876 +#: ../../library/multiprocessing.rst:2865 msgid "" "Therefore it is probably best to only consider using :meth:`Process." "terminate ` on processes which never use " "any shared resources." msgstr "" -#: ../../library/multiprocessing.rst:2880 +#: ../../library/multiprocessing.rst:2869 msgid "Joining processes that use queues" msgstr "" -#: ../../library/multiprocessing.rst:2882 +#: ../../library/multiprocessing.rst:2871 msgid "" "Bear in mind that a process that has put items in a queue will wait before " "terminating until all the buffered items are fed by the \"feeder\" thread to " @@ -3192,7 +3177,7 @@ msgid "" "queue to avoid this behaviour.)" msgstr "" -#: ../../library/multiprocessing.rst:2888 +#: ../../library/multiprocessing.rst:2877 msgid "" "This means that whenever you use a queue you need to make sure that all " "items which have been put on the queue will eventually be removed before the " @@ -3201,21 +3186,21 @@ msgid "" "processes will be joined automatically." msgstr "" -#: ../../library/multiprocessing.rst:2894 +#: ../../library/multiprocessing.rst:2883 msgid "An example which will deadlock is the following::" msgstr "" -#: ../../library/multiprocessing.rst:2908 +#: ../../library/multiprocessing.rst:2897 msgid "" "A fix here would be to swap the last two lines (or simply remove the ``p." "join()`` line)." msgstr "" -#: ../../library/multiprocessing.rst:2911 +#: ../../library/multiprocessing.rst:2900 msgid "Explicitly pass resources to child processes" msgstr "" -#: ../../library/multiprocessing.rst:2913 +#: ../../library/multiprocessing.rst:2902 msgid "" "On POSIX using the *fork* start method, a child process can make use of a " "shared resource created in a parent process using a global resource. " @@ -3223,7 +3208,7 @@ msgid "" "for the child process." msgstr "" -#: ../../library/multiprocessing.rst:2918 +#: ../../library/multiprocessing.rst:2907 msgid "" "Apart from making the code (potentially) compatible with Windows and the " "other start methods this also ensures that as long as the child process is " @@ -3232,29 +3217,29 @@ msgid "" "collected in the parent process." msgstr "" -#: ../../library/multiprocessing.rst:2925 +#: ../../library/multiprocessing.rst:2914 msgid "So for instance ::" msgstr "" -#: ../../library/multiprocessing.rst:2937 +#: ../../library/multiprocessing.rst:2926 msgid "should be rewritten as ::" msgstr "" -#: ../../library/multiprocessing.rst:2949 +#: ../../library/multiprocessing.rst:2938 msgid "Beware of replacing :data:`sys.stdin` with a \"file like object\"" msgstr "" -#: ../../library/multiprocessing.rst:2951 +#: ../../library/multiprocessing.rst:2940 msgid ":mod:`multiprocessing` originally unconditionally called::" msgstr "" -#: ../../library/multiprocessing.rst:2955 +#: ../../library/multiprocessing.rst:2944 msgid "" "in the :meth:`multiprocessing.Process._bootstrap` method --- this resulted " "in issues with processes-in-processes. This has been changed to::" msgstr "" -#: ../../library/multiprocessing.rst:2961 +#: ../../library/multiprocessing.rst:2950 msgid "" "Which solves the fundamental issue of processes colliding with each other " "resulting in a bad file descriptor error, but introduces a potential danger " @@ -3264,33 +3249,33 @@ msgid "" "data being flushed to the object multiple times, resulting in corruption." msgstr "" -#: ../../library/multiprocessing.rst:2968 +#: ../../library/multiprocessing.rst:2957 msgid "" "If you write a file-like object and implement your own caching, you can make " "it fork-safe by storing the pid whenever you append to the cache, and " "discarding the cache when the pid changes. For example::" msgstr "" -#: ../../library/multiprocessing.rst:2980 +#: ../../library/multiprocessing.rst:2969 msgid "" "For more information, see :issue:`5155`, :issue:`5313` and :issue:`5331`" msgstr "" -#: ../../library/multiprocessing.rst:2983 +#: ../../library/multiprocessing.rst:2972 msgid "The *spawn* and *forkserver* start methods" msgstr "" -#: ../../library/multiprocessing.rst:2985 +#: ../../library/multiprocessing.rst:2974 msgid "" "There are a few extra restrictions which don't apply to the *fork* start " "method." msgstr "" -#: ../../library/multiprocessing.rst:2988 +#: ../../library/multiprocessing.rst:2977 msgid "More picklability" msgstr "" -#: ../../library/multiprocessing.rst:2990 +#: ../../library/multiprocessing.rst:2979 msgid "" "Ensure that all arguments to :meth:`Process.__init__` are picklable. Also, " "if you subclass :class:`~multiprocessing.Process` then make sure that " @@ -3298,11 +3283,11 @@ msgid "" "Process.start>` method is called." msgstr "" -#: ../../library/multiprocessing.rst:2995 +#: ../../library/multiprocessing.rst:2984 msgid "Global variables" msgstr "" -#: ../../library/multiprocessing.rst:2997 +#: ../../library/multiprocessing.rst:2986 msgid "" "Bear in mind that if code run in a child process tries to access a global " "variable, then the value it sees (if any) may not be the same as the value " @@ -3310,66 +3295,66 @@ msgid "" "Process.start>` was called." msgstr "" -#: ../../library/multiprocessing.rst:3002 +#: ../../library/multiprocessing.rst:2991 msgid "" "However, global variables which are just module level constants cause no " "problems." msgstr "" -#: ../../library/multiprocessing.rst:3007 +#: ../../library/multiprocessing.rst:2996 msgid "Safe importing of main module" msgstr "" -#: ../../library/multiprocessing.rst:3009 +#: ../../library/multiprocessing.rst:2998 msgid "" "Make sure that the main module can be safely imported by a new Python " "interpreter without causing unintended side effects (such as starting a new " "process)." msgstr "" -#: ../../library/multiprocessing.rst:3013 +#: ../../library/multiprocessing.rst:3002 msgid "" "For example, using the *spawn* or *forkserver* start method running the " "following module would fail with a :exc:`RuntimeError`::" msgstr "" -#: ../../library/multiprocessing.rst:3025 +#: ../../library/multiprocessing.rst:3014 msgid "" "Instead one should protect the \"entry point\" of the program by using ``if " "__name__ == '__main__':`` as follows::" msgstr "" -#: ../../library/multiprocessing.rst:3039 +#: ../../library/multiprocessing.rst:3028 msgid "" "(The ``freeze_support()`` line can be omitted if the program will be run " "normally instead of frozen.)" msgstr "" -#: ../../library/multiprocessing.rst:3042 +#: ../../library/multiprocessing.rst:3031 msgid "" "This allows the newly spawned Python interpreter to safely import the module " "and then run the module's ``foo()`` function." msgstr "" -#: ../../library/multiprocessing.rst:3045 +#: ../../library/multiprocessing.rst:3034 msgid "" "Similar restrictions apply if a pool or manager is created in the main " "module." msgstr "" -#: ../../library/multiprocessing.rst:3052 +#: ../../library/multiprocessing.rst:3041 msgid "Examples" msgstr "範例" -#: ../../library/multiprocessing.rst:3054 +#: ../../library/multiprocessing.rst:3043 msgid "Demonstration of how to create and use customized managers and proxies:" msgstr "" -#: ../../library/multiprocessing.rst:3060 +#: ../../library/multiprocessing.rst:3049 msgid "Using :class:`~multiprocessing.pool.Pool`:" msgstr "" -#: ../../library/multiprocessing.rst:3066 +#: ../../library/multiprocessing.rst:3055 msgid "" "An example showing how to use queues to feed tasks to a collection of worker " "processes and collect the results:" diff --git a/library/statistics.po b/library/statistics.po index 6bc3d5122e..bbda217a4d 100644 --- a/library/statistics.po +++ b/library/statistics.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-07-22 00:03+0000\n" "PO-Revision-Date: 2023-07-22 21:15+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -618,13 +618,22 @@ msgstr "眾數特別之處在於它是此套件中唯一也適用於名目（非 #: ../../library/statistics.rst:411 msgid "" +"Only hashable inputs are supported. To handle type :class:`set`, consider " +"casting to :class:`frozenset`. To handle type :class:`list`, consider " +"casting to :class:`tuple`. For mixed or nested inputs, consider using this " +"slower quadratic algorithm that only depends on equality tests: ``max(data, " +"key=data.count)``." +msgstr "" + +#: ../../library/statistics.rst:417 +msgid "" "Now handles multimodal datasets by returning the first mode encountered. " "Formerly, it raised :exc:`StatisticsError` when more than one mode was found." msgstr "" "現在，遇到資料中有多個眾數時，會回傳第一個遇到的眾數。在以前，當找到大於一個" "眾數時，會引發 :exc:`StatisticsError`。" -#: ../../library/statistics.rst:419 +#: ../../library/statistics.rst:425 msgid "" "Return a list of the most frequently occurring values in the order they were " "first encountered in the *data*. Will return more than one result if there " @@ -634,7 +643,7 @@ msgstr "" "次出現的順序排列。如果有多個眾數，將會回傳所有結果。若 *data* 為空，則回傳空" "的 list：" -#: ../../library/statistics.rst:435 +#: ../../library/statistics.rst:441 msgid "" "Return the population standard deviation (the square root of the population " "variance). See :func:`pvariance` for arguments and other details." @@ -642,7 +651,7 @@ msgstr "" "回傳母體標準差（即母體變異數的平方根）。有關引數以及其他細節，請參見 :func:" "`pvariance`。" -#: ../../library/statistics.rst:446 +#: ../../library/statistics.rst:452 msgid "" "Return the population variance of *data*, a non-empty sequence or iterable " "of real-valued numbers. Variance, or second moment about the mean, is a " @@ -654,7 +663,7 @@ msgstr "" "數，或者以平均數為中心的二階動差，用於衡量資料的變異性（離度或分散程度）。變" "異數大表示資料分散，變異數小表示資料集中在平均數附近。" -#: ../../library/statistics.rst:452 +#: ../../library/statistics.rst:458 msgid "" "If the optional second argument *mu* is given, it should be the *population* " "mean of the *data*. It can also be used to compute the second moment around " @@ -665,7 +674,7 @@ msgstr "" "(population mean)。它也可以用於計算非以平均值為中心的第二動差。如果沒有傳入此" "引數或者引數為 ``None`` （預設值），則自動計算資料的算數平均數。" -#: ../../library/statistics.rst:457 +#: ../../library/statistics.rst:463 msgid "" "Use this function to calculate the variance from the entire population. To " "estimate the variance from a sample, the :func:`variance` function is " @@ -674,16 +683,16 @@ msgstr "" "使用此函式來計算整個母體的變異數。如果要從樣本估算變異數，:func:`variance` 通" "常是較好的選擇。" -#: ../../library/statistics.rst:461 +#: ../../library/statistics.rst:467 msgid "Raises :exc:`StatisticsError` if *data* is empty." msgstr "若 *data* 為空，則引發 :exc:`StatisticsError`。" -#: ../../library/statistics.rst:463 ../../library/statistics.rst:533 -#: ../../library/statistics.rst:637 +#: ../../library/statistics.rst:469 ../../library/statistics.rst:539 +#: ../../library/statistics.rst:643 msgid "Examples:" msgstr "範例：" -#: ../../library/statistics.rst:471 +#: ../../library/statistics.rst:477 msgid "" "If you have already calculated the mean of your data, you can pass it as the " "optional second argument *mu* to avoid recalculation:" @@ -691,11 +700,11 @@ msgstr "" "如果已經計算出資料的平均值，你可以將其作為選擇性的第二個引數 *mu* 傳遞以避免" "重新計算：" -#: ../../library/statistics.rst:480 +#: ../../library/statistics.rst:486 msgid "Decimals and Fractions are supported:" msgstr "支援小數 (decimal) 與分數 (fraction)：" -#: ../../library/statistics.rst:494 +#: ../../library/statistics.rst:500 msgid "" "When called with the entire population, this gives the population variance " "σ². When called on a sample instead, this is the biased sample variance s², " @@ -704,7 +713,7 @@ msgstr "" "當在整個母體上呼叫此函式時，會回傳母體變異數 σ²。當在樣本上呼叫此函式時，會回" "傳有偏差的樣本變異數 s²，也就是具有 N 個自由度的變異數。" -#: ../../library/statistics.rst:498 +#: ../../library/statistics.rst:504 msgid "" "If you somehow know the true population mean μ, you may use this function to " "calculate the variance of a sample, giving the known population mean as the " @@ -716,7 +725,7 @@ msgstr "" "引數提供給此函式，用以計算樣本的變異數。只要資料點是母體的隨機樣本，結果將是" "母體變異數的不偏估計。" -#: ../../library/statistics.rst:507 +#: ../../library/statistics.rst:513 msgid "" "Return the sample standard deviation (the square root of the sample " "variance). See :func:`variance` for arguments and other details." @@ -724,7 +733,7 @@ msgstr "" "回傳樣本標準差（即樣本變異數的平方根）。有關引數以及其他細節，請參見 :func:" "`variance`。" -#: ../../library/statistics.rst:518 +#: ../../library/statistics.rst:524 msgid "" "Return the sample variance of *data*, an iterable of at least two real-" "valued numbers. Variance, or second moment about the mean, is a measure of " @@ -736,7 +745,7 @@ msgstr "" "平均數為中心的二階動差，用於衡量資料的變異性（離度或分散程度）。變異數大表示" "資料分散，變異數小表示資料集中在平均數附近。" -#: ../../library/statistics.rst:524 +#: ../../library/statistics.rst:530 msgid "" "If the optional second argument *xbar* is given, it should be the *sample* " "mean of *data*. If it is missing or ``None`` (the default), the mean is " @@ -746,7 +755,7 @@ msgstr "" "(sample mean)。如果沒有傳入或者為 ``None`` （預設值），則自動計算資料的平均" "值。" -#: ../../library/statistics.rst:528 +#: ../../library/statistics.rst:534 msgid "" "Use this function when your data is a sample from a population. To calculate " "the variance from the entire population, see :func:`pvariance`." @@ -754,11 +763,11 @@ msgstr "" "當你的資料是來自母體的樣本時，請使用此函式。若要從整個母體計算變異數，請參" "見 :func:`pvariance`。" -#: ../../library/statistics.rst:531 +#: ../../library/statistics.rst:537 msgid "Raises :exc:`StatisticsError` if *data* has fewer than two values." msgstr "若 *data* 內少於兩個值，則引發 :exc:`StatisticsError`。" -#: ../../library/statistics.rst:541 +#: ../../library/statistics.rst:547 msgid "" "If you have already calculated the sample mean of your data, you can pass it " "as the optional second argument *xbar* to avoid recalculation:" @@ -766,7 +775,7 @@ msgstr "" "如果已經計算出資料的樣本平均值，你可以將其作為選擇性的第二個引數 *mu* 傳遞以" "避免重新計算：" -#: ../../library/statistics.rst:550 +#: ../../library/statistics.rst:556 msgid "" "This function does not attempt to verify that you have passed the actual " "mean as *xbar*. Using arbitrary values for *xbar* can lead to invalid or " @@ -775,11 +784,11 @@ msgstr "" "此函式不會驗證你傳入的 *xbar* 是否為實際的平均數。傳入任意的 *xbar* 會導致無" "效或不可能的結果。" -#: ../../library/statistics.rst:554 +#: ../../library/statistics.rst:560 msgid "Decimal and Fraction values are supported:" msgstr "支援小數 (decimal) 與分數 (fraction)：" -#: ../../library/statistics.rst:568 +#: ../../library/statistics.rst:574 msgid "" "This is the sample variance s² with Bessel's correction, also known as " "variance with N-1 degrees of freedom. Provided that the data points are " @@ -790,7 +799,7 @@ msgstr "" "為 N-1 的變異數。只要資料點具有代表性（例如：獨立且具有相同分布），結果應該會" "是對真實母體變異數的不偏估計。" -#: ../../library/statistics.rst:573 +#: ../../library/statistics.rst:579 msgid "" "If you somehow know the actual population mean μ you should pass it to the :" "func:`pvariance` function as the *mu* parameter to get the variance of a " @@ -799,7 +808,7 @@ msgstr "" "若你剛好知道真正的母體平均數 μ，你應該將其作為 *mu* 參數傳入 :func:" "`pvariance` 函式來計算樣本變異數。" -#: ../../library/statistics.rst:579 +#: ../../library/statistics.rst:585 msgid "" "Divide *data* into *n* continuous intervals with equal probability. Returns " "a list of ``n - 1`` cut points separating the intervals." @@ -807,7 +816,7 @@ msgstr "" "將 *data* 分成 *n* 個具有相等機率的連續區間。回傳一個包含 ``n - 1`` 個用於切" "分各區間的分隔點的 list。" -#: ../../library/statistics.rst:582 +#: ../../library/statistics.rst:588 msgid "" "Set *n* to 4 for quartiles (the default). Set *n* to 10 for deciles. Set " "*n* to 100 for percentiles which gives the 99 cuts points that separate " @@ -818,7 +827,7 @@ msgstr "" "分位數 (percentile)，這將給出 99 個分隔點將 *data* 分成 100 個大小相等的組。" "如果 *n* 不是至少為 1，則引發 :exc:`StatisticsError`。" -#: ../../library/statistics.rst:587 +#: ../../library/statistics.rst:593 msgid "" "The *data* can be any iterable containing sample data. For meaningful " "results, the number of data points in *data* should be larger than *n*. " @@ -827,7 +836,7 @@ msgstr "" "*data* 可以是包含樣本資料的任何 iterable。為了取得有意義的結果，*data* 中的資" "料點數量應大於 *n*。如果資料點少於兩個，則引發 :exc:`StatisticsError`。" -#: ../../library/statistics.rst:591 +#: ../../library/statistics.rst:597 msgid "" "The cut points are linearly interpolated from the two nearest data points. " "For example, if a cut point falls one-third of the distance between two " @@ -836,7 +845,7 @@ msgstr "" "分隔點是從兩個最近的資料點線性內插值計算出來的。舉例來說，如果分隔點落在兩個" "樣本值 ``100`` 與 ``112`` 之間的距離三分之一處，則分隔點的值將為 ``104``。" -#: ../../library/statistics.rst:596 +#: ../../library/statistics.rst:602 msgid "" "The *method* for computing quantiles can be varied depending on whether the " "*data* includes or excludes the lowest and highest possible values from the " @@ -845,7 +854,7 @@ msgstr "" "計算分位數的 *method* 可以根據 *data* 是否包含或排除來自母體的最小與最大可能" "的值而改變。" -#: ../../library/statistics.rst:600 +#: ../../library/statistics.rst:606 msgid "" "The default *method* is \"exclusive\" and is used for data sampled from a " "population that can have more extreme values than found in the samples. The " @@ -859,7 +868,7 @@ msgstr "" "1)``。給定九個樣本資料，此方法將對資料排序且計算下列百分位數：10%、20%、30%、" "40%、50%、60%、70%、80%、90%。" -#: ../../library/statistics.rst:607 +#: ../../library/statistics.rst:613 msgid "" "Setting the *method* to \"inclusive\" is used for describing population data " "or for samples that are known to include the most extreme values from the " @@ -876,7 +885,7 @@ msgstr "" "給定十一個個樣本資料，此方法將對資料排序且計算下列百分位數：0%、10%、20%、" "30%、40%、50%、60%、70%、80%、90%、100%。" -#: ../../library/statistics.rst:631 +#: ../../library/statistics.rst:637 msgid "" "Return the sample covariance of two inputs *x* and *y*. Covariance is a " "measure of the joint variability of two inputs." @@ -884,14 +893,14 @@ msgstr "" "回傳兩輸入 *x* 與 *y* 的樣本共變異數 (sample covariance)。共變異數是衡量兩輸" "入的聯合變異性 (joint variability) 的指標。" -#: ../../library/statistics.rst:634 +#: ../../library/statistics.rst:640 msgid "" "Both inputs must be of the same length (no less than two), otherwise :exc:" "`StatisticsError` is raised." msgstr "" "兩輸入必須具有相同長度（至少兩個），否則會引發 :exc:`StatisticsError`。" -#: ../../library/statistics.rst:655 +#: ../../library/statistics.rst:661 msgid "" "Return the `Pearson's correlation coefficient `_ for two inputs. Pearson's correlation " @@ -902,7 +911,7 @@ msgstr "" "en.wikipedia.org/wiki/Pearson_correlation_coefficient>`_。Pearson 相關係數 " "*r* 的值介於 -1 與 +1 之間。它衡量線性關係的強度與方向。" -#: ../../library/statistics.rst:661 +#: ../../library/statistics.rst:667 msgid "" "If *method* is \"ranked\", computes `Spearman's rank correlation coefficient " "`_ " @@ -916,7 +925,7 @@ msgstr "" "則取平均，令相同的值排名也相同。所得係數衡量單調關係 (monotonic " "relationship) 的強度。" -#: ../../library/statistics.rst:667 +#: ../../library/statistics.rst:673 msgid "" "Spearman's correlation coefficient is appropriate for ordinal data or for " "continuous data that doesn't meet the linear proportion requirement for " @@ -925,7 +934,7 @@ msgstr "" "Spearman 相關係數適用於順序型資料，或者不符合 Pearson 相關係數要求的線性比例" "關係的連續型 (continuous) 資料。" -#: ../../library/statistics.rst:671 +#: ../../library/statistics.rst:677 msgid "" "Both inputs must be of the same length (no less than two), and need not to " "be constant, otherwise :exc:`StatisticsError` is raised." @@ -933,7 +942,7 @@ msgstr "" "兩輸入必須具有相同長度（至少兩個），且不須為常數，否則會引發 :exc:" "`StatisticsError`。" -#: ../../library/statistics.rst:674 +#: ../../library/statistics.rst:680 msgid "" "Example with `Kepler's laws of planetary motion `_:" @@ -941,11 +950,11 @@ msgstr "" "以 `Kepler 行星運動定律 `_\\ 為例：" -#: ../../library/statistics.rst:701 +#: ../../library/statistics.rst:707 msgid "Added support for Spearman's rank correlation coefficient." msgstr "新增了對 Spearman 等級相關係數的支援。" -#: ../../library/statistics.rst:706 +#: ../../library/statistics.rst:712 msgid "" "Return the slope and intercept of `simple linear regression `_ parameters estimated using " @@ -959,11 +968,11 @@ msgstr "" "迴歸描述自變數 (independent variable) *x* 與應變數 (dependent variable) *y* " "之間的關係，用以下的線性函式表示：" -#: ../../library/statistics.rst:712 +#: ../../library/statistics.rst:718 msgid "*y = slope \\* x + intercept + noise*" msgstr "*y = slope \\* x + intercept + noise*" -#: ../../library/statistics.rst:714 +#: ../../library/statistics.rst:720 msgid "" "where ``slope`` and ``intercept`` are the regression parameters that are " "estimated, and ``noise`` represents the variability of the data that was not " @@ -973,7 +982,7 @@ msgstr "" "其中 ``slope`` 和 ``intercept`` 是被估計的迴歸參數，而 ``noise`` 表示由線性迴" "歸未解釋的資料變異性（它等於應變數的預測值與實際值之差）。" -#: ../../library/statistics.rst:720 +#: ../../library/statistics.rst:726 msgid "" "Both inputs must be of the same length (no less than two), and the " "independent variable *x* cannot be constant; otherwise a :exc:" @@ -982,7 +991,7 @@ msgstr "" "兩輸入必須具有相同長度（至少兩個），且自變數 *x* 不得為常數，否則會引發 :exc:" "`StatisticsError`。" -#: ../../library/statistics.rst:724 +#: ../../library/statistics.rst:730 msgid "" "For example, we can use the `release dates of the Monty Python films " "`_ to predict the " @@ -993,7 +1002,7 @@ msgstr "" "wikipedia.org/wiki/Monty_Python#Films>`_\\ 來預測至 2019 年為止，假設他們保持" "固定的製作速度，應該會產生的 Monty Python 電影的累計數量。" -#: ../../library/statistics.rst:738 +#: ../../library/statistics.rst:744 msgid "" "If *proportional* is true, the independent variable *x* and the dependent " "variable *y* are assumed to be directly proportional. The data is fit to a " @@ -1004,11 +1013,11 @@ msgstr "" "資料座落在通過原點的一直線上。由於 *intercept* 始終為 0.0，因此線性函式可簡化" "如下：" -#: ../../library/statistics.rst:744 +#: ../../library/statistics.rst:750 msgid "*y = slope \\* x + noise*" msgstr "*y = slope \\* x + noise*" -#: ../../library/statistics.rst:746 +#: ../../library/statistics.rst:752 msgid "" "Continuing the example from :func:`correlation`, we look to see how well a " "model based on major planets can predict the orbital distances for dwarf " @@ -1017,27 +1026,27 @@ msgstr "" "繼續 :func:`correlation` 中的範例，我們看看基於主要行星的模型可以如何很好地預" "測矮行星的軌道距離：" -#: ../../library/statistics.rst:766 +#: ../../library/statistics.rst:772 msgid "Added support for *proportional*." msgstr "新增 *proportional* 的支援。" -#: ../../library/statistics.rst:770 +#: ../../library/statistics.rst:776 msgid "Exceptions" msgstr "例外" -#: ../../library/statistics.rst:772 +#: ../../library/statistics.rst:778 msgid "A single exception is defined:" msgstr "定義了一個單一的例外：" -#: ../../library/statistics.rst:776 +#: ../../library/statistics.rst:782 msgid "Subclass of :exc:`ValueError` for statistics-related exceptions." msgstr ":exc:`ValueError` 的子類別，用於和統計相關的例外。" -#: ../../library/statistics.rst:780 +#: ../../library/statistics.rst:786 msgid ":class:`NormalDist` objects" msgstr ":class:`NormalDist` 物件" -#: ../../library/statistics.rst:782 +#: ../../library/statistics.rst:788 msgid "" ":class:`NormalDist` is a tool for creating and manipulating normal " "distributions of a `random variable `_ 的常態分布的工" "具。它是一個將量測資料的平均數與標準差視為單一實體的類別。" -#: ../../library/statistics.rst:788 +#: ../../library/statistics.rst:794 msgid "" "Normal distributions arise from the `Central Limit Theorem `_ and have a wide range of " @@ -1057,7 +1066,7 @@ msgstr "" "常態分布源自於\\ `中央極限定理 (Central Limit Theorem) `_，在統計學中有著廣泛的應用。" -#: ../../library/statistics.rst:794 +#: ../../library/statistics.rst:800 msgid "" "Returns a new *NormalDist* object where *mu* represents the `arithmetic mean " "`_ and *sigma* represents the " @@ -1067,11 +1076,11 @@ msgstr "" "en.wikipedia.org/wiki/Arithmetic_mean>`_\\ 而 *sigma* 代表\\ `標準差 " "`_。" -#: ../../library/statistics.rst:799 +#: ../../library/statistics.rst:805 msgid "If *sigma* is negative, raises :exc:`StatisticsError`." msgstr "若 *sigma* 為負值，則引發 :exc:`StatisticsError`。" -#: ../../library/statistics.rst:803 +#: ../../library/statistics.rst:809 msgid "" "A read-only property for the `arithmetic mean `_ of a normal distribution." @@ -1079,14 +1088,14 @@ msgstr "" "常態分布中的\\ `算數平均數 `_\\ 唯讀屬性。" -#: ../../library/statistics.rst:809 +#: ../../library/statistics.rst:815 msgid "" "A read-only property for the `median `_ of a normal distribution." msgstr "" "常態分布中的\\ `中位數 `_\\ 唯讀屬性。" -#: ../../library/statistics.rst:815 +#: ../../library/statistics.rst:821 msgid "" "A read-only property for the `mode `_ of a normal distribution." @@ -1094,7 +1103,7 @@ msgstr "" "常態分布中的\\ `眾數 `_\\ 唯" "讀屬性。" -#: ../../library/statistics.rst:821 +#: ../../library/statistics.rst:827 msgid "" "A read-only property for the `standard deviation `_ of a normal distribution." @@ -1102,7 +1111,7 @@ msgstr "" "常態分布中的\\ `標準差 `_\\ 唯讀屬性。" -#: ../../library/statistics.rst:827 +#: ../../library/statistics.rst:833 msgid "" "A read-only property for the `variance `_ of a normal distribution. Equal to the square of the standard " @@ -1111,7 +1120,7 @@ msgstr "" "常態分布中的\\ `變異數 `_\\ 唯讀屬" "性。" -#: ../../library/statistics.rst:833 +#: ../../library/statistics.rst:839 msgid "" "Makes a normal distribution instance with *mu* and *sigma* parameters " "estimated from the *data* using :func:`fmean` and :func:`stdev`." @@ -1119,7 +1128,7 @@ msgstr "" "利用 :func:`fmean` 與 :func:`stdev` 函式，估計 *data* 的 *mu* 與 *sigma* 參" "數，建立一個常態分布的實例。" -#: ../../library/statistics.rst:836 +#: ../../library/statistics.rst:842 msgid "" "The *data* can be any :term:`iterable` and should consist of values that can " "be converted to type :class:`float`. If *data* does not contain at least " @@ -1131,7 +1140,7 @@ msgstr "" "若 *data* 沒有包含至少兩個以上的元素在內，則引發 :exc:`StatisticsError`，因為" "至少需要一個點來估計中央值且至少需要兩個點來估計分散情形。" -#: ../../library/statistics.rst:844 +#: ../../library/statistics.rst:850 msgid "" "Generates *n* random samples for a given mean and standard deviation. " "Returns a :class:`list` of :class:`float` values." @@ -1139,7 +1148,7 @@ msgstr "" "給定平均值與標準差，產生 *n* 個隨機樣本。回傳一個由 :class:`float` 組成的 :" "class:`list`。" -#: ../../library/statistics.rst:847 +#: ../../library/statistics.rst:853 msgid "" "If *seed* is given, creates a new instance of the underlying random number " "generator. This is useful for creating reproducible results, even in a " @@ -1148,7 +1157,7 @@ msgstr "" "若有給定 *seed*，則會建立一個以此為基礎的亂數產生器實例。這對於建立可重現的結" "果很有幫助，即使在多執行緒情境下也是如此。" -#: ../../library/statistics.rst:853 +#: ../../library/statistics.rst:859 msgid "" "Using a `probability density function (pdf) `_, compute the relative likelihood that a " @@ -1160,7 +1169,7 @@ msgstr "" "值 *x* 的相對概度 (relative likelihood)。數學上，它是比率 ``P(x <= X < " "x+dx) / dx`` 在 *dx* 趨近於零時的極限值。" -#: ../../library/statistics.rst:859 +#: ../../library/statistics.rst:865 msgid "" "The relative likelihood is computed as the probability of a sample occurring " "in a narrow range divided by the width of the range (hence the word " @@ -1170,7 +1179,7 @@ msgstr "" "相對概度是樣本出現在狹窄範圍的機率，除以該範圍的寬度（故稱為「密度」）計算而" "得。由於概度是相對於其它點，故其值可大於 ``1.0``。" -#: ../../library/statistics.rst:866 +#: ../../library/statistics.rst:872 msgid "" "Using a `cumulative distribution function (cdf) `_, compute the probability that a " @@ -1181,7 +1190,7 @@ msgstr "" "wikipedia.org/wiki/Cumulative_distribution_function>`_ 計算隨機變數 *X* 小於" "或等於 *x* 的機率。數學上，它記為 ``P(X <= x)``。" -#: ../../library/statistics.rst:873 +#: ../../library/statistics.rst:879 msgid "" "Compute the inverse cumulative distribution function, also known as the " "`quantile function `_ or " @@ -1195,7 +1204,7 @@ msgstr "" "org/web/20190203145224/https://www.statisticshowto.datasciencecentral.com/" "inverse-distribution-function/>`_ 函式。數學上記為 ``x : P(X <= x) = p``。" -#: ../../library/statistics.rst:879 +#: ../../library/statistics.rst:885 msgid "" "Finds the value *x* of the random variable *X* such that the probability of " "the variable being less than or equal to that value equals the given " @@ -1203,7 +1212,7 @@ msgid "" msgstr "" "找出一個值 *x*，使得隨機變數 *X* 小於或等於該值的機率等於給定的機率 *p*。" -#: ../../library/statistics.rst:885 +#: ../../library/statistics.rst:891 msgid "" "Measures the agreement between two normal probability distributions. Returns " "a value between 0.0 and 1.0 giving `the overlapping area for the two " @@ -1212,7 +1221,7 @@ msgstr "" "衡量兩常態分布之間的一致性。回傳一個介於 0.0 與 1.0 之間的值，表示\\ `兩機率" "密度函式的重疊區域 `_。" -#: ../../library/statistics.rst:892 +#: ../../library/statistics.rst:898 msgid "" "Divide the normal distribution into *n* continuous intervals with equal " "probability. Returns a list of (n - 1) cut points separating the intervals." @@ -1220,7 +1229,7 @@ msgstr "" "將常態分布分割成 *n* 個具有相等機率的連續區間。回傳一個 list，包含 (n-1) 個切" "割區間的分隔點。" -#: ../../library/statistics.rst:896 +#: ../../library/statistics.rst:902 msgid "" "Set *n* to 4 for quartiles (the default). Set *n* to 10 for deciles. Set " "*n* to 100 for percentiles which gives the 99 cuts points that separate the " @@ -1230,7 +1239,7 @@ msgstr "" "*n* 設定為 100 表示百分位數，這會產生 99 個分隔點，將常態分布切割成大小相等的" "群組。" -#: ../../library/statistics.rst:902 +#: ../../library/statistics.rst:908 msgid "" "Compute the `Standard Score `_ describing *x* in terms of the number of standard " @@ -1241,7 +1250,7 @@ msgstr "" "probability-and-statistics/z-score/>`_，用以描述在常態分布中，*x* 高出或低於" "平均數幾個標準差：``(x - mean) / stdev``。" -#: ../../library/statistics.rst:910 +#: ../../library/statistics.rst:916 msgid "" "Instances of :class:`NormalDist` support addition, subtraction, " "multiplication and division by a constant. These operations are used for " @@ -1250,14 +1259,14 @@ msgstr "" ":class:`NormalDist` 的實例支援對常數的加法、減法、乘法與除法。這些操作用於平" "移與縮放。例如：" -#: ../../library/statistics.rst:920 +#: ../../library/statistics.rst:926 msgid "" "Dividing a constant by an instance of :class:`NormalDist` is not supported " "because the result wouldn't be normally distributed." msgstr "" "不支援將常數除以 :class:`NormalDist` 的實例，因為結果將不符合常態分布。" -#: ../../library/statistics.rst:923 +#: ../../library/statistics.rst:929 msgid "" "Since normal distributions arise from additive effects of independent " "variables, it is possible to `add and subtract two independent normally " @@ -1270,19 +1279,19 @@ msgstr "" "Sum_of_normally_distributed_random_variables>`_，並且表示為 :class:" "`NormalDist` 的實例。例如：" -#: ../../library/statistics.rst:943 +#: ../../library/statistics.rst:949 msgid "Examples and Recipes" msgstr "範例與錦囊妙計" -#: ../../library/statistics.rst:947 +#: ../../library/statistics.rst:953 msgid "Classic probability problems" msgstr "經典機率問題" -#: ../../library/statistics.rst:949 +#: ../../library/statistics.rst:955 msgid ":class:`NormalDist` readily solves classic probability problems." msgstr ":class:`NormalDist` 可以輕易地解決經典的機率問題。" -#: ../../library/statistics.rst:951 +#: ../../library/statistics.rst:957 msgid "" "For example, given `historical data for SAT exams `_ showing that scores are " @@ -1294,7 +1303,7 @@ msgstr "" "tables/dt17_226.40.asp>`_，顯示成績為平均 1060、標準差 195 的常態分布。我們要" "求出分數在 1100 與 1200 之間（四捨五入至最接近的整數）的學生的百分比：" -#: ../../library/statistics.rst:964 +#: ../../library/statistics.rst:970 msgid "" "Find the `quartiles `_ and `deciles " "`_ for the SAT scores:" @@ -1302,11 +1311,11 @@ msgstr "" "找出 SAT 分數的\\ `四分位數 `_\\ 以及" "\\ `十分位數 `_：" -#: ../../library/statistics.rst:976 +#: ../../library/statistics.rst:982 msgid "Monte Carlo inputs for simulations" msgstr "用於模擬的蒙地卡羅 (Monte Carlo) 輸入" -#: ../../library/statistics.rst:978 +#: ../../library/statistics.rst:984 msgid "" "To estimate the distribution for a model that isn't easy to solve " "analytically, :class:`NormalDist` can generate input samples for a `Monte " @@ -1316,11 +1325,11 @@ msgstr "" "樣本以進行\\ `蒙地卡羅模擬 `_：" -#: ../../library/statistics.rst:995 +#: ../../library/statistics.rst:1001 msgid "Approximating binomial distributions" msgstr "近似二項分布" -#: ../../library/statistics.rst:997 +#: ../../library/statistics.rst:1003 msgid "" "Normal distributions can be used to approximate `Binomial distributions " "`_ when the sample " @@ -1330,7 +1339,7 @@ msgstr "" "(Binomial distributions) `_。" -#: ../../library/statistics.rst:1002 +#: ../../library/statistics.rst:1008 msgid "" "For example, an open source conference has 750 attendees and two rooms with " "a 500 person capacity. There is a talk about Python and another about Ruby. " @@ -1343,15 +1352,15 @@ msgstr "" "向參與 Python 講座。假設參與者的偏好沒有改變，那麼 Python 會議室未超過自身容" "量限制的機率是？" -#: ../../library/statistics.rst:1033 +#: ../../library/statistics.rst:1039 msgid "Naive bayesian classifier" msgstr "單純貝氏分類器 (Naive bayesian classifier)" -#: ../../library/statistics.rst:1035 +#: ../../library/statistics.rst:1041 msgid "Normal distributions commonly arise in machine learning problems." msgstr "常態分布常在機器學習問題中出現。" -#: ../../library/statistics.rst:1037 +#: ../../library/statistics.rst:1043 msgid "" "Wikipedia has a `nice example of a Naive Bayesian Classifier `_. The " @@ -1362,7 +1371,7 @@ msgstr "" "wiki/Naive_Bayes_classifier#Person_classification>`_。課題為從身高、體重與鞋" "子尺寸等符合常態分布的特徵量測值中判斷一個人的性別。" -#: ../../library/statistics.rst:1042 +#: ../../library/statistics.rst:1048 msgid "" "We're given a training dataset with measurements for eight people. The " "measurements are assumed to be normally distributed, so we summarize the " @@ -1371,13 +1380,13 @@ msgstr "" "給定一組包含八個人的量測值的訓練資料集。假設這些量測值服從常態分布，我們可以" "利用 :class:`NormalDist` 來總結資料：" -#: ../../library/statistics.rst:1055 +#: ../../library/statistics.rst:1061 msgid "" "Next, we encounter a new person whose feature measurements are known but " "whose gender is unknown:" msgstr "接著，我們遇到一個新的人，他的特徵量測值已知，但性別未知：" -#: ../../library/statistics.rst:1064 +#: ../../library/statistics.rst:1070 msgid "" "Starting with a 50% `prior probability `_ of being male or female, we compute the posterior as " @@ -1388,7 +1397,7 @@ msgstr "" "org/wiki/Prior_probability>`_ 為開端，我們將後驗機率 (posterior probability) " "計算為先驗機率乘以給定性別下，各特徵量測值的概度乘積：" -#: ../../library/statistics.rst:1079 +#: ../../library/statistics.rst:1085 msgid "" "The final prediction goes to the largest posterior. This is known as the " "`maximum a posteriori `_ 或者 MAP：" -#: ../../library/statistics.rst:1090 +#: ../../library/statistics.rst:1096 msgid "Kernel density estimation" msgstr "核密度估計 (Kernel density estimation)" -#: ../../library/statistics.rst:1092 +#: ../../library/statistics.rst:1098 msgid "" "It is possible to estimate a continuous probability distribution from a " "fixed number of discrete samples." msgstr "可以從固定數量的離散樣本估計出連續機率分布。" -#: ../../library/statistics.rst:1095 +#: ../../library/statistics.rst:1101 msgid "" "The basic idea is to smooth the data using `a kernel function such as a " "normal distribution, triangular distribution, or uniform distribution " @@ -1421,7 +1430,7 @@ msgstr "" "wikipedia.org/wiki/Kernel_(statistics)#Kernel_functions_in_common_use>`_\\ 來" "使資料更加平滑。平滑程度由一個縮放參數 ``h`` 控制，被稱為 *bandwidth*。" -#: ../../library/statistics.rst:1125 +#: ../../library/statistics.rst:1131 msgid "" "`Wikipedia has an example `_ where we can use the ``kde_normal()`` " @@ -1432,25 +1441,25 @@ msgstr "" "Kernel_density_estimation#Example>`_，我們可以使用 ``kde_normal()`` 這個錦囊" "妙計來生成並繪製從小樣本估計的機率密度函式：" -#: ../../library/statistics.rst:1137 +#: ../../library/statistics.rst:1143 msgid "The points in ``xarr`` and ``yarr`` can be used to make a PDF plot:" msgstr "``xarr`` 和 ``yarr`` 中的點可用於繪製 PDF 圖：" -#: ../../library/statistics.rst:1139 +#: ../../library/statistics.rst:1145 msgid "Scatter plot of the estimated probability density function." msgstr "估計機率密度函式的散點圖 (scatter plot)。" -#: ../../library/statistics.rst:1142 +#: ../../library/statistics.rst:1148 msgid "" "`Resample `_ the data " "to produce 100 new selections:" msgstr "" -#: ../../library/statistics.rst:1149 +#: ../../library/statistics.rst:1155 msgid "Determine the probability of a new selection being below ``2.0``:" msgstr "" -#: ../../library/statistics.rst:1156 +#: ../../library/statistics.rst:1162 msgid "Add a new sample data point and find the new CDF at ``2.0``:" msgstr "" From b9bb09eeb0487bb144696ead6d51e96e82721e11 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Tue, 23 Jul 2024 00:05:23 +0000 Subject: [PATCH 06/28] sync with cpython 8d1f1571 --- c-api/init_config.po | 4 +- howto/logging-cookbook.po | 4 +- library/ast.po | 8 +- library/asyncio-future.po | 8 +- library/asyncio-task.po | 4 +- library/asyncio.po | 32 +++++-- library/contextlib.po | 4 +- library/ctypes.po | 4 +- library/fractions.po | 4 +- library/http.server.po | 4 +- library/importlib.po | 4 +- library/importlib.resources.abc.po | 4 +- library/inspect.po | 6 +- library/mailbox.po | 4 +- library/optparse.po | 4 +- library/os.po | 8 +- library/pathlib.po | 5 +- library/ssl.po | 4 +- library/subprocess.po | 4 +- library/urllib.request.po | 6 +- using/cmdline.po | 148 +++++++++++++++-------------- 21 files changed, 148 insertions(+), 125 deletions(-) diff --git a/c-api/init_config.po b/c-api/init_config.po index 196f80e713..36f6ad459a 100644 --- a/c-api/init_config.po +++ b/c-api/init_config.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-08-23 00:03+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -595,7 +595,7 @@ msgstr "" msgid "" "The :c:func:`PyConfig_Read` function only parses :c:member:`PyConfig.argv` " "arguments once: :c:member:`PyConfig.parse_argv` is set to ``2`` after " -"arguments are parsed. Since Python arguments are strippped from :c:member:" +"arguments are parsed. Since Python arguments are stripped from :c:member:" "`PyConfig.argv`, parsing arguments twice would parse the application options " "as Python options." msgstr "" diff --git a/howto/logging-cookbook.po b/howto/logging-cookbook.po index acaf42d09c..3c3d9e0dcf 100644 --- a/howto/logging-cookbook.po +++ b/howto/logging-cookbook.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 00:04+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2018-05-23 14:36+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1949,7 +1949,7 @@ msgid "" "which writes to ``sys.stderr`` makes multiple writes, each of which results " "in a separate logged line (for example, the last three lines above). To get " "around this problem, you need to buffer things and only output log lines " -"when newlines are seen. Let's use a slghtly better implementation of " +"when newlines are seen. Let's use a slightly better implementation of " "``LoggerWriter``:" msgstr "" diff --git a/library/ast.po b/library/ast.po index 48644a8ec5..99a57e76eb 100644 --- a/library/ast.po +++ b/library/ast.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-21 00:04+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2018-05-23 14:38+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -646,9 +646,10 @@ msgid "" msgstr "``type_comment`` 是一個可選字串，其中的註解為型別註釋。" #: ../../library/ast.rst:881 +#, fuzzy msgid "" "An assignment with a type annotation. ``target`` is a single node and can be " -"a :class:`Name`, a :class:`Attribute` or a :class:`Subscript`. " +"a :class:`Name`, an :class:`Attribute` or a :class:`Subscript`. " "``annotation`` is the annotation, such as a :class:`Constant` or :class:" "`Name` node. ``value`` is a single optional node." msgstr "" @@ -1165,9 +1166,10 @@ msgid "A ``return`` statement." msgstr "一個 ``return`` 陳述式。" #: ../../library/ast.rst:2004 +#, fuzzy msgid "" "A ``yield`` or ``yield from`` expression. Because these are expressions, " -"they must be wrapped in a :class:`Expr` node if the value sent back is not " +"they must be wrapped in an :class:`Expr` node if the value sent back is not " "used." msgstr "" "一個 ``yield`` 或 ``yield from`` 運算式。因為這些是運算式，所以如果不使用發送" diff --git a/library/asyncio-future.po b/library/asyncio-future.po index c0a2b9830a..4d3b302694 100644 --- a/library/asyncio-future.po +++ b/library/asyncio-future.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-07-29 10:36+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2022-01-25 01:29+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -212,8 +212,9 @@ msgstr "" "`CancelledError` 例外。" #: ../../library/asyncio-future.rst:122 +#, fuzzy msgid "" -"If the Future's result isn't yet available, this method raises a :exc:" +"If the Future's result isn't yet available, this method raises an :exc:" "`InvalidStateError` exception." msgstr "" "如果 Future 的結果還不可用，此方法會引發一個 :exc:`InvalidStateError` 例外。" @@ -223,8 +224,9 @@ msgid "Mark the Future as *done* and set its result." msgstr "將 Future 標記為 *done* 並設定其結果。" #: ../../library/asyncio-future.rst:129 ../../library/asyncio-future.rst:136 +#, fuzzy msgid "" -"Raises a :exc:`InvalidStateError` error if the Future is already *done*." +"Raises an :exc:`InvalidStateError` error if the Future is already *done*." msgstr "如果 Future 已經 *done* 則引發一個 :exc:`InvalidStateError` 錯誤。" #: ../../library/asyncio-future.rst:134 diff --git a/library/asyncio-task.po b/library/asyncio-task.po index 84133b14cc..f6b59716e5 100644 --- a/library/asyncio-task.po +++ b/library/asyncio-task.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2018-05-23 14:39+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1051,7 +1051,7 @@ msgstr "" #: ../../library/asyncio-task.rst:1106 msgid "" -"If the Task's result isn't yet available, this method raises a :exc:" +"If the Task's result isn't yet available, this method raises an :exc:" "`InvalidStateError` exception." msgstr "" diff --git a/library/asyncio.po b/library/asyncio.po index 4170c3073e..69b0a726cd 100644 --- a/library/asyncio.po +++ b/library/asyncio.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2021-11-23 12:40+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -21,15 +21,15 @@ msgstr "" "Plural-Forms: nplurals=1; plural=0;\n" "X-Generator: Poedit 3.0\n" -#: ../../library/asyncio.rst:80 +#: ../../library/asyncio.rst:87 msgid "High-level APIs" msgstr "高階 API" -#: ../../library/asyncio.rst:92 +#: ../../library/asyncio.rst:99 msgid "Low-level APIs" msgstr "低階 API" -#: ../../library/asyncio.rst:103 +#: ../../library/asyncio.rst:110 msgid "Guides and Tutorials" msgstr "指南與教學" @@ -127,10 +127,6 @@ msgstr "" "透過 async/await 語法來\\ :ref:`橋接 `\\ 基於回呼 (callback-" "based) 的函式庫與程式碼。" -#: ../../library/asyncio.rst:61 -msgid "You can experiment with an ``asyncio`` concurrent context in the REPL:" -msgstr "你能在 REPL 中對一個 ``asyncio`` 的並行情境 (context) 進行實驗：" - #: ../../includes/wasm-notavail.rst:3 msgid ":ref:`Availability `: not Emscripten, not WASI." msgstr ":ref:`適用 `：非 Emscripten、非 WASI。" @@ -144,10 +140,28 @@ msgstr "" "此模組在 WebAssembly 平台 ``wasm32-emscripten`` 和 ``wasm32-wasi`` 上不起作用" "或無法使用。有關更多資訊，請參閱 :ref:`wasm-availability`。" +#: ../../library/asyncio.rst:64 +msgid "asyncio REPL" +msgstr "" + +#: ../../library/asyncio.rst:65 +msgid "You can experiment with an ``asyncio`` concurrent context in the REPL:" +msgstr "你能在 REPL 中對一個 ``asyncio`` 的並行情境 (context) 進行實驗：" + +#: ../../library/asyncio.rst:88 +msgid "" +"Raises an :ref:`auditing event ` ``cpython.run_stdin`` with no " +"arguments." +msgstr "" + #: ../../library/asyncio.rst:79 +msgid "(also 3.11.10, 3.10.15, 3.9.20, and 3.8.20) Emits audit events." +msgstr "" + +#: ../../library/asyncio.rst:86 msgid "Reference" msgstr "參閱" -#: ../../library/asyncio.rst:112 +#: ../../library/asyncio.rst:119 msgid "The source code for asyncio can be found in :source:`Lib/asyncio/`." msgstr "asyncio 的原始碼可以在 :source:`Lib/asyncio/` 中找到。" diff --git a/library/contextlib.po b/library/contextlib.po index 23c11f2ca6..2ff04c77a8 100644 --- a/library/contextlib.po +++ b/library/contextlib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-06 00:03+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2018-05-23 14:41+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -270,7 +270,7 @@ msgstr "" #: ../../library/contextlib.rst:323 msgid "" -"``suppress`` now supports suppressing exceptions raised as part of an :exc:" +"``suppress`` now supports suppressing exceptions raised as part of a :exc:" "`BaseExceptionGroup`." msgstr "" diff --git a/library/ctypes.po b/library/ctypes.po index 20395118a5..ff1bb2f892 100644 --- a/library/ctypes.po +++ b/library/ctypes.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2023-04-26 02:59+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -120,7 +120,7 @@ msgstr "" msgid "" "Note that win32 system dlls like ``kernel32`` and ``user32`` often export " "ANSI as well as UNICODE versions of a function. The UNICODE version is " -"exported with an ``W`` appended to the name, while the ANSI version is " +"exported with a ``W`` appended to the name, while the ANSI version is " "exported with an ``A`` appended to the name. The win32 ``GetModuleHandle`` " "function, which returns a *module handle* for a given module name, has the " "following C prototype, and a macro is used to expose one of them as " diff --git a/library/fractions.po b/library/fractions.po index 20873cd4c6..11c2d748b5 100644 --- a/library/fractions.po +++ b/library/fractions.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2016-01-31 07:18+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -84,7 +84,7 @@ msgstr "" #: ../../library/fractions.rst:88 msgid "" "The :func:`math.gcd` function is now used to normalize the *numerator* and " -"*denominator*. :func:`math.gcd` always return a :class:`int` type. " +"*denominator*. :func:`math.gcd` always returns an :class:`int` type. " "Previously, the GCD type depended on *numerator* and *denominator*." msgstr "" diff --git a/library/http.server.po b/library/http.server.po index 366867d644..d21c9e365b 100644 --- a/library/http.server.po +++ b/library/http.server.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2018-05-23 16:03+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -461,7 +461,7 @@ msgstr "" msgid "" "If the request was mapped to a file, it is opened. Any :exc:`OSError` " "exception in opening the requested file is mapped to a ``404``, ``'File not " -"found'`` error. If there was a ``'If-Modified-Since'`` header in the " +"found'`` error. If there was an ``'If-Modified-Since'`` header in the " "request, and the file was not modified after this time, a ``304``, ``'Not " "Modified'`` response is sent. Otherwise, the content type is guessed by " "calling the :meth:`guess_type` method, which in turn uses the " diff --git a/library/importlib.po b/library/importlib.po index eca2d80194..e4e4cecca2 100644 --- a/library/importlib.po +++ b/library/importlib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2018-05-23 16:04+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -869,7 +869,7 @@ msgid "" "shipped within a package. Typically this is something like a data file that " "lives next to the ``__init__.py`` file of the package. The purpose of this " "class is to help abstract out the accessing of such data files so that it " -"does not matter if the package and its data file(s) are stored in a e.g. zip " +"does not matter if the package and its data file(s) are stored e.g. in a zip " "file versus on the file system." msgstr "" diff --git a/library/importlib.resources.abc.po b/library/importlib.resources.abc.po index 0bf49a9636..31eb678ac2 100644 --- a/library/importlib.resources.abc.po +++ b/library/importlib.resources.abc.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -40,7 +40,7 @@ msgid "" "shipped within a package. Typically this is something like a data file that " "lives next to the ``__init__.py`` file of the package. The purpose of this " "class is to help abstract out the accessing of such data files so that it " -"does not matter if the package and its data file(s) are stored in a e.g. zip " +"does not matter if the package and its data file(s) are stored e.g. in a zip " "file versus on the file system." msgstr "" diff --git a/library/inspect.po b/library/inspect.po index e873661720..8a74de9c9d 100644 --- a/library/inspect.po +++ b/library/inspect.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-22 00:03+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2022-10-16 06:59+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -734,7 +734,7 @@ msgstr "" #: ../../library/inspect.rst:451 msgid "" "Functions wrapped in :func:`functools.partial` now return ``True`` if the " -"wrapped function is a :term:`asynchronous generator` function." +"wrapped function is an :term:`asynchronous generator` function." msgstr "" #: ../../library/inspect.rst:458 @@ -1214,7 +1214,7 @@ msgid "Example: print all keyword-only arguments without default values:" msgstr "" #: ../../library/inspect.rst:912 -msgid "Describes a enum value of :attr:`Parameter.kind`." +msgid "Describes an enum value of :attr:`Parameter.kind`." msgstr "" #: ../../library/inspect.rst:916 diff --git a/library/mailbox.po b/library/mailbox.po index e65d2da99c..b11afc514b 100644 --- a/library/mailbox.po +++ b/library/mailbox.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2018-05-23 16:05+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1608,7 +1608,7 @@ msgstr "" #: ../../library/mailbox.rst:1281 msgid "" -"Return an :class:`Message` instance whose headers are the message's visible " +"Return a :class:`Message` instance whose headers are the message's visible " "headers and whose body is empty." msgstr "" diff --git a/library/optparse.po b/library/optparse.po index 412926c2c8..c9f0e1ba2b 100644 --- a/library/optparse.po +++ b/library/optparse.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-27 00:03+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2018-05-23 16:07+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1628,7 +1628,7 @@ msgstr "``values``" #: ../../library/optparse.rst:1354 msgid "" -"an :class:`Values` object to store option arguments in (default: a new " +"a :class:`Values` object to store option arguments in (default: a new " "instance of :class:`Values`) -- if you give an existing object, the option " "defaults will not be initialized on it" msgstr "" diff --git a/library/os.po b/library/os.po index cf914e275c..eb4394cb83 100644 --- a/library/os.po +++ b/library/os.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-10 00:04+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2024-04-29 15:24+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1694,7 +1694,7 @@ msgstr "" #: ../../library/os.rst:1500 msgid "" -"Write the *buffers* contents to file descriptor *fd* at a offset *offset*, " +"Write the *buffers* contents to file descriptor *fd* at an offset *offset*, " "leaving the file offset unchanged. *buffers* must be a sequence of :term:" "`bytes-like objects `. Buffers are processed in array " "order. Entire contents of the first buffer is written before proceeding to " @@ -4099,7 +4099,7 @@ msgstr "" #: ../../library/os.rst:3703 msgid "" "*initval* is the initial value of the event counter. The initial value must " -"be an 32 bit unsigned integer. Please note that the initial value is limited " +"be a 32 bit unsigned integer. Please note that the initial value is limited " "to a 32 bit unsigned int although the event counter is an unsigned 64 bit " "integer with a maximum value of 2\\ :sup:`64`\\ -\\ 2." msgstr "" @@ -4168,7 +4168,7 @@ msgstr "設定新的 :func:`eventfd` 檔案描述器的 :const:`O_NONBLOCK` 狀 #: ../../library/os.rst:3783 msgid "" -"Provide semaphore-like semantics for reads from a :func:`eventfd` file " +"Provide semaphore-like semantics for reads from an :func:`eventfd` file " "descriptor. On read the internal counter is decremented by one." msgstr "" diff --git a/library/pathlib.po b/library/pathlib.po index 64eb36d2a6..984276fcac 100644 --- a/library/pathlib.po +++ b/library/pathlib.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-30 00:03+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2024-02-29 20:49+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -761,8 +761,9 @@ msgstr "" "會回傳 ``False`` 而不是引發例外。" #: ../../library/pathlib.rst:910 +#, fuzzy msgid "" -"Return a :class:`os.stat_result` object containing information about this " +"Return an :class:`os.stat_result` object containing information about this " "path, like :func:`os.stat`. The result is looked up at each call to this " "method." msgstr "" diff --git a/library/ssl.po b/library/ssl.po index 40bebfaf25..5c22818042 100644 --- a/library/ssl.po +++ b/library/ssl.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-17 00:04+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2024-05-01 14:51+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -2119,7 +2119,7 @@ msgstr "" #: ../../library/ssl.rst:1700 msgid "" -"If there is an decoding error on the server name, the TLS connection will " +"If there is a decoding error on the server name, the TLS connection will " "terminate with an :const:`ALERT_DESCRIPTION_INTERNAL_ERROR` fatal TLS alert " "message to the client." msgstr "" diff --git a/library/subprocess.po b/library/subprocess.po index 4d4688cf58..e21d3caa52 100644 --- a/library/subprocess.po +++ b/library/subprocess.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-31 00:03+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2018-05-23 16:11+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1372,7 +1372,7 @@ msgstr "" #: ../../library/subprocess.rst:1112 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " -"will have an normal priority. (default)" +"will have a normal priority. (default)" msgstr "" #: ../../library/subprocess.rst:1119 diff --git a/library/urllib.request.po b/library/urllib.request.po index da3320e7ad..944f4bf51f 100644 --- a/library/urllib.request.po +++ b/library/urllib.request.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2022-04-21 17:59+0800\n" "Last-Translator: Jordan Su \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1391,7 +1391,7 @@ msgstr "" #: ../../library/urllib.request.rst:1104 msgid "" "This method is applicable only for local hostnames. When a remote hostname " -"is given, an :exc:`~urllib.error.URLError` is raised." +"is given, a :exc:`~urllib.error.URLError` is raised." msgstr "" #: ../../library/urllib.request.rst:1112 @@ -1405,7 +1405,7 @@ msgid "" "ignores white spaces in base64 encoded data URLs so the URL may be wrapped " "in whatever source file it comes from. But even though some browsers don't " "mind about a missing padding at the end of a base64 encoded data URL, this " -"implementation will raise an :exc:`ValueError` in that case." +"implementation will raise a :exc:`ValueError` in that case." msgstr "" #: ../../library/urllib.request.rst:1127 diff --git a/using/cmdline.po b/using/cmdline.po index 461dc7b961..d003016ec8 100644 --- a/using/cmdline.po +++ b/using/cmdline.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-30 00:03+0000\n" +"POT-Creation-Date: 2024-07-23 00:04+0000\n" "PO-Revision-Date: 2018-05-23 16:19+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -218,7 +218,7 @@ msgid "" "path`." msgstr "" -#: ../../using/cmdline.rst:140 +#: ../../using/cmdline.rst:140 ../../using/cmdline.rst:723 msgid "" "Raises an :ref:`auditing event ` ``cpython.run_stdin`` with no " "arguments." @@ -508,8 +508,8 @@ msgstr "" msgid "See also :envvar:`PYTHONNOUSERSITE`." msgstr "另請參閱 :envvar:`PYTHONNOUSERSITE`。" -#: ../../using/cmdline.rst:394 ../../using/cmdline.rst:811 -#: ../../using/cmdline.rst:823 +#: ../../using/cmdline.rst:394 ../../using/cmdline.rst:816 +#: ../../using/cmdline.rst:828 msgid ":pep:`370` -- Per user site-packages directory" msgstr "" @@ -559,7 +559,7 @@ msgid "" "messages to :data:`sys.stderr`." msgstr "" -#: ../../using/cmdline.rst:436 ../../using/cmdline.rst:839 +#: ../../using/cmdline.rst:436 ../../using/cmdline.rst:844 msgid "" "The simplest settings apply a particular action unconditionally to all " "warnings emitted by a process (even those that are otherwise ignored by " @@ -632,7 +632,7 @@ msgid "" "can be used to use a regular expression on the warning message." msgstr "" -#: ../../using/cmdline.rst:487 ../../using/cmdline.rst:851 +#: ../../using/cmdline.rst:487 ../../using/cmdline.rst:856 msgid "" "See :ref:`warning-filter` and :ref:`describing-warning-filters` for more " "details." @@ -909,33 +909,37 @@ msgid "" "to force inspect mode on program termination." msgstr "" -#: ../../using/cmdline.rst:726 +#: ../../using/cmdline.rst:725 +msgid "(also 3.11.10, 3.10.15, 3.9.20, and 3.8.20) Emits audit events." +msgstr "" + +#: ../../using/cmdline.rst:731 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-u` option." msgstr "" -#: ../../using/cmdline.rst:732 +#: ../../using/cmdline.rst:737 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-v` option. If set to an integer, it is equivalent to specifying :" "option:`-v` multiple times." msgstr "" -#: ../../using/cmdline.rst:739 +#: ../../using/cmdline.rst:744 msgid "" "If this is set, Python ignores case in :keyword:`import` statements. This " "only works on Windows and macOS." msgstr "" -#: ../../using/cmdline.rst:745 +#: ../../using/cmdline.rst:750 msgid "" "If this is set to a non-empty string, Python won't try to write ``.pyc`` " "files on the import of source modules. This is equivalent to specifying " "the :option:`-B` option." msgstr "" -#: ../../using/cmdline.rst:752 +#: ../../using/cmdline.rst:757 msgid "" "If this is set, Python will write ``.pyc`` files in a mirror directory tree " "at this path, instead of in ``__pycache__`` directories within the source " @@ -943,40 +947,40 @@ msgid "" "``pycache_prefix=PATH`` option." msgstr "" -#: ../../using/cmdline.rst:762 +#: ../../using/cmdline.rst:767 msgid "" "If this variable is not set or set to ``random``, a random value is used to " "seed the hashes of str and bytes objects." msgstr "" -#: ../../using/cmdline.rst:765 +#: ../../using/cmdline.rst:770 msgid "" "If :envvar:`PYTHONHASHSEED` is set to an integer value, it is used as a " "fixed seed for generating the hash() of the types covered by the hash " "randomization." msgstr "" -#: ../../using/cmdline.rst:769 +#: ../../using/cmdline.rst:774 msgid "" "Its purpose is to allow repeatable hashing, such as for selftests for the " "interpreter itself, or to allow a cluster of python processes to share hash " "values." msgstr "" -#: ../../using/cmdline.rst:773 +#: ../../using/cmdline.rst:778 msgid "" "The integer must be a decimal number in the range [0,4294967295]. " "Specifying the value 0 will disable hash randomization." msgstr "" -#: ../../using/cmdline.rst:780 +#: ../../using/cmdline.rst:785 msgid "" "If this variable is set to an integer, it is used to configure the " "interpreter's global :ref:`integer string conversion length limitation " "`." msgstr "" -#: ../../using/cmdline.rst:788 +#: ../../using/cmdline.rst:793 msgid "" "If this is set before running the interpreter, it overrides the encoding " "used for stdin/stdout/stderr, in the syntax ``encodingname:errorhandler``. " @@ -984,17 +988,17 @@ msgid "" "have the same meaning as in :func:`str.encode`." msgstr "" -#: ../../using/cmdline.rst:793 +#: ../../using/cmdline.rst:798 msgid "" "For stderr, the ``:errorhandler`` part is ignored; the handler will always " "be ``'backslashreplace'``." msgstr "" -#: ../../using/cmdline.rst:796 +#: ../../using/cmdline.rst:801 msgid "The ``encodingname`` part is now optional." msgstr "" -#: ../../using/cmdline.rst:799 +#: ../../using/cmdline.rst:804 msgid "" "On Windows, the encoding specified by this variable is ignored for " "interactive console buffers unless :envvar:`PYTHONLEGACYWINDOWSSTDIO` is " @@ -1002,13 +1006,13 @@ msgid "" "not affected." msgstr "" -#: ../../using/cmdline.rst:806 +#: ../../using/cmdline.rst:811 msgid "" "If this is set, Python won't add the :data:`user site-packages directory " "` to :data:`sys.path`." msgstr "" -#: ../../using/cmdline.rst:816 +#: ../../using/cmdline.rst:821 msgid "" "Defines the :data:`user base directory `, which is used to " "compute the path of the :data:`user site-packages directory ` of the :mod:`asyncio` module." msgstr "" -#: ../../using/cmdline.rst:899 +#: ../../using/cmdline.rst:904 msgid "Set the Python memory allocators and/or install debug hooks." msgstr "" -#: ../../using/cmdline.rst:901 +#: ../../using/cmdline.rst:906 msgid "Set the family of memory allocators used by Python:" msgstr "" -#: ../../using/cmdline.rst:903 +#: ../../using/cmdline.rst:908 msgid "" "``default``: use the :ref:`default memory allocators `." msgstr "" -#: ../../using/cmdline.rst:905 +#: ../../using/cmdline.rst:910 msgid "" "``malloc``: use the :c:func:`malloc` function of the C library for all " "domains (:c:macro:`PYMEM_DOMAIN_RAW`, :c:macro:`PYMEM_DOMAIN_MEM`, :c:macro:" "`PYMEM_DOMAIN_OBJ`)." msgstr "" -#: ../../using/cmdline.rst:908 +#: ../../using/cmdline.rst:913 msgid "" "``pymalloc``: use the :ref:`pymalloc allocator ` for :c:macro:" "`PYMEM_DOMAIN_MEM` and :c:macro:`PYMEM_DOMAIN_OBJ` domains and use the :c:" "func:`malloc` function for the :c:macro:`PYMEM_DOMAIN_RAW` domain." msgstr "" -#: ../../using/cmdline.rst:912 +#: ../../using/cmdline.rst:917 msgid "Install :ref:`debug hooks `:" msgstr "" -#: ../../using/cmdline.rst:914 +#: ../../using/cmdline.rst:919 msgid "" "``debug``: install debug hooks on top of the :ref:`default memory allocators " "`." msgstr "" -#: ../../using/cmdline.rst:916 +#: ../../using/cmdline.rst:921 msgid "``malloc_debug``: same as ``malloc`` but also install debug hooks." msgstr "" -#: ../../using/cmdline.rst:917 +#: ../../using/cmdline.rst:922 msgid "``pymalloc_debug``: same as ``pymalloc`` but also install debug hooks." msgstr "" -#: ../../using/cmdline.rst:921 +#: ../../using/cmdline.rst:926 msgid "Added the ``\"default\"`` allocator." msgstr "" -#: ../../using/cmdline.rst:927 +#: ../../using/cmdline.rst:932 msgid "" "If set to a non-empty string, Python will print statistics of the :ref:" "`pymalloc memory allocator ` every time a new pymalloc object " "arena is created, and on shutdown." msgstr "" -#: ../../using/cmdline.rst:931 +#: ../../using/cmdline.rst:936 msgid "" "This variable is ignored if the :envvar:`PYTHONMALLOC` environment variable " "is used to force the :c:func:`malloc` allocator of the C library, or if " "Python is configured without ``pymalloc`` support." msgstr "" -#: ../../using/cmdline.rst:935 +#: ../../using/cmdline.rst:940 msgid "" "This variable can now also be used on Python compiled in release mode. It " "now has no effect if set to an empty string." msgstr "" -#: ../../using/cmdline.rst:942 +#: ../../using/cmdline.rst:947 msgid "" "If set to a non-empty string, the default :term:`filesystem encoding and " "error handler` mode will revert to their pre-3.6 values of 'mbcs' and " @@ -1139,41 +1143,41 @@ msgid "" "'surrogatepass' are used." msgstr "" -#: ../../using/cmdline.rst:947 +#: ../../using/cmdline.rst:952 msgid "" "This may also be enabled at runtime with :func:`sys." "_enablelegacywindowsfsencoding()`." msgstr "" -#: ../../using/cmdline.rst:950 ../../using/cmdline.rst:964 +#: ../../using/cmdline.rst:955 ../../using/cmdline.rst:969 msgid ":ref:`Availability `: Windows." msgstr ":ref:`適用 `：Windows。" -#: ../../using/cmdline.rst:952 +#: ../../using/cmdline.rst:957 msgid "See :pep:`529` for more details." msgstr "更多細節請見 :pep:`529`。" -#: ../../using/cmdline.rst:957 +#: ../../using/cmdline.rst:962 msgid "" "If set to a non-empty string, does not use the new console reader and " "writer. This means that Unicode characters will be encoded according to the " "active console code page, rather than using utf-8." msgstr "" -#: ../../using/cmdline.rst:961 +#: ../../using/cmdline.rst:966 msgid "" "This variable is ignored if the standard streams are redirected (to files or " "pipes) rather than referring to console buffers." msgstr "" -#: ../../using/cmdline.rst:971 +#: ../../using/cmdline.rst:976 msgid "" "If set to the value ``0``, causes the main Python command line application " "to skip coercing the legacy ASCII-based C and POSIX locales to a more " "capable UTF-8 based alternative." msgstr "" -#: ../../using/cmdline.rst:975 +#: ../../using/cmdline.rst:980 msgid "" "If this variable is *not* set (or is set to a value other than ``0``), the " "``LC_ALL`` locale override environment variable is also not set, and the " @@ -1184,19 +1188,19 @@ msgid "" "runtime:" msgstr "" -#: ../../using/cmdline.rst:983 +#: ../../using/cmdline.rst:988 msgid "``C.UTF-8``" msgstr "``C.UTF-8``" -#: ../../using/cmdline.rst:984 +#: ../../using/cmdline.rst:989 msgid "``C.utf8``" msgstr "``C.utf8``" -#: ../../using/cmdline.rst:985 +#: ../../using/cmdline.rst:990 msgid "``UTF-8``" msgstr "``UTF-8``" -#: ../../using/cmdline.rst:987 +#: ../../using/cmdline.rst:992 msgid "" "If setting one of these locale categories succeeds, then the ``LC_CTYPE`` " "environment variable will also be set accordingly in the current process " @@ -1209,7 +1213,7 @@ msgid "" "(such as Python's own :func:`locale.getdefaultlocale`)." msgstr "" -#: ../../using/cmdline.rst:997 +#: ../../using/cmdline.rst:1002 msgid "" "Configuring one of these locales (either explicitly or via the above " "implicit locale coercion) automatically enables the ``surrogateescape`` :ref:" @@ -1219,7 +1223,7 @@ msgid "" "envvar:`PYTHONIOENCODING` as usual." msgstr "" -#: ../../using/cmdline.rst:1004 +#: ../../using/cmdline.rst:1009 msgid "" "For debugging purposes, setting ``PYTHONCOERCECLOCALE=warn`` will cause " "Python to emit warning messages on ``stderr`` if either the locale coercion " @@ -1227,7 +1231,7 @@ msgid "" "active when the Python runtime is initialized." msgstr "" -#: ../../using/cmdline.rst:1009 +#: ../../using/cmdline.rst:1014 msgid "" "Also note that even when locale coercion is disabled, or when it fails to " "find a suitable target locale, :envvar:`PYTHONUTF8` will still activate by " @@ -1236,15 +1240,15 @@ msgid "" "system interfaces." msgstr "" -#: ../../using/cmdline.rst:1015 +#: ../../using/cmdline.rst:1020 msgid ":ref:`Availability `: Unix." msgstr ":ref:`適用 `：Unix。" -#: ../../using/cmdline.rst:1017 +#: ../../using/cmdline.rst:1022 msgid "See :pep:`538` for more details." msgstr "更多細節請見 :pep:`538`。" -#: ../../using/cmdline.rst:1023 +#: ../../using/cmdline.rst:1028 msgid "" "If this environment variable is set to a non-empty string, enable :ref:" "`Python Development Mode `, introducing additional runtime checks " @@ -1252,31 +1256,31 @@ msgid "" "setting the :option:`-X` ``dev`` option." msgstr "" -#: ../../using/cmdline.rst:1032 +#: ../../using/cmdline.rst:1037 msgid "If set to ``1``, enable the :ref:`Python UTF-8 Mode `." msgstr "如果設為 ``1``，則啟用 :ref:`Python UTF-8 Mode `。" -#: ../../using/cmdline.rst:1034 +#: ../../using/cmdline.rst:1039 msgid "If set to ``0``, disable the :ref:`Python UTF-8 Mode `." msgstr "如果設為 ``0``，則停用 :ref:`Python UTF-8 Mode `。" -#: ../../using/cmdline.rst:1036 +#: ../../using/cmdline.rst:1041 msgid "" "Setting any other non-empty string causes an error during interpreter " "initialisation." msgstr "" -#: ../../using/cmdline.rst:1043 +#: ../../using/cmdline.rst:1048 msgid "" "If this environment variable is set to a non-empty string, issue a :class:" "`EncodingWarning` when the locale-specific default encoding is used." msgstr "" -#: ../../using/cmdline.rst:1046 +#: ../../using/cmdline.rst:1051 msgid "See :ref:`io-encoding-warning` for details." msgstr "細節請見 :ref:`io-encoding-warning`。" -#: ../../using/cmdline.rst:1052 +#: ../../using/cmdline.rst:1057 msgid "" "If this variable is set, it disables the inclusion of the tables mapping " "extra location information (end line, start column offset and end column " @@ -1285,38 +1289,38 @@ msgid "" "visual location indicators when the interpreter displays tracebacks." msgstr "" -#: ../../using/cmdline.rst:1062 +#: ../../using/cmdline.rst:1067 msgid "" "If this variable is set to a nonzero value, it enables support for the Linux " "``perf`` profiler so Python calls can be detected by it." msgstr "" -#: ../../using/cmdline.rst:1065 +#: ../../using/cmdline.rst:1070 msgid "If set to ``0``, disable Linux ``perf`` profiler support." msgstr "" -#: ../../using/cmdline.rst:1067 +#: ../../using/cmdline.rst:1072 msgid "" "See also the :option:`-X perf <-X>` command-line option and :ref:" "`perf_profiling`." msgstr "" -#: ../../using/cmdline.rst:1074 +#: ../../using/cmdline.rst:1079 msgid "Debug-mode variables" msgstr "除錯模式變數" -#: ../../using/cmdline.rst:1078 +#: ../../using/cmdline.rst:1083 msgid "" "If set, Python will dump objects and reference counts still alive after " "shutting down the interpreter." msgstr "" -#: ../../using/cmdline.rst:1081 ../../using/cmdline.rst:1088 +#: ../../using/cmdline.rst:1086 ../../using/cmdline.rst:1093 msgid "" "Need Python configured with the :option:`--with-trace-refs` build option." msgstr "" -#: ../../using/cmdline.rst:1085 +#: ../../using/cmdline.rst:1090 msgid "" "If set, Python will dump objects and reference counts still alive after " "shutting down the interpreter into a file called *FILENAME*." From 166a7e1d777e14bf3f2ee707eaf33326218e62e1 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 24 Jul 2024 00:05:09 +0000 Subject: [PATCH 07/28] sync with cpython 257c413c --- library/sysconfig.po | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/library/sysconfig.po b/library/sysconfig.po index c479b06f82..cb05043805 100644 --- a/library/sysconfig.po +++ b/library/sysconfig.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-24 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:12+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -620,7 +620,7 @@ msgstr "" msgid "" "This is used mainly to distinguish platform-specific build directories and " "platform-specific built distributions. Typically includes the OS name and " -"version and the architecture (as supplied by 'os.uname()'), although the " +"version and the architecture (as supplied by :func:`os.uname`), although the " "exact information included depends on the OS; e.g., on Linux, the kernel " "version isn't particularly important." msgstr "" From 4025bcc204e585f1c062c1c7a72729d6a88d7a47 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Thu, 25 Jul 2024 00:05:20 +0000 Subject: [PATCH 08/28] sync with cpython dd4c8aca --- deprecations/pending-removal-in-3.13.po | 189 +++ deprecations/pending-removal-in-3.14.po | 228 +++ deprecations/pending-removal-in-3.15.po | 103 ++ deprecations/pending-removal-in-3.16.po | 28 + deprecations/pending-removal-in-future.po | 371 +++++ whatsnew/3.12.po | 1566 ++++++++++++++------- 6 files changed, 1968 insertions(+), 517 deletions(-) create mode 100644 deprecations/pending-removal-in-3.13.po create mode 100644 deprecations/pending-removal-in-3.14.po create mode 100644 deprecations/pending-removal-in-3.15.po create mode 100644 deprecations/pending-removal-in-3.16.po create mode 100644 deprecations/pending-removal-in-future.po diff --git a/deprecations/pending-removal-in-3.13.po b/deprecations/pending-removal-in-3.13.po new file mode 100644 index 0000000000..18b2e0cfa2 --- /dev/null +++ b/deprecations/pending-removal-in-3.13.po @@ -0,0 +1,189 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-07-25 00:04+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"Language: zh_TW\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: ../../deprecations/pending-removal-in-3.13.rst:2 +msgid "Pending Removal in Python 3.13" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:4 +msgid "Modules (see :pep:`594`):" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:6 +msgid ":mod:`aifc`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:7 +msgid ":mod:`audioop`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:8 +msgid ":mod:`cgi`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:9 +msgid ":mod:`cgitb`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:10 +msgid ":mod:`chunk`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:11 +msgid ":mod:`crypt`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:12 +msgid ":mod:`imghdr`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:13 +msgid ":mod:`mailcap`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:14 +msgid ":mod:`msilib`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:15 +msgid ":mod:`nis`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:16 +msgid ":mod:`nntplib`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:17 +msgid ":mod:`ossaudiodev`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:18 +msgid ":mod:`pipes`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:19 +msgid ":mod:`sndhdr`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:20 +msgid ":mod:`spwd`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:21 +msgid ":mod:`sunau`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:22 +msgid ":mod:`telnetlib`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:23 +msgid ":mod:`uu`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:24 +msgid ":mod:`xdrlib`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:26 +msgid "Other modules:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:28 +msgid ":mod:`!lib2to3`, and the :program:`2to3` program (:gh:`84540`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:30 +msgid "APIs:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:32 +msgid ":class:`!configparser.LegacyInterpolation` (:gh:`90765`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:33 +msgid "``locale.resetlocale()`` (:gh:`90817`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:34 +msgid ":meth:`!turtle.RawTurtle.settiltangle` (:gh:`50096`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:35 +msgid ":func:`!unittest.findTestCases` (:gh:`50096`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:36 +msgid ":func:`!unittest.getTestCaseNames` (:gh:`50096`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:37 +msgid ":func:`!unittest.makeSuite` (:gh:`50096`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:38 +msgid ":meth:`!unittest.TestProgram.usageExit` (:gh:`67048`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:39 +msgid ":class:`!webbrowser.MacOSX` (:gh:`86421`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:40 +msgid ":class:`classmethod` descriptor chaining (:gh:`89519`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:41 +msgid ":mod:`importlib.resources` deprecated methods:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:43 +msgid "``contents()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:44 +msgid "``is_resource()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:45 +msgid "``open_binary()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:46 +msgid "``open_text()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:47 +msgid "``path()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:48 +msgid "``read_binary()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:49 +msgid "``read_text()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:51 +msgid "" +"Use :func:`importlib.resources.files()` instead. Refer to `importlib-" +"resources: Migrating from Legacy `_ (:gh:`106531`)" +msgstr "" diff --git a/deprecations/pending-removal-in-3.14.po b/deprecations/pending-removal-in-3.14.po new file mode 100644 index 0000000000..391b88ca68 --- /dev/null +++ b/deprecations/pending-removal-in-3.14.po @@ -0,0 +1,228 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-07-25 00:04+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"Language: zh_TW\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: ../../deprecations/pending-removal-in-3.14.rst:2 +msgid "Pending Removal in Python 3.14" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:4 +msgid "" +":mod:`argparse`: The *type*, *choices*, and *metavar* parameters of :class:`!" +"argparse.BooleanOptionalAction` are deprecated and will be removed in 3.14. " +"(Contributed by Nikita Sobolev in :gh:`92248`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:9 +msgid "" +":mod:`ast`: The following features have been deprecated in documentation " +"since Python 3.8, now cause a :exc:`DeprecationWarning` to be emitted at " +"runtime when they are accessed or used, and will be removed in Python 3.14:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:13 +msgid ":class:`!ast.Num`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:14 +msgid ":class:`!ast.Str`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:15 +msgid ":class:`!ast.Bytes`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:16 +msgid ":class:`!ast.NameConstant`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:17 +msgid ":class:`!ast.Ellipsis`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:19 +msgid "" +"Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka in :gh:" +"`90953`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:22 +msgid ":mod:`asyncio`:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:24 +msgid "" +"The child watcher classes :class:`~asyncio.MultiLoopChildWatcher`, :class:" +"`~asyncio.FastChildWatcher`, :class:`~asyncio.AbstractChildWatcher` and :" +"class:`~asyncio.SafeChildWatcher` are deprecated and will be removed in " +"Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:30 +msgid "" +":func:`asyncio.set_child_watcher`, :func:`asyncio.get_child_watcher`, :meth:" +"`asyncio.AbstractEventLoopPolicy.set_child_watcher` and :meth:`asyncio." +"AbstractEventLoopPolicy.get_child_watcher` are deprecated and will be " +"removed in Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:36 +msgid "" +"The :meth:`~asyncio.get_event_loop` method of the default event loop policy " +"now emits a :exc:`DeprecationWarning` if there is no current event loop set " +"and it decides to create one. (Contributed by Serhiy Storchaka and Guido van " +"Rossum in :gh:`100160`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:41 +msgid "" +":mod:`collections.abc`: Deprecated :class:`~collections.abc.ByteString`. " +"Prefer :class:`!Sequence` or :class:`~collections.abc.Buffer`. For use in " +"typing, prefer a union, like ``bytes | bytearray``, or :class:`collections." +"abc.Buffer`. (Contributed by Shantanu Jain in :gh:`91896`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:47 +msgid "" +":mod:`email`: Deprecated the *isdst* parameter in :func:`email.utils." +"localtime`. (Contributed by Alan Williams in :gh:`72346`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:50 +msgid "" +":mod:`importlib`: ``__package__`` and ``__cached__`` will cease to be set or " +"taken into consideration by the import system (:gh:`97879`)." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:53 +msgid ":mod:`importlib.abc` deprecated classes:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:55 +msgid ":class:`!importlib.abc.ResourceReader`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:56 +msgid ":class:`!importlib.abc.Traversable`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:57 +msgid ":class:`!importlib.abc.TraversableResources`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:59 +msgid "Use :mod:`importlib.resources.abc` classes instead:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:61 +msgid ":class:`importlib.resources.abc.Traversable`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:62 +msgid ":class:`importlib.resources.abc.TraversableResources`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:64 +msgid "(Contributed by Jason R. Coombs and Hugo van Kemenade in :gh:`93963`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:66 +msgid "" +":mod:`itertools` had undocumented, inefficient, historically buggy, and " +"inconsistent support for copy, deepcopy, and pickle operations. This will be " +"removed in 3.14 for a significant reduction in code volume and maintenance " +"burden. (Contributed by Raymond Hettinger in :gh:`101588`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:72 +msgid "" +":mod:`multiprocessing`: The default start method will change to a safer one " +"on Linux, BSDs, and other non-macOS POSIX platforms where ``'fork'`` is " +"currently the default (:gh:`84559`). Adding a runtime warning about this was " +"deemed too disruptive as the majority of code is not expected to care. Use " +"the :func:`~multiprocessing.get_context` or :func:`~multiprocessing." +"set_start_method` APIs to explicitly specify when your code *requires* " +"``'fork'``. See :ref:`multiprocessing-start-methods`." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:80 +msgid "" +":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` and :meth:`~pathlib." +"PurePath.relative_to`: passing additional arguments is deprecated." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:84 +msgid "" +":mod:`pkgutil`: :func:`~pkgutil.find_loader` and :func:`~pkgutil.get_loader` " +"now raise :exc:`DeprecationWarning`; use :func:`importlib.util.find_spec` " +"instead. (Contributed by Nikita Sobolev in :gh:`97850`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:89 +msgid ":mod:`pty`:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:91 +msgid "``master_open()``: use :func:`pty.openpty`." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:92 +msgid "``slave_open()``: use :func:`pty.openpty`." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:94 +msgid ":mod:`sqlite3`:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:96 +msgid ":data:`~sqlite3.version` and :data:`~sqlite3.version_info`." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:98 +msgid "" +":meth:`~sqlite3.Cursor.execute` and :meth:`~sqlite3.Cursor.executemany` if :" +"ref:`named placeholders ` are used and *parameters* is " +"a sequence instead of a :class:`dict`." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:102 +msgid "" +"date and datetime adapter, date and timestamp converter: see the :mod:" +"`sqlite3` documentation for suggested replacement recipes." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:105 +msgid "" +":class:`types.CodeType`: Accessing :attr:`~codeobject.co_lnotab` was " +"deprecated in :pep:`626` since 3.10 and was planned to be removed in 3.12, " +"but it only got a proper :exc:`DeprecationWarning` in 3.12. May be removed " +"in 3.14. (Contributed by Nikita Sobolev in :gh:`101866`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:112 +msgid "" +":mod:`typing`: :class:`~typing.ByteString`, deprecated since Python 3.9, now " +"causes a :exc:`DeprecationWarning` to be emitted when it is used." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:115 +msgid "" +":mod:`urllib`: :class:`!urllib.parse.Quoter` is deprecated: it was not " +"intended to be a public API. (Contributed by Gregory P. Smith in :gh:" +"`88168`.)" +msgstr "" diff --git a/deprecations/pending-removal-in-3.15.po b/deprecations/pending-removal-in-3.15.po new file mode 100644 index 0000000000..265a821577 --- /dev/null +++ b/deprecations/pending-removal-in-3.15.po @@ -0,0 +1,103 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-07-25 00:04+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"Language: zh_TW\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: ../../deprecations/pending-removal-in-3.15.rst:2 +msgid "Pending Removal in Python 3.15" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:4 +msgid "" +":class:`http.server.CGIHTTPRequestHandler` will be removed along with its " +"related ``--cgi`` flag to ``python -m http.server``. It was obsolete and " +"rarely used. No direct replacement exists. *Anything* is better than CGI " +"to interface a web server with a request handler." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:9 +msgid "" +":class:`locale`: :func:`locale.getdefaultlocale` was deprecated in Python " +"3.11 and originally planned for removal in Python 3.13 (:gh:`90817`), but " +"removal has been postponed to Python 3.15. Use :func:`locale.setlocale()`, :" +"func:`locale.getencoding()` and :func:`locale.getlocale()` instead. " +"(Contributed by Hugo van Kemenade in :gh:`111187`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:16 +msgid "" +":mod:`pathlib`: :meth:`pathlib.PurePath.is_reserved` is deprecated and " +"scheduled for removal in Python 3.15. From Python 3.13 onwards, use ``os." +"path.isreserved`` to detect reserved paths on Windows." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:21 +msgid "" +":mod:`platform`: :func:`~platform.java_ver` is deprecated and will be " +"removed in 3.15. It was largely untested, had a confusing API, and was only " +"useful for Jython support. (Contributed by Nikita Sobolev in :gh:`116349`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:27 +msgid "" +":mod:`threading`: Passing any arguments to :func:`threading.RLock` is now " +"deprecated. C version allows any numbers of args and kwargs, but they are " +"just ignored. Python version does not allow any arguments. All arguments " +"will be removed from :func:`threading.RLock` in Python 3.15. (Contributed by " +"Nikita Sobolev in :gh:`102029`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:34 +msgid ":class:`typing.NamedTuple`:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:36 +msgid "" +"The undocumented keyword argument syntax for creating :class:`!NamedTuple` " +"classes (``NT = NamedTuple(\"NT\", x=int)``) is deprecated, and will be " +"disallowed in 3.15. Use the class-based syntax or the functional syntax " +"instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:40 +msgid "" +"When using the functional syntax to create a :class:`!NamedTuple` class, " +"failing to pass a value to the *fields* parameter (``NT = " +"NamedTuple(\"NT\")``) is deprecated. Passing ``None`` to the *fields* " +"parameter (``NT = NamedTuple(\"NT\", None)``) is also deprecated. Both will " +"be disallowed in Python 3.15. To create a :class:`!NamedTuple` class with 0 " +"fields, use ``class NT(NamedTuple): pass`` or ``NT = NamedTuple(\"NT\", " +"[])``." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:47 +msgid "" +":class:`typing.TypedDict`: When using the functional syntax to create a :" +"class:`!TypedDict` class, failing to pass a value to the *fields* parameter " +"(``TD = TypedDict(\"TD\")``) is deprecated. Passing ``None`` to the *fields* " +"parameter (``TD = TypedDict(\"TD\", None)``) is also deprecated. Both will " +"be disallowed in Python 3.15. To create a :class:`!TypedDict` class with 0 " +"fields, use ``class TD(TypedDict): pass`` or ``TD = TypedDict(\"TD\", {})``." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:54 +msgid "" +":mod:`wave`: Deprecate the ``getmark()``, ``setmark()`` and ``getmarkers()`` " +"methods of the :class:`wave.Wave_read` and :class:`wave.Wave_write` classes. " +"They will be removed in Python 3.15. (Contributed by Victor Stinner in :gh:" +"`105096`.)" +msgstr "" diff --git a/deprecations/pending-removal-in-3.16.po b/deprecations/pending-removal-in-3.16.po new file mode 100644 index 0000000000..a34f49d580 --- /dev/null +++ b/deprecations/pending-removal-in-3.16.po @@ -0,0 +1,28 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-07-25 00:04+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"Language: zh_TW\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: ../../deprecations/pending-removal-in-3.16.rst:2 +msgid "Pending Removal in Python 3.16" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.16.rst:4 +msgid "" +":class:`array.array` ``'u'`` type (:c:type:`wchar_t`): use the ``'w'`` type " +"instead (``Py_UCS4``)." +msgstr "" diff --git a/deprecations/pending-removal-in-future.po b/deprecations/pending-removal-in-future.po new file mode 100644 index 0000000000..9ac214f85b --- /dev/null +++ b/deprecations/pending-removal-in-future.po @@ -0,0 +1,371 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-07-25 00:04+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"Language: zh_TW\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: ../../deprecations/pending-removal-in-future.rst:2 +msgid "Pending Removal in Future Versions" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:4 +msgid "" +"The following APIs will be removed in the future, although there is " +"currently no date scheduled for their removal." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:7 +msgid "" +":mod:`argparse`: Nesting argument groups and nesting mutually exclusive " +"groups are deprecated." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:10 +msgid ":mod:`array`'s ``'u'`` format code (:gh:`57281`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:12 +msgid ":mod:`builtins`:" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:14 +msgid "``~bool``, bitwise inversion on bool." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:15 +msgid "``bool(NotImplemented)``." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:16 +msgid "" +"Generators: ``throw(type, exc, tb)`` and ``athrow(type, exc, tb)`` signature " +"is deprecated: use ``throw(exc)`` and ``athrow(exc)`` instead, the single " +"argument signature." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:19 +msgid "" +"Currently Python accepts numeric literals immediately followed by keywords, " +"for example ``0in x``, ``1or x``, ``0if 1else 2``. It allows confusing and " +"ambiguous expressions like ``[0x1for x in y]`` (which can be interpreted as " +"``[0x1 for x in y]`` or ``[0x1f or x in y]``). A syntax warning is raised " +"if the numeric literal is immediately followed by one of keywords :keyword:" +"`and`, :keyword:`else`, :keyword:`for`, :keyword:`if`, :keyword:`in`, :" +"keyword:`is` and :keyword:`or`. In a future release it will be changed to a " +"syntax error. (:gh:`87999`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:27 +msgid "" +"Support for ``__index__()`` and ``__int__()`` method returning non-int type: " +"these methods will be required to return an instance of a strict subclass " +"of :class:`int`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:30 +msgid "" +"Support for ``__float__()`` method returning a strict subclass of :class:" +"`float`: these methods will be required to return an instance of :class:" +"`float`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:33 +msgid "" +"Support for ``__complex__()`` method returning a strict subclass of :class:" +"`complex`: these methods will be required to return an instance of :class:" +"`complex`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:36 +msgid "Delegation of ``int()`` to ``__trunc__()`` method." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:38 +msgid "" +":mod:`calendar`: ``calendar.January`` and ``calendar.February`` constants " +"are deprecated and replaced by :data:`calendar.JANUARY` and :data:`calendar." +"FEBRUARY`. (Contributed by Prince Roshan in :gh:`103636`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:43 +msgid "" +":attr:`codeobject.co_lnotab`: use the :meth:`codeobject.co_lines` method " +"instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:46 +msgid ":mod:`datetime`:" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:48 +msgid "" +":meth:`~datetime.datetime.utcnow`: use ``datetime.datetime.now(tz=datetime." +"UTC)``." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:50 +msgid "" +":meth:`~datetime.datetime.utcfromtimestamp`: use ``datetime.datetime." +"fromtimestamp(timestamp, tz=datetime.UTC)``." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:53 +msgid ":mod:`gettext`: Plural value must be an integer." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:55 +msgid ":mod:`importlib`:" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:57 +msgid "``load_module()`` method: use ``exec_module()`` instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:58 +msgid "" +":func:`~importlib.util.cache_from_source` *debug_override* parameter is " +"deprecated: use the *optimization* parameter instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:61 +msgid ":mod:`importlib.metadata`:" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:63 +msgid "``EntryPoints`` tuple interface." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:64 +msgid "Implicit ``None`` on return values." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:66 +msgid "" +":mod:`mailbox`: Use of StringIO input and text mode is deprecated, use " +"BytesIO and binary mode instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:69 +msgid "" +":mod:`os`: Calling :func:`os.register_at_fork` in multi-threaded process." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:71 +msgid "" +":class:`!pydoc.ErrorDuringImport`: A tuple value for *exc_info* parameter is " +"deprecated, use an exception instance." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:74 +msgid "" +":mod:`re`: More strict rules are now applied for numerical group references " +"and group names in regular expressions. Only sequence of ASCII digits is " +"now accepted as a numerical reference. The group name in bytes patterns and " +"replacement strings can now only contain ASCII letters and digits and " +"underscore. (Contributed by Serhiy Storchaka in :gh:`91760`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:81 +msgid "" +":mod:`!sre_compile`, :mod:`!sre_constants` and :mod:`!sre_parse` modules." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:83 +msgid "" +":mod:`shutil`: :func:`~shutil.rmtree`'s *onerror* parameter is deprecated in " +"Python 3.12; use the *onexc* parameter instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:86 +msgid ":mod:`ssl` options and protocols:" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:88 +msgid ":class:`ssl.SSLContext` without protocol argument is deprecated." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:89 +msgid "" +":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` and :meth:" +"`!selected_npn_protocol` are deprecated: use ALPN instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:92 +msgid "``ssl.OP_NO_SSL*`` options" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:93 +msgid "``ssl.OP_NO_TLS*`` options" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:94 +msgid "``ssl.PROTOCOL_SSLv3``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:95 +msgid "``ssl.PROTOCOL_TLS``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:96 +msgid "``ssl.PROTOCOL_TLSv1``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:97 +msgid "``ssl.PROTOCOL_TLSv1_1``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:98 +msgid "``ssl.PROTOCOL_TLSv1_2``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:99 +msgid "``ssl.TLSVersion.SSLv3``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:100 +msgid "``ssl.TLSVersion.TLSv1``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:101 +msgid "``ssl.TLSVersion.TLSv1_1``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:103 +msgid "" +":func:`sysconfig.is_python_build` *check_home* parameter is deprecated and " +"ignored." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:106 +msgid ":mod:`threading` methods:" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:108 +msgid "" +":meth:`!threading.Condition.notifyAll`: use :meth:`~threading.Condition." +"notify_all`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:109 +msgid ":meth:`!threading.Event.isSet`: use :meth:`~threading.Event.is_set`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:110 +msgid "" +":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: use :" +"attr:`threading.Thread.daemon` attribute." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:112 +msgid "" +":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: use :" +"attr:`threading.Thread.name` attribute." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:114 +msgid ":meth:`!threading.currentThread`: use :meth:`threading.current_thread`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:115 +msgid ":meth:`!threading.activeCount`: use :meth:`threading.active_count`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:117 +msgid ":class:`typing.Text` (:gh:`92332`)." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:119 +msgid "" +":class:`unittest.IsolatedAsyncioTestCase`: it is deprecated to return a " +"value that is not ``None`` from a test case." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:122 +msgid "" +":mod:`urllib.parse` deprecated functions: :func:`~urllib.parse.urlparse` " +"instead" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:124 +msgid "``splitattr()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:125 +msgid "``splithost()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:126 +msgid "``splitnport()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:127 +msgid "``splitpasswd()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:128 +msgid "``splitport()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:129 +msgid "``splitquery()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:130 +msgid "``splittag()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:131 +msgid "``splittype()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:132 +msgid "``splituser()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:133 +msgid "``splitvalue()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:134 +msgid "``to_bytes()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:136 +msgid "" +":mod:`urllib.request`: :class:`~urllib.request.URLopener` and :class:" +"`~urllib.request.FancyURLopener` style of invoking requests is deprecated. " +"Use newer :func:`~urllib.request.urlopen` functions and methods." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:140 +msgid "" +":mod:`wsgiref`: ``SimpleHandler.stdout.write()`` should not do partial " +"writes." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:143 +msgid "" +":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`~xml." +"etree.ElementTree.Element` is deprecated. In a future release it will always " +"return ``True``. Prefer explicit ``len(elem)`` or ``elem is not None`` tests " +"instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:148 +msgid "" +":meth:`zipimport.zipimporter.load_module` is deprecated: use :meth:" +"`~zipimport.zipimporter.exec_module` instead." +msgstr "" diff --git a/whatsnew/3.12.po b/whatsnew/3.12.po index bdf15d700b..dc9167036f 100644 --- a/whatsnew/3.12.po +++ b/whatsnew/3.12.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-13 00:03+0000\n" +"POT-Creation-Date: 2024-07-25 00:04+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -266,7 +266,7 @@ msgstr "" "`unittest.TestCase` 的\\ `方法別名 `_\\ " "已被刪除。" -#: ../../whatsnew/3.12.rst:176 ../../whatsnew/3.12.rst:1973 +#: ../../whatsnew/3.12.rst:176 ../../whatsnew/3.12.rst:1836 msgid "New Features" msgstr "新增特性" @@ -1143,7 +1143,7 @@ msgid "" "Windows. (Contributed by Charles Machalow in :gh:`103179`.)" msgstr "" -#: ../../whatsnew/3.12.rst:868 ../../whatsnew/3.12.rst:1677 +#: ../../whatsnew/3.12.rst:868 ../../whatsnew/3.12.rst:1540 msgid "sqlite3" msgstr "sqlite3" @@ -1218,7 +1218,7 @@ msgid "" "Katriel in :gh:`102778`.)" msgstr "" -#: ../../whatsnew/3.12.rst:919 ../../whatsnew/3.12.rst:1872 +#: ../../whatsnew/3.12.rst:919 ../../whatsnew/3.12.rst:1735 msgid "" ":func:`sys._current_exceptions` now returns a mapping from thread-id to an " "exception instance, rather than to a ``(typ, exc, tb)`` tuple. (Contributed " @@ -1373,7 +1373,7 @@ msgid "" "Benjamin Peterson in :gh:`96734`)." msgstr "" -#: ../../whatsnew/3.12.rst:1037 ../../whatsnew/3.12.rst:1717 +#: ../../whatsnew/3.12.rst:1037 ../../whatsnew/3.12.rst:1580 msgid "unittest" msgstr "unittest" @@ -1549,11 +1549,12 @@ msgid "" "demos>`_. (Contributed by Victor Stinner in :gh:`97669`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1154 ../../whatsnew/3.12.rst:2275 +#: ../../whatsnew/3.12.rst:1154 ../../whatsnew/3.12.rst:2138 msgid "Deprecated" msgstr "已棄用" #: ../../whatsnew/3.12.rst:1156 +#: ../../deprecations/pending-removal-in-3.14.rst:4 msgid "" ":mod:`argparse`: The *type*, *choices*, and *metavar* parameters of :class:`!" "argparse.BooleanOptionalAction` are deprecated and will be removed in 3.14. " @@ -1568,34 +1569,41 @@ msgid "" "Python 3.14:" msgstr "" -#: ../../whatsnew/3.12.rst:1165 ../../whatsnew/3.12.rst:1411 +#: ../../whatsnew/3.12.rst:1165 +#: ../../deprecations/pending-removal-in-3.14.rst:13 msgid ":class:`!ast.Num`" msgstr ":class:`!ast.Num`" -#: ../../whatsnew/3.12.rst:1166 ../../whatsnew/3.12.rst:1412 +#: ../../whatsnew/3.12.rst:1166 +#: ../../deprecations/pending-removal-in-3.14.rst:14 msgid ":class:`!ast.Str`" msgstr ":class:`!ast.Str`" -#: ../../whatsnew/3.12.rst:1167 ../../whatsnew/3.12.rst:1413 +#: ../../whatsnew/3.12.rst:1167 +#: ../../deprecations/pending-removal-in-3.14.rst:15 msgid ":class:`!ast.Bytes`" msgstr ":class:`!ast.Bytes`" -#: ../../whatsnew/3.12.rst:1168 ../../whatsnew/3.12.rst:1414 +#: ../../whatsnew/3.12.rst:1168 +#: ../../deprecations/pending-removal-in-3.14.rst:16 msgid ":class:`!ast.NameConstant`" msgstr ":class:`!ast.NameConstant`" -#: ../../whatsnew/3.12.rst:1169 ../../whatsnew/3.12.rst:1415 +#: ../../whatsnew/3.12.rst:1169 +#: ../../deprecations/pending-removal-in-3.14.rst:17 msgid ":class:`!ast.Ellipsis`" msgstr ":class:`!ast.Ellipsis`" #: ../../whatsnew/3.12.rst:1171 +#: ../../deprecations/pending-removal-in-3.14.rst:19 msgid "" "Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka in :gh:" "`90953`.)" msgstr "" "改用 :class:`ast.Constant`。（由 Serhiy Storchaka 在 :gh:`90953` 中貢獻。）" -#: ../../whatsnew/3.12.rst:1174 ../../whatsnew/3.12.rst:1417 +#: ../../whatsnew/3.12.rst:1174 +#: ../../deprecations/pending-removal-in-3.14.rst:22 msgid ":mod:`asyncio`:" msgstr ":mod:`asyncio`：" @@ -1608,6 +1616,7 @@ msgid "" msgstr "" #: ../../whatsnew/3.12.rst:1182 +#: ../../deprecations/pending-removal-in-3.14.rst:30 msgid "" ":func:`asyncio.set_child_watcher`, :func:`asyncio.get_child_watcher`, :meth:" "`asyncio.AbstractEventLoopPolicy.set_child_watcher` and :meth:`asyncio." @@ -1616,6 +1625,7 @@ msgid "" msgstr "" #: ../../whatsnew/3.12.rst:1188 +#: ../../deprecations/pending-removal-in-3.14.rst:36 msgid "" "The :meth:`~asyncio.get_event_loop` method of the default event loop policy " "now emits a :exc:`DeprecationWarning` if there is no current event loop set " @@ -1624,6 +1634,7 @@ msgid "" msgstr "" #: ../../whatsnew/3.12.rst:1193 +#: ../../deprecations/pending-removal-in-future.rst:38 msgid "" ":mod:`calendar`: ``calendar.January`` and ``calendar.February`` constants " "are deprecated and replaced by :data:`calendar.JANUARY` and :data:`calendar." @@ -1662,31 +1673,38 @@ msgid "" "removal in Python 3.14:" msgstr ":mod:`importlib.abc`：棄用下列類別，預定於 Python 3.14 中移除：" -#: ../../whatsnew/3.12.rst:1216 ../../whatsnew/3.12.rst:1434 +#: ../../whatsnew/3.12.rst:1216 +#: ../../deprecations/pending-removal-in-3.14.rst:55 msgid ":class:`!importlib.abc.ResourceReader`" msgstr ":class:`!importlib.abc.ResourceReader`" -#: ../../whatsnew/3.12.rst:1217 ../../whatsnew/3.12.rst:1435 +#: ../../whatsnew/3.12.rst:1217 +#: ../../deprecations/pending-removal-in-3.14.rst:56 msgid ":class:`!importlib.abc.Traversable`" msgstr ":class:`!importlib.abc.Traversable`" -#: ../../whatsnew/3.12.rst:1218 ../../whatsnew/3.12.rst:1436 +#: ../../whatsnew/3.12.rst:1218 +#: ../../deprecations/pending-removal-in-3.14.rst:57 msgid ":class:`!importlib.abc.TraversableResources`" msgstr ":class:`!importlib.abc.TraversableResources`" #: ../../whatsnew/3.12.rst:1220 +#: ../../deprecations/pending-removal-in-3.14.rst:59 msgid "Use :mod:`importlib.resources.abc` classes instead:" msgstr "請改用 :mod:`importlib.resources.abc` 類別：" #: ../../whatsnew/3.12.rst:1222 +#: ../../deprecations/pending-removal-in-3.14.rst:61 msgid ":class:`importlib.resources.abc.Traversable`" msgstr ":class:`importlib.resources.abc.Traversable`" #: ../../whatsnew/3.12.rst:1223 +#: ../../deprecations/pending-removal-in-3.14.rst:62 msgid ":class:`importlib.resources.abc.TraversableResources`" msgstr ":class:`importlib.resources.abc.TraversableResources`" #: ../../whatsnew/3.12.rst:1225 +#: ../../deprecations/pending-removal-in-3.14.rst:64 msgid "(Contributed by Jason R. Coombs and Hugo van Kemenade in :gh:`93963`.)" msgstr "（由 Jason R. Coombs 和 Hugo van Kemenade 於 :gh:`93963` 中貢獻。）" @@ -1769,6 +1787,7 @@ msgstr "" "*onexc*。（由 Irit Katriel 於 :gh:`102828` 中貢獻。）" #: ../../whatsnew/3.12.rst:1278 +#: ../../deprecations/pending-removal-in-3.14.rst:94 msgid ":mod:`sqlite3`:" msgstr ":mod:`sqlite3`：" @@ -1869,370 +1888,797 @@ msgid "" "(Contributed by Nikita Sobolev in :gh:`101866`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1345 +#: ../../deprecations/pending-removal-in-3.13.rst:2 msgid "Pending Removal in Python 3.13" msgstr "Python 3.13 中待決議的移除項目" -#: ../../whatsnew/3.12.rst:1347 -msgid "" -"The following modules and APIs have been deprecated in earlier Python " -"releases, and will be removed in Python 3.13." -msgstr "" -"以下模組和 API 在早期的 Python 版本中已被棄用，並將在 Python 3.13 中刪除。" - -#: ../../whatsnew/3.12.rst:1350 +#: ../../deprecations/pending-removal-in-3.13.rst:4 msgid "Modules (see :pep:`594`):" msgstr "模組（參見:pep:`594`）：" -#: ../../whatsnew/3.12.rst:1352 +#: ../../deprecations/pending-removal-in-3.13.rst:6 msgid ":mod:`aifc`" msgstr ":mod:`aifc`" -#: ../../whatsnew/3.12.rst:1353 +#: ../../deprecations/pending-removal-in-3.13.rst:7 msgid ":mod:`audioop`" msgstr ":mod:`audioop`" -#: ../../whatsnew/3.12.rst:1354 +#: ../../deprecations/pending-removal-in-3.13.rst:8 msgid ":mod:`cgi`" msgstr ":mod:`cgi`" -#: ../../whatsnew/3.12.rst:1355 +#: ../../deprecations/pending-removal-in-3.13.rst:9 msgid ":mod:`cgitb`" msgstr ":mod:`cgitb`" -#: ../../whatsnew/3.12.rst:1356 +#: ../../deprecations/pending-removal-in-3.13.rst:10 msgid ":mod:`chunk`" msgstr ":mod:`chunk`" -#: ../../whatsnew/3.12.rst:1357 +#: ../../deprecations/pending-removal-in-3.13.rst:11 msgid ":mod:`crypt`" msgstr ":mod:`crypt`" -#: ../../whatsnew/3.12.rst:1358 +#: ../../deprecations/pending-removal-in-3.13.rst:12 msgid ":mod:`imghdr`" msgstr ":mod:`imghdr`" -#: ../../whatsnew/3.12.rst:1359 +#: ../../deprecations/pending-removal-in-3.13.rst:13 msgid ":mod:`mailcap`" msgstr ":mod:`mailcap`" -#: ../../whatsnew/3.12.rst:1360 +#: ../../deprecations/pending-removal-in-3.13.rst:14 msgid ":mod:`msilib`" msgstr ":mod:`msilib`" -#: ../../whatsnew/3.12.rst:1361 +#: ../../deprecations/pending-removal-in-3.13.rst:15 msgid ":mod:`nis`" msgstr ":mod:`nis`" -#: ../../whatsnew/3.12.rst:1362 +#: ../../deprecations/pending-removal-in-3.13.rst:16 msgid ":mod:`nntplib`" msgstr ":mod:`nntplib`" -#: ../../whatsnew/3.12.rst:1363 +#: ../../deprecations/pending-removal-in-3.13.rst:17 msgid ":mod:`ossaudiodev`" msgstr ":mod:`ossaudiodev`" -#: ../../whatsnew/3.12.rst:1364 +#: ../../deprecations/pending-removal-in-3.13.rst:18 msgid ":mod:`pipes`" msgstr ":mod:`pipes`" -#: ../../whatsnew/3.12.rst:1365 +#: ../../deprecations/pending-removal-in-3.13.rst:19 msgid ":mod:`sndhdr`" msgstr ":mod:`sndhdr`" -#: ../../whatsnew/3.12.rst:1366 +#: ../../deprecations/pending-removal-in-3.13.rst:20 msgid ":mod:`spwd`" msgstr ":mod:`spwd`" -#: ../../whatsnew/3.12.rst:1367 +#: ../../deprecations/pending-removal-in-3.13.rst:21 msgid ":mod:`sunau`" msgstr ":mod:`sunau`" -#: ../../whatsnew/3.12.rst:1368 +#: ../../deprecations/pending-removal-in-3.13.rst:22 msgid ":mod:`telnetlib`" msgstr ":mod:`telnetlib`" -#: ../../whatsnew/3.12.rst:1369 +#: ../../deprecations/pending-removal-in-3.13.rst:23 msgid ":mod:`uu`" msgstr ":mod:`uu`" -#: ../../whatsnew/3.12.rst:1370 +#: ../../deprecations/pending-removal-in-3.13.rst:24 msgid ":mod:`xdrlib`" msgstr ":mod:`xdrlib`" -#: ../../whatsnew/3.12.rst:1372 +#: ../../deprecations/pending-removal-in-3.13.rst:26 msgid "Other modules:" msgstr "其他模組：" -#: ../../whatsnew/3.12.rst:1374 +#: ../../deprecations/pending-removal-in-3.13.rst:28 msgid ":mod:`!lib2to3`, and the :program:`2to3` program (:gh:`84540`)" msgstr ":mod:`!lib2to3` 以及 :program:`2to3` 程式 (:gh:`84540`)" -#: ../../whatsnew/3.12.rst:1376 ../../whatsnew/3.12.rst:1466 +#: ../../deprecations/pending-removal-in-3.13.rst:30 msgid "APIs:" msgstr "API：" -#: ../../whatsnew/3.12.rst:1378 +#: ../../deprecations/pending-removal-in-3.13.rst:32 msgid ":class:`!configparser.LegacyInterpolation` (:gh:`90765`)" msgstr ":class:`!configparser.LegacyInterpolation` (:gh:`90765`)" -#: ../../whatsnew/3.12.rst:1379 +#: ../../deprecations/pending-removal-in-3.13.rst:33 msgid "``locale.resetlocale()`` (:gh:`90817`)" msgstr "``locale.resetlocale()`` (:gh:`90817`)" -#: ../../whatsnew/3.12.rst:1380 +#: ../../deprecations/pending-removal-in-3.13.rst:34 msgid ":meth:`!turtle.RawTurtle.settiltangle` (:gh:`50096`)" msgstr ":meth:`!turtle.RawTurtle.settiltangle` (:gh:`50096`)" -#: ../../whatsnew/3.12.rst:1381 +#: ../../deprecations/pending-removal-in-3.13.rst:35 msgid ":func:`!unittest.findTestCases` (:gh:`50096`)" msgstr ":func:`!unittest.findTestCases` (:gh:`50096`)" -#: ../../whatsnew/3.12.rst:1382 +#: ../../deprecations/pending-removal-in-3.13.rst:36 msgid ":func:`!unittest.getTestCaseNames` (:gh:`50096`)" msgstr ":func:`!unittest.getTestCaseNames` (:gh:`50096`)" -#: ../../whatsnew/3.12.rst:1383 +#: ../../deprecations/pending-removal-in-3.13.rst:37 msgid ":func:`!unittest.makeSuite` (:gh:`50096`)" msgstr ":func:`!unittest.makeSuite` (:gh:`50096`)" -#: ../../whatsnew/3.12.rst:1384 +#: ../../deprecations/pending-removal-in-3.13.rst:38 msgid ":meth:`!unittest.TestProgram.usageExit` (:gh:`67048`)" msgstr ":meth:`!unittest.TestProgram.usageExit` (:gh:`67048`)" -#: ../../whatsnew/3.12.rst:1385 +#: ../../deprecations/pending-removal-in-3.13.rst:39 msgid ":class:`!webbrowser.MacOSX` (:gh:`86421`)" msgstr ":class:`!webbrowser.MacOSX` (:gh:`86421`)" -#: ../../whatsnew/3.12.rst:1386 +#: ../../deprecations/pending-removal-in-3.13.rst:40 msgid ":class:`classmethod` descriptor chaining (:gh:`89519`)" msgstr ":class:`classmethod` 描述器鏈結 (:gh:`89519`)" -#: ../../whatsnew/3.12.rst:1387 +#: ../../deprecations/pending-removal-in-3.13.rst:41 msgid ":mod:`importlib.resources` deprecated methods:" msgstr ":mod:`importlib.resources` 中被棄用的方法：" -#: ../../whatsnew/3.12.rst:1389 +#: ../../deprecations/pending-removal-in-3.13.rst:43 msgid "``contents()``" msgstr "``contents()``" -#: ../../whatsnew/3.12.rst:1390 +#: ../../deprecations/pending-removal-in-3.13.rst:44 msgid "``is_resource()``" msgstr "``is_resource()``" -#: ../../whatsnew/3.12.rst:1391 +#: ../../deprecations/pending-removal-in-3.13.rst:45 msgid "``open_binary()``" msgstr "``open_binary()``" -#: ../../whatsnew/3.12.rst:1392 +#: ../../deprecations/pending-removal-in-3.13.rst:46 msgid "``open_text()``" msgstr "``open_text()``" -#: ../../whatsnew/3.12.rst:1393 +#: ../../deprecations/pending-removal-in-3.13.rst:47 msgid "``path()``" msgstr "``path()``" -#: ../../whatsnew/3.12.rst:1394 +#: ../../deprecations/pending-removal-in-3.13.rst:48 msgid "``read_binary()``" msgstr "``read_binary()``" -#: ../../whatsnew/3.12.rst:1395 +#: ../../deprecations/pending-removal-in-3.13.rst:49 msgid "``read_text()``" msgstr "``read_text()``" -#: ../../whatsnew/3.12.rst:1397 +#: ../../deprecations/pending-removal-in-3.13.rst:51 msgid "" "Use :func:`importlib.resources.files()` instead. Refer to `importlib-" "resources: Migrating from Legacy `_ (:gh:`106531`)" msgstr "" -#: ../../whatsnew/3.12.rst:1401 ../../whatsnew/3.12.rst:2362 +#: ../../whatsnew/3.12.rst:2225 +#: ../../deprecations/pending-removal-in-3.14.rst:2 msgid "Pending Removal in Python 3.14" msgstr "Python 3.14 中待決議的移除項目" -#: ../../whatsnew/3.12.rst:1403 +#: ../../deprecations/pending-removal-in-3.14.rst:9 msgid "" -"The following APIs have been deprecated and will be removed in Python 3.14." -msgstr "以下 API 已被棄用並將在 Python 3.14 中移除。" +":mod:`ast`: The following features have been deprecated in documentation " +"since Python 3.8, now cause a :exc:`DeprecationWarning` to be emitted at " +"runtime when they are accessed or used, and will be removed in Python 3.14:" +msgstr "" -#: ../../whatsnew/3.12.rst:1406 +#: ../../deprecations/pending-removal-in-3.14.rst:24 msgid "" -":mod:`argparse`: The *type*, *choices*, and *metavar* parameters of :class:`!" -"argparse.BooleanOptionalAction`" +"The child watcher classes :class:`~asyncio.MultiLoopChildWatcher`, :class:" +"`~asyncio.FastChildWatcher`, :class:`~asyncio.AbstractChildWatcher` and :" +"class:`~asyncio.SafeChildWatcher` are deprecated and will be removed in " +"Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1409 -msgid ":mod:`ast`:" -msgstr ":mod:`ast`：" +#: ../../deprecations/pending-removal-in-3.14.rst:41 +msgid "" +":mod:`collections.abc`: Deprecated :class:`~collections.abc.ByteString`. " +"Prefer :class:`!Sequence` or :class:`~collections.abc.Buffer`. For use in " +"typing, prefer a union, like ``bytes | bytearray``, or :class:`collections." +"abc.Buffer`. (Contributed by Shantanu Jain in :gh:`91896`.)" +msgstr "" -#: ../../whatsnew/3.12.rst:1419 -msgid ":class:`!asyncio.MultiLoopChildWatcher`" -msgstr ":class:`!asyncio.MultiLoopChildWatcher`" +#: ../../deprecations/pending-removal-in-3.14.rst:47 +#, fuzzy +msgid "" +":mod:`email`: Deprecated the *isdst* parameter in :func:`email.utils." +"localtime`. (Contributed by Alan Williams in :gh:`72346`.)" +msgstr "" +":mod:`email`：棄用 :func:`email.utils.localtime` 中的 *isdst* 參數。（由 " +"Alan Williams 於 :gh:`72346` 中貢獻。）" -#: ../../whatsnew/3.12.rst:1420 -msgid ":class:`!asyncio.FastChildWatcher`" -msgstr ":class:`!asyncio.FastChildWatcher`" +#: ../../deprecations/pending-removal-in-3.14.rst:50 +msgid "" +":mod:`importlib`: ``__package__`` and ``__cached__`` will cease to be set or " +"taken into consideration by the import system (:gh:`97879`)." +msgstr "" -#: ../../whatsnew/3.12.rst:1421 -msgid ":class:`!asyncio.AbstractChildWatcher`" -msgstr ":class:`!asyncio.AbstractChildWatcher`" +#: ../../deprecations/pending-removal-in-3.14.rst:53 +#, fuzzy +msgid ":mod:`importlib.abc` deprecated classes:" +msgstr ":mod:`importlib.resources` 中被棄用的方法：" -#: ../../whatsnew/3.12.rst:1422 -msgid ":class:`!asyncio.SafeChildWatcher`" -msgstr ":class:`!asyncio.SafeChildWatcher`" +#: ../../deprecations/pending-removal-in-3.14.rst:66 +msgid "" +":mod:`itertools` had undocumented, inefficient, historically buggy, and " +"inconsistent support for copy, deepcopy, and pickle operations. This will be " +"removed in 3.14 for a significant reduction in code volume and maintenance " +"burden. (Contributed by Raymond Hettinger in :gh:`101588`.)" +msgstr "" -#: ../../whatsnew/3.12.rst:1423 -msgid ":func:`!asyncio.set_child_watcher`" -msgstr ":func:`!asyncio.set_child_watcher`" +#: ../../deprecations/pending-removal-in-3.14.rst:72 +msgid "" +":mod:`multiprocessing`: The default start method will change to a safer one " +"on Linux, BSDs, and other non-macOS POSIX platforms where ``'fork'`` is " +"currently the default (:gh:`84559`). Adding a runtime warning about this was " +"deemed too disruptive as the majority of code is not expected to care. Use " +"the :func:`~multiprocessing.get_context` or :func:`~multiprocessing." +"set_start_method` APIs to explicitly specify when your code *requires* " +"``'fork'``. See :ref:`multiprocessing-start-methods`." +msgstr "" -#: ../../whatsnew/3.12.rst:1424 -msgid ":func:`!asyncio.get_child_watcher`," -msgstr ":func:`!asyncio.get_child_watcher`、" +#: ../../deprecations/pending-removal-in-3.14.rst:80 +msgid "" +":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` and :meth:`~pathlib." +"PurePath.relative_to`: passing additional arguments is deprecated." +msgstr "" -#: ../../whatsnew/3.12.rst:1425 -msgid ":meth:`!asyncio.AbstractEventLoopPolicy.set_child_watcher`" -msgstr ":meth:`!asyncio.AbstractEventLoopPolicy.set_child_watcher`" +#: ../../deprecations/pending-removal-in-3.14.rst:84 +msgid "" +":mod:`pkgutil`: :func:`~pkgutil.find_loader` and :func:`~pkgutil.get_loader` " +"now raise :exc:`DeprecationWarning`; use :func:`importlib.util.find_spec` " +"instead. (Contributed by Nikita Sobolev in :gh:`97850`.)" +msgstr "" -#: ../../whatsnew/3.12.rst:1426 -msgid ":meth:`!asyncio.AbstractEventLoopPolicy.get_child_watcher`" -msgstr ":meth:`!asyncio.AbstractEventLoopPolicy.get_child_watcher`" +#: ../../deprecations/pending-removal-in-3.14.rst:89 +msgid ":mod:`pty`:" +msgstr ":mod:`pty`：" -#: ../../whatsnew/3.12.rst:1428 -msgid ":mod:`collections.abc`: :class:`!collections.abc.ByteString`." -msgstr ":mod:`collections.abc`: :class:`!collections.abc.ByteString`。" +#: ../../deprecations/pending-removal-in-3.14.rst:91 +msgid "``master_open()``: use :func:`pty.openpty`." +msgstr "" -#: ../../whatsnew/3.12.rst:1430 -msgid ":mod:`email`: the *isdst* parameter in :func:`email.utils.localtime`." -msgstr ":mod:`email`：:func:`email.utils.localtime` 中的 *isdst* 參數。" +#: ../../deprecations/pending-removal-in-3.14.rst:92 +msgid "``slave_open()``: use :func:`pty.openpty`." +msgstr "" -#: ../../whatsnew/3.12.rst:1432 -msgid ":mod:`importlib.abc`:" -msgstr ":mod:`importlib.abc`：" +#: ../../deprecations/pending-removal-in-3.14.rst:96 +msgid ":data:`~sqlite3.version` and :data:`~sqlite3.version_info`." +msgstr "" -#: ../../whatsnew/3.12.rst:1438 -msgid ":mod:`itertools`: Support for copy, deepcopy, and pickle operations." -msgstr ":mod:`itertools`：支援複製、深度複製 (deepcopy) 和 pickle 操作。" +#: ../../deprecations/pending-removal-in-3.14.rst:98 +msgid "" +":meth:`~sqlite3.Cursor.execute` and :meth:`~sqlite3.Cursor.executemany` if :" +"ref:`named placeholders ` are used and *parameters* is " +"a sequence instead of a :class:`dict`." +msgstr "" -#: ../../whatsnew/3.12.rst:1440 -msgid ":mod:`pkgutil`:" -msgstr ":mod:`pkgutil`：" +#: ../../deprecations/pending-removal-in-3.14.rst:102 +msgid "" +"date and datetime adapter, date and timestamp converter: see the :mod:" +"`sqlite3` documentation for suggested replacement recipes." +msgstr "" -#: ../../whatsnew/3.12.rst:1442 -msgid ":func:`!pkgutil.find_loader`" -msgstr ":func:`!pkgutil.find_loader`" +#: ../../deprecations/pending-removal-in-3.14.rst:105 +msgid "" +":class:`types.CodeType`: Accessing :attr:`~codeobject.co_lnotab` was " +"deprecated in :pep:`626` since 3.10 and was planned to be removed in 3.12, " +"but it only got a proper :exc:`DeprecationWarning` in 3.12. May be removed " +"in 3.14. (Contributed by Nikita Sobolev in :gh:`101866`.)" +msgstr "" -#: ../../whatsnew/3.12.rst:1443 -msgid ":func:`!pkgutil.get_loader`." -msgstr ":func:`!pkgutil.get_loader`。" +#: ../../deprecations/pending-removal-in-3.14.rst:112 +msgid "" +":mod:`typing`: :class:`~typing.ByteString`, deprecated since Python 3.9, now " +"causes a :exc:`DeprecationWarning` to be emitted when it is used." +msgstr "" -#: ../../whatsnew/3.12.rst:1445 -msgid ":mod:`pty`:" -msgstr ":mod:`pty`：" +#: ../../deprecations/pending-removal-in-3.14.rst:115 +msgid "" +":mod:`urllib`: :class:`!urllib.parse.Quoter` is deprecated: it was not " +"intended to be a public API. (Contributed by Gregory P. Smith in :gh:" +"`88168`.)" +msgstr "" -#: ../../whatsnew/3.12.rst:1447 -msgid ":func:`!pty.master_open`" -msgstr ":func:`!pty.master_open`" +#: ../../whatsnew/3.12.rst:2262 +#: ../../deprecations/pending-removal-in-3.15.rst:2 +msgid "Pending Removal in Python 3.15" +msgstr "Python 3.15 中待決議的移除項目" -#: ../../whatsnew/3.12.rst:1448 -msgid ":func:`!pty.slave_open`" -msgstr ":func:`!pty.slave_open`" +#: ../../deprecations/pending-removal-in-3.15.rst:4 +msgid "" +":class:`http.server.CGIHTTPRequestHandler` will be removed along with its " +"related ``--cgi`` flag to ``python -m http.server``. It was obsolete and " +"rarely used. No direct replacement exists. *Anything* is better than CGI " +"to interface a web server with a request handler." +msgstr "" -#: ../../whatsnew/3.12.rst:1450 -msgid ":mod:`shutil`: The *onerror* argument of :func:`shutil.rmtree`" -msgstr ":mod:`shutil`：:func:`shutil.rmtree` 的 *onerror* 引數" +#: ../../deprecations/pending-removal-in-3.15.rst:9 +msgid "" +":class:`locale`: :func:`locale.getdefaultlocale` was deprecated in Python " +"3.11 and originally planned for removal in Python 3.13 (:gh:`90817`), but " +"removal has been postponed to Python 3.15. Use :func:`locale.setlocale()`, :" +"func:`locale.getencoding()` and :func:`locale.getlocale()` instead. " +"(Contributed by Hugo van Kemenade in :gh:`111187`.)" +msgstr "" -#: ../../whatsnew/3.12.rst:1452 -msgid ":mod:`typing`: :class:`!typing.ByteString`" -msgstr ":mod:`typing`：:class:`!typing.ByteString`" +#: ../../deprecations/pending-removal-in-3.15.rst:16 +msgid "" +":mod:`pathlib`: :meth:`pathlib.PurePath.is_reserved` is deprecated and " +"scheduled for removal in Python 3.15. From Python 3.13 onwards, use ``os." +"path.isreserved`` to detect reserved paths on Windows." +msgstr "" -#: ../../whatsnew/3.12.rst:1454 +#: ../../deprecations/pending-removal-in-3.15.rst:21 msgid "" -":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`xml." -"etree.ElementTree.Element`." +":mod:`platform`: :func:`~platform.java_ver` is deprecated and will be " +"removed in 3.15. It was largely untested, had a confusing API, and was only " +"useful for Jython support. (Contributed by Nikita Sobolev in :gh:`116349`.)" msgstr "" -":mod:`xml.etree.ElementTree`：測試 :class:`xml.etree.ElementTree.Element` 的" -"真值。" -#: ../../whatsnew/3.12.rst:1456 -msgid "The ``__package__`` and ``__cached__`` attributes on module objects." -msgstr "模組物件上的 ``__package__`` 和 ``__cached__`` 屬性。" +#: ../../deprecations/pending-removal-in-3.15.rst:27 +msgid "" +":mod:`threading`: Passing any arguments to :func:`threading.RLock` is now " +"deprecated. C version allows any numbers of args and kwargs, but they are " +"just ignored. Python version does not allow any arguments. All arguments " +"will be removed from :func:`threading.RLock` in Python 3.15. (Contributed by " +"Nikita Sobolev in :gh:`102029`.)" +msgstr "" -#: ../../whatsnew/3.12.rst:1458 -msgid "The :attr:`~codeobject.co_lnotab` attribute of code objects." -msgstr "程式碼物件的 :attr:`~codeobject.co_lnotab` 屬性。" +#: ../../deprecations/pending-removal-in-3.15.rst:34 +#, fuzzy +msgid ":class:`typing.NamedTuple`:" +msgstr ":class:`typing.Text` (:gh:`92332`)" -#: ../../whatsnew/3.12.rst:1461 ../../whatsnew/3.12.rst:2399 -msgid "Pending Removal in Python 3.15" -msgstr "Python 3.15 中待決議的移除項目" +#: ../../deprecations/pending-removal-in-3.15.rst:36 +msgid "" +"The undocumented keyword argument syntax for creating :class:`!NamedTuple` " +"classes (``NT = NamedTuple(\"NT\", x=int)``) is deprecated, and will be " +"disallowed in 3.15. Use the class-based syntax or the functional syntax " +"instead." +msgstr "" -#: ../../whatsnew/3.12.rst:1463 +#: ../../deprecations/pending-removal-in-3.15.rst:40 msgid "" -"The following APIs have been deprecated and will be removed in Python 3.15." +"When using the functional syntax to create a :class:`!NamedTuple` class, " +"failing to pass a value to the *fields* parameter (``NT = " +"NamedTuple(\"NT\")``) is deprecated. Passing ``None`` to the *fields* " +"parameter (``NT = NamedTuple(\"NT\", None)``) is also deprecated. Both will " +"be disallowed in Python 3.15. To create a :class:`!NamedTuple` class with 0 " +"fields, use ``class NT(NamedTuple): pass`` or ``NT = NamedTuple(\"NT\", " +"[])``." msgstr "" -#: ../../whatsnew/3.12.rst:1468 -msgid ":func:`locale.getdefaultlocale` (:gh:`90817`)" -msgstr ":func:`locale.getdefaultlocale` (:gh:`90817`)" +#: ../../deprecations/pending-removal-in-3.15.rst:47 +msgid "" +":class:`typing.TypedDict`: When using the functional syntax to create a :" +"class:`!TypedDict` class, failing to pass a value to the *fields* parameter " +"(``TD = TypedDict(\"TD\")``) is deprecated. Passing ``None`` to the *fields* " +"parameter (``TD = TypedDict(\"TD\", None)``) is also deprecated. Both will " +"be disallowed in Python 3.15. To create a :class:`!TypedDict` class with 0 " +"fields, use ``class TD(TypedDict): pass`` or ``TD = TypedDict(\"TD\", {})``." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:54 +msgid "" +":mod:`wave`: Deprecate the ``getmark()``, ``setmark()`` and ``getmarkers()`` " +"methods of the :class:`wave.Wave_read` and :class:`wave.Wave_write` classes. " +"They will be removed in Python 3.15. (Contributed by Victor Stinner in :gh:" +"`105096`.)" +msgstr "" -#: ../../whatsnew/3.12.rst:1472 ../../whatsnew/3.12.rst:2417 +#: ../../deprecations/pending-removal-in-3.16.rst:2 +#, fuzzy +msgid "Pending Removal in Python 3.16" +msgstr "Python 3.13 中待決議的移除項目" + +#: ../../deprecations/pending-removal-in-3.16.rst:4 +msgid "" +":class:`array.array` ``'u'`` type (:c:type:`wchar_t`): use the ``'w'`` type " +"instead (``Py_UCS4``)." +msgstr "" + +#: ../../whatsnew/3.12.rst:2280 +#: ../../deprecations/pending-removal-in-future.rst:2 msgid "Pending Removal in Future Versions" msgstr "未來版本中待決議的移除項目" -#: ../../whatsnew/3.12.rst:1474 +#: ../../deprecations/pending-removal-in-future.rst:4 +#, fuzzy msgid "" -"The following APIs were deprecated in earlier Python versions and will be " -"removed, although there is currently no date scheduled for their removal." +"The following APIs will be removed in the future, although there is " +"currently no date scheduled for their removal." +msgstr "以下 API 已棄用，且將會被移除，雖目前尚未定下移除日期。" + +#: ../../deprecations/pending-removal-in-future.rst:7 +msgid "" +":mod:`argparse`: Nesting argument groups and nesting mutually exclusive " +"groups are deprecated." msgstr "" -"以下 API 在早期 Python 版本中已棄用，並將被刪除，但目前還沒有計劃刪除它們的日" -"期。" -#: ../../whatsnew/3.12.rst:1477 +#: ../../deprecations/pending-removal-in-future.rst:10 msgid ":mod:`array`'s ``'u'`` format code (:gh:`57281`)" msgstr ":mod:`array` 的 ``'u'`` 格式碼 (:gh:`57281`)" -#: ../../whatsnew/3.12.rst:1479 -msgid ":class:`typing.Text` (:gh:`92332`)" -msgstr ":class:`typing.Text` (:gh:`92332`)" +#: ../../deprecations/pending-removal-in-future.rst:12 +#, fuzzy +msgid ":mod:`builtins`:" +msgstr ":mod:`typing`：" -#: ../../whatsnew/3.12.rst:1481 +#: ../../deprecations/pending-removal-in-future.rst:14 +msgid "``~bool``, bitwise inversion on bool." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:15 +msgid "``bool(NotImplemented)``." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:16 +msgid "" +"Generators: ``throw(type, exc, tb)`` and ``athrow(type, exc, tb)`` signature " +"is deprecated: use ``throw(exc)`` and ``athrow(exc)`` instead, the single " +"argument signature." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:19 msgid "" "Currently Python accepts numeric literals immediately followed by keywords, " "for example ``0in x``, ``1or x``, ``0if 1else 2``. It allows confusing and " "ambiguous expressions like ``[0x1for x in y]`` (which can be interpreted as " -"``[0x1 for x in y]`` or ``[0x1f or x in y]``). A syntax warning is raised if " -"the numeric literal is immediately followed by one of keywords :keyword:" +"``[0x1 for x in y]`` or ``[0x1f or x in y]``). A syntax warning is raised " +"if the numeric literal is immediately followed by one of keywords :keyword:" "`and`, :keyword:`else`, :keyword:`for`, :keyword:`if`, :keyword:`in`, :" -"keyword:`is` and :keyword:`or`. In a future release it will be changed to a " +"keyword:`is` and :keyword:`or`. In a future release it will be changed to a " "syntax error. (:gh:`87999`)" msgstr "" -#: ../../whatsnew/3.12.rst:1492 ../../whatsnew/3.12.rst:2449 +#: ../../deprecations/pending-removal-in-future.rst:27 +msgid "" +"Support for ``__index__()`` and ``__int__()`` method returning non-int type: " +"these methods will be required to return an instance of a strict subclass " +"of :class:`int`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:30 +msgid "" +"Support for ``__float__()`` method returning a strict subclass of :class:" +"`float`: these methods will be required to return an instance of :class:" +"`float`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:33 +msgid "" +"Support for ``__complex__()`` method returning a strict subclass of :class:" +"`complex`: these methods will be required to return an instance of :class:" +"`complex`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:36 +msgid "Delegation of ``int()`` to ``__trunc__()`` method." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:43 +#, fuzzy +msgid "" +":attr:`codeobject.co_lnotab`: use the :meth:`codeobject.co_lines` method " +"instead." +msgstr "程式碼物件的 :attr:`~codeobject.co_lnotab` 屬性。" + +#: ../../deprecations/pending-removal-in-future.rst:46 +#, fuzzy +msgid ":mod:`datetime`:" +msgstr ":mod:`ast`：" + +#: ../../deprecations/pending-removal-in-future.rst:48 +msgid "" +":meth:`~datetime.datetime.utcnow`: use ``datetime.datetime.now(tz=datetime." +"UTC)``." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:50 +msgid "" +":meth:`~datetime.datetime.utcfromtimestamp`: use ``datetime.datetime." +"fromtimestamp(timestamp, tz=datetime.UTC)``." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:53 +msgid ":mod:`gettext`: Plural value must be an integer." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:55 +#, fuzzy +msgid ":mod:`importlib`:" +msgstr ":mod:`importlib.abc`：" + +#: ../../deprecations/pending-removal-in-future.rst:57 +msgid "``load_module()`` method: use ``exec_module()`` instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:58 +msgid "" +":func:`~importlib.util.cache_from_source` *debug_override* parameter is " +"deprecated: use the *optimization* parameter instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:61 +#, fuzzy +msgid ":mod:`importlib.metadata`:" +msgstr ":mod:`importlib.abc`：" + +#: ../../deprecations/pending-removal-in-future.rst:63 +msgid "``EntryPoints`` tuple interface." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:64 +msgid "Implicit ``None`` on return values." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:66 +msgid "" +":mod:`mailbox`: Use of StringIO input and text mode is deprecated, use " +"BytesIO and binary mode instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:69 +msgid "" +":mod:`os`: Calling :func:`os.register_at_fork` in multi-threaded process." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:71 +msgid "" +":class:`!pydoc.ErrorDuringImport`: A tuple value for *exc_info* parameter is " +"deprecated, use an exception instance." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:74 +msgid "" +":mod:`re`: More strict rules are now applied for numerical group references " +"and group names in regular expressions. Only sequence of ASCII digits is " +"now accepted as a numerical reference. The group name in bytes patterns and " +"replacement strings can now only contain ASCII letters and digits and " +"underscore. (Contributed by Serhiy Storchaka in :gh:`91760`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:81 +msgid "" +":mod:`!sre_compile`, :mod:`!sre_constants` and :mod:`!sre_parse` modules." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:83 +msgid "" +":mod:`shutil`: :func:`~shutil.rmtree`'s *onerror* parameter is deprecated in " +"Python 3.12; use the *onexc* parameter instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:86 +msgid ":mod:`ssl` options and protocols:" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:88 +msgid ":class:`ssl.SSLContext` without protocol argument is deprecated." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:89 +msgid "" +":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` and :meth:" +"`!selected_npn_protocol` are deprecated: use ALPN instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:92 +msgid "``ssl.OP_NO_SSL*`` options" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:93 +msgid "``ssl.OP_NO_TLS*`` options" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:94 +msgid "``ssl.PROTOCOL_SSLv3``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:95 +msgid "``ssl.PROTOCOL_TLS``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:96 +msgid "``ssl.PROTOCOL_TLSv1``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:97 +msgid "``ssl.PROTOCOL_TLSv1_1``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:98 +msgid "``ssl.PROTOCOL_TLSv1_2``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:99 +msgid "``ssl.TLSVersion.SSLv3``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:100 +msgid "``ssl.TLSVersion.TLSv1``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:101 +msgid "``ssl.TLSVersion.TLSv1_1``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:103 +msgid "" +":func:`sysconfig.is_python_build` *check_home* parameter is deprecated and " +"ignored." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:106 +#, fuzzy +msgid ":mod:`threading` methods:" +msgstr ":mod:`typing`：" + +#: ../../deprecations/pending-removal-in-future.rst:108 +msgid "" +":meth:`!threading.Condition.notifyAll`: use :meth:`~threading.Condition." +"notify_all`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:109 +msgid ":meth:`!threading.Event.isSet`: use :meth:`~threading.Event.is_set`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:110 +msgid "" +":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: use :" +"attr:`threading.Thread.daemon` attribute." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:112 +msgid "" +":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: use :" +"attr:`threading.Thread.name` attribute." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:114 +msgid ":meth:`!threading.currentThread`: use :meth:`threading.current_thread`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:115 +msgid ":meth:`!threading.activeCount`: use :meth:`threading.active_count`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:117 +#, fuzzy +msgid ":class:`typing.Text` (:gh:`92332`)." +msgstr ":class:`typing.Text` (:gh:`92332`)" + +#: ../../deprecations/pending-removal-in-future.rst:119 +msgid "" +":class:`unittest.IsolatedAsyncioTestCase`: it is deprecated to return a " +"value that is not ``None`` from a test case." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:122 +msgid "" +":mod:`urllib.parse` deprecated functions: :func:`~urllib.parse.urlparse` " +"instead" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:124 +#, fuzzy +msgid "``splitattr()``" +msgstr "``path()``" + +#: ../../deprecations/pending-removal-in-future.rst:125 +#, fuzzy +msgid "``splithost()``" +msgstr "``path()``" + +#: ../../deprecations/pending-removal-in-future.rst:126 +#, fuzzy +msgid "``splitnport()``" +msgstr "``path()``" + +#: ../../deprecations/pending-removal-in-future.rst:127 +#, fuzzy +msgid "``splitpasswd()``" +msgstr "``imp.reload()``" + +#: ../../deprecations/pending-removal-in-future.rst:128 +#, fuzzy +msgid "``splitport()``" +msgstr "``path()``" + +#: ../../deprecations/pending-removal-in-future.rst:129 +#, fuzzy +msgid "``splitquery()``" +msgstr "``path()``" + +#: ../../deprecations/pending-removal-in-future.rst:130 +#, fuzzy +msgid "``splittag()``" +msgstr "``imp.get_tag()``" + +#: ../../deprecations/pending-removal-in-future.rst:131 +#, fuzzy +msgid "``splittype()``" +msgstr "``path()``" + +#: ../../deprecations/pending-removal-in-future.rst:132 +#, fuzzy +msgid "``splituser()``" +msgstr "``path()``" + +#: ../../deprecations/pending-removal-in-future.rst:133 +#, fuzzy +msgid "``splitvalue()``" +msgstr "``path()``" + +#: ../../deprecations/pending-removal-in-future.rst:134 +#, fuzzy +msgid "``to_bytes()``" +msgstr "``contents()``" + +#: ../../deprecations/pending-removal-in-future.rst:136 +msgid "" +":mod:`urllib.request`: :class:`~urllib.request.URLopener` and :class:" +"`~urllib.request.FancyURLopener` style of invoking requests is deprecated. " +"Use newer :func:`~urllib.request.urlopen` functions and methods." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:140 +msgid "" +":mod:`wsgiref`: ``SimpleHandler.stdout.write()`` should not do partial " +"writes." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:143 +msgid "" +":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`~xml." +"etree.ElementTree.Element` is deprecated. In a future release it will always " +"return ``True``. Prefer explicit ``len(elem)`` or ``elem is not None`` tests " +"instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:148 +msgid "" +":meth:`zipimport.zipimporter.load_module` is deprecated: use :meth:" +"`~zipimport.zipimporter.exec_module` instead." +msgstr "" + +#: ../../whatsnew/3.12.rst:1355 ../../whatsnew/3.12.rst:2312 msgid "Removed" msgstr "已移除" -#: ../../whatsnew/3.12.rst:1495 +#: ../../whatsnew/3.12.rst:1358 msgid "asynchat and asyncore" msgstr "asynchat 和 asyncore" -#: ../../whatsnew/3.12.rst:1497 +#: ../../whatsnew/3.12.rst:1360 msgid "" "These two modules have been removed according to the schedule in :pep:`594`, " "having been deprecated in Python 3.6. Use :mod:`asyncio` instead. " "(Contributed by Nikita Sobolev in :gh:`96580`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1504 +#: ../../whatsnew/3.12.rst:1367 msgid "configparser" msgstr "configparser" -#: ../../whatsnew/3.12.rst:1506 +#: ../../whatsnew/3.12.rst:1369 msgid "" "Several names deprecated in the :mod:`configparser` way back in 3.2 have " "been removed per :gh:`89336`:" msgstr "" -#: ../../whatsnew/3.12.rst:1509 +#: ../../whatsnew/3.12.rst:1372 msgid "" ":class:`configparser.ParsingError` no longer has a ``filename`` attribute or " "argument. Use the ``source`` attribute and argument instead." @@ -2240,23 +2686,23 @@ msgstr "" ":class:`configparser.ParsingError` 不再具有 ``filename`` 屬性或引數。請改用 " "``source`` 屬性和引數。" -#: ../../whatsnew/3.12.rst:1511 +#: ../../whatsnew/3.12.rst:1374 msgid "" ":mod:`configparser` no longer has a ``SafeConfigParser`` class. Use the " "shorter :class:`~configparser.ConfigParser` name instead." msgstr "" -#: ../../whatsnew/3.12.rst:1513 +#: ../../whatsnew/3.12.rst:1376 msgid "" ":class:`configparser.ConfigParser` no longer has a ``readfp`` method. Use :" "meth:`~configparser.ConfigParser.read_file` instead." msgstr "" -#: ../../whatsnew/3.12.rst:1517 +#: ../../whatsnew/3.12.rst:1380 msgid "distutils" msgstr "distutils" -#: ../../whatsnew/3.12.rst:1519 +#: ../../whatsnew/3.12.rst:1382 msgid "" "Remove the :py:mod:`!distutils` package. It was deprecated in Python 3.10 " "by :pep:`632` \"Deprecate distutils module\". For projects still using " @@ -2265,17 +2711,17 @@ msgid "" "Victor Stinner in :gh:`92584`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1526 +#: ../../whatsnew/3.12.rst:1389 msgid "ensurepip" msgstr "ensurepip" -#: ../../whatsnew/3.12.rst:1528 +#: ../../whatsnew/3.12.rst:1391 msgid "" "Remove the bundled setuptools wheel from :mod:`ensurepip`, and stop " "installing setuptools in environments created by :mod:`venv`." msgstr "" -#: ../../whatsnew/3.12.rst:1531 +#: ../../whatsnew/3.12.rst:1394 msgid "" "``pip (>= 22.1)`` does not require setuptools to be installed in the " "environment. ``setuptools``-based (and ``distutils``-based) packages can " @@ -2283,7 +2729,7 @@ msgid "" "the build environment it uses for building a package." msgstr "" -#: ../../whatsnew/3.12.rst:1537 +#: ../../whatsnew/3.12.rst:1400 msgid "" "``easy_install``, ``pkg_resources``, ``setuptools`` and ``distutils`` are no " "longer provided by default in environments created with ``venv`` or " @@ -2293,25 +2739,25 @@ msgid "" "(typically, using pip)." msgstr "" -#: ../../whatsnew/3.12.rst:1544 +#: ../../whatsnew/3.12.rst:1407 msgid "(Contributed by Pradyun Gedam in :gh:`95299`.)" msgstr "（由 Pradyun Gedam 於 :gh:`95299` 中貢獻。）" -#: ../../whatsnew/3.12.rst:1547 +#: ../../whatsnew/3.12.rst:1410 msgid "enum" msgstr "enum" -#: ../../whatsnew/3.12.rst:1549 +#: ../../whatsnew/3.12.rst:1412 msgid "" "Remove :mod:`enum`'s ``EnumMeta.__getattr__``, which is no longer needed for " "enum attribute access. (Contributed by Ethan Furman in :gh:`95083`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1554 +#: ../../whatsnew/3.12.rst:1417 msgid "ftplib" msgstr "ftplib" -#: ../../whatsnew/3.12.rst:1556 +#: ../../whatsnew/3.12.rst:1419 msgid "" "Remove :mod:`ftplib`'s ``FTP_TLS.ssl_version`` class attribute: use the " "*context* parameter instead. (Contributed by Victor Stinner in :gh:`94172`.)" @@ -2319,11 +2765,11 @@ msgstr "" "移除 :mod:`ftplib` 的 ``FTP_TLS.ssl_version`` 類別屬性：請改用 *context* 參" "數。（由 Victor Stinner 於 :gh:`94172` 中貢獻。）" -#: ../../whatsnew/3.12.rst:1561 +#: ../../whatsnew/3.12.rst:1424 msgid "gzip" msgstr "gzip" -#: ../../whatsnew/3.12.rst:1563 +#: ../../whatsnew/3.12.rst:1426 msgid "" "Remove the ``filename`` attribute of :mod:`gzip`'s :class:`gzip.GzipFile`, " "deprecated since Python 2.6, use the :attr:`~gzip.GzipFile.name` attribute " @@ -2332,11 +2778,11 @@ msgid "" "`94196`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1570 +#: ../../whatsnew/3.12.rst:1433 msgid "hashlib" msgstr "hashlib" -#: ../../whatsnew/3.12.rst:1572 +#: ../../whatsnew/3.12.rst:1435 msgid "" "Remove the pure Python implementation of :mod:`hashlib`'s :func:`hashlib." "pbkdf2_hmac()`, deprecated in Python 3.10. Python 3.10 and newer requires " @@ -2345,17 +2791,17 @@ msgid "" "Stinner in :gh:`94199`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1579 ../../whatsnew/3.12.rst:1606 +#: ../../whatsnew/3.12.rst:1442 ../../whatsnew/3.12.rst:1469 msgid "importlib" msgstr "importlib" -#: ../../whatsnew/3.12.rst:1581 +#: ../../whatsnew/3.12.rst:1444 msgid "" "Many previously deprecated cleanups in :mod:`importlib` have now been " "completed:" msgstr "現已完成清理 :mod:`importlib` 中許多過去已經棄用的東西：" -#: ../../whatsnew/3.12.rst:1584 +#: ../../whatsnew/3.12.rst:1447 msgid "" "References to, and support for :meth:`!module_repr()` has been removed. " "(Contributed by Barry Warsaw in :gh:`97850`.)" @@ -2363,164 +2809,164 @@ msgstr "" "對 :meth:`!module_repr()` 的參照和支援已刪除。（由 Barry Warsaw 在 :gh:" "`97850` 中貢獻。）" -#: ../../whatsnew/3.12.rst:1587 +#: ../../whatsnew/3.12.rst:1450 msgid "" "``importlib.util.set_package``, ``importlib.util.set_loader`` and " "``importlib.util.module_for_loader`` have all been removed. (Contributed by " "Brett Cannon and Nikita Sobolev in :gh:`65961` and :gh:`97850`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1591 +#: ../../whatsnew/3.12.rst:1454 msgid "" "Support for ``find_loader()`` and ``find_module()`` APIs have been removed. " "(Contributed by Barry Warsaw in :gh:`98040`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1594 +#: ../../whatsnew/3.12.rst:1457 msgid "" "``importlib.abc.Finder``, ``pkgutil.ImpImporter``, and ``pkgutil.ImpLoader`` " "have been removed. (Contributed by Barry Warsaw in :gh:`98040`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1598 ../../whatsnew/3.12.rst:1606 +#: ../../whatsnew/3.12.rst:1461 ../../whatsnew/3.12.rst:1469 msgid "imp" msgstr "imp" -#: ../../whatsnew/3.12.rst:1600 +#: ../../whatsnew/3.12.rst:1463 msgid "" "The :mod:`!imp` module has been removed. (Contributed by Barry Warsaw in :" "gh:`98040`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1603 +#: ../../whatsnew/3.12.rst:1466 msgid "To migrate, consult the following correspondence table:" msgstr "" -#: ../../whatsnew/3.12.rst:1608 +#: ../../whatsnew/3.12.rst:1471 msgid "``imp.NullImporter``" msgstr "``imp.NullImporter``" -#: ../../whatsnew/3.12.rst:1608 +#: ../../whatsnew/3.12.rst:1471 msgid "Insert ``None`` into ``sys.path_importer_cache``" msgstr "將 ``None`` 插入 ``sys.path_importer_cache``" -#: ../../whatsnew/3.12.rst:1609 +#: ../../whatsnew/3.12.rst:1472 msgid "``imp.cache_from_source()``" msgstr "``imp.cache_from_source()``" -#: ../../whatsnew/3.12.rst:1609 +#: ../../whatsnew/3.12.rst:1472 msgid ":func:`importlib.util.cache_from_source`" msgstr ":func:`importlib.util.cache_from_source`" -#: ../../whatsnew/3.12.rst:1610 +#: ../../whatsnew/3.12.rst:1473 msgid "``imp.find_module()``" msgstr "``imp.find_module()``" -#: ../../whatsnew/3.12.rst:1610 +#: ../../whatsnew/3.12.rst:1473 msgid ":func:`importlib.util.find_spec`" msgstr ":func:`importlib.util.find_spec`" -#: ../../whatsnew/3.12.rst:1611 +#: ../../whatsnew/3.12.rst:1474 msgid "``imp.get_magic()``" msgstr "``imp.get_magic()``" -#: ../../whatsnew/3.12.rst:1611 +#: ../../whatsnew/3.12.rst:1474 msgid ":attr:`importlib.util.MAGIC_NUMBER`" msgstr ":attr:`importlib.util.MAGIC_NUMBER`" -#: ../../whatsnew/3.12.rst:1612 +#: ../../whatsnew/3.12.rst:1475 msgid "``imp.get_suffixes()``" msgstr "``imp.get_suffixes()``" -#: ../../whatsnew/3.12.rst:1612 +#: ../../whatsnew/3.12.rst:1475 msgid "" ":attr:`importlib.machinery.SOURCE_SUFFIXES`, :attr:`importlib.machinery." "EXTENSION_SUFFIXES`, and :attr:`importlib.machinery.BYTECODE_SUFFIXES`" msgstr "" -#: ../../whatsnew/3.12.rst:1613 +#: ../../whatsnew/3.12.rst:1476 msgid "``imp.get_tag()``" msgstr "``imp.get_tag()``" -#: ../../whatsnew/3.12.rst:1613 +#: ../../whatsnew/3.12.rst:1476 msgid ":attr:`sys.implementation.cache_tag `" msgstr ":attr:`sys.implementation.cache_tag `" -#: ../../whatsnew/3.12.rst:1614 +#: ../../whatsnew/3.12.rst:1477 msgid "``imp.load_module()``" msgstr "``imp.load_module()``" -#: ../../whatsnew/3.12.rst:1614 +#: ../../whatsnew/3.12.rst:1477 msgid ":func:`importlib.import_module`" msgstr ":func:`importlib.import_module`" -#: ../../whatsnew/3.12.rst:1615 +#: ../../whatsnew/3.12.rst:1478 msgid "``imp.new_module(name)``" msgstr "``imp.new_module(name)``" -#: ../../whatsnew/3.12.rst:1615 +#: ../../whatsnew/3.12.rst:1478 msgid "``types.ModuleType(name)``" msgstr "``types.ModuleType(name)``" -#: ../../whatsnew/3.12.rst:1616 +#: ../../whatsnew/3.12.rst:1479 msgid "``imp.reload()``" msgstr "``imp.reload()``" -#: ../../whatsnew/3.12.rst:1616 +#: ../../whatsnew/3.12.rst:1479 msgid ":func:`importlib.reload`" msgstr ":func:`importlib.reload`" -#: ../../whatsnew/3.12.rst:1617 +#: ../../whatsnew/3.12.rst:1480 msgid "``imp.source_from_cache()``" msgstr "``imp.source_from_cache()``" -#: ../../whatsnew/3.12.rst:1617 +#: ../../whatsnew/3.12.rst:1480 msgid ":func:`importlib.util.source_from_cache`" msgstr ":func:`importlib.util.source_from_cache`" -#: ../../whatsnew/3.12.rst:1618 +#: ../../whatsnew/3.12.rst:1481 msgid "``imp.load_source()``" msgstr "``imp.load_source()``" -#: ../../whatsnew/3.12.rst:1618 +#: ../../whatsnew/3.12.rst:1481 msgid "*See below*" msgstr "*見下文*" -#: ../../whatsnew/3.12.rst:1621 +#: ../../whatsnew/3.12.rst:1484 msgid "Replace ``imp.load_source()`` with::" msgstr "用以下取代 ``imp.load_source()``： ::" -#: ../../whatsnew/3.12.rst:1636 +#: ../../whatsnew/3.12.rst:1499 msgid "Remove :mod:`!imp` functions and attributes with no replacements:" msgstr "移除 :mod:`!imp` 函式和屬性、沒有替代方案：" -#: ../../whatsnew/3.12.rst:1638 +#: ../../whatsnew/3.12.rst:1501 msgid "Undocumented functions:" msgstr "未以文件記錄的函式：" -#: ../../whatsnew/3.12.rst:1640 +#: ../../whatsnew/3.12.rst:1503 msgid "``imp.init_builtin()``" msgstr "``imp.init_builtin()``" -#: ../../whatsnew/3.12.rst:1641 +#: ../../whatsnew/3.12.rst:1504 msgid "``imp.load_compiled()``" msgstr "``imp.load_compiled()``" -#: ../../whatsnew/3.12.rst:1642 +#: ../../whatsnew/3.12.rst:1505 msgid "``imp.load_dynamic()``" msgstr "``imp.load_dynamic()``" -#: ../../whatsnew/3.12.rst:1643 +#: ../../whatsnew/3.12.rst:1506 msgid "``imp.load_package()``" msgstr "``imp.load_package()``" -#: ../../whatsnew/3.12.rst:1645 +#: ../../whatsnew/3.12.rst:1508 msgid "" "``imp.lock_held()``, ``imp.acquire_lock()``, ``imp.release_lock()``: the " "locking scheme has changed in Python 3.3 to per-module locks." msgstr "" -#: ../../whatsnew/3.12.rst:1647 +#: ../../whatsnew/3.12.rst:1510 msgid "" "``imp.find_module()`` constants: ``SEARCH_ERROR``, ``PY_SOURCE``, " "``PY_COMPILED``, ``C_EXTENSION``, ``PY_RESOURCE``, ``PKG_DIRECTORY``, " @@ -2530,11 +2976,11 @@ msgstr "" "``PY_COMPILED``、``C_EXTENSION``、``PY_RESOURCE``、``PKG_DIRECTORY``、" "``C_BUILTIN``、``PY_FROZEN``、``PY_CODERESOURCE``、``IMP_HOOK``。" -#: ../../whatsnew/3.12.rst:1652 +#: ../../whatsnew/3.12.rst:1515 msgid "io" msgstr "io" -#: ../../whatsnew/3.12.rst:1654 +#: ../../whatsnew/3.12.rst:1517 msgid "" "Remove :mod:`io`'s ``io.OpenWrapper`` and ``_pyio.OpenWrapper``, deprecated " "in Python 3.10: just use :func:`open` instead. The :func:`open` (:func:`io." @@ -2543,22 +2989,22 @@ msgid "" "`94169`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1661 +#: ../../whatsnew/3.12.rst:1524 msgid "locale" msgstr "locale" -#: ../../whatsnew/3.12.rst:1663 +#: ../../whatsnew/3.12.rst:1526 msgid "" "Remove :mod:`locale`'s :func:`!locale.format` function, deprecated in Python " "3.7: use :func:`locale.format_string` instead. (Contributed by Victor " "Stinner in :gh:`94226`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1668 +#: ../../whatsnew/3.12.rst:1531 msgid "smtpd" msgstr "smtpd" -#: ../../whatsnew/3.12.rst:1670 +#: ../../whatsnew/3.12.rst:1533 msgid "" "The ``smtpd`` module has been removed according to the schedule in :pep:" "`594`, having been deprecated in Python 3.4.7 and 3.5.4. Use the :pypi:" @@ -2566,27 +3012,27 @@ msgid "" "(Contributed by Oleg Iarygin in :gh:`93243`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1679 +#: ../../whatsnew/3.12.rst:1542 msgid "" "The following undocumented :mod:`sqlite3` features, deprecated in Python " "3.10, are now removed:" msgstr "" -#: ../../whatsnew/3.12.rst:1682 +#: ../../whatsnew/3.12.rst:1545 msgid "``sqlite3.enable_shared_cache()``" msgstr "``sqlite3.enable_shared_cache()``" -#: ../../whatsnew/3.12.rst:1683 +#: ../../whatsnew/3.12.rst:1546 msgid "``sqlite3.OptimizedUnicode``" msgstr "``sqlite3.OptimizedUnicode``" -#: ../../whatsnew/3.12.rst:1685 +#: ../../whatsnew/3.12.rst:1548 msgid "" "If a shared cache must be used, open the database in URI mode using the " "``cache=shared`` query parameter." msgstr "" -#: ../../whatsnew/3.12.rst:1688 +#: ../../whatsnew/3.12.rst:1551 msgid "" "The ``sqlite3.OptimizedUnicode`` text factory has been an alias for :class:" "`str` since Python 3.3. Code that previously set the text factory to " @@ -2594,22 +3040,22 @@ msgid "" "default value which is also ``str``." msgstr "" -#: ../../whatsnew/3.12.rst:1693 +#: ../../whatsnew/3.12.rst:1556 msgid "(Contributed by Erlend E. Aasland in :gh:`92548`.)" msgstr "（由 Erlend E. Aasland 於 :gh:`92548` 中貢獻。）" -#: ../../whatsnew/3.12.rst:1696 +#: ../../whatsnew/3.12.rst:1559 msgid "ssl" msgstr "ssl" -#: ../../whatsnew/3.12.rst:1698 +#: ../../whatsnew/3.12.rst:1561 msgid "" "Remove :mod:`ssl`'s :func:`!ssl.RAND_pseudo_bytes` function, deprecated in " "Python 3.6: use :func:`os.urandom` or :func:`ssl.RAND_bytes` instead. " "(Contributed by Victor Stinner in :gh:`94199`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1702 +#: ../../whatsnew/3.12.rst:1565 msgid "" "Remove the :func:`!ssl.match_hostname` function. It was deprecated in Python " "3.7. OpenSSL performs hostname matching since Python 3.7, Python no longer " @@ -2617,7 +3063,7 @@ msgid "" "Stinner in :gh:`94199`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1708 +#: ../../whatsnew/3.12.rst:1571 msgid "" "Remove the :func:`!ssl.wrap_socket` function, deprecated in Python 3.7: " "instead, create a :class:`ssl.SSLContext` object and call its :class:`ssl." @@ -2628,189 +3074,189 @@ msgid "" "`94199`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1719 +#: ../../whatsnew/3.12.rst:1582 msgid "Remove many long-deprecated :mod:`unittest` features:" msgstr "移除許多 :mod:`unittest` 中被棄用已久的功能：" -#: ../../whatsnew/3.12.rst:1723 +#: ../../whatsnew/3.12.rst:1586 msgid "A number of :class:`~unittest.TestCase` method aliases:" msgstr "許多 :class:`~unittest.TestCase` 方法別名：" -#: ../../whatsnew/3.12.rst:1726 +#: ../../whatsnew/3.12.rst:1589 msgid "Deprecated alias" msgstr "已棄用的別名" -#: ../../whatsnew/3.12.rst:1726 +#: ../../whatsnew/3.12.rst:1589 msgid "Method Name" msgstr "方法名稱" -#: ../../whatsnew/3.12.rst:1726 +#: ../../whatsnew/3.12.rst:1589 msgid "Deprecated in" msgstr "已棄用於" -#: ../../whatsnew/3.12.rst:1728 +#: ../../whatsnew/3.12.rst:1591 msgid "``failUnless``" msgstr "``failUnless``" -#: ../../whatsnew/3.12.rst:1728 ../../whatsnew/3.12.rst:1735 +#: ../../whatsnew/3.12.rst:1591 ../../whatsnew/3.12.rst:1598 msgid ":meth:`.assertTrue`" msgstr ":meth:`.assertTrue`" -#: ../../whatsnew/3.12.rst:1728 ../../whatsnew/3.12.rst:1729 -#: ../../whatsnew/3.12.rst:1730 ../../whatsnew/3.12.rst:1731 -#: ../../whatsnew/3.12.rst:1732 ../../whatsnew/3.12.rst:1733 -#: ../../whatsnew/3.12.rst:1734 +#: ../../whatsnew/3.12.rst:1591 ../../whatsnew/3.12.rst:1592 +#: ../../whatsnew/3.12.rst:1593 ../../whatsnew/3.12.rst:1594 +#: ../../whatsnew/3.12.rst:1595 ../../whatsnew/3.12.rst:1596 +#: ../../whatsnew/3.12.rst:1597 msgid "3.1" msgstr "3.1" -#: ../../whatsnew/3.12.rst:1729 +#: ../../whatsnew/3.12.rst:1592 msgid "``failIf``" msgstr "``failIf``" -#: ../../whatsnew/3.12.rst:1729 +#: ../../whatsnew/3.12.rst:1592 msgid ":meth:`.assertFalse`" msgstr ":meth:`.assertFalse`" -#: ../../whatsnew/3.12.rst:1730 +#: ../../whatsnew/3.12.rst:1593 msgid "``failUnlessEqual``" msgstr "``failUnlessEqual``" -#: ../../whatsnew/3.12.rst:1730 ../../whatsnew/3.12.rst:1736 +#: ../../whatsnew/3.12.rst:1593 ../../whatsnew/3.12.rst:1599 msgid ":meth:`.assertEqual`" msgstr ":meth:`.assertEqual`" -#: ../../whatsnew/3.12.rst:1731 +#: ../../whatsnew/3.12.rst:1594 msgid "``failIfEqual``" msgstr "``failIfEqual``" -#: ../../whatsnew/3.12.rst:1731 ../../whatsnew/3.12.rst:1737 +#: ../../whatsnew/3.12.rst:1594 ../../whatsnew/3.12.rst:1600 msgid ":meth:`.assertNotEqual`" msgstr ":meth:`.assertNotEqual`" -#: ../../whatsnew/3.12.rst:1732 +#: ../../whatsnew/3.12.rst:1595 msgid "``failUnlessAlmostEqual``" msgstr "``failUnlessAlmostEqual``" -#: ../../whatsnew/3.12.rst:1732 ../../whatsnew/3.12.rst:1738 +#: ../../whatsnew/3.12.rst:1595 ../../whatsnew/3.12.rst:1601 msgid ":meth:`.assertAlmostEqual`" msgstr ":meth:`.assertAlmostEqual`" -#: ../../whatsnew/3.12.rst:1733 +#: ../../whatsnew/3.12.rst:1596 msgid "``failIfAlmostEqual``" msgstr "``failIfAlmostEqual``" -#: ../../whatsnew/3.12.rst:1733 ../../whatsnew/3.12.rst:1739 +#: ../../whatsnew/3.12.rst:1596 ../../whatsnew/3.12.rst:1602 msgid ":meth:`.assertNotAlmostEqual`" msgstr ":meth:`.assertNotAlmostEqual`" -#: ../../whatsnew/3.12.rst:1734 +#: ../../whatsnew/3.12.rst:1597 msgid "``failUnlessRaises``" msgstr "``failUnlessRaises``" -#: ../../whatsnew/3.12.rst:1734 +#: ../../whatsnew/3.12.rst:1597 msgid ":meth:`.assertRaises`" msgstr ":meth:`.assertRaises`" -#: ../../whatsnew/3.12.rst:1735 +#: ../../whatsnew/3.12.rst:1598 msgid "``assert_``" msgstr "``assert_``" -#: ../../whatsnew/3.12.rst:1735 ../../whatsnew/3.12.rst:1736 -#: ../../whatsnew/3.12.rst:1737 ../../whatsnew/3.12.rst:1738 -#: ../../whatsnew/3.12.rst:1739 ../../whatsnew/3.12.rst:1740 -#: ../../whatsnew/3.12.rst:1741 +#: ../../whatsnew/3.12.rst:1598 ../../whatsnew/3.12.rst:1599 +#: ../../whatsnew/3.12.rst:1600 ../../whatsnew/3.12.rst:1601 +#: ../../whatsnew/3.12.rst:1602 ../../whatsnew/3.12.rst:1603 +#: ../../whatsnew/3.12.rst:1604 msgid "3.2" msgstr "3.2" -#: ../../whatsnew/3.12.rst:1736 +#: ../../whatsnew/3.12.rst:1599 msgid "``assertEquals``" msgstr "``assertEquals``" -#: ../../whatsnew/3.12.rst:1737 +#: ../../whatsnew/3.12.rst:1600 msgid "``assertNotEquals``" msgstr "``assertNotEquals``" -#: ../../whatsnew/3.12.rst:1738 +#: ../../whatsnew/3.12.rst:1601 msgid "``assertAlmostEquals``" msgstr "``assertAlmostEquals``" -#: ../../whatsnew/3.12.rst:1739 +#: ../../whatsnew/3.12.rst:1602 msgid "``assertNotAlmostEquals``" msgstr "``assertNotAlmostEquals``" -#: ../../whatsnew/3.12.rst:1740 +#: ../../whatsnew/3.12.rst:1603 msgid "``assertRegexpMatches``" msgstr "``assertRegexpMatches``" -#: ../../whatsnew/3.12.rst:1740 +#: ../../whatsnew/3.12.rst:1603 msgid ":meth:`.assertRegex`" msgstr ":meth:`.assertRegex`" -#: ../../whatsnew/3.12.rst:1741 +#: ../../whatsnew/3.12.rst:1604 msgid "``assertRaisesRegexp``" msgstr "``assertRaisesRegexp``" -#: ../../whatsnew/3.12.rst:1741 +#: ../../whatsnew/3.12.rst:1604 msgid ":meth:`.assertRaisesRegex`" msgstr ":meth:`.assertRaisesRegex`" -#: ../../whatsnew/3.12.rst:1742 +#: ../../whatsnew/3.12.rst:1605 msgid "``assertNotRegexpMatches``" msgstr "``assertNotRegexpMatches``" -#: ../../whatsnew/3.12.rst:1742 +#: ../../whatsnew/3.12.rst:1605 msgid ":meth:`.assertNotRegex`" msgstr ":meth:`.assertNotRegex`" -#: ../../whatsnew/3.12.rst:1742 +#: ../../whatsnew/3.12.rst:1605 msgid "3.5" msgstr "3.5" -#: ../../whatsnew/3.12.rst:1745 +#: ../../whatsnew/3.12.rst:1608 msgid "" "You can use https://github.com/isidentical/teyit to automatically modernise " "your unit tests." msgstr "" -#: ../../whatsnew/3.12.rst:1748 +#: ../../whatsnew/3.12.rst:1611 msgid "" "Undocumented and broken :class:`~unittest.TestCase` method " "``assertDictContainsSubset`` (deprecated in Python 3.2)." msgstr "" -#: ../../whatsnew/3.12.rst:1751 +#: ../../whatsnew/3.12.rst:1614 msgid "" "Undocumented :meth:`TestLoader.loadTestsFromModule ` parameter *use_load_tests* (deprecated and ignored " "since Python 3.5)." msgstr "" -#: ../../whatsnew/3.12.rst:1755 +#: ../../whatsnew/3.12.rst:1618 msgid "" "An alias of the :class:`~unittest.TextTestResult` class: ``_TextTestResult`` " "(deprecated in Python 3.2)." msgstr "" -#: ../../whatsnew/3.12.rst:1758 +#: ../../whatsnew/3.12.rst:1621 msgid "(Contributed by Serhiy Storchaka in :gh:`89325`.)" msgstr "（由 Serhiy Storchaka 於 :gh:`89325` 中貢獻。）" -#: ../../whatsnew/3.12.rst:1761 +#: ../../whatsnew/3.12.rst:1624 msgid "webbrowser" msgstr "webbrowser" -#: ../../whatsnew/3.12.rst:1763 +#: ../../whatsnew/3.12.rst:1626 msgid "" "Remove support for obsolete browsers from :mod:`webbrowser`. The removed " "browsers include: Grail, Mosaic, Netscape, Galeon, Skipstone, Iceape, " "Firebird, and Firefox versions 35 and below (:gh:`102871`)." msgstr "" -#: ../../whatsnew/3.12.rst:1768 +#: ../../whatsnew/3.12.rst:1631 msgid "xml.etree.ElementTree" msgstr "xml.etree.ElementTree" -#: ../../whatsnew/3.12.rst:1770 +#: ../../whatsnew/3.12.rst:1633 msgid "" "Remove the ``ElementTree.Element.copy()`` method of the pure Python " "implementation, deprecated in Python 3.10, use the :func:`copy.copy` " @@ -2819,22 +3265,22 @@ msgid "" "Stinner in :gh:`94383`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1777 +#: ../../whatsnew/3.12.rst:1640 msgid "zipimport" msgstr "zipimport" -#: ../../whatsnew/3.12.rst:1779 +#: ../../whatsnew/3.12.rst:1642 msgid "" "Remove :mod:`zipimport`'s ``find_loader()`` and ``find_module()`` methods, " "deprecated in Python 3.10: use the ``find_spec()`` method instead. See :pep:" "`451` for the rationale. (Contributed by Victor Stinner in :gh:`94379`.)" msgstr "" -#: ../../whatsnew/3.12.rst:1785 +#: ../../whatsnew/3.12.rst:1648 msgid "Others" msgstr "其他" -#: ../../whatsnew/3.12.rst:1787 +#: ../../whatsnew/3.12.rst:1650 msgid "" "Remove the ``suspicious`` rule from the documentation :file:`Makefile` and :" "file:`Doc/tools/rstlint.py`, both in favor of `sphinx-lint `, " "intended for low-level tools like debuggers and JIT compilers. This API may " @@ -3108,15 +3554,15 @@ msgid "" "contents are marked by the ``PyUnstable_`` prefix in names." msgstr "" -#: ../../whatsnew/3.12.rst:1983 +#: ../../whatsnew/3.12.rst:1846 msgid "Code object constructors:" msgstr "程式碼物件建構函式：" -#: ../../whatsnew/3.12.rst:1985 +#: ../../whatsnew/3.12.rst:1848 msgid "``PyUnstable_Code_New()`` (renamed from ``PyCode_New``)" msgstr "``PyUnstable_Code_New()``\\ （自 ``PyCode_New`` 重新命名）" -#: ../../whatsnew/3.12.rst:1986 +#: ../../whatsnew/3.12.rst:1849 msgid "" "``PyUnstable_Code_NewWithPosOnlyArgs()`` (renamed from " "``PyCode_NewWithPosOnlyArgs``)" @@ -3124,11 +3570,11 @@ msgstr "" "``PyUnstable_Code_NewWithPosOnlyArgs()``\\ （自 " "``PyCode_NewWithPosOnlyArgs`` 重新命名）" -#: ../../whatsnew/3.12.rst:1988 +#: ../../whatsnew/3.12.rst:1851 msgid "Extra storage for code objects (:pep:`523`):" msgstr "程式碼物件的額外儲存 (:pep:`523`)：" -#: ../../whatsnew/3.12.rst:1990 +#: ../../whatsnew/3.12.rst:1853 msgid "" "``PyUnstable_Eval_RequestCodeExtraIndex()`` (renamed from " "``_PyEval_RequestCodeExtraIndex``)" @@ -3136,31 +3582,31 @@ msgstr "" "``PyUnstable_Eval_RequestCodeExtraIndex()``\\ （自 " "``_PyEval_RequestCodeExtraIndex`` 重新命名）" -#: ../../whatsnew/3.12.rst:1991 +#: ../../whatsnew/3.12.rst:1854 msgid "``PyUnstable_Code_GetExtra()`` (renamed from ``_PyCode_GetExtra``)" msgstr "``PyUnstable_Code_GetExtra()``\\ （自 ``_PyCode_GetExtra`` 重新命名）" -#: ../../whatsnew/3.12.rst:1992 +#: ../../whatsnew/3.12.rst:1855 msgid "``PyUnstable_Code_SetExtra()`` (renamed from ``_PyCode_SetExtra``)" msgstr "``PyUnstable_Code_SetExtra()``\\ （自 ``_PyCode_SetExtra`` 重新命名）" -#: ../../whatsnew/3.12.rst:1994 +#: ../../whatsnew/3.12.rst:1857 msgid "" "The original names will continue to be available until the respective API " "changes." msgstr "原始名稱將可繼續使用，直到相應的 API 發生變更。" -#: ../../whatsnew/3.12.rst:1997 +#: ../../whatsnew/3.12.rst:1860 msgid "(Contributed by Petr Viktorin in :gh:`101101`.)" msgstr "（由 Petr Viktorin 於 :gh:`101101` 中貢獻。）" -#: ../../whatsnew/3.12.rst:1999 +#: ../../whatsnew/3.12.rst:1862 msgid "" ":pep:`697`: Add an API for extending types whose instance memory layout is " "opaque:" msgstr "" -#: ../../whatsnew/3.12.rst:2002 +#: ../../whatsnew/3.12.rst:1865 msgid "" ":c:member:`PyType_Spec.basicsize` can be zero or negative to specify " "inheriting or extending the base class size." @@ -3168,30 +3614,30 @@ msgstr "" ":c:member:`PyType_Spec.basicsize` 可以為零或負數來指定繼承或擴充基底類別大" "小。" -#: ../../whatsnew/3.12.rst:2004 +#: ../../whatsnew/3.12.rst:1867 msgid "" ":c:func:`PyObject_GetTypeData` and :c:func:`PyType_GetTypeDataSize` added to " "allow access to subclass-specific instance data." msgstr "" -#: ../../whatsnew/3.12.rst:2006 +#: ../../whatsnew/3.12.rst:1869 msgid "" ":c:macro:`Py_TPFLAGS_ITEMS_AT_END` and :c:func:`PyObject_GetItemData` added " "to allow safely extending certain variable-sized types, including :c:var:" "`PyType_Type`." msgstr "" -#: ../../whatsnew/3.12.rst:2009 +#: ../../whatsnew/3.12.rst:1872 msgid "" ":c:macro:`Py_RELATIVE_OFFSET` added to allow defining :c:type:`members " "` in terms of a subclass-specific struct." msgstr "" -#: ../../whatsnew/3.12.rst:2012 +#: ../../whatsnew/3.12.rst:1875 msgid "(Contributed by Petr Viktorin in :gh:`103509`.)" msgstr "（由 Petr Viktorin 於 :gh:`103509` 中貢獻。）" -#: ../../whatsnew/3.12.rst:2014 +#: ../../whatsnew/3.12.rst:1877 msgid "" "Add the new :ref:`limited C API ` function :c:func:" "`PyType_FromMetaclass`, which generalizes the existing :c:func:" @@ -3199,29 +3645,29 @@ msgid "" "(Contributed by Wenzel Jakob in :gh:`93012`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2019 +#: ../../whatsnew/3.12.rst:1882 msgid "" "API for creating objects that can be called using :ref:`the vectorcall " "protocol ` was added to the :ref:`Limited API `:" msgstr "" -#: ../../whatsnew/3.12.rst:2023 +#: ../../whatsnew/3.12.rst:1886 msgid ":c:macro:`Py_TPFLAGS_HAVE_VECTORCALL`" msgstr ":c:macro:`Py_TPFLAGS_HAVE_VECTORCALL`" -#: ../../whatsnew/3.12.rst:2024 +#: ../../whatsnew/3.12.rst:1887 msgid ":c:func:`PyVectorcall_NARGS`" msgstr ":c:func:`PyVectorcall_NARGS`" -#: ../../whatsnew/3.12.rst:2025 +#: ../../whatsnew/3.12.rst:1888 msgid ":c:func:`PyVectorcall_Call`" msgstr ":c:func:`PyVectorcall_Call`" -#: ../../whatsnew/3.12.rst:2026 +#: ../../whatsnew/3.12.rst:1889 msgid ":c:type:`vectorcallfunc`" msgstr ":c:type:`vectorcallfunc`" -#: ../../whatsnew/3.12.rst:2028 +#: ../../whatsnew/3.12.rst:1891 msgid "" "The :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` flag is now removed from a class " "when the class's :py:meth:`~object.__call__` method is reassigned. This " @@ -3232,7 +3678,7 @@ msgid "" "`93274`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2036 +#: ../../whatsnew/3.12.rst:1899 msgid "" "The :c:macro:`Py_TPFLAGS_MANAGED_DICT` and :c:macro:" "`Py_TPFLAGS_MANAGED_WEAKREF` flags have been added. This allows extensions " @@ -3240,32 +3686,32 @@ msgid "" "using less memory and with faster access." msgstr "" -#: ../../whatsnew/3.12.rst:2041 +#: ../../whatsnew/3.12.rst:1904 msgid "" "API for performing calls using :ref:`the vectorcall protocol ` " "was added to the :ref:`Limited API `:" msgstr "" -#: ../../whatsnew/3.12.rst:2045 +#: ../../whatsnew/3.12.rst:1908 msgid ":c:func:`PyObject_Vectorcall`" msgstr ":c:func:`PyObject_Vectorcall`" -#: ../../whatsnew/3.12.rst:2046 +#: ../../whatsnew/3.12.rst:1909 msgid ":c:func:`PyObject_VectorcallMethod`" msgstr ":c:func:`PyObject_VectorcallMethod`" -#: ../../whatsnew/3.12.rst:2047 +#: ../../whatsnew/3.12.rst:1910 msgid ":c:macro:`PY_VECTORCALL_ARGUMENTS_OFFSET`" msgstr ":c:macro:`PY_VECTORCALL_ARGUMENTS_OFFSET`" -#: ../../whatsnew/3.12.rst:2049 +#: ../../whatsnew/3.12.rst:1912 msgid "" "This means that both the incoming and outgoing ends of the vector call " "protocol are now available in the :ref:`Limited API `. (Contributed " "by Wenzel Jakob in :gh:`98586`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2053 +#: ../../whatsnew/3.12.rst:1916 msgid "" "Add two new public functions, :c:func:`PyEval_SetProfileAllThreads` and :c:" "func:`PyEval_SetTraceAllThreads`, that allow to set tracing and profiling " @@ -3273,14 +3719,14 @@ msgid "" "(Contributed by Pablo Galindo in :gh:`93503`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2059 +#: ../../whatsnew/3.12.rst:1922 msgid "" "Add new function :c:func:`PyFunction_SetVectorcall` to the C API which sets " "the vectorcall field of a given :c:type:`PyFunctionObject`. (Contributed by " "Andrew Frost in :gh:`92257`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2063 +#: ../../whatsnew/3.12.rst:1926 msgid "" "The C API now permits registering callbacks via :c:func:" "`PyDict_AddWatcher`, :c:func:`PyDict_Watch` and related APIs to be called " @@ -3289,28 +3735,28 @@ msgid "" "`91052`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2069 +#: ../../whatsnew/3.12.rst:1932 msgid "" "Add :c:func:`PyType_AddWatcher` and :c:func:`PyType_Watch` API to register " "callbacks to receive notification on changes to a type. (Contributed by Carl " "Meyer in :gh:`91051`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2073 +#: ../../whatsnew/3.12.rst:1936 msgid "" "Add :c:func:`PyCode_AddWatcher` and :c:func:`PyCode_ClearWatcher` APIs to " "register callbacks to receive notification on creation and destruction of " "code objects. (Contributed by Itamar Oren in :gh:`91054`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2078 +#: ../../whatsnew/3.12.rst:1941 msgid "" "Add :c:func:`PyFrame_GetVar` and :c:func:`PyFrame_GetVarString` functions to " "get a frame variable by its name. (Contributed by Victor Stinner in :gh:" "`91248`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2082 +#: ../../whatsnew/3.12.rst:1945 msgid "" "Add :c:func:`PyErr_GetRaisedException` and :c:func:" "`PyErr_SetRaisedException` for saving and restoring the current exception. " @@ -3320,14 +3766,14 @@ msgid "" "(Contributed by Mark Shannon in :gh:`101578`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2090 +#: ../../whatsnew/3.12.rst:1953 msgid "" "Add ``_PyErr_ChainExceptions1``, which takes an exception instance, to " "replace the legacy-API ``_PyErr_ChainExceptions``, which is now deprecated. " "(Contributed by Mark Shannon in :gh:`101578`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2094 +#: ../../whatsnew/3.12.rst:1957 msgid "" "Add :c:func:`PyException_GetArgs` and :c:func:`PyException_SetArgs` as " "convenience functions for retrieving and modifying the :attr:`~BaseException." @@ -3335,71 +3781,71 @@ msgid "" "in :gh:`101578`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2099 +#: ../../whatsnew/3.12.rst:1962 msgid "" "Add :c:func:`PyErr_DisplayException`, which takes an exception instance, to " "replace the legacy-api :c:func:`!PyErr_Display`. (Contributed by Irit " "Katriel in :gh:`102755`)." msgstr "" -#: ../../whatsnew/3.12.rst:2105 +#: ../../whatsnew/3.12.rst:1968 msgid "" ":pep:`683`: Introduce *Immortal Objects*, which allows objects to bypass " "reference counts, and related changes to the C-API:" msgstr "" -#: ../../whatsnew/3.12.rst:2108 +#: ../../whatsnew/3.12.rst:1971 msgid "``_Py_IMMORTAL_REFCNT``: The reference count that defines an object" msgstr "``_Py_IMMORTAL_REFCNT``：定義物件的參照計數" -#: ../../whatsnew/3.12.rst:2109 +#: ../../whatsnew/3.12.rst:1972 msgid "as immortal." msgstr "" -#: ../../whatsnew/3.12.rst:2110 +#: ../../whatsnew/3.12.rst:1973 msgid "" "``_Py_IsImmortal`` Checks if an object has the immortal reference count." msgstr "" -#: ../../whatsnew/3.12.rst:2111 +#: ../../whatsnew/3.12.rst:1974 msgid "``PyObject_HEAD_INIT`` This will now initialize reference count to" msgstr "``PyObject_HEAD_INIT`` 這現在將初始化參照計數" -#: ../../whatsnew/3.12.rst:2112 +#: ../../whatsnew/3.12.rst:1975 msgid "``_Py_IMMORTAL_REFCNT`` when used with ``Py_BUILD_CORE``." msgstr "``_Py_IMMORTAL_REFCNT``\\ （與 ``Py_BUILD_CORE`` 一起使用時）。" -#: ../../whatsnew/3.12.rst:2113 +#: ../../whatsnew/3.12.rst:1976 msgid "``SSTATE_INTERNED_IMMORTAL`` An identifier for interned unicode objects" msgstr "" -#: ../../whatsnew/3.12.rst:2114 +#: ../../whatsnew/3.12.rst:1977 msgid "that are immortal." msgstr "" -#: ../../whatsnew/3.12.rst:2115 +#: ../../whatsnew/3.12.rst:1978 msgid "``SSTATE_INTERNED_IMMORTAL_STATIC`` An identifier for interned unicode" msgstr "" -#: ../../whatsnew/3.12.rst:2116 +#: ../../whatsnew/3.12.rst:1979 msgid "objects that are immortal and static" msgstr "" -#: ../../whatsnew/3.12.rst:2117 +#: ../../whatsnew/3.12.rst:1980 msgid "``sys.getunicodeinternedsize`` This returns the total number of unicode" msgstr "" -#: ../../whatsnew/3.12.rst:2118 +#: ../../whatsnew/3.12.rst:1981 msgid "" "objects that have been interned. This is now needed for :file:`refleak.py` " "to correctly track reference counts and allocated blocks" msgstr "" -#: ../../whatsnew/3.12.rst:2121 +#: ../../whatsnew/3.12.rst:1984 msgid "(Contributed by Eddie Elizondo in :gh:`84436`.)" msgstr "（由 Eddie Elizondo 於 :gh:`84436` 中貢獻。）" -#: ../../whatsnew/3.12.rst:2123 +#: ../../whatsnew/3.12.rst:1986 msgid "" ":pep:`684`: Add the new :c:func:`Py_NewInterpreterFromConfig` function and :" "c:type:`PyInterpreterConfig`, which may be used to create sub-interpreters " @@ -3407,27 +3853,27 @@ msgid "" "(Contributed by Eric Snow in :gh:`104110`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2129 +#: ../../whatsnew/3.12.rst:1992 msgid "" "In the limited C API version 3.12, :c:func:`Py_INCREF` and :c:func:" "`Py_DECREF` functions are now implemented as opaque function calls to hide " "implementation details. (Contributed by Victor Stinner in :gh:`105387`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2137 +#: ../../whatsnew/3.12.rst:2000 msgid "" "Legacy Unicode APIs based on ``Py_UNICODE*`` representation has been " "removed. Please migrate to APIs based on UTF-8 or ``wchar_t*``." msgstr "" -#: ../../whatsnew/3.12.rst:2140 +#: ../../whatsnew/3.12.rst:2003 msgid "" "Argument parsing functions like :c:func:`PyArg_ParseTuple` doesn't support " "``Py_UNICODE*`` based format (e.g. ``u``, ``Z``) anymore. Please migrate to " "other formats for Unicode like ``s``, ``z``, ``es``, and ``U``." msgstr "" -#: ../../whatsnew/3.12.rst:2144 +#: ../../whatsnew/3.12.rst:2007 msgid "" "``tp_weaklist`` for all static builtin types is always ``NULL``. This is an " "internal-only field on ``PyTypeObject`` but we're pointing out the change in " @@ -3436,7 +3882,7 @@ msgid "" "necessary, the (internal-only) ``_PyObject_GET_WEAKREFS_LISTPTR()`` macro." msgstr "" -#: ../../whatsnew/3.12.rst:2151 +#: ../../whatsnew/3.12.rst:2014 msgid "" "This internal-only :c:member:`PyTypeObject.tp_subclasses` may now not be a " "valid object pointer. Its type was changed to :c:expr:`void *` to reflect " @@ -3444,13 +3890,13 @@ msgid "" "only field directly." msgstr "" -#: ../../whatsnew/3.12.rst:2156 +#: ../../whatsnew/3.12.rst:2019 msgid "" "To get a list of subclasses, call the Python method :py:meth:`~class." "__subclasses__` (using :c:func:`PyObject_CallMethod`, for example)." msgstr "" -#: ../../whatsnew/3.12.rst:2160 +#: ../../whatsnew/3.12.rst:2023 msgid "" "Add support of more formatting options (left aligning, octals, uppercase " "hexadecimals, :c:type:`intmax_t`, :c:type:`ptrdiff_t`, :c:type:`wchar_t` C " @@ -3459,7 +3905,7 @@ msgid "" "`98836`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2166 +#: ../../whatsnew/3.12.rst:2029 msgid "" "An unrecognized format character in :c:func:`PyUnicode_FromFormat` and :c:" "func:`PyUnicode_FromFormatV` now sets a :exc:`SystemError`. In previous " @@ -3468,13 +3914,13 @@ msgid "" "Storchaka in :gh:`95781`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2172 +#: ../../whatsnew/3.12.rst:2035 msgid "" "Fix wrong sign placement in :c:func:`PyUnicode_FromFormat` and :c:func:" "`PyUnicode_FromFormatV`. (Contributed by Philip Georgi in :gh:`95504`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2176 +#: ../../whatsnew/3.12.rst:2039 msgid "" "Extension classes wanting to add a ``__dict__`` or weak reference slot " "should use :c:macro:`Py_TPFLAGS_MANAGED_DICT` and :c:macro:" @@ -3488,7 +3934,7 @@ msgid "" "func:`PyObject_ClearWeakRefs`, as before." msgstr "" -#: ../../whatsnew/3.12.rst:2188 +#: ../../whatsnew/3.12.rst:2051 msgid "" "The :c:func:`PyUnicode_FSDecoder` function no longer accepts bytes-like " "paths, like :class:`bytearray` and :class:`memoryview` types: only the " @@ -3496,7 +3942,7 @@ msgid "" "Victor Stinner in :gh:`98393`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2193 +#: ../../whatsnew/3.12.rst:2056 msgid "" "The :c:macro:`Py_CLEAR`, :c:macro:`Py_SETREF` and :c:macro:`Py_XSETREF` " "macros now only evaluate their arguments once. If an argument has side " @@ -3504,7 +3950,7 @@ msgid "" "Stinner in :gh:`98724`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2198 +#: ../../whatsnew/3.12.rst:2061 msgid "" "The interpreter's error indicator is now always normalized. This means that :" "c:func:`PyErr_SetObject`, :c:func:`PyErr_SetString` and the other functions " @@ -3512,7 +3958,7 @@ msgid "" "(Contributed by Mark Shannon in :gh:`101578`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2203 +#: ../../whatsnew/3.12.rst:2066 msgid "" "``_Py_RefTotal`` is no longer authoritative and only kept around for ABI " "compatibility. Note that it is an internal global and only available on " @@ -3520,25 +3966,25 @@ msgid "" "``_Py_GetGlobalRefTotal()``." msgstr "" -#: ../../whatsnew/3.12.rst:2208 +#: ../../whatsnew/3.12.rst:2071 msgid "" "The following functions now select an appropriate metaclass for the newly " "created type:" msgstr "" -#: ../../whatsnew/3.12.rst:2211 +#: ../../whatsnew/3.12.rst:2074 msgid ":c:func:`PyType_FromSpec`" msgstr ":c:func:`PyType_FromSpec`" -#: ../../whatsnew/3.12.rst:2212 +#: ../../whatsnew/3.12.rst:2075 msgid ":c:func:`PyType_FromSpecWithBases`" msgstr ":c:func:`PyType_FromSpecWithBases`" -#: ../../whatsnew/3.12.rst:2213 +#: ../../whatsnew/3.12.rst:2076 msgid ":c:func:`PyType_FromModuleAndSpec`" msgstr ":c:func:`PyType_FromModuleAndSpec`" -#: ../../whatsnew/3.12.rst:2215 +#: ../../whatsnew/3.12.rst:2078 msgid "" "Creating classes whose metaclass overrides :c:member:`~PyTypeObject.tp_new` " "is deprecated, and in Python 3.14+ it will be disallowed. Note that these " @@ -3546,14 +3992,14 @@ msgid "" "initialization." msgstr "" -#: ../../whatsnew/3.12.rst:2220 +#: ../../whatsnew/3.12.rst:2083 msgid "" "Note that :c:func:`PyType_FromMetaclass` (added in Python 3.12) already " "disallows creating classes whose metaclass overrides ``tp_new`` (:meth:" "`~object.__new__` in Python)." msgstr "" -#: ../../whatsnew/3.12.rst:2224 +#: ../../whatsnew/3.12.rst:2087 msgid "" "Since ``tp_new`` overrides almost everything ``PyType_From*`` functions do, " "the two are incompatible with each other. The existing behavior -- ignoring " @@ -3562,17 +4008,17 @@ msgid "" "general workaround. One of the following may work for you:" msgstr "" -#: ../../whatsnew/3.12.rst:2231 +#: ../../whatsnew/3.12.rst:2094 msgid "If you control the metaclass, avoid using ``tp_new`` in it:" msgstr "" -#: ../../whatsnew/3.12.rst:2233 +#: ../../whatsnew/3.12.rst:2096 msgid "" "If initialization can be skipped, it can be done in :c:member:`~PyTypeObject." "tp_init` instead." msgstr "" -#: ../../whatsnew/3.12.rst:2235 +#: ../../whatsnew/3.12.rst:2098 msgid "" "If the metaclass doesn't need to be instantiated from Python, set its " "``tp_new`` to ``NULL`` using the :c:macro:" @@ -3580,20 +4026,20 @@ msgid "" "``PyType_From*`` functions." msgstr "" -#: ../../whatsnew/3.12.rst:2240 +#: ../../whatsnew/3.12.rst:2103 msgid "" "Avoid ``PyType_From*`` functions: if you don't need C-specific features " "(slots or setting the instance size), create types by :ref:`calling ` " "the metaclass." msgstr "" -#: ../../whatsnew/3.12.rst:2244 +#: ../../whatsnew/3.12.rst:2107 msgid "" "If you *know* the ``tp_new`` can be skipped safely, filter the deprecation " "warning out using :func:`warnings.catch_warnings` from Python." msgstr "" -#: ../../whatsnew/3.12.rst:2247 +#: ../../whatsnew/3.12.rst:2110 msgid "" ":c:var:`PyOS_InputHook` and :c:var:`PyOS_ReadlineFunctionPointer` are no " "longer called in :ref:`subinterpreters `. This is " @@ -3601,14 +4047,14 @@ msgid "" "callbacks have no way of recovering extension module state)." msgstr "" -#: ../../whatsnew/3.12.rst:2252 +#: ../../whatsnew/3.12.rst:2115 msgid "" "This also avoids situations where extensions may find themselves running in " "a subinterpreter that they don't support (or haven't yet been loaded in). " "See :gh:`104668` for more info." msgstr "" -#: ../../whatsnew/3.12.rst:2256 +#: ../../whatsnew/3.12.rst:2119 msgid "" ":c:struct:`PyLongObject` has had its internals changed for better " "performance. Although the internals of :c:struct:`PyLongObject` are private, " @@ -3619,15 +4065,15 @@ msgid "" "a single machine word:" msgstr "" -#: ../../whatsnew/3.12.rst:2264 +#: ../../whatsnew/3.12.rst:2127 msgid ":c:func:`PyUnstable_Long_IsCompact`" msgstr ":c:func:`PyUnstable_Long_IsCompact`" -#: ../../whatsnew/3.12.rst:2265 +#: ../../whatsnew/3.12.rst:2128 msgid ":c:func:`PyUnstable_Long_CompactValue`" msgstr ":c:func:`PyUnstable_Long_CompactValue`" -#: ../../whatsnew/3.12.rst:2267 +#: ../../whatsnew/3.12.rst:2130 msgid "" "Custom allocators, set via :c:func:`PyMem_SetAllocator`, are now required to " "be thread-safe, regardless of memory domain. Allocators that don't have " @@ -3636,7 +4082,7 @@ msgid "" "create a new GitHub issue and CC ``@ericsnowcurrently``." msgstr "" -#: ../../whatsnew/3.12.rst:2277 +#: ../../whatsnew/3.12.rst:2140 msgid "" "In accordance with :pep:`699`, the ``ma_version_tag`` field in :c:type:" "`PyDictObject` is deprecated for extension modules. Accessing this field " @@ -3645,76 +4091,76 @@ msgid "" "PEP by Ken Jin.)" msgstr "" -#: ../../whatsnew/3.12.rst:2282 +#: ../../whatsnew/3.12.rst:2145 msgid "Deprecate global configuration variable:" msgstr "棄用全域配置變數：" -#: ../../whatsnew/3.12.rst:2284 ../../whatsnew/3.12.rst:2369 +#: ../../whatsnew/3.12.rst:2147 ../../whatsnew/3.12.rst:2232 msgid ":c:var:`Py_DebugFlag`: use :c:member:`PyConfig.parser_debug`" msgstr ":c:var:`Py_DebugFlag`: 請改用 :c:member:`PyConfig.parser_debug`" -#: ../../whatsnew/3.12.rst:2285 ../../whatsnew/3.12.rst:2370 +#: ../../whatsnew/3.12.rst:2148 ../../whatsnew/3.12.rst:2233 msgid ":c:var:`Py_VerboseFlag`: use :c:member:`PyConfig.verbose`" msgstr ":c:var:`Py_VerboseFlag`: 請改用 :c:member:`PyConfig.verbose`" -#: ../../whatsnew/3.12.rst:2286 ../../whatsnew/3.12.rst:2371 +#: ../../whatsnew/3.12.rst:2149 ../../whatsnew/3.12.rst:2234 msgid ":c:var:`Py_QuietFlag`: use :c:member:`PyConfig.quiet`" msgstr ":c:var:`Py_QuietFlag`: 請改用 :c:member:`PyConfig.quiet`" -#: ../../whatsnew/3.12.rst:2287 ../../whatsnew/3.12.rst:2372 +#: ../../whatsnew/3.12.rst:2150 ../../whatsnew/3.12.rst:2235 msgid ":c:var:`Py_InteractiveFlag`: use :c:member:`PyConfig.interactive`" msgstr ":c:var:`Py_InteractiveFlag`: 請改用 :c:member:`PyConfig.interactive`" -#: ../../whatsnew/3.12.rst:2288 ../../whatsnew/3.12.rst:2373 +#: ../../whatsnew/3.12.rst:2151 ../../whatsnew/3.12.rst:2236 msgid ":c:var:`Py_InspectFlag`: use :c:member:`PyConfig.inspect`" msgstr ":c:var:`Py_InspectFlag`: 請改用 :c:member:`PyConfig.inspect`" -#: ../../whatsnew/3.12.rst:2289 ../../whatsnew/3.12.rst:2374 +#: ../../whatsnew/3.12.rst:2152 ../../whatsnew/3.12.rst:2237 msgid ":c:var:`Py_OptimizeFlag`: use :c:member:`PyConfig.optimization_level`" msgstr "" ":c:var:`Py_OptimizeFlag`: 請改用 :c:member:`PyConfig.optimization_level`" -#: ../../whatsnew/3.12.rst:2290 ../../whatsnew/3.12.rst:2375 +#: ../../whatsnew/3.12.rst:2153 ../../whatsnew/3.12.rst:2238 msgid ":c:var:`Py_NoSiteFlag`: use :c:member:`PyConfig.site_import`" msgstr ":c:var:`Py_NoSiteFlag`: 請改用 :c:member:`PyConfig.site_import`" -#: ../../whatsnew/3.12.rst:2291 ../../whatsnew/3.12.rst:2376 +#: ../../whatsnew/3.12.rst:2154 ../../whatsnew/3.12.rst:2239 msgid ":c:var:`Py_BytesWarningFlag`: use :c:member:`PyConfig.bytes_warning`" msgstr "" ":c:var:`Py_BytesWarningFlag`: 請改用 :c:member:`PyConfig.bytes_warning`" -#: ../../whatsnew/3.12.rst:2292 ../../whatsnew/3.12.rst:2377 +#: ../../whatsnew/3.12.rst:2155 ../../whatsnew/3.12.rst:2240 msgid ":c:var:`Py_FrozenFlag`: use :c:member:`PyConfig.pathconfig_warnings`" msgstr "" ":c:var:`Py_FrozenFlag`: 請改用 :c:member:`PyConfig.pathconfig_warnings`" -#: ../../whatsnew/3.12.rst:2293 ../../whatsnew/3.12.rst:2378 +#: ../../whatsnew/3.12.rst:2156 ../../whatsnew/3.12.rst:2241 msgid "" ":c:var:`Py_IgnoreEnvironmentFlag`: use :c:member:`PyConfig.use_environment`" msgstr "" ":c:var:`Py_IgnoreEnvironmentFlag`: 請改用 :c:member:`PyConfig." "use_environment`" -#: ../../whatsnew/3.12.rst:2294 ../../whatsnew/3.12.rst:2379 +#: ../../whatsnew/3.12.rst:2157 ../../whatsnew/3.12.rst:2242 msgid "" ":c:var:`Py_DontWriteBytecodeFlag`: use :c:member:`PyConfig.write_bytecode`" msgstr "" ":c:var:`Py_DontWriteBytecodeFlag`: 請改用 :c:member:`PyConfig.write_bytecode`" -#: ../../whatsnew/3.12.rst:2295 ../../whatsnew/3.12.rst:2380 +#: ../../whatsnew/3.12.rst:2158 ../../whatsnew/3.12.rst:2243 msgid "" ":c:var:`Py_NoUserSiteDirectory`: use :c:member:`PyConfig.user_site_directory`" msgstr "" ":c:var:`Py_NoUserSiteDirectory`: 請改用 :c:member:`PyConfig." "user_site_directory`" -#: ../../whatsnew/3.12.rst:2296 ../../whatsnew/3.12.rst:2381 +#: ../../whatsnew/3.12.rst:2159 ../../whatsnew/3.12.rst:2244 msgid "" ":c:var:`Py_UnbufferedStdioFlag`: use :c:member:`PyConfig.buffered_stdio`" msgstr "" ":c:var:`Py_UnbufferedStdioFlag`: 請改用 :c:member:`PyConfig.buffered_stdio`" -#: ../../whatsnew/3.12.rst:2297 ../../whatsnew/3.12.rst:2382 +#: ../../whatsnew/3.12.rst:2160 ../../whatsnew/3.12.rst:2245 msgid "" ":c:var:`Py_HashRandomizationFlag`: use :c:member:`PyConfig.use_hash_seed` " "and :c:member:`PyConfig.hash_seed`" @@ -3722,11 +4168,11 @@ msgstr "" ":c:var:`Py_HashRandomizationFlag`: 請改用 :c:member:`PyConfig.use_hash_seed` " "和 :c:member:`PyConfig.hash_seed`" -#: ../../whatsnew/3.12.rst:2299 ../../whatsnew/3.12.rst:2384 +#: ../../whatsnew/3.12.rst:2162 ../../whatsnew/3.12.rst:2247 msgid ":c:var:`Py_IsolatedFlag`: use :c:member:`PyConfig.isolated`" msgstr ":c:var:`Py_IsolatedFlag`: 請改用 :c:member:`PyConfig.isolated`" -#: ../../whatsnew/3.12.rst:2300 ../../whatsnew/3.12.rst:2385 +#: ../../whatsnew/3.12.rst:2163 ../../whatsnew/3.12.rst:2248 msgid "" ":c:var:`Py_LegacyWindowsFSEncodingFlag`: use :c:member:`PyPreConfig." "legacy_windows_fs_encoding`" @@ -3734,7 +4180,7 @@ msgstr "" ":c:var:`Py_LegacyWindowsFSEncodingFlag`: 請改用 :c:member:`PyPreConfig." "legacy_windows_fs_encoding`" -#: ../../whatsnew/3.12.rst:2301 ../../whatsnew/3.12.rst:2386 +#: ../../whatsnew/3.12.rst:2164 ../../whatsnew/3.12.rst:2249 msgid "" ":c:var:`Py_LegacyWindowsStdioFlag`: use :c:member:`PyConfig." "legacy_windows_stdio`" @@ -3742,7 +4188,7 @@ msgstr "" ":c:var:`Py_LegacyWindowsStdioFlag`: 請改用 :c:member:`PyConfig." "legacy_windows_stdio`" -#: ../../whatsnew/3.12.rst:2302 ../../whatsnew/3.12.rst:2387 +#: ../../whatsnew/3.12.rst:2165 ../../whatsnew/3.12.rst:2250 msgid "" ":c:var:`!Py_FileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding`" @@ -3750,7 +4196,7 @@ msgstr "" ":c:var:`!Py_FileSystemDefaultEncoding`: 請改用 :c:member:`PyConfig." "filesystem_encoding`" -#: ../../whatsnew/3.12.rst:2303 ../../whatsnew/3.12.rst:2388 +#: ../../whatsnew/3.12.rst:2166 ../../whatsnew/3.12.rst:2251 msgid "" ":c:var:`!Py_HasFileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding`" @@ -3758,7 +4204,7 @@ msgstr "" ":c:var:`!Py_HasFileSystemDefaultEncoding`: 請改用 :c:member:`PyConfig." "filesystem_encoding`" -#: ../../whatsnew/3.12.rst:2304 ../../whatsnew/3.12.rst:2389 +#: ../../whatsnew/3.12.rst:2167 ../../whatsnew/3.12.rst:2252 msgid "" ":c:var:`!Py_FileSystemDefaultEncodeErrors`: use :c:member:`PyConfig." "filesystem_errors`" @@ -3766,7 +4212,7 @@ msgstr "" ":c:var:`!Py_FileSystemDefaultEncodeErrors`: 請改用 :c:member:`PyConfig." "filesystem_errors`" -#: ../../whatsnew/3.12.rst:2305 ../../whatsnew/3.12.rst:2390 +#: ../../whatsnew/3.12.rst:2168 ../../whatsnew/3.12.rst:2253 msgid "" ":c:var:`!Py_UTF8Mode`: use :c:member:`PyPreConfig.utf8_mode` (see :c:func:" "`Py_PreInitialize`)" @@ -3774,7 +4220,7 @@ msgstr "" ":c:var:`!Py_UTF8Mode`: 請改用 :c:member:`PyPreConfig.utf8_mode`\\ （參見 :c:" "func:`Py_PreInitialize`）" -#: ../../whatsnew/3.12.rst:2307 +#: ../../whatsnew/3.12.rst:2170 msgid "" "The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" "`PyConfig` instead. (Contributed by Victor Stinner in :gh:`77782`.)" @@ -3782,25 +4228,25 @@ msgstr "" ":c:func:`Py_InitializeFromConfig` API 應改為與 :c:type:`PyConfig` 一起使用。" "（由 Victor Stinner 於 :gh:`77782` 中貢獻。）" -#: ../../whatsnew/3.12.rst:2311 +#: ../../whatsnew/3.12.rst:2174 msgid "" "Creating :c:data:`immutable types ` with mutable " "bases is deprecated and will be disabled in Python 3.14. (:gh:`95388`)" msgstr "" -#: ../../whatsnew/3.12.rst:2314 +#: ../../whatsnew/3.12.rst:2177 msgid "" "The :file:`structmember.h` header is deprecated, though it continues to be " "available and there are no plans to remove it." msgstr ":file:`structmember.h` 標頭已棄用，但仍可使用，且還沒有移除它的計畫。" -#: ../../whatsnew/3.12.rst:2317 +#: ../../whatsnew/3.12.rst:2180 msgid "" "Its contents are now available just by including :file:`Python.h`, with a " "``Py`` prefix added if it was missing:" msgstr "" -#: ../../whatsnew/3.12.rst:2320 +#: ../../whatsnew/3.12.rst:2183 msgid "" ":c:struct:`PyMemberDef`, :c:func:`PyMember_GetOne` and :c:func:" "`PyMember_SetOne`" @@ -3808,13 +4254,13 @@ msgstr "" ":c:struct:`PyMemberDef`、:c:func:`PyMember_GetOne` 和 :c:func:" "`PyMember_SetOne`" -#: ../../whatsnew/3.12.rst:2322 +#: ../../whatsnew/3.12.rst:2185 msgid "" "Type macros like :c:macro:`Py_T_INT`, :c:macro:`Py_T_DOUBLE`, etc. " "(previously ``T_INT``, ``T_DOUBLE``, etc.)" msgstr "" -#: ../../whatsnew/3.12.rst:2324 +#: ../../whatsnew/3.12.rst:2187 msgid "" "The flags :c:macro:`Py_READONLY` (previously ``READONLY``) and :c:macro:" "`Py_AUDIT_READ` (previously all uppercase)" @@ -3822,23 +4268,23 @@ msgstr "" ":c:macro:`Py_READONLY`\\ （先前為 ``READONLY``）和 :c:macro:" "`Py_AUDIT_READ`\\ （先前全大寫）旗標" -#: ../../whatsnew/3.12.rst:2327 +#: ../../whatsnew/3.12.rst:2190 msgid "Several items are not exposed from :file:`Python.h`:" msgstr "數個項目不再從 :file:`Python.h` 中公開：" -#: ../../whatsnew/3.12.rst:2329 +#: ../../whatsnew/3.12.rst:2192 msgid ":c:macro:`T_OBJECT` (use :c:macro:`Py_T_OBJECT_EX`)" msgstr ":c:macro:`T_OBJECT`\\ （請改用 :c:macro:`Py_T_OBJECT_EX`）" -#: ../../whatsnew/3.12.rst:2330 +#: ../../whatsnew/3.12.rst:2193 msgid ":c:macro:`T_NONE` (previously undocumented, and pretty quirky)" msgstr ":c:macro:`T_NONE`\\ （先前未記錄於文件上，且相當古怪）" -#: ../../whatsnew/3.12.rst:2331 +#: ../../whatsnew/3.12.rst:2194 msgid "The macro ``WRITE_RESTRICTED`` which does nothing." msgstr "不做任何事的巨集 ``WRITE_RESTRICTED``。" -#: ../../whatsnew/3.12.rst:2332 +#: ../../whatsnew/3.12.rst:2195 msgid "" "The macros ``RESTRICTED`` and ``READ_RESTRICTED``, equivalents of :c:macro:" "`Py_AUDIT_READ`." @@ -3846,33 +4292,33 @@ msgstr "" "``RESTRICTED`` 和 ``READ_RESTRICTED`` 這兩個巨集，相當於 :c:macro:" "`Py_AUDIT_READ`。" -#: ../../whatsnew/3.12.rst:2334 +#: ../../whatsnew/3.12.rst:2197 msgid "" "In some configurations, ```` is not included from :file:`Python." "h`. It should be included manually when using ``offsetof()``." msgstr "" -#: ../../whatsnew/3.12.rst:2337 +#: ../../whatsnew/3.12.rst:2200 msgid "" "The deprecated header continues to provide its original contents under the " "original names. Your old code can stay unchanged, unless the extra include " "and non-namespaced macros bother you greatly." msgstr "" -#: ../../whatsnew/3.12.rst:2342 +#: ../../whatsnew/3.12.rst:2205 msgid "" "(Contributed in :gh:`47146` by Petr Viktorin, based on earlier work by " "Alexander Belopolsky and Matthias Braun.)" msgstr "" -#: ../../whatsnew/3.12.rst:2345 +#: ../../whatsnew/3.12.rst:2208 msgid "" ":c:func:`PyErr_Fetch` and :c:func:`PyErr_Restore` are deprecated. Use :c:" "func:`PyErr_GetRaisedException` and :c:func:`PyErr_SetRaisedException` " "instead. (Contributed by Mark Shannon in :gh:`101578`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2350 +#: ../../whatsnew/3.12.rst:2213 msgid "" ":c:func:`!PyErr_Display` is deprecated. Use :c:func:`PyErr_DisplayException` " "instead. (Contributed by Irit Katriel in :gh:`102755`)." @@ -3880,7 +4326,7 @@ msgstr "" ":c:func:`!PyErr_Display` 已棄用，請改用 :c:func:`PyErr_DisplayException`。" "（由 Irit Katriel 於 :gh:`102755` 中貢獻。）" -#: ../../whatsnew/3.12.rst:2353 +#: ../../whatsnew/3.12.rst:2216 msgid "" "``_PyErr_ChainExceptions`` is deprecated. Use ``_PyErr_ChainExceptions1`` " "instead. (Contributed by Irit Katriel in :gh:`102192`.)" @@ -3888,31 +4334,31 @@ msgstr "" "``_PyErr_ChainExceptions`` 已棄用，請改用 ``_PyErr_ChainExceptions1``。（由 " "Irit Katriel 於 :gh:`102192` 中貢獻。）" -#: ../../whatsnew/3.12.rst:2356 +#: ../../whatsnew/3.12.rst:2219 msgid "" "Using :c:func:`PyType_FromSpec`, :c:func:`PyType_FromSpecWithBases` or :c:" "func:`PyType_FromModuleAndSpec` to create a class whose metaclass overrides :" "c:member:`~PyTypeObject.tp_new` is deprecated. Call the metaclass instead." msgstr "" -#: ../../whatsnew/3.12.rst:2364 +#: ../../whatsnew/3.12.rst:2227 msgid "" "The ``ma_version_tag`` field in :c:type:`PyDictObject` for extension modules " "(:pep:`699`; :gh:`101193`)." msgstr "" -#: ../../whatsnew/3.12.rst:2367 +#: ../../whatsnew/3.12.rst:2230 msgid "Global configuration variables:" msgstr "全域配置變數：" -#: ../../whatsnew/3.12.rst:2392 +#: ../../whatsnew/3.12.rst:2255 msgid "" "The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" "`PyConfig` instead." msgstr "" ":c:func:`Py_InitializeFromConfig` API 應改為與 :c:type:`PyConfig` 一起使用。" -#: ../../whatsnew/3.12.rst:2395 +#: ../../whatsnew/3.12.rst:2258 #, fuzzy msgid "" "Creating :c:data:`immutable types ` with mutable " @@ -3920,26 +4366,26 @@ msgid "" msgstr "" "建立具有可變基底的\\ `不可變型別 ` (:gh:`95388`)。" -#: ../../whatsnew/3.12.rst:2401 +#: ../../whatsnew/3.12.rst:2264 msgid "" ":c:func:`PyImport_ImportModuleNoBlock`: use :c:func:`PyImport_ImportModule`" msgstr "" ":c:func:`PyImport_ImportModuleNoBlock`：請改用 :c:func:" "`PyImport_ImportModule`" -#: ../../whatsnew/3.12.rst:2402 +#: ../../whatsnew/3.12.rst:2265 msgid ":c:type:`!Py_UNICODE_WIDE` type: use :c:type:`wchar_t`" msgstr ":c:type:`!Py_UNICODE_WIDE` 型別：請改用 :c:type:`wchar_t`" -#: ../../whatsnew/3.12.rst:2403 +#: ../../whatsnew/3.12.rst:2266 msgid ":c:type:`Py_UNICODE` type: use :c:type:`wchar_t`" msgstr ":c:type:`Py_UNICODE` 型別：請改用 :c:type:`wchar_t`" -#: ../../whatsnew/3.12.rst:2404 +#: ../../whatsnew/3.12.rst:2267 msgid "Python initialization functions:" msgstr "Python 初始化函式：" -#: ../../whatsnew/3.12.rst:2406 +#: ../../whatsnew/3.12.rst:2269 msgid "" ":c:func:`PySys_ResetWarnOptions`: clear :data:`sys.warnoptions` and :data:`!" "warnings.filters`" @@ -3947,27 +4393,27 @@ msgstr "" ":c:func:`PySys_ResetWarnOptions`：清除 :data:`sys.warnoptions` 和 :data:`!" "warnings.filters`" -#: ../../whatsnew/3.12.rst:2408 +#: ../../whatsnew/3.12.rst:2271 msgid ":c:func:`Py_GetExecPrefix`: get :data:`sys.exec_prefix`" msgstr ":c:func:`Py_GetExecPrefix`：取得 :data:`sys.exec_prefix`" -#: ../../whatsnew/3.12.rst:2409 +#: ../../whatsnew/3.12.rst:2272 msgid ":c:func:`Py_GetPath`: get :data:`sys.path`" msgstr ":c:func:`Py_GetPath`：取得 :data:`sys.path`" -#: ../../whatsnew/3.12.rst:2410 +#: ../../whatsnew/3.12.rst:2273 msgid ":c:func:`Py_GetPrefix`: get :data:`sys.prefix`" msgstr ":c:func:`Py_GetPrefix`：取得 :data:`sys.prefix`" -#: ../../whatsnew/3.12.rst:2411 +#: ../../whatsnew/3.12.rst:2274 msgid ":c:func:`Py_GetProgramFullPath`: get :data:`sys.executable`" msgstr ":c:func:`Py_GetProgramFullPath`：取得 :data:`sys.executable`" -#: ../../whatsnew/3.12.rst:2412 +#: ../../whatsnew/3.12.rst:2275 msgid ":c:func:`Py_GetProgramName`: get :data:`sys.executable`" msgstr ":c:func:`Py_GetProgramName`：取得 :data:`sys.executable`" -#: ../../whatsnew/3.12.rst:2413 +#: ../../whatsnew/3.12.rst:2276 msgid "" ":c:func:`Py_GetPythonHome`: get :c:member:`PyConfig.home` or the :envvar:" "`PYTHONHOME` environment variable" @@ -3975,41 +4421,41 @@ msgstr "" ":c:func:`Py_GetPythonHome`：取得 :c:member:`PyConfig.home` 或 :envvar:" "`PYTHONHOME` 環境變數" -#: ../../whatsnew/3.12.rst:2419 +#: ../../whatsnew/3.12.rst:2282 msgid "" "The following APIs are deprecated and will be removed, although there is " "currently no date scheduled for their removal." msgstr "以下 API 已棄用，且將會被移除，雖目前尚未定下移除日期。" -#: ../../whatsnew/3.12.rst:2422 +#: ../../whatsnew/3.12.rst:2285 msgid ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`: unneeded since Python 3.8" msgstr ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`：自 Python 3.8 起不再需要" -#: ../../whatsnew/3.12.rst:2423 +#: ../../whatsnew/3.12.rst:2286 msgid ":c:func:`PyErr_Fetch`: use :c:func:`PyErr_GetRaisedException`" msgstr ":c:func:`PyErr_Fetch`：請改用 :c:func:`PyErr_GetRaisedException`" -#: ../../whatsnew/3.12.rst:2424 +#: ../../whatsnew/3.12.rst:2287 msgid "" ":c:func:`PyErr_NormalizeException`: use :c:func:`PyErr_GetRaisedException`" msgstr "" ":c:func:`PyErr_NormalizeException`：請改用 :c:func:`PyErr_GetRaisedException`" -#: ../../whatsnew/3.12.rst:2425 +#: ../../whatsnew/3.12.rst:2288 msgid ":c:func:`PyErr_Restore`: use :c:func:`PyErr_SetRaisedException`" msgstr ":c:func:`PyErr_Restore`：請改用 :c:func:`PyErr_SetRaisedException`" -#: ../../whatsnew/3.12.rst:2426 +#: ../../whatsnew/3.12.rst:2289 msgid "" ":c:func:`PyModule_GetFilename`: use :c:func:`PyModule_GetFilenameObject`" msgstr "" ":c:func:`PyModule_GetFilename`：請改用 :c:func:`PyModule_GetFilenameObject`" -#: ../../whatsnew/3.12.rst:2427 +#: ../../whatsnew/3.12.rst:2290 msgid ":c:func:`PyOS_AfterFork`: use :c:func:`PyOS_AfterFork_Child`" msgstr ":c:func:`PyOS_AfterFork`：請改用 :c:func:`PyOS_AfterFork_Child`" -#: ../../whatsnew/3.12.rst:2428 +#: ../../whatsnew/3.12.rst:2291 msgid "" ":c:func:`PySlice_GetIndicesEx`: use :c:func:`PySlice_Unpack` and :c:func:" "`PySlice_AdjustIndices`" @@ -4017,122 +4463,122 @@ msgstr "" ":c:func:`PySlice_GetIndicesEx`：請改用 :c:func:`PySlice_Unpack` 和 :c:func:" "`PySlice_AdjustIndices`" -#: ../../whatsnew/3.12.rst:2429 +#: ../../whatsnew/3.12.rst:2292 msgid ":c:func:`!PyUnicode_AsDecodedObject`: use :c:func:`PyCodec_Decode`" msgstr ":c:func:`!PyUnicode_AsDecodedObject`：請改用 :c:func:`PyCodec_Decode`" -#: ../../whatsnew/3.12.rst:2430 +#: ../../whatsnew/3.12.rst:2293 msgid ":c:func:`!PyUnicode_AsDecodedUnicode`: use :c:func:`PyCodec_Decode`" msgstr ":c:func:`!PyUnicode_AsDecodedUnicode`：請改用 :c:func:`PyCodec_Decode`" -#: ../../whatsnew/3.12.rst:2431 +#: ../../whatsnew/3.12.rst:2294 msgid ":c:func:`!PyUnicode_AsEncodedObject`: use :c:func:`PyCodec_Encode`" msgstr ":c:func:`!PyUnicode_AsEncodedObject`：請改用 :c:func:`PyCodec_Encode`" -#: ../../whatsnew/3.12.rst:2432 +#: ../../whatsnew/3.12.rst:2295 msgid ":c:func:`!PyUnicode_AsEncodedUnicode`: use :c:func:`PyCodec_Encode`" msgstr ":c:func:`!PyUnicode_AsEncodedUnicode`：請改用 :c:func:`PyCodec_Encode`" -#: ../../whatsnew/3.12.rst:2433 +#: ../../whatsnew/3.12.rst:2296 msgid ":c:func:`PyUnicode_READY`: unneeded since Python 3.12" msgstr ":c:func:`PyUnicode_READY`：自 Python 3.12 起不再需要" -#: ../../whatsnew/3.12.rst:2434 +#: ../../whatsnew/3.12.rst:2297 msgid ":c:func:`!PyErr_Display`: use :c:func:`PyErr_DisplayException`" msgstr ":c:func:`!PyErr_Display`：請改用 :c:func:`PyErr_DisplayException`" -#: ../../whatsnew/3.12.rst:2435 +#: ../../whatsnew/3.12.rst:2298 msgid ":c:func:`!_PyErr_ChainExceptions`: use ``_PyErr_ChainExceptions1``" msgstr ":c:func:`!_PyErr_ChainExceptions`：請改用 ``_PyErr_ChainExceptions1``" -#: ../../whatsnew/3.12.rst:2436 +#: ../../whatsnew/3.12.rst:2299 msgid "" ":c:member:`!PyBytesObject.ob_shash` member: call :c:func:`PyObject_Hash` " "instead" msgstr "" ":c:member:`!PyBytesObject.ob_shash` 成員：請改用 :c:func:`PyObject_Hash`" -#: ../../whatsnew/3.12.rst:2438 +#: ../../whatsnew/3.12.rst:2301 msgid ":c:member:`!PyDictObject.ma_version_tag` member" msgstr ":c:member:`!PyDictObject.ma_version_tag` 成員" -#: ../../whatsnew/3.12.rst:2439 +#: ../../whatsnew/3.12.rst:2302 msgid "Thread Local Storage (TLS) API:" msgstr "" -#: ../../whatsnew/3.12.rst:2441 +#: ../../whatsnew/3.12.rst:2304 msgid ":c:func:`PyThread_create_key`: use :c:func:`PyThread_tss_alloc`" msgstr ":c:func:`PyThread_create_key`：請改用 :c:func:`PyThread_tss_alloc`" -#: ../../whatsnew/3.12.rst:2442 +#: ../../whatsnew/3.12.rst:2305 msgid ":c:func:`PyThread_delete_key`: use :c:func:`PyThread_tss_free`" msgstr ":c:func:`PyThread_delete_key`：請改用 :c:func:`PyThread_tss_free`" -#: ../../whatsnew/3.12.rst:2443 +#: ../../whatsnew/3.12.rst:2306 msgid ":c:func:`PyThread_set_key_value`: use :c:func:`PyThread_tss_set`" msgstr ":c:func:`PyThread_set_key_value`：請改用 :c:func:`PyThread_tss_set`" -#: ../../whatsnew/3.12.rst:2444 +#: ../../whatsnew/3.12.rst:2307 msgid ":c:func:`PyThread_get_key_value`: use :c:func:`PyThread_tss_get`" msgstr ":c:func:`PyThread_get_key_value`：請改用 :c:func:`PyThread_tss_get`" -#: ../../whatsnew/3.12.rst:2445 +#: ../../whatsnew/3.12.rst:2308 msgid ":c:func:`PyThread_delete_key_value`: use :c:func:`PyThread_tss_delete`" msgstr "" ":c:func:`PyThread_delete_key_value`：請改用 :c:func:`PyThread_tss_delete`" -#: ../../whatsnew/3.12.rst:2446 +#: ../../whatsnew/3.12.rst:2309 msgid ":c:func:`PyThread_ReInitTLS`: unneeded since Python 3.7" msgstr ":c:func:`PyThread_ReInitTLS`：自 Python 3.7 起不再需要" -#: ../../whatsnew/3.12.rst:2451 +#: ../../whatsnew/3.12.rst:2314 msgid "" "Remove the :file:`token.h` header file. There was never any public tokenizer " "C API. The :file:`token.h` header file was only designed to be used by " "Python internals. (Contributed by Victor Stinner in :gh:`92651`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2456 +#: ../../whatsnew/3.12.rst:2319 msgid "Legacy Unicode APIs have been removed. See :pep:`623` for detail." msgstr "" -#: ../../whatsnew/3.12.rst:2458 +#: ../../whatsnew/3.12.rst:2321 msgid ":c:macro:`!PyUnicode_WCHAR_KIND`" msgstr ":c:macro:`!PyUnicode_WCHAR_KIND`" -#: ../../whatsnew/3.12.rst:2459 +#: ../../whatsnew/3.12.rst:2322 msgid ":c:func:`!PyUnicode_AS_UNICODE`" msgstr ":c:func:`!PyUnicode_AS_UNICODE`" -#: ../../whatsnew/3.12.rst:2460 +#: ../../whatsnew/3.12.rst:2323 msgid ":c:func:`!PyUnicode_AsUnicode`" msgstr ":c:func:`!PyUnicode_AsUnicode`" -#: ../../whatsnew/3.12.rst:2461 +#: ../../whatsnew/3.12.rst:2324 msgid ":c:func:`!PyUnicode_AsUnicodeAndSize`" msgstr ":c:func:`!PyUnicode_AsUnicodeAndSize`" -#: ../../whatsnew/3.12.rst:2462 +#: ../../whatsnew/3.12.rst:2325 msgid ":c:func:`!PyUnicode_AS_DATA`" msgstr ":c:func:`!PyUnicode_AS_DATA`" -#: ../../whatsnew/3.12.rst:2463 +#: ../../whatsnew/3.12.rst:2326 msgid ":c:func:`!PyUnicode_FromUnicode`" msgstr ":c:func:`!PyUnicode_FromUnicode`" -#: ../../whatsnew/3.12.rst:2464 +#: ../../whatsnew/3.12.rst:2327 msgid ":c:func:`!PyUnicode_GET_SIZE`" msgstr ":c:func:`!PyUnicode_GET_SIZE`" -#: ../../whatsnew/3.12.rst:2465 +#: ../../whatsnew/3.12.rst:2328 msgid ":c:func:`!PyUnicode_GetSize`" msgstr ":c:func:`!PyUnicode_GetSize`" -#: ../../whatsnew/3.12.rst:2466 +#: ../../whatsnew/3.12.rst:2329 msgid ":c:func:`!PyUnicode_GET_DATA_SIZE`" msgstr ":c:func:`!PyUnicode_GET_DATA_SIZE`" -#: ../../whatsnew/3.12.rst:2468 +#: ../../whatsnew/3.12.rst:2331 msgid "" "Remove the ``PyUnicode_InternImmortal()`` function macro. (Contributed by " "Victor Stinner in :gh:`85858`.)" @@ -4140,18 +4586,104 @@ msgstr "" "移除 ``PyUnicode_InternImmortal()`` 函式巨集。（由 Victor Stinner 於 :gh:" "`85858` 中貢獻。）" -#: ../../whatsnew/3.12.rst:2472 +#: ../../whatsnew/3.12.rst:2335 msgid "Notable changes in 3.12.4" msgstr "3.12.4 中的明顯變更" -#: ../../whatsnew/3.12.rst:2475 +#: ../../whatsnew/3.12.rst:2338 msgid "ipaddress" msgstr "ipaddress" -#: ../../whatsnew/3.12.rst:2477 +#: ../../whatsnew/3.12.rst:2340 msgid "" "Fixed ``is_global`` and ``is_private`` behavior in ``IPv4Address``, " "``IPv6Address``, ``IPv4Network`` and ``IPv6Network``." msgstr "" "修正 ``IPv4Address``、``IPv6Address``、``IPv4Network`` 和 ``IPv6Network`` 中" "的 ``is_global`` 和 ``is_private`` 行為。" + +#~ msgid "" +#~ "The following modules and APIs have been deprecated in earlier Python " +#~ "releases, and will be removed in Python 3.13." +#~ msgstr "" +#~ "以下模組和 API 在早期的 Python 版本中已被棄用，並將在 Python 3.13 中刪除。" + +#~ msgid "" +#~ "The following APIs have been deprecated and will be removed in Python " +#~ "3.14." +#~ msgstr "以下 API 已被棄用並將在 Python 3.14 中移除。" + +#~ msgid ":class:`!asyncio.MultiLoopChildWatcher`" +#~ msgstr ":class:`!asyncio.MultiLoopChildWatcher`" + +#~ msgid ":class:`!asyncio.FastChildWatcher`" +#~ msgstr ":class:`!asyncio.FastChildWatcher`" + +#~ msgid ":class:`!asyncio.AbstractChildWatcher`" +#~ msgstr ":class:`!asyncio.AbstractChildWatcher`" + +#~ msgid ":class:`!asyncio.SafeChildWatcher`" +#~ msgstr ":class:`!asyncio.SafeChildWatcher`" + +#~ msgid ":func:`!asyncio.set_child_watcher`" +#~ msgstr ":func:`!asyncio.set_child_watcher`" + +#~ msgid ":func:`!asyncio.get_child_watcher`," +#~ msgstr ":func:`!asyncio.get_child_watcher`、" + +#~ msgid ":meth:`!asyncio.AbstractEventLoopPolicy.set_child_watcher`" +#~ msgstr ":meth:`!asyncio.AbstractEventLoopPolicy.set_child_watcher`" + +#~ msgid ":meth:`!asyncio.AbstractEventLoopPolicy.get_child_watcher`" +#~ msgstr ":meth:`!asyncio.AbstractEventLoopPolicy.get_child_watcher`" + +#~ msgid ":mod:`collections.abc`: :class:`!collections.abc.ByteString`." +#~ msgstr ":mod:`collections.abc`: :class:`!collections.abc.ByteString`。" + +#~ msgid "" +#~ ":mod:`email`: the *isdst* parameter in :func:`email.utils.localtime`." +#~ msgstr ":mod:`email`：:func:`email.utils.localtime` 中的 *isdst* 參數。" + +#~ msgid ":mod:`itertools`: Support for copy, deepcopy, and pickle operations." +#~ msgstr ":mod:`itertools`：支援複製、深度複製 (deepcopy) 和 pickle 操作。" + +#~ msgid ":mod:`pkgutil`:" +#~ msgstr ":mod:`pkgutil`：" + +#~ msgid ":func:`!pkgutil.find_loader`" +#~ msgstr ":func:`!pkgutil.find_loader`" + +#~ msgid ":func:`!pkgutil.get_loader`." +#~ msgstr ":func:`!pkgutil.get_loader`。" + +#~ msgid ":func:`!pty.master_open`" +#~ msgstr ":func:`!pty.master_open`" + +#~ msgid ":func:`!pty.slave_open`" +#~ msgstr ":func:`!pty.slave_open`" + +#~ msgid ":mod:`shutil`: The *onerror* argument of :func:`shutil.rmtree`" +#~ msgstr ":mod:`shutil`：:func:`shutil.rmtree` 的 *onerror* 引數" + +#~ msgid ":mod:`typing`: :class:`!typing.ByteString`" +#~ msgstr ":mod:`typing`：:class:`!typing.ByteString`" + +#~ msgid "" +#~ ":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`xml." +#~ "etree.ElementTree.Element`." +#~ msgstr "" +#~ ":mod:`xml.etree.ElementTree`：測試 :class:`xml.etree.ElementTree.Element` " +#~ "的真值。" + +#~ msgid "The ``__package__`` and ``__cached__`` attributes on module objects." +#~ msgstr "模組物件上的 ``__package__`` 和 ``__cached__`` 屬性。" + +#~ msgid ":func:`locale.getdefaultlocale` (:gh:`90817`)" +#~ msgstr ":func:`locale.getdefaultlocale` (:gh:`90817`)" + +#~ msgid "" +#~ "The following APIs were deprecated in earlier Python versions and will be " +#~ "removed, although there is currently no date scheduled for their removal." +#~ msgstr "" +#~ "以下 API 在早期 Python 版本中已棄用，並將被刪除，但目前還沒有計劃刪除它們" +#~ "的日期。" From 62e33440068593868079252f18711fd8f3d56ce0 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Sat, 27 Jul 2024 00:05:05 +0000 Subject: [PATCH 09/28] sync with cpython d4ca183a --- library/mimetypes.po | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/library/mimetypes.po b/library/mimetypes.po index d4e79df177..5a923db1a8 100644 --- a/library/mimetypes.po +++ b/library/mimetypes.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-27 00:03+0000\n" "PO-Revision-Date: 2016-11-19 00:32+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -152,7 +152,7 @@ msgid "" "file *filename* does not exist or cannot be read, ``None`` is returned." msgstr "" -#: ../../library/mimetypes.rst:114 +#: ../../library/mimetypes.rst:114 ../../library/mimetypes.rst:279 msgid "" "Add a mapping from the MIME type *type* to the extension *ext*. When the " "extension is already known, the new type will replace the old one. When the " @@ -160,7 +160,7 @@ msgid "" "extensions." msgstr "" -#: ../../library/mimetypes.rst:118 +#: ../../library/mimetypes.rst:118 ../../library/mimetypes.rst:283 msgid "" "When *strict* is ``True`` (the default), the mapping will be added to the " "official MIME types, otherwise to the non-standard ones." From d3e845883914536828556a5e9f830af1b4a22253 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Sun, 28 Jul 2024 00:05:00 +0000 Subject: [PATCH 10/28] sync with cpython ca3486cb --- deprecations/pending-removal-in-3.16.po | 12 +- deprecations/pending-removal-in-future.po | 124 +++---- library/ast.po | 380 +++++++++++----------- library/pathlib.po | 374 ++++++++++++--------- whatsnew/3.12.po | 134 ++++---- 5 files changed, 567 insertions(+), 457 deletions(-) diff --git a/deprecations/pending-removal-in-3.16.po b/deprecations/pending-removal-in-3.16.po index a34f49d580..a38d082adc 100644 --- a/deprecations/pending-removal-in-3.16.po +++ b/deprecations/pending-removal-in-3.16.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-25 00:04+0000\n" +"POT-Creation-Date: 2024-07-28 00:03+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -23,6 +23,12 @@ msgstr "" #: ../../deprecations/pending-removal-in-3.16.rst:4 msgid "" -":class:`array.array` ``'u'`` type (:c:type:`wchar_t`): use the ``'w'`` type " -"instead (``Py_UCS4``)." +":mod:`array`: :class:`array.array` ``'u'`` type (:c:type:`wchar_t`): use the " +"``'w'`` type instead (``Py_UCS4``)." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.16.rst:8 +msgid "" +":mod:`symtable`: Deprecate :meth:`symtable.Class.get_methods` due to the " +"lack of interest. (Contributed by Bénédikt Tran in :gh:`119698`.)" msgstr "" diff --git a/deprecations/pending-removal-in-future.po b/deprecations/pending-removal-in-future.po index 9ac214f85b..11a43f5e49 100644 --- a/deprecations/pending-removal-in-future.po +++ b/deprecations/pending-removal-in-future.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-25 00:04+0000\n" +"POT-Creation-Date: 2024-07-28 00:03+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -93,83 +93,91 @@ msgstr "" msgid "Delegation of ``int()`` to ``__trunc__()`` method." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:38 +#: ../../deprecations/pending-removal-in-future.rst:37 +msgid "" +"Passing a complex number as the *real* or *imag* argument in the :func:" +"`complex` constructor is now deprecated; it should only be passed as a " +"single positional argument. (Contributed by Serhiy Storchaka in :gh:" +"`109218`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:42 msgid "" ":mod:`calendar`: ``calendar.January`` and ``calendar.February`` constants " "are deprecated and replaced by :data:`calendar.JANUARY` and :data:`calendar." "FEBRUARY`. (Contributed by Prince Roshan in :gh:`103636`.)" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:43 +#: ../../deprecations/pending-removal-in-future.rst:47 msgid "" ":attr:`codeobject.co_lnotab`: use the :meth:`codeobject.co_lines` method " "instead." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:46 +#: ../../deprecations/pending-removal-in-future.rst:50 msgid ":mod:`datetime`:" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:48 +#: ../../deprecations/pending-removal-in-future.rst:52 msgid "" ":meth:`~datetime.datetime.utcnow`: use ``datetime.datetime.now(tz=datetime." "UTC)``." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:50 +#: ../../deprecations/pending-removal-in-future.rst:54 msgid "" ":meth:`~datetime.datetime.utcfromtimestamp`: use ``datetime.datetime." "fromtimestamp(timestamp, tz=datetime.UTC)``." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:53 +#: ../../deprecations/pending-removal-in-future.rst:57 msgid ":mod:`gettext`: Plural value must be an integer." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:55 +#: ../../deprecations/pending-removal-in-future.rst:59 msgid ":mod:`importlib`:" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:57 +#: ../../deprecations/pending-removal-in-future.rst:61 msgid "``load_module()`` method: use ``exec_module()`` instead." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:58 +#: ../../deprecations/pending-removal-in-future.rst:62 msgid "" ":func:`~importlib.util.cache_from_source` *debug_override* parameter is " "deprecated: use the *optimization* parameter instead." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:61 +#: ../../deprecations/pending-removal-in-future.rst:65 msgid ":mod:`importlib.metadata`:" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:63 +#: ../../deprecations/pending-removal-in-future.rst:67 msgid "``EntryPoints`` tuple interface." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:64 +#: ../../deprecations/pending-removal-in-future.rst:68 msgid "Implicit ``None`` on return values." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:66 +#: ../../deprecations/pending-removal-in-future.rst:70 msgid "" ":mod:`mailbox`: Use of StringIO input and text mode is deprecated, use " "BytesIO and binary mode instead." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:69 +#: ../../deprecations/pending-removal-in-future.rst:73 msgid "" ":mod:`os`: Calling :func:`os.register_at_fork` in multi-threaded process." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:71 +#: ../../deprecations/pending-removal-in-future.rst:75 msgid "" ":class:`!pydoc.ErrorDuringImport`: A tuple value for *exc_info* parameter is " "deprecated, use an exception instance." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:74 +#: ../../deprecations/pending-removal-in-future.rst:78 msgid "" ":mod:`re`: More strict rules are now applied for numerical group references " "and group names in regular expressions. Only sequence of ASCII digits is " @@ -178,185 +186,185 @@ msgid "" "underscore. (Contributed by Serhiy Storchaka in :gh:`91760`.)" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:81 +#: ../../deprecations/pending-removal-in-future.rst:85 msgid "" ":mod:`!sre_compile`, :mod:`!sre_constants` and :mod:`!sre_parse` modules." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:83 +#: ../../deprecations/pending-removal-in-future.rst:87 msgid "" ":mod:`shutil`: :func:`~shutil.rmtree`'s *onerror* parameter is deprecated in " "Python 3.12; use the *onexc* parameter instead." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:86 +#: ../../deprecations/pending-removal-in-future.rst:90 msgid ":mod:`ssl` options and protocols:" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:88 +#: ../../deprecations/pending-removal-in-future.rst:92 msgid ":class:`ssl.SSLContext` without protocol argument is deprecated." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:89 +#: ../../deprecations/pending-removal-in-future.rst:93 msgid "" ":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` and :meth:" "`!selected_npn_protocol` are deprecated: use ALPN instead." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:92 +#: ../../deprecations/pending-removal-in-future.rst:96 msgid "``ssl.OP_NO_SSL*`` options" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:93 +#: ../../deprecations/pending-removal-in-future.rst:97 msgid "``ssl.OP_NO_TLS*`` options" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:94 +#: ../../deprecations/pending-removal-in-future.rst:98 msgid "``ssl.PROTOCOL_SSLv3``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:95 +#: ../../deprecations/pending-removal-in-future.rst:99 msgid "``ssl.PROTOCOL_TLS``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:96 +#: ../../deprecations/pending-removal-in-future.rst:100 msgid "``ssl.PROTOCOL_TLSv1``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:97 +#: ../../deprecations/pending-removal-in-future.rst:101 msgid "``ssl.PROTOCOL_TLSv1_1``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:98 +#: ../../deprecations/pending-removal-in-future.rst:102 msgid "``ssl.PROTOCOL_TLSv1_2``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:99 +#: ../../deprecations/pending-removal-in-future.rst:103 msgid "``ssl.TLSVersion.SSLv3``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:100 +#: ../../deprecations/pending-removal-in-future.rst:104 msgid "``ssl.TLSVersion.TLSv1``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:101 +#: ../../deprecations/pending-removal-in-future.rst:105 msgid "``ssl.TLSVersion.TLSv1_1``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:103 +#: ../../deprecations/pending-removal-in-future.rst:107 msgid "" ":func:`sysconfig.is_python_build` *check_home* parameter is deprecated and " "ignored." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:106 +#: ../../deprecations/pending-removal-in-future.rst:110 msgid ":mod:`threading` methods:" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:108 +#: ../../deprecations/pending-removal-in-future.rst:112 msgid "" ":meth:`!threading.Condition.notifyAll`: use :meth:`~threading.Condition." "notify_all`." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:109 +#: ../../deprecations/pending-removal-in-future.rst:113 msgid ":meth:`!threading.Event.isSet`: use :meth:`~threading.Event.is_set`." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:110 +#: ../../deprecations/pending-removal-in-future.rst:114 msgid "" ":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: use :" "attr:`threading.Thread.daemon` attribute." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:112 +#: ../../deprecations/pending-removal-in-future.rst:116 msgid "" ":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: use :" "attr:`threading.Thread.name` attribute." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:114 +#: ../../deprecations/pending-removal-in-future.rst:118 msgid ":meth:`!threading.currentThread`: use :meth:`threading.current_thread`." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:115 +#: ../../deprecations/pending-removal-in-future.rst:119 msgid ":meth:`!threading.activeCount`: use :meth:`threading.active_count`." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:117 +#: ../../deprecations/pending-removal-in-future.rst:121 msgid ":class:`typing.Text` (:gh:`92332`)." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:119 +#: ../../deprecations/pending-removal-in-future.rst:123 msgid "" ":class:`unittest.IsolatedAsyncioTestCase`: it is deprecated to return a " "value that is not ``None`` from a test case." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:122 +#: ../../deprecations/pending-removal-in-future.rst:126 msgid "" ":mod:`urllib.parse` deprecated functions: :func:`~urllib.parse.urlparse` " "instead" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:124 +#: ../../deprecations/pending-removal-in-future.rst:128 msgid "``splitattr()``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:125 +#: ../../deprecations/pending-removal-in-future.rst:129 msgid "``splithost()``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:126 +#: ../../deprecations/pending-removal-in-future.rst:130 msgid "``splitnport()``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:127 +#: ../../deprecations/pending-removal-in-future.rst:131 msgid "``splitpasswd()``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:128 +#: ../../deprecations/pending-removal-in-future.rst:132 msgid "``splitport()``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:129 +#: ../../deprecations/pending-removal-in-future.rst:133 msgid "``splitquery()``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:130 +#: ../../deprecations/pending-removal-in-future.rst:134 msgid "``splittag()``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:131 +#: ../../deprecations/pending-removal-in-future.rst:135 msgid "``splittype()``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:132 +#: ../../deprecations/pending-removal-in-future.rst:136 msgid "``splituser()``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:133 +#: ../../deprecations/pending-removal-in-future.rst:137 msgid "``splitvalue()``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:134 +#: ../../deprecations/pending-removal-in-future.rst:138 msgid "``to_bytes()``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:136 +#: ../../deprecations/pending-removal-in-future.rst:140 msgid "" ":mod:`urllib.request`: :class:`~urllib.request.URLopener` and :class:" "`~urllib.request.FancyURLopener` style of invoking requests is deprecated. " "Use newer :func:`~urllib.request.urlopen` functions and methods." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:140 +#: ../../deprecations/pending-removal-in-future.rst:144 msgid "" ":mod:`wsgiref`: ``SimpleHandler.stdout.write()`` should not do partial " "writes." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:143 +#: ../../deprecations/pending-removal-in-future.rst:147 msgid "" ":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`~xml." "etree.ElementTree.Element` is deprecated. In a future release it will always " @@ -364,7 +372,7 @@ msgid "" "instead." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:148 +#: ../../deprecations/pending-removal-in-future.rst:152 msgid "" ":meth:`zipimport.zipimporter.load_module` is deprecated: use :meth:" "`~zipimport.zipimporter.exec_module` instead." diff --git a/library/ast.po b/library/ast.po index 99a57e76eb..27f45561ee 100644 --- a/library/ast.po +++ b/library/ast.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-23 00:04+0000\n" +"POT-Creation-Date: 2024-07-28 00:03+0000\n" "PO-Revision-Date: 2018-05-23 14:38+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -359,7 +359,7 @@ msgid "" msgstr "" "一個 f 字串，包含一系列 :class:`FormattedValue` 和 :class:`Constant` 節點。" -#: ../../library/ast.rst:311 +#: ../../library/ast.rst:313 msgid "" "A list or tuple. ``elts`` holds a list of nodes representing the elements. " "``ctx`` is :class:`Store` if the container is an assignment target (i.e. " @@ -368,11 +368,11 @@ msgstr "" "串列或元組。``elts`` 保存表示元素的節點串列。如果容器是賦值目標（即 ``(x," "y)=something`` ），則 ``ctx`` 是 :class:`Store`，否則是 :class:`Load`。" -#: ../../library/ast.rst:337 +#: ../../library/ast.rst:339 msgid "A set. ``elts`` holds a list of nodes representing the set's elements." msgstr "一個集合。``elts`` 保存表示集合之元素的節點串列。" -#: ../../library/ast.rst:352 +#: ../../library/ast.rst:354 msgid "" "A dictionary. ``keys`` and ``values`` hold lists of nodes representing the " "keys and the values respectively, in matching order (what would be returned " @@ -382,7 +382,7 @@ msgstr "" "節點串列（為呼叫 :code:`dictionary.keys()` 和 :code:`dictionary.values()` 時" "將回傳的內容）。" -#: ../../library/ast.rst:356 +#: ../../library/ast.rst:358 msgid "" "When doing dictionary unpacking using dictionary literals the expression to " "be expanded goes in the ``values`` list, with a ``None`` at the " @@ -391,17 +391,17 @@ msgstr "" "當使用字典文本進行字典解包 (unpack) 時，要擴充的運算式位於 ``values`` 串列" "中，在 ``keys`` 中的相應位置有一個 ``None``。" -#: ../../library/ast.rst:374 +#: ../../library/ast.rst:376 msgid "Variables" msgstr "變數" -#: ../../library/ast.rst:378 +#: ../../library/ast.rst:380 msgid "" "A variable name. ``id`` holds the name as a string, and ``ctx`` is one of " "the following types." msgstr "一個變數名稱。``id`` 將名稱以字串形式保存，且 ``ctx`` 是以下型別之一。" -#: ../../library/ast.rst:386 +#: ../../library/ast.rst:388 msgid "" "Variable references can be used to load the value of a variable, to assign a " "new value to it, or to delete it. Variable references are given a context to " @@ -410,7 +410,7 @@ msgstr "" "變數參照可用於載入變數的值、為其分配新值或刪除它。變數參照被賦予情境 " "(context) 來區分這些情況。" -#: ../../library/ast.rst:419 +#: ../../library/ast.rst:421 msgid "" "A ``*var`` variable reference. ``value`` holds the variable, typically a :" "class:`Name` node. This type must be used when building a :class:`Call` node " @@ -419,11 +419,11 @@ msgstr "" "一個 ``*var`` 變數參照。``value`` 保存變數，通常是一個 :class:`Name` 節點。在" "使用 ``*args`` 建置 :class:`Call` 節點時必須使用此型別。" -#: ../../library/ast.rst:444 +#: ../../library/ast.rst:446 msgid "Expressions" msgstr "運算式" -#: ../../library/ast.rst:448 +#: ../../library/ast.rst:450 msgid "" "When an expression, such as a function call, appears as a statement by " "itself with its return value not used or stored, it is wrapped in this " @@ -436,14 +436,14 @@ msgstr "" "`Constant`、:class:`Name`、:class:`Lambda`、:class:`Yield` 或 :class:" "`YieldFrom`" -#: ../../library/ast.rst:467 +#: ../../library/ast.rst:469 msgid "" "A unary operation. ``op`` is the operator, and ``operand`` any expression " "node." msgstr "" "一元運算 (unary operation)。``op`` 是運算子，``operand`` 是任何運算式節點。" -#: ../../library/ast.rst:476 +#: ../../library/ast.rst:478 msgid "" "Unary operator tokens. :class:`Not` is the ``not`` keyword, :class:`Invert` " "is the ``~`` operator." @@ -451,7 +451,7 @@ msgstr "" "一元運算子標記。 :class:`Not` 是 ``not`` 關鍵字、:class:`Invert` 是 ``~`` 運" "算子。" -#: ../../library/ast.rst:490 +#: ../../library/ast.rst:492 msgid "" "A binary operation (like addition or division). ``op`` is the operator, and " "``left`` and ``right`` are any expression nodes." @@ -459,11 +459,11 @@ msgstr "" "二元運算 (binary operation)（如加法或除法）。 ``op`` 是運算子、``left`` 和 " "``right`` 是任意運算式節點。" -#: ../../library/ast.rst:517 +#: ../../library/ast.rst:519 msgid "Binary operator tokens." msgstr "二元運算子 token。" -#: ../../library/ast.rst:522 +#: ../../library/ast.rst:524 msgid "" "A boolean operation, 'or' or 'and'. ``op`` is :class:`Or` or :class:`And`. " "``values`` are the values involved. Consecutive operations with the same " @@ -474,15 +474,15 @@ msgstr "" "有所涉及的值。使用同一運算子的連續操作（例如 ``a or b or c``\\ ）會被折疊為具" "有多個值的一個節點。" -#: ../../library/ast.rst:527 +#: ../../library/ast.rst:529 msgid "This doesn't include ``not``, which is a :class:`UnaryOp`." msgstr "這不包括 ``not``，它是一個 :class:`UnaryOp`。" -#: ../../library/ast.rst:543 +#: ../../library/ast.rst:545 msgid "Boolean operator tokens." msgstr "布林運算子 token。" -#: ../../library/ast.rst:548 +#: ../../library/ast.rst:550 msgid "" "A comparison of two or more values. ``left`` is the first value in the " "comparison, ``ops`` the list of operators, and ``comparators`` the list of " @@ -491,11 +491,11 @@ msgstr "" "兩個或多個值的比較。``left`` 是比較中的第一個值、``ops`` 是運算子串列、" "``comparators`` 是要比較的第一個元素之後值的串列。" -#: ../../library/ast.rst:577 +#: ../../library/ast.rst:579 msgid "Comparison operator tokens." msgstr "比較運算子 token。" -#: ../../library/ast.rst:582 +#: ../../library/ast.rst:584 msgid "" "A function call. ``func`` is the function, which will often be a :class:" "`Name` or :class:`Attribute` object. Of the arguments:" @@ -503,25 +503,25 @@ msgstr "" "一個函式呼叫。``func`` 是該函式，通常是一個 :class:`Name` 或 :class:" "`Attribute` 物件。而在引數中：" -#: ../../library/ast.rst:585 +#: ../../library/ast.rst:587 msgid "``args`` holds a list of the arguments passed by position." msgstr "``args`` 保存按位置傳遞的引數串列。" -#: ../../library/ast.rst:586 +#: ../../library/ast.rst:588 msgid "" "``keywords`` holds a list of :class:`.keyword` objects representing " "arguments passed by keyword." msgstr "" "``keywords`` 保存一個 :class:`.keyword` 物件串列，表示透過關鍵字傳遞的引數。" -#: ../../library/ast.rst:589 +#: ../../library/ast.rst:591 msgid "" "When creating a ``Call`` node, ``args`` and ``keywords`` are required, but " "they can be empty lists." msgstr "" "建立 ``Call`` 節點時會需要 ``args`` 和 ``keywords``，但它們可以是空串列。" -#: ../../library/ast.rst:613 +#: ../../library/ast.rst:615 msgid "" "A keyword argument to a function call or class definition. ``arg`` is a raw " "string of the parameter name, ``value`` is a node to pass in." @@ -529,7 +529,7 @@ msgstr "" "函式呼叫或類別定義的關鍵字引數。``arg`` 是參數名稱的原始字串，``value`` 是要" "傳入的節點。" -#: ../../library/ast.rst:619 +#: ../../library/ast.rst:621 msgid "" "An expression such as ``a if b else c``. Each field holds a single node, so " "in the following example, all three are :class:`Name` nodes." @@ -537,7 +537,7 @@ msgstr "" "像是 ``a if b else c`` 之類的運算式。每個欄位都保存一個節點，因此在以下範例" "中，所有三個都是 :class:`Name` 節點。" -#: ../../library/ast.rst:634 +#: ../../library/ast.rst:636 msgid "" "Attribute access, e.g. ``d.keys``. ``value`` is a node, typically a :class:" "`Name`. ``attr`` is a bare string giving the name of the attribute, and " @@ -548,7 +548,7 @@ msgstr "" "``attr`` 是一個屬性名稱的字串，``ctx`` 根據屬性的作用方式可能是 :class:" "`Load`、:class:`Store` 或 :class:`Del`。" -#: ../../library/ast.rst:651 +#: ../../library/ast.rst:653 msgid "" "A named expression. This AST node is produced by the assignment expressions " "operator (also known as the walrus operator). As opposed to the :class:" @@ -559,11 +559,11 @@ msgstr "" "運算子）產生。相對於 :class:`Assign` 節點之第一個引數可為多個節點，在這種情況" "下 ``target`` 和 ``value`` 都必須是單個節點。" -#: ../../library/ast.rst:667 +#: ../../library/ast.rst:669 msgid "Subscripting" msgstr "下標 (Subscripting)" -#: ../../library/ast.rst:671 +#: ../../library/ast.rst:673 msgid "" "A subscript, such as ``l[1]``. ``value`` is the subscripted object (usually " "sequence or mapping). ``slice`` is an index, slice or key. It can be a :" @@ -575,7 +575,7 @@ msgstr "" "下標執行的操作不同，``ctx`` 可以是 :class:`Load`、:class:`Store` 或 :class:" "`Del`。" -#: ../../library/ast.rst:695 +#: ../../library/ast.rst:697 msgid "" "Regular slicing (on the form ``lower:upper`` or ``lower:upper:step``). Can " "occur only inside the *slice* field of :class:`Subscript`, either directly " @@ -584,11 +584,11 @@ msgstr "" "常規切片（形式為 ``lower:upper`` 或 ``lower:upper:step``\\ ）。只能直接或者或" "者作為 :class:`Tuple` 的元素出現在 :class:`Subscript` 的 *slice* 欄位內。" -#: ../../library/ast.rst:712 +#: ../../library/ast.rst:714 msgid "Comprehensions" msgstr "綜合運算式 (comprehensions)" -#: ../../library/ast.rst:719 +#: ../../library/ast.rst:721 msgid "" "List and set comprehensions, generator expressions, and dictionary " "comprehensions. ``elt`` (or ``key`` and ``value``) is a single node " @@ -597,11 +597,11 @@ msgstr "" "串列和集合綜合運算、生成器運算式和字典綜合運算。``elt``\\ （或 ``key`` 和 " "``value``\\ ）是單個節點，表示各個項目會被求值 (evaluate) 的部分。" -#: ../../library/ast.rst:723 +#: ../../library/ast.rst:725 msgid "``generators`` is a list of :class:`comprehension` nodes." msgstr "``generators`` 是一個 :class:`comprehension` 節點的串列。" -#: ../../library/ast.rst:765 +#: ../../library/ast.rst:767 msgid "" "One ``for`` clause in a comprehension. ``target`` is the reference to use " "for each element - typically a :class:`Name` or :class:`Tuple` node. " @@ -612,7 +612,7 @@ msgstr "" "class:`Name` 或 :class:`Tuple` 節點。``iter`` 是要疊代的物件。``ifs`` 是測試" "運算式的串列：每個 ``for`` 子句可以有多個 ``ifs``。" -#: ../../library/ast.rst:770 +#: ../../library/ast.rst:772 msgid "" "``is_async`` indicates a comprehension is asynchronous (using an ``async " "for`` instead of ``for``). The value is an integer (0 or 1)." @@ -620,17 +620,17 @@ msgstr "" "``is_async`` 表示綜合運算式是非同步的（使用 ``async for`` 而不是 ``for`` ）。" "該值為整數（0 或 1）。" -#: ../../library/ast.rst:839 +#: ../../library/ast.rst:841 msgid "Statements" msgstr "陳述式" -#: ../../library/ast.rst:843 +#: ../../library/ast.rst:845 msgid "" "An assignment. ``targets`` is a list of nodes, and ``value`` is a single " "node." msgstr "一個賦值。``targets`` 是節點串列，``value`` 是單個節點。" -#: ../../library/ast.rst:845 +#: ../../library/ast.rst:847 msgid "" "Multiple nodes in ``targets`` represents assigning the same value to each. " "Unpacking is represented by putting a :class:`Tuple` or :class:`List` within " @@ -639,13 +639,13 @@ msgstr "" "``targets`` 中的多個節點表示為每個節點分配相同的值。解包是透過在 ``targets`` " "中放置一個 :class:`Tuple` 或 :class:`List` 來表示的。" -#: ../../library/ast.rst:851 ../../library/ast.rst:1163 -#: ../../library/ast.rst:1368 ../../library/ast.rst:1893 +#: ../../library/ast.rst:853 ../../library/ast.rst:1165 +#: ../../library/ast.rst:1370 ../../library/ast.rst:1895 msgid "" "``type_comment`` is an optional string with the type annotation as a comment." msgstr "``type_comment`` 是一個可選字串，其中的註解為型別註釋。" -#: ../../library/ast.rst:881 +#: ../../library/ast.rst:883 #, fuzzy msgid "" "An assignment with a type annotation. ``target`` is a single node and can be " @@ -657,7 +657,7 @@ msgstr "" "`Attribute` 或 :class:`Subscript`。``annotation`` 是註釋，例如 :class:" "`Constant` 或 :class:`Name` 節點。``value`` 是單個可選節點。" -#: ../../library/ast.rst:886 +#: ../../library/ast.rst:888 msgid "" "``simple`` is always either 0 (indicating a \"complex\" target) or 1 " "(indicating a \"simple\" target). A \"simple\" target consists solely of a :" @@ -670,7 +670,7 @@ msgstr "" "被視為是複雜的。只有簡單目標會出現在模組和類別的 :attr:`__annotations__` 字典" "中。" -#: ../../library/ast.rst:940 +#: ../../library/ast.rst:942 msgid "" "Augmented assignment, such as ``a += 1``. In the following example, " "``target`` is a :class:`Name` node for ``x`` (with the :class:`Store` " @@ -681,7 +681,7 @@ msgstr "" "是 ``x`` 的 :class:`Name` 節點（帶有 :class:`Store` 情境），``op`` 是 :class:" "`Add`，``value`` 是一個值為 1 的 :class:`Constant`。" -#: ../../library/ast.rst:945 +#: ../../library/ast.rst:947 msgid "" "The ``target`` attribute cannot be of class :class:`Tuple` or :class:`List`, " "unlike the targets of :class:`Assign`." @@ -689,7 +689,7 @@ msgstr "" "與 :class:`Assign` 的目標不同，``target`` 屬性不能屬於 :class:`Tuple` 或 :" "class:`List` 類別。" -#: ../../library/ast.rst:962 +#: ../../library/ast.rst:964 msgid "" "A ``raise`` statement. ``exc`` is the exception object to be raised, " "normally a :class:`Call` or :class:`Name`, or ``None`` for a standalone " @@ -699,7 +699,7 @@ msgstr "" "class:`Name`，若是獨立的 ``raise`` 則為 ``None``。``cause`` 是 ``raise x " "from y`` 中的可選部分 ``y``。" -#: ../../library/ast.rst:979 +#: ../../library/ast.rst:981 msgid "" "An assertion. ``test`` holds the condition, such as a :class:`Compare` node. " "``msg`` holds the failure message." @@ -707,7 +707,7 @@ msgstr "" "一個斷言 (assertion)。``test`` 保存條件，例如 :class:`Compare` 節點。``msg`` " "保存失敗訊息。" -#: ../../library/ast.rst:995 +#: ../../library/ast.rst:997 msgid "" "Represents a ``del`` statement. ``targets`` is a list of nodes, such as :" "class:`Name`, :class:`Attribute` or :class:`Subscript` nodes." @@ -715,11 +715,11 @@ msgstr "" "代表一個 ``del`` 陳述式。``targets`` 是節點串列，例如 :class:`Name`、:class:" "`Attribute` 或 :class:`Subscript` 節點。" -#: ../../library/ast.rst:1013 +#: ../../library/ast.rst:1015 msgid "A ``pass`` statement." msgstr "一個 ``pass`` 陳述式。" -#: ../../library/ast.rst:1026 +#: ../../library/ast.rst:1028 msgid "" "A :ref:`type alias ` created through the :keyword:`type` " "statement. ``name`` is the name of the alias, ``type_params`` is a list of :" @@ -730,21 +730,21 @@ msgstr "" "aliases>`。``name`` 是別名的名稱、``type_params`` 是\\ :ref:`型別參數 (type " "parameter) ` 的串列、``value`` 是型別別名的值。" -#: ../../library/ast.rst:1044 +#: ../../library/ast.rst:1046 msgid "" "Other statements which are only applicable inside functions or loops are " "described in other sections." msgstr "其他僅適用於函式或迴圈內部的陳述式將在其他部分中描述。" -#: ../../library/ast.rst:1048 +#: ../../library/ast.rst:1050 msgid "Imports" msgstr "引入 (imports)" -#: ../../library/ast.rst:1052 +#: ../../library/ast.rst:1054 msgid "An import statement. ``names`` is a list of :class:`alias` nodes." msgstr "一個 import 陳述式。``names`` 是 :class:`alias` 節點的串列。" -#: ../../library/ast.rst:1069 +#: ../../library/ast.rst:1071 msgid "" "Represents ``from x import y``. ``module`` is a raw string of the 'from' " "name, without any leading dots, or ``None`` for statements such as ``from . " @@ -755,7 +755,7 @@ msgstr "" "點 (dot)，或者對於諸如 ``from . import foo`` 之類的陳述式則為 ``None``。" "``level`` 是一個整數，保存相對引入的級別（0 表示絕對引入）。" -#: ../../library/ast.rst:1091 +#: ../../library/ast.rst:1093 msgid "" "Both parameters are raw strings of the names. ``asname`` can be ``None`` if " "the regular name is to be used." @@ -763,17 +763,17 @@ msgstr "" "這兩個參數都是名稱的原始字串。如果要使用常規名稱，``asname`` 可以為 " "``None``。" -#: ../../library/ast.rst:1108 +#: ../../library/ast.rst:1110 msgid "Control flow" msgstr "流程控制" -#: ../../library/ast.rst:1111 +#: ../../library/ast.rst:1113 msgid "" "Optional clauses such as ``else`` are stored as an empty list if they're not " "present." msgstr "諸如 ``else`` 之類的可選子句如果不存在，則將被儲存為空串列。" -#: ../../library/ast.rst:1116 +#: ../../library/ast.rst:1118 msgid "" "An ``if`` statement. ``test`` holds a single node, such as a :class:" "`Compare` node. ``body`` and ``orelse`` each hold a list of nodes." @@ -781,7 +781,7 @@ msgstr "" "一個 ``if`` 陳述式。``test`` 保存單個節點，例如 :class:`Compare` 節點。" "``body`` 和 ``orelse`` 各自保存一個節點串列。" -#: ../../library/ast.rst:1119 +#: ../../library/ast.rst:1121 msgid "" "``elif`` clauses don't have a special representation in the AST, but rather " "appear as extra :class:`If` nodes within the ``orelse`` section of the " @@ -790,7 +790,7 @@ msgstr "" "``elif`` 子句在 AST 中沒有特殊表示，而是在前一個子句的 ``orelse`` 部分中作為" "額外的 :class:`If` 節點出現。" -#: ../../library/ast.rst:1154 +#: ../../library/ast.rst:1156 msgid "" "A ``for`` loop. ``target`` holds the variable(s) the loop assigns to, as a " "single :class:`Name`, :class:`Tuple`, :class:`List`, :class:`Attribute` or :" @@ -805,17 +805,17 @@ msgstr "" "行的節點串列。如果迴圈正常完成，則執行 ``orelse`` 中的內容，而不是透過 " "``break`` 陳述式執行。" -#: ../../library/ast.rst:1189 +#: ../../library/ast.rst:1191 msgid "" "A ``while`` loop. ``test`` holds the condition, such as a :class:`Compare` " "node." msgstr "一個 ``while`` 迴圈。``test`` 保存條件，例如 :class:`Compare` 節點。" -#: ../../library/ast.rst:1216 +#: ../../library/ast.rst:1218 msgid "The ``break`` and ``continue`` statements." msgstr "``break`` 和 ``continue`` 陳述式。" -#: ../../library/ast.rst:1251 +#: ../../library/ast.rst:1253 msgid "" "``try`` blocks. All attributes are list of nodes to execute, except for " "``handlers``, which is a list of :class:`ExceptHandler` nodes." @@ -823,7 +823,7 @@ msgstr "" "``try`` 區塊。除 ``handlers`` 是 :class:`ExceptHandler` 節點的串列外，其他所" "有屬性都是要執行之節點的串列。" -#: ../../library/ast.rst:1297 +#: ../../library/ast.rst:1299 msgid "" "``try`` blocks which are followed by ``except*`` clauses. The attributes are " "the same as for :class:`Try` but the :class:`ExceptHandler` nodes in " @@ -833,7 +833,7 @@ msgstr "" "``handlers`` 中的 :class:`ExceptHandler` 節點被直譯 (interpret) 為 " "``except*`` 區塊而不是 ``except``。" -#: ../../library/ast.rst:1329 +#: ../../library/ast.rst:1331 msgid "" "A single ``except`` clause. ``type`` is the exception type it will match, " "typically a :class:`Name` node (or ``None`` for a catch-all ``except:`` " @@ -845,7 +845,7 @@ msgstr "" "``name`` 是用於保存例外的名稱之原始字串，如果子句沒有 ``as foo`` ，則為 " "``None``。``body`` 是節點串列。" -#: ../../library/ast.rst:1363 +#: ../../library/ast.rst:1365 msgid "" "A ``with`` block. ``items`` is a list of :class:`withitem` nodes " "representing the context managers, and ``body`` is the indented block inside " @@ -854,7 +854,7 @@ msgstr "" "一個 ``with`` 區塊。``items`` 是表示情境管理器的 :class:`withitem` 節點串列，" "``body`` 是情境內的縮進區塊。" -#: ../../library/ast.rst:1373 +#: ../../library/ast.rst:1375 msgid "" "A single context manager in a ``with`` block. ``context_expr`` is the " "context manager, often a :class:`Call` node. ``optional_vars`` is a :class:" @@ -865,11 +865,11 @@ msgstr "" "class:`Call` 節點。``Optional_vars`` 是 ``as foo`` 部分的 :class:`Name`、:" "class:`Tuple` 或 :class:`List`，或者如果不使用則為 ``None`` 。" -#: ../../library/ast.rst:1406 +#: ../../library/ast.rst:1408 msgid "Pattern matching" msgstr "模式匹配 (pattern matching)" -#: ../../library/ast.rst:1411 +#: ../../library/ast.rst:1413 msgid "" "A ``match`` statement. ``subject`` holds the subject of the match (the " "object that is being matched against the cases) and ``cases`` contains an " @@ -878,7 +878,7 @@ msgstr "" "一個 ``match`` 陳述式。``subject`` 保存匹配的主題（與案例匹配的物件），" "``cases`` 包含具有不同案例的 :class:`match_case` 節點的可疊代物件。" -#: ../../library/ast.rst:1419 +#: ../../library/ast.rst:1421 msgid "" "A single case pattern in a ``match`` statement. ``pattern`` contains the " "match pattern that the subject will be matched against. Note that the :class:" @@ -889,13 +889,13 @@ msgstr "" "請注意，為模式生成的 :class:`AST` 節點與為運算式生成的節點不同，即使它們共享" "相同的語法。" -#: ../../library/ast.rst:1424 +#: ../../library/ast.rst:1426 msgid "" "The ``guard`` attribute contains an expression that will be evaluated if the " "pattern matches the subject." msgstr "``guard`` 屬性包含一個運算式，如果模式與主題匹配，則將對該運算式求值。" -#: ../../library/ast.rst:1427 +#: ../../library/ast.rst:1429 msgid "" "``body`` contains a list of nodes to execute if the pattern matches and the " "result of evaluating the guard expression is true." @@ -903,7 +903,7 @@ msgstr "" "``body`` 包含一個節點串列，如果模式匹配並且為防護運算式 (guard expression) 的" "求值 (evaluate) 結果為真，則會執行該節點串列。" -#: ../../library/ast.rst:1472 +#: ../../library/ast.rst:1474 msgid "" "A match literal or value pattern that compares by equality. ``value`` is an " "expression node. Permitted value nodes are restricted as described in the " @@ -913,7 +913,7 @@ msgstr "" "以相等性進行比較的匹配文本或值的模式。``value`` 是一個運算式節點。允許值節點" "受到匹配陳述式文件中所述的限制。如果匹配主題等於求出值，則此模式成功。" -#: ../../library/ast.rst:1501 +#: ../../library/ast.rst:1503 msgid "" "A match literal pattern that compares by identity. ``value`` is the " "singleton to be compared against: ``None``, ``True``, or ``False``. This " @@ -923,7 +923,7 @@ msgstr "" "``True`` 或 ``False`` 進行比較的單例 (singleton)。如果匹配主題是給定的常數，" "則此模式成功。" -#: ../../library/ast.rst:1528 +#: ../../library/ast.rst:1530 msgid "" "A match sequence pattern. ``patterns`` contains the patterns to be matched " "against the subject elements if the subject is a sequence. Matches a " @@ -933,7 +933,7 @@ msgstr "" "匹配序列模式。如果主題是一個序列，``patterns`` 包含與主題元素匹配的模式。如果" "子模式之一是 ``MatchStar`` 節點，則匹配可變長度序列，否則匹配固定長度序列。" -#: ../../library/ast.rst:1561 +#: ../../library/ast.rst:1563 msgid "" "Matches the rest of the sequence in a variable length match sequence " "pattern. If ``name`` is not ``None``, a list containing the remaining " @@ -943,7 +943,7 @@ msgstr "" "以可變長度匹配序列模式匹配序列的其餘部分。如果 ``name`` 不是 ``None``，則如果" "整體序列模式成功，則包含其餘序列元素的串列將綁定到該名稱。" -#: ../../library/ast.rst:1603 +#: ../../library/ast.rst:1605 msgid "" "A match mapping pattern. ``keys`` is a sequence of expression nodes. " "``patterns`` is a corresponding sequence of pattern nodes. ``rest`` is an " @@ -955,7 +955,7 @@ msgstr "" "列。``rest`` 是一個可選名稱，可以指定它來捕獲剩餘的對映元素。允許的鍵運算式受" "到匹配陳述式文件中所述的限制。" -#: ../../library/ast.rst:1609 +#: ../../library/ast.rst:1611 msgid "" "This pattern succeeds if the subject is a mapping, all evaluated key " "expressions are present in the mapping, and the value corresponding to each " @@ -967,7 +967,7 @@ msgstr "" "應的子模式匹配，則此模式成功。如果 ``rest`` 不是 ``None``，則如果整體對映模式" "成功，則包含其餘對映元素的字典將綁定到該名稱。" -#: ../../library/ast.rst:1651 +#: ../../library/ast.rst:1653 msgid "" "A match class pattern. ``cls`` is an expression giving the nominal class to " "be matched. ``patterns`` is a sequence of pattern nodes to be matched " @@ -982,7 +982,7 @@ msgstr "" "``kwd_attrs`` 是要匹配的附加屬性序列（在類別模式中指定為關鍵字引數），" "``kwd_patterns`` 是相應的模式（在類別模式中指定為關鍵字的值）。" -#: ../../library/ast.rst:1658 +#: ../../library/ast.rst:1660 msgid "" "This pattern succeeds if the subject is an instance of the nominated class, " "all positional patterns match the corresponding class-defined attributes, " @@ -991,7 +991,7 @@ msgstr "" "如果主題是指定類別的實例，所有位置模式都與相應的類別定義屬性匹配，並且任何指" "定的關鍵字屬性與其相應模式匹配，則此模式成功。" -#: ../../library/ast.rst:1662 +#: ../../library/ast.rst:1664 msgid "" "Note: classes may define a property that returns self in order to match a " "pattern node against the instance being matched. Several builtin types are " @@ -1000,7 +1000,7 @@ msgstr "" "注意：類別可以定義一個回傳 self 的特性 (property)，以便將模式節點與正在匹配的" "實例進行匹配。一些內建型別也以這種方式匹配，如同匹配陳述式文件中所述。" -#: ../../library/ast.rst:1717 +#: ../../library/ast.rst:1719 msgid "" "A match \"as-pattern\", capture pattern or wildcard pattern. ``pattern`` " "contains the match pattern that the subject will be matched against. If the " @@ -1011,7 +1011,7 @@ msgstr "" "(wildcard pattern)。``pattern`` 包含主題將與之匹配的匹配模式。如果模式為 " "``None``，則該節點代表捕獲模式（即裸名 (bare name)）並且始終會成功。" -#: ../../library/ast.rst:1722 +#: ../../library/ast.rst:1724 msgid "" "The ``name`` attribute contains the name that will be bound if the pattern " "is successful. If ``name`` is ``None``, ``pattern`` must also be ``None`` " @@ -1020,7 +1020,7 @@ msgstr "" "``name`` 屬性包含模式成功時將綁定的名稱。如果 ``name`` 為 ``None``，則 " "``pattern`` 也必須為 ``None``，並且節點代表通配模式。" -#: ../../library/ast.rst:1760 +#: ../../library/ast.rst:1762 msgid "" "A match \"or-pattern\". An or-pattern matches each of its subpatterns in " "turn to the subject, until one succeeds. The or-pattern is then deemed to " @@ -1032,17 +1032,17 @@ msgstr "" "到成功為止，然後 or 模式就會被認為是成功的。如果沒有一個子模式成功，則 or 模" "式將失敗。 ``patterns`` 屬性包含將與主題進行匹配的匹配模式節點串列。" -#: ../../library/ast.rst:1795 +#: ../../library/ast.rst:1797 msgid "Type parameters" msgstr "型別參數 (type parameters)" -#: ../../library/ast.rst:1797 +#: ../../library/ast.rst:1799 msgid "" ":ref:`Type parameters ` can exist on classes, functions, and " "type aliases." msgstr ":ref:`型別參數 `\\ 可以存在於類別、函式和型別別名上。" -#: ../../library/ast.rst:1802 +#: ../../library/ast.rst:1804 msgid "" "A :class:`typing.TypeVar`. ``name`` is the name of the type variable. " "``bound`` is the bound or constraints, if any. If ``bound`` is a :class:" @@ -1052,39 +1052,39 @@ msgstr "" "存在的）界限 (bound) 或約束 (constraint)。如果 ``bound`` 是一個 :class:" "`Tuple`，它代表約束；否則它代表界限。" -#: ../../library/ast.rst:1827 +#: ../../library/ast.rst:1829 msgid "" "A :class:`typing.ParamSpec`. ``name`` is the name of the parameter " "specification." msgstr "A :class:`typing.ParamSpec`。``name`` 是參數規範的名稱。" -#: ../../library/ast.rst:1852 +#: ../../library/ast.rst:1854 msgid "" "A :class:`typing.TypeVarTuple`. ``name`` is the name of the type variable " "tuple." msgstr "一個 :class:`typing.TypeVarTuple`。``name`` 是型別變數元組的名稱。" -#: ../../library/ast.rst:1877 +#: ../../library/ast.rst:1879 msgid "Function and class definitions" msgstr "函式和類別定義" -#: ../../library/ast.rst:1881 +#: ../../library/ast.rst:1883 msgid "A function definition." msgstr "一個函式定義。" -#: ../../library/ast.rst:1883 +#: ../../library/ast.rst:1885 msgid "``name`` is a raw string of the function name." msgstr "``name`` 是函式名稱的原始字串。" -#: ../../library/ast.rst:1884 +#: ../../library/ast.rst:1886 msgid "``args`` is an :class:`arguments` node." msgstr "``args`` 是一個 :class:`arguments` 節點。" -#: ../../library/ast.rst:1885 +#: ../../library/ast.rst:1887 msgid "``body`` is the list of nodes inside the function." msgstr "``body`` 是函式內節點的串列。" -#: ../../library/ast.rst:1886 +#: ../../library/ast.rst:1888 msgid "" "``decorator_list`` is the list of decorators to be applied, stored outermost " "first (i.e. the first in the list will be applied last)." @@ -1092,20 +1092,20 @@ msgstr "" "``decorator_list`` 是要應用的裝飾器串列，在最外層者會被儲存在首位（即串列中首" "位將會是最後一個被應用的那個）。" -#: ../../library/ast.rst:1888 +#: ../../library/ast.rst:1890 msgid "``returns`` is the return annotation." msgstr "``returns`` 是回傳註釋。" -#: ../../library/ast.rst:1889 ../../library/ast.rst:2066 +#: ../../library/ast.rst:1891 ../../library/ast.rst:2068 msgid "``type_params`` is a list of :ref:`type parameters `." msgstr "``type_params`` 是\\ :ref:`型別參數 `\\ 的串列。" -#: ../../library/ast.rst:1895 ../../library/ast.rst:2095 -#: ../../library/ast.rst:2106 +#: ../../library/ast.rst:1897 ../../library/ast.rst:2097 +#: ../../library/ast.rst:2108 msgid "Added ``type_params``." msgstr "新增了 ``type_params``。" -#: ../../library/ast.rst:1901 +#: ../../library/ast.rst:1903 msgid "" "``lambda`` is a minimal function definition that can be used inside an " "expression. Unlike :class:`FunctionDef`, ``body`` holds a single node." @@ -1113,17 +1113,17 @@ msgstr "" "``lambda`` 是可以在運算式內使用的最小函式定義。與 :class:`FunctionDef` 不同，" "``body`` 保存單個節點。" -#: ../../library/ast.rst:1925 +#: ../../library/ast.rst:1927 msgid "The arguments for a function." msgstr "函式的引數。" -#: ../../library/ast.rst:1927 +#: ../../library/ast.rst:1929 msgid "" "``posonlyargs``, ``args`` and ``kwonlyargs`` are lists of :class:`arg` nodes." msgstr "" "``posonlyargs``、``args`` 和 ``kwonlyargs`` 是 :class:`arg` 節點的串列。" -#: ../../library/ast.rst:1928 +#: ../../library/ast.rst:1930 msgid "" "``vararg`` and ``kwarg`` are single :class:`arg` nodes, referring to the " "``*args, **kwargs`` parameters." @@ -1131,7 +1131,7 @@ msgstr "" "``vararg`` 和 ``kwarg`` 是單個 :class:`arg` 節點，指的是 ``*args, **kwargs`` " "參數。" -#: ../../library/ast.rst:1930 +#: ../../library/ast.rst:1932 msgid "" "``kw_defaults`` is a list of default values for keyword-only arguments. If " "one is ``None``, the corresponding argument is required." @@ -1139,7 +1139,7 @@ msgstr "" "``kw_defaults`` 是僅限關鍵字引數的預設值串列。如果其中某個為 ``None``，則相應" "參數就會是必要的。" -#: ../../library/ast.rst:1932 +#: ../../library/ast.rst:1934 msgid "" "``defaults`` is a list of default values for arguments that can be passed " "positionally. If there are fewer defaults, they correspond to the last n " @@ -1148,7 +1148,7 @@ msgstr "" "``defaults`` 是可以按位置傳遞的引數的預設值串列。如果預設值較少，則它們對應於" "最後 n 個引數。" -#: ../../library/ast.rst:1939 +#: ../../library/ast.rst:1941 msgid "" "A single argument in a list. ``arg`` is a raw string of the argument name; " "``annotation`` is its annotation, such as a :class:`Name` node." @@ -1156,16 +1156,16 @@ msgstr "" "串列中的單個引數。``arg`` 是引數名稱的原始字串，``annotation`` 是它的註釋，例" "如 :class:`Name` 節點。" -#: ../../library/ast.rst:1944 +#: ../../library/ast.rst:1946 msgid "" "``type_comment`` is an optional string with the type annotation as a comment" msgstr "``type_comment`` 是一個可選字串，其註解為型別註釋" -#: ../../library/ast.rst:1989 +#: ../../library/ast.rst:1991 msgid "A ``return`` statement." msgstr "一個 ``return`` 陳述式。" -#: ../../library/ast.rst:2004 +#: ../../library/ast.rst:2006 #, fuzzy msgid "" "A ``yield`` or ``yield from`` expression. Because these are expressions, " @@ -1175,24 +1175,24 @@ msgstr "" "一個 ``yield`` 或 ``yield from`` 運算式。因為這些是運算式，所以如果不使用發送" "回來的值，則必須將它們包裝在 :class:`Expr` 節點中。" -#: ../../library/ast.rst:2029 +#: ../../library/ast.rst:2031 msgid "" "``global`` and ``nonlocal`` statements. ``names`` is a list of raw strings." msgstr "``global`` 和 ``nonlocal`` 陳述式。``names`` 是原始字串的串列。" -#: ../../library/ast.rst:2056 +#: ../../library/ast.rst:2058 msgid "A class definition." msgstr "一個類別定義。" -#: ../../library/ast.rst:2058 +#: ../../library/ast.rst:2060 msgid "``name`` is a raw string for the class name" msgstr "``name`` 是類別名的原始字串" -#: ../../library/ast.rst:2059 +#: ../../library/ast.rst:2061 msgid "``bases`` is a list of nodes for explicitly specified base classes." msgstr "``bases`` 是被顯式指定的基底類別節點串列。" -#: ../../library/ast.rst:2060 +#: ../../library/ast.rst:2062 msgid "" "``keywords`` is a list of :class:`.keyword` nodes, principally for " "'metaclass'. Other keywords will be passed to the metaclass, as per " @@ -1202,27 +1202,27 @@ msgstr "" "別）。如 `PEP-3115 `_ 所述，其他關鍵字將被" "傳遞到 metaclass。" -#: ../../library/ast.rst:2063 +#: ../../library/ast.rst:2065 msgid "" "``body`` is a list of nodes representing the code within the class " "definition." msgstr "``body`` 是表示類別定義中程式碼的節點串列。" -#: ../../library/ast.rst:2065 +#: ../../library/ast.rst:2067 msgid "``decorator_list`` is a list of nodes, as in :class:`FunctionDef`." msgstr "``decorator_list`` 是一個節點串列，如 :class:`FunctionDef` 中所示。" -#: ../../library/ast.rst:2099 +#: ../../library/ast.rst:2101 msgid "Async and await" msgstr "async 和 await" -#: ../../library/ast.rst:2103 +#: ../../library/ast.rst:2105 msgid "" "An ``async def`` function definition. Has the same fields as :class:" "`FunctionDef`." msgstr "一個 ``async def`` 函式定義。與 :class:`FunctionDef` 具有相同的欄位。" -#: ../../library/ast.rst:2112 +#: ../../library/ast.rst:2114 msgid "" "An ``await`` expression. ``value`` is what it waits for. Only valid in the " "body of an :class:`AsyncFunctionDef`." @@ -1230,7 +1230,7 @@ msgstr "" "一個 ``await`` 運算式。``value`` 是它等待的東西。僅在 :class:" "`AsyncFunctionDef` 主體 (body) 中有效。" -#: ../../library/ast.rst:2146 +#: ../../library/ast.rst:2148 msgid "" "``async for`` loops and ``async with`` context managers. They have the same " "fields as :class:`For` and :class:`With`, respectively. Only valid in the " @@ -1239,7 +1239,7 @@ msgstr "" "``async for`` 迴圈和 ``async with`` 情境管理器。它們分別具有與 :class:`For` " "和 :class:`With` 相同的欄位。僅在 :class:`AsyncFunctionDef` 主體中有效。" -#: ../../library/ast.rst:2151 +#: ../../library/ast.rst:2153 msgid "" "When a string is parsed by :func:`ast.parse`, operator nodes (subclasses of :" "class:`ast.operator`, :class:`ast.unaryop`, :class:`ast.cmpop`, :class:`ast." @@ -1252,11 +1252,11 @@ msgstr "" "boolop` 和 :class:`ast.expr_context`\\ ）將是單例。對其中之一的更改將反映在所" "有其他出現的相同值中（例如 :class:`ast.Add`\\ ）。" -#: ../../library/ast.rst:2159 +#: ../../library/ast.rst:2161 msgid ":mod:`ast` Helpers" msgstr ":mod:`ast` 輔助程式" -#: ../../library/ast.rst:2161 +#: ../../library/ast.rst:2163 msgid "" "Apart from the node classes, the :mod:`ast` module defines these utility " "functions and classes for traversing abstract syntax trees:" @@ -1264,7 +1264,7 @@ msgstr "" "除了節點類別之外，:mod:`ast` 模組還定義了這些用於遍歷 (traverse) 抽象語法樹的" "實用函式和類別：" -#: ../../library/ast.rst:2166 +#: ../../library/ast.rst:2168 msgid "" "Parse the source into an AST node. Equivalent to ``compile(source, " "filename, mode, ast.PyCF_ONLY_AST)``." @@ -1272,7 +1272,7 @@ msgstr "" "將原始碼剖析為 AST 節點。相當於 ``compile(source, filename, mode, ast." "PyCF_ONLY_AST)``。" -#: ../../library/ast.rst:2169 +#: ../../library/ast.rst:2171 msgid "" "If ``type_comments=True`` is given, the parser is modified to check and " "return type comments as specified by :pep:`484` and :pep:`526`. This is " @@ -1291,7 +1291,7 @@ msgstr "" "``None``。此外，``# type: ignore`` 註釋的位置將作為 :class:`Module` 的 " "``type_ignores`` 屬性回傳（否則它始終是一個空串列）。" -#: ../../library/ast.rst:2179 +#: ../../library/ast.rst:2181 msgid "" "In addition, if ``mode`` is ``'func_type'``, the input syntax is modified to " "correspond to :pep:`484` \"signature type comments\", e.g. ``(str, int) -> " @@ -1301,7 +1301,7 @@ msgstr "" "名型別註解 (signature type comments)」而被修改，例如 ``(str, int) -> " "List[str]``。" -#: ../../library/ast.rst:2183 +#: ../../library/ast.rst:2185 msgid "" "Setting ``feature_version`` to a tuple ``(major, minor)`` will result in a " "\"best-effort\" attempt to parse using that Python version's grammar. For " @@ -1321,12 +1321,12 @@ msgstr "" "能保證剖析（或剖析的成功）與在與 ``feature_version`` 對應的 Python 版本上運行" "時相同。" -#: ../../library/ast.rst:2193 +#: ../../library/ast.rst:2195 msgid "" "If source contains a null character (``\\0``), :exc:`ValueError` is raised." msgstr "如果來源包含 null 字元 (``\\0``)，則會引發 :exc:`ValueError`。" -#: ../../library/ast.rst:2196 +#: ../../library/ast.rst:2198 msgid "" "Note that successfully parsing source code into an AST object doesn't " "guarantee that the source code provided is valid Python code that can be " @@ -1340,14 +1340,14 @@ msgstr "" "原始的 ``return 42`` 為 return 陳述式生成一個有效的 AST 節點，但它不能單獨編" "譯（它需要位於函式節點內）。" -#: ../../library/ast.rst:2203 +#: ../../library/ast.rst:2205 msgid "" "In particular, :func:`ast.parse` won't do any scoping checks, which the " "compilation step does." msgstr "" "特別是 :func:`ast.parse` 不會執行任何範圍檢查，而編譯步驟才會執行此操作。" -#: ../../library/ast.rst:2207 +#: ../../library/ast.rst:2209 msgid "" "It is possible to crash the Python interpreter with a sufficiently large/" "complex string due to stack depth limitations in Python's AST compiler." @@ -1355,11 +1355,11 @@ msgstr "" "由於 Python AST 編譯器中的堆疊 (stack) 深度限制，太大或太複雜的字串可能會導" "致 Python 直譯器崩潰。" -#: ../../library/ast.rst:2211 +#: ../../library/ast.rst:2213 msgid "Added ``type_comments``, ``mode='func_type'`` and ``feature_version``." msgstr "新增 ``type_comments``、``mode='func_type'`` 與 ``feature_version``。" -#: ../../library/ast.rst:2217 +#: ../../library/ast.rst:2219 msgid "" "Unparse an :class:`ast.AST` object and generate a string with code that " "would produce an equivalent :class:`ast.AST` object if parsed back with :" @@ -1368,7 +1368,7 @@ msgstr "" "反剖析 :class:`ast.AST` 物件並生成一個帶有程式碼的字串，如果使用 :func:`ast." "parse` 剖析回來，該程式碼將生成等效的 :class:`ast.AST` 物件。" -#: ../../library/ast.rst:2222 +#: ../../library/ast.rst:2224 msgid "" "The produced code string will not necessarily be equal to the original code " "that generated the :class:`ast.AST` object (without any compiler " @@ -1377,13 +1377,13 @@ msgstr "" "生成的程式碼字串不一定等於生成 :class:`ast.AST` 物件的原始程式碼（沒有任何編" "譯器最佳化，例如常數元組/凍結集合）。" -#: ../../library/ast.rst:2227 +#: ../../library/ast.rst:2229 msgid "" "Trying to unparse a highly complex expression would result with :exc:" "`RecursionError`." msgstr "嘗試剖析高度複雜的運算式會導致 :exc:`RecursionError`。" -#: ../../library/ast.rst:2235 +#: ../../library/ast.rst:2237 msgid "" "Evaluate an expression node or a string containing only a Python literal or " "container display. The string or node provided may only consist of the " @@ -1394,7 +1394,7 @@ msgstr "" "能包含以下 Python 文本結構：字串、位元組、數字、元組、串列、字典、集合、布林" "值、``None`` 和 ``Ellipsis``。" -#: ../../library/ast.rst:2240 +#: ../../library/ast.rst:2242 msgid "" "This can be used for evaluating strings containing Python values without the " "need to parse the values oneself. It is not capable of evaluating " @@ -1403,7 +1403,7 @@ msgstr "" "這可用於為包含 Python 值的字串求值，而無需自己剖析這些值。它無法計算任意複雜" "的運算式，例如涉及運算子或索引。" -#: ../../library/ast.rst:2245 +#: ../../library/ast.rst:2247 msgid "" "This function had been documented as \"safe\" in the past without defining " "what that meant. That was misleading. This is specifically designed not to " @@ -1420,13 +1420,13 @@ msgstr "" "盡或 C 堆疊耗盡，從而導致行程崩潰。某些輸入也可能會出現 CPU 消耗過多而導致拒" "絕服務的情況。因此不建議在不受信任的資料上呼叫它。" -#: ../../library/ast.rst:2255 +#: ../../library/ast.rst:2257 msgid "" "It is possible to crash the Python interpreter due to stack depth " "limitations in Python's AST compiler." msgstr "由於 Python AST 編譯器的堆疊深度限制，Python 直譯器可能會崩潰。" -#: ../../library/ast.rst:2258 +#: ../../library/ast.rst:2260 msgid "" "It can raise :exc:`ValueError`, :exc:`TypeError`, :exc:`SyntaxError`, :exc:" "`MemoryError` and :exc:`RecursionError` depending on the malformed input." @@ -1434,19 +1434,19 @@ msgstr "" "它可能會引發 :exc:`ValueError`、:exc:`TypeError`、:exc:`SyntaxError`、:exc:" "`MemoryError` 和 :exc:`RecursionError`，具體取決於格式錯誤的輸入。" -#: ../../library/ast.rst:2262 +#: ../../library/ast.rst:2264 msgid "Now allows bytes and set literals." msgstr "現在允許位元組和集合文本 (set literal)。" -#: ../../library/ast.rst:2265 +#: ../../library/ast.rst:2267 msgid "Now supports creating empty sets with ``'set()'``." msgstr "現在支援使用 ``'set()'`` 建立空集合。" -#: ../../library/ast.rst:2268 +#: ../../library/ast.rst:2270 msgid "For string inputs, leading spaces and tabs are now stripped." msgstr "對於字串輸入，前導空格和定位字元 (tab) 現在已被去除。" -#: ../../library/ast.rst:2274 +#: ../../library/ast.rst:2276 msgid "" "Return the docstring of the given *node* (which must be a :class:" "`FunctionDef`, :class:`AsyncFunctionDef`, :class:`ClassDef`, or :class:" @@ -1458,11 +1458,11 @@ msgstr "" "件字串則為 ``None``。如果 *clean* 為 true，則使用 :func:`inspect.cleandoc` 清" "理文件字串的縮排。" -#: ../../library/ast.rst:2280 +#: ../../library/ast.rst:2282 msgid ":class:`AsyncFunctionDef` is now supported." msgstr "目前已支援 :class:`AsyncFunctionDef`。" -#: ../../library/ast.rst:2286 +#: ../../library/ast.rst:2288 msgid "" "Get source code segment of the *source* that generated *node*. If some " "location information (:attr:`~ast.AST.lineno`, :attr:`~ast.AST.end_lineno`, :" @@ -1473,7 +1473,7 @@ msgstr "" "lineno`、:attr:`~ast.AST.end_lineno`、:attr:`~ast.AST.col_offset` 或 :attr:" "`~ast.AST.end_col_offset`\\ ）遺漏，則回傳 ``None``。" -#: ../../library/ast.rst:2290 +#: ../../library/ast.rst:2292 msgid "" "If *padded* is ``True``, the first line of a multi-line statement will be " "padded with spaces to match its original position." @@ -1481,7 +1481,7 @@ msgstr "" "如果 *padded* 為 ``True``，則多列陳述式的第一列將用空格填充 (padded) 以匹配其" "原始位置。" -#: ../../library/ast.rst:2298 +#: ../../library/ast.rst:2300 msgid "" "When you compile a node tree with :func:`compile`, the compiler expects :" "attr:`~ast.AST.lineno` and :attr:`~ast.AST.col_offset` attributes for every " @@ -1495,7 +1495,7 @@ msgstr "" "要存在。填入生成的節點相當繁瑣，因此該輔助工具透過將這些屬性設定為父節點的" "值，在尚未設定的地方遞迴地新增這些屬性。它從 *node* 開始遞迴地作用。" -#: ../../library/ast.rst:2307 +#: ../../library/ast.rst:2309 msgid "" "Increment the line number and end line number of each node in the tree " "starting at *node* by *n*. This is useful to \"move code\" to a different " @@ -1504,7 +1504,7 @@ msgstr "" "將樹中從 *node* 開始的每個節點的列號和結束列號增加 *n*。這對於「移動程式碼」" "到檔案中的不同位置很有用。" -#: ../../library/ast.rst:2314 +#: ../../library/ast.rst:2316 msgid "" "Copy source location (:attr:`~ast.AST.lineno`, :attr:`~ast.AST.col_offset`, :" "attr:`~ast.AST.end_lineno`, and :attr:`~ast.AST.end_col_offset`) from " @@ -1514,7 +1514,7 @@ msgstr "" "attr:`~ast.AST.end_lineno` 和 :attr:`~ast.AST.end_col_offset` ）從 " "*old_node* 複製到 *new_node*，並回傳 *new_node* 。" -#: ../../library/ast.rst:2321 +#: ../../library/ast.rst:2323 msgid "" "Yield a tuple of ``(fieldname, value)`` for each field in ``node._fields`` " "that is present on *node*." @@ -1522,7 +1522,7 @@ msgstr "" "為 *node* 上存在的 ``node._fields`` 中的每個欄位生成一個 ``(fieldname, " "value)`` 元組。" -#: ../../library/ast.rst:2327 +#: ../../library/ast.rst:2329 msgid "" "Yield all direct child nodes of *node*, that is, all fields that are nodes " "and all items of fields that are lists of nodes." @@ -1530,7 +1530,7 @@ msgstr "" "生成 *node* 的所有直接子節點，即作為節點的所有欄位以及作為節點串列欄位的所有" "項目。" -#: ../../library/ast.rst:2333 +#: ../../library/ast.rst:2335 msgid "" "Recursively yield all descendant nodes in the tree starting at *node* " "(including *node* itself), in no specified order. This is useful if you " @@ -1539,7 +1539,7 @@ msgstr "" "遞迴地生成樹中從 *node* 開始的所有後代節點（包括 *node* 本身），不按指定順" "序。如果你只想就地修改節點而不關心情境，這非常有用。" -#: ../../library/ast.rst:2340 +#: ../../library/ast.rst:2342 msgid "" "A node visitor base class that walks the abstract syntax tree and calls a " "visitor function for every node found. This function may return a value " @@ -1548,13 +1548,13 @@ msgstr "" "節點訪問者基底類別，它遍歷抽象語法樹並為找到的每個節點呼叫訪問者函式。該函式" "可能會回傳一個由 :meth:`visit` 方法轉發的值。" -#: ../../library/ast.rst:2344 +#: ../../library/ast.rst:2346 msgid "" "This class is meant to be subclassed, with the subclass adding visitor " "methods." msgstr "這個類別應該被子類別化，子類別新增訪問者方法。" -#: ../../library/ast.rst:2349 +#: ../../library/ast.rst:2351 msgid "" "Visit a node. The default implementation calls the method called :samp:" "`self.visit_{classname}` where *classname* is the name of the node class, " @@ -1564,11 +1564,11 @@ msgstr "" "*classname* 是節點類別的名稱，或者在該方法不存在時呼叫 :meth:" "`generic_visit`。" -#: ../../library/ast.rst:2355 +#: ../../library/ast.rst:2357 msgid "This visitor calls :meth:`visit` on all children of the node." msgstr "該訪問者對該節點的所有子節點呼叫 :meth:`visit`。" -#: ../../library/ast.rst:2357 +#: ../../library/ast.rst:2359 msgid "" "Note that child nodes of nodes that have a custom visitor method won't be " "visited unless the visitor calls :meth:`generic_visit` or visits them itself." @@ -1576,11 +1576,11 @@ msgstr "" "請注意，除非訪問者呼叫 :meth:`generic_visit` 或訪問它們本身，否則不會訪問具有" "自定義訪問者方法的節點之子節點。" -#: ../../library/ast.rst:2363 +#: ../../library/ast.rst:2365 msgid "Handles all constant nodes." msgstr "處理所有常數節點。" -#: ../../library/ast.rst:2365 +#: ../../library/ast.rst:2367 msgid "" "Don't use the :class:`NodeVisitor` if you want to apply changes to nodes " "during traversal. For this a special visitor exists (:class:" @@ -1590,7 +1590,7 @@ msgstr "" "`NodeVisitor`。為此，有個允許修改的特殊遍歷訪問者工具 :class:" "`NodeTransformer`。" -#: ../../library/ast.rst:2371 +#: ../../library/ast.rst:2373 msgid "" "Methods :meth:`!visit_Num`, :meth:`!visit_Str`, :meth:`!visit_Bytes`, :meth:" "`!visit_NameConstant` and :meth:`!visit_Ellipsis` are deprecated now and " @@ -1601,13 +1601,13 @@ msgstr "" "visit_NameConstant` 和 :meth:`!visit_Ellipsis` 方法現已棄用，並且不會在未來的" "Python 版本中被呼叫。新增 :meth:`visit_Constant` 方法來處理所有常數節點。" -#: ../../library/ast.rst:2379 +#: ../../library/ast.rst:2381 msgid "" "A :class:`NodeVisitor` subclass that walks the abstract syntax tree and " "allows modification of nodes." msgstr "一個 :class:`NodeVisitor` 子類別，它會遍歷抽象語法樹並允許修改節點。" -#: ../../library/ast.rst:2382 +#: ../../library/ast.rst:2384 msgid "" "The :class:`NodeTransformer` will walk the AST and use the return value of " "the visitor methods to replace or remove the old node. If the return value " @@ -1619,7 +1619,7 @@ msgstr "" "點。如果訪問者方法的回傳值為 ``None``，則該節點將從其位置中刪除，否則將被替換" "為回傳值。回傳值可能是原始節點，在這種情況下不會發生替換。" -#: ../../library/ast.rst:2388 +#: ../../library/ast.rst:2390 msgid "" "Here is an example transformer that rewrites all occurrences of name lookups " "(``foo``) to ``data['foo']``::" @@ -1627,7 +1627,7 @@ msgstr "" "下面是一個示範用的 transformer，它將查找所有出現名稱 (``foo``) 並改寫為 " "``data['foo']``： ::" -#: ../../library/ast.rst:2400 +#: ../../library/ast.rst:2402 msgid "" "Keep in mind that if the node you're operating on has child nodes you must " "either transform the child nodes yourself or call the :meth:`~ast." @@ -1636,7 +1636,7 @@ msgstr "" "請記住，如果你正在操作的節點有子節點，你必須自己轉換子節點或先呼叫該節點的 :" "meth:`~ast.NodeVisitor.generic_visit` 方法。" -#: ../../library/ast.rst:2404 +#: ../../library/ast.rst:2406 msgid "" "For nodes that were part of a collection of statements (that applies to all " "statement nodes), the visitor may also return a list of nodes rather than " @@ -1645,7 +1645,7 @@ msgstr "" "對於屬於陳述式總集 (collection) 一部分的節點（適用於所有陳述式節點），訪問者" "還可以回傳節點串列，而不僅僅是單個節點。" -#: ../../library/ast.rst:2408 +#: ../../library/ast.rst:2410 msgid "" "If :class:`NodeTransformer` introduces new nodes (that weren't part of " "original tree) without giving them location information (such as :attr:`~ast." @@ -1656,11 +1656,11 @@ msgstr "" "它們提供位置資訊（例如 :attr:`~ast.AST.lineno`\\ ），則應使用新的子樹呼叫 :" "func:`fix_missing_locations` 以重新計算位置資訊： ::" -#: ../../library/ast.rst:2416 +#: ../../library/ast.rst:2418 msgid "Usually you use the transformer like this::" msgstr "你通常會像這樣使用 transformer： ::" -#: ../../library/ast.rst:2423 +#: ../../library/ast.rst:2425 msgid "" "Return a formatted dump of the tree in *node*. This is mainly useful for " "debugging purposes. If *annotate_fields* is true (by default), the returned " @@ -1676,7 +1676,7 @@ msgstr "" "潔。預設情況下，不會傾印列號和行偏移量等屬性。如果需要，可以設定 " "*include_attributes* 為 true。" -#: ../../library/ast.rst:2431 +#: ../../library/ast.rst:2433 msgid "" "If *indent* is a non-negative integer or string, then the tree will be " "pretty-printed with that indent level. An indent level of 0, negative, or " @@ -1690,21 +1690,21 @@ msgstr "" "（預設值）代表選擇單列表示。使用正整數縮排可以在每個級別縮排相同數量的空格。" "如果 *indent* 是一個字串（例如 ``\"\\t\"``\\ ），則該字串用於縮排每個級別。" -#: ../../library/ast.rst:2438 +#: ../../library/ast.rst:2440 msgid "Added the *indent* option." msgstr "新增 *indent* 選項。" -#: ../../library/ast.rst:2445 +#: ../../library/ast.rst:2447 msgid "Compiler Flags" msgstr "編譯器旗標" -#: ../../library/ast.rst:2447 +#: ../../library/ast.rst:2449 msgid "" "The following flags may be passed to :func:`compile` in order to change " "effects on the compilation of a program:" msgstr "可以將以下旗標傳遞給 :func:`compile` 以變更對程式的編譯效果：" -#: ../../library/ast.rst:2452 +#: ../../library/ast.rst:2454 msgid "" "Enables support for top-level ``await``, ``async for``, ``async with`` and " "async comprehensions." @@ -1712,13 +1712,13 @@ msgstr "" "啟用對最高階 ``await``、``async for``、``async with`` 和非同步綜合運算的支" "援。" -#: ../../library/ast.rst:2459 +#: ../../library/ast.rst:2461 msgid "" "Generates and returns an abstract syntax tree instead of returning a " "compiled code object." msgstr "生成並回傳抽象語法樹，而不是回傳已編譯的程式碼物件。" -#: ../../library/ast.rst:2464 +#: ../../library/ast.rst:2466 msgid "" "Enables support for :pep:`484` and :pep:`526` style type comments (``# type: " "``, ``# type: ignore ``)." @@ -1726,43 +1726,43 @@ msgstr "" "啟用對 :pep:`484` 和 :pep:`526` 樣式型別註釋的支援 (``# type: ``, ``# " "type: ignore ``)。" -#: ../../library/ast.rst:2473 +#: ../../library/ast.rst:2475 msgid "Command-Line Usage" msgstr "命令列用法" -#: ../../library/ast.rst:2477 +#: ../../library/ast.rst:2479 msgid "" "The :mod:`ast` module can be executed as a script from the command line. It " "is as simple as:" msgstr ":mod:`ast` 模組可以作為腳本從命令列執行，可以像這樣簡單地做到：" -#: ../../library/ast.rst:2484 +#: ../../library/ast.rst:2486 msgid "The following options are accepted:" msgstr "以下選項可被接受：" -#: ../../library/ast.rst:2490 +#: ../../library/ast.rst:2492 msgid "Show the help message and exit." msgstr "顯示幫助訊息並退出。" -#: ../../library/ast.rst:2495 +#: ../../library/ast.rst:2497 msgid "" "Specify what kind of code must be compiled, like the *mode* argument in :" "func:`parse`." msgstr "指定必須編譯哪種類型的程式碼，像是 :func:`parse` 中的 *mode* 引數。" -#: ../../library/ast.rst:2500 +#: ../../library/ast.rst:2502 msgid "Don't parse type comments." msgstr "不要剖析型別註解。" -#: ../../library/ast.rst:2504 +#: ../../library/ast.rst:2506 msgid "Include attributes such as line numbers and column offsets." msgstr "包括列號和行偏移量等屬性。" -#: ../../library/ast.rst:2509 +#: ../../library/ast.rst:2511 msgid "Indentation of nodes in AST (number of spaces)." msgstr "AST 中節點的縮進（空格數）。" -#: ../../library/ast.rst:2511 +#: ../../library/ast.rst:2513 msgid "" "If :file:`infile` is specified its contents are parsed to AST and dumped to " "stdout. Otherwise, the content is read from stdin." @@ -1770,7 +1770,7 @@ msgstr "" "如果指定了 :file:`infile`，則其內容將被剖析為 AST 並傾印 (dump) 到 stdout。否" "則會從 stdin 讀取內容。" -#: ../../library/ast.rst:2517 +#: ../../library/ast.rst:2519 msgid "" "`Green Tree Snakes `_, an external " "documentation resource, has good details on working with Python ASTs." @@ -1778,7 +1778,7 @@ msgstr "" "`Green Tree Snakes `_ 是一個外部文件" "資源，提供了有關使用 Python AST 的詳細資訊。" -#: ../../library/ast.rst:2520 +#: ../../library/ast.rst:2522 msgid "" "`ASTTokens `_ " "annotates Python ASTs with the positions of tokens and text in the source " @@ -1789,7 +1789,7 @@ msgstr "" "用生成它們的原始碼中的標記和文本的位置來註釋 Python AST。這對於進行原始碼轉換" "的工具很有幫助。" -#: ../../library/ast.rst:2525 +#: ../../library/ast.rst:2527 msgid "" "`leoAst.py `_ unifies the token-based and parse-tree-based views of python programs " @@ -1799,7 +1799,7 @@ msgstr "" "py>`_ 透過在 token 和 ast 節點之間插入雙向鏈結，統一了 python 程式的基於 " "token 和基於剖析樹的視圖。" -#: ../../library/ast.rst:2530 +#: ../../library/ast.rst:2532 msgid "" "`LibCST `_ parses code as a Concrete Syntax " "Tree that looks like an ast tree and keeps all formatting details. It's " @@ -1809,7 +1809,7 @@ msgstr "" "(Concrete Syntax Tree)，看起來像 ast 樹並保留所有格式詳細資訊。它對於建置自動" "重構 (codemod) 應用程式和 linter 非常有用。" -#: ../../library/ast.rst:2535 +#: ../../library/ast.rst:2537 msgid "" "`Parso `_ is a Python parser that supports " "error recovery and round-trip parsing for different Python versions (in " diff --git a/library/pathlib.po b/library/pathlib.po index 984276fcac..b003d7b0d7 100644 --- a/library/pathlib.po +++ b/library/pathlib.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-23 00:04+0000\n" +"POT-Creation-Date: 2024-07-28 00:03+0000\n" "PO-Revision-Date: 2024-02-29 20:49+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1444,264 +1444,314 @@ msgstr "" "以下是一張表格，對應許多 :mod:`os` 函式及其相符於 :class:`PurePath`/:class:" "`Path` 的項目。" -#: ../../library/pathlib.rst:1532 -msgid "" -"Not all pairs of functions/methods below are equivalent. Some of them, " -"despite having some overlapping use-cases, have different semantics. They " -"include :func:`os.path.abspath` and :meth:`Path.absolute`, :func:`os.path." -"relpath` and :meth:`PurePath.relative_to`." -msgstr "" -"不是以下所有一對的函式/方法都相等。其中有一些儘管有重疊的使用情境但有不同的語" -"意。它們包含 :func:`os.path.abspath` 和 :meth:`Path.absolute`、:func:`os." -"path.relpath` 和 :meth:`PurePath.relative_to`。" - -#: ../../library/pathlib.rst:1538 +#: ../../library/pathlib.rst:1531 msgid ":mod:`os` and :mod:`os.path`" msgstr ":mod:`os` 和 :mod:`os.path`" -#: ../../library/pathlib.rst:1538 +#: ../../library/pathlib.rst:1531 msgid ":mod:`pathlib`" msgstr ":mod:`pathlib`" -#: ../../library/pathlib.rst:1540 -msgid ":func:`os.path.abspath`" -msgstr ":func:`os.path.abspath`" +#: ../../library/pathlib.rst:1533 +msgid ":func:`os.path.dirname`" +msgstr ":func:`os.path.dirname`" -#: ../../library/pathlib.rst:1540 -msgid ":meth:`Path.absolute` [#]_" +#: ../../library/pathlib.rst:1533 +msgid ":attr:`PurePath.parent`" +msgstr ":attr:`PurePath.parent`" + +#: ../../library/pathlib.rst:1534 +msgid ":func:`os.path.basename`" +msgstr ":func:`os.path.basename`" + +#: ../../library/pathlib.rst:1534 +msgid ":attr:`PurePath.name`" +msgstr ":attr:`PurePath.name`" + +#: ../../library/pathlib.rst:1535 +msgid ":func:`os.path.splitext`" +msgstr ":func:`os.path.splitext`" + +#: ../../library/pathlib.rst:1535 +#, fuzzy +msgid ":attr:`PurePath.stem`, :attr:`PurePath.suffix`" +msgstr ":attr:`PurePath.stem` 和 :attr:`PurePath.suffix`" + +#: ../../library/pathlib.rst:1536 +msgid ":func:`os.path.join`" +msgstr ":func:`os.path.join`" + +#: ../../library/pathlib.rst:1536 +#, fuzzy +msgid ":meth:`PurePath.joinpath`" +msgstr ":func:`PurePath.joinpath`" + +#: ../../library/pathlib.rst:1537 +msgid ":func:`os.path.isabs`" +msgstr ":func:`os.path.isabs`" + +#: ../../library/pathlib.rst:1537 +msgid ":meth:`PurePath.is_absolute`" +msgstr ":meth:`PurePath.is_absolute`" + +#: ../../library/pathlib.rst:1538 +msgid ":func:`os.path.relpath`" +msgstr ":func:`os.path.relpath`" + +#: ../../library/pathlib.rst:1538 +#, fuzzy +msgid ":meth:`PurePath.relative_to` [1]_" +msgstr ":meth:`PurePath.relative_to` [#]_" + +#: ../../library/pathlib.rst:1539 +msgid ":func:`os.path.expanduser`" +msgstr ":func:`os.path.expanduser`" + +#: ../../library/pathlib.rst:1539 +#, fuzzy +msgid ":meth:`Path.expanduser` [2]_" msgstr ":meth:`Path.absolute` [#]_" -#: ../../library/pathlib.rst:1541 +#: ../../library/pathlib.rst:1540 msgid ":func:`os.path.realpath`" msgstr ":func:`os.path.realpath`" -#: ../../library/pathlib.rst:1541 +#: ../../library/pathlib.rst:1540 msgid ":meth:`Path.resolve`" msgstr ":meth:`Path.resolve`" +#: ../../library/pathlib.rst:1541 +msgid ":func:`os.path.abspath`" +msgstr ":func:`os.path.abspath`" + +#: ../../library/pathlib.rst:1541 +#, fuzzy +msgid ":meth:`Path.absolute` [3]_" +msgstr ":meth:`Path.absolute` [#]_" + #: ../../library/pathlib.rst:1542 -msgid ":func:`os.chmod`" -msgstr ":func:`os.chmod`" +msgid ":func:`os.path.exists`" +msgstr ":func:`os.path.exists`" #: ../../library/pathlib.rst:1542 -msgid ":meth:`Path.chmod`" -msgstr ":meth:`Path.chmod`" +msgid ":meth:`Path.exists`" +msgstr ":meth:`Path.exists`" + +#: ../../library/pathlib.rst:1543 +msgid ":func:`os.path.isfile`" +msgstr ":func:`os.path.isfile`" #: ../../library/pathlib.rst:1543 -msgid ":func:`os.mkdir`" -msgstr ":func:`os.mkdir`" +msgid ":meth:`Path.is_file`" +msgstr ":meth:`Path.is_file`" -#: ../../library/pathlib.rst:1543 ../../library/pathlib.rst:1544 -msgid ":meth:`Path.mkdir`" -msgstr ":meth:`Path.mkdir`" +#: ../../library/pathlib.rst:1544 +msgid ":func:`os.path.isdir`" +msgstr ":func:`os.path.isdir`" #: ../../library/pathlib.rst:1544 -msgid ":func:`os.makedirs`" -msgstr ":func:`os.makedirs`" +msgid ":meth:`Path.is_dir`" +msgstr ":meth:`Path.is_dir`" #: ../../library/pathlib.rst:1545 -msgid ":func:`os.rename`" -msgstr ":func:`os.rename`" +msgid ":func:`os.path.islink`" +msgstr ":func:`os.path.islink`" #: ../../library/pathlib.rst:1545 -msgid ":meth:`Path.rename`" -msgstr ":meth:`Path.rename`" +msgid ":meth:`Path.is_symlink`" +msgstr ":meth:`Path.is_symlink`" #: ../../library/pathlib.rst:1546 -msgid ":func:`os.replace`" -msgstr ":func:`os.replace`" +#, fuzzy +msgid ":func:`os.path.isjunction`" +msgstr ":func:`os.path.islink`" #: ../../library/pathlib.rst:1546 -msgid ":meth:`Path.replace`" -msgstr ":meth:`Path.replace`" +#, fuzzy +msgid ":meth:`Path.is_junction`" +msgstr ":meth:`Path.is_dir`" #: ../../library/pathlib.rst:1547 -msgid ":func:`os.rmdir`" -msgstr ":func:`os.rmdir`" +#, fuzzy +msgid ":func:`os.path.ismount`" +msgstr ":func:`os.path.islink`" #: ../../library/pathlib.rst:1547 -msgid ":meth:`Path.rmdir`" -msgstr ":meth:`Path.rmdir`" +#, fuzzy +msgid ":meth:`Path.is_mount`" +msgstr ":meth:`Path.is_symlink`" #: ../../library/pathlib.rst:1548 -msgid ":func:`os.remove`, :func:`os.unlink`" -msgstr ":func:`os.remove`、:func:`os.unlink`" +msgid ":func:`os.path.samefile`" +msgstr ":func:`os.path.samefile`" #: ../../library/pathlib.rst:1548 -msgid ":meth:`Path.unlink`" -msgstr ":meth:`Path.unlink`" +msgid ":meth:`Path.samefile`" +msgstr ":meth:`Path.samefile`" #: ../../library/pathlib.rst:1549 msgid ":func:`os.getcwd`" msgstr ":func:`os.getcwd`" #: ../../library/pathlib.rst:1549 -msgid ":func:`Path.cwd`" -msgstr ":func:`Path.cwd`" +#, fuzzy +msgid ":meth:`Path.cwd`" +msgstr ":meth:`Path.chmod`" #: ../../library/pathlib.rst:1550 -msgid ":func:`os.path.exists`" -msgstr ":func:`os.path.exists`" +msgid ":func:`os.stat`" +msgstr ":func:`os.stat`" #: ../../library/pathlib.rst:1550 -msgid ":meth:`Path.exists`" +#, fuzzy +msgid ":meth:`Path.stat`" msgstr ":meth:`Path.exists`" #: ../../library/pathlib.rst:1551 -msgid ":func:`os.path.expanduser`" -msgstr ":func:`os.path.expanduser`" +#, fuzzy +msgid ":func:`os.lstat`" +msgstr ":func:`os.stat`" #: ../../library/pathlib.rst:1551 -msgid ":meth:`Path.expanduser` and :meth:`Path.home`" -msgstr ":meth:`Path.expanduser` 和 :meth:`Path.home`" +#, fuzzy +msgid ":meth:`Path.lstat`" +msgstr ":meth:`Path.exists`" -#: ../../library/pathlib.rst:1553 +#: ../../library/pathlib.rst:1552 msgid ":func:`os.listdir`" msgstr ":func:`os.listdir`" -#: ../../library/pathlib.rst:1553 +#: ../../library/pathlib.rst:1552 msgid ":meth:`Path.iterdir`" msgstr ":meth:`Path.iterdir`" -#: ../../library/pathlib.rst:1554 +#: ../../library/pathlib.rst:1553 msgid ":func:`os.walk`" msgstr ":func:`os.walk`" -#: ../../library/pathlib.rst:1554 -msgid ":meth:`Path.walk`" +#: ../../library/pathlib.rst:1553 +#, fuzzy +msgid ":meth:`Path.walk` [4]_" msgstr ":meth:`Path.walk`" +#: ../../library/pathlib.rst:1554 +#, fuzzy +msgid ":func:`os.mkdir`, :func:`os.makedirs`" +msgstr ":func:`os.remove`、:func:`os.unlink`" + +#: ../../library/pathlib.rst:1554 +msgid ":meth:`Path.mkdir`" +msgstr ":meth:`Path.mkdir`" + #: ../../library/pathlib.rst:1555 -msgid ":func:`os.path.isdir`" -msgstr ":func:`os.path.isdir`" +msgid ":func:`os.link`" +msgstr ":func:`os.link`" #: ../../library/pathlib.rst:1555 -msgid ":meth:`Path.is_dir`" -msgstr ":meth:`Path.is_dir`" +msgid ":meth:`Path.hardlink_to`" +msgstr ":meth:`Path.hardlink_to`" #: ../../library/pathlib.rst:1556 -msgid ":func:`os.path.isfile`" -msgstr ":func:`os.path.isfile`" +msgid ":func:`os.symlink`" +msgstr ":func:`os.symlink`" #: ../../library/pathlib.rst:1556 -msgid ":meth:`Path.is_file`" -msgstr ":meth:`Path.is_file`" +msgid ":meth:`Path.symlink_to`" +msgstr ":meth:`Path.symlink_to`" #: ../../library/pathlib.rst:1557 -msgid ":func:`os.path.islink`" -msgstr ":func:`os.path.islink`" +msgid ":func:`os.readlink`" +msgstr ":func:`os.readlink`" #: ../../library/pathlib.rst:1557 -msgid ":meth:`Path.is_symlink`" -msgstr ":meth:`Path.is_symlink`" +msgid ":meth:`Path.readlink`" +msgstr ":meth:`Path.readlink`" #: ../../library/pathlib.rst:1558 -msgid ":func:`os.link`" -msgstr ":func:`os.link`" +msgid ":func:`os.rename`" +msgstr ":func:`os.rename`" #: ../../library/pathlib.rst:1558 -msgid ":meth:`Path.hardlink_to`" -msgstr ":meth:`Path.hardlink_to`" +msgid ":meth:`Path.rename`" +msgstr ":meth:`Path.rename`" #: ../../library/pathlib.rst:1559 -msgid ":func:`os.symlink`" -msgstr ":func:`os.symlink`" +msgid ":func:`os.replace`" +msgstr ":func:`os.replace`" #: ../../library/pathlib.rst:1559 -msgid ":meth:`Path.symlink_to`" -msgstr ":meth:`Path.symlink_to`" +msgid ":meth:`Path.replace`" +msgstr ":meth:`Path.replace`" #: ../../library/pathlib.rst:1560 -msgid ":func:`os.readlink`" -msgstr ":func:`os.readlink`" +msgid ":func:`os.remove`, :func:`os.unlink`" +msgstr ":func:`os.remove`、:func:`os.unlink`" #: ../../library/pathlib.rst:1560 -msgid ":meth:`Path.readlink`" -msgstr ":meth:`Path.readlink`" +msgid ":meth:`Path.unlink`" +msgstr ":meth:`Path.unlink`" #: ../../library/pathlib.rst:1561 -msgid ":func:`os.path.relpath`" -msgstr ":func:`os.path.relpath`" +msgid ":func:`os.rmdir`" +msgstr ":func:`os.rmdir`" #: ../../library/pathlib.rst:1561 -msgid ":meth:`PurePath.relative_to` [#]_" -msgstr ":meth:`PurePath.relative_to` [#]_" +msgid ":meth:`Path.rmdir`" +msgstr ":meth:`Path.rmdir`" #: ../../library/pathlib.rst:1562 -msgid ":func:`os.stat`" -msgstr ":func:`os.stat`" +msgid ":func:`os.chmod`" +msgstr ":func:`os.chmod`" #: ../../library/pathlib.rst:1562 -msgid ":meth:`Path.stat`, :meth:`Path.owner`, :meth:`Path.group`" -msgstr ":meth:`Path.stat`、:meth:`Path.owner`、:meth:`Path.group`" - -#: ../../library/pathlib.rst:1565 -msgid ":func:`os.path.isabs`" -msgstr ":func:`os.path.isabs`" - -#: ../../library/pathlib.rst:1565 -msgid ":meth:`PurePath.is_absolute`" -msgstr ":meth:`PurePath.is_absolute`" - -#: ../../library/pathlib.rst:1566 -msgid ":func:`os.path.join`" -msgstr ":func:`os.path.join`" +msgid ":meth:`Path.chmod`" +msgstr ":meth:`Path.chmod`" -#: ../../library/pathlib.rst:1566 -msgid ":func:`PurePath.joinpath`" -msgstr ":func:`PurePath.joinpath`" +#: ../../library/pathlib.rst:1563 +#, fuzzy +msgid ":func:`os.lchmod`" +msgstr ":func:`os.chmod`" -#: ../../library/pathlib.rst:1567 -msgid ":func:`os.path.basename`" -msgstr ":func:`os.path.basename`" +#: ../../library/pathlib.rst:1563 +#, fuzzy +msgid ":meth:`Path.lchmod`" +msgstr ":meth:`Path.chmod`" #: ../../library/pathlib.rst:1567 -msgid ":attr:`PurePath.name`" -msgstr ":attr:`PurePath.name`" - -#: ../../library/pathlib.rst:1568 -msgid ":func:`os.path.dirname`" -msgstr ":func:`os.path.dirname`" +msgid "Footnotes" +msgstr "註解" #: ../../library/pathlib.rst:1568 -msgid ":attr:`PurePath.parent`" -msgstr ":attr:`PurePath.parent`" - -#: ../../library/pathlib.rst:1569 -msgid ":func:`os.path.samefile`" -msgstr ":func:`os.path.samefile`" - -#: ../../library/pathlib.rst:1569 -msgid ":meth:`Path.samefile`" -msgstr ":meth:`Path.samefile`" - -#: ../../library/pathlib.rst:1570 -msgid ":func:`os.path.splitext`" -msgstr ":func:`os.path.splitext`" +msgid "" +":func:`os.path.relpath` calls :func:`~os.path.abspath` to make paths " +"absolute and remove \"``..``\" parts, whereas :meth:`PurePath.relative_to` " +"is a lexical operation that raises :exc:`ValueError` when its inputs' " +"anchors differ (e.g. if one path is absolute and the other relative.)" +msgstr "" -#: ../../library/pathlib.rst:1570 -msgid ":attr:`PurePath.stem` and :attr:`PurePath.suffix`" -msgstr ":attr:`PurePath.stem` 和 :attr:`PurePath.suffix`" +#: ../../library/pathlib.rst:1572 +msgid "" +":func:`os.path.expanduser` returns the path unchanged if the home directory " +"can't be resolved, whereas :meth:`Path.expanduser` raises :exc:" +"`RuntimeError`." +msgstr "" #: ../../library/pathlib.rst:1575 -msgid "Footnotes" -msgstr "註解" - -#: ../../library/pathlib.rst:1576 +#, fuzzy msgid "" -":func:`os.path.abspath` normalizes the resulting path, which may change its " -"meaning in the presence of symlinks, while :meth:`Path.absolute` does not." +":func:`os.path.abspath` removes \"``..``\" components without resolving " +"symlinks, which may change the meaning of the path, whereas :meth:`Path." +"absolute` leaves any \"``..``\" components in the path." msgstr "" ":func:`os.path.abspath` 會標準化產生的路徑，因而當有符號連結的時候會改變其意" "義，但 :meth:`Path.absolute` 不會。" -#: ../../library/pathlib.rst:1577 +#: ../../library/pathlib.rst:1578 msgid "" -":meth:`PurePath.relative_to` requires ``self`` to be the subpath of the " -"argument, but :func:`os.path.relpath` does not." +":func:`os.walk` always follows symlinks when categorizing paths into " +"*dirnames* and *filenames*, whereas :meth:`Path.walk` categorizes all " +"symlinks into *filenames* when *follow_symlinks* is false (the default.)" msgstr "" -":meth:`PurePath.relative_to` 要求 ``self`` 是其引數的子路徑 (subpath)，但 :" -"func:`os.path.relpath` 不用。" #: ../../library/pathlib.rst:11 msgid "path" @@ -1711,5 +1761,37 @@ msgstr "path（路徑）" msgid "operations" msgstr "operations（操作）" +#~ msgid "" +#~ "Not all pairs of functions/methods below are equivalent. Some of them, " +#~ "despite having some overlapping use-cases, have different semantics. They " +#~ "include :func:`os.path.abspath` and :meth:`Path.absolute`, :func:`os.path." +#~ "relpath` and :meth:`PurePath.relative_to`." +#~ msgstr "" +#~ "不是以下所有一對的函式/方法都相等。其中有一些儘管有重疊的使用情境但有不同" +#~ "的語意。它們包含 :func:`os.path.abspath` 和 :meth:`Path.absolute`、:func:" +#~ "`os.path.relpath` 和 :meth:`PurePath.relative_to`。" + +#~ msgid ":func:`os.mkdir`" +#~ msgstr ":func:`os.mkdir`" + +#~ msgid ":func:`os.makedirs`" +#~ msgstr ":func:`os.makedirs`" + +#~ msgid ":func:`Path.cwd`" +#~ msgstr ":func:`Path.cwd`" + +#~ msgid ":meth:`Path.expanduser` and :meth:`Path.home`" +#~ msgstr ":meth:`Path.expanduser` 和 :meth:`Path.home`" + +#~ msgid ":meth:`Path.stat`, :meth:`Path.owner`, :meth:`Path.group`" +#~ msgstr ":meth:`Path.stat`、:meth:`Path.owner`、:meth:`Path.group`" + +#~ msgid "" +#~ ":meth:`PurePath.relative_to` requires ``self`` to be the subpath of the " +#~ "argument, but :func:`os.path.relpath` does not." +#~ msgstr "" +#~ ":meth:`PurePath.relative_to` 要求 ``self`` 是其引數的子路徑 (subpath)，" +#~ "但 :func:`os.path.relpath` 不用。" + #~ msgid "Other methods" #~ msgstr "其他方法" diff --git a/whatsnew/3.12.po b/whatsnew/3.12.po index dc9167036f..0add2d8872 100644 --- a/whatsnew/3.12.po +++ b/whatsnew/3.12.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-25 00:04+0000\n" +"POT-Creation-Date: 2024-07-28 00:03+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1634,7 +1634,7 @@ msgid "" msgstr "" #: ../../whatsnew/3.12.rst:1193 -#: ../../deprecations/pending-removal-in-future.rst:38 +#: ../../deprecations/pending-removal-in-future.rst:42 msgid "" ":mod:`calendar`: ``calendar.January`` and ``calendar.February`` constants " "are deprecated and replaced by :data:`calendar.JANUARY` and :data:`calendar." @@ -2283,8 +2283,14 @@ msgstr "Python 3.13 中待決議的移除項目" #: ../../deprecations/pending-removal-in-3.16.rst:4 msgid "" -":class:`array.array` ``'u'`` type (:c:type:`wchar_t`): use the ``'w'`` type " -"instead (``Py_UCS4``)." +":mod:`array`: :class:`array.array` ``'u'`` type (:c:type:`wchar_t`): use the " +"``'w'`` type instead (``Py_UCS4``)." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.16.rst:8 +msgid "" +":mod:`symtable`: Deprecate :meth:`symtable.Class.get_methods` due to the " +"lack of interest. (Contributed by Bénédikt Tran in :gh:`119698`.)" msgstr "" #: ../../whatsnew/3.12.rst:2280 @@ -2366,80 +2372,88 @@ msgstr "" msgid "Delegation of ``int()`` to ``__trunc__()`` method." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:43 +#: ../../deprecations/pending-removal-in-future.rst:37 +msgid "" +"Passing a complex number as the *real* or *imag* argument in the :func:" +"`complex` constructor is now deprecated; it should only be passed as a " +"single positional argument. (Contributed by Serhiy Storchaka in :gh:" +"`109218`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:47 #, fuzzy msgid "" ":attr:`codeobject.co_lnotab`: use the :meth:`codeobject.co_lines` method " "instead." msgstr "程式碼物件的 :attr:`~codeobject.co_lnotab` 屬性。" -#: ../../deprecations/pending-removal-in-future.rst:46 +#: ../../deprecations/pending-removal-in-future.rst:50 #, fuzzy msgid ":mod:`datetime`:" msgstr ":mod:`ast`：" -#: ../../deprecations/pending-removal-in-future.rst:48 +#: ../../deprecations/pending-removal-in-future.rst:52 msgid "" ":meth:`~datetime.datetime.utcnow`: use ``datetime.datetime.now(tz=datetime." "UTC)``." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:50 +#: ../../deprecations/pending-removal-in-future.rst:54 msgid "" ":meth:`~datetime.datetime.utcfromtimestamp`: use ``datetime.datetime." "fromtimestamp(timestamp, tz=datetime.UTC)``." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:53 +#: ../../deprecations/pending-removal-in-future.rst:57 msgid ":mod:`gettext`: Plural value must be an integer." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:55 +#: ../../deprecations/pending-removal-in-future.rst:59 #, fuzzy msgid ":mod:`importlib`:" msgstr ":mod:`importlib.abc`：" -#: ../../deprecations/pending-removal-in-future.rst:57 +#: ../../deprecations/pending-removal-in-future.rst:61 msgid "``load_module()`` method: use ``exec_module()`` instead." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:58 +#: ../../deprecations/pending-removal-in-future.rst:62 msgid "" ":func:`~importlib.util.cache_from_source` *debug_override* parameter is " "deprecated: use the *optimization* parameter instead." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:61 +#: ../../deprecations/pending-removal-in-future.rst:65 #, fuzzy msgid ":mod:`importlib.metadata`:" msgstr ":mod:`importlib.abc`：" -#: ../../deprecations/pending-removal-in-future.rst:63 +#: ../../deprecations/pending-removal-in-future.rst:67 msgid "``EntryPoints`` tuple interface." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:64 +#: ../../deprecations/pending-removal-in-future.rst:68 msgid "Implicit ``None`` on return values." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:66 +#: ../../deprecations/pending-removal-in-future.rst:70 msgid "" ":mod:`mailbox`: Use of StringIO input and text mode is deprecated, use " "BytesIO and binary mode instead." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:69 +#: ../../deprecations/pending-removal-in-future.rst:73 msgid "" ":mod:`os`: Calling :func:`os.register_at_fork` in multi-threaded process." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:71 +#: ../../deprecations/pending-removal-in-future.rst:75 msgid "" ":class:`!pydoc.ErrorDuringImport`: A tuple value for *exc_info* parameter is " "deprecated, use an exception instance." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:74 +#: ../../deprecations/pending-removal-in-future.rst:78 msgid "" ":mod:`re`: More strict rules are now applied for numerical group references " "and group names in regular expressions. Only sequence of ASCII digits is " @@ -2448,198 +2462,198 @@ msgid "" "underscore. (Contributed by Serhiy Storchaka in :gh:`91760`.)" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:81 +#: ../../deprecations/pending-removal-in-future.rst:85 msgid "" ":mod:`!sre_compile`, :mod:`!sre_constants` and :mod:`!sre_parse` modules." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:83 +#: ../../deprecations/pending-removal-in-future.rst:87 msgid "" ":mod:`shutil`: :func:`~shutil.rmtree`'s *onerror* parameter is deprecated in " "Python 3.12; use the *onexc* parameter instead." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:86 +#: ../../deprecations/pending-removal-in-future.rst:90 msgid ":mod:`ssl` options and protocols:" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:88 +#: ../../deprecations/pending-removal-in-future.rst:92 msgid ":class:`ssl.SSLContext` without protocol argument is deprecated." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:89 +#: ../../deprecations/pending-removal-in-future.rst:93 msgid "" ":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` and :meth:" "`!selected_npn_protocol` are deprecated: use ALPN instead." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:92 +#: ../../deprecations/pending-removal-in-future.rst:96 msgid "``ssl.OP_NO_SSL*`` options" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:93 +#: ../../deprecations/pending-removal-in-future.rst:97 msgid "``ssl.OP_NO_TLS*`` options" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:94 +#: ../../deprecations/pending-removal-in-future.rst:98 msgid "``ssl.PROTOCOL_SSLv3``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:95 +#: ../../deprecations/pending-removal-in-future.rst:99 msgid "``ssl.PROTOCOL_TLS``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:96 +#: ../../deprecations/pending-removal-in-future.rst:100 msgid "``ssl.PROTOCOL_TLSv1``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:97 +#: ../../deprecations/pending-removal-in-future.rst:101 msgid "``ssl.PROTOCOL_TLSv1_1``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:98 +#: ../../deprecations/pending-removal-in-future.rst:102 msgid "``ssl.PROTOCOL_TLSv1_2``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:99 +#: ../../deprecations/pending-removal-in-future.rst:103 msgid "``ssl.TLSVersion.SSLv3``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:100 +#: ../../deprecations/pending-removal-in-future.rst:104 msgid "``ssl.TLSVersion.TLSv1``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:101 +#: ../../deprecations/pending-removal-in-future.rst:105 msgid "``ssl.TLSVersion.TLSv1_1``" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:103 +#: ../../deprecations/pending-removal-in-future.rst:107 msgid "" ":func:`sysconfig.is_python_build` *check_home* parameter is deprecated and " "ignored." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:106 +#: ../../deprecations/pending-removal-in-future.rst:110 #, fuzzy msgid ":mod:`threading` methods:" msgstr ":mod:`typing`：" -#: ../../deprecations/pending-removal-in-future.rst:108 +#: ../../deprecations/pending-removal-in-future.rst:112 msgid "" ":meth:`!threading.Condition.notifyAll`: use :meth:`~threading.Condition." "notify_all`." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:109 +#: ../../deprecations/pending-removal-in-future.rst:113 msgid ":meth:`!threading.Event.isSet`: use :meth:`~threading.Event.is_set`." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:110 +#: ../../deprecations/pending-removal-in-future.rst:114 msgid "" ":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: use :" "attr:`threading.Thread.daemon` attribute." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:112 +#: ../../deprecations/pending-removal-in-future.rst:116 msgid "" ":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: use :" "attr:`threading.Thread.name` attribute." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:114 +#: ../../deprecations/pending-removal-in-future.rst:118 msgid ":meth:`!threading.currentThread`: use :meth:`threading.current_thread`." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:115 +#: ../../deprecations/pending-removal-in-future.rst:119 msgid ":meth:`!threading.activeCount`: use :meth:`threading.active_count`." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:117 +#: ../../deprecations/pending-removal-in-future.rst:121 #, fuzzy msgid ":class:`typing.Text` (:gh:`92332`)." msgstr ":class:`typing.Text` (:gh:`92332`)" -#: ../../deprecations/pending-removal-in-future.rst:119 +#: ../../deprecations/pending-removal-in-future.rst:123 msgid "" ":class:`unittest.IsolatedAsyncioTestCase`: it is deprecated to return a " "value that is not ``None`` from a test case." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:122 +#: ../../deprecations/pending-removal-in-future.rst:126 msgid "" ":mod:`urllib.parse` deprecated functions: :func:`~urllib.parse.urlparse` " "instead" msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:124 +#: ../../deprecations/pending-removal-in-future.rst:128 #, fuzzy msgid "``splitattr()``" msgstr "``path()``" -#: ../../deprecations/pending-removal-in-future.rst:125 +#: ../../deprecations/pending-removal-in-future.rst:129 #, fuzzy msgid "``splithost()``" msgstr "``path()``" -#: ../../deprecations/pending-removal-in-future.rst:126 +#: ../../deprecations/pending-removal-in-future.rst:130 #, fuzzy msgid "``splitnport()``" msgstr "``path()``" -#: ../../deprecations/pending-removal-in-future.rst:127 +#: ../../deprecations/pending-removal-in-future.rst:131 #, fuzzy msgid "``splitpasswd()``" msgstr "``imp.reload()``" -#: ../../deprecations/pending-removal-in-future.rst:128 +#: ../../deprecations/pending-removal-in-future.rst:132 #, fuzzy msgid "``splitport()``" msgstr "``path()``" -#: ../../deprecations/pending-removal-in-future.rst:129 +#: ../../deprecations/pending-removal-in-future.rst:133 #, fuzzy msgid "``splitquery()``" msgstr "``path()``" -#: ../../deprecations/pending-removal-in-future.rst:130 +#: ../../deprecations/pending-removal-in-future.rst:134 #, fuzzy msgid "``splittag()``" msgstr "``imp.get_tag()``" -#: ../../deprecations/pending-removal-in-future.rst:131 +#: ../../deprecations/pending-removal-in-future.rst:135 #, fuzzy msgid "``splittype()``" msgstr "``path()``" -#: ../../deprecations/pending-removal-in-future.rst:132 +#: ../../deprecations/pending-removal-in-future.rst:136 #, fuzzy msgid "``splituser()``" msgstr "``path()``" -#: ../../deprecations/pending-removal-in-future.rst:133 +#: ../../deprecations/pending-removal-in-future.rst:137 #, fuzzy msgid "``splitvalue()``" msgstr "``path()``" -#: ../../deprecations/pending-removal-in-future.rst:134 +#: ../../deprecations/pending-removal-in-future.rst:138 #, fuzzy msgid "``to_bytes()``" msgstr "``contents()``" -#: ../../deprecations/pending-removal-in-future.rst:136 +#: ../../deprecations/pending-removal-in-future.rst:140 msgid "" ":mod:`urllib.request`: :class:`~urllib.request.URLopener` and :class:" "`~urllib.request.FancyURLopener` style of invoking requests is deprecated. " "Use newer :func:`~urllib.request.urlopen` functions and methods." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:140 +#: ../../deprecations/pending-removal-in-future.rst:144 msgid "" ":mod:`wsgiref`: ``SimpleHandler.stdout.write()`` should not do partial " "writes." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:143 +#: ../../deprecations/pending-removal-in-future.rst:147 msgid "" ":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`~xml." "etree.ElementTree.Element` is deprecated. In a future release it will always " @@ -2647,7 +2661,7 @@ msgid "" "instead." msgstr "" -#: ../../deprecations/pending-removal-in-future.rst:148 +#: ../../deprecations/pending-removal-in-future.rst:152 msgid "" ":meth:`zipimport.zipimporter.load_module` is deprecated: use :meth:" "`~zipimport.zipimporter.exec_module` instead." From 2331ca726204cea67a2c7d4d3391df28c81a30a0 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Mon, 29 Jul 2024 00:05:18 +0000 Subject: [PATCH 11/28] sync with cpython ecc97cb4 --- deprecations/index.po | 865 ++++++++++++++++++++++++++++++++++++++++++ sphinx.po | 46 ++- 2 files changed, 892 insertions(+), 19 deletions(-) create mode 100644 deprecations/index.po diff --git a/deprecations/index.po b/deprecations/index.po new file mode 100644 index 0000000000..d7747d4d24 --- /dev/null +++ b/deprecations/index.po @@ -0,0 +1,865 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-07-29 00:04+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"Language: zh_TW\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: ../../deprecations/index.rst:2 +msgid "Deprecations" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:2 +msgid "Pending Removal in Python 3.13" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:4 +msgid "Modules (see :pep:`594`):" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:6 +msgid ":mod:`aifc`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:7 +msgid ":mod:`audioop`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:8 +msgid ":mod:`cgi`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:9 +msgid ":mod:`cgitb`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:10 +msgid ":mod:`chunk`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:11 +msgid ":mod:`crypt`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:12 +msgid ":mod:`imghdr`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:13 +msgid ":mod:`mailcap`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:14 +msgid ":mod:`msilib`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:15 +msgid ":mod:`nis`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:16 +msgid ":mod:`nntplib`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:17 +msgid ":mod:`ossaudiodev`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:18 +msgid ":mod:`pipes`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:19 +msgid ":mod:`sndhdr`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:20 +msgid ":mod:`spwd`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:21 +msgid ":mod:`sunau`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:22 +msgid ":mod:`telnetlib`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:23 +msgid ":mod:`uu`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:24 +msgid ":mod:`xdrlib`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:26 +msgid "Other modules:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:28 +msgid ":mod:`!lib2to3`, and the :program:`2to3` program (:gh:`84540`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:30 +msgid "APIs:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:32 +msgid ":class:`!configparser.LegacyInterpolation` (:gh:`90765`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:33 +msgid "``locale.resetlocale()`` (:gh:`90817`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:34 +msgid ":meth:`!turtle.RawTurtle.settiltangle` (:gh:`50096`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:35 +msgid ":func:`!unittest.findTestCases` (:gh:`50096`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:36 +msgid ":func:`!unittest.getTestCaseNames` (:gh:`50096`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:37 +msgid ":func:`!unittest.makeSuite` (:gh:`50096`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:38 +msgid ":meth:`!unittest.TestProgram.usageExit` (:gh:`67048`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:39 +msgid ":class:`!webbrowser.MacOSX` (:gh:`86421`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:40 +msgid ":class:`classmethod` descriptor chaining (:gh:`89519`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:41 +msgid ":mod:`importlib.resources` deprecated methods:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:43 +msgid "``contents()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:44 +msgid "``is_resource()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:45 +msgid "``open_binary()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:46 +msgid "``open_text()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:47 +msgid "``path()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:48 +msgid "``read_binary()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:49 +msgid "``read_text()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.13.rst:51 +msgid "" +"Use :func:`importlib.resources.files()` instead. Refer to `importlib-" +"resources: Migrating from Legacy `_ (:gh:`106531`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:2 +msgid "Pending Removal in Python 3.14" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:4 +msgid "" +":mod:`argparse`: The *type*, *choices*, and *metavar* parameters of :class:`!" +"argparse.BooleanOptionalAction` are deprecated and will be removed in 3.14. " +"(Contributed by Nikita Sobolev in :gh:`92248`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:9 +msgid "" +":mod:`ast`: The following features have been deprecated in documentation " +"since Python 3.8, now cause a :exc:`DeprecationWarning` to be emitted at " +"runtime when they are accessed or used, and will be removed in Python 3.14:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:13 +msgid ":class:`!ast.Num`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:14 +msgid ":class:`!ast.Str`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:15 +msgid ":class:`!ast.Bytes`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:16 +msgid ":class:`!ast.NameConstant`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:17 +msgid ":class:`!ast.Ellipsis`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:19 +msgid "" +"Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka in :gh:" +"`90953`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:22 +msgid ":mod:`asyncio`:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:24 +msgid "" +"The child watcher classes :class:`~asyncio.MultiLoopChildWatcher`, :class:" +"`~asyncio.FastChildWatcher`, :class:`~asyncio.AbstractChildWatcher` and :" +"class:`~asyncio.SafeChildWatcher` are deprecated and will be removed in " +"Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:30 +msgid "" +":func:`asyncio.set_child_watcher`, :func:`asyncio.get_child_watcher`, :meth:" +"`asyncio.AbstractEventLoopPolicy.set_child_watcher` and :meth:`asyncio." +"AbstractEventLoopPolicy.get_child_watcher` are deprecated and will be " +"removed in Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:36 +msgid "" +"The :meth:`~asyncio.get_event_loop` method of the default event loop policy " +"now emits a :exc:`DeprecationWarning` if there is no current event loop set " +"and it decides to create one. (Contributed by Serhiy Storchaka and Guido van " +"Rossum in :gh:`100160`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:41 +msgid "" +":mod:`collections.abc`: Deprecated :class:`~collections.abc.ByteString`. " +"Prefer :class:`!Sequence` or :class:`~collections.abc.Buffer`. For use in " +"typing, prefer a union, like ``bytes | bytearray``, or :class:`collections." +"abc.Buffer`. (Contributed by Shantanu Jain in :gh:`91896`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:47 +msgid "" +":mod:`email`: Deprecated the *isdst* parameter in :func:`email.utils." +"localtime`. (Contributed by Alan Williams in :gh:`72346`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:50 +msgid "" +":mod:`importlib`: ``__package__`` and ``__cached__`` will cease to be set or " +"taken into consideration by the import system (:gh:`97879`)." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:53 +msgid ":mod:`importlib.abc` deprecated classes:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:55 +msgid ":class:`!importlib.abc.ResourceReader`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:56 +msgid ":class:`!importlib.abc.Traversable`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:57 +msgid ":class:`!importlib.abc.TraversableResources`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:59 +msgid "Use :mod:`importlib.resources.abc` classes instead:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:61 +msgid ":class:`importlib.resources.abc.Traversable`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:62 +msgid ":class:`importlib.resources.abc.TraversableResources`" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:64 +msgid "(Contributed by Jason R. Coombs and Hugo van Kemenade in :gh:`93963`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:66 +msgid "" +":mod:`itertools` had undocumented, inefficient, historically buggy, and " +"inconsistent support for copy, deepcopy, and pickle operations. This will be " +"removed in 3.14 for a significant reduction in code volume and maintenance " +"burden. (Contributed by Raymond Hettinger in :gh:`101588`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:72 +msgid "" +":mod:`multiprocessing`: The default start method will change to a safer one " +"on Linux, BSDs, and other non-macOS POSIX platforms where ``'fork'`` is " +"currently the default (:gh:`84559`). Adding a runtime warning about this was " +"deemed too disruptive as the majority of code is not expected to care. Use " +"the :func:`~multiprocessing.get_context` or :func:`~multiprocessing." +"set_start_method` APIs to explicitly specify when your code *requires* " +"``'fork'``. See :ref:`multiprocessing-start-methods`." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:80 +msgid "" +":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` and :meth:`~pathlib." +"PurePath.relative_to`: passing additional arguments is deprecated." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:84 +msgid "" +":mod:`pkgutil`: :func:`~pkgutil.find_loader` and :func:`~pkgutil.get_loader` " +"now raise :exc:`DeprecationWarning`; use :func:`importlib.util.find_spec` " +"instead. (Contributed by Nikita Sobolev in :gh:`97850`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:89 +msgid ":mod:`pty`:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:91 +msgid "``master_open()``: use :func:`pty.openpty`." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:92 +msgid "``slave_open()``: use :func:`pty.openpty`." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:94 +msgid ":mod:`sqlite3`:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:96 +msgid ":data:`~sqlite3.version` and :data:`~sqlite3.version_info`." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:98 +msgid "" +":meth:`~sqlite3.Cursor.execute` and :meth:`~sqlite3.Cursor.executemany` if :" +"ref:`named placeholders ` are used and *parameters* is " +"a sequence instead of a :class:`dict`." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:102 +msgid "" +"date and datetime adapter, date and timestamp converter: see the :mod:" +"`sqlite3` documentation for suggested replacement recipes." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:105 +msgid "" +":class:`types.CodeType`: Accessing :attr:`~codeobject.co_lnotab` was " +"deprecated in :pep:`626` since 3.10 and was planned to be removed in 3.12, " +"but it only got a proper :exc:`DeprecationWarning` in 3.12. May be removed " +"in 3.14. (Contributed by Nikita Sobolev in :gh:`101866`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:112 +msgid "" +":mod:`typing`: :class:`~typing.ByteString`, deprecated since Python 3.9, now " +"causes a :exc:`DeprecationWarning` to be emitted when it is used." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.14.rst:115 +msgid "" +":mod:`urllib`: :class:`!urllib.parse.Quoter` is deprecated: it was not " +"intended to be a public API. (Contributed by Gregory P. Smith in :gh:" +"`88168`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:2 +msgid "Pending Removal in Python 3.15" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:4 +msgid "" +":class:`http.server.CGIHTTPRequestHandler` will be removed along with its " +"related ``--cgi`` flag to ``python -m http.server``. It was obsolete and " +"rarely used. No direct replacement exists. *Anything* is better than CGI " +"to interface a web server with a request handler." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:9 +msgid "" +":class:`locale`: :func:`locale.getdefaultlocale` was deprecated in Python " +"3.11 and originally planned for removal in Python 3.13 (:gh:`90817`), but " +"removal has been postponed to Python 3.15. Use :func:`locale.setlocale()`, :" +"func:`locale.getencoding()` and :func:`locale.getlocale()` instead. " +"(Contributed by Hugo van Kemenade in :gh:`111187`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:16 +msgid "" +":mod:`pathlib`: :meth:`pathlib.PurePath.is_reserved` is deprecated and " +"scheduled for removal in Python 3.15. From Python 3.13 onwards, use ``os." +"path.isreserved`` to detect reserved paths on Windows." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:21 +msgid "" +":mod:`platform`: :func:`~platform.java_ver` is deprecated and will be " +"removed in 3.15. It was largely untested, had a confusing API, and was only " +"useful for Jython support. (Contributed by Nikita Sobolev in :gh:`116349`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:27 +msgid "" +":mod:`threading`: Passing any arguments to :func:`threading.RLock` is now " +"deprecated. C version allows any numbers of args and kwargs, but they are " +"just ignored. Python version does not allow any arguments. All arguments " +"will be removed from :func:`threading.RLock` in Python 3.15. (Contributed by " +"Nikita Sobolev in :gh:`102029`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:34 +msgid ":class:`typing.NamedTuple`:" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:36 +msgid "" +"The undocumented keyword argument syntax for creating :class:`!NamedTuple` " +"classes (``NT = NamedTuple(\"NT\", x=int)``) is deprecated, and will be " +"disallowed in 3.15. Use the class-based syntax or the functional syntax " +"instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:40 +msgid "" +"When using the functional syntax to create a :class:`!NamedTuple` class, " +"failing to pass a value to the *fields* parameter (``NT = " +"NamedTuple(\"NT\")``) is deprecated. Passing ``None`` to the *fields* " +"parameter (``NT = NamedTuple(\"NT\", None)``) is also deprecated. Both will " +"be disallowed in Python 3.15. To create a :class:`!NamedTuple` class with 0 " +"fields, use ``class NT(NamedTuple): pass`` or ``NT = NamedTuple(\"NT\", " +"[])``." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:47 +msgid "" +":class:`typing.TypedDict`: When using the functional syntax to create a :" +"class:`!TypedDict` class, failing to pass a value to the *fields* parameter " +"(``TD = TypedDict(\"TD\")``) is deprecated. Passing ``None`` to the *fields* " +"parameter (``TD = TypedDict(\"TD\", None)``) is also deprecated. Both will " +"be disallowed in Python 3.15. To create a :class:`!TypedDict` class with 0 " +"fields, use ``class TD(TypedDict): pass`` or ``TD = TypedDict(\"TD\", {})``." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.15.rst:54 +msgid "" +":mod:`wave`: Deprecate the ``getmark()``, ``setmark()`` and ``getmarkers()`` " +"methods of the :class:`wave.Wave_read` and :class:`wave.Wave_write` classes. " +"They will be removed in Python 3.15. (Contributed by Victor Stinner in :gh:" +"`105096`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.16.rst:2 +msgid "Pending Removal in Python 3.16" +msgstr "" + +#: ../../deprecations/pending-removal-in-3.16.rst:4 +msgid "" +":mod:`array`: :class:`array.array` ``'u'`` type (:c:type:`wchar_t`): use the " +"``'w'`` type instead (``Py_UCS4``)." +msgstr "" + +#: ../../deprecations/pending-removal-in-3.16.rst:8 +msgid "" +":mod:`symtable`: Deprecate :meth:`symtable.Class.get_methods` due to the " +"lack of interest. (Contributed by Bénédikt Tran in :gh:`119698`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:2 +msgid "Pending Removal in Future Versions" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:4 +msgid "" +"The following APIs will be removed in the future, although there is " +"currently no date scheduled for their removal." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:7 +msgid "" +":mod:`argparse`: Nesting argument groups and nesting mutually exclusive " +"groups are deprecated." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:10 +msgid ":mod:`array`'s ``'u'`` format code (:gh:`57281`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:12 +msgid ":mod:`builtins`:" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:14 +msgid "``~bool``, bitwise inversion on bool." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:15 +msgid "``bool(NotImplemented)``." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:16 +msgid "" +"Generators: ``throw(type, exc, tb)`` and ``athrow(type, exc, tb)`` signature " +"is deprecated: use ``throw(exc)`` and ``athrow(exc)`` instead, the single " +"argument signature." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:19 +msgid "" +"Currently Python accepts numeric literals immediately followed by keywords, " +"for example ``0in x``, ``1or x``, ``0if 1else 2``. It allows confusing and " +"ambiguous expressions like ``[0x1for x in y]`` (which can be interpreted as " +"``[0x1 for x in y]`` or ``[0x1f or x in y]``). A syntax warning is raised " +"if the numeric literal is immediately followed by one of keywords :keyword:" +"`and`, :keyword:`else`, :keyword:`for`, :keyword:`if`, :keyword:`in`, :" +"keyword:`is` and :keyword:`or`. In a future release it will be changed to a " +"syntax error. (:gh:`87999`)" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:27 +msgid "" +"Support for ``__index__()`` and ``__int__()`` method returning non-int type: " +"these methods will be required to return an instance of a strict subclass " +"of :class:`int`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:30 +msgid "" +"Support for ``__float__()`` method returning a strict subclass of :class:" +"`float`: these methods will be required to return an instance of :class:" +"`float`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:33 +msgid "" +"Support for ``__complex__()`` method returning a strict subclass of :class:" +"`complex`: these methods will be required to return an instance of :class:" +"`complex`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:36 +msgid "Delegation of ``int()`` to ``__trunc__()`` method." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:37 +msgid "" +"Passing a complex number as the *real* or *imag* argument in the :func:" +"`complex` constructor is now deprecated; it should only be passed as a " +"single positional argument. (Contributed by Serhiy Storchaka in :gh:" +"`109218`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:42 +msgid "" +":mod:`calendar`: ``calendar.January`` and ``calendar.February`` constants " +"are deprecated and replaced by :data:`calendar.JANUARY` and :data:`calendar." +"FEBRUARY`. (Contributed by Prince Roshan in :gh:`103636`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:47 +msgid "" +":attr:`codeobject.co_lnotab`: use the :meth:`codeobject.co_lines` method " +"instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:50 +msgid ":mod:`datetime`:" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:52 +msgid "" +":meth:`~datetime.datetime.utcnow`: use ``datetime.datetime.now(tz=datetime." +"UTC)``." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:54 +msgid "" +":meth:`~datetime.datetime.utcfromtimestamp`: use ``datetime.datetime." +"fromtimestamp(timestamp, tz=datetime.UTC)``." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:57 +msgid ":mod:`gettext`: Plural value must be an integer." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:59 +msgid ":mod:`importlib`:" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:61 +msgid "``load_module()`` method: use ``exec_module()`` instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:62 +msgid "" +":func:`~importlib.util.cache_from_source` *debug_override* parameter is " +"deprecated: use the *optimization* parameter instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:65 +msgid ":mod:`importlib.metadata`:" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:67 +msgid "``EntryPoints`` tuple interface." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:68 +msgid "Implicit ``None`` on return values." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:70 +msgid "" +":mod:`mailbox`: Use of StringIO input and text mode is deprecated, use " +"BytesIO and binary mode instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:73 +msgid "" +":mod:`os`: Calling :func:`os.register_at_fork` in multi-threaded process." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:75 +msgid "" +":class:`!pydoc.ErrorDuringImport`: A tuple value for *exc_info* parameter is " +"deprecated, use an exception instance." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:78 +msgid "" +":mod:`re`: More strict rules are now applied for numerical group references " +"and group names in regular expressions. Only sequence of ASCII digits is " +"now accepted as a numerical reference. The group name in bytes patterns and " +"replacement strings can now only contain ASCII letters and digits and " +"underscore. (Contributed by Serhiy Storchaka in :gh:`91760`.)" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:85 +msgid "" +":mod:`!sre_compile`, :mod:`!sre_constants` and :mod:`!sre_parse` modules." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:87 +msgid "" +":mod:`shutil`: :func:`~shutil.rmtree`'s *onerror* parameter is deprecated in " +"Python 3.12; use the *onexc* parameter instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:90 +msgid ":mod:`ssl` options and protocols:" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:92 +msgid ":class:`ssl.SSLContext` without protocol argument is deprecated." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:93 +msgid "" +":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` and :meth:" +"`!selected_npn_protocol` are deprecated: use ALPN instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:96 +msgid "``ssl.OP_NO_SSL*`` options" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:97 +msgid "``ssl.OP_NO_TLS*`` options" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:98 +msgid "``ssl.PROTOCOL_SSLv3``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:99 +msgid "``ssl.PROTOCOL_TLS``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:100 +msgid "``ssl.PROTOCOL_TLSv1``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:101 +msgid "``ssl.PROTOCOL_TLSv1_1``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:102 +msgid "``ssl.PROTOCOL_TLSv1_2``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:103 +msgid "``ssl.TLSVersion.SSLv3``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:104 +msgid "``ssl.TLSVersion.TLSv1``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:105 +msgid "``ssl.TLSVersion.TLSv1_1``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:107 +msgid "" +":func:`sysconfig.is_python_build` *check_home* parameter is deprecated and " +"ignored." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:110 +msgid ":mod:`threading` methods:" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:112 +msgid "" +":meth:`!threading.Condition.notifyAll`: use :meth:`~threading.Condition." +"notify_all`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:113 +msgid ":meth:`!threading.Event.isSet`: use :meth:`~threading.Event.is_set`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:114 +msgid "" +":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: use :" +"attr:`threading.Thread.daemon` attribute." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:116 +msgid "" +":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: use :" +"attr:`threading.Thread.name` attribute." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:118 +msgid ":meth:`!threading.currentThread`: use :meth:`threading.current_thread`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:119 +msgid ":meth:`!threading.activeCount`: use :meth:`threading.active_count`." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:121 +msgid ":class:`typing.Text` (:gh:`92332`)." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:123 +msgid "" +":class:`unittest.IsolatedAsyncioTestCase`: it is deprecated to return a " +"value that is not ``None`` from a test case." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:126 +msgid "" +":mod:`urllib.parse` deprecated functions: :func:`~urllib.parse.urlparse` " +"instead" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:128 +msgid "``splitattr()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:129 +msgid "``splithost()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:130 +msgid "``splitnport()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:131 +msgid "``splitpasswd()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:132 +msgid "``splitport()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:133 +msgid "``splitquery()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:134 +msgid "``splittag()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:135 +msgid "``splittype()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:136 +msgid "``splituser()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:137 +msgid "``splitvalue()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:138 +msgid "``to_bytes()``" +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:140 +msgid "" +":mod:`urllib.request`: :class:`~urllib.request.URLopener` and :class:" +"`~urllib.request.FancyURLopener` style of invoking requests is deprecated. " +"Use newer :func:`~urllib.request.urlopen` functions and methods." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:144 +msgid "" +":mod:`wsgiref`: ``SimpleHandler.stdout.write()`` should not do partial " +"writes." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:147 +msgid "" +":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`~xml." +"etree.ElementTree.Element` is deprecated. In a future release it will always " +"return ``True``. Prefer explicit ``len(elem)`` or ``elem is not None`` tests " +"instead." +msgstr "" + +#: ../../deprecations/pending-removal-in-future.rst:152 +msgid "" +":meth:`zipimport.zipimporter.load_module` is deprecated: use :meth:" +"`~zipimport.zipimporter.exec_module` instead." +msgstr "" diff --git a/sphinx.po b/sphinx.po index a4641b17c0..14a37a8512 100644 --- a/sphinx.po +++ b/sphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-03-27 00:03+0000\n" +"POT-Creation-Date: 2024-07-29 00:04+0000\n" "PO-Revision-Date: 2023-03-15 10:19+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -216,75 +216,83 @@ msgstr "常見問答集" msgid "Frequently asked questions (with answers!)" msgstr "常被提出的問題（還有答案！）" -#: ../../tools/templates/indexcontent.html:39 +#: ../../tools/templates/indexcontent.html:36 +msgid "Deprecations" +msgstr "" + +#: ../../tools/templates/indexcontent.html:37 +msgid "Deprecated functionality" +msgstr "" + +#: ../../tools/templates/indexcontent.html:41 msgid "Indices, glossary, and search:" msgstr "索引、術語表與搜尋：" -#: ../../tools/templates/indexcontent.html:42 +#: ../../tools/templates/indexcontent.html:44 msgid "Global module index" msgstr "全域模組索引" -#: ../../tools/templates/indexcontent.html:43 +#: ../../tools/templates/indexcontent.html:45 msgid "All modules and libraries" msgstr "所有模組與函式庫" -#: ../../tools/templates/indexcontent.html:44 +#: ../../tools/templates/indexcontent.html:46 msgid "General index" msgstr "總索引" -#: ../../tools/templates/indexcontent.html:45 +#: ../../tools/templates/indexcontent.html:47 msgid "All functions, classes, and terms" msgstr "全部函式、類別和術語" -#: ../../tools/templates/indexcontent.html:46 +#: ../../tools/templates/indexcontent.html:48 msgid "Glossary" msgstr "術語表" -#: ../../tools/templates/indexcontent.html:47 +#: ../../tools/templates/indexcontent.html:49 msgid "Terms explained" msgstr "術語解釋" -#: ../../tools/templates/indexcontent.html:49 +#: ../../tools/templates/indexcontent.html:51 msgid "Search page" msgstr "搜尋頁" -#: ../../tools/templates/indexcontent.html:50 +#: ../../tools/templates/indexcontent.html:52 msgid "Search this documentation" msgstr "搜尋這份說明文件" -#: ../../tools/templates/indexcontent.html:51 +#: ../../tools/templates/indexcontent.html:53 msgid "Complete table of contents" msgstr "完整內容列表" -#: ../../tools/templates/indexcontent.html:52 +#: ../../tools/templates/indexcontent.html:54 msgid "Lists all sections and subsections" msgstr "列出所有章節與小節" -#: ../../tools/templates/indexcontent.html:56 +#: ../../tools/templates/indexcontent.html:58 msgid "Project information:" msgstr "專案資訊：" -#: ../../tools/templates/indexcontent.html:59 +#: ../../tools/templates/indexcontent.html:61 msgid "Reporting issues" msgstr "回報問題" -#: ../../tools/templates/indexcontent.html:60 +#: ../../tools/templates/indexcontent.html:62 msgid "Contributing to Docs" msgstr "貢獻說明文件" -#: ../../tools/templates/indexcontent.html:61 +#: ../../tools/templates/indexcontent.html:63 msgid "Download the documentation" msgstr "下載說明文件" -#: ../../tools/templates/indexcontent.html:63 +#: ../../tools/templates/indexcontent.html:65 msgid "History and license of Python" msgstr "Python 的沿革與授權" -#: ../../tools/templates/indexcontent.html:64 +#: ../../tools/templates/indexcontent.html:66 msgid "Copyright" msgstr "版權" -#: ../../tools/templates/indexcontent.html:65 +#: ../../tools/templates/indexcontent.html:67 msgid "About the documentation" msgstr "關於說明文件" From f28f38f5e37e56fb761df9ca0f7d1f96a36e0f9b Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 31 Jul 2024 00:04:48 +0000 Subject: [PATCH 12/28] sync with cpython efba83f9 --- c-api/file.po | 7 +- c-api/init.po | 14 +- c-api/sys.po | 16 +- deprecations/c-api-pending-removal-in-3.14.po | 177 +++ deprecations/c-api-pending-removal-in-3.15.po | 85 ++ .../c-api-pending-removal-in-future.po | 139 ++ deprecations/index.po | 344 ++++- library/_thread.po | 17 +- library/array.po | 6 +- library/asyncio.po | 8 +- library/ctypes.po | 123 +- library/ensurepip.po | 9 +- library/fcntl.po | 22 +- library/ftplib.po | 15 +- library/functions.po | 75 +- library/gc.po | 17 +- library/glob.po | 12 +- library/http.client.po | 15 +- library/imaplib.po | 16 +- library/io.po | 20 +- library/marshal.po | 17 +- library/mmap.po | 9 +- library/msvcrt.po | 15 +- library/nntplib.po | 23 +- library/os.po | 195 ++- library/pathlib.po | 10 +- library/pdb.po | 6 +- library/pickle.po | 7 +- library/poplib.po | 24 +- library/pty.po | 7 +- library/resource.po | 11 +- library/shutil.po | 47 +- library/signal.po | 7 +- library/smtplib.po | 21 +- library/socket.po | 93 +- library/sqlite3.po | 22 +- library/subprocess.po | 19 +- library/sys.po | 99 +- library/syslog.po | 21 +- library/telnetlib.po | 15 +- library/tempfile.po | 12 +- library/types.po | 13 +- library/urllib.request.po | 20 +- library/webbrowser.po | 9 +- library/winreg.po | 90 +- reference/datamodel.po | 1338 +++++++++-------- reference/simple_stmts.po | 8 +- using/cmdline.po | 33 +- whatsnew/3.12.po | 474 ++++-- 49 files changed, 2439 insertions(+), 1363 deletions(-) create mode 100644 deprecations/c-api-pending-removal-in-3.14.po create mode 100644 deprecations/c-api-pending-removal-in-3.15.po create mode 100644 deprecations/c-api-pending-removal-in-future.po diff --git a/c-api/file.po b/c-api/file.po index e70cc9d24f..c3522d745b 100644 --- a/c-api/file.po +++ b/c-api/file.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-12 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2023-04-24 20:38+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -157,9 +157,8 @@ msgid "This function is safe to call before :c:func:`Py_Initialize`." msgstr "在 :c:func:`Py_Initialize` 之前呼叫此函式是安全的。" #: ../../c-api/file.rst:90 -msgid "" -"Raises an :ref:`auditing event ` ``setopencodehook`` with no " -"arguments." +#, fuzzy +msgid "Raises an auditing event setopencodehook with no arguments." msgstr "" "不帶引數地引發一個\\ :ref:`稽核事件 (auditing event) ` " "``setopencodehook``。" diff --git a/c-api/init.po b/c-api/init.po index c4201abdb6..b3025e319b 100644 --- a/c-api/init.po +++ b/c-api/init.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-22 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2023-04-24 20:49+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -612,9 +612,9 @@ msgid "" msgstr "" #: ../../c-api/init.rst:421 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``cpython." -"_PySys_ClearAuditHooks`` with no arguments." +"Raises an auditing event cpython._PySys_ClearAuditHooks with no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``cpython." "_PySys_ClearAuditHooks``。" @@ -1417,9 +1417,9 @@ msgid "" msgstr "" #: ../../c-api/init.rst:1227 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``cpython." -"PyInterpreterState_New`` with no arguments." +"Raises an auditing event cpython.PyInterpreterState_New with no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``cpython." "PyInterpreterState_New``。" @@ -1431,9 +1431,9 @@ msgid "" msgstr "" #: ../../c-api/init.rst:1235 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``cpython." -"PyInterpreterState_Clear`` with no arguments." +"Raises an auditing event cpython.PyInterpreterState_Clear with no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``cpython." "PyInterpreterState_Clear``。" diff --git a/c-api/sys.po b/c-api/sys.po index 037e2554b0..73b08e3056 100644 --- a/c-api/sys.po +++ b/c-api/sys.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-12 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 14:07+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -456,10 +456,12 @@ msgstr "" #: ../../c-api/sys.rst:395 msgid "" -"Raises an :ref:`auditing event ` ``sys.addaudithook`` with no " -"arguments." +"If the interpreter is initialized, this function raises an auditing event " +"sys.addaudithook with no arguments. If any existing hooks raise an exception " +"derived from Exception, the new hook will not be added and the exception is " +"cleared. As a result, callers cannot assume that their hook has been added " +"unless they control all existing hooks." msgstr "" -"引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.addaudithook``。" #: ../../c-api/sys.rst:397 msgid "" @@ -544,3 +546,9 @@ msgstr "exit（C 函式）" #: ../../c-api/sys.rst:455 msgid "cleanup functions" msgstr "cleanup functions（清理函式）" + +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``sys.addaudithook`` with no " +#~ "arguments." +#~ msgstr "" +#~ "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.addaudithook``。" diff --git a/deprecations/c-api-pending-removal-in-3.14.po b/deprecations/c-api-pending-removal-in-3.14.po new file mode 100644 index 0000000000..7c5787b5d5 --- /dev/null +++ b/deprecations/c-api-pending-removal-in-3.14.po @@ -0,0 +1,177 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"Language: zh_TW\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:2 +msgid "Pending Removal in Python 3.14" +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:4 +msgid "" +"The ``ma_version_tag`` field in :c:type:`PyDictObject` for extension modules " +"(:pep:`699`; :gh:`101193`)." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:7 +msgid "" +"Creating :c:data:`immutable types ` with mutable " +"bases (:gh:`95388`)." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:10 +msgid "" +"Functions to configure Python's initialization, deprecated in Python 3.11:" +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:12 +msgid "``PySys_SetArgvEx()``: set :c:member:`PyConfig.argv` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:13 +msgid "``PySys_SetArgv()``: set :c:member:`PyConfig.argv` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:14 +msgid "``Py_SetProgramName()``: set :c:member:`PyConfig.program_name` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:15 +msgid "``Py_SetPythonHome()``: set :c:member:`PyConfig.home` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:17 +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:45 +msgid "" +"The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" +"`PyConfig` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:20 +msgid "Global configuration variables:" +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:22 +msgid ":c:var:`Py_DebugFlag`: use :c:member:`PyConfig.parser_debug` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:23 +msgid ":c:var:`Py_VerboseFlag`: use :c:member:`PyConfig.verbose` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:24 +msgid ":c:var:`Py_QuietFlag`: use :c:member:`PyConfig.quiet` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:25 +msgid "" +":c:var:`Py_InteractiveFlag`: use :c:member:`PyConfig.interactive` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:26 +msgid ":c:var:`Py_InspectFlag`: use :c:member:`PyConfig.inspect` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:27 +msgid "" +":c:var:`Py_OptimizeFlag`: use :c:member:`PyConfig.optimization_level` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:28 +msgid ":c:var:`Py_NoSiteFlag`: use :c:member:`PyConfig.site_import` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:29 +msgid "" +":c:var:`Py_BytesWarningFlag`: use :c:member:`PyConfig.bytes_warning` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:30 +msgid "" +":c:var:`Py_FrozenFlag`: use :c:member:`PyConfig.pathconfig_warnings` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:31 +msgid "" +":c:var:`Py_IgnoreEnvironmentFlag`: use :c:member:`PyConfig.use_environment` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:32 +msgid "" +":c:var:`Py_DontWriteBytecodeFlag`: use :c:member:`PyConfig.write_bytecode` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:33 +msgid "" +":c:var:`Py_NoUserSiteDirectory`: use :c:member:`PyConfig." +"user_site_directory` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:34 +msgid "" +":c:var:`Py_UnbufferedStdioFlag`: use :c:member:`PyConfig.buffered_stdio` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:35 +msgid "" +":c:var:`Py_HashRandomizationFlag`: use :c:member:`PyConfig.use_hash_seed` " +"and :c:member:`PyConfig.hash_seed` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:37 +msgid ":c:var:`Py_IsolatedFlag`: use :c:member:`PyConfig.isolated` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:38 +msgid "" +":c:var:`Py_LegacyWindowsFSEncodingFlag`: use :c:member:`PyPreConfig." +"legacy_windows_fs_encoding` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:39 +msgid "" +":c:var:`Py_LegacyWindowsStdioFlag`: use :c:member:`PyConfig." +"legacy_windows_stdio` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:40 +msgid "" +":c:var:`!Py_FileSystemDefaultEncoding`: use :c:member:`PyConfig." +"filesystem_encoding` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:41 +msgid "" +":c:var:`!Py_HasFileSystemDefaultEncoding`: use :c:member:`PyConfig." +"filesystem_encoding` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:42 +msgid "" +":c:var:`!Py_FileSystemDefaultEncodeErrors`: use :c:member:`PyConfig." +"filesystem_errors` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:43 +msgid "" +":c:var:`!Py_UTF8Mode`: use :c:member:`PyPreConfig.utf8_mode` instead. (see :" +"c:func:`Py_PreInitialize`)" +msgstr "" diff --git a/deprecations/c-api-pending-removal-in-3.15.po b/deprecations/c-api-pending-removal-in-3.15.po new file mode 100644 index 0000000000..173866a164 --- /dev/null +++ b/deprecations/c-api-pending-removal-in-3.15.po @@ -0,0 +1,85 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"Language: zh_TW\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:2 +msgid "Pending Removal in Python 3.15" +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:4 +msgid "The bundled copy of ``libmpdecimal``." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:5 +msgid "" +":c:func:`PyImport_ImportModuleNoBlock`: use :c:func:`PyImport_ImportModule` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:6 +msgid "" +":c:func:`PyWeakref_GET_OBJECT`: use :c:func:`!PyWeakref_GetRef` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:7 +msgid ":c:func:`PyWeakref_GetObject`: use :c:func:`!PyWeakref_GetRef` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:8 +msgid ":c:type:`!Py_UNICODE_WIDE` type: use :c:type:`wchar_t` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:9 +msgid ":c:type:`Py_UNICODE` type: use :c:type:`wchar_t` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:10 +msgid "Python initialization functions:" +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:12 +msgid "" +":c:func:`PySys_ResetWarnOptions`: clear :data:`sys.warnoptions` and :data:`!" +"warnings.filters` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:14 +msgid ":c:func:`Py_GetExecPrefix`: get :data:`sys.exec_prefix` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:15 +msgid ":c:func:`Py_GetPath`: get :data:`sys.path` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:16 +msgid ":c:func:`Py_GetPrefix`: get :data:`sys.prefix` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:17 +msgid ":c:func:`Py_GetProgramFullPath`: get :data:`sys.executable` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:18 +msgid ":c:func:`Py_GetProgramName`: get :data:`sys.executable` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:19 +msgid "" +":c:func:`Py_GetPythonHome`: get :c:member:`PyConfig.home` or the :envvar:" +"`PYTHONHOME` environment variable instead." +msgstr "" diff --git a/deprecations/c-api-pending-removal-in-future.po b/deprecations/c-api-pending-removal-in-future.po new file mode 100644 index 0000000000..c0623d6206 --- /dev/null +++ b/deprecations/c-api-pending-removal-in-future.po @@ -0,0 +1,139 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"Language: zh_TW\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:2 +msgid "Pending Removal in Future Versions" +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:4 +msgid "" +"The following APIs are deprecated and will be removed, although there is " +"currently no date scheduled for their removal." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:7 +msgid ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`: unneeded since Python 3.8." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:8 +msgid ":c:func:`PyErr_Fetch`: use :c:func:`PyErr_GetRaisedException` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:9 +msgid "" +":c:func:`PyErr_NormalizeException`: use :c:func:`PyErr_GetRaisedException` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:10 +msgid "" +":c:func:`PyErr_Restore`: use :c:func:`PyErr_SetRaisedException` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:11 +msgid "" +":c:func:`PyModule_GetFilename`: use :c:func:`PyModule_GetFilenameObject` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:12 +msgid ":c:func:`PyOS_AfterFork`: use :c:func:`PyOS_AfterFork_Child` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:13 +msgid "" +":c:func:`PySlice_GetIndicesEx`: use :c:func:`PySlice_Unpack` and :c:func:" +"`PySlice_AdjustIndices` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:14 +msgid "" +":c:func:`!PyUnicode_AsDecodedObject`: use :c:func:`PyCodec_Decode` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:15 +msgid "" +":c:func:`!PyUnicode_AsDecodedUnicode`: use :c:func:`PyCodec_Decode` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:16 +msgid "" +":c:func:`!PyUnicode_AsEncodedObject`: use :c:func:`PyCodec_Encode` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:17 +msgid "" +":c:func:`!PyUnicode_AsEncodedUnicode`: use :c:func:`PyCodec_Encode` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:18 +msgid ":c:func:`PyUnicode_READY`: unneeded since Python 3.12" +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:19 +msgid ":c:func:`!PyErr_Display`: use :c:func:`PyErr_DisplayException` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:20 +msgid "" +":c:func:`!_PyErr_ChainExceptions`: use ``_PyErr_ChainExceptions1`` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:21 +msgid "" +":c:member:`!PyBytesObject.ob_shash` member: call :c:func:`PyObject_Hash` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:23 +msgid ":c:member:`!PyDictObject.ma_version_tag` member." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:24 +msgid "Thread Local Storage (TLS) API:" +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:26 +msgid "" +":c:func:`PyThread_create_key`: use :c:func:`PyThread_tss_alloc` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:27 +msgid ":c:func:`PyThread_delete_key`: use :c:func:`PyThread_tss_free` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:28 +msgid "" +":c:func:`PyThread_set_key_value`: use :c:func:`PyThread_tss_set` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:29 +msgid "" +":c:func:`PyThread_get_key_value`: use :c:func:`PyThread_tss_get` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:30 +msgid "" +":c:func:`PyThread_delete_key_value`: use :c:func:`PyThread_tss_delete` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:31 +msgid ":c:func:`PyThread_ReInitTLS`: unneeded since Python 3.7." +msgstr "" diff --git a/deprecations/index.po b/deprecations/index.po index d7747d4d24..3a2f9977ee 100644 --- a/deprecations/index.po +++ b/deprecations/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-29 00:04+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -192,6 +192,7 @@ msgid "" "en/latest/using.html#migrating-from-legacy>`_ (:gh:`106531`)" msgstr "" +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:2 #: ../../deprecations/pending-removal-in-3.14.rst:2 msgid "Pending Removal in Python 3.14" msgstr "" @@ -402,6 +403,7 @@ msgid "" "`88168`.)" msgstr "" +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:2 #: ../../deprecations/pending-removal-in-3.15.rst:2 msgid "Pending Removal in Python 3.15" msgstr "" @@ -503,6 +505,7 @@ msgid "" "lack of interest. (Contributed by Bénédikt Tran in :gh:`119698`.)" msgstr "" +#: ../../deprecations/c-api-pending-removal-in-future.rst:2 #: ../../deprecations/pending-removal-in-future.rst:2 msgid "Pending Removal in Future Versions" msgstr "" @@ -863,3 +866,342 @@ msgid "" ":meth:`zipimport.zipimporter.load_module` is deprecated: use :meth:" "`~zipimport.zipimporter.exec_module` instead." msgstr "" + +#: ../../deprecations/index.rst:15 +msgid "C API Deprecations" +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:4 +msgid "" +"The ``ma_version_tag`` field in :c:type:`PyDictObject` for extension modules " +"(:pep:`699`; :gh:`101193`)." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:7 +msgid "" +"Creating :c:data:`immutable types ` with mutable " +"bases (:gh:`95388`)." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:10 +msgid "" +"Functions to configure Python's initialization, deprecated in Python 3.11:" +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:12 +msgid "``PySys_SetArgvEx()``: set :c:member:`PyConfig.argv` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:13 +msgid "``PySys_SetArgv()``: set :c:member:`PyConfig.argv` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:14 +msgid "``Py_SetProgramName()``: set :c:member:`PyConfig.program_name` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:15 +msgid "``Py_SetPythonHome()``: set :c:member:`PyConfig.home` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:17 +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:45 +msgid "" +"The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" +"`PyConfig` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:20 +msgid "Global configuration variables:" +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:22 +msgid ":c:var:`Py_DebugFlag`: use :c:member:`PyConfig.parser_debug` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:23 +msgid ":c:var:`Py_VerboseFlag`: use :c:member:`PyConfig.verbose` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:24 +msgid ":c:var:`Py_QuietFlag`: use :c:member:`PyConfig.quiet` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:25 +msgid "" +":c:var:`Py_InteractiveFlag`: use :c:member:`PyConfig.interactive` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:26 +msgid ":c:var:`Py_InspectFlag`: use :c:member:`PyConfig.inspect` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:27 +msgid "" +":c:var:`Py_OptimizeFlag`: use :c:member:`PyConfig.optimization_level` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:28 +msgid ":c:var:`Py_NoSiteFlag`: use :c:member:`PyConfig.site_import` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:29 +msgid "" +":c:var:`Py_BytesWarningFlag`: use :c:member:`PyConfig.bytes_warning` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:30 +msgid "" +":c:var:`Py_FrozenFlag`: use :c:member:`PyConfig.pathconfig_warnings` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:31 +msgid "" +":c:var:`Py_IgnoreEnvironmentFlag`: use :c:member:`PyConfig.use_environment` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:32 +msgid "" +":c:var:`Py_DontWriteBytecodeFlag`: use :c:member:`PyConfig.write_bytecode` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:33 +msgid "" +":c:var:`Py_NoUserSiteDirectory`: use :c:member:`PyConfig." +"user_site_directory` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:34 +msgid "" +":c:var:`Py_UnbufferedStdioFlag`: use :c:member:`PyConfig.buffered_stdio` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:35 +msgid "" +":c:var:`Py_HashRandomizationFlag`: use :c:member:`PyConfig.use_hash_seed` " +"and :c:member:`PyConfig.hash_seed` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:37 +msgid ":c:var:`Py_IsolatedFlag`: use :c:member:`PyConfig.isolated` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:38 +msgid "" +":c:var:`Py_LegacyWindowsFSEncodingFlag`: use :c:member:`PyPreConfig." +"legacy_windows_fs_encoding` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:39 +msgid "" +":c:var:`Py_LegacyWindowsStdioFlag`: use :c:member:`PyConfig." +"legacy_windows_stdio` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:40 +msgid "" +":c:var:`!Py_FileSystemDefaultEncoding`: use :c:member:`PyConfig." +"filesystem_encoding` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:41 +msgid "" +":c:var:`!Py_HasFileSystemDefaultEncoding`: use :c:member:`PyConfig." +"filesystem_encoding` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:42 +msgid "" +":c:var:`!Py_FileSystemDefaultEncodeErrors`: use :c:member:`PyConfig." +"filesystem_errors` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:43 +msgid "" +":c:var:`!Py_UTF8Mode`: use :c:member:`PyPreConfig.utf8_mode` instead. (see :" +"c:func:`Py_PreInitialize`)" +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:4 +msgid "The bundled copy of ``libmpdecimal``." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:5 +msgid "" +":c:func:`PyImport_ImportModuleNoBlock`: use :c:func:`PyImport_ImportModule` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:6 +msgid "" +":c:func:`PyWeakref_GET_OBJECT`: use :c:func:`!PyWeakref_GetRef` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:7 +msgid ":c:func:`PyWeakref_GetObject`: use :c:func:`!PyWeakref_GetRef` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:8 +msgid ":c:type:`!Py_UNICODE_WIDE` type: use :c:type:`wchar_t` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:9 +msgid ":c:type:`Py_UNICODE` type: use :c:type:`wchar_t` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:10 +msgid "Python initialization functions:" +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:12 +msgid "" +":c:func:`PySys_ResetWarnOptions`: clear :data:`sys.warnoptions` and :data:`!" +"warnings.filters` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:14 +msgid ":c:func:`Py_GetExecPrefix`: get :data:`sys.exec_prefix` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:15 +msgid ":c:func:`Py_GetPath`: get :data:`sys.path` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:16 +msgid ":c:func:`Py_GetPrefix`: get :data:`sys.prefix` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:17 +msgid ":c:func:`Py_GetProgramFullPath`: get :data:`sys.executable` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:18 +msgid ":c:func:`Py_GetProgramName`: get :data:`sys.executable` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:19 +msgid "" +":c:func:`Py_GetPythonHome`: get :c:member:`PyConfig.home` or the :envvar:" +"`PYTHONHOME` environment variable instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:4 +msgid "" +"The following APIs are deprecated and will be removed, although there is " +"currently no date scheduled for their removal." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:7 +msgid ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`: unneeded since Python 3.8." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:8 +msgid ":c:func:`PyErr_Fetch`: use :c:func:`PyErr_GetRaisedException` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:9 +msgid "" +":c:func:`PyErr_NormalizeException`: use :c:func:`PyErr_GetRaisedException` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:10 +msgid "" +":c:func:`PyErr_Restore`: use :c:func:`PyErr_SetRaisedException` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:11 +msgid "" +":c:func:`PyModule_GetFilename`: use :c:func:`PyModule_GetFilenameObject` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:12 +msgid ":c:func:`PyOS_AfterFork`: use :c:func:`PyOS_AfterFork_Child` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:13 +msgid "" +":c:func:`PySlice_GetIndicesEx`: use :c:func:`PySlice_Unpack` and :c:func:" +"`PySlice_AdjustIndices` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:14 +msgid "" +":c:func:`!PyUnicode_AsDecodedObject`: use :c:func:`PyCodec_Decode` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:15 +msgid "" +":c:func:`!PyUnicode_AsDecodedUnicode`: use :c:func:`PyCodec_Decode` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:16 +msgid "" +":c:func:`!PyUnicode_AsEncodedObject`: use :c:func:`PyCodec_Encode` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:17 +msgid "" +":c:func:`!PyUnicode_AsEncodedUnicode`: use :c:func:`PyCodec_Encode` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:18 +msgid ":c:func:`PyUnicode_READY`: unneeded since Python 3.12" +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:19 +msgid ":c:func:`!PyErr_Display`: use :c:func:`PyErr_DisplayException` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:20 +msgid "" +":c:func:`!_PyErr_ChainExceptions`: use ``_PyErr_ChainExceptions1`` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:21 +msgid "" +":c:member:`!PyBytesObject.ob_shash` member: call :c:func:`PyObject_Hash` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:23 +msgid ":c:member:`!PyDictObject.ma_version_tag` member." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:24 +msgid "Thread Local Storage (TLS) API:" +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:26 +msgid "" +":c:func:`PyThread_create_key`: use :c:func:`PyThread_tss_alloc` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:27 +msgid ":c:func:`PyThread_delete_key`: use :c:func:`PyThread_tss_free` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:28 +msgid "" +":c:func:`PyThread_set_key_value`: use :c:func:`PyThread_tss_set` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:29 +msgid "" +":c:func:`PyThread_get_key_value`: use :c:func:`PyThread_tss_get` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:30 +msgid "" +":c:func:`PyThread_delete_key_value`: use :c:func:`PyThread_tss_delete` " +"instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-future.rst:31 +msgid ":c:func:`PyThread_ReInitTLS`: unneeded since Python 3.7." +msgstr "" diff --git a/library/_thread.po b/library/_thread.po index cc148fae2f..acbb332af2 100644 --- a/library/_thread.po +++ b/library/_thread.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2015-12-09 17:51+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -32,8 +32,8 @@ msgid "" "level threading API built on top of this module." msgstr "" "這個模組提供了與多個執行緒（也稱為:dfn:`輕量級行程` 或 :dfn: `任務`）一起工作" -"的低階原始物件 --- 多個控制執行緒分享其全域資料空間。為了處理同步問題，也提供了簡" -"單的鎖 (lock) 機制（也稱為:dfn:`互斥鎖` 或 :dfn:`二進位號誌`）。 :mod:" +"的低階原始物件 --- 多個控制執行緒分享其全域資料空間。為了處理同步問題，也提供" +"了簡單的鎖 (lock) 機制（也稱為:dfn:`互斥鎖` 或 :dfn:`二進位號誌`）。 :mod:" "`threading` 模組提供了一個建立在這個模組之上的更易於使用和高階的執行緒 API。" #: ../../library/_thread.rst:26 @@ -77,9 +77,9 @@ msgid "" "the hook argument is *function*. By default, a stack trace is printed and " "then the thread exits (but other threads continue to run)." msgstr "" -"當函式因未處理的例外終止時，將呼叫 :func:`sys.unraisablehook` 來處理該例外。鉤" -"子引數的 *object* 屬性是 *function*。預設情況下，會列印堆疊跟蹤，然後執行緒退" -"出（但其他執行緒會繼續運行）。" +"當函式因未處理的例外終止時，將呼叫 :func:`sys.unraisablehook` 來處理該例外。" +"鉤子引數的 *object* 屬性是 *function*。預設情況下，會列印堆疊跟蹤，然後執行緒" +"退出（但其他執行緒會繼續運行）。" #: ../../library/_thread.rst:57 msgid "" @@ -88,9 +88,10 @@ msgid "" msgstr "當函式引發 :exc:`SystemExit` 例外時，它會被靜默忽略。" #: ../../library/_thread.rst:60 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``_thread.start_new_thread`` with " -"arguments ``function``, ``args``, ``kwargs``." +"Raises an auditing event _thread.start_new_thread with arguments function, " +"args, kwargs." msgstr "" "引發一個 :ref:`稽核事件 ` ``_thread.start_new_thread``，帶有引數 " "``function``、``args`` 和 ``kwargs``。" diff --git a/library/array.po b/library/array.po index 0ca003ede8..f6388bdc6d 100644 --- a/library/array.po +++ b/library/array.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2021-11-23 18:40+0800\n" "Last-Translator: Benson Chen \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -280,9 +280,9 @@ msgstr "" "的地方使用。" #: ../../library/array.rst:96 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``array.__new__`` with arguments " -"``typecode``, ``initializer``." +"Raises an auditing event array.__new__ with arguments typecode, initializer." msgstr "" "引發\\ :ref:`稽核事件 (auditing event) ` ``array.__new__`` 並帶入引" "數 ``typecode``、``initializer``。" diff --git a/library/asyncio.po b/library/asyncio.po index 69b0a726cd..236d438943 100644 --- a/library/asyncio.po +++ b/library/asyncio.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-23 00:04+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2021-11-23 12:40+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -148,10 +148,8 @@ msgstr "" msgid "You can experiment with an ``asyncio`` concurrent context in the REPL:" msgstr "你能在 REPL 中對一個 ``asyncio`` 的並行情境 (context) 進行實驗：" -#: ../../library/asyncio.rst:88 -msgid "" -"Raises an :ref:`auditing event ` ``cpython.run_stdin`` with no " -"arguments." +#: ../../library/asyncio.rst:77 +msgid "Raises an auditing event cpython.run_stdin with no arguments." msgstr "" #: ../../library/asyncio.rst:79 diff --git a/library/ctypes.po b/library/ctypes.po index ff1bb2f892..e23c1d66de 100644 --- a/library/ctypes.po +++ b/library/ctypes.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-23 00:04+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2023-04-26 02:59+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1527,10 +1527,9 @@ msgstr "" #: ../../library/ctypes.rst:1580 msgid "" -"Raises an :ref:`auditing event ` ``ctypes.dlopen`` with argument " -"``name``." +"Loading a library through any of these objects raises an auditing event " +"ctypes.dlopen with string argument name, the name used to load the library." msgstr "" -"引發一個附帶引數 ``name`` 的\\ :ref:`稽核事件 ` ``ctypes.dlopen``。" #: ../../library/ctypes.rst:1582 msgid "" @@ -1540,13 +1539,11 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:1586 -#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``ctypes.dlsym`` with arguments " -"``library``, ``name``." +"Accessing a function on a loaded library raises an auditing event ctypes." +"dlsym with arguments library (the library object) and name (the symbol's " +"name as a string or integer)." msgstr "" -"引發一個附帶引數 ``library``、``name`` 的\\ :ref:`稽核事件 ` " -"``ctypes.dlsym``。" #: ../../library/ctypes.rst:1588 msgid "" @@ -1556,13 +1553,11 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:1592 -#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``ctypes.dlsym/handle`` with " -"arguments ``handle``, ``name``." +"In cases when only the library handle is available rather than the object, " +"accessing a function raises an auditing event ctypes.dlsym/handle with " +"arguments handle (the raw library handle) and name." msgstr "" -"引發一個附帶引數 ``handle``、``name`` 的\\ :ref:`稽核事件 ` " -"``ctypes.dlsym/handle``。" #: ../../library/ctypes.rst:1594 msgid "" @@ -1681,13 +1676,13 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:1683 -#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``ctypes.set_exception`` with " -"argument ``code``." +"On Windows, when a foreign function call raises a system exception (for " +"example, due to an access violation), it will be captured and replaced with " +"a suitable Python exception. Further, an auditing event ctypes.set_exception " +"with argument code will be raised, allowing an audit hook to replace the " +"exception with its own." msgstr "" -"引發一個附帶引數 ``code`` 的\\ :ref:`稽核事件 ` ``ctypes." -"set_exception``。" #: ../../library/ctypes.rst:1685 msgid "" @@ -1701,8 +1696,8 @@ msgstr "" #: ../../library/ctypes.rst:1691 #, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``ctypes.call_function`` with " -"arguments ``func_pointer``, ``arguments``." +"Some ways to invoke foreign function calls may raise an auditing event " +"ctypes.call_function with arguments function pointer and arguments." msgstr "" "引發一個附帶引數 ``func_pointer``、``arguments`` 的\\ :ref:`稽核事件 " "` ``ctypes.call_function``。" @@ -1909,9 +1904,8 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:1886 -msgid "" -"Raises an :ref:`auditing event ` ``ctypes.addressof`` with " -"argument ``obj``." +#, fuzzy +msgid "Raises an auditing event ctypes.addressof with argument obj." msgstr "" "引發一個附帶引數 ``obj`` 的\\ :ref:`稽核事件 ` ``ctypes." "addressof``。" @@ -1969,9 +1963,10 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:1930 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``ctypes.create_string_buffer`` " -"with arguments ``init``, ``size``." +"Raises an auditing event ctypes.create_string_buffer with arguments init, " +"size." msgstr "" "引發一個附帶引數 ``init`` 與 ``size`` 的\\ :ref:`稽核事件 ` " "``ctypes.create_string_buffer``。" @@ -1998,9 +1993,10 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:1947 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``ctypes.create_unicode_buffer`` " -"with arguments ``init``, ``size``." +"Raises an auditing event ctypes.create_unicode_buffer with arguments init, " +"size." msgstr "" "引發一個附帶引數 ``init`` 與 ``size`` 的\\ :ref:`稽核事件 ` " "``ctypes.create_unicode_buffer``。" @@ -2062,9 +2058,8 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:2005 -msgid "" -"Raises an :ref:`auditing event ` ``ctypes.get_errno`` with no " -"arguments." +#, fuzzy +msgid "Raises an auditing event ctypes.get_errno with no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``ctypes.get_errno``。" @@ -2075,9 +2070,8 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:2012 -msgid "" -"Raises an :ref:`auditing event ` ``ctypes.get_last_error`` with no " -"arguments." +#, fuzzy +msgid "Raises an auditing event ctypes.get_last_error with no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``ctypes.get_last_error``。" @@ -2129,9 +2123,8 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:2057 -msgid "" -"Raises an :ref:`auditing event ` ``ctypes.set_errno`` with " -"argument ``errno``." +#, fuzzy +msgid "Raises an auditing event ctypes.set_errno with argument errno." msgstr "" "引發一個附帶引數 ``errno`` 的\\ :ref:`稽核事件 ` ``ctypes." "set_errno``。" @@ -2144,9 +2137,8 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:2066 -msgid "" -"Raises an :ref:`auditing event ` ``ctypes.set_last_error`` with " -"argument ``error``." +#, fuzzy +msgid "Raises an auditing event ctypes.set_last_error with argument error." msgstr "" "引發一個附帶引數 ``error`` 的\\ :ref:`稽核事件 ` ``ctypes." "get_last_error``。" @@ -2164,9 +2156,8 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:2081 -msgid "" -"Raises an :ref:`auditing event ` ``ctypes.string_at`` with " -"arguments ``ptr``, ``size``." +#, fuzzy +msgid "Raises an auditing event ctypes.string_at with arguments ptr, size." msgstr "" "引發一個附帶引數 ``ptr``、``size`` 的\\ :ref:`稽核事件 ` ``ctypes." "string_at``。" @@ -2194,9 +2185,8 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:2104 -msgid "" -"Raises an :ref:`auditing event ` ``ctypes.wstring_at`` with " -"arguments ``ptr``, ``size``." +#, fuzzy +msgid "Raises an auditing event ctypes.wstring_at with arguments ptr, size." msgstr "" "引發一個附帶引數 ``ptr``、``size`` 的\\ :ref:`稽核事件 ` ``ctypes." "wstring_at``。" @@ -2231,9 +2221,10 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:2133 ../../library/ctypes.rst:2143 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``ctypes.cdata/buffer`` with " -"arguments ``pointer``, ``size``, ``offset``." +"Raises an auditing event ctypes.cdata/buffer with arguments pointer, size, " +"offset." msgstr "" "引發一個附帶引數 ``pointer``、``size``、``offset`` 的\\ :ref:`稽核事件 " "` ``ctypes.cdata/buffer``。" @@ -2253,9 +2244,10 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:2150 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``ctypes.cdata`` with argument " -"``address``." +"This method, and others that indirectly call this method, raises an auditing " +"event ctypes.cdata with argument address." msgstr "" "引發一個附帶引數 ``address`` 的\\ :ref:`稽核事件 ` ``ctypes." "cdata``。" @@ -2773,5 +2765,36 @@ msgid "" "changes the pointer to point to the assigned object." msgstr "" +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``ctypes.dlopen`` with " +#~ "argument ``name``." +#~ msgstr "" +#~ "引發一個附帶引數 ``name`` 的\\ :ref:`稽核事件 ` ``ctypes." +#~ "dlopen``。" + +#, fuzzy +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``ctypes.dlsym`` with " +#~ "arguments ``library``, ``name``." +#~ msgstr "" +#~ "引發一個附帶引數 ``library``、``name`` 的\\ :ref:`稽核事件 ` " +#~ "``ctypes.dlsym``。" + +#, fuzzy +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``ctypes.dlsym/handle`` with " +#~ "arguments ``handle``, ``name``." +#~ msgstr "" +#~ "引發一個附帶引數 ``handle``、``name`` 的\\ :ref:`稽核事件 ` " +#~ "``ctypes.dlsym/handle``。" + +#, fuzzy +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``ctypes.set_exception`` with " +#~ "argument ``code``." +#~ msgstr "" +#~ "引發一個附帶引數 ``code`` 的\\ :ref:`稽核事件 ` ``ctypes." +#~ "set_exception``。" + #~ msgid ":c:expr:`size_t`" #~ msgstr ":c:expr:`size_t`" diff --git a/library/ensurepip.po b/library/ensurepip.po index 006cbf3f05..c6044ea1f2 100644 --- a/library/ensurepip.po +++ b/library/ensurepip.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:01+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -236,10 +236,9 @@ msgid "" msgstr "" "*verbosity* 用來控制初始建置操作內，對於 :data:`sys.stdout` 的輸出等級。" -#: ../../library/ensurepip.rst:136 -msgid "" -"Raises an :ref:`auditing event ` ``ensurepip.bootstrap`` with " -"argument ``root``." +#: ../../library/ensurepip.rst:125 +#, fuzzy +msgid "Raises an auditing event ensurepip.bootstrap with argument root." msgstr "" "引發一個附帶引數 ``root`` 的\\ :ref:`稽核事件 ` ``ensurepip." "bootstrap``。" diff --git a/library/fcntl.po b/library/fcntl.po index c9bcddee77..b6900c9079 100644 --- a/library/fcntl.po +++ b/library/fcntl.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2017-09-22 18:26+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -114,9 +114,8 @@ msgid "If the :c:func:`fcntl` call fails, an :exc:`OSError` is raised." msgstr "" #: ../../library/fcntl.rst:85 -msgid "" -"Raises an :ref:`auditing event ` ``fcntl.fcntl`` with arguments " -"``fd``, ``cmd``, ``arg``." +#, fuzzy +msgid "Raises an auditing event fcntl.fcntl with arguments fd, cmd, arg." msgstr "" "引發一個附帶引數 ``fd``、``cmd``、``arg`` 的\\ :ref:`稽核事件 ` " "``fcntl.fcntl``。" @@ -183,9 +182,8 @@ msgid "An example::" msgstr "範例： ::" #: ../../library/fcntl.rst:136 -msgid "" -"Raises an :ref:`auditing event ` ``fcntl.ioctl`` with arguments " -"``fd``, ``request``, ``arg``." +#, fuzzy +msgid "Raises an auditing event fcntl.ioctl with arguments fd, request, arg." msgstr "" "引發一個附帶引數 ``fd``、``request``、``arg`` 的\\ :ref:`稽核事件 " "` ``fcntl.ioctl``。" @@ -204,9 +202,8 @@ msgid "" msgstr "" #: ../../library/fcntl.rst:148 -msgid "" -"Raises an :ref:`auditing event ` ``fcntl.flock`` with arguments " -"``fd``, ``operation``." +#, fuzzy +msgid "Raises an auditing event fcntl.flock with arguments fd, operation." msgstr "" "引發一個附帶引數 ``fd``、``operation`` 的\\ :ref:`稽核事件 ` " "``fcntl.flock``。" @@ -274,9 +271,10 @@ msgid "" msgstr "" #: ../../library/fcntl.rst:194 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``fcntl.lockf`` with arguments " -"``fd``, ``cmd``, ``len``, ``start``, ``whence``." +"Raises an auditing event fcntl.lockf with arguments fd, cmd, len, start, " +"whence." msgstr "" "引發一個附帶引數 ``fd``、``cmd``、``len``、``start``、``whence`` 的\\ :ref:`" "稽核事件 ` ``fcntl.lockf``。" diff --git a/library/ftplib.po b/library/ftplib.po index 06d50d04d5..e9a3660b6c 100644 --- a/library/ftplib.po +++ b/library/ftplib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-14 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2023-04-26 19:44+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -213,10 +213,10 @@ msgid "" "timeout setting)." msgstr "連線嘗試的超時設定，以秒為單位（預設：全域預設超時設定）。" -#: ../../library/ftplib.rst:198 +#: ../../library/ftplib.rst:187 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``ftplib.connect`` with arguments " -"``self``, ``host``, ``port``." +"Raises an auditing event ftplib.connect with arguments self, host, port." msgstr "" "引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " "` ``ftplib.connect``。" @@ -257,10 +257,9 @@ msgid "" "Send a simple command string to the server and return the response string." msgstr "向伺服器發送一個簡單的命令字串並回傳回應字串。" -#: ../../library/ftplib.rst:240 ../../library/ftplib.rst:249 -msgid "" -"Raises an :ref:`auditing event ` ``ftplib.sendcmd`` with arguments " -"``self``, ``cmd``." +#: ../../library/ftplib.rst:229 ../../library/ftplib.rst:238 +#, fuzzy +msgid "Raises an auditing event ftplib.sendcmd with arguments self, cmd." msgstr "" "引發一個附帶引數 ``self``、``cmd`` 的\\ :ref:`稽核事件 ` ``ftplib." "sendcmd``。" diff --git a/library/functions.po b/library/functions.po index 527eee9156..1192f2c527 100644 --- a/library/functions.po +++ b/library/functions.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2024-05-06 17:06+0800\n" "Last-Translator: KNChiu \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -547,9 +547,9 @@ msgid "" msgstr "請注意，如果 :func:`sys.breakpointhook` 被替換了，則無法保證此功能。" #: ../../library/functions.rst:180 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``builtins.breakpoint`` with " -"argument ``breakpointhook``." +"Raises an auditing event builtins.breakpoint with argument breakpointhook." msgstr "" "引發一個附帶引數 ``breakpointhook`` 的\\ :ref:`稽核事件 ` " "``builtins.breakpoint``。" @@ -838,12 +838,13 @@ msgid "" msgstr "如果您想解析 Python 程式碼為 AST 運算式，請參閱 :func:`ast.parse`。" #: ../../library/functions.rst:343 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``compile`` with arguments " -"``source``, ``filename``." +"Raises an auditing event compile with arguments source and filename. This " +"event may also be raised by implicit compilation." msgstr "" "引發一個附帶引數 ``source``、``filename`` 的\\ :ref:`稽核事件 ` " -"``compile``。" +"``compile``。此事件也可能由隱式編譯 (implicit compilation) 所引發。" #: ../../library/functions.rst:345 msgid "" @@ -1214,11 +1215,13 @@ msgstr "" "串。" #: ../../library/functions.rst:626 ../../library/functions.rst:671 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``exec`` with argument " -"``code_object``." +"Raises an auditing event exec with the code object as the argument. Code " +"compilation events may also be raised." msgstr "" -"引發一個附帶引數 ``code_object`` 的\\ :ref:`稽核事件 ` ``exec``。" +"引發一個附帶程式碼物件為引數的\\ :ref:`稽核事件 ` ``exec``。也可能" +"會引發程式碼編譯事件。" #: ../../library/functions.rst:628 ../../library/functions.rst:673 msgid "" @@ -1623,9 +1626,8 @@ msgid "This is the address of the object in memory." msgstr "這是該物件在記憶體中的位址。" #: ../../library/functions.rst:929 -msgid "" -"Raises an :ref:`auditing event ` ``builtins.id`` with argument " -"``id``." +#, fuzzy +msgid "Raises an auditing event builtins.id with argument id." msgstr "" "引發一個附帶引數 ``id`` 的\\ :ref:`稽核事件 ` ``builtins.id``。" @@ -1649,12 +1651,13 @@ msgstr "" "歷史記錄功能。" #: ../../library/functions.rst:948 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``builtins.input`` with argument " -"``prompt``." +"Raises an auditing event builtins.input with argument prompt before reading " +"input" msgstr "" -"引發一個附帶引數 ``prompt`` 的\\ :ref:`稽核事件 ` ``builtins." -"input``。" +"引發一個附帶讀取輸入前的引數 ``prompt`` 的\\ :ref:`稽核事件 ` " +"``builtins.input``。" #: ../../library/functions.rst:950 msgid "" @@ -1665,11 +1668,12 @@ msgstr "" "``builtins.input``。" #: ../../library/functions.rst:953 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``builtins.input/result`` with " -"argument ``result``." +"Raises an auditing event builtins.input/result with the result after " +"successfully reading input." msgstr "" -"引發一個附帶引數 ``result`` 的\\ :ref:`稽核事件 ` ``builtins.input/" +"引發一個附帶成功讀取結果的\\ :ref:`稽核事件 ` ``builtins.input/" "result``。" #: ../../library/functions.rst:955 @@ -2423,9 +2427,8 @@ msgstr "" "`shutil`。" #: ../../library/functions.rst:1443 -msgid "" -"Raises an :ref:`auditing event ` ``open`` with arguments ``path``, " -"``mode``, ``flags``." +#, fuzzy +msgid "Raises an auditing event open with arguments path, mode, flags." msgstr "" "引發一個附帶引數 ``path``、``model``、``path`` 的\\ :ref:`稽核事件 " "` ``open``。" @@ -3442,3 +3445,31 @@ msgstr "import（引入）" #: ../../library/functions.rst:2111 msgid "builtins" msgstr "builtins（內建）" + +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``compile`` with arguments " +#~ "``source``, ``filename``." +#~ msgstr "" +#~ "引發一個附帶引數 ``source``、``filename`` 的\\ :ref:`稽核事件 ` " +#~ "``compile``。" + +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``exec`` with argument " +#~ "``code_object``." +#~ msgstr "" +#~ "引發一個附帶引數 ``code_object`` 的\\ :ref:`稽核事件 ` " +#~ "``exec``。" + +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``builtins.input`` with " +#~ "argument ``prompt``." +#~ msgstr "" +#~ "引發一個附帶引數 ``prompt`` 的\\ :ref:`稽核事件 ` ``builtins." +#~ "input``。" + +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``builtins.input/result`` with " +#~ "argument ``result``." +#~ msgstr "" +#~ "引發一個附帶引數 ``result`` 的\\ :ref:`稽核事件 ` ``builtins." +#~ "input/result``。" diff --git a/library/gc.po b/library/gc.po index 8947c5145a..5392bccf09 100644 --- a/library/gc.po +++ b/library/gc.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2023-04-24 21:25+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -119,9 +119,8 @@ msgid "New *generation* parameter." msgstr "新增 *generation* 參數。" #: ../../library/gc.rst:78 -msgid "" -"Raises an :ref:`auditing event ` ``gc.get_objects`` with argument " -"``generation``." +#, fuzzy +msgid "Raises an auditing event gc.get_objects with argument generation." msgstr "" "引發一個附帶引數 ``generation`` 的\\ :ref:`稽核事件 (auditing event) " "` ``gc.get_objects``。" @@ -235,9 +234,8 @@ msgstr "" "目的。" #: ../../library/gc.rst:149 -msgid "" -"Raises an :ref:`auditing event ` ``gc.get_referrers`` with " -"argument ``objs``." +#, fuzzy +msgid "Raises an auditing event gc.get_referrers with argument objs." msgstr "" "引發一個附帶引數 ``objs`` 的\\ :ref:`稽核事件 ` ``gc." "get_referrers``。" @@ -261,9 +259,8 @@ msgstr "" "或不出現在結果的 list 當中。" #: ../../library/gc.rst:162 -msgid "" -"Raises an :ref:`auditing event ` ``gc.get_referents`` with " -"argument ``objs``." +#, fuzzy +msgid "Raises an auditing event gc.get_referents with argument objs." msgstr "" "引發一個附帶引數 ``objs`` 的\\ :ref:`稽核事件 ` ``gc." "get_referents``。" diff --git a/library/glob.po b/library/glob.po index 81927c319b..ac79936420 100644 --- a/library/glob.po +++ b/library/glob.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2023-01-24 01:21+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -118,17 +118,17 @@ msgid "" msgstr "如果 *include_hidden* 為真，\"``**``\" 模式將匹配被隱藏的目錄。" #: ../../library/glob.rst:73 ../../library/glob.rst:100 -msgid "" -"Raises an :ref:`auditing event ` ``glob.glob`` with arguments " -"``pathname``, ``recursive``." +#, fuzzy +msgid "Raises an auditing event glob.glob with arguments pathname, recursive." msgstr "" "引發一個附帶引數 ``pathname``、``recursive`` 的\\ :ref:`稽核事件 ` " "``glob.glob``。" #: ../../library/glob.rst:74 ../../library/glob.rst:101 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``glob.glob/2`` with arguments " -"``pathname``, ``recursive``, ``root_dir``, ``dir_fd``." +"Raises an auditing event glob.glob/2 with arguments pathname, recursive, " +"root_dir, dir_fd." msgstr "" "引發一個附帶引數 ``pathname``、``recursive``、``root_dir``、``dir_fd`` 的\\ :" "ref:`稽核事件 ` ``glob.glob/2``。" diff --git a/library/http.client.po b/library/http.client.po index 7f37515ef3..10051a3e80 100644 --- a/library/http.client.po +++ b/library/http.client.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:03+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -443,10 +443,10 @@ msgid "" "already have a connection." msgstr "" -#: ../../library/http.client.rst:415 +#: ../../library/http.client.rst:404 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``http.client.connect`` with " -"arguments ``self``, ``host``, ``port``." +"Raises an auditing event http.client.connect with arguments self, host, port." msgstr "" "引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " "` ``http.client.connect``。" @@ -522,10 +522,9 @@ msgid "" "`endheaders` method has been called and before :meth:`getresponse` is called." msgstr "" -#: ../../library/http.client.rst:485 -msgid "" -"Raises an :ref:`auditing event ` ``http.client.send`` with " -"arguments ``self``, ``data``." +#: ../../library/http.client.rst:474 +#, fuzzy +msgid "Raises an auditing event http.client.send with arguments self, data." msgstr "" "引發一個附帶引數 ``self``、``data`` 的\\ :ref:`稽核事件 ` ``http." "client.send``。" diff --git a/library/imaplib.po b/library/imaplib.po index 995f89c9b1..b6490a1591 100644 --- a/library/imaplib.po +++ b/library/imaplib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:04+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -419,10 +419,9 @@ msgid "" "You may override this method." msgstr "" -#: ../../library/imaplib.rst:382 -msgid "" -"Raises an :ref:`auditing event ` ``imaplib.open`` with arguments " -"``self``, ``host``, ``port``." +#: ../../library/imaplib.rst:371 +#, fuzzy +msgid "Raises an auditing event imaplib.open with arguments self, host, port." msgstr "" "引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " "` ``imaplib.open``。" @@ -493,10 +492,9 @@ msgstr "" msgid "Sends ``data`` to the remote server. You may override this method." msgstr "" -#: ../../library/imaplib.rst:455 -msgid "" -"Raises an :ref:`auditing event ` ``imaplib.send`` with arguments " -"``self``, ``data``." +#: ../../library/imaplib.rst:444 +#, fuzzy +msgid "Raises an auditing event imaplib.send with arguments self, data." msgstr "" "引發一個附帶引數 ``self``、``data`` 的\\ :ref:`稽核事件 ` " "``imaplib.send``。" diff --git a/library/io.po b/library/io.po index fd6d0776c8..dc289a6a9c 100644 --- a/library/io.po +++ b/library/io.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2023-12-08 00:08+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -279,12 +279,15 @@ msgid "This is an alias for the builtin :func:`open` function." msgstr "這是內建函式 :func:`open` 的別名。" #: ../../library/io.rst:175 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``open`` with arguments ``path``, " -"``mode``, ``flags``." +"This function raises an auditing event open with arguments path, mode and " +"flags. The mode and flags arguments may have been modified or inferred from " +"the original call." msgstr "" -"引發一個附帶引數 ``path``、``mode``、``flags`` 的\\ :ref:`稽核事件 " -"` ``open``。" +"此函式會引發一個帶有引數 *path*、*mode* 以及 *flags* 的\\ :ref:`稽核事件 " +"(auditing event) ` ``open``。*mode* 與 *flags* 引數可能已經被修改或" +"者從原始呼叫中被推斷出來。" #: ../../library/io.rst:177 msgid "" @@ -1819,3 +1822,10 @@ msgstr "io.TextIOWrapper 類別" #: ../../library/io.rst:1121 msgid "io.IncrementalNewlineDecoder class" msgstr "io.IncrementalNewlineDecoder 類別" + +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``open`` with arguments " +#~ "``path``, ``mode``, ``flags``." +#~ msgstr "" +#~ "引發一個附帶引數 ``path``、``mode``、``flags`` 的\\ :ref:`稽核事件 " +#~ "` ``open``。" diff --git a/library/marshal.po b/library/marshal.po index d589f81336..dd20fa167f 100644 --- a/library/marshal.po +++ b/library/marshal.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2023-04-24 21:28+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -131,9 +131,8 @@ msgid "" msgstr "*version* 引數指明 ``dump`` 應該使用的資料格式（見下文）。" #: ../../library/marshal.rst:69 ../../library/marshal.rst:101 -msgid "" -"Raises an :ref:`auditing event ` ``marshal.dumps`` with arguments " -"``value``, ``version``." +#, fuzzy +msgid "Raises an auditing event marshal.dumps with arguments value, version." msgstr "" "引發一個附帶引數 ``value`` 與 ``version`` 的\\ :ref:`稽核事件 (auditing " "event) ` ``marshal.dumps``。" @@ -150,9 +149,8 @@ msgstr "" "`ValueError` 或 :exc:`TypeError`。檔案必須為可讀取的 :term:`binary file`。" #: ../../library/marshal.rst:79 -msgid "" -"Raises an :ref:`auditing event ` ``marshal.load`` with no " -"arguments." +#, fuzzy +msgid "Raises an auditing event marshal.load with no arguments." msgstr "引發一個沒有附帶引數的\\ :ref:`稽核事件 ` ``marshal.load``。" #: ../../library/marshal.rst:83 @@ -198,9 +196,8 @@ msgstr "" "略。" #: ../../library/marshal.rst:110 -msgid "" -"Raises an :ref:`auditing event ` ``marshal.loads`` with argument " -"``bytes``." +#, fuzzy +msgid "Raises an auditing event marshal.loads with argument bytes." msgstr "" "引發一個附帶引數 ``bytes`` 的\\ :ref:`稽核事件 ` ``marshal." "loads``。" diff --git a/library/mmap.po b/library/mmap.po index 0dd60bf1ec..4e991b10e6 100644 --- a/library/mmap.po +++ b/library/mmap.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:06+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -121,10 +121,11 @@ msgid "" "`ALLOCATIONGRANULARITY`." msgstr "" -#: ../../library/mmap.rst:83 ../../library/mmap.rst:174 +#: ../../library/mmap.rst:72 ../../library/mmap.rst:163 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``mmap.__new__`` with arguments " -"``fileno``, ``length``, ``access``, ``offset``." +"Raises an auditing event mmap.__new__ with arguments fileno, length, access, " +"offset." msgstr "" "引發一個附帶引數 ``fileno``、``length``、``access``、``offset`` 的\\ :ref:`稽" "核事件 ` ``mmap.__new__``。" diff --git a/library/msvcrt.po b/library/msvcrt.po index 526d18240f..88906ec139 100644 --- a/library/msvcrt.po +++ b/library/msvcrt.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:06+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -66,9 +66,9 @@ msgid "" msgstr "" #: ../../library/msvcrt.rst:45 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``msvcrt.locking`` with arguments " -"``fd``, ``mode``, ``nbytes``." +"Raises an auditing event msvcrt.locking with arguments fd, mode, nbytes." msgstr "" "引發一個附帶引數 ``fd``、``mode``、``nbytes`` 的\\ :ref:`稽核事件 " "` ``msvcrt.locking``。" @@ -106,9 +106,9 @@ msgid "" msgstr "" #: ../../library/msvcrt.rst:82 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``msvcrt.open_osfhandle`` with " -"arguments ``handle``, ``flags``." +"Raises an auditing event msvcrt.open_osfhandle with arguments handle, flags." msgstr "" "引發一個附帶引數 ``arguments``、``handle``、``flags`` 的\\ :ref:`稽核事件 " "` ``msvcrt.open_osfhandle``。" @@ -120,9 +120,8 @@ msgid "" msgstr "" #: ../../library/msvcrt.rst:90 -msgid "" -"Raises an :ref:`auditing event ` ``msvcrt.get_osfhandle`` with " -"argument ``fd``." +#, fuzzy +msgid "Raises an auditing event msvcrt.get_osfhandle with argument fd." msgstr "" "引發一個附帶引數 ``fd`` 的\\ :ref:`稽核事件 ` ``msvcrt." "get_osfhandle``。" diff --git a/library/nntplib.po b/library/nntplib.po index d8f3b4c026..ae18e59a00 100644 --- a/library/nntplib.po +++ b/library/nntplib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-07-17 17:39+0800\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:06+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -85,21 +85,19 @@ msgid "" "close the NNTP connection when done, e.g.:" msgstr "" -#: ../../library/nntplib.rst:116 ../../library/nntplib.rst:148 +#: ../../library/nntplib.rst:105 ../../library/nntplib.rst:137 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``nntplib.connect`` with " -"arguments ``self``, ``host``, ``port``." +"Raises an auditing event nntplib.connect with arguments self, host, port." msgstr "" "引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " "` ``nntplib.connect``。" -#: ../../library/nntplib.rst:118 ../../library/nntplib.rst:150 +#: ../../library/nntplib.rst:107 ../../library/nntplib.rst:139 msgid "" -"Raises an :ref:`auditing event ` ``nntplib.putline`` with " -"arguments ``self``, ``line``." +"All commands will raise an auditing event nntplib.putline with arguments " +"self and line, where line is the bytes about to be sent to the remote host." msgstr "" -"引發一個附帶引數 ``self``、``line`` 的\\ :ref:`稽核事件 ` " -"``nntplib.putline``。" #: ../../library/nntplib.rst:109 ../../library/nntplib.rst:141 msgid "" @@ -588,3 +586,10 @@ msgstr "protocol（協定）" #: ../../library/nntplib.rst:10 msgid "Network News Transfer Protocol" msgstr "Network News Transfer Protocol（網路新聞傳輸協定）" + +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``nntplib.putline`` with " +#~ "arguments ``self``, ``line``." +#~ msgstr "" +#~ "引發一個附帶引數 ``self``、``line`` 的\\ :ref:`稽核事件 ` " +#~ "``nntplib.putline``。" diff --git a/library/os.po b/library/os.po index eb4394cb83..89288a3ca3 100644 --- a/library/os.po +++ b/library/os.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-23 00:04+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2024-04-29 15:24+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -706,9 +706,8 @@ msgid "" msgstr "" #: ../../library/os.rst:569 -msgid "" -"Raises an :ref:`auditing event ` ``os.putenv`` with arguments " -"``key``, ``value``." +#, fuzzy +msgid "Raises an auditing event os.putenv with arguments key, value." msgstr "" "引發一個附帶引數 ``key``、``value`` 的\\ :ref:`稽核事件 ` ``os." "putenv``。" @@ -929,9 +928,8 @@ msgid "" msgstr "" #: ../../library/os.rst:807 -msgid "" -"Raises an :ref:`auditing event ` ``os.unsetenv`` with argument " -"``key``." +#, fuzzy +msgid "Raises an auditing event os.unsetenv with argument key." msgstr "" "引發一個附帶引數 ``key`` 的\\ :ref:`稽核事件 ` ``os.unsetenv``。" @@ -1138,9 +1136,8 @@ msgstr "" #: ../../library/os.rst:1002 ../../library/os.rst:2069 #: ../../library/os.rst:2166 -msgid "" -"Raises an :ref:`auditing event ` ``os.chmod`` with arguments " -"``path``, ``mode``, ``dir_fd``." +#, fuzzy +msgid "Raises an auditing event os.chmod with arguments path, mode, dir_fd." msgstr "" "引發一個附帶引數 ``path``、``mode``、``dir_fd`` 的\\ :ref:`稽核事件 " "` ``os.chmod``。" @@ -1163,9 +1160,9 @@ msgstr "" #: ../../library/os.rst:1017 ../../library/os.rst:2091 #: ../../library/os.rst:2179 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``os.chown`` with arguments " -"``path``, ``uid``, ``gid``, ``dir_fd``." +"Raises an auditing event os.chown with arguments path, uid, gid, dir_fd." msgstr "" "引發一個附帶引數 ``path``、``uid``、``gid``、``dir_fd`` 的\\ :ref:`稽核事件 " "` ``os.chown``。" @@ -1246,9 +1243,8 @@ msgid "" msgstr "" #: ../../library/os.rst:1095 -msgid "" -"Raises an :ref:`auditing event ` ``os.truncate`` with arguments " -"``fd``, ``length``." +#, fuzzy +msgid "Raises an auditing event os.truncate with arguments fd, length." msgstr "" "引發一個附帶引數 ``fd``、``length`` 的\\ :ref:`稽核事件 ` ``os." "truncate``。" @@ -1290,10 +1286,11 @@ msgid "" msgstr "" #: ../../library/os.rst:1136 -msgid "" -"Raises an :ref:`auditing event ` ``os.lockf`` with arguments " -"``fd``, ``cmd``, ``len``." +#, fuzzy +msgid "Raises an auditing event os.lockf with arguments fd, cmd, len." msgstr "" +"引發一個附帶引數 ``fd``、``length`` 的\\ :ref:`稽核事件 ` ``os." +"truncate``。" #: ../../library/os.rst:1148 msgid "Flags that specify what action :func:`lockf` will take." @@ -1434,9 +1431,8 @@ msgid "" msgstr "" #: ../../library/os.rst:1242 -msgid "" -"Raises an :ref:`auditing event ` ``open`` with arguments ``path``, " -"``mode``, ``flags``." +#, fuzzy +msgid "Raises an auditing event open with arguments path, mode, flags." msgstr "" "引發一個附帶引數 ``path``、``mode``、``flags`` 的\\ :ref:`稽核事件 " "` ``open``。" @@ -2174,9 +2170,8 @@ msgid "" msgstr "" #: ../../library/os.rst:1989 ../../library/os.rst:2122 -msgid "" -"Raises an :ref:`auditing event ` ``os.chdir`` with argument " -"``path``." +#, fuzzy +msgid "Raises an auditing event os.chdir with argument path." msgstr "" "引發一個附帶引數 ``path`` 的\\ :ref:`稽核事件 ` ``os.chdir``。" @@ -2246,9 +2241,8 @@ msgid "" msgstr "" #: ../../library/os.rst:2019 ../../library/os.rst:2148 -msgid "" -"Raises an :ref:`auditing event ` ``os.chflags`` with arguments " -"``path``, ``flags``." +#, fuzzy +msgid "Raises an auditing event os.chflags with arguments path, flags." msgstr "" "引發一個附帶引數 ``path``、``flags`` 的\\ :ref:`稽核事件 ` ``os." "chflags``。" @@ -2451,9 +2445,10 @@ msgid "" msgstr "" #: ../../library/os.rst:2195 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``os.link`` with arguments " -"``src``, ``dst``, ``src_dir_fd``, ``dst_dir_fd``." +"Raises an auditing event os.link with arguments src, dst, src_dir_fd, " +"dst_dir_fd." msgstr "" "引發一個附帶引數 ``src``、``dst``、``src_dir_fd``、``dst_dir_fd`` 的\\ :ref:`" "稽核事件 ` ``os.link``。" @@ -2499,9 +2494,8 @@ msgid "" msgstr "" #: ../../library/os.rst:2225 -msgid "" -"Raises an :ref:`auditing event ` ``os.listdir`` with argument " -"``path``." +#, fuzzy +msgid "Raises an auditing event os.listdir with argument path." msgstr "" "引發一個附帶引數 ``path`` 的\\ :ref:`稽核事件 ` ``os.listdir``。" @@ -2540,9 +2534,8 @@ msgid "May raise :exc:`OSError` if an error occurs collecting the drive names." msgstr "" #: ../../library/os.rst:2258 -msgid "" -"Raises an :ref:`auditing event ` ``os.listdrives`` with no " -"arguments." +#, fuzzy +msgid "Raises an auditing event os.listdrives with no arguments." msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``os.listdrives``。" #: ../../library/os.rst:2260 ../../library/os.rst:2284 @@ -2576,9 +2569,8 @@ msgid "" msgstr "" #: ../../library/os.rst:2282 -msgid "" -"Raises an :ref:`auditing event ` ``os.listmounts`` with argument " -"``volume``." +#, fuzzy +msgid "Raises an auditing event os.listmounts with argument volume." msgstr "" "引發一個附帶引數 ``volume`` 的\\ :ref:`稽核事件 ` ``os." "listmounts``。" @@ -2601,9 +2593,8 @@ msgid "May raise :exc:`OSError` if an error occurs collecting the volumes." msgstr "" #: ../../library/os.rst:2302 -msgid "" -"Raises an :ref:`auditing event ` ``os.listvolumes`` with no " -"arguments." +#, fuzzy +msgid "Raises an auditing event os.listvolumes with no arguments." msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``os.listvolumes``。" #: ../../library/os.rst:2311 @@ -2680,9 +2671,8 @@ msgid "" msgstr "" #: ../../library/os.rst:2369 ../../library/os.rst:2406 -msgid "" -"Raises an :ref:`auditing event ` ``os.mkdir`` with arguments " -"``path``, ``mode``, ``dir_fd``." +#, fuzzy +msgid "Raises an auditing event os.mkdir with arguments path, mode, dir_fd." msgstr "" "引發一個附帶引數 ``path``、``mode``、``dir_fd`` 的\\ :ref:`稽核事件 " "` ``os.mkdir``。" @@ -2872,9 +2862,8 @@ msgstr "" #: ../../library/os.rst:2573 ../../library/os.rst:2595 #: ../../library/os.rst:3437 -msgid "" -"Raises an :ref:`auditing event ` ``os.remove`` with arguments " -"``path``, ``dir_fd``." +#, fuzzy +msgid "Raises an auditing event os.remove with arguments path, dir_fd." msgstr "" "引發一個附帶引數 ``path``、``dir_fd`` 的\\ :ref:`稽核事件 ` ``os." "remove``。" @@ -2930,9 +2919,10 @@ msgstr "" #: ../../library/os.rst:2624 ../../library/os.rst:2645 #: ../../library/os.rst:2662 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``os.rename`` with arguments " -"``src``, ``dst``, ``src_dir_fd``, ``dst_dir_fd``." +"Raises an auditing event os.rename with arguments src, dst, src_dir_fd, " +"dst_dir_fd." msgstr "" "引發一個附帶引數 ``src``、``dst``、``src_dir_fd``、``dst_dir_fd`` 的\\ :ref:`" "稽核事件 ` ``os.rename``。" @@ -2978,9 +2968,8 @@ msgid "" msgstr "" #: ../../library/os.rst:2680 -msgid "" -"Raises an :ref:`auditing event ` ``os.rmdir`` with arguments " -"``path``, ``dir_fd``." +#, fuzzy +msgid "Raises an auditing event os.rmdir with arguments path, dir_fd." msgstr "" "引發一個附帶引數 ``path``、``dir_fd`` 的\\ :ref:`稽核事件 ` ``os." "rmdir``。" @@ -3017,9 +3006,8 @@ msgid "" msgstr "" #: ../../library/os.rst:2717 -msgid "" -"Raises an :ref:`auditing event ` ``os.scandir`` with argument " -"``path``." +#, fuzzy +msgid "Raises an auditing event os.scandir with argument path." msgstr "" "引發一個附帶引數 ``path`` 的\\ :ref:`稽核事件 ` ``os.scandir``。" @@ -3805,9 +3793,8 @@ msgid "" msgstr "" #: ../../library/os.rst:3380 -msgid "" -"Raises an :ref:`auditing event ` ``os.symlink`` with arguments " -"``src``, ``dst``, ``dir_fd``." +#, fuzzy +msgid "Raises an auditing event os.symlink with arguments src, dst, dir_fd." msgstr "" "引發一個附帶引數 ``src``、``dst``、``dir_fd`` 的\\ :ref:`稽核事件 " "` ``os.symlink``。" @@ -3833,9 +3820,8 @@ msgid "" msgstr "" #: ../../library/os.rst:3417 -msgid "" -"Raises an :ref:`auditing event ` ``os.truncate`` with arguments " -"``path``, ``length``." +#, fuzzy +msgid "Raises an auditing event os.truncate with arguments path, length." msgstr "" "引發一個附帶引數 ``path``、``length`` 的\\ :ref:`稽核事件 ` ``os." "truncate``。" @@ -3890,9 +3876,9 @@ msgid "" msgstr "" #: ../../library/os.rst:3476 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``os.utime`` with arguments " -"``path``, ``times``, ``ns``, ``dir_fd``." +"Raises an auditing event os.utime with arguments path, times, ns, dir_fd." msgstr "" "引發一個附帶引數 ``path``、``times``、``ns``、``dir_fd`` 的\\ :ref:`稽核事件 " "` ``os.utime``。" @@ -3995,9 +3981,10 @@ msgid "" msgstr "" #: ../../library/os.rst:3575 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``os.walk`` with arguments " -"``top``, ``topdown``, ``onerror``, ``followlinks``." +"Raises an auditing event os.walk with arguments top, topdown, onerror, " +"followlinks." msgstr "" "引發一個附帶引數 ``top``、``topdown``、``onerror``、``followlinks`` 的\\ :" "ref:`稽核事件 ` ``os.walk``。" @@ -4042,9 +4029,10 @@ msgid "" msgstr "" #: ../../library/os.rst:3636 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``os.fwalk`` with arguments " -"``top``, ``topdown``, ``onerror``, ``follow_symlinks``, ``dir_fd``." +"Raises an auditing event os.fwalk with arguments top, topdown, onerror, " +"follow_symlinks, dir_fd." msgstr "" "引發一個附帶引數 ``top``、``topdown``、``onerror``、``follow_symlinks``、" "``dir_fd`` 的\\ :ref:`稽核事件 ` ``os.fwalk``。" @@ -4193,9 +4181,8 @@ msgid "" msgstr "" #: ../../library/os.rst:3808 -msgid "" -"Raises an :ref:`auditing event ` ``os.getxattr`` with arguments " -"``path``, ``attribute``." +#, fuzzy +msgid "Raises an auditing event os.getxattr with arguments path, attribute." msgstr "" "引發一個附帶引數 ``path``、``attribute`` 的\\ :ref:`稽核事件 ` " "``os.getxattr``。" @@ -4214,9 +4201,8 @@ msgid "" msgstr "" #: ../../library/os.rst:3824 -msgid "" -"Raises an :ref:`auditing event ` ``os.listxattr`` with argument " -"``path``." +#, fuzzy +msgid "Raises an auditing event os.listxattr with argument path." msgstr "" "引發一個附帶引數 ``path`` 的\\ :ref:`稽核事件 ` ``os.listxattr``。" @@ -4229,9 +4215,8 @@ msgid "" msgstr "" #: ../../library/os.rst:3840 -msgid "" -"Raises an :ref:`auditing event ` ``os.removexattr`` with arguments " -"``path``, ``attribute``." +#, fuzzy +msgid "Raises an auditing event os.removexattr with arguments path, attribute." msgstr "" "引發一個附帶引數 ``path``、``attribute`` 的\\ :ref:`稽核事件 ` " "``os.removexattr``。" @@ -4255,9 +4240,10 @@ msgid "" msgstr "" #: ../../library/os.rst:3865 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``os.setxattr`` with arguments " -"``path``, ``attribute``, ``value``, ``flags``." +"Raises an auditing event os.setxattr with arguments path, attribute, value, " +"flags." msgstr "" "引發一個附帶引數 ``path``、``attribute``、``value``、``flags`` 的\\ :ref:`稽" "核事件 ` ``os.setxattr``。" @@ -4333,9 +4319,8 @@ msgid "" msgstr "" #: ../../library/os.rst:3929 -msgid "" -"Raises an :ref:`auditing event ` ``os.add_dll_directory`` with " -"argument ``path``." +#, fuzzy +msgid "Raises an auditing event os.add_dll_directory with argument path." msgstr "" "引發一個附帶引數 ``path`` 的\\ :ref:`稽核事件 ` ``os." "add_dll_directory``。" @@ -4418,9 +4403,8 @@ msgid "" msgstr "" #: ../../library/os.rst:3998 -msgid "" -"Raises an :ref:`auditing event ` ``os.exec`` with arguments " -"``path``, ``args``, ``env``." +#, fuzzy +msgid "Raises an auditing event os.exec with arguments path, args, env." msgstr "" "引發一個附帶引數 ``path``、``args``、``env`` 的\\ :ref:`稽核事件 ` " "``os.exec``。" @@ -4555,8 +4539,8 @@ msgid "" msgstr "" #: ../../library/os.rst:4165 -msgid "" -"Raises an :ref:`auditing event ` ``os.fork`` with no arguments." +#, fuzzy +msgid "Raises an auditing event os.fork with no arguments." msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``os.fork``。" #: ../../library/os.rst:4169 @@ -4622,8 +4606,8 @@ msgid "" msgstr "" #: ../../library/os.rst:4214 -msgid "" -"Raises an :ref:`auditing event ` ``os.forkpty`` with no arguments." +#, fuzzy +msgid "Raises an auditing event os.forkpty with no arguments." msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``os.forkpty``。" #: ../../library/os.rst:4221 @@ -4661,9 +4645,8 @@ msgid "See also :func:`signal.pthread_kill`." msgstr "另請參閱 :func:`signal.pthread_kill`。" #: ../../library/os.rst:4252 -msgid "" -"Raises an :ref:`auditing event ` ``os.kill`` with arguments " -"``pid``, ``sig``." +#, fuzzy +msgid "Raises an auditing event os.kill with arguments pid, sig." msgstr "" "引發一個附帶引數 ``pid``、``sig`` 的\\ :ref:`稽核事件 ` ``os." "kill``。" @@ -4673,9 +4656,8 @@ msgid "Send the signal *sig* to the process group *pgid*." msgstr "" #: ../../library/os.rst:4268 -msgid "" -"Raises an :ref:`auditing event ` ``os.killpg`` with arguments " -"``pgid``, ``sig``." +#, fuzzy +msgid "Raises an auditing event os.killpg with arguments pgid, sig." msgstr "" "引發一個附帶引數 ``pgid``、``sig`` 的\\ :ref:`稽核事件 ` ``os." "killpg``。" @@ -4889,9 +4871,8 @@ msgid "" msgstr "" #: ../../library/os.rst:4430 ../../library/os.rst:4446 -msgid "" -"Raises an :ref:`auditing event ` ``os.posix_spawn`` with arguments " -"``path``, ``argv``, ``env``." +#, fuzzy +msgid "Raises an auditing event os.posix_spawn with arguments path, argv, env." msgstr "" "引發一個附帶引數 ``path``、``argv``、``env`` 的\\ :ref:`稽核事件 ` " "``os.posix_spawn``。" @@ -5028,9 +5009,8 @@ msgid "" msgstr "" #: ../../library/os.rst:4550 -msgid "" -"Raises an :ref:`auditing event ` ``os.spawn`` with arguments " -"``mode``, ``path``, ``args``, ``env``." +#, fuzzy +msgid "Raises an auditing event os.spawn with arguments mode, path, args, env." msgstr "" "引發一個附帶引數 ``mode``、``path``、``args``、``env`` 的\\ :ref:`稽核事件 " "` ``os.spawn``。" @@ -5130,17 +5110,17 @@ msgid "" msgstr "" #: ../../library/os.rst:4635 -msgid "" -"Raises an :ref:`auditing event ` ``os.startfile`` with arguments " -"``path``, ``operation``." +#, fuzzy +msgid "Raises an auditing event os.startfile with arguments path, operation." msgstr "" "引發一個附帶引數 ``path``、``operation`` 的\\ :ref:`稽核事件 ` " "``os.startfile``。" #: ../../library/os.rst:4637 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``os.startfile/2`` with arguments " -"``path``, ``operation``, ``arguments``, ``cwd``, ``show_cmd``." +"Raises an auditing event os.startfile/2 with arguments path, operation, " +"arguments, cwd, show_cmd." msgstr "" "引發一個附帶引數 ``path``、``operation``、``arguments``、``cwd``、" "``show_cmd`` 的\\ :ref:`稽核事件 ` ``os.startfile/2``。" @@ -5193,9 +5173,8 @@ msgid "" msgstr "" #: ../../library/os.rst:4674 -msgid "" -"Raises an :ref:`auditing event ` ``os.system`` with argument " -"``command``." +#, fuzzy +msgid "Raises an auditing event os.system with argument command." msgstr "" "引發一個附帶引數 ``command`` 的\\ :ref:`稽核事件 ` ``os.system``。" diff --git a/library/pathlib.po b/library/pathlib.po index b003d7b0d7..a5fba7002f 100644 --- a/library/pathlib.po +++ b/library/pathlib.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-28 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2024-02-29 20:49+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1043,9 +1043,9 @@ msgid "" msgstr "在很大的目錄樹裡使用 \"``**``\" 可能會耗費過多的時間。" #: ../../library/pathlib.rst:1206 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``pathlib.Path.glob`` with " -"arguments ``self``, ``pattern``." +"Raises an auditing event pathlib.Path.glob with arguments self, pattern." msgstr "" "引發一個附帶引數 ``self``、``pattern`` 的\\ :ref:`稽核事件 ` " "``pathlib.Path.glob``。" @@ -1069,9 +1069,9 @@ msgstr "" "相同： ::" #: ../../library/pathlib.rst:1234 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``pathlib.Path.rglob`` with " -"arguments ``self``, ``pattern``." +"Raises an auditing event pathlib.Path.rglob with arguments self, pattern." msgstr "" "引發一個附帶引數 ``self``、``pattern`` 的\\ :ref:`稽核事件 ` " "``pathlib.Path.rglob``。" diff --git a/library/pdb.po b/library/pdb.po index d2db334f8f..06f705bb48 100644 --- a/library/pdb.po +++ b/library/pdb.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-28 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:07+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -236,8 +236,8 @@ msgid "Example call to enable tracing with *skip*::" msgstr "" #: ../../library/pdb.rst:210 -msgid "" -"Raises an :ref:`auditing event ` ``pdb.Pdb`` with no arguments." +#, fuzzy +msgid "Raises an auditing event pdb.Pdb with no arguments." msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``pdb.Pdb``。" #: ../../library/pdb.rst:212 diff --git a/library/pickle.po b/library/pickle.po index 532f1f1884..e841c8738f 100644 --- a/library/pickle.po +++ b/library/pickle.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:07+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -616,9 +616,8 @@ msgid "" msgstr "" #: ../../library/pickle.rst:460 -msgid "" -"Raises an :ref:`auditing event ` ``pickle.find_class`` with " -"arguments ``module``, ``name``." +#, fuzzy +msgid "Raises an auditing event pickle.find_class with arguments module, name." msgstr "" "引發一個附帶引數 ``module``、``name`` 的\\ :ref:`稽核事件 ` " "``pickle.find_class``。" diff --git a/library/poplib.po b/library/poplib.po index 92bb9d730e..1e31e1d77c 100644 --- a/library/poplib.po +++ b/library/poplib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:08+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -77,21 +77,22 @@ msgid "" "timeout setting will be used)." msgstr "" -#: ../../library/poplib.rst:55 ../../library/poplib.rst:77 +#: ../../library/poplib.rst:44 ../../library/poplib.rst:66 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``poplib.connect`` with arguments " -"``self``, ``host``, ``port``." +"Raises an auditing event poplib.connect with arguments self, host, port." msgstr "" "引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " "` ``poplib.connect``。" -#: ../../library/poplib.rst:57 ../../library/poplib.rst:79 +#: ../../library/poplib.rst:46 ../../library/poplib.rst:68 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``poplib.putline`` with arguments " -"``self``, ``line``." +"All commands will raise an auditing event poplib.putline with arguments self " +"and line, where line is the bytes about to be sent to the remote host." msgstr "" "引發一個附帶引數 ``self``、``line`` 的\\ :ref:`稽核事件 ` ``poplib." -"putline``。" +"putline``。其中 ``line`` 為即將傳送給遠端的位元組。" #: ../../library/poplib.rst:48 ../../library/poplib.rst:70 msgid "" @@ -335,3 +336,10 @@ msgstr "POP3" #: ../../library/poplib.rst:12 msgid "protocol" msgstr "protocol（協定）" + +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``poplib.putline`` with " +#~ "arguments ``self``, ``line``." +#~ msgstr "" +#~ "引發一個附帶引數 ``self``、``line`` 的\\ :ref:`稽核事件 ` " +#~ "``poplib.putline``。" diff --git a/library/pty.po b/library/pty.po index 7613307a80..10383e32ca 100644 --- a/library/pty.po +++ b/library/pty.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2016-11-19 00:33+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -125,9 +125,8 @@ msgid "" msgstr "" #: ../../library/pty.rst:82 -msgid "" -"Raises an :ref:`auditing event ` ``pty.spawn`` with argument " -"``argv``." +#, fuzzy +msgid "Raises an auditing event pty.spawn with argument argv." msgstr "" "引發一個附帶引數 ``argv`` 的\\ :ref:`稽核事件 ` ``pty.spawn``。" diff --git a/library/resource.po b/library/resource.po index b151ccb1a3..acdd34fb43 100644 --- a/library/resource.po +++ b/library/resource.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:09+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -115,9 +115,9 @@ msgid "VxWorks only supports setting :data:`RLIMIT_NOFILE`." msgstr "" #: ../../library/resource.rst:83 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``resource.setrlimit`` with " -"arguments ``resource``, ``limits``." +"Raises an auditing event resource.setrlimit with arguments resource, limits." msgstr "" "引發一個附帶引數 ``resource``、``limits`` 的\\ :ref:`稽核事件 ` " "``resource.setrlimit``。" @@ -146,9 +146,10 @@ msgid "" msgstr "" #: ../../library/resource.rst:102 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``resource.prlimit`` with " -"arguments ``pid``, ``resource``, ``limits``." +"Raises an auditing event resource.prlimit with arguments pid, resource, " +"limits." msgstr "" "引發一個附帶引數 ``pid``、``resource``、``limits`` 的\\ :ref:`稽核事件 " "` ``resource.prlimit``。" diff --git a/library/shutil.po b/library/shutil.po index 150d4985d8..aec28647d0 100644 --- a/library/shutil.po +++ b/library/shutil.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-14 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:10+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -94,9 +94,8 @@ msgstr "" #: ../../library/shutil.rst:70 ../../library/shutil.rst:177 #: ../../library/shutil.rst:208 -msgid "" -"Raises an :ref:`auditing event ` ``shutil.copyfile`` with " -"arguments ``src``, ``dst``." +#, fuzzy +msgid "Raises an auditing event shutil.copyfile with arguments src, dst." msgstr "" "引發一個附帶引數 ``src``、``dst`` 的\\ :ref:`稽核事件 ` ``shutil." "copyfile``。" @@ -142,9 +141,8 @@ msgid "" msgstr "" #: ../../library/shutil.rst:106 ../../library/shutil.rst:179 -msgid "" -"Raises an :ref:`auditing event ` ``shutil.copymode`` with " -"arguments ``src``, ``dst``." +#, fuzzy +msgid "Raises an auditing event shutil.copymode with arguments src, dst." msgstr "" "引發一個附帶引數 ``src``、``dst`` 的\\ :ref:`稽核事件 ` ``shutil." "copymode``。" @@ -207,9 +205,8 @@ msgid "Please see :data:`os.supports_follow_symlinks` for more information." msgstr "更多資訊請見 :data:`os.supports_follow_symlinks`。" #: ../../library/shutil.rst:153 ../../library/shutil.rst:210 -msgid "" -"Raises an :ref:`auditing event ` ``shutil.copystat`` with " -"arguments ``src``, ``dst``." +#, fuzzy +msgid "Raises an auditing event shutil.copystat with arguments src, dst." msgstr "" "引發一個附帶引數 ``src``、``dst`` 的\\ :ref:`稽核事件 ` ``shutil." "copystat``。" @@ -352,9 +349,8 @@ msgid "" msgstr "" #: ../../library/shutil.rst:275 -msgid "" -"Raises an :ref:`auditing event ` ``shutil.copytree`` with " -"arguments ``src``, ``dst``." +#, fuzzy +msgid "Raises an auditing event shutil.copytree with arguments src, dst." msgstr "" "引發一個附帶引數 ``src``、``dst`` 的\\ :ref:`稽核事件 ` ``shutil." "copytree``。" @@ -422,9 +418,8 @@ msgid "" msgstr "" #: ../../library/shutil.rst:330 -msgid "" -"Raises an :ref:`auditing event ` ``shutil.rmtree`` with arguments " -"``path``, ``dir_fd``." +#, fuzzy +msgid "Raises an auditing event shutil.rmtree with arguments path, dir_fd." msgstr "" "引發一個附帶引數 ``path``、``dir_fd`` 的\\ :ref:`稽核事件 ` " "``shutil.rmtree``。" @@ -495,9 +490,8 @@ msgid "" msgstr "" #: ../../library/shutil.rst:380 -msgid "" -"Raises an :ref:`auditing event ` ``shutil.move`` with arguments " -"``src``, ``dst``." +#, fuzzy +msgid "Raises an auditing event shutil.move with arguments src, dst." msgstr "" "引發一個附帶引數 ``src``、``dst`` 的\\ :ref:`稽核事件 ` ``shutil." "move``。" @@ -553,9 +547,8 @@ msgid "See also :func:`os.chown`, the underlying function." msgstr "" #: ../../library/shutil.rst:427 -msgid "" -"Raises an :ref:`auditing event ` ``shutil.chown`` with arguments " -"``path``, ``user``, ``group``." +#, fuzzy +msgid "Raises an auditing event shutil.chown with arguments path, user, group." msgstr "" "引發一個附帶引數 ``path``、``user``、``group`` 的\\ :ref:`稽核事件 " "` ``shutil.chown``。" @@ -778,9 +771,10 @@ msgid "The *verbose* argument is unused and deprecated." msgstr "" #: ../../library/shutil.rst:616 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``shutil.make_archive`` with " -"arguments ``base_name``, ``format``, ``root_dir``, ``base_dir``." +"Raises an auditing event shutil.make_archive with arguments base_name, " +"format, root_dir, base_dir." msgstr "" "引發一個附帶引數 ``base_name``、``format``、``root_dir``、``base_dir`` 的\\ :" "ref:`稽核事件 ` ``shutil.make_archive``。" @@ -914,9 +908,10 @@ msgid "" msgstr "" #: ../../library/shutil.rst:704 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``shutil.unpack_archive`` with " -"arguments ``filename``, ``extract_dir``, ``format``." +"Raises an auditing event shutil.unpack_archive with arguments filename, " +"extract_dir, format." msgstr "" "引發一個附帶引數 ``filename``、``extract_dir``、``format`` 的\\ :ref:`稽核事" "件 ` ``shutil.unpack_archive``。" diff --git a/library/signal.po b/library/signal.po index 2485f8c902..6cd3a48235 100644 --- a/library/signal.po +++ b/library/signal.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:10+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -498,9 +498,10 @@ msgid "" msgstr "" #: ../../library/signal.rst:435 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``signal.pthread_kill`` with " -"arguments ``thread_id``, ``signalnum``." +"Raises an auditing event signal.pthread_kill with arguments thread_id, " +"signalnum." msgstr "" "引發一個附帶引數 ``thread_id``、``signalnum`` 的\\ :ref:`稽核事件 " "` ``signal.pthread_kill``。" diff --git a/library/smtplib.po b/library/smtplib.po index 12a9f729a6..7231713c0d 100644 --- a/library/smtplib.po +++ b/library/smtplib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-19 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:10+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -80,13 +80,14 @@ msgid "" "keyword:`!with` statement exits. E.g.::" msgstr "" -#: ../../library/smtplib.rst:70 +#: ../../library/smtplib.rst:59 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``smtplib.send`` with arguments " -"``self``, ``data``." +"All commands will raise an auditing event smtplib.SMTP.send with arguments " +"self and data, where data is the bytes about to be sent to the remote host." msgstr "" -"引發一個附帶引數 ``self``、``data`` 的\\ :ref:`稽核事件 ` " -"``smtplib.send``。" +"所有指令都會引發一個附帶引數 ``self``、``data`` 的\\ :ref:`稽核事件 " +"` ``smtplib.SMTP.send``，其中 ``data`` 為即將傳送至遠端的位元組。" #: ../../library/smtplib.rst:61 msgid "" @@ -317,11 +318,13 @@ msgid "" "connection response." msgstr "" -#: ../../library/smtplib.rst:264 +#: ../../library/smtplib.rst:253 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``smtplib.connect`` with " -"arguments ``self``, ``host``, ``port``." +"Raises an auditing event smtplib.connect with arguments self, host, port." msgstr "" +"引發一個附帶引數 ``self``、``data`` 的\\ :ref:`稽核事件 ` " +"``smtplib.send``。" #: ../../library/smtplib.rst:258 msgid "" diff --git a/library/socket.po b/library/socket.po index cf7238e2a0..7875b3431a 100644 --- a/library/socket.po +++ b/library/socket.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:10+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -891,10 +891,11 @@ msgstr "" msgid "The newly created socket is :ref:`non-inheritable `." msgstr "" -#: ../../library/socket.rst:742 +#: ../../library/socket.rst:731 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``socket.__new__`` with arguments " -"``self``, ``family``, ``type``, ``protocol``." +"Raises an auditing event socket.__new__ with arguments self, family, type, " +"protocol." msgstr "" "引發一個附帶引數 ``self``、``family``、``type``、``protocol`` 的\\ :ref:`稽核" "事件 ` ``socket.__new__``。" @@ -1125,10 +1126,11 @@ msgid "" "`AF_INET6`), and is meant to be passed to the :meth:`socket.connect` method." msgstr "" -#: ../../library/socket.rst:953 +#: ../../library/socket.rst:942 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``socket.getaddrinfo`` with " -"arguments ``host``, ``port``, ``family``, ``type``, ``protocol``." +"Raises an auditing event socket.getaddrinfo with arguments host, port, " +"family, type, protocol." msgstr "" "引發一個附帶引數 ``host``、``port``、``family``、``type``、``protocol`` 的" "\\ :ref:`稽核事件 ` ``socket.getaddrinfo``。" @@ -1171,10 +1173,9 @@ msgid "" "stack support." msgstr "" -#: ../../library/socket.rst:991 ../../library/socket.rst:1007 -msgid "" -"Raises an :ref:`auditing event ` ``socket.gethostbyname`` with " -"argument ``hostname``." +#: ../../library/socket.rst:980 ../../library/socket.rst:996 +#, fuzzy +msgid "Raises an auditing event socket.gethostbyname with argument hostname." msgstr "" "引發一個附帶引數 ``hostname`` 的\\ :ref:`稽核事件 ` ``socket." "gethostbyname``。" @@ -1208,10 +1209,9 @@ msgid "" "interpreter is currently executing." msgstr "" -#: ../../library/socket.rst:1017 -msgid "" -"Raises an :ref:`auditing event ` ``socket.gethostname`` with no " -"arguments." +#: ../../library/socket.rst:1006 +#, fuzzy +msgid "Raises an auditing event socket.gethostname with no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``socket.gethostname``。" @@ -1232,10 +1232,9 @@ msgid "" "`gethostbyaddr` supports both IPv4 and IPv6." msgstr "" -#: ../../library/socket.rst:1035 -msgid "" -"Raises an :ref:`auditing event ` ``socket.gethostbyaddr`` with " -"argument ``ip_address``." +#: ../../library/socket.rst:1024 +#, fuzzy +msgid "Raises an auditing event socket.gethostbyaddr with argument ip_address." msgstr "" "引發一個附帶引數 ``ip_address`` 的\\ :ref:`稽核事件 ` ``socket." "gethostbyaddr``。" @@ -1259,10 +1258,9 @@ msgid "" "For more information about *flags* you can consult :manpage:`getnameinfo(3)`." msgstr "" -#: ../../library/socket.rst:1052 -msgid "" -"Raises an :ref:`auditing event ` ``socket.getnameinfo`` with " -"argument ``sockaddr``." +#: ../../library/socket.rst:1041 +#, fuzzy +msgid "Raises an auditing event socket.getnameinfo with argument sockaddr." msgstr "" "引發一個附帶引數 ``sockaddr`` 的\\ :ref:`稽核事件 ` ``socket." "getnameinfo``。" @@ -1283,10 +1281,11 @@ msgid "" "``'udp'``, otherwise any protocol will match." msgstr "" -#: ../../library/socket.rst:1074 +#: ../../library/socket.rst:1063 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``socket.getservbyname`` with " -"arguments ``servicename``, ``protocolname``." +"Raises an auditing event socket.getservbyname with arguments servicename, " +"protocolname." msgstr "" "引發一個附帶引數 ``sockaddr``、``protocolname`` 的\\ :ref:`稽核事件 " "` ``socket.getservbyname``。" @@ -1298,10 +1297,11 @@ msgid "" "``'udp'``, otherwise any protocol will match." msgstr "" -#: ../../library/socket.rst:1085 +#: ../../library/socket.rst:1074 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``socket.getservbyport`` with " -"arguments ``port``, ``protocolname``." +"Raises an auditing event socket.getservbyport with arguments port, " +"protocolname." msgstr "" "引發一個附帶引數 ``port``、``protocolname`` 的\\ :ref:`稽核事件 ` " "``socket.getservbyport``。" @@ -1489,10 +1489,9 @@ msgid "" "you don't have enough rights." msgstr "" -#: ../../library/socket.rst:1272 -msgid "" -"Raises an :ref:`auditing event ` ``socket.sethostname`` with " -"argument ``name``." +#: ../../library/socket.rst:1261 +#, fuzzy +msgid "Raises an auditing event socket.sethostname with argument name." msgstr "" "引發一個附帶引數 ``name`` 的\\ :ref:`稽核事件 ` ``socket." "sethostname``。" @@ -1633,10 +1632,9 @@ msgid "" "format of *address* depends on the address family --- see above.)" msgstr "" -#: ../../library/socket.rst:1409 -msgid "" -"Raises an :ref:`auditing event ` ``socket.bind`` with arguments " -"``self``, ``address``." +#: ../../library/socket.rst:1398 +#, fuzzy +msgid "Raises an auditing event socket.bind with arguments self, address." msgstr "" "引發一個附帶引數 ``self``、``address`` 的\\ :ref:`稽核事件 ` " "``socket.bind``。" @@ -1687,10 +1685,9 @@ msgid "" "(or the exception raised by the signal handler)." msgstr "" -#: ../../library/socket.rst:1450 ../../library/socket.rst:1470 -msgid "" -"Raises an :ref:`auditing event ` ``socket.connect`` with arguments " -"``self``, ``address``." +#: ../../library/socket.rst:1439 ../../library/socket.rst:1459 +#, fuzzy +msgid "Raises an auditing event socket.connect with arguments self, address." msgstr "" "引發一個附帶引數 ``self``、``address`` 的\\ :ref:`稽核事件 ` " "``socket.connect``。" @@ -2026,10 +2023,9 @@ msgid "" "address family --- see above.)" msgstr "" -#: ../../library/socket.rst:1827 -msgid "" -"Raises an :ref:`auditing event ` ``socket.sendto`` with arguments " -"``self``, ``address``." +#: ../../library/socket.rst:1816 +#, fuzzy +msgid "Raises an auditing event socket.sendto with arguments self, address." msgstr "" "引發一個附帶引數 ``self``、``address`` 的\\ :ref:`稽核事件 ` " "``socket.sendto``。" @@ -2065,10 +2061,9 @@ msgstr "" msgid ":ref:`Availability `: Unix, not WASI." msgstr ":ref:`適用 `：Unix、非 WASI。" -#: ../../library/socket.rst:1870 -msgid "" -"Raises an :ref:`auditing event ` ``socket.sendmsg`` with arguments " -"``self``, ``address``." +#: ../../library/socket.rst:1859 +#, fuzzy +msgid "Raises an auditing event socket.sendmsg with arguments self, address." msgstr "" "引發一個附帶引數 ``self``、``address`` 的\\ :ref:`稽核事件 ` " "``socket.sendmsg``。" diff --git a/library/sqlite3.po b/library/sqlite3.po index 2c2888e6f0..8a06381631 100644 --- a/library/sqlite3.po +++ b/library/sqlite3.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:10+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -346,17 +346,17 @@ msgid "Return type" msgstr "" #: ../../library/sqlite3.rst:346 -msgid "" -"Raises an :ref:`auditing event ` ``sqlite3.connect`` with argument " -"``database``." +#, fuzzy +msgid "Raises an auditing event sqlite3.connect with argument database." msgstr "" "引發一個附帶引數 ``database`` 的\\ :ref:`稽核事件 ` ``sqlite3." "connect``。" #: ../../library/sqlite3.rst:347 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``sqlite3.connect/handle`` with " -"argument ``connection_handle``." +"Raises an auditing event sqlite3.connect/handle with argument " +"connection_handle." msgstr "" "引發一個附帶引數 ``connection_handle`` 的\\ :ref:`稽核事件 ` " "``sqlite3.connect/handle``。" @@ -1064,9 +1064,10 @@ msgid "" msgstr "" #: ../../library/sqlite3.rst:1020 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``sqlite3.enable_load_extension`` " -"with arguments ``connection``, ``enabled``." +"Raises an auditing event sqlite3.enable_load_extension with arguments " +"connection, enabled." msgstr "" "引發一個附帶引數 ``connection``、``enabled`` 的\\ :ref:`稽核事件 ` " "``sqlite3.enable_load_extension``。" @@ -1093,9 +1094,10 @@ msgid "" msgstr "" #: ../../library/sqlite3.rst:1073 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``sqlite3.load_extension`` with " -"arguments ``connection``, ``path``." +"Raises an auditing event sqlite3.load_extension with arguments connection, " +"path." msgstr "" "引發一個附帶引數 ``connection``、``path`` 的\\ :ref:`稽核事件 ` " "``sqlite3.load_extension``。" diff --git a/library/subprocess.po b/library/subprocess.po index e21d3caa52..20b76147e3 100644 --- a/library/subprocess.po +++ b/library/subprocess.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-23 00:04+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:11+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -878,13 +878,13 @@ msgid "" "waited for. ::" msgstr "" -#: ../../library/subprocess.rst:712 +#: ../../library/subprocess.rst:701 msgid "" -"Raises an :ref:`auditing event ` ``subprocess.Popen`` with " -"arguments ``executable``, ``args``, ``cwd``, ``env``." +"Popen and the other functions in this module that use it raise an auditing " +"event subprocess.Popen with arguments executable, args, cwd, and env. The " +"value for args may be a single string or a list of strings, depending on " +"platform." msgstr "" -"引發一個附帶引數 ``executable``、``args``、``cwd``、``env`` 的\\ :ref:`稽核事" -"件 ` ``subprocess.Popen``。" #: ../../library/subprocess.rst:703 msgid "" @@ -1835,5 +1835,12 @@ msgstr "universal newlines" msgid "subprocess module" msgstr "subprocess 模組" +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``subprocess.Popen`` with " +#~ "arguments ``executable``, ``args``, ``cwd``, ``env``." +#~ msgstr "" +#~ "引發一個附帶引數 ``executable``、``args``、``cwd``、``env`` 的\\ :ref:`稽" +#~ "核事件 ` ``subprocess.Popen``。" + #~ msgid "Added *encoding* and *errors* arguments." #~ msgstr "新增 *encoding* 與 *errors* 引數。" diff --git a/library/sys.po b/library/sys.po index e06b7d53e5..7392787d2c 100644 --- a/library/sys.po +++ b/library/sys.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2023-04-26 02:54+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -78,10 +78,16 @@ msgstr "" #: ../../library/sys.rst:49 #, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``sys.addaudithook`` with no " -"arguments." +"Calling sys.addaudithook() will itself raise an auditing event named sys." +"addaudithook with no arguments. If any existing hooks raise an exception " +"derived from RuntimeError, the new hook will not be added and the exception " +"suppressed. As a result, callers cannot assume that their hook has been " +"added unless they control all existing hooks." msgstr "" -"引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.addaudithook``。" +"呼叫 :func:`sys.addaudithook` 本身會引發一個不帶任何引數、名為 ``sys." +"addaudithook`` 的稽核事件。如果任何現有的 hook 引發從 :class:`RuntimeError` " +"衍生的例外，則不會添加新的 hook 並抑制異常。因此，除非呼叫者控制所有已存在的 " +"hook，他們不能假設他們的 hook 已被添加。" #: ../../library/sys.rst:51 msgid "" @@ -280,9 +286,8 @@ msgid "" msgstr "" #: ../../library/sys.rst:214 -msgid "" -"Raises an :ref:`auditing event ` ``sys._current_frames`` with no " -"arguments." +#, fuzzy +msgid "Raises an auditing event sys._current_frames with no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys._current_frames``。" @@ -299,9 +304,8 @@ msgid "This is most useful for statistical profiling." msgstr "" #: ../../library/sys.rst:227 -msgid "" -"Raises an :ref:`auditing event ` ``sys._current_exceptions`` with " -"no arguments." +#, fuzzy +msgid "Raises an auditing event sys._current_exceptions with no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys." "_current_exceptions``。" @@ -493,11 +497,12 @@ msgstr "" #: ../../library/sys.rst:394 msgid "" -"Raises an :ref:`auditing event ` ``sys.excepthook`` with arguments " -"``hook``, ``type``, ``value``, ``traceback``." +"Raise an auditing event sys.excepthook with arguments hook, type, value, " +"traceback when an uncaught exception occurs. If no hook has been set, hook " +"may be None. If any hook raises an exception derived from RuntimeError the " +"call to the hook will be suppressed. Otherwise, the audit hook exception " +"will be reported as unraisable and sys.excepthook will be called." msgstr "" -"引發一個附帶引數 ``hook``、``type``、``value``、``traceback`` 的\\ :ref:`稽核" -"事件 ` ``sys.excepthook``。" #: ../../library/sys.rst:396 msgid "" @@ -1121,9 +1126,8 @@ msgid "" msgstr "" #: ../../library/sys.rst:886 -msgid "" -"Raises an :ref:`auditing event ` ``sys._getframe`` with argument " -"``frame``." +#, fuzzy +msgid "Raises an auditing event sys._getframe with argument frame." msgstr "" "引發一個附帶引數 ``frame`` 的\\ :ref:`稽核事件 ` ``sys." "_getframe``。" @@ -1144,9 +1148,8 @@ msgid "" msgstr "" #: ../../library/sys.rst:902 -msgid "" -"Raises an :ref:`auditing event ` ``sys._getframemodulename`` with " -"argument ``depth``." +#, fuzzy +msgid "Raises an auditing event sys._getframemodulename with argument depth." msgstr "" "引發一個附帶引數 ``depth`` 的\\ :ref:`稽核事件 ` ``sys." "_getframemodulename``。" @@ -1448,9 +1451,10 @@ msgid "" msgstr "" #: ../../library/sys.rst:1166 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``cpython.run_interactivehook`` " -"with argument ``hook``." +"Raises an auditing event cpython.run_interactivehook with the hook object as " +"the argument when the hook is called on startup." msgstr "" "引發一個附帶引數 ``hook`` 的\\ :ref:`稽核事件 ` ``cpython." "run_interactivehook``。" @@ -1939,9 +1943,8 @@ msgid "A C function has raised an exception. *arg* is the C function object." msgstr "" #: ../../library/sys.rst:1517 -msgid "" -"Raises an :ref:`auditing event ` ``sys.setprofile`` with no " -"arguments." +#, fuzzy +msgid "Raises an auditing event sys.setprofile with no arguments." msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.setprofile``。" #: ../../library/sys.rst:1522 @@ -2104,10 +2107,9 @@ msgid "For more information on code and frame objects, refer to :ref:`types`." msgstr "" #: ../../library/sys.rst:1635 -msgid "" -"Raises an :ref:`auditing event ` ``sys.settrace`` with no " -"arguments." -msgstr "" +#, fuzzy +msgid "Raises an auditing event sys.settrace with no arguments." +msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.setprofile``。" #: ../../library/sys.rst:1639 msgid "" @@ -2141,17 +2143,17 @@ msgid "" msgstr "" #: ../../library/sys.rst:1663 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``sys." -"set_asyncgen_hooks_firstiter`` with no arguments." +"Raises an auditing event sys.set_asyncgen_hooks_firstiter with no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys." "set_asyncgen_hooks_firstiter``。" #: ../../library/sys.rst:1665 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``sys." -"set_asyncgen_hooks_finalizer`` with no arguments." +"Raises an auditing event sys.set_asyncgen_hooks_finalizer with no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys." "set_asyncgen_hooks_finalizer``。" @@ -2506,13 +2508,12 @@ msgid "" msgstr "" #: ../../library/sys.rst:1929 -#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``sys.unraisablehook`` with " -"arguments ``hook``, ``unraisable``." +"Raise an auditing event sys.unraisablehook with arguments hook, unraisable " +"when an exception that cannot be handled occurs. The unraisable object is " +"the same as what will be passed to the hook. If no hook has been set, hook " +"may be None." msgstr "" -"引發一個附帶引數 ``hook``、``unraisable`` 的\\ :ref:`稽核事件 ` " -"``sys.unraisablehook``。" #: ../../library/sys.rst:1931 msgid "" @@ -2661,6 +2662,28 @@ msgstr "interpreter prompt（直譯器提示）" msgid "..." msgstr "..." +#, fuzzy +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``sys.addaudithook`` with no " +#~ "arguments." +#~ msgstr "" +#~ "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.addaudithook``。" + +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``sys.excepthook`` with " +#~ "arguments ``hook``, ``type``, ``value``, ``traceback``." +#~ msgstr "" +#~ "引發一個附帶引數 ``hook``、``type``、``value``、``traceback`` 的\\ :ref:`" +#~ "稽核事件 ` ``sys.excepthook``。" + +#, fuzzy +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``sys.unraisablehook`` with " +#~ "arguments ``hook``, ``unraisable``." +#~ msgstr "" +#~ "引發一個附帶引數 ``hook``、``unraisable`` 的\\ :ref:`稽核事件 ` " +#~ "``sys.unraisablehook``。" + #~ msgid "See also :data:`sys.argv`." #~ msgstr "另請參閱 :data:`sys.argv`。" diff --git a/library/syslog.po b/library/syslog.po index 8cfcffd20d..7d6e6fb63b 100644 --- a/library/syslog.po +++ b/library/syslog.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2015-12-09 17:51+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -61,9 +61,9 @@ msgid "" msgstr "" #: ../../library/syslog.rst:36 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``syslog.syslog`` with arguments " -"``priority``, ``message``." +"Raises an auditing event syslog.syslog with arguments priority, message." msgstr "" "引發一個附帶引數 ``priority``、``message`` 的\\ :ref:`稽核事件 ` " "``syslog.syslog``。" @@ -102,9 +102,10 @@ msgid "" msgstr "" #: ../../library/syslog.rst:64 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``syslog.openlog`` with arguments " -"``ident``, ``logoption``, ``facility``." +"Raises an auditing event syslog.openlog with arguments ident, logoption, " +"facility." msgstr "" "引發一個附帶引數 ``ident``、``logoption``、``facility`` 的\\ :ref:`稽核事件 " "` ``syslog.openlog``。" @@ -137,9 +138,8 @@ msgid "" msgstr "" #: ../../library/syslog.rst:87 -msgid "" -"Raises an :ref:`auditing event ` ``syslog.closelog`` with no " -"arguments." +#, fuzzy +msgid "Raises an auditing event syslog.closelog with no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``syslog.closelog``。" @@ -154,9 +154,8 @@ msgid "" msgstr "" #: ../../library/syslog.rst:106 -msgid "" -"Raises an :ref:`auditing event ` ``syslog.setlogmask`` with " -"argument ``maskpri``." +#, fuzzy +msgid "Raises an auditing event syslog.setlogmask with argument maskpri." msgstr "" "引發一個附帶引數 ``maskpri`` 的\\ :ref:`稽核事件 ` ``syslog." "setlogmask``。" diff --git a/library/telnetlib.po b/library/telnetlib.po index 3b749d1a64..b1d6ca817e 100644 --- a/library/telnetlib.po +++ b/library/telnetlib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2022-05-22 02:15+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -196,10 +196,11 @@ msgstr "" msgid "Do not try to reopen an already connected instance." msgstr "" -#: ../../library/telnetlib.rst:161 +#: ../../library/telnetlib.rst:150 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``telnetlib.Telnet.open`` with " -"arguments ``self``, ``host``, ``port``." +"Raises an auditing event telnetlib.Telnet.open with arguments self, host, " +"port." msgstr "" "引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " "` ``telnetlib.Telnet.open``。" @@ -236,10 +237,10 @@ msgid "" "connection is closed." msgstr "" -#: ../../library/telnetlib.rst:198 +#: ../../library/telnetlib.rst:187 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``telnetlib.Telnet.write`` with " -"arguments ``self``, ``buffer``." +"Raises an auditing event telnetlib.Telnet.write with arguments self, buffer." msgstr "" "引發一個附帶引數 ``self``、``buffer`` 的\\ :ref:`稽核事件 ` " "``telnetlib.Telnet.write``。" diff --git a/library/tempfile.po b/library/tempfile.po index 0eae51d0ce..6d517ed5a7 100644 --- a/library/tempfile.po +++ b/library/tempfile.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2022-06-12 15:17+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -137,9 +137,8 @@ msgstr "" #: ../../library/tempfile.rst:68 ../../library/tempfile.rst:137 #: ../../library/tempfile.rst:264 -msgid "" -"Raises an :ref:`auditing event ` ``tempfile.mkstemp`` with " -"argument ``fullpath``." +#, fuzzy +msgid "Raises an auditing event tempfile.mkstemp with argument fullpath." msgstr "" "引發一個附帶引數 ``fullpath`` 的 ``tempfile.mkstemp`` :ref:`稽核事件 " "`。" @@ -389,9 +388,8 @@ msgstr "" "非常有用。" #: ../../library/tempfile.rst:210 ../../library/tempfile.rst:290 -msgid "" -"Raises an :ref:`auditing event ` ``tempfile.mkdtemp`` with " -"argument ``fullpath``." +#, fuzzy +msgid "Raises an auditing event tempfile.mkdtemp with argument fullpath." msgstr "" "引發一個附帶引數 ``fullpath`` 的 ``tempfile.mkdtemp`` :ref:`稽核事件 " "`。" diff --git a/library/types.po b/library/types.po index a9cf7b86bf..787d43c918 100644 --- a/library/types.po +++ b/library/types.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:14+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -191,9 +191,8 @@ msgid "" msgstr "" #: ../../library/types.rst:159 -msgid "" -"Raises an :ref:`auditing event ` ``function.__new__`` with " -"argument ``code``." +#, fuzzy +msgid "Raises an auditing event function.__new__ with argument code." msgstr "" "引發一個附帶引數 ``code`` 的\\ :ref:`稽核事件 ` ``function." "__new__``。" @@ -229,10 +228,10 @@ msgid "" msgstr "" #: ../../library/types.rst:193 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``code.__new__`` with arguments " -"``code``, ``filename``, ``name``, ``argcount``, ``posonlyargcount``, " -"``kwonlyargcount``, ``nlocals``, ``stacksize``, ``flags``." +"Raises an auditing event code.__new__ with arguments code, filename, name, " +"argcount, posonlyargcount, kwonlyargcount, nlocals, stacksize, flags." msgstr "" "引發一個附帶引數 ``code``、``filename``、``name``、``argcount``、" "``posonlyargcount``、``kwonlyargcount``、``nlocals``、``stacksize``、" diff --git a/library/urllib.request.po b/library/urllib.request.po index 944f4bf51f..1c31f24404 100644 --- a/library/urllib.request.po +++ b/library/urllib.request.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-23 00:04+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2022-04-21 17:59+0800\n" "Last-Translator: Jordan Su \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -205,13 +205,14 @@ msgstr "" "的處理，以往是透過傳遞 dictionary（字典）參數給 ``urllib.urlopen`` 來取得的，" "現在則可以透過 :class:`ProxyHandler` 物件來取得。" -#: ../../library/urllib.request.rst:110 +#: ../../library/urllib.request.rst:99 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``urllib.Request`` with arguments " -"``fullurl``, ``data``, ``headers``, ``method``." +"The default opener raises an auditing event urllib.Request with arguments " +"fullurl, data, headers, method taken from the request object." msgstr "" -"觸發一個 :ref:`auditing event ` ``urllib.Request`` 及其引數 " -"``fullurl``、``data``、``headers``、``method``。" +"預設的 opener 會觸發一個 :ref:`auditing event ` ``urllib.Request`` " +"與其從請求物件中所獲得的引數 ``fullurl``、``data``、``headers``、``method``。" #: ../../library/urllib.request.rst:101 msgid "" @@ -1949,3 +1950,10 @@ msgstr "FTP" #: ../../library/urllib.request.rst:1568 msgid "HTML" msgstr "HTML" + +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``urllib.Request`` with " +#~ "arguments ``fullurl``, ``data``, ``headers``, ``method``." +#~ msgstr "" +#~ "觸發一個 :ref:`auditing event ` ``urllib.Request`` 及其引數 " +#~ "``fullurl``、``data``、``headers``、``method``。" diff --git a/library/webbrowser.po b/library/webbrowser.po index 858bf34473..e5c60c39b6 100644 --- a/library/webbrowser.po +++ b/library/webbrowser.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2017-09-22 18:27+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -111,10 +111,9 @@ msgid "" "is neither supported nor portable." msgstr "" -#: ../../library/webbrowser.rst:80 -msgid "" -"Raises an :ref:`auditing event ` ``webbrowser.open`` with argument " -"``url``." +#: ../../library/webbrowser.rst:69 +#, fuzzy +msgid "Raises an auditing event webbrowser.open with argument url." msgstr "" "引發一個附帶引數 ``url`` 的\\ :ref:`稽核事件 ` ``webbrowser." "open``。" diff --git a/library/winreg.po b/library/winreg.po index ceca6b4843..14e6e2509a 100644 --- a/library/winreg.po +++ b/library/winreg.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:15+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -80,9 +80,10 @@ msgid "" msgstr "" #: ../../library/winreg.rst:56 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``winreg.ConnectRegistry`` with " -"arguments ``computer_name``, ``key``." +"Raises an auditing event winreg.ConnectRegistry with arguments " +"computer_name, key." msgstr "" "引發一個附帶引數 ``computer_name``、``key`` 的\\ :ref:`稽核事件 ` " "``winreg.ConnectRegistry``。" @@ -129,18 +130,18 @@ msgid "If the key already exists, this function opens the existing key." msgstr "" #: ../../library/winreg.rst:80 ../../library/winreg.rst:112 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``winreg.CreateKey`` with " -"arguments ``key``, ``sub_key``, ``access``." +"Raises an auditing event winreg.CreateKey with arguments key, sub_key, " +"access." msgstr "" "引發一個附帶引數 ``key``、``sub_key``、``access`` 的\\ :ref:`稽核事件 " "` ``winreg.CreateKey``。" #: ../../library/winreg.rst:82 ../../library/winreg.rst:114 #: ../../library/winreg.rst:324 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.OpenKey/result`` with " -"argument ``key``." +#, fuzzy +msgid "Raises an auditing event winreg.OpenKey/result with argument key." msgstr "" "引發一個附帶引數 ``key`` 的\\ :ref:`稽核事件 ` ``winreg.OpenKey/" "result``。" @@ -179,9 +180,10 @@ msgid "" msgstr "" #: ../../library/winreg.rst:137 ../../library/winreg.rst:168 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``winreg.DeleteKey`` with " -"arguments ``key``, ``sub_key``, ``access``." +"Raises an auditing event winreg.DeleteKey with arguments key, sub_key, " +"access." msgstr "" "引發一個附帶引數 ``key``、``sub_key``、``access`` 的\\ :ref:`稽核事件 " "` ``winreg.DeleteKey``。" @@ -214,9 +216,8 @@ msgid "*value* is a string that identifies the value to remove." msgstr "" #: ../../library/winreg.rst:185 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.DeleteValue`` with " -"arguments ``key``, ``value``." +#, fuzzy +msgid "Raises an auditing event winreg.DeleteValue with arguments key, value." msgstr "" "引發一個附帶引數 ``key``、``value`` 的\\ :ref:`稽核事件 ` ``winreg." "DeleteValue``。" @@ -237,9 +238,8 @@ msgid "" msgstr "" #: ../../library/winreg.rst:201 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.EnumKey`` with arguments " -"``key``, ``index``." +#, fuzzy +msgid "Raises an auditing event winreg.EnumKey with arguments key, index." msgstr "" "引發一個附帶引數 ``key``、``index`` 的\\ :ref:`稽核事件 ` ``winreg." "EnumKey``。" @@ -305,9 +305,8 @@ msgid "" msgstr "" #: ../../library/winreg.rst:236 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.EnumValue`` with " -"arguments ``key``, ``index``." +#, fuzzy +msgid "Raises an auditing event winreg.EnumValue with arguments key, index." msgstr "" "引發一個附帶引數 ``key``、``index`` 的\\ :ref:`稽核事件 ` ``winreg." "EnumValue``。" @@ -319,9 +318,9 @@ msgid "" msgstr "" #: ../../library/winreg.rst:253 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``winreg." -"ExpandEnvironmentStrings`` with argument ``str``." +"Raises an auditing event winreg.ExpandEnvironmentStrings with argument str." msgstr "" "引發一個附帶引數 ``str`` 的\\ :ref:`稽核事件 ` ``winreg." "ExpandEnvironmentStrings``。" @@ -385,9 +384,10 @@ msgid "" msgstr "" #: ../../library/winreg.rst:299 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``winreg.LoadKey`` with arguments " -"``key``, ``sub_key``, ``file_name``." +"Raises an auditing event winreg.LoadKey with arguments key, sub_key, " +"file_name." msgstr "" "引發一個附帶引數 ``key``、``sub_key``、``file_name`` 的\\ :ref:`稽核事件 " "` ``winreg.LoadKey``。" @@ -422,9 +422,9 @@ msgid "If the function fails, :exc:`OSError` is raised." msgstr "" #: ../../library/winreg.rst:322 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``winreg.OpenKey`` with arguments " -"``key``, ``sub_key``, ``access``." +"Raises an auditing event winreg.OpenKey with arguments key, sub_key, access." msgstr "" "引發一個附帶引數 ``key``、``sub_key``、``access`` 的\\ :ref:`稽核事件 " "` ``winreg.OpenKey``。" @@ -452,9 +452,8 @@ msgid "" msgstr "" #: ../../library/winreg.rst:356 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.QueryInfoKey`` with " -"argument ``key``." +#, fuzzy +msgid "Raises an auditing event winreg.QueryInfoKey with argument key." msgstr "" "引發一個附帶引數 ``key`` 的\\ :ref:`稽核事件 ` ``winreg." "QueryInfoKey``。" @@ -480,9 +479,10 @@ msgid "" msgstr "" #: ../../library/winreg.rst:375 ../../library/winreg.rst:400 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``winreg.QueryValue`` with " -"arguments ``key``, ``sub_key``, ``value_name``." +"Raises an auditing event winreg.QueryValue with arguments key, sub_key, " +"value_name." msgstr "" "引發一個附帶引數 ``key``、``sub_key``、``value_name`` 的\\ :ref:`稽核事件 " "` ``winreg.QueryKey``。" @@ -538,9 +538,8 @@ msgid "This function passes ``NULL`` for *security_attributes* to the API." msgstr "" #: ../../library/winreg.rst:425 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.SaveKey`` with arguments " -"``key``, ``file_name``." +#, fuzzy +msgid "Raises an auditing event winreg.SaveKey with arguments key, file_name." msgstr "" "引發一個附帶引數 ``key``、``file_name`` 的\\ :ref:`稽核事件 ` " "``winreg.SaveKey``。" @@ -586,9 +585,10 @@ msgid "" msgstr "" #: ../../library/winreg.rst:453 ../../library/winreg.rst:483 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``winreg.SetValue`` with " -"arguments ``key``, ``sub_key``, ``type``, ``value``." +"Raises an auditing event winreg.SetValue with arguments key, sub_key, type, " +"value." msgstr "" "引發一個附帶引數 ``key``、``sub_key``、``type``、``value`` 的\\ :ref:`稽核事" "件 ` ``winreg.SetValue``。" @@ -645,9 +645,8 @@ msgid "" msgstr "" #: ../../library/winreg.rst:501 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.DisableReflectionKey`` " -"with argument ``key``." +#, fuzzy +msgid "Raises an auditing event winreg.DisableReflectionKey with argument key." msgstr "" "引發一個附帶引數 ``key`` 的\\ :ref:`稽核事件 ` ``winreg." "DsiableReflectionKey``。" @@ -662,9 +661,8 @@ msgid "" msgstr "" #: ../../library/winreg.rst:516 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.EnableReflectionKey`` " -"with argument ``key``." +#, fuzzy +msgid "Raises an auditing event winreg.EnableReflectionKey with argument key." msgstr "" "引發一個附帶引數 ``key`` 的\\ :ref:`稽核事件 ` ``winreg." "EnableReflectionKey``。" @@ -678,9 +676,8 @@ msgid "Returns ``True`` if reflection is disabled." msgstr "" #: ../../library/winreg.rst:531 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.QueryReflectionKey`` " -"with argument ``key``." +#, fuzzy +msgid "Raises an auditing event winreg.QueryReflectionKey with argument key." msgstr "" "引發一個附帶引數 ``key`` 的\\ :ref:`稽核事件 ` ``winreg." "QueryReflectionKey``。" @@ -972,9 +969,8 @@ msgid "" msgstr "" #: ../../library/winreg.rst:784 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.PyHKEY.Detach`` with " -"argument ``key``." +#, fuzzy +msgid "Raises an auditing event winreg.PyHKEY.Detach with argument key." msgstr "" "引發一個附帶引數 ``key`` 的\\ :ref:`稽核事件 ` ``winreg.PyHKEY." "Detach``。" diff --git a/reference/datamodel.po b/reference/datamodel.po index 6bd3810027..857605ed0a 100644 --- a/reference/datamodel.po +++ b/reference/datamodel.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:17+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -600,8 +600,8 @@ msgid "" "containing the same number of items as the function's formal parameter list." msgstr "" -#: ../../reference/datamodel.rst:541 ../../reference/datamodel.rst:1127 -#: ../../reference/datamodel.rst:1322 +#: ../../reference/datamodel.rst:541 ../../reference/datamodel.rst:1120 +#: ../../reference/datamodel.rst:1315 msgid "Special read-only attributes" msgstr "特殊唯讀屬性" @@ -632,7 +632,7 @@ msgid "" "the value of the cell, as well as set the value." msgstr "" -#: ../../reference/datamodel.rst:567 ../../reference/datamodel.rst:1359 +#: ../../reference/datamodel.rst:567 ../../reference/datamodel.rst:1352 msgid "Special writable attributes" msgstr "特殊可寫屬性" @@ -734,7 +734,7 @@ msgid "" "callable object (normally a user-defined function)." msgstr "" -#: ../../reference/datamodel.rst:672 ../../reference/datamodel.rst:1450 +#: ../../reference/datamodel.rst:672 ../../reference/datamodel.rst:1443 msgid "Special read-only attributes:" msgstr "特殊唯讀屬性：" @@ -818,22 +818,16 @@ msgstr "" #: ../../reference/datamodel.rst:730 msgid "" -"Note that the transformation from :ref:`function object ` to instance method object happens each time the attribute is " -"retrieved from the instance. In some cases, a fruitful optimization is to " -"assign the attribute to a local variable and call that local variable. Also " -"notice that this transformation only happens for user-defined functions; " -"other callable objects (and all non-callable objects) are retrieved without " -"transformation. It is also important to note that user-defined functions " -"which are attributes of a class instance are not converted to bound methods; " -"this *only* happens when the function is an attribute of the class." +"It is important to note that user-defined functions which are attributes of " +"a class instance are not converted to bound methods; this *only* happens " +"when the function is an attribute of the class." msgstr "" -#: ../../reference/datamodel.rst:744 +#: ../../reference/datamodel.rst:737 msgid "Generator functions" msgstr "" -#: ../../reference/datamodel.rst:750 +#: ../../reference/datamodel.rst:743 msgid "" "A function or method which uses the :keyword:`yield` statement (see section :" "ref:`yield`) is called a :dfn:`generator function`. Such a function, when " @@ -846,11 +840,11 @@ msgid "" "values to be returned." msgstr "" -#: ../../reference/datamodel.rst:762 +#: ../../reference/datamodel.rst:755 msgid "Coroutine functions" msgstr "" -#: ../../reference/datamodel.rst:767 +#: ../../reference/datamodel.rst:760 msgid "" "A function or method which is defined using :keyword:`async def` is called " "a :dfn:`coroutine function`. Such a function, when called, returns a :term:" @@ -859,11 +853,11 @@ msgid "" "ref:`coroutine-objects` section." msgstr "" -#: ../../reference/datamodel.rst:775 +#: ../../reference/datamodel.rst:768 msgid "Asynchronous generator functions" msgstr "" -#: ../../reference/datamodel.rst:781 +#: ../../reference/datamodel.rst:774 msgid "" "A function or method which is defined using :keyword:`async def` and which " "uses the :keyword:`yield` statement is called a :dfn:`asynchronous generator " @@ -872,7 +866,7 @@ msgid "" "execute the body of the function." msgstr "" -#: ../../reference/datamodel.rst:787 +#: ../../reference/datamodel.rst:780 msgid "" "Calling the asynchronous iterator's :meth:`aiterator.__anext__ ` method will return an :term:`awaitable` which when awaited will " @@ -883,11 +877,11 @@ msgid "" "yielded." msgstr "" -#: ../../reference/datamodel.rst:800 +#: ../../reference/datamodel.rst:793 msgid "Built-in functions" msgstr "" -#: ../../reference/datamodel.rst:807 +#: ../../reference/datamodel.rst:800 msgid "" "A built-in function object is a wrapper around a C function. Examples of " "built-in functions are :func:`len` and :func:`math.sin` (:mod:`math` is a " @@ -895,7 +889,7 @@ msgid "" "determined by the C function. Special read-only attributes:" msgstr "" -#: ../../reference/datamodel.rst:812 +#: ../../reference/datamodel.rst:805 msgid "" ":attr:`!__doc__` is the function's documentation string, or ``None`` if " "unavailable. See :attr:`function.__doc__`." @@ -903,26 +897,26 @@ msgstr "" ":attr:`!__doc__` 是函式的文件字串，若不可用則為 ``None``。請見 :attr:" "`function.__doc__`。" -#: ../../reference/datamodel.rst:814 +#: ../../reference/datamodel.rst:807 msgid "" ":attr:`!__name__` is the function's name. See :attr:`function.__name__`." msgstr ":attr:`!__name__` 是函式的名稱。請見 :attr:`function.__name__`。" -#: ../../reference/datamodel.rst:815 +#: ../../reference/datamodel.rst:808 msgid ":attr:`!__self__` is set to ``None`` (but see the next item)." msgstr "" -#: ../../reference/datamodel.rst:816 +#: ../../reference/datamodel.rst:809 msgid "" ":attr:`!__module__` is the name of the module the function was defined in or " "``None`` if unavailable. See :attr:`function.__module__`." msgstr "" -#: ../../reference/datamodel.rst:824 +#: ../../reference/datamodel.rst:817 msgid "Built-in methods" msgstr "" -#: ../../reference/datamodel.rst:831 +#: ../../reference/datamodel.rst:824 msgid "" "This is really a different disguise of a built-in function, this time " "containing an object passed to the C function as an implicit extra " @@ -933,11 +927,11 @@ msgid "" "__self__>`.)" msgstr "" -#: ../../reference/datamodel.rst:840 +#: ../../reference/datamodel.rst:833 msgid "Classes" msgstr "" -#: ../../reference/datamodel.rst:842 +#: ../../reference/datamodel.rst:835 msgid "" "Classes are callable. These objects normally act as factories for new " "instances of themselves, but variations are possible for class types that " @@ -946,21 +940,21 @@ msgid "" "initialize the new instance." msgstr "" -#: ../../reference/datamodel.rst:850 +#: ../../reference/datamodel.rst:843 msgid "Class Instances" msgstr "" -#: ../../reference/datamodel.rst:852 +#: ../../reference/datamodel.rst:845 msgid "" "Instances of arbitrary classes can be made callable by defining a :meth:" "`~object.__call__` method in their class." msgstr "" -#: ../../reference/datamodel.rst:857 +#: ../../reference/datamodel.rst:850 msgid "Modules" msgstr "模組" -#: ../../reference/datamodel.rst:863 +#: ../../reference/datamodel.rst:856 msgid "" "Modules are a basic organizational unit of Python code, and are created by " "the :ref:`import system ` as invoked either by the :keyword:" @@ -975,37 +969,37 @@ msgid "" "done)." msgstr "" -#: ../../reference/datamodel.rst:876 +#: ../../reference/datamodel.rst:869 msgid "" "Attribute assignment updates the module's namespace dictionary, e.g., ``m.x " "= 1`` is equivalent to ``m.__dict__[\"x\"] = 1``." msgstr "" -#: ../../reference/datamodel.rst:886 +#: ../../reference/datamodel.rst:879 msgid "Predefined (writable) attributes:" msgstr "" -#: ../../reference/datamodel.rst:888 +#: ../../reference/datamodel.rst:881 msgid ":attr:`__name__`" msgstr ":attr:`__name__`" -#: ../../reference/datamodel.rst:889 +#: ../../reference/datamodel.rst:882 msgid "The module's name." msgstr "" -#: ../../reference/datamodel.rst:891 ../../reference/datamodel.rst:989 +#: ../../reference/datamodel.rst:884 ../../reference/datamodel.rst:982 msgid ":attr:`__doc__`" msgstr ":attr:`__doc__`" -#: ../../reference/datamodel.rst:892 +#: ../../reference/datamodel.rst:885 msgid "The module's documentation string, or ``None`` if unavailable." msgstr "" -#: ../../reference/datamodel.rst:895 +#: ../../reference/datamodel.rst:888 msgid ":attr:`__file__`" msgstr ":attr:`__file__`" -#: ../../reference/datamodel.rst:896 +#: ../../reference/datamodel.rst:889 msgid "" "The pathname of the file from which the module was loaded, if it was loaded " "from a file. The :attr:`__file__` attribute may be missing for certain types " @@ -1014,24 +1008,24 @@ msgid "" "library, it's the pathname of the shared library file." msgstr "" -#: ../../reference/datamodel.rst:904 ../../reference/datamodel.rst:992 +#: ../../reference/datamodel.rst:897 ../../reference/datamodel.rst:985 msgid ":attr:`__annotations__`" msgstr ":attr:`__annotations__`" -#: ../../reference/datamodel.rst:905 +#: ../../reference/datamodel.rst:898 msgid "" "A dictionary containing :term:`variable annotations ` " "collected during module body execution. For best practices on working with :" "attr:`__annotations__`, please see :ref:`annotations-howto`." msgstr "" -#: ../../reference/datamodel.rst:912 +#: ../../reference/datamodel.rst:905 msgid "" "Special read-only attribute: :attr:`~object.__dict__` is the module's " "namespace as a dictionary object." msgstr "" -#: ../../reference/datamodel.rst:917 +#: ../../reference/datamodel.rst:910 msgid "" "Because of the way CPython clears module dictionaries, the module dictionary " "will be cleared when the module falls out of scope even if the dictionary " @@ -1039,11 +1033,11 @@ msgid "" "module around while using its dictionary directly." msgstr "" -#: ../../reference/datamodel.rst:924 +#: ../../reference/datamodel.rst:917 msgid "Custom classes" msgstr "" -#: ../../reference/datamodel.rst:926 +#: ../../reference/datamodel.rst:919 msgid "" "Custom class types are typically created by class definitions (see section :" "ref:`class`). A class has a namespace implemented by a dictionary object. " @@ -1058,7 +1052,7 @@ msgid "" "found at :ref:`python_2.3_mro`." msgstr "" -#: ../../reference/datamodel.rst:947 +#: ../../reference/datamodel.rst:940 msgid "" "When a class attribute reference (for class :class:`!C`, say) would yield a " "class method object, it is transformed into an instance method object whose :" @@ -1069,82 +1063,82 @@ msgid "" "contained in its :attr:`~object.__dict__`." msgstr "" -#: ../../reference/datamodel.rst:958 +#: ../../reference/datamodel.rst:951 msgid "" "Class attribute assignments update the class's dictionary, never the " "dictionary of a base class." msgstr "" -#: ../../reference/datamodel.rst:963 +#: ../../reference/datamodel.rst:956 msgid "" "A class object can be called (see above) to yield a class instance (see " "below)." msgstr "" -#: ../../reference/datamodel.rst:974 +#: ../../reference/datamodel.rst:967 msgid "Special attributes:" msgstr "" -#: ../../reference/datamodel.rst:976 +#: ../../reference/datamodel.rst:969 msgid ":attr:`~definition.__name__`" msgstr ":attr:`~definition.__name__`" -#: ../../reference/datamodel.rst:977 +#: ../../reference/datamodel.rst:970 msgid "The class name." msgstr "" -#: ../../reference/datamodel.rst:979 +#: ../../reference/datamodel.rst:972 msgid ":attr:`__module__`" msgstr ":attr:`__module__`" -#: ../../reference/datamodel.rst:980 +#: ../../reference/datamodel.rst:973 msgid "The name of the module in which the class was defined." msgstr "" -#: ../../reference/datamodel.rst:982 +#: ../../reference/datamodel.rst:975 msgid ":attr:`~object.__dict__`" msgstr ":attr:`~object.__dict__`" -#: ../../reference/datamodel.rst:983 +#: ../../reference/datamodel.rst:976 msgid "The dictionary containing the class's namespace." msgstr "" -#: ../../reference/datamodel.rst:985 +#: ../../reference/datamodel.rst:978 msgid ":attr:`~class.__bases__`" msgstr ":attr:`~class.__bases__`" -#: ../../reference/datamodel.rst:986 +#: ../../reference/datamodel.rst:979 msgid "" "A tuple containing the base classes, in the order of their occurrence in the " "base class list." msgstr "" -#: ../../reference/datamodel.rst:990 +#: ../../reference/datamodel.rst:983 msgid "The class's documentation string, or ``None`` if undefined." msgstr "" -#: ../../reference/datamodel.rst:993 +#: ../../reference/datamodel.rst:986 msgid "" "A dictionary containing :term:`variable annotations ` " "collected during class body execution. For best practices on working with :" "attr:`__annotations__`, please see :ref:`annotations-howto`." msgstr "" -#: ../../reference/datamodel.rst:999 +#: ../../reference/datamodel.rst:992 msgid ":attr:`__type_params__`" msgstr ":attr:`__type_params__`" -#: ../../reference/datamodel.rst:1000 +#: ../../reference/datamodel.rst:993 msgid "" "A tuple containing the :ref:`type parameters ` of a :ref:" "`generic class `." msgstr "" -#: ../../reference/datamodel.rst:1005 +#: ../../reference/datamodel.rst:998 msgid "Class instances" msgstr "" -#: ../../reference/datamodel.rst:1013 +#: ../../reference/datamodel.rst:1006 msgid "" "A class instance is created by calling a class object (see above). A class " "instance has a namespace implemented as a dictionary which is the first " @@ -1161,7 +1155,7 @@ msgid "" "__getattr__` method, that is called to satisfy the lookup." msgstr "" -#: ../../reference/datamodel.rst:1029 +#: ../../reference/datamodel.rst:1022 msgid "" "Attribute assignments and deletions update the instance's dictionary, never " "a class's dictionary. If the class has a :meth:`~object.__setattr__` or :" @@ -1169,23 +1163,23 @@ msgid "" "instance dictionary directly." msgstr "" -#: ../../reference/datamodel.rst:1039 +#: ../../reference/datamodel.rst:1032 msgid "" "Class instances can pretend to be numbers, sequences, or mappings if they " "have methods with certain special names. See section :ref:`specialnames`." msgstr "" -#: ../../reference/datamodel.rst:1046 +#: ../../reference/datamodel.rst:1039 msgid "" "Special attributes: :attr:`~object.__dict__` is the attribute dictionary; :" "attr:`~instance.__class__` is the instance's class." msgstr "" -#: ../../reference/datamodel.rst:1051 +#: ../../reference/datamodel.rst:1044 msgid "I/O objects (also known as file objects)" msgstr "" -#: ../../reference/datamodel.rst:1066 +#: ../../reference/datamodel.rst:1059 msgid "" "A :term:`file object` represents an open file. Various shortcuts are " "available to create file objects: the :func:`open` built-in function, and " @@ -1194,7 +1188,7 @@ msgid "" "methods provided by extension modules)." msgstr "" -#: ../../reference/datamodel.rst:1072 +#: ../../reference/datamodel.rst:1065 msgid "" "The objects ``sys.stdin``, ``sys.stdout`` and ``sys.stderr`` are initialized " "to file objects corresponding to the interpreter's standard input, output " @@ -1202,22 +1196,22 @@ msgid "" "interface defined by the :class:`io.TextIOBase` abstract class." msgstr "" -#: ../../reference/datamodel.rst:1080 +#: ../../reference/datamodel.rst:1073 msgid "Internal types" msgstr "" -#: ../../reference/datamodel.rst:1086 +#: ../../reference/datamodel.rst:1079 msgid "" "A few types used internally by the interpreter are exposed to the user. " "Their definitions may change with future versions of the interpreter, but " "they are mentioned here for completeness." msgstr "" -#: ../../reference/datamodel.rst:1094 +#: ../../reference/datamodel.rst:1087 msgid "Code objects" msgstr "" -#: ../../reference/datamodel.rst:1098 +#: ../../reference/datamodel.rst:1091 msgid "" "Code objects represent *byte-compiled* executable Python code, or :term:" "`bytecode`. The difference between a code object and a function object is " @@ -1229,103 +1223,103 @@ msgid "" "no references (directly or indirectly) to mutable objects." msgstr "" -#: ../../reference/datamodel.rst:1132 +#: ../../reference/datamodel.rst:1125 msgid "The function name" msgstr "函式名稱" -#: ../../reference/datamodel.rst:1135 +#: ../../reference/datamodel.rst:1128 msgid "The fully qualified function name" msgstr "" -#: ../../reference/datamodel.rst:1140 +#: ../../reference/datamodel.rst:1133 msgid "" "The total number of positional :term:`parameters ` (including " "positional-only parameters and parameters with default values) that the " "function has" msgstr "" -#: ../../reference/datamodel.rst:1145 +#: ../../reference/datamodel.rst:1138 msgid "" "The number of positional-only :term:`parameters ` (including " "arguments with default values) that the function has" msgstr "" -#: ../../reference/datamodel.rst:1149 +#: ../../reference/datamodel.rst:1142 msgid "" "The number of keyword-only :term:`parameters ` (including " "arguments with default values) that the function has" msgstr "" -#: ../../reference/datamodel.rst:1153 +#: ../../reference/datamodel.rst:1146 msgid "" "The number of :ref:`local variables ` used by the function " "(including parameters)" msgstr "" -#: ../../reference/datamodel.rst:1157 +#: ../../reference/datamodel.rst:1150 msgid "" "A :class:`tuple` containing the names of the local variables in the function " "(starting with the parameter names)" msgstr "" -#: ../../reference/datamodel.rst:1161 +#: ../../reference/datamodel.rst:1154 msgid "" "A :class:`tuple` containing the names of :ref:`local variables ` " "that are referenced by nested functions inside the function" msgstr "" -#: ../../reference/datamodel.rst:1165 +#: ../../reference/datamodel.rst:1158 msgid "A :class:`tuple` containing the names of free variables in the function" msgstr "" -#: ../../reference/datamodel.rst:1168 +#: ../../reference/datamodel.rst:1161 msgid "" "A string representing the sequence of :term:`bytecode` instructions in the " "function" msgstr "" -#: ../../reference/datamodel.rst:1172 +#: ../../reference/datamodel.rst:1165 msgid "" "A :class:`tuple` containing the literals used by the :term:`bytecode` in the " "function" msgstr "" -#: ../../reference/datamodel.rst:1176 +#: ../../reference/datamodel.rst:1169 msgid "" "A :class:`tuple` containing the names used by the :term:`bytecode` in the " "function" msgstr "" -#: ../../reference/datamodel.rst:1180 +#: ../../reference/datamodel.rst:1173 msgid "The name of the file from which the code was compiled" msgstr "" -#: ../../reference/datamodel.rst:1183 +#: ../../reference/datamodel.rst:1176 msgid "The line number of the first line of the function" msgstr "" -#: ../../reference/datamodel.rst:1186 +#: ../../reference/datamodel.rst:1179 msgid "" "A string encoding the mapping from :term:`bytecode` offsets to line numbers. " "For details, see the source code of the interpreter." msgstr "" -#: ../../reference/datamodel.rst:1189 +#: ../../reference/datamodel.rst:1182 msgid "" "This attribute of code objects is deprecated, and may be removed in Python " "3.14." msgstr "" -#: ../../reference/datamodel.rst:1194 +#: ../../reference/datamodel.rst:1187 msgid "The required stack size of the code object" msgstr "" -#: ../../reference/datamodel.rst:1197 +#: ../../reference/datamodel.rst:1190 msgid "" "An :class:`integer ` encoding a number of flags for the interpreter." msgstr "" -#: ../../reference/datamodel.rst:1202 +#: ../../reference/datamodel.rst:1195 msgid "" "The following flag bits are defined for :attr:`~codeobject.co_flags`: bit " "``0x04`` is set if the function uses the ``*arguments`` syntax to accept an " @@ -1336,7 +1330,7 @@ msgid "" "might be present." msgstr "" -#: ../../reference/datamodel.rst:1210 +#: ../../reference/datamodel.rst:1203 msgid "" "Future feature declarations (``from __future__ import division``) also use " "bits in :attr:`~codeobject.co_flags` to indicate whether a code object was " @@ -1345,29 +1339,29 @@ msgid "" "``0x1000`` were used in earlier versions of Python." msgstr "" -#: ../../reference/datamodel.rst:1216 +#: ../../reference/datamodel.rst:1209 msgid "" "Other bits in :attr:`~codeobject.co_flags` are reserved for internal use." msgstr "" -#: ../../reference/datamodel.rst:1220 +#: ../../reference/datamodel.rst:1213 msgid "" "If a code object represents a function, the first item in :attr:`~codeobject." "co_consts` is the documentation string of the function, or ``None`` if " "undefined." msgstr "" -#: ../../reference/datamodel.rst:1225 +#: ../../reference/datamodel.rst:1218 msgid "Methods on code objects" msgstr "用於程式碼物件的方法" -#: ../../reference/datamodel.rst:1229 +#: ../../reference/datamodel.rst:1222 msgid "" "Returns an iterable over the source code positions of each :term:`bytecode` " "instruction in the code object." msgstr "" -#: ../../reference/datamodel.rst:1232 +#: ../../reference/datamodel.rst:1225 msgid "" "The iterator returns :class:`tuple`\\s containing the ``(start_line, " "end_line, start_column, end_column)``. The *i-th* tuple corresponds to the " @@ -1375,37 +1369,37 @@ msgid "" "information is 0-indexed utf-8 byte offsets on the given source line." msgstr "" -#: ../../reference/datamodel.rst:1238 +#: ../../reference/datamodel.rst:1231 msgid "" "This positional information can be missing. A non-exhaustive lists of cases " "where this may happen:" msgstr "" -#: ../../reference/datamodel.rst:1241 +#: ../../reference/datamodel.rst:1234 msgid "Running the interpreter with :option:`-X` ``no_debug_ranges``." msgstr "" -#: ../../reference/datamodel.rst:1242 +#: ../../reference/datamodel.rst:1235 msgid "" "Loading a pyc file compiled while using :option:`-X` ``no_debug_ranges``." msgstr "" -#: ../../reference/datamodel.rst:1243 +#: ../../reference/datamodel.rst:1236 msgid "Position tuples corresponding to artificial instructions." msgstr "" -#: ../../reference/datamodel.rst:1244 +#: ../../reference/datamodel.rst:1237 msgid "" "Line and column numbers that can't be represented due to implementation " "specific limitations." msgstr "" -#: ../../reference/datamodel.rst:1247 +#: ../../reference/datamodel.rst:1240 msgid "" "When this occurs, some or all of the tuple elements can be :const:`None`." msgstr "" -#: ../../reference/datamodel.rst:1253 +#: ../../reference/datamodel.rst:1246 msgid "" "This feature requires storing column positions in code objects which may " "result in a small increase of disk usage of compiled Python files or " @@ -1415,95 +1409,95 @@ msgid "" "environment variable can be used." msgstr "" -#: ../../reference/datamodel.rst:1262 +#: ../../reference/datamodel.rst:1255 msgid "" "Returns an iterator that yields information about successive ranges of :term:" "`bytecode`\\s. Each item yielded is a ``(start, end, lineno)`` :class:" "`tuple`:" msgstr "" -#: ../../reference/datamodel.rst:1266 +#: ../../reference/datamodel.rst:1259 msgid "" "``start`` (an :class:`int`) represents the offset (inclusive) of the start " "of the :term:`bytecode` range" msgstr "" -#: ../../reference/datamodel.rst:1268 +#: ../../reference/datamodel.rst:1261 msgid "" "``end`` (an :class:`int`) represents the offset (exclusive) of the end of " "the :term:`bytecode` range" msgstr "" -#: ../../reference/datamodel.rst:1270 +#: ../../reference/datamodel.rst:1263 msgid "" "``lineno`` is an :class:`int` representing the line number of the :term:" "`bytecode` range, or ``None`` if the bytecodes in the given range have no " "line number" msgstr "" -#: ../../reference/datamodel.rst:1274 +#: ../../reference/datamodel.rst:1267 msgid "The items yielded will have the following properties:" msgstr "" -#: ../../reference/datamodel.rst:1276 +#: ../../reference/datamodel.rst:1269 msgid "The first range yielded will have a ``start`` of 0." msgstr "" -#: ../../reference/datamodel.rst:1277 +#: ../../reference/datamodel.rst:1270 msgid "" "The ``(start, end)`` ranges will be non-decreasing and consecutive. That is, " "for any pair of :class:`tuple`\\s, the ``start`` of the second will be equal " "to the ``end`` of the first." msgstr "" -#: ../../reference/datamodel.rst:1280 +#: ../../reference/datamodel.rst:1273 msgid "No range will be backwards: ``end >= start`` for all triples." msgstr "" -#: ../../reference/datamodel.rst:1281 +#: ../../reference/datamodel.rst:1274 msgid "" "The last :class:`tuple` yielded will have ``end`` equal to the size of the :" "term:`bytecode`." msgstr "" -#: ../../reference/datamodel.rst:1284 +#: ../../reference/datamodel.rst:1277 msgid "" "Zero-width ranges, where ``start == end``, are allowed. Zero-width ranges " "are used for lines that are present in the source code, but have been " "eliminated by the :term:`bytecode` compiler." msgstr "" -#: ../../reference/datamodel.rst:1292 +#: ../../reference/datamodel.rst:1285 msgid ":pep:`626` - Precise line numbers for debugging and other tools." msgstr "" -#: ../../reference/datamodel.rst:1293 +#: ../../reference/datamodel.rst:1286 msgid "The PEP that introduced the :meth:`!co_lines` method." msgstr "" -#: ../../reference/datamodel.rst:1297 +#: ../../reference/datamodel.rst:1290 msgid "" "Return a copy of the code object with new values for the specified fields." msgstr "" -#: ../../reference/datamodel.rst:1305 +#: ../../reference/datamodel.rst:1298 msgid "Frame objects" msgstr "" -#: ../../reference/datamodel.rst:1309 +#: ../../reference/datamodel.rst:1302 msgid "" "Frame objects represent execution frames. They may occur in :ref:`traceback " "objects `, and are also passed to registered trace " "functions." msgstr "" -#: ../../reference/datamodel.rst:1327 +#: ../../reference/datamodel.rst:1320 msgid "" "Points to the previous stack frame (towards the caller), or ``None`` if this " "is the bottom stack frame" msgstr "" -#: ../../reference/datamodel.rst:1331 +#: ../../reference/datamodel.rst:1324 msgid "" "The :ref:`code object ` being executed in this frame. " "Accessing this attribute raises an :ref:`auditing event ` ``object." @@ -1513,49 +1507,49 @@ msgstr "" "這個屬性會引發一個附帶引數 ``obj`` 與 ``\"f_code\"`` 的\\ :ref:`稽核事件 " "` ``object.__getattr__``。" -#: ../../reference/datamodel.rst:1336 +#: ../../reference/datamodel.rst:1329 msgid "" "The dictionary used by the frame to look up :ref:`local variables `" msgstr "" -#: ../../reference/datamodel.rst:1340 +#: ../../reference/datamodel.rst:1333 msgid "" "The dictionary used by the frame to look up :ref:`global variables `" msgstr "" -#: ../../reference/datamodel.rst:1344 +#: ../../reference/datamodel.rst:1337 msgid "" "The dictionary used by the frame to look up :ref:`built-in (intrinsic) names " "`" msgstr "" -#: ../../reference/datamodel.rst:1348 +#: ../../reference/datamodel.rst:1341 msgid "" "The \"precise instruction\" of the frame object (this is an index into the :" "term:`bytecode` string of the :ref:`code object `)" msgstr "" -#: ../../reference/datamodel.rst:1364 +#: ../../reference/datamodel.rst:1357 msgid "" "If not ``None``, this is a function called for various events during code " "execution (this is used by debuggers). Normally an event is triggered for " "each new source line (see :attr:`~frame.f_trace_lines`)." msgstr "" -#: ../../reference/datamodel.rst:1369 +#: ../../reference/datamodel.rst:1362 msgid "" "Set this attribute to :const:`False` to disable triggering a tracing event " "for each source line." msgstr "" -#: ../../reference/datamodel.rst:1373 +#: ../../reference/datamodel.rst:1366 msgid "" "Set this attribute to :const:`True` to allow per-opcode events to be " "requested. Note that this may lead to undefined interpreter behaviour if " "exceptions raised by the trace function escape to the function being traced." msgstr "" -#: ../../reference/datamodel.rst:1379 +#: ../../reference/datamodel.rst:1372 msgid "" "The current line number of the frame -- writing to this from within a trace " "function jumps to the given line (only for the bottom-most frame). A " @@ -1563,15 +1557,15 @@ msgid "" "this attribute." msgstr "" -#: ../../reference/datamodel.rst:1385 +#: ../../reference/datamodel.rst:1378 msgid "Frame object methods" msgstr "" -#: ../../reference/datamodel.rst:1387 +#: ../../reference/datamodel.rst:1380 msgid "Frame objects support one method:" msgstr "" -#: ../../reference/datamodel.rst:1391 +#: ../../reference/datamodel.rst:1384 msgid "" "This method clears all references to :ref:`local variables ` held by " "the frame. Also, if the frame belonged to a :term:`generator`, the " @@ -1580,26 +1574,26 @@ msgid "" "and storing its :ref:`traceback ` for later use)." msgstr "" -#: ../../reference/datamodel.rst:1397 +#: ../../reference/datamodel.rst:1390 msgid ":exc:`RuntimeError` is raised if the frame is currently executing." msgstr "" -#: ../../reference/datamodel.rst:1405 +#: ../../reference/datamodel.rst:1398 msgid "Traceback objects" msgstr "" -#: ../../reference/datamodel.rst:1418 +#: ../../reference/datamodel.rst:1411 msgid "" "Traceback objects represent the stack trace of an :ref:`exception `. A traceback object is implicitly created when an exception occurs, " "and may also be explicitly created by calling :class:`types.TracebackType`." msgstr "" -#: ../../reference/datamodel.rst:1423 +#: ../../reference/datamodel.rst:1416 msgid "Traceback objects can now be explicitly instantiated from Python code." msgstr "" -#: ../../reference/datamodel.rst:1426 +#: ../../reference/datamodel.rst:1419 msgid "" "For implicitly created tracebacks, when the search for an exception handler " "unwinds the execution stack, at each unwound level a traceback object is " @@ -1610,7 +1604,7 @@ msgid "" "the caught exception." msgstr "" -#: ../../reference/datamodel.rst:1435 +#: ../../reference/datamodel.rst:1428 msgid "" "When the program contains no suitable handler, the stack trace is written " "(nicely formatted) to the standard error stream; if the interpreter is " @@ -1618,19 +1612,19 @@ msgid "" "last_traceback`." msgstr "" -#: ../../reference/datamodel.rst:1440 +#: ../../reference/datamodel.rst:1433 msgid "" "For explicitly created tracebacks, it is up to the creator of the traceback " "to determine how the :attr:`~traceback.tb_next` attributes should be linked " "to form a full stack trace." msgstr "" -#: ../../reference/datamodel.rst:1455 +#: ../../reference/datamodel.rst:1448 msgid "" "Points to the execution :ref:`frame ` of the current level." msgstr "" -#: ../../reference/datamodel.rst:1458 +#: ../../reference/datamodel.rst:1451 msgid "" "Accessing this attribute raises an :ref:`auditing event ` ``object." "__getattr__`` with arguments ``obj`` and ``\"tb_frame\"``." @@ -1638,15 +1632,15 @@ msgstr "" "存取此屬性會引發一個附帶引數 ``obj`` 與 ``\"tb_frame\"`` 的\\ :ref:`稽核事件 " "` ``object.__getattr__``。" -#: ../../reference/datamodel.rst:1463 +#: ../../reference/datamodel.rst:1456 msgid "Gives the line number where the exception occurred" msgstr "" -#: ../../reference/datamodel.rst:1466 +#: ../../reference/datamodel.rst:1459 msgid "Indicates the \"precise instruction\"." msgstr "" -#: ../../reference/datamodel.rst:1468 +#: ../../reference/datamodel.rst:1461 msgid "" "The line number and last instruction in the traceback may differ from the " "line number of its :ref:`frame object ` if the exception " @@ -1654,39 +1648,39 @@ msgid "" "with a :keyword:`finally` clause." msgstr "" -#: ../../reference/datamodel.rst:1479 +#: ../../reference/datamodel.rst:1472 msgid "" "The special writable attribute :attr:`!tb_next` is the next level in the " "stack trace (towards the frame where the exception occurred), or ``None`` if " "there is no next level." msgstr "" -#: ../../reference/datamodel.rst:1483 +#: ../../reference/datamodel.rst:1476 msgid "This attribute is now writable" msgstr "" -#: ../../reference/datamodel.rst:1488 +#: ../../reference/datamodel.rst:1481 msgid "Slice objects" msgstr "" -#: ../../reference/datamodel.rst:1492 +#: ../../reference/datamodel.rst:1485 msgid "" "Slice objects are used to represent slices for :meth:`~object.__getitem__` " "methods. They are also created by the built-in :func:`slice` function." msgstr "" -#: ../../reference/datamodel.rst:1501 +#: ../../reference/datamodel.rst:1494 msgid "" "Special read-only attributes: :attr:`~slice.start` is the lower bound; :attr:" "`~slice.stop` is the upper bound; :attr:`~slice.step` is the step value; " "each is ``None`` if omitted. These attributes can have any type." msgstr "" -#: ../../reference/datamodel.rst:1505 +#: ../../reference/datamodel.rst:1498 msgid "Slice objects support one method:" msgstr "" -#: ../../reference/datamodel.rst:1509 +#: ../../reference/datamodel.rst:1502 msgid "" "This method takes a single integer argument *length* and computes " "information about the slice that the slice object would describe if applied " @@ -1696,11 +1690,11 @@ msgid "" "a manner consistent with regular slices." msgstr "" -#: ../../reference/datamodel.rst:1518 +#: ../../reference/datamodel.rst:1511 msgid "Static method objects" msgstr "" -#: ../../reference/datamodel.rst:1520 +#: ../../reference/datamodel.rst:1513 msgid "" "Static method objects provide a way of defeating the transformation of " "function objects to method objects described above. A static method object " @@ -1711,11 +1705,11 @@ msgid "" "method objects are created by the built-in :func:`staticmethod` constructor." msgstr "" -#: ../../reference/datamodel.rst:1530 +#: ../../reference/datamodel.rst:1523 msgid "Class method objects" msgstr "" -#: ../../reference/datamodel.rst:1532 +#: ../../reference/datamodel.rst:1525 msgid "" "A class method object, like a static method object, is a wrapper around " "another object that alters the way in which that object is retrieved from " @@ -1725,11 +1719,11 @@ msgid "" "`classmethod` constructor." msgstr "" -#: ../../reference/datamodel.rst:1542 +#: ../../reference/datamodel.rst:1535 msgid "Special method names" msgstr "" -#: ../../reference/datamodel.rst:1548 +#: ../../reference/datamodel.rst:1541 msgid "" "A class can implement certain operations that are invoked by special syntax " "(such as arithmetic operations or subscripting and slicing) by defining " @@ -1743,7 +1737,7 @@ msgid "" "`TypeError`)." msgstr "" -#: ../../reference/datamodel.rst:1559 +#: ../../reference/datamodel.rst:1552 msgid "" "Setting a special method to ``None`` indicates that the corresponding " "operation is not available. For example, if a class sets :meth:`~object." @@ -1752,7 +1746,7 @@ msgid "" "`~object.__getitem__`). [#]_" msgstr "" -#: ../../reference/datamodel.rst:1565 +#: ../../reference/datamodel.rst:1558 msgid "" "When implementing a class that emulates any built-in type, it is important " "that the emulation only be implemented to the degree that it makes sense for " @@ -1762,11 +1756,11 @@ msgid "" "the W3C's Document Object Model.)" msgstr "" -#: ../../reference/datamodel.rst:1576 +#: ../../reference/datamodel.rst:1569 msgid "Basic customization" msgstr "" -#: ../../reference/datamodel.rst:1582 +#: ../../reference/datamodel.rst:1575 msgid "" "Called to create a new instance of class *cls*. :meth:`__new__` is a static " "method (special-cased so you need not declare it as such) that takes the " @@ -1776,7 +1770,7 @@ msgid "" "new object instance (usually an instance of *cls*)." msgstr "" -#: ../../reference/datamodel.rst:1589 +#: ../../reference/datamodel.rst:1582 msgid "" "Typical implementations create a new instance of the class by invoking the " "superclass's :meth:`__new__` method using ``super().__new__(cls[, ...])`` " @@ -1784,7 +1778,7 @@ msgid "" "necessary before returning it." msgstr "" -#: ../../reference/datamodel.rst:1594 +#: ../../reference/datamodel.rst:1587 msgid "" "If :meth:`__new__` is invoked during object construction and it returns an " "instance of *cls*, then the new instance’s :meth:`__init__` method will be " @@ -1793,13 +1787,13 @@ msgid "" "constructor." msgstr "" -#: ../../reference/datamodel.rst:1599 +#: ../../reference/datamodel.rst:1592 msgid "" "If :meth:`__new__` does not return an instance of *cls*, then the new " "instance's :meth:`__init__` method will not be invoked." msgstr "" -#: ../../reference/datamodel.rst:1602 +#: ../../reference/datamodel.rst:1595 msgid "" ":meth:`__new__` is intended mainly to allow subclasses of immutable types " "(like int, str, or tuple) to customize instance creation. It is also " @@ -1807,7 +1801,7 @@ msgid "" "creation." msgstr "" -#: ../../reference/datamodel.rst:1611 +#: ../../reference/datamodel.rst:1604 msgid "" "Called after the instance has been created (by :meth:`__new__`), but before " "it is returned to the caller. The arguments are those passed to the class " @@ -1817,7 +1811,7 @@ msgid "" "example: ``super().__init__([args...])``." msgstr "" -#: ../../reference/datamodel.rst:1618 +#: ../../reference/datamodel.rst:1611 msgid "" "Because :meth:`__new__` and :meth:`__init__` work together in constructing " "objects (:meth:`__new__` to create it, and :meth:`__init__` to customize " @@ -1825,7 +1819,7 @@ msgid "" "will cause a :exc:`TypeError` to be raised at runtime." msgstr "" -#: ../../reference/datamodel.rst:1631 +#: ../../reference/datamodel.rst:1624 msgid "" "Called when the instance is about to be destroyed. This is also called a " "finalizer or (improperly) a destructor. If a base class has a :meth:" @@ -1834,7 +1828,7 @@ msgid "" "instance." msgstr "" -#: ../../reference/datamodel.rst:1637 +#: ../../reference/datamodel.rst:1630 msgid "" "It is possible (though not recommended!) for the :meth:`__del__` method to " "postpone destruction of the instance by creating a new reference to it. " @@ -1844,7 +1838,7 @@ msgid "" "it once." msgstr "" -#: ../../reference/datamodel.rst:1644 +#: ../../reference/datamodel.rst:1637 msgid "" "It is not guaranteed that :meth:`__del__` methods are called for objects " "that still exist when the interpreter exits. :class:`weakref.finalize` " @@ -1852,14 +1846,14 @@ msgid "" "when an object is garbage collected." msgstr "" -#: ../../reference/datamodel.rst:1651 +#: ../../reference/datamodel.rst:1644 msgid "" "``del x`` doesn't directly call ``x.__del__()`` --- the former decrements " "the reference count for ``x`` by one, and the latter is only called when " "``x``'s reference count reaches zero." msgstr "" -#: ../../reference/datamodel.rst:1656 +#: ../../reference/datamodel.rst:1649 msgid "" "It is possible for a reference cycle to prevent the reference count of an " "object from going to zero. In this case, the cycle will be later detected " @@ -1870,18 +1864,18 @@ msgid "" "caught in the traceback." msgstr "" -#: ../../reference/datamodel.rst:1666 +#: ../../reference/datamodel.rst:1659 msgid "Documentation for the :mod:`gc` module." msgstr "" -#: ../../reference/datamodel.rst:1670 +#: ../../reference/datamodel.rst:1663 msgid "" "Due to the precarious circumstances under which :meth:`__del__` methods are " "invoked, exceptions that occur during their execution are ignored, and a " "warning is printed to ``sys.stderr`` instead. In particular:" msgstr "" -#: ../../reference/datamodel.rst:1674 +#: ../../reference/datamodel.rst:1667 msgid "" ":meth:`__del__` can be invoked when arbitrary code is being executed, " "including from any arbitrary thread. If :meth:`__del__` needs to take a " @@ -1890,7 +1884,7 @@ msgid "" "`__del__`." msgstr "" -#: ../../reference/datamodel.rst:1680 +#: ../../reference/datamodel.rst:1673 msgid "" ":meth:`__del__` can be executed during interpreter shutdown. As a " "consequence, the global variables it needs to access (including other " @@ -1901,7 +1895,7 @@ msgid "" "still available at the time when the :meth:`__del__` method is called." msgstr "" -#: ../../reference/datamodel.rst:1695 +#: ../../reference/datamodel.rst:1688 msgid "" "Called by the :func:`repr` built-in function to compute the \"official\" " "string representation of an object. If at all possible, this should look " @@ -1913,13 +1907,13 @@ msgid "" "an \"informal\" string representation of instances of that class is required." msgstr "" -#: ../../reference/datamodel.rst:1704 +#: ../../reference/datamodel.rst:1697 msgid "" "This is typically used for debugging, so it is important that the " "representation is information-rich and unambiguous." msgstr "" -#: ../../reference/datamodel.rst:1715 +#: ../../reference/datamodel.rst:1708 msgid "" "Called by :func:`str(object) ` and the built-in functions :func:" "`format` and :func:`print` to compute the \"informal\" or nicely printable " @@ -1927,26 +1921,26 @@ msgid "" "` object." msgstr "" -#: ../../reference/datamodel.rst:1720 +#: ../../reference/datamodel.rst:1713 msgid "" "This method differs from :meth:`object.__repr__` in that there is no " "expectation that :meth:`__str__` return a valid Python expression: a more " "convenient or concise representation can be used." msgstr "" -#: ../../reference/datamodel.rst:1724 +#: ../../reference/datamodel.rst:1717 msgid "" "The default implementation defined by the built-in type :class:`object` " "calls :meth:`object.__repr__`." msgstr "" -#: ../../reference/datamodel.rst:1734 +#: ../../reference/datamodel.rst:1727 msgid "" "Called by :ref:`bytes ` to compute a byte-string representation " "of an object. This should return a :class:`bytes` object." msgstr "" -#: ../../reference/datamodel.rst:1745 +#: ../../reference/datamodel.rst:1738 msgid "" "Called by the :func:`format` built-in function, and by extension, evaluation " "of :ref:`formatted string literals ` and the :meth:`str.format` " @@ -1958,28 +1952,28 @@ msgid "" "formatting option syntax." msgstr "" -#: ../../reference/datamodel.rst:1755 +#: ../../reference/datamodel.rst:1748 msgid "" "See :ref:`formatspec` for a description of the standard formatting syntax." msgstr "" -#: ../../reference/datamodel.rst:1757 +#: ../../reference/datamodel.rst:1750 msgid "The return value must be a string object." msgstr "" -#: ../../reference/datamodel.rst:1759 +#: ../../reference/datamodel.rst:1752 msgid "" "The __format__ method of ``object`` itself raises a :exc:`TypeError` if " "passed any non-empty string." msgstr "" -#: ../../reference/datamodel.rst:1763 +#: ../../reference/datamodel.rst:1756 msgid "" "``object.__format__(x, '')`` is now equivalent to ``str(x)`` rather than " "``format(str(x), '')``." msgstr "" -#: ../../reference/datamodel.rst:1779 +#: ../../reference/datamodel.rst:1772 msgid "" "These are the so-called \"rich comparison\" methods. The correspondence " "between operator symbols and method names is as follows: ``x.__hash__``." msgstr "" -#: ../../reference/datamodel.rst:1871 +#: ../../reference/datamodel.rst:1864 msgid "" "If a class that does not override :meth:`__eq__` wishes to suppress hash " "support, it should include ``__hash__ = None`` in the class definition. A " @@ -2105,7 +2099,7 @@ msgid "" "``isinstance(obj, collections.abc.Hashable)`` call." msgstr "" -#: ../../reference/datamodel.rst:1880 +#: ../../reference/datamodel.rst:1873 msgid "" "By default, the :meth:`__hash__` values of str and bytes objects are " "\"salted\" with an unpredictable random value. Although they remain " @@ -2113,7 +2107,7 @@ msgid "" "between repeated invocations of Python." msgstr "" -#: ../../reference/datamodel.rst:1885 +#: ../../reference/datamodel.rst:1878 msgid "" "This is intended to provide protection against a denial-of-service caused by " "carefully chosen inputs that exploit the worst case performance of a dict " @@ -2121,22 +2115,22 @@ msgid "" "advisories/ocert-2011-003.html for details." msgstr "" -#: ../../reference/datamodel.rst:1890 +#: ../../reference/datamodel.rst:1883 msgid "" "Changing hash values affects the iteration order of sets. Python has never " "made guarantees about this ordering (and it typically varies between 32-bit " "and 64-bit builds)." msgstr "" -#: ../../reference/datamodel.rst:1894 +#: ../../reference/datamodel.rst:1887 msgid "See also :envvar:`PYTHONHASHSEED`." msgstr "另請參閱 :envvar:`PYTHONHASHSEED`。" -#: ../../reference/datamodel.rst:1896 +#: ../../reference/datamodel.rst:1889 msgid "Hash randomization is enabled by default." msgstr "" -#: ../../reference/datamodel.rst:1904 +#: ../../reference/datamodel.rst:1897 msgid "" "Called to implement truth value testing and the built-in operation " "``bool()``; should return ``False`` or ``True``. When this method is not " @@ -2145,18 +2139,18 @@ msgid "" "meth:`!__len__` nor :meth:`!__bool__`, all its instances are considered true." msgstr "" -#: ../../reference/datamodel.rst:1915 +#: ../../reference/datamodel.rst:1908 msgid "Customizing attribute access" msgstr "" -#: ../../reference/datamodel.rst:1917 +#: ../../reference/datamodel.rst:1910 msgid "" "The following methods can be defined to customize the meaning of attribute " "access (use of, assignment to, or deletion of ``x.name``) for class " "instances." msgstr "" -#: ../../reference/datamodel.rst:1925 +#: ../../reference/datamodel.rst:1918 msgid "" "Called when the default attribute access fails with an :exc:`AttributeError` " "(either :meth:`__getattribute__` raises an :exc:`AttributeError` because " @@ -2166,7 +2160,7 @@ msgid "" "attribute value or raise an :exc:`AttributeError` exception." msgstr "" -#: ../../reference/datamodel.rst:1932 +#: ../../reference/datamodel.rst:1925 msgid "" "Note that if the attribute is found through the normal mechanism, :meth:" "`__getattr__` is not called. (This is an intentional asymmetry between :" @@ -2179,7 +2173,7 @@ msgid "" "actually get total control over attribute access." msgstr "" -#: ../../reference/datamodel.rst:1945 +#: ../../reference/datamodel.rst:1938 msgid "" "Called unconditionally to implement attribute accesses for instances of the " "class. If the class also defines :meth:`__getattr__`, the latter will not be " @@ -2191,88 +2185,91 @@ msgid "" "example, ``object.__getattribute__(self, name)``." msgstr "" -#: ../../reference/datamodel.rst:1956 +#: ../../reference/datamodel.rst:1949 msgid "" "This method may still be bypassed when looking up special methods as the " "result of implicit invocation via language syntax or :ref:`built-in " "functions `. See :ref:`special-lookup`." msgstr "" -#: ../../reference/datamodel.rst:1961 +#: ../../reference/datamodel.rst:1954 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``object.__getattr__`` with " -"arguments ``obj``, ``name``." +"For certain sensitive attribute accesses, raises an auditing event object." +"__getattr__ with arguments obj and name." msgstr "" -"引發一個附帶引數 ``obj``、``name`` 的\\ :ref:`稽核事件 ` ``object." -"__getattr__``。" +"存取此屬性會引發一個附帶引數 ``obj`` 與 ``\"tb_frame\"`` 的\\ :ref:`稽核事件 " +"` ``object.__getattr__``。" -#: ../../reference/datamodel.rst:1963 +#: ../../reference/datamodel.rst:1956 msgid "" "For certain sensitive attribute accesses, raises an :ref:`auditing event " "` ``object.__getattr__`` with arguments ``obj`` and ``name``." msgstr "" -#: ../../reference/datamodel.rst:1970 +#: ../../reference/datamodel.rst:1963 msgid "" "Called when an attribute assignment is attempted. This is called instead of " "the normal mechanism (i.e. store the value in the instance dictionary). " "*name* is the attribute name, *value* is the value to be assigned to it." msgstr "" -#: ../../reference/datamodel.rst:1974 +#: ../../reference/datamodel.rst:1967 msgid "" "If :meth:`__setattr__` wants to assign to an instance attribute, it should " "call the base class method with the same name, for example, ``object." "__setattr__(self, name, value)``." msgstr "" -#: ../../reference/datamodel.rst:1978 +#: ../../reference/datamodel.rst:1971 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``object.__setattr__`` with " -"arguments ``obj``, ``name``, ``value``." +"For certain sensitive attribute assignments, raises an auditing event object." +"__setattr__ with arguments obj, name, value." msgstr "" -"引發一個附帶引數 ``obj``、``name``、``value`` 的\\ :ref:`稽核事件 " -"` ``object.__setattr__``。" +"存取此屬性會引發一個附帶引數 ``obj`` 與 ``\"tb_frame\"`` 的\\ :ref:`稽核事件 " +"` ``object.__getattr__``。" -#: ../../reference/datamodel.rst:1980 +#: ../../reference/datamodel.rst:1973 msgid "" "For certain sensitive attribute assignments, raises an :ref:`auditing event " "` ``object.__setattr__`` with arguments ``obj``, ``name``, " "``value``." msgstr "" -#: ../../reference/datamodel.rst:1987 +#: ../../reference/datamodel.rst:1980 msgid "" "Like :meth:`__setattr__` but for attribute deletion instead of assignment. " "This should only be implemented if ``del obj.name`` is meaningful for the " "object." msgstr "" -#: ../../reference/datamodel.rst:1990 +#: ../../reference/datamodel.rst:1983 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``object.__delattr__`` with " -"arguments ``obj``, ``name``." +"For certain sensitive attribute deletions, raises an auditing event object." +"__delattr__ with arguments obj and name." msgstr "" -"引發一個附帶引數 ``obj``、``name`` 的\\ :ref:`稽核事件 ` ``object." -"__delattr__``。" +"存取此屬性會引發一個附帶引數 ``obj`` 與 ``\"tb_frame\"`` 的\\ :ref:`稽核事件 " +"` ``object.__getattr__``。" -#: ../../reference/datamodel.rst:1992 +#: ../../reference/datamodel.rst:1985 msgid "" "For certain sensitive attribute deletions, raises an :ref:`auditing event " "` ``object.__delattr__`` with arguments ``obj`` and ``name``." msgstr "" -#: ../../reference/datamodel.rst:1999 +#: ../../reference/datamodel.rst:1992 msgid "" "Called when :func:`dir` is called on the object. An iterable must be " "returned. :func:`dir` converts the returned iterable to a list and sorts it." msgstr "" -#: ../../reference/datamodel.rst:2004 +#: ../../reference/datamodel.rst:1997 msgid "Customizing module attribute access" msgstr "" -#: ../../reference/datamodel.rst:2011 +#: ../../reference/datamodel.rst:2004 msgid "" "Special names ``__getattr__`` and ``__dir__`` can be also used to customize " "access to module attributes. The ``__getattr__`` function at the module " @@ -2284,21 +2281,21 @@ msgid "" "with the attribute name and the result is returned." msgstr "" -#: ../../reference/datamodel.rst:2020 +#: ../../reference/datamodel.rst:2013 msgid "" "The ``__dir__`` function should accept no arguments, and return an iterable " "of strings that represents the names accessible on module. If present, this " "function overrides the standard :func:`dir` search on a module." msgstr "" -#: ../../reference/datamodel.rst:2024 +#: ../../reference/datamodel.rst:2017 msgid "" "For a more fine grained customization of the module behavior (setting " "attributes, properties, etc.), one can set the ``__class__`` attribute of a " "module object to a subclass of :class:`types.ModuleType`. For example::" msgstr "" -#: ../../reference/datamodel.rst:2042 +#: ../../reference/datamodel.rst:2035 msgid "" "Defining module ``__getattr__`` and setting module ``__class__`` only affect " "lookups made using the attribute access syntax -- directly accessing the " @@ -2306,27 +2303,27 @@ msgid "" "module's globals dictionary) is unaffected." msgstr "" -#: ../../reference/datamodel.rst:2047 +#: ../../reference/datamodel.rst:2040 msgid "``__class__`` module attribute is now writable." msgstr "" -#: ../../reference/datamodel.rst:2050 +#: ../../reference/datamodel.rst:2043 msgid "``__getattr__`` and ``__dir__`` module attributes." msgstr "" -#: ../../reference/datamodel.rst:2055 +#: ../../reference/datamodel.rst:2048 msgid ":pep:`562` - Module __getattr__ and __dir__" msgstr ":pep:`562` - 模組 __getattr__ 和 __dir__" -#: ../../reference/datamodel.rst:2056 +#: ../../reference/datamodel.rst:2049 msgid "Describes the ``__getattr__`` and ``__dir__`` functions on modules." msgstr "" -#: ../../reference/datamodel.rst:2062 +#: ../../reference/datamodel.rst:2055 msgid "Implementing Descriptors" msgstr "" -#: ../../reference/datamodel.rst:2064 +#: ../../reference/datamodel.rst:2057 msgid "" "The following methods only apply when an instance of the class containing " "the method (a so-called *descriptor* class) appears in an *owner* class (the " @@ -2336,7 +2333,7 @@ msgid "" "the owner class' :attr:`~object.__dict__`." msgstr "" -#: ../../reference/datamodel.rst:2074 +#: ../../reference/datamodel.rst:2067 msgid "" "Called to get the attribute of the owner class (class attribute access) or " "of an instance of that class (instance attribute access). The optional " @@ -2345,13 +2342,13 @@ msgid "" "accessed through the *owner*." msgstr "" -#: ../../reference/datamodel.rst:2080 +#: ../../reference/datamodel.rst:2073 msgid "" "This method should return the computed attribute value or raise an :exc:" "`AttributeError` exception." msgstr "" -#: ../../reference/datamodel.rst:2083 +#: ../../reference/datamodel.rst:2076 msgid "" ":PEP:`252` specifies that :meth:`__get__` is callable with one or two " "arguments. Python's own built-in descriptors support this specification; " @@ -2361,31 +2358,31 @@ msgid "" "not." msgstr "" -#: ../../reference/datamodel.rst:2092 +#: ../../reference/datamodel.rst:2085 msgid "" "Called to set the attribute on an instance *instance* of the owner class to " "a new value, *value*." msgstr "" -#: ../../reference/datamodel.rst:2095 +#: ../../reference/datamodel.rst:2088 msgid "" "Note, adding :meth:`__set__` or :meth:`__delete__` changes the kind of " "descriptor to a \"data descriptor\". See :ref:`descriptor-invocation` for " "more details." msgstr "" -#: ../../reference/datamodel.rst:2101 +#: ../../reference/datamodel.rst:2094 msgid "" "Called to delete the attribute on an instance *instance* of the owner class." msgstr "" -#: ../../reference/datamodel.rst:2103 +#: ../../reference/datamodel.rst:2096 msgid "" "Instances of descriptors may also have the :attr:`!__objclass__` attribute " "present:" msgstr "" -#: ../../reference/datamodel.rst:2108 +#: ../../reference/datamodel.rst:2101 msgid "" "The attribute :attr:`!__objclass__` is interpreted by the :mod:`inspect` " "module as specifying the class where this object was defined (setting this " @@ -2396,11 +2393,11 @@ msgid "" "are implemented in C)." msgstr "" -#: ../../reference/datamodel.rst:2119 +#: ../../reference/datamodel.rst:2112 msgid "Invoking Descriptors" msgstr "" -#: ../../reference/datamodel.rst:2121 +#: ../../reference/datamodel.rst:2114 msgid "" "In general, a descriptor is an object attribute with \"binding behavior\", " "one whose attribute access has been overridden by methods in the descriptor " @@ -2409,7 +2406,7 @@ msgid "" "is said to be a descriptor." msgstr "" -#: ../../reference/datamodel.rst:2127 +#: ../../reference/datamodel.rst:2120 msgid "" "The default behavior for attribute access is to get, set, or delete the " "attribute from an object's dictionary. For instance, ``a.x`` has a lookup " @@ -2417,7 +2414,7 @@ msgid "" "continuing through the base classes of ``type(a)`` excluding metaclasses." msgstr "" -#: ../../reference/datamodel.rst:2132 +#: ../../reference/datamodel.rst:2125 msgid "" "However, if the looked-up value is an object defining one of the descriptor " "methods, then Python may override the default behavior and invoke the " @@ -2425,54 +2422,54 @@ msgid "" "depends on which descriptor methods were defined and how they were called." msgstr "" -#: ../../reference/datamodel.rst:2137 +#: ../../reference/datamodel.rst:2130 msgid "" "The starting point for descriptor invocation is a binding, ``a.x``. How the " "arguments are assembled depends on ``a``:" msgstr "" -#: ../../reference/datamodel.rst:2140 +#: ../../reference/datamodel.rst:2133 msgid "Direct Call" msgstr "" -#: ../../reference/datamodel.rst:2141 +#: ../../reference/datamodel.rst:2134 msgid "" "The simplest and least common call is when user code directly invokes a " "descriptor method: ``x.__get__(a)``." msgstr "" -#: ../../reference/datamodel.rst:2144 +#: ../../reference/datamodel.rst:2137 msgid "Instance Binding" msgstr "" -#: ../../reference/datamodel.rst:2145 +#: ../../reference/datamodel.rst:2138 msgid "" "If binding to an object instance, ``a.x`` is transformed into the call: " "``type(a).__dict__['x'].__get__(a, type(a))``." msgstr "" -#: ../../reference/datamodel.rst:2148 +#: ../../reference/datamodel.rst:2141 msgid "Class Binding" msgstr "" -#: ../../reference/datamodel.rst:2149 +#: ../../reference/datamodel.rst:2142 msgid "" "If binding to a class, ``A.x`` is transformed into the call: ``A." "__dict__['x'].__get__(None, A)``." msgstr "" -#: ../../reference/datamodel.rst:2152 +#: ../../reference/datamodel.rst:2145 msgid "Super Binding" msgstr "" -#: ../../reference/datamodel.rst:2153 +#: ../../reference/datamodel.rst:2146 msgid "" "A dotted lookup such as ``super(A, a).x`` searches ``a.__class__.__mro__`` " "for a base class ``B`` following ``A`` and then returns ``B.__dict__['x']." "__get__(a, A)``. If not a descriptor, ``x`` is returned unchanged." msgstr "" -#: ../../reference/datamodel.rst:2190 +#: ../../reference/datamodel.rst:2183 msgid "" "For instance bindings, the precedence of descriptor invocation depends on " "which descriptor methods are defined. A descriptor can define any " @@ -2490,7 +2487,7 @@ msgid "" "instances." msgstr "" -#: ../../reference/datamodel.rst:2205 +#: ../../reference/datamodel.rst:2198 msgid "" "Python methods (including those decorated with :func:`@staticmethod " "` and :func:`@classmethod `) are implemented as " @@ -2499,30 +2496,30 @@ msgid "" "from other instances of the same class." msgstr "" -#: ../../reference/datamodel.rst:2211 +#: ../../reference/datamodel.rst:2204 msgid "" "The :func:`property` function is implemented as a data descriptor. " "Accordingly, instances cannot override the behavior of a property." msgstr "" -#: ../../reference/datamodel.rst:2218 +#: ../../reference/datamodel.rst:2211 msgid "__slots__" msgstr "__slots__" -#: ../../reference/datamodel.rst:2220 +#: ../../reference/datamodel.rst:2213 msgid "" "*__slots__* allow us to explicitly declare data members (like properties) " "and deny the creation of :attr:`~object.__dict__` and *__weakref__* (unless " "explicitly declared in *__slots__* or available in a parent.)" msgstr "" -#: ../../reference/datamodel.rst:2224 +#: ../../reference/datamodel.rst:2217 msgid "" "The space saved over using :attr:`~object.__dict__` can be significant. " "Attribute lookup speed can be significantly improved as well." msgstr "" -#: ../../reference/datamodel.rst:2229 +#: ../../reference/datamodel.rst:2222 msgid "" "This class variable can be assigned a string, iterable, or sequence of " "strings with variable names used by instances. *__slots__* reserves space " @@ -2530,18 +2527,18 @@ msgid "" "`~object.__dict__` and *__weakref__* for each instance." msgstr "" -#: ../../reference/datamodel.rst:2238 +#: ../../reference/datamodel.rst:2231 msgid "Notes on using *__slots__*:" msgstr "" -#: ../../reference/datamodel.rst:2240 +#: ../../reference/datamodel.rst:2233 msgid "" "When inheriting from a class without *__slots__*, the :attr:`~object." "__dict__` and *__weakref__* attribute of the instances will always be " "accessible." msgstr "" -#: ../../reference/datamodel.rst:2244 +#: ../../reference/datamodel.rst:2237 msgid "" "Without a :attr:`~object.__dict__` variable, instances cannot be assigned " "new variables not listed in the *__slots__* definition. Attempts to assign " @@ -2550,7 +2547,7 @@ msgid "" "sequence of strings in the *__slots__* declaration." msgstr "" -#: ../../reference/datamodel.rst:2251 +#: ../../reference/datamodel.rst:2244 msgid "" "Without a *__weakref__* variable for each instance, classes defining " "*__slots__* do not support :mod:`weak references ` to its " @@ -2558,7 +2555,7 @@ msgid "" "to the sequence of strings in the *__slots__* declaration." msgstr "" -#: ../../reference/datamodel.rst:2257 +#: ../../reference/datamodel.rst:2250 msgid "" "*__slots__* are implemented at the class level by creating :ref:`descriptors " "` for each variable name. As a result, class attributes cannot " @@ -2566,7 +2563,7 @@ msgid "" "otherwise, the class attribute would overwrite the descriptor assignment." msgstr "" -#: ../../reference/datamodel.rst:2263 +#: ../../reference/datamodel.rst:2256 msgid "" "The action of a *__slots__* declaration is not limited to the class where it " "is defined. *__slots__* declared in parents are available in child classes. " @@ -2575,7 +2572,7 @@ msgid "" "names of any *additional* slots)." msgstr "" -#: ../../reference/datamodel.rst:2269 +#: ../../reference/datamodel.rst:2262 msgid "" "If a class defines a slot also defined in a base class, the instance " "variable defined by the base class slot is inaccessible (except by " @@ -2584,7 +2581,7 @@ msgid "" "prevent this." msgstr "" -#: ../../reference/datamodel.rst:2274 +#: ../../reference/datamodel.rst:2267 msgid "" ":exc:`TypeError` will be raised if nonempty *__slots__* are defined for a " "class derived from a :c:member:`\"variable-length\" built-in type " @@ -2592,11 +2589,11 @@ msgid "" "`tuple`." msgstr "" -#: ../../reference/datamodel.rst:2279 +#: ../../reference/datamodel.rst:2272 msgid "Any non-string :term:`iterable` may be assigned to *__slots__*." msgstr "" -#: ../../reference/datamodel.rst:2281 +#: ../../reference/datamodel.rst:2274 msgid "" "If a :class:`dictionary ` is used to assign *__slots__*, the " "dictionary keys will be used as the slot names. The values of the dictionary " @@ -2604,13 +2601,13 @@ msgid "" "func:`inspect.getdoc` and displayed in the output of :func:`help`." msgstr "" -#: ../../reference/datamodel.rst:2286 +#: ../../reference/datamodel.rst:2279 msgid "" ":attr:`~instance.__class__` assignment works only if both classes have the " "same *__slots__*." msgstr "" -#: ../../reference/datamodel.rst:2289 +#: ../../reference/datamodel.rst:2282 msgid "" ":ref:`Multiple inheritance ` with multiple slotted parent " "classes can be used, but only one parent is allowed to have attributes " @@ -2618,18 +2615,18 @@ msgid "" "raise :exc:`TypeError`." msgstr "" -#: ../../reference/datamodel.rst:2295 +#: ../../reference/datamodel.rst:2288 msgid "" "If an :term:`iterator` is used for *__slots__* then a :term:`descriptor` is " "created for each of the iterator's values. However, the *__slots__* " "attribute will be an empty iterator." msgstr "" -#: ../../reference/datamodel.rst:2303 +#: ../../reference/datamodel.rst:2296 msgid "Customizing class creation" msgstr "" -#: ../../reference/datamodel.rst:2305 +#: ../../reference/datamodel.rst:2298 msgid "" "Whenever a class inherits from another class, :meth:`~object." "__init_subclass__` is called on the parent class. This way, it is possible " @@ -2639,14 +2636,14 @@ msgid "" "future subclasses of the class defining the method." msgstr "" -#: ../../reference/datamodel.rst:2314 +#: ../../reference/datamodel.rst:2307 msgid "" "This method is called whenever the containing class is subclassed. *cls* is " "then the new subclass. If defined as a normal instance method, this method " "is implicitly converted to a class method." msgstr "" -#: ../../reference/datamodel.rst:2318 +#: ../../reference/datamodel.rst:2311 msgid "" "Keyword arguments which are given to a new class are passed to the parent " "class's ``__init_subclass__``. For compatibility with other classes using " @@ -2654,13 +2651,13 @@ msgid "" "pass the others over to the base class, as in::" msgstr "" -#: ../../reference/datamodel.rst:2332 +#: ../../reference/datamodel.rst:2325 msgid "" "The default implementation ``object.__init_subclass__`` does nothing, but " "raises an error if it is called with any arguments." msgstr "" -#: ../../reference/datamodel.rst:2337 +#: ../../reference/datamodel.rst:2330 msgid "" "The metaclass hint ``metaclass`` is consumed by the rest of the type " "machinery, and is never passed to ``__init_subclass__`` implementations. The " @@ -2668,41 +2665,41 @@ msgid "" "``type(cls)``." msgstr "" -#: ../../reference/datamodel.rst:2345 +#: ../../reference/datamodel.rst:2338 msgid "" "When a class is created, :meth:`type.__new__` scans the class variables and " "makes callbacks to those with a :meth:`~object.__set_name__` hook." msgstr "" -#: ../../reference/datamodel.rst:2350 +#: ../../reference/datamodel.rst:2343 msgid "" "Automatically called at the time the owning class *owner* is created. The " "object has been assigned to *name* in that class::" msgstr "" -#: ../../reference/datamodel.rst:2356 +#: ../../reference/datamodel.rst:2349 msgid "" "If the class variable is assigned after the class is created, :meth:" "`__set_name__` will not be called automatically. If needed, :meth:" "`__set_name__` can be called directly::" msgstr "" -#: ../../reference/datamodel.rst:2367 +#: ../../reference/datamodel.rst:2360 msgid "See :ref:`class-object-creation` for more details." msgstr "更多細節請見 :ref:`class-object-creation`。" -#: ../../reference/datamodel.rst:2375 +#: ../../reference/datamodel.rst:2368 msgid "Metaclasses" msgstr "" -#: ../../reference/datamodel.rst:2382 +#: ../../reference/datamodel.rst:2375 msgid "" "By default, classes are constructed using :func:`type`. The class body is " "executed in a new namespace and the class name is bound locally to the " "result of ``type(name, bases, namespace)``." msgstr "" -#: ../../reference/datamodel.rst:2386 +#: ../../reference/datamodel.rst:2379 msgid "" "The class creation process can be customized by passing the ``metaclass`` " "keyword argument in the class definition line, or by inheriting from an " @@ -2710,41 +2707,41 @@ msgid "" "both ``MyClass`` and ``MySubclass`` are instances of ``Meta``::" msgstr "" -#: ../../reference/datamodel.rst:2400 +#: ../../reference/datamodel.rst:2393 msgid "" "Any other keyword arguments that are specified in the class definition are " "passed through to all metaclass operations described below." msgstr "" -#: ../../reference/datamodel.rst:2403 +#: ../../reference/datamodel.rst:2396 msgid "When a class definition is executed, the following steps occur:" msgstr "" -#: ../../reference/datamodel.rst:2405 +#: ../../reference/datamodel.rst:2398 msgid "MRO entries are resolved;" msgstr "" -#: ../../reference/datamodel.rst:2406 +#: ../../reference/datamodel.rst:2399 msgid "the appropriate metaclass is determined;" msgstr "" -#: ../../reference/datamodel.rst:2407 +#: ../../reference/datamodel.rst:2400 msgid "the class namespace is prepared;" msgstr "" -#: ../../reference/datamodel.rst:2408 +#: ../../reference/datamodel.rst:2401 msgid "the class body is executed;" msgstr "" -#: ../../reference/datamodel.rst:2409 +#: ../../reference/datamodel.rst:2402 msgid "the class object is created." msgstr "" -#: ../../reference/datamodel.rst:2413 +#: ../../reference/datamodel.rst:2406 msgid "Resolving MRO entries" msgstr "" -#: ../../reference/datamodel.rst:2417 +#: ../../reference/datamodel.rst:2410 msgid "" "If a base that appears in a class definition is not an instance of :class:" "`type`, then an :meth:`!__mro_entries__` method is searched on the base. If " @@ -2756,59 +2753,59 @@ msgid "" "is ignored." msgstr "" -#: ../../reference/datamodel.rst:2428 +#: ../../reference/datamodel.rst:2421 msgid ":func:`types.resolve_bases`" msgstr ":func:`types.resolve_bases`" -#: ../../reference/datamodel.rst:2429 +#: ../../reference/datamodel.rst:2422 msgid "Dynamically resolve bases that are not instances of :class:`type`." msgstr "" -#: ../../reference/datamodel.rst:2431 +#: ../../reference/datamodel.rst:2424 msgid ":func:`types.get_original_bases`" msgstr ":func:`types.get_original_bases`" -#: ../../reference/datamodel.rst:2432 +#: ../../reference/datamodel.rst:2425 msgid "" "Retrieve a class's \"original bases\" prior to modifications by :meth:" "`~object.__mro_entries__`." msgstr "" -#: ../../reference/datamodel.rst:2435 +#: ../../reference/datamodel.rst:2428 msgid ":pep:`560`" msgstr ":pep:`560`" -#: ../../reference/datamodel.rst:2436 +#: ../../reference/datamodel.rst:2429 msgid "Core support for typing module and generic types." msgstr "" -#: ../../reference/datamodel.rst:2440 +#: ../../reference/datamodel.rst:2433 msgid "Determining the appropriate metaclass" msgstr "" -#: ../../reference/datamodel.rst:2444 +#: ../../reference/datamodel.rst:2437 msgid "" "The appropriate metaclass for a class definition is determined as follows:" msgstr "" -#: ../../reference/datamodel.rst:2446 +#: ../../reference/datamodel.rst:2439 msgid "" "if no bases and no explicit metaclass are given, then :func:`type` is used;" msgstr "" -#: ../../reference/datamodel.rst:2447 +#: ../../reference/datamodel.rst:2440 msgid "" "if an explicit metaclass is given and it is *not* an instance of :func:" "`type`, then it is used directly as the metaclass;" msgstr "" -#: ../../reference/datamodel.rst:2449 +#: ../../reference/datamodel.rst:2442 msgid "" "if an instance of :func:`type` is given as the explicit metaclass, or bases " "are defined, then the most derived metaclass is used." msgstr "" -#: ../../reference/datamodel.rst:2452 +#: ../../reference/datamodel.rst:2445 msgid "" "The most derived metaclass is selected from the explicitly specified " "metaclass (if any) and the metaclasses (i.e. ``type(cls)``) of all specified " @@ -2817,11 +2814,11 @@ msgid "" "that criterion, then the class definition will fail with ``TypeError``." msgstr "" -#: ../../reference/datamodel.rst:2462 +#: ../../reference/datamodel.rst:2455 msgid "Preparing the class namespace" msgstr "" -#: ../../reference/datamodel.rst:2467 +#: ../../reference/datamodel.rst:2460 msgid "" "Once the appropriate metaclass has been identified, then the class namespace " "is prepared. If the metaclass has a ``__prepare__`` attribute, it is called " @@ -2833,25 +2830,25 @@ msgid "" "copied into a new ``dict``." msgstr "" -#: ../../reference/datamodel.rst:2476 +#: ../../reference/datamodel.rst:2469 msgid "" "If the metaclass has no ``__prepare__`` attribute, then the class namespace " "is initialised as an empty ordered mapping." msgstr "" -#: ../../reference/datamodel.rst:2481 +#: ../../reference/datamodel.rst:2474 msgid ":pep:`3115` - Metaclasses in Python 3000" msgstr "" -#: ../../reference/datamodel.rst:2482 +#: ../../reference/datamodel.rst:2475 msgid "Introduced the ``__prepare__`` namespace hook" msgstr "" -#: ../../reference/datamodel.rst:2486 +#: ../../reference/datamodel.rst:2479 msgid "Executing the class body" msgstr "" -#: ../../reference/datamodel.rst:2491 +#: ../../reference/datamodel.rst:2484 msgid "" "The class body is executed (approximately) as ``exec(body, globals(), " "namespace)``. The key difference from a normal call to :func:`exec` is that " @@ -2860,7 +2857,7 @@ msgid "" "inside a function." msgstr "" -#: ../../reference/datamodel.rst:2497 +#: ../../reference/datamodel.rst:2490 msgid "" "However, even when the class definition occurs inside the function, methods " "defined inside the class still cannot see names defined at the class scope. " @@ -2869,11 +2866,11 @@ msgid "" "reference described in the next section." msgstr "" -#: ../../reference/datamodel.rst:2506 +#: ../../reference/datamodel.rst:2499 msgid "Creating the class object" msgstr "" -#: ../../reference/datamodel.rst:2513 +#: ../../reference/datamodel.rst:2506 msgid "" "Once the class namespace has been populated by executing the class body, the " "class object is created by calling ``metaclass(name, bases, namespace, " @@ -2881,7 +2878,7 @@ msgid "" "to ``__prepare__``)." msgstr "" -#: ../../reference/datamodel.rst:2518 +#: ../../reference/datamodel.rst:2511 msgid "" "This class object is the one that will be referenced by the zero-argument " "form of :func:`super`. ``__class__`` is an implicit closure reference " @@ -2892,7 +2889,7 @@ msgid "" "is identified based on the first argument passed to the method." msgstr "" -#: ../../reference/datamodel.rst:2528 +#: ../../reference/datamodel.rst:2521 msgid "" "In CPython 3.6 and later, the ``__class__`` cell is passed to the metaclass " "as a ``__classcell__`` entry in the class namespace. If present, this must " @@ -2901,39 +2898,39 @@ msgid "" "in Python 3.8." msgstr "" -#: ../../reference/datamodel.rst:2534 +#: ../../reference/datamodel.rst:2527 msgid "" "When using the default metaclass :class:`type`, or any metaclass that " "ultimately calls ``type.__new__``, the following additional customization " "steps are invoked after creating the class object:" msgstr "" -#: ../../reference/datamodel.rst:2538 +#: ../../reference/datamodel.rst:2531 msgid "" "The ``type.__new__`` method collects all of the attributes in the class " "namespace that define a :meth:`~object.__set_name__` method;" msgstr "" -#: ../../reference/datamodel.rst:2540 +#: ../../reference/datamodel.rst:2533 msgid "" "Those ``__set_name__`` methods are called with the class being defined and " "the assigned name of that particular attribute;" msgstr "" -#: ../../reference/datamodel.rst:2542 +#: ../../reference/datamodel.rst:2535 msgid "" "The :meth:`~object.__init_subclass__` hook is called on the immediate parent " "of the new class in its method resolution order." msgstr "" -#: ../../reference/datamodel.rst:2545 +#: ../../reference/datamodel.rst:2538 msgid "" "After the class object is created, it is passed to the class decorators " "included in the class definition (if any) and the resulting object is bound " "in the local namespace as the defined class." msgstr "" -#: ../../reference/datamodel.rst:2549 +#: ../../reference/datamodel.rst:2542 msgid "" "When a new class is created by ``type.__new__``, the object provided as the " "namespace parameter is copied to a new ordered mapping and the original " @@ -2941,19 +2938,19 @@ msgid "" "becomes the :attr:`~object.__dict__` attribute of the class object." msgstr "" -#: ../../reference/datamodel.rst:2556 +#: ../../reference/datamodel.rst:2549 msgid ":pep:`3135` - New super" msgstr "" -#: ../../reference/datamodel.rst:2557 +#: ../../reference/datamodel.rst:2550 msgid "Describes the implicit ``__class__`` closure reference" msgstr "" -#: ../../reference/datamodel.rst:2561 +#: ../../reference/datamodel.rst:2554 msgid "Uses for metaclasses" msgstr "" -#: ../../reference/datamodel.rst:2563 +#: ../../reference/datamodel.rst:2556 msgid "" "The potential uses for metaclasses are boundless. Some ideas that have been " "explored include enum, logging, interface checking, automatic delegation, " @@ -2961,17 +2958,17 @@ msgid "" "locking/synchronization." msgstr "" -#: ../../reference/datamodel.rst:2570 +#: ../../reference/datamodel.rst:2563 msgid "Customizing instance and subclass checks" msgstr "" -#: ../../reference/datamodel.rst:2572 +#: ../../reference/datamodel.rst:2565 msgid "" "The following methods are used to override the default behavior of the :func:" "`isinstance` and :func:`issubclass` built-in functions." msgstr "" -#: ../../reference/datamodel.rst:2575 +#: ../../reference/datamodel.rst:2568 msgid "" "In particular, the metaclass :class:`abc.ABCMeta` implements these methods " "in order to allow the addition of Abstract Base Classes (ABCs) as \"virtual " @@ -2979,21 +2976,21 @@ msgid "" "other ABCs." msgstr "" -#: ../../reference/datamodel.rst:2582 +#: ../../reference/datamodel.rst:2575 msgid "" "Return true if *instance* should be considered a (direct or indirect) " "instance of *class*. If defined, called to implement ``isinstance(instance, " "class)``." msgstr "" -#: ../../reference/datamodel.rst:2589 +#: ../../reference/datamodel.rst:2582 msgid "" "Return true if *subclass* should be considered a (direct or indirect) " "subclass of *class*. If defined, called to implement ``issubclass(subclass, " "class)``." msgstr "" -#: ../../reference/datamodel.rst:2594 +#: ../../reference/datamodel.rst:2587 msgid "" "Note that these methods are looked up on the type (metaclass) of a class. " "They cannot be defined as class methods in the actual class. This is " @@ -3001,11 +2998,11 @@ msgid "" "only in this case the instance is itself a class." msgstr "" -#: ../../reference/datamodel.rst:2601 +#: ../../reference/datamodel.rst:2594 msgid ":pep:`3119` - Introducing Abstract Base Classes" msgstr "" -#: ../../reference/datamodel.rst:2602 +#: ../../reference/datamodel.rst:2595 msgid "" "Includes the specification for customizing :func:`isinstance` and :func:" "`issubclass` behavior through :meth:`~class.__instancecheck__` and :meth:" @@ -3014,11 +3011,11 @@ msgid "" "language." msgstr "" -#: ../../reference/datamodel.rst:2610 +#: ../../reference/datamodel.rst:2603 msgid "Emulating generic types" msgstr "" -#: ../../reference/datamodel.rst:2612 +#: ../../reference/datamodel.rst:2605 msgid "" "When using :term:`type annotations`, it is often useful to " "*parameterize* a :term:`generic type` using Python's square-brackets " @@ -3026,65 +3023,65 @@ msgid "" "a :class:`list` in which all the elements are of type :class:`int`." msgstr "" -#: ../../reference/datamodel.rst:2619 +#: ../../reference/datamodel.rst:2612 msgid ":pep:`484` - Type Hints" msgstr "" -#: ../../reference/datamodel.rst:2620 +#: ../../reference/datamodel.rst:2613 msgid "Introducing Python's framework for type annotations" msgstr "" -#: ../../reference/datamodel.rst:2622 +#: ../../reference/datamodel.rst:2615 msgid ":ref:`Generic Alias Types`" msgstr ":ref:`泛型別名型別 `" -#: ../../reference/datamodel.rst:2623 +#: ../../reference/datamodel.rst:2616 msgid "Documentation for objects representing parameterized generic classes" msgstr "" -#: ../../reference/datamodel.rst:2625 +#: ../../reference/datamodel.rst:2618 msgid "" ":ref:`Generics`, :ref:`user-defined generics` and :" "class:`typing.Generic`" msgstr "" -#: ../../reference/datamodel.rst:2626 +#: ../../reference/datamodel.rst:2619 msgid "" "Documentation on how to implement generic classes that can be parameterized " "at runtime and understood by static type-checkers." msgstr "" -#: ../../reference/datamodel.rst:2629 +#: ../../reference/datamodel.rst:2622 msgid "" "A class can *generally* only be parameterized if it defines the special " "class method ``__class_getitem__()``." msgstr "" -#: ../../reference/datamodel.rst:2634 +#: ../../reference/datamodel.rst:2627 msgid "" "Return an object representing the specialization of a generic class by type " "arguments found in *key*." msgstr "" -#: ../../reference/datamodel.rst:2637 +#: ../../reference/datamodel.rst:2630 msgid "" "When defined on a class, ``__class_getitem__()`` is automatically a class " "method. As such, there is no need for it to be decorated with :func:" "`@classmethod` when it is defined." msgstr "" -#: ../../reference/datamodel.rst:2643 +#: ../../reference/datamodel.rst:2636 msgid "The purpose of *__class_getitem__*" msgstr "" -#: ../../reference/datamodel.rst:2645 +#: ../../reference/datamodel.rst:2638 msgid "" "The purpose of :meth:`~object.__class_getitem__` is to allow runtime " "parameterization of standard-library generic classes in order to more easily " "apply :term:`type hints` to these classes." msgstr "" -#: ../../reference/datamodel.rst:2649 +#: ../../reference/datamodel.rst:2642 msgid "" "To implement custom generic classes that can be parameterized at runtime and " "understood by static type-checkers, users should either inherit from a " @@ -3093,7 +3090,7 @@ msgid "" "own implementation of ``__class_getitem__()``." msgstr "" -#: ../../reference/datamodel.rst:2655 +#: ../../reference/datamodel.rst:2648 msgid "" "Custom implementations of :meth:`~object.__class_getitem__` on classes " "defined outside of the standard library may not be understood by third-party " @@ -3101,11 +3098,11 @@ msgid "" "purposes other than type hinting is discouraged." msgstr "" -#: ../../reference/datamodel.rst:2665 +#: ../../reference/datamodel.rst:2658 msgid "*__class_getitem__* versus *__getitem__*" msgstr "" -#: ../../reference/datamodel.rst:2667 +#: ../../reference/datamodel.rst:2660 msgid "" "Usually, the :ref:`subscription` of an object using square " "brackets will call the :meth:`~object.__getitem__` instance method defined " @@ -3115,14 +3112,14 @@ msgid "" "genericalias>` object if it is properly defined." msgstr "" -#: ../../reference/datamodel.rst:2674 +#: ../../reference/datamodel.rst:2667 msgid "" "Presented with the :term:`expression` ``obj[x]``, the Python interpreter " "follows something like the following process to decide whether :meth:" "`~object.__getitem__` or :meth:`~object.__class_getitem__` should be called::" msgstr "" -#: ../../reference/datamodel.rst:2702 +#: ../../reference/datamodel.rst:2695 msgid "" "In Python, all classes are themselves instances of other classes. The class " "of a class is known as that class's :term:`metaclass`, and most classes have " @@ -3132,40 +3129,40 @@ msgid "" "__class_getitem__` being called::" msgstr "" -#: ../../reference/datamodel.rst:2721 +#: ../../reference/datamodel.rst:2714 msgid "" "However, if a class has a custom metaclass that defines :meth:`~object." "__getitem__`, subscribing the class may result in different behaviour. An " "example of this can be found in the :mod:`enum` module::" msgstr "" -#: ../../reference/datamodel.rst:2744 +#: ../../reference/datamodel.rst:2737 msgid ":pep:`560` - Core Support for typing module and generic types" msgstr "" -#: ../../reference/datamodel.rst:2745 +#: ../../reference/datamodel.rst:2738 msgid "" "Introducing :meth:`~object.__class_getitem__`, and outlining when a :ref:" "`subscription` results in ``__class_getitem__()`` being " "called instead of :meth:`~object.__getitem__`" msgstr "" -#: ../../reference/datamodel.rst:2753 +#: ../../reference/datamodel.rst:2746 msgid "Emulating callable objects" msgstr "" -#: ../../reference/datamodel.rst:2760 +#: ../../reference/datamodel.rst:2753 msgid "" "Called when the instance is \"called\" as a function; if this method is " "defined, ``x(arg1, arg2, ...)`` roughly translates to ``type(x).__call__(x, " "arg1, ...)``." msgstr "" -#: ../../reference/datamodel.rst:2767 +#: ../../reference/datamodel.rst:2760 msgid "Emulating container types" msgstr "" -#: ../../reference/datamodel.rst:2769 +#: ../../reference/datamodel.rst:2762 msgid "" "The following methods can be defined to implement container objects. " "Containers usually are :term:`sequences ` (such as :class:`lists " @@ -3201,7 +3198,7 @@ msgid "" "should iterate through the values." msgstr "" -#: ../../reference/datamodel.rst:2810 +#: ../../reference/datamodel.rst:2803 msgid "" "Called to implement the built-in function :func:`len`. Should return the " "length of the object, an integer ``>=`` 0. Also, an object that doesn't " @@ -3209,7 +3206,7 @@ msgid "" "returns zero is considered to be false in a Boolean context." msgstr "" -#: ../../reference/datamodel.rst:2817 +#: ../../reference/datamodel.rst:2810 msgid "" "In CPython, the length is required to be at most :data:`sys.maxsize`. If the " "length is larger than :data:`!sys.maxsize` some features (such as :func:" @@ -3218,7 +3215,7 @@ msgid "" "`~object.__bool__` method." msgstr "" -#: ../../reference/datamodel.rst:2826 +#: ../../reference/datamodel.rst:2819 msgid "" "Called to implement :func:`operator.length_hint`. Should return an estimated " "length for the object (which may be greater or less than the actual length). " @@ -3228,20 +3225,20 @@ msgid "" "never required for correctness." msgstr "" -#: ../../reference/datamodel.rst:2840 +#: ../../reference/datamodel.rst:2833 msgid "" "Slicing is done exclusively with the following three methods. A call like ::" msgstr "" -#: ../../reference/datamodel.rst:2844 +#: ../../reference/datamodel.rst:2837 msgid "is translated to ::" msgstr "" -#: ../../reference/datamodel.rst:2848 +#: ../../reference/datamodel.rst:2841 msgid "and so forth. Missing slice items are always filled in with ``None``." msgstr "" -#: ../../reference/datamodel.rst:2853 +#: ../../reference/datamodel.rst:2846 msgid "" "Called to implement evaluation of ``self[key]``. For :term:`sequence` types, " "the accepted keys should be integers. Optionally, they may support :class:" @@ -3253,20 +3250,20 @@ msgid "" "`KeyError` should be raised." msgstr "" -#: ../../reference/datamodel.rst:2865 +#: ../../reference/datamodel.rst:2858 msgid "" ":keyword:`for` loops expect that an :exc:`IndexError` will be raised for " "illegal indexes to allow proper detection of the end of the sequence." msgstr "" -#: ../../reference/datamodel.rst:2870 +#: ../../reference/datamodel.rst:2863 msgid "" "When :ref:`subscripting` a *class*, the special class method :" "meth:`~object.__class_getitem__` may be called instead of ``__getitem__()``. " "See :ref:`classgetitem-versus-getitem` for more details." msgstr "" -#: ../../reference/datamodel.rst:2878 +#: ../../reference/datamodel.rst:2871 msgid "" "Called to implement assignment to ``self[key]``. Same note as for :meth:" "`__getitem__`. This should only be implemented for mappings if the objects " @@ -3275,7 +3272,7 @@ msgid "" "for improper *key* values as for the :meth:`__getitem__` method." msgstr "" -#: ../../reference/datamodel.rst:2887 +#: ../../reference/datamodel.rst:2880 msgid "" "Called to implement deletion of ``self[key]``. Same note as for :meth:" "`__getitem__`. This should only be implemented for mappings if the objects " @@ -3284,13 +3281,13 @@ msgid "" "values as for the :meth:`__getitem__` method." msgstr "" -#: ../../reference/datamodel.rst:2896 +#: ../../reference/datamodel.rst:2889 msgid "" "Called by :class:`dict`\\ .\\ :meth:`__getitem__` to implement ``self[key]`` " "for dict subclasses when key is not in the dictionary." msgstr "" -#: ../../reference/datamodel.rst:2902 +#: ../../reference/datamodel.rst:2895 msgid "" "This method is called when an :term:`iterator` is required for a container. " "This method should return a new iterator object that can iterate over all " @@ -3298,14 +3295,14 @@ msgid "" "of the container." msgstr "" -#: ../../reference/datamodel.rst:2910 +#: ../../reference/datamodel.rst:2903 msgid "" "Called (if present) by the :func:`reversed` built-in to implement reverse " "iteration. It should return a new iterator object that iterates over all " "the objects in the container in reverse order." msgstr "" -#: ../../reference/datamodel.rst:2914 +#: ../../reference/datamodel.rst:2907 msgid "" "If the :meth:`__reversed__` method is not provided, the :func:`reversed` " "built-in will fall back to using the sequence protocol (:meth:`__len__` and :" @@ -3314,7 +3311,7 @@ msgid "" "more efficient than the one provided by :func:`reversed`." msgstr "" -#: ../../reference/datamodel.rst:2921 +#: ../../reference/datamodel.rst:2914 msgid "" "The membership test operators (:keyword:`in` and :keyword:`not in`) are " "normally implemented as an iteration through a container. However, container " @@ -3322,14 +3319,14 @@ msgid "" "implementation, which also does not require the object be iterable." msgstr "" -#: ../../reference/datamodel.rst:2928 +#: ../../reference/datamodel.rst:2921 msgid "" "Called to implement membership test operators. Should return true if *item* " "is in *self*, false otherwise. For mapping objects, this should consider " "the keys of the mapping rather than the values or the key-item pairs." msgstr "" -#: ../../reference/datamodel.rst:2932 +#: ../../reference/datamodel.rst:2925 msgid "" "For objects that don't define :meth:`__contains__`, the membership test " "first tries iteration via :meth:`__iter__`, then the old sequence iteration " @@ -3337,11 +3334,11 @@ msgid "" "reference `." msgstr "" -#: ../../reference/datamodel.rst:2941 +#: ../../reference/datamodel.rst:2934 msgid "Emulating numeric types" msgstr "" -#: ../../reference/datamodel.rst:2943 +#: ../../reference/datamodel.rst:2936 msgid "" "The following methods can be defined to emulate numeric objects. Methods " "corresponding to operations that are not supported by the particular kind of " @@ -3349,7 +3346,7 @@ msgid "" "should be left undefined." msgstr "" -#: ../../reference/datamodel.rst:2969 +#: ../../reference/datamodel.rst:2962 msgid "" "These methods are called to implement the binary arithmetic operations " "(``+``, ``-``, ``*``, ``@``, ``/``, ``//``, ``%``, :func:`divmod`, :func:" @@ -3363,13 +3360,13 @@ msgid "" "function is to be supported." msgstr "" -#: ../../reference/datamodel.rst:2980 +#: ../../reference/datamodel.rst:2973 msgid "" "If one of those methods does not support the operation with the supplied " "arguments, it should return :data:`NotImplemented`." msgstr "" -#: ../../reference/datamodel.rst:3003 +#: ../../reference/datamodel.rst:2996 msgid "" "These methods are called to implement the binary arithmetic operations " "(``+``, ``-``, ``*``, ``@``, ``/``, ``//``, ``%``, :func:`divmod`, :func:" @@ -3382,13 +3379,13 @@ msgid "" "`NotImplemented`." msgstr "" -#: ../../reference/datamodel.rst:3015 +#: ../../reference/datamodel.rst:3008 msgid "" "Note that ternary :func:`pow` will not try calling :meth:`__rpow__` (the " "coercion rules would become too complicated)." msgstr "" -#: ../../reference/datamodel.rst:3020 +#: ../../reference/datamodel.rst:3013 msgid "" "If the right operand's type is a subclass of the left operand's type and " "that subclass provides a different implementation of the reflected method " @@ -3397,7 +3394,7 @@ msgid "" "ancestors' operations." msgstr "" -#: ../../reference/datamodel.rst:3041 +#: ../../reference/datamodel.rst:3034 msgid "" "These methods are called to implement the augmented arithmetic assignments " "(``+=``, ``-=``, ``*=``, ``@=``, ``/=``, ``//=``, ``%=``, ``**=``, ``<<=``, " @@ -3415,19 +3412,19 @@ msgid "" "data model." msgstr "" -#: ../../reference/datamodel.rst:3064 +#: ../../reference/datamodel.rst:3057 msgid "" "Called to implement the unary arithmetic operations (``-``, ``+``, :func:" "`abs` and ``~``)." msgstr "" -#: ../../reference/datamodel.rst:3077 +#: ../../reference/datamodel.rst:3070 msgid "" "Called to implement the built-in functions :func:`complex`, :func:`int` and :" "func:`float`. Should return a value of the appropriate type." msgstr "" -#: ../../reference/datamodel.rst:3084 +#: ../../reference/datamodel.rst:3077 msgid "" "Called to implement :func:`operator.index`, and whenever Python needs to " "losslessly convert the numeric object to an integer object (such as in " @@ -3436,14 +3433,14 @@ msgid "" "integer type. Must return an integer." msgstr "" -#: ../../reference/datamodel.rst:3090 +#: ../../reference/datamodel.rst:3083 msgid "" "If :meth:`__int__`, :meth:`__float__` and :meth:`__complex__` are not " "defined then corresponding built-in functions :func:`int`, :func:`float` " "and :func:`complex` fall back to :meth:`__index__`." msgstr "" -#: ../../reference/datamodel.rst:3102 +#: ../../reference/datamodel.rst:3095 msgid "" "Called to implement the built-in function :func:`round` and :mod:`math` " "functions :func:`~math.trunc`, :func:`~math.floor` and :func:`~math.ceil`. " @@ -3452,21 +3449,21 @@ msgid "" "(typically an :class:`int`)." msgstr "" -#: ../../reference/datamodel.rst:3108 +#: ../../reference/datamodel.rst:3101 msgid "" "The built-in function :func:`int` falls back to :meth:`__trunc__` if " "neither :meth:`__int__` nor :meth:`__index__` is defined." msgstr "" -#: ../../reference/datamodel.rst:3111 +#: ../../reference/datamodel.rst:3104 msgid "The delegation of :func:`int` to :meth:`__trunc__` is deprecated." msgstr "" -#: ../../reference/datamodel.rst:3118 +#: ../../reference/datamodel.rst:3111 msgid "With Statement Context Managers" msgstr "" -#: ../../reference/datamodel.rst:3120 +#: ../../reference/datamodel.rst:3113 msgid "" "A :dfn:`context manager` is an object that defines the runtime context to be " "established when executing a :keyword:`with` statement. The context manager " @@ -3476,32 +3473,32 @@ msgid "" "can also be used by directly invoking their methods." msgstr "" -#: ../../reference/datamodel.rst:3131 +#: ../../reference/datamodel.rst:3124 msgid "" "Typical uses of context managers include saving and restoring various kinds " "of global state, locking and unlocking resources, closing opened files, etc." msgstr "" -#: ../../reference/datamodel.rst:3134 +#: ../../reference/datamodel.rst:3127 msgid "" "For more information on context managers, see :ref:`typecontextmanager`." msgstr "" -#: ../../reference/datamodel.rst:3139 +#: ../../reference/datamodel.rst:3132 msgid "" "Enter the runtime context related to this object. The :keyword:`with` " "statement will bind this method's return value to the target(s) specified in " "the :keyword:`!as` clause of the statement, if any." msgstr "" -#: ../../reference/datamodel.rst:3146 +#: ../../reference/datamodel.rst:3139 msgid "" "Exit the runtime context related to this object. The parameters describe the " "exception that caused the context to be exited. If the context was exited " "without an exception, all three arguments will be :const:`None`." msgstr "" -#: ../../reference/datamodel.rst:3150 +#: ../../reference/datamodel.rst:3143 msgid "" "If an exception is supplied, and the method wishes to suppress the exception " "(i.e., prevent it from being propagated), it should return a true value. " @@ -3509,27 +3506,27 @@ msgid "" "method." msgstr "" -#: ../../reference/datamodel.rst:3154 +#: ../../reference/datamodel.rst:3147 msgid "" "Note that :meth:`~object.__exit__` methods should not reraise the passed-in " "exception; this is the caller's responsibility." msgstr "" -#: ../../reference/datamodel.rst:3160 +#: ../../reference/datamodel.rst:3153 msgid ":pep:`343` - The \"with\" statement" msgstr "" -#: ../../reference/datamodel.rst:3161 +#: ../../reference/datamodel.rst:3154 msgid "" "The specification, background, and examples for the Python :keyword:`with` " "statement." msgstr "" -#: ../../reference/datamodel.rst:3168 +#: ../../reference/datamodel.rst:3161 msgid "Customizing positional arguments in class pattern matching" msgstr "" -#: ../../reference/datamodel.rst:3170 +#: ../../reference/datamodel.rst:3163 msgid "" "When using a class name in a pattern, positional arguments in the pattern " "are not allowed by default, i.e. ``case MyClass(x, y)`` is typically invalid " @@ -3537,7 +3534,7 @@ msgid "" "pattern, the class needs to define a *__match_args__* attribute." msgstr "" -#: ../../reference/datamodel.rst:3177 +#: ../../reference/datamodel.rst:3170 msgid "" "This class variable can be assigned a tuple of strings. When this class is " "used in a class pattern with positional arguments, each positional argument " @@ -3546,7 +3543,7 @@ msgid "" "to setting it to ``()``." msgstr "" -#: ../../reference/datamodel.rst:3183 +#: ../../reference/datamodel.rst:3176 msgid "" "For example, if ``MyClass.__match_args__`` is ``(\"left\", \"center\", " "\"right\")`` that means that ``case MyClass(x, y)`` is equivalent to ``case " @@ -3556,19 +3553,19 @@ msgid "" "exc:`TypeError`." msgstr "" -#: ../../reference/datamodel.rst:3193 +#: ../../reference/datamodel.rst:3186 msgid ":pep:`634` - Structural Pattern Matching" msgstr "" -#: ../../reference/datamodel.rst:3194 +#: ../../reference/datamodel.rst:3187 msgid "The specification for the Python ``match`` statement." msgstr "" -#: ../../reference/datamodel.rst:3200 +#: ../../reference/datamodel.rst:3193 msgid "Emulating buffer types" msgstr "" -#: ../../reference/datamodel.rst:3202 +#: ../../reference/datamodel.rst:3195 msgid "" "The :ref:`buffer protocol ` provides a way for Python objects " "to expose efficient access to a low-level memory array. This protocol is " @@ -3576,13 +3573,13 @@ msgid "" "and third-party libraries may define additional buffer types." msgstr "" -#: ../../reference/datamodel.rst:3207 +#: ../../reference/datamodel.rst:3200 msgid "" "While buffer types are usually implemented in C, it is also possible to " "implement the protocol in Python." msgstr "" -#: ../../reference/datamodel.rst:3212 +#: ../../reference/datamodel.rst:3205 msgid "" "Called when a buffer is requested from *self* (for example, by the :class:" "`memoryview` constructor). The *flags* argument is an integer representing " @@ -3592,7 +3589,7 @@ msgid "" "`memoryview` object." msgstr "" -#: ../../reference/datamodel.rst:3221 +#: ../../reference/datamodel.rst:3214 msgid "" "Called when a buffer is no longer needed. The *buffer* argument is a :class:" "`memoryview` object that was previously returned by :meth:`~object." @@ -3601,28 +3598,28 @@ msgid "" "to perform any cleanup are not required to implement this method." msgstr "" -#: ../../reference/datamodel.rst:3232 +#: ../../reference/datamodel.rst:3225 msgid ":pep:`688` - Making the buffer protocol accessible in Python" msgstr "" -#: ../../reference/datamodel.rst:3233 +#: ../../reference/datamodel.rst:3226 msgid "" "Introduces the Python ``__buffer__`` and ``__release_buffer__`` methods." msgstr "" -#: ../../reference/datamodel.rst:3235 +#: ../../reference/datamodel.rst:3228 msgid ":class:`collections.abc.Buffer`" msgstr ":class:`collections.abc.Buffer`" -#: ../../reference/datamodel.rst:3236 +#: ../../reference/datamodel.rst:3229 msgid "ABC for buffer types." msgstr "" -#: ../../reference/datamodel.rst:3241 +#: ../../reference/datamodel.rst:3234 msgid "Special method lookup" msgstr "" -#: ../../reference/datamodel.rst:3243 +#: ../../reference/datamodel.rst:3236 msgid "" "For custom classes, implicit invocations of special methods are only " "guaranteed to work correctly if defined on an object's type, not in the " @@ -3630,7 +3627,7 @@ msgid "" "following code raises an exception::" msgstr "" -#: ../../reference/datamodel.rst:3258 +#: ../../reference/datamodel.rst:3251 msgid "" "The rationale behind this behaviour lies with a number of special methods " "such as :meth:`~object.__hash__` and :meth:`~object.__repr__` that are " @@ -3639,21 +3636,21 @@ msgid "" "invoked on the type object itself::" msgstr "" -#: ../../reference/datamodel.rst:3272 +#: ../../reference/datamodel.rst:3265 msgid "" "Incorrectly attempting to invoke an unbound method of a class in this way is " "sometimes referred to as 'metaclass confusion', and is avoided by bypassing " "the instance when looking up special methods::" msgstr "" -#: ../../reference/datamodel.rst:3281 +#: ../../reference/datamodel.rst:3274 msgid "" "In addition to bypassing any instance attributes in the interest of " "correctness, implicit special method lookup generally also bypasses the :" "meth:`~object.__getattribute__` method even of the object's metaclass::" msgstr "" -#: ../../reference/datamodel.rst:3307 +#: ../../reference/datamodel.rst:3300 msgid "" "Bypassing the :meth:`~object.__getattribute__` machinery in this fashion " "provides significant scope for speed optimisations within the interpreter, " @@ -3662,36 +3659,36 @@ msgid "" "consistently invoked by the interpreter)." msgstr "" -#: ../../reference/datamodel.rst:3318 +#: ../../reference/datamodel.rst:3311 msgid "Coroutines" msgstr "協程" -#: ../../reference/datamodel.rst:3322 +#: ../../reference/datamodel.rst:3315 msgid "Awaitable Objects" msgstr "" -#: ../../reference/datamodel.rst:3324 +#: ../../reference/datamodel.rst:3317 msgid "" "An :term:`awaitable` object generally implements an :meth:`~object." "__await__` method. :term:`Coroutine objects ` returned from :" "keyword:`async def` functions are awaitable." msgstr "" -#: ../../reference/datamodel.rst:3330 +#: ../../reference/datamodel.rst:3323 msgid "" "The :term:`generator iterator` objects returned from generators decorated " "with :func:`types.coroutine` are also awaitable, but they do not implement :" "meth:`~object.__await__`." msgstr "" -#: ../../reference/datamodel.rst:3336 +#: ../../reference/datamodel.rst:3329 msgid "" "Must return an :term:`iterator`. Should be used to implement :term:" "`awaitable` objects. For instance, :class:`asyncio.Future` implements this " "method to be compatible with the :keyword:`await` expression." msgstr "" -#: ../../reference/datamodel.rst:3342 +#: ../../reference/datamodel.rst:3335 msgid "" "The language doesn't place any restriction on the type or value of the " "objects yielded by the iterator returned by ``__await__``, as this is " @@ -3699,15 +3696,15 @@ msgid "" "g. :mod:`asyncio`) that will be managing the :term:`awaitable` object." msgstr "" -#: ../../reference/datamodel.rst:3350 +#: ../../reference/datamodel.rst:3343 msgid ":pep:`492` for additional information about awaitable objects." msgstr "" -#: ../../reference/datamodel.rst:3356 +#: ../../reference/datamodel.rst:3349 msgid "Coroutine Objects" msgstr "" -#: ../../reference/datamodel.rst:3358 +#: ../../reference/datamodel.rst:3351 msgid "" ":term:`Coroutine objects ` are :term:`awaitable` objects. A " "coroutine's execution can be controlled by calling :meth:`~object.__await__` " @@ -3718,18 +3715,18 @@ msgid "" "should not directly raise unhandled :exc:`StopIteration` exceptions." msgstr "" -#: ../../reference/datamodel.rst:3366 +#: ../../reference/datamodel.rst:3359 msgid "" "Coroutines also have the methods listed below, which are analogous to those " "of generators (see :ref:`generator-methods`). However, unlike generators, " "coroutines do not directly support iteration." msgstr "" -#: ../../reference/datamodel.rst:3370 +#: ../../reference/datamodel.rst:3363 msgid "It is a :exc:`RuntimeError` to await on a coroutine more than once." msgstr "" -#: ../../reference/datamodel.rst:3376 +#: ../../reference/datamodel.rst:3369 msgid "" "Starts or resumes execution of the coroutine. If *value* is ``None``, this " "is equivalent to advancing the iterator returned by :meth:`~object." @@ -3740,7 +3737,7 @@ msgid "" "value, described above." msgstr "" -#: ../../reference/datamodel.rst:3387 +#: ../../reference/datamodel.rst:3380 msgid "" "Raises the specified exception in the coroutine. This method delegates to " "the :meth:`~generator.throw` method of the iterator that caused the " @@ -3751,13 +3748,13 @@ msgid "" "not caught in the coroutine, it propagates back to the caller." msgstr "" -#: ../../reference/datamodel.rst:3398 +#: ../../reference/datamodel.rst:3391 msgid "" "The second signature \\(type\\[, value\\[, traceback\\]\\]\\) is deprecated " "and may be removed in a future version of Python." msgstr "" -#: ../../reference/datamodel.rst:3403 +#: ../../reference/datamodel.rst:3396 msgid "" "Causes the coroutine to clean itself up and exit. If the coroutine is " "suspended, this method first delegates to the :meth:`~generator.close` " @@ -3767,99 +3764,99 @@ msgid "" "is marked as having finished executing, even if it was never started." msgstr "" -#: ../../reference/datamodel.rst:3411 +#: ../../reference/datamodel.rst:3404 msgid "" "Coroutine objects are automatically closed using the above process when they " "are about to be destroyed." msgstr "" -#: ../../reference/datamodel.rst:3417 +#: ../../reference/datamodel.rst:3410 msgid "Asynchronous Iterators" msgstr "" -#: ../../reference/datamodel.rst:3419 +#: ../../reference/datamodel.rst:3412 msgid "" "An *asynchronous iterator* can call asynchronous code in its ``__anext__`` " "method." msgstr "" -#: ../../reference/datamodel.rst:3422 +#: ../../reference/datamodel.rst:3415 msgid "" "Asynchronous iterators can be used in an :keyword:`async for` statement." msgstr "" -#: ../../reference/datamodel.rst:3426 +#: ../../reference/datamodel.rst:3419 msgid "Must return an *asynchronous iterator* object." msgstr "" -#: ../../reference/datamodel.rst:3430 +#: ../../reference/datamodel.rst:3423 msgid "" "Must return an *awaitable* resulting in a next value of the iterator. " "Should raise a :exc:`StopAsyncIteration` error when the iteration is over." msgstr "" -#: ../../reference/datamodel.rst:3433 +#: ../../reference/datamodel.rst:3426 msgid "An example of an asynchronous iterable object::" msgstr "" -#: ../../reference/datamodel.rst:3450 +#: ../../reference/datamodel.rst:3443 msgid "" "Prior to Python 3.7, :meth:`~object.__aiter__` could return an *awaitable* " "that would resolve to an :term:`asynchronous iterator `." msgstr "" -#: ../../reference/datamodel.rst:3455 +#: ../../reference/datamodel.rst:3448 msgid "" "Starting with Python 3.7, :meth:`~object.__aiter__` must return an " "asynchronous iterator object. Returning anything else will result in a :exc:" "`TypeError` error." msgstr "" -#: ../../reference/datamodel.rst:3463 +#: ../../reference/datamodel.rst:3456 msgid "Asynchronous Context Managers" msgstr "" -#: ../../reference/datamodel.rst:3465 +#: ../../reference/datamodel.rst:3458 msgid "" "An *asynchronous context manager* is a *context manager* that is able to " "suspend execution in its ``__aenter__`` and ``__aexit__`` methods." msgstr "" -#: ../../reference/datamodel.rst:3468 +#: ../../reference/datamodel.rst:3461 msgid "" "Asynchronous context managers can be used in an :keyword:`async with` " "statement." msgstr "" -#: ../../reference/datamodel.rst:3472 +#: ../../reference/datamodel.rst:3465 msgid "" "Semantically similar to :meth:`~object.__enter__`, the only difference being " "that it must return an *awaitable*." msgstr "" -#: ../../reference/datamodel.rst:3477 +#: ../../reference/datamodel.rst:3470 msgid "" "Semantically similar to :meth:`~object.__exit__`, the only difference being " "that it must return an *awaitable*." msgstr "" -#: ../../reference/datamodel.rst:3480 +#: ../../reference/datamodel.rst:3473 msgid "An example of an asynchronous context manager class::" msgstr "" -#: ../../reference/datamodel.rst:3493 +#: ../../reference/datamodel.rst:3486 msgid "Footnotes" msgstr "註解" -#: ../../reference/datamodel.rst:3494 +#: ../../reference/datamodel.rst:3487 msgid "" "It *is* possible in some cases to change an object's type, under certain " "controlled conditions. It generally isn't a good idea though, since it can " "lead to some very strange behaviour if it is handled incorrectly." msgstr "" -#: ../../reference/datamodel.rst:3498 +#: ../../reference/datamodel.rst:3491 msgid "" "The :meth:`~object.__hash__`, :meth:`~object.__iter__`, :meth:`~object." "__reversed__`, and :meth:`~object.__contains__` methods have special " @@ -3867,7 +3864,7 @@ msgid "" "by relying on the behavior that ``None`` is not callable." msgstr "" -#: ../../reference/datamodel.rst:3504 +#: ../../reference/datamodel.rst:3497 msgid "" "\"Does not support\" here means that the class has no such method, or the " "method returns :data:`NotImplemented`. Do not set the method to ``None`` if " @@ -3875,7 +3872,7 @@ msgid "" "instead have the opposite effect of explicitly *blocking* such fallback." msgstr "" -#: ../../reference/datamodel.rst:3510 +#: ../../reference/datamodel.rst:3503 msgid "" "For operands of the same type, it is assumed that if the non-reflected " "method -- such as :meth:`~object.__add__` -- fails then the overall " @@ -3893,12 +3890,12 @@ msgstr "" #: ../../reference/datamodel.rst:451 ../../reference/datamodel.rst:462 #: ../../reference/datamodel.rst:479 ../../reference/datamodel.rst:515 #: ../../reference/datamodel.rst:530 ../../reference/datamodel.rst:657 -#: ../../reference/datamodel.rst:802 ../../reference/datamodel.rst:826 -#: ../../reference/datamodel.rst:859 ../../reference/datamodel.rst:938 -#: ../../reference/datamodel.rst:1007 ../../reference/datamodel.rst:1034 -#: ../../reference/datamodel.rst:1096 ../../reference/datamodel.rst:1200 -#: ../../reference/datamodel.rst:1307 ../../reference/datamodel.rst:1407 -#: ../../reference/datamodel.rst:1821 ../../reference/datamodel.rst:2836 +#: ../../reference/datamodel.rst:795 ../../reference/datamodel.rst:819 +#: ../../reference/datamodel.rst:852 ../../reference/datamodel.rst:931 +#: ../../reference/datamodel.rst:1000 ../../reference/datamodel.rst:1027 +#: ../../reference/datamodel.rst:1089 ../../reference/datamodel.rst:1193 +#: ../../reference/datamodel.rst:1300 ../../reference/datamodel.rst:1400 +#: ../../reference/datamodel.rst:1814 ../../reference/datamodel.rst:2829 msgid "object" msgstr "object（物件）" @@ -3908,14 +3905,14 @@ msgstr "data（資料）" #: ../../reference/datamodel.rst:23 ../../reference/datamodel.rst:292 #: ../../reference/datamodel.rst:339 ../../reference/datamodel.rst:423 -#: ../../reference/datamodel.rst:462 ../../reference/datamodel.rst:802 -#: ../../reference/datamodel.rst:1053 ../../reference/datamodel.rst:1490 -#: ../../reference/datamodel.rst:1732 ../../reference/datamodel.rst:1737 -#: ../../reference/datamodel.rst:1821 ../../reference/datamodel.rst:2377 -#: ../../reference/datamodel.rst:2806 ../../reference/datamodel.rst:2964 -#: ../../reference/datamodel.rst:2999 ../../reference/datamodel.rst:3013 -#: ../../reference/datamodel.rst:3062 ../../reference/datamodel.rst:3072 -#: ../../reference/datamodel.rst:3100 +#: ../../reference/datamodel.rst:462 ../../reference/datamodel.rst:795 +#: ../../reference/datamodel.rst:1046 ../../reference/datamodel.rst:1483 +#: ../../reference/datamodel.rst:1725 ../../reference/datamodel.rst:1730 +#: ../../reference/datamodel.rst:1814 ../../reference/datamodel.rst:2370 +#: ../../reference/datamodel.rst:2799 ../../reference/datamodel.rst:2957 +#: ../../reference/datamodel.rst:2992 ../../reference/datamodel.rst:3006 +#: ../../reference/datamodel.rst:3055 ../../reference/datamodel.rst:3065 +#: ../../reference/datamodel.rst:3093 msgid "built-in function" msgstr "built-in function（內建函式）" @@ -3924,7 +3921,7 @@ msgid "id" msgstr "id" #: ../../reference/datamodel.rst:23 ../../reference/datamodel.rst:122 -#: ../../reference/datamodel.rst:2377 +#: ../../reference/datamodel.rst:2370 msgid "type" msgstr "type（型別）" @@ -3960,7 +3957,7 @@ msgstr "reference counting（參照計數）" msgid "unreachable object" msgstr "unreachable object（不可達物件）" -#: ../../reference/datamodel.rst:95 ../../reference/datamodel.rst:938 +#: ../../reference/datamodel.rst:95 ../../reference/datamodel.rst:931 msgid "container" msgstr "container（容器）" @@ -3974,24 +3971,24 @@ msgstr "extension（擴充）" #: ../../reference/datamodel.rst:122 ../../reference/datamodel.rst:396 #: ../../reference/datamodel.rst:397 ../../reference/datamodel.rst:498 -#: ../../reference/datamodel.rst:859 ../../reference/datamodel.rst:879 -#: ../../reference/datamodel.rst:1053 +#: ../../reference/datamodel.rst:852 ../../reference/datamodel.rst:872 +#: ../../reference/datamodel.rst:1046 msgid "module" msgstr "module（模組）" #: ../../reference/datamodel.rst:122 ../../reference/datamodel.rst:261 -#: ../../reference/datamodel.rst:802 +#: ../../reference/datamodel.rst:795 msgid "C" msgstr "C" #: ../../reference/datamodel.rst:122 ../../reference/datamodel.rst:261 -#: ../../reference/datamodel.rst:802 +#: ../../reference/datamodel.rst:795 msgid "language" msgstr "language（語言）" -#: ../../reference/datamodel.rst:135 ../../reference/datamodel.rst:938 -#: ../../reference/datamodel.rst:956 ../../reference/datamodel.rst:1007 -#: ../../reference/datamodel.rst:1027 +#: ../../reference/datamodel.rst:135 ../../reference/datamodel.rst:931 +#: ../../reference/datamodel.rst:949 ../../reference/datamodel.rst:1000 +#: ../../reference/datamodel.rst:1020 msgid "attribute" msgstr "attribute（屬性）" @@ -4011,7 +4008,7 @@ msgstr "..." msgid "ellipsis literal" msgstr "ellipsis literal（刪節號）" -#: ../../reference/datamodel.rst:192 ../../reference/datamodel.rst:1034 +#: ../../reference/datamodel.rst:192 ../../reference/datamodel.rst:1027 msgid "numeric" msgstr "numeric（數值）" @@ -4048,16 +4045,16 @@ msgstr "number（數字）" msgid "Java" msgstr "Java" -#: ../../reference/datamodel.rst:279 ../../reference/datamodel.rst:3072 +#: ../../reference/datamodel.rst:279 ../../reference/datamodel.rst:3065 msgid "complex" msgstr "complex（複數）" #: ../../reference/datamodel.rst:292 ../../reference/datamodel.rst:423 -#: ../../reference/datamodel.rst:462 ../../reference/datamodel.rst:2806 +#: ../../reference/datamodel.rst:462 ../../reference/datamodel.rst:2799 msgid "len" msgstr "len" -#: ../../reference/datamodel.rst:292 ../../reference/datamodel.rst:1034 +#: ../../reference/datamodel.rst:292 ../../reference/datamodel.rst:1027 msgid "sequence" msgstr "sequence（序列）" @@ -4086,8 +4083,8 @@ msgstr "immutable sequence（不可變序列）" msgid "immutable" msgstr "immutable（不可變）" -#: ../../reference/datamodel.rst:335 ../../reference/datamodel.rst:1707 -#: ../../reference/datamodel.rst:1737 +#: ../../reference/datamodel.rst:335 ../../reference/datamodel.rst:1700 +#: ../../reference/datamodel.rst:1730 msgid "string" msgstr "string（字串）" @@ -4123,7 +4120,7 @@ msgstr "singleton（單例）" msgid "empty" msgstr "empty（空的）" -#: ../../reference/datamodel.rst:372 ../../reference/datamodel.rst:1732 +#: ../../reference/datamodel.rst:372 ../../reference/datamodel.rst:1725 msgid "bytes" msgstr "bytes（位元組）" @@ -4139,14 +4136,14 @@ msgstr "mutable sequence（可變序列）" msgid "mutable" msgstr "mutable（可變的）" -#: ../../reference/datamodel.rst:384 ../../reference/datamodel.rst:956 -#: ../../reference/datamodel.rst:1027 +#: ../../reference/datamodel.rst:384 ../../reference/datamodel.rst:949 +#: ../../reference/datamodel.rst:1020 msgid "assignment" msgstr "assignment（賦值）" -#: ../../reference/datamodel.rst:384 ../../reference/datamodel.rst:859 -#: ../../reference/datamodel.rst:1444 ../../reference/datamodel.rst:1626 -#: ../../reference/datamodel.rst:3127 +#: ../../reference/datamodel.rst:384 ../../reference/datamodel.rst:852 +#: ../../reference/datamodel.rst:1437 ../../reference/datamodel.rst:1619 +#: ../../reference/datamodel.rst:3120 msgid "statement" msgstr "statement（陳述式）" @@ -4178,12 +4175,12 @@ msgstr "set（集合）" msgid "frozenset" msgstr "frozenset（凍結集合）" -#: ../../reference/datamodel.rst:462 ../../reference/datamodel.rst:1034 +#: ../../reference/datamodel.rst:462 ../../reference/datamodel.rst:1027 msgid "mapping" msgstr "mapping（對映）" -#: ../../reference/datamodel.rst:479 ../../reference/datamodel.rst:938 -#: ../../reference/datamodel.rst:1821 +#: ../../reference/datamodel.rst:479 ../../reference/datamodel.rst:931 +#: ../../reference/datamodel.rst:1814 msgid "dictionary" msgstr "dictionary（字典）" @@ -4200,13 +4197,13 @@ msgid "callable" msgstr "callable（可呼叫物件）" #: ../../reference/datamodel.rst:515 ../../reference/datamodel.rst:530 -#: ../../reference/datamodel.rst:746 ../../reference/datamodel.rst:764 -#: ../../reference/datamodel.rst:777 ../../reference/datamodel.rst:802 +#: ../../reference/datamodel.rst:739 ../../reference/datamodel.rst:757 +#: ../../reference/datamodel.rst:770 ../../reference/datamodel.rst:795 msgid "function" msgstr "function （函式）" -#: ../../reference/datamodel.rst:515 ../../reference/datamodel.rst:938 -#: ../../reference/datamodel.rst:961 ../../reference/datamodel.rst:2758 +#: ../../reference/datamodel.rst:515 ../../reference/datamodel.rst:931 +#: ../../reference/datamodel.rst:954 ../../reference/datamodel.rst:2751 msgid "call" msgstr "call（呼叫）" @@ -4238,7 +4235,7 @@ msgstr "__globals__ （函式屬性）" msgid "global" msgstr "global（全域）" -#: ../../reference/datamodel.rst:543 ../../reference/datamodel.rst:879 +#: ../../reference/datamodel.rst:543 ../../reference/datamodel.rst:872 msgid "namespace" msgstr "namespace（命名空間）" @@ -4278,7 +4275,7 @@ msgstr "__kwdefaults__ （函式屬性）" msgid "__type_params__ (function attribute)" msgstr "__type_params__ （函式屬性）" -#: ../../reference/datamodel.rst:657 ../../reference/datamodel.rst:826 +#: ../../reference/datamodel.rst:657 ../../reference/datamodel.rst:819 msgid "method" msgstr "method（方法）" @@ -4306,531 +4303,552 @@ msgstr "__name__ （方法屬性）" msgid "__module__ (method attribute)" msgstr "__module__ （方法屬性）" -#: ../../reference/datamodel.rst:746 ../../reference/datamodel.rst:1200 +#: ../../reference/datamodel.rst:739 ../../reference/datamodel.rst:1193 msgid "generator" msgstr "generator（產生器）" -#: ../../reference/datamodel.rst:746 +#: ../../reference/datamodel.rst:739 msgid "iterator" msgstr "itorator（疊代器）" -#: ../../reference/datamodel.rst:764 ../../reference/datamodel.rst:3314 +#: ../../reference/datamodel.rst:757 ../../reference/datamodel.rst:3307 msgid "coroutine" msgstr "coroutine（協程）" -#: ../../reference/datamodel.rst:777 +#: ../../reference/datamodel.rst:770 msgid "asynchronous generator" msgstr "asynchronous generator（非同步產生器）" -#: ../../reference/datamodel.rst:777 +#: ../../reference/datamodel.rst:770 msgid "asynchronous iterator" msgstr "asynchronous iterator（非同步疊代器）" -#: ../../reference/datamodel.rst:826 +#: ../../reference/datamodel.rst:819 msgid "built-in method" msgstr "built-in method（內建方法）" -#: ../../reference/datamodel.rst:826 +#: ../../reference/datamodel.rst:819 msgid "built-in" msgstr "built-in（內建）" -#: ../../reference/datamodel.rst:859 +#: ../../reference/datamodel.rst:852 msgid "import" msgstr "import（引入）" -#: ../../reference/datamodel.rst:879 +#: ../../reference/datamodel.rst:872 msgid "__name__ (module attribute)" msgstr "__name__ （模組屬性）" -#: ../../reference/datamodel.rst:879 +#: ../../reference/datamodel.rst:872 msgid "__doc__ (module attribute)" msgstr "__doc__ （模組屬性）" -#: ../../reference/datamodel.rst:879 +#: ../../reference/datamodel.rst:872 msgid "__file__ (module attribute)" msgstr "__file__ （模組屬性）" -#: ../../reference/datamodel.rst:879 +#: ../../reference/datamodel.rst:872 msgid "__annotations__ (module attribute)" msgstr "__annotations__ （模組屬性）" -#: ../../reference/datamodel.rst:910 +#: ../../reference/datamodel.rst:903 msgid "__dict__ (module attribute)" msgstr "__dict__ （模組屬性）" -#: ../../reference/datamodel.rst:938 ../../reference/datamodel.rst:956 -#: ../../reference/datamodel.rst:1007 ../../reference/datamodel.rst:1609 -#: ../../reference/datamodel.rst:2488 +#: ../../reference/datamodel.rst:931 ../../reference/datamodel.rst:949 +#: ../../reference/datamodel.rst:1000 ../../reference/datamodel.rst:1602 +#: ../../reference/datamodel.rst:2481 msgid "class" msgstr "class（類別）" -#: ../../reference/datamodel.rst:938 ../../reference/datamodel.rst:1007 -#: ../../reference/datamodel.rst:1027 +#: ../../reference/datamodel.rst:931 ../../reference/datamodel.rst:1000 +#: ../../reference/datamodel.rst:1020 msgid "class instance" msgstr "class instance（類別實例）" -#: ../../reference/datamodel.rst:938 ../../reference/datamodel.rst:1007 -#: ../../reference/datamodel.rst:2758 +#: ../../reference/datamodel.rst:931 ../../reference/datamodel.rst:1000 +#: ../../reference/datamodel.rst:2751 msgid "instance" msgstr "instance（實例）" -#: ../../reference/datamodel.rst:938 ../../reference/datamodel.rst:961 +#: ../../reference/datamodel.rst:931 ../../reference/datamodel.rst:954 msgid "class object" msgstr "class object（類別物件）" -#: ../../reference/datamodel.rst:965 +#: ../../reference/datamodel.rst:958 msgid "__name__ (class attribute)" msgstr "__name__ （類別屬性）" -#: ../../reference/datamodel.rst:965 +#: ../../reference/datamodel.rst:958 msgid "__module__ (class attribute)" msgstr "__module__ （類別屬性）" -#: ../../reference/datamodel.rst:965 +#: ../../reference/datamodel.rst:958 msgid "__dict__ (class attribute)" msgstr "__dict__ （類別屬性）" -#: ../../reference/datamodel.rst:965 +#: ../../reference/datamodel.rst:958 msgid "__bases__ (class attribute)" msgstr "__bases__ （類別屬性）" -#: ../../reference/datamodel.rst:965 +#: ../../reference/datamodel.rst:958 msgid "__doc__ (class attribute)" msgstr "__doc__ （類別屬性）" -#: ../../reference/datamodel.rst:965 +#: ../../reference/datamodel.rst:958 msgid "__annotations__ (class attribute)" msgstr "__annotations__ （類別屬性）" -#: ../../reference/datamodel.rst:965 +#: ../../reference/datamodel.rst:958 msgid "__type_params__ (class attribute)" msgstr "__type_params__ （類別屬性）" -#: ../../reference/datamodel.rst:1042 +#: ../../reference/datamodel.rst:1035 msgid "__dict__ (instance attribute)" msgstr "__dict__ （實例屬性）" -#: ../../reference/datamodel.rst:1042 +#: ../../reference/datamodel.rst:1035 msgid "__class__ (instance attribute)" msgstr "__class__ （實例屬性）" -#: ../../reference/datamodel.rst:1053 +#: ../../reference/datamodel.rst:1046 msgid "open" msgstr "open" -#: ../../reference/datamodel.rst:1053 +#: ../../reference/datamodel.rst:1046 msgid "io" msgstr "io" -#: ../../reference/datamodel.rst:1053 +#: ../../reference/datamodel.rst:1046 msgid "popen() (in module os)" msgstr "popen() （於 os 模組中）" -#: ../../reference/datamodel.rst:1053 +#: ../../reference/datamodel.rst:1046 msgid "makefile() (socket method)" msgstr "makefile() （socket 方法）" -#: ../../reference/datamodel.rst:1053 +#: ../../reference/datamodel.rst:1046 msgid "sys.stdin" msgstr "sys.stdin" -#: ../../reference/datamodel.rst:1053 +#: ../../reference/datamodel.rst:1046 msgid "sys.stdout" msgstr "sys.stdout" -#: ../../reference/datamodel.rst:1053 +#: ../../reference/datamodel.rst:1046 msgid "sys.stderr" msgstr "sys.stderr" -#: ../../reference/datamodel.rst:1053 +#: ../../reference/datamodel.rst:1046 msgid "stdio" msgstr "stdio" -#: ../../reference/datamodel.rst:1053 +#: ../../reference/datamodel.rst:1046 msgid "stdin (in module sys)" msgstr "stdin （sys 模組中）" -#: ../../reference/datamodel.rst:1053 +#: ../../reference/datamodel.rst:1046 msgid "stdout (in module sys)" msgstr "stdout （sys 模組中）" -#: ../../reference/datamodel.rst:1053 +#: ../../reference/datamodel.rst:1046 msgid "stderr (in module sys)" msgstr "stderr （sys 模組中）" -#: ../../reference/datamodel.rst:1082 +#: ../../reference/datamodel.rst:1075 msgid "internal type" msgstr "internal type（內部型別）" -#: ../../reference/datamodel.rst:1082 +#: ../../reference/datamodel.rst:1075 msgid "types, internal" msgstr "types（型別）, internal（內部）" -#: ../../reference/datamodel.rst:1096 +#: ../../reference/datamodel.rst:1089 msgid "bytecode" msgstr "bytecode（位元組碼）" -#: ../../reference/datamodel.rst:1096 +#: ../../reference/datamodel.rst:1089 msgid "code" msgstr "code（程式碼）" -#: ../../reference/datamodel.rst:1096 +#: ../../reference/datamodel.rst:1089 msgid "code object" msgstr "code object（程式碼物件）" -#: ../../reference/datamodel.rst:1107 +#: ../../reference/datamodel.rst:1100 msgid "co_argcount (code object attribute)" msgstr "co_argcount （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1107 +#: ../../reference/datamodel.rst:1100 msgid "co_posonlyargcount (code object attribute)" msgstr "co_posonlyargcount （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1107 +#: ../../reference/datamodel.rst:1100 msgid "co_kwonlyargcount (code object attribute)" msgstr "co_kwonlyargcount （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1107 +#: ../../reference/datamodel.rst:1100 msgid "co_code (code object attribute)" msgstr "co_code （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1107 +#: ../../reference/datamodel.rst:1100 msgid "co_consts (code object attribute)" msgstr "co_consts （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1107 +#: ../../reference/datamodel.rst:1100 msgid "co_filename (code object attribute)" msgstr "co_filename （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1107 +#: ../../reference/datamodel.rst:1100 msgid "co_firstlineno (code object attribute)" msgstr "co_firstlineno （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1107 +#: ../../reference/datamodel.rst:1100 msgid "co_flags (code object attribute)" msgstr "co_flags （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1107 +#: ../../reference/datamodel.rst:1100 msgid "co_lnotab (code object attribute)" msgstr "co_lnotab （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1107 +#: ../../reference/datamodel.rst:1100 msgid "co_name (code object attribute)" msgstr "co_name （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1107 +#: ../../reference/datamodel.rst:1100 msgid "co_names (code object attribute)" msgstr "co_names （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1107 +#: ../../reference/datamodel.rst:1100 msgid "co_nlocals (code object attribute)" msgstr "co_nlocals （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1107 +#: ../../reference/datamodel.rst:1100 msgid "co_stacksize (code object attribute)" msgstr "co_stacksize （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1107 +#: ../../reference/datamodel.rst:1100 msgid "co_varnames (code object attribute)" msgstr "co_varnames （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1107 +#: ../../reference/datamodel.rst:1100 msgid "co_cellvars (code object attribute)" msgstr "co_cellvars （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1107 +#: ../../reference/datamodel.rst:1100 msgid "co_freevars (code object attribute)" msgstr "co_freevars （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1107 +#: ../../reference/datamodel.rst:1100 msgid "co_qualname (code object attribute)" msgstr "co_qualname （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1218 +#: ../../reference/datamodel.rst:1211 msgid "documentation string" msgstr "documentation string（文件字串）" -#: ../../reference/datamodel.rst:1307 +#: ../../reference/datamodel.rst:1300 msgid "frame" msgstr "frame" -#: ../../reference/datamodel.rst:1313 +#: ../../reference/datamodel.rst:1306 msgid "f_back (frame attribute)" msgstr "f_back （frame 屬性）" -#: ../../reference/datamodel.rst:1313 +#: ../../reference/datamodel.rst:1306 msgid "f_code (frame attribute)" msgstr "f_code （frame 屬性）" -#: ../../reference/datamodel.rst:1313 +#: ../../reference/datamodel.rst:1306 msgid "f_globals (frame attribute)" msgstr "f_globals （frame 屬性）" -#: ../../reference/datamodel.rst:1313 +#: ../../reference/datamodel.rst:1306 msgid "f_locals (frame attribute)" msgstr "f_locals （frame 屬性）" -#: ../../reference/datamodel.rst:1313 +#: ../../reference/datamodel.rst:1306 msgid "f_lasti (frame attribute)" msgstr "f_lasti （frame 屬性）" -#: ../../reference/datamodel.rst:1313 +#: ../../reference/datamodel.rst:1306 msgid "f_builtins (frame attribute)" msgstr "f_builtins （frame 屬性）" -#: ../../reference/datamodel.rst:1352 +#: ../../reference/datamodel.rst:1345 msgid "f_trace (frame attribute)" msgstr "f_trace （frame 屬性）" -#: ../../reference/datamodel.rst:1352 +#: ../../reference/datamodel.rst:1345 msgid "f_trace_lines (frame attribute)" msgstr "f_trace_lines （frame 屬性）" -#: ../../reference/datamodel.rst:1352 +#: ../../reference/datamodel.rst:1345 msgid "f_trace_opcodes (frame attribute)" msgstr "f_trace_opcodes （frame 屬性）" -#: ../../reference/datamodel.rst:1352 +#: ../../reference/datamodel.rst:1345 msgid "f_lineno (frame attribute)" msgstr "f_lineno （frame 屬性）" -#: ../../reference/datamodel.rst:1407 +#: ../../reference/datamodel.rst:1400 msgid "traceback" msgstr "traceback" -#: ../../reference/datamodel.rst:1407 +#: ../../reference/datamodel.rst:1400 msgid "stack" msgstr "stack（堆疊）" -#: ../../reference/datamodel.rst:1407 +#: ../../reference/datamodel.rst:1400 msgid "trace" msgstr "trace（追蹤）" -#: ../../reference/datamodel.rst:1407 +#: ../../reference/datamodel.rst:1400 msgid "exception" msgstr "exception（例外）" -#: ../../reference/datamodel.rst:1407 +#: ../../reference/datamodel.rst:1400 msgid "handler" msgstr "handler（處理器）" -#: ../../reference/datamodel.rst:1407 +#: ../../reference/datamodel.rst:1400 msgid "execution" msgstr "execution（執行）" -#: ../../reference/datamodel.rst:1407 +#: ../../reference/datamodel.rst:1400 msgid "exc_info (in module sys)" msgstr "exc_info （sys 模組中）" -#: ../../reference/datamodel.rst:1407 +#: ../../reference/datamodel.rst:1400 msgid "last_traceback (in module sys)" msgstr "last_traceback （sys 模組中）" -#: ../../reference/datamodel.rst:1407 +#: ../../reference/datamodel.rst:1400 msgid "sys.exc_info" msgstr "sys.exc_info" -#: ../../reference/datamodel.rst:1407 +#: ../../reference/datamodel.rst:1400 msgid "sys.exception" msgstr "sys.exception" -#: ../../reference/datamodel.rst:1407 +#: ../../reference/datamodel.rst:1400 msgid "sys.last_traceback" msgstr "sys.last_traceback" -#: ../../reference/datamodel.rst:1444 +#: ../../reference/datamodel.rst:1437 msgid "tb_frame (traceback attribute)" msgstr "tb_frame （traceback 屬性）" -#: ../../reference/datamodel.rst:1444 +#: ../../reference/datamodel.rst:1437 msgid "tb_lineno (traceback attribute)" msgstr "tb_lineno （traceback 屬性）" -#: ../../reference/datamodel.rst:1444 +#: ../../reference/datamodel.rst:1437 msgid "tb_lasti (traceback attribute)" msgstr "tb_lasti （traceback 屬性）" -#: ../../reference/datamodel.rst:1444 +#: ../../reference/datamodel.rst:1437 msgid "try" msgstr "try" -#: ../../reference/datamodel.rst:1474 +#: ../../reference/datamodel.rst:1467 msgid "tb_next (traceback attribute)" msgstr "tb_next （traceback 屬性）" -#: ../../reference/datamodel.rst:1490 ../../reference/datamodel.rst:2836 +#: ../../reference/datamodel.rst:1483 ../../reference/datamodel.rst:2829 msgid "slice" msgstr "slice（切片）" -#: ../../reference/datamodel.rst:1496 +#: ../../reference/datamodel.rst:1489 msgid "start (slice object attribute)" msgstr "start （slice 物件屬性）" -#: ../../reference/datamodel.rst:1496 +#: ../../reference/datamodel.rst:1489 msgid "stop (slice object attribute)" msgstr "stop （slice 物件屬性）" -#: ../../reference/datamodel.rst:1496 +#: ../../reference/datamodel.rst:1489 msgid "step (slice object attribute)" msgstr "step （slice 物件屬性）" -#: ../../reference/datamodel.rst:1544 +#: ../../reference/datamodel.rst:1537 msgid "operator" msgstr "operator（運算子）" -#: ../../reference/datamodel.rst:1544 +#: ../../reference/datamodel.rst:1537 msgid "overloading" msgstr "overloading（多載）" -#: ../../reference/datamodel.rst:1544 +#: ../../reference/datamodel.rst:1537 msgid "__getitem__() (mapping object method)" msgstr "__getitem__() （對映物件方法）" -#: ../../reference/datamodel.rst:1580 +#: ../../reference/datamodel.rst:1573 msgid "subclassing" msgstr "subclassing（子類別化）" -#: ../../reference/datamodel.rst:1580 +#: ../../reference/datamodel.rst:1573 msgid "immutable types" msgstr "immutable types（不可變型別）" -#: ../../reference/datamodel.rst:1609 +#: ../../reference/datamodel.rst:1602 msgid "constructor" msgstr "constructor（建構函式）" -#: ../../reference/datamodel.rst:1626 +#: ../../reference/datamodel.rst:1619 msgid "destructor" msgstr "destructor（解構函式）" -#: ../../reference/datamodel.rst:1626 +#: ../../reference/datamodel.rst:1619 msgid "finalizer" msgstr "finalizer（終結函式）" -#: ../../reference/datamodel.rst:1626 +#: ../../reference/datamodel.rst:1619 msgid "del" msgstr "del" -#: ../../reference/datamodel.rst:1690 +#: ../../reference/datamodel.rst:1683 msgid "repr() (built-in function)" msgstr "repr() （內建函式）" -#: ../../reference/datamodel.rst:1690 +#: ../../reference/datamodel.rst:1683 msgid "__repr__() (object method)" msgstr "__repr__() （物件方法）" -#: ../../reference/datamodel.rst:1707 +#: ../../reference/datamodel.rst:1700 msgid "__str__() (object method)" msgstr "__str__() （物件方法）" -#: ../../reference/datamodel.rst:1707 +#: ../../reference/datamodel.rst:1700 msgid "format() (built-in function)" msgstr "format() （內建函式）" -#: ../../reference/datamodel.rst:1707 +#: ../../reference/datamodel.rst:1700 msgid "print() (built-in function)" msgstr "print() （內建函式）" -#: ../../reference/datamodel.rst:1737 +#: ../../reference/datamodel.rst:1730 msgid "__format__() (object method)" msgstr "__format__() （物件方法）" -#: ../../reference/datamodel.rst:1737 +#: ../../reference/datamodel.rst:1730 msgid "conversion" msgstr "conversion" -#: ../../reference/datamodel.rst:1737 +#: ../../reference/datamodel.rst:1730 msgid "print" msgstr "print" -#: ../../reference/datamodel.rst:1776 +#: ../../reference/datamodel.rst:1769 msgid "comparisons" msgstr "comparison（比較）" -#: ../../reference/datamodel.rst:1821 +#: ../../reference/datamodel.rst:1814 msgid "hash" msgstr "hash（雜湊）" -#: ../../reference/datamodel.rst:1902 +#: ../../reference/datamodel.rst:1895 msgid "__len__() (mapping object method)" msgstr "__len__() （對映物件方法）" -#: ../../reference/datamodel.rst:2006 +#: ../../reference/datamodel.rst:1999 msgid "__getattr__ (module attribute)" msgstr "__getattr__ （模組屬性）" -#: ../../reference/datamodel.rst:2006 +#: ../../reference/datamodel.rst:1999 msgid "__dir__ (module attribute)" msgstr "__dir__ （模組屬性）" -#: ../../reference/datamodel.rst:2006 +#: ../../reference/datamodel.rst:1999 msgid "__class__ (module attribute)" msgstr "__class__ （模組屬性）" -#: ../../reference/datamodel.rst:2377 +#: ../../reference/datamodel.rst:2370 msgid "metaclass" msgstr "metaclass（元類別）" -#: ../../reference/datamodel.rst:2377 +#: ../../reference/datamodel.rst:2370 msgid "= (equals)" msgstr "= （等於）" -#: ../../reference/datamodel.rst:2377 +#: ../../reference/datamodel.rst:2370 msgid "class definition" msgstr "class definition（類別定義）" -#: ../../reference/datamodel.rst:2441 +#: ../../reference/datamodel.rst:2434 msgid "metaclass hint" msgstr "metaclass hint（元類別提示）" -#: ../../reference/datamodel.rst:2464 +#: ../../reference/datamodel.rst:2457 msgid "__prepare__ (metaclass method)" msgstr "__prepare__ （元類別方法）" -#: ../../reference/datamodel.rst:2488 +#: ../../reference/datamodel.rst:2481 msgid "body" msgstr "body" -#: ../../reference/datamodel.rst:2508 +#: ../../reference/datamodel.rst:2501 msgid "__class__ (method cell)" msgstr "__class__ （方法 cell）" -#: ../../reference/datamodel.rst:2508 +#: ../../reference/datamodel.rst:2501 msgid "__classcell__ (class namespace entry)" msgstr "__classcell__ （類別命名空間項目）" -#: ../../reference/datamodel.rst:2806 +#: ../../reference/datamodel.rst:2799 msgid "__bool__() (object method)" msgstr "__bool__() （物件方法）" -#: ../../reference/datamodel.rst:2964 ../../reference/datamodel.rst:2999 +#: ../../reference/datamodel.rst:2957 ../../reference/datamodel.rst:2992 msgid "divmod" msgstr "divmod" -#: ../../reference/datamodel.rst:2964 ../../reference/datamodel.rst:2999 -#: ../../reference/datamodel.rst:3013 +#: ../../reference/datamodel.rst:2957 ../../reference/datamodel.rst:2992 +#: ../../reference/datamodel.rst:3006 msgid "pow" msgstr "pow" -#: ../../reference/datamodel.rst:3062 +#: ../../reference/datamodel.rst:3055 msgid "abs" msgstr "abs" -#: ../../reference/datamodel.rst:3072 +#: ../../reference/datamodel.rst:3065 msgid "int" msgstr "int" -#: ../../reference/datamodel.rst:3072 +#: ../../reference/datamodel.rst:3065 msgid "float" msgstr "float" -#: ../../reference/datamodel.rst:3100 +#: ../../reference/datamodel.rst:3093 msgid "round" msgstr "round" -#: ../../reference/datamodel.rst:3127 +#: ../../reference/datamodel.rst:3120 msgid "with" msgstr "with" -#: ../../reference/datamodel.rst:3127 +#: ../../reference/datamodel.rst:3120 msgid "context manager" msgstr "context manager（情境管理器）" + +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``object.__getattr__`` with " +#~ "arguments ``obj``, ``name``." +#~ msgstr "" +#~ "引發一個附帶引數 ``obj``、``name`` 的\\ :ref:`稽核事件 ` " +#~ "``object.__getattr__``。" + +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``object.__setattr__`` with " +#~ "arguments ``obj``, ``name``, ``value``." +#~ msgstr "" +#~ "引發一個附帶引數 ``obj``、``name``、``value`` 的\\ :ref:`稽核事件 " +#~ "` ``object.__setattr__``。" + +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``object.__delattr__`` with " +#~ "arguments ``obj``, ``name``." +#~ msgstr "" +#~ "引發一個附帶引數 ``obj``、``name`` 的\\ :ref:`稽核事件 ` " +#~ "``object.__delattr__``。" diff --git a/reference/simple_stmts.po b/reference/simple_stmts.po index a5b35e53ed..300c6f392d 100644 --- a/reference/simple_stmts.po +++ b/reference/simple_stmts.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-05 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:17+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -846,10 +846,10 @@ msgid "" msgstr "" #: ../../reference/simple_stmts.rst:866 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``import`` with arguments " -"``module``, ``filename``, ``sys.path``, ``sys.meta_path``, ``sys." -"path_hooks``." +"Raises an auditing event import with arguments module, filename, sys.path, " +"sys.meta_path, sys.path_hooks." msgstr "" "引發一個附帶引數 ``module``、``filename``、``sys.path``、``sys.meta_path``、" "``sys.path_hooks`` 的\\ :ref:`稽核事件 ` ``import``。" diff --git a/using/cmdline.po b/using/cmdline.po index d003016ec8..0f5c5937bb 100644 --- a/using/cmdline.po +++ b/using/cmdline.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-23 00:04+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:19+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -118,9 +118,8 @@ msgid "" msgstr "" #: ../../using/cmdline.rst:73 -msgid "" -"Raises an :ref:`auditing event ` ``cpython.run_command`` with " -"argument ``command``." +#, fuzzy +msgid "Raises an auditing event cpython.run_command with argument command." msgstr "" "引發一個附帶引數 ``command`` 的\\ :ref:`稽核事件 ` ``cpython." "run_command``。" @@ -178,9 +177,8 @@ msgid "" msgstr "" #: ../../using/cmdline.rst:115 -msgid "" -"Raises an :ref:`auditing event ` ``cpython.run_module`` with " -"argument ``module-name``." +#, fuzzy +msgid "Raises an auditing event cpython.run_module with argument module-name." msgstr "" "引發一個附帶引數 ``module-name`` 的\\ :ref:`稽核事件 ` ``cpython." "run_module``。" @@ -219,9 +217,8 @@ msgid "" msgstr "" #: ../../using/cmdline.rst:140 ../../using/cmdline.rst:723 -msgid "" -"Raises an :ref:`auditing event ` ``cpython.run_stdin`` with no " -"arguments." +#, fuzzy +msgid "Raises an auditing event cpython.run_stdin with no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``cpython.run_stdin``。" @@ -261,10 +258,11 @@ msgid "" msgstr "" #: ../../using/cmdline.rst:167 -msgid "" -"Raises an :ref:`auditing event ` ``cpython.run_file`` with " -"argument ``filename``." +#, fuzzy +msgid "Raises an auditing event cpython.run_file with argument filename." msgstr "" +"引發一個附帶引數 ``filename`` 的\\ :ref:`稽核事件 ` ``cpython." +"run_startup``。" #: ../../using/cmdline.rst:170 msgid ":func:`runpy.run_path`" @@ -851,12 +849,13 @@ msgid "" msgstr "" #: ../../using/cmdline.rst:680 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``cpython.run_startup`` with " -"argument ``filename``." +"Raises an auditing event cpython.run_startup with the filename as the " +"argument when called on startup." msgstr "" -"引發一個附帶引數 ``filename`` 的\\ :ref:`稽核事件 ` ``cpython." -"run_startup``。" +"引發一個附帶呼叫啟動時的檔案名稱為引數的\\ :ref:`稽核事件 ` " +"``cpython.run_startup``。" #: ../../using/cmdline.rst:682 msgid "" diff --git a/whatsnew/3.12.po b/whatsnew/3.12.po index 0add2d8872..c9ddd830d7 100644 --- a/whatsnew/3.12.po +++ b/whatsnew/3.12.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-28 00:03+0000\n" +"POT-Creation-Date: 2024-07-31 00:03+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -2059,7 +2059,7 @@ msgid "" "en/latest/using.html#migrating-from-legacy>`_ (:gh:`106531`)" msgstr "" -#: ../../whatsnew/3.12.rst:2225 +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:2 #: ../../deprecations/pending-removal-in-3.14.rst:2 msgid "Pending Removal in Python 3.14" msgstr "Python 3.14 中待決議的移除項目" @@ -2189,7 +2189,7 @@ msgid "" "`88168`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2262 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:2 #: ../../deprecations/pending-removal-in-3.15.rst:2 msgid "Pending Removal in Python 3.15" msgstr "Python 3.15 中待決議的移除項目" @@ -2293,7 +2293,7 @@ msgid "" "lack of interest. (Contributed by Bénédikt Tran in :gh:`119698`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2280 +#: ../../deprecations/c-api-pending-removal-in-future.rst:2 #: ../../deprecations/pending-removal-in-future.rst:2 msgid "Pending Removal in Future Versions" msgstr "未來版本中待決議的移除項目" @@ -2667,7 +2667,7 @@ msgid "" "`~zipimport.zipimporter.exec_module` instead." msgstr "" -#: ../../whatsnew/3.12.rst:1355 ../../whatsnew/3.12.rst:2312 +#: ../../whatsnew/3.12.rst:1355 ../../whatsnew/3.12.rst:2233 msgid "Removed" msgstr "已移除" @@ -4109,72 +4109,72 @@ msgstr "" msgid "Deprecate global configuration variable:" msgstr "棄用全域配置變數：" -#: ../../whatsnew/3.12.rst:2147 ../../whatsnew/3.12.rst:2232 +#: ../../whatsnew/3.12.rst:2147 msgid ":c:var:`Py_DebugFlag`: use :c:member:`PyConfig.parser_debug`" msgstr ":c:var:`Py_DebugFlag`: 請改用 :c:member:`PyConfig.parser_debug`" -#: ../../whatsnew/3.12.rst:2148 ../../whatsnew/3.12.rst:2233 +#: ../../whatsnew/3.12.rst:2148 msgid ":c:var:`Py_VerboseFlag`: use :c:member:`PyConfig.verbose`" msgstr ":c:var:`Py_VerboseFlag`: 請改用 :c:member:`PyConfig.verbose`" -#: ../../whatsnew/3.12.rst:2149 ../../whatsnew/3.12.rst:2234 +#: ../../whatsnew/3.12.rst:2149 msgid ":c:var:`Py_QuietFlag`: use :c:member:`PyConfig.quiet`" msgstr ":c:var:`Py_QuietFlag`: 請改用 :c:member:`PyConfig.quiet`" -#: ../../whatsnew/3.12.rst:2150 ../../whatsnew/3.12.rst:2235 +#: ../../whatsnew/3.12.rst:2150 msgid ":c:var:`Py_InteractiveFlag`: use :c:member:`PyConfig.interactive`" msgstr ":c:var:`Py_InteractiveFlag`: 請改用 :c:member:`PyConfig.interactive`" -#: ../../whatsnew/3.12.rst:2151 ../../whatsnew/3.12.rst:2236 +#: ../../whatsnew/3.12.rst:2151 msgid ":c:var:`Py_InspectFlag`: use :c:member:`PyConfig.inspect`" msgstr ":c:var:`Py_InspectFlag`: 請改用 :c:member:`PyConfig.inspect`" -#: ../../whatsnew/3.12.rst:2152 ../../whatsnew/3.12.rst:2237 +#: ../../whatsnew/3.12.rst:2152 msgid ":c:var:`Py_OptimizeFlag`: use :c:member:`PyConfig.optimization_level`" msgstr "" ":c:var:`Py_OptimizeFlag`: 請改用 :c:member:`PyConfig.optimization_level`" -#: ../../whatsnew/3.12.rst:2153 ../../whatsnew/3.12.rst:2238 +#: ../../whatsnew/3.12.rst:2153 msgid ":c:var:`Py_NoSiteFlag`: use :c:member:`PyConfig.site_import`" msgstr ":c:var:`Py_NoSiteFlag`: 請改用 :c:member:`PyConfig.site_import`" -#: ../../whatsnew/3.12.rst:2154 ../../whatsnew/3.12.rst:2239 +#: ../../whatsnew/3.12.rst:2154 msgid ":c:var:`Py_BytesWarningFlag`: use :c:member:`PyConfig.bytes_warning`" msgstr "" ":c:var:`Py_BytesWarningFlag`: 請改用 :c:member:`PyConfig.bytes_warning`" -#: ../../whatsnew/3.12.rst:2155 ../../whatsnew/3.12.rst:2240 +#: ../../whatsnew/3.12.rst:2155 msgid ":c:var:`Py_FrozenFlag`: use :c:member:`PyConfig.pathconfig_warnings`" msgstr "" ":c:var:`Py_FrozenFlag`: 請改用 :c:member:`PyConfig.pathconfig_warnings`" -#: ../../whatsnew/3.12.rst:2156 ../../whatsnew/3.12.rst:2241 +#: ../../whatsnew/3.12.rst:2156 msgid "" ":c:var:`Py_IgnoreEnvironmentFlag`: use :c:member:`PyConfig.use_environment`" msgstr "" ":c:var:`Py_IgnoreEnvironmentFlag`: 請改用 :c:member:`PyConfig." "use_environment`" -#: ../../whatsnew/3.12.rst:2157 ../../whatsnew/3.12.rst:2242 +#: ../../whatsnew/3.12.rst:2157 msgid "" ":c:var:`Py_DontWriteBytecodeFlag`: use :c:member:`PyConfig.write_bytecode`" msgstr "" ":c:var:`Py_DontWriteBytecodeFlag`: 請改用 :c:member:`PyConfig.write_bytecode`" -#: ../../whatsnew/3.12.rst:2158 ../../whatsnew/3.12.rst:2243 +#: ../../whatsnew/3.12.rst:2158 msgid "" ":c:var:`Py_NoUserSiteDirectory`: use :c:member:`PyConfig.user_site_directory`" msgstr "" ":c:var:`Py_NoUserSiteDirectory`: 請改用 :c:member:`PyConfig." "user_site_directory`" -#: ../../whatsnew/3.12.rst:2159 ../../whatsnew/3.12.rst:2244 +#: ../../whatsnew/3.12.rst:2159 msgid "" ":c:var:`Py_UnbufferedStdioFlag`: use :c:member:`PyConfig.buffered_stdio`" msgstr "" ":c:var:`Py_UnbufferedStdioFlag`: 請改用 :c:member:`PyConfig.buffered_stdio`" -#: ../../whatsnew/3.12.rst:2160 ../../whatsnew/3.12.rst:2245 +#: ../../whatsnew/3.12.rst:2160 msgid "" ":c:var:`Py_HashRandomizationFlag`: use :c:member:`PyConfig.use_hash_seed` " "and :c:member:`PyConfig.hash_seed`" @@ -4182,11 +4182,11 @@ msgstr "" ":c:var:`Py_HashRandomizationFlag`: 請改用 :c:member:`PyConfig.use_hash_seed` " "和 :c:member:`PyConfig.hash_seed`" -#: ../../whatsnew/3.12.rst:2162 ../../whatsnew/3.12.rst:2247 +#: ../../whatsnew/3.12.rst:2162 msgid ":c:var:`Py_IsolatedFlag`: use :c:member:`PyConfig.isolated`" msgstr ":c:var:`Py_IsolatedFlag`: 請改用 :c:member:`PyConfig.isolated`" -#: ../../whatsnew/3.12.rst:2163 ../../whatsnew/3.12.rst:2248 +#: ../../whatsnew/3.12.rst:2163 msgid "" ":c:var:`Py_LegacyWindowsFSEncodingFlag`: use :c:member:`PyPreConfig." "legacy_windows_fs_encoding`" @@ -4194,7 +4194,7 @@ msgstr "" ":c:var:`Py_LegacyWindowsFSEncodingFlag`: 請改用 :c:member:`PyPreConfig." "legacy_windows_fs_encoding`" -#: ../../whatsnew/3.12.rst:2164 ../../whatsnew/3.12.rst:2249 +#: ../../whatsnew/3.12.rst:2164 msgid "" ":c:var:`Py_LegacyWindowsStdioFlag`: use :c:member:`PyConfig." "legacy_windows_stdio`" @@ -4202,7 +4202,7 @@ msgstr "" ":c:var:`Py_LegacyWindowsStdioFlag`: 請改用 :c:member:`PyConfig." "legacy_windows_stdio`" -#: ../../whatsnew/3.12.rst:2165 ../../whatsnew/3.12.rst:2250 +#: ../../whatsnew/3.12.rst:2165 msgid "" ":c:var:`!Py_FileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding`" @@ -4210,7 +4210,7 @@ msgstr "" ":c:var:`!Py_FileSystemDefaultEncoding`: 請改用 :c:member:`PyConfig." "filesystem_encoding`" -#: ../../whatsnew/3.12.rst:2166 ../../whatsnew/3.12.rst:2251 +#: ../../whatsnew/3.12.rst:2166 msgid "" ":c:var:`!Py_HasFileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding`" @@ -4218,7 +4218,7 @@ msgstr "" ":c:var:`!Py_HasFileSystemDefaultEncoding`: 請改用 :c:member:`PyConfig." "filesystem_encoding`" -#: ../../whatsnew/3.12.rst:2167 ../../whatsnew/3.12.rst:2252 +#: ../../whatsnew/3.12.rst:2167 msgid "" ":c:var:`!Py_FileSystemDefaultEncodeErrors`: use :c:member:`PyConfig." "filesystem_errors`" @@ -4226,7 +4226,7 @@ msgstr "" ":c:var:`!Py_FileSystemDefaultEncodeErrors`: 請改用 :c:member:`PyConfig." "filesystem_errors`" -#: ../../whatsnew/3.12.rst:2168 ../../whatsnew/3.12.rst:2253 +#: ../../whatsnew/3.12.rst:2168 msgid "" ":c:var:`!Py_UTF8Mode`: use :c:member:`PyPreConfig.utf8_mode` (see :c:func:" "`Py_PreInitialize`)" @@ -4355,244 +4355,486 @@ msgid "" "c:member:`~PyTypeObject.tp_new` is deprecated. Call the metaclass instead." msgstr "" -#: ../../whatsnew/3.12.rst:2227 +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:4 msgid "" "The ``ma_version_tag`` field in :c:type:`PyDictObject` for extension modules " "(:pep:`699`; :gh:`101193`)." msgstr "" -#: ../../whatsnew/3.12.rst:2230 -msgid "Global configuration variables:" -msgstr "全域配置變數：" +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:7 +#, fuzzy +msgid "" +"Creating :c:data:`immutable types ` with mutable " +"bases (:gh:`95388`)." +msgstr "" +"建立具有可變基底的\\ `不可變型別 ` (:gh:`95388`)。" -#: ../../whatsnew/3.12.rst:2255 +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:10 +msgid "" +"Functions to configure Python's initialization, deprecated in Python 3.11:" +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:12 +#, fuzzy +msgid "``PySys_SetArgvEx()``: set :c:member:`PyConfig.argv` instead." +msgstr ":c:var:`Py_InspectFlag`: 請改用 :c:member:`PyConfig.inspect`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:13 +#, fuzzy +msgid "``PySys_SetArgv()``: set :c:member:`PyConfig.argv` instead." +msgstr ":c:var:`Py_InspectFlag`: 請改用 :c:member:`PyConfig.inspect`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:14 +msgid "``Py_SetProgramName()``: set :c:member:`PyConfig.program_name` instead." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:15 +#, fuzzy +msgid "``Py_SetPythonHome()``: set :c:member:`PyConfig.home` instead." +msgstr "" +":c:func:`Py_GetPythonHome`：取得 :c:member:`PyConfig.home` 或 :envvar:" +"`PYTHONHOME` 環境變數" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:17 +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:45 msgid "" "The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" "`PyConfig` instead." msgstr "" ":c:func:`Py_InitializeFromConfig` API 應改為與 :c:type:`PyConfig` 一起使用。" -#: ../../whatsnew/3.12.rst:2258 +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:20 +msgid "Global configuration variables:" +msgstr "全域配置變數：" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:22 +#, fuzzy +msgid ":c:var:`Py_DebugFlag`: use :c:member:`PyConfig.parser_debug` instead." +msgstr ":c:var:`Py_DebugFlag`: 請改用 :c:member:`PyConfig.parser_debug`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:23 +#, fuzzy +msgid ":c:var:`Py_VerboseFlag`: use :c:member:`PyConfig.verbose` instead." +msgstr ":c:var:`Py_VerboseFlag`: 請改用 :c:member:`PyConfig.verbose`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:24 +#, fuzzy +msgid ":c:var:`Py_QuietFlag`: use :c:member:`PyConfig.quiet` instead." +msgstr ":c:var:`Py_QuietFlag`: 請改用 :c:member:`PyConfig.quiet`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:25 #, fuzzy msgid "" -"Creating :c:data:`immutable types ` with mutable " -"bases (:gh:`95388`)." +":c:var:`Py_InteractiveFlag`: use :c:member:`PyConfig.interactive` instead." +msgstr ":c:var:`Py_InteractiveFlag`: 請改用 :c:member:`PyConfig.interactive`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:26 +#, fuzzy +msgid ":c:var:`Py_InspectFlag`: use :c:member:`PyConfig.inspect` instead." +msgstr ":c:var:`Py_InspectFlag`: 請改用 :c:member:`PyConfig.inspect`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:27 +#, fuzzy +msgid "" +":c:var:`Py_OptimizeFlag`: use :c:member:`PyConfig.optimization_level` " +"instead." msgstr "" -"建立具有可變基底的\\ `不可變型別 ` (:gh:`95388`)。" +":c:var:`Py_OptimizeFlag`: 請改用 :c:member:`PyConfig.optimization_level`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:28 +#, fuzzy +msgid ":c:var:`Py_NoSiteFlag`: use :c:member:`PyConfig.site_import` instead." +msgstr ":c:var:`Py_NoSiteFlag`: 請改用 :c:member:`PyConfig.site_import`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:29 +#, fuzzy +msgid "" +":c:var:`Py_BytesWarningFlag`: use :c:member:`PyConfig.bytes_warning` instead." +msgstr "" +":c:var:`Py_BytesWarningFlag`: 請改用 :c:member:`PyConfig.bytes_warning`" -#: ../../whatsnew/3.12.rst:2264 +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:30 +#, fuzzy +msgid "" +":c:var:`Py_FrozenFlag`: use :c:member:`PyConfig.pathconfig_warnings` instead." +msgstr "" +":c:var:`Py_FrozenFlag`: 請改用 :c:member:`PyConfig.pathconfig_warnings`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:31 +#, fuzzy msgid "" -":c:func:`PyImport_ImportModuleNoBlock`: use :c:func:`PyImport_ImportModule`" +":c:var:`Py_IgnoreEnvironmentFlag`: use :c:member:`PyConfig.use_environment` " +"instead." +msgstr "" +":c:var:`Py_IgnoreEnvironmentFlag`: 請改用 :c:member:`PyConfig." +"use_environment`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:32 +#, fuzzy +msgid "" +":c:var:`Py_DontWriteBytecodeFlag`: use :c:member:`PyConfig.write_bytecode` " +"instead." +msgstr "" +":c:var:`Py_DontWriteBytecodeFlag`: 請改用 :c:member:`PyConfig.write_bytecode`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:33 +#, fuzzy +msgid "" +":c:var:`Py_NoUserSiteDirectory`: use :c:member:`PyConfig." +"user_site_directory` instead." +msgstr "" +":c:var:`Py_NoUserSiteDirectory`: 請改用 :c:member:`PyConfig." +"user_site_directory`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:34 +#, fuzzy +msgid "" +":c:var:`Py_UnbufferedStdioFlag`: use :c:member:`PyConfig.buffered_stdio` " +"instead." +msgstr "" +":c:var:`Py_UnbufferedStdioFlag`: 請改用 :c:member:`PyConfig.buffered_stdio`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:35 +#, fuzzy +msgid "" +":c:var:`Py_HashRandomizationFlag`: use :c:member:`PyConfig.use_hash_seed` " +"and :c:member:`PyConfig.hash_seed` instead." +msgstr "" +":c:var:`Py_HashRandomizationFlag`: 請改用 :c:member:`PyConfig.use_hash_seed` " +"和 :c:member:`PyConfig.hash_seed`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:37 +#, fuzzy +msgid ":c:var:`Py_IsolatedFlag`: use :c:member:`PyConfig.isolated` instead." +msgstr ":c:var:`Py_IsolatedFlag`: 請改用 :c:member:`PyConfig.isolated`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:38 +#, fuzzy +msgid "" +":c:var:`Py_LegacyWindowsFSEncodingFlag`: use :c:member:`PyPreConfig." +"legacy_windows_fs_encoding` instead." +msgstr "" +":c:var:`Py_LegacyWindowsFSEncodingFlag`: 請改用 :c:member:`PyPreConfig." +"legacy_windows_fs_encoding`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:39 +#, fuzzy +msgid "" +":c:var:`Py_LegacyWindowsStdioFlag`: use :c:member:`PyConfig." +"legacy_windows_stdio` instead." +msgstr "" +":c:var:`Py_LegacyWindowsStdioFlag`: 請改用 :c:member:`PyConfig." +"legacy_windows_stdio`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:40 +#, fuzzy +msgid "" +":c:var:`!Py_FileSystemDefaultEncoding`: use :c:member:`PyConfig." +"filesystem_encoding` instead." +msgstr "" +":c:var:`!Py_FileSystemDefaultEncoding`: 請改用 :c:member:`PyConfig." +"filesystem_encoding`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:41 +#, fuzzy +msgid "" +":c:var:`!Py_HasFileSystemDefaultEncoding`: use :c:member:`PyConfig." +"filesystem_encoding` instead." +msgstr "" +":c:var:`!Py_HasFileSystemDefaultEncoding`: 請改用 :c:member:`PyConfig." +"filesystem_encoding`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:42 +#, fuzzy +msgid "" +":c:var:`!Py_FileSystemDefaultEncodeErrors`: use :c:member:`PyConfig." +"filesystem_errors` instead." +msgstr "" +":c:var:`!Py_FileSystemDefaultEncodeErrors`: 請改用 :c:member:`PyConfig." +"filesystem_errors`" + +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:43 +#, fuzzy +msgid "" +":c:var:`!Py_UTF8Mode`: use :c:member:`PyPreConfig.utf8_mode` instead. (see :" +"c:func:`Py_PreInitialize`)" +msgstr "" +":c:var:`!Py_UTF8Mode`: 請改用 :c:member:`PyPreConfig.utf8_mode`\\ （參見 :c:" +"func:`Py_PreInitialize`）" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:4 +msgid "The bundled copy of ``libmpdecimal``." +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:5 +#, fuzzy +msgid "" +":c:func:`PyImport_ImportModuleNoBlock`: use :c:func:`PyImport_ImportModule` " +"instead." msgstr "" ":c:func:`PyImport_ImportModuleNoBlock`：請改用 :c:func:" "`PyImport_ImportModule`" -#: ../../whatsnew/3.12.rst:2265 -msgid ":c:type:`!Py_UNICODE_WIDE` type: use :c:type:`wchar_t`" +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:6 +#, fuzzy +msgid "" +":c:func:`PyWeakref_GET_OBJECT`: use :c:func:`!PyWeakref_GetRef` instead." +msgstr ":c:func:`PyErr_Fetch`：請改用 :c:func:`PyErr_GetRaisedException`" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:7 +#, fuzzy +msgid ":c:func:`PyWeakref_GetObject`: use :c:func:`!PyWeakref_GetRef` instead." +msgstr ":c:func:`PyErr_Fetch`：請改用 :c:func:`PyErr_GetRaisedException`" + +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:8 +#, fuzzy +msgid ":c:type:`!Py_UNICODE_WIDE` type: use :c:type:`wchar_t` instead." msgstr ":c:type:`!Py_UNICODE_WIDE` 型別：請改用 :c:type:`wchar_t`" -#: ../../whatsnew/3.12.rst:2266 -msgid ":c:type:`Py_UNICODE` type: use :c:type:`wchar_t`" +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:9 +#, fuzzy +msgid ":c:type:`Py_UNICODE` type: use :c:type:`wchar_t` instead." msgstr ":c:type:`Py_UNICODE` 型別：請改用 :c:type:`wchar_t`" -#: ../../whatsnew/3.12.rst:2267 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:10 msgid "Python initialization functions:" msgstr "Python 初始化函式：" -#: ../../whatsnew/3.12.rst:2269 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:12 +#, fuzzy msgid "" ":c:func:`PySys_ResetWarnOptions`: clear :data:`sys.warnoptions` and :data:`!" -"warnings.filters`" +"warnings.filters` instead." msgstr "" ":c:func:`PySys_ResetWarnOptions`：清除 :data:`sys.warnoptions` 和 :data:`!" "warnings.filters`" -#: ../../whatsnew/3.12.rst:2271 -msgid ":c:func:`Py_GetExecPrefix`: get :data:`sys.exec_prefix`" +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:14 +#, fuzzy +msgid ":c:func:`Py_GetExecPrefix`: get :data:`sys.exec_prefix` instead." msgstr ":c:func:`Py_GetExecPrefix`：取得 :data:`sys.exec_prefix`" -#: ../../whatsnew/3.12.rst:2272 -msgid ":c:func:`Py_GetPath`: get :data:`sys.path`" +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:15 +#, fuzzy +msgid ":c:func:`Py_GetPath`: get :data:`sys.path` instead." msgstr ":c:func:`Py_GetPath`：取得 :data:`sys.path`" -#: ../../whatsnew/3.12.rst:2273 -msgid ":c:func:`Py_GetPrefix`: get :data:`sys.prefix`" +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:16 +#, fuzzy +msgid ":c:func:`Py_GetPrefix`: get :data:`sys.prefix` instead." msgstr ":c:func:`Py_GetPrefix`：取得 :data:`sys.prefix`" -#: ../../whatsnew/3.12.rst:2274 -msgid ":c:func:`Py_GetProgramFullPath`: get :data:`sys.executable`" +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:17 +#, fuzzy +msgid ":c:func:`Py_GetProgramFullPath`: get :data:`sys.executable` instead." msgstr ":c:func:`Py_GetProgramFullPath`：取得 :data:`sys.executable`" -#: ../../whatsnew/3.12.rst:2275 -msgid ":c:func:`Py_GetProgramName`: get :data:`sys.executable`" +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:18 +#, fuzzy +msgid ":c:func:`Py_GetProgramName`: get :data:`sys.executable` instead." msgstr ":c:func:`Py_GetProgramName`：取得 :data:`sys.executable`" -#: ../../whatsnew/3.12.rst:2276 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:19 +#, fuzzy msgid "" ":c:func:`Py_GetPythonHome`: get :c:member:`PyConfig.home` or the :envvar:" -"`PYTHONHOME` environment variable" +"`PYTHONHOME` environment variable instead." msgstr "" ":c:func:`Py_GetPythonHome`：取得 :c:member:`PyConfig.home` 或 :envvar:" "`PYTHONHOME` 環境變數" -#: ../../whatsnew/3.12.rst:2282 +#: ../../deprecations/c-api-pending-removal-in-future.rst:4 msgid "" "The following APIs are deprecated and will be removed, although there is " "currently no date scheduled for their removal." msgstr "以下 API 已棄用，且將會被移除，雖目前尚未定下移除日期。" -#: ../../whatsnew/3.12.rst:2285 -msgid ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`: unneeded since Python 3.8" +#: ../../deprecations/c-api-pending-removal-in-future.rst:7 +#, fuzzy +msgid ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`: unneeded since Python 3.8." msgstr ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`：自 Python 3.8 起不再需要" -#: ../../whatsnew/3.12.rst:2286 -msgid ":c:func:`PyErr_Fetch`: use :c:func:`PyErr_GetRaisedException`" +#: ../../deprecations/c-api-pending-removal-in-future.rst:8 +#, fuzzy +msgid ":c:func:`PyErr_Fetch`: use :c:func:`PyErr_GetRaisedException` instead." msgstr ":c:func:`PyErr_Fetch`：請改用 :c:func:`PyErr_GetRaisedException`" -#: ../../whatsnew/3.12.rst:2287 +#: ../../deprecations/c-api-pending-removal-in-future.rst:9 +#, fuzzy msgid "" -":c:func:`PyErr_NormalizeException`: use :c:func:`PyErr_GetRaisedException`" +":c:func:`PyErr_NormalizeException`: use :c:func:`PyErr_GetRaisedException` " +"instead." msgstr "" ":c:func:`PyErr_NormalizeException`：請改用 :c:func:`PyErr_GetRaisedException`" -#: ../../whatsnew/3.12.rst:2288 -msgid ":c:func:`PyErr_Restore`: use :c:func:`PyErr_SetRaisedException`" +#: ../../deprecations/c-api-pending-removal-in-future.rst:10 +#, fuzzy +msgid "" +":c:func:`PyErr_Restore`: use :c:func:`PyErr_SetRaisedException` instead." msgstr ":c:func:`PyErr_Restore`：請改用 :c:func:`PyErr_SetRaisedException`" -#: ../../whatsnew/3.12.rst:2289 +#: ../../deprecations/c-api-pending-removal-in-future.rst:11 +#, fuzzy msgid "" -":c:func:`PyModule_GetFilename`: use :c:func:`PyModule_GetFilenameObject`" +":c:func:`PyModule_GetFilename`: use :c:func:`PyModule_GetFilenameObject` " +"instead." msgstr "" ":c:func:`PyModule_GetFilename`：請改用 :c:func:`PyModule_GetFilenameObject`" -#: ../../whatsnew/3.12.rst:2290 -msgid ":c:func:`PyOS_AfterFork`: use :c:func:`PyOS_AfterFork_Child`" +#: ../../deprecations/c-api-pending-removal-in-future.rst:12 +#, fuzzy +msgid ":c:func:`PyOS_AfterFork`: use :c:func:`PyOS_AfterFork_Child` instead." msgstr ":c:func:`PyOS_AfterFork`：請改用 :c:func:`PyOS_AfterFork_Child`" -#: ../../whatsnew/3.12.rst:2291 +#: ../../deprecations/c-api-pending-removal-in-future.rst:13 +#, fuzzy msgid "" ":c:func:`PySlice_GetIndicesEx`: use :c:func:`PySlice_Unpack` and :c:func:" -"`PySlice_AdjustIndices`" +"`PySlice_AdjustIndices` instead." msgstr "" ":c:func:`PySlice_GetIndicesEx`：請改用 :c:func:`PySlice_Unpack` 和 :c:func:" "`PySlice_AdjustIndices`" -#: ../../whatsnew/3.12.rst:2292 -msgid ":c:func:`!PyUnicode_AsDecodedObject`: use :c:func:`PyCodec_Decode`" +#: ../../deprecations/c-api-pending-removal-in-future.rst:14 +#, fuzzy +msgid "" +":c:func:`!PyUnicode_AsDecodedObject`: use :c:func:`PyCodec_Decode` instead." msgstr ":c:func:`!PyUnicode_AsDecodedObject`：請改用 :c:func:`PyCodec_Decode`" -#: ../../whatsnew/3.12.rst:2293 -msgid ":c:func:`!PyUnicode_AsDecodedUnicode`: use :c:func:`PyCodec_Decode`" +#: ../../deprecations/c-api-pending-removal-in-future.rst:15 +#, fuzzy +msgid "" +":c:func:`!PyUnicode_AsDecodedUnicode`: use :c:func:`PyCodec_Decode` instead." msgstr ":c:func:`!PyUnicode_AsDecodedUnicode`：請改用 :c:func:`PyCodec_Decode`" -#: ../../whatsnew/3.12.rst:2294 -msgid ":c:func:`!PyUnicode_AsEncodedObject`: use :c:func:`PyCodec_Encode`" +#: ../../deprecations/c-api-pending-removal-in-future.rst:16 +#, fuzzy +msgid "" +":c:func:`!PyUnicode_AsEncodedObject`: use :c:func:`PyCodec_Encode` instead." msgstr ":c:func:`!PyUnicode_AsEncodedObject`：請改用 :c:func:`PyCodec_Encode`" -#: ../../whatsnew/3.12.rst:2295 -msgid ":c:func:`!PyUnicode_AsEncodedUnicode`: use :c:func:`PyCodec_Encode`" +#: ../../deprecations/c-api-pending-removal-in-future.rst:17 +#, fuzzy +msgid "" +":c:func:`!PyUnicode_AsEncodedUnicode`: use :c:func:`PyCodec_Encode` instead." msgstr ":c:func:`!PyUnicode_AsEncodedUnicode`：請改用 :c:func:`PyCodec_Encode`" -#: ../../whatsnew/3.12.rst:2296 +#: ../../deprecations/c-api-pending-removal-in-future.rst:18 msgid ":c:func:`PyUnicode_READY`: unneeded since Python 3.12" msgstr ":c:func:`PyUnicode_READY`：自 Python 3.12 起不再需要" -#: ../../whatsnew/3.12.rst:2297 -msgid ":c:func:`!PyErr_Display`: use :c:func:`PyErr_DisplayException`" +#: ../../deprecations/c-api-pending-removal-in-future.rst:19 +#, fuzzy +msgid ":c:func:`!PyErr_Display`: use :c:func:`PyErr_DisplayException` instead." msgstr ":c:func:`!PyErr_Display`：請改用 :c:func:`PyErr_DisplayException`" -#: ../../whatsnew/3.12.rst:2298 -msgid ":c:func:`!_PyErr_ChainExceptions`: use ``_PyErr_ChainExceptions1``" +#: ../../deprecations/c-api-pending-removal-in-future.rst:20 +#, fuzzy +msgid "" +":c:func:`!_PyErr_ChainExceptions`: use ``_PyErr_ChainExceptions1`` instead." msgstr ":c:func:`!_PyErr_ChainExceptions`：請改用 ``_PyErr_ChainExceptions1``" -#: ../../whatsnew/3.12.rst:2299 +#: ../../deprecations/c-api-pending-removal-in-future.rst:21 +#, fuzzy msgid "" ":c:member:`!PyBytesObject.ob_shash` member: call :c:func:`PyObject_Hash` " -"instead" +"instead." msgstr "" ":c:member:`!PyBytesObject.ob_shash` 成員：請改用 :c:func:`PyObject_Hash`" -#: ../../whatsnew/3.12.rst:2301 -msgid ":c:member:`!PyDictObject.ma_version_tag` member" +#: ../../deprecations/c-api-pending-removal-in-future.rst:23 +#, fuzzy +msgid ":c:member:`!PyDictObject.ma_version_tag` member." msgstr ":c:member:`!PyDictObject.ma_version_tag` 成員" -#: ../../whatsnew/3.12.rst:2302 +#: ../../deprecations/c-api-pending-removal-in-future.rst:24 msgid "Thread Local Storage (TLS) API:" msgstr "" -#: ../../whatsnew/3.12.rst:2304 -msgid ":c:func:`PyThread_create_key`: use :c:func:`PyThread_tss_alloc`" +#: ../../deprecations/c-api-pending-removal-in-future.rst:26 +#, fuzzy +msgid "" +":c:func:`PyThread_create_key`: use :c:func:`PyThread_tss_alloc` instead." msgstr ":c:func:`PyThread_create_key`：請改用 :c:func:`PyThread_tss_alloc`" -#: ../../whatsnew/3.12.rst:2305 -msgid ":c:func:`PyThread_delete_key`: use :c:func:`PyThread_tss_free`" +#: ../../deprecations/c-api-pending-removal-in-future.rst:27 +#, fuzzy +msgid ":c:func:`PyThread_delete_key`: use :c:func:`PyThread_tss_free` instead." msgstr ":c:func:`PyThread_delete_key`：請改用 :c:func:`PyThread_tss_free`" -#: ../../whatsnew/3.12.rst:2306 -msgid ":c:func:`PyThread_set_key_value`: use :c:func:`PyThread_tss_set`" +#: ../../deprecations/c-api-pending-removal-in-future.rst:28 +#, fuzzy +msgid "" +":c:func:`PyThread_set_key_value`: use :c:func:`PyThread_tss_set` instead." msgstr ":c:func:`PyThread_set_key_value`：請改用 :c:func:`PyThread_tss_set`" -#: ../../whatsnew/3.12.rst:2307 -msgid ":c:func:`PyThread_get_key_value`: use :c:func:`PyThread_tss_get`" +#: ../../deprecations/c-api-pending-removal-in-future.rst:29 +#, fuzzy +msgid "" +":c:func:`PyThread_get_key_value`: use :c:func:`PyThread_tss_get` instead." msgstr ":c:func:`PyThread_get_key_value`：請改用 :c:func:`PyThread_tss_get`" -#: ../../whatsnew/3.12.rst:2308 -msgid ":c:func:`PyThread_delete_key_value`: use :c:func:`PyThread_tss_delete`" +#: ../../deprecations/c-api-pending-removal-in-future.rst:30 +#, fuzzy +msgid "" +":c:func:`PyThread_delete_key_value`: use :c:func:`PyThread_tss_delete` " +"instead." msgstr "" ":c:func:`PyThread_delete_key_value`：請改用 :c:func:`PyThread_tss_delete`" -#: ../../whatsnew/3.12.rst:2309 -msgid ":c:func:`PyThread_ReInitTLS`: unneeded since Python 3.7" +#: ../../deprecations/c-api-pending-removal-in-future.rst:31 +#, fuzzy +msgid ":c:func:`PyThread_ReInitTLS`: unneeded since Python 3.7." msgstr ":c:func:`PyThread_ReInitTLS`：自 Python 3.7 起不再需要" -#: ../../whatsnew/3.12.rst:2314 +#: ../../whatsnew/3.12.rst:2235 msgid "" "Remove the :file:`token.h` header file. There was never any public tokenizer " "C API. The :file:`token.h` header file was only designed to be used by " "Python internals. (Contributed by Victor Stinner in :gh:`92651`.)" msgstr "" -#: ../../whatsnew/3.12.rst:2319 +#: ../../whatsnew/3.12.rst:2240 msgid "Legacy Unicode APIs have been removed. See :pep:`623` for detail." msgstr "" -#: ../../whatsnew/3.12.rst:2321 +#: ../../whatsnew/3.12.rst:2242 msgid ":c:macro:`!PyUnicode_WCHAR_KIND`" msgstr ":c:macro:`!PyUnicode_WCHAR_KIND`" -#: ../../whatsnew/3.12.rst:2322 +#: ../../whatsnew/3.12.rst:2243 msgid ":c:func:`!PyUnicode_AS_UNICODE`" msgstr ":c:func:`!PyUnicode_AS_UNICODE`" -#: ../../whatsnew/3.12.rst:2323 +#: ../../whatsnew/3.12.rst:2244 msgid ":c:func:`!PyUnicode_AsUnicode`" msgstr ":c:func:`!PyUnicode_AsUnicode`" -#: ../../whatsnew/3.12.rst:2324 +#: ../../whatsnew/3.12.rst:2245 msgid ":c:func:`!PyUnicode_AsUnicodeAndSize`" msgstr ":c:func:`!PyUnicode_AsUnicodeAndSize`" -#: ../../whatsnew/3.12.rst:2325 +#: ../../whatsnew/3.12.rst:2246 msgid ":c:func:`!PyUnicode_AS_DATA`" msgstr ":c:func:`!PyUnicode_AS_DATA`" -#: ../../whatsnew/3.12.rst:2326 +#: ../../whatsnew/3.12.rst:2247 msgid ":c:func:`!PyUnicode_FromUnicode`" msgstr ":c:func:`!PyUnicode_FromUnicode`" -#: ../../whatsnew/3.12.rst:2327 +#: ../../whatsnew/3.12.rst:2248 msgid ":c:func:`!PyUnicode_GET_SIZE`" msgstr ":c:func:`!PyUnicode_GET_SIZE`" -#: ../../whatsnew/3.12.rst:2328 +#: ../../whatsnew/3.12.rst:2249 msgid ":c:func:`!PyUnicode_GetSize`" msgstr ":c:func:`!PyUnicode_GetSize`" -#: ../../whatsnew/3.12.rst:2329 +#: ../../whatsnew/3.12.rst:2250 msgid ":c:func:`!PyUnicode_GET_DATA_SIZE`" msgstr ":c:func:`!PyUnicode_GET_DATA_SIZE`" -#: ../../whatsnew/3.12.rst:2331 +#: ../../whatsnew/3.12.rst:2252 msgid "" "Remove the ``PyUnicode_InternImmortal()`` function macro. (Contributed by " "Victor Stinner in :gh:`85858`.)" @@ -4600,15 +4842,15 @@ msgstr "" "移除 ``PyUnicode_InternImmortal()`` 函式巨集。（由 Victor Stinner 於 :gh:" "`85858` 中貢獻。）" -#: ../../whatsnew/3.12.rst:2335 +#: ../../whatsnew/3.12.rst:2256 msgid "Notable changes in 3.12.4" msgstr "3.12.4 中的明顯變更" -#: ../../whatsnew/3.12.rst:2338 +#: ../../whatsnew/3.12.rst:2259 msgid "ipaddress" msgstr "ipaddress" -#: ../../whatsnew/3.12.rst:2340 +#: ../../whatsnew/3.12.rst:2261 msgid "" "Fixed ``is_global`` and ``is_private`` behavior in ``IPv4Address``, " "``IPv6Address``, ``IPv4Network`` and ``IPv6Network``." From 48eade72a337d695523517301888f57aefcc7aff Mon Sep 17 00:00:00 2001 From: Matt Wang Date: Wed, 31 Jul 2024 14:02:13 +0800 Subject: [PATCH 13/28] chore: translate deprecations/index --- deprecations/index.po | 335 +++++++++++++++++++++++++----------------- 1 file changed, 198 insertions(+), 137 deletions(-) diff --git a/deprecations/index.po b/deprecations/index.po index 3a2f9977ee..d1912b292a 100644 --- a/deprecations/index.po +++ b/deprecations/index.po @@ -19,171 +19,171 @@ msgstr "" #: ../../deprecations/index.rst:2 msgid "Deprecations" -msgstr "" +msgstr "已棄用項目" #: ../../deprecations/pending-removal-in-3.13.rst:2 msgid "Pending Removal in Python 3.13" -msgstr "" +msgstr "Python 3.13 中待移除的項目" #: ../../deprecations/pending-removal-in-3.13.rst:4 msgid "Modules (see :pep:`594`):" -msgstr "" +msgstr "模組（請見 :pep:`594`）：" #: ../../deprecations/pending-removal-in-3.13.rst:6 msgid ":mod:`aifc`" -msgstr "" +msgstr ":mod:`aifc`" #: ../../deprecations/pending-removal-in-3.13.rst:7 msgid ":mod:`audioop`" -msgstr "" +msgstr ":mod:`audioop`" #: ../../deprecations/pending-removal-in-3.13.rst:8 msgid ":mod:`cgi`" -msgstr "" +msgstr ":mod:`cgi`" #: ../../deprecations/pending-removal-in-3.13.rst:9 msgid ":mod:`cgitb`" -msgstr "" +msgstr ":mod:`cgitb`" #: ../../deprecations/pending-removal-in-3.13.rst:10 msgid ":mod:`chunk`" -msgstr "" +msgstr ":mod:`chunk`" #: ../../deprecations/pending-removal-in-3.13.rst:11 msgid ":mod:`crypt`" -msgstr "" +msgstr ":mod:`crypt`" #: ../../deprecations/pending-removal-in-3.13.rst:12 msgid ":mod:`imghdr`" -msgstr "" +msgstr ":mod:`imghdr`" #: ../../deprecations/pending-removal-in-3.13.rst:13 msgid ":mod:`mailcap`" -msgstr "" +msgstr ":mod:`mailcap`" #: ../../deprecations/pending-removal-in-3.13.rst:14 msgid ":mod:`msilib`" -msgstr "" +msgstr ":mod:`msilib`" #: ../../deprecations/pending-removal-in-3.13.rst:15 msgid ":mod:`nis`" -msgstr "" +msgstr ":mod:`nis`" #: ../../deprecations/pending-removal-in-3.13.rst:16 msgid ":mod:`nntplib`" -msgstr "" +msgstr ":mod:`nntplib`" #: ../../deprecations/pending-removal-in-3.13.rst:17 msgid ":mod:`ossaudiodev`" -msgstr "" +msgstr ":mod:`ossaudiodev`" #: ../../deprecations/pending-removal-in-3.13.rst:18 msgid ":mod:`pipes`" -msgstr "" +msgstr ":mod:`pipes`" #: ../../deprecations/pending-removal-in-3.13.rst:19 msgid ":mod:`sndhdr`" -msgstr "" +msgstr ":mod:`sndhdr`" #: ../../deprecations/pending-removal-in-3.13.rst:20 msgid ":mod:`spwd`" -msgstr "" +msgstr ":mod:`spwd`" #: ../../deprecations/pending-removal-in-3.13.rst:21 msgid ":mod:`sunau`" -msgstr "" +msgstr ":mod:`sunau`" #: ../../deprecations/pending-removal-in-3.13.rst:22 msgid ":mod:`telnetlib`" -msgstr "" +msgstr ":mod:`telnetlib`" #: ../../deprecations/pending-removal-in-3.13.rst:23 msgid ":mod:`uu`" -msgstr "" +msgstr ":mod:`uu`" #: ../../deprecations/pending-removal-in-3.13.rst:24 msgid ":mod:`xdrlib`" -msgstr "" +msgstr ":mod:`xdrlib`" #: ../../deprecations/pending-removal-in-3.13.rst:26 msgid "Other modules:" -msgstr "" +msgstr "其他模組：" #: ../../deprecations/pending-removal-in-3.13.rst:28 msgid ":mod:`!lib2to3`, and the :program:`2to3` program (:gh:`84540`)" -msgstr "" +msgstr ":mod:`!lib2to3` 和 :program:`2to3` 程式 (:gh:`84540`)" #: ../../deprecations/pending-removal-in-3.13.rst:30 msgid "APIs:" -msgstr "" +msgstr "API：" #: ../../deprecations/pending-removal-in-3.13.rst:32 msgid ":class:`!configparser.LegacyInterpolation` (:gh:`90765`)" -msgstr "" +msgstr ":class:`!configparser.LegacyInterpolation` (:gh:`90765`)" #: ../../deprecations/pending-removal-in-3.13.rst:33 msgid "``locale.resetlocale()`` (:gh:`90817`)" -msgstr "" +msgstr "``locale.resetlocale()`` (:gh:`90817`)" #: ../../deprecations/pending-removal-in-3.13.rst:34 msgid ":meth:`!turtle.RawTurtle.settiltangle` (:gh:`50096`)" -msgstr "" +msgstr ":meth:`!turtle.RawTurtle.settiltangle` (:gh:`50096`)" #: ../../deprecations/pending-removal-in-3.13.rst:35 msgid ":func:`!unittest.findTestCases` (:gh:`50096`)" -msgstr "" +msgstr ":func:`!unittest.findTestCases` (:gh:`50096`)" #: ../../deprecations/pending-removal-in-3.13.rst:36 msgid ":func:`!unittest.getTestCaseNames` (:gh:`50096`)" -msgstr "" +msgstr ":func:`!unittest.getTestCaseNames` (:gh:`50096`)" #: ../../deprecations/pending-removal-in-3.13.rst:37 msgid ":func:`!unittest.makeSuite` (:gh:`50096`)" -msgstr "" +msgstr ":func:`!unittest.makeSuite` (:gh:`50096`)" #: ../../deprecations/pending-removal-in-3.13.rst:38 msgid ":meth:`!unittest.TestProgram.usageExit` (:gh:`67048`)" -msgstr "" +msgstr ":meth:`!unittest.TestProgram.usageExit` (:gh:`67048`)" #: ../../deprecations/pending-removal-in-3.13.rst:39 msgid ":class:`!webbrowser.MacOSX` (:gh:`86421`)" -msgstr "" +msgstr ":class:`!webbrowser.MacOSX` (:gh:`86421`)" #: ../../deprecations/pending-removal-in-3.13.rst:40 msgid ":class:`classmethod` descriptor chaining (:gh:`89519`)" -msgstr "" +msgstr ":class:`classmethod` 描述器鏈接 (:gh:`89519`)" #: ../../deprecations/pending-removal-in-3.13.rst:41 msgid ":mod:`importlib.resources` deprecated methods:" -msgstr "" +msgstr ":mod:`importlib.resources` 的已棄用方法：" #: ../../deprecations/pending-removal-in-3.13.rst:43 msgid "``contents()``" -msgstr "" +msgstr "``contents()``" #: ../../deprecations/pending-removal-in-3.13.rst:44 msgid "``is_resource()``" -msgstr "" +msgstr "``is_resource()``" #: ../../deprecations/pending-removal-in-3.13.rst:45 msgid "``open_binary()``" -msgstr "" +msgstr "``open_binary()``" #: ../../deprecations/pending-removal-in-3.13.rst:46 msgid "``open_text()``" -msgstr "" +msgstr "``open_text()``" #: ../../deprecations/pending-removal-in-3.13.rst:47 msgid "``path()``" -msgstr "" +msgstr "``path()``" #: ../../deprecations/pending-removal-in-3.13.rst:48 msgid "``read_binary()``" -msgstr "" +msgstr "``read_binary()``" #: ../../deprecations/pending-removal-in-3.13.rst:49 msgid "``read_text()``" -msgstr "" +msgstr "``read_text()``" #: ../../deprecations/pending-removal-in-3.13.rst:51 msgid "" @@ -195,7 +195,7 @@ msgstr "" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:2 #: ../../deprecations/pending-removal-in-3.14.rst:2 msgid "Pending Removal in Python 3.14" -msgstr "" +msgstr "Python 3.14 中待移除的項目" #: ../../deprecations/pending-removal-in-3.14.rst:4 msgid "" @@ -213,33 +213,34 @@ msgstr "" #: ../../deprecations/pending-removal-in-3.14.rst:13 msgid ":class:`!ast.Num`" -msgstr "" +msgstr ":class:`!ast.Num`" #: ../../deprecations/pending-removal-in-3.14.rst:14 msgid ":class:`!ast.Str`" -msgstr "" +msgstr ":class:`!ast.Str`" #: ../../deprecations/pending-removal-in-3.14.rst:15 msgid ":class:`!ast.Bytes`" -msgstr "" +msgstr ":class:`!ast.Bytes`" #: ../../deprecations/pending-removal-in-3.14.rst:16 msgid ":class:`!ast.NameConstant`" -msgstr "" +msgstr ":class:`!ast.NameConstant`" #: ../../deprecations/pending-removal-in-3.14.rst:17 msgid ":class:`!ast.Ellipsis`" -msgstr "" +msgstr ":class:`!ast.Ellipsis`" #: ../../deprecations/pending-removal-in-3.14.rst:19 msgid "" "Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka in :gh:" "`90953`.)" msgstr "" +"請改用 :class:`ast.Constant`。（由 Serhiy Storchaka 貢獻於 :gh:`90953`。）" #: ../../deprecations/pending-removal-in-3.14.rst:22 msgid ":mod:`asyncio`:" -msgstr "" +msgstr ":mod:`asyncio`：" #: ../../deprecations/pending-removal-in-3.14.rst:24 msgid "" @@ -287,35 +288,35 @@ msgstr "" #: ../../deprecations/pending-removal-in-3.14.rst:53 msgid ":mod:`importlib.abc` deprecated classes:" -msgstr "" +msgstr ":mod:`importlib.abc` 的已棄用類別：" #: ../../deprecations/pending-removal-in-3.14.rst:55 msgid ":class:`!importlib.abc.ResourceReader`" -msgstr "" +msgstr ":class:`!importlib.abc.ResourceReader`" #: ../../deprecations/pending-removal-in-3.14.rst:56 msgid ":class:`!importlib.abc.Traversable`" -msgstr "" +msgstr ":class:`!importlib.abc.Traversable`" #: ../../deprecations/pending-removal-in-3.14.rst:57 msgid ":class:`!importlib.abc.TraversableResources`" -msgstr "" +msgstr ":class:`!importlib.abc.TraversableResources`" #: ../../deprecations/pending-removal-in-3.14.rst:59 msgid "Use :mod:`importlib.resources.abc` classes instead:" -msgstr "" +msgstr "請改用 :mod:`importlib.resources.abc` 類別：" #: ../../deprecations/pending-removal-in-3.14.rst:61 msgid ":class:`importlib.resources.abc.Traversable`" -msgstr "" +msgstr ":class:`importlib.resources.abc.Traversable`" #: ../../deprecations/pending-removal-in-3.14.rst:62 msgid ":class:`importlib.resources.abc.TraversableResources`" -msgstr "" +msgstr ":class:`importlib.resources.abc.TraversableResources`" #: ../../deprecations/pending-removal-in-3.14.rst:64 msgid "(Contributed by Jason R. Coombs and Hugo van Kemenade in :gh:`93963`.)" -msgstr "" +msgstr "（由 Jason R. Coombs 和 Hugo van Kemenade 貢獻於 :gh:`93963`。）" #: ../../deprecations/pending-removal-in-3.14.rst:66 msgid "" @@ -351,23 +352,23 @@ msgstr "" #: ../../deprecations/pending-removal-in-3.14.rst:89 msgid ":mod:`pty`:" -msgstr "" +msgstr ":mod:`pty`：" #: ../../deprecations/pending-removal-in-3.14.rst:91 msgid "``master_open()``: use :func:`pty.openpty`." -msgstr "" +msgstr "``master_open()``：請用 :func:`pty.openpty`。" #: ../../deprecations/pending-removal-in-3.14.rst:92 msgid "``slave_open()``: use :func:`pty.openpty`." -msgstr "" +msgstr "``slave_open()``：請用 :func:`pty.openpty`。" #: ../../deprecations/pending-removal-in-3.14.rst:94 msgid ":mod:`sqlite3`:" -msgstr "" +msgstr ":mod:`sqlite3`：" #: ../../deprecations/pending-removal-in-3.14.rst:96 msgid ":data:`~sqlite3.version` and :data:`~sqlite3.version_info`." -msgstr "" +msgstr ":data:`~sqlite3.version` 和 :data:`~sqlite3.version_info`。" #: ../../deprecations/pending-removal-in-3.14.rst:98 msgid "" @@ -406,7 +407,7 @@ msgstr "" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:2 #: ../../deprecations/pending-removal-in-3.15.rst:2 msgid "Pending Removal in Python 3.15" -msgstr "" +msgstr "Python 3.15 中待移除的項目" #: ../../deprecations/pending-removal-in-3.15.rst:4 msgid "" @@ -450,7 +451,7 @@ msgstr "" #: ../../deprecations/pending-removal-in-3.15.rst:34 msgid ":class:`typing.NamedTuple`:" -msgstr "" +msgstr ":class:`typing.NamedTuple`：" #: ../../deprecations/pending-removal-in-3.15.rst:36 msgid "" @@ -491,7 +492,7 @@ msgstr "" #: ../../deprecations/pending-removal-in-3.16.rst:2 msgid "Pending Removal in Python 3.16" -msgstr "" +msgstr "Python 3.16 中待移除的項目" #: ../../deprecations/pending-removal-in-3.16.rst:4 msgid "" @@ -508,7 +509,7 @@ msgstr "" #: ../../deprecations/c-api-pending-removal-in-future.rst:2 #: ../../deprecations/pending-removal-in-future.rst:2 msgid "Pending Removal in Future Versions" -msgstr "" +msgstr "未來版本中的待移除項目" #: ../../deprecations/pending-removal-in-future.rst:4 msgid "" @@ -524,11 +525,11 @@ msgstr "" #: ../../deprecations/pending-removal-in-future.rst:10 msgid ":mod:`array`'s ``'u'`` format code (:gh:`57281`)" -msgstr "" +msgstr ":mod:`array` 的 ``'u'`` 格式碼 (:gh:`57281`)" #: ../../deprecations/pending-removal-in-future.rst:12 msgid ":mod:`builtins`:" -msgstr "" +msgstr ":mod:`builtins`：" #: ../../deprecations/pending-removal-in-future.rst:14 msgid "``~bool``, bitwise inversion on bool." @@ -536,7 +537,7 @@ msgstr "" #: ../../deprecations/pending-removal-in-future.rst:15 msgid "``bool(NotImplemented)``." -msgstr "" +msgstr "``bool(NotImplemented)``。" #: ../../deprecations/pending-removal-in-future.rst:16 msgid "" @@ -602,34 +603,39 @@ msgid "" ":attr:`codeobject.co_lnotab`: use the :meth:`codeobject.co_lines` method " "instead." msgstr "" +":attr:`codeobject.co_lnotab`：請改用 :meth:`codeobject.co_lines` 方法。" #: ../../deprecations/pending-removal-in-future.rst:50 msgid ":mod:`datetime`:" -msgstr "" +msgstr ":mod:`datetime`：" #: ../../deprecations/pending-removal-in-future.rst:52 msgid "" ":meth:`~datetime.datetime.utcnow`: use ``datetime.datetime.now(tz=datetime." "UTC)``." msgstr "" +":meth:`~datetime.datetime.utcnow`：請改用 ``datetime.datetime." +"now(tz=datetime.UTC)``。" #: ../../deprecations/pending-removal-in-future.rst:54 msgid "" ":meth:`~datetime.datetime.utcfromtimestamp`: use ``datetime.datetime." "fromtimestamp(timestamp, tz=datetime.UTC)``." msgstr "" +":meth:`~datetime.datetime.utcfromtimestamp`：請改用 ``datetime.datetime." +"fromtimestamp(timestamp, tz=datetime.UTC)``。" #: ../../deprecations/pending-removal-in-future.rst:57 msgid ":mod:`gettext`: Plural value must be an integer." -msgstr "" +msgstr ":mod:`gettext`：複數值必須是整數。" #: ../../deprecations/pending-removal-in-future.rst:59 msgid ":mod:`importlib`:" -msgstr "" +msgstr ":mod:`importlib`：" #: ../../deprecations/pending-removal-in-future.rst:61 msgid "``load_module()`` method: use ``exec_module()`` instead." -msgstr "" +msgstr "``load_module()`` method：請改用 ``exec_module()``。" #: ../../deprecations/pending-removal-in-future.rst:62 msgid "" @@ -639,7 +645,7 @@ msgstr "" #: ../../deprecations/pending-removal-in-future.rst:65 msgid ":mod:`importlib.metadata`:" -msgstr "" +msgstr ":mod:`importlib.metadata`：" #: ../../deprecations/pending-removal-in-future.rst:67 msgid "``EntryPoints`` tuple interface." @@ -658,7 +664,7 @@ msgstr "" #: ../../deprecations/pending-removal-in-future.rst:73 msgid "" ":mod:`os`: Calling :func:`os.register_at_fork` in multi-threaded process." -msgstr "" +msgstr ":mod:`os`：在多執行緒行程中呼叫 :func:`os.register_at_fork`。" #: ../../deprecations/pending-removal-in-future.rst:75 msgid "" @@ -678,111 +684,123 @@ msgstr "" #: ../../deprecations/pending-removal-in-future.rst:85 msgid "" ":mod:`!sre_compile`, :mod:`!sre_constants` and :mod:`!sre_parse` modules." -msgstr "" +msgstr ":mod:`!sre_compile`、:mod:`!sre_constants` 和 :mod:`!sre_parse` 模組。" #: ../../deprecations/pending-removal-in-future.rst:87 msgid "" ":mod:`shutil`: :func:`~shutil.rmtree`'s *onerror* parameter is deprecated in " "Python 3.12; use the *onexc* parameter instead." msgstr "" +":mod:`shutil`：:func:`~shutil.rmtree` 的 *onerror* 參數在 Python 3.12 中已被" +"棄用；請改用 *onexc* 參數。" #: ../../deprecations/pending-removal-in-future.rst:90 msgid ":mod:`ssl` options and protocols:" -msgstr "" +msgstr ":mod:`ssl` 選項和協定：" #: ../../deprecations/pending-removal-in-future.rst:92 msgid ":class:`ssl.SSLContext` without protocol argument is deprecated." -msgstr "" +msgstr "不帶協定引數的 :class:`ssl.SSLContext` 已被棄用。" #: ../../deprecations/pending-removal-in-future.rst:93 msgid "" ":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` and :meth:" "`!selected_npn_protocol` are deprecated: use ALPN instead." msgstr "" +":class:`ssl.SSLContext`：:meth:`~ssl.SSLContext.set_npn_protocols` 和 :meth:" +"`!selected_npn_protocol` 已被棄用：請改用 ALPN。" #: ../../deprecations/pending-removal-in-future.rst:96 msgid "``ssl.OP_NO_SSL*`` options" -msgstr "" +msgstr "``ssl.OP_NO_SSL*`` 選項" #: ../../deprecations/pending-removal-in-future.rst:97 msgid "``ssl.OP_NO_TLS*`` options" -msgstr "" +msgstr "``ssl.OP_NO_TLS*`` 選項" #: ../../deprecations/pending-removal-in-future.rst:98 msgid "``ssl.PROTOCOL_SSLv3``" -msgstr "" +msgstr "``ssl.PROTOCOL_SSLv3``" #: ../../deprecations/pending-removal-in-future.rst:99 msgid "``ssl.PROTOCOL_TLS``" -msgstr "" +msgstr "``ssl.PROTOCOL_TLS``" #: ../../deprecations/pending-removal-in-future.rst:100 msgid "``ssl.PROTOCOL_TLSv1``" -msgstr "" +msgstr "``ssl.PROTOCOL_TLSv1``" #: ../../deprecations/pending-removal-in-future.rst:101 msgid "``ssl.PROTOCOL_TLSv1_1``" -msgstr "" +msgstr "``ssl.PROTOCOL_TLSv1_1``" #: ../../deprecations/pending-removal-in-future.rst:102 msgid "``ssl.PROTOCOL_TLSv1_2``" -msgstr "" +msgstr "``ssl.PROTOCOL_TLSv1_2``" #: ../../deprecations/pending-removal-in-future.rst:103 msgid "``ssl.TLSVersion.SSLv3``" -msgstr "" +msgstr "``ssl.TLSVersion.SSLv3``" #: ../../deprecations/pending-removal-in-future.rst:104 msgid "``ssl.TLSVersion.TLSv1``" -msgstr "" +msgstr "``ssl.TLSVersion.TLSv1``" #: ../../deprecations/pending-removal-in-future.rst:105 msgid "``ssl.TLSVersion.TLSv1_1``" -msgstr "" +msgstr "``ssl.TLSVersion.TLSv1_1``" #: ../../deprecations/pending-removal-in-future.rst:107 msgid "" ":func:`sysconfig.is_python_build` *check_home* parameter is deprecated and " "ignored." msgstr "" +":func:`sysconfig.is_python_build` 的 *check_home* 參數已被棄用並被忽略。" #: ../../deprecations/pending-removal-in-future.rst:110 msgid ":mod:`threading` methods:" -msgstr "" +msgstr ":mod:`threading` 方法：" #: ../../deprecations/pending-removal-in-future.rst:112 msgid "" ":meth:`!threading.Condition.notifyAll`: use :meth:`~threading.Condition." "notify_all`." msgstr "" +":meth:`!threading.Condition.notifyAll`：請用 :meth:`~threading.Condition." +"notify_all`。" #: ../../deprecations/pending-removal-in-future.rst:113 msgid ":meth:`!threading.Event.isSet`: use :meth:`~threading.Event.is_set`." -msgstr "" +msgstr ":meth:`!threading.Event.isSet`：請用 :meth:`~threading.Event.is_set`。" #: ../../deprecations/pending-removal-in-future.rst:114 msgid "" ":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: use :" "attr:`threading.Thread.daemon` attribute." msgstr "" +":meth:`!threading.Thread.isDaemon`、:meth:`threading.Thread.setDaemon`：請" +"用 :attr:`threading.Thread.daemon` 屬性。" #: ../../deprecations/pending-removal-in-future.rst:116 msgid "" ":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: use :" "attr:`threading.Thread.name` attribute." msgstr "" +":meth:`!threading.Thread.getName`、:meth:`threading.Thread.setName`：請用 :" +"attr:`threading.Thread.name` 屬性。" #: ../../deprecations/pending-removal-in-future.rst:118 msgid ":meth:`!threading.currentThread`: use :meth:`threading.current_thread`." msgstr "" +":meth:`!threading.currentThread`：請用 :meth:`threading.current_thread`。" #: ../../deprecations/pending-removal-in-future.rst:119 msgid ":meth:`!threading.activeCount`: use :meth:`threading.active_count`." -msgstr "" +msgstr ":meth:`!threading.activeCount`：請用 :meth:`threading.active_count`。" #: ../../deprecations/pending-removal-in-future.rst:121 msgid ":class:`typing.Text` (:gh:`92332`)." -msgstr "" +msgstr ":class:`typing.Text` (:gh:`92332`)。" #: ../../deprecations/pending-removal-in-future.rst:123 msgid "" @@ -798,47 +816,47 @@ msgstr "" #: ../../deprecations/pending-removal-in-future.rst:128 msgid "``splitattr()``" -msgstr "" +msgstr "``splitattr()``" #: ../../deprecations/pending-removal-in-future.rst:129 msgid "``splithost()``" -msgstr "" +msgstr "``splithost()``" #: ../../deprecations/pending-removal-in-future.rst:130 msgid "``splitnport()``" -msgstr "" +msgstr "``splitnport()``" #: ../../deprecations/pending-removal-in-future.rst:131 msgid "``splitpasswd()``" -msgstr "" +msgstr "``splitpasswd()``" #: ../../deprecations/pending-removal-in-future.rst:132 msgid "``splitport()``" -msgstr "" +msgstr "``splitport()``" #: ../../deprecations/pending-removal-in-future.rst:133 msgid "``splitquery()``" -msgstr "" +msgstr "``splitquery()``" #: ../../deprecations/pending-removal-in-future.rst:134 msgid "``splittag()``" -msgstr "" +msgstr "``splittag()``" #: ../../deprecations/pending-removal-in-future.rst:135 msgid "``splittype()``" -msgstr "" +msgstr "``splittype()``" #: ../../deprecations/pending-removal-in-future.rst:136 msgid "``splituser()``" -msgstr "" +msgstr "``splituser()``" #: ../../deprecations/pending-removal-in-future.rst:137 msgid "``splitvalue()``" -msgstr "" +msgstr "``splitvalue()``" #: ../../deprecations/pending-removal-in-future.rst:138 msgid "``to_bytes()``" -msgstr "" +msgstr "``to_bytes()``" #: ../../deprecations/pending-removal-in-future.rst:140 msgid "" @@ -851,7 +869,7 @@ msgstr "" msgid "" ":mod:`wsgiref`: ``SimpleHandler.stdout.write()`` should not do partial " "writes." -msgstr "" +msgstr ":mod:`wsgiref`：``SimpleHandler.stdout.write()`` 不應該進行部分寫入。" #: ../../deprecations/pending-removal-in-future.rst:147 msgid "" @@ -869,13 +887,15 @@ msgstr "" #: ../../deprecations/index.rst:15 msgid "C API Deprecations" -msgstr "" +msgstr "C API 的棄用項目" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:4 msgid "" "The ``ma_version_tag`` field in :c:type:`PyDictObject` for extension modules " "(:pep:`699`; :gh:`101193`)." msgstr "" +":c:type:`PyDictObject` 中的 ``ma_version_tag`` 欄位，用於擴充模組 (:pep:" +"`699`；:gh:`101193`)。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:7 msgid "" @@ -886,23 +906,24 @@ msgstr "" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:10 msgid "" "Functions to configure Python's initialization, deprecated in Python 3.11:" -msgstr "" +msgstr "設定 Python 初始化的函式，Python 3.11 中已被棄用：" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:12 msgid "``PySys_SetArgvEx()``: set :c:member:`PyConfig.argv` instead." -msgstr "" +msgstr "``PySys_SetArgvEx()``：請改以 :c:member:`PyConfig.argv` 設定。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:13 msgid "``PySys_SetArgv()``: set :c:member:`PyConfig.argv` instead." -msgstr "" +msgstr "``PySys_SetArgv()``：請改以 :c:member:`PyConfig.argv` 設定。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:14 msgid "``Py_SetProgramName()``: set :c:member:`PyConfig.program_name` instead." msgstr "" +"``Py_SetProgramName()``：請改以 :c:member:`PyConfig.program_name` 設定。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:15 msgid "``Py_SetPythonHome()``: set :c:member:`PyConfig.home` instead." -msgstr "" +msgstr "``Py_SetPythonHome()``：請改以 :c:member:`PyConfig.home` 設定。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:17 #: ../../deprecations/c-api-pending-removal-in-3.14.rst:45 @@ -910,121 +931,146 @@ msgid "" "The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" "`PyConfig` instead." msgstr "" +":c:func:`Py_InitializeFromConfig` API 應該與 :c:type:`PyConfig` 一起使用。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:20 msgid "Global configuration variables:" -msgstr "" +msgstr "全域設定變數：" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:22 msgid ":c:var:`Py_DebugFlag`: use :c:member:`PyConfig.parser_debug` instead." -msgstr "" +msgstr ":c:var:`Py_DebugFlag`：請改用 :c:member:`PyConfig.parser_debug`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:23 msgid ":c:var:`Py_VerboseFlag`: use :c:member:`PyConfig.verbose` instead." -msgstr "" +msgstr ":c:var:`Py_VerboseFlag`：請改用 :c:member:`PyConfig.verbose`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:24 msgid ":c:var:`Py_QuietFlag`: use :c:member:`PyConfig.quiet` instead." -msgstr "" +msgstr ":c:var:`Py_QuietFlag`：請改用 :c:member:`PyConfig.quiet`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:25 msgid "" ":c:var:`Py_InteractiveFlag`: use :c:member:`PyConfig.interactive` instead." -msgstr "" +msgstr ":c:var:`Py_InteractiveFlag`：請改用 :c:member:`PyConfig.interactive`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:26 msgid ":c:var:`Py_InspectFlag`: use :c:member:`PyConfig.inspect` instead." -msgstr "" +msgstr ":c:var:`Py_InspectFlag`：請改用 :c:member:`PyConfig.inspect`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:27 msgid "" ":c:var:`Py_OptimizeFlag`: use :c:member:`PyConfig.optimization_level` " "instead." msgstr "" +":c:var:`Py_OptimizeFlag`：請改用 :c:member:`PyConfig.optimization_level`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:28 msgid ":c:var:`Py_NoSiteFlag`: use :c:member:`PyConfig.site_import` instead." -msgstr "" +msgstr ":c:var:`Py_NoSiteFlag`：請改用 :c:member:`PyConfig.site_import`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:29 msgid "" ":c:var:`Py_BytesWarningFlag`: use :c:member:`PyConfig.bytes_warning` instead." msgstr "" +":c:var:`Py_BytesWarningFlag`：請改用 :c:member:`PyConfig.bytes_warning`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:30 msgid "" ":c:var:`Py_FrozenFlag`: use :c:member:`PyConfig.pathconfig_warnings` instead." msgstr "" +":c:var:`Py_FrozenFlag`：請改用 :c:member:`PyConfig.pathconfig_warnings`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:31 msgid "" ":c:var:`Py_IgnoreEnvironmentFlag`: use :c:member:`PyConfig.use_environment` " "instead." msgstr "" +":c:var:`Py_IgnoreEnvironmentFlag`：請改用 :c:member:`PyConfig." +"use_environment`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:32 msgid "" ":c:var:`Py_DontWriteBytecodeFlag`: use :c:member:`PyConfig.write_bytecode` " "instead." msgstr "" +":c:var:`Py_DontWriteBytecodeFlag`：請改用 :c:member:`PyConfig." +"write_bytecode`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:33 msgid "" ":c:var:`Py_NoUserSiteDirectory`: use :c:member:`PyConfig." "user_site_directory` instead." msgstr "" +":c:var:`Py_NoUserSiteDirectory`：請改用 :c:member:`PyConfig." +"user_site_directory`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:34 msgid "" ":c:var:`Py_UnbufferedStdioFlag`: use :c:member:`PyConfig.buffered_stdio` " "instead." msgstr "" +":c:var:`Py_UnbufferedStdioFlag`：請改用 :c:member:`PyConfig.buffered_stdio`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:35 msgid "" ":c:var:`Py_HashRandomizationFlag`: use :c:member:`PyConfig.use_hash_seed` " "and :c:member:`PyConfig.hash_seed` instead." msgstr "" +":c:var:`Py_HashRandomizationFlag`：請改用 :c:member:`PyConfig.use_hash_seed` " +"和 :c:member:`PyConfig.hash_seed`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:37 msgid ":c:var:`Py_IsolatedFlag`: use :c:member:`PyConfig.isolated` instead." -msgstr "" +msgstr ":c:var:`Py_IsolatedFlag`：請改用 :c:member:`PyConfig.isolated`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:38 msgid "" ":c:var:`Py_LegacyWindowsFSEncodingFlag`: use :c:member:`PyPreConfig." "legacy_windows_fs_encoding` instead." msgstr "" +":c:var:`Py_LegacyWindowsFSEncodingFlag`：請改用 :c:member:`PyPreConfig." +"legacy_windows_fs_encoding`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:39 msgid "" ":c:var:`Py_LegacyWindowsStdioFlag`: use :c:member:`PyConfig." "legacy_windows_stdio` instead." msgstr "" +":c:var:`Py_LegacyWindowsStdioFlag`：請改用 :c:member:`PyConfig." +"legacy_windows_stdio`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:40 msgid "" ":c:var:`!Py_FileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding` instead." msgstr "" +":c:var:`!Py_FileSystemDefaultEncoding`：請改用 :c:member:`PyConfig." +"filesystem_encoding`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:41 msgid "" ":c:var:`!Py_HasFileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding` instead." msgstr "" +":c:var:`!Py_HasFileSystemDefaultEncoding`：請改用 :c:member:`PyConfig." +"filesystem_encoding`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:42 msgid "" ":c:var:`!Py_FileSystemDefaultEncodeErrors`: use :c:member:`PyConfig." "filesystem_errors` instead." msgstr "" +":c:var:`!Py_FileSystemDefaultEncodeErrors`：請改用 :c:member:`PyConfig." +"filesystem_errors`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:43 msgid "" ":c:var:`!Py_UTF8Mode`: use :c:member:`PyPreConfig.utf8_mode` instead. (see :" "c:func:`Py_PreInitialize`)" msgstr "" +":c:var:`!Py_UTF8Mode`：請改用 :c:member:`PyPreConfig.utf8_mode`。（請見 :c:" +"func:`Py_PreInitialize`）" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:4 msgid "The bundled copy of ``libmpdecimal``." @@ -1035,27 +1081,29 @@ msgid "" ":c:func:`PyImport_ImportModuleNoBlock`: use :c:func:`PyImport_ImportModule` " "instead." msgstr "" +":c:func:`PyImport_ImportModuleNoBlock`：請改用 :c:func:" +"`PyImport_ImportModule`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:6 msgid "" ":c:func:`PyWeakref_GET_OBJECT`: use :c:func:`!PyWeakref_GetRef` instead." -msgstr "" +msgstr ":c:func:`PyWeakref_GET_OBJECT`：請改用 :c:func:`!PyWeakref_GetRef`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:7 msgid ":c:func:`PyWeakref_GetObject`: use :c:func:`!PyWeakref_GetRef` instead." -msgstr "" +msgstr ":c:func:`PyWeakref_GetObject`：請改用 :c:func:`!PyWeakref_GetRef`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:8 msgid ":c:type:`!Py_UNICODE_WIDE` type: use :c:type:`wchar_t` instead." -msgstr "" +msgstr ":c:type:`!Py_UNICODE_WIDE` type：請改用 :c:type:`wchar_t`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:9 msgid ":c:type:`Py_UNICODE` type: use :c:type:`wchar_t` instead." -msgstr "" +msgstr ":c:type:`Py_UNICODE` type：請改用 :c:type:`wchar_t`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:10 msgid "Python initialization functions:" -msgstr "" +msgstr "Python 初始化函式：" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:12 msgid "" @@ -1065,15 +1113,15 @@ msgstr "" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:14 msgid ":c:func:`Py_GetExecPrefix`: get :data:`sys.exec_prefix` instead." -msgstr "" +msgstr ":c:func:`Py_GetExecPrefix`：請改用 :data:`sys.exec_prefix`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:15 msgid ":c:func:`Py_GetPath`: get :data:`sys.path` instead." -msgstr "" +msgstr ":c:func:`Py_GetPath`：請改用 :data:`sys.path`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:16 msgid ":c:func:`Py_GetPrefix`: get :data:`sys.prefix` instead." -msgstr "" +msgstr ":c:func:`Py_GetPrefix`：請改用 :data:`sys.prefix`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:17 msgid ":c:func:`Py_GetProgramFullPath`: get :data:`sys.executable` instead." @@ -1097,81 +1145,93 @@ msgstr "" #: ../../deprecations/c-api-pending-removal-in-future.rst:7 msgid ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`: unneeded since Python 3.8." -msgstr "" +msgstr ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`：自 Python 3.8 起不再需要" #: ../../deprecations/c-api-pending-removal-in-future.rst:8 msgid ":c:func:`PyErr_Fetch`: use :c:func:`PyErr_GetRaisedException` instead." -msgstr "" +msgstr ":c:func:`PyErr_Fetch`：請改用 :c:func:`PyErr_GetRaisedException`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:9 msgid "" ":c:func:`PyErr_NormalizeException`: use :c:func:`PyErr_GetRaisedException` " "instead." msgstr "" +":c:func:`PyErr_NormalizeException`：請改用 :c:func:" +"`PyErr_GetRaisedException`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:10 msgid "" ":c:func:`PyErr_Restore`: use :c:func:`PyErr_SetRaisedException` instead." -msgstr "" +msgstr ":c:func:`PyErr_Restore`：請改用 :c:func:`PyErr_SetRaisedException`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:11 msgid "" ":c:func:`PyModule_GetFilename`: use :c:func:`PyModule_GetFilenameObject` " "instead." msgstr "" +":c:func:`PyModule_GetFilename`：請改用 :c:func:`PyModule_GetFilenameObject`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:12 msgid ":c:func:`PyOS_AfterFork`: use :c:func:`PyOS_AfterFork_Child` instead." -msgstr "" +msgstr ":c:func:`PyOS_AfterFork`：請改用 :c:func:`PyOS_AfterFork_Child`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:13 msgid "" ":c:func:`PySlice_GetIndicesEx`: use :c:func:`PySlice_Unpack` and :c:func:" "`PySlice_AdjustIndices` instead." msgstr "" +":c:func:`PySlice_GetIndicesEx`：請改用 :c:func:`PySlice_Unpack` 和 :c:func:" +"`PySlice_AdjustIndices`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:14 msgid "" ":c:func:`!PyUnicode_AsDecodedObject`: use :c:func:`PyCodec_Decode` instead." msgstr "" +":c:func:`!PyUnicode_AsDecodedObject`：請改用 :c:func:`PyCodec_Decode`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:15 msgid "" ":c:func:`!PyUnicode_AsDecodedUnicode`: use :c:func:`PyCodec_Decode` instead." msgstr "" +":c:func:`!PyUnicode_AsDecodedUnicode`：請改用 :c:func:`PyCodec_Decode`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:16 msgid "" ":c:func:`!PyUnicode_AsEncodedObject`: use :c:func:`PyCodec_Encode` instead." msgstr "" +":c:func:`!PyUnicode_AsEncodedObject`：請改用 :c:func:`PyCodec_Encode`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:17 msgid "" ":c:func:`!PyUnicode_AsEncodedUnicode`: use :c:func:`PyCodec_Encode` instead." msgstr "" +":c:func:`!PyUnicode_AsEncodedUnicode`：請改用 :c:func:`PyCodec_Encode`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:18 msgid ":c:func:`PyUnicode_READY`: unneeded since Python 3.12" -msgstr "" +msgstr ":c:func:`PyUnicode_READY`：自 Python 3.12 起不再需要" #: ../../deprecations/c-api-pending-removal-in-future.rst:19 msgid ":c:func:`!PyErr_Display`: use :c:func:`PyErr_DisplayException` instead." -msgstr "" +msgstr ":c:func:`!PyErr_Display`：請改用 :c:func:`PyErr_DisplayException`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:20 msgid "" ":c:func:`!_PyErr_ChainExceptions`: use ``_PyErr_ChainExceptions1`` instead." msgstr "" +":c:func:`!_PyErr_ChainExceptions`：請改用 ``_PyErr_ChainExceptions1``。" #: ../../deprecations/c-api-pending-removal-in-future.rst:21 msgid "" ":c:member:`!PyBytesObject.ob_shash` member: call :c:func:`PyObject_Hash` " "instead." msgstr "" +":c:member:`!PyBytesObject.ob_shash` 成員：請改為呼叫 :c:func:" +"`PyObject_Hash`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:23 msgid ":c:member:`!PyDictObject.ma_version_tag` member." -msgstr "" +msgstr ":c:member:`!PyDictObject.ma_version_tag` 成員。" #: ../../deprecations/c-api-pending-removal-in-future.rst:24 msgid "Thread Local Storage (TLS) API:" @@ -1180,28 +1240,29 @@ msgstr "" #: ../../deprecations/c-api-pending-removal-in-future.rst:26 msgid "" ":c:func:`PyThread_create_key`: use :c:func:`PyThread_tss_alloc` instead." -msgstr "" +msgstr ":c:func:`PyThread_create_key`：請改用 :c:func:`PyThread_tss_alloc`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:27 msgid ":c:func:`PyThread_delete_key`: use :c:func:`PyThread_tss_free` instead." -msgstr "" +msgstr ":c:func:`PyThread_delete_key`：請改用 :c:func:`PyThread_tss_free`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:28 msgid "" ":c:func:`PyThread_set_key_value`: use :c:func:`PyThread_tss_set` instead." -msgstr "" +msgstr ":c:func:`PyThread_set_key_value`：請改用 :c:func:`PyThread_tss_set`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:29 msgid "" ":c:func:`PyThread_get_key_value`: use :c:func:`PyThread_tss_get` instead." -msgstr "" +msgstr ":c:func:`PyThread_get_key_value`：請改用 :c:func:`PyThread_tss_get`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:30 msgid "" ":c:func:`PyThread_delete_key_value`: use :c:func:`PyThread_tss_delete` " "instead." msgstr "" +":c:func:`PyThread_delete_key_value`：請改用 :c:func:`PyThread_tss_delete`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:31 msgid ":c:func:`PyThread_ReInitTLS`: unneeded since Python 3.7." -msgstr "" +msgstr ":c:func:`PyThread_ReInitTLS`：自 Python 3.7 起不再需要。" From 6922a5b2a908931bb2f981f85f77eae0b603519a Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Fri, 2 Aug 2024 00:05:11 +0000 Subject: [PATCH 14/28] sync with cpython fed70e03 --- sphinx.po | 164 ++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 159 insertions(+), 5 deletions(-) diff --git a/sphinx.po b/sphinx.po index 14a37a8512..25a081891c 100644 --- a/sphinx.po +++ b/sphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-29 00:04+0000\n" +"POT-Creation-Date: 2024-08-02 00:03+0000\n" "PO-Revision-Date: 2023-03-15 10:19+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -32,6 +32,164 @@ msgstr "回報錯誤" msgid "Show Source" msgstr "顯示原始碼" +#: ../../tools/templates/download.html:2 +#: ../../tools/templates/indexsidebar.html:1 +msgid "Download" +msgstr "下載" + +#: ../../tools/templates/download.html:14 +#, fuzzy +msgid "Download Python %(release)s Documentation" +msgstr "下載說明文件" + +#: ../../tools/templates/download.html:16 +msgid "Last updated on: %(last_updated)s." +msgstr "" + +#: ../../tools/templates/download.html:18 +msgid "" +"To download an archive containing all the documents for this version of\n" +"Python in one of various formats, follow one of links in this table." +msgstr "" + +#: ../../tools/templates/download.html:23 +msgid "Format" +msgstr "" + +#: ../../tools/templates/download.html:24 +msgid "Packed as .zip" +msgstr "" + +#: ../../tools/templates/download.html:25 +msgid "Packed as .tar.bz2" +msgstr "" + +#: ../../tools/templates/download.html:28 +msgid "PDF (US-Letter paper size)" +msgstr "" + +#: ../../tools/templates/download.html:29 +msgid "" +"Download " +"(ca. %(download_size)s MiB)" +msgstr "" + +#: ../../tools/templates/download.html:30 +msgid "" +"Download (ca. %(download_size)s MiB)" +msgstr "" + +#: ../../tools/templates/download.html:33 +msgid "PDF (A4 paper size)" +msgstr "" + +#: ../../tools/templates/download.html:34 +msgid "" +"Download (ca. " +"%(download_size)s MiB)" +msgstr "" + +#: ../../tools/templates/download.html:35 +msgid "" +"Download " +"(ca. %(download_size)s MiB)" +msgstr "" + +#: ../../tools/templates/download.html:38 +msgid "HTML" +msgstr "" + +#: ../../tools/templates/download.html:39 +msgid "" +"Download (ca. " +"%(download_size)s MiB)" +msgstr "" + +#: ../../tools/templates/download.html:40 +msgid "" +"Download " +"(ca. %(download_size)s MiB)" +msgstr "" + +#: ../../tools/templates/download.html:43 +msgid "Plain text" +msgstr "" + +#: ../../tools/templates/download.html:44 +msgid "" +"Download (ca. " +"%(download_size)s MiB)" +msgstr "" + +#: ../../tools/templates/download.html:45 +msgid "" +"Download " +"(ca. %(download_size)s MiB)" +msgstr "" + +#: ../../tools/templates/download.html:48 +msgid "Texinfo" +msgstr "" + +#: ../../tools/templates/download.html:49 +msgid "" +"Download (ca. " +"%(download_size)s MiB)" +msgstr "" + +#: ../../tools/templates/download.html:50 +msgid "" +"Download " +"(ca. %(download_size)s MiB)" +msgstr "" + +#: ../../tools/templates/download.html:53 +msgid "EPUB" +msgstr "" + +#: ../../tools/templates/download.html:54 +msgid "" +"Download (ca. " +"%(download_size)s MiB)" +msgstr "" + +#: ../../tools/templates/download.html:59 +msgid "These archives contain all the content in the documentation." +msgstr "" + +#: ../../tools/templates/download.html:62 +msgid "Unpacking" +msgstr "" + +#: ../../tools/templates/download.html:64 +msgid "" +"Unix users should download the .tar.bz2 archives; these are bzipped tar\n" +"archives and can be handled in the usual way using tar and the bzip2\n" +"program. The Info-ZIP unzip " +"program can be\n" +"used to handle the ZIP archives if desired. The .tar.bz2 archives provide " +"the\n" +"best compression and fastest download times." +msgstr "" + +#: ../../tools/templates/download.html:70 +msgid "" +"Windows users can use the ZIP archives since those are customary on that\n" +"platform. These are created on Unix using the Info-ZIP zip program." +msgstr "" + +#: ../../tools/templates/download.html:74 +msgid "Problems" +msgstr "" + +#: ../../tools/templates/download.html:76 +msgid "" +"If you have comments or suggestions for the Python documentation, please " +"send\n" +"email to docs@python.org." +msgstr "" + #: ../../tools/templates/dummy.html:6 msgid "CPython implementation detail:" msgstr "CPython 實作細節：" @@ -296,10 +454,6 @@ msgstr "版權" msgid "About the documentation" msgstr "關於說明文件" -#: ../../tools/templates/indexsidebar.html:1 -msgid "Download" -msgstr "下載" - #: ../../tools/templates/indexsidebar.html:2 msgid "Download these documents" msgstr "下載這些說明文件" From a5775882ed829195516988f3f2b2183fdacc7daf Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Sat, 3 Aug 2024 00:05:20 +0000 Subject: [PATCH 15/28] sync with cpython 6b8a9a10 --- howto/isolating-extensions.po | 6 +-- library/logging.config.po | 77 +++++++++++++++++++---------------- library/threading.po | 4 +- 3 files changed, 47 insertions(+), 40 deletions(-) diff --git a/howto/isolating-extensions.po b/howto/isolating-extensions.po index 1196545904..23bf093704 100644 --- a/howto/isolating-extensions.po +++ b/howto/isolating-extensions.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-27 00:03+0000\n" +"POT-Creation-Date: 2024-08-03 00:03+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -444,8 +444,8 @@ msgstr "" #: ../../howto/isolating-extensions.rst:342 msgid "" -"Please refer to the the documentation of :c:macro:`Py_TPFLAGS_HAVE_GC` and :" -"c:member:`~PyTypeObject.tp_traverse` for additional considerations." +"Please refer to the documentation of :c:macro:`Py_TPFLAGS_HAVE_GC` and :c:" +"member:`~PyTypeObject.tp_traverse` for additional considerations." msgstr "" #: ../../howto/isolating-extensions.rst:346 diff --git a/library/logging.config.po b/library/logging.config.po index 2483fce5bb..c3b781c223 100644 --- a/library/logging.config.po +++ b/library/logging.config.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-08-03 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:05+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -867,52 +867,59 @@ msgstr "" #: ../../library/logging.config.rst:755 msgid "" -"An actual instance of :class:`queue.Queue` or a subclass thereof. This is of " -"course only possible if you are constructing or modifying the configuration " -"dictionary in code." +"An object implementing the :class:`queue.Queue` public API. For instance, " +"this may be an actual instance of :class:`queue.Queue` or a subclass " +"thereof, or a proxy obtained by :meth:`multiprocessing.managers.SyncManager." +"Queue`." msgstr "" #: ../../library/logging.config.rst:759 msgid "" +"This is of course only possible if you are constructing or modifying the " +"configuration dictionary in code." +msgstr "" + +#: ../../library/logging.config.rst:762 +msgid "" "A string that resolves to a callable which, when called with no arguments, " "returns the :class:`queue.Queue` instance to use. That callable could be a :" "class:`queue.Queue` subclass or a function which returns a suitable queue " "instance, such as ``my.module.queue_factory()``." msgstr "" -#: ../../library/logging.config.rst:764 +#: ../../library/logging.config.rst:767 msgid "" "A dict with a ``'()'`` key which is constructed in the usual way as " "discussed in :ref:`logging-config-dict-userdef`. The result of this " "construction should be a :class:`queue.Queue` instance." msgstr "" -#: ../../library/logging.config.rst:768 +#: ../../library/logging.config.rst:771 msgid "" "If the ``queue`` key is absent, a standard unbounded :class:`queue.Queue` " "instance is created and used." msgstr "" -#: ../../library/logging.config.rst:771 +#: ../../library/logging.config.rst:774 msgid "" "If the ``listener`` key is present, the corresponding value can be one of " "the following:" msgstr "" -#: ../../library/logging.config.rst:773 +#: ../../library/logging.config.rst:776 msgid "" "A subclass of :class:`logging.handlers.QueueListener`. This is of course " "only possible if you are constructing or modifying the configuration " "dictionary in code." msgstr "" -#: ../../library/logging.config.rst:777 +#: ../../library/logging.config.rst:780 msgid "" "A string which resolves to a class which is a subclass of ``QueueListener``, " "such as ``'my.package.CustomListener'``." msgstr "" -#: ../../library/logging.config.rst:780 +#: ../../library/logging.config.rst:783 msgid "" "A dict with a ``'()'`` key which is constructed in the usual way as " "discussed in :ref:`logging-config-dict-userdef`. The result of this " @@ -920,31 +927,31 @@ msgid "" "``QueueListener`` initializer." msgstr "" -#: ../../library/logging.config.rst:784 +#: ../../library/logging.config.rst:787 msgid "" "If the ``listener`` key is absent, :class:`logging.handlers.QueueListener` " "is used." msgstr "" -#: ../../library/logging.config.rst:786 +#: ../../library/logging.config.rst:789 msgid "" "The values under the ``handlers`` key are the names of other handlers in the " "configuration (not shown in the above snippet) which will be passed to the " "queue listener." msgstr "" -#: ../../library/logging.config.rst:790 +#: ../../library/logging.config.rst:793 msgid "" "Any custom queue handler and listener classes will need to be defined with " "the same initialization signatures as :class:`~logging.handlers." "QueueHandler` and :class:`~logging.handlers.QueueListener`." msgstr "" -#: ../../library/logging.config.rst:799 +#: ../../library/logging.config.rst:802 msgid "Configuration file format" msgstr "" -#: ../../library/logging.config.rst:801 +#: ../../library/logging.config.rst:804 msgid "" "The configuration file format understood by :func:`fileConfig` is based on :" "mod:`configparser` functionality. The file must contain sections called " @@ -961,7 +968,7 @@ msgid "" "specified in a section called ``[logger_root]``." msgstr "" -#: ../../library/logging.config.rst:816 +#: ../../library/logging.config.rst:819 msgid "" "The :func:`fileConfig` API is older than the :func:`dictConfig` API and does " "not provide functionality to cover certain aspects of logging. For example, " @@ -974,17 +981,17 @@ msgid "" "when it's convenient to do so." msgstr "" -#: ../../library/logging.config.rst:826 +#: ../../library/logging.config.rst:829 msgid "Examples of these sections in the file are given below." msgstr "" -#: ../../library/logging.config.rst:839 +#: ../../library/logging.config.rst:842 msgid "" "The root logger must specify a level and a list of handlers. An example of a " "root logger section is given below." msgstr "" -#: ../../library/logging.config.rst:848 +#: ../../library/logging.config.rst:851 msgid "" "The ``level`` entry can be one of ``DEBUG, INFO, WARNING, ERROR, CRITICAL`` " "or ``NOTSET``. For the root logger only, ``NOTSET`` means that all messages " @@ -992,7 +999,7 @@ msgid "" "of the ``logging`` package's namespace." msgstr "" -#: ../../library/logging.config.rst:853 +#: ../../library/logging.config.rst:856 msgid "" "The ``handlers`` entry is a comma-separated list of handler names, which " "must appear in the ``[handlers]`` section. These names must appear in the " @@ -1000,13 +1007,13 @@ msgid "" "file." msgstr "" -#: ../../library/logging.config.rst:858 +#: ../../library/logging.config.rst:861 msgid "" "For loggers other than the root logger, some additional information is " "required. This is illustrated by the following example." msgstr "" -#: ../../library/logging.config.rst:869 +#: ../../library/logging.config.rst:872 msgid "" "The ``level`` and ``handlers`` entries are interpreted as for the root " "logger, except that if a non-root logger's level is specified as ``NOTSET``, " @@ -1019,20 +1026,20 @@ msgid "" "application to get the logger." msgstr "" -#: ../../library/logging.config.rst:878 +#: ../../library/logging.config.rst:881 msgid "" "Sections which specify handler configuration are exemplified by the " "following." msgstr "" -#: ../../library/logging.config.rst:888 +#: ../../library/logging.config.rst:891 msgid "" "The ``class`` entry indicates the handler's class (as determined by :func:" "`eval` in the ``logging`` package's namespace). The ``level`` is interpreted " "as for loggers, and ``NOTSET`` is taken to mean 'log everything'." msgstr "" -#: ../../library/logging.config.rst:892 +#: ../../library/logging.config.rst:895 msgid "" "The ``formatter`` entry indicates the key name of the formatter for this " "handler. If blank, a default formatter (``logging._defaultFormatter``) is " @@ -1040,7 +1047,7 @@ msgid "" "and have a corresponding section in the configuration file." msgstr "" -#: ../../library/logging.config.rst:897 +#: ../../library/logging.config.rst:900 msgid "" "The ``args`` entry, when :ref:`evaluated ` in the context of the " "``logging`` package's namespace, is the list of arguments to the constructor " @@ -1049,7 +1056,7 @@ msgid "" "provided, it defaults to ``()``." msgstr "" -#: ../../library/logging.config.rst:903 +#: ../../library/logging.config.rst:906 msgid "" "The optional ``kwargs`` entry, when :ref:`evaluated ` in the " "context of the ``logging`` package's namespace, is the keyword argument dict " @@ -1057,26 +1064,26 @@ msgid "" "``{}``." msgstr "" -#: ../../library/logging.config.rst:960 +#: ../../library/logging.config.rst:963 msgid "" "Sections which specify formatter configuration are typified by the following." msgstr "" -#: ../../library/logging.config.rst:972 +#: ../../library/logging.config.rst:975 msgid "" "The arguments for the formatter configuration are the same as the keys in " "the dictionary schema :ref:`formatters section `." msgstr "" -#: ../../library/logging.config.rst:976 +#: ../../library/logging.config.rst:979 msgid "" "The ``defaults`` entry, when :ref:`evaluated ` in the context of " "the ``logging`` package's namespace, is a dictionary of default values for " "custom formatting fields. If not provided, it defaults to ``None``." msgstr "" -#: ../../library/logging.config.rst:983 +#: ../../library/logging.config.rst:986 msgid "" "Due to the use of :func:`eval` as described above, there are potential " "security risks which result from using the :func:`listen` to send and " @@ -1085,18 +1092,18 @@ msgid "" "`listen` documentation for more information." msgstr "" -#: ../../library/logging.config.rst:991 +#: ../../library/logging.config.rst:994 msgid "Module :mod:`logging`" msgstr ":mod:`logging` 模組" -#: ../../library/logging.config.rst:992 +#: ../../library/logging.config.rst:995 msgid "API reference for the logging module." msgstr "" -#: ../../library/logging.config.rst:994 +#: ../../library/logging.config.rst:997 msgid "Module :mod:`logging.handlers`" msgstr ":mod:`logging.handlers` 模組" -#: ../../library/logging.config.rst:995 +#: ../../library/logging.config.rst:998 msgid "Useful handlers included with the logging module." msgstr "" diff --git a/library/threading.po b/library/threading.po index 184b52aab8..3eb2e56fc1 100644 --- a/library/threading.po +++ b/library/threading.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-08-03 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:12+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1291,7 +1291,7 @@ msgid "" "Block as long as the internal flag is false and the timeout, if given, has " "not expired. The return value represents the reason that this blocking " "method returned; ``True`` if returning because the internal flag is set to " -"true, or ``False`` if a timeout is given and the the internal flag did not " +"true, or ``False`` if a timeout is given and the internal flag did not " "become true within the given wait time." msgstr "" From e08c28cde7df83a25989fda5027c4dd6cacf3be0 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Sun, 4 Aug 2024 00:05:15 +0000 Subject: [PATCH 16/28] sync with cpython 62f224a9 --- c-api/bytearray.po | 30 ++++--- c-api/file.po | 6 +- c-api/init.po | 11 ++- c-api/sys.po | 13 +-- library/_thread.po | 6 +- library/array.po | 5 +- library/asyncio.po | 6 +- library/ctypes.po | 183 ++++++++++++++++++-------------------- library/ensurepip.po | 6 +- library/fcntl.po | 18 ++-- library/ftplib.po | 9 +- library/functions.po | 125 ++++++++++++++------------ library/gc.po | 14 ++- library/glob.po | 10 ++- library/http.client.po | 9 +- library/imaplib.po | 10 ++- library/io.po | 25 +++--- library/marshal.po | 14 ++- library/mmap.po | 6 +- library/msvcrt.po | 12 ++- library/nntplib.po | 26 +++--- library/os.path.po | 5 +- library/os.po | 154 ++++++++++++++++++++++---------- library/pathlib.po | 8 +- library/pdb.po | 5 +- library/pickle.po | 6 +- library/poplib.po | 34 +++---- library/pty.po | 6 +- library/resource.po | 9 +- library/shutil.po | 38 +++++--- library/signal.po | 6 +- library/smtplib.po | 26 +++--- library/socket.po | 54 +++++++---- library/sqlite3.po | 18 ++-- library/ssl.po | 8 +- library/subprocess.po | 12 +-- library/sys.po | 124 ++++++++++++++------------ library/syslog.po | 17 ++-- library/telnetlib.po | 9 +- library/tempfile.po | 10 ++- library/types.po | 11 ++- library/urllib.request.po | 22 ++--- library/webbrowser.po | 6 +- library/winreg.po | 72 +++++++++------ reference/datamodel.po | 59 ++++++------ reference/simple_stmts.po | 7 +- using/cmdline.po | 37 ++++---- 47 files changed, 746 insertions(+), 561 deletions(-) diff --git a/c-api/bytearray.po b/c-api/bytearray.po index 0ea4c7be73..f32090bde8 100644 --- a/c-api/bytearray.po +++ b/c-api/bytearray.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-09 00:15+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2023-08-12 11:42+0800\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -68,24 +68,28 @@ msgstr "" "由任意物件 *o* 回傳一個新的位元組陣列物件，並實作了\\ :ref:`緩衝協議 (buffer " "protocol) `。" -#: ../../c-api/bytearray.rst:48 -msgid "" -"Create a new bytearray object from *string* and its length, *len*. On " -"failure, ``NULL`` is returned." +#: ../../c-api/bytearray.rst:45 ../../c-api/bytearray.rst:52 +#: ../../c-api/bytearray.rst:59 +msgid "On failure, return ``NULL`` with an exception set." +msgstr "" + +#: ../../c-api/bytearray.rst:50 +#, fuzzy +msgid "Create a new bytearray object from *string* and its length, *len*." msgstr "" "從 *string* 及其長度 *len* 建立一個新的位元組陣列物件。若失敗則回傳 " "``NULL``。" -#: ../../c-api/bytearray.rst:54 +#: ../../c-api/bytearray.rst:57 msgid "" "Concat bytearrays *a* and *b* and return a new bytearray with the result." msgstr "連接位元組陣列 *a* 和 *b*，並回傳一個包含結果的新位元組陣列。" -#: ../../c-api/bytearray.rst:59 +#: ../../c-api/bytearray.rst:64 msgid "Return the size of *bytearray* after checking for a ``NULL`` pointer." msgstr "在檢查為 ``NULL`` 指標後，回傳 *bytearray* 的大小。" -#: ../../c-api/bytearray.rst:64 +#: ../../c-api/bytearray.rst:69 msgid "" "Return the contents of *bytearray* as a char array after checking for a " "``NULL`` pointer. The returned array always has an extra null byte appended." @@ -93,23 +97,23 @@ msgstr "" "在檢查是否為 ``NULL`` 指標後，將 *bytearray* 的內容回傳為字元陣列。回傳的陣列" "總是會多附加一個空位元組。" -#: ../../c-api/bytearray.rst:71 +#: ../../c-api/bytearray.rst:76 msgid "Resize the internal buffer of *bytearray* to *len*." msgstr "將 *bytearray* 的內部緩衝區大小調整為 *len*。" -#: ../../c-api/bytearray.rst:74 +#: ../../c-api/bytearray.rst:79 msgid "Macros" msgstr "巨集" -#: ../../c-api/bytearray.rst:76 +#: ../../c-api/bytearray.rst:81 msgid "These macros trade safety for speed and they don't check pointers." msgstr "這些巨集犧牲了安全性以換取速度，並且它們不會檢查指標。" -#: ../../c-api/bytearray.rst:80 +#: ../../c-api/bytearray.rst:85 msgid "Similar to :c:func:`PyByteArray_AsString`, but without error checking." msgstr "與 :c:func:`PyByteArray_AsString` 類似，但沒有錯誤檢查。" -#: ../../c-api/bytearray.rst:85 +#: ../../c-api/bytearray.rst:90 msgid "Similar to :c:func:`PyByteArray_Size`, but without error checking." msgstr "與 :c:func:`PyByteArray_Size` 類似，但沒有錯誤檢查。" diff --git a/c-api/file.po b/c-api/file.po index c3522d745b..5460b908b9 100644 --- a/c-api/file.po +++ b/c-api/file.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2023-04-24 20:38+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -158,7 +158,9 @@ msgstr "在 :c:func:`Py_Initialize` 之前呼叫此函式是安全的。" #: ../../c-api/file.rst:90 #, fuzzy -msgid "Raises an auditing event setopencodehook with no arguments." +msgid "" +"Raises an :ref:`auditing event ` ``setopencodehook`` with no " +"arguments." msgstr "" "不帶引數地引發一個\\ :ref:`稽核事件 (auditing event) ` " "``setopencodehook``。" diff --git a/c-api/init.po b/c-api/init.po index b3025e319b..be887b4ae4 100644 --- a/c-api/init.po +++ b/c-api/init.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2023-04-24 20:49+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -614,7 +614,8 @@ msgstr "" #: ../../c-api/init.rst:421 #, fuzzy msgid "" -"Raises an auditing event cpython._PySys_ClearAuditHooks with no arguments." +"Raises an :ref:`auditing event ` ``cpython." +"_PySys_ClearAuditHooks`` with no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``cpython." "_PySys_ClearAuditHooks``。" @@ -1419,7 +1420,8 @@ msgstr "" #: ../../c-api/init.rst:1227 #, fuzzy msgid "" -"Raises an auditing event cpython.PyInterpreterState_New with no arguments." +"Raises an :ref:`auditing event ` ``cpython." +"PyInterpreterState_New`` with no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``cpython." "PyInterpreterState_New``。" @@ -1433,7 +1435,8 @@ msgstr "" #: ../../c-api/init.rst:1235 #, fuzzy msgid "" -"Raises an auditing event cpython.PyInterpreterState_Clear with no arguments." +"Raises an :ref:`auditing event ` ``cpython." +"PyInterpreterState_Clear`` with no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``cpython." "PyInterpreterState_Clear``。" diff --git a/c-api/sys.po b/c-api/sys.po index 73b08e3056..b8d271fe90 100644 --- a/c-api/sys.po +++ b/c-api/sys.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 14:07+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -454,16 +454,7 @@ msgid "" "events table `. Details are in each function's documentation." msgstr "" -#: ../../c-api/sys.rst:395 -msgid "" -"If the interpreter is initialized, this function raises an auditing event " -"sys.addaudithook with no arguments. If any existing hooks raise an exception " -"derived from Exception, the new hook will not be added and the exception is " -"cleared. As a result, callers cannot assume that their hook has been added " -"unless they control all existing hooks." -msgstr "" - -#: ../../c-api/sys.rst:397 +#: ../../c-api/sys.rst:395 ../../c-api/sys.rst:397 msgid "" "If the interpreter is initialized, this function raises an auditing event " "``sys.addaudithook`` with no arguments. If any existing hooks raise an " diff --git a/library/_thread.po b/library/_thread.po index acbb332af2..f0c9f44e0b 100644 --- a/library/_thread.po +++ b/library/_thread.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2015-12-09 17:51+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -90,8 +90,8 @@ msgstr "當函式引發 :exc:`SystemExit` 例外時，它會被靜默忽略。" #: ../../library/_thread.rst:60 #, fuzzy msgid "" -"Raises an auditing event _thread.start_new_thread with arguments function, " -"args, kwargs." +"Raises an :ref:`auditing event ` ``_thread.start_new_thread`` with " +"arguments ``function``, ``args``, ``kwargs``." msgstr "" "引發一個 :ref:`稽核事件 ` ``_thread.start_new_thread``，帶有引數 " "``function``、``args`` 和 ``kwargs``。" diff --git a/library/array.po b/library/array.po index f6388bdc6d..f9a44f3271 100644 --- a/library/array.po +++ b/library/array.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2021-11-23 18:40+0800\n" "Last-Translator: Benson Chen \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -282,7 +282,8 @@ msgstr "" #: ../../library/array.rst:96 #, fuzzy msgid "" -"Raises an auditing event array.__new__ with arguments typecode, initializer." +"Raises an :ref:`auditing event ` ``array.__new__`` with arguments " +"``typecode``, ``initializer``." msgstr "" "引發\\ :ref:`稽核事件 (auditing event) ` ``array.__new__`` 並帶入引" "數 ``typecode``、``initializer``。" diff --git a/library/asyncio.po b/library/asyncio.po index 236d438943..197d9dca7a 100644 --- a/library/asyncio.po +++ b/library/asyncio.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2021-11-23 12:40+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -149,7 +149,9 @@ msgid "You can experiment with an ``asyncio`` concurrent context in the REPL:" msgstr "你能在 REPL 中對一個 ``asyncio`` 的並行情境 (context) 進行實驗：" #: ../../library/asyncio.rst:77 -msgid "Raises an auditing event cpython.run_stdin with no arguments." +msgid "" +"Raises an :ref:`auditing event ` ``cpython.run_stdin`` with no " +"arguments." msgstr "" #: ../../library/asyncio.rst:79 diff --git a/library/ctypes.po b/library/ctypes.po index e23c1d66de..9c4bc22014 100644 --- a/library/ctypes.po +++ b/library/ctypes.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2023-04-26 02:59+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1525,41 +1525,21 @@ msgid "" "correct :attr:`!restype` attribute to use these functions." msgstr "" -#: ../../library/ctypes.rst:1580 -msgid "" -"Loading a library through any of these objects raises an auditing event " -"ctypes.dlopen with string argument name, the name used to load the library." -msgstr "" - -#: ../../library/ctypes.rst:1582 +#: ../../library/ctypes.rst:1580 ../../library/ctypes.rst:1582 msgid "" "Loading a library through any of these objects raises an :ref:`auditing " "event ` ``ctypes.dlopen`` with string argument ``name``, the name " "used to load the library." msgstr "" -#: ../../library/ctypes.rst:1586 -msgid "" -"Accessing a function on a loaded library raises an auditing event ctypes." -"dlsym with arguments library (the library object) and name (the symbol's " -"name as a string or integer)." -msgstr "" - -#: ../../library/ctypes.rst:1588 +#: ../../library/ctypes.rst:1586 ../../library/ctypes.rst:1588 msgid "" "Accessing a function on a loaded library raises an auditing event ``ctypes." "dlsym`` with arguments ``library`` (the library object) and ``name`` (the " "symbol's name as a string or integer)." msgstr "" -#: ../../library/ctypes.rst:1592 -msgid "" -"In cases when only the library handle is available rather than the object, " -"accessing a function raises an auditing event ctypes.dlsym/handle with " -"arguments handle (the raw library handle) and name." -msgstr "" - -#: ../../library/ctypes.rst:1594 +#: ../../library/ctypes.rst:1592 ../../library/ctypes.rst:1594 msgid "" "In cases when only the library handle is available rather than the object, " "accessing a function raises an auditing event ``ctypes.dlsym/handle`` with " @@ -1675,16 +1655,7 @@ msgid "" "the passed arguments." msgstr "" -#: ../../library/ctypes.rst:1683 -msgid "" -"On Windows, when a foreign function call raises a system exception (for " -"example, due to an access violation), it will be captured and replaced with " -"a suitable Python exception. Further, an auditing event ctypes.set_exception " -"with argument code will be raised, allowing an audit hook to replace the " -"exception with its own." -msgstr "" - -#: ../../library/ctypes.rst:1685 +#: ../../library/ctypes.rst:1683 ../../library/ctypes.rst:1685 msgid "" "On Windows, when a foreign function call raises a system exception (for " "example, due to an access violation), it will be captured and replaced with " @@ -1693,16 +1664,7 @@ msgid "" "hook to replace the exception with its own." msgstr "" -#: ../../library/ctypes.rst:1691 -#, fuzzy -msgid "" -"Some ways to invoke foreign function calls may raise an auditing event " -"ctypes.call_function with arguments function pointer and arguments." -msgstr "" -"引發一個附帶引數 ``func_pointer``、``arguments`` 的\\ :ref:`稽核事件 " -"` ``ctypes.call_function``。" - -#: ../../library/ctypes.rst:1693 +#: ../../library/ctypes.rst:1691 ../../library/ctypes.rst:1693 msgid "" "Some ways to invoke foreign function calls may raise an auditing event " "``ctypes.call_function`` with arguments ``function pointer`` and " @@ -1905,10 +1867,11 @@ msgstr "" #: ../../library/ctypes.rst:1886 #, fuzzy -msgid "Raises an auditing event ctypes.addressof with argument obj." +msgid "" +"Raises an :ref:`auditing event ` ``ctypes.addressof`` with " +"argument ``obj``." msgstr "" -"引發一個附帶引數 ``obj`` 的\\ :ref:`稽核事件 ` ``ctypes." -"addressof``。" +"引發一個附帶引數 ``name`` 的\\ :ref:`稽核事件 ` ``ctypes.dlopen``。" #: ../../library/ctypes.rst:1891 msgid "" @@ -1965,8 +1928,8 @@ msgstr "" #: ../../library/ctypes.rst:1930 #, fuzzy msgid "" -"Raises an auditing event ctypes.create_string_buffer with arguments init, " -"size." +"Raises an :ref:`auditing event ` ``ctypes.create_string_buffer`` " +"with arguments ``init``, ``size``." msgstr "" "引發一個附帶引數 ``init`` 與 ``size`` 的\\ :ref:`稽核事件 ` " "``ctypes.create_string_buffer``。" @@ -1995,8 +1958,8 @@ msgstr "" #: ../../library/ctypes.rst:1947 #, fuzzy msgid "" -"Raises an auditing event ctypes.create_unicode_buffer with arguments init, " -"size." +"Raises an :ref:`auditing event ` ``ctypes.create_unicode_buffer`` " +"with arguments ``init``, ``size``." msgstr "" "引發一個附帶引數 ``init`` 與 ``size`` 的\\ :ref:`稽核事件 ` " "``ctypes.create_unicode_buffer``。" @@ -2059,9 +2022,12 @@ msgstr "" #: ../../library/ctypes.rst:2005 #, fuzzy -msgid "Raises an auditing event ctypes.get_errno with no arguments." +msgid "" +"Raises an :ref:`auditing event ` ``ctypes.get_errno`` with no " +"arguments." msgstr "" -"引發一個不附帶引數的\\ :ref:`稽核事件 ` ``ctypes.get_errno``。" +"引發一個附帶引數 ``code`` 的\\ :ref:`稽核事件 ` ``ctypes." +"set_exception``。" #: ../../library/ctypes.rst:2009 msgid "" @@ -2071,7 +2037,9 @@ msgstr "" #: ../../library/ctypes.rst:2012 #, fuzzy -msgid "Raises an auditing event ctypes.get_last_error with no arguments." +msgid "" +"Raises an :ref:`auditing event ` ``ctypes.get_last_error`` with no " +"arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``ctypes.get_last_error``。" @@ -2124,10 +2092,12 @@ msgstr "" #: ../../library/ctypes.rst:2057 #, fuzzy -msgid "Raises an auditing event ctypes.set_errno with argument errno." +msgid "" +"Raises an :ref:`auditing event ` ``ctypes.set_errno`` with " +"argument ``errno``." msgstr "" -"引發一個附帶引數 ``errno`` 的\\ :ref:`稽核事件 ` ``ctypes." -"set_errno``。" +"引發一個附帶引數 ``code`` 的\\ :ref:`稽核事件 ` ``ctypes." +"set_exception``。" #: ../../library/ctypes.rst:2062 msgid "" @@ -2138,10 +2108,12 @@ msgstr "" #: ../../library/ctypes.rst:2066 #, fuzzy -msgid "Raises an auditing event ctypes.set_last_error with argument error." +msgid "" +"Raises an :ref:`auditing event ` ``ctypes.set_last_error`` with " +"argument ``error``." msgstr "" -"引發一個附帶引數 ``error`` 的\\ :ref:`稽核事件 ` ``ctypes." -"get_last_error``。" +"引發一個附帶引數 ``code`` 的\\ :ref:`稽核事件 ` ``ctypes." +"set_exception``。" #: ../../library/ctypes.rst:2071 msgid "" @@ -2157,10 +2129,12 @@ msgstr "" #: ../../library/ctypes.rst:2081 #, fuzzy -msgid "Raises an auditing event ctypes.string_at with arguments ptr, size." +msgid "" +"Raises an :ref:`auditing event ` ``ctypes.string_at`` with " +"arguments ``ptr``, ``size``." msgstr "" -"引發一個附帶引數 ``ptr``、``size`` 的\\ :ref:`稽核事件 ` ``ctypes." -"string_at``。" +"引發一個附帶引數 ``library``、``name`` 的\\ :ref:`稽核事件 ` " +"``ctypes.dlsym``。" #: ../../library/ctypes.rst:2086 msgid "" @@ -2186,10 +2160,12 @@ msgstr "" #: ../../library/ctypes.rst:2104 #, fuzzy -msgid "Raises an auditing event ctypes.wstring_at with arguments ptr, size." +msgid "" +"Raises an :ref:`auditing event ` ``ctypes.wstring_at`` with " +"arguments ``ptr``, ``size``." msgstr "" -"引發一個附帶引數 ``ptr``、``size`` 的\\ :ref:`稽核事件 ` ``ctypes." -"wstring_at``。" +"引發一個附帶引數 ``library``、``name`` 的\\ :ref:`稽核事件 ` " +"``ctypes.dlsym``。" #: ../../library/ctypes.rst:2110 msgid "Data types" @@ -2223,8 +2199,8 @@ msgstr "" #: ../../library/ctypes.rst:2133 ../../library/ctypes.rst:2143 #, fuzzy msgid "" -"Raises an auditing event ctypes.cdata/buffer with arguments pointer, size, " -"offset." +"Raises an :ref:`auditing event ` ``ctypes.cdata/buffer`` with " +"arguments ``pointer``, ``size``, ``offset``." msgstr "" "引發一個附帶引數 ``pointer``、``size``、``offset`` 的\\ :ref:`稽核事件 " "` ``ctypes.cdata/buffer``。" @@ -2243,16 +2219,7 @@ msgid "" "*address* which must be an integer." msgstr "" -#: ../../library/ctypes.rst:2150 -#, fuzzy -msgid "" -"This method, and others that indirectly call this method, raises an auditing " -"event ctypes.cdata with argument address." -msgstr "" -"引發一個附帶引數 ``address`` 的\\ :ref:`稽核事件 ` ``ctypes." -"cdata``。" - -#: ../../library/ctypes.rst:2152 +#: ../../library/ctypes.rst:2150 ../../library/ctypes.rst:2152 msgid "" "This method, and others that indirectly call this method, raises an :ref:" "`auditing event ` ``ctypes.cdata`` with argument ``address``." @@ -2765,20 +2732,56 @@ msgid "" "changes the pointer to point to the assigned object." msgstr "" +#, fuzzy #~ msgid "" -#~ "Raises an :ref:`auditing event ` ``ctypes.dlopen`` with " -#~ "argument ``name``." +#~ "Some ways to invoke foreign function calls may raise an auditing event " +#~ "ctypes.call_function with arguments function pointer and arguments." +#~ msgstr "" +#~ "引發一個附帶引數 ``func_pointer``、``arguments`` 的\\ :ref:`稽核事件 " +#~ "` ``ctypes.call_function``。" + +#, fuzzy +#~ msgid "Raises an auditing event ctypes.addressof with argument obj." +#~ msgstr "" +#~ "引發一個附帶引數 ``obj`` 的\\ :ref:`稽核事件 ` ``ctypes." +#~ "addressof``。" + +#, fuzzy +#~ msgid "Raises an auditing event ctypes.get_errno with no arguments." +#~ msgstr "" +#~ "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``ctypes.get_errno``。" + +#, fuzzy +#~ msgid "Raises an auditing event ctypes.set_errno with argument errno." #~ msgstr "" -#~ "引發一個附帶引數 ``name`` 的\\ :ref:`稽核事件 ` ``ctypes." -#~ "dlopen``。" +#~ "引發一個附帶引數 ``errno`` 的\\ :ref:`稽核事件 ` ``ctypes." +#~ "set_errno``。" + +#, fuzzy +#~ msgid "Raises an auditing event ctypes.set_last_error with argument error." +#~ msgstr "" +#~ "引發一個附帶引數 ``error`` 的\\ :ref:`稽核事件 ` ``ctypes." +#~ "get_last_error``。" + +#, fuzzy +#~ msgid "Raises an auditing event ctypes.string_at with arguments ptr, size." +#~ msgstr "" +#~ "引發一個附帶引數 ``ptr``、``size`` 的\\ :ref:`稽核事件 ` " +#~ "``ctypes.string_at``。" + +#, fuzzy +#~ msgid "Raises an auditing event ctypes.wstring_at with arguments ptr, size." +#~ msgstr "" +#~ "引發一個附帶引數 ``ptr``、``size`` 的\\ :ref:`稽核事件 ` " +#~ "``ctypes.wstring_at``。" #, fuzzy #~ msgid "" -#~ "Raises an :ref:`auditing event ` ``ctypes.dlsym`` with " -#~ "arguments ``library``, ``name``." +#~ "This method, and others that indirectly call this method, raises an " +#~ "auditing event ctypes.cdata with argument address." #~ msgstr "" -#~ "引發一個附帶引數 ``library``、``name`` 的\\ :ref:`稽核事件 ` " -#~ "``ctypes.dlsym``。" +#~ "引發一個附帶引數 ``address`` 的\\ :ref:`稽核事件 ` ``ctypes." +#~ "cdata``。" #, fuzzy #~ msgid "" @@ -2788,13 +2791,5 @@ msgstr "" #~ "引發一個附帶引數 ``handle``、``name`` 的\\ :ref:`稽核事件 ` " #~ "``ctypes.dlsym/handle``。" -#, fuzzy -#~ msgid "" -#~ "Raises an :ref:`auditing event ` ``ctypes.set_exception`` with " -#~ "argument ``code``." -#~ msgstr "" -#~ "引發一個附帶引數 ``code`` 的\\ :ref:`稽核事件 ` ``ctypes." -#~ "set_exception``。" - #~ msgid ":c:expr:`size_t`" #~ msgstr ":c:expr:`size_t`" diff --git a/library/ensurepip.po b/library/ensurepip.po index c6044ea1f2..ec37983bae 100644 --- a/library/ensurepip.po +++ b/library/ensurepip.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:01+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -238,7 +238,9 @@ msgstr "" #: ../../library/ensurepip.rst:125 #, fuzzy -msgid "Raises an auditing event ensurepip.bootstrap with argument root." +msgid "" +"Raises an :ref:`auditing event ` ``ensurepip.bootstrap`` with " +"argument ``root``." msgstr "" "引發一個附帶引數 ``root`` 的\\ :ref:`稽核事件 ` ``ensurepip." "bootstrap``。" diff --git a/library/fcntl.po b/library/fcntl.po index b6900c9079..98b1e70e34 100644 --- a/library/fcntl.po +++ b/library/fcntl.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2017-09-22 18:26+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -115,7 +115,9 @@ msgstr "" #: ../../library/fcntl.rst:85 #, fuzzy -msgid "Raises an auditing event fcntl.fcntl with arguments fd, cmd, arg." +msgid "" +"Raises an :ref:`auditing event ` ``fcntl.fcntl`` with arguments " +"``fd``, ``cmd``, ``arg``." msgstr "" "引發一個附帶引數 ``fd``、``cmd``、``arg`` 的\\ :ref:`稽核事件 ` " "``fcntl.fcntl``。" @@ -183,7 +185,9 @@ msgstr "範例： ::" #: ../../library/fcntl.rst:136 #, fuzzy -msgid "Raises an auditing event fcntl.ioctl with arguments fd, request, arg." +msgid "" +"Raises an :ref:`auditing event ` ``fcntl.ioctl`` with arguments " +"``fd``, ``request``, ``arg``." msgstr "" "引發一個附帶引數 ``fd``、``request``、``arg`` 的\\ :ref:`稽核事件 " "` ``fcntl.ioctl``。" @@ -203,7 +207,9 @@ msgstr "" #: ../../library/fcntl.rst:148 #, fuzzy -msgid "Raises an auditing event fcntl.flock with arguments fd, operation." +msgid "" +"Raises an :ref:`auditing event ` ``fcntl.flock`` with arguments " +"``fd``, ``operation``." msgstr "" "引發一個附帶引數 ``fd``、``operation`` 的\\ :ref:`稽核事件 ` " "``fcntl.flock``。" @@ -273,8 +279,8 @@ msgstr "" #: ../../library/fcntl.rst:194 #, fuzzy msgid "" -"Raises an auditing event fcntl.lockf with arguments fd, cmd, len, start, " -"whence." +"Raises an :ref:`auditing event ` ``fcntl.lockf`` with arguments " +"``fd``, ``cmd``, ``len``, ``start``, ``whence``." msgstr "" "引發一個附帶引數 ``fd``、``cmd``、``len``、``start``、``whence`` 的\\ :ref:`" "稽核事件 ` ``fcntl.lockf``。" diff --git a/library/ftplib.po b/library/ftplib.po index e9a3660b6c..7f901762fc 100644 --- a/library/ftplib.po +++ b/library/ftplib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2023-04-26 19:44+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -216,7 +216,8 @@ msgstr "連線嘗試的超時設定，以秒為單位（預設：全域預設超 #: ../../library/ftplib.rst:187 #, fuzzy msgid "" -"Raises an auditing event ftplib.connect with arguments self, host, port." +"Raises an :ref:`auditing event ` ``ftplib.connect`` with arguments " +"``self``, ``host``, ``port``." msgstr "" "引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " "` ``ftplib.connect``。" @@ -259,7 +260,9 @@ msgstr "向伺服器發送一個簡單的命令字串並回傳回應字串。" #: ../../library/ftplib.rst:229 ../../library/ftplib.rst:238 #, fuzzy -msgid "Raises an auditing event ftplib.sendcmd with arguments self, cmd." +msgid "" +"Raises an :ref:`auditing event ` ``ftplib.sendcmd`` with arguments " +"``self``, ``cmd``." msgstr "" "引發一個附帶引數 ``self``、``cmd`` 的\\ :ref:`稽核事件 ` ``ftplib." "sendcmd``。" diff --git a/library/functions.po b/library/functions.po index 1192f2c527..4d9586045c 100644 --- a/library/functions.po +++ b/library/functions.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2024-05-06 17:06+0800\n" "Last-Translator: KNChiu \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -549,10 +549,11 @@ msgstr "請注意，如果 :func:`sys.breakpointhook` 被替換了，則無法 #: ../../library/functions.rst:180 #, fuzzy msgid "" -"Raises an auditing event builtins.breakpoint with argument breakpointhook." +"Raises an :ref:`auditing event ` ``builtins.breakpoint`` with " +"argument ``breakpointhook``." msgstr "" -"引發一個附帶引數 ``breakpointhook`` 的\\ :ref:`稽核事件 ` " -"``builtins.breakpoint``。" +"引發一個附帶引數 ``prompt`` 的\\ :ref:`稽核事件 ` ``builtins." +"input``。" #: ../../library/functions.rst:190 msgid "" @@ -837,16 +838,7 @@ msgid "" "parse`." msgstr "如果您想解析 Python 程式碼為 AST 運算式，請參閱 :func:`ast.parse`。" -#: ../../library/functions.rst:343 -#, fuzzy -msgid "" -"Raises an auditing event compile with arguments source and filename. This " -"event may also be raised by implicit compilation." -msgstr "" -"引發一個附帶引數 ``source``、``filename`` 的\\ :ref:`稽核事件 ` " -"``compile``。此事件也可能由隱式編譯 (implicit compilation) 所引發。" - -#: ../../library/functions.rst:345 +#: ../../library/functions.rst:343 ../../library/functions.rst:345 msgid "" "Raises an :ref:`auditing event ` ``compile`` with arguments " "``source`` and ``filename``. This event may also be raised by implicit " @@ -1214,16 +1206,8 @@ msgstr "" "另外可以參閱 :func:`ast.literal_eval`，該函式可以安全執行僅包含文字的運算式字" "串。" -#: ../../library/functions.rst:626 ../../library/functions.rst:671 -#, fuzzy -msgid "" -"Raises an auditing event exec with the code object as the argument. Code " -"compilation events may also be raised." -msgstr "" -"引發一個附帶程式碼物件為引數的\\ :ref:`稽核事件 ` ``exec``。也可能" -"會引發程式碼編譯事件。" - -#: ../../library/functions.rst:628 ../../library/functions.rst:673 +#: ../../library/functions.rst:626 ../../library/functions.rst:628 +#: ../../library/functions.rst:671 ../../library/functions.rst:673 msgid "" "Raises an :ref:`auditing event ` ``exec`` with the code object as " "the argument. Code compilation events may also be raised." @@ -1627,9 +1611,12 @@ msgstr "這是該物件在記憶體中的位址。" #: ../../library/functions.rst:929 #, fuzzy -msgid "Raises an auditing event builtins.id with argument id." +msgid "" +"Raises an :ref:`auditing event ` ``builtins.id`` with argument " +"``id``." msgstr "" -"引發一個附帶引數 ``id`` 的\\ :ref:`稽核事件 ` ``builtins.id``。" +"引發一個附帶引數 ``prompt`` 的\\ :ref:`稽核事件 ` ``builtins." +"input``。" #: ../../library/functions.rst:935 msgid "" @@ -1650,16 +1637,7 @@ msgstr "" "如果載入了 :mod:`readline` module，:func:`input` 將使用它來提供複雜的行編輯和" "歷史記錄功能。" -#: ../../library/functions.rst:948 -#, fuzzy -msgid "" -"Raises an auditing event builtins.input with argument prompt before reading " -"input" -msgstr "" -"引發一個附帶讀取輸入前的引數 ``prompt`` 的\\ :ref:`稽核事件 ` " -"``builtins.input``。" - -#: ../../library/functions.rst:950 +#: ../../library/functions.rst:948 ../../library/functions.rst:950 msgid "" "Raises an :ref:`auditing event ` ``builtins.input`` with argument " "``prompt`` before reading input" @@ -1667,16 +1645,7 @@ msgstr "" "引發一個附帶讀取輸入前的引數 ``prompt`` 的\\ :ref:`稽核事件 ` " "``builtins.input``。" -#: ../../library/functions.rst:953 -#, fuzzy -msgid "" -"Raises an auditing event builtins.input/result with the result after " -"successfully reading input." -msgstr "" -"引發一個附帶成功讀取結果的\\ :ref:`稽核事件 ` ``builtins.input/" -"result``。" - -#: ../../library/functions.rst:955 +#: ../../library/functions.rst:953 ../../library/functions.rst:955 msgid "" "Raises an :ref:`auditing event ` ``builtins.input/result`` with " "the result after successfully reading input." @@ -2428,10 +2397,12 @@ msgstr "" #: ../../library/functions.rst:1443 #, fuzzy -msgid "Raises an auditing event open with arguments path, mode, flags." +msgid "" +"Raises an :ref:`auditing event ` ``open`` with arguments ``path``, " +"``mode``, ``flags``." msgstr "" -"引發一個附帶引數 ``path``、``model``、``path`` 的\\ :ref:`稽核事件 " -"` ``open``。" +"引發一個附帶引數 ``source``、``filename`` 的\\ :ref:`稽核事件 ` " +"``compile``。" #: ../../library/functions.rst:1445 msgid "" @@ -3446,12 +3417,55 @@ msgstr "import（引入）" msgid "builtins" msgstr "builtins（內建）" +#, fuzzy #~ msgid "" -#~ "Raises an :ref:`auditing event ` ``compile`` with arguments " -#~ "``source``, ``filename``." +#~ "Raises an auditing event builtins.breakpoint with argument breakpointhook." +#~ msgstr "" +#~ "引發一個附帶引數 ``breakpointhook`` 的\\ :ref:`稽核事件 ` " +#~ "``builtins.breakpoint``。" + +#, fuzzy +#~ msgid "" +#~ "Raises an auditing event compile with arguments source and filename. This " +#~ "event may also be raised by implicit compilation." #~ msgstr "" #~ "引發一個附帶引數 ``source``、``filename`` 的\\ :ref:`稽核事件 ` " -#~ "``compile``。" +#~ "``compile``。此事件也可能由隱式編譯 (implicit compilation) 所引發。" + +#, fuzzy +#~ msgid "" +#~ "Raises an auditing event exec with the code object as the argument. Code " +#~ "compilation events may also be raised." +#~ msgstr "" +#~ "引發一個附帶程式碼物件為引數的\\ :ref:`稽核事件 ` ``exec``。也可" +#~ "能會引發程式碼編譯事件。" + +#, fuzzy +#~ msgid "Raises an auditing event builtins.id with argument id." +#~ msgstr "" +#~ "引發一個附帶引數 ``id`` 的\\ :ref:`稽核事件 ` ``builtins.id``。" + +#, fuzzy +#~ msgid "" +#~ "Raises an auditing event builtins.input with argument prompt before " +#~ "reading input" +#~ msgstr "" +#~ "引發一個附帶讀取輸入前的引數 ``prompt`` 的\\ :ref:`稽核事件 ` " +#~ "``builtins.input``。" + +#, fuzzy +#~ msgid "" +#~ "Raises an auditing event builtins.input/result with the result after " +#~ "successfully reading input." +#~ msgstr "" +#~ "引發一個附帶成功讀取結果的\\ :ref:`稽核事件 ` ``builtins.input/" +#~ "result``。" + +#, fuzzy +#~ msgid "Raises an auditing event open with arguments path, mode, flags." +#~ msgstr "" +#~ "引發一個附帶引數 ``path``、``model``、``path`` 的\\ :ref:`稽核事件 " +#~ "` ``open``。" #~ msgid "" #~ "Raises an :ref:`auditing event ` ``exec`` with argument " @@ -3460,13 +3474,6 @@ msgstr "builtins（內建）" #~ "引發一個附帶引數 ``code_object`` 的\\ :ref:`稽核事件 ` " #~ "``exec``。" -#~ msgid "" -#~ "Raises an :ref:`auditing event ` ``builtins.input`` with " -#~ "argument ``prompt``." -#~ msgstr "" -#~ "引發一個附帶引數 ``prompt`` 的\\ :ref:`稽核事件 ` ``builtins." -#~ "input``。" - #~ msgid "" #~ "Raises an :ref:`auditing event ` ``builtins.input/result`` with " #~ "argument ``result``." diff --git a/library/gc.po b/library/gc.po index 5392bccf09..02cc0e017b 100644 --- a/library/gc.po +++ b/library/gc.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2023-04-24 21:25+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -120,7 +120,9 @@ msgstr "新增 *generation* 參數。" #: ../../library/gc.rst:78 #, fuzzy -msgid "Raises an auditing event gc.get_objects with argument generation." +msgid "" +"Raises an :ref:`auditing event ` ``gc.get_objects`` with argument " +"``generation``." msgstr "" "引發一個附帶引數 ``generation`` 的\\ :ref:`稽核事件 (auditing event) " "` ``gc.get_objects``。" @@ -235,7 +237,9 @@ msgstr "" #: ../../library/gc.rst:149 #, fuzzy -msgid "Raises an auditing event gc.get_referrers with argument objs." +msgid "" +"Raises an :ref:`auditing event ` ``gc.get_referrers`` with " +"argument ``objs``." msgstr "" "引發一個附帶引數 ``objs`` 的\\ :ref:`稽核事件 ` ``gc." "get_referrers``。" @@ -260,7 +264,9 @@ msgstr "" #: ../../library/gc.rst:162 #, fuzzy -msgid "Raises an auditing event gc.get_referents with argument objs." +msgid "" +"Raises an :ref:`auditing event ` ``gc.get_referents`` with " +"argument ``objs``." msgstr "" "引發一個附帶引數 ``objs`` 的\\ :ref:`稽核事件 ` ``gc." "get_referents``。" diff --git a/library/glob.po b/library/glob.po index ac79936420..5d101d2899 100644 --- a/library/glob.po +++ b/library/glob.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2023-01-24 01:21+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -119,7 +119,9 @@ msgstr "如果 *include_hidden* 為真，\"``**``\" 模式將匹配被隱藏的 #: ../../library/glob.rst:73 ../../library/glob.rst:100 #, fuzzy -msgid "Raises an auditing event glob.glob with arguments pathname, recursive." +msgid "" +"Raises an :ref:`auditing event ` ``glob.glob`` with arguments " +"``pathname``, ``recursive``." msgstr "" "引發一個附帶引數 ``pathname``、``recursive`` 的\\ :ref:`稽核事件 ` " "``glob.glob``。" @@ -127,8 +129,8 @@ msgstr "" #: ../../library/glob.rst:74 ../../library/glob.rst:101 #, fuzzy msgid "" -"Raises an auditing event glob.glob/2 with arguments pathname, recursive, " -"root_dir, dir_fd." +"Raises an :ref:`auditing event ` ``glob.glob/2`` with arguments " +"``pathname``, ``recursive``, ``root_dir``, ``dir_fd``." msgstr "" "引發一個附帶引數 ``pathname``、``recursive``、``root_dir``、``dir_fd`` 的\\ :" "ref:`稽核事件 ` ``glob.glob/2``。" diff --git a/library/http.client.po b/library/http.client.po index 10051a3e80..a55e0d45dd 100644 --- a/library/http.client.po +++ b/library/http.client.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:03+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -446,7 +446,8 @@ msgstr "" #: ../../library/http.client.rst:404 #, fuzzy msgid "" -"Raises an auditing event http.client.connect with arguments self, host, port." +"Raises an :ref:`auditing event ` ``http.client.connect`` with " +"arguments ``self``, ``host``, ``port``." msgstr "" "引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " "` ``http.client.connect``。" @@ -524,7 +525,9 @@ msgstr "" #: ../../library/http.client.rst:474 #, fuzzy -msgid "Raises an auditing event http.client.send with arguments self, data." +msgid "" +"Raises an :ref:`auditing event ` ``http.client.send`` with " +"arguments ``self``, ``data``." msgstr "" "引發一個附帶引數 ``self``、``data`` 的\\ :ref:`稽核事件 ` ``http." "client.send``。" diff --git a/library/imaplib.po b/library/imaplib.po index b6490a1591..e8425cd390 100644 --- a/library/imaplib.po +++ b/library/imaplib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:04+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -421,7 +421,9 @@ msgstr "" #: ../../library/imaplib.rst:371 #, fuzzy -msgid "Raises an auditing event imaplib.open with arguments self, host, port." +msgid "" +"Raises an :ref:`auditing event ` ``imaplib.open`` with arguments " +"``self``, ``host``, ``port``." msgstr "" "引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " "` ``imaplib.open``。" @@ -494,7 +496,9 @@ msgstr "" #: ../../library/imaplib.rst:444 #, fuzzy -msgid "Raises an auditing event imaplib.send with arguments self, data." +msgid "" +"Raises an :ref:`auditing event ` ``imaplib.send`` with arguments " +"``self``, ``data``." msgstr "" "引發一個附帶引數 ``self``、``data`` 的\\ :ref:`稽核事件 ` " "``imaplib.send``。" diff --git a/library/io.po b/library/io.po index dc289a6a9c..fc294b51d0 100644 --- a/library/io.po +++ b/library/io.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2023-12-08 00:08+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -278,18 +278,7 @@ msgstr "" msgid "This is an alias for the builtin :func:`open` function." msgstr "這是內建函式 :func:`open` 的別名。" -#: ../../library/io.rst:175 -#, fuzzy -msgid "" -"This function raises an auditing event open with arguments path, mode and " -"flags. The mode and flags arguments may have been modified or inferred from " -"the original call." -msgstr "" -"此函式會引發一個帶有引數 *path*、*mode* 以及 *flags* 的\\ :ref:`稽核事件 " -"(auditing event) ` ``open``。*mode* 與 *flags* 引數可能已經被修改或" -"者從原始呼叫中被推斷出來。" - -#: ../../library/io.rst:177 +#: ../../library/io.rst:175 ../../library/io.rst:177 msgid "" "This function raises an :ref:`auditing event ` ``open`` with " "arguments *path*, *mode* and *flags*. The *mode* and *flags* arguments may " @@ -1823,6 +1812,16 @@ msgstr "io.TextIOWrapper 類別" msgid "io.IncrementalNewlineDecoder class" msgstr "io.IncrementalNewlineDecoder 類別" +#, fuzzy +#~ msgid "" +#~ "This function raises an auditing event open with arguments path, mode and " +#~ "flags. The mode and flags arguments may have been modified or inferred " +#~ "from the original call." +#~ msgstr "" +#~ "此函式會引發一個帶有引數 *path*、*mode* 以及 *flags* 的\\ :ref:`稽核事件 " +#~ "(auditing event) ` ``open``。*mode* 與 *flags* 引數可能已經被修" +#~ "改或者從原始呼叫中被推斷出來。" + #~ msgid "" #~ "Raises an :ref:`auditing event ` ``open`` with arguments " #~ "``path``, ``mode``, ``flags``." diff --git a/library/marshal.po b/library/marshal.po index dd20fa167f..f484936b19 100644 --- a/library/marshal.po +++ b/library/marshal.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2023-04-24 21:28+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -132,7 +132,9 @@ msgstr "*version* 引數指明 ``dump`` 應該使用的資料格式（見下文 #: ../../library/marshal.rst:69 ../../library/marshal.rst:101 #, fuzzy -msgid "Raises an auditing event marshal.dumps with arguments value, version." +msgid "" +"Raises an :ref:`auditing event ` ``marshal.dumps`` with arguments " +"``value``, ``version``." msgstr "" "引發一個附帶引數 ``value`` 與 ``version`` 的\\ :ref:`稽核事件 (auditing " "event) ` ``marshal.dumps``。" @@ -150,7 +152,9 @@ msgstr "" #: ../../library/marshal.rst:79 #, fuzzy -msgid "Raises an auditing event marshal.load with no arguments." +msgid "" +"Raises an :ref:`auditing event ` ``marshal.load`` with no " +"arguments." msgstr "引發一個沒有附帶引數的\\ :ref:`稽核事件 ` ``marshal.load``。" #: ../../library/marshal.rst:83 @@ -197,7 +201,9 @@ msgstr "" #: ../../library/marshal.rst:110 #, fuzzy -msgid "Raises an auditing event marshal.loads with argument bytes." +msgid "" +"Raises an :ref:`auditing event ` ``marshal.loads`` with argument " +"``bytes``." msgstr "" "引發一個附帶引數 ``bytes`` 的\\ :ref:`稽核事件 ` ``marshal." "loads``。" diff --git a/library/mmap.po b/library/mmap.po index 4e991b10e6..8a790454b0 100644 --- a/library/mmap.po +++ b/library/mmap.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:06+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -124,8 +124,8 @@ msgstr "" #: ../../library/mmap.rst:72 ../../library/mmap.rst:163 #, fuzzy msgid "" -"Raises an auditing event mmap.__new__ with arguments fileno, length, access, " -"offset." +"Raises an :ref:`auditing event ` ``mmap.__new__`` with arguments " +"``fileno``, ``length``, ``access``, ``offset``." msgstr "" "引發一個附帶引數 ``fileno``、``length``、``access``、``offset`` 的\\ :ref:`稽" "核事件 ` ``mmap.__new__``。" diff --git a/library/msvcrt.po b/library/msvcrt.po index 88906ec139..fa09c8e737 100644 --- a/library/msvcrt.po +++ b/library/msvcrt.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:06+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -68,7 +68,8 @@ msgstr "" #: ../../library/msvcrt.rst:45 #, fuzzy msgid "" -"Raises an auditing event msvcrt.locking with arguments fd, mode, nbytes." +"Raises an :ref:`auditing event ` ``msvcrt.locking`` with arguments " +"``fd``, ``mode``, ``nbytes``." msgstr "" "引發一個附帶引數 ``fd``、``mode``、``nbytes`` 的\\ :ref:`稽核事件 " "` ``msvcrt.locking``。" @@ -108,7 +109,8 @@ msgstr "" #: ../../library/msvcrt.rst:82 #, fuzzy msgid "" -"Raises an auditing event msvcrt.open_osfhandle with arguments handle, flags." +"Raises an :ref:`auditing event ` ``msvcrt.open_osfhandle`` with " +"arguments ``handle``, ``flags``." msgstr "" "引發一個附帶引數 ``arguments``、``handle``、``flags`` 的\\ :ref:`稽核事件 " "` ``msvcrt.open_osfhandle``。" @@ -121,7 +123,9 @@ msgstr "" #: ../../library/msvcrt.rst:90 #, fuzzy -msgid "Raises an auditing event msvcrt.get_osfhandle with argument fd." +msgid "" +"Raises an :ref:`auditing event ` ``msvcrt.get_osfhandle`` with " +"argument ``fd``." msgstr "" "引發一個附帶引數 ``fd`` 的\\ :ref:`稽核事件 ` ``msvcrt." "get_osfhandle``。" diff --git a/library/nntplib.po b/library/nntplib.po index ae18e59a00..222123b746 100644 --- a/library/nntplib.po +++ b/library/nntplib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:06+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -88,18 +88,14 @@ msgstr "" #: ../../library/nntplib.rst:105 ../../library/nntplib.rst:137 #, fuzzy msgid "" -"Raises an auditing event nntplib.connect with arguments self, host, port." +"Raises an :ref:`auditing event ` ``nntplib.connect`` with " +"arguments ``self``, ``host``, ``port``." msgstr "" -"引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " -"` ``nntplib.connect``。" +"引發一個附帶引數 ``self``、``line`` 的\\ :ref:`稽核事件 ` " +"``nntplib.putline``。" -#: ../../library/nntplib.rst:107 ../../library/nntplib.rst:139 -msgid "" -"All commands will raise an auditing event nntplib.putline with arguments " -"self and line, where line is the bytes about to be sent to the remote host." -msgstr "" - -#: ../../library/nntplib.rst:109 ../../library/nntplib.rst:141 +#: ../../library/nntplib.rst:107 ../../library/nntplib.rst:109 +#: ../../library/nntplib.rst:139 ../../library/nntplib.rst:141 msgid "" "All commands will raise an :ref:`auditing event ` ``nntplib." "putline`` with arguments ``self`` and ``line``, where ``line`` is the bytes " @@ -587,9 +583,9 @@ msgstr "protocol（協定）" msgid "Network News Transfer Protocol" msgstr "Network News Transfer Protocol（網路新聞傳輸協定）" +#, fuzzy #~ msgid "" -#~ "Raises an :ref:`auditing event ` ``nntplib.putline`` with " -#~ "arguments ``self``, ``line``." +#~ "Raises an auditing event nntplib.connect with arguments self, host, port." #~ msgstr "" -#~ "引發一個附帶引數 ``self``、``line`` 的\\ :ref:`稽核事件 ` " -#~ "``nntplib.putline``。" +#~ "引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " +#~ "` ``nntplib.connect``。" diff --git a/library/os.path.po b/library/os.path.po index bebb9f8a44..810a3795fa 100644 --- a/library/os.path.po +++ b/library/os.path.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2023-07-13 14:06+0800\n" "Last-Translator: Po-Chuan Chen \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -138,10 +138,11 @@ msgstr "" "`basename` 函式回傳空字串（``''``）。" #: ../../library/os.path.rst:82 +#, fuzzy msgid "" "Return the longest common sub-path of each pathname in the sequence " "*paths*. Raise :exc:`ValueError` if *paths* contain both absolute and " -"relative pathnames, the *paths* are on the different drives or if *paths* is " +"relative pathnames, if *paths* are on different drives, or if *paths* is " "empty. Unlike :func:`commonprefix`, this returns a valid path." msgstr "" "回傳序列 *paths* 中每個路徑名的最長共同子路徑。如果 *paths* 同時包含絕對路徑" diff --git a/library/os.po b/library/os.po index 89288a3ca3..41c0d93ed9 100644 --- a/library/os.po +++ b/library/os.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2024-04-29 15:24+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -707,7 +707,9 @@ msgstr "" #: ../../library/os.rst:569 #, fuzzy -msgid "Raises an auditing event os.putenv with arguments key, value." +msgid "" +"Raises an :ref:`auditing event ` ``os.putenv`` with arguments " +"``key``, ``value``." msgstr "" "引發一個附帶引數 ``key``、``value`` 的\\ :ref:`稽核事件 ` ``os." "putenv``。" @@ -929,7 +931,9 @@ msgstr "" #: ../../library/os.rst:807 #, fuzzy -msgid "Raises an auditing event os.unsetenv with argument key." +msgid "" +"Raises an :ref:`auditing event ` ``os.unsetenv`` with argument " +"``key``." msgstr "" "引發一個附帶引數 ``key`` 的\\ :ref:`稽核事件 ` ``os.unsetenv``。" @@ -1137,7 +1141,9 @@ msgstr "" #: ../../library/os.rst:1002 ../../library/os.rst:2069 #: ../../library/os.rst:2166 #, fuzzy -msgid "Raises an auditing event os.chmod with arguments path, mode, dir_fd." +msgid "" +"Raises an :ref:`auditing event ` ``os.chmod`` with arguments " +"``path``, ``mode``, ``dir_fd``." msgstr "" "引發一個附帶引數 ``path``、``mode``、``dir_fd`` 的\\ :ref:`稽核事件 " "` ``os.chmod``。" @@ -1162,7 +1168,8 @@ msgstr "" #: ../../library/os.rst:2179 #, fuzzy msgid "" -"Raises an auditing event os.chown with arguments path, uid, gid, dir_fd." +"Raises an :ref:`auditing event ` ``os.chown`` with arguments " +"``path``, ``uid``, ``gid``, ``dir_fd``." msgstr "" "引發一個附帶引數 ``path``、``uid``、``gid``、``dir_fd`` 的\\ :ref:`稽核事件 " "` ``os.chown``。" @@ -1244,7 +1251,9 @@ msgstr "" #: ../../library/os.rst:1095 #, fuzzy -msgid "Raises an auditing event os.truncate with arguments fd, length." +msgid "" +"Raises an :ref:`auditing event ` ``os.truncate`` with arguments " +"``fd``, ``length``." msgstr "" "引發一個附帶引數 ``fd``、``length`` 的\\ :ref:`稽核事件 ` ``os." "truncate``。" @@ -1287,7 +1296,9 @@ msgstr "" #: ../../library/os.rst:1136 #, fuzzy -msgid "Raises an auditing event os.lockf with arguments fd, cmd, len." +msgid "" +"Raises an :ref:`auditing event ` ``os.lockf`` with arguments " +"``fd``, ``cmd``, ``len``." msgstr "" "引發一個附帶引數 ``fd``、``length`` 的\\ :ref:`稽核事件 ` ``os." "truncate``。" @@ -1432,7 +1443,9 @@ msgstr "" #: ../../library/os.rst:1242 #, fuzzy -msgid "Raises an auditing event open with arguments path, mode, flags." +msgid "" +"Raises an :ref:`auditing event ` ``open`` with arguments ``path``, " +"``mode``, ``flags``." msgstr "" "引發一個附帶引數 ``path``、``mode``、``flags`` 的\\ :ref:`稽核事件 " "` ``open``。" @@ -2171,7 +2184,9 @@ msgstr "" #: ../../library/os.rst:1989 ../../library/os.rst:2122 #, fuzzy -msgid "Raises an auditing event os.chdir with argument path." +msgid "" +"Raises an :ref:`auditing event ` ``os.chdir`` with argument " +"``path``." msgstr "" "引發一個附帶引數 ``path`` 的\\ :ref:`稽核事件 ` ``os.chdir``。" @@ -2242,7 +2257,9 @@ msgstr "" #: ../../library/os.rst:2019 ../../library/os.rst:2148 #, fuzzy -msgid "Raises an auditing event os.chflags with arguments path, flags." +msgid "" +"Raises an :ref:`auditing event ` ``os.chflags`` with arguments " +"``path``, ``flags``." msgstr "" "引發一個附帶引數 ``path``、``flags`` 的\\ :ref:`稽核事件 ` ``os." "chflags``。" @@ -2447,8 +2464,8 @@ msgstr "" #: ../../library/os.rst:2195 #, fuzzy msgid "" -"Raises an auditing event os.link with arguments src, dst, src_dir_fd, " -"dst_dir_fd." +"Raises an :ref:`auditing event ` ``os.link`` with arguments " +"``src``, ``dst``, ``src_dir_fd``, ``dst_dir_fd``." msgstr "" "引發一個附帶引數 ``src``、``dst``、``src_dir_fd``、``dst_dir_fd`` 的\\ :ref:`" "稽核事件 ` ``os.link``。" @@ -2495,7 +2512,9 @@ msgstr "" #: ../../library/os.rst:2225 #, fuzzy -msgid "Raises an auditing event os.listdir with argument path." +msgid "" +"Raises an :ref:`auditing event ` ``os.listdir`` with argument " +"``path``." msgstr "" "引發一個附帶引數 ``path`` 的\\ :ref:`稽核事件 ` ``os.listdir``。" @@ -2535,7 +2554,9 @@ msgstr "" #: ../../library/os.rst:2258 #, fuzzy -msgid "Raises an auditing event os.listdrives with no arguments." +msgid "" +"Raises an :ref:`auditing event ` ``os.listdrives`` with no " +"arguments." msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``os.listdrives``。" #: ../../library/os.rst:2260 ../../library/os.rst:2284 @@ -2570,7 +2591,9 @@ msgstr "" #: ../../library/os.rst:2282 #, fuzzy -msgid "Raises an auditing event os.listmounts with argument volume." +msgid "" +"Raises an :ref:`auditing event ` ``os.listmounts`` with argument " +"``volume``." msgstr "" "引發一個附帶引數 ``volume`` 的\\ :ref:`稽核事件 ` ``os." "listmounts``。" @@ -2594,7 +2617,9 @@ msgstr "" #: ../../library/os.rst:2302 #, fuzzy -msgid "Raises an auditing event os.listvolumes with no arguments." +msgid "" +"Raises an :ref:`auditing event ` ``os.listvolumes`` with no " +"arguments." msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``os.listvolumes``。" #: ../../library/os.rst:2311 @@ -2672,7 +2697,9 @@ msgstr "" #: ../../library/os.rst:2369 ../../library/os.rst:2406 #, fuzzy -msgid "Raises an auditing event os.mkdir with arguments path, mode, dir_fd." +msgid "" +"Raises an :ref:`auditing event ` ``os.mkdir`` with arguments " +"``path``, ``mode``, ``dir_fd``." msgstr "" "引發一個附帶引數 ``path``、``mode``、``dir_fd`` 的\\ :ref:`稽核事件 " "` ``os.mkdir``。" @@ -2863,7 +2890,9 @@ msgstr "" #: ../../library/os.rst:2573 ../../library/os.rst:2595 #: ../../library/os.rst:3437 #, fuzzy -msgid "Raises an auditing event os.remove with arguments path, dir_fd." +msgid "" +"Raises an :ref:`auditing event ` ``os.remove`` with arguments " +"``path``, ``dir_fd``." msgstr "" "引發一個附帶引數 ``path``、``dir_fd`` 的\\ :ref:`稽核事件 ` ``os." "remove``。" @@ -2921,8 +2950,8 @@ msgstr "" #: ../../library/os.rst:2662 #, fuzzy msgid "" -"Raises an auditing event os.rename with arguments src, dst, src_dir_fd, " -"dst_dir_fd." +"Raises an :ref:`auditing event ` ``os.rename`` with arguments " +"``src``, ``dst``, ``src_dir_fd``, ``dst_dir_fd``." msgstr "" "引發一個附帶引數 ``src``、``dst``、``src_dir_fd``、``dst_dir_fd`` 的\\ :ref:`" "稽核事件 ` ``os.rename``。" @@ -2969,7 +2998,9 @@ msgstr "" #: ../../library/os.rst:2680 #, fuzzy -msgid "Raises an auditing event os.rmdir with arguments path, dir_fd." +msgid "" +"Raises an :ref:`auditing event ` ``os.rmdir`` with arguments " +"``path``, ``dir_fd``." msgstr "" "引發一個附帶引數 ``path``、``dir_fd`` 的\\ :ref:`稽核事件 ` ``os." "rmdir``。" @@ -3007,7 +3038,9 @@ msgstr "" #: ../../library/os.rst:2717 #, fuzzy -msgid "Raises an auditing event os.scandir with argument path." +msgid "" +"Raises an :ref:`auditing event ` ``os.scandir`` with argument " +"``path``." msgstr "" "引發一個附帶引數 ``path`` 的\\ :ref:`稽核事件 ` ``os.scandir``。" @@ -3794,7 +3827,9 @@ msgstr "" #: ../../library/os.rst:3380 #, fuzzy -msgid "Raises an auditing event os.symlink with arguments src, dst, dir_fd." +msgid "" +"Raises an :ref:`auditing event ` ``os.symlink`` with arguments " +"``src``, ``dst``, ``dir_fd``." msgstr "" "引發一個附帶引數 ``src``、``dst``、``dir_fd`` 的\\ :ref:`稽核事件 " "` ``os.symlink``。" @@ -3821,7 +3856,9 @@ msgstr "" #: ../../library/os.rst:3417 #, fuzzy -msgid "Raises an auditing event os.truncate with arguments path, length." +msgid "" +"Raises an :ref:`auditing event ` ``os.truncate`` with arguments " +"``path``, ``length``." msgstr "" "引發一個附帶引數 ``path``、``length`` 的\\ :ref:`稽核事件 ` ``os." "truncate``。" @@ -3878,7 +3915,8 @@ msgstr "" #: ../../library/os.rst:3476 #, fuzzy msgid "" -"Raises an auditing event os.utime with arguments path, times, ns, dir_fd." +"Raises an :ref:`auditing event ` ``os.utime`` with arguments " +"``path``, ``times``, ``ns``, ``dir_fd``." msgstr "" "引發一個附帶引數 ``path``、``times``、``ns``、``dir_fd`` 的\\ :ref:`稽核事件 " "` ``os.utime``。" @@ -3983,8 +4021,8 @@ msgstr "" #: ../../library/os.rst:3575 #, fuzzy msgid "" -"Raises an auditing event os.walk with arguments top, topdown, onerror, " -"followlinks." +"Raises an :ref:`auditing event ` ``os.walk`` with arguments " +"``top``, ``topdown``, ``onerror``, ``followlinks``." msgstr "" "引發一個附帶引數 ``top``、``topdown``、``onerror``、``followlinks`` 的\\ :" "ref:`稽核事件 ` ``os.walk``。" @@ -4031,8 +4069,8 @@ msgstr "" #: ../../library/os.rst:3636 #, fuzzy msgid "" -"Raises an auditing event os.fwalk with arguments top, topdown, onerror, " -"follow_symlinks, dir_fd." +"Raises an :ref:`auditing event ` ``os.fwalk`` with arguments " +"``top``, ``topdown``, ``onerror``, ``follow_symlinks``, ``dir_fd``." msgstr "" "引發一個附帶引數 ``top``、``topdown``、``onerror``、``follow_symlinks``、" "``dir_fd`` 的\\ :ref:`稽核事件 ` ``os.fwalk``。" @@ -4182,7 +4220,9 @@ msgstr "" #: ../../library/os.rst:3808 #, fuzzy -msgid "Raises an auditing event os.getxattr with arguments path, attribute." +msgid "" +"Raises an :ref:`auditing event ` ``os.getxattr`` with arguments " +"``path``, ``attribute``." msgstr "" "引發一個附帶引數 ``path``、``attribute`` 的\\ :ref:`稽核事件 ` " "``os.getxattr``。" @@ -4202,7 +4242,9 @@ msgstr "" #: ../../library/os.rst:3824 #, fuzzy -msgid "Raises an auditing event os.listxattr with argument path." +msgid "" +"Raises an :ref:`auditing event ` ``os.listxattr`` with argument " +"``path``." msgstr "" "引發一個附帶引數 ``path`` 的\\ :ref:`稽核事件 ` ``os.listxattr``。" @@ -4216,7 +4258,9 @@ msgstr "" #: ../../library/os.rst:3840 #, fuzzy -msgid "Raises an auditing event os.removexattr with arguments path, attribute." +msgid "" +"Raises an :ref:`auditing event ` ``os.removexattr`` with arguments " +"``path``, ``attribute``." msgstr "" "引發一個附帶引數 ``path``、``attribute`` 的\\ :ref:`稽核事件 ` " "``os.removexattr``。" @@ -4242,8 +4286,8 @@ msgstr "" #: ../../library/os.rst:3865 #, fuzzy msgid "" -"Raises an auditing event os.setxattr with arguments path, attribute, value, " -"flags." +"Raises an :ref:`auditing event ` ``os.setxattr`` with arguments " +"``path``, ``attribute``, ``value``, ``flags``." msgstr "" "引發一個附帶引數 ``path``、``attribute``、``value``、``flags`` 的\\ :ref:`稽" "核事件 ` ``os.setxattr``。" @@ -4320,7 +4364,9 @@ msgstr "" #: ../../library/os.rst:3929 #, fuzzy -msgid "Raises an auditing event os.add_dll_directory with argument path." +msgid "" +"Raises an :ref:`auditing event ` ``os.add_dll_directory`` with " +"argument ``path``." msgstr "" "引發一個附帶引數 ``path`` 的\\ :ref:`稽核事件 ` ``os." "add_dll_directory``。" @@ -4404,7 +4450,9 @@ msgstr "" #: ../../library/os.rst:3998 #, fuzzy -msgid "Raises an auditing event os.exec with arguments path, args, env." +msgid "" +"Raises an :ref:`auditing event ` ``os.exec`` with arguments " +"``path``, ``args``, ``env``." msgstr "" "引發一個附帶引數 ``path``、``args``、``env`` 的\\ :ref:`稽核事件 ` " "``os.exec``。" @@ -4540,7 +4588,8 @@ msgstr "" #: ../../library/os.rst:4165 #, fuzzy -msgid "Raises an auditing event os.fork with no arguments." +msgid "" +"Raises an :ref:`auditing event ` ``os.fork`` with no arguments." msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``os.fork``。" #: ../../library/os.rst:4169 @@ -4607,7 +4656,8 @@ msgstr "" #: ../../library/os.rst:4214 #, fuzzy -msgid "Raises an auditing event os.forkpty with no arguments." +msgid "" +"Raises an :ref:`auditing event ` ``os.forkpty`` with no arguments." msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``os.forkpty``。" #: ../../library/os.rst:4221 @@ -4646,7 +4696,9 @@ msgstr "另請參閱 :func:`signal.pthread_kill`。" #: ../../library/os.rst:4252 #, fuzzy -msgid "Raises an auditing event os.kill with arguments pid, sig." +msgid "" +"Raises an :ref:`auditing event ` ``os.kill`` with arguments " +"``pid``, ``sig``." msgstr "" "引發一個附帶引數 ``pid``、``sig`` 的\\ :ref:`稽核事件 ` ``os." "kill``。" @@ -4657,7 +4709,9 @@ msgstr "" #: ../../library/os.rst:4268 #, fuzzy -msgid "Raises an auditing event os.killpg with arguments pgid, sig." +msgid "" +"Raises an :ref:`auditing event ` ``os.killpg`` with arguments " +"``pgid``, ``sig``." msgstr "" "引發一個附帶引數 ``pgid``、``sig`` 的\\ :ref:`稽核事件 ` ``os." "killpg``。" @@ -4872,7 +4926,9 @@ msgstr "" #: ../../library/os.rst:4430 ../../library/os.rst:4446 #, fuzzy -msgid "Raises an auditing event os.posix_spawn with arguments path, argv, env." +msgid "" +"Raises an :ref:`auditing event ` ``os.posix_spawn`` with arguments " +"``path``, ``argv``, ``env``." msgstr "" "引發一個附帶引數 ``path``、``argv``、``env`` 的\\ :ref:`稽核事件 ` " "``os.posix_spawn``。" @@ -5010,7 +5066,9 @@ msgstr "" #: ../../library/os.rst:4550 #, fuzzy -msgid "Raises an auditing event os.spawn with arguments mode, path, args, env." +msgid "" +"Raises an :ref:`auditing event ` ``os.spawn`` with arguments " +"``mode``, ``path``, ``args``, ``env``." msgstr "" "引發一個附帶引數 ``mode``、``path``、``args``、``env`` 的\\ :ref:`稽核事件 " "` ``os.spawn``。" @@ -5111,7 +5169,9 @@ msgstr "" #: ../../library/os.rst:4635 #, fuzzy -msgid "Raises an auditing event os.startfile with arguments path, operation." +msgid "" +"Raises an :ref:`auditing event ` ``os.startfile`` with arguments " +"``path``, ``operation``." msgstr "" "引發一個附帶引數 ``path``、``operation`` 的\\ :ref:`稽核事件 ` " "``os.startfile``。" @@ -5119,8 +5179,8 @@ msgstr "" #: ../../library/os.rst:4637 #, fuzzy msgid "" -"Raises an auditing event os.startfile/2 with arguments path, operation, " -"arguments, cwd, show_cmd." +"Raises an :ref:`auditing event ` ``os.startfile/2`` with arguments " +"``path``, ``operation``, ``arguments``, ``cwd``, ``show_cmd``." msgstr "" "引發一個附帶引數 ``path``、``operation``、``arguments``、``cwd``、" "``show_cmd`` 的\\ :ref:`稽核事件 ` ``os.startfile/2``。" @@ -5174,7 +5234,9 @@ msgstr "" #: ../../library/os.rst:4674 #, fuzzy -msgid "Raises an auditing event os.system with argument command." +msgid "" +"Raises an :ref:`auditing event ` ``os.system`` with argument " +"``command``." msgstr "" "引發一個附帶引數 ``command`` 的\\ :ref:`稽核事件 ` ``os.system``。" diff --git a/library/pathlib.po b/library/pathlib.po index a5fba7002f..8c3c876318 100644 --- a/library/pathlib.po +++ b/library/pathlib.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2024-02-29 20:49+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1045,7 +1045,8 @@ msgstr "在很大的目錄樹裡使用 \"``**``\" 可能會耗費過多的時間 #: ../../library/pathlib.rst:1206 #, fuzzy msgid "" -"Raises an auditing event pathlib.Path.glob with arguments self, pattern." +"Raises an :ref:`auditing event ` ``pathlib.Path.glob`` with " +"arguments ``self``, ``pattern``." msgstr "" "引發一個附帶引數 ``self``、``pattern`` 的\\ :ref:`稽核事件 ` " "``pathlib.Path.glob``。" @@ -1071,7 +1072,8 @@ msgstr "" #: ../../library/pathlib.rst:1234 #, fuzzy msgid "" -"Raises an auditing event pathlib.Path.rglob with arguments self, pattern." +"Raises an :ref:`auditing event ` ``pathlib.Path.rglob`` with " +"arguments ``self``, ``pattern``." msgstr "" "引發一個附帶引數 ``self``、``pattern`` 的\\ :ref:`稽核事件 ` " "``pathlib.Path.rglob``。" diff --git a/library/pdb.po b/library/pdb.po index 06f705bb48..8d5700c923 100644 --- a/library/pdb.po +++ b/library/pdb.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:07+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -237,7 +237,8 @@ msgstr "" #: ../../library/pdb.rst:210 #, fuzzy -msgid "Raises an auditing event pdb.Pdb with no arguments." +msgid "" +"Raises an :ref:`auditing event ` ``pdb.Pdb`` with no arguments." msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``pdb.Pdb``。" #: ../../library/pdb.rst:212 diff --git a/library/pickle.po b/library/pickle.po index e841c8738f..7f0a69858e 100644 --- a/library/pickle.po +++ b/library/pickle.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:07+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -617,7 +617,9 @@ msgstr "" #: ../../library/pickle.rst:460 #, fuzzy -msgid "Raises an auditing event pickle.find_class with arguments module, name." +msgid "" +"Raises an :ref:`auditing event ` ``pickle.find_class`` with " +"arguments ``module``, ``name``." msgstr "" "引發一個附帶引數 ``module``、``name`` 的\\ :ref:`稽核事件 ` " "``pickle.find_class``。" diff --git a/library/poplib.po b/library/poplib.po index 1e31e1d77c..b5880a033a 100644 --- a/library/poplib.po +++ b/library/poplib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:08+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -80,21 +80,14 @@ msgstr "" #: ../../library/poplib.rst:44 ../../library/poplib.rst:66 #, fuzzy msgid "" -"Raises an auditing event poplib.connect with arguments self, host, port." -msgstr "" -"引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " -"` ``poplib.connect``。" - -#: ../../library/poplib.rst:46 ../../library/poplib.rst:68 -#, fuzzy -msgid "" -"All commands will raise an auditing event poplib.putline with arguments self " -"and line, where line is the bytes about to be sent to the remote host." +"Raises an :ref:`auditing event ` ``poplib.connect`` with arguments " +"``self``, ``host``, ``port``." msgstr "" "引發一個附帶引數 ``self``、``line`` 的\\ :ref:`稽核事件 ` ``poplib." -"putline``。其中 ``line`` 為即將傳送給遠端的位元組。" +"putline``。" -#: ../../library/poplib.rst:48 ../../library/poplib.rst:70 +#: ../../library/poplib.rst:46 ../../library/poplib.rst:48 +#: ../../library/poplib.rst:68 ../../library/poplib.rst:70 msgid "" "All commands will raise an :ref:`auditing event ` ``poplib." "putline`` with arguments ``self`` and ``line``, where ``line`` is the bytes " @@ -337,9 +330,18 @@ msgstr "POP3" msgid "protocol" msgstr "protocol（協定）" +#, fuzzy +#~ msgid "" +#~ "Raises an auditing event poplib.connect with arguments self, host, port." +#~ msgstr "" +#~ "引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " +#~ "` ``poplib.connect``。" + +#, fuzzy #~ msgid "" -#~ "Raises an :ref:`auditing event ` ``poplib.putline`` with " -#~ "arguments ``self``, ``line``." +#~ "All commands will raise an auditing event poplib.putline with arguments " +#~ "self and line, where line is the bytes about to be sent to the remote " +#~ "host." #~ msgstr "" #~ "引發一個附帶引數 ``self``、``line`` 的\\ :ref:`稽核事件 ` " -#~ "``poplib.putline``。" +#~ "``poplib.putline``。其中 ``line`` 為即將傳送給遠端的位元組。" diff --git a/library/pty.po b/library/pty.po index 10383e32ca..c6a507151e 100644 --- a/library/pty.po +++ b/library/pty.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2016-11-19 00:33+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -126,7 +126,9 @@ msgstr "" #: ../../library/pty.rst:82 #, fuzzy -msgid "Raises an auditing event pty.spawn with argument argv." +msgid "" +"Raises an :ref:`auditing event ` ``pty.spawn`` with argument " +"``argv``." msgstr "" "引發一個附帶引數 ``argv`` 的\\ :ref:`稽核事件 ` ``pty.spawn``。" diff --git a/library/resource.po b/library/resource.po index acdd34fb43..3721e26b24 100644 --- a/library/resource.po +++ b/library/resource.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:09+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -117,7 +117,8 @@ msgstr "" #: ../../library/resource.rst:83 #, fuzzy msgid "" -"Raises an auditing event resource.setrlimit with arguments resource, limits." +"Raises an :ref:`auditing event ` ``resource.setrlimit`` with " +"arguments ``resource``, ``limits``." msgstr "" "引發一個附帶引數 ``resource``、``limits`` 的\\ :ref:`稽核事件 ` " "``resource.setrlimit``。" @@ -148,8 +149,8 @@ msgstr "" #: ../../library/resource.rst:102 #, fuzzy msgid "" -"Raises an auditing event resource.prlimit with arguments pid, resource, " -"limits." +"Raises an :ref:`auditing event ` ``resource.prlimit`` with " +"arguments ``pid``, ``resource``, ``limits``." msgstr "" "引發一個附帶引數 ``pid``、``resource``、``limits`` 的\\ :ref:`稽核事件 " "` ``resource.prlimit``。" diff --git a/library/shutil.po b/library/shutil.po index aec28647d0..8beba86a04 100644 --- a/library/shutil.po +++ b/library/shutil.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:10+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -95,7 +95,9 @@ msgstr "" #: ../../library/shutil.rst:70 ../../library/shutil.rst:177 #: ../../library/shutil.rst:208 #, fuzzy -msgid "Raises an auditing event shutil.copyfile with arguments src, dst." +msgid "" +"Raises an :ref:`auditing event ` ``shutil.copyfile`` with " +"arguments ``src``, ``dst``." msgstr "" "引發一個附帶引數 ``src``、``dst`` 的\\ :ref:`稽核事件 ` ``shutil." "copyfile``。" @@ -142,7 +144,9 @@ msgstr "" #: ../../library/shutil.rst:106 ../../library/shutil.rst:179 #, fuzzy -msgid "Raises an auditing event shutil.copymode with arguments src, dst." +msgid "" +"Raises an :ref:`auditing event ` ``shutil.copymode`` with " +"arguments ``src``, ``dst``." msgstr "" "引發一個附帶引數 ``src``、``dst`` 的\\ :ref:`稽核事件 ` ``shutil." "copymode``。" @@ -206,7 +210,9 @@ msgstr "更多資訊請見 :data:`os.supports_follow_symlinks`。" #: ../../library/shutil.rst:153 ../../library/shutil.rst:210 #, fuzzy -msgid "Raises an auditing event shutil.copystat with arguments src, dst." +msgid "" +"Raises an :ref:`auditing event ` ``shutil.copystat`` with " +"arguments ``src``, ``dst``." msgstr "" "引發一個附帶引數 ``src``、``dst`` 的\\ :ref:`稽核事件 ` ``shutil." "copystat``。" @@ -350,7 +356,9 @@ msgstr "" #: ../../library/shutil.rst:275 #, fuzzy -msgid "Raises an auditing event shutil.copytree with arguments src, dst." +msgid "" +"Raises an :ref:`auditing event ` ``shutil.copytree`` with " +"arguments ``src``, ``dst``." msgstr "" "引發一個附帶引數 ``src``、``dst`` 的\\ :ref:`稽核事件 ` ``shutil." "copytree``。" @@ -419,7 +427,9 @@ msgstr "" #: ../../library/shutil.rst:330 #, fuzzy -msgid "Raises an auditing event shutil.rmtree with arguments path, dir_fd." +msgid "" +"Raises an :ref:`auditing event ` ``shutil.rmtree`` with arguments " +"``path``, ``dir_fd``." msgstr "" "引發一個附帶引數 ``path``、``dir_fd`` 的\\ :ref:`稽核事件 ` " "``shutil.rmtree``。" @@ -491,7 +501,9 @@ msgstr "" #: ../../library/shutil.rst:380 #, fuzzy -msgid "Raises an auditing event shutil.move with arguments src, dst." +msgid "" +"Raises an :ref:`auditing event ` ``shutil.move`` with arguments " +"``src``, ``dst``." msgstr "" "引發一個附帶引數 ``src``、``dst`` 的\\ :ref:`稽核事件 ` ``shutil." "move``。" @@ -548,7 +560,9 @@ msgstr "" #: ../../library/shutil.rst:427 #, fuzzy -msgid "Raises an auditing event shutil.chown with arguments path, user, group." +msgid "" +"Raises an :ref:`auditing event ` ``shutil.chown`` with arguments " +"``path``, ``user``, ``group``." msgstr "" "引發一個附帶引數 ``path``、``user``、``group`` 的\\ :ref:`稽核事件 " "` ``shutil.chown``。" @@ -773,8 +787,8 @@ msgstr "" #: ../../library/shutil.rst:616 #, fuzzy msgid "" -"Raises an auditing event shutil.make_archive with arguments base_name, " -"format, root_dir, base_dir." +"Raises an :ref:`auditing event ` ``shutil.make_archive`` with " +"arguments ``base_name``, ``format``, ``root_dir``, ``base_dir``." msgstr "" "引發一個附帶引數 ``base_name``、``format``、``root_dir``、``base_dir`` 的\\ :" "ref:`稽核事件 ` ``shutil.make_archive``。" @@ -910,8 +924,8 @@ msgstr "" #: ../../library/shutil.rst:704 #, fuzzy msgid "" -"Raises an auditing event shutil.unpack_archive with arguments filename, " -"extract_dir, format." +"Raises an :ref:`auditing event ` ``shutil.unpack_archive`` with " +"arguments ``filename``, ``extract_dir``, ``format``." msgstr "" "引發一個附帶引數 ``filename``、``extract_dir``、``format`` 的\\ :ref:`稽核事" "件 ` ``shutil.unpack_archive``。" diff --git a/library/signal.po b/library/signal.po index 6cd3a48235..e0cb35ca69 100644 --- a/library/signal.po +++ b/library/signal.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:10+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -500,8 +500,8 @@ msgstr "" #: ../../library/signal.rst:435 #, fuzzy msgid "" -"Raises an auditing event signal.pthread_kill with arguments thread_id, " -"signalnum." +"Raises an :ref:`auditing event ` ``signal.pthread_kill`` with " +"arguments ``thread_id``, ``signalnum``." msgstr "" "引發一個附帶引數 ``thread_id``、``signalnum`` 的\\ :ref:`稽核事件 " "` ``signal.pthread_kill``。" diff --git a/library/smtplib.po b/library/smtplib.po index 7231713c0d..b41f1e9c53 100644 --- a/library/smtplib.po +++ b/library/smtplib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:10+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -80,16 +80,7 @@ msgid "" "keyword:`!with` statement exits. E.g.::" msgstr "" -#: ../../library/smtplib.rst:59 -#, fuzzy -msgid "" -"All commands will raise an auditing event smtplib.SMTP.send with arguments " -"self and data, where data is the bytes about to be sent to the remote host." -msgstr "" -"所有指令都會引發一個附帶引數 ``self``、``data`` 的\\ :ref:`稽核事件 " -"` ``smtplib.SMTP.send``，其中 ``data`` 為即將傳送至遠端的位元組。" - -#: ../../library/smtplib.rst:61 +#: ../../library/smtplib.rst:59 ../../library/smtplib.rst:61 msgid "" "All commands will raise an :ref:`auditing event ` ``smtplib.SMTP." "send`` with arguments ``self`` and ``data``, where ``data`` is the bytes " @@ -321,7 +312,8 @@ msgstr "" #: ../../library/smtplib.rst:253 #, fuzzy msgid "" -"Raises an auditing event smtplib.connect with arguments self, host, port." +"Raises an :ref:`auditing event ` ``smtplib.connect`` with " +"arguments ``self``, ``host``, ``port``." msgstr "" "引發一個附帶引數 ``self``、``data`` 的\\ :ref:`稽核事件 ` " "``smtplib.send``。" @@ -754,3 +746,13 @@ msgstr "protocol（協定）" #: ../../library/smtplib.rst:11 msgid "Simple Mail Transfer Protocol" msgstr "Simple Mail Transfer Protocol（簡單郵件傳輸協定）" + +#, fuzzy +#~ msgid "" +#~ "All commands will raise an auditing event smtplib.SMTP.send with " +#~ "arguments self and data, where data is the bytes about to be sent to the " +#~ "remote host." +#~ msgstr "" +#~ "所有指令都會引發一個附帶引數 ``self``、``data`` 的\\ :ref:`稽核事件 " +#~ "` ``smtplib.SMTP.send``，其中 ``data`` 為即將傳送至遠端的位元" +#~ "組。" diff --git a/library/socket.po b/library/socket.po index 7875b3431a..0e75960f76 100644 --- a/library/socket.po +++ b/library/socket.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:10+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -894,8 +894,8 @@ msgstr "" #: ../../library/socket.rst:731 #, fuzzy msgid "" -"Raises an auditing event socket.__new__ with arguments self, family, type, " -"protocol." +"Raises an :ref:`auditing event ` ``socket.__new__`` with arguments " +"``self``, ``family``, ``type``, ``protocol``." msgstr "" "引發一個附帶引數 ``self``、``family``、``type``、``protocol`` 的\\ :ref:`稽核" "事件 ` ``socket.__new__``。" @@ -1129,8 +1129,8 @@ msgstr "" #: ../../library/socket.rst:942 #, fuzzy msgid "" -"Raises an auditing event socket.getaddrinfo with arguments host, port, " -"family, type, protocol." +"Raises an :ref:`auditing event ` ``socket.getaddrinfo`` with " +"arguments ``host``, ``port``, ``family``, ``type``, ``protocol``." msgstr "" "引發一個附帶引數 ``host``、``port``、``family``、``type``、``protocol`` 的" "\\ :ref:`稽核事件 ` ``socket.getaddrinfo``。" @@ -1175,7 +1175,9 @@ msgstr "" #: ../../library/socket.rst:980 ../../library/socket.rst:996 #, fuzzy -msgid "Raises an auditing event socket.gethostbyname with argument hostname." +msgid "" +"Raises an :ref:`auditing event ` ``socket.gethostbyname`` with " +"argument ``hostname``." msgstr "" "引發一個附帶引數 ``hostname`` 的\\ :ref:`稽核事件 ` ``socket." "gethostbyname``。" @@ -1211,7 +1213,9 @@ msgstr "" #: ../../library/socket.rst:1006 #, fuzzy -msgid "Raises an auditing event socket.gethostname with no arguments." +msgid "" +"Raises an :ref:`auditing event ` ``socket.gethostname`` with no " +"arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``socket.gethostname``。" @@ -1234,7 +1238,9 @@ msgstr "" #: ../../library/socket.rst:1024 #, fuzzy -msgid "Raises an auditing event socket.gethostbyaddr with argument ip_address." +msgid "" +"Raises an :ref:`auditing event ` ``socket.gethostbyaddr`` with " +"argument ``ip_address``." msgstr "" "引發一個附帶引數 ``ip_address`` 的\\ :ref:`稽核事件 ` ``socket." "gethostbyaddr``。" @@ -1260,7 +1266,9 @@ msgstr "" #: ../../library/socket.rst:1041 #, fuzzy -msgid "Raises an auditing event socket.getnameinfo with argument sockaddr." +msgid "" +"Raises an :ref:`auditing event ` ``socket.getnameinfo`` with " +"argument ``sockaddr``." msgstr "" "引發一個附帶引數 ``sockaddr`` 的\\ :ref:`稽核事件 ` ``socket." "getnameinfo``。" @@ -1284,8 +1292,8 @@ msgstr "" #: ../../library/socket.rst:1063 #, fuzzy msgid "" -"Raises an auditing event socket.getservbyname with arguments servicename, " -"protocolname." +"Raises an :ref:`auditing event ` ``socket.getservbyname`` with " +"arguments ``servicename``, ``protocolname``." msgstr "" "引發一個附帶引數 ``sockaddr``、``protocolname`` 的\\ :ref:`稽核事件 " "` ``socket.getservbyname``。" @@ -1300,8 +1308,8 @@ msgstr "" #: ../../library/socket.rst:1074 #, fuzzy msgid "" -"Raises an auditing event socket.getservbyport with arguments port, " -"protocolname." +"Raises an :ref:`auditing event ` ``socket.getservbyport`` with " +"arguments ``port``, ``protocolname``." msgstr "" "引發一個附帶引數 ``port``、``protocolname`` 的\\ :ref:`稽核事件 ` " "``socket.getservbyport``。" @@ -1491,7 +1499,9 @@ msgstr "" #: ../../library/socket.rst:1261 #, fuzzy -msgid "Raises an auditing event socket.sethostname with argument name." +msgid "" +"Raises an :ref:`auditing event ` ``socket.sethostname`` with " +"argument ``name``." msgstr "" "引發一個附帶引數 ``name`` 的\\ :ref:`稽核事件 ` ``socket." "sethostname``。" @@ -1634,7 +1644,9 @@ msgstr "" #: ../../library/socket.rst:1398 #, fuzzy -msgid "Raises an auditing event socket.bind with arguments self, address." +msgid "" +"Raises an :ref:`auditing event ` ``socket.bind`` with arguments " +"``self``, ``address``." msgstr "" "引發一個附帶引數 ``self``、``address`` 的\\ :ref:`稽核事件 ` " "``socket.bind``。" @@ -1687,7 +1699,9 @@ msgstr "" #: ../../library/socket.rst:1439 ../../library/socket.rst:1459 #, fuzzy -msgid "Raises an auditing event socket.connect with arguments self, address." +msgid "" +"Raises an :ref:`auditing event ` ``socket.connect`` with arguments " +"``self``, ``address``." msgstr "" "引發一個附帶引數 ``self``、``address`` 的\\ :ref:`稽核事件 ` " "``socket.connect``。" @@ -2025,7 +2039,9 @@ msgstr "" #: ../../library/socket.rst:1816 #, fuzzy -msgid "Raises an auditing event socket.sendto with arguments self, address." +msgid "" +"Raises an :ref:`auditing event ` ``socket.sendto`` with arguments " +"``self``, ``address``." msgstr "" "引發一個附帶引數 ``self``、``address`` 的\\ :ref:`稽核事件 ` " "``socket.sendto``。" @@ -2063,7 +2079,9 @@ msgstr ":ref:`適用 `：Unix、非 WASI。" #: ../../library/socket.rst:1859 #, fuzzy -msgid "Raises an auditing event socket.sendmsg with arguments self, address." +msgid "" +"Raises an :ref:`auditing event ` ``socket.sendmsg`` with arguments " +"``self``, ``address``." msgstr "" "引發一個附帶引數 ``self``、``address`` 的\\ :ref:`稽核事件 ` " "``socket.sendmsg``。" diff --git a/library/sqlite3.po b/library/sqlite3.po index 8a06381631..e464b3bc16 100644 --- a/library/sqlite3.po +++ b/library/sqlite3.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:10+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -347,7 +347,9 @@ msgstr "" #: ../../library/sqlite3.rst:346 #, fuzzy -msgid "Raises an auditing event sqlite3.connect with argument database." +msgid "" +"Raises an :ref:`auditing event ` ``sqlite3.connect`` with argument " +"``database``." msgstr "" "引發一個附帶引數 ``database`` 的\\ :ref:`稽核事件 ` ``sqlite3." "connect``。" @@ -355,8 +357,8 @@ msgstr "" #: ../../library/sqlite3.rst:347 #, fuzzy msgid "" -"Raises an auditing event sqlite3.connect/handle with argument " -"connection_handle." +"Raises an :ref:`auditing event ` ``sqlite3.connect/handle`` with " +"argument ``connection_handle``." msgstr "" "引發一個附帶引數 ``connection_handle`` 的\\ :ref:`稽核事件 ` " "``sqlite3.connect/handle``。" @@ -1066,8 +1068,8 @@ msgstr "" #: ../../library/sqlite3.rst:1020 #, fuzzy msgid "" -"Raises an auditing event sqlite3.enable_load_extension with arguments " -"connection, enabled." +"Raises an :ref:`auditing event ` ``sqlite3.enable_load_extension`` " +"with arguments ``connection``, ``enabled``." msgstr "" "引發一個附帶引數 ``connection``、``enabled`` 的\\ :ref:`稽核事件 ` " "``sqlite3.enable_load_extension``。" @@ -1096,8 +1098,8 @@ msgstr "" #: ../../library/sqlite3.rst:1073 #, fuzzy msgid "" -"Raises an auditing event sqlite3.load_extension with arguments connection, " -"path." +"Raises an :ref:`auditing event ` ``sqlite3.load_extension`` with " +"arguments ``connection``, ``path``." msgstr "" "引發一個附帶引數 ``connection``、``path`` 的\\ :ref:`稽核事件 ` " "``sqlite3.load_extension``。" diff --git a/library/ssl.po b/library/ssl.po index 5c22818042..4a84f85a9c 100644 --- a/library/ssl.po +++ b/library/ssl.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-23 00:04+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2024-05-01 14:51+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -3039,9 +3039,9 @@ msgstr "驗證憑證" msgid "" "When calling the :class:`SSLContext` constructor directly, :const:" "`CERT_NONE` is the default. Since it does not authenticate the other peer, " -"it can be insecure, especially in client mode where most of time you would " -"like to ensure the authenticity of the server you're talking to. Therefore, " -"when in client mode, it is highly recommended to use :const:" +"it can be insecure, especially in client mode where most of the time you " +"would like to ensure the authenticity of the server you're talking to. " +"Therefore, when in client mode, it is highly recommended to use :const:" "`CERT_REQUIRED`. However, it is in itself not sufficient; you also have to " "check that the server certificate, which can be obtained by calling :meth:" "`SSLSocket.getpeercert`, matches the desired service. For many protocols " diff --git a/library/subprocess.po b/library/subprocess.po index 20b76147e3..d5129c9af3 100644 --- a/library/subprocess.po +++ b/library/subprocess.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:11+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -878,15 +878,7 @@ msgid "" "waited for. ::" msgstr "" -#: ../../library/subprocess.rst:701 -msgid "" -"Popen and the other functions in this module that use it raise an auditing " -"event subprocess.Popen with arguments executable, args, cwd, and env. The " -"value for args may be a single string or a list of strings, depending on " -"platform." -msgstr "" - -#: ../../library/subprocess.rst:703 +#: ../../library/subprocess.rst:701 ../../library/subprocess.rst:703 msgid "" "Popen and the other functions in this module that use it raise an :ref:" "`auditing event ` ``subprocess.Popen`` with arguments " diff --git a/library/sys.po b/library/sys.po index 7392787d2c..97e4c782ab 100644 --- a/library/sys.po +++ b/library/sys.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2023-04-26 02:54+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -75,21 +75,7 @@ msgid "" "mod:`ctypes`) should be completely removed or closely monitored." msgstr "" -#: ../../library/sys.rst:49 -#, fuzzy -msgid "" -"Calling sys.addaudithook() will itself raise an auditing event named sys." -"addaudithook with no arguments. If any existing hooks raise an exception " -"derived from RuntimeError, the new hook will not be added and the exception " -"suppressed. As a result, callers cannot assume that their hook has been " -"added unless they control all existing hooks." -msgstr "" -"呼叫 :func:`sys.addaudithook` 本身會引發一個不帶任何引數、名為 ``sys." -"addaudithook`` 的稽核事件。如果任何現有的 hook 引發從 :class:`RuntimeError` " -"衍生的例外，則不會添加新的 hook 並抑制異常。因此，除非呼叫者控制所有已存在的 " -"hook，他們不能假設他們的 hook 已被添加。" - -#: ../../library/sys.rst:51 +#: ../../library/sys.rst:49 ../../library/sys.rst:51 msgid "" "Calling :func:`sys.addaudithook` will itself raise an auditing event named " "``sys.addaudithook`` with no arguments. If any existing hooks raise an " @@ -287,9 +273,11 @@ msgstr "" #: ../../library/sys.rst:214 #, fuzzy -msgid "Raises an auditing event sys._current_frames with no arguments." +msgid "" +"Raises an :ref:`auditing event ` ``sys._current_frames`` with no " +"arguments." msgstr "" -"引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys._current_frames``。" +"引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.addaudithook``。" #: ../../library/sys.rst:218 msgid "" @@ -305,7 +293,9 @@ msgstr "" #: ../../library/sys.rst:227 #, fuzzy -msgid "Raises an auditing event sys._current_exceptions with no arguments." +msgid "" +"Raises an :ref:`auditing event ` ``sys._current_exceptions`` with " +"no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys." "_current_exceptions``。" @@ -495,16 +485,7 @@ msgid "" "argument function to ``sys.excepthook``." msgstr "" -#: ../../library/sys.rst:394 -msgid "" -"Raise an auditing event sys.excepthook with arguments hook, type, value, " -"traceback when an uncaught exception occurs. If no hook has been set, hook " -"may be None. If any hook raises an exception derived from RuntimeError the " -"call to the hook will be suppressed. Otherwise, the audit hook exception " -"will be reported as unraisable and sys.excepthook will be called." -msgstr "" - -#: ../../library/sys.rst:396 +#: ../../library/sys.rst:394 ../../library/sys.rst:396 msgid "" "Raise an auditing event ``sys.excepthook`` with arguments ``hook``, " "``type``, ``value``, ``traceback`` when an uncaught exception occurs. If no " @@ -1127,7 +1108,9 @@ msgstr "" #: ../../library/sys.rst:886 #, fuzzy -msgid "Raises an auditing event sys._getframe with argument frame." +msgid "" +"Raises an :ref:`auditing event ` ``sys._getframe`` with argument " +"``frame``." msgstr "" "引發一個附帶引數 ``frame`` 的\\ :ref:`稽核事件 ` ``sys." "_getframe``。" @@ -1149,7 +1132,9 @@ msgstr "" #: ../../library/sys.rst:902 #, fuzzy -msgid "Raises an auditing event sys._getframemodulename with argument depth." +msgid "" +"Raises an :ref:`auditing event ` ``sys._getframemodulename`` with " +"argument ``depth``." msgstr "" "引發一個附帶引數 ``depth`` 的\\ :ref:`稽核事件 ` ``sys." "_getframemodulename``。" @@ -1450,16 +1435,7 @@ msgid "" "`." msgstr "" -#: ../../library/sys.rst:1166 -#, fuzzy -msgid "" -"Raises an auditing event cpython.run_interactivehook with the hook object as " -"the argument when the hook is called on startup." -msgstr "" -"引發一個附帶引數 ``hook`` 的\\ :ref:`稽核事件 ` ``cpython." -"run_interactivehook``。" - -#: ../../library/sys.rst:1168 +#: ../../library/sys.rst:1166 ../../library/sys.rst:1168 msgid "" "Raises an :ref:`auditing event ` ``cpython.run_interactivehook`` " "with the hook object as the argument when the hook is called on startup." @@ -1944,8 +1920,11 @@ msgstr "" #: ../../library/sys.rst:1517 #, fuzzy -msgid "Raises an auditing event sys.setprofile with no arguments." -msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.setprofile``。" +msgid "" +"Raises an :ref:`auditing event ` ``sys.setprofile`` with no " +"arguments." +msgstr "" +"引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.addaudithook``。" #: ../../library/sys.rst:1522 msgid "" @@ -2108,8 +2087,11 @@ msgstr "" #: ../../library/sys.rst:1635 #, fuzzy -msgid "Raises an auditing event sys.settrace with no arguments." -msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.setprofile``。" +msgid "" +"Raises an :ref:`auditing event ` ``sys.settrace`` with no " +"arguments." +msgstr "" +"引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.addaudithook``。" #: ../../library/sys.rst:1639 msgid "" @@ -2145,7 +2127,8 @@ msgstr "" #: ../../library/sys.rst:1663 #, fuzzy msgid "" -"Raises an auditing event sys.set_asyncgen_hooks_firstiter with no arguments." +"Raises an :ref:`auditing event ` ``sys." +"set_asyncgen_hooks_firstiter`` with no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys." "set_asyncgen_hooks_firstiter``。" @@ -2153,7 +2136,8 @@ msgstr "" #: ../../library/sys.rst:1665 #, fuzzy msgid "" -"Raises an auditing event sys.set_asyncgen_hooks_finalizer with no arguments." +"Raises an :ref:`auditing event ` ``sys." +"set_asyncgen_hooks_finalizer`` with no arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys." "set_asyncgen_hooks_finalizer``。" @@ -2507,15 +2491,7 @@ msgid "" "custom hook completes to avoid resurrecting objects." msgstr "" -#: ../../library/sys.rst:1929 -msgid "" -"Raise an auditing event sys.unraisablehook with arguments hook, unraisable " -"when an exception that cannot be handled occurs. The unraisable object is " -"the same as what will be passed to the hook. If no hook has been set, hook " -"may be None." -msgstr "" - -#: ../../library/sys.rst:1931 +#: ../../library/sys.rst:1929 ../../library/sys.rst:1931 msgid "" "Raise an auditing event ``sys.unraisablehook`` with arguments *hook*, " "*unraisable* when an exception that cannot be handled occurs. The " @@ -2664,10 +2640,40 @@ msgstr "..." #, fuzzy #~ msgid "" -#~ "Raises an :ref:`auditing event ` ``sys.addaudithook`` with no " -#~ "arguments." +#~ "Calling sys.addaudithook() will itself raise an auditing event named sys." +#~ "addaudithook with no arguments. If any existing hooks raise an exception " +#~ "derived from RuntimeError, the new hook will not be added and the " +#~ "exception suppressed. As a result, callers cannot assume that their hook " +#~ "has been added unless they control all existing hooks." +#~ msgstr "" +#~ "呼叫 :func:`sys.addaudithook` 本身會引發一個不帶任何引數、名為 ``sys." +#~ "addaudithook`` 的稽核事件。如果任何現有的 hook 引發從 :class:" +#~ "`RuntimeError` 衍生的例外，則不會添加新的 hook 並抑制異常。因此，除非呼叫" +#~ "者控制所有已存在的 hook，他們不能假設他們的 hook 已被添加。" + +#, fuzzy +#~ msgid "Raises an auditing event sys._current_frames with no arguments." +#~ msgstr "" +#~ "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys." +#~ "_current_frames``。" + +#, fuzzy +#~ msgid "" +#~ "Raises an auditing event cpython.run_interactivehook with the hook object " +#~ "as the argument when the hook is called on startup." +#~ msgstr "" +#~ "引發一個附帶引數 ``hook`` 的\\ :ref:`稽核事件 ` ``cpython." +#~ "run_interactivehook``。" + +#, fuzzy +#~ msgid "Raises an auditing event sys.setprofile with no arguments." +#~ msgstr "" +#~ "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.setprofile``。" + +#, fuzzy +#~ msgid "Raises an auditing event sys.settrace with no arguments." #~ msgstr "" -#~ "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.addaudithook``。" +#~ "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.setprofile``。" #~ msgid "" #~ "Raises an :ref:`auditing event ` ``sys.excepthook`` with " diff --git a/library/syslog.po b/library/syslog.po index 7d6e6fb63b..6bacea69e6 100644 --- a/library/syslog.po +++ b/library/syslog.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2015-12-09 17:51+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -63,7 +63,8 @@ msgstr "" #: ../../library/syslog.rst:36 #, fuzzy msgid "" -"Raises an auditing event syslog.syslog with arguments priority, message." +"Raises an :ref:`auditing event ` ``syslog.syslog`` with arguments " +"``priority``, ``message``." msgstr "" "引發一個附帶引數 ``priority``、``message`` 的\\ :ref:`稽核事件 ` " "``syslog.syslog``。" @@ -104,8 +105,8 @@ msgstr "" #: ../../library/syslog.rst:64 #, fuzzy msgid "" -"Raises an auditing event syslog.openlog with arguments ident, logoption, " -"facility." +"Raises an :ref:`auditing event ` ``syslog.openlog`` with arguments " +"``ident``, ``logoption``, ``facility``." msgstr "" "引發一個附帶引數 ``ident``、``logoption``、``facility`` 的\\ :ref:`稽核事件 " "` ``syslog.openlog``。" @@ -139,7 +140,9 @@ msgstr "" #: ../../library/syslog.rst:87 #, fuzzy -msgid "Raises an auditing event syslog.closelog with no arguments." +msgid "" +"Raises an :ref:`auditing event ` ``syslog.closelog`` with no " +"arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``syslog.closelog``。" @@ -155,7 +158,9 @@ msgstr "" #: ../../library/syslog.rst:106 #, fuzzy -msgid "Raises an auditing event syslog.setlogmask with argument maskpri." +msgid "" +"Raises an :ref:`auditing event ` ``syslog.setlogmask`` with " +"argument ``maskpri``." msgstr "" "引發一個附帶引數 ``maskpri`` 的\\ :ref:`稽核事件 ` ``syslog." "setlogmask``。" diff --git a/library/telnetlib.po b/library/telnetlib.po index b1d6ca817e..1e5ae67217 100644 --- a/library/telnetlib.po +++ b/library/telnetlib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2022-05-22 02:15+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -199,8 +199,8 @@ msgstr "" #: ../../library/telnetlib.rst:150 #, fuzzy msgid "" -"Raises an auditing event telnetlib.Telnet.open with arguments self, host, " -"port." +"Raises an :ref:`auditing event ` ``telnetlib.Telnet.open`` with " +"arguments ``self``, ``host``, ``port``." msgstr "" "引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " "` ``telnetlib.Telnet.open``。" @@ -240,7 +240,8 @@ msgstr "" #: ../../library/telnetlib.rst:187 #, fuzzy msgid "" -"Raises an auditing event telnetlib.Telnet.write with arguments self, buffer." +"Raises an :ref:`auditing event ` ``telnetlib.Telnet.write`` with " +"arguments ``self``, ``buffer``." msgstr "" "引發一個附帶引數 ``self``、``buffer`` 的\\ :ref:`稽核事件 ` " "``telnetlib.Telnet.write``。" diff --git a/library/tempfile.po b/library/tempfile.po index 6d517ed5a7..77fc10ccca 100644 --- a/library/tempfile.po +++ b/library/tempfile.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2022-06-12 15:17+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -138,7 +138,9 @@ msgstr "" #: ../../library/tempfile.rst:68 ../../library/tempfile.rst:137 #: ../../library/tempfile.rst:264 #, fuzzy -msgid "Raises an auditing event tempfile.mkstemp with argument fullpath." +msgid "" +"Raises an :ref:`auditing event ` ``tempfile.mkstemp`` with " +"argument ``fullpath``." msgstr "" "引發一個附帶引數 ``fullpath`` 的 ``tempfile.mkstemp`` :ref:`稽核事件 " "`。" @@ -389,7 +391,9 @@ msgstr "" #: ../../library/tempfile.rst:210 ../../library/tempfile.rst:290 #, fuzzy -msgid "Raises an auditing event tempfile.mkdtemp with argument fullpath." +msgid "" +"Raises an :ref:`auditing event ` ``tempfile.mkdtemp`` with " +"argument ``fullpath``." msgstr "" "引發一個附帶引數 ``fullpath`` 的 ``tempfile.mkdtemp`` :ref:`稽核事件 " "`。" diff --git a/library/types.po b/library/types.po index 787d43c918..e1eb1e2361 100644 --- a/library/types.po +++ b/library/types.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:14+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -192,7 +192,9 @@ msgstr "" #: ../../library/types.rst:159 #, fuzzy -msgid "Raises an auditing event function.__new__ with argument code." +msgid "" +"Raises an :ref:`auditing event ` ``function.__new__`` with " +"argument ``code``." msgstr "" "引發一個附帶引數 ``code`` 的\\ :ref:`稽核事件 ` ``function." "__new__``。" @@ -230,8 +232,9 @@ msgstr "" #: ../../library/types.rst:193 #, fuzzy msgid "" -"Raises an auditing event code.__new__ with arguments code, filename, name, " -"argcount, posonlyargcount, kwonlyargcount, nlocals, stacksize, flags." +"Raises an :ref:`auditing event ` ``code.__new__`` with arguments " +"``code``, ``filename``, ``name``, ``argcount``, ``posonlyargcount``, " +"``kwonlyargcount``, ``nlocals``, ``stacksize``, ``flags``." msgstr "" "引發一個附帶引數 ``code``、``filename``、``name``、``argcount``、" "``posonlyargcount``、``kwonlyargcount``、``nlocals``、``stacksize``、" diff --git a/library/urllib.request.po b/library/urllib.request.po index 1c31f24404..2b50a10f5f 100644 --- a/library/urllib.request.po +++ b/library/urllib.request.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2022-04-21 17:59+0800\n" "Last-Translator: Jordan Su \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -205,16 +205,7 @@ msgstr "" "的處理，以往是透過傳遞 dictionary（字典）參數給 ``urllib.urlopen`` 來取得的，" "現在則可以透過 :class:`ProxyHandler` 物件來取得。" -#: ../../library/urllib.request.rst:99 -#, fuzzy -msgid "" -"The default opener raises an auditing event urllib.Request with arguments " -"fullurl, data, headers, method taken from the request object." -msgstr "" -"預設的 opener 會觸發一個 :ref:`auditing event ` ``urllib.Request`` " -"與其從請求物件中所獲得的引數 ``fullurl``、``data``、``headers``、``method``。" - -#: ../../library/urllib.request.rst:101 +#: ../../library/urllib.request.rst:99 ../../library/urllib.request.rst:101 msgid "" "The default opener raises an :ref:`auditing event ` ``urllib." "Request`` with arguments ``fullurl``, ``data``, ``headers``, ``method`` " @@ -1951,6 +1942,15 @@ msgstr "FTP" msgid "HTML" msgstr "HTML" +#, fuzzy +#~ msgid "" +#~ "The default opener raises an auditing event urllib.Request with arguments " +#~ "fullurl, data, headers, method taken from the request object." +#~ msgstr "" +#~ "預設的 opener 會觸發一個 :ref:`auditing event ` ``urllib." +#~ "Request`` 與其從請求物件中所獲得的引數 ``fullurl``、``data``、" +#~ "``headers``、``method``。" + #~ msgid "" #~ "Raises an :ref:`auditing event ` ``urllib.Request`` with " #~ "arguments ``fullurl``, ``data``, ``headers``, ``method``." diff --git a/library/webbrowser.po b/library/webbrowser.po index e5c60c39b6..88a3064ca8 100644 --- a/library/webbrowser.po +++ b/library/webbrowser.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2017-09-22 18:27+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -113,7 +113,9 @@ msgstr "" #: ../../library/webbrowser.rst:69 #, fuzzy -msgid "Raises an auditing event webbrowser.open with argument url." +msgid "" +"Raises an :ref:`auditing event ` ``webbrowser.open`` with argument " +"``url``." msgstr "" "引發一個附帶引數 ``url`` 的\\ :ref:`稽核事件 ` ``webbrowser." "open``。" diff --git a/library/winreg.po b/library/winreg.po index 14e6e2509a..2a5e3cab5a 100644 --- a/library/winreg.po +++ b/library/winreg.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:15+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -82,8 +82,8 @@ msgstr "" #: ../../library/winreg.rst:56 #, fuzzy msgid "" -"Raises an auditing event winreg.ConnectRegistry with arguments " -"computer_name, key." +"Raises an :ref:`auditing event ` ``winreg.ConnectRegistry`` with " +"arguments ``computer_name``, ``key``." msgstr "" "引發一個附帶引數 ``computer_name``、``key`` 的\\ :ref:`稽核事件 ` " "``winreg.ConnectRegistry``。" @@ -132,8 +132,8 @@ msgstr "" #: ../../library/winreg.rst:80 ../../library/winreg.rst:112 #, fuzzy msgid "" -"Raises an auditing event winreg.CreateKey with arguments key, sub_key, " -"access." +"Raises an :ref:`auditing event ` ``winreg.CreateKey`` with " +"arguments ``key``, ``sub_key``, ``access``." msgstr "" "引發一個附帶引數 ``key``、``sub_key``、``access`` 的\\ :ref:`稽核事件 " "` ``winreg.CreateKey``。" @@ -141,7 +141,9 @@ msgstr "" #: ../../library/winreg.rst:82 ../../library/winreg.rst:114 #: ../../library/winreg.rst:324 #, fuzzy -msgid "Raises an auditing event winreg.OpenKey/result with argument key." +msgid "" +"Raises an :ref:`auditing event ` ``winreg.OpenKey/result`` with " +"argument ``key``." msgstr "" "引發一個附帶引數 ``key`` 的\\ :ref:`稽核事件 ` ``winreg.OpenKey/" "result``。" @@ -182,8 +184,8 @@ msgstr "" #: ../../library/winreg.rst:137 ../../library/winreg.rst:168 #, fuzzy msgid "" -"Raises an auditing event winreg.DeleteKey with arguments key, sub_key, " -"access." +"Raises an :ref:`auditing event ` ``winreg.DeleteKey`` with " +"arguments ``key``, ``sub_key``, ``access``." msgstr "" "引發一個附帶引數 ``key``、``sub_key``、``access`` 的\\ :ref:`稽核事件 " "` ``winreg.DeleteKey``。" @@ -217,7 +219,9 @@ msgstr "" #: ../../library/winreg.rst:185 #, fuzzy -msgid "Raises an auditing event winreg.DeleteValue with arguments key, value." +msgid "" +"Raises an :ref:`auditing event ` ``winreg.DeleteValue`` with " +"arguments ``key``, ``value``." msgstr "" "引發一個附帶引數 ``key``、``value`` 的\\ :ref:`稽核事件 ` ``winreg." "DeleteValue``。" @@ -239,7 +243,9 @@ msgstr "" #: ../../library/winreg.rst:201 #, fuzzy -msgid "Raises an auditing event winreg.EnumKey with arguments key, index." +msgid "" +"Raises an :ref:`auditing event ` ``winreg.EnumKey`` with arguments " +"``key``, ``index``." msgstr "" "引發一個附帶引數 ``key``、``index`` 的\\ :ref:`稽核事件 ` ``winreg." "EnumKey``。" @@ -306,7 +312,9 @@ msgstr "" #: ../../library/winreg.rst:236 #, fuzzy -msgid "Raises an auditing event winreg.EnumValue with arguments key, index." +msgid "" +"Raises an :ref:`auditing event ` ``winreg.EnumValue`` with " +"arguments ``key``, ``index``." msgstr "" "引發一個附帶引數 ``key``、``index`` 的\\ :ref:`稽核事件 ` ``winreg." "EnumValue``。" @@ -320,7 +328,8 @@ msgstr "" #: ../../library/winreg.rst:253 #, fuzzy msgid "" -"Raises an auditing event winreg.ExpandEnvironmentStrings with argument str." +"Raises an :ref:`auditing event ` ``winreg." +"ExpandEnvironmentStrings`` with argument ``str``." msgstr "" "引發一個附帶引數 ``str`` 的\\ :ref:`稽核事件 ` ``winreg." "ExpandEnvironmentStrings``。" @@ -386,8 +395,8 @@ msgstr "" #: ../../library/winreg.rst:299 #, fuzzy msgid "" -"Raises an auditing event winreg.LoadKey with arguments key, sub_key, " -"file_name." +"Raises an :ref:`auditing event ` ``winreg.LoadKey`` with arguments " +"``key``, ``sub_key``, ``file_name``." msgstr "" "引發一個附帶引數 ``key``、``sub_key``、``file_name`` 的\\ :ref:`稽核事件 " "` ``winreg.LoadKey``。" @@ -424,7 +433,8 @@ msgstr "" #: ../../library/winreg.rst:322 #, fuzzy msgid "" -"Raises an auditing event winreg.OpenKey with arguments key, sub_key, access." +"Raises an :ref:`auditing event ` ``winreg.OpenKey`` with arguments " +"``key``, ``sub_key``, ``access``." msgstr "" "引發一個附帶引數 ``key``、``sub_key``、``access`` 的\\ :ref:`稽核事件 " "` ``winreg.OpenKey``。" @@ -453,7 +463,9 @@ msgstr "" #: ../../library/winreg.rst:356 #, fuzzy -msgid "Raises an auditing event winreg.QueryInfoKey with argument key." +msgid "" +"Raises an :ref:`auditing event ` ``winreg.QueryInfoKey`` with " +"argument ``key``." msgstr "" "引發一個附帶引數 ``key`` 的\\ :ref:`稽核事件 ` ``winreg." "QueryInfoKey``。" @@ -481,8 +493,8 @@ msgstr "" #: ../../library/winreg.rst:375 ../../library/winreg.rst:400 #, fuzzy msgid "" -"Raises an auditing event winreg.QueryValue with arguments key, sub_key, " -"value_name." +"Raises an :ref:`auditing event ` ``winreg.QueryValue`` with " +"arguments ``key``, ``sub_key``, ``value_name``." msgstr "" "引發一個附帶引數 ``key``、``sub_key``、``value_name`` 的\\ :ref:`稽核事件 " "` ``winreg.QueryKey``。" @@ -539,7 +551,9 @@ msgstr "" #: ../../library/winreg.rst:425 #, fuzzy -msgid "Raises an auditing event winreg.SaveKey with arguments key, file_name." +msgid "" +"Raises an :ref:`auditing event ` ``winreg.SaveKey`` with arguments " +"``key``, ``file_name``." msgstr "" "引發一個附帶引數 ``key``、``file_name`` 的\\ :ref:`稽核事件 ` " "``winreg.SaveKey``。" @@ -587,8 +601,8 @@ msgstr "" #: ../../library/winreg.rst:453 ../../library/winreg.rst:483 #, fuzzy msgid "" -"Raises an auditing event winreg.SetValue with arguments key, sub_key, type, " -"value." +"Raises an :ref:`auditing event ` ``winreg.SetValue`` with " +"arguments ``key``, ``sub_key``, ``type``, ``value``." msgstr "" "引發一個附帶引數 ``key``、``sub_key``、``type``、``value`` 的\\ :ref:`稽核事" "件 ` ``winreg.SetValue``。" @@ -646,7 +660,9 @@ msgstr "" #: ../../library/winreg.rst:501 #, fuzzy -msgid "Raises an auditing event winreg.DisableReflectionKey with argument key." +msgid "" +"Raises an :ref:`auditing event ` ``winreg.DisableReflectionKey`` " +"with argument ``key``." msgstr "" "引發一個附帶引數 ``key`` 的\\ :ref:`稽核事件 ` ``winreg." "DsiableReflectionKey``。" @@ -662,7 +678,9 @@ msgstr "" #: ../../library/winreg.rst:516 #, fuzzy -msgid "Raises an auditing event winreg.EnableReflectionKey with argument key." +msgid "" +"Raises an :ref:`auditing event ` ``winreg.EnableReflectionKey`` " +"with argument ``key``." msgstr "" "引發一個附帶引數 ``key`` 的\\ :ref:`稽核事件 ` ``winreg." "EnableReflectionKey``。" @@ -677,7 +695,9 @@ msgstr "" #: ../../library/winreg.rst:531 #, fuzzy -msgid "Raises an auditing event winreg.QueryReflectionKey with argument key." +msgid "" +"Raises an :ref:`auditing event ` ``winreg.QueryReflectionKey`` " +"with argument ``key``." msgstr "" "引發一個附帶引數 ``key`` 的\\ :ref:`稽核事件 ` ``winreg." "QueryReflectionKey``。" @@ -970,7 +990,9 @@ msgstr "" #: ../../library/winreg.rst:784 #, fuzzy -msgid "Raises an auditing event winreg.PyHKEY.Detach with argument key." +msgid "" +"Raises an :ref:`auditing event ` ``winreg.PyHKEY.Detach`` with " +"argument ``key``." msgstr "" "引發一個附帶引數 ``key`` 的\\ :ref:`稽核事件 ` ``winreg.PyHKEY." "Detach``。" diff --git a/reference/datamodel.po b/reference/datamodel.po index 857605ed0a..98118eee21 100644 --- a/reference/datamodel.po +++ b/reference/datamodel.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:17+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -2192,16 +2192,7 @@ msgid "" "functions `. See :ref:`special-lookup`." msgstr "" -#: ../../reference/datamodel.rst:1954 -#, fuzzy -msgid "" -"For certain sensitive attribute accesses, raises an auditing event object." -"__getattr__ with arguments obj and name." -msgstr "" -"存取此屬性會引發一個附帶引數 ``obj`` 與 ``\"tb_frame\"`` 的\\ :ref:`稽核事件 " -"` ``object.__getattr__``。" - -#: ../../reference/datamodel.rst:1956 +#: ../../reference/datamodel.rst:1954 ../../reference/datamodel.rst:1956 msgid "" "For certain sensitive attribute accesses, raises an :ref:`auditing event " "` ``object.__getattr__`` with arguments ``obj`` and ``name``." @@ -2221,16 +2212,7 @@ msgid "" "__setattr__(self, name, value)``." msgstr "" -#: ../../reference/datamodel.rst:1971 -#, fuzzy -msgid "" -"For certain sensitive attribute assignments, raises an auditing event object." -"__setattr__ with arguments obj, name, value." -msgstr "" -"存取此屬性會引發一個附帶引數 ``obj`` 與 ``\"tb_frame\"`` 的\\ :ref:`稽核事件 " -"` ``object.__getattr__``。" - -#: ../../reference/datamodel.rst:1973 +#: ../../reference/datamodel.rst:1971 ../../reference/datamodel.rst:1973 msgid "" "For certain sensitive attribute assignments, raises an :ref:`auditing event " "` ``object.__setattr__`` with arguments ``obj``, ``name``, " @@ -2244,16 +2226,7 @@ msgid "" "object." msgstr "" -#: ../../reference/datamodel.rst:1983 -#, fuzzy -msgid "" -"For certain sensitive attribute deletions, raises an auditing event object." -"__delattr__ with arguments obj and name." -msgstr "" -"存取此屬性會引發一個附帶引數 ``obj`` 與 ``\"tb_frame\"`` 的\\ :ref:`稽核事件 " -"` ``object.__getattr__``。" - -#: ../../reference/datamodel.rst:1985 +#: ../../reference/datamodel.rst:1983 ../../reference/datamodel.rst:1985 msgid "" "For certain sensitive attribute deletions, raises an :ref:`auditing event " "` ``object.__delattr__`` with arguments ``obj`` and ``name``." @@ -4832,6 +4805,30 @@ msgstr "with" msgid "context manager" msgstr "context manager（情境管理器）" +#, fuzzy +#~ msgid "" +#~ "For certain sensitive attribute accesses, raises an auditing event object." +#~ "__getattr__ with arguments obj and name." +#~ msgstr "" +#~ "存取此屬性會引發一個附帶引數 ``obj`` 與 ``\"tb_frame\"`` 的\\ :ref:`稽核事" +#~ "件 ` ``object.__getattr__``。" + +#, fuzzy +#~ msgid "" +#~ "For certain sensitive attribute assignments, raises an auditing event " +#~ "object.__setattr__ with arguments obj, name, value." +#~ msgstr "" +#~ "存取此屬性會引發一個附帶引數 ``obj`` 與 ``\"tb_frame\"`` 的\\ :ref:`稽核事" +#~ "件 ` ``object.__getattr__``。" + +#, fuzzy +#~ msgid "" +#~ "For certain sensitive attribute deletions, raises an auditing event " +#~ "object.__delattr__ with arguments obj and name." +#~ msgstr "" +#~ "存取此屬性會引發一個附帶引數 ``obj`` 與 ``\"tb_frame\"`` 的\\ :ref:`稽核事" +#~ "件 ` ``object.__getattr__``。" + #~ msgid "" #~ "Raises an :ref:`auditing event ` ``object.__getattr__`` with " #~ "arguments ``obj``, ``name``." diff --git a/reference/simple_stmts.po b/reference/simple_stmts.po index 300c6f392d..30df8ec5fa 100644 --- a/reference/simple_stmts.po +++ b/reference/simple_stmts.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:17+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -848,8 +848,9 @@ msgstr "" #: ../../reference/simple_stmts.rst:866 #, fuzzy msgid "" -"Raises an auditing event import with arguments module, filename, sys.path, " -"sys.meta_path, sys.path_hooks." +"Raises an :ref:`auditing event ` ``import`` with arguments " +"``module``, ``filename``, ``sys.path``, ``sys.meta_path``, ``sys." +"path_hooks``." msgstr "" "引發一個附帶引數 ``module``、``filename``、``sys.path``、``sys.meta_path``、" "``sys.path_hooks`` 的\\ :ref:`稽核事件 ` ``import``。" diff --git a/using/cmdline.po b/using/cmdline.po index 0f5c5937bb..f73e538d53 100644 --- a/using/cmdline.po +++ b/using/cmdline.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-04 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:19+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -119,7 +119,9 @@ msgstr "" #: ../../using/cmdline.rst:73 #, fuzzy -msgid "Raises an auditing event cpython.run_command with argument command." +msgid "" +"Raises an :ref:`auditing event ` ``cpython.run_command`` with " +"argument ``command``." msgstr "" "引發一個附帶引數 ``command`` 的\\ :ref:`稽核事件 ` ``cpython." "run_command``。" @@ -178,7 +180,9 @@ msgstr "" #: ../../using/cmdline.rst:115 #, fuzzy -msgid "Raises an auditing event cpython.run_module with argument module-name." +msgid "" +"Raises an :ref:`auditing event ` ``cpython.run_module`` with " +"argument ``module-name``." msgstr "" "引發一個附帶引數 ``module-name`` 的\\ :ref:`稽核事件 ` ``cpython." "run_module``。" @@ -218,7 +222,9 @@ msgstr "" #: ../../using/cmdline.rst:140 ../../using/cmdline.rst:723 #, fuzzy -msgid "Raises an auditing event cpython.run_stdin with no arguments." +msgid "" +"Raises an :ref:`auditing event ` ``cpython.run_stdin`` with no " +"arguments." msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``cpython.run_stdin``。" @@ -259,7 +265,9 @@ msgstr "" #: ../../using/cmdline.rst:167 #, fuzzy -msgid "Raises an auditing event cpython.run_file with argument filename." +msgid "" +"Raises an :ref:`auditing event ` ``cpython.run_file`` with " +"argument ``filename``." msgstr "" "引發一個附帶引數 ``filename`` 的\\ :ref:`稽核事件 ` ``cpython." "run_startup``。" @@ -848,16 +856,7 @@ msgid "" "file." msgstr "" -#: ../../using/cmdline.rst:680 -#, fuzzy -msgid "" -"Raises an auditing event cpython.run_startup with the filename as the " -"argument when called on startup." -msgstr "" -"引發一個附帶呼叫啟動時的檔案名稱為引數的\\ :ref:`稽核事件 ` " -"``cpython.run_startup``。" - -#: ../../using/cmdline.rst:682 +#: ../../using/cmdline.rst:680 ../../using/cmdline.rst:682 msgid "" "Raises an :ref:`auditing event ` ``cpython.run_startup`` with the " "filename as the argument when called on startup." @@ -1325,6 +1324,14 @@ msgid "" "shutting down the interpreter into a file called *FILENAME*." msgstr "" +#, fuzzy +#~ msgid "" +#~ "Raises an auditing event cpython.run_startup with the filename as the " +#~ "argument when called on startup." +#~ msgstr "" +#~ "引發一個附帶呼叫啟動時的檔案名稱為引數的\\ :ref:`稽核事件 ` " +#~ "``cpython.run_startup``。" + #~ msgid "Added the ``-X faulthandler`` option." #~ msgstr "新增 ``-X faulthandler`` 選項。" From a5019bbdf99bea104a0bf160dc245347bbf5180a Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Tue, 6 Aug 2024 00:05:06 +0000 Subject: [PATCH 17/28] sync with cpython 2ff41583 --- c-api/long.po | 23 +++- library/dis.po | 350 ++++++++++++++++++++++++------------------------- 2 files changed, 192 insertions(+), 181 deletions(-) diff --git a/c-api/long.po b/c-api/long.po index 7d1f613e4b..4c722396b8 100644 --- a/c-api/long.po +++ b/c-api/long.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-12 00:03+0000\n" +"POT-Creation-Date: 2024-08-06 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-" @@ -335,10 +335,21 @@ msgid "" msgstr "" #: ../../c-api/long.rst:329 +msgid "" +"On success, return a read only :term:`named tuple`, that holds information " +"about Python's internal representation of integers. See :data:`sys.int_info` " +"for description of individual fields." +msgstr "" + +#: ../../c-api/long.rst:333 +msgid "On failure, return ``NULL`` with an exception set." +msgstr "" + +#: ../../c-api/long.rst:340 msgid "Return 1 if *op* is compact, 0 otherwise." msgstr "" -#: ../../c-api/long.rst:331 +#: ../../c-api/long.rst:342 msgid "" "This function makes it possible for performance-critical code to implement a " "“fast path” for small integers. For compact values use :c:func:" @@ -347,23 +358,23 @@ msgid "" "` :meth:`int.to_bytes`." msgstr "" -#: ../../c-api/long.rst:337 +#: ../../c-api/long.rst:348 msgid "The speedup is expected to be negligible for most users." msgstr "" -#: ../../c-api/long.rst:339 +#: ../../c-api/long.rst:350 msgid "" "Exactly what values are considered compact is an implementation detail and " "is subject to change." msgstr "" -#: ../../c-api/long.rst:344 +#: ../../c-api/long.rst:355 msgid "" "If *op* is compact, as determined by :c:func:`PyUnstable_Long_IsCompact`, " "return its value." msgstr "" -#: ../../c-api/long.rst:347 +#: ../../c-api/long.rst:358 msgid "Otherwise, the return value is undefined." msgstr "" diff --git a/library/dis.po b/library/dis.po index f5e9a5d0c8..9d3c3ccf50 100644 --- a/library/dis.po +++ b/library/dis.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-08-06 00:03+0000\n" "PO-Revision-Date: 2018-07-27 16:55+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -600,8 +600,8 @@ msgstr "" #: ../../library/dis.rst:606 ../../library/dis.rst:694 #: ../../library/dis.rst:704 ../../library/dis.rst:714 #: ../../library/dis.rst:934 ../../library/dis.rst:945 -#: ../../library/dis.rst:1045 ../../library/dis.rst:1057 -#: ../../library/dis.rst:1069 +#: ../../library/dis.rst:1049 ../../library/dis.rst:1061 +#: ../../library/dis.rst:1073 msgid "Implements::" msgstr "" @@ -840,7 +840,7 @@ msgid "" "class:`tuple` containing the corresponding values. Otherwise, push ``None``." msgstr "" -#: ../../library/dis.rst:886 ../../library/dis.rst:1513 +#: ../../library/dis.rst:886 ../../library/dis.rst:1517 msgid "" "Previously, this instruction also pushed a boolean value indicating success " "(``True``) or failure (``False``)." @@ -942,66 +942,66 @@ msgstr "" #: ../../library/dis.rst:997 msgid "" "Creates a tuple consuming *count* items from the stack, and pushes the " -"resulting tuple onto the stack.::" +"resulting tuple onto the stack::" msgstr "" -#: ../../library/dis.rst:1007 +#: ../../library/dis.rst:1011 msgid "Works as :opcode:`BUILD_TUPLE`, but creates a list." msgstr "" -#: ../../library/dis.rst:1012 +#: ../../library/dis.rst:1016 msgid "Works as :opcode:`BUILD_TUPLE`, but creates a set." msgstr "" -#: ../../library/dis.rst:1017 +#: ../../library/dis.rst:1021 msgid "" "Pushes a new dictionary object onto the stack. Pops ``2 * count`` items so " "that the dictionary holds *count* entries: ``{..., STACK[-4]: STACK[-3], " "STACK[-2]: STACK[-1]}``." msgstr "" -#: ../../library/dis.rst:1021 +#: ../../library/dis.rst:1025 msgid "" "The dictionary is created from stack items instead of creating an empty " "dictionary pre-sized to hold *count* items." msgstr "" -#: ../../library/dis.rst:1028 +#: ../../library/dis.rst:1032 msgid "" "The version of :opcode:`BUILD_MAP` specialized for constant keys. Pops the " "top element on the stack which contains a tuple of keys, then starting from " "``STACK[-2]``, pops *count* values to form values in the built dictionary." msgstr "" -#: ../../library/dis.rst:1037 +#: ../../library/dis.rst:1041 msgid "" "Concatenates *count* strings from the stack and pushes the resulting string " "onto the stack." msgstr "" -#: ../../library/dis.rst:1050 +#: ../../library/dis.rst:1054 msgid "Used to build lists." msgstr "" -#: ../../library/dis.rst:1062 +#: ../../library/dis.rst:1066 msgid "Used to build sets." msgstr "" -#: ../../library/dis.rst:1074 +#: ../../library/dis.rst:1078 msgid "Used to build dicts." msgstr "" -#: ../../library/dis.rst:1081 +#: ../../library/dis.rst:1085 msgid "Like :opcode:`DICT_UPDATE` but raises an exception for duplicate keys." msgstr "" -#: ../../library/dis.rst:1088 +#: ../../library/dis.rst:1092 msgid "" "If the low bit of ``namei`` is not set, this replaces ``STACK[-1]`` with " "``getattr(STACK[-1], co_names[namei>>1])``." msgstr "" -#: ../../library/dis.rst:1091 +#: ../../library/dis.rst:1095 msgid "" "If the low bit of ``namei`` is set, this will attempt to load a method named " "``co_names[namei>>1]`` from the ``STACK[-1]`` object. ``STACK[-1]`` is " @@ -1012,60 +1012,60 @@ msgid "" "the object returned by the attribute lookup are pushed." msgstr "" -#: ../../library/dis.rst:1099 +#: ../../library/dis.rst:1103 msgid "" "If the low bit of ``namei`` is set, then a ``NULL`` or ``self`` is pushed to " "the stack before the attribute or unbound method respectively." msgstr "" -#: ../../library/dis.rst:1106 +#: ../../library/dis.rst:1110 msgid "" "This opcode implements :func:`super`, both in its zero-argument and two-" "argument forms (e.g. ``super().method()``, ``super().attr`` and ``super(cls, " "self).method()``, ``super(cls, self).attr``)." msgstr "" -#: ../../library/dis.rst:1110 +#: ../../library/dis.rst:1114 msgid "" "It pops three values from the stack (from top of stack down): - ``self``: " "the first argument to the current method - ``cls``: the class within which " "the current method was defined - the global ``super``" msgstr "" -#: ../../library/dis.rst:1115 +#: ../../library/dis.rst:1119 msgid "" "With respect to its argument, it works similarly to :opcode:`LOAD_ATTR`, " "except that ``namei`` is shifted left by 2 bits instead of 1." msgstr "" -#: ../../library/dis.rst:1118 +#: ../../library/dis.rst:1122 msgid "" "The low bit of ``namei`` signals to attempt a method load, as with :opcode:" "`LOAD_ATTR`, which results in pushing ``NULL`` and the loaded method. When " "it is unset a single value is pushed to the stack." msgstr "" -#: ../../library/dis.rst:1122 +#: ../../library/dis.rst:1126 msgid "" "The second-low bit of ``namei``, if set, means that this was a two-argument " "call to :func:`super` (unset means zero-argument)." msgstr "" -#: ../../library/dis.rst:1130 +#: ../../library/dis.rst:1134 msgid "" "Performs a Boolean operation. The operation name can be found in " "``cmp_op[opname]``." msgstr "" -#: ../../library/dis.rst:1136 +#: ../../library/dis.rst:1140 msgid "Performs ``is`` comparison, or ``is not`` if ``invert`` is 1." msgstr "" -#: ../../library/dis.rst:1143 +#: ../../library/dis.rst:1147 msgid "Performs ``in`` comparison, or ``not in`` if ``invert`` is 1." msgstr "" -#: ../../library/dis.rst:1150 +#: ../../library/dis.rst:1154 msgid "" "Imports the module ``co_names[namei]``. ``STACK[-1]`` and ``STACK[-2]`` are " "popped and provide the *fromlist* and *level* arguments of :func:" @@ -1074,68 +1074,68 @@ msgid "" "opcode:`STORE_FAST` instruction modifies the namespace." msgstr "" -#: ../../library/dis.rst:1158 +#: ../../library/dis.rst:1162 msgid "" "Loads the attribute ``co_names[namei]`` from the module found in " "``STACK[-1]``. The resulting object is pushed onto the stack, to be " "subsequently stored by a :opcode:`STORE_FAST` instruction." msgstr "" -#: ../../library/dis.rst:1165 +#: ../../library/dis.rst:1169 msgid "Increments bytecode counter by *delta*." msgstr "" -#: ../../library/dis.rst:1170 +#: ../../library/dis.rst:1174 msgid "Decrements bytecode counter by *delta*. Checks for interrupts." msgstr "" -#: ../../library/dis.rst:1177 +#: ../../library/dis.rst:1181 msgid "Decrements bytecode counter by *delta*. Does not check for interrupts." msgstr "" -#: ../../library/dis.rst:1184 +#: ../../library/dis.rst:1188 msgid "" "If ``STACK[-1]`` is true, increments the bytecode counter by *delta*. " "``STACK[-1]`` is popped." msgstr "" -#: ../../library/dis.rst:1187 ../../library/dis.rst:1200 +#: ../../library/dis.rst:1191 ../../library/dis.rst:1204 msgid "" "The oparg is now a relative delta rather than an absolute target. This " "opcode is a pseudo-instruction, replaced in final bytecode by the directed " "versions (forward/backward)." msgstr "" -#: ../../library/dis.rst:1192 ../../library/dis.rst:1205 -#: ../../library/dis.rst:1218 ../../library/dis.rst:1232 +#: ../../library/dis.rst:1196 ../../library/dis.rst:1209 +#: ../../library/dis.rst:1222 ../../library/dis.rst:1236 msgid "This is no longer a pseudo-instruction." msgstr "" -#: ../../library/dis.rst:1197 +#: ../../library/dis.rst:1201 msgid "" "If ``STACK[-1]`` is false, increments the bytecode counter by *delta*. " "``STACK[-1]`` is popped." msgstr "" -#: ../../library/dis.rst:1210 +#: ../../library/dis.rst:1214 msgid "" "If ``STACK[-1]`` is not ``None``, increments the bytecode counter by " "*delta*. ``STACK[-1]`` is popped." msgstr "" -#: ../../library/dis.rst:1213 ../../library/dis.rst:1227 +#: ../../library/dis.rst:1217 ../../library/dis.rst:1231 msgid "" "This opcode is a pseudo-instruction, replaced in final bytecode by the " "directed versions (forward/backward)." msgstr "" -#: ../../library/dis.rst:1224 +#: ../../library/dis.rst:1228 msgid "" "If ``STACK[-1]`` is ``None``, increments the bytecode counter by *delta*. " "``STACK[-1]`` is popped." msgstr "" -#: ../../library/dis.rst:1237 +#: ../../library/dis.rst:1241 msgid "" "``STACK[-1]`` is an :term:`iterator`. Call its :meth:`~iterator.__next__` " "method. If this yields a new value, push it on the stack (leaving the " @@ -1143,88 +1143,88 @@ msgid "" "code counter is incremented by *delta*." msgstr "" -#: ../../library/dis.rst:1242 +#: ../../library/dis.rst:1246 msgid "Up until 3.11 the iterator was popped when it was exhausted." msgstr "" -#: ../../library/dis.rst:1247 +#: ../../library/dis.rst:1251 msgid "Loads the global named ``co_names[namei>>1]`` onto the stack." msgstr "" -#: ../../library/dis.rst:1249 +#: ../../library/dis.rst:1253 msgid "" "If the low bit of ``namei`` is set, then a ``NULL`` is pushed to the stack " "before the global variable." msgstr "" -#: ../../library/dis.rst:1255 +#: ../../library/dis.rst:1259 msgid "" "Pushes a reference to the local ``co_varnames[var_num]`` onto the stack." msgstr "" -#: ../../library/dis.rst:1257 +#: ../../library/dis.rst:1261 msgid "" "This opcode is now only used in situations where the local variable is " "guaranteed to be initialized. It cannot raise :exc:`UnboundLocalError`." msgstr "" -#: ../../library/dis.rst:1263 +#: ../../library/dis.rst:1267 msgid "" "Pushes a reference to the local ``co_varnames[var_num]`` onto the stack, " "raising an :exc:`UnboundLocalError` if the local variable has not been " "initialized." msgstr "" -#: ../../library/dis.rst:1271 +#: ../../library/dis.rst:1275 msgid "" "Pushes a reference to the local ``co_varnames[var_num]`` onto the stack (or " "pushes ``NULL`` onto the stack if the local variable has not been " "initialized) and sets ``co_varnames[var_num]`` to ``NULL``." msgstr "" -#: ../../library/dis.rst:1279 +#: ../../library/dis.rst:1283 msgid "Stores ``STACK.pop()`` into the local ``co_varnames[var_num]``." msgstr "" -#: ../../library/dis.rst:1284 +#: ../../library/dis.rst:1288 msgid "Deletes local ``co_varnames[var_num]``." msgstr "" -#: ../../library/dis.rst:1289 +#: ../../library/dis.rst:1293 msgid "" "Creates a new cell in slot ``i``. If that slot is nonempty then that value " "is stored into the new cell." msgstr "" -#: ../../library/dis.rst:1297 +#: ../../library/dis.rst:1301 msgid "" "Pushes a reference to the cell contained in slot ``i`` of the \"fast " "locals\" storage. The name of the variable is ``co_fastlocalnames[i]``." msgstr "" -#: ../../library/dis.rst:1300 +#: ../../library/dis.rst:1304 msgid "" "Note that ``LOAD_CLOSURE`` is effectively an alias for ``LOAD_FAST``. It " "exists to keep bytecode a little more readable." msgstr "" -#: ../../library/dis.rst:1303 +#: ../../library/dis.rst:1307 msgid "``i`` is no longer offset by the length of ``co_varnames``." msgstr "" -#: ../../library/dis.rst:1309 +#: ../../library/dis.rst:1313 msgid "" "Loads the cell contained in slot ``i`` of the \"fast locals\" storage. " "Pushes a reference to the object the cell contains on the stack." msgstr "" -#: ../../library/dis.rst:1312 ../../library/dis.rst:1334 -#: ../../library/dis.rst:1345 +#: ../../library/dis.rst:1316 ../../library/dis.rst:1338 +#: ../../library/dis.rst:1349 msgid "" "``i`` is no longer offset by the length of :attr:`~codeobject.co_varnames`." msgstr "" -#: ../../library/dis.rst:1318 +#: ../../library/dis.rst:1322 msgid "" "Pops a mapping off the stack and looks up the name associated with slot " "``i`` of the \"fast locals\" storage in this mapping. If the name is not " @@ -1234,94 +1234,94 @@ msgid "" "scopes ` within class bodies." msgstr "" -#: ../../library/dis.rst:1331 +#: ../../library/dis.rst:1335 msgid "" "Stores ``STACK.pop()`` into the cell contained in slot ``i`` of the \"fast " "locals\" storage." msgstr "" -#: ../../library/dis.rst:1340 +#: ../../library/dis.rst:1344 msgid "" "Empties the cell contained in slot ``i`` of the \"fast locals\" storage. " "Used by the :keyword:`del` statement." msgstr "" -#: ../../library/dis.rst:1351 +#: ../../library/dis.rst:1355 msgid "" "Copies the ``n`` free variables from the closure into the frame. Removes the " "need for special code on the caller's side when calling closures." msgstr "" -#: ../../library/dis.rst:1360 +#: ../../library/dis.rst:1364 msgid "" "Raises an exception using one of the 3 forms of the ``raise`` statement, " "depending on the value of *argc*:" msgstr "" -#: ../../library/dis.rst:1363 +#: ../../library/dis.rst:1367 msgid "0: ``raise`` (re-raise previous exception)" msgstr "" -#: ../../library/dis.rst:1364 +#: ../../library/dis.rst:1368 msgid "" "1: ``raise STACK[-1]`` (raise exception instance or type at ``STACK[-1]``)" msgstr "" -#: ../../library/dis.rst:1365 +#: ../../library/dis.rst:1369 msgid "" "2: ``raise STACK[-2] from STACK[-1]`` (raise exception instance or type at " "``STACK[-2]`` with ``__cause__`` set to ``STACK[-1]``)" msgstr "" -#: ../../library/dis.rst:1371 +#: ../../library/dis.rst:1375 msgid "" "Calls a callable object with the number of arguments specified by ``argc``, " "including the named arguments specified by the preceding :opcode:`KW_NAMES`, " "if any. On the stack are (in ascending order), either:" msgstr "" -#: ../../library/dis.rst:1376 +#: ../../library/dis.rst:1380 msgid "NULL" msgstr "" -#: ../../library/dis.rst:1377 ../../library/dis.rst:1383 +#: ../../library/dis.rst:1381 ../../library/dis.rst:1387 msgid "The callable" msgstr "" -#: ../../library/dis.rst:1378 +#: ../../library/dis.rst:1382 msgid "The positional arguments" msgstr "" -#: ../../library/dis.rst:1379 ../../library/dis.rst:1386 +#: ../../library/dis.rst:1383 ../../library/dis.rst:1390 msgid "The named arguments" msgstr "" -#: ../../library/dis.rst:1381 +#: ../../library/dis.rst:1385 msgid "or:" msgstr "或：" -#: ../../library/dis.rst:1384 +#: ../../library/dis.rst:1388 msgid "``self``" msgstr "``self``" -#: ../../library/dis.rst:1385 +#: ../../library/dis.rst:1389 msgid "The remaining positional arguments" msgstr "" -#: ../../library/dis.rst:1388 +#: ../../library/dis.rst:1392 msgid "" "``argc`` is the total of the positional and named arguments, excluding " "``self`` when a ``NULL`` is not present." msgstr "" -#: ../../library/dis.rst:1391 +#: ../../library/dis.rst:1395 msgid "" "``CALL`` pops all arguments and the callable object off the stack, calls the " "callable object with those arguments, and pushes the return value returned " "by the callable object." msgstr "" -#: ../../library/dis.rst:1400 +#: ../../library/dis.rst:1404 msgid "" "Calls a callable object with variable set of positional and keyword " "arguments. If the lowest bit of *flags* is set, the top of the stack " @@ -1333,70 +1333,70 @@ msgid "" "arguments, and pushes the return value returned by the callable object." msgstr "" -#: ../../library/dis.rst:1415 +#: ../../library/dis.rst:1419 msgid "" "Pushes a ``NULL`` to the stack. Used in the call sequence to match the " "``NULL`` pushed by :opcode:`LOAD_METHOD` for non-method calls." msgstr "" -#: ../../library/dis.rst:1424 +#: ../../library/dis.rst:1428 msgid "" "Prefixes :opcode:`CALL`. Stores a reference to ``co_consts[consti]`` into an " "internal variable for use by :opcode:`CALL`. ``co_consts[consti]`` must be a " "tuple of strings." msgstr "" -#: ../../library/dis.rst:1433 +#: ../../library/dis.rst:1437 msgid "" "Pushes a new function object on the stack. From bottom to top, the consumed " "stack must consist of values if the argument carries a specified flag value" msgstr "" -#: ../../library/dis.rst:1436 +#: ../../library/dis.rst:1440 msgid "" "``0x01`` a tuple of default values for positional-only and positional-or-" "keyword parameters in positional order" msgstr "" -#: ../../library/dis.rst:1438 +#: ../../library/dis.rst:1442 msgid "``0x02`` a dictionary of keyword-only parameters' default values" msgstr "" -#: ../../library/dis.rst:1439 +#: ../../library/dis.rst:1443 msgid "``0x04`` a tuple of strings containing parameters' annotations" msgstr "" -#: ../../library/dis.rst:1440 +#: ../../library/dis.rst:1444 msgid "``0x08`` a tuple containing cells for free variables, making a closure" msgstr "" -#: ../../library/dis.rst:1441 +#: ../../library/dis.rst:1445 msgid "the code associated with the function (at ``STACK[-1]``)" msgstr "" -#: ../../library/dis.rst:1443 +#: ../../library/dis.rst:1447 msgid "Flag value ``0x04`` is a tuple of strings instead of dictionary" msgstr "" -#: ../../library/dis.rst:1446 +#: ../../library/dis.rst:1450 msgid "Qualified name at ``STACK[-1]`` was removed." msgstr "" -#: ../../library/dis.rst:1454 +#: ../../library/dis.rst:1458 msgid "" "Pushes a slice object on the stack. *argc* must be 2 or 3. If it is 2, " "implements::" msgstr "" -#: ../../library/dis.rst:1460 +#: ../../library/dis.rst:1464 msgid "if it is 3, implements::" msgstr "" -#: ../../library/dis.rst:1467 +#: ../../library/dis.rst:1471 msgid "See the :func:`slice` built-in function for more information." msgstr "" -#: ../../library/dis.rst:1472 +#: ../../library/dis.rst:1476 msgid "" "Prefixes any opcode which has an argument too big to fit into the default " "one byte. *ext* holds an additional byte which act as higher bits in the " @@ -1404,54 +1404,54 @@ msgid "" "allowed, forming an argument from two-byte to four-byte." msgstr "" -#: ../../library/dis.rst:1480 +#: ../../library/dis.rst:1484 msgid "" "Used for implementing formatted literal strings (f-strings). Pops an " "optional *fmt_spec* from the stack, then a required *value*. *flags* is " "interpreted as follows:" msgstr "" -#: ../../library/dis.rst:1484 +#: ../../library/dis.rst:1488 msgid "``(flags & 0x03) == 0x00``: *value* is formatted as-is." msgstr "" -#: ../../library/dis.rst:1485 +#: ../../library/dis.rst:1489 msgid "" "``(flags & 0x03) == 0x01``: call :func:`str` on *value* before formatting it." msgstr "" -#: ../../library/dis.rst:1487 +#: ../../library/dis.rst:1491 msgid "" "``(flags & 0x03) == 0x02``: call :func:`repr` on *value* before formatting " "it." msgstr "" -#: ../../library/dis.rst:1489 +#: ../../library/dis.rst:1493 msgid "" "``(flags & 0x03) == 0x03``: call :func:`ascii` on *value* before formatting " "it." msgstr "" -#: ../../library/dis.rst:1491 +#: ../../library/dis.rst:1495 msgid "" "``(flags & 0x04) == 0x04``: pop *fmt_spec* from the stack and use it, else " "use an empty *fmt_spec*." msgstr "" -#: ../../library/dis.rst:1494 +#: ../../library/dis.rst:1498 msgid "" "Formatting is performed using :c:func:`PyObject_Format`. The result is " "pushed on the stack." msgstr "" -#: ../../library/dis.rst:1502 +#: ../../library/dis.rst:1506 msgid "" "``STACK[-1]`` is a tuple of keyword attribute names, ``STACK[-2]`` is the " "class being matched against, and ``STACK[-3]`` is the match subject. " "*count* is the number of positional sub-patterns." msgstr "" -#: ../../library/dis.rst:1506 +#: ../../library/dis.rst:1510 msgid "" "Pop ``STACK[-1]``, ``STACK[-2]``, and ``STACK[-3]``. If ``STACK[-3]`` is an " "instance of ``STACK[-2]`` and has the positional and keyword attributes " @@ -1459,257 +1459,257 @@ msgid "" "Otherwise, push ``None``." msgstr "" -#: ../../library/dis.rst:1520 +#: ../../library/dis.rst:1524 msgid "A no-op. Performs internal tracing, debugging and optimization checks." msgstr "" -#: ../../library/dis.rst:1522 +#: ../../library/dis.rst:1526 msgid "The ``where`` operand marks where the ``RESUME`` occurs:" msgstr "" -#: ../../library/dis.rst:1524 +#: ../../library/dis.rst:1528 msgid "" "``0`` The start of a function, which is neither a generator, coroutine nor " "an async generator" msgstr "" -#: ../../library/dis.rst:1526 +#: ../../library/dis.rst:1530 msgid "``1`` After a ``yield`` expression" msgstr "" -#: ../../library/dis.rst:1527 +#: ../../library/dis.rst:1531 msgid "``2`` After a ``yield from`` expression" msgstr "" -#: ../../library/dis.rst:1528 +#: ../../library/dis.rst:1532 msgid "``3`` After an ``await`` expression" msgstr "" -#: ../../library/dis.rst:1535 +#: ../../library/dis.rst:1539 msgid "" "Create a generator, coroutine, or async generator from the current frame. " "Used as first opcode of in code object for the above mentioned callables. " "Clear the current frame and return the newly created generator." msgstr "" -#: ../../library/dis.rst:1544 +#: ../../library/dis.rst:1548 msgid "" "Equivalent to ``STACK[-1] = STACK[-2].send(STACK[-1])``. Used in ``yield " "from`` and ``await`` statements." msgstr "" -#: ../../library/dis.rst:1547 +#: ../../library/dis.rst:1551 msgid "" "If the call raises :exc:`StopIteration`, pop the top value from the stack, " "push the exception's ``value`` attribute, and increment the bytecode counter " "by *delta*." msgstr "" -#: ../../library/dis.rst:1556 +#: ../../library/dis.rst:1560 msgid "" "This is not really an opcode. It identifies the dividing line between " "opcodes in the range [0,255] which don't use their argument and those that " "do (``< HAVE_ARGUMENT`` and ``>= HAVE_ARGUMENT``, respectively)." msgstr "" -#: ../../library/dis.rst:1560 +#: ../../library/dis.rst:1564 msgid "" "If your application uses pseudo instructions, use the :data:`hasarg` " "collection instead." msgstr "" -#: ../../library/dis.rst:1563 +#: ../../library/dis.rst:1567 msgid "" "Now every instruction has an argument, but opcodes ``< HAVE_ARGUMENT`` " "ignore it. Before, only opcodes ``>= HAVE_ARGUMENT`` had an argument." msgstr "" -#: ../../library/dis.rst:1567 +#: ../../library/dis.rst:1571 msgid "" "Pseudo instructions were added to the :mod:`dis` module, and for them it is " "not true that comparison with ``HAVE_ARGUMENT`` indicates whether they use " "their arg." msgstr "" -#: ../../library/dis.rst:1575 +#: ../../library/dis.rst:1579 msgid "" "Calls an intrinsic function with one argument. Passes ``STACK[-1]`` as the " "argument and sets ``STACK[-1]`` to the result. Used to implement " "functionality that is not performance critical." msgstr "" -#: ../../library/dis.rst:1579 ../../library/dis.rst:1633 +#: ../../library/dis.rst:1583 ../../library/dis.rst:1637 msgid "The operand determines which intrinsic function is called:" msgstr "" -#: ../../library/dis.rst:1582 ../../library/dis.rst:1636 +#: ../../library/dis.rst:1586 ../../library/dis.rst:1640 msgid "Operand" msgstr "" -#: ../../library/dis.rst:1582 ../../library/dis.rst:1636 +#: ../../library/dis.rst:1586 ../../library/dis.rst:1640 msgid "Description" msgstr "" -#: ../../library/dis.rst:1584 +#: ../../library/dis.rst:1588 msgid "``INTRINSIC_1_INVALID``" msgstr "``INTRINSIC_1_INVALID``" -#: ../../library/dis.rst:1584 ../../library/dis.rst:1638 +#: ../../library/dis.rst:1588 ../../library/dis.rst:1642 msgid "Not valid" msgstr "" -#: ../../library/dis.rst:1586 +#: ../../library/dis.rst:1590 msgid "``INTRINSIC_PRINT``" msgstr "``INTRINSIC_PRINT``" -#: ../../library/dis.rst:1586 +#: ../../library/dis.rst:1590 msgid "Prints the argument to standard out. Used in the REPL." msgstr "" -#: ../../library/dis.rst:1589 +#: ../../library/dis.rst:1593 msgid "``INTRINSIC_IMPORT_STAR``" msgstr "``INTRINSIC_IMPORT_STAR``" -#: ../../library/dis.rst:1589 +#: ../../library/dis.rst:1593 msgid "Performs ``import *`` for the named module." msgstr "" -#: ../../library/dis.rst:1592 +#: ../../library/dis.rst:1596 msgid "``INTRINSIC_STOPITERATION_ERROR``" msgstr "``INTRINSIC_STOPITERATION_ERROR``" -#: ../../library/dis.rst:1592 +#: ../../library/dis.rst:1596 msgid "Extracts the return value from a ``StopIteration`` exception." msgstr "" -#: ../../library/dis.rst:1595 +#: ../../library/dis.rst:1599 msgid "``INTRINSIC_ASYNC_GEN_WRAP``" msgstr "``INTRINSIC_ASYNC_GEN_WRAP``" -#: ../../library/dis.rst:1595 +#: ../../library/dis.rst:1599 msgid "Wraps an async generator value" msgstr "" -#: ../../library/dis.rst:1597 +#: ../../library/dis.rst:1601 msgid "``INTRINSIC_UNARY_POSITIVE``" msgstr "``INTRINSIC_UNARY_POSITIVE``" -#: ../../library/dis.rst:1597 +#: ../../library/dis.rst:1601 msgid "Performs the unary ``+`` operation" msgstr "" -#: ../../library/dis.rst:1600 +#: ../../library/dis.rst:1604 msgid "``INTRINSIC_LIST_TO_TUPLE``" msgstr "``INTRINSIC_LIST_TO_TUPLE``" -#: ../../library/dis.rst:1600 +#: ../../library/dis.rst:1604 msgid "Converts a list to a tuple" msgstr "" -#: ../../library/dis.rst:1602 +#: ../../library/dis.rst:1606 msgid "``INTRINSIC_TYPEVAR``" msgstr "``INTRINSIC_TYPEVAR``" -#: ../../library/dis.rst:1602 +#: ../../library/dis.rst:1606 msgid "Creates a :class:`typing.TypeVar`" msgstr "" -#: ../../library/dis.rst:1604 +#: ../../library/dis.rst:1608 msgid "``INTRINSIC_PARAMSPEC``" msgstr "``INTRINSIC_PARAMSPEC``" -#: ../../library/dis.rst:1604 +#: ../../library/dis.rst:1608 msgid "Creates a :class:`typing.ParamSpec`" msgstr "" -#: ../../library/dis.rst:1607 +#: ../../library/dis.rst:1611 msgid "``INTRINSIC_TYPEVARTUPLE``" msgstr "``INTRINSIC_TYPEVARTUPLE``" -#: ../../library/dis.rst:1607 +#: ../../library/dis.rst:1611 msgid "Creates a :class:`typing.TypeVarTuple`" msgstr "" -#: ../../library/dis.rst:1610 +#: ../../library/dis.rst:1614 msgid "``INTRINSIC_SUBSCRIPT_GENERIC``" msgstr "``INTRINSIC_SUBSCRIPT_GENERIC``" -#: ../../library/dis.rst:1610 +#: ../../library/dis.rst:1614 msgid "Returns :class:`typing.Generic` subscripted with the argument" msgstr "" -#: ../../library/dis.rst:1613 +#: ../../library/dis.rst:1617 msgid "``INTRINSIC_TYPEALIAS``" msgstr "``INTRINSIC_TYPEALIAS``" -#: ../../library/dis.rst:1613 +#: ../../library/dis.rst:1617 msgid "" "Creates a :class:`typing.TypeAliasType`; used in the :keyword:`type` " "statement. The argument is a tuple of the type alias's name, type " "parameters, and value." msgstr "" -#: ../../library/dis.rst:1625 +#: ../../library/dis.rst:1629 msgid "" "Calls an intrinsic function with two arguments. Used to implement " "functionality that is not performance critical::" msgstr "" -#: ../../library/dis.rst:1638 +#: ../../library/dis.rst:1642 msgid "``INTRINSIC_2_INVALID``" msgstr "``INTRINSIC_2_INVALID``" -#: ../../library/dis.rst:1640 +#: ../../library/dis.rst:1644 msgid "``INTRINSIC_PREP_RERAISE_STAR``" msgstr "``INTRINSIC_PREP_RERAISE_STAR``" -#: ../../library/dis.rst:1640 +#: ../../library/dis.rst:1644 msgid "Calculates the :exc:`ExceptionGroup` to raise from a ``try-except*``." msgstr "" -#: ../../library/dis.rst:1644 +#: ../../library/dis.rst:1648 msgid "``INTRINSIC_TYPEVAR_WITH_BOUND``" msgstr "``INTRINSIC_TYPEVAR_WITH_BOUND``" -#: ../../library/dis.rst:1644 +#: ../../library/dis.rst:1648 msgid "Creates a :class:`typing.TypeVar` with a bound." msgstr "" -#: ../../library/dis.rst:1647 +#: ../../library/dis.rst:1651 msgid "``INTRINSIC_TYPEVAR_WITH_CONSTRAINTS``" msgstr "``INTRINSIC_TYPEVAR_WITH_CONSTRAINTS``" -#: ../../library/dis.rst:1647 +#: ../../library/dis.rst:1651 msgid "Creates a :class:`typing.TypeVar` with constraints." msgstr "" -#: ../../library/dis.rst:1651 +#: ../../library/dis.rst:1655 msgid "``INTRINSIC_SET_FUNCTION_TYPE_PARAMS``" msgstr "``INTRINSIC_SET_FUNCTION_TYPE_PARAMS``" -#: ../../library/dis.rst:1651 +#: ../../library/dis.rst:1655 msgid "Sets the ``__type_params__`` attribute of a function." msgstr "" -#: ../../library/dis.rst:1658 +#: ../../library/dis.rst:1662 msgid "**Pseudo-instructions**" msgstr "" -#: ../../library/dis.rst:1660 +#: ../../library/dis.rst:1664 msgid "" "These opcodes do not appear in Python bytecode. They are used by the " "compiler but are replaced by real opcodes or removed before bytecode is " "generated." msgstr "" -#: ../../library/dis.rst:1665 +#: ../../library/dis.rst:1669 msgid "" "Set up an exception handler for the following code block. If an exception " "occurs, the value stack level is restored to its current state and control " "is transferred to the exception handler at ``target``." msgstr "" -#: ../../library/dis.rst:1672 +#: ../../library/dis.rst:1676 msgid "" "Like ``SETUP_FINALLY``, but in case of an exception also pushes the last " "instruction (``lasti``) to the stack so that ``RERAISE`` can restore it. If " @@ -1718,76 +1718,76 @@ msgid "" "exception handler at ``target``." msgstr "" -#: ../../library/dis.rst:1681 +#: ../../library/dis.rst:1685 msgid "" "Like ``SETUP_CLEANUP``, but in case of an exception one more item is popped " "from the stack before control is transferred to the exception handler at " "``target``." msgstr "" -#: ../../library/dis.rst:1685 +#: ../../library/dis.rst:1689 msgid "" "This variant is used in :keyword:`with` and :keyword:`async with` " "constructs, which push the return value of the context manager's :meth:" "`~object.__enter__` or :meth:`~object.__aenter__` to the stack." msgstr "" -#: ../../library/dis.rst:1692 +#: ../../library/dis.rst:1696 msgid "" "Marks the end of the code block associated with the last ``SETUP_FINALLY``, " "``SETUP_CLEANUP`` or ``SETUP_WITH``." msgstr "" -#: ../../library/dis.rst:1698 +#: ../../library/dis.rst:1702 msgid "" "Undirected relative jump instructions which are replaced by their directed " "(forward/backward) counterparts by the assembler." msgstr "" -#: ../../library/dis.rst:1703 +#: ../../library/dis.rst:1707 msgid "" "Optimized unbound method lookup. Emitted as a ``LOAD_ATTR`` opcode with a " "flag set in the arg." msgstr "" -#: ../../library/dis.rst:1710 +#: ../../library/dis.rst:1714 msgid "Opcode collections" msgstr "" -#: ../../library/dis.rst:1712 +#: ../../library/dis.rst:1716 msgid "" "These collections are provided for automatic introspection of bytecode " "instructions:" msgstr "" -#: ../../library/dis.rst:1715 +#: ../../library/dis.rst:1719 msgid "" "The collections now contain pseudo instructions and instrumented " "instructions as well. These are opcodes with values ``>= MIN_PSEUDO_OPCODE`` " "and ``>= MIN_INSTRUMENTED_OPCODE``." msgstr "" -#: ../../library/dis.rst:1722 +#: ../../library/dis.rst:1726 msgid "Sequence of operation names, indexable using the bytecode." msgstr "" -#: ../../library/dis.rst:1727 +#: ../../library/dis.rst:1731 msgid "Dictionary mapping operation names to bytecodes." msgstr "" -#: ../../library/dis.rst:1732 +#: ../../library/dis.rst:1736 msgid "Sequence of all compare operation names." msgstr "" -#: ../../library/dis.rst:1737 +#: ../../library/dis.rst:1741 msgid "Sequence of bytecodes that use their argument." msgstr "" -#: ../../library/dis.rst:1744 +#: ../../library/dis.rst:1748 msgid "Sequence of bytecodes that access a constant." msgstr "" -#: ../../library/dis.rst:1749 +#: ../../library/dis.rst:1753 msgid "" "Sequence of bytecodes that access a free variable. 'free' in this context " "refers to names in the current scope that are referenced by inner scopes or " @@ -1795,34 +1795,34 @@ msgid "" "include references to global or builtin scopes." msgstr "" -#: ../../library/dis.rst:1757 +#: ../../library/dis.rst:1761 msgid "Sequence of bytecodes that access an attribute by name." msgstr "" -#: ../../library/dis.rst:1762 +#: ../../library/dis.rst:1766 msgid "Sequence of bytecodes that have a relative jump target." msgstr "" -#: ../../library/dis.rst:1767 +#: ../../library/dis.rst:1771 msgid "Sequence of bytecodes that have an absolute jump target." msgstr "" -#: ../../library/dis.rst:1772 +#: ../../library/dis.rst:1776 msgid "Sequence of bytecodes that access a local variable." msgstr "" -#: ../../library/dis.rst:1777 +#: ../../library/dis.rst:1781 msgid "Sequence of bytecodes of Boolean operations." msgstr "" -#: ../../library/dis.rst:1781 +#: ../../library/dis.rst:1785 msgid "Sequence of bytecodes that set an exception handler." msgstr "" -#: ../../library/dis.rst:1452 +#: ../../library/dis.rst:1456 msgid "built-in function" msgstr "built-in function（內建函式）" -#: ../../library/dis.rst:1452 +#: ../../library/dis.rst:1456 msgid "slice" msgstr "slice（切片）" From dbbab2f47a34e9c384ad1ae25d1d7a5b6a638be9 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 7 Aug 2024 00:05:20 +0000 Subject: [PATCH 18/28] sync with cpython b895f180 --- library/dis.po | 314 ++++++++++++++++--------------- library/email.errors.po | 41 ++-- library/email.policy.po | 160 +++++++++------- library/xml.etree.elementtree.po | 143 +++++++------- whatsnew/3.12.po | 25 ++- 5 files changed, 367 insertions(+), 316 deletions(-) diff --git a/library/dis.po b/library/dis.po index 9d3c3ccf50..51bc74eef7 100644 --- a/library/dis.po +++ b/library/dis.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-08-06 00:03+0000\n" +"POT-Creation-Date: 2024-08-07 00:03+0000\n" "PO-Revision-Date: 2018-07-27 16:55+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -840,7 +840,7 @@ msgid "" "class:`tuple` containing the corresponding values. Otherwise, push ``None``." msgstr "" -#: ../../library/dis.rst:886 ../../library/dis.rst:1517 +#: ../../library/dis.rst:886 ../../library/dis.rst:1520 msgid "" "Previously, this instruction also pushed a boolean value indicating success " "(``True``) or failure (``False``)." @@ -1054,18 +1054,24 @@ msgstr "" #: ../../library/dis.rst:1134 msgid "" "Performs a Boolean operation. The operation name can be found in " -"``cmp_op[opname]``." +"``cmp_op[opname >> 4]``." msgstr "" -#: ../../library/dis.rst:1140 +#: ../../library/dis.rst:1137 +msgid "" +"The cmp_op index is now stored in the four-highest bits of oparg instead of " +"the four-lowest bits of oparg." +msgstr "" + +#: ../../library/dis.rst:1143 msgid "Performs ``is`` comparison, or ``is not`` if ``invert`` is 1." msgstr "" -#: ../../library/dis.rst:1147 +#: ../../library/dis.rst:1150 msgid "Performs ``in`` comparison, or ``not in`` if ``invert`` is 1." msgstr "" -#: ../../library/dis.rst:1154 +#: ../../library/dis.rst:1157 msgid "" "Imports the module ``co_names[namei]``. ``STACK[-1]`` and ``STACK[-2]`` are " "popped and provide the *fromlist* and *level* arguments of :func:" @@ -1074,68 +1080,68 @@ msgid "" "opcode:`STORE_FAST` instruction modifies the namespace." msgstr "" -#: ../../library/dis.rst:1162 +#: ../../library/dis.rst:1165 msgid "" "Loads the attribute ``co_names[namei]`` from the module found in " "``STACK[-1]``. The resulting object is pushed onto the stack, to be " "subsequently stored by a :opcode:`STORE_FAST` instruction." msgstr "" -#: ../../library/dis.rst:1169 +#: ../../library/dis.rst:1172 msgid "Increments bytecode counter by *delta*." msgstr "" -#: ../../library/dis.rst:1174 +#: ../../library/dis.rst:1177 msgid "Decrements bytecode counter by *delta*. Checks for interrupts." msgstr "" -#: ../../library/dis.rst:1181 +#: ../../library/dis.rst:1184 msgid "Decrements bytecode counter by *delta*. Does not check for interrupts." msgstr "" -#: ../../library/dis.rst:1188 +#: ../../library/dis.rst:1191 msgid "" "If ``STACK[-1]`` is true, increments the bytecode counter by *delta*. " "``STACK[-1]`` is popped." msgstr "" -#: ../../library/dis.rst:1191 ../../library/dis.rst:1204 +#: ../../library/dis.rst:1194 ../../library/dis.rst:1207 msgid "" "The oparg is now a relative delta rather than an absolute target. This " "opcode is a pseudo-instruction, replaced in final bytecode by the directed " "versions (forward/backward)." msgstr "" -#: ../../library/dis.rst:1196 ../../library/dis.rst:1209 -#: ../../library/dis.rst:1222 ../../library/dis.rst:1236 +#: ../../library/dis.rst:1199 ../../library/dis.rst:1212 +#: ../../library/dis.rst:1225 ../../library/dis.rst:1239 msgid "This is no longer a pseudo-instruction." msgstr "" -#: ../../library/dis.rst:1201 +#: ../../library/dis.rst:1204 msgid "" "If ``STACK[-1]`` is false, increments the bytecode counter by *delta*. " "``STACK[-1]`` is popped." msgstr "" -#: ../../library/dis.rst:1214 +#: ../../library/dis.rst:1217 msgid "" "If ``STACK[-1]`` is not ``None``, increments the bytecode counter by " "*delta*. ``STACK[-1]`` is popped." msgstr "" -#: ../../library/dis.rst:1217 ../../library/dis.rst:1231 +#: ../../library/dis.rst:1220 ../../library/dis.rst:1234 msgid "" "This opcode is a pseudo-instruction, replaced in final bytecode by the " "directed versions (forward/backward)." msgstr "" -#: ../../library/dis.rst:1228 +#: ../../library/dis.rst:1231 msgid "" "If ``STACK[-1]`` is ``None``, increments the bytecode counter by *delta*. " "``STACK[-1]`` is popped." msgstr "" -#: ../../library/dis.rst:1241 +#: ../../library/dis.rst:1244 msgid "" "``STACK[-1]`` is an :term:`iterator`. Call its :meth:`~iterator.__next__` " "method. If this yields a new value, push it on the stack (leaving the " @@ -1143,88 +1149,88 @@ msgid "" "code counter is incremented by *delta*." msgstr "" -#: ../../library/dis.rst:1246 +#: ../../library/dis.rst:1249 msgid "Up until 3.11 the iterator was popped when it was exhausted." msgstr "" -#: ../../library/dis.rst:1251 +#: ../../library/dis.rst:1254 msgid "Loads the global named ``co_names[namei>>1]`` onto the stack." msgstr "" -#: ../../library/dis.rst:1253 +#: ../../library/dis.rst:1256 msgid "" "If the low bit of ``namei`` is set, then a ``NULL`` is pushed to the stack " "before the global variable." msgstr "" -#: ../../library/dis.rst:1259 +#: ../../library/dis.rst:1262 msgid "" "Pushes a reference to the local ``co_varnames[var_num]`` onto the stack." msgstr "" -#: ../../library/dis.rst:1261 +#: ../../library/dis.rst:1264 msgid "" "This opcode is now only used in situations where the local variable is " "guaranteed to be initialized. It cannot raise :exc:`UnboundLocalError`." msgstr "" -#: ../../library/dis.rst:1267 +#: ../../library/dis.rst:1270 msgid "" "Pushes a reference to the local ``co_varnames[var_num]`` onto the stack, " "raising an :exc:`UnboundLocalError` if the local variable has not been " "initialized." msgstr "" -#: ../../library/dis.rst:1275 +#: ../../library/dis.rst:1278 msgid "" "Pushes a reference to the local ``co_varnames[var_num]`` onto the stack (or " "pushes ``NULL`` onto the stack if the local variable has not been " "initialized) and sets ``co_varnames[var_num]`` to ``NULL``." msgstr "" -#: ../../library/dis.rst:1283 +#: ../../library/dis.rst:1286 msgid "Stores ``STACK.pop()`` into the local ``co_varnames[var_num]``." msgstr "" -#: ../../library/dis.rst:1288 +#: ../../library/dis.rst:1291 msgid "Deletes local ``co_varnames[var_num]``." msgstr "" -#: ../../library/dis.rst:1293 +#: ../../library/dis.rst:1296 msgid "" "Creates a new cell in slot ``i``. If that slot is nonempty then that value " "is stored into the new cell." msgstr "" -#: ../../library/dis.rst:1301 +#: ../../library/dis.rst:1304 msgid "" "Pushes a reference to the cell contained in slot ``i`` of the \"fast " "locals\" storage. The name of the variable is ``co_fastlocalnames[i]``." msgstr "" -#: ../../library/dis.rst:1304 +#: ../../library/dis.rst:1307 msgid "" "Note that ``LOAD_CLOSURE`` is effectively an alias for ``LOAD_FAST``. It " "exists to keep bytecode a little more readable." msgstr "" -#: ../../library/dis.rst:1307 +#: ../../library/dis.rst:1310 msgid "``i`` is no longer offset by the length of ``co_varnames``." msgstr "" -#: ../../library/dis.rst:1313 +#: ../../library/dis.rst:1316 msgid "" "Loads the cell contained in slot ``i`` of the \"fast locals\" storage. " "Pushes a reference to the object the cell contains on the stack." msgstr "" -#: ../../library/dis.rst:1316 ../../library/dis.rst:1338 -#: ../../library/dis.rst:1349 +#: ../../library/dis.rst:1319 ../../library/dis.rst:1341 +#: ../../library/dis.rst:1352 msgid "" "``i`` is no longer offset by the length of :attr:`~codeobject.co_varnames`." msgstr "" -#: ../../library/dis.rst:1322 +#: ../../library/dis.rst:1325 msgid "" "Pops a mapping off the stack and looks up the name associated with slot " "``i`` of the \"fast locals\" storage in this mapping. If the name is not " @@ -1234,94 +1240,94 @@ msgid "" "scopes ` within class bodies." msgstr "" -#: ../../library/dis.rst:1335 +#: ../../library/dis.rst:1338 msgid "" "Stores ``STACK.pop()`` into the cell contained in slot ``i`` of the \"fast " "locals\" storage." msgstr "" -#: ../../library/dis.rst:1344 +#: ../../library/dis.rst:1347 msgid "" "Empties the cell contained in slot ``i`` of the \"fast locals\" storage. " "Used by the :keyword:`del` statement." msgstr "" -#: ../../library/dis.rst:1355 +#: ../../library/dis.rst:1358 msgid "" "Copies the ``n`` free variables from the closure into the frame. Removes the " "need for special code on the caller's side when calling closures." msgstr "" -#: ../../library/dis.rst:1364 +#: ../../library/dis.rst:1367 msgid "" "Raises an exception using one of the 3 forms of the ``raise`` statement, " "depending on the value of *argc*:" msgstr "" -#: ../../library/dis.rst:1367 +#: ../../library/dis.rst:1370 msgid "0: ``raise`` (re-raise previous exception)" msgstr "" -#: ../../library/dis.rst:1368 +#: ../../library/dis.rst:1371 msgid "" "1: ``raise STACK[-1]`` (raise exception instance or type at ``STACK[-1]``)" msgstr "" -#: ../../library/dis.rst:1369 +#: ../../library/dis.rst:1372 msgid "" "2: ``raise STACK[-2] from STACK[-1]`` (raise exception instance or type at " "``STACK[-2]`` with ``__cause__`` set to ``STACK[-1]``)" msgstr "" -#: ../../library/dis.rst:1375 +#: ../../library/dis.rst:1378 msgid "" "Calls a callable object with the number of arguments specified by ``argc``, " "including the named arguments specified by the preceding :opcode:`KW_NAMES`, " "if any. On the stack are (in ascending order), either:" msgstr "" -#: ../../library/dis.rst:1380 +#: ../../library/dis.rst:1383 msgid "NULL" msgstr "" -#: ../../library/dis.rst:1381 ../../library/dis.rst:1387 +#: ../../library/dis.rst:1384 ../../library/dis.rst:1390 msgid "The callable" msgstr "" -#: ../../library/dis.rst:1382 +#: ../../library/dis.rst:1385 msgid "The positional arguments" msgstr "" -#: ../../library/dis.rst:1383 ../../library/dis.rst:1390 +#: ../../library/dis.rst:1386 ../../library/dis.rst:1393 msgid "The named arguments" msgstr "" -#: ../../library/dis.rst:1385 +#: ../../library/dis.rst:1388 msgid "or:" msgstr "或：" -#: ../../library/dis.rst:1388 +#: ../../library/dis.rst:1391 msgid "``self``" msgstr "``self``" -#: ../../library/dis.rst:1389 +#: ../../library/dis.rst:1392 msgid "The remaining positional arguments" msgstr "" -#: ../../library/dis.rst:1392 +#: ../../library/dis.rst:1395 msgid "" "``argc`` is the total of the positional and named arguments, excluding " "``self`` when a ``NULL`` is not present." msgstr "" -#: ../../library/dis.rst:1395 +#: ../../library/dis.rst:1398 msgid "" "``CALL`` pops all arguments and the callable object off the stack, calls the " "callable object with those arguments, and pushes the return value returned " "by the callable object." msgstr "" -#: ../../library/dis.rst:1404 +#: ../../library/dis.rst:1407 msgid "" "Calls a callable object with variable set of positional and keyword " "arguments. If the lowest bit of *flags* is set, the top of the stack " @@ -1333,70 +1339,70 @@ msgid "" "arguments, and pushes the return value returned by the callable object." msgstr "" -#: ../../library/dis.rst:1419 +#: ../../library/dis.rst:1422 msgid "" "Pushes a ``NULL`` to the stack. Used in the call sequence to match the " "``NULL`` pushed by :opcode:`LOAD_METHOD` for non-method calls." msgstr "" -#: ../../library/dis.rst:1428 +#: ../../library/dis.rst:1431 msgid "" "Prefixes :opcode:`CALL`. Stores a reference to ``co_consts[consti]`` into an " "internal variable for use by :opcode:`CALL`. ``co_consts[consti]`` must be a " "tuple of strings." msgstr "" -#: ../../library/dis.rst:1437 +#: ../../library/dis.rst:1440 msgid "" "Pushes a new function object on the stack. From bottom to top, the consumed " "stack must consist of values if the argument carries a specified flag value" msgstr "" -#: ../../library/dis.rst:1440 +#: ../../library/dis.rst:1443 msgid "" "``0x01`` a tuple of default values for positional-only and positional-or-" "keyword parameters in positional order" msgstr "" -#: ../../library/dis.rst:1442 +#: ../../library/dis.rst:1445 msgid "``0x02`` a dictionary of keyword-only parameters' default values" msgstr "" -#: ../../library/dis.rst:1443 +#: ../../library/dis.rst:1446 msgid "``0x04`` a tuple of strings containing parameters' annotations" msgstr "" -#: ../../library/dis.rst:1444 +#: ../../library/dis.rst:1447 msgid "``0x08`` a tuple containing cells for free variables, making a closure" msgstr "" -#: ../../library/dis.rst:1445 +#: ../../library/dis.rst:1448 msgid "the code associated with the function (at ``STACK[-1]``)" msgstr "" -#: ../../library/dis.rst:1447 +#: ../../library/dis.rst:1450 msgid "Flag value ``0x04`` is a tuple of strings instead of dictionary" msgstr "" -#: ../../library/dis.rst:1450 +#: ../../library/dis.rst:1453 msgid "Qualified name at ``STACK[-1]`` was removed." msgstr "" -#: ../../library/dis.rst:1458 +#: ../../library/dis.rst:1461 msgid "" "Pushes a slice object on the stack. *argc* must be 2 or 3. If it is 2, " "implements::" msgstr "" -#: ../../library/dis.rst:1464 +#: ../../library/dis.rst:1467 msgid "if it is 3, implements::" msgstr "" -#: ../../library/dis.rst:1471 +#: ../../library/dis.rst:1474 msgid "See the :func:`slice` built-in function for more information." msgstr "" -#: ../../library/dis.rst:1476 +#: ../../library/dis.rst:1479 msgid "" "Prefixes any opcode which has an argument too big to fit into the default " "one byte. *ext* holds an additional byte which act as higher bits in the " @@ -1404,54 +1410,54 @@ msgid "" "allowed, forming an argument from two-byte to four-byte." msgstr "" -#: ../../library/dis.rst:1484 +#: ../../library/dis.rst:1487 msgid "" "Used for implementing formatted literal strings (f-strings). Pops an " "optional *fmt_spec* from the stack, then a required *value*. *flags* is " "interpreted as follows:" msgstr "" -#: ../../library/dis.rst:1488 +#: ../../library/dis.rst:1491 msgid "``(flags & 0x03) == 0x00``: *value* is formatted as-is." msgstr "" -#: ../../library/dis.rst:1489 +#: ../../library/dis.rst:1492 msgid "" "``(flags & 0x03) == 0x01``: call :func:`str` on *value* before formatting it." msgstr "" -#: ../../library/dis.rst:1491 +#: ../../library/dis.rst:1494 msgid "" "``(flags & 0x03) == 0x02``: call :func:`repr` on *value* before formatting " "it." msgstr "" -#: ../../library/dis.rst:1493 +#: ../../library/dis.rst:1496 msgid "" "``(flags & 0x03) == 0x03``: call :func:`ascii` on *value* before formatting " "it." msgstr "" -#: ../../library/dis.rst:1495 +#: ../../library/dis.rst:1498 msgid "" "``(flags & 0x04) == 0x04``: pop *fmt_spec* from the stack and use it, else " "use an empty *fmt_spec*." msgstr "" -#: ../../library/dis.rst:1498 +#: ../../library/dis.rst:1501 msgid "" "Formatting is performed using :c:func:`PyObject_Format`. The result is " "pushed on the stack." msgstr "" -#: ../../library/dis.rst:1506 +#: ../../library/dis.rst:1509 msgid "" "``STACK[-1]`` is a tuple of keyword attribute names, ``STACK[-2]`` is the " "class being matched against, and ``STACK[-3]`` is the match subject. " "*count* is the number of positional sub-patterns." msgstr "" -#: ../../library/dis.rst:1510 +#: ../../library/dis.rst:1513 msgid "" "Pop ``STACK[-1]``, ``STACK[-2]``, and ``STACK[-3]``. If ``STACK[-3]`` is an " "instance of ``STACK[-2]`` and has the positional and keyword attributes " @@ -1459,257 +1465,257 @@ msgid "" "Otherwise, push ``None``." msgstr "" -#: ../../library/dis.rst:1524 +#: ../../library/dis.rst:1527 msgid "A no-op. Performs internal tracing, debugging and optimization checks." msgstr "" -#: ../../library/dis.rst:1526 +#: ../../library/dis.rst:1529 msgid "The ``where`` operand marks where the ``RESUME`` occurs:" msgstr "" -#: ../../library/dis.rst:1528 +#: ../../library/dis.rst:1531 msgid "" "``0`` The start of a function, which is neither a generator, coroutine nor " "an async generator" msgstr "" -#: ../../library/dis.rst:1530 +#: ../../library/dis.rst:1533 msgid "``1`` After a ``yield`` expression" msgstr "" -#: ../../library/dis.rst:1531 +#: ../../library/dis.rst:1534 msgid "``2`` After a ``yield from`` expression" msgstr "" -#: ../../library/dis.rst:1532 +#: ../../library/dis.rst:1535 msgid "``3`` After an ``await`` expression" msgstr "" -#: ../../library/dis.rst:1539 +#: ../../library/dis.rst:1542 msgid "" "Create a generator, coroutine, or async generator from the current frame. " "Used as first opcode of in code object for the above mentioned callables. " "Clear the current frame and return the newly created generator." msgstr "" -#: ../../library/dis.rst:1548 +#: ../../library/dis.rst:1551 msgid "" "Equivalent to ``STACK[-1] = STACK[-2].send(STACK[-1])``. Used in ``yield " "from`` and ``await`` statements." msgstr "" -#: ../../library/dis.rst:1551 +#: ../../library/dis.rst:1554 msgid "" "If the call raises :exc:`StopIteration`, pop the top value from the stack, " "push the exception's ``value`` attribute, and increment the bytecode counter " "by *delta*." msgstr "" -#: ../../library/dis.rst:1560 +#: ../../library/dis.rst:1563 msgid "" "This is not really an opcode. It identifies the dividing line between " "opcodes in the range [0,255] which don't use their argument and those that " "do (``< HAVE_ARGUMENT`` and ``>= HAVE_ARGUMENT``, respectively)." msgstr "" -#: ../../library/dis.rst:1564 +#: ../../library/dis.rst:1567 msgid "" "If your application uses pseudo instructions, use the :data:`hasarg` " "collection instead." msgstr "" -#: ../../library/dis.rst:1567 +#: ../../library/dis.rst:1570 msgid "" "Now every instruction has an argument, but opcodes ``< HAVE_ARGUMENT`` " "ignore it. Before, only opcodes ``>= HAVE_ARGUMENT`` had an argument." msgstr "" -#: ../../library/dis.rst:1571 +#: ../../library/dis.rst:1574 msgid "" "Pseudo instructions were added to the :mod:`dis` module, and for them it is " "not true that comparison with ``HAVE_ARGUMENT`` indicates whether they use " "their arg." msgstr "" -#: ../../library/dis.rst:1579 +#: ../../library/dis.rst:1582 msgid "" "Calls an intrinsic function with one argument. Passes ``STACK[-1]`` as the " "argument and sets ``STACK[-1]`` to the result. Used to implement " "functionality that is not performance critical." msgstr "" -#: ../../library/dis.rst:1583 ../../library/dis.rst:1637 +#: ../../library/dis.rst:1586 ../../library/dis.rst:1640 msgid "The operand determines which intrinsic function is called:" msgstr "" -#: ../../library/dis.rst:1586 ../../library/dis.rst:1640 +#: ../../library/dis.rst:1589 ../../library/dis.rst:1643 msgid "Operand" msgstr "" -#: ../../library/dis.rst:1586 ../../library/dis.rst:1640 +#: ../../library/dis.rst:1589 ../../library/dis.rst:1643 msgid "Description" msgstr "" -#: ../../library/dis.rst:1588 +#: ../../library/dis.rst:1591 msgid "``INTRINSIC_1_INVALID``" msgstr "``INTRINSIC_1_INVALID``" -#: ../../library/dis.rst:1588 ../../library/dis.rst:1642 +#: ../../library/dis.rst:1591 ../../library/dis.rst:1645 msgid "Not valid" msgstr "" -#: ../../library/dis.rst:1590 +#: ../../library/dis.rst:1593 msgid "``INTRINSIC_PRINT``" msgstr "``INTRINSIC_PRINT``" -#: ../../library/dis.rst:1590 +#: ../../library/dis.rst:1593 msgid "Prints the argument to standard out. Used in the REPL." msgstr "" -#: ../../library/dis.rst:1593 +#: ../../library/dis.rst:1596 msgid "``INTRINSIC_IMPORT_STAR``" msgstr "``INTRINSIC_IMPORT_STAR``" -#: ../../library/dis.rst:1593 +#: ../../library/dis.rst:1596 msgid "Performs ``import *`` for the named module." msgstr "" -#: ../../library/dis.rst:1596 +#: ../../library/dis.rst:1599 msgid "``INTRINSIC_STOPITERATION_ERROR``" msgstr "``INTRINSIC_STOPITERATION_ERROR``" -#: ../../library/dis.rst:1596 +#: ../../library/dis.rst:1599 msgid "Extracts the return value from a ``StopIteration`` exception." msgstr "" -#: ../../library/dis.rst:1599 +#: ../../library/dis.rst:1602 msgid "``INTRINSIC_ASYNC_GEN_WRAP``" msgstr "``INTRINSIC_ASYNC_GEN_WRAP``" -#: ../../library/dis.rst:1599 +#: ../../library/dis.rst:1602 msgid "Wraps an async generator value" msgstr "" -#: ../../library/dis.rst:1601 +#: ../../library/dis.rst:1604 msgid "``INTRINSIC_UNARY_POSITIVE``" msgstr "``INTRINSIC_UNARY_POSITIVE``" -#: ../../library/dis.rst:1601 +#: ../../library/dis.rst:1604 msgid "Performs the unary ``+`` operation" msgstr "" -#: ../../library/dis.rst:1604 +#: ../../library/dis.rst:1607 msgid "``INTRINSIC_LIST_TO_TUPLE``" msgstr "``INTRINSIC_LIST_TO_TUPLE``" -#: ../../library/dis.rst:1604 +#: ../../library/dis.rst:1607 msgid "Converts a list to a tuple" msgstr "" -#: ../../library/dis.rst:1606 +#: ../../library/dis.rst:1609 msgid "``INTRINSIC_TYPEVAR``" msgstr "``INTRINSIC_TYPEVAR``" -#: ../../library/dis.rst:1606 +#: ../../library/dis.rst:1609 msgid "Creates a :class:`typing.TypeVar`" msgstr "" -#: ../../library/dis.rst:1608 +#: ../../library/dis.rst:1611 msgid "``INTRINSIC_PARAMSPEC``" msgstr "``INTRINSIC_PARAMSPEC``" -#: ../../library/dis.rst:1608 +#: ../../library/dis.rst:1611 msgid "Creates a :class:`typing.ParamSpec`" msgstr "" -#: ../../library/dis.rst:1611 +#: ../../library/dis.rst:1614 msgid "``INTRINSIC_TYPEVARTUPLE``" msgstr "``INTRINSIC_TYPEVARTUPLE``" -#: ../../library/dis.rst:1611 +#: ../../library/dis.rst:1614 msgid "Creates a :class:`typing.TypeVarTuple`" msgstr "" -#: ../../library/dis.rst:1614 +#: ../../library/dis.rst:1617 msgid "``INTRINSIC_SUBSCRIPT_GENERIC``" msgstr "``INTRINSIC_SUBSCRIPT_GENERIC``" -#: ../../library/dis.rst:1614 +#: ../../library/dis.rst:1617 msgid "Returns :class:`typing.Generic` subscripted with the argument" msgstr "" -#: ../../library/dis.rst:1617 +#: ../../library/dis.rst:1620 msgid "``INTRINSIC_TYPEALIAS``" msgstr "``INTRINSIC_TYPEALIAS``" -#: ../../library/dis.rst:1617 +#: ../../library/dis.rst:1620 msgid "" "Creates a :class:`typing.TypeAliasType`; used in the :keyword:`type` " "statement. The argument is a tuple of the type alias's name, type " "parameters, and value." msgstr "" -#: ../../library/dis.rst:1629 +#: ../../library/dis.rst:1632 msgid "" "Calls an intrinsic function with two arguments. Used to implement " "functionality that is not performance critical::" msgstr "" -#: ../../library/dis.rst:1642 +#: ../../library/dis.rst:1645 msgid "``INTRINSIC_2_INVALID``" msgstr "``INTRINSIC_2_INVALID``" -#: ../../library/dis.rst:1644 +#: ../../library/dis.rst:1647 msgid "``INTRINSIC_PREP_RERAISE_STAR``" msgstr "``INTRINSIC_PREP_RERAISE_STAR``" -#: ../../library/dis.rst:1644 +#: ../../library/dis.rst:1647 msgid "Calculates the :exc:`ExceptionGroup` to raise from a ``try-except*``." msgstr "" -#: ../../library/dis.rst:1648 +#: ../../library/dis.rst:1651 msgid "``INTRINSIC_TYPEVAR_WITH_BOUND``" msgstr "``INTRINSIC_TYPEVAR_WITH_BOUND``" -#: ../../library/dis.rst:1648 +#: ../../library/dis.rst:1651 msgid "Creates a :class:`typing.TypeVar` with a bound." msgstr "" -#: ../../library/dis.rst:1651 +#: ../../library/dis.rst:1654 msgid "``INTRINSIC_TYPEVAR_WITH_CONSTRAINTS``" msgstr "``INTRINSIC_TYPEVAR_WITH_CONSTRAINTS``" -#: ../../library/dis.rst:1651 +#: ../../library/dis.rst:1654 msgid "Creates a :class:`typing.TypeVar` with constraints." msgstr "" -#: ../../library/dis.rst:1655 +#: ../../library/dis.rst:1658 msgid "``INTRINSIC_SET_FUNCTION_TYPE_PARAMS``" msgstr "``INTRINSIC_SET_FUNCTION_TYPE_PARAMS``" -#: ../../library/dis.rst:1655 +#: ../../library/dis.rst:1658 msgid "Sets the ``__type_params__`` attribute of a function." msgstr "" -#: ../../library/dis.rst:1662 +#: ../../library/dis.rst:1665 msgid "**Pseudo-instructions**" msgstr "" -#: ../../library/dis.rst:1664 +#: ../../library/dis.rst:1667 msgid "" "These opcodes do not appear in Python bytecode. They are used by the " "compiler but are replaced by real opcodes or removed before bytecode is " "generated." msgstr "" -#: ../../library/dis.rst:1669 +#: ../../library/dis.rst:1672 msgid "" "Set up an exception handler for the following code block. If an exception " "occurs, the value stack level is restored to its current state and control " "is transferred to the exception handler at ``target``." msgstr "" -#: ../../library/dis.rst:1676 +#: ../../library/dis.rst:1679 msgid "" "Like ``SETUP_FINALLY``, but in case of an exception also pushes the last " "instruction (``lasti``) to the stack so that ``RERAISE`` can restore it. If " @@ -1718,76 +1724,76 @@ msgid "" "exception handler at ``target``." msgstr "" -#: ../../library/dis.rst:1685 +#: ../../library/dis.rst:1688 msgid "" "Like ``SETUP_CLEANUP``, but in case of an exception one more item is popped " "from the stack before control is transferred to the exception handler at " "``target``." msgstr "" -#: ../../library/dis.rst:1689 +#: ../../library/dis.rst:1692 msgid "" "This variant is used in :keyword:`with` and :keyword:`async with` " "constructs, which push the return value of the context manager's :meth:" "`~object.__enter__` or :meth:`~object.__aenter__` to the stack." msgstr "" -#: ../../library/dis.rst:1696 +#: ../../library/dis.rst:1699 msgid "" "Marks the end of the code block associated with the last ``SETUP_FINALLY``, " "``SETUP_CLEANUP`` or ``SETUP_WITH``." msgstr "" -#: ../../library/dis.rst:1702 +#: ../../library/dis.rst:1705 msgid "" "Undirected relative jump instructions which are replaced by their directed " "(forward/backward) counterparts by the assembler." msgstr "" -#: ../../library/dis.rst:1707 +#: ../../library/dis.rst:1710 msgid "" "Optimized unbound method lookup. Emitted as a ``LOAD_ATTR`` opcode with a " "flag set in the arg." msgstr "" -#: ../../library/dis.rst:1714 +#: ../../library/dis.rst:1717 msgid "Opcode collections" msgstr "" -#: ../../library/dis.rst:1716 +#: ../../library/dis.rst:1719 msgid "" "These collections are provided for automatic introspection of bytecode " "instructions:" msgstr "" -#: ../../library/dis.rst:1719 +#: ../../library/dis.rst:1722 msgid "" "The collections now contain pseudo instructions and instrumented " "instructions as well. These are opcodes with values ``>= MIN_PSEUDO_OPCODE`` " "and ``>= MIN_INSTRUMENTED_OPCODE``." msgstr "" -#: ../../library/dis.rst:1726 +#: ../../library/dis.rst:1729 msgid "Sequence of operation names, indexable using the bytecode." msgstr "" -#: ../../library/dis.rst:1731 +#: ../../library/dis.rst:1734 msgid "Dictionary mapping operation names to bytecodes." msgstr "" -#: ../../library/dis.rst:1736 +#: ../../library/dis.rst:1739 msgid "Sequence of all compare operation names." msgstr "" -#: ../../library/dis.rst:1741 +#: ../../library/dis.rst:1744 msgid "Sequence of bytecodes that use their argument." msgstr "" -#: ../../library/dis.rst:1748 +#: ../../library/dis.rst:1751 msgid "Sequence of bytecodes that access a constant." msgstr "" -#: ../../library/dis.rst:1753 +#: ../../library/dis.rst:1756 msgid "" "Sequence of bytecodes that access a free variable. 'free' in this context " "refers to names in the current scope that are referenced by inner scopes or " @@ -1795,34 +1801,34 @@ msgid "" "include references to global or builtin scopes." msgstr "" -#: ../../library/dis.rst:1761 +#: ../../library/dis.rst:1764 msgid "Sequence of bytecodes that access an attribute by name." msgstr "" -#: ../../library/dis.rst:1766 +#: ../../library/dis.rst:1769 msgid "Sequence of bytecodes that have a relative jump target." msgstr "" -#: ../../library/dis.rst:1771 +#: ../../library/dis.rst:1774 msgid "Sequence of bytecodes that have an absolute jump target." msgstr "" -#: ../../library/dis.rst:1776 +#: ../../library/dis.rst:1779 msgid "Sequence of bytecodes that access a local variable." msgstr "" -#: ../../library/dis.rst:1781 +#: ../../library/dis.rst:1784 msgid "Sequence of bytecodes of Boolean operations." msgstr "" -#: ../../library/dis.rst:1785 +#: ../../library/dis.rst:1788 msgid "Sequence of bytecodes that set an exception handler." msgstr "" -#: ../../library/dis.rst:1456 +#: ../../library/dis.rst:1459 msgid "built-in function" msgstr "built-in function（內建函式）" -#: ../../library/dis.rst:1456 +#: ../../library/dis.rst:1459 msgid "slice" msgstr "slice（切片）" diff --git a/library/email.errors.po b/library/email.errors.po index fb695bb0ac..b9ac58c595 100644 --- a/library/email.errors.po +++ b/library/email.errors.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-08-07 00:03+0000\n" "PO-Revision-Date: 2018-05-23 14:44+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -80,19 +80,24 @@ msgid "" "`~email.mime.image.MIMEImage`)." msgstr "" -#: ../../library/email.errors.rst:63 +#: ../../library/email.errors.rst:64 +msgid "" +"Raised when an error occurs when the :mod:`~email.generator` outputs headers." +msgstr "" + +#: ../../library/email.errors.rst:70 msgid "" "This is the base class for all defects found when parsing email messages. It " "is derived from :exc:`ValueError`." msgstr "" -#: ../../library/email.errors.rst:68 +#: ../../library/email.errors.rst:75 msgid "" "This is the base class for all defects found when parsing email headers. It " "is derived from :exc:`MessageDefect`." msgstr "" -#: ../../library/email.errors.rst:71 +#: ../../library/email.errors.rst:78 msgid "" "Here is the list of the defects that the :class:`~email.parser.FeedParser` " "can find while parsing messages. Note that the defects are added to the " @@ -102,59 +107,59 @@ msgid "" "not." msgstr "" -#: ../../library/email.errors.rst:77 +#: ../../library/email.errors.rst:84 msgid "" "All defect classes are subclassed from :class:`email.errors.MessageDefect`." msgstr "" -#: ../../library/email.errors.rst:79 +#: ../../library/email.errors.rst:86 msgid "" ":class:`NoBoundaryInMultipartDefect` -- A message claimed to be a multipart, " "but had no :mimetype:`boundary` parameter." msgstr "" -#: ../../library/email.errors.rst:82 +#: ../../library/email.errors.rst:89 msgid "" ":class:`StartBoundaryNotFoundDefect` -- The start boundary claimed in the :" "mailheader:`Content-Type` header was never found." msgstr "" -#: ../../library/email.errors.rst:85 +#: ../../library/email.errors.rst:92 msgid "" ":class:`CloseBoundaryNotFoundDefect` -- A start boundary was found, but no " "corresponding close boundary was ever found." msgstr "" -#: ../../library/email.errors.rst:90 +#: ../../library/email.errors.rst:97 msgid "" ":class:`FirstHeaderLineIsContinuationDefect` -- The message had a " "continuation line as its first header line." msgstr "" -#: ../../library/email.errors.rst:93 +#: ../../library/email.errors.rst:100 msgid "" ":class:`MisplacedEnvelopeHeaderDefect` - A \"Unix From\" header was found in " "the middle of a header block." msgstr "" -#: ../../library/email.errors.rst:96 +#: ../../library/email.errors.rst:103 msgid "" ":class:`MissingHeaderBodySeparatorDefect` - A line was found while parsing " "headers that had no leading white space but contained no ':'. Parsing " "continues assuming that the line represents the first line of the body." msgstr "" -#: ../../library/email.errors.rst:102 +#: ../../library/email.errors.rst:109 msgid "" ":class:`MalformedHeaderDefect` -- A header was found that was missing a " "colon, or was otherwise malformed." msgstr "" -#: ../../library/email.errors.rst:105 +#: ../../library/email.errors.rst:112 msgid "This defect has not been used for several Python versions." msgstr "" -#: ../../library/email.errors.rst:108 +#: ../../library/email.errors.rst:115 msgid "" ":class:`MultipartInvariantViolationDefect` -- A message claimed to be a :" "mimetype:`multipart`, but no subparts were found. Note that when a message " @@ -163,28 +168,28 @@ msgid "" "`multipart`." msgstr "" -#: ../../library/email.errors.rst:113 +#: ../../library/email.errors.rst:120 msgid "" ":class:`InvalidBase64PaddingDefect` -- When decoding a block of base64 " "encoded bytes, the padding was not correct. Enough padding is added to " "perform the decode, but the resulting decoded bytes may be invalid." msgstr "" -#: ../../library/email.errors.rst:117 +#: ../../library/email.errors.rst:124 msgid "" ":class:`InvalidBase64CharactersDefect` -- When decoding a block of base64 " "encoded bytes, characters outside the base64 alphabet were encountered. The " "characters are ignored, but the resulting decoded bytes may be invalid." msgstr "" -#: ../../library/email.errors.rst:121 +#: ../../library/email.errors.rst:128 msgid "" ":class:`InvalidBase64LengthDefect` -- When decoding a block of base64 " "encoded bytes, the number of non-padding base64 characters was invalid (1 " "more than a multiple of 4). The encoded block was kept as-is." msgstr "" -#: ../../library/email.errors.rst:125 +#: ../../library/email.errors.rst:132 msgid "" ":class:`InvalidDateDefect` -- When decoding an invalid or unparsable date " "field. The original value is kept as-is." diff --git a/library/email.policy.po b/library/email.policy.po index b516bdae08..f3c991842c 100644 --- a/library/email.policy.po +++ b/library/email.policy.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-09 00:03+0000\n" +"POT-Creation-Date: 2024-08-07 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:01+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -247,46 +247,62 @@ msgid "" "`~email.message.Message` is used." msgstr "" -#: ../../library/email.policy.rst:232 +#: ../../library/email.policy.rst:235 +msgid "" +"If ``True`` (the default), the generator will raise :exc:`~email.errors." +"HeaderWriteError` instead of writing a header that is improperly folded or " +"delimited, such that it would be parsed as multiple headers or joined with " +"adjacent data. Such headers can be generated by custom header classes or " +"bugs in the ``email`` module." +msgstr "" + +#: ../../library/email.policy.rst:242 +msgid "" +"As it's a security feature, this defaults to ``True`` even in the :class:" +"`~email.policy.Compat32` policy. For backwards compatible, but unsafe, " +"behavior, it must be set to ``False`` explicitly." +msgstr "" + +#: ../../library/email.policy.rst:250 msgid "" "The following :class:`Policy` method is intended to be called by code using " "the email library to create policy instances with custom settings:" msgstr "" -#: ../../library/email.policy.rst:238 +#: ../../library/email.policy.rst:256 msgid "" "Return a new :class:`Policy` instance whose attributes have the same values " "as the current instance, except where those attributes are given new values " "by the keyword arguments." msgstr "" -#: ../../library/email.policy.rst:243 +#: ../../library/email.policy.rst:261 msgid "" "The remaining :class:`Policy` methods are called by the email package code, " "and are not intended to be called by an application using the email package. " "A custom policy must implement all of these methods." msgstr "" -#: ../../library/email.policy.rst:250 +#: ../../library/email.policy.rst:268 msgid "" "Handle a *defect* found on *obj*. When the email package calls this method, " "*defect* will always be a subclass of :class:`~email.errors.Defect`." msgstr "" -#: ../../library/email.policy.rst:254 +#: ../../library/email.policy.rst:272 msgid "" "The default implementation checks the :attr:`raise_on_defect` flag. If it " "is ``True``, *defect* is raised as an exception. If it is ``False`` (the " "default), *obj* and *defect* are passed to :meth:`register_defect`." msgstr "" -#: ../../library/email.policy.rst:261 +#: ../../library/email.policy.rst:279 msgid "" "Register a *defect* on *obj*. In the email package, *defect* will always be " "a subclass of :class:`~email.errors.Defect`." msgstr "" -#: ../../library/email.policy.rst:264 +#: ../../library/email.policy.rst:282 msgid "" "The default implementation calls the ``append`` method of the ``defects`` " "attribute of *obj*. When the email package calls :attr:`handle_defect`, " @@ -296,11 +312,11 @@ msgid "" "defects in parsed messages will raise unexpected errors." msgstr "" -#: ../../library/email.policy.rst:274 +#: ../../library/email.policy.rst:292 msgid "Return the maximum allowed number of headers named *name*." msgstr "" -#: ../../library/email.policy.rst:276 +#: ../../library/email.policy.rst:294 msgid "" "Called when a header is added to an :class:`~email.message.EmailMessage` or :" "class:`~email.message.Message` object. If the returned value is not ``0`` " @@ -308,7 +324,7 @@ msgid "" "greater than or equal to the value returned, a :exc:`ValueError` is raised." msgstr "" -#: ../../library/email.policy.rst:282 +#: ../../library/email.policy.rst:300 msgid "" "Because the default behavior of ``Message.__setitem__`` is to append the " "value to the list of headers, it is easy to create duplicate headers without " @@ -318,11 +334,11 @@ msgid "" "faithfully produce as many headers as exist in the message being parsed.)" msgstr "" -#: ../../library/email.policy.rst:290 +#: ../../library/email.policy.rst:308 msgid "The default implementation returns ``None`` for all header names." msgstr "" -#: ../../library/email.policy.rst:295 +#: ../../library/email.policy.rst:313 msgid "" "The email package calls this method with a list of strings, each string " "ending with the line separation characters found in the source being " @@ -332,7 +348,7 @@ msgid "" "the parsed header." msgstr "" -#: ../../library/email.policy.rst:302 +#: ../../library/email.policy.rst:320 msgid "" "If an implementation wishes to retain compatibility with the existing email " "package policies, *name* should be the case preserved name (all characters " @@ -341,16 +357,16 @@ msgid "" "stripped of leading whitespace." msgstr "" -#: ../../library/email.policy.rst:308 +#: ../../library/email.policy.rst:326 msgid "*sourcelines* may contain surrogateescaped binary data." msgstr "" -#: ../../library/email.policy.rst:310 ../../library/email.policy.rst:326 -#: ../../library/email.policy.rst:342 +#: ../../library/email.policy.rst:328 ../../library/email.policy.rst:344 +#: ../../library/email.policy.rst:360 msgid "There is no default implementation" msgstr "" -#: ../../library/email.policy.rst:315 +#: ../../library/email.policy.rst:333 msgid "" "The email package calls this method with the name and value provided by the " "application program when the application program is modifying a ``Message`` " @@ -359,14 +375,14 @@ msgid "" "``Message`` to represent the header." msgstr "" -#: ../../library/email.policy.rst:321 +#: ../../library/email.policy.rst:339 msgid "" "If an implementation wishes to retain compatibility with the existing email " "package policies, the *name* and *value* should be strings or string " "subclasses that do not change the content of the passed in arguments." msgstr "" -#: ../../library/email.policy.rst:331 +#: ../../library/email.policy.rst:349 msgid "" "The email package calls this method with the *name* and *value* currently " "stored in the ``Message`` when that header is requested by the application " @@ -377,13 +393,13 @@ msgid "" "returned to the application." msgstr "" -#: ../../library/email.policy.rst:339 +#: ../../library/email.policy.rst:357 msgid "" "*value* may contain surrogateescaped binary data. There should be no " "surrogateescaped binary data in the value returned by the method." msgstr "" -#: ../../library/email.policy.rst:347 +#: ../../library/email.policy.rst:365 msgid "" "The email package calls this method with the *name* and *value* currently " "stored in the ``Message`` for a given header. The method should return a " @@ -393,32 +409,32 @@ msgid "" "discussion of the rules for folding email headers." msgstr "" -#: ../../library/email.policy.rst:354 +#: ../../library/email.policy.rst:372 msgid "" "*value* may contain surrogateescaped binary data. There should be no " "surrogateescaped binary data in the string returned by the method." msgstr "" -#: ../../library/email.policy.rst:360 +#: ../../library/email.policy.rst:378 msgid "" "The same as :meth:`fold`, except that the returned value should be a bytes " "object rather than a string." msgstr "" -#: ../../library/email.policy.rst:363 +#: ../../library/email.policy.rst:381 msgid "" "*value* may contain surrogateescaped binary data. These could be converted " "back into binary data in the returned bytes object." msgstr "" -#: ../../library/email.policy.rst:370 +#: ../../library/email.policy.rst:388 msgid "" "This concrete :class:`Policy` provides behavior that is intended to be fully " "compliant with the current email RFCs. These include (but are not limited " "to) :rfc:`5322`, :rfc:`2047`, and the current MIME RFCs." msgstr "" -#: ../../library/email.policy.rst:374 +#: ../../library/email.policy.rst:392 msgid "" "This policy adds new header parsing and folding algorithms. Instead of " "simple strings, headers are ``str`` subclasses with attributes that depend " @@ -426,23 +442,23 @@ msgid "" "implement :rfc:`2047` and :rfc:`5322`." msgstr "" -#: ../../library/email.policy.rst:379 +#: ../../library/email.policy.rst:397 msgid "" "The default value for the :attr:`~email.policy.Policy.message_factory` " "attribute is :class:`~email.message.EmailMessage`." msgstr "" -#: ../../library/email.policy.rst:382 +#: ../../library/email.policy.rst:400 msgid "" "In addition to the settable attributes listed above that apply to all " "policies, this policy adds the following additional attributes:" msgstr "" -#: ../../library/email.policy.rst:385 +#: ../../library/email.policy.rst:403 msgid "[1]_" msgstr "" -#: ../../library/email.policy.rst:390 +#: ../../library/email.policy.rst:408 msgid "" "If ``False``, follow :rfc:`5322`, supporting non-ASCII characters in headers " "by encoding them as \"encoded words\". If ``True``, follow :rfc:`6532` and " @@ -450,7 +466,7 @@ msgid "" "passed to SMTP servers that support the ``SMTPUTF8`` extension (:rfc:`6531`)." msgstr "" -#: ../../library/email.policy.rst:399 +#: ../../library/email.policy.rst:417 msgid "" "If the value for a header in the ``Message`` object originated from a :mod:" "`~email.parser` (as opposed to being set by a program), this attribute " @@ -458,37 +474,37 @@ msgid "" "transforming the message back into serialized form. The possible values are:" msgstr "" -#: ../../library/email.policy.rst:406 +#: ../../library/email.policy.rst:424 msgid "``none``" msgstr "``none``" -#: ../../library/email.policy.rst:406 +#: ../../library/email.policy.rst:424 msgid "all source values use original folding" msgstr "" -#: ../../library/email.policy.rst:408 +#: ../../library/email.policy.rst:426 msgid "``long``" msgstr "``long``" -#: ../../library/email.policy.rst:408 +#: ../../library/email.policy.rst:426 msgid "" "source values that have any line that is longer than ``max_line_length`` " "will be refolded" msgstr "" -#: ../../library/email.policy.rst:411 +#: ../../library/email.policy.rst:429 msgid "``all``" msgstr "``all``" -#: ../../library/email.policy.rst:411 +#: ../../library/email.policy.rst:429 msgid "all values are refolded." msgstr "" -#: ../../library/email.policy.rst:414 +#: ../../library/email.policy.rst:432 msgid "The default is ``long``." msgstr "預設為 ``long``。" -#: ../../library/email.policy.rst:419 +#: ../../library/email.policy.rst:437 msgid "" "A callable that takes two arguments, ``name`` and ``value``, where ``name`` " "is a header field name and ``value`` is an unfolded header field value, and " @@ -499,7 +515,7 @@ msgid "" "custom parsing will be added in the future." msgstr "" -#: ../../library/email.policy.rst:430 +#: ../../library/email.policy.rst:448 msgid "" "An object with at least two methods: get_content and set_content. When the :" "meth:`~email.message.EmailMessage.get_content` or :meth:`~email.message." @@ -510,20 +526,20 @@ msgid "" "``content_manager`` is set to :data:`~email.contentmanager.raw_data_manager`." msgstr "" -#: ../../library/email.policy.rst:442 ../../library/email.policy.rst:600 +#: ../../library/email.policy.rst:460 ../../library/email.policy.rst:618 msgid "" "The class provides the following concrete implementations of the abstract " "methods of :class:`Policy`:" msgstr "" -#: ../../library/email.policy.rst:448 +#: ../../library/email.policy.rst:466 msgid "" "Returns the value of the :attr:`~email.headerregistry.BaseHeader.max_count` " "attribute of the specialized class used to represent the header with the " "given name." msgstr "" -#: ../../library/email.policy.rst:456 ../../library/email.policy.rst:606 +#: ../../library/email.policy.rst:474 ../../library/email.policy.rst:624 msgid "" "The name is parsed as everything up to the '``:``' and returned unmodified. " "The value is determined by stripping leading whitespace off the remainder of " @@ -531,7 +547,7 @@ msgid "" "trailing carriage return or linefeed characters." msgstr "" -#: ../../library/email.policy.rst:464 +#: ../../library/email.policy.rst:482 msgid "" "The name is returned unchanged. If the input value has a ``name`` attribute " "and it matches *name* ignoring case, the value is returned unchanged. " @@ -540,7 +556,7 @@ msgid "" "``ValueError`` is raised if the input value contains CR or LF characters." msgstr "" -#: ../../library/email.policy.rst:474 +#: ../../library/email.policy.rst:492 msgid "" "If the value has a ``name`` attribute, it is returned to unmodified. " "Otherwise the *name*, and the *value* with any CR or LF characters removed, " @@ -549,7 +565,7 @@ msgid "" "character glyph." msgstr "" -#: ../../library/email.policy.rst:483 +#: ../../library/email.policy.rst:501 msgid "" "Header folding is controlled by the :attr:`refold_source` policy setting. A " "value is considered to be a 'source value' if and only if it does not have a " @@ -561,7 +577,7 @@ msgid "" "current policy." msgstr "" -#: ../../library/email.policy.rst:492 +#: ../../library/email.policy.rst:510 msgid "" "Source values are split into lines using :meth:`~str.splitlines`. If the " "value is not to be refolded, the lines are rejoined using the ``linesep`` " @@ -571,13 +587,13 @@ msgid "" "using the ``unknown-8bit`` charset." msgstr "" -#: ../../library/email.policy.rst:502 +#: ../../library/email.policy.rst:520 msgid "" "The same as :meth:`fold` if :attr:`~Policy.cte_type` is ``7bit``, except " "that the returned value is bytes." msgstr "" -#: ../../library/email.policy.rst:505 +#: ../../library/email.policy.rst:523 msgid "" "If :attr:`~Policy.cte_type` is ``8bit``, non-ASCII binary data is converted " "back into bytes. Headers with binary data are not refolded, regardless of " @@ -585,7 +601,7 @@ msgid "" "binary data consists of single byte characters or multibyte characters." msgstr "" -#: ../../library/email.policy.rst:512 +#: ../../library/email.policy.rst:530 msgid "" "The following instances of :class:`EmailPolicy` provide defaults suitable " "for specific application domains. Note that in the future the behavior of " @@ -593,20 +609,20 @@ msgid "" "conform even more closely to the RFCs relevant to their domains." msgstr "" -#: ../../library/email.policy.rst:520 +#: ../../library/email.policy.rst:538 msgid "" "An instance of ``EmailPolicy`` with all defaults unchanged. This policy " "uses the standard Python ``\\n`` line endings rather than the RFC-correct " "``\\r\\n``." msgstr "" -#: ../../library/email.policy.rst:527 +#: ../../library/email.policy.rst:545 msgid "" "Suitable for serializing messages in conformance with the email RFCs. Like " "``default``, but with ``linesep`` set to ``\\r\\n``, which is RFC compliant." msgstr "" -#: ../../library/email.policy.rst:534 +#: ../../library/email.policy.rst:552 msgid "" "The same as ``SMTP`` except that :attr:`~EmailPolicy.utf8` is ``True``. " "Useful for serializing messages to a message store without using encoded " @@ -615,46 +631,46 @@ msgid "" "SMTP.send_message` method handles this automatically)." msgstr "" -#: ../../library/email.policy.rst:543 +#: ../../library/email.policy.rst:561 msgid "" "Suitable for serializing headers with for use in HTTP traffic. Like " "``SMTP`` except that ``max_line_length`` is set to ``None`` (unlimited)." msgstr "" -#: ../../library/email.policy.rst:549 +#: ../../library/email.policy.rst:567 msgid "" "Convenience instance. The same as ``default`` except that " "``raise_on_defect`` is set to ``True``. This allows any policy to be made " "strict by writing::" msgstr "" -#: ../../library/email.policy.rst:556 +#: ../../library/email.policy.rst:574 msgid "" "With all of these :class:`EmailPolicies <.EmailPolicy>`, the effective API " "of the email package is changed from the Python 3.2 API in the following " "ways:" msgstr "" -#: ../../library/email.policy.rst:559 +#: ../../library/email.policy.rst:577 msgid "" "Setting a header on a :class:`~email.message.Message` results in that header " "being parsed and a header object created." msgstr "" -#: ../../library/email.policy.rst:562 +#: ../../library/email.policy.rst:580 msgid "" "Fetching a header value from a :class:`~email.message.Message` results in " "that header being parsed and a header object created and returned." msgstr "" -#: ../../library/email.policy.rst:566 +#: ../../library/email.policy.rst:584 msgid "" "Any header object, or any header that is refolded due to the policy " "settings, is folded using an algorithm that fully implements the RFC folding " "algorithms, including knowing where encoded words are required and allowed." msgstr "" -#: ../../library/email.policy.rst:571 +#: ../../library/email.policy.rst:589 msgid "" "From the application view, this means that any header obtained through the :" "class:`~email.message.EmailMessage` is a header object with extra " @@ -664,13 +680,13 @@ msgid "" "the unicode string into the correct RFC encoded form." msgstr "" -#: ../../library/email.policy.rst:578 +#: ../../library/email.policy.rst:596 msgid "" "The header objects and their attributes are described in :mod:`~email." "headerregistry`." msgstr "" -#: ../../library/email.policy.rst:585 +#: ../../library/email.policy.rst:603 msgid "" "This concrete :class:`Policy` is the backward compatibility policy. It " "replicates the behavior of the email package in Python 3.2. The :mod:" @@ -679,28 +695,28 @@ msgid "" "of the email package is to maintain compatibility with Python 3.2." msgstr "" -#: ../../library/email.policy.rst:591 +#: ../../library/email.policy.rst:609 msgid "" "The following attributes have values that are different from the :class:" "`Policy` default:" msgstr "" -#: ../../library/email.policy.rst:597 +#: ../../library/email.policy.rst:615 msgid "The default is ``True``." msgstr "" -#: ../../library/email.policy.rst:614 +#: ../../library/email.policy.rst:632 msgid "The name and value are returned unmodified." msgstr "" -#: ../../library/email.policy.rst:619 +#: ../../library/email.policy.rst:637 msgid "" "If the value contains binary data, it is converted into a :class:`~email." "header.Header` object using the ``unknown-8bit`` charset. Otherwise it is " "returned unmodified." msgstr "" -#: ../../library/email.policy.rst:626 +#: ../../library/email.policy.rst:644 msgid "" "Headers are folded using the :class:`~email.header.Header` folding " "algorithm, which preserves existing line breaks in the value, and wraps each " @@ -708,7 +724,7 @@ msgid "" "encoded using the ``unknown-8bit`` charset." msgstr "" -#: ../../library/email.policy.rst:634 +#: ../../library/email.policy.rst:652 msgid "" "Headers are folded using the :class:`~email.header.Header` folding " "algorithm, which preserves existing line breaks in the value, and wraps each " @@ -718,17 +734,17 @@ msgid "" "and any (RFC invalid) binary data it may contain." msgstr "" -#: ../../library/email.policy.rst:644 +#: ../../library/email.policy.rst:662 msgid "" "An instance of :class:`Compat32`, providing backward compatibility with the " "behavior of the email package in Python 3.2." msgstr "" -#: ../../library/email.policy.rst:649 +#: ../../library/email.policy.rst:667 msgid "Footnotes" msgstr "註解" -#: ../../library/email.policy.rst:650 +#: ../../library/email.policy.rst:668 msgid "" "Originally added in 3.3 as a :term:`provisional feature `." diff --git a/library/xml.etree.elementtree.po b/library/xml.etree.elementtree.po index 866ac71811..978699f9fd 100644 --- a/library/xml.etree.elementtree.po +++ b/library/xml.etree.elementtree.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-21 00:04+0000\n" +"POT-Creation-Date: 2024-08-07 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:16+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -677,7 +677,7 @@ msgid "" msgstr "" #: ../../library/xml.etree.elementtree.rst:647 -#: ../../library/xml.etree.elementtree.rst:1516 +#: ../../library/xml.etree.elementtree.rst:1517 msgid "If you need a fully populated element, look for \"end\" events instead." msgstr "" @@ -686,7 +686,7 @@ msgid "The *parser* argument." msgstr "*parser* 引數。" #: ../../library/xml.etree.elementtree.rst:652 -#: ../../library/xml.etree.elementtree.rst:1520 +#: ../../library/xml.etree.elementtree.rst:1521 msgid "The ``comment`` and ``pi`` events were added." msgstr "新增 *context* 與 *check_hostname* 事件。" @@ -752,7 +752,7 @@ msgstr "" #: ../../library/xml.etree.elementtree.rst:713 #: ../../library/xml.etree.elementtree.rst:740 -#: ../../library/xml.etree.elementtree.rst:1193 +#: ../../library/xml.etree.elementtree.rst:1194 msgid "Added the *short_empty_elements* parameter." msgstr "新增 *short_empty_elements* 參數。" @@ -1082,16 +1082,17 @@ msgstr "" #: ../../library/xml.etree.elementtree.rst:1057 msgid "" -"Caution: Elements with no subelements will test as ``False``. Testing the " -"truth value of an Element is deprecated and will raise an exception in " -"Python 3.14. Use specific ``len(elem)`` or ``elem is None`` test instead.::" +"Caution: Elements with no subelements will test as ``False``. In a future " +"release of Python, all elements will test as ``True`` regardless of whether " +"subelements exist. Instead, prefer explicit ``len(elem)`` or ``elem is not " +"None`` tests.::" msgstr "" -#: ../../library/xml.etree.elementtree.rst:1069 +#: ../../library/xml.etree.elementtree.rst:1070 msgid "Testing the truth value of an Element emits :exc:`DeprecationWarning`." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1072 +#: ../../library/xml.etree.elementtree.rst:1073 msgid "" "Prior to Python 3.8, the serialisation order of the XML attributes of " "elements was artificially made predictable by sorting the attributes by " @@ -1100,7 +1101,7 @@ msgid "" "attributes were originally parsed or created by user code." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1078 +#: ../../library/xml.etree.elementtree.rst:1079 msgid "" "In general, user code should try not to depend on a specific ordering of " "attributes, given that the `XML Information Set `_ writer. Arguments are the " "same as for the :func:`canonicalize` function. This class does not build a " @@ -1336,11 +1337,11 @@ msgid "" "using the *write* function." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1357 +#: ../../library/xml.etree.elementtree.rst:1358 msgid "XMLParser Objects" msgstr "XMLParser 物件" -#: ../../library/xml.etree.elementtree.rst:1362 +#: ../../library/xml.etree.elementtree.rst:1363 msgid "" "This class is the low-level building block of the module. It uses :mod:`xml." "parsers.expat` for efficient, event-based parsing of XML. It can be fed XML " @@ -1351,25 +1352,25 @@ msgid "" "XML file." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1370 +#: ../../library/xml.etree.elementtree.rst:1371 msgid "" "Parameters are now :ref:`keyword-only `. The *html* " "argument no longer supported." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1377 +#: ../../library/xml.etree.elementtree.rst:1378 msgid "" "Finishes feeding data to the parser. Returns the result of calling the " "``close()`` method of the *target* passed during construction; by default, " "this is the toplevel document element." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1384 +#: ../../library/xml.etree.elementtree.rst:1385 msgid "Feeds data to the parser. *data* is encoded data." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1389 -#: ../../library/xml.etree.elementtree.rst:1467 +#: ../../library/xml.etree.elementtree.rst:1390 +#: ../../library/xml.etree.elementtree.rst:1468 msgid "" "Triggers parsing of any previously fed unparsed data, which can be used to " "ensure more immediate feedback, in particular with Expat >=2.6.0. The " @@ -1379,15 +1380,15 @@ msgid "" "xmlparser.SetReparseDeferralEnabled` for details." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1396 -#: ../../library/xml.etree.elementtree.rst:1474 +#: ../../library/xml.etree.elementtree.rst:1397 +#: ../../library/xml.etree.elementtree.rst:1475 msgid "" "Note that :meth:`flush` has been backported to some prior releases of " "CPython as a security fix. Check for availability of :meth:`flush` using :" "func:`hasattr` if used in code running across a variety of Python versions." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1404 +#: ../../library/xml.etree.elementtree.rst:1405 msgid "" ":meth:`XMLParser.feed` calls *target*\\'s ``start(tag, attrs_dict)`` method " "for each opening tag, its ``end(tag)`` method for each closing tag, and data " @@ -1398,11 +1399,11 @@ msgid "" "of an XML file::" msgstr "" -#: ../../library/xml.etree.elementtree.rst:1448 +#: ../../library/xml.etree.elementtree.rst:1449 msgid "XMLPullParser Objects" msgstr "XMLPullParser 物件" -#: ../../library/xml.etree.elementtree.rst:1452 +#: ../../library/xml.etree.elementtree.rst:1453 msgid "" "A pull parser suitable for non-blocking applications. Its input-side API is " "similar to that of :class:`XMLParser`, but instead of pushing calls to a " @@ -1414,11 +1415,11 @@ msgid "" "If *events* is omitted, only ``\"end\"`` events are reported." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1463 +#: ../../library/xml.etree.elementtree.rst:1464 msgid "Feed the given bytes data to the parser." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1483 +#: ../../library/xml.etree.elementtree.rst:1484 msgid "" "Signal the parser that the data stream is terminated. Unlike :meth:" "`XMLParser.close`, this method always returns :const:`None`. Any events not " @@ -1426,7 +1427,7 @@ msgid "" "`read_events`." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1490 +#: ../../library/xml.etree.elementtree.rst:1491 msgid "" "Return an iterator over the events which have been encountered in the data " "fed to the parser. The iterator yields ``(event, elem)`` pairs, where " @@ -1435,25 +1436,25 @@ msgid "" "follows." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1496 +#: ../../library/xml.etree.elementtree.rst:1497 msgid "``start``, ``end``: the current Element." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1497 +#: ../../library/xml.etree.elementtree.rst:1498 msgid "``comment``, ``pi``: the current comment / processing instruction" msgstr "" -#: ../../library/xml.etree.elementtree.rst:1498 +#: ../../library/xml.etree.elementtree.rst:1499 msgid "" "``start-ns``: a tuple ``(prefix, uri)`` naming the declared namespace " "mapping." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1500 +#: ../../library/xml.etree.elementtree.rst:1501 msgid "``end-ns``: :const:`None` (this may change in a future version)" msgstr "" -#: ../../library/xml.etree.elementtree.rst:1502 +#: ../../library/xml.etree.elementtree.rst:1503 msgid "" "Events provided in a previous call to :meth:`read_events` will not be " "yielded again. Events are consumed from the internal queue only when they " @@ -1462,7 +1463,7 @@ msgid "" "results." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1510 +#: ../../library/xml.etree.elementtree.rst:1511 msgid "" ":class:`XMLPullParser` only guarantees that it has seen the \">\" character " "of a starting tag when it emits a \"start\" event, so the attributes are " @@ -1471,11 +1472,11 @@ msgid "" "be present." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1525 +#: ../../library/xml.etree.elementtree.rst:1526 msgid "Exceptions" msgstr "例外" -#: ../../library/xml.etree.elementtree.rst:1529 +#: ../../library/xml.etree.elementtree.rst:1530 msgid "" "XML parse error, raised by the various parsing methods in this module when " "parsing fails. The string representation of an instance of this exception " @@ -1483,22 +1484,22 @@ msgid "" "following attributes available:" msgstr "" -#: ../../library/xml.etree.elementtree.rst:1536 +#: ../../library/xml.etree.elementtree.rst:1537 msgid "" "A numeric error code from the expat parser. See the documentation of :mod:" "`xml.parsers.expat` for the list of error codes and their meanings." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1541 +#: ../../library/xml.etree.elementtree.rst:1542 msgid "" "A tuple of *line*, *column* numbers, specifying where the error occurred." msgstr "" -#: ../../library/xml.etree.elementtree.rst:1544 +#: ../../library/xml.etree.elementtree.rst:1545 msgid "Footnotes" msgstr "註解" -#: ../../library/xml.etree.elementtree.rst:1545 +#: ../../library/xml.etree.elementtree.rst:1546 msgid "" "The encoding string included in XML output should conform to the appropriate " "standards. For example, \"UTF-8\" is valid, but \"UTF8\" is not. See " diff --git a/whatsnew/3.12.po b/whatsnew/3.12.po index c9ddd830d7..d14e974cdc 100644 --- a/whatsnew/3.12.po +++ b/whatsnew/3.12.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-07 00:03+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -4858,6 +4858,29 @@ msgstr "" "修正 ``IPv4Address``、``IPv6Address``、``IPv4Network`` 和 ``IPv6Network`` 中" "的 ``is_global`` 和 ``is_private`` 行為。" +#: ../../whatsnew/3.12.rst:2266 +#, fuzzy +msgid "Notable changes in 3.12.5" +msgstr "3.12.4 中的明顯變更" + +#: ../../whatsnew/3.12.rst:2269 +msgid "email" +msgstr "" + +#: ../../whatsnew/3.12.rst:2272 +msgid "Headers with embedded newlines are now quoted on output." +msgstr "" + +#: ../../whatsnew/3.12.rst:2274 +msgid "" +"The :mod:`~email.generator` will now refuse to serialize (write) headers " +"that are improperly folded or delimited, such that they would be parsed as " +"multiple headers or joined with adjacent data. If you need to turn this " +"safety feature off, set :attr:`~email.policy.Policy." +"verify_generated_headers`. (Contributed by Bas Bloemsaat and Petr Viktorin " +"in :gh:`121650`.)" +msgstr "" + #~ msgid "" #~ "The following modules and APIs have been deprecated in earlier Python " #~ "releases, and will be removed in Python 3.13." From 75c5e172e0f7fa30eebde72224391187d8223aa9 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Thu, 8 Aug 2024 00:05:14 +0000 Subject: [PATCH 19/28] sync with cpython 8f4892ac --- library/stdtypes.po | 1806 ++++++++++++++++++++-------------------- reference/datamodel.po | 1678 ++++++++++++++++++------------------- 2 files changed, 1744 insertions(+), 1740 deletions(-) diff --git a/library/stdtypes.po b/library/stdtypes.po index 1b7862c393..1587de4cd8 100644 --- a/library/stdtypes.po +++ b/library/stdtypes.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-08-08 00:03+0000\n" "PO-Revision-Date: 2022-06-12 15:22+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -136,8 +136,8 @@ msgstr "結果" #: ../../library/stdtypes.rst:86 ../../library/stdtypes.rst:276 #: ../../library/stdtypes.rst:416 ../../library/stdtypes.rst:965 -#: ../../library/stdtypes.rst:1170 ../../library/stdtypes.rst:2422 -#: ../../library/stdtypes.rst:3641 +#: ../../library/stdtypes.rst:1170 ../../library/stdtypes.rst:2423 +#: ../../library/stdtypes.rst:3642 msgid "Notes" msgstr "註解" @@ -151,7 +151,7 @@ msgstr "假如 *x* 為真，則 *x*，否則 *y*" #: ../../library/stdtypes.rst:88 ../../library/stdtypes.rst:967 #: ../../library/stdtypes.rst:970 ../../library/stdtypes.rst:1181 -#: ../../library/stdtypes.rst:2428 ../../library/stdtypes.rst:3647 +#: ../../library/stdtypes.rst:2429 ../../library/stdtypes.rst:3648 msgid "\\(1)" msgstr "\\(1)" @@ -165,8 +165,8 @@ msgstr "假如 *x* 為假，則 *x*，否則 *y*" #: ../../library/stdtypes.rst:91 ../../library/stdtypes.rst:289 #: ../../library/stdtypes.rst:309 ../../library/stdtypes.rst:1209 -#: ../../library/stdtypes.rst:2432 ../../library/stdtypes.rst:2434 -#: ../../library/stdtypes.rst:3651 ../../library/stdtypes.rst:3653 +#: ../../library/stdtypes.rst:2433 ../../library/stdtypes.rst:2435 +#: ../../library/stdtypes.rst:3652 ../../library/stdtypes.rst:3654 msgid "\\(2)" msgstr "\\(2)" @@ -179,18 +179,18 @@ msgid "if *x* is false, then ``True``, else ``False``" msgstr "假如 *x* 為假，則 ``True``，否則 ``False``" #: ../../library/stdtypes.rst:94 ../../library/stdtypes.rst:979 -#: ../../library/stdtypes.rst:1212 ../../library/stdtypes.rst:2436 -#: ../../library/stdtypes.rst:2438 ../../library/stdtypes.rst:2440 -#: ../../library/stdtypes.rst:2442 ../../library/stdtypes.rst:3655 -#: ../../library/stdtypes.rst:3657 ../../library/stdtypes.rst:3659 -#: ../../library/stdtypes.rst:3661 +#: ../../library/stdtypes.rst:1212 ../../library/stdtypes.rst:2437 +#: ../../library/stdtypes.rst:2439 ../../library/stdtypes.rst:2441 +#: ../../library/stdtypes.rst:2443 ../../library/stdtypes.rst:3656 +#: ../../library/stdtypes.rst:3658 ../../library/stdtypes.rst:3660 +#: ../../library/stdtypes.rst:3662 msgid "\\(3)" msgstr "\\(3)" #: ../../library/stdtypes.rst:103 ../../library/stdtypes.rst:320 #: ../../library/stdtypes.rst:434 ../../library/stdtypes.rst:1016 -#: ../../library/stdtypes.rst:1220 ../../library/stdtypes.rst:2468 -#: ../../library/stdtypes.rst:3691 +#: ../../library/stdtypes.rst:1221 ../../library/stdtypes.rst:2469 +#: ../../library/stdtypes.rst:3692 msgid "Notes:" msgstr "註解：" @@ -237,9 +237,9 @@ msgstr "" msgid "This table summarizes the comparison operations:" msgstr "這個表格統整所有比較運算：" -#: ../../library/stdtypes.rst:144 ../../library/stdtypes.rst:2399 -#: ../../library/stdtypes.rst:2422 ../../library/stdtypes.rst:3618 -#: ../../library/stdtypes.rst:3641 +#: ../../library/stdtypes.rst:144 ../../library/stdtypes.rst:2400 +#: ../../library/stdtypes.rst:2423 ../../library/stdtypes.rst:3619 +#: ../../library/stdtypes.rst:3642 msgid "Meaning" msgstr "含義" @@ -560,7 +560,7 @@ msgid "" msgstr "一個複數，其實部為 *re*，虛部為 *im*。*im* 預設為零。" #: ../../library/stdtypes.rst:302 ../../library/stdtypes.rst:1202 -#: ../../library/stdtypes.rst:2430 ../../library/stdtypes.rst:3678 +#: ../../library/stdtypes.rst:2431 ../../library/stdtypes.rst:3679 msgid "\\(6)" msgstr "\\(6)" @@ -598,9 +598,9 @@ msgstr "*x* 的 *y* 次方" #: ../../library/stdtypes.rst:311 ../../library/stdtypes.rst:313 #: ../../library/stdtypes.rst:1191 ../../library/stdtypes.rst:1194 -#: ../../library/stdtypes.rst:2455 ../../library/stdtypes.rst:2458 -#: ../../library/stdtypes.rst:2461 ../../library/stdtypes.rst:3674 -#: ../../library/stdtypes.rst:3681 +#: ../../library/stdtypes.rst:2456 ../../library/stdtypes.rst:2459 +#: ../../library/stdtypes.rst:2462 ../../library/stdtypes.rst:3675 +#: ../../library/stdtypes.rst:3682 msgid "\\(5)" msgstr "\\(5)" @@ -758,9 +758,9 @@ msgid "bitwise :dfn:`or` of *x* and *y*" msgstr "*x* 及 *y* 的位元 :dfn:`或`" #: ../../library/stdtypes.rst:418 ../../library/stdtypes.rst:421 -#: ../../library/stdtypes.rst:424 ../../library/stdtypes.rst:1215 -#: ../../library/stdtypes.rst:2444 ../../library/stdtypes.rst:2448 -#: ../../library/stdtypes.rst:3663 ../../library/stdtypes.rst:3667 +#: ../../library/stdtypes.rst:424 ../../library/stdtypes.rst:1216 +#: ../../library/stdtypes.rst:2445 ../../library/stdtypes.rst:2449 +#: ../../library/stdtypes.rst:3664 ../../library/stdtypes.rst:3668 msgid "\\(4)" msgstr "\\(4)" @@ -1493,7 +1493,7 @@ msgid "" "before index *j*)" msgstr "" -#: ../../library/stdtypes.rst:992 ../../library/stdtypes.rst:3649 +#: ../../library/stdtypes.rst:992 ../../library/stdtypes.rst:3650 msgid "\\(8)" msgstr "\\(8)" @@ -1779,41 +1779,41 @@ msgid "``s.remove(x)``" msgstr "``s.remove(x)``" #: ../../library/stdtypes.rst:1212 -msgid "remove the first item from *s* where ``s[i]`` is equal to *x*" +msgid "removes the first item from *s* where ``s[i]`` is equal to *x*" msgstr "" -#: ../../library/stdtypes.rst:1215 +#: ../../library/stdtypes.rst:1216 msgid "``s.reverse()``" msgstr "``s.reverse()``" -#: ../../library/stdtypes.rst:1215 +#: ../../library/stdtypes.rst:1216 msgid "reverses the items of *s* in place" msgstr "" -#: ../../library/stdtypes.rst:1223 +#: ../../library/stdtypes.rst:1224 msgid "" "If *k* is not equal to ``1``, *t* must have the same length as the slice it " "is replacing." msgstr "" -#: ../../library/stdtypes.rst:1226 +#: ../../library/stdtypes.rst:1227 msgid "" "The optional argument *i* defaults to ``-1``, so that by default the last " "item is removed and returned." msgstr "" -#: ../../library/stdtypes.rst:1230 +#: ../../library/stdtypes.rst:1231 msgid ":meth:`remove` raises :exc:`ValueError` when *x* is not found in *s*." msgstr "" -#: ../../library/stdtypes.rst:1233 +#: ../../library/stdtypes.rst:1234 msgid "" "The :meth:`reverse` method modifies the sequence in place for economy of " "space when reversing a large sequence. To remind users that it operates by " "side effect, it does not return the reversed sequence." msgstr "" -#: ../../library/stdtypes.rst:1238 +#: ../../library/stdtypes.rst:1239 msgid "" ":meth:`clear` and :meth:`!copy` are included for consistency with the " "interfaces of mutable containers that don't support slicing operations (such " @@ -1822,11 +1822,11 @@ msgid "" "classes provide it." msgstr "" -#: ../../library/stdtypes.rst:1244 +#: ../../library/stdtypes.rst:1245 msgid ":meth:`clear` and :meth:`!copy` methods." msgstr "" -#: ../../library/stdtypes.rst:1248 +#: ../../library/stdtypes.rst:1249 msgid "" "The value *n* is an integer, or an object implementing :meth:`~object." "__index__`. Zero and negative values of *n* clear the sequence. Items in " @@ -1834,39 +1834,39 @@ msgid "" "explained for ``s * n`` under :ref:`typesseq-common`." msgstr "" -#: ../../library/stdtypes.rst:1257 +#: ../../library/stdtypes.rst:1258 msgid "Lists" msgstr "List（串列）" -#: ../../library/stdtypes.rst:1261 +#: ../../library/stdtypes.rst:1262 msgid "" "Lists are mutable sequences, typically used to store collections of " "homogeneous items (where the precise degree of similarity will vary by " "application)." msgstr "" -#: ../../library/stdtypes.rst:1267 +#: ../../library/stdtypes.rst:1268 msgid "Lists may be constructed in several ways:" msgstr "" -#: ../../library/stdtypes.rst:1269 +#: ../../library/stdtypes.rst:1270 msgid "Using a pair of square brackets to denote the empty list: ``[]``" msgstr "" -#: ../../library/stdtypes.rst:1270 +#: ../../library/stdtypes.rst:1271 msgid "" "Using square brackets, separating items with commas: ``[a]``, ``[a, b, c]``" msgstr "" -#: ../../library/stdtypes.rst:1271 +#: ../../library/stdtypes.rst:1272 msgid "Using a list comprehension: ``[x for x in iterable]``" msgstr "" -#: ../../library/stdtypes.rst:1272 +#: ../../library/stdtypes.rst:1273 msgid "Using the type constructor: ``list()`` or ``list(iterable)``" msgstr "" -#: ../../library/stdtypes.rst:1274 +#: ../../library/stdtypes.rst:1275 msgid "" "The constructor builds a list whose items are the same and in the same order " "as *iterable*'s items. *iterable* may be either a sequence, a container " @@ -1877,20 +1877,20 @@ msgid "" "new empty list, ``[]``." msgstr "" -#: ../../library/stdtypes.rst:1283 +#: ../../library/stdtypes.rst:1284 msgid "" "Many other operations also produce lists, including the :func:`sorted` built-" "in." msgstr "" -#: ../../library/stdtypes.rst:1286 +#: ../../library/stdtypes.rst:1287 msgid "" "Lists implement all of the :ref:`common ` and :ref:`mutable " "` sequence operations. Lists also provide the following " "additional method:" msgstr "" -#: ../../library/stdtypes.rst:1292 +#: ../../library/stdtypes.rst:1293 msgid "" "This method sorts the list in place, using only ``<`` comparisons between " "items. Exceptions are not suppressed - if any comparison operations fail, " @@ -1898,13 +1898,13 @@ msgid "" "partially modified state)." msgstr "" -#: ../../library/stdtypes.rst:1297 +#: ../../library/stdtypes.rst:1298 msgid "" ":meth:`sort` accepts two arguments that can only be passed by keyword (:ref:" "`keyword-only arguments `):" msgstr "" -#: ../../library/stdtypes.rst:1300 +#: ../../library/stdtypes.rst:1301 msgid "" "*key* specifies a function of one argument that is used to extract a " "comparison key from each list element (for example, ``key=str.lower``). The " @@ -1913,19 +1913,19 @@ msgid "" "list items are sorted directly without calculating a separate key value." msgstr "" -#: ../../library/stdtypes.rst:1307 +#: ../../library/stdtypes.rst:1308 msgid "" "The :func:`functools.cmp_to_key` utility is available to convert a 2.x style " "*cmp* function to a *key* function." msgstr "" -#: ../../library/stdtypes.rst:1310 +#: ../../library/stdtypes.rst:1311 msgid "" "*reverse* is a boolean value. If set to ``True``, then the list elements " "are sorted as if each comparison were reversed." msgstr "" -#: ../../library/stdtypes.rst:1313 +#: ../../library/stdtypes.rst:1314 msgid "" "This method modifies the sequence in place for economy of space when sorting " "a large sequence. To remind users that it operates by side effect, it does " @@ -1933,7 +1933,7 @@ msgid "" "new sorted list instance)." msgstr "" -#: ../../library/stdtypes.rst:1318 +#: ../../library/stdtypes.rst:1319 msgid "" "The :meth:`sort` method is guaranteed to be stable. A sort is stable if it " "guarantees not to change the relative order of elements that compare equal " @@ -1941,12 +1941,12 @@ msgid "" "department, then by salary grade)." msgstr "" -#: ../../library/stdtypes.rst:1323 +#: ../../library/stdtypes.rst:1324 msgid "" "For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`." msgstr "" -#: ../../library/stdtypes.rst:1327 +#: ../../library/stdtypes.rst:1328 msgid "" "While a list is being sorted, the effect of attempting to mutate, or even " "inspect, the list is undefined. The C implementation of Python makes the " @@ -1954,11 +1954,11 @@ msgid "" "detect that the list has been mutated during a sort." msgstr "" -#: ../../library/stdtypes.rst:1336 +#: ../../library/stdtypes.rst:1337 msgid "Tuples" msgstr "" -#: ../../library/stdtypes.rst:1340 +#: ../../library/stdtypes.rst:1341 msgid "" "Tuples are immutable sequences, typically used to store collections of " "heterogeneous data (such as the 2-tuples produced by the :func:`enumerate` " @@ -1967,27 +1967,27 @@ msgid "" "class:`dict` instance)." msgstr "" -#: ../../library/stdtypes.rst:1348 +#: ../../library/stdtypes.rst:1349 msgid "Tuples may be constructed in a number of ways:" msgstr "" -#: ../../library/stdtypes.rst:1350 +#: ../../library/stdtypes.rst:1351 msgid "Using a pair of parentheses to denote the empty tuple: ``()``" msgstr "" -#: ../../library/stdtypes.rst:1351 +#: ../../library/stdtypes.rst:1352 msgid "Using a trailing comma for a singleton tuple: ``a,`` or ``(a,)``" msgstr "" -#: ../../library/stdtypes.rst:1352 +#: ../../library/stdtypes.rst:1353 msgid "Separating items with commas: ``a, b, c`` or ``(a, b, c)``" msgstr "" -#: ../../library/stdtypes.rst:1353 +#: ../../library/stdtypes.rst:1354 msgid "Using the :func:`tuple` built-in: ``tuple()`` or ``tuple(iterable)``" msgstr "" -#: ../../library/stdtypes.rst:1355 +#: ../../library/stdtypes.rst:1356 msgid "" "The constructor builds a tuple whose items are the same and in the same " "order as *iterable*'s items. *iterable* may be either a sequence, a " @@ -1998,7 +1998,7 @@ msgid "" "``()``." msgstr "" -#: ../../library/stdtypes.rst:1363 +#: ../../library/stdtypes.rst:1364 msgid "" "Note that it is actually the comma which makes a tuple, not the parentheses. " "The parentheses are optional, except in the empty tuple case, or when they " @@ -2007,30 +2007,30 @@ msgid "" "call with a 3-tuple as the sole argument." msgstr "" -#: ../../library/stdtypes.rst:1369 +#: ../../library/stdtypes.rst:1370 msgid "" "Tuples implement all of the :ref:`common ` sequence " "operations." msgstr "" -#: ../../library/stdtypes.rst:1372 +#: ../../library/stdtypes.rst:1373 msgid "" "For heterogeneous collections of data where access by name is clearer than " "access by index, :func:`collections.namedtuple` may be a more appropriate " "choice than a simple tuple object." msgstr "" -#: ../../library/stdtypes.rst:1380 +#: ../../library/stdtypes.rst:1381 msgid "Ranges" msgstr "" -#: ../../library/stdtypes.rst:1384 +#: ../../library/stdtypes.rst:1385 msgid "" "The :class:`range` type represents an immutable sequence of numbers and is " "commonly used for looping a specific number of times in :keyword:`for` loops." msgstr "" -#: ../../library/stdtypes.rst:1391 +#: ../../library/stdtypes.rst:1392 msgid "" "The arguments to the range constructor must be integers (either built-in :" "class:`int` or any object that implements the :meth:`~object.__index__` " @@ -2039,38 +2039,38 @@ msgid "" "zero, :exc:`ValueError` is raised." msgstr "" -#: ../../library/stdtypes.rst:1397 +#: ../../library/stdtypes.rst:1398 msgid "" "For a positive *step*, the contents of a range ``r`` are determined by the " "formula ``r[i] = start + step*i`` where ``i >= 0`` and ``r[i] < stop``." msgstr "" -#: ../../library/stdtypes.rst:1401 +#: ../../library/stdtypes.rst:1402 msgid "" "For a negative *step*, the contents of the range are still determined by the " "formula ``r[i] = start + step*i``, but the constraints are ``i >= 0`` and " "``r[i] > stop``." msgstr "" -#: ../../library/stdtypes.rst:1405 +#: ../../library/stdtypes.rst:1406 msgid "" "A range object will be empty if ``r[0]`` does not meet the value constraint. " "Ranges do support negative indices, but these are interpreted as indexing " "from the end of the sequence determined by the positive indices." msgstr "" -#: ../../library/stdtypes.rst:1410 +#: ../../library/stdtypes.rst:1411 msgid "" "Ranges containing absolute values larger than :data:`sys.maxsize` are " "permitted but some features (such as :func:`len`) may raise :exc:" "`OverflowError`." msgstr "" -#: ../../library/stdtypes.rst:1414 +#: ../../library/stdtypes.rst:1415 msgid "Range examples::" msgstr "" -#: ../../library/stdtypes.rst:1431 +#: ../../library/stdtypes.rst:1432 msgid "" "Ranges implement all of the :ref:`common ` sequence " "operations except concatenation and repetition (due to the fact that range " @@ -2078,23 +2078,23 @@ msgid "" "repetition and concatenation will usually violate that pattern)." msgstr "" -#: ../../library/stdtypes.rst:1438 +#: ../../library/stdtypes.rst:1439 msgid "" "The value of the *start* parameter (or ``0`` if the parameter was not " "supplied)" msgstr "" -#: ../../library/stdtypes.rst:1443 +#: ../../library/stdtypes.rst:1444 msgid "The value of the *stop* parameter" msgstr "" -#: ../../library/stdtypes.rst:1447 +#: ../../library/stdtypes.rst:1448 msgid "" "The value of the *step* parameter (or ``1`` if the parameter was not " "supplied)" msgstr "" -#: ../../library/stdtypes.rst:1450 +#: ../../library/stdtypes.rst:1451 msgid "" "The advantage of the :class:`range` type over a regular :class:`list` or :" "class:`tuple` is that a :class:`range` object will always take the same " @@ -2103,14 +2103,14 @@ msgid "" "individual items and subranges as needed)." msgstr "" -#: ../../library/stdtypes.rst:1456 +#: ../../library/stdtypes.rst:1457 msgid "" "Range objects implement the :class:`collections.abc.Sequence` ABC, and " "provide features such as containment tests, element index lookup, slicing " "and support for negative indices (see :ref:`typesseq`):" msgstr "" -#: ../../library/stdtypes.rst:1476 +#: ../../library/stdtypes.rst:1477 msgid "" "Testing range objects for equality with ``==`` and ``!=`` compares them as " "sequences. That is, two range objects are considered equal if they " @@ -2120,111 +2120,111 @@ msgid "" "3)`` or ``range(0, 3, 2) == range(0, 4, 2)``.)" msgstr "" -#: ../../library/stdtypes.rst:1483 +#: ../../library/stdtypes.rst:1484 msgid "" "Implement the Sequence ABC. Support slicing and negative indices. Test :" "class:`int` objects for membership in constant time instead of iterating " "through all items." msgstr "" -#: ../../library/stdtypes.rst:1489 +#: ../../library/stdtypes.rst:1490 msgid "" "Define '==' and '!=' to compare range objects based on the sequence of " "values they define (instead of comparing based on object identity)." msgstr "" -#: ../../library/stdtypes.rst:1494 +#: ../../library/stdtypes.rst:1495 msgid "" "Added the :attr:`~range.start`, :attr:`~range.stop` and :attr:`~range.step` " "attributes." msgstr "" -#: ../../library/stdtypes.rst:1499 +#: ../../library/stdtypes.rst:1500 msgid "" "The `linspace recipe `_ shows how to implement a lazy version of range " "suitable for floating-point applications." msgstr "" -#: ../../library/stdtypes.rst:1511 +#: ../../library/stdtypes.rst:1512 msgid "Text Sequence Type --- :class:`str`" msgstr "" -#: ../../library/stdtypes.rst:1513 +#: ../../library/stdtypes.rst:1514 msgid "" "Textual data in Python is handled with :class:`str` objects, or :dfn:" "`strings`. Strings are immutable :ref:`sequences ` of Unicode code " "points. String literals are written in a variety of ways:" msgstr "" -#: ../../library/stdtypes.rst:1518 +#: ../../library/stdtypes.rst:1519 msgid "Single quotes: ``'allows embedded \"double\" quotes'``" msgstr "" -#: ../../library/stdtypes.rst:1519 +#: ../../library/stdtypes.rst:1520 msgid "Double quotes: ``\"allows embedded 'single' quotes\"``" msgstr "" -#: ../../library/stdtypes.rst:1520 +#: ../../library/stdtypes.rst:1521 msgid "" "Triple quoted: ``'''Three single quotes'''``, ``\"\"\"Three double " "quotes\"\"\"``" msgstr "" -#: ../../library/stdtypes.rst:1522 +#: ../../library/stdtypes.rst:1523 msgid "" "Triple quoted strings may span multiple lines - all associated whitespace " "will be included in the string literal." msgstr "" -#: ../../library/stdtypes.rst:1525 +#: ../../library/stdtypes.rst:1526 msgid "" "String literals that are part of a single expression and have only " "whitespace between them will be implicitly converted to a single string " "literal. That is, ``(\"spam \" \"eggs\") == \"spam eggs\"``." msgstr "" -#: ../../library/stdtypes.rst:1529 +#: ../../library/stdtypes.rst:1530 msgid "" "See :ref:`strings` for more about the various forms of string literal, " "including supported :ref:`escape sequences `, and the " "``r`` (\"raw\") prefix that disables most escape sequence processing." msgstr "" -#: ../../library/stdtypes.rst:1533 +#: ../../library/stdtypes.rst:1534 msgid "" "Strings may also be created from other objects using the :class:`str` " "constructor." msgstr "" -#: ../../library/stdtypes.rst:1536 +#: ../../library/stdtypes.rst:1537 msgid "" "Since there is no separate \"character\" type, indexing a string produces " "strings of length 1. That is, for a non-empty string *s*, ``s[0] == s[0:1]``." msgstr "" -#: ../../library/stdtypes.rst:1542 +#: ../../library/stdtypes.rst:1543 msgid "" "There is also no mutable string type, but :meth:`str.join` or :class:`io." "StringIO` can be used to efficiently construct strings from multiple " "fragments." msgstr "" -#: ../../library/stdtypes.rst:1546 +#: ../../library/stdtypes.rst:1547 msgid "" "For backwards compatibility with the Python 2 series, the ``u`` prefix is " "once again permitted on string literals. It has no effect on the meaning of " "string literals and cannot be combined with the ``r`` prefix." msgstr "" -#: ../../library/stdtypes.rst:1558 +#: ../../library/stdtypes.rst:1559 msgid "" "Return a :ref:`string ` version of *object*. If *object* is not " "provided, returns the empty string. Otherwise, the behavior of ``str()`` " "depends on whether *encoding* or *errors* is given, as follows." msgstr "" -#: ../../library/stdtypes.rst:1562 +#: ../../library/stdtypes.rst:1563 msgid "" "If neither *encoding* nor *errors* is given, ``str(object)`` returns :meth:" "`type(object).__str__(object) `, which is the \"informal\" " @@ -2234,7 +2234,7 @@ msgid "" "`repr(object) `." msgstr "" -#: ../../library/stdtypes.rst:1574 +#: ../../library/stdtypes.rst:1575 msgid "" "If at least one of *encoding* or *errors* is given, *object* should be a :" "term:`bytes-like object` (e.g. :class:`bytes` or :class:`bytearray`). In " @@ -2246,7 +2246,7 @@ msgid "" "buffer objects." msgstr "" -#: ../../library/stdtypes.rst:1583 +#: ../../library/stdtypes.rst:1584 msgid "" "Passing a :class:`bytes` object to :func:`str` without the *encoding* or " "*errors* arguments falls under the first case of returning the informal " @@ -2254,7 +2254,7 @@ msgid "" "Python). For example::" msgstr "" -#: ../../library/stdtypes.rst:1591 +#: ../../library/stdtypes.rst:1592 msgid "" "For more information on the ``str`` class and its methods, see :ref:" "`textseq` and the :ref:`string-methods` section below. To output formatted " @@ -2262,17 +2262,17 @@ msgid "" "addition, see the :ref:`stringservices` section." msgstr "" -#: ../../library/stdtypes.rst:1603 +#: ../../library/stdtypes.rst:1604 msgid "String Methods" msgstr "" -#: ../../library/stdtypes.rst:1608 +#: ../../library/stdtypes.rst:1609 msgid "" "Strings implement all of the :ref:`common ` sequence " "operations, along with the additional methods described below." msgstr "" -#: ../../library/stdtypes.rst:1611 +#: ../../library/stdtypes.rst:1612 msgid "" "Strings also support two styles of string formatting, one providing a large " "degree of flexibility and customization (see :meth:`str.format`, :ref:" @@ -2282,33 +2282,33 @@ msgid "" "handle (:ref:`old-string-formatting`)." msgstr "" -#: ../../library/stdtypes.rst:1618 +#: ../../library/stdtypes.rst:1619 msgid "" "The :ref:`textservices` section of the standard library covers a number of " "other modules that provide various text related utilities (including regular " "expression support in the :mod:`re` module)." msgstr "" -#: ../../library/stdtypes.rst:1624 +#: ../../library/stdtypes.rst:1625 msgid "" "Return a copy of the string with its first character capitalized and the " "rest lowercased." msgstr "" -#: ../../library/stdtypes.rst:1627 +#: ../../library/stdtypes.rst:1628 msgid "" "The first character is now put into titlecase rather than uppercase. This " "means that characters like digraphs will only have their first letter " "capitalized, instead of the full character." msgstr "" -#: ../../library/stdtypes.rst:1634 +#: ../../library/stdtypes.rst:1635 msgid "" "Return a casefolded copy of the string. Casefolded strings may be used for " "caseless matching." msgstr "" -#: ../../library/stdtypes.rst:1637 +#: ../../library/stdtypes.rst:1638 msgid "" "Casefolding is similar to lowercasing but more aggressive because it is " "intended to remove all case distinctions in a string. For example, the " @@ -2317,44 +2317,44 @@ msgid "" "`casefold` converts it to ``\"ss\"``." msgstr "" -#: ../../library/stdtypes.rst:1643 +#: ../../library/stdtypes.rst:1644 msgid "" "The casefolding algorithm is `described in section 3.13 'Default Case " "Folding' of the Unicode Standard `__." msgstr "" -#: ../../library/stdtypes.rst:1652 +#: ../../library/stdtypes.rst:1653 msgid "" "Return centered in a string of length *width*. Padding is done using the " "specified *fillchar* (default is an ASCII space). The original string is " "returned if *width* is less than or equal to ``len(s)``." msgstr "" -#: ../../library/stdtypes.rst:1660 +#: ../../library/stdtypes.rst:1661 msgid "" "Return the number of non-overlapping occurrences of substring *sub* in the " "range [*start*, *end*]. Optional arguments *start* and *end* are " "interpreted as in slice notation." msgstr "" -#: ../../library/stdtypes.rst:1664 +#: ../../library/stdtypes.rst:1665 msgid "" "If *sub* is empty, returns the number of empty strings between characters " "which is the length of the string plus one." msgstr "" -#: ../../library/stdtypes.rst:1670 +#: ../../library/stdtypes.rst:1671 msgid "Return the string encoded to :class:`bytes`." msgstr "" -#: ../../library/stdtypes.rst:1672 ../../library/stdtypes.rst:2814 +#: ../../library/stdtypes.rst:1673 ../../library/stdtypes.rst:2815 msgid "" "*encoding* defaults to ``'utf-8'``; see :ref:`standard-encodings` for " "possible values." msgstr "" -#: ../../library/stdtypes.rst:1675 +#: ../../library/stdtypes.rst:1676 msgid "" "*errors* controls how encoding errors are handled. If ``'strict'`` (the " "default), a :exc:`UnicodeError` exception is raised. Other possible values " @@ -2363,24 +2363,24 @@ msgid "" "register_error`. See :ref:`error-handlers` for details." msgstr "" -#: ../../library/stdtypes.rst:1682 +#: ../../library/stdtypes.rst:1683 msgid "" "For performance reasons, the value of *errors* is not checked for validity " "unless an encoding error actually occurs, :ref:`devmode` is enabled or a :" "ref:`debug build ` is used." msgstr "" -#: ../../library/stdtypes.rst:1687 ../../library/stdtypes.rst:2833 +#: ../../library/stdtypes.rst:1688 ../../library/stdtypes.rst:2834 msgid "Added support for keyword arguments." msgstr "新增關鍵字引數的支援。" -#: ../../library/stdtypes.rst:1690 ../../library/stdtypes.rst:2836 +#: ../../library/stdtypes.rst:1691 ../../library/stdtypes.rst:2837 msgid "" "The value of the *errors* argument is now checked in :ref:`devmode` and in :" "ref:`debug mode `." msgstr "" -#: ../../library/stdtypes.rst:1697 +#: ../../library/stdtypes.rst:1698 msgid "" "Return ``True`` if the string ends with the specified *suffix*, otherwise " "return ``False``. *suffix* can also be a tuple of suffixes to look for. " @@ -2388,7 +2388,7 @@ msgid "" "*end*, stop comparing at that position." msgstr "" -#: ../../library/stdtypes.rst:1705 +#: ../../library/stdtypes.rst:1706 msgid "" "Return a copy of the string where all tab characters are replaced by one or " "more spaces, depending on the current column and the given tab size. Tab " @@ -2404,21 +2404,21 @@ msgid "" "printed." msgstr "" -#: ../../library/stdtypes.rst:1726 +#: ../../library/stdtypes.rst:1727 msgid "" "Return the lowest index in the string where substring *sub* is found within " "the slice ``s[start:end]``. Optional arguments *start* and *end* are " "interpreted as in slice notation. Return ``-1`` if *sub* is not found." msgstr "" -#: ../../library/stdtypes.rst:1732 +#: ../../library/stdtypes.rst:1733 msgid "" "The :meth:`~str.find` method should be used only if you need to know the " "position of *sub*. To check if *sub* is a substring or not, use the :" "keyword:`in` operator::" msgstr "" -#: ../../library/stdtypes.rst:1742 +#: ../../library/stdtypes.rst:1743 msgid "" "Perform a string formatting operation. The string on which this method is " "called can contain literal text or replacement fields delimited by braces " @@ -2428,13 +2428,13 @@ msgid "" "the corresponding argument." msgstr "" -#: ../../library/stdtypes.rst:1752 +#: ../../library/stdtypes.rst:1753 msgid "" "See :ref:`formatstrings` for a description of the various formatting options " "that can be specified in format strings." msgstr "" -#: ../../library/stdtypes.rst:1756 +#: ../../library/stdtypes.rst:1757 msgid "" "When formatting a number (:class:`int`, :class:`float`, :class:`complex`, :" "class:`decimal.Decimal` and subclasses) with the ``n`` type (ex: ``'{:n}'." @@ -2445,26 +2445,26 @@ msgid "" "This temporary change affects other threads." msgstr "" -#: ../../library/stdtypes.rst:1765 +#: ../../library/stdtypes.rst:1766 msgid "" "When formatting a number with the ``n`` type, the function sets temporarily " "the ``LC_CTYPE`` locale to the ``LC_NUMERIC`` locale in some cases." msgstr "" -#: ../../library/stdtypes.rst:1773 +#: ../../library/stdtypes.rst:1774 msgid "" "Similar to ``str.format(**mapping)``, except that ``mapping`` is used " "directly and not copied to a :class:`dict`. This is useful if for example " "``mapping`` is a dict subclass:" msgstr "" -#: ../../library/stdtypes.rst:1789 +#: ../../library/stdtypes.rst:1790 msgid "" "Like :meth:`~str.find`, but raise :exc:`ValueError` when the substring is " "not found." msgstr "" -#: ../../library/stdtypes.rst:1795 +#: ../../library/stdtypes.rst:1796 msgid "" "Return ``True`` if all characters in the string are alphanumeric and there " "is at least one character, ``False`` otherwise. A character ``c`` is " @@ -2472,7 +2472,7 @@ msgid "" "isdecimal()``, ``c.isdigit()``, or ``c.isnumeric()``." msgstr "" -#: ../../library/stdtypes.rst:1803 +#: ../../library/stdtypes.rst:1804 msgid "" "Return ``True`` if all characters in the string are alphabetic and there is " "at least one character, ``False`` otherwise. Alphabetic characters are " @@ -2484,14 +2484,14 @@ msgid "" "pdf>`_." msgstr "" -#: ../../library/stdtypes.rst:1814 +#: ../../library/stdtypes.rst:1815 msgid "" "Return ``True`` if the string is empty or all characters in the string are " "ASCII, ``False`` otherwise. ASCII characters have code points in the range " "U+0000-U+007F." msgstr "" -#: ../../library/stdtypes.rst:1823 +#: ../../library/stdtypes.rst:1824 msgid "" "Return ``True`` if all characters in the string are decimal characters and " "there is at least one character, ``False`` otherwise. Decimal characters are " @@ -2500,7 +2500,7 @@ msgid "" "General Category \"Nd\"." msgstr "" -#: ../../library/stdtypes.rst:1833 +#: ../../library/stdtypes.rst:1834 msgid "" "Return ``True`` if all characters in the string are digits and there is at " "least one character, ``False`` otherwise. Digits include decimal characters " @@ -2510,29 +2510,29 @@ msgid "" "property value Numeric_Type=Digit or Numeric_Type=Decimal." msgstr "" -#: ../../library/stdtypes.rst:1843 +#: ../../library/stdtypes.rst:1844 msgid "" "Return ``True`` if the string is a valid identifier according to the " "language definition, section :ref:`identifiers`." msgstr "" -#: ../../library/stdtypes.rst:1846 +#: ../../library/stdtypes.rst:1847 msgid "" ":func:`keyword.iskeyword` can be used to test whether string ``s`` is a " "reserved identifier, such as :keyword:`def` and :keyword:`class`." msgstr "" -#: ../../library/stdtypes.rst:1849 +#: ../../library/stdtypes.rst:1850 msgid "Example: ::" msgstr "範例： ::" -#: ../../library/stdtypes.rst:1862 +#: ../../library/stdtypes.rst:1863 msgid "" "Return ``True`` if all cased characters [4]_ in the string are lowercase and " "there is at least one cased character, ``False`` otherwise." msgstr "" -#: ../../library/stdtypes.rst:1868 +#: ../../library/stdtypes.rst:1869 msgid "" "Return ``True`` if all characters in the string are numeric characters, and " "there is at least one character, ``False`` otherwise. Numeric characters " @@ -2542,7 +2542,7 @@ msgid "" "Numeric_Type=Decimal or Numeric_Type=Numeric." msgstr "" -#: ../../library/stdtypes.rst:1878 +#: ../../library/stdtypes.rst:1879 msgid "" "Return ``True`` if all characters in the string are printable or the string " "is empty, ``False`` otherwise. Nonprintable characters are those characters " @@ -2553,20 +2553,20 @@ msgid "" "of strings written to :data:`sys.stdout` or :data:`sys.stderr`.)" msgstr "" -#: ../../library/stdtypes.rst:1889 +#: ../../library/stdtypes.rst:1890 msgid "" "Return ``True`` if there are only whitespace characters in the string and " "there is at least one character, ``False`` otherwise." msgstr "" -#: ../../library/stdtypes.rst:1892 +#: ../../library/stdtypes.rst:1893 msgid "" "A character is *whitespace* if in the Unicode character database (see :mod:" "`unicodedata`), either its general category is ``Zs`` (\"Separator, " "space\"), or its bidirectional class is one of ``WS``, ``B``, or ``S``." msgstr "" -#: ../../library/stdtypes.rst:1900 +#: ../../library/stdtypes.rst:1901 msgid "" "Return ``True`` if the string is a titlecased string and there is at least " "one character, for example uppercase characters may only follow uncased " @@ -2574,13 +2574,13 @@ msgid "" "otherwise." msgstr "" -#: ../../library/stdtypes.rst:1907 +#: ../../library/stdtypes.rst:1908 msgid "" "Return ``True`` if all cased characters [4]_ in the string are uppercase and " "there is at least one cased character, ``False`` otherwise." msgstr "" -#: ../../library/stdtypes.rst:1925 +#: ../../library/stdtypes.rst:1926 msgid "" "Return a string which is the concatenation of the strings in *iterable*. A :" "exc:`TypeError` will be raised if there are any non-string values in " @@ -2588,27 +2588,27 @@ msgid "" "elements is the string providing this method." msgstr "" -#: ../../library/stdtypes.rst:1933 +#: ../../library/stdtypes.rst:1934 msgid "" "Return the string left justified in a string of length *width*. Padding is " "done using the specified *fillchar* (default is an ASCII space). The " "original string is returned if *width* is less than or equal to ``len(s)``." msgstr "" -#: ../../library/stdtypes.rst:1940 +#: ../../library/stdtypes.rst:1941 msgid "" "Return a copy of the string with all the cased characters [4]_ converted to " "lowercase." msgstr "" -#: ../../library/stdtypes.rst:1943 +#: ../../library/stdtypes.rst:1944 msgid "" "The lowercasing algorithm used is `described in section 3.13 'Default Case " "Folding' of the Unicode Standard `__." msgstr "" -#: ../../library/stdtypes.rst:1950 +#: ../../library/stdtypes.rst:1951 msgid "" "Return a copy of the string with leading characters removed. The *chars* " "argument is a string specifying the set of characters to be removed. If " @@ -2617,19 +2617,19 @@ msgid "" "are stripped::" msgstr "" -#: ../../library/stdtypes.rst:1960 +#: ../../library/stdtypes.rst:1961 msgid "" "See :meth:`str.removeprefix` for a method that will remove a single prefix " "string rather than all of a set of characters. For example::" msgstr "" -#: ../../library/stdtypes.rst:1971 +#: ../../library/stdtypes.rst:1972 msgid "" "This static method returns a translation table usable for :meth:`str." "translate`." msgstr "" -#: ../../library/stdtypes.rst:1973 +#: ../../library/stdtypes.rst:1974 msgid "" "If there is only one argument, it must be a dictionary mapping Unicode " "ordinals (integers) or characters (strings of length 1) to Unicode ordinals, " @@ -2637,7 +2637,7 @@ msgid "" "converted to ordinals." msgstr "" -#: ../../library/stdtypes.rst:1978 +#: ../../library/stdtypes.rst:1979 msgid "" "If there are two arguments, they must be strings of equal length, and in the " "resulting dictionary, each character in x will be mapped to the character at " @@ -2645,7 +2645,7 @@ msgid "" "whose characters will be mapped to ``None`` in the result." msgstr "" -#: ../../library/stdtypes.rst:1986 +#: ../../library/stdtypes.rst:1987 msgid "" "Split the string at the first occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself, and the part " @@ -2653,47 +2653,47 @@ msgid "" "containing the string itself, followed by two empty strings." msgstr "" -#: ../../library/stdtypes.rst:1994 +#: ../../library/stdtypes.rst:1995 msgid "" "If the string starts with the *prefix* string, return " "``string[len(prefix):]``. Otherwise, return a copy of the original string::" msgstr "" -#: ../../library/stdtypes.rst:2008 +#: ../../library/stdtypes.rst:2009 msgid "" "If the string ends with the *suffix* string and that *suffix* is not empty, " "return ``string[:-len(suffix)]``. Otherwise, return a copy of the original " "string::" msgstr "" -#: ../../library/stdtypes.rst:2022 +#: ../../library/stdtypes.rst:2023 msgid "" "Return a copy of the string with all occurrences of substring *old* replaced " "by *new*. If the optional argument *count* is given, only the first *count* " "occurrences are replaced." msgstr "" -#: ../../library/stdtypes.rst:2029 +#: ../../library/stdtypes.rst:2030 msgid "" "Return the highest index in the string where substring *sub* is found, such " "that *sub* is contained within ``s[start:end]``. Optional arguments *start* " "and *end* are interpreted as in slice notation. Return ``-1`` on failure." msgstr "" -#: ../../library/stdtypes.rst:2036 +#: ../../library/stdtypes.rst:2037 msgid "" "Like :meth:`rfind` but raises :exc:`ValueError` when the substring *sub* is " "not found." msgstr "" -#: ../../library/stdtypes.rst:2042 +#: ../../library/stdtypes.rst:2043 msgid "" "Return the string right justified in a string of length *width*. Padding is " "done using the specified *fillchar* (default is an ASCII space). The " "original string is returned if *width* is less than or equal to ``len(s)``." msgstr "" -#: ../../library/stdtypes.rst:2049 +#: ../../library/stdtypes.rst:2050 msgid "" "Split the string at the last occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself, and the part " @@ -2701,7 +2701,7 @@ msgid "" "containing two empty strings, followed by the string itself." msgstr "" -#: ../../library/stdtypes.rst:2057 +#: ../../library/stdtypes.rst:2058 msgid "" "Return a list of the words in the string, using *sep* as the delimiter " "string. If *maxsplit* is given, at most *maxsplit* splits are done, the " @@ -2710,7 +2710,7 @@ msgid "" "behaves like :meth:`split` which is described in detail below." msgstr "" -#: ../../library/stdtypes.rst:2066 +#: ../../library/stdtypes.rst:2067 msgid "" "Return a copy of the string with trailing characters removed. The *chars* " "argument is a string specifying the set of characters to be removed. If " @@ -2719,13 +2719,13 @@ msgid "" "are stripped::" msgstr "" -#: ../../library/stdtypes.rst:2076 +#: ../../library/stdtypes.rst:2077 msgid "" "See :meth:`str.removesuffix` for a method that will remove a single suffix " "string rather than all of a set of characters. For example::" msgstr "" -#: ../../library/stdtypes.rst:2086 +#: ../../library/stdtypes.rst:2087 msgid "" "Return a list of the words in the string, using *sep* as the delimiter " "string. If *maxsplit* is given, at most *maxsplit* splits are done (thus, " @@ -2734,7 +2734,7 @@ msgid "" "possible splits are made)." msgstr "" -#: ../../library/stdtypes.rst:2092 +#: ../../library/stdtypes.rst:2093 msgid "" "If *sep* is given, consecutive delimiters are not grouped together and are " "deemed to delimit empty strings (for example, ``'1,,2'.split(',')`` returns " @@ -2744,20 +2744,20 @@ msgid "" "``['']``." msgstr "" -#: ../../library/stdtypes.rst:2099 ../../library/stdtypes.rst:2117 -#: ../../library/stdtypes.rst:2169 ../../library/stdtypes.rst:2237 -#: ../../library/stdtypes.rst:2305 ../../library/stdtypes.rst:3151 -#: ../../library/stdtypes.rst:3169 ../../library/stdtypes.rst:3260 -#: ../../library/stdtypes.rst:3276 ../../library/stdtypes.rst:3301 -#: ../../library/stdtypes.rst:3315 ../../library/stdtypes.rst:3343 -#: ../../library/stdtypes.rst:3357 ../../library/stdtypes.rst:3375 -#: ../../library/stdtypes.rst:3402 ../../library/stdtypes.rst:3425 -#: ../../library/stdtypes.rst:3452 ../../library/stdtypes.rst:3494 -#: ../../library/stdtypes.rst:3518 +#: ../../library/stdtypes.rst:2100 ../../library/stdtypes.rst:2118 +#: ../../library/stdtypes.rst:2170 ../../library/stdtypes.rst:2238 +#: ../../library/stdtypes.rst:2306 ../../library/stdtypes.rst:3152 +#: ../../library/stdtypes.rst:3170 ../../library/stdtypes.rst:3261 +#: ../../library/stdtypes.rst:3277 ../../library/stdtypes.rst:3302 +#: ../../library/stdtypes.rst:3316 ../../library/stdtypes.rst:3344 +#: ../../library/stdtypes.rst:3358 ../../library/stdtypes.rst:3376 +#: ../../library/stdtypes.rst:3403 ../../library/stdtypes.rst:3426 +#: ../../library/stdtypes.rst:3453 ../../library/stdtypes.rst:3495 +#: ../../library/stdtypes.rst:3519 msgid "For example::" msgstr "舉例來說： ::" -#: ../../library/stdtypes.rst:2110 +#: ../../library/stdtypes.rst:2111 msgid "" "If *sep* is not specified or is ``None``, a different splitting algorithm is " "applied: runs of consecutive whitespace are regarded as a single separator, " @@ -2767,131 +2767,131 @@ msgid "" "returns ``[]``." msgstr "" -#: ../../library/stdtypes.rst:2132 +#: ../../library/stdtypes.rst:2133 msgid "" "Return a list of the lines in the string, breaking at line boundaries. Line " "breaks are not included in the resulting list unless *keepends* is given and " "true." msgstr "" -#: ../../library/stdtypes.rst:2136 +#: ../../library/stdtypes.rst:2137 msgid "" "This method splits on the following line boundaries. In particular, the " "boundaries are a superset of :term:`universal newlines`." msgstr "" -#: ../../library/stdtypes.rst:2140 +#: ../../library/stdtypes.rst:2141 msgid "Representation" msgstr "" -#: ../../library/stdtypes.rst:2140 +#: ../../library/stdtypes.rst:2141 msgid "Description" msgstr "描述" -#: ../../library/stdtypes.rst:2142 +#: ../../library/stdtypes.rst:2143 msgid "``\\n``" msgstr "``\\n``" -#: ../../library/stdtypes.rst:2142 +#: ../../library/stdtypes.rst:2143 msgid "Line Feed" msgstr "" -#: ../../library/stdtypes.rst:2144 +#: ../../library/stdtypes.rst:2145 msgid "``\\r``" msgstr "``\\r``" -#: ../../library/stdtypes.rst:2144 +#: ../../library/stdtypes.rst:2145 msgid "Carriage Return" msgstr "" -#: ../../library/stdtypes.rst:2146 +#: ../../library/stdtypes.rst:2147 msgid "``\\r\\n``" msgstr "``\\r\\n``" -#: ../../library/stdtypes.rst:2146 +#: ../../library/stdtypes.rst:2147 msgid "Carriage Return + Line Feed" msgstr "" -#: ../../library/stdtypes.rst:2148 +#: ../../library/stdtypes.rst:2149 msgid "``\\v`` or ``\\x0b``" msgstr "``\\v`` 或 ``\\x0b``" -#: ../../library/stdtypes.rst:2148 +#: ../../library/stdtypes.rst:2149 msgid "Line Tabulation" msgstr "" -#: ../../library/stdtypes.rst:2150 +#: ../../library/stdtypes.rst:2151 msgid "``\\f`` or ``\\x0c``" msgstr "``\\f`` 或 ``\\x0c``" -#: ../../library/stdtypes.rst:2150 +#: ../../library/stdtypes.rst:2151 msgid "Form Feed" msgstr "" -#: ../../library/stdtypes.rst:2152 +#: ../../library/stdtypes.rst:2153 msgid "``\\x1c``" msgstr "``\\x1c``" -#: ../../library/stdtypes.rst:2152 +#: ../../library/stdtypes.rst:2153 msgid "File Separator" msgstr "" -#: ../../library/stdtypes.rst:2154 +#: ../../library/stdtypes.rst:2155 msgid "``\\x1d``" msgstr "``\\x1d``" -#: ../../library/stdtypes.rst:2154 +#: ../../library/stdtypes.rst:2155 msgid "Group Separator" msgstr "" -#: ../../library/stdtypes.rst:2156 +#: ../../library/stdtypes.rst:2157 msgid "``\\x1e``" msgstr "``\\x1e``" -#: ../../library/stdtypes.rst:2156 +#: ../../library/stdtypes.rst:2157 msgid "Record Separator" msgstr "" -#: ../../library/stdtypes.rst:2158 +#: ../../library/stdtypes.rst:2159 msgid "``\\x85``" msgstr "``\\x85``" -#: ../../library/stdtypes.rst:2158 +#: ../../library/stdtypes.rst:2159 msgid "Next Line (C1 Control Code)" msgstr "" -#: ../../library/stdtypes.rst:2160 +#: ../../library/stdtypes.rst:2161 msgid "``\\u2028``" msgstr "``\\u2028``" -#: ../../library/stdtypes.rst:2160 +#: ../../library/stdtypes.rst:2161 msgid "Line Separator" msgstr "" -#: ../../library/stdtypes.rst:2162 +#: ../../library/stdtypes.rst:2163 msgid "``\\u2029``" msgstr "``\\u2029``" -#: ../../library/stdtypes.rst:2162 +#: ../../library/stdtypes.rst:2163 msgid "Paragraph Separator" msgstr "" -#: ../../library/stdtypes.rst:2167 +#: ../../library/stdtypes.rst:2168 msgid "``\\v`` and ``\\f`` added to list of line boundaries." msgstr "" -#: ../../library/stdtypes.rst:2176 +#: ../../library/stdtypes.rst:2177 msgid "" "Unlike :meth:`~str.split` when a delimiter string *sep* is given, this " "method returns an empty list for the empty string, and a terminal line break " "does not result in an extra line::" msgstr "" -#: ../../library/stdtypes.rst:2185 +#: ../../library/stdtypes.rst:2186 msgid "For comparison, ``split('\\n')`` gives::" msgstr "" -#: ../../library/stdtypes.rst:2195 +#: ../../library/stdtypes.rst:2196 msgid "" "Return ``True`` if string starts with the *prefix*, otherwise return " "``False``. *prefix* can also be a tuple of prefixes to look for. With " @@ -2899,7 +2899,7 @@ msgid "" "*end*, stop comparing string at that position." msgstr "" -#: ../../library/stdtypes.rst:2203 +#: ../../library/stdtypes.rst:2204 msgid "" "Return a copy of the string with the leading and trailing characters " "removed. The *chars* argument is a string specifying the set of characters " @@ -2908,7 +2908,7 @@ msgid "" "all combinations of its values are stripped::" msgstr "" -#: ../../library/stdtypes.rst:2214 +#: ../../library/stdtypes.rst:2215 msgid "" "The outermost leading and trailing *chars* argument values are stripped from " "the string. Characters are removed from the leading end until reaching a " @@ -2916,20 +2916,20 @@ msgid "" "A similar action takes place on the trailing end. For example::" msgstr "" -#: ../../library/stdtypes.rst:2227 +#: ../../library/stdtypes.rst:2228 msgid "" "Return a copy of the string with uppercase characters converted to lowercase " "and vice versa. Note that it is not necessarily true that ``s.swapcase()." "swapcase() == s``." msgstr "" -#: ../../library/stdtypes.rst:2234 +#: ../../library/stdtypes.rst:2235 msgid "" "Return a titlecased version of the string where words start with an " "uppercase character and the remaining characters are lowercase." msgstr "" -#: ../../library/stdtypes.rst:2242 ../../library/stdtypes.rst:3462 +#: ../../library/stdtypes.rst:2243 ../../library/stdtypes.rst:3463 msgid "" "The algorithm uses a simple language-independent definition of a word as " "groups of consecutive letters. The definition works in many contexts but it " @@ -2937,19 +2937,19 @@ msgid "" "which may not be the desired result::" msgstr "" -#: ../../library/stdtypes.rst:2250 +#: ../../library/stdtypes.rst:2251 msgid "" "The :func:`string.capwords` function does not have this problem, as it " "splits words on spaces only." msgstr "" -#: ../../library/stdtypes.rst:2253 +#: ../../library/stdtypes.rst:2254 msgid "" "Alternatively, a workaround for apostrophes can be constructed using regular " "expressions::" msgstr "" -#: ../../library/stdtypes.rst:2268 +#: ../../library/stdtypes.rst:2269 msgid "" "Return a copy of the string in which each character has been mapped through " "the given translation table. The table must be an object that implements " @@ -2961,19 +2961,19 @@ msgid "" "exception, to map the character to itself." msgstr "" -#: ../../library/stdtypes.rst:2277 +#: ../../library/stdtypes.rst:2278 msgid "" "You can use :meth:`str.maketrans` to create a translation map from character-" "to-character mappings in different formats." msgstr "" -#: ../../library/stdtypes.rst:2280 +#: ../../library/stdtypes.rst:2281 msgid "" "See also the :mod:`codecs` module for a more flexible approach to custom " "character mappings." msgstr "" -#: ../../library/stdtypes.rst:2286 +#: ../../library/stdtypes.rst:2287 msgid "" "Return a copy of the string with all the cased characters [4]_ converted to " "uppercase. Note that ``s.upper().isupper()`` might be ``False`` if ``s`` " @@ -2982,14 +2982,14 @@ msgid "" "titlecase)." msgstr "" -#: ../../library/stdtypes.rst:2292 +#: ../../library/stdtypes.rst:2293 msgid "" "The uppercasing algorithm used is `described in section 3.13 'Default Case " "Folding' of the Unicode Standard `__." msgstr "" -#: ../../library/stdtypes.rst:2299 +#: ../../library/stdtypes.rst:2300 msgid "" "Return a copy of the string left filled with ASCII ``'0'`` digits to make a " "string of length *width*. A leading sign prefix (``'+'``/``'-'``) is handled " @@ -2997,11 +2997,11 @@ msgid "" "original string is returned if *width* is less than or equal to ``len(s)``." msgstr "" -#: ../../library/stdtypes.rst:2317 +#: ../../library/stdtypes.rst:2318 msgid "``printf``-style String Formatting" msgstr "" -#: ../../library/stdtypes.rst:2330 +#: ../../library/stdtypes.rst:2331 msgid "" "The formatting operations described here exhibit a variety of quirks that " "lead to a number of common errors (such as failing to display tuples and " @@ -3012,7 +3012,7 @@ msgid "" "or extensibility." msgstr "" -#: ../../library/stdtypes.rst:2338 +#: ../../library/stdtypes.rst:2339 msgid "" "String objects have one unique built-in operation: the ``%`` operator " "(modulo). This is also known as the string *formatting* or *interpolation* " @@ -3022,7 +3022,7 @@ msgid "" "in the C language." msgstr "" -#: ../../library/stdtypes.rst:2344 +#: ../../library/stdtypes.rst:2345 msgid "" "If *format* requires a single argument, *values* may be a single non-tuple " "object. [5]_ Otherwise, *values* must be a tuple with exactly the number of " @@ -3030,36 +3030,36 @@ msgid "" "example, a dictionary)." msgstr "" -#: ../../library/stdtypes.rst:2354 ../../library/stdtypes.rst:3573 +#: ../../library/stdtypes.rst:2355 ../../library/stdtypes.rst:3574 msgid "" "A conversion specifier contains two or more characters and has the following " "components, which must occur in this order:" msgstr "" -#: ../../library/stdtypes.rst:2357 ../../library/stdtypes.rst:3576 +#: ../../library/stdtypes.rst:2358 ../../library/stdtypes.rst:3577 msgid "The ``'%'`` character, which marks the start of the specifier." msgstr "" -#: ../../library/stdtypes.rst:2359 ../../library/stdtypes.rst:3578 +#: ../../library/stdtypes.rst:2360 ../../library/stdtypes.rst:3579 msgid "" "Mapping key (optional), consisting of a parenthesised sequence of characters " "(for example, ``(somename)``)." msgstr "" -#: ../../library/stdtypes.rst:2362 ../../library/stdtypes.rst:3581 +#: ../../library/stdtypes.rst:2363 ../../library/stdtypes.rst:3582 msgid "" "Conversion flags (optional), which affect the result of some conversion " "types." msgstr "" -#: ../../library/stdtypes.rst:2365 ../../library/stdtypes.rst:3584 +#: ../../library/stdtypes.rst:2366 ../../library/stdtypes.rst:3585 msgid "" "Minimum field width (optional). If specified as an ``'*'`` (asterisk), the " "actual width is read from the next element of the tuple in *values*, and the " "object to convert comes after the minimum field width and optional precision." msgstr "" -#: ../../library/stdtypes.rst:2369 ../../library/stdtypes.rst:3588 +#: ../../library/stdtypes.rst:2370 ../../library/stdtypes.rst:3589 msgid "" "Precision (optional), given as a ``'.'`` (dot) followed by the precision. " "If specified as ``'*'`` (an asterisk), the actual precision is read from the " @@ -3067,15 +3067,15 @@ msgid "" "the precision." msgstr "" -#: ../../library/stdtypes.rst:2374 ../../library/stdtypes.rst:3593 +#: ../../library/stdtypes.rst:2375 ../../library/stdtypes.rst:3594 msgid "Length modifier (optional)." msgstr "" -#: ../../library/stdtypes.rst:2376 ../../library/stdtypes.rst:3595 +#: ../../library/stdtypes.rst:2377 ../../library/stdtypes.rst:3596 msgid "Conversion type." msgstr "" -#: ../../library/stdtypes.rst:2378 +#: ../../library/stdtypes.rst:2379 msgid "" "When the right argument is a dictionary (or other mapping type), then the " "formats in the string *must* include a parenthesised mapping key into that " @@ -3083,279 +3083,279 @@ msgid "" "selects the value to be formatted from the mapping. For example:" msgstr "" -#: ../../library/stdtypes.rst:2387 ../../library/stdtypes.rst:3606 +#: ../../library/stdtypes.rst:2388 ../../library/stdtypes.rst:3607 msgid "" "In this case no ``*`` specifiers may occur in a format (since they require a " "sequential parameter list)." msgstr "" -#: ../../library/stdtypes.rst:2390 ../../library/stdtypes.rst:3609 +#: ../../library/stdtypes.rst:2391 ../../library/stdtypes.rst:3610 msgid "The conversion flag characters are:" msgstr "" -#: ../../library/stdtypes.rst:2399 ../../library/stdtypes.rst:3618 +#: ../../library/stdtypes.rst:2400 ../../library/stdtypes.rst:3619 msgid "Flag" msgstr "" -#: ../../library/stdtypes.rst:2401 ../../library/stdtypes.rst:3620 +#: ../../library/stdtypes.rst:2402 ../../library/stdtypes.rst:3621 msgid "``'#'``" msgstr "``'#'``" -#: ../../library/stdtypes.rst:2401 ../../library/stdtypes.rst:3620 +#: ../../library/stdtypes.rst:2402 ../../library/stdtypes.rst:3621 msgid "" "The value conversion will use the \"alternate form\" (where defined below)." msgstr "" -#: ../../library/stdtypes.rst:2404 ../../library/stdtypes.rst:3623 +#: ../../library/stdtypes.rst:2405 ../../library/stdtypes.rst:3624 msgid "``'0'``" msgstr "``'0'``" -#: ../../library/stdtypes.rst:2404 ../../library/stdtypes.rst:3623 +#: ../../library/stdtypes.rst:2405 ../../library/stdtypes.rst:3624 msgid "The conversion will be zero padded for numeric values." msgstr "" -#: ../../library/stdtypes.rst:2406 ../../library/stdtypes.rst:3625 +#: ../../library/stdtypes.rst:2407 ../../library/stdtypes.rst:3626 msgid "``'-'``" msgstr "``'-'``" -#: ../../library/stdtypes.rst:2406 ../../library/stdtypes.rst:3625 +#: ../../library/stdtypes.rst:2407 ../../library/stdtypes.rst:3626 msgid "" "The converted value is left adjusted (overrides the ``'0'`` conversion if " "both are given)." msgstr "" -#: ../../library/stdtypes.rst:2409 ../../library/stdtypes.rst:3628 +#: ../../library/stdtypes.rst:2410 ../../library/stdtypes.rst:3629 msgid "``' '``" msgstr "``' '``" -#: ../../library/stdtypes.rst:2409 ../../library/stdtypes.rst:3628 +#: ../../library/stdtypes.rst:2410 ../../library/stdtypes.rst:3629 msgid "" "(a space) A blank should be left before a positive number (or empty string) " "produced by a signed conversion." msgstr "" -#: ../../library/stdtypes.rst:2412 ../../library/stdtypes.rst:3631 +#: ../../library/stdtypes.rst:2413 ../../library/stdtypes.rst:3632 msgid "``'+'``" msgstr "``'+'``" -#: ../../library/stdtypes.rst:2412 ../../library/stdtypes.rst:3631 +#: ../../library/stdtypes.rst:2413 ../../library/stdtypes.rst:3632 msgid "" "A sign character (``'+'`` or ``'-'``) will precede the conversion (overrides " "a \"space\" flag)." msgstr "" -#: ../../library/stdtypes.rst:2416 ../../library/stdtypes.rst:3635 +#: ../../library/stdtypes.rst:2417 ../../library/stdtypes.rst:3636 msgid "" "A length modifier (``h``, ``l``, or ``L``) may be present, but is ignored as " "it is not necessary for Python -- so e.g. ``%ld`` is identical to ``%d``." msgstr "" -#: ../../library/stdtypes.rst:2419 ../../library/stdtypes.rst:3638 +#: ../../library/stdtypes.rst:2420 ../../library/stdtypes.rst:3639 msgid "The conversion types are:" msgstr "" -#: ../../library/stdtypes.rst:2422 ../../library/stdtypes.rst:3641 +#: ../../library/stdtypes.rst:2423 ../../library/stdtypes.rst:3642 msgid "Conversion" msgstr "" -#: ../../library/stdtypes.rst:2424 ../../library/stdtypes.rst:3643 +#: ../../library/stdtypes.rst:2425 ../../library/stdtypes.rst:3644 msgid "``'d'``" msgstr "``'d'``" -#: ../../library/stdtypes.rst:2424 ../../library/stdtypes.rst:2426 -#: ../../library/stdtypes.rst:3643 ../../library/stdtypes.rst:3645 +#: ../../library/stdtypes.rst:2425 ../../library/stdtypes.rst:2427 +#: ../../library/stdtypes.rst:3644 ../../library/stdtypes.rst:3646 msgid "Signed integer decimal." msgstr "" -#: ../../library/stdtypes.rst:2426 ../../library/stdtypes.rst:3645 +#: ../../library/stdtypes.rst:2427 ../../library/stdtypes.rst:3646 msgid "``'i'``" msgstr "``'i'``" -#: ../../library/stdtypes.rst:2428 ../../library/stdtypes.rst:3647 +#: ../../library/stdtypes.rst:2429 ../../library/stdtypes.rst:3648 msgid "``'o'``" msgstr "``'o'``" -#: ../../library/stdtypes.rst:2428 ../../library/stdtypes.rst:3647 +#: ../../library/stdtypes.rst:2429 ../../library/stdtypes.rst:3648 msgid "Signed octal value." msgstr "" -#: ../../library/stdtypes.rst:2430 ../../library/stdtypes.rst:3649 +#: ../../library/stdtypes.rst:2431 ../../library/stdtypes.rst:3650 msgid "``'u'``" msgstr "``'u'``" -#: ../../library/stdtypes.rst:2430 ../../library/stdtypes.rst:3649 +#: ../../library/stdtypes.rst:2431 ../../library/stdtypes.rst:3650 msgid "Obsolete type -- it is identical to ``'d'``." msgstr "" -#: ../../library/stdtypes.rst:2432 ../../library/stdtypes.rst:3651 +#: ../../library/stdtypes.rst:2433 ../../library/stdtypes.rst:3652 msgid "``'x'``" msgstr "``'x'``" -#: ../../library/stdtypes.rst:2432 ../../library/stdtypes.rst:3651 +#: ../../library/stdtypes.rst:2433 ../../library/stdtypes.rst:3652 msgid "Signed hexadecimal (lowercase)." msgstr "" -#: ../../library/stdtypes.rst:2434 ../../library/stdtypes.rst:3653 +#: ../../library/stdtypes.rst:2435 ../../library/stdtypes.rst:3654 msgid "``'X'``" msgstr "``'X'``" -#: ../../library/stdtypes.rst:2434 ../../library/stdtypes.rst:3653 +#: ../../library/stdtypes.rst:2435 ../../library/stdtypes.rst:3654 msgid "Signed hexadecimal (uppercase)." msgstr "" -#: ../../library/stdtypes.rst:2436 ../../library/stdtypes.rst:3655 +#: ../../library/stdtypes.rst:2437 ../../library/stdtypes.rst:3656 msgid "``'e'``" msgstr "``'e'``" -#: ../../library/stdtypes.rst:2436 ../../library/stdtypes.rst:3655 +#: ../../library/stdtypes.rst:2437 ../../library/stdtypes.rst:3656 msgid "Floating-point exponential format (lowercase)." msgstr "" -#: ../../library/stdtypes.rst:2438 ../../library/stdtypes.rst:3657 +#: ../../library/stdtypes.rst:2439 ../../library/stdtypes.rst:3658 msgid "``'E'``" msgstr "``'E'``" -#: ../../library/stdtypes.rst:2438 ../../library/stdtypes.rst:3657 +#: ../../library/stdtypes.rst:2439 ../../library/stdtypes.rst:3658 msgid "Floating-point exponential format (uppercase)." msgstr "" -#: ../../library/stdtypes.rst:2440 ../../library/stdtypes.rst:3659 +#: ../../library/stdtypes.rst:2441 ../../library/stdtypes.rst:3660 msgid "``'f'``" msgstr "``'f'``" -#: ../../library/stdtypes.rst:2440 ../../library/stdtypes.rst:2442 -#: ../../library/stdtypes.rst:3659 ../../library/stdtypes.rst:3661 +#: ../../library/stdtypes.rst:2441 ../../library/stdtypes.rst:2443 +#: ../../library/stdtypes.rst:3660 ../../library/stdtypes.rst:3662 msgid "Floating-point decimal format." msgstr "" -#: ../../library/stdtypes.rst:2442 ../../library/stdtypes.rst:3661 +#: ../../library/stdtypes.rst:2443 ../../library/stdtypes.rst:3662 msgid "``'F'``" msgstr "``'F'``" -#: ../../library/stdtypes.rst:2444 ../../library/stdtypes.rst:3663 +#: ../../library/stdtypes.rst:2445 ../../library/stdtypes.rst:3664 msgid "``'g'``" msgstr "``'g'``" -#: ../../library/stdtypes.rst:2444 ../../library/stdtypes.rst:3663 +#: ../../library/stdtypes.rst:2445 ../../library/stdtypes.rst:3664 msgid "" "Floating-point format. Uses lowercase exponential format if exponent is less " "than -4 or not less than precision, decimal format otherwise." msgstr "" -#: ../../library/stdtypes.rst:2448 ../../library/stdtypes.rst:3667 +#: ../../library/stdtypes.rst:2449 ../../library/stdtypes.rst:3668 msgid "``'G'``" msgstr "``'G'``" -#: ../../library/stdtypes.rst:2448 ../../library/stdtypes.rst:3667 +#: ../../library/stdtypes.rst:2449 ../../library/stdtypes.rst:3668 msgid "" "Floating-point format. Uses uppercase exponential format if exponent is less " "than -4 or not less than precision, decimal format otherwise." msgstr "" -#: ../../library/stdtypes.rst:2452 ../../library/stdtypes.rst:3671 +#: ../../library/stdtypes.rst:2453 ../../library/stdtypes.rst:3672 msgid "``'c'``" msgstr "``'c'``" -#: ../../library/stdtypes.rst:2452 +#: ../../library/stdtypes.rst:2453 msgid "Single character (accepts integer or single character string)." msgstr "" -#: ../../library/stdtypes.rst:2455 ../../library/stdtypes.rst:3684 +#: ../../library/stdtypes.rst:2456 ../../library/stdtypes.rst:3685 msgid "``'r'``" msgstr "``'r'``" -#: ../../library/stdtypes.rst:2455 +#: ../../library/stdtypes.rst:2456 msgid "String (converts any Python object using :func:`repr`)." msgstr "" -#: ../../library/stdtypes.rst:2458 ../../library/stdtypes.rst:3678 +#: ../../library/stdtypes.rst:2459 ../../library/stdtypes.rst:3679 msgid "``'s'``" msgstr "``'s'``" -#: ../../library/stdtypes.rst:2458 +#: ../../library/stdtypes.rst:2459 msgid "String (converts any Python object using :func:`str`)." msgstr "" -#: ../../library/stdtypes.rst:2461 ../../library/stdtypes.rst:3681 +#: ../../library/stdtypes.rst:2462 ../../library/stdtypes.rst:3682 msgid "``'a'``" msgstr "``'a'``" -#: ../../library/stdtypes.rst:2461 +#: ../../library/stdtypes.rst:2462 msgid "String (converts any Python object using :func:`ascii`)." msgstr "" -#: ../../library/stdtypes.rst:2464 ../../library/stdtypes.rst:3687 +#: ../../library/stdtypes.rst:2465 ../../library/stdtypes.rst:3688 msgid "``'%'``" msgstr "``'%'``" -#: ../../library/stdtypes.rst:2464 ../../library/stdtypes.rst:3687 +#: ../../library/stdtypes.rst:2465 ../../library/stdtypes.rst:3688 msgid "No argument is converted, results in a ``'%'`` character in the result." msgstr "" -#: ../../library/stdtypes.rst:2471 ../../library/stdtypes.rst:3694 +#: ../../library/stdtypes.rst:2472 ../../library/stdtypes.rst:3695 msgid "" "The alternate form causes a leading octal specifier (``'0o'``) to be " "inserted before the first digit." msgstr "" -#: ../../library/stdtypes.rst:2475 ../../library/stdtypes.rst:3698 +#: ../../library/stdtypes.rst:2476 ../../library/stdtypes.rst:3699 msgid "" "The alternate form causes a leading ``'0x'`` or ``'0X'`` (depending on " "whether the ``'x'`` or ``'X'`` format was used) to be inserted before the " "first digit." msgstr "" -#: ../../library/stdtypes.rst:2479 ../../library/stdtypes.rst:3702 +#: ../../library/stdtypes.rst:2480 ../../library/stdtypes.rst:3703 msgid "" "The alternate form causes the result to always contain a decimal point, even " "if no digits follow it." msgstr "" -#: ../../library/stdtypes.rst:2482 ../../library/stdtypes.rst:3705 +#: ../../library/stdtypes.rst:2483 ../../library/stdtypes.rst:3706 msgid "" "The precision determines the number of digits after the decimal point and " "defaults to 6." msgstr "" -#: ../../library/stdtypes.rst:2486 ../../library/stdtypes.rst:3709 +#: ../../library/stdtypes.rst:2487 ../../library/stdtypes.rst:3710 msgid "" "The alternate form causes the result to always contain a decimal point, and " "trailing zeroes are not removed as they would otherwise be." msgstr "" -#: ../../library/stdtypes.rst:2489 ../../library/stdtypes.rst:3712 +#: ../../library/stdtypes.rst:2490 ../../library/stdtypes.rst:3713 msgid "" "The precision determines the number of significant digits before and after " "the decimal point and defaults to 6." msgstr "" -#: ../../library/stdtypes.rst:2493 ../../library/stdtypes.rst:3716 +#: ../../library/stdtypes.rst:2494 ../../library/stdtypes.rst:3717 msgid "If precision is ``N``, the output is truncated to ``N`` characters." msgstr "" -#: ../../library/stdtypes.rst:2496 ../../library/stdtypes.rst:3725 +#: ../../library/stdtypes.rst:2497 ../../library/stdtypes.rst:3726 msgid "See :pep:`237`." msgstr "參閱 :pep:`237`。" -#: ../../library/stdtypes.rst:2498 +#: ../../library/stdtypes.rst:2499 msgid "" "Since Python strings have an explicit length, ``%s`` conversions do not " "assume that ``'\\0'`` is the end of the string." msgstr "" -#: ../../library/stdtypes.rst:2503 +#: ../../library/stdtypes.rst:2504 msgid "" "``%f`` conversions for numbers whose absolute value is over 1e50 are no " "longer replaced by ``%g`` conversions." msgstr "" -#: ../../library/stdtypes.rst:2514 +#: ../../library/stdtypes.rst:2515 msgid "" "Binary Sequence Types --- :class:`bytes`, :class:`bytearray`, :class:" "`memoryview`" msgstr "" -#: ../../library/stdtypes.rst:2522 +#: ../../library/stdtypes.rst:2523 msgid "" "The core built-in types for manipulating binary data are :class:`bytes` and :" "class:`bytearray`. They are supported by :class:`memoryview` which uses the :" @@ -3363,17 +3363,17 @@ msgid "" "objects without needing to make a copy." msgstr "" -#: ../../library/stdtypes.rst:2527 +#: ../../library/stdtypes.rst:2528 msgid "" "The :mod:`array` module supports efficient storage of basic data types like " "32-bit integers and IEEE754 double-precision floating values." msgstr "" -#: ../../library/stdtypes.rst:2533 +#: ../../library/stdtypes.rst:2534 msgid "Bytes Objects" msgstr "" -#: ../../library/stdtypes.rst:2537 +#: ../../library/stdtypes.rst:2538 msgid "" "Bytes objects are immutable sequences of single bytes. Since many major " "binary protocols are based on the ASCII text encoding, bytes objects offer " @@ -3381,40 +3381,40 @@ msgid "" "and are closely related to string objects in a variety of other ways." msgstr "" -#: ../../library/stdtypes.rst:2544 +#: ../../library/stdtypes.rst:2545 msgid "" "Firstly, the syntax for bytes literals is largely the same as that for " "string literals, except that a ``b`` prefix is added:" msgstr "" -#: ../../library/stdtypes.rst:2547 +#: ../../library/stdtypes.rst:2548 msgid "Single quotes: ``b'still allows embedded \"double\" quotes'``" msgstr "" -#: ../../library/stdtypes.rst:2548 +#: ../../library/stdtypes.rst:2549 msgid "Double quotes: ``b\"still allows embedded 'single' quotes\"``" msgstr "" -#: ../../library/stdtypes.rst:2549 +#: ../../library/stdtypes.rst:2550 msgid "" "Triple quoted: ``b'''3 single quotes'''``, ``b\"\"\"3 double quotes\"\"\"``" msgstr "" -#: ../../library/stdtypes.rst:2551 +#: ../../library/stdtypes.rst:2552 msgid "" "Only ASCII characters are permitted in bytes literals (regardless of the " "declared source code encoding). Any binary values over 127 must be entered " "into bytes literals using the appropriate escape sequence." msgstr "" -#: ../../library/stdtypes.rst:2555 +#: ../../library/stdtypes.rst:2556 msgid "" "As with string literals, bytes literals may also use a ``r`` prefix to " "disable processing of escape sequences. See :ref:`strings` for more about " "the various forms of bytes literal, including supported escape sequences." msgstr "" -#: ../../library/stdtypes.rst:2559 +#: ../../library/stdtypes.rst:2560 msgid "" "While bytes literals and representations are based on ASCII text, bytes " "objects actually behave like immutable sequences of integers, with each " @@ -3427,29 +3427,29 @@ msgid "" "compatible will usually lead to data corruption)." msgstr "" -#: ../../library/stdtypes.rst:2569 +#: ../../library/stdtypes.rst:2570 msgid "" "In addition to the literal forms, bytes objects can be created in a number " "of other ways:" msgstr "" -#: ../../library/stdtypes.rst:2572 +#: ../../library/stdtypes.rst:2573 msgid "A zero-filled bytes object of a specified length: ``bytes(10)``" msgstr "" -#: ../../library/stdtypes.rst:2573 +#: ../../library/stdtypes.rst:2574 msgid "From an iterable of integers: ``bytes(range(20))``" msgstr "" -#: ../../library/stdtypes.rst:2574 +#: ../../library/stdtypes.rst:2575 msgid "Copying existing binary data via the buffer protocol: ``bytes(obj)``" msgstr "" -#: ../../library/stdtypes.rst:2576 +#: ../../library/stdtypes.rst:2577 msgid "Also see the :ref:`bytes ` built-in." msgstr "" -#: ../../library/stdtypes.rst:2578 +#: ../../library/stdtypes.rst:2579 msgid "" "Since 2 hexadecimal digits correspond precisely to a single byte, " "hexadecimal numbers are a commonly used format for describing binary data. " @@ -3457,32 +3457,32 @@ msgid "" "that format:" msgstr "" -#: ../../library/stdtypes.rst:2584 +#: ../../library/stdtypes.rst:2585 msgid "" "This :class:`bytes` class method returns a bytes object, decoding the given " "string object. The string must contain two hexadecimal digits per byte, " "with ASCII whitespace being ignored." msgstr "" -#: ../../library/stdtypes.rst:2591 +#: ../../library/stdtypes.rst:2592 msgid "" ":meth:`bytes.fromhex` now skips all ASCII whitespace in the string, not just " "spaces." msgstr "" -#: ../../library/stdtypes.rst:2595 +#: ../../library/stdtypes.rst:2596 msgid "" "A reverse conversion function exists to transform a bytes object into its " "hexadecimal representation." msgstr "" -#: ../../library/stdtypes.rst:2600 ../../library/stdtypes.rst:2685 +#: ../../library/stdtypes.rst:2601 ../../library/stdtypes.rst:2686 msgid "" "Return a string object containing two hexadecimal digits for each byte in " "the instance." msgstr "" -#: ../../library/stdtypes.rst:2606 +#: ../../library/stdtypes.rst:2607 msgid "" "If you want to make the hex string easier to read, you can specify a single " "character separator *sep* parameter to include in the output. By default, " @@ -3491,13 +3491,13 @@ msgid "" "the separator position from the right, negative values from the left." msgstr "" -#: ../../library/stdtypes.rst:2623 +#: ../../library/stdtypes.rst:2624 msgid "" ":meth:`bytes.hex` now supports optional *sep* and *bytes_per_sep* parameters " "to insert separators between bytes in the hex output." msgstr "" -#: ../../library/stdtypes.rst:2627 +#: ../../library/stdtypes.rst:2628 msgid "" "Since bytes objects are sequences of integers (akin to a tuple), for a bytes " "object *b*, ``b[0]`` will be an integer, while ``b[0:1]`` will be a bytes " @@ -3505,58 +3505,58 @@ msgid "" "and slicing will produce a string of length 1)" msgstr "" -#: ../../library/stdtypes.rst:2632 +#: ../../library/stdtypes.rst:2633 msgid "" "The representation of bytes objects uses the literal format (``b'...'``) " "since it is often more useful than e.g. ``bytes([46, 46, 46])``. You can " "always convert a bytes object into a list of integers using ``list(b)``." msgstr "" -#: ../../library/stdtypes.rst:2640 +#: ../../library/stdtypes.rst:2641 msgid "Bytearray Objects" msgstr "" -#: ../../library/stdtypes.rst:2644 +#: ../../library/stdtypes.rst:2645 msgid "" ":class:`bytearray` objects are a mutable counterpart to :class:`bytes` " "objects." msgstr "" -#: ../../library/stdtypes.rst:2649 +#: ../../library/stdtypes.rst:2650 msgid "" "There is no dedicated literal syntax for bytearray objects, instead they are " "always created by calling the constructor:" msgstr "" -#: ../../library/stdtypes.rst:2652 +#: ../../library/stdtypes.rst:2653 msgid "Creating an empty instance: ``bytearray()``" msgstr "" -#: ../../library/stdtypes.rst:2653 +#: ../../library/stdtypes.rst:2654 msgid "Creating a zero-filled instance with a given length: ``bytearray(10)``" msgstr "" -#: ../../library/stdtypes.rst:2654 +#: ../../library/stdtypes.rst:2655 msgid "From an iterable of integers: ``bytearray(range(20))``" msgstr "" -#: ../../library/stdtypes.rst:2655 +#: ../../library/stdtypes.rst:2656 msgid "" "Copying existing binary data via the buffer protocol: ``bytearray(b'Hi!')``" msgstr "" -#: ../../library/stdtypes.rst:2657 +#: ../../library/stdtypes.rst:2658 msgid "" "As bytearray objects are mutable, they support the :ref:`mutable ` sequence operations in addition to the common bytes and bytearray " "operations described in :ref:`bytes-methods`." msgstr "" -#: ../../library/stdtypes.rst:2661 +#: ../../library/stdtypes.rst:2662 msgid "Also see the :ref:`bytearray ` built-in." msgstr "" -#: ../../library/stdtypes.rst:2663 +#: ../../library/stdtypes.rst:2664 msgid "" "Since 2 hexadecimal digits correspond precisely to a single byte, " "hexadecimal numbers are a commonly used format for describing binary data. " @@ -3564,33 +3564,33 @@ msgid "" "in that format:" msgstr "" -#: ../../library/stdtypes.rst:2669 +#: ../../library/stdtypes.rst:2670 msgid "" "This :class:`bytearray` class method returns bytearray object, decoding the " "given string object. The string must contain two hexadecimal digits per " "byte, with ASCII whitespace being ignored." msgstr "" -#: ../../library/stdtypes.rst:2676 +#: ../../library/stdtypes.rst:2677 msgid "" ":meth:`bytearray.fromhex` now skips all ASCII whitespace in the string, not " "just spaces." msgstr "" -#: ../../library/stdtypes.rst:2680 +#: ../../library/stdtypes.rst:2681 msgid "" "A reverse conversion function exists to transform a bytearray object into " "its hexadecimal representation." msgstr "" -#: ../../library/stdtypes.rst:2693 +#: ../../library/stdtypes.rst:2694 msgid "" "Similar to :meth:`bytes.hex`, :meth:`bytearray.hex` now supports optional " "*sep* and *bytes_per_sep* parameters to insert separators between bytes in " "the hex output." msgstr "" -#: ../../library/stdtypes.rst:2698 +#: ../../library/stdtypes.rst:2699 msgid "" "Since bytearray objects are sequences of integers (akin to a list), for a " "bytearray object *b*, ``b[0]`` will be an integer, while ``b[0:1]`` will be " @@ -3598,7 +3598,7 @@ msgid "" "both indexing and slicing will produce a string of length 1)" msgstr "" -#: ../../library/stdtypes.rst:2703 +#: ../../library/stdtypes.rst:2704 msgid "" "The representation of bytearray objects uses the bytes literal format " "(``bytearray(b'...')``) since it is often more useful than e.g. " @@ -3606,11 +3606,11 @@ msgid "" "a list of integers using ``list(b)``." msgstr "" -#: ../../library/stdtypes.rst:2712 +#: ../../library/stdtypes.rst:2713 msgid "Bytes and Bytearray Operations" msgstr "" -#: ../../library/stdtypes.rst:2717 +#: ../../library/stdtypes.rst:2718 msgid "" "Both bytes and bytearray objects support the :ref:`common ` " "sequence operations. They interoperate not just with operands of the same " @@ -3619,104 +3619,104 @@ msgid "" "return type of the result may depend on the order of operands." msgstr "" -#: ../../library/stdtypes.rst:2725 +#: ../../library/stdtypes.rst:2726 msgid "" "The methods on bytes and bytearray objects don't accept strings as their " "arguments, just as the methods on strings don't accept bytes as their " "arguments. For example, you have to write::" msgstr "" -#: ../../library/stdtypes.rst:2732 +#: ../../library/stdtypes.rst:2733 msgid "and::" msgstr "和： ::" -#: ../../library/stdtypes.rst:2737 +#: ../../library/stdtypes.rst:2738 msgid "" "Some bytes and bytearray operations assume the use of ASCII compatible " "binary formats, and hence should be avoided when working with arbitrary " "binary data. These restrictions are covered below." msgstr "" -#: ../../library/stdtypes.rst:2742 +#: ../../library/stdtypes.rst:2743 msgid "" "Using these ASCII based operations to manipulate binary data that is not " "stored in an ASCII based format may lead to data corruption." msgstr "" -#: ../../library/stdtypes.rst:2745 +#: ../../library/stdtypes.rst:2746 msgid "" "The following methods on bytes and bytearray objects can be used with " "arbitrary binary data." msgstr "" -#: ../../library/stdtypes.rst:2751 +#: ../../library/stdtypes.rst:2752 msgid "" "Return the number of non-overlapping occurrences of subsequence *sub* in the " "range [*start*, *end*]. Optional arguments *start* and *end* are " "interpreted as in slice notation." msgstr "" -#: ../../library/stdtypes.rst:2755 ../../library/stdtypes.rst:2860 -#: ../../library/stdtypes.rst:2882 ../../library/stdtypes.rst:2948 -#: ../../library/stdtypes.rst:2961 +#: ../../library/stdtypes.rst:2756 ../../library/stdtypes.rst:2861 +#: ../../library/stdtypes.rst:2883 ../../library/stdtypes.rst:2949 +#: ../../library/stdtypes.rst:2962 msgid "" "The subsequence to search for may be any :term:`bytes-like object` or an " "integer in the range 0 to 255." msgstr "" -#: ../../library/stdtypes.rst:2758 +#: ../../library/stdtypes.rst:2759 msgid "" "If *sub* is empty, returns the number of empty slices between characters " "which is the length of the bytes object plus one." msgstr "" -#: ../../library/stdtypes.rst:2761 ../../library/stdtypes.rst:2872 -#: ../../library/stdtypes.rst:2885 ../../library/stdtypes.rst:2951 -#: ../../library/stdtypes.rst:2964 +#: ../../library/stdtypes.rst:2762 ../../library/stdtypes.rst:2873 +#: ../../library/stdtypes.rst:2886 ../../library/stdtypes.rst:2952 +#: ../../library/stdtypes.rst:2965 msgid "Also accept an integer in the range 0 to 255 as the subsequence." msgstr "" -#: ../../library/stdtypes.rst:2768 +#: ../../library/stdtypes.rst:2769 msgid "" "If the binary data starts with the *prefix* string, return " "``bytes[len(prefix):]``. Otherwise, return a copy of the original binary " "data::" msgstr "" -#: ../../library/stdtypes.rst:2777 +#: ../../library/stdtypes.rst:2778 msgid "The *prefix* may be any :term:`bytes-like object`." msgstr "" -#: ../../library/stdtypes.rst:2781 ../../library/stdtypes.rst:2803 -#: ../../library/stdtypes.rst:2936 ../../library/stdtypes.rst:3029 -#: ../../library/stdtypes.rst:3043 ../../library/stdtypes.rst:3074 -#: ../../library/stdtypes.rst:3088 ../../library/stdtypes.rst:3130 -#: ../../library/stdtypes.rst:3201 ../../library/stdtypes.rst:3219 -#: ../../library/stdtypes.rst:3247 ../../library/stdtypes.rst:3386 -#: ../../library/stdtypes.rst:3441 ../../library/stdtypes.rst:3484 -#: ../../library/stdtypes.rst:3505 ../../library/stdtypes.rst:3527 -#: ../../library/stdtypes.rst:3729 +#: ../../library/stdtypes.rst:2782 ../../library/stdtypes.rst:2804 +#: ../../library/stdtypes.rst:2937 ../../library/stdtypes.rst:3030 +#: ../../library/stdtypes.rst:3044 ../../library/stdtypes.rst:3075 +#: ../../library/stdtypes.rst:3089 ../../library/stdtypes.rst:3131 +#: ../../library/stdtypes.rst:3202 ../../library/stdtypes.rst:3220 +#: ../../library/stdtypes.rst:3248 ../../library/stdtypes.rst:3387 +#: ../../library/stdtypes.rst:3442 ../../library/stdtypes.rst:3485 +#: ../../library/stdtypes.rst:3506 ../../library/stdtypes.rst:3528 +#: ../../library/stdtypes.rst:3730 msgid "" "The bytearray version of this method does *not* operate in place - it always " "produces a new object, even if no changes were made." msgstr "" -#: ../../library/stdtypes.rst:2790 +#: ../../library/stdtypes.rst:2791 msgid "" "If the binary data ends with the *suffix* string and that *suffix* is not " "empty, return ``bytes[:-len(suffix)]``. Otherwise, return a copy of the " "original binary data::" msgstr "" -#: ../../library/stdtypes.rst:2799 +#: ../../library/stdtypes.rst:2800 msgid "The *suffix* may be any :term:`bytes-like object`." msgstr "" -#: ../../library/stdtypes.rst:2812 +#: ../../library/stdtypes.rst:2813 msgid "Return the bytes decoded to a :class:`str`." msgstr "" -#: ../../library/stdtypes.rst:2817 +#: ../../library/stdtypes.rst:2818 msgid "" "*errors* controls how decoding errors are handled. If ``'strict'`` (the " "default), a :exc:`UnicodeError` exception is raised. Other possible values " @@ -3724,21 +3724,21 @@ msgid "" "`codecs.register_error`. See :ref:`error-handlers` for details." msgstr "" -#: ../../library/stdtypes.rst:2823 +#: ../../library/stdtypes.rst:2824 msgid "" "For performance reasons, the value of *errors* is not checked for validity " "unless a decoding error actually occurs, :ref:`devmode` is enabled or a :ref:" "`debug build ` is used." msgstr "" -#: ../../library/stdtypes.rst:2829 +#: ../../library/stdtypes.rst:2830 msgid "" "Passing the *encoding* argument to :class:`str` allows decoding any :term:" "`bytes-like object` directly, without needing to make a temporary :class:`!" "bytes` or :class:`!bytearray` object." msgstr "" -#: ../../library/stdtypes.rst:2844 +#: ../../library/stdtypes.rst:2845 msgid "" "Return ``True`` if the binary data ends with the specified *suffix*, " "otherwise return ``False``. *suffix* can also be a tuple of suffixes to " @@ -3746,11 +3746,11 @@ msgid "" "optional *end*, stop comparing at that position." msgstr "" -#: ../../library/stdtypes.rst:2849 +#: ../../library/stdtypes.rst:2850 msgid "The suffix(es) to search for may be any :term:`bytes-like object`." msgstr "" -#: ../../library/stdtypes.rst:2855 +#: ../../library/stdtypes.rst:2856 msgid "" "Return the lowest index in the data where the subsequence *sub* is found, " "such that *sub* is contained in the slice ``s[start:end]``. Optional " @@ -3758,20 +3758,20 @@ msgid "" "``-1`` if *sub* is not found." msgstr "" -#: ../../library/stdtypes.rst:2865 +#: ../../library/stdtypes.rst:2866 msgid "" "The :meth:`~bytes.find` method should be used only if you need to know the " "position of *sub*. To check if *sub* is a substring or not, use the :" "keyword:`in` operator::" msgstr "" -#: ../../library/stdtypes.rst:2879 +#: ../../library/stdtypes.rst:2880 msgid "" "Like :meth:`~bytes.find`, but raise :exc:`ValueError` when the subsequence " "is not found." msgstr "" -#: ../../library/stdtypes.rst:2892 +#: ../../library/stdtypes.rst:2893 msgid "" "Return a bytes or bytearray object which is the concatenation of the binary " "data sequences in *iterable*. A :exc:`TypeError` will be raised if there " @@ -3781,7 +3781,7 @@ msgid "" "method." msgstr "" -#: ../../library/stdtypes.rst:2903 +#: ../../library/stdtypes.rst:2904 msgid "" "This static method returns a translation table usable for :meth:`bytes." "translate` that will map each character in *from* into the character at the " @@ -3789,7 +3789,7 @@ msgid "" "objects ` and have the same length." msgstr "" -#: ../../library/stdtypes.rst:2914 +#: ../../library/stdtypes.rst:2915 msgid "" "Split the sequence at the first occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself or its " @@ -3798,24 +3798,24 @@ msgid "" "by two empty bytes or bytearray objects." msgstr "" -#: ../../library/stdtypes.rst:2921 ../../library/stdtypes.rst:2978 +#: ../../library/stdtypes.rst:2922 ../../library/stdtypes.rst:2979 msgid "The separator to search for may be any :term:`bytes-like object`." msgstr "" -#: ../../library/stdtypes.rst:2927 +#: ../../library/stdtypes.rst:2928 msgid "" "Return a copy of the sequence with all occurrences of subsequence *old* " "replaced by *new*. If the optional argument *count* is given, only the " "first *count* occurrences are replaced." msgstr "" -#: ../../library/stdtypes.rst:2931 +#: ../../library/stdtypes.rst:2932 msgid "" "The subsequence to search for and its replacement may be any :term:`bytes-" "like object`." msgstr "" -#: ../../library/stdtypes.rst:2943 +#: ../../library/stdtypes.rst:2944 msgid "" "Return the highest index in the sequence where the subsequence *sub* is " "found, such that *sub* is contained within ``s[start:end]``. Optional " @@ -3823,13 +3823,13 @@ msgid "" "``-1`` on failure." msgstr "" -#: ../../library/stdtypes.rst:2958 +#: ../../library/stdtypes.rst:2959 msgid "" "Like :meth:`~bytes.rfind` but raises :exc:`ValueError` when the subsequence " "*sub* is not found." msgstr "" -#: ../../library/stdtypes.rst:2971 +#: ../../library/stdtypes.rst:2972 msgid "" "Split the sequence at the last occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself or its " @@ -3838,7 +3838,7 @@ msgid "" "followed by a copy of the original sequence." msgstr "" -#: ../../library/stdtypes.rst:2984 +#: ../../library/stdtypes.rst:2985 msgid "" "Return ``True`` if the binary data starts with the specified *prefix*, " "otherwise return ``False``. *prefix* can also be a tuple of prefixes to " @@ -3846,11 +3846,11 @@ msgid "" "optional *end*, stop comparing at that position." msgstr "" -#: ../../library/stdtypes.rst:2989 +#: ../../library/stdtypes.rst:2990 msgid "The prefix(es) to search for may be any :term:`bytes-like object`." msgstr "" -#: ../../library/stdtypes.rst:2995 +#: ../../library/stdtypes.rst:2996 msgid "" "Return a copy of the bytes or bytearray object where all bytes occurring in " "the optional argument *delete* are removed, and the remaining bytes have " @@ -3858,22 +3858,22 @@ msgid "" "object of length 256." msgstr "" -#: ../../library/stdtypes.rst:3000 +#: ../../library/stdtypes.rst:3001 msgid "" "You can use the :func:`bytes.maketrans` method to create a translation table." msgstr "" -#: ../../library/stdtypes.rst:3003 +#: ../../library/stdtypes.rst:3004 msgid "" "Set the *table* argument to ``None`` for translations that only delete " "characters::" msgstr "" -#: ../../library/stdtypes.rst:3009 +#: ../../library/stdtypes.rst:3010 msgid "*delete* is now supported as a keyword argument." msgstr "" -#: ../../library/stdtypes.rst:3013 +#: ../../library/stdtypes.rst:3014 msgid "" "The following methods on bytes and bytearray objects have default behaviours " "that assume the use of ASCII compatible binary formats, but can still be " @@ -3882,7 +3882,7 @@ msgid "" "instead produce new objects." msgstr "" -#: ../../library/stdtypes.rst:3022 +#: ../../library/stdtypes.rst:3023 msgid "" "Return a copy of the object centered in a sequence of length *width*. " "Padding is done using the specified *fillbyte* (default is an ASCII space). " @@ -3890,7 +3890,7 @@ msgid "" "less than or equal to ``len(s)``." msgstr "" -#: ../../library/stdtypes.rst:3036 +#: ../../library/stdtypes.rst:3037 msgid "" "Return a copy of the object left justified in a sequence of length *width*. " "Padding is done using the specified *fillbyte* (default is an ASCII space). " @@ -3898,7 +3898,7 @@ msgid "" "less than or equal to ``len(s)``." msgstr "" -#: ../../library/stdtypes.rst:3050 +#: ../../library/stdtypes.rst:3051 msgid "" "Return a copy of the sequence with specified leading bytes removed. The " "*chars* argument is a binary sequence specifying the set of byte values to " @@ -3908,14 +3908,14 @@ msgid "" "all combinations of its values are stripped::" msgstr "" -#: ../../library/stdtypes.rst:3062 +#: ../../library/stdtypes.rst:3063 msgid "" "The binary sequence of byte values to remove may be any :term:`bytes-like " "object`. See :meth:`~bytes.removeprefix` for a method that will remove a " "single prefix string rather than all of a set of characters. For example::" msgstr "" -#: ../../library/stdtypes.rst:3081 +#: ../../library/stdtypes.rst:3082 msgid "" "Return a copy of the object right justified in a sequence of length *width*. " "Padding is done using the specified *fillbyte* (default is an ASCII space). " @@ -3923,7 +3923,7 @@ msgid "" "less than or equal to ``len(s)``." msgstr "" -#: ../../library/stdtypes.rst:3095 +#: ../../library/stdtypes.rst:3096 msgid "" "Split the binary sequence into subsequences of the same type, using *sep* as " "the delimiter string. If *maxsplit* is given, at most *maxsplit* splits are " @@ -3933,7 +3933,7 @@ msgid "" "described in detail below." msgstr "" -#: ../../library/stdtypes.rst:3106 +#: ../../library/stdtypes.rst:3107 msgid "" "Return a copy of the sequence with specified trailing bytes removed. The " "*chars* argument is a binary sequence specifying the set of byte values to " @@ -3943,14 +3943,14 @@ msgid "" "all combinations of its values are stripped::" msgstr "" -#: ../../library/stdtypes.rst:3118 +#: ../../library/stdtypes.rst:3119 msgid "" "The binary sequence of byte values to remove may be any :term:`bytes-like " "object`. See :meth:`~bytes.removesuffix` for a method that will remove a " "single suffix string rather than all of a set of characters. For example::" msgstr "" -#: ../../library/stdtypes.rst:3137 +#: ../../library/stdtypes.rst:3138 msgid "" "Split the binary sequence into subsequences of the same type, using *sep* as " "the delimiter string. If *maxsplit* is given and non-negative, at most " @@ -3959,7 +3959,7 @@ msgid "" "limit on the number of splits (all possible splits are made)." msgstr "" -#: ../../library/stdtypes.rst:3143 +#: ../../library/stdtypes.rst:3144 msgid "" "If *sep* is given, consecutive delimiters are not grouped together and are " "deemed to delimit empty subsequences (for example, ``b'1,,2'.split(b',')`` " @@ -3970,7 +3970,7 @@ msgid "" "like object`." msgstr "" -#: ../../library/stdtypes.rst:3162 +#: ../../library/stdtypes.rst:3163 msgid "" "If *sep* is not specified or is ``None``, a different splitting algorithm is " "applied: runs of consecutive ASCII whitespace are regarded as a single " @@ -3980,7 +3980,7 @@ msgid "" "without a specified separator returns ``[]``." msgstr "" -#: ../../library/stdtypes.rst:3183 +#: ../../library/stdtypes.rst:3184 msgid "" "Return a copy of the sequence with specified leading and trailing bytes " "removed. The *chars* argument is a binary sequence specifying the set of " @@ -3990,13 +3990,13 @@ msgid "" "a prefix or suffix; rather, all combinations of its values are stripped::" msgstr "" -#: ../../library/stdtypes.rst:3196 +#: ../../library/stdtypes.rst:3197 msgid "" "The binary sequence of byte values to remove may be any :term:`bytes-like " "object`." msgstr "" -#: ../../library/stdtypes.rst:3205 +#: ../../library/stdtypes.rst:3206 msgid "" "The following methods on bytes and bytearray objects assume the use of ASCII " "compatible binary formats and should not be applied to arbitrary binary " @@ -4004,14 +4004,14 @@ msgid "" "operate in place, and instead produce new objects." msgstr "" -#: ../../library/stdtypes.rst:3213 +#: ../../library/stdtypes.rst:3214 msgid "" "Return a copy of the sequence with each byte interpreted as an ASCII " "character, and the first byte capitalized and the rest lowercased. Non-ASCII " "byte values are passed through unchanged." msgstr "" -#: ../../library/stdtypes.rst:3226 +#: ../../library/stdtypes.rst:3227 msgid "" "Return a copy of the sequence where all ASCII tab characters are replaced by " "one or more ASCII spaces, depending on the current column and the given tab " @@ -4027,7 +4027,7 @@ msgid "" "by one regardless of how the byte value is represented when printed::" msgstr "" -#: ../../library/stdtypes.rst:3254 +#: ../../library/stdtypes.rst:3255 msgid "" "Return ``True`` if all bytes in the sequence are alphabetical ASCII " "characters or ASCII decimal digits and the sequence is not empty, ``False`` " @@ -4036,7 +4036,7 @@ msgid "" "digits are those byte values in the sequence ``b'0123456789'``." msgstr "" -#: ../../library/stdtypes.rst:3271 +#: ../../library/stdtypes.rst:3272 msgid "" "Return ``True`` if all bytes in the sequence are alphabetic ASCII characters " "and the sequence is not empty, ``False`` otherwise. Alphabetic ASCII " @@ -4044,35 +4044,35 @@ msgid "" "``b'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'``." msgstr "" -#: ../../library/stdtypes.rst:3287 +#: ../../library/stdtypes.rst:3288 msgid "" "Return ``True`` if the sequence is empty or all bytes in the sequence are " "ASCII, ``False`` otherwise. ASCII bytes are in the range 0-0x7F." msgstr "" -#: ../../library/stdtypes.rst:3297 +#: ../../library/stdtypes.rst:3298 msgid "" "Return ``True`` if all bytes in the sequence are ASCII decimal digits and " "the sequence is not empty, ``False`` otherwise. ASCII decimal digits are " "those byte values in the sequence ``b'0123456789'``." msgstr "" -#: ../../library/stdtypes.rst:3312 +#: ../../library/stdtypes.rst:3313 msgid "" "Return ``True`` if there is at least one lowercase ASCII character in the " "sequence and no uppercase ASCII characters, ``False`` otherwise." msgstr "" -#: ../../library/stdtypes.rst:3322 ../../library/stdtypes.rst:3364 -#: ../../library/stdtypes.rst:3380 ../../library/stdtypes.rst:3430 -#: ../../library/stdtypes.rst:3499 +#: ../../library/stdtypes.rst:3323 ../../library/stdtypes.rst:3365 +#: ../../library/stdtypes.rst:3381 ../../library/stdtypes.rst:3431 +#: ../../library/stdtypes.rst:3500 msgid "" "Lowercase ASCII characters are those byte values in the sequence " "``b'abcdefghijklmnopqrstuvwxyz'``. Uppercase ASCII characters are those byte " "values in the sequence ``b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'``." msgstr "" -#: ../../library/stdtypes.rst:3330 +#: ../../library/stdtypes.rst:3331 msgid "" "Return ``True`` if all bytes in the sequence are ASCII whitespace and the " "sequence is not empty, ``False`` otherwise. ASCII whitespace characters are " @@ -4080,27 +4080,27 @@ msgid "" "newline, carriage return, vertical tab, form feed)." msgstr "" -#: ../../library/stdtypes.rst:3339 +#: ../../library/stdtypes.rst:3340 msgid "" "Return ``True`` if the sequence is ASCII titlecase and the sequence is not " "empty, ``False`` otherwise. See :meth:`bytes.title` for more details on the " "definition of \"titlecase\"." msgstr "" -#: ../../library/stdtypes.rst:3354 +#: ../../library/stdtypes.rst:3355 msgid "" "Return ``True`` if there is at least one uppercase alphabetic ASCII " "character in the sequence and no lowercase ASCII characters, ``False`` " "otherwise." msgstr "" -#: ../../library/stdtypes.rst:3372 +#: ../../library/stdtypes.rst:3373 msgid "" "Return a copy of the sequence with all the uppercase ASCII characters " "converted to their corresponding lowercase counterpart." msgstr "" -#: ../../library/stdtypes.rst:3397 +#: ../../library/stdtypes.rst:3398 msgid "" "Return a list of the lines in the binary sequence, breaking at ASCII line " "boundaries. This method uses the :term:`universal newlines` approach to " @@ -4108,20 +4108,20 @@ msgid "" "*keepends* is given and true." msgstr "" -#: ../../library/stdtypes.rst:3409 +#: ../../library/stdtypes.rst:3410 msgid "" "Unlike :meth:`~bytes.split` when a delimiter string *sep* is given, this " "method returns an empty list for the empty string, and a terminal line break " "does not result in an extra line::" msgstr "" -#: ../../library/stdtypes.rst:3422 +#: ../../library/stdtypes.rst:3423 msgid "" "Return a copy of the sequence with all the lowercase ASCII characters " "converted to their corresponding uppercase counterpart and vice-versa." msgstr "" -#: ../../library/stdtypes.rst:3434 +#: ../../library/stdtypes.rst:3435 msgid "" "Unlike :func:`str.swapcase()`, it is always the case that ``bin.swapcase()." "swapcase() == bin`` for the binary versions. Case conversions are " @@ -4129,14 +4129,14 @@ msgid "" "Unicode code points." msgstr "" -#: ../../library/stdtypes.rst:3448 +#: ../../library/stdtypes.rst:3449 msgid "" "Return a titlecased version of the binary sequence where words start with an " "uppercase ASCII character and the remaining characters are lowercase. " "Uncased byte values are left unmodified." msgstr "" -#: ../../library/stdtypes.rst:3457 +#: ../../library/stdtypes.rst:3458 msgid "" "Lowercase ASCII characters are those byte values in the sequence " "``b'abcdefghijklmnopqrstuvwxyz'``. Uppercase ASCII characters are those byte " @@ -4144,18 +4144,18 @@ msgid "" "values are uncased." msgstr "" -#: ../../library/stdtypes.rst:3470 +#: ../../library/stdtypes.rst:3471 msgid "" "A workaround for apostrophes can be constructed using regular expressions::" msgstr "" -#: ../../library/stdtypes.rst:3491 +#: ../../library/stdtypes.rst:3492 msgid "" "Return a copy of the sequence with all the lowercase ASCII characters " "converted to their corresponding uppercase counterpart." msgstr "" -#: ../../library/stdtypes.rst:3512 +#: ../../library/stdtypes.rst:3513 msgid "" "Return a copy of the sequence left filled with ASCII ``b'0'`` digits to make " "a sequence of length *width*. A leading sign prefix (``b'+'``/ ``b'-'``) is " @@ -4164,11 +4164,11 @@ msgid "" "*width* is less than or equal to ``len(seq)``." msgstr "" -#: ../../library/stdtypes.rst:3534 +#: ../../library/stdtypes.rst:3535 msgid "``printf``-style Bytes Formatting" msgstr "" -#: ../../library/stdtypes.rst:3551 +#: ../../library/stdtypes.rst:3552 msgid "" "The formatting operations described here exhibit a variety of quirks that " "lead to a number of common errors (such as failing to display tuples and " @@ -4176,7 +4176,7 @@ msgid "" "dictionary, wrap it in a tuple." msgstr "" -#: ../../library/stdtypes.rst:3556 +#: ../../library/stdtypes.rst:3557 msgid "" "Bytes objects (``bytes``/``bytearray``) have one unique built-in operation: " "the ``%`` operator (modulo). This is also known as the bytes *formatting* or " @@ -4186,7 +4186,7 @@ msgid "" "func:`sprintf` in the C language." msgstr "" -#: ../../library/stdtypes.rst:3563 +#: ../../library/stdtypes.rst:3564 msgid "" "If *format* requires a single argument, *values* may be a single non-tuple " "object. [5]_ Otherwise, *values* must be a tuple with exactly the number of " @@ -4194,7 +4194,7 @@ msgid "" "example, a dictionary)." msgstr "" -#: ../../library/stdtypes.rst:3597 +#: ../../library/stdtypes.rst:3598 msgid "" "When the right argument is a dictionary (or other mapping type), then the " "formats in the bytes object *must* include a parenthesised mapping key into " @@ -4202,73 +4202,73 @@ msgid "" "mapping key selects the value to be formatted from the mapping. For example:" msgstr "" -#: ../../library/stdtypes.rst:3671 +#: ../../library/stdtypes.rst:3672 msgid "Single byte (accepts integer or single byte objects)." msgstr "" -#: ../../library/stdtypes.rst:3674 +#: ../../library/stdtypes.rst:3675 msgid "``'b'``" msgstr "``'b'``" -#: ../../library/stdtypes.rst:3674 +#: ../../library/stdtypes.rst:3675 msgid "" "Bytes (any object that follows the :ref:`buffer protocol ` or " "has :meth:`~object.__bytes__`)." msgstr "" -#: ../../library/stdtypes.rst:3678 +#: ../../library/stdtypes.rst:3679 msgid "" "``'s'`` is an alias for ``'b'`` and should only be used for Python2/3 code " "bases." msgstr "" -#: ../../library/stdtypes.rst:3681 +#: ../../library/stdtypes.rst:3682 msgid "" "Bytes (converts any Python object using ``repr(obj).encode('ascii', " "'backslashreplace')``)." msgstr "" -#: ../../library/stdtypes.rst:3684 +#: ../../library/stdtypes.rst:3685 msgid "" "``'r'`` is an alias for ``'a'`` and should only be used for Python2/3 code " "bases." msgstr "" -#: ../../library/stdtypes.rst:3684 +#: ../../library/stdtypes.rst:3685 msgid "\\(7)" msgstr "\\(7)" -#: ../../library/stdtypes.rst:3719 +#: ../../library/stdtypes.rst:3720 msgid "``b'%s'`` is deprecated, but will not be removed during the 3.x series." msgstr "" -#: ../../library/stdtypes.rst:3722 +#: ../../library/stdtypes.rst:3723 msgid "``b'%r'`` is deprecated, but will not be removed during the 3.x series." msgstr "" -#: ../../library/stdtypes.rst:3734 +#: ../../library/stdtypes.rst:3735 msgid ":pep:`461` - Adding % formatting to bytes and bytearray" msgstr "" -#: ../../library/stdtypes.rst:3741 +#: ../../library/stdtypes.rst:3742 msgid "Memory Views" msgstr "" -#: ../../library/stdtypes.rst:3743 +#: ../../library/stdtypes.rst:3744 msgid "" ":class:`memoryview` objects allow Python code to access the internal data of " "an object that supports the :ref:`buffer protocol ` without " "copying." msgstr "" -#: ../../library/stdtypes.rst:3749 +#: ../../library/stdtypes.rst:3750 msgid "" "Create a :class:`memoryview` that references *object*. *object* must " "support the buffer protocol. Built-in objects that support the buffer " "protocol include :class:`bytes` and :class:`bytearray`." msgstr "" -#: ../../library/stdtypes.rst:3753 +#: ../../library/stdtypes.rst:3754 msgid "" "A :class:`memoryview` has the notion of an *element*, which is the atomic " "memory unit handled by the originating *object*. For many simple types such " @@ -4276,32 +4276,32 @@ msgid "" "other types such as :class:`array.array` may have bigger elements." msgstr "" -#: ../../library/stdtypes.rst:3758 +#: ../../library/stdtypes.rst:3759 msgid "" "``len(view)`` is equal to the length of :class:`~memoryview.tolist`, which " "is the nested list representation of the view. If ``view.ndim = 1``, this is " "equal to the number of elements in the view." msgstr "" -#: ../../library/stdtypes.rst:3762 +#: ../../library/stdtypes.rst:3763 msgid "" "If ``view.ndim == 0``, ``len(view)`` now raises :exc:`TypeError` instead of " "returning 1." msgstr "" -#: ../../library/stdtypes.rst:3765 +#: ../../library/stdtypes.rst:3766 msgid "" "The :class:`~memoryview.itemsize` attribute will give you the number of " "bytes in a single element." msgstr "" -#: ../../library/stdtypes.rst:3768 +#: ../../library/stdtypes.rst:3769 msgid "" "A :class:`memoryview` supports slicing and indexing to expose its data. One-" "dimensional slicing will result in a subview::" msgstr "" -#: ../../library/stdtypes.rst:3781 +#: ../../library/stdtypes.rst:3782 msgid "" "If :class:`~memoryview.format` is one of the native format specifiers from " "the :mod:`struct` module, indexing with an integer or a tuple of integers is " @@ -4312,82 +4312,82 @@ msgid "" "memoryviews can be indexed with the empty tuple." msgstr "" -#: ../../library/stdtypes.rst:3790 +#: ../../library/stdtypes.rst:3791 msgid "Here is an example with a non-byte format::" msgstr "" -#: ../../library/stdtypes.rst:3802 +#: ../../library/stdtypes.rst:3803 msgid "" "If the underlying object is writable, the memoryview supports one-" "dimensional slice assignment. Resizing is not allowed::" msgstr "" -#: ../../library/stdtypes.rst:3823 +#: ../../library/stdtypes.rst:3824 msgid "" "One-dimensional memoryviews of :term:`hashable` (read-only) types with " "formats 'B', 'b' or 'c' are also hashable. The hash is defined as ``hash(m) " "== hash(m.tobytes())``::" msgstr "" -#: ../../library/stdtypes.rst:3835 +#: ../../library/stdtypes.rst:3836 msgid "" "One-dimensional memoryviews can now be sliced. One-dimensional memoryviews " "with formats 'B', 'b' or 'c' are now :term:`hashable`." msgstr "" -#: ../../library/stdtypes.rst:3839 +#: ../../library/stdtypes.rst:3840 msgid "" "memoryview is now registered automatically with :class:`collections.abc." "Sequence`" msgstr "" -#: ../../library/stdtypes.rst:3843 +#: ../../library/stdtypes.rst:3844 msgid "memoryviews can now be indexed with tuple of integers." msgstr "" -#: ../../library/stdtypes.rst:3846 +#: ../../library/stdtypes.rst:3847 msgid ":class:`memoryview` has several methods:" msgstr "" -#: ../../library/stdtypes.rst:3850 +#: ../../library/stdtypes.rst:3851 msgid "" "A memoryview and a :pep:`3118` exporter are equal if their shapes are " "equivalent and if all corresponding values are equal when the operands' " "respective format codes are interpreted using :mod:`struct` syntax." msgstr "" -#: ../../library/stdtypes.rst:3854 +#: ../../library/stdtypes.rst:3855 msgid "" "For the subset of :mod:`struct` format strings currently supported by :meth:" "`tolist`, ``v`` and ``w`` are equal if ``v.tolist() == w.tolist()``::" msgstr "" -#: ../../library/stdtypes.rst:3873 +#: ../../library/stdtypes.rst:3874 msgid "" "If either format string is not supported by the :mod:`struct` module, then " "the objects will always compare as unequal (even if the format strings and " "buffer contents are identical)::" msgstr "" -#: ../../library/stdtypes.rst:3889 +#: ../../library/stdtypes.rst:3890 msgid "" "Note that, as with floating-point numbers, ``v is w`` does *not* imply ``v " "== w`` for memoryview objects." msgstr "" -#: ../../library/stdtypes.rst:3892 +#: ../../library/stdtypes.rst:3893 msgid "" "Previous versions compared the raw memory disregarding the item format and " "the logical array structure." msgstr "" -#: ../../library/stdtypes.rst:3898 +#: ../../library/stdtypes.rst:3899 msgid "" "Return the data in the buffer as a bytestring. This is equivalent to " "calling the :class:`bytes` constructor on the memoryview. ::" msgstr "" -#: ../../library/stdtypes.rst:3907 +#: ../../library/stdtypes.rst:3908 msgid "" "For non-contiguous arrays the result is equal to the flattened list " "representation with all elements converted to bytes. :meth:`tobytes` " @@ -4395,7 +4395,7 @@ msgid "" "module syntax." msgstr "" -#: ../../library/stdtypes.rst:3912 +#: ../../library/stdtypes.rst:3913 msgid "" "*order* can be {'C', 'F', 'A'}. When *order* is 'C' or 'F', the data of the " "original array is converted to C or Fortran order. For contiguous views, 'A' " @@ -4404,36 +4404,36 @@ msgid "" "to C first. *order=None* is the same as *order='C'*." msgstr "" -#: ../../library/stdtypes.rst:3921 +#: ../../library/stdtypes.rst:3922 msgid "" "Return a string object containing two hexadecimal digits for each byte in " "the buffer. ::" msgstr "" -#: ../../library/stdtypes.rst:3930 +#: ../../library/stdtypes.rst:3931 msgid "" "Similar to :meth:`bytes.hex`, :meth:`memoryview.hex` now supports optional " "*sep* and *bytes_per_sep* parameters to insert separators between bytes in " "the hex output." msgstr "" -#: ../../library/stdtypes.rst:3937 +#: ../../library/stdtypes.rst:3938 msgid "Return the data in the buffer as a list of elements. ::" msgstr "" -#: ../../library/stdtypes.rst:3947 +#: ../../library/stdtypes.rst:3948 msgid "" ":meth:`tolist` now supports all single character native formats in :mod:" "`struct` module syntax as well as multi-dimensional representations." msgstr "" -#: ../../library/stdtypes.rst:3954 +#: ../../library/stdtypes.rst:3955 msgid "" "Return a readonly version of the memoryview object. The original memoryview " "object is unchanged. ::" msgstr "" -#: ../../library/stdtypes.rst:3973 +#: ../../library/stdtypes.rst:3974 msgid "" "Release the underlying buffer exposed by the memoryview object. Many " "objects take special actions when a view is held on them (for example, a :" @@ -4442,20 +4442,20 @@ msgid "" "resources) as soon as possible." msgstr "" -#: ../../library/stdtypes.rst:3979 +#: ../../library/stdtypes.rst:3980 msgid "" "After this method has been called, any further operation on the view raises " "a :class:`ValueError` (except :meth:`release()` itself which can be called " "multiple times)::" msgstr "" -#: ../../library/stdtypes.rst:3990 +#: ../../library/stdtypes.rst:3991 msgid "" "The context management protocol can be used for a similar effect, using the " "``with`` statement::" msgstr "" -#: ../../library/stdtypes.rst:4006 +#: ../../library/stdtypes.rst:4007 msgid "" "Cast a memoryview to a new format or shape. *shape* defaults to " "``[byte_length//new_itemsize]``, which means that the result view will be " @@ -4464,7 +4464,7 @@ msgid "" "contiguous -> 1D." msgstr "" -#: ../../library/stdtypes.rst:4012 +#: ../../library/stdtypes.rst:4013 msgid "" "The destination format is restricted to a single element native format in :" "mod:`struct` syntax. One of the formats must be a byte format ('B', 'b' or " @@ -4472,50 +4472,50 @@ msgid "" "Note that all byte lengths may depend on the operating system." msgstr "" -#: ../../library/stdtypes.rst:4018 +#: ../../library/stdtypes.rst:4019 msgid "Cast 1D/long to 1D/unsigned bytes::" msgstr "" -#: ../../library/stdtypes.rst:4041 +#: ../../library/stdtypes.rst:4042 msgid "Cast 1D/unsigned bytes to 1D/char::" msgstr "" -#: ../../library/stdtypes.rst:4054 +#: ../../library/stdtypes.rst:4055 msgid "Cast 1D/bytes to 3D/ints to 1D/signed char::" msgstr "" -#: ../../library/stdtypes.rst:4080 +#: ../../library/stdtypes.rst:4081 msgid "Cast 1D/unsigned long to 2D/unsigned long::" msgstr "" -#: ../../library/stdtypes.rst:4094 +#: ../../library/stdtypes.rst:4095 msgid "The source format is no longer restricted when casting to a byte view." msgstr "" -#: ../../library/stdtypes.rst:4097 +#: ../../library/stdtypes.rst:4098 msgid "There are also several readonly attributes available:" msgstr "" -#: ../../library/stdtypes.rst:4101 +#: ../../library/stdtypes.rst:4102 msgid "The underlying object of the memoryview::" msgstr "" -#: ../../library/stdtypes.rst:4112 +#: ../../library/stdtypes.rst:4113 msgid "" "``nbytes == product(shape) * itemsize == len(m.tobytes())``. This is the " "amount of space in bytes that the array would use in a contiguous " "representation. It is not necessarily equal to ``len(m)``::" msgstr "" -#: ../../library/stdtypes.rst:4131 +#: ../../library/stdtypes.rst:4132 msgid "Multi-dimensional arrays::" msgstr "" -#: ../../library/stdtypes.rst:4148 +#: ../../library/stdtypes.rst:4149 msgid "A bool indicating whether the memory is read only." msgstr "" -#: ../../library/stdtypes.rst:4152 +#: ../../library/stdtypes.rst:4153 msgid "" "A string containing the format (in :mod:`struct` module style) for each " "element in the view. A memoryview can be created from exporters with " @@ -4523,59 +4523,59 @@ msgid "" "restricted to native single element formats." msgstr "" -#: ../../library/stdtypes.rst:4157 +#: ../../library/stdtypes.rst:4158 msgid "" "format ``'B'`` is now handled according to the struct module syntax. This " "means that ``memoryview(b'abc')[0] == b'abc'[0] == 97``." msgstr "" -#: ../../library/stdtypes.rst:4163 +#: ../../library/stdtypes.rst:4164 msgid "The size in bytes of each element of the memoryview::" msgstr "" -#: ../../library/stdtypes.rst:4176 +#: ../../library/stdtypes.rst:4177 msgid "" "An integer indicating how many dimensions of a multi-dimensional array the " "memory represents." msgstr "" -#: ../../library/stdtypes.rst:4181 +#: ../../library/stdtypes.rst:4182 msgid "" "A tuple of integers the length of :attr:`ndim` giving the shape of the " "memory as an N-dimensional array." msgstr "" -#: ../../library/stdtypes.rst:4184 ../../library/stdtypes.rst:4192 +#: ../../library/stdtypes.rst:4185 ../../library/stdtypes.rst:4193 msgid "An empty tuple instead of ``None`` when ndim = 0." msgstr "" -#: ../../library/stdtypes.rst:4189 +#: ../../library/stdtypes.rst:4190 msgid "" "A tuple of integers the length of :attr:`ndim` giving the size in bytes to " "access each element for each dimension of the array." msgstr "" -#: ../../library/stdtypes.rst:4197 +#: ../../library/stdtypes.rst:4198 msgid "Used internally for PIL-style arrays. The value is informational only." msgstr "" -#: ../../library/stdtypes.rst:4201 +#: ../../library/stdtypes.rst:4202 msgid "A bool indicating whether the memory is C-:term:`contiguous`." msgstr "" -#: ../../library/stdtypes.rst:4207 +#: ../../library/stdtypes.rst:4208 msgid "A bool indicating whether the memory is Fortran :term:`contiguous`." msgstr "" -#: ../../library/stdtypes.rst:4213 +#: ../../library/stdtypes.rst:4214 msgid "A bool indicating whether the memory is :term:`contiguous`." msgstr "" -#: ../../library/stdtypes.rst:4221 +#: ../../library/stdtypes.rst:4222 msgid "Set Types --- :class:`set`, :class:`frozenset`" msgstr "" -#: ../../library/stdtypes.rst:4225 +#: ../../library/stdtypes.rst:4226 msgid "" "A :dfn:`set` object is an unordered collection of distinct :term:`hashable` " "objects. Common uses include membership testing, removing duplicates from a " @@ -4585,7 +4585,7 @@ msgid "" "`collections` module.)" msgstr "" -#: ../../library/stdtypes.rst:4232 +#: ../../library/stdtypes.rst:4233 msgid "" "Like other collections, sets support ``x in set``, ``len(set)``, and ``for x " "in set``. Being an unordered collection, sets do not record element " @@ -4593,7 +4593,7 @@ msgid "" "slicing, or other sequence-like behavior." msgstr "" -#: ../../library/stdtypes.rst:4237 +#: ../../library/stdtypes.rst:4238 msgid "" "There are currently two built-in set types, :class:`set` and :class:" "`frozenset`. The :class:`set` type is mutable --- the contents can be " @@ -4605,18 +4605,18 @@ msgid "" "of another set." msgstr "" -#: ../../library/stdtypes.rst:4245 +#: ../../library/stdtypes.rst:4246 msgid "" "Non-empty sets (not frozensets) can be created by placing a comma-separated " "list of elements within braces, for example: ``{'jack', 'sjoerd'}``, in " "addition to the :class:`set` constructor." msgstr "" -#: ../../library/stdtypes.rst:4249 +#: ../../library/stdtypes.rst:4250 msgid "The constructors for both classes work the same:" msgstr "" -#: ../../library/stdtypes.rst:4254 +#: ../../library/stdtypes.rst:4255 msgid "" "Return a new set or frozenset object whose elements are taken from " "*iterable*. The elements of a set must be :term:`hashable`. To represent " @@ -4624,92 +4624,92 @@ msgid "" "*iterable* is not specified, a new empty set is returned." msgstr "" -#: ../../library/stdtypes.rst:4260 +#: ../../library/stdtypes.rst:4261 msgid "Sets can be created by several means:" msgstr "" -#: ../../library/stdtypes.rst:4262 +#: ../../library/stdtypes.rst:4263 msgid "" "Use a comma-separated list of elements within braces: ``{'jack', 'sjoerd'}``" msgstr "" -#: ../../library/stdtypes.rst:4263 +#: ../../library/stdtypes.rst:4264 msgid "" "Use a set comprehension: ``{c for c in 'abracadabra' if c not in 'abc'}``" msgstr "" -#: ../../library/stdtypes.rst:4264 +#: ../../library/stdtypes.rst:4265 msgid "" "Use the type constructor: ``set()``, ``set('foobar')``, ``set(['a', 'b', " "'foo'])``" msgstr "" -#: ../../library/stdtypes.rst:4266 +#: ../../library/stdtypes.rst:4267 msgid "" "Instances of :class:`set` and :class:`frozenset` provide the following " "operations:" msgstr "" -#: ../../library/stdtypes.rst:4271 +#: ../../library/stdtypes.rst:4272 msgid "Return the number of elements in set *s* (cardinality of *s*)." msgstr "" -#: ../../library/stdtypes.rst:4275 +#: ../../library/stdtypes.rst:4276 msgid "Test *x* for membership in *s*." msgstr "" -#: ../../library/stdtypes.rst:4279 +#: ../../library/stdtypes.rst:4280 msgid "Test *x* for non-membership in *s*." msgstr "" -#: ../../library/stdtypes.rst:4283 +#: ../../library/stdtypes.rst:4284 msgid "" "Return ``True`` if the set has no elements in common with *other*. Sets are " "disjoint if and only if their intersection is the empty set." msgstr "" -#: ../../library/stdtypes.rst:4289 +#: ../../library/stdtypes.rst:4290 msgid "Test whether every element in the set is in *other*." msgstr "" -#: ../../library/stdtypes.rst:4293 +#: ../../library/stdtypes.rst:4294 msgid "" "Test whether the set is a proper subset of *other*, that is, ``set <= other " "and set != other``." msgstr "" -#: ../../library/stdtypes.rst:4299 +#: ../../library/stdtypes.rst:4300 msgid "Test whether every element in *other* is in the set." msgstr "" -#: ../../library/stdtypes.rst:4303 +#: ../../library/stdtypes.rst:4304 msgid "" "Test whether the set is a proper superset of *other*, that is, ``set >= " "other and set != other``." msgstr "" -#: ../../library/stdtypes.rst:4309 +#: ../../library/stdtypes.rst:4310 msgid "Return a new set with elements from the set and all others." msgstr "" -#: ../../library/stdtypes.rst:4314 +#: ../../library/stdtypes.rst:4315 msgid "Return a new set with elements common to the set and all others." msgstr "" -#: ../../library/stdtypes.rst:4319 +#: ../../library/stdtypes.rst:4320 msgid "Return a new set with elements in the set that are not in the others." msgstr "" -#: ../../library/stdtypes.rst:4324 +#: ../../library/stdtypes.rst:4325 msgid "" "Return a new set with elements in either the set or *other* but not both." msgstr "" -#: ../../library/stdtypes.rst:4328 +#: ../../library/stdtypes.rst:4329 msgid "Return a shallow copy of the set." msgstr "" -#: ../../library/stdtypes.rst:4331 +#: ../../library/stdtypes.rst:4332 msgid "" "Note, the non-operator versions of :meth:`union`, :meth:`intersection`, :" "meth:`difference`, :meth:`symmetric_difference`, :meth:`issubset`, and :meth:" @@ -4719,7 +4719,7 @@ msgid "" "the more readable ``set('abc').intersection('cbs')``." msgstr "" -#: ../../library/stdtypes.rst:4338 +#: ../../library/stdtypes.rst:4339 msgid "" "Both :class:`set` and :class:`frozenset` support set to set comparisons. Two " "sets are equal if and only if every element of each set is contained in the " @@ -4729,14 +4729,14 @@ msgid "" "set is a proper superset of the second set (is a superset, but is not equal)." msgstr "" -#: ../../library/stdtypes.rst:4345 +#: ../../library/stdtypes.rst:4346 msgid "" "Instances of :class:`set` are compared to instances of :class:`frozenset` " "based on their members. For example, ``set('abc') == frozenset('abc')`` " "returns ``True`` and so does ``set('abc') in set([frozenset('abc')])``." msgstr "" -#: ../../library/stdtypes.rst:4349 +#: ../../library/stdtypes.rst:4350 msgid "" "The subset and equality comparisons do not generalize to a total ordering " "function. For example, any two nonempty disjoint sets are not equal and are " @@ -4744,71 +4744,71 @@ msgid "" "``ab``." msgstr "" -#: ../../library/stdtypes.rst:4354 +#: ../../library/stdtypes.rst:4355 msgid "" "Since sets only define partial ordering (subset relationships), the output " "of the :meth:`list.sort` method is undefined for lists of sets." msgstr "" -#: ../../library/stdtypes.rst:4357 +#: ../../library/stdtypes.rst:4358 msgid "Set elements, like dictionary keys, must be :term:`hashable`." msgstr "" -#: ../../library/stdtypes.rst:4359 +#: ../../library/stdtypes.rst:4360 msgid "" "Binary operations that mix :class:`set` instances with :class:`frozenset` " "return the type of the first operand. For example: ``frozenset('ab') | " "set('bc')`` returns an instance of :class:`frozenset`." msgstr "" -#: ../../library/stdtypes.rst:4363 +#: ../../library/stdtypes.rst:4364 msgid "" "The following table lists operations available for :class:`set` that do not " "apply to immutable instances of :class:`frozenset`:" msgstr "" -#: ../../library/stdtypes.rst:4369 +#: ../../library/stdtypes.rst:4370 msgid "Update the set, adding elements from all others." msgstr "" -#: ../../library/stdtypes.rst:4374 +#: ../../library/stdtypes.rst:4375 msgid "Update the set, keeping only elements found in it and all others." msgstr "" -#: ../../library/stdtypes.rst:4379 +#: ../../library/stdtypes.rst:4380 msgid "Update the set, removing elements found in others." msgstr "" -#: ../../library/stdtypes.rst:4384 +#: ../../library/stdtypes.rst:4385 msgid "" "Update the set, keeping only elements found in either set, but not in both." msgstr "" -#: ../../library/stdtypes.rst:4388 +#: ../../library/stdtypes.rst:4389 msgid "Add element *elem* to the set." msgstr "" -#: ../../library/stdtypes.rst:4392 +#: ../../library/stdtypes.rst:4393 msgid "" "Remove element *elem* from the set. Raises :exc:`KeyError` if *elem* is not " "contained in the set." msgstr "" -#: ../../library/stdtypes.rst:4397 +#: ../../library/stdtypes.rst:4398 msgid "Remove element *elem* from the set if it is present." msgstr "" -#: ../../library/stdtypes.rst:4401 +#: ../../library/stdtypes.rst:4402 msgid "" "Remove and return an arbitrary element from the set. Raises :exc:`KeyError` " "if the set is empty." msgstr "" -#: ../../library/stdtypes.rst:4406 +#: ../../library/stdtypes.rst:4407 msgid "Remove all elements from the set." msgstr "" -#: ../../library/stdtypes.rst:4409 +#: ../../library/stdtypes.rst:4410 msgid "" "Note, the non-operator versions of the :meth:`update`, :meth:" "`intersection_update`, :meth:`difference_update`, and :meth:" @@ -4816,18 +4816,18 @@ msgid "" "argument." msgstr "" -#: ../../library/stdtypes.rst:4414 +#: ../../library/stdtypes.rst:4415 msgid "" "Note, the *elem* argument to the :meth:`~object.__contains__`, :meth:" "`remove`, and :meth:`discard` methods may be a set. To support searching " "for an equivalent frozenset, a temporary one is created from *elem*." msgstr "" -#: ../../library/stdtypes.rst:4423 +#: ../../library/stdtypes.rst:4424 msgid "Mapping Types --- :class:`dict`" msgstr "" -#: ../../library/stdtypes.rst:4433 +#: ../../library/stdtypes.rst:4434 msgid "" "A :term:`mapping` object maps :term:`hashable` values to arbitrary objects. " "Mappings are mutable objects. There is currently only one standard mapping " @@ -4836,7 +4836,7 @@ msgid "" "module.)" msgstr "" -#: ../../library/stdtypes.rst:4439 +#: ../../library/stdtypes.rst:4440 msgid "" "A dictionary's keys are *almost* arbitrary values. Values that are not :" "term:`hashable`, that is, values containing lists, dictionaries or other " @@ -4845,33 +4845,33 @@ msgid "" "and ``True``) can be used interchangeably to index the same dictionary entry." msgstr "" -#: ../../library/stdtypes.rst:4450 +#: ../../library/stdtypes.rst:4451 msgid "" "Return a new dictionary initialized from an optional positional argument and " "a possibly empty set of keyword arguments." msgstr "" -#: ../../library/stdtypes.rst:4453 +#: ../../library/stdtypes.rst:4454 msgid "Dictionaries can be created by several means:" msgstr "" -#: ../../library/stdtypes.rst:4455 +#: ../../library/stdtypes.rst:4456 msgid "" "Use a comma-separated list of ``key: value`` pairs within braces: ``{'jack': " "4098, 'sjoerd': 4127}`` or ``{4098: 'jack', 4127: 'sjoerd'}``" msgstr "" -#: ../../library/stdtypes.rst:4457 +#: ../../library/stdtypes.rst:4458 msgid "Use a dict comprehension: ``{}``, ``{x: x ** 2 for x in range(10)}``" msgstr "" -#: ../../library/stdtypes.rst:4458 +#: ../../library/stdtypes.rst:4459 msgid "" "Use the type constructor: ``dict()``, ``dict([('foo', 100), ('bar', " "200)])``, ``dict(foo=100, bar=200)``" msgstr "" -#: ../../library/stdtypes.rst:4461 +#: ../../library/stdtypes.rst:4462 msgid "" "If no positional argument is given, an empty dictionary is created. If a " "positional argument is given and it is a mapping object, a dictionary is " @@ -4883,7 +4883,7 @@ msgid "" "value for that key becomes the corresponding value in the new dictionary." msgstr "" -#: ../../library/stdtypes.rst:4471 +#: ../../library/stdtypes.rst:4472 msgid "" "If keyword arguments are given, the keyword arguments and their values are " "added to the dictionary created from the positional argument. If a key " @@ -4891,39 +4891,39 @@ msgid "" "the value from the positional argument." msgstr "" -#: ../../library/stdtypes.rst:4476 +#: ../../library/stdtypes.rst:4477 msgid "" "To illustrate, the following examples all return a dictionary equal to " "``{\"one\": 1, \"two\": 2, \"three\": 3}``::" msgstr "" -#: ../../library/stdtypes.rst:4488 +#: ../../library/stdtypes.rst:4489 msgid "" "Providing keyword arguments as in the first example only works for keys that " "are valid Python identifiers. Otherwise, any valid keys can be used." msgstr "" -#: ../../library/stdtypes.rst:4492 +#: ../../library/stdtypes.rst:4493 msgid "" "These are the operations that dictionaries support (and therefore, custom " "mapping types should support too):" msgstr "" -#: ../../library/stdtypes.rst:4497 +#: ../../library/stdtypes.rst:4498 msgid "Return a list of all the keys used in the dictionary *d*." msgstr "" -#: ../../library/stdtypes.rst:4501 +#: ../../library/stdtypes.rst:4502 msgid "Return the number of items in the dictionary *d*." msgstr "" -#: ../../library/stdtypes.rst:4505 +#: ../../library/stdtypes.rst:4506 msgid "" "Return the item of *d* with key *key*. Raises a :exc:`KeyError` if *key* is " "not in the map." msgstr "" -#: ../../library/stdtypes.rst:4510 +#: ../../library/stdtypes.rst:4511 msgid "" "If a subclass of dict defines a method :meth:`__missing__` and *key* is not " "present, the ``d[key]`` operation calls that method with the key *key* as " @@ -4934,51 +4934,51 @@ msgid "" "an instance variable::" msgstr "" -#: ../../library/stdtypes.rst:4529 +#: ../../library/stdtypes.rst:4530 msgid "" "The example above shows part of the implementation of :class:`collections." "Counter`. A different ``__missing__`` method is used by :class:`collections." "defaultdict`." msgstr "" -#: ../../library/stdtypes.rst:4535 +#: ../../library/stdtypes.rst:4536 msgid "Set ``d[key]`` to *value*." msgstr "" -#: ../../library/stdtypes.rst:4539 +#: ../../library/stdtypes.rst:4540 msgid "" "Remove ``d[key]`` from *d*. Raises a :exc:`KeyError` if *key* is not in the " "map." msgstr "" -#: ../../library/stdtypes.rst:4544 +#: ../../library/stdtypes.rst:4545 msgid "Return ``True`` if *d* has a key *key*, else ``False``." msgstr "" -#: ../../library/stdtypes.rst:4548 +#: ../../library/stdtypes.rst:4549 msgid "Equivalent to ``not key in d``." msgstr "" -#: ../../library/stdtypes.rst:4552 +#: ../../library/stdtypes.rst:4553 msgid "" "Return an iterator over the keys of the dictionary. This is a shortcut for " "``iter(d.keys())``." msgstr "" -#: ../../library/stdtypes.rst:4557 +#: ../../library/stdtypes.rst:4558 msgid "Remove all items from the dictionary." msgstr "" -#: ../../library/stdtypes.rst:4561 +#: ../../library/stdtypes.rst:4562 msgid "Return a shallow copy of the dictionary." msgstr "" -#: ../../library/stdtypes.rst:4565 +#: ../../library/stdtypes.rst:4566 msgid "" "Create a new dictionary with keys from *iterable* and values set to *value*." msgstr "" -#: ../../library/stdtypes.rst:4567 +#: ../../library/stdtypes.rst:4568 msgid "" ":meth:`fromkeys` is a class method that returns a new dictionary. *value* " "defaults to ``None``. All of the values refer to just a single instance, so " @@ -4987,70 +4987,70 @@ msgid "" "` instead." msgstr "" -#: ../../library/stdtypes.rst:4575 +#: ../../library/stdtypes.rst:4576 msgid "" "Return the value for *key* if *key* is in the dictionary, else *default*. If " "*default* is not given, it defaults to ``None``, so that this method never " "raises a :exc:`KeyError`." msgstr "" -#: ../../library/stdtypes.rst:4581 +#: ../../library/stdtypes.rst:4582 msgid "" "Return a new view of the dictionary's items (``(key, value)`` pairs). See " "the :ref:`documentation of view objects `." msgstr "" -#: ../../library/stdtypes.rst:4586 +#: ../../library/stdtypes.rst:4587 msgid "" "Return a new view of the dictionary's keys. See the :ref:`documentation of " "view objects `." msgstr "" -#: ../../library/stdtypes.rst:4591 +#: ../../library/stdtypes.rst:4592 msgid "" "If *key* is in the dictionary, remove it and return its value, else return " "*default*. If *default* is not given and *key* is not in the dictionary, a :" "exc:`KeyError` is raised." msgstr "" -#: ../../library/stdtypes.rst:4597 +#: ../../library/stdtypes.rst:4598 msgid "" "Remove and return a ``(key, value)`` pair from the dictionary. Pairs are " "returned in :abbr:`LIFO (last-in, first-out)` order." msgstr "" -#: ../../library/stdtypes.rst:4600 +#: ../../library/stdtypes.rst:4601 msgid "" ":meth:`popitem` is useful to destructively iterate over a dictionary, as " "often used in set algorithms. If the dictionary is empty, calling :meth:" "`popitem` raises a :exc:`KeyError`." msgstr "" -#: ../../library/stdtypes.rst:4604 +#: ../../library/stdtypes.rst:4605 msgid "" "LIFO order is now guaranteed. In prior versions, :meth:`popitem` would " "return an arbitrary key/value pair." msgstr "" -#: ../../library/stdtypes.rst:4610 +#: ../../library/stdtypes.rst:4611 msgid "" "Return a reverse iterator over the keys of the dictionary. This is a " "shortcut for ``reversed(d.keys())``." msgstr "" -#: ../../library/stdtypes.rst:4617 +#: ../../library/stdtypes.rst:4618 msgid "" "If *key* is in the dictionary, return its value. If not, insert *key* with " "a value of *default* and return *default*. *default* defaults to ``None``." msgstr "" -#: ../../library/stdtypes.rst:4623 +#: ../../library/stdtypes.rst:4624 msgid "" "Update the dictionary with the key/value pairs from *other*, overwriting " "existing keys. Return ``None``." msgstr "" -#: ../../library/stdtypes.rst:4626 +#: ../../library/stdtypes.rst:4627 msgid "" ":meth:`update` accepts either another dictionary object or an iterable of " "key/value pairs (as tuples or other iterables of length two). If keyword " @@ -5058,71 +5058,71 @@ msgid "" "pairs: ``d.update(red=1, blue=2)``." msgstr "" -#: ../../library/stdtypes.rst:4633 +#: ../../library/stdtypes.rst:4634 msgid "" "Return a new view of the dictionary's values. See the :ref:`documentation " "of view objects `." msgstr "" -#: ../../library/stdtypes.rst:4636 +#: ../../library/stdtypes.rst:4637 msgid "" "An equality comparison between one ``dict.values()`` view and another will " "always return ``False``. This also applies when comparing ``dict.values()`` " "to itself::" msgstr "" -#: ../../library/stdtypes.rst:4646 +#: ../../library/stdtypes.rst:4647 msgid "" "Create a new dictionary with the merged keys and values of *d* and *other*, " "which must both be dictionaries. The values of *other* take priority when " "*d* and *other* share keys." msgstr "" -#: ../../library/stdtypes.rst:4654 +#: ../../library/stdtypes.rst:4655 msgid "" "Update the dictionary *d* with keys and values from *other*, which may be " "either a :term:`mapping` or an :term:`iterable` of key/value pairs. The " "values of *other* take priority when *d* and *other* share keys." msgstr "" -#: ../../library/stdtypes.rst:4660 +#: ../../library/stdtypes.rst:4661 msgid "" "Dictionaries compare equal if and only if they have the same ``(key, " "value)`` pairs (regardless of ordering). Order comparisons ('<', '<=', '>=', " "'>') raise :exc:`TypeError`." msgstr "" -#: ../../library/stdtypes.rst:4664 +#: ../../library/stdtypes.rst:4665 msgid "" "Dictionaries preserve insertion order. Note that updating a key does not " "affect the order. Keys added after deletion are inserted at the end. ::" msgstr "" -#: ../../library/stdtypes.rst:4682 +#: ../../library/stdtypes.rst:4683 msgid "" "Dictionary order is guaranteed to be insertion order. This behavior was an " "implementation detail of CPython from 3.6." msgstr "" -#: ../../library/stdtypes.rst:4686 +#: ../../library/stdtypes.rst:4687 msgid "Dictionaries and dictionary views are reversible. ::" msgstr "" -#: ../../library/stdtypes.rst:4698 +#: ../../library/stdtypes.rst:4699 msgid "Dictionaries are now reversible." msgstr "" -#: ../../library/stdtypes.rst:4703 +#: ../../library/stdtypes.rst:4704 msgid "" ":class:`types.MappingProxyType` can be used to create a read-only view of a :" "class:`dict`." msgstr "" -#: ../../library/stdtypes.rst:4710 +#: ../../library/stdtypes.rst:4711 msgid "Dictionary view objects" msgstr "字典視圖物件" -#: ../../library/stdtypes.rst:4712 +#: ../../library/stdtypes.rst:4713 msgid "" "The objects returned by :meth:`dict.keys`, :meth:`dict.values` and :meth:" "`dict.items` are *view objects*. They provide a dynamic view on the " @@ -5130,23 +5130,23 @@ msgid "" "reflects these changes." msgstr "" -#: ../../library/stdtypes.rst:4717 +#: ../../library/stdtypes.rst:4718 msgid "" "Dictionary views can be iterated over to yield their respective data, and " "support membership tests:" msgstr "" -#: ../../library/stdtypes.rst:4722 +#: ../../library/stdtypes.rst:4723 msgid "Return the number of entries in the dictionary." msgstr "" -#: ../../library/stdtypes.rst:4726 +#: ../../library/stdtypes.rst:4727 msgid "" "Return an iterator over the keys, values or items (represented as tuples of " "``(key, value)``) in the dictionary." msgstr "" -#: ../../library/stdtypes.rst:4729 +#: ../../library/stdtypes.rst:4730 msgid "" "Keys and values are iterated over in insertion order. This allows the " "creation of ``(value, key)`` pairs using :func:`zip`: ``pairs = zip(d." @@ -5154,39 +5154,39 @@ msgid "" "[(v, k) for (k, v) in d.items()]``." msgstr "" -#: ../../library/stdtypes.rst:4734 +#: ../../library/stdtypes.rst:4735 msgid "" "Iterating views while adding or deleting entries in the dictionary may raise " "a :exc:`RuntimeError` or fail to iterate over all entries." msgstr "" -#: ../../library/stdtypes.rst:4737 +#: ../../library/stdtypes.rst:4738 msgid "Dictionary order is guaranteed to be insertion order." msgstr "" -#: ../../library/stdtypes.rst:4742 +#: ../../library/stdtypes.rst:4743 msgid "" "Return ``True`` if *x* is in the underlying dictionary's keys, values or " "items (in the latter case, *x* should be a ``(key, value)`` tuple)." msgstr "" -#: ../../library/stdtypes.rst:4747 +#: ../../library/stdtypes.rst:4748 msgid "" "Return a reverse iterator over the keys, values or items of the dictionary. " "The view will be iterated in reverse order of the insertion." msgstr "" -#: ../../library/stdtypes.rst:4750 +#: ../../library/stdtypes.rst:4751 msgid "Dictionary views are now reversible." msgstr "" -#: ../../library/stdtypes.rst:4755 +#: ../../library/stdtypes.rst:4756 msgid "" "Return a :class:`types.MappingProxyType` that wraps the original dictionary " "to which the view refers." msgstr "" -#: ../../library/stdtypes.rst:4760 +#: ../../library/stdtypes.rst:4761 msgid "" "Keys views are set-like since their entries are unique and :term:`hashable`. " "Items views also have set-like operations since the (key, value) pairs are " @@ -5200,15 +5200,15 @@ msgid "" "input." msgstr "" -#: ../../library/stdtypes.rst:4772 +#: ../../library/stdtypes.rst:4773 msgid "An example of dictionary view usage::" msgstr "" -#: ../../library/stdtypes.rst:4816 +#: ../../library/stdtypes.rst:4817 msgid "Context Manager Types" msgstr "" -#: ../../library/stdtypes.rst:4823 +#: ../../library/stdtypes.rst:4824 msgid "" "Python's :keyword:`with` statement supports the concept of a runtime context " "defined by a context manager. This is implemented using a pair of methods " @@ -5216,7 +5216,7 @@ msgid "" "before the statement body is executed and exited when the statement ends:" msgstr "" -#: ../../library/stdtypes.rst:4831 +#: ../../library/stdtypes.rst:4832 msgid "" "Enter the runtime context and return either this object or another object " "related to the runtime context. The value returned by this method is bound " @@ -5224,14 +5224,14 @@ msgid "" "using this context manager." msgstr "" -#: ../../library/stdtypes.rst:4836 +#: ../../library/stdtypes.rst:4837 msgid "" "An example of a context manager that returns itself is a :term:`file " "object`. File objects return themselves from __enter__() to allow :func:" "`open` to be used as the context expression in a :keyword:`with` statement." msgstr "" -#: ../../library/stdtypes.rst:4840 +#: ../../library/stdtypes.rst:4841 msgid "" "An example of a context manager that returns a related object is the one " "returned by :func:`decimal.localcontext`. These managers set the active " @@ -5241,7 +5241,7 @@ msgid "" "the :keyword:`!with` statement." msgstr "" -#: ../../library/stdtypes.rst:4850 +#: ../../library/stdtypes.rst:4851 msgid "" "Exit the runtime context and return a Boolean flag indicating if any " "exception that occurred should be suppressed. If an exception occurred while " @@ -5250,7 +5250,7 @@ msgid "" "arguments are ``None``." msgstr "" -#: ../../library/stdtypes.rst:4855 +#: ../../library/stdtypes.rst:4856 msgid "" "Returning a true value from this method will cause the :keyword:`with` " "statement to suppress the exception and continue execution with the " @@ -5261,7 +5261,7 @@ msgid "" "statement." msgstr "" -#: ../../library/stdtypes.rst:4862 +#: ../../library/stdtypes.rst:4863 msgid "" "The exception passed in should never be reraised explicitly - instead, this " "method should return a false value to indicate that the method completed " @@ -5270,7 +5270,7 @@ msgid "" "__exit__` method has actually failed." msgstr "" -#: ../../library/stdtypes.rst:4868 +#: ../../library/stdtypes.rst:4869 msgid "" "Python defines several context managers to support easy thread " "synchronisation, prompt closure of files or other objects, and simpler " @@ -5279,7 +5279,7 @@ msgid "" "management protocol. See the :mod:`contextlib` module for some examples." msgstr "" -#: ../../library/stdtypes.rst:4874 +#: ../../library/stdtypes.rst:4875 msgid "" "Python's :term:`generator`\\s and the :class:`contextlib.contextmanager` " "decorator provide a convenient way to implement these protocols. If a " @@ -5289,7 +5289,7 @@ msgid "" "rather than the iterator produced by an undecorated generator function." msgstr "" -#: ../../library/stdtypes.rst:4881 +#: ../../library/stdtypes.rst:4882 msgid "" "Note that there is no specific slot for any of these methods in the type " "structure for Python objects in the Python/C API. Extension types wanting to " @@ -5298,23 +5298,23 @@ msgid "" "a single class dictionary lookup is negligible." msgstr "" -#: ../../library/stdtypes.rst:4889 +#: ../../library/stdtypes.rst:4890 msgid "" "Type Annotation Types --- :ref:`Generic Alias `, :ref:" "`Union `" msgstr "" -#: ../../library/stdtypes.rst:4894 +#: ../../library/stdtypes.rst:4895 msgid "" "The core built-in types for :term:`type annotations ` are :ref:" "`Generic Alias ` and :ref:`Union `." msgstr "" -#: ../../library/stdtypes.rst:4901 +#: ../../library/stdtypes.rst:4902 msgid "Generic Alias Type" msgstr "" -#: ../../library/stdtypes.rst:4907 +#: ../../library/stdtypes.rst:4908 msgid "" "``GenericAlias`` objects are generally created by :ref:`subscripting " "` a class. They are most often used with :ref:`container " @@ -5324,19 +5324,19 @@ msgid "" "are intended primarily for use with :term:`type annotations `." msgstr "" -#: ../../library/stdtypes.rst:4917 +#: ../../library/stdtypes.rst:4918 msgid "" "It is generally only possible to subscript a class if the class implements " "the special method :meth:`~object.__class_getitem__`." msgstr "" -#: ../../library/stdtypes.rst:4920 +#: ../../library/stdtypes.rst:4921 msgid "" "A ``GenericAlias`` object acts as a proxy for a :term:`generic type`, " "implementing *parameterized generics*." msgstr "" -#: ../../library/stdtypes.rst:4923 +#: ../../library/stdtypes.rst:4924 msgid "" "For a container class, the argument(s) supplied to a :ref:`subscription " "` of the class may indicate the type(s) of the elements an " @@ -5345,7 +5345,7 @@ msgid "" "`bytes`." msgstr "" -#: ../../library/stdtypes.rst:4929 +#: ../../library/stdtypes.rst:4930 msgid "" "For a class which defines :meth:`~object.__class_getitem__` but is not a " "container, the argument(s) supplied to a subscription of the class will " @@ -5354,7 +5354,7 @@ msgid "" "the :class:`str` data type and the :class:`bytes` data type:" msgstr "" -#: ../../library/stdtypes.rst:4935 +#: ../../library/stdtypes.rst:4936 msgid "" "If ``x = re.search('foo', 'foo')``, ``x`` will be a :ref:`re.Match ` object where the return values of ``x.group(0)`` and ``x[0]`` will " @@ -5362,7 +5362,7 @@ msgid "" "annotations with the ``GenericAlias`` ``re.Match[str]``." msgstr "" -#: ../../library/stdtypes.rst:4941 +#: ../../library/stdtypes.rst:4942 msgid "" "If ``y = re.search(b'bar', b'bar')``, (note the ``b`` for :class:`bytes`), " "``y`` will also be an instance of ``re.Match``, but the return values of ``y." @@ -5371,21 +5371,21 @@ msgid "" "objects>` objects with ``re.Match[bytes]``." msgstr "" -#: ../../library/stdtypes.rst:4947 +#: ../../library/stdtypes.rst:4948 msgid "" "``GenericAlias`` objects are instances of the class :class:`types." "GenericAlias`, which can also be used to create ``GenericAlias`` objects " "directly." msgstr "" -#: ../../library/stdtypes.rst:4953 +#: ../../library/stdtypes.rst:4954 msgid "" "Creates a ``GenericAlias`` representing a type ``T`` parameterized by types " "*X*, *Y*, and more depending on the ``T`` used. For example, a function " "expecting a :class:`list` containing :class:`float` elements::" msgstr "" -#: ../../library/stdtypes.rst:4961 +#: ../../library/stdtypes.rst:4962 msgid "" "Another example for :term:`mapping` objects, using a :class:`dict`, which is " "a generic type expecting two type parameters representing the key type and " @@ -5393,13 +5393,13 @@ msgid "" "of type :class:`str` and values of type :class:`int`::" msgstr "" -#: ../../library/stdtypes.rst:4969 +#: ../../library/stdtypes.rst:4970 msgid "" "The builtin functions :func:`isinstance` and :func:`issubclass` do not " "accept ``GenericAlias`` types for their second argument::" msgstr "" -#: ../../library/stdtypes.rst:4977 +#: ../../library/stdtypes.rst:4978 msgid "" "The Python runtime does not enforce :term:`type annotations `. " "This extends to generic types and their type parameters. When creating a " @@ -5408,331 +5408,331 @@ msgid "" "discouraged, but will run without errors::" msgstr "" -#: ../../library/stdtypes.rst:4987 +#: ../../library/stdtypes.rst:4988 msgid "" "Furthermore, parameterized generics erase type parameters during object " "creation::" msgstr "" -#: ../../library/stdtypes.rst:4998 +#: ../../library/stdtypes.rst:4999 msgid "" "Calling :func:`repr` or :func:`str` on a generic shows the parameterized " "type::" msgstr "" -#: ../../library/stdtypes.rst:5006 +#: ../../library/stdtypes.rst:5007 msgid "" "The :meth:`~object.__getitem__` method of generic containers will raise an " "exception to disallow mistakes like ``dict[str][str]``::" msgstr "" -#: ../../library/stdtypes.rst:5014 +#: ../../library/stdtypes.rst:5015 msgid "" "However, such expressions are valid when :ref:`type variables ` " "are used. The index must have as many elements as there are type variable " "items in the ``GenericAlias`` object's :attr:`~genericalias.__args__`. ::" msgstr "" -#: ../../library/stdtypes.rst:5025 +#: ../../library/stdtypes.rst:5026 msgid "Standard Generic Classes" msgstr "" -#: ../../library/stdtypes.rst:5027 +#: ../../library/stdtypes.rst:5028 msgid "" "The following standard library classes support parameterized generics. This " "list is non-exhaustive." msgstr "" -#: ../../library/stdtypes.rst:5030 +#: ../../library/stdtypes.rst:5031 msgid ":class:`tuple`" msgstr ":class:`tuple`" -#: ../../library/stdtypes.rst:5031 +#: ../../library/stdtypes.rst:5032 msgid ":class:`list`" msgstr ":class:`list`" -#: ../../library/stdtypes.rst:5032 +#: ../../library/stdtypes.rst:5033 msgid ":class:`dict`" msgstr ":class:`dict`" -#: ../../library/stdtypes.rst:5033 +#: ../../library/stdtypes.rst:5034 msgid ":class:`set`" msgstr ":class:`set`" -#: ../../library/stdtypes.rst:5034 +#: ../../library/stdtypes.rst:5035 msgid ":class:`frozenset`" msgstr ":class:`frozenset`" -#: ../../library/stdtypes.rst:5035 +#: ../../library/stdtypes.rst:5036 msgid ":class:`type`" msgstr ":class:`type`" -#: ../../library/stdtypes.rst:5036 +#: ../../library/stdtypes.rst:5037 msgid ":class:`collections.deque`" msgstr ":class:`collections.deque`" -#: ../../library/stdtypes.rst:5037 +#: ../../library/stdtypes.rst:5038 msgid ":class:`collections.defaultdict`" msgstr ":class:`collections.defaultdict`" -#: ../../library/stdtypes.rst:5038 +#: ../../library/stdtypes.rst:5039 msgid ":class:`collections.OrderedDict`" msgstr ":class:`collections.OrderedDict`" -#: ../../library/stdtypes.rst:5039 +#: ../../library/stdtypes.rst:5040 msgid ":class:`collections.Counter`" msgstr ":class:`collections.Counter`" -#: ../../library/stdtypes.rst:5040 +#: ../../library/stdtypes.rst:5041 msgid ":class:`collections.ChainMap`" msgstr ":class:`collections.ChainMap`" -#: ../../library/stdtypes.rst:5041 +#: ../../library/stdtypes.rst:5042 msgid ":class:`collections.abc.Awaitable`" msgstr ":class:`collections.abc.Awaitable`" -#: ../../library/stdtypes.rst:5042 +#: ../../library/stdtypes.rst:5043 msgid ":class:`collections.abc.Coroutine`" msgstr ":class:`collections.abc.Coroutine`" -#: ../../library/stdtypes.rst:5043 +#: ../../library/stdtypes.rst:5044 msgid ":class:`collections.abc.AsyncIterable`" msgstr ":class:`collections.abc.AsyncIterable`" -#: ../../library/stdtypes.rst:5044 +#: ../../library/stdtypes.rst:5045 msgid ":class:`collections.abc.AsyncIterator`" msgstr ":class:`collections.abc.AsyncIterator`" -#: ../../library/stdtypes.rst:5045 +#: ../../library/stdtypes.rst:5046 msgid ":class:`collections.abc.AsyncGenerator`" msgstr ":class:`collections.abc.AsyncGenerator`" -#: ../../library/stdtypes.rst:5046 +#: ../../library/stdtypes.rst:5047 msgid ":class:`collections.abc.Iterable`" msgstr ":class:`collections.abc.Iterable`" -#: ../../library/stdtypes.rst:5047 +#: ../../library/stdtypes.rst:5048 msgid ":class:`collections.abc.Iterator`" msgstr ":class:`collections.abc.Iterator`" -#: ../../library/stdtypes.rst:5048 +#: ../../library/stdtypes.rst:5049 msgid ":class:`collections.abc.Generator`" msgstr ":class:`collections.abc.Generator`" -#: ../../library/stdtypes.rst:5049 +#: ../../library/stdtypes.rst:5050 msgid ":class:`collections.abc.Reversible`" msgstr ":class:`collections.abc.Reversible`" -#: ../../library/stdtypes.rst:5050 +#: ../../library/stdtypes.rst:5051 msgid ":class:`collections.abc.Container`" msgstr ":class:`collections.abc.Container`" -#: ../../library/stdtypes.rst:5051 +#: ../../library/stdtypes.rst:5052 msgid ":class:`collections.abc.Collection`" msgstr ":class:`collections.abc.Collection`" -#: ../../library/stdtypes.rst:5052 +#: ../../library/stdtypes.rst:5053 msgid ":class:`collections.abc.Callable`" msgstr ":class:`collections.abc.Callable`" -#: ../../library/stdtypes.rst:5053 +#: ../../library/stdtypes.rst:5054 msgid ":class:`collections.abc.Set`" msgstr ":class:`collections.abc.Set`" -#: ../../library/stdtypes.rst:5054 +#: ../../library/stdtypes.rst:5055 msgid ":class:`collections.abc.MutableSet`" msgstr ":class:`collections.abc.MutableSet`" -#: ../../library/stdtypes.rst:5055 +#: ../../library/stdtypes.rst:5056 msgid ":class:`collections.abc.Mapping`" msgstr ":class:`collections.abc.Mapping`" -#: ../../library/stdtypes.rst:5056 +#: ../../library/stdtypes.rst:5057 msgid ":class:`collections.abc.MutableMapping`" msgstr ":class:`collections.abc.MutableMapping`" -#: ../../library/stdtypes.rst:5057 +#: ../../library/stdtypes.rst:5058 msgid ":class:`collections.abc.Sequence`" msgstr ":class:`collections.abc.Sequence`" -#: ../../library/stdtypes.rst:5058 +#: ../../library/stdtypes.rst:5059 msgid ":class:`collections.abc.MutableSequence`" msgstr ":class:`collections.abc.MutableSequence`" -#: ../../library/stdtypes.rst:5059 +#: ../../library/stdtypes.rst:5060 msgid ":class:`collections.abc.ByteString`" msgstr ":class:`collections.abc.ByteString`" -#: ../../library/stdtypes.rst:5060 +#: ../../library/stdtypes.rst:5061 msgid ":class:`collections.abc.MappingView`" msgstr ":class:`collections.abc.MappingView`" -#: ../../library/stdtypes.rst:5061 +#: ../../library/stdtypes.rst:5062 msgid ":class:`collections.abc.KeysView`" msgstr ":class:`collections.abc.KeysView`" -#: ../../library/stdtypes.rst:5062 +#: ../../library/stdtypes.rst:5063 msgid ":class:`collections.abc.ItemsView`" msgstr ":class:`collections.abc.ItemsView`" -#: ../../library/stdtypes.rst:5063 +#: ../../library/stdtypes.rst:5064 msgid ":class:`collections.abc.ValuesView`" msgstr ":class:`collections.abc.ValuesView`" -#: ../../library/stdtypes.rst:5064 +#: ../../library/stdtypes.rst:5065 msgid ":class:`contextlib.AbstractContextManager`" msgstr ":class:`contextlib.AbstractContextManager`" -#: ../../library/stdtypes.rst:5065 +#: ../../library/stdtypes.rst:5066 msgid ":class:`contextlib.AbstractAsyncContextManager`" msgstr ":class:`contextlib.AbstractAsyncContextManager`" -#: ../../library/stdtypes.rst:5066 +#: ../../library/stdtypes.rst:5067 msgid ":class:`dataclasses.Field`" msgstr ":class:`dataclasses.Field`" -#: ../../library/stdtypes.rst:5067 +#: ../../library/stdtypes.rst:5068 msgid ":class:`functools.cached_property`" msgstr ":class:`functools.cached_property`" -#: ../../library/stdtypes.rst:5068 +#: ../../library/stdtypes.rst:5069 msgid ":class:`functools.partialmethod`" msgstr ":class:`functools.partialmethod`" -#: ../../library/stdtypes.rst:5069 +#: ../../library/stdtypes.rst:5070 msgid ":class:`os.PathLike`" msgstr ":class:`os.PathLike`" -#: ../../library/stdtypes.rst:5070 +#: ../../library/stdtypes.rst:5071 msgid ":class:`queue.LifoQueue`" msgstr ":class:`queue.LifoQueue`" -#: ../../library/stdtypes.rst:5071 +#: ../../library/stdtypes.rst:5072 msgid ":class:`queue.Queue`" msgstr ":class:`queue.Queue`" -#: ../../library/stdtypes.rst:5072 +#: ../../library/stdtypes.rst:5073 msgid ":class:`queue.PriorityQueue`" msgstr ":class:`queue.PriorityQueue`" -#: ../../library/stdtypes.rst:5073 +#: ../../library/stdtypes.rst:5074 msgid ":class:`queue.SimpleQueue`" msgstr ":class:`queue.SimpleQueue`" -#: ../../library/stdtypes.rst:5074 +#: ../../library/stdtypes.rst:5075 msgid ":ref:`re.Pattern `" msgstr ":ref:`re.Pattern `" -#: ../../library/stdtypes.rst:5075 +#: ../../library/stdtypes.rst:5076 msgid ":ref:`re.Match `" msgstr ":ref:`re.Match `" -#: ../../library/stdtypes.rst:5076 +#: ../../library/stdtypes.rst:5077 msgid ":class:`shelve.BsdDbShelf`" msgstr ":class:`shelve.BsdDbShelf`" -#: ../../library/stdtypes.rst:5077 +#: ../../library/stdtypes.rst:5078 msgid ":class:`shelve.DbfilenameShelf`" msgstr ":class:`shelve.DbfilenameShelf`" -#: ../../library/stdtypes.rst:5078 +#: ../../library/stdtypes.rst:5079 msgid ":class:`shelve.Shelf`" msgstr ":class:`shelve.Shelf`" -#: ../../library/stdtypes.rst:5079 +#: ../../library/stdtypes.rst:5080 msgid ":class:`types.MappingProxyType`" msgstr ":class:`types.MappingProxyType`" -#: ../../library/stdtypes.rst:5080 +#: ../../library/stdtypes.rst:5081 msgid ":class:`weakref.WeakKeyDictionary`" msgstr ":class:`weakref.WeakKeyDictionary`" -#: ../../library/stdtypes.rst:5081 +#: ../../library/stdtypes.rst:5082 msgid ":class:`weakref.WeakMethod`" msgstr ":class:`weakref.WeakMethod`" -#: ../../library/stdtypes.rst:5082 +#: ../../library/stdtypes.rst:5083 msgid ":class:`weakref.WeakSet`" msgstr ":class:`weakref.WeakSet`" -#: ../../library/stdtypes.rst:5083 +#: ../../library/stdtypes.rst:5084 msgid ":class:`weakref.WeakValueDictionary`" msgstr ":class:`weakref.WeakValueDictionary`" -#: ../../library/stdtypes.rst:5088 +#: ../../library/stdtypes.rst:5089 msgid "Special Attributes of ``GenericAlias`` objects" msgstr "" -#: ../../library/stdtypes.rst:5090 +#: ../../library/stdtypes.rst:5091 msgid "All parameterized generics implement special read-only attributes." msgstr "" -#: ../../library/stdtypes.rst:5094 +#: ../../library/stdtypes.rst:5095 msgid "This attribute points at the non-parameterized generic class::" msgstr "" -#: ../../library/stdtypes.rst:5102 +#: ../../library/stdtypes.rst:5103 msgid "" "This attribute is a :class:`tuple` (possibly of length 1) of generic types " "passed to the original :meth:`~object.__class_getitem__` of the generic " "class::" msgstr "" -#: ../../library/stdtypes.rst:5112 +#: ../../library/stdtypes.rst:5113 msgid "" "This attribute is a lazily computed tuple (possibly empty) of unique type " "variables found in ``__args__``::" msgstr "" -#: ../../library/stdtypes.rst:5123 +#: ../../library/stdtypes.rst:5124 msgid "" "A ``GenericAlias`` object with :class:`typing.ParamSpec` parameters may not " "have correct ``__parameters__`` after substitution because :class:`typing." "ParamSpec` is intended primarily for static type checking." msgstr "" -#: ../../library/stdtypes.rst:5130 +#: ../../library/stdtypes.rst:5131 msgid "" "A boolean that is true if the alias has been unpacked using the ``*`` " "operator (see :data:`~typing.TypeVarTuple`)." msgstr "" -#: ../../library/stdtypes.rst:5138 +#: ../../library/stdtypes.rst:5139 msgid ":pep:`484` - Type Hints" msgstr "" -#: ../../library/stdtypes.rst:5139 +#: ../../library/stdtypes.rst:5140 msgid "Introducing Python's framework for type annotations." msgstr "" -#: ../../library/stdtypes.rst:5141 +#: ../../library/stdtypes.rst:5142 msgid ":pep:`585` - Type Hinting Generics In Standard Collections" msgstr "" -#: ../../library/stdtypes.rst:5142 +#: ../../library/stdtypes.rst:5143 msgid "" "Introducing the ability to natively parameterize standard-library classes, " "provided they implement the special class method :meth:`~object." "__class_getitem__`." msgstr "" -#: ../../library/stdtypes.rst:5146 +#: ../../library/stdtypes.rst:5147 msgid "" ":ref:`Generics`, :ref:`user-defined generics ` and :" "class:`typing.Generic`" msgstr "" -#: ../../library/stdtypes.rst:5147 +#: ../../library/stdtypes.rst:5148 msgid "" "Documentation on how to implement generic classes that can be parameterized " "at runtime and understood by static type-checkers." msgstr "" -#: ../../library/stdtypes.rst:5156 +#: ../../library/stdtypes.rst:5157 msgid "Union Type" msgstr "" -#: ../../library/stdtypes.rst:5162 +#: ../../library/stdtypes.rst:5163 msgid "" "A union object holds the value of the ``|`` (bitwise or) operation on " "multiple :ref:`type objects `. These types are intended " @@ -5741,7 +5741,7 @@ msgid "" "Union`." msgstr "" -#: ../../library/stdtypes.rst:5169 +#: ../../library/stdtypes.rst:5170 msgid "" "Defines a union object which holds types *X*, *Y*, and so forth. ``X | Y`` " "means either X or Y. It is equivalent to ``typing.Union[X, Y]``. For " @@ -5749,7 +5749,7 @@ msgid "" "class:`float`::" msgstr "" -#: ../../library/stdtypes.rst:5179 +#: ../../library/stdtypes.rst:5180 msgid "" "The ``|`` operand cannot be used at runtime to define unions where one or " "more members is a forward reference. For example, ``int | \"Foo\"``, where " @@ -5758,76 +5758,76 @@ msgid "" "a string, e.g. ``\"int | Foo\"``." msgstr "" -#: ../../library/stdtypes.rst:5187 +#: ../../library/stdtypes.rst:5188 msgid "" "Union objects can be tested for equality with other union objects. Details:" msgstr "" -#: ../../library/stdtypes.rst:5189 +#: ../../library/stdtypes.rst:5190 msgid "Unions of unions are flattened::" msgstr "" -#: ../../library/stdtypes.rst:5193 +#: ../../library/stdtypes.rst:5194 msgid "Redundant types are removed::" msgstr "" -#: ../../library/stdtypes.rst:5197 +#: ../../library/stdtypes.rst:5198 msgid "When comparing unions, the order is ignored::" msgstr "" -#: ../../library/stdtypes.rst:5201 +#: ../../library/stdtypes.rst:5202 msgid "It is compatible with :data:`typing.Union`::" msgstr "" -#: ../../library/stdtypes.rst:5205 +#: ../../library/stdtypes.rst:5206 msgid "Optional types can be spelled as a union with ``None``::" msgstr "" -#: ../../library/stdtypes.rst:5212 +#: ../../library/stdtypes.rst:5213 msgid "" "Calls to :func:`isinstance` and :func:`issubclass` are also supported with a " "union object::" msgstr "" -#: ../../library/stdtypes.rst:5218 +#: ../../library/stdtypes.rst:5219 msgid "" "However, :ref:`parameterized generics ` in union objects " "cannot be checked::" msgstr "" -#: ../../library/stdtypes.rst:5228 +#: ../../library/stdtypes.rst:5229 msgid "" "The user-exposed type for the union object can be accessed from :data:`types." "UnionType` and used for :func:`isinstance` checks. An object cannot be " "instantiated from the type::" msgstr "" -#: ../../library/stdtypes.rst:5241 +#: ../../library/stdtypes.rst:5242 msgid "" "The :meth:`!__or__` method for type objects was added to support the syntax " "``X | Y``. If a metaclass implements :meth:`!__or__`, the Union may " "override it:" msgstr "" -#: ../../library/stdtypes.rst:5261 +#: ../../library/stdtypes.rst:5262 msgid ":pep:`604` -- PEP proposing the ``X | Y`` syntax and the Union type." msgstr "" -#: ../../library/stdtypes.rst:5269 +#: ../../library/stdtypes.rst:5270 msgid "Other Built-in Types" msgstr "" -#: ../../library/stdtypes.rst:5271 +#: ../../library/stdtypes.rst:5272 msgid "" "The interpreter supports several other kinds of objects. Most of these " "support only one or two operations." msgstr "" -#: ../../library/stdtypes.rst:5278 +#: ../../library/stdtypes.rst:5279 msgid "Modules" msgstr "模組" -#: ../../library/stdtypes.rst:5280 +#: ../../library/stdtypes.rst:5281 msgid "" "The only special operation on a module is attribute access: ``m.name``, " "where *m* is a module and *name* accesses a name defined in *m*'s symbol " @@ -5838,7 +5838,7 @@ msgid "" "*foo* somewhere.)" msgstr "" -#: ../../library/stdtypes.rst:5287 +#: ../../library/stdtypes.rst:5288 msgid "" "A special attribute of every module is :attr:`~object.__dict__`. This is the " "dictionary containing the module's symbol table. Modifying this dictionary " @@ -5849,32 +5849,32 @@ msgid "" "recommended." msgstr "" -#: ../../library/stdtypes.rst:5295 +#: ../../library/stdtypes.rst:5296 msgid "" -"Modules built into the interpreter are written like this: ````. If loaded from a file, they are written as ````." +"Modules built into the interpreter are written like this: ````. If loaded from a file, they are written as ````." msgstr "" -#: ../../library/stdtypes.rst:5303 +#: ../../library/stdtypes.rst:5304 msgid "Classes and Class Instances" msgstr "" -#: ../../library/stdtypes.rst:5305 +#: ../../library/stdtypes.rst:5306 msgid "See :ref:`objects` and :ref:`class` for these." msgstr "" -#: ../../library/stdtypes.rst:5311 +#: ../../library/stdtypes.rst:5312 msgid "Functions" msgstr "函式" -#: ../../library/stdtypes.rst:5313 +#: ../../library/stdtypes.rst:5314 msgid "" "Function objects are created by function definitions. The only operation on " "a function object is to call it: ``func(argument-list)``." msgstr "" -#: ../../library/stdtypes.rst:5316 +#: ../../library/stdtypes.rst:5317 msgid "" "There are really two flavors of function objects: built-in functions and " "user-defined functions. Both support the same operation (to call the " @@ -5882,15 +5882,15 @@ msgid "" "types." msgstr "" -#: ../../library/stdtypes.rst:5320 +#: ../../library/stdtypes.rst:5321 msgid "See :ref:`function` for more information." msgstr "更多資訊請見 :ref:`function`。" -#: ../../library/stdtypes.rst:5326 +#: ../../library/stdtypes.rst:5327 msgid "Methods" msgstr "" -#: ../../library/stdtypes.rst:5330 +#: ../../library/stdtypes.rst:5331 msgid "" "Methods are functions that are called using the attribute notation. There " "are two flavors: :ref:`built-in methods ` (such as :meth:" @@ -5898,7 +5898,7 @@ msgid "" "Built-in methods are described with the types that support them." msgstr "" -#: ../../library/stdtypes.rst:5335 +#: ../../library/stdtypes.rst:5336 msgid "" "If you access a method (a function defined in a class namespace) through an " "instance, you get a special object: a :dfn:`bound method` (also called :ref:" @@ -5911,7 +5911,7 @@ msgid "" "arg-2, ..., arg-n)``." msgstr "" -#: ../../library/stdtypes.rst:5346 +#: ../../library/stdtypes.rst:5347 msgid "" "Like :ref:`function objects `, bound method objects " "support getting arbitrary attributes. However, since method attributes are " @@ -5922,15 +5922,15 @@ msgid "" "underlying function object:" msgstr "" -#: ../../library/stdtypes.rst:5369 +#: ../../library/stdtypes.rst:5370 msgid "See :ref:`instance-methods` for more information." msgstr "更多資訊請見 :ref:`instance-methods`。" -#: ../../library/stdtypes.rst:5377 +#: ../../library/stdtypes.rst:5378 msgid "Code Objects" msgstr "" -#: ../../library/stdtypes.rst:5383 +#: ../../library/stdtypes.rst:5384 msgid "" "Code objects are used by the implementation to represent \"pseudo-compiled\" " "executable Python code such as a function body. They differ from function " @@ -5940,7 +5940,7 @@ msgid "" "`~function.__code__` attribute. See also the :mod:`code` module." msgstr "" -#: ../../library/stdtypes.rst:5390 +#: ../../library/stdtypes.rst:5391 msgid "" "Accessing :attr:`~function.__code__` raises an :ref:`auditing event " "` ``object.__getattr__`` with arguments ``obj`` and " @@ -5949,21 +5949,21 @@ msgstr "" "存取 :attr:`~function.__code__` 會引發一個附帶引數 ``obj`` 與 " "``\"__code__\"`` 的\\ :ref:`稽核事件 ` ``object.__getattr__``。" -#: ../../library/stdtypes.rst:5397 +#: ../../library/stdtypes.rst:5398 msgid "" "A code object can be executed or evaluated by passing it (instead of a " "source string) to the :func:`exec` or :func:`eval` built-in functions." msgstr "" -#: ../../library/stdtypes.rst:5400 +#: ../../library/stdtypes.rst:5401 msgid "See :ref:`types` for more information." msgstr "更多資訊請見 :ref:`types`。" -#: ../../library/stdtypes.rst:5406 +#: ../../library/stdtypes.rst:5407 msgid "Type Objects" msgstr "" -#: ../../library/stdtypes.rst:5412 +#: ../../library/stdtypes.rst:5413 msgid "" "Type objects represent the various object types. An object's type is " "accessed by the built-in function :func:`type`. There are no special " @@ -5971,30 +5971,30 @@ msgid "" "standard built-in types." msgstr "" -#: ../../library/stdtypes.rst:5417 +#: ../../library/stdtypes.rst:5418 msgid "Types are written like this: ````." msgstr "" -#: ../../library/stdtypes.rst:5423 +#: ../../library/stdtypes.rst:5424 msgid "The Null Object" msgstr "" -#: ../../library/stdtypes.rst:5425 +#: ../../library/stdtypes.rst:5426 msgid "" "This object is returned by functions that don't explicitly return a value. " "It supports no special operations. There is exactly one null object, named " "``None`` (a built-in name). ``type(None)()`` produces the same singleton." msgstr "" -#: ../../library/stdtypes.rst:5429 +#: ../../library/stdtypes.rst:5430 msgid "It is written as ``None``." msgstr "" -#: ../../library/stdtypes.rst:5436 +#: ../../library/stdtypes.rst:5437 msgid "The Ellipsis Object" msgstr "" -#: ../../library/stdtypes.rst:5438 +#: ../../library/stdtypes.rst:5439 msgid "" "This object is commonly used by slicing (see :ref:`slicings`). It supports " "no special operations. There is exactly one ellipsis object, named :const:" @@ -6002,15 +6002,15 @@ msgid "" "`Ellipsis` singleton." msgstr "" -#: ../../library/stdtypes.rst:5443 +#: ../../library/stdtypes.rst:5444 msgid "It is written as ``Ellipsis`` or ``...``." msgstr "" -#: ../../library/stdtypes.rst:5449 +#: ../../library/stdtypes.rst:5450 msgid "The NotImplemented Object" msgstr "" -#: ../../library/stdtypes.rst:5451 +#: ../../library/stdtypes.rst:5452 msgid "" "This object is returned from comparisons and binary operations when they are " "asked to operate on types they don't support. See :ref:`comparisons` for " @@ -6018,88 +6018,88 @@ msgid "" "`type(NotImplemented)()` produces the singleton instance." msgstr "" -#: ../../library/stdtypes.rst:5456 +#: ../../library/stdtypes.rst:5457 msgid "It is written as :code:`NotImplemented`." msgstr "" -#: ../../library/stdtypes.rst:5462 +#: ../../library/stdtypes.rst:5463 msgid "Internal Objects" msgstr "" -#: ../../library/stdtypes.rst:5464 +#: ../../library/stdtypes.rst:5465 msgid "" "See :ref:`types` for this information. It describes :ref:`stack frame " "objects `, :ref:`traceback objects `, and " "slice objects." msgstr "" -#: ../../library/stdtypes.rst:5472 +#: ../../library/stdtypes.rst:5473 msgid "Special Attributes" msgstr "" -#: ../../library/stdtypes.rst:5474 +#: ../../library/stdtypes.rst:5475 msgid "" "The implementation adds a few special read-only attributes to several object " "types, where they are relevant. Some of these are not reported by the :func:" "`dir` built-in function." msgstr "" -#: ../../library/stdtypes.rst:5481 +#: ../../library/stdtypes.rst:5482 msgid "" "A dictionary or other mapping object used to store an object's (writable) " "attributes." msgstr "" -#: ../../library/stdtypes.rst:5487 +#: ../../library/stdtypes.rst:5488 msgid "The class to which a class instance belongs." msgstr "" -#: ../../library/stdtypes.rst:5492 +#: ../../library/stdtypes.rst:5493 msgid "The tuple of base classes of a class object." msgstr "" -#: ../../library/stdtypes.rst:5497 +#: ../../library/stdtypes.rst:5498 msgid "" "The name of the class, function, method, descriptor, or generator instance." msgstr "" -#: ../../library/stdtypes.rst:5503 +#: ../../library/stdtypes.rst:5504 msgid "" "The :term:`qualified name` of the class, function, method, descriptor, or " "generator instance." msgstr "" -#: ../../library/stdtypes.rst:5511 +#: ../../library/stdtypes.rst:5512 msgid "" "The :ref:`type parameters ` of generic classes, functions, and :" "ref:`type aliases `." msgstr "" -#: ../../library/stdtypes.rst:5519 +#: ../../library/stdtypes.rst:5520 msgid "" "This attribute is a tuple of classes that are considered when looking for " "base classes during method resolution." msgstr "" -#: ../../library/stdtypes.rst:5525 +#: ../../library/stdtypes.rst:5526 msgid "" "This method can be overridden by a metaclass to customize the method " "resolution order for its instances. It is called at class instantiation, " "and its result is stored in :attr:`~class.__mro__`." msgstr "" -#: ../../library/stdtypes.rst:5532 +#: ../../library/stdtypes.rst:5533 msgid "" "Each class keeps a list of weak references to its immediate subclasses. " "This method returns a list of all those references still alive. The list is " "in definition order. Example::" msgstr "" -#: ../../library/stdtypes.rst:5543 +#: ../../library/stdtypes.rst:5544 msgid "Integer string conversion length limitation" msgstr "" -#: ../../library/stdtypes.rst:5545 +#: ../../library/stdtypes.rst:5546 msgid "" "CPython has a global limit for converting between :class:`int` and :class:" "`str` to mitigate denial of service attacks. This limit *only* applies to " @@ -6107,7 +6107,7 @@ msgid "" "binary conversions are unlimited. The limit can be configured." msgstr "" -#: ../../library/stdtypes.rst:5550 +#: ../../library/stdtypes.rst:5551 msgid "" "The :class:`int` type in CPython is an arbitrary length number stored in " "binary form (commonly known as a \"bignum\"). There exists no algorithm that " @@ -6117,24 +6117,24 @@ msgid "" "value such as ``int('1' * 500_000)`` can take over a second on a fast CPU." msgstr "" -#: ../../library/stdtypes.rst:5557 +#: ../../library/stdtypes.rst:5558 msgid "" "Limiting conversion size offers a practical way to avoid :cve:`2020-10735`." msgstr "" -#: ../../library/stdtypes.rst:5559 +#: ../../library/stdtypes.rst:5560 msgid "" "The limit is applied to the number of digit characters in the input or " "output string when a non-linear conversion algorithm would be involved. " "Underscores and the sign are not counted towards the limit." msgstr "" -#: ../../library/stdtypes.rst:5563 +#: ../../library/stdtypes.rst:5564 msgid "" "When an operation would exceed the limit, a :exc:`ValueError` is raised:" msgstr "" -#: ../../library/stdtypes.rst:5585 +#: ../../library/stdtypes.rst:5586 msgid "" "The default limit is 4300 digits as provided in :data:`sys.int_info." "default_max_str_digits `. The lowest limit that can be " @@ -6142,94 +6142,94 @@ msgid "" "str_digits_check_threshold `." msgstr "" -#: ../../library/stdtypes.rst:5590 +#: ../../library/stdtypes.rst:5591 msgid "Verification:" msgstr "" -#: ../../library/stdtypes.rst:5605 +#: ../../library/stdtypes.rst:5606 msgid "Affected APIs" msgstr "" -#: ../../library/stdtypes.rst:5607 +#: ../../library/stdtypes.rst:5608 msgid "" "The limitation only applies to potentially slow conversions between :class:" "`int` and :class:`str` or :class:`bytes`:" msgstr "" -#: ../../library/stdtypes.rst:5610 +#: ../../library/stdtypes.rst:5611 msgid "``int(string)`` with default base 10." msgstr "" -#: ../../library/stdtypes.rst:5611 +#: ../../library/stdtypes.rst:5612 msgid "``int(string, base)`` for all bases that are not a power of 2." msgstr "" -#: ../../library/stdtypes.rst:5612 +#: ../../library/stdtypes.rst:5613 msgid "``str(integer)``." msgstr "``str(integer)``。" -#: ../../library/stdtypes.rst:5613 +#: ../../library/stdtypes.rst:5614 msgid "``repr(integer)``." msgstr "``repr(integer)``。" -#: ../../library/stdtypes.rst:5614 +#: ../../library/stdtypes.rst:5615 msgid "" "any other string conversion to base 10, for example ``f\"{integer}\"``, " "``\"{}\".format(integer)``, or ``b\"%d\" % integer``." msgstr "" -#: ../../library/stdtypes.rst:5617 +#: ../../library/stdtypes.rst:5618 msgid "The limitations do not apply to functions with a linear algorithm:" msgstr "" -#: ../../library/stdtypes.rst:5619 +#: ../../library/stdtypes.rst:5620 msgid "``int(string, base)`` with base 2, 4, 8, 16, or 32." msgstr "" -#: ../../library/stdtypes.rst:5620 +#: ../../library/stdtypes.rst:5621 msgid ":func:`int.from_bytes` and :func:`int.to_bytes`." msgstr "" -#: ../../library/stdtypes.rst:5621 +#: ../../library/stdtypes.rst:5622 msgid ":func:`hex`, :func:`oct`, :func:`bin`." msgstr "" -#: ../../library/stdtypes.rst:5622 +#: ../../library/stdtypes.rst:5623 msgid ":ref:`formatspec` for hex, octal, and binary numbers." msgstr "" -#: ../../library/stdtypes.rst:5623 +#: ../../library/stdtypes.rst:5624 msgid ":class:`str` to :class:`float`." msgstr "" -#: ../../library/stdtypes.rst:5624 +#: ../../library/stdtypes.rst:5625 msgid ":class:`str` to :class:`decimal.Decimal`." msgstr "" -#: ../../library/stdtypes.rst:5627 +#: ../../library/stdtypes.rst:5628 msgid "Configuring the limit" msgstr "" -#: ../../library/stdtypes.rst:5629 +#: ../../library/stdtypes.rst:5630 msgid "" "Before Python starts up you can use an environment variable or an " "interpreter command line flag to configure the limit:" msgstr "" -#: ../../library/stdtypes.rst:5632 +#: ../../library/stdtypes.rst:5633 msgid "" ":envvar:`PYTHONINTMAXSTRDIGITS`, e.g. ``PYTHONINTMAXSTRDIGITS=640 python3`` " "to set the limit to 640 or ``PYTHONINTMAXSTRDIGITS=0 python3`` to disable " "the limitation." msgstr "" -#: ../../library/stdtypes.rst:5635 +#: ../../library/stdtypes.rst:5636 msgid "" ":option:`-X int_max_str_digits <-X>`, e.g. ``python3 -X " "int_max_str_digits=640``" msgstr "" -#: ../../library/stdtypes.rst:5637 +#: ../../library/stdtypes.rst:5638 msgid "" ":data:`sys.flags.int_max_str_digits` contains the value of :envvar:" "`PYTHONINTMAXSTRDIGITS` or :option:`-X int_max_str_digits <-X>`. If both the " @@ -6238,38 +6238,38 @@ msgid "" "int_info.default_max_str_digits` was used during initialization." msgstr "" -#: ../../library/stdtypes.rst:5643 +#: ../../library/stdtypes.rst:5644 msgid "" "From code, you can inspect the current limit and set a new one using these :" "mod:`sys` APIs:" msgstr "" -#: ../../library/stdtypes.rst:5646 +#: ../../library/stdtypes.rst:5647 msgid "" ":func:`sys.get_int_max_str_digits` and :func:`sys.set_int_max_str_digits` " "are a getter and setter for the interpreter-wide limit. Subinterpreters have " "their own limit." msgstr "" -#: ../../library/stdtypes.rst:5650 +#: ../../library/stdtypes.rst:5651 msgid "" "Information about the default and minimum can be found in :data:`sys." "int_info`:" msgstr "" -#: ../../library/stdtypes.rst:5652 +#: ../../library/stdtypes.rst:5653 msgid "" ":data:`sys.int_info.default_max_str_digits ` is the compiled-" "in default limit." msgstr "" -#: ../../library/stdtypes.rst:5654 +#: ../../library/stdtypes.rst:5655 msgid "" ":data:`sys.int_info.str_digits_check_threshold ` is the lowest " "accepted value for the limit (other than 0 which disables it)." msgstr "" -#: ../../library/stdtypes.rst:5661 +#: ../../library/stdtypes.rst:5662 msgid "" "Setting a low limit *can* lead to problems. While rare, code exists that " "contains integer constants in decimal in their source that exceed the " @@ -6281,7 +6281,7 @@ msgid "" "constants is to convert them to ``0x`` hexadecimal form as it has no limit." msgstr "" -#: ../../library/stdtypes.rst:5670 +#: ../../library/stdtypes.rst:5671 msgid "" "Test your application thoroughly if you use a low limit. Ensure your tests " "run with the limit set early via the environment or flag so that it applies " @@ -6289,11 +6289,11 @@ msgid "" "to precompile ``.py`` sources to ``.pyc`` files." msgstr "" -#: ../../library/stdtypes.rst:5676 +#: ../../library/stdtypes.rst:5677 msgid "Recommended configuration" msgstr "" -#: ../../library/stdtypes.rst:5678 +#: ../../library/stdtypes.rst:5679 msgid "" "The default :data:`sys.int_info.default_max_str_digits` is expected to be " "reasonable for most applications. If your application requires a different " @@ -6301,42 +6301,42 @@ msgid "" "as these APIs were added in security patch releases in versions before 3.12." msgstr "" -#: ../../library/stdtypes.rst:5683 +#: ../../library/stdtypes.rst:5684 msgid "Example::" msgstr "範例： ::" -#: ../../library/stdtypes.rst:5695 +#: ../../library/stdtypes.rst:5696 msgid "If you need to disable it entirely, set it to ``0``." msgstr "" -#: ../../library/stdtypes.rst:5699 +#: ../../library/stdtypes.rst:5700 msgid "Footnotes" msgstr "註解" -#: ../../library/stdtypes.rst:5700 +#: ../../library/stdtypes.rst:5701 msgid "" "Additional information on these special methods may be found in the Python " "Reference Manual (:ref:`customization`)." msgstr "" -#: ../../library/stdtypes.rst:5703 +#: ../../library/stdtypes.rst:5704 msgid "" "As a consequence, the list ``[1, 2]`` is considered equal to ``[1.0, 2.0]``, " "and similarly for tuples." msgstr "" -#: ../../library/stdtypes.rst:5706 +#: ../../library/stdtypes.rst:5707 msgid "They must have since the parser can't tell the type of the operands." msgstr "" -#: ../../library/stdtypes.rst:5708 +#: ../../library/stdtypes.rst:5709 msgid "" "Cased characters are those with general category property being one of " "\"Lu\" (Letter, uppercase), \"Ll\" (Letter, lowercase), or \"Lt\" (Letter, " "titlecase)." msgstr "" -#: ../../library/stdtypes.rst:5711 +#: ../../library/stdtypes.rst:5712 msgid "" "To format only a tuple you should therefore provide a singleton tuple whose " "only element is the tuple to be formatted." @@ -6349,13 +6349,13 @@ msgstr "built-in（內建）" #: ../../library/stdtypes.rst:13 ../../library/stdtypes.rst:316 #: ../../library/stdtypes.rst:393 ../../library/stdtypes.rst:950 #: ../../library/stdtypes.rst:1117 ../../library/stdtypes.rst:1139 -#: ../../library/stdtypes.rst:1154 ../../library/stdtypes.rst:4425 -#: ../../library/stdtypes.rst:5408 +#: ../../library/stdtypes.rst:1154 ../../library/stdtypes.rst:4426 +#: ../../library/stdtypes.rst:5409 msgid "types" msgstr "type（型別）" #: ../../library/stdtypes.rst:34 ../../library/stdtypes.rst:1154 -#: ../../library/stdtypes.rst:4425 +#: ../../library/stdtypes.rst:4426 msgid "statement" msgstr "statement（陳述式）" @@ -6474,14 +6474,14 @@ msgstr "is not" #: ../../library/stdtypes.rst:163 ../../library/stdtypes.rst:208 #: ../../library/stdtypes.rst:934 ../../library/stdtypes.rst:1117 -#: ../../library/stdtypes.rst:1139 ../../library/stdtypes.rst:1259 -#: ../../library/stdtypes.rst:1338 ../../library/stdtypes.rst:1382 -#: ../../library/stdtypes.rst:1503 ../../library/stdtypes.rst:1539 -#: ../../library/stdtypes.rst:2516 ../../library/stdtypes.rst:2535 -#: ../../library/stdtypes.rst:2642 ../../library/stdtypes.rst:4223 -#: ../../library/stdtypes.rst:4425 ../../library/stdtypes.rst:4903 -#: ../../library/stdtypes.rst:5158 ../../library/stdtypes.rst:5328 -#: ../../library/stdtypes.rst:5372 +#: ../../library/stdtypes.rst:1139 ../../library/stdtypes.rst:1260 +#: ../../library/stdtypes.rst:1339 ../../library/stdtypes.rst:1383 +#: ../../library/stdtypes.rst:1504 ../../library/stdtypes.rst:1540 +#: ../../library/stdtypes.rst:2517 ../../library/stdtypes.rst:2536 +#: ../../library/stdtypes.rst:2643 ../../library/stdtypes.rst:4224 +#: ../../library/stdtypes.rst:4426 ../../library/stdtypes.rst:4904 +#: ../../library/stdtypes.rst:5159 ../../library/stdtypes.rst:5329 +#: ../../library/stdtypes.rst:5373 msgid "object" msgstr "object（物件）" @@ -6573,9 +6573,9 @@ msgid "arithmetic" msgstr "arithmetic（算術）" #: ../../library/stdtypes.rst:246 ../../library/stdtypes.rst:950 -#: ../../library/stdtypes.rst:1117 ../../library/stdtypes.rst:4425 -#: ../../library/stdtypes.rst:5379 ../../library/stdtypes.rst:5393 -#: ../../library/stdtypes.rst:5408 +#: ../../library/stdtypes.rst:1117 ../../library/stdtypes.rst:4426 +#: ../../library/stdtypes.rst:5380 ../../library/stdtypes.rst:5394 +#: ../../library/stdtypes.rst:5409 msgid "built-in function" msgstr "built-in function（內建函式）" @@ -6591,8 +6591,8 @@ msgstr "float" msgid "complex" msgstr "complex（複數）" -#: ../../library/stdtypes.rst:246 ../../library/stdtypes.rst:2392 -#: ../../library/stdtypes.rst:3611 +#: ../../library/stdtypes.rst:246 ../../library/stdtypes.rst:2393 +#: ../../library/stdtypes.rst:3612 msgid "+ (plus)" msgstr "+ （加號）" @@ -6604,13 +6604,13 @@ msgstr "unary operator（一元運算子）" msgid "binary operator" msgstr "binary operator（二元運算子）" -#: ../../library/stdtypes.rst:246 ../../library/stdtypes.rst:2392 -#: ../../library/stdtypes.rst:3611 +#: ../../library/stdtypes.rst:246 ../../library/stdtypes.rst:2393 +#: ../../library/stdtypes.rst:3612 msgid "- (minus)" msgstr "- （減號）" -#: ../../library/stdtypes.rst:246 ../../library/stdtypes.rst:2349 -#: ../../library/stdtypes.rst:3568 +#: ../../library/stdtypes.rst:246 ../../library/stdtypes.rst:2350 +#: ../../library/stdtypes.rst:3569 msgid "* (asterisk)" msgstr "* （星號）" @@ -6622,8 +6622,8 @@ msgstr "/ （斜線）" msgid "//" msgstr "//" -#: ../../library/stdtypes.rst:246 ../../library/stdtypes.rst:2319 -#: ../../library/stdtypes.rst:3536 +#: ../../library/stdtypes.rst:246 ../../library/stdtypes.rst:2320 +#: ../../library/stdtypes.rst:3537 msgid "% (percent)" msgstr "% （百分號）" @@ -6633,7 +6633,7 @@ msgstr "**" #: ../../library/stdtypes.rst:316 ../../library/stdtypes.rst:393 #: ../../library/stdtypes.rst:950 ../../library/stdtypes.rst:1154 -#: ../../library/stdtypes.rst:4425 +#: ../../library/stdtypes.rst:4426 msgid "operations on" msgstr "operations on（操作於）" @@ -6641,8 +6641,8 @@ msgstr "operations on（操作於）" msgid "conjugate() (complex number method)" msgstr "conjugate()（複數方法）" -#: ../../library/stdtypes.rst:335 ../../library/stdtypes.rst:1605 -#: ../../library/stdtypes.rst:2516 ../../library/stdtypes.rst:5408 +#: ../../library/stdtypes.rst:335 ../../library/stdtypes.rst:1606 +#: ../../library/stdtypes.rst:2517 ../../library/stdtypes.rst:5409 msgid "module" msgstr "模組" @@ -6710,7 +6710,7 @@ msgstr "values" msgid "iterator protocol" msgstr "iterator protocol（疊代器協定）" -#: ../../library/stdtypes.rst:847 ../../library/stdtypes.rst:4818 +#: ../../library/stdtypes.rst:847 ../../library/stdtypes.rst:4819 msgid "protocol" msgstr "protocol（協定）" @@ -6736,7 +6736,7 @@ msgstr "container（容器）" msgid "iteration over" msgstr "iteration over（疊代於）" -#: ../../library/stdtypes.rst:950 ../../library/stdtypes.rst:4425 +#: ../../library/stdtypes.rst:950 ../../library/stdtypes.rst:4426 msgid "len" msgstr "len" @@ -6796,7 +6796,7 @@ msgstr "loop over（迴圈）" msgid "immutable" msgstr "immutable（不可變）" -#: ../../library/stdtypes.rst:1117 ../../library/stdtypes.rst:1338 +#: ../../library/stdtypes.rst:1117 ../../library/stdtypes.rst:1339 msgid "tuple" msgstr "tuple（元組）" @@ -6809,18 +6809,18 @@ msgid "mutable" msgstr "mutable（可變）" #: ../../library/stdtypes.rst:1139 ../../library/stdtypes.rst:1154 -#: ../../library/stdtypes.rst:1259 +#: ../../library/stdtypes.rst:1260 msgid "list" msgstr "list（串列）" -#: ../../library/stdtypes.rst:1139 ../../library/stdtypes.rst:2516 -#: ../../library/stdtypes.rst:2642 ../../library/stdtypes.rst:2714 -#: ../../library/stdtypes.rst:3536 +#: ../../library/stdtypes.rst:1139 ../../library/stdtypes.rst:2517 +#: ../../library/stdtypes.rst:2643 ../../library/stdtypes.rst:2715 +#: ../../library/stdtypes.rst:3537 msgid "bytearray" msgstr "bytearray（位元組陣列）" -#: ../../library/stdtypes.rst:1154 ../../library/stdtypes.rst:4425 -#: ../../library/stdtypes.rst:5158 ../../library/stdtypes.rst:5408 +#: ../../library/stdtypes.rst:1154 ../../library/stdtypes.rst:4426 +#: ../../library/stdtypes.rst:5159 ../../library/stdtypes.rst:5409 msgid "type" msgstr "type（型別）" @@ -6828,7 +6828,7 @@ msgstr "type（型別）" msgid "assignment" msgstr "assignment（賦值）" -#: ../../library/stdtypes.rst:1154 ../../library/stdtypes.rst:4425 +#: ../../library/stdtypes.rst:1154 ../../library/stdtypes.rst:4426 msgid "del" msgstr "del" @@ -6864,227 +6864,227 @@ msgstr "remove()（序列方法）" msgid "reverse() (sequence method)" msgstr "reverse()（序列方法）" -#: ../../library/stdtypes.rst:1382 +#: ../../library/stdtypes.rst:1383 msgid "range" msgstr "range" -#: ../../library/stdtypes.rst:1503 ../../library/stdtypes.rst:1552 -#: ../../library/stdtypes.rst:1597 ../../library/stdtypes.rst:2319 +#: ../../library/stdtypes.rst:1504 ../../library/stdtypes.rst:1553 +#: ../../library/stdtypes.rst:1598 ../../library/stdtypes.rst:2320 msgid "string" msgstr "string（字串）" -#: ../../library/stdtypes.rst:1503 +#: ../../library/stdtypes.rst:1504 msgid "text sequence type" msgstr "text sequence type（文字序列型別）" -#: ../../library/stdtypes.rst:1503 ../../library/stdtypes.rst:1552 -#: ../../library/stdtypes.rst:1570 +#: ../../library/stdtypes.rst:1504 ../../library/stdtypes.rst:1553 +#: ../../library/stdtypes.rst:1571 msgid "str (built-in class)" msgstr "str（內建類別）" -#: ../../library/stdtypes.rst:1503 +#: ../../library/stdtypes.rst:1504 msgid "(see also string)" msgstr "（亦請見 string）" -#: ../../library/stdtypes.rst:1539 +#: ../../library/stdtypes.rst:1540 msgid "io.StringIO" msgstr "io.StringIO" -#: ../../library/stdtypes.rst:1570 ../../library/stdtypes.rst:2508 +#: ../../library/stdtypes.rst:1571 ../../library/stdtypes.rst:2509 msgid "buffer protocol" msgstr "buffer protocol（緩衝區協定）" -#: ../../library/stdtypes.rst:1570 ../../library/stdtypes.rst:2516 -#: ../../library/stdtypes.rst:2535 ../../library/stdtypes.rst:2714 -#: ../../library/stdtypes.rst:3536 +#: ../../library/stdtypes.rst:1571 ../../library/stdtypes.rst:2517 +#: ../../library/stdtypes.rst:2536 ../../library/stdtypes.rst:2715 +#: ../../library/stdtypes.rst:3537 msgid "bytes" msgstr "bytes（位元組）" -#: ../../library/stdtypes.rst:1597 ../../library/stdtypes.rst:2714 +#: ../../library/stdtypes.rst:1598 ../../library/stdtypes.rst:2715 msgid "methods" msgstr "methods（方法）" -#: ../../library/stdtypes.rst:1605 +#: ../../library/stdtypes.rst:1606 msgid "re" msgstr "re" -#: ../../library/stdtypes.rst:2127 ../../library/stdtypes.rst:3390 +#: ../../library/stdtypes.rst:2128 ../../library/stdtypes.rst:3391 msgid "universal newlines" msgstr "universal newlines" -#: ../../library/stdtypes.rst:2127 +#: ../../library/stdtypes.rst:2128 msgid "str.splitlines method" msgstr "str.splitlines 方法" -#: ../../library/stdtypes.rst:2319 +#: ../../library/stdtypes.rst:2320 msgid "formatting, string (%)" msgstr "formatting（格式化）、字串 (%)" -#: ../../library/stdtypes.rst:2319 +#: ../../library/stdtypes.rst:2320 msgid "interpolation, string (%)" msgstr "interpolation（插值）、字串 (%)" -#: ../../library/stdtypes.rst:2319 +#: ../../library/stdtypes.rst:2320 msgid "formatting, printf" msgstr "formatting（格式化）、printf" -#: ../../library/stdtypes.rst:2319 +#: ../../library/stdtypes.rst:2320 msgid "interpolation, printf" msgstr "interpolation（插值）、printf" -#: ../../library/stdtypes.rst:2319 ../../library/stdtypes.rst:3536 +#: ../../library/stdtypes.rst:2320 ../../library/stdtypes.rst:3537 msgid "printf-style formatting" msgstr "printf 風格格式化" -#: ../../library/stdtypes.rst:2319 ../../library/stdtypes.rst:3536 +#: ../../library/stdtypes.rst:2320 ../../library/stdtypes.rst:3537 msgid "sprintf-style formatting" msgstr "sprintf 風格格式化" -#: ../../library/stdtypes.rst:2349 ../../library/stdtypes.rst:3568 +#: ../../library/stdtypes.rst:2350 ../../library/stdtypes.rst:3569 msgid "() (parentheses)" msgstr "() （圓括號）" -#: ../../library/stdtypes.rst:2349 ../../library/stdtypes.rst:2392 -#: ../../library/stdtypes.rst:3568 ../../library/stdtypes.rst:3611 +#: ../../library/stdtypes.rst:2350 ../../library/stdtypes.rst:2393 +#: ../../library/stdtypes.rst:3569 ../../library/stdtypes.rst:3612 msgid "in printf-style formatting" msgstr "於 printf 風格格式化" -#: ../../library/stdtypes.rst:2349 ../../library/stdtypes.rst:3568 +#: ../../library/stdtypes.rst:2350 ../../library/stdtypes.rst:3569 msgid ". (dot)" msgstr ". （點）" -#: ../../library/stdtypes.rst:2392 ../../library/stdtypes.rst:3611 +#: ../../library/stdtypes.rst:2393 ../../library/stdtypes.rst:3612 msgid "# (hash)" msgstr "# （井字號）" -#: ../../library/stdtypes.rst:2392 ../../library/stdtypes.rst:3611 +#: ../../library/stdtypes.rst:2393 ../../library/stdtypes.rst:3612 msgid "space" msgstr "space（空白）" -#: ../../library/stdtypes.rst:2508 +#: ../../library/stdtypes.rst:2509 msgid "binary sequence types" msgstr "binary sequence types（二進位序列型別）" -#: ../../library/stdtypes.rst:2516 +#: ../../library/stdtypes.rst:2517 msgid "memoryview" msgstr "memoryview（記憶體視圖）" -#: ../../library/stdtypes.rst:2516 +#: ../../library/stdtypes.rst:2517 msgid "array" msgstr "array（陣列）" -#: ../../library/stdtypes.rst:3390 +#: ../../library/stdtypes.rst:3391 msgid "bytes.splitlines method" msgstr "bytes.splitlines 方法" -#: ../../library/stdtypes.rst:3390 +#: ../../library/stdtypes.rst:3391 msgid "bytearray.splitlines method" msgstr "bytearray.splitlines 方法" -#: ../../library/stdtypes.rst:3536 +#: ../../library/stdtypes.rst:3537 msgid "formatting" msgstr "formatting（格式化）" -#: ../../library/stdtypes.rst:3536 +#: ../../library/stdtypes.rst:3537 msgid "bytes (%)" msgstr "bytes (%)" -#: ../../library/stdtypes.rst:3536 +#: ../../library/stdtypes.rst:3537 msgid "bytearray (%)" msgstr "bytearray (%)" -#: ../../library/stdtypes.rst:3536 +#: ../../library/stdtypes.rst:3537 msgid "interpolation" msgstr "interpolation（插值）" -#: ../../library/stdtypes.rst:4223 +#: ../../library/stdtypes.rst:4224 msgid "set" msgstr "set（集合）" -#: ../../library/stdtypes.rst:4425 +#: ../../library/stdtypes.rst:4426 msgid "mapping" msgstr "mapping（對映）" -#: ../../library/stdtypes.rst:4425 +#: ../../library/stdtypes.rst:4426 msgid "dictionary" msgstr "dictionary（字典）" -#: ../../library/stdtypes.rst:4508 +#: ../../library/stdtypes.rst:4509 msgid "__missing__()" msgstr "__missing__()" -#: ../../library/stdtypes.rst:4818 +#: ../../library/stdtypes.rst:4819 msgid "context manager" msgstr "context manager（情境管理器）" -#: ../../library/stdtypes.rst:4818 +#: ../../library/stdtypes.rst:4819 msgid "context management protocol" msgstr "context management protocol（情境管理協定）" -#: ../../library/stdtypes.rst:4818 +#: ../../library/stdtypes.rst:4819 msgid "context management" msgstr "context management（情境管理）" -#: ../../library/stdtypes.rst:4891 +#: ../../library/stdtypes.rst:4892 msgid "annotation" msgstr "annotation（註記）" -#: ../../library/stdtypes.rst:4891 +#: ../../library/stdtypes.rst:4892 msgid "type annotation; type hint" msgstr "type annotation（型別註記）；type hint（型別提示）" -#: ../../library/stdtypes.rst:4903 +#: ../../library/stdtypes.rst:4904 msgid "GenericAlias" msgstr "GenericAlias（泛型別名）" -#: ../../library/stdtypes.rst:4903 +#: ../../library/stdtypes.rst:4904 msgid "Generic" msgstr "Generic（泛型）" -#: ../../library/stdtypes.rst:4903 +#: ../../library/stdtypes.rst:4904 msgid "Alias" msgstr "Alias（別名）" -#: ../../library/stdtypes.rst:5158 +#: ../../library/stdtypes.rst:5159 msgid "Union" msgstr "Union（聯集）" -#: ../../library/stdtypes.rst:5158 +#: ../../library/stdtypes.rst:5159 msgid "union" msgstr "union（聯集）" -#: ../../library/stdtypes.rst:5328 +#: ../../library/stdtypes.rst:5329 msgid "method" msgstr "method（方法）" -#: ../../library/stdtypes.rst:5372 +#: ../../library/stdtypes.rst:5373 msgid "code" msgstr "code（程式碼）" -#: ../../library/stdtypes.rst:5372 +#: ../../library/stdtypes.rst:5373 msgid "code object" msgstr "code object（程式碼物件）" -#: ../../library/stdtypes.rst:5379 +#: ../../library/stdtypes.rst:5380 msgid "compile" msgstr "compile（編譯）" -#: ../../library/stdtypes.rst:5379 +#: ../../library/stdtypes.rst:5380 msgid "__code__ (function object attribute)" msgstr "__code__（函式物件屬性）" -#: ../../library/stdtypes.rst:5393 +#: ../../library/stdtypes.rst:5394 msgid "exec" msgstr "exec" -#: ../../library/stdtypes.rst:5393 +#: ../../library/stdtypes.rst:5394 msgid "eval" msgstr "eval" -#: ../../library/stdtypes.rst:5432 +#: ../../library/stdtypes.rst:5433 msgid "..." msgstr "..." -#: ../../library/stdtypes.rst:5432 +#: ../../library/stdtypes.rst:5433 msgid "ellipsis literal" msgstr "ellipsis literal（刪節號）" diff --git a/reference/datamodel.po b/reference/datamodel.po index 98118eee21..a175709e58 100644 --- a/reference/datamodel.po +++ b/reference/datamodel.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-08-04 00:03+0000\n" +"POT-Creation-Date: 2024-08-08 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:17+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -128,18 +128,22 @@ msgid "" "object identity is affected in some sense: for immutable types, operations " "that compute new values may actually return a reference to any existing " "object with the same type and value, while for mutable objects this is not " -"allowed. E.g., after ``a = 1; b = 1``, ``a`` and ``b`` may or may not refer " -"to the same object with the value one, depending on the implementation, but " -"after ``c = []; d = []``, ``c`` and ``d`` are guaranteed to refer to two " -"different, unique, newly created empty lists. (Note that ``c = d = []`` " -"assigns the same object to both ``c`` and ``d``.)" -msgstr "" - -#: ../../reference/datamodel.rst:120 +"allowed. For example, after ``a = 1; b = 1``, *a* and *b* may or may not " +"refer to the same object with the value one, depending on the " +"implementation. This is because :class:`int` is an immutable type, so the " +"reference to ``1`` can be reused. This behaviour depends on the " +"implementation used, so should not be relied upon, but is something to be " +"aware of when making use of object identity tests. However, after ``c = []; " +"d = []``, *c* and *d* are guaranteed to refer to two different, unique, " +"newly created empty lists. (Note that ``e = f = []`` assigns the *same* " +"object to both *e* and *f*.)" +msgstr "" + +#: ../../reference/datamodel.rst:124 msgid "The standard type hierarchy" msgstr "標準型別階層" -#: ../../reference/datamodel.rst:129 +#: ../../reference/datamodel.rst:133 msgid "" "Below is a list of the types that are built into Python. Extension modules " "(written in C, Java, or other languages, depending on the implementation) " @@ -149,7 +153,7 @@ msgid "" "standard library instead." msgstr "" -#: ../../reference/datamodel.rst:140 +#: ../../reference/datamodel.rst:144 msgid "" "Some of the type descriptions below contain a paragraph listing 'special " "attributes.' These are attributes that provide access to the implementation " @@ -157,11 +161,11 @@ msgid "" "future." msgstr "" -#: ../../reference/datamodel.rst:146 ../../reference/datamodel.rst:148 +#: ../../reference/datamodel.rst:150 ../../reference/datamodel.rst:152 msgid "None" msgstr "" -#: ../../reference/datamodel.rst:150 +#: ../../reference/datamodel.rst:154 msgid "" "This type has a single value. There is a single object with this value. " "This object is accessed through the built-in name ``None``. It is used to " @@ -169,11 +173,11 @@ msgid "" "functions that don't explicitly return anything. Its truth value is false." msgstr "" -#: ../../reference/datamodel.rst:157 ../../reference/datamodel.rst:159 +#: ../../reference/datamodel.rst:161 ../../reference/datamodel.rst:163 msgid "NotImplemented" msgstr "NotImplemented" -#: ../../reference/datamodel.rst:161 +#: ../../reference/datamodel.rst:165 msgid "" "This type has a single value. There is a single object with this value. " "This object is accessed through the built-in name :data:`NotImplemented`. " @@ -183,33 +187,33 @@ msgid "" "the operator.) It should not be evaluated in a boolean context." msgstr "" -#: ../../reference/datamodel.rst:168 +#: ../../reference/datamodel.rst:172 msgid "See :ref:`implementing-the-arithmetic-operations` for more details." msgstr "更多細節請見 :ref:`implementing-the-arithmetic-operations`。" -#: ../../reference/datamodel.rst:172 +#: ../../reference/datamodel.rst:176 msgid "" "Evaluating :data:`NotImplemented` in a boolean context is deprecated. While " "it currently evaluates as true, it will emit a :exc:`DeprecationWarning`. It " "will raise a :exc:`TypeError` in a future version of Python." msgstr "" -#: ../../reference/datamodel.rst:179 ../../reference/datamodel.rst:180 +#: ../../reference/datamodel.rst:183 ../../reference/datamodel.rst:184 msgid "Ellipsis" msgstr "" -#: ../../reference/datamodel.rst:184 +#: ../../reference/datamodel.rst:188 msgid "" "This type has a single value. There is a single object with this value. " "This object is accessed through the literal ``...`` or the built-in name " "``Ellipsis``. Its truth value is true." msgstr "" -#: ../../reference/datamodel.rst:190 +#: ../../reference/datamodel.rst:194 msgid ":class:`numbers.Number`" msgstr ":class:`numbers.Number`" -#: ../../reference/datamodel.rst:194 +#: ../../reference/datamodel.rst:198 msgid "" "These are created by numeric literals and returned as results by arithmetic " "operators and arithmetic built-in functions. Numeric objects are immutable; " @@ -218,71 +222,71 @@ msgid "" "numerical representation in computers." msgstr "" -#: ../../reference/datamodel.rst:200 +#: ../../reference/datamodel.rst:204 msgid "" "The string representations of the numeric classes, computed by :meth:" "`~object.__repr__` and :meth:`~object.__str__`, have the following " "properties:" msgstr "" -#: ../../reference/datamodel.rst:204 +#: ../../reference/datamodel.rst:208 msgid "" "They are valid numeric literals which, when passed to their class " "constructor, produce an object having the value of the original numeric." msgstr "" -#: ../../reference/datamodel.rst:208 +#: ../../reference/datamodel.rst:212 msgid "The representation is in base 10, when possible." msgstr "" -#: ../../reference/datamodel.rst:210 +#: ../../reference/datamodel.rst:214 msgid "" "Leading zeros, possibly excepting a single zero before a decimal point, are " "not shown." msgstr "" -#: ../../reference/datamodel.rst:213 +#: ../../reference/datamodel.rst:217 msgid "" "Trailing zeros, possibly excepting a single zero after a decimal point, are " "not shown." msgstr "" -#: ../../reference/datamodel.rst:216 +#: ../../reference/datamodel.rst:220 msgid "A sign is shown only when the number is negative." msgstr "" -#: ../../reference/datamodel.rst:218 +#: ../../reference/datamodel.rst:222 msgid "" "Python distinguishes between integers, floating-point numbers, and complex " "numbers:" msgstr "" -#: ../../reference/datamodel.rst:223 +#: ../../reference/datamodel.rst:227 msgid ":class:`numbers.Integral`" msgstr ":class:`numbers.Integral`" -#: ../../reference/datamodel.rst:227 +#: ../../reference/datamodel.rst:231 msgid "" "These represent elements from the mathematical set of integers (positive and " "negative)." msgstr "" -#: ../../reference/datamodel.rst:233 +#: ../../reference/datamodel.rst:237 msgid "" "The rules for integer representation are intended to give the most " "meaningful interpretation of shift and mask operations involving negative " "integers." msgstr "" -#: ../../reference/datamodel.rst:236 +#: ../../reference/datamodel.rst:240 msgid "There are two types of integers:" msgstr "" -#: ../../reference/datamodel.rst:238 +#: ../../reference/datamodel.rst:242 msgid "Integers (:class:`int`)" msgstr "" -#: ../../reference/datamodel.rst:239 +#: ../../reference/datamodel.rst:243 msgid "" "These represent numbers in an unlimited range, subject to available " "(virtual) memory only. For the purpose of shift and mask operations, a " @@ -291,11 +295,11 @@ msgid "" "sign bits extending to the left." msgstr "" -#: ../../reference/datamodel.rst:245 +#: ../../reference/datamodel.rst:249 msgid "Booleans (:class:`bool`)" msgstr "" -#: ../../reference/datamodel.rst:251 +#: ../../reference/datamodel.rst:255 msgid "" "These represent the truth values False and True. The two objects " "representing the values ``False`` and ``True`` are the only Boolean objects. " @@ -305,11 +309,11 @@ msgid "" "``\"True\"`` are returned, respectively." msgstr "" -#: ../../reference/datamodel.rst:259 +#: ../../reference/datamodel.rst:263 msgid ":class:`numbers.Real` (:class:`float`)" msgstr ":class:`numbers.Real` (:class:`float`)" -#: ../../reference/datamodel.rst:267 +#: ../../reference/datamodel.rst:271 msgid "" "These represent machine-level double precision floating-point numbers. You " "are at the mercy of the underlying machine architecture (and C or Java " @@ -320,11 +324,11 @@ msgid "" "complicate the language with two kinds of floating-point numbers." msgstr "" -#: ../../reference/datamodel.rst:277 +#: ../../reference/datamodel.rst:281 msgid ":class:`numbers.Complex` (:class:`complex`)" msgstr ":class:`numbers.Complex` (:class:`complex`)" -#: ../../reference/datamodel.rst:283 +#: ../../reference/datamodel.rst:287 msgid "" "These represent complex numbers as a pair of machine-level double precision " "floating-point numbers. The same caveats apply as for floating-point " @@ -332,11 +336,11 @@ msgid "" "retrieved through the read-only attributes ``z.real`` and ``z.imag``." msgstr "" -#: ../../reference/datamodel.rst:290 +#: ../../reference/datamodel.rst:294 msgid "Sequences" msgstr "" -#: ../../reference/datamodel.rst:299 +#: ../../reference/datamodel.rst:303 msgid "" "These represent finite ordered sets indexed by non-negative numbers. The " "built-in function :func:`len` returns the number of items of a sequence. " @@ -347,7 +351,7 @@ msgid "" "second to last item of sequence a with length ``n``." msgstr "" -#: ../../reference/datamodel.rst:309 +#: ../../reference/datamodel.rst:313 msgid "" "Sequences also support slicing: ``a[i:j]`` selects all items with index *k* " "such that *i* ``<=`` *k* ``<`` *j*. When used as an expression, a slice is " @@ -355,22 +359,22 @@ msgid "" "applies to negative slice positions." msgstr "" -#: ../../reference/datamodel.rst:314 +#: ../../reference/datamodel.rst:318 msgid "" "Some sequences also support \"extended slicing\" with a third \"step\" " "parameter: ``a[i:j:k]`` selects all items of *a* with index *x* where ``x = " "i + n*k``, *n* ``>=`` ``0`` and *i* ``<=`` *x* ``<`` *j*." msgstr "" -#: ../../reference/datamodel.rst:318 +#: ../../reference/datamodel.rst:322 msgid "Sequences are distinguished according to their mutability:" msgstr "" -#: ../../reference/datamodel.rst:322 +#: ../../reference/datamodel.rst:326 msgid "Immutable sequences" msgstr "" -#: ../../reference/datamodel.rst:328 +#: ../../reference/datamodel.rst:332 msgid "" "An object of an immutable sequence type cannot change once it is created. " "(If the object contains references to other objects, these other objects may " @@ -378,15 +382,15 @@ msgid "" "referenced by an immutable object cannot change.)" msgstr "" -#: ../../reference/datamodel.rst:333 +#: ../../reference/datamodel.rst:337 msgid "The following types are immutable sequences:" msgstr "" -#: ../../reference/datamodel.rst:338 +#: ../../reference/datamodel.rst:342 msgid "Strings" msgstr "字串 (String)" -#: ../../reference/datamodel.rst:346 +#: ../../reference/datamodel.rst:350 msgid "" "A string is a sequence of values that represent Unicode code points. All the " "code points in the range ``U+0000 - U+10FFFF`` can be represented in a " @@ -400,11 +404,11 @@ msgid "" "to achieve the opposite." msgstr "" -#: ../../reference/datamodel.rst:358 +#: ../../reference/datamodel.rst:362 msgid "Tuples" msgstr "" -#: ../../reference/datamodel.rst:364 +#: ../../reference/datamodel.rst:368 msgid "" "The items of a tuple are arbitrary Python objects. Tuples of two or more " "items are formed by comma-separated lists of expressions. A tuple of one " @@ -414,11 +418,11 @@ msgid "" "empty pair of parentheses." msgstr "" -#: ../../reference/datamodel.rst:371 +#: ../../reference/datamodel.rst:375 msgid "Bytes" msgstr "" -#: ../../reference/datamodel.rst:374 +#: ../../reference/datamodel.rst:378 msgid "" "A bytes object is an immutable array. The items are 8-bit bytes, " "represented by integers in the range 0 <= x < 256. Bytes literals (like " @@ -427,43 +431,43 @@ msgid "" "the :meth:`~bytes.decode` method." msgstr "" -#: ../../reference/datamodel.rst:382 +#: ../../reference/datamodel.rst:386 msgid "Mutable sequences" msgstr "" -#: ../../reference/datamodel.rst:391 +#: ../../reference/datamodel.rst:395 msgid "" "Mutable sequences can be changed after they are created. The subscription " "and slicing notations can be used as the target of assignment and :keyword:" "`del` (delete) statements." msgstr "" -#: ../../reference/datamodel.rst:399 +#: ../../reference/datamodel.rst:403 msgid "" "The :mod:`collections` and :mod:`array` module provide additional examples " "of mutable sequence types." msgstr "" -#: ../../reference/datamodel.rst:402 +#: ../../reference/datamodel.rst:406 msgid "There are currently two intrinsic mutable sequence types:" msgstr "" -#: ../../reference/datamodel.rst:404 +#: ../../reference/datamodel.rst:408 msgid "Lists" msgstr "List（串列）" -#: ../../reference/datamodel.rst:407 +#: ../../reference/datamodel.rst:411 msgid "" "The items of a list are arbitrary Python objects. Lists are formed by " "placing a comma-separated list of expressions in square brackets. (Note that " "there are no special cases needed to form lists of length 0 or 1.)" msgstr "" -#: ../../reference/datamodel.rst:411 +#: ../../reference/datamodel.rst:415 msgid "Byte Arrays" msgstr "" -#: ../../reference/datamodel.rst:414 +#: ../../reference/datamodel.rst:418 msgid "" "A bytearray object is a mutable array. They are created by the built-in :" "func:`bytearray` constructor. Aside from being mutable (and hence " @@ -471,11 +475,11 @@ msgid "" "functionality as immutable :class:`bytes` objects." msgstr "" -#: ../../reference/datamodel.rst:421 +#: ../../reference/datamodel.rst:425 msgid "Set types" msgstr "" -#: ../../reference/datamodel.rst:427 +#: ../../reference/datamodel.rst:431 msgid "" "These represent unordered, finite sets of unique, immutable objects. As " "such, they cannot be indexed by any subscript. However, they can be iterated " @@ -485,7 +489,7 @@ msgid "" "union, difference, and symmetric difference." msgstr "" -#: ../../reference/datamodel.rst:434 +#: ../../reference/datamodel.rst:438 msgid "" "For set elements, the same immutability rules apply as for dictionary keys. " "Note that numeric types obey the normal rules for numeric comparison: if two " @@ -493,37 +497,37 @@ msgid "" "contained in a set." msgstr "" -#: ../../reference/datamodel.rst:439 +#: ../../reference/datamodel.rst:443 msgid "There are currently two intrinsic set types:" msgstr "" -#: ../../reference/datamodel.rst:442 +#: ../../reference/datamodel.rst:446 msgid "Sets" msgstr "" -#: ../../reference/datamodel.rst:445 +#: ../../reference/datamodel.rst:449 msgid "" "These represent a mutable set. They are created by the built-in :func:`set` " "constructor and can be modified afterwards by several methods, such as :meth:" "`~set.add`." msgstr "" -#: ../../reference/datamodel.rst:450 +#: ../../reference/datamodel.rst:454 msgid "Frozen sets" msgstr "" -#: ../../reference/datamodel.rst:453 +#: ../../reference/datamodel.rst:457 msgid "" "These represent an immutable set. They are created by the built-in :func:" "`frozenset` constructor. As a frozenset is immutable and :term:`hashable`, " "it can be used again as an element of another set, or as a dictionary key." msgstr "" -#: ../../reference/datamodel.rst:460 +#: ../../reference/datamodel.rst:464 msgid "Mappings" msgstr "" -#: ../../reference/datamodel.rst:467 +#: ../../reference/datamodel.rst:471 msgid "" "These represent finite sets of objects indexed by arbitrary index sets. The " "subscript notation ``a[k]`` selects the item indexed by ``k`` from the " @@ -532,15 +536,15 @@ msgid "" "returns the number of items in a mapping." msgstr "" -#: ../../reference/datamodel.rst:473 +#: ../../reference/datamodel.rst:477 msgid "There is currently a single intrinsic mapping type:" msgstr "" -#: ../../reference/datamodel.rst:477 +#: ../../reference/datamodel.rst:481 msgid "Dictionaries" msgstr "字典" -#: ../../reference/datamodel.rst:481 +#: ../../reference/datamodel.rst:485 msgid "" "These represent finite sets of objects indexed by nearly arbitrary values. " "The only types of values not acceptable as keys are values containing lists " @@ -552,7 +556,7 @@ msgid "" "interchangeably to index the same dictionary entry." msgstr "" -#: ../../reference/datamodel.rst:490 +#: ../../reference/datamodel.rst:494 msgid "" "Dictionaries preserve insertion order, meaning that keys will be produced in " "the same order they were added sequentially over the dictionary. Replacing " @@ -560,130 +564,130 @@ msgid "" "inserting it will add it to the end instead of keeping its old place." msgstr "" -#: ../../reference/datamodel.rst:495 +#: ../../reference/datamodel.rst:499 msgid "" "Dictionaries are mutable; they can be created by the ``{...}`` notation (see " "section :ref:`dict`)." msgstr "" -#: ../../reference/datamodel.rst:502 +#: ../../reference/datamodel.rst:506 msgid "" "The extension modules :mod:`dbm.ndbm` and :mod:`dbm.gnu` provide additional " "examples of mapping types, as does the :mod:`collections` module." msgstr "" -#: ../../reference/datamodel.rst:506 +#: ../../reference/datamodel.rst:510 msgid "" "Dictionaries did not preserve insertion order in versions of Python before " "3.6. In CPython 3.6, insertion order was preserved, but it was considered an " "implementation detail at that time rather than a language guarantee." msgstr "" -#: ../../reference/datamodel.rst:513 +#: ../../reference/datamodel.rst:517 msgid "Callable types" msgstr "" -#: ../../reference/datamodel.rst:521 +#: ../../reference/datamodel.rst:525 msgid "" "These are the types to which the function call operation (see section :ref:" "`calls`) can be applied:" msgstr "" -#: ../../reference/datamodel.rst:528 +#: ../../reference/datamodel.rst:532 msgid "User-defined functions" msgstr "自訂函式" -#: ../../reference/datamodel.rst:535 +#: ../../reference/datamodel.rst:539 msgid "" "A user-defined function object is created by a function definition (see " "section :ref:`function`). It should be called with an argument list " "containing the same number of items as the function's formal parameter list." msgstr "" -#: ../../reference/datamodel.rst:541 ../../reference/datamodel.rst:1120 -#: ../../reference/datamodel.rst:1315 +#: ../../reference/datamodel.rst:545 ../../reference/datamodel.rst:1124 +#: ../../reference/datamodel.rst:1319 msgid "Special read-only attributes" msgstr "特殊唯讀屬性" -#: ../../reference/datamodel.rst:551 ../../reference/datamodel.rst:585 +#: ../../reference/datamodel.rst:555 ../../reference/datamodel.rst:589 msgid "Attribute" msgstr "屬性" -#: ../../reference/datamodel.rst:552 ../../reference/datamodel.rst:586 +#: ../../reference/datamodel.rst:556 ../../reference/datamodel.rst:590 msgid "Meaning" msgstr "" -#: ../../reference/datamodel.rst:555 +#: ../../reference/datamodel.rst:559 msgid "" "A reference to the :class:`dictionary ` that holds the function's :ref:" "`global variables ` -- the global namespace of the module in which " "the function was defined." msgstr "" -#: ../../reference/datamodel.rst:560 +#: ../../reference/datamodel.rst:564 msgid "" "``None`` or a :class:`tuple` of cells that contain bindings for the " "function's free variables." msgstr "" -#: ../../reference/datamodel.rst:563 +#: ../../reference/datamodel.rst:567 msgid "" "A cell object has the attribute ``cell_contents``. This can be used to get " "the value of the cell, as well as set the value." msgstr "" -#: ../../reference/datamodel.rst:567 ../../reference/datamodel.rst:1352 +#: ../../reference/datamodel.rst:571 ../../reference/datamodel.rst:1356 msgid "Special writable attributes" msgstr "特殊可寫屬性" -#: ../../reference/datamodel.rst:580 +#: ../../reference/datamodel.rst:584 msgid "Most of these attributes check the type of the assigned value:" msgstr "" -#: ../../reference/datamodel.rst:589 +#: ../../reference/datamodel.rst:593 msgid "" "The function's documentation string, or ``None`` if unavailable. Not " "inherited by subclasses." msgstr "" -#: ../../reference/datamodel.rst:593 +#: ../../reference/datamodel.rst:597 msgid "" "The function's name. See also: :attr:`__name__ attributes `." msgstr "" -#: ../../reference/datamodel.rst:597 +#: ../../reference/datamodel.rst:601 msgid "" "The function's :term:`qualified name`. See also: :attr:`__qualname__ " "attributes `." msgstr "" -#: ../../reference/datamodel.rst:603 +#: ../../reference/datamodel.rst:607 msgid "" "The name of the module the function was defined in, or ``None`` if " "unavailable." msgstr "" -#: ../../reference/datamodel.rst:607 +#: ../../reference/datamodel.rst:611 msgid "" "A :class:`tuple` containing default :term:`parameter` values for those " "parameters that have defaults, or ``None`` if no parameters have a default " "value." msgstr "" -#: ../../reference/datamodel.rst:612 +#: ../../reference/datamodel.rst:616 msgid "" "The :ref:`code object ` representing the compiled function " "body." msgstr "代表編譯函式主體的\\ :ref:`程式碼物件 `。" -#: ../../reference/datamodel.rst:616 +#: ../../reference/datamodel.rst:620 msgid "" "The namespace supporting arbitrary function attributes. See also: :attr:" "`__dict__ attributes `." msgstr "" -#: ../../reference/datamodel.rst:620 +#: ../../reference/datamodel.rst:624 msgid "" "A :class:`dictionary ` containing annotations of :term:`parameters " "`. The keys of the dictionary are the parameter names, and " @@ -691,88 +695,88 @@ msgid "" "`annotations-howto`." msgstr "" -#: ../../reference/datamodel.rst:627 +#: ../../reference/datamodel.rst:631 msgid "" "A :class:`dictionary ` containing defaults for keyword-only :term:" "`parameters `." msgstr "" -#: ../../reference/datamodel.rst:631 +#: ../../reference/datamodel.rst:635 msgid "" "A :class:`tuple` containing the :ref:`type parameters ` of a :" "ref:`generic function `." msgstr "" -#: ../../reference/datamodel.rst:636 +#: ../../reference/datamodel.rst:640 msgid "" "Function objects also support getting and setting arbitrary attributes, " "which can be used, for example, to attach metadata to functions. Regular " "attribute dot-notation is used to get and set such attributes." msgstr "" -#: ../../reference/datamodel.rst:642 +#: ../../reference/datamodel.rst:646 msgid "" "CPython's current implementation only supports function attributes on user-" "defined functions. Function attributes on :ref:`built-in functions ` may be supported in the future." msgstr "" -#: ../../reference/datamodel.rst:647 +#: ../../reference/datamodel.rst:651 msgid "" "Additional information about a function's definition can be retrieved from " "its :ref:`code object ` (accessible via the :attr:`~function." "__code__` attribute)." msgstr "" -#: ../../reference/datamodel.rst:655 +#: ../../reference/datamodel.rst:659 msgid "Instance methods" msgstr "" -#: ../../reference/datamodel.rst:662 +#: ../../reference/datamodel.rst:666 msgid "" "An instance method object combines a class, a class instance and any " "callable object (normally a user-defined function)." msgstr "" -#: ../../reference/datamodel.rst:672 ../../reference/datamodel.rst:1443 +#: ../../reference/datamodel.rst:676 ../../reference/datamodel.rst:1447 msgid "Special read-only attributes:" msgstr "特殊唯讀屬性：" -#: ../../reference/datamodel.rst:677 +#: ../../reference/datamodel.rst:681 msgid "" "Refers to the class instance object to which the method is :ref:`bound " "`" msgstr "" -#: ../../reference/datamodel.rst:681 +#: ../../reference/datamodel.rst:685 msgid "Refers to the original :ref:`function object `" msgstr "" -#: ../../reference/datamodel.rst:684 +#: ../../reference/datamodel.rst:688 msgid "" "The method's documentation (same as :attr:`method.__func__.__doc__ `). A :class:`string ` if the original function had a " "docstring, else ``None``." msgstr "" -#: ../../reference/datamodel.rst:690 +#: ../../reference/datamodel.rst:694 msgid "" "The name of the method (same as :attr:`method.__func__.__name__ `)" msgstr "" -#: ../../reference/datamodel.rst:694 +#: ../../reference/datamodel.rst:698 msgid "" "The name of the module the method was defined in, or ``None`` if unavailable." msgstr "" -#: ../../reference/datamodel.rst:697 +#: ../../reference/datamodel.rst:701 msgid "" "Methods also support accessing (but not setting) the arbitrary function " "attributes on the underlying :ref:`function object `." msgstr "" -#: ../../reference/datamodel.rst:700 +#: ../../reference/datamodel.rst:704 msgid "" "User-defined method objects may be created when getting an attribute of a " "class (perhaps via an instance of that class), if that attribute is a user-" @@ -780,7 +784,7 @@ msgid "" "`classmethod` object." msgstr "" -#: ../../reference/datamodel.rst:707 +#: ../../reference/datamodel.rst:711 msgid "" "When an instance method object is created by retrieving a user-defined :ref:" "`function object ` from a class via one of its " @@ -789,7 +793,7 @@ msgid "" "__func__` attribute is the original function object." msgstr "" -#: ../../reference/datamodel.rst:713 +#: ../../reference/datamodel.rst:717 msgid "" "When an instance method object is created by retrieving a :class:" "`classmethod` object from a class or instance, its :attr:`~method.__self__` " @@ -797,7 +801,7 @@ msgid "" "the function object underlying the class method." msgstr "" -#: ../../reference/datamodel.rst:718 +#: ../../reference/datamodel.rst:722 msgid "" "When an instance method object is called, the underlying function (:attr:" "`~method.__func__`) is called, inserting the class instance (:attr:`~method." @@ -807,7 +811,7 @@ msgid "" "f(x, 1)``." msgstr "" -#: ../../reference/datamodel.rst:725 +#: ../../reference/datamodel.rst:729 msgid "" "When an instance method object is derived from a :class:`classmethod` " "object, the \"class instance\" stored in :attr:`~method.__self__` will " @@ -816,18 +820,18 @@ msgid "" "function." msgstr "" -#: ../../reference/datamodel.rst:730 +#: ../../reference/datamodel.rst:734 msgid "" "It is important to note that user-defined functions which are attributes of " "a class instance are not converted to bound methods; this *only* happens " "when the function is an attribute of the class." msgstr "" -#: ../../reference/datamodel.rst:737 +#: ../../reference/datamodel.rst:741 msgid "Generator functions" msgstr "" -#: ../../reference/datamodel.rst:743 +#: ../../reference/datamodel.rst:747 msgid "" "A function or method which uses the :keyword:`yield` statement (see section :" "ref:`yield`) is called a :dfn:`generator function`. Such a function, when " @@ -840,11 +844,11 @@ msgid "" "values to be returned." msgstr "" -#: ../../reference/datamodel.rst:755 +#: ../../reference/datamodel.rst:759 msgid "Coroutine functions" msgstr "" -#: ../../reference/datamodel.rst:760 +#: ../../reference/datamodel.rst:764 msgid "" "A function or method which is defined using :keyword:`async def` is called " "a :dfn:`coroutine function`. Such a function, when called, returns a :term:" @@ -853,11 +857,11 @@ msgid "" "ref:`coroutine-objects` section." msgstr "" -#: ../../reference/datamodel.rst:768 +#: ../../reference/datamodel.rst:772 msgid "Asynchronous generator functions" msgstr "" -#: ../../reference/datamodel.rst:774 +#: ../../reference/datamodel.rst:778 msgid "" "A function or method which is defined using :keyword:`async def` and which " "uses the :keyword:`yield` statement is called a :dfn:`asynchronous generator " @@ -866,7 +870,7 @@ msgid "" "execute the body of the function." msgstr "" -#: ../../reference/datamodel.rst:780 +#: ../../reference/datamodel.rst:784 msgid "" "Calling the asynchronous iterator's :meth:`aiterator.__anext__ ` method will return an :term:`awaitable` which when awaited will " @@ -877,11 +881,11 @@ msgid "" "yielded." msgstr "" -#: ../../reference/datamodel.rst:793 +#: ../../reference/datamodel.rst:797 msgid "Built-in functions" msgstr "" -#: ../../reference/datamodel.rst:800 +#: ../../reference/datamodel.rst:804 msgid "" "A built-in function object is a wrapper around a C function. Examples of " "built-in functions are :func:`len` and :func:`math.sin` (:mod:`math` is a " @@ -889,7 +893,7 @@ msgid "" "determined by the C function. Special read-only attributes:" msgstr "" -#: ../../reference/datamodel.rst:805 +#: ../../reference/datamodel.rst:809 msgid "" ":attr:`!__doc__` is the function's documentation string, or ``None`` if " "unavailable. See :attr:`function.__doc__`." @@ -897,26 +901,26 @@ msgstr "" ":attr:`!__doc__` 是函式的文件字串，若不可用則為 ``None``。請見 :attr:" "`function.__doc__`。" -#: ../../reference/datamodel.rst:807 +#: ../../reference/datamodel.rst:811 msgid "" ":attr:`!__name__` is the function's name. See :attr:`function.__name__`." msgstr ":attr:`!__name__` 是函式的名稱。請見 :attr:`function.__name__`。" -#: ../../reference/datamodel.rst:808 +#: ../../reference/datamodel.rst:812 msgid ":attr:`!__self__` is set to ``None`` (but see the next item)." msgstr "" -#: ../../reference/datamodel.rst:809 +#: ../../reference/datamodel.rst:813 msgid "" ":attr:`!__module__` is the name of the module the function was defined in or " "``None`` if unavailable. See :attr:`function.__module__`." msgstr "" -#: ../../reference/datamodel.rst:817 +#: ../../reference/datamodel.rst:821 msgid "Built-in methods" msgstr "" -#: ../../reference/datamodel.rst:824 +#: ../../reference/datamodel.rst:828 msgid "" "This is really a different disguise of a built-in function, this time " "containing an object passed to the C function as an implicit extra " @@ -927,11 +931,11 @@ msgid "" "__self__>`.)" msgstr "" -#: ../../reference/datamodel.rst:833 +#: ../../reference/datamodel.rst:837 msgid "Classes" msgstr "" -#: ../../reference/datamodel.rst:835 +#: ../../reference/datamodel.rst:839 msgid "" "Classes are callable. These objects normally act as factories for new " "instances of themselves, but variations are possible for class types that " @@ -940,21 +944,21 @@ msgid "" "initialize the new instance." msgstr "" -#: ../../reference/datamodel.rst:843 +#: ../../reference/datamodel.rst:847 msgid "Class Instances" msgstr "" -#: ../../reference/datamodel.rst:845 +#: ../../reference/datamodel.rst:849 msgid "" "Instances of arbitrary classes can be made callable by defining a :meth:" "`~object.__call__` method in their class." msgstr "" -#: ../../reference/datamodel.rst:850 +#: ../../reference/datamodel.rst:854 msgid "Modules" msgstr "模組" -#: ../../reference/datamodel.rst:856 +#: ../../reference/datamodel.rst:860 msgid "" "Modules are a basic organizational unit of Python code, and are created by " "the :ref:`import system ` as invoked either by the :keyword:" @@ -969,37 +973,37 @@ msgid "" "done)." msgstr "" -#: ../../reference/datamodel.rst:869 +#: ../../reference/datamodel.rst:873 msgid "" "Attribute assignment updates the module's namespace dictionary, e.g., ``m.x " "= 1`` is equivalent to ``m.__dict__[\"x\"] = 1``." msgstr "" -#: ../../reference/datamodel.rst:879 +#: ../../reference/datamodel.rst:883 msgid "Predefined (writable) attributes:" msgstr "" -#: ../../reference/datamodel.rst:881 +#: ../../reference/datamodel.rst:885 msgid ":attr:`__name__`" msgstr ":attr:`__name__`" -#: ../../reference/datamodel.rst:882 +#: ../../reference/datamodel.rst:886 msgid "The module's name." msgstr "" -#: ../../reference/datamodel.rst:884 ../../reference/datamodel.rst:982 +#: ../../reference/datamodel.rst:888 ../../reference/datamodel.rst:986 msgid ":attr:`__doc__`" msgstr ":attr:`__doc__`" -#: ../../reference/datamodel.rst:885 +#: ../../reference/datamodel.rst:889 msgid "The module's documentation string, or ``None`` if unavailable." msgstr "" -#: ../../reference/datamodel.rst:888 +#: ../../reference/datamodel.rst:892 msgid ":attr:`__file__`" msgstr ":attr:`__file__`" -#: ../../reference/datamodel.rst:889 +#: ../../reference/datamodel.rst:893 msgid "" "The pathname of the file from which the module was loaded, if it was loaded " "from a file. The :attr:`__file__` attribute may be missing for certain types " @@ -1008,24 +1012,24 @@ msgid "" "library, it's the pathname of the shared library file." msgstr "" -#: ../../reference/datamodel.rst:897 ../../reference/datamodel.rst:985 +#: ../../reference/datamodel.rst:901 ../../reference/datamodel.rst:989 msgid ":attr:`__annotations__`" msgstr ":attr:`__annotations__`" -#: ../../reference/datamodel.rst:898 +#: ../../reference/datamodel.rst:902 msgid "" "A dictionary containing :term:`variable annotations ` " "collected during module body execution. For best practices on working with :" "attr:`__annotations__`, please see :ref:`annotations-howto`." msgstr "" -#: ../../reference/datamodel.rst:905 +#: ../../reference/datamodel.rst:909 msgid "" "Special read-only attribute: :attr:`~object.__dict__` is the module's " "namespace as a dictionary object." msgstr "" -#: ../../reference/datamodel.rst:910 +#: ../../reference/datamodel.rst:914 msgid "" "Because of the way CPython clears module dictionaries, the module dictionary " "will be cleared when the module falls out of scope even if the dictionary " @@ -1033,11 +1037,11 @@ msgid "" "module around while using its dictionary directly." msgstr "" -#: ../../reference/datamodel.rst:917 +#: ../../reference/datamodel.rst:921 msgid "Custom classes" msgstr "" -#: ../../reference/datamodel.rst:919 +#: ../../reference/datamodel.rst:923 msgid "" "Custom class types are typically created by class definitions (see section :" "ref:`class`). A class has a namespace implemented by a dictionary object. " @@ -1052,7 +1056,7 @@ msgid "" "found at :ref:`python_2.3_mro`." msgstr "" -#: ../../reference/datamodel.rst:940 +#: ../../reference/datamodel.rst:944 msgid "" "When a class attribute reference (for class :class:`!C`, say) would yield a " "class method object, it is transformed into an instance method object whose :" @@ -1063,82 +1067,82 @@ msgid "" "contained in its :attr:`~object.__dict__`." msgstr "" -#: ../../reference/datamodel.rst:951 +#: ../../reference/datamodel.rst:955 msgid "" "Class attribute assignments update the class's dictionary, never the " "dictionary of a base class." msgstr "" -#: ../../reference/datamodel.rst:956 +#: ../../reference/datamodel.rst:960 msgid "" "A class object can be called (see above) to yield a class instance (see " "below)." msgstr "" -#: ../../reference/datamodel.rst:967 +#: ../../reference/datamodel.rst:971 msgid "Special attributes:" msgstr "" -#: ../../reference/datamodel.rst:969 +#: ../../reference/datamodel.rst:973 msgid ":attr:`~definition.__name__`" msgstr ":attr:`~definition.__name__`" -#: ../../reference/datamodel.rst:970 +#: ../../reference/datamodel.rst:974 msgid "The class name." msgstr "" -#: ../../reference/datamodel.rst:972 +#: ../../reference/datamodel.rst:976 msgid ":attr:`__module__`" msgstr ":attr:`__module__`" -#: ../../reference/datamodel.rst:973 +#: ../../reference/datamodel.rst:977 msgid "The name of the module in which the class was defined." msgstr "" -#: ../../reference/datamodel.rst:975 +#: ../../reference/datamodel.rst:979 msgid ":attr:`~object.__dict__`" msgstr ":attr:`~object.__dict__`" -#: ../../reference/datamodel.rst:976 +#: ../../reference/datamodel.rst:980 msgid "The dictionary containing the class's namespace." msgstr "" -#: ../../reference/datamodel.rst:978 +#: ../../reference/datamodel.rst:982 msgid ":attr:`~class.__bases__`" msgstr ":attr:`~class.__bases__`" -#: ../../reference/datamodel.rst:979 +#: ../../reference/datamodel.rst:983 msgid "" "A tuple containing the base classes, in the order of their occurrence in the " "base class list." msgstr "" -#: ../../reference/datamodel.rst:983 +#: ../../reference/datamodel.rst:987 msgid "The class's documentation string, or ``None`` if undefined." msgstr "" -#: ../../reference/datamodel.rst:986 +#: ../../reference/datamodel.rst:990 msgid "" "A dictionary containing :term:`variable annotations ` " "collected during class body execution. For best practices on working with :" "attr:`__annotations__`, please see :ref:`annotations-howto`." msgstr "" -#: ../../reference/datamodel.rst:992 +#: ../../reference/datamodel.rst:996 msgid ":attr:`__type_params__`" msgstr ":attr:`__type_params__`" -#: ../../reference/datamodel.rst:993 +#: ../../reference/datamodel.rst:997 msgid "" "A tuple containing the :ref:`type parameters ` of a :ref:" "`generic class `." msgstr "" -#: ../../reference/datamodel.rst:998 +#: ../../reference/datamodel.rst:1002 msgid "Class instances" msgstr "" -#: ../../reference/datamodel.rst:1006 +#: ../../reference/datamodel.rst:1010 msgid "" "A class instance is created by calling a class object (see above). A class " "instance has a namespace implemented as a dictionary which is the first " @@ -1155,7 +1159,7 @@ msgid "" "__getattr__` method, that is called to satisfy the lookup." msgstr "" -#: ../../reference/datamodel.rst:1022 +#: ../../reference/datamodel.rst:1026 msgid "" "Attribute assignments and deletions update the instance's dictionary, never " "a class's dictionary. If the class has a :meth:`~object.__setattr__` or :" @@ -1163,23 +1167,23 @@ msgid "" "instance dictionary directly." msgstr "" -#: ../../reference/datamodel.rst:1032 +#: ../../reference/datamodel.rst:1036 msgid "" "Class instances can pretend to be numbers, sequences, or mappings if they " "have methods with certain special names. See section :ref:`specialnames`." msgstr "" -#: ../../reference/datamodel.rst:1039 +#: ../../reference/datamodel.rst:1043 msgid "" "Special attributes: :attr:`~object.__dict__` is the attribute dictionary; :" "attr:`~instance.__class__` is the instance's class." msgstr "" -#: ../../reference/datamodel.rst:1044 +#: ../../reference/datamodel.rst:1048 msgid "I/O objects (also known as file objects)" msgstr "" -#: ../../reference/datamodel.rst:1059 +#: ../../reference/datamodel.rst:1063 msgid "" "A :term:`file object` represents an open file. Various shortcuts are " "available to create file objects: the :func:`open` built-in function, and " @@ -1188,7 +1192,7 @@ msgid "" "methods provided by extension modules)." msgstr "" -#: ../../reference/datamodel.rst:1065 +#: ../../reference/datamodel.rst:1069 msgid "" "The objects ``sys.stdin``, ``sys.stdout`` and ``sys.stderr`` are initialized " "to file objects corresponding to the interpreter's standard input, output " @@ -1196,22 +1200,22 @@ msgid "" "interface defined by the :class:`io.TextIOBase` abstract class." msgstr "" -#: ../../reference/datamodel.rst:1073 +#: ../../reference/datamodel.rst:1077 msgid "Internal types" msgstr "" -#: ../../reference/datamodel.rst:1079 +#: ../../reference/datamodel.rst:1083 msgid "" "A few types used internally by the interpreter are exposed to the user. " "Their definitions may change with future versions of the interpreter, but " "they are mentioned here for completeness." msgstr "" -#: ../../reference/datamodel.rst:1087 +#: ../../reference/datamodel.rst:1091 msgid "Code objects" msgstr "" -#: ../../reference/datamodel.rst:1091 +#: ../../reference/datamodel.rst:1095 msgid "" "Code objects represent *byte-compiled* executable Python code, or :term:" "`bytecode`. The difference between a code object and a function object is " @@ -1223,103 +1227,103 @@ msgid "" "no references (directly or indirectly) to mutable objects." msgstr "" -#: ../../reference/datamodel.rst:1125 +#: ../../reference/datamodel.rst:1129 msgid "The function name" msgstr "函式名稱" -#: ../../reference/datamodel.rst:1128 +#: ../../reference/datamodel.rst:1132 msgid "The fully qualified function name" msgstr "" -#: ../../reference/datamodel.rst:1133 +#: ../../reference/datamodel.rst:1137 msgid "" "The total number of positional :term:`parameters ` (including " "positional-only parameters and parameters with default values) that the " "function has" msgstr "" -#: ../../reference/datamodel.rst:1138 +#: ../../reference/datamodel.rst:1142 msgid "" "The number of positional-only :term:`parameters ` (including " "arguments with default values) that the function has" msgstr "" -#: ../../reference/datamodel.rst:1142 +#: ../../reference/datamodel.rst:1146 msgid "" "The number of keyword-only :term:`parameters ` (including " "arguments with default values) that the function has" msgstr "" -#: ../../reference/datamodel.rst:1146 +#: ../../reference/datamodel.rst:1150 msgid "" "The number of :ref:`local variables ` used by the function " "(including parameters)" msgstr "" -#: ../../reference/datamodel.rst:1150 +#: ../../reference/datamodel.rst:1154 msgid "" "A :class:`tuple` containing the names of the local variables in the function " "(starting with the parameter names)" msgstr "" -#: ../../reference/datamodel.rst:1154 +#: ../../reference/datamodel.rst:1158 msgid "" "A :class:`tuple` containing the names of :ref:`local variables ` " "that are referenced by nested functions inside the function" msgstr "" -#: ../../reference/datamodel.rst:1158 +#: ../../reference/datamodel.rst:1162 msgid "A :class:`tuple` containing the names of free variables in the function" msgstr "" -#: ../../reference/datamodel.rst:1161 +#: ../../reference/datamodel.rst:1165 msgid "" "A string representing the sequence of :term:`bytecode` instructions in the " "function" msgstr "" -#: ../../reference/datamodel.rst:1165 +#: ../../reference/datamodel.rst:1169 msgid "" "A :class:`tuple` containing the literals used by the :term:`bytecode` in the " "function" msgstr "" -#: ../../reference/datamodel.rst:1169 +#: ../../reference/datamodel.rst:1173 msgid "" "A :class:`tuple` containing the names used by the :term:`bytecode` in the " "function" msgstr "" -#: ../../reference/datamodel.rst:1173 +#: ../../reference/datamodel.rst:1177 msgid "The name of the file from which the code was compiled" msgstr "" -#: ../../reference/datamodel.rst:1176 +#: ../../reference/datamodel.rst:1180 msgid "The line number of the first line of the function" msgstr "" -#: ../../reference/datamodel.rst:1179 +#: ../../reference/datamodel.rst:1183 msgid "" "A string encoding the mapping from :term:`bytecode` offsets to line numbers. " "For details, see the source code of the interpreter." msgstr "" -#: ../../reference/datamodel.rst:1182 +#: ../../reference/datamodel.rst:1186 msgid "" "This attribute of code objects is deprecated, and may be removed in Python " "3.14." msgstr "" -#: ../../reference/datamodel.rst:1187 +#: ../../reference/datamodel.rst:1191 msgid "The required stack size of the code object" msgstr "" -#: ../../reference/datamodel.rst:1190 +#: ../../reference/datamodel.rst:1194 msgid "" "An :class:`integer ` encoding a number of flags for the interpreter." msgstr "" -#: ../../reference/datamodel.rst:1195 +#: ../../reference/datamodel.rst:1199 msgid "" "The following flag bits are defined for :attr:`~codeobject.co_flags`: bit " "``0x04`` is set if the function uses the ``*arguments`` syntax to accept an " @@ -1330,7 +1334,7 @@ msgid "" "might be present." msgstr "" -#: ../../reference/datamodel.rst:1203 +#: ../../reference/datamodel.rst:1207 msgid "" "Future feature declarations (``from __future__ import division``) also use " "bits in :attr:`~codeobject.co_flags` to indicate whether a code object was " @@ -1339,29 +1343,29 @@ msgid "" "``0x1000`` were used in earlier versions of Python." msgstr "" -#: ../../reference/datamodel.rst:1209 +#: ../../reference/datamodel.rst:1213 msgid "" "Other bits in :attr:`~codeobject.co_flags` are reserved for internal use." msgstr "" -#: ../../reference/datamodel.rst:1213 +#: ../../reference/datamodel.rst:1217 msgid "" "If a code object represents a function, the first item in :attr:`~codeobject." "co_consts` is the documentation string of the function, or ``None`` if " "undefined." msgstr "" -#: ../../reference/datamodel.rst:1218 +#: ../../reference/datamodel.rst:1222 msgid "Methods on code objects" msgstr "用於程式碼物件的方法" -#: ../../reference/datamodel.rst:1222 +#: ../../reference/datamodel.rst:1226 msgid "" "Returns an iterable over the source code positions of each :term:`bytecode` " "instruction in the code object." msgstr "" -#: ../../reference/datamodel.rst:1225 +#: ../../reference/datamodel.rst:1229 msgid "" "The iterator returns :class:`tuple`\\s containing the ``(start_line, " "end_line, start_column, end_column)``. The *i-th* tuple corresponds to the " @@ -1369,37 +1373,37 @@ msgid "" "information is 0-indexed utf-8 byte offsets on the given source line." msgstr "" -#: ../../reference/datamodel.rst:1231 +#: ../../reference/datamodel.rst:1235 msgid "" "This positional information can be missing. A non-exhaustive lists of cases " "where this may happen:" msgstr "" -#: ../../reference/datamodel.rst:1234 +#: ../../reference/datamodel.rst:1238 msgid "Running the interpreter with :option:`-X` ``no_debug_ranges``." msgstr "" -#: ../../reference/datamodel.rst:1235 +#: ../../reference/datamodel.rst:1239 msgid "" "Loading a pyc file compiled while using :option:`-X` ``no_debug_ranges``." msgstr "" -#: ../../reference/datamodel.rst:1236 +#: ../../reference/datamodel.rst:1240 msgid "Position tuples corresponding to artificial instructions." msgstr "" -#: ../../reference/datamodel.rst:1237 +#: ../../reference/datamodel.rst:1241 msgid "" "Line and column numbers that can't be represented due to implementation " "specific limitations." msgstr "" -#: ../../reference/datamodel.rst:1240 +#: ../../reference/datamodel.rst:1244 msgid "" "When this occurs, some or all of the tuple elements can be :const:`None`." msgstr "" -#: ../../reference/datamodel.rst:1246 +#: ../../reference/datamodel.rst:1250 msgid "" "This feature requires storing column positions in code objects which may " "result in a small increase of disk usage of compiled Python files or " @@ -1409,95 +1413,95 @@ msgid "" "environment variable can be used." msgstr "" -#: ../../reference/datamodel.rst:1255 +#: ../../reference/datamodel.rst:1259 msgid "" "Returns an iterator that yields information about successive ranges of :term:" "`bytecode`\\s. Each item yielded is a ``(start, end, lineno)`` :class:" "`tuple`:" msgstr "" -#: ../../reference/datamodel.rst:1259 +#: ../../reference/datamodel.rst:1263 msgid "" "``start`` (an :class:`int`) represents the offset (inclusive) of the start " "of the :term:`bytecode` range" msgstr "" -#: ../../reference/datamodel.rst:1261 +#: ../../reference/datamodel.rst:1265 msgid "" "``end`` (an :class:`int`) represents the offset (exclusive) of the end of " "the :term:`bytecode` range" msgstr "" -#: ../../reference/datamodel.rst:1263 +#: ../../reference/datamodel.rst:1267 msgid "" "``lineno`` is an :class:`int` representing the line number of the :term:" "`bytecode` range, or ``None`` if the bytecodes in the given range have no " "line number" msgstr "" -#: ../../reference/datamodel.rst:1267 +#: ../../reference/datamodel.rst:1271 msgid "The items yielded will have the following properties:" msgstr "" -#: ../../reference/datamodel.rst:1269 +#: ../../reference/datamodel.rst:1273 msgid "The first range yielded will have a ``start`` of 0." msgstr "" -#: ../../reference/datamodel.rst:1270 +#: ../../reference/datamodel.rst:1274 msgid "" "The ``(start, end)`` ranges will be non-decreasing and consecutive. That is, " "for any pair of :class:`tuple`\\s, the ``start`` of the second will be equal " "to the ``end`` of the first." msgstr "" -#: ../../reference/datamodel.rst:1273 +#: ../../reference/datamodel.rst:1277 msgid "No range will be backwards: ``end >= start`` for all triples." msgstr "" -#: ../../reference/datamodel.rst:1274 +#: ../../reference/datamodel.rst:1278 msgid "" "The last :class:`tuple` yielded will have ``end`` equal to the size of the :" "term:`bytecode`." msgstr "" -#: ../../reference/datamodel.rst:1277 +#: ../../reference/datamodel.rst:1281 msgid "" "Zero-width ranges, where ``start == end``, are allowed. Zero-width ranges " "are used for lines that are present in the source code, but have been " "eliminated by the :term:`bytecode` compiler." msgstr "" -#: ../../reference/datamodel.rst:1285 +#: ../../reference/datamodel.rst:1289 msgid ":pep:`626` - Precise line numbers for debugging and other tools." msgstr "" -#: ../../reference/datamodel.rst:1286 +#: ../../reference/datamodel.rst:1290 msgid "The PEP that introduced the :meth:`!co_lines` method." msgstr "" -#: ../../reference/datamodel.rst:1290 +#: ../../reference/datamodel.rst:1294 msgid "" "Return a copy of the code object with new values for the specified fields." msgstr "" -#: ../../reference/datamodel.rst:1298 +#: ../../reference/datamodel.rst:1302 msgid "Frame objects" msgstr "" -#: ../../reference/datamodel.rst:1302 +#: ../../reference/datamodel.rst:1306 msgid "" "Frame objects represent execution frames. They may occur in :ref:`traceback " "objects `, and are also passed to registered trace " "functions." msgstr "" -#: ../../reference/datamodel.rst:1320 +#: ../../reference/datamodel.rst:1324 msgid "" "Points to the previous stack frame (towards the caller), or ``None`` if this " "is the bottom stack frame" msgstr "" -#: ../../reference/datamodel.rst:1324 +#: ../../reference/datamodel.rst:1328 msgid "" "The :ref:`code object ` being executed in this frame. " "Accessing this attribute raises an :ref:`auditing event ` ``object." @@ -1507,49 +1511,49 @@ msgstr "" "這個屬性會引發一個附帶引數 ``obj`` 與 ``\"f_code\"`` 的\\ :ref:`稽核事件 " "` ``object.__getattr__``。" -#: ../../reference/datamodel.rst:1329 +#: ../../reference/datamodel.rst:1333 msgid "" "The dictionary used by the frame to look up :ref:`local variables `" msgstr "" -#: ../../reference/datamodel.rst:1333 +#: ../../reference/datamodel.rst:1337 msgid "" "The dictionary used by the frame to look up :ref:`global variables `" msgstr "" -#: ../../reference/datamodel.rst:1337 +#: ../../reference/datamodel.rst:1341 msgid "" "The dictionary used by the frame to look up :ref:`built-in (intrinsic) names " "`" msgstr "" -#: ../../reference/datamodel.rst:1341 +#: ../../reference/datamodel.rst:1345 msgid "" "The \"precise instruction\" of the frame object (this is an index into the :" "term:`bytecode` string of the :ref:`code object `)" msgstr "" -#: ../../reference/datamodel.rst:1357 +#: ../../reference/datamodel.rst:1361 msgid "" "If not ``None``, this is a function called for various events during code " "execution (this is used by debuggers). Normally an event is triggered for " "each new source line (see :attr:`~frame.f_trace_lines`)." msgstr "" -#: ../../reference/datamodel.rst:1362 +#: ../../reference/datamodel.rst:1366 msgid "" "Set this attribute to :const:`False` to disable triggering a tracing event " "for each source line." msgstr "" -#: ../../reference/datamodel.rst:1366 +#: ../../reference/datamodel.rst:1370 msgid "" "Set this attribute to :const:`True` to allow per-opcode events to be " "requested. Note that this may lead to undefined interpreter behaviour if " "exceptions raised by the trace function escape to the function being traced." msgstr "" -#: ../../reference/datamodel.rst:1372 +#: ../../reference/datamodel.rst:1376 msgid "" "The current line number of the frame -- writing to this from within a trace " "function jumps to the given line (only for the bottom-most frame). A " @@ -1557,15 +1561,15 @@ msgid "" "this attribute." msgstr "" -#: ../../reference/datamodel.rst:1378 +#: ../../reference/datamodel.rst:1382 msgid "Frame object methods" msgstr "" -#: ../../reference/datamodel.rst:1380 +#: ../../reference/datamodel.rst:1384 msgid "Frame objects support one method:" msgstr "" -#: ../../reference/datamodel.rst:1384 +#: ../../reference/datamodel.rst:1388 msgid "" "This method clears all references to :ref:`local variables ` held by " "the frame. Also, if the frame belonged to a :term:`generator`, the " @@ -1574,26 +1578,26 @@ msgid "" "and storing its :ref:`traceback ` for later use)." msgstr "" -#: ../../reference/datamodel.rst:1390 +#: ../../reference/datamodel.rst:1394 msgid ":exc:`RuntimeError` is raised if the frame is currently executing." msgstr "" -#: ../../reference/datamodel.rst:1398 +#: ../../reference/datamodel.rst:1402 msgid "Traceback objects" msgstr "" -#: ../../reference/datamodel.rst:1411 +#: ../../reference/datamodel.rst:1415 msgid "" "Traceback objects represent the stack trace of an :ref:`exception `. A traceback object is implicitly created when an exception occurs, " "and may also be explicitly created by calling :class:`types.TracebackType`." msgstr "" -#: ../../reference/datamodel.rst:1416 +#: ../../reference/datamodel.rst:1420 msgid "Traceback objects can now be explicitly instantiated from Python code." msgstr "" -#: ../../reference/datamodel.rst:1419 +#: ../../reference/datamodel.rst:1423 msgid "" "For implicitly created tracebacks, when the search for an exception handler " "unwinds the execution stack, at each unwound level a traceback object is " @@ -1604,7 +1608,7 @@ msgid "" "the caught exception." msgstr "" -#: ../../reference/datamodel.rst:1428 +#: ../../reference/datamodel.rst:1432 msgid "" "When the program contains no suitable handler, the stack trace is written " "(nicely formatted) to the standard error stream; if the interpreter is " @@ -1612,19 +1616,19 @@ msgid "" "last_traceback`." msgstr "" -#: ../../reference/datamodel.rst:1433 +#: ../../reference/datamodel.rst:1437 msgid "" "For explicitly created tracebacks, it is up to the creator of the traceback " "to determine how the :attr:`~traceback.tb_next` attributes should be linked " "to form a full stack trace." msgstr "" -#: ../../reference/datamodel.rst:1448 +#: ../../reference/datamodel.rst:1452 msgid "" "Points to the execution :ref:`frame ` of the current level." msgstr "" -#: ../../reference/datamodel.rst:1451 +#: ../../reference/datamodel.rst:1455 msgid "" "Accessing this attribute raises an :ref:`auditing event ` ``object." "__getattr__`` with arguments ``obj`` and ``\"tb_frame\"``." @@ -1632,15 +1636,15 @@ msgstr "" "存取此屬性會引發一個附帶引數 ``obj`` 與 ``\"tb_frame\"`` 的\\ :ref:`稽核事件 " "` ``object.__getattr__``。" -#: ../../reference/datamodel.rst:1456 +#: ../../reference/datamodel.rst:1460 msgid "Gives the line number where the exception occurred" msgstr "" -#: ../../reference/datamodel.rst:1459 +#: ../../reference/datamodel.rst:1463 msgid "Indicates the \"precise instruction\"." msgstr "" -#: ../../reference/datamodel.rst:1461 +#: ../../reference/datamodel.rst:1465 msgid "" "The line number and last instruction in the traceback may differ from the " "line number of its :ref:`frame object ` if the exception " @@ -1648,39 +1652,39 @@ msgid "" "with a :keyword:`finally` clause." msgstr "" -#: ../../reference/datamodel.rst:1472 +#: ../../reference/datamodel.rst:1476 msgid "" "The special writable attribute :attr:`!tb_next` is the next level in the " "stack trace (towards the frame where the exception occurred), or ``None`` if " "there is no next level." msgstr "" -#: ../../reference/datamodel.rst:1476 +#: ../../reference/datamodel.rst:1480 msgid "This attribute is now writable" msgstr "" -#: ../../reference/datamodel.rst:1481 +#: ../../reference/datamodel.rst:1485 msgid "Slice objects" msgstr "" -#: ../../reference/datamodel.rst:1485 +#: ../../reference/datamodel.rst:1489 msgid "" "Slice objects are used to represent slices for :meth:`~object.__getitem__` " "methods. They are also created by the built-in :func:`slice` function." msgstr "" -#: ../../reference/datamodel.rst:1494 +#: ../../reference/datamodel.rst:1498 msgid "" "Special read-only attributes: :attr:`~slice.start` is the lower bound; :attr:" "`~slice.stop` is the upper bound; :attr:`~slice.step` is the step value; " "each is ``None`` if omitted. These attributes can have any type." msgstr "" -#: ../../reference/datamodel.rst:1498 +#: ../../reference/datamodel.rst:1502 msgid "Slice objects support one method:" msgstr "" -#: ../../reference/datamodel.rst:1502 +#: ../../reference/datamodel.rst:1506 msgid "" "This method takes a single integer argument *length* and computes " "information about the slice that the slice object would describe if applied " @@ -1690,11 +1694,11 @@ msgid "" "a manner consistent with regular slices." msgstr "" -#: ../../reference/datamodel.rst:1511 +#: ../../reference/datamodel.rst:1515 msgid "Static method objects" msgstr "" -#: ../../reference/datamodel.rst:1513 +#: ../../reference/datamodel.rst:1517 msgid "" "Static method objects provide a way of defeating the transformation of " "function objects to method objects described above. A static method object " @@ -1705,11 +1709,11 @@ msgid "" "method objects are created by the built-in :func:`staticmethod` constructor." msgstr "" -#: ../../reference/datamodel.rst:1523 +#: ../../reference/datamodel.rst:1527 msgid "Class method objects" msgstr "" -#: ../../reference/datamodel.rst:1525 +#: ../../reference/datamodel.rst:1529 msgid "" "A class method object, like a static method object, is a wrapper around " "another object that alters the way in which that object is retrieved from " @@ -1719,11 +1723,11 @@ msgid "" "`classmethod` constructor." msgstr "" -#: ../../reference/datamodel.rst:1535 +#: ../../reference/datamodel.rst:1539 msgid "Special method names" msgstr "" -#: ../../reference/datamodel.rst:1541 +#: ../../reference/datamodel.rst:1545 msgid "" "A class can implement certain operations that are invoked by special syntax " "(such as arithmetic operations or subscripting and slicing) by defining " @@ -1737,7 +1741,7 @@ msgid "" "`TypeError`)." msgstr "" -#: ../../reference/datamodel.rst:1552 +#: ../../reference/datamodel.rst:1556 msgid "" "Setting a special method to ``None`` indicates that the corresponding " "operation is not available. For example, if a class sets :meth:`~object." @@ -1746,7 +1750,7 @@ msgid "" "`~object.__getitem__`). [#]_" msgstr "" -#: ../../reference/datamodel.rst:1558 +#: ../../reference/datamodel.rst:1562 msgid "" "When implementing a class that emulates any built-in type, it is important " "that the emulation only be implemented to the degree that it makes sense for " @@ -1756,11 +1760,11 @@ msgid "" "the W3C's Document Object Model.)" msgstr "" -#: ../../reference/datamodel.rst:1569 +#: ../../reference/datamodel.rst:1573 msgid "Basic customization" msgstr "" -#: ../../reference/datamodel.rst:1575 +#: ../../reference/datamodel.rst:1579 msgid "" "Called to create a new instance of class *cls*. :meth:`__new__` is a static " "method (special-cased so you need not declare it as such) that takes the " @@ -1770,7 +1774,7 @@ msgid "" "new object instance (usually an instance of *cls*)." msgstr "" -#: ../../reference/datamodel.rst:1582 +#: ../../reference/datamodel.rst:1586 msgid "" "Typical implementations create a new instance of the class by invoking the " "superclass's :meth:`__new__` method using ``super().__new__(cls[, ...])`` " @@ -1778,7 +1782,7 @@ msgid "" "necessary before returning it." msgstr "" -#: ../../reference/datamodel.rst:1587 +#: ../../reference/datamodel.rst:1591 msgid "" "If :meth:`__new__` is invoked during object construction and it returns an " "instance of *cls*, then the new instance’s :meth:`__init__` method will be " @@ -1787,13 +1791,13 @@ msgid "" "constructor." msgstr "" -#: ../../reference/datamodel.rst:1592 +#: ../../reference/datamodel.rst:1596 msgid "" "If :meth:`__new__` does not return an instance of *cls*, then the new " "instance's :meth:`__init__` method will not be invoked." msgstr "" -#: ../../reference/datamodel.rst:1595 +#: ../../reference/datamodel.rst:1599 msgid "" ":meth:`__new__` is intended mainly to allow subclasses of immutable types " "(like int, str, or tuple) to customize instance creation. It is also " @@ -1801,7 +1805,7 @@ msgid "" "creation." msgstr "" -#: ../../reference/datamodel.rst:1604 +#: ../../reference/datamodel.rst:1608 msgid "" "Called after the instance has been created (by :meth:`__new__`), but before " "it is returned to the caller. The arguments are those passed to the class " @@ -1811,7 +1815,7 @@ msgid "" "example: ``super().__init__([args...])``." msgstr "" -#: ../../reference/datamodel.rst:1611 +#: ../../reference/datamodel.rst:1615 msgid "" "Because :meth:`__new__` and :meth:`__init__` work together in constructing " "objects (:meth:`__new__` to create it, and :meth:`__init__` to customize " @@ -1819,7 +1823,7 @@ msgid "" "will cause a :exc:`TypeError` to be raised at runtime." msgstr "" -#: ../../reference/datamodel.rst:1624 +#: ../../reference/datamodel.rst:1628 msgid "" "Called when the instance is about to be destroyed. This is also called a " "finalizer or (improperly) a destructor. If a base class has a :meth:" @@ -1828,7 +1832,7 @@ msgid "" "instance." msgstr "" -#: ../../reference/datamodel.rst:1630 +#: ../../reference/datamodel.rst:1634 msgid "" "It is possible (though not recommended!) for the :meth:`__del__` method to " "postpone destruction of the instance by creating a new reference to it. " @@ -1838,7 +1842,7 @@ msgid "" "it once." msgstr "" -#: ../../reference/datamodel.rst:1637 +#: ../../reference/datamodel.rst:1641 msgid "" "It is not guaranteed that :meth:`__del__` methods are called for objects " "that still exist when the interpreter exits. :class:`weakref.finalize` " @@ -1846,14 +1850,14 @@ msgid "" "when an object is garbage collected." msgstr "" -#: ../../reference/datamodel.rst:1644 +#: ../../reference/datamodel.rst:1648 msgid "" "``del x`` doesn't directly call ``x.__del__()`` --- the former decrements " "the reference count for ``x`` by one, and the latter is only called when " "``x``'s reference count reaches zero." msgstr "" -#: ../../reference/datamodel.rst:1649 +#: ../../reference/datamodel.rst:1653 msgid "" "It is possible for a reference cycle to prevent the reference count of an " "object from going to zero. In this case, the cycle will be later detected " @@ -1864,18 +1868,18 @@ msgid "" "caught in the traceback." msgstr "" -#: ../../reference/datamodel.rst:1659 +#: ../../reference/datamodel.rst:1663 msgid "Documentation for the :mod:`gc` module." msgstr "" -#: ../../reference/datamodel.rst:1663 +#: ../../reference/datamodel.rst:1667 msgid "" "Due to the precarious circumstances under which :meth:`__del__` methods are " "invoked, exceptions that occur during their execution are ignored, and a " "warning is printed to ``sys.stderr`` instead. In particular:" msgstr "" -#: ../../reference/datamodel.rst:1667 +#: ../../reference/datamodel.rst:1671 msgid "" ":meth:`__del__` can be invoked when arbitrary code is being executed, " "including from any arbitrary thread. If :meth:`__del__` needs to take a " @@ -1884,7 +1888,7 @@ msgid "" "`__del__`." msgstr "" -#: ../../reference/datamodel.rst:1673 +#: ../../reference/datamodel.rst:1677 msgid "" ":meth:`__del__` can be executed during interpreter shutdown. As a " "consequence, the global variables it needs to access (including other " @@ -1895,7 +1899,7 @@ msgid "" "still available at the time when the :meth:`__del__` method is called." msgstr "" -#: ../../reference/datamodel.rst:1688 +#: ../../reference/datamodel.rst:1692 msgid "" "Called by the :func:`repr` built-in function to compute the \"official\" " "string representation of an object. If at all possible, this should look " @@ -1907,13 +1911,13 @@ msgid "" "an \"informal\" string representation of instances of that class is required." msgstr "" -#: ../../reference/datamodel.rst:1697 +#: ../../reference/datamodel.rst:1701 msgid "" "This is typically used for debugging, so it is important that the " "representation is information-rich and unambiguous." msgstr "" -#: ../../reference/datamodel.rst:1708 +#: ../../reference/datamodel.rst:1712 msgid "" "Called by :func:`str(object) ` and the built-in functions :func:" "`format` and :func:`print` to compute the \"informal\" or nicely printable " @@ -1921,26 +1925,26 @@ msgid "" "` object." msgstr "" -#: ../../reference/datamodel.rst:1713 +#: ../../reference/datamodel.rst:1717 msgid "" "This method differs from :meth:`object.__repr__` in that there is no " "expectation that :meth:`__str__` return a valid Python expression: a more " "convenient or concise representation can be used." msgstr "" -#: ../../reference/datamodel.rst:1717 +#: ../../reference/datamodel.rst:1721 msgid "" "The default implementation defined by the built-in type :class:`object` " "calls :meth:`object.__repr__`." msgstr "" -#: ../../reference/datamodel.rst:1727 +#: ../../reference/datamodel.rst:1731 msgid "" "Called by :ref:`bytes ` to compute a byte-string representation " "of an object. This should return a :class:`bytes` object." msgstr "" -#: ../../reference/datamodel.rst:1738 +#: ../../reference/datamodel.rst:1742 msgid "" "Called by the :func:`format` built-in function, and by extension, evaluation " "of :ref:`formatted string literals ` and the :meth:`str.format` " @@ -1952,28 +1956,28 @@ msgid "" "formatting option syntax." msgstr "" -#: ../../reference/datamodel.rst:1748 +#: ../../reference/datamodel.rst:1752 msgid "" "See :ref:`formatspec` for a description of the standard formatting syntax." msgstr "" -#: ../../reference/datamodel.rst:1750 +#: ../../reference/datamodel.rst:1754 msgid "The return value must be a string object." msgstr "" -#: ../../reference/datamodel.rst:1752 +#: ../../reference/datamodel.rst:1756 msgid "" "The __format__ method of ``object`` itself raises a :exc:`TypeError` if " "passed any non-empty string." msgstr "" -#: ../../reference/datamodel.rst:1756 +#: ../../reference/datamodel.rst:1760 msgid "" "``object.__format__(x, '')`` is now equivalent to ``str(x)`` rather than " "``format(str(x), '')``." msgstr "" -#: ../../reference/datamodel.rst:1772 +#: ../../reference/datamodel.rst:1776 msgid "" "These are the so-called \"rich comparison\" methods. The correspondence " "between operator symbols and method names is as follows: ``x.__hash__``." msgstr "" -#: ../../reference/datamodel.rst:1864 +#: ../../reference/datamodel.rst:1868 msgid "" "If a class that does not override :meth:`__eq__` wishes to suppress hash " "support, it should include ``__hash__ = None`` in the class definition. A " @@ -2099,7 +2103,7 @@ msgid "" "``isinstance(obj, collections.abc.Hashable)`` call." msgstr "" -#: ../../reference/datamodel.rst:1873 +#: ../../reference/datamodel.rst:1877 msgid "" "By default, the :meth:`__hash__` values of str and bytes objects are " "\"salted\" with an unpredictable random value. Although they remain " @@ -2107,7 +2111,7 @@ msgid "" "between repeated invocations of Python." msgstr "" -#: ../../reference/datamodel.rst:1878 +#: ../../reference/datamodel.rst:1882 msgid "" "This is intended to provide protection against a denial-of-service caused by " "carefully chosen inputs that exploit the worst case performance of a dict " @@ -2115,22 +2119,22 @@ msgid "" "advisories/ocert-2011-003.html for details." msgstr "" -#: ../../reference/datamodel.rst:1883 +#: ../../reference/datamodel.rst:1887 msgid "" "Changing hash values affects the iteration order of sets. Python has never " "made guarantees about this ordering (and it typically varies between 32-bit " "and 64-bit builds)." msgstr "" -#: ../../reference/datamodel.rst:1887 +#: ../../reference/datamodel.rst:1891 msgid "See also :envvar:`PYTHONHASHSEED`." msgstr "另請參閱 :envvar:`PYTHONHASHSEED`。" -#: ../../reference/datamodel.rst:1889 +#: ../../reference/datamodel.rst:1893 msgid "Hash randomization is enabled by default." msgstr "" -#: ../../reference/datamodel.rst:1897 +#: ../../reference/datamodel.rst:1901 msgid "" "Called to implement truth value testing and the built-in operation " "``bool()``; should return ``False`` or ``True``. When this method is not " @@ -2139,18 +2143,18 @@ msgid "" "meth:`!__len__` nor :meth:`!__bool__`, all its instances are considered true." msgstr "" -#: ../../reference/datamodel.rst:1908 +#: ../../reference/datamodel.rst:1912 msgid "Customizing attribute access" msgstr "" -#: ../../reference/datamodel.rst:1910 +#: ../../reference/datamodel.rst:1914 msgid "" "The following methods can be defined to customize the meaning of attribute " "access (use of, assignment to, or deletion of ``x.name``) for class " "instances." msgstr "" -#: ../../reference/datamodel.rst:1918 +#: ../../reference/datamodel.rst:1922 msgid "" "Called when the default attribute access fails with an :exc:`AttributeError` " "(either :meth:`__getattribute__` raises an :exc:`AttributeError` because " @@ -2160,7 +2164,7 @@ msgid "" "attribute value or raise an :exc:`AttributeError` exception." msgstr "" -#: ../../reference/datamodel.rst:1925 +#: ../../reference/datamodel.rst:1929 msgid "" "Note that if the attribute is found through the normal mechanism, :meth:" "`__getattr__` is not called. (This is an intentional asymmetry between :" @@ -2173,7 +2177,7 @@ msgid "" "actually get total control over attribute access." msgstr "" -#: ../../reference/datamodel.rst:1938 +#: ../../reference/datamodel.rst:1942 msgid "" "Called unconditionally to implement attribute accesses for instances of the " "class. If the class also defines :meth:`__getattr__`, the latter will not be " @@ -2185,64 +2189,64 @@ msgid "" "example, ``object.__getattribute__(self, name)``." msgstr "" -#: ../../reference/datamodel.rst:1949 +#: ../../reference/datamodel.rst:1953 msgid "" "This method may still be bypassed when looking up special methods as the " "result of implicit invocation via language syntax or :ref:`built-in " "functions `. See :ref:`special-lookup`." msgstr "" -#: ../../reference/datamodel.rst:1954 ../../reference/datamodel.rst:1956 +#: ../../reference/datamodel.rst:1958 ../../reference/datamodel.rst:1960 msgid "" "For certain sensitive attribute accesses, raises an :ref:`auditing event " "` ``object.__getattr__`` with arguments ``obj`` and ``name``." msgstr "" -#: ../../reference/datamodel.rst:1963 +#: ../../reference/datamodel.rst:1967 msgid "" "Called when an attribute assignment is attempted. This is called instead of " "the normal mechanism (i.e. store the value in the instance dictionary). " "*name* is the attribute name, *value* is the value to be assigned to it." msgstr "" -#: ../../reference/datamodel.rst:1967 +#: ../../reference/datamodel.rst:1971 msgid "" "If :meth:`__setattr__` wants to assign to an instance attribute, it should " "call the base class method with the same name, for example, ``object." "__setattr__(self, name, value)``." msgstr "" -#: ../../reference/datamodel.rst:1971 ../../reference/datamodel.rst:1973 +#: ../../reference/datamodel.rst:1975 ../../reference/datamodel.rst:1977 msgid "" "For certain sensitive attribute assignments, raises an :ref:`auditing event " "` ``object.__setattr__`` with arguments ``obj``, ``name``, " "``value``." msgstr "" -#: ../../reference/datamodel.rst:1980 +#: ../../reference/datamodel.rst:1984 msgid "" "Like :meth:`__setattr__` but for attribute deletion instead of assignment. " "This should only be implemented if ``del obj.name`` is meaningful for the " "object." msgstr "" -#: ../../reference/datamodel.rst:1983 ../../reference/datamodel.rst:1985 +#: ../../reference/datamodel.rst:1987 ../../reference/datamodel.rst:1989 msgid "" "For certain sensitive attribute deletions, raises an :ref:`auditing event " "` ``object.__delattr__`` with arguments ``obj`` and ``name``." msgstr "" -#: ../../reference/datamodel.rst:1992 +#: ../../reference/datamodel.rst:1996 msgid "" "Called when :func:`dir` is called on the object. An iterable must be " "returned. :func:`dir` converts the returned iterable to a list and sorts it." msgstr "" -#: ../../reference/datamodel.rst:1997 +#: ../../reference/datamodel.rst:2001 msgid "Customizing module attribute access" msgstr "" -#: ../../reference/datamodel.rst:2004 +#: ../../reference/datamodel.rst:2008 msgid "" "Special names ``__getattr__`` and ``__dir__`` can be also used to customize " "access to module attributes. The ``__getattr__`` function at the module " @@ -2254,21 +2258,21 @@ msgid "" "with the attribute name and the result is returned." msgstr "" -#: ../../reference/datamodel.rst:2013 +#: ../../reference/datamodel.rst:2017 msgid "" "The ``__dir__`` function should accept no arguments, and return an iterable " "of strings that represents the names accessible on module. If present, this " "function overrides the standard :func:`dir` search on a module." msgstr "" -#: ../../reference/datamodel.rst:2017 +#: ../../reference/datamodel.rst:2021 msgid "" "For a more fine grained customization of the module behavior (setting " "attributes, properties, etc.), one can set the ``__class__`` attribute of a " "module object to a subclass of :class:`types.ModuleType`. For example::" msgstr "" -#: ../../reference/datamodel.rst:2035 +#: ../../reference/datamodel.rst:2039 msgid "" "Defining module ``__getattr__`` and setting module ``__class__`` only affect " "lookups made using the attribute access syntax -- directly accessing the " @@ -2276,27 +2280,27 @@ msgid "" "module's globals dictionary) is unaffected." msgstr "" -#: ../../reference/datamodel.rst:2040 +#: ../../reference/datamodel.rst:2044 msgid "``__class__`` module attribute is now writable." msgstr "" -#: ../../reference/datamodel.rst:2043 +#: ../../reference/datamodel.rst:2047 msgid "``__getattr__`` and ``__dir__`` module attributes." msgstr "" -#: ../../reference/datamodel.rst:2048 +#: ../../reference/datamodel.rst:2052 msgid ":pep:`562` - Module __getattr__ and __dir__" msgstr ":pep:`562` - 模組 __getattr__ 和 __dir__" -#: ../../reference/datamodel.rst:2049 +#: ../../reference/datamodel.rst:2053 msgid "Describes the ``__getattr__`` and ``__dir__`` functions on modules." msgstr "" -#: ../../reference/datamodel.rst:2055 +#: ../../reference/datamodel.rst:2059 msgid "Implementing Descriptors" msgstr "" -#: ../../reference/datamodel.rst:2057 +#: ../../reference/datamodel.rst:2061 msgid "" "The following methods only apply when an instance of the class containing " "the method (a so-called *descriptor* class) appears in an *owner* class (the " @@ -2306,7 +2310,7 @@ msgid "" "the owner class' :attr:`~object.__dict__`." msgstr "" -#: ../../reference/datamodel.rst:2067 +#: ../../reference/datamodel.rst:2071 msgid "" "Called to get the attribute of the owner class (class attribute access) or " "of an instance of that class (instance attribute access). The optional " @@ -2315,13 +2319,13 @@ msgid "" "accessed through the *owner*." msgstr "" -#: ../../reference/datamodel.rst:2073 +#: ../../reference/datamodel.rst:2077 msgid "" "This method should return the computed attribute value or raise an :exc:" "`AttributeError` exception." msgstr "" -#: ../../reference/datamodel.rst:2076 +#: ../../reference/datamodel.rst:2080 msgid "" ":PEP:`252` specifies that :meth:`__get__` is callable with one or two " "arguments. Python's own built-in descriptors support this specification; " @@ -2331,31 +2335,31 @@ msgid "" "not." msgstr "" -#: ../../reference/datamodel.rst:2085 +#: ../../reference/datamodel.rst:2089 msgid "" "Called to set the attribute on an instance *instance* of the owner class to " "a new value, *value*." msgstr "" -#: ../../reference/datamodel.rst:2088 +#: ../../reference/datamodel.rst:2092 msgid "" "Note, adding :meth:`__set__` or :meth:`__delete__` changes the kind of " "descriptor to a \"data descriptor\". See :ref:`descriptor-invocation` for " "more details." msgstr "" -#: ../../reference/datamodel.rst:2094 +#: ../../reference/datamodel.rst:2098 msgid "" "Called to delete the attribute on an instance *instance* of the owner class." msgstr "" -#: ../../reference/datamodel.rst:2096 +#: ../../reference/datamodel.rst:2100 msgid "" "Instances of descriptors may also have the :attr:`!__objclass__` attribute " "present:" msgstr "" -#: ../../reference/datamodel.rst:2101 +#: ../../reference/datamodel.rst:2105 msgid "" "The attribute :attr:`!__objclass__` is interpreted by the :mod:`inspect` " "module as specifying the class where this object was defined (setting this " @@ -2366,11 +2370,11 @@ msgid "" "are implemented in C)." msgstr "" -#: ../../reference/datamodel.rst:2112 +#: ../../reference/datamodel.rst:2116 msgid "Invoking Descriptors" msgstr "" -#: ../../reference/datamodel.rst:2114 +#: ../../reference/datamodel.rst:2118 msgid "" "In general, a descriptor is an object attribute with \"binding behavior\", " "one whose attribute access has been overridden by methods in the descriptor " @@ -2379,7 +2383,7 @@ msgid "" "is said to be a descriptor." msgstr "" -#: ../../reference/datamodel.rst:2120 +#: ../../reference/datamodel.rst:2124 msgid "" "The default behavior for attribute access is to get, set, or delete the " "attribute from an object's dictionary. For instance, ``a.x`` has a lookup " @@ -2387,7 +2391,7 @@ msgid "" "continuing through the base classes of ``type(a)`` excluding metaclasses." msgstr "" -#: ../../reference/datamodel.rst:2125 +#: ../../reference/datamodel.rst:2129 msgid "" "However, if the looked-up value is an object defining one of the descriptor " "methods, then Python may override the default behavior and invoke the " @@ -2395,54 +2399,54 @@ msgid "" "depends on which descriptor methods were defined and how they were called." msgstr "" -#: ../../reference/datamodel.rst:2130 +#: ../../reference/datamodel.rst:2134 msgid "" "The starting point for descriptor invocation is a binding, ``a.x``. How the " "arguments are assembled depends on ``a``:" msgstr "" -#: ../../reference/datamodel.rst:2133 +#: ../../reference/datamodel.rst:2137 msgid "Direct Call" msgstr "" -#: ../../reference/datamodel.rst:2134 +#: ../../reference/datamodel.rst:2138 msgid "" "The simplest and least common call is when user code directly invokes a " "descriptor method: ``x.__get__(a)``." msgstr "" -#: ../../reference/datamodel.rst:2137 +#: ../../reference/datamodel.rst:2141 msgid "Instance Binding" msgstr "" -#: ../../reference/datamodel.rst:2138 +#: ../../reference/datamodel.rst:2142 msgid "" "If binding to an object instance, ``a.x`` is transformed into the call: " "``type(a).__dict__['x'].__get__(a, type(a))``." msgstr "" -#: ../../reference/datamodel.rst:2141 +#: ../../reference/datamodel.rst:2145 msgid "Class Binding" msgstr "" -#: ../../reference/datamodel.rst:2142 +#: ../../reference/datamodel.rst:2146 msgid "" "If binding to a class, ``A.x`` is transformed into the call: ``A." "__dict__['x'].__get__(None, A)``." msgstr "" -#: ../../reference/datamodel.rst:2145 +#: ../../reference/datamodel.rst:2149 msgid "Super Binding" msgstr "" -#: ../../reference/datamodel.rst:2146 +#: ../../reference/datamodel.rst:2150 msgid "" "A dotted lookup such as ``super(A, a).x`` searches ``a.__class__.__mro__`` " "for a base class ``B`` following ``A`` and then returns ``B.__dict__['x']." "__get__(a, A)``. If not a descriptor, ``x`` is returned unchanged." msgstr "" -#: ../../reference/datamodel.rst:2183 +#: ../../reference/datamodel.rst:2187 msgid "" "For instance bindings, the precedence of descriptor invocation depends on " "which descriptor methods are defined. A descriptor can define any " @@ -2460,7 +2464,7 @@ msgid "" "instances." msgstr "" -#: ../../reference/datamodel.rst:2198 +#: ../../reference/datamodel.rst:2202 msgid "" "Python methods (including those decorated with :func:`@staticmethod " "` and :func:`@classmethod `) are implemented as " @@ -2469,30 +2473,30 @@ msgid "" "from other instances of the same class." msgstr "" -#: ../../reference/datamodel.rst:2204 +#: ../../reference/datamodel.rst:2208 msgid "" "The :func:`property` function is implemented as a data descriptor. " "Accordingly, instances cannot override the behavior of a property." msgstr "" -#: ../../reference/datamodel.rst:2211 +#: ../../reference/datamodel.rst:2215 msgid "__slots__" msgstr "__slots__" -#: ../../reference/datamodel.rst:2213 +#: ../../reference/datamodel.rst:2217 msgid "" "*__slots__* allow us to explicitly declare data members (like properties) " "and deny the creation of :attr:`~object.__dict__` and *__weakref__* (unless " "explicitly declared in *__slots__* or available in a parent.)" msgstr "" -#: ../../reference/datamodel.rst:2217 +#: ../../reference/datamodel.rst:2221 msgid "" "The space saved over using :attr:`~object.__dict__` can be significant. " "Attribute lookup speed can be significantly improved as well." msgstr "" -#: ../../reference/datamodel.rst:2222 +#: ../../reference/datamodel.rst:2226 msgid "" "This class variable can be assigned a string, iterable, or sequence of " "strings with variable names used by instances. *__slots__* reserves space " @@ -2500,18 +2504,18 @@ msgid "" "`~object.__dict__` and *__weakref__* for each instance." msgstr "" -#: ../../reference/datamodel.rst:2231 +#: ../../reference/datamodel.rst:2235 msgid "Notes on using *__slots__*:" msgstr "" -#: ../../reference/datamodel.rst:2233 +#: ../../reference/datamodel.rst:2237 msgid "" "When inheriting from a class without *__slots__*, the :attr:`~object." "__dict__` and *__weakref__* attribute of the instances will always be " "accessible." msgstr "" -#: ../../reference/datamodel.rst:2237 +#: ../../reference/datamodel.rst:2241 msgid "" "Without a :attr:`~object.__dict__` variable, instances cannot be assigned " "new variables not listed in the *__slots__* definition. Attempts to assign " @@ -2520,7 +2524,7 @@ msgid "" "sequence of strings in the *__slots__* declaration." msgstr "" -#: ../../reference/datamodel.rst:2244 +#: ../../reference/datamodel.rst:2248 msgid "" "Without a *__weakref__* variable for each instance, classes defining " "*__slots__* do not support :mod:`weak references ` to its " @@ -2528,7 +2532,7 @@ msgid "" "to the sequence of strings in the *__slots__* declaration." msgstr "" -#: ../../reference/datamodel.rst:2250 +#: ../../reference/datamodel.rst:2254 msgid "" "*__slots__* are implemented at the class level by creating :ref:`descriptors " "` for each variable name. As a result, class attributes cannot " @@ -2536,7 +2540,7 @@ msgid "" "otherwise, the class attribute would overwrite the descriptor assignment." msgstr "" -#: ../../reference/datamodel.rst:2256 +#: ../../reference/datamodel.rst:2260 msgid "" "The action of a *__slots__* declaration is not limited to the class where it " "is defined. *__slots__* declared in parents are available in child classes. " @@ -2545,7 +2549,7 @@ msgid "" "names of any *additional* slots)." msgstr "" -#: ../../reference/datamodel.rst:2262 +#: ../../reference/datamodel.rst:2266 msgid "" "If a class defines a slot also defined in a base class, the instance " "variable defined by the base class slot is inaccessible (except by " @@ -2554,7 +2558,7 @@ msgid "" "prevent this." msgstr "" -#: ../../reference/datamodel.rst:2267 +#: ../../reference/datamodel.rst:2271 msgid "" ":exc:`TypeError` will be raised if nonempty *__slots__* are defined for a " "class derived from a :c:member:`\"variable-length\" built-in type " @@ -2562,11 +2566,11 @@ msgid "" "`tuple`." msgstr "" -#: ../../reference/datamodel.rst:2272 +#: ../../reference/datamodel.rst:2276 msgid "Any non-string :term:`iterable` may be assigned to *__slots__*." msgstr "" -#: ../../reference/datamodel.rst:2274 +#: ../../reference/datamodel.rst:2278 msgid "" "If a :class:`dictionary ` is used to assign *__slots__*, the " "dictionary keys will be used as the slot names. The values of the dictionary " @@ -2574,13 +2578,13 @@ msgid "" "func:`inspect.getdoc` and displayed in the output of :func:`help`." msgstr "" -#: ../../reference/datamodel.rst:2279 +#: ../../reference/datamodel.rst:2283 msgid "" ":attr:`~instance.__class__` assignment works only if both classes have the " "same *__slots__*." msgstr "" -#: ../../reference/datamodel.rst:2282 +#: ../../reference/datamodel.rst:2286 msgid "" ":ref:`Multiple inheritance ` with multiple slotted parent " "classes can be used, but only one parent is allowed to have attributes " @@ -2588,18 +2592,18 @@ msgid "" "raise :exc:`TypeError`." msgstr "" -#: ../../reference/datamodel.rst:2288 +#: ../../reference/datamodel.rst:2292 msgid "" "If an :term:`iterator` is used for *__slots__* then a :term:`descriptor` is " "created for each of the iterator's values. However, the *__slots__* " "attribute will be an empty iterator." msgstr "" -#: ../../reference/datamodel.rst:2296 +#: ../../reference/datamodel.rst:2300 msgid "Customizing class creation" msgstr "" -#: ../../reference/datamodel.rst:2298 +#: ../../reference/datamodel.rst:2302 msgid "" "Whenever a class inherits from another class, :meth:`~object." "__init_subclass__` is called on the parent class. This way, it is possible " @@ -2609,14 +2613,14 @@ msgid "" "future subclasses of the class defining the method." msgstr "" -#: ../../reference/datamodel.rst:2307 +#: ../../reference/datamodel.rst:2311 msgid "" "This method is called whenever the containing class is subclassed. *cls* is " "then the new subclass. If defined as a normal instance method, this method " "is implicitly converted to a class method." msgstr "" -#: ../../reference/datamodel.rst:2311 +#: ../../reference/datamodel.rst:2315 msgid "" "Keyword arguments which are given to a new class are passed to the parent " "class's ``__init_subclass__``. For compatibility with other classes using " @@ -2624,13 +2628,13 @@ msgid "" "pass the others over to the base class, as in::" msgstr "" -#: ../../reference/datamodel.rst:2325 +#: ../../reference/datamodel.rst:2329 msgid "" "The default implementation ``object.__init_subclass__`` does nothing, but " "raises an error if it is called with any arguments." msgstr "" -#: ../../reference/datamodel.rst:2330 +#: ../../reference/datamodel.rst:2334 msgid "" "The metaclass hint ``metaclass`` is consumed by the rest of the type " "machinery, and is never passed to ``__init_subclass__`` implementations. The " @@ -2638,41 +2642,41 @@ msgid "" "``type(cls)``." msgstr "" -#: ../../reference/datamodel.rst:2338 +#: ../../reference/datamodel.rst:2342 msgid "" "When a class is created, :meth:`type.__new__` scans the class variables and " "makes callbacks to those with a :meth:`~object.__set_name__` hook." msgstr "" -#: ../../reference/datamodel.rst:2343 +#: ../../reference/datamodel.rst:2347 msgid "" "Automatically called at the time the owning class *owner* is created. The " "object has been assigned to *name* in that class::" msgstr "" -#: ../../reference/datamodel.rst:2349 +#: ../../reference/datamodel.rst:2353 msgid "" "If the class variable is assigned after the class is created, :meth:" "`__set_name__` will not be called automatically. If needed, :meth:" "`__set_name__` can be called directly::" msgstr "" -#: ../../reference/datamodel.rst:2360 +#: ../../reference/datamodel.rst:2364 msgid "See :ref:`class-object-creation` for more details." msgstr "更多細節請見 :ref:`class-object-creation`。" -#: ../../reference/datamodel.rst:2368 +#: ../../reference/datamodel.rst:2372 msgid "Metaclasses" msgstr "" -#: ../../reference/datamodel.rst:2375 +#: ../../reference/datamodel.rst:2379 msgid "" "By default, classes are constructed using :func:`type`. The class body is " "executed in a new namespace and the class name is bound locally to the " "result of ``type(name, bases, namespace)``." msgstr "" -#: ../../reference/datamodel.rst:2379 +#: ../../reference/datamodel.rst:2383 msgid "" "The class creation process can be customized by passing the ``metaclass`` " "keyword argument in the class definition line, or by inheriting from an " @@ -2680,41 +2684,41 @@ msgid "" "both ``MyClass`` and ``MySubclass`` are instances of ``Meta``::" msgstr "" -#: ../../reference/datamodel.rst:2393 +#: ../../reference/datamodel.rst:2397 msgid "" "Any other keyword arguments that are specified in the class definition are " "passed through to all metaclass operations described below." msgstr "" -#: ../../reference/datamodel.rst:2396 +#: ../../reference/datamodel.rst:2400 msgid "When a class definition is executed, the following steps occur:" msgstr "" -#: ../../reference/datamodel.rst:2398 +#: ../../reference/datamodel.rst:2402 msgid "MRO entries are resolved;" msgstr "" -#: ../../reference/datamodel.rst:2399 +#: ../../reference/datamodel.rst:2403 msgid "the appropriate metaclass is determined;" msgstr "" -#: ../../reference/datamodel.rst:2400 +#: ../../reference/datamodel.rst:2404 msgid "the class namespace is prepared;" msgstr "" -#: ../../reference/datamodel.rst:2401 +#: ../../reference/datamodel.rst:2405 msgid "the class body is executed;" msgstr "" -#: ../../reference/datamodel.rst:2402 +#: ../../reference/datamodel.rst:2406 msgid "the class object is created." msgstr "" -#: ../../reference/datamodel.rst:2406 +#: ../../reference/datamodel.rst:2410 msgid "Resolving MRO entries" msgstr "" -#: ../../reference/datamodel.rst:2410 +#: ../../reference/datamodel.rst:2414 msgid "" "If a base that appears in a class definition is not an instance of :class:" "`type`, then an :meth:`!__mro_entries__` method is searched on the base. If " @@ -2726,59 +2730,59 @@ msgid "" "is ignored." msgstr "" -#: ../../reference/datamodel.rst:2421 +#: ../../reference/datamodel.rst:2425 msgid ":func:`types.resolve_bases`" msgstr ":func:`types.resolve_bases`" -#: ../../reference/datamodel.rst:2422 +#: ../../reference/datamodel.rst:2426 msgid "Dynamically resolve bases that are not instances of :class:`type`." msgstr "" -#: ../../reference/datamodel.rst:2424 +#: ../../reference/datamodel.rst:2428 msgid ":func:`types.get_original_bases`" msgstr ":func:`types.get_original_bases`" -#: ../../reference/datamodel.rst:2425 +#: ../../reference/datamodel.rst:2429 msgid "" "Retrieve a class's \"original bases\" prior to modifications by :meth:" "`~object.__mro_entries__`." msgstr "" -#: ../../reference/datamodel.rst:2428 +#: ../../reference/datamodel.rst:2432 msgid ":pep:`560`" msgstr ":pep:`560`" -#: ../../reference/datamodel.rst:2429 +#: ../../reference/datamodel.rst:2433 msgid "Core support for typing module and generic types." msgstr "" -#: ../../reference/datamodel.rst:2433 +#: ../../reference/datamodel.rst:2437 msgid "Determining the appropriate metaclass" msgstr "" -#: ../../reference/datamodel.rst:2437 +#: ../../reference/datamodel.rst:2441 msgid "" "The appropriate metaclass for a class definition is determined as follows:" msgstr "" -#: ../../reference/datamodel.rst:2439 +#: ../../reference/datamodel.rst:2443 msgid "" "if no bases and no explicit metaclass are given, then :func:`type` is used;" msgstr "" -#: ../../reference/datamodel.rst:2440 +#: ../../reference/datamodel.rst:2444 msgid "" "if an explicit metaclass is given and it is *not* an instance of :func:" "`type`, then it is used directly as the metaclass;" msgstr "" -#: ../../reference/datamodel.rst:2442 +#: ../../reference/datamodel.rst:2446 msgid "" "if an instance of :func:`type` is given as the explicit metaclass, or bases " "are defined, then the most derived metaclass is used." msgstr "" -#: ../../reference/datamodel.rst:2445 +#: ../../reference/datamodel.rst:2449 msgid "" "The most derived metaclass is selected from the explicitly specified " "metaclass (if any) and the metaclasses (i.e. ``type(cls)``) of all specified " @@ -2787,11 +2791,11 @@ msgid "" "that criterion, then the class definition will fail with ``TypeError``." msgstr "" -#: ../../reference/datamodel.rst:2455 +#: ../../reference/datamodel.rst:2459 msgid "Preparing the class namespace" msgstr "" -#: ../../reference/datamodel.rst:2460 +#: ../../reference/datamodel.rst:2464 msgid "" "Once the appropriate metaclass has been identified, then the class namespace " "is prepared. If the metaclass has a ``__prepare__`` attribute, it is called " @@ -2803,25 +2807,25 @@ msgid "" "copied into a new ``dict``." msgstr "" -#: ../../reference/datamodel.rst:2469 +#: ../../reference/datamodel.rst:2473 msgid "" "If the metaclass has no ``__prepare__`` attribute, then the class namespace " "is initialised as an empty ordered mapping." msgstr "" -#: ../../reference/datamodel.rst:2474 +#: ../../reference/datamodel.rst:2478 msgid ":pep:`3115` - Metaclasses in Python 3000" msgstr "" -#: ../../reference/datamodel.rst:2475 +#: ../../reference/datamodel.rst:2479 msgid "Introduced the ``__prepare__`` namespace hook" msgstr "" -#: ../../reference/datamodel.rst:2479 +#: ../../reference/datamodel.rst:2483 msgid "Executing the class body" msgstr "" -#: ../../reference/datamodel.rst:2484 +#: ../../reference/datamodel.rst:2488 msgid "" "The class body is executed (approximately) as ``exec(body, globals(), " "namespace)``. The key difference from a normal call to :func:`exec` is that " @@ -2830,7 +2834,7 @@ msgid "" "inside a function." msgstr "" -#: ../../reference/datamodel.rst:2490 +#: ../../reference/datamodel.rst:2494 msgid "" "However, even when the class definition occurs inside the function, methods " "defined inside the class still cannot see names defined at the class scope. " @@ -2839,11 +2843,11 @@ msgid "" "reference described in the next section." msgstr "" -#: ../../reference/datamodel.rst:2499 +#: ../../reference/datamodel.rst:2503 msgid "Creating the class object" msgstr "" -#: ../../reference/datamodel.rst:2506 +#: ../../reference/datamodel.rst:2510 msgid "" "Once the class namespace has been populated by executing the class body, the " "class object is created by calling ``metaclass(name, bases, namespace, " @@ -2851,7 +2855,7 @@ msgid "" "to ``__prepare__``)." msgstr "" -#: ../../reference/datamodel.rst:2511 +#: ../../reference/datamodel.rst:2515 msgid "" "This class object is the one that will be referenced by the zero-argument " "form of :func:`super`. ``__class__`` is an implicit closure reference " @@ -2862,7 +2866,7 @@ msgid "" "is identified based on the first argument passed to the method." msgstr "" -#: ../../reference/datamodel.rst:2521 +#: ../../reference/datamodel.rst:2525 msgid "" "In CPython 3.6 and later, the ``__class__`` cell is passed to the metaclass " "as a ``__classcell__`` entry in the class namespace. If present, this must " @@ -2871,39 +2875,39 @@ msgid "" "in Python 3.8." msgstr "" -#: ../../reference/datamodel.rst:2527 +#: ../../reference/datamodel.rst:2531 msgid "" "When using the default metaclass :class:`type`, or any metaclass that " "ultimately calls ``type.__new__``, the following additional customization " "steps are invoked after creating the class object:" msgstr "" -#: ../../reference/datamodel.rst:2531 +#: ../../reference/datamodel.rst:2535 msgid "" "The ``type.__new__`` method collects all of the attributes in the class " "namespace that define a :meth:`~object.__set_name__` method;" msgstr "" -#: ../../reference/datamodel.rst:2533 +#: ../../reference/datamodel.rst:2537 msgid "" "Those ``__set_name__`` methods are called with the class being defined and " "the assigned name of that particular attribute;" msgstr "" -#: ../../reference/datamodel.rst:2535 +#: ../../reference/datamodel.rst:2539 msgid "" "The :meth:`~object.__init_subclass__` hook is called on the immediate parent " "of the new class in its method resolution order." msgstr "" -#: ../../reference/datamodel.rst:2538 +#: ../../reference/datamodel.rst:2542 msgid "" "After the class object is created, it is passed to the class decorators " "included in the class definition (if any) and the resulting object is bound " "in the local namespace as the defined class." msgstr "" -#: ../../reference/datamodel.rst:2542 +#: ../../reference/datamodel.rst:2546 msgid "" "When a new class is created by ``type.__new__``, the object provided as the " "namespace parameter is copied to a new ordered mapping and the original " @@ -2911,19 +2915,19 @@ msgid "" "becomes the :attr:`~object.__dict__` attribute of the class object." msgstr "" -#: ../../reference/datamodel.rst:2549 +#: ../../reference/datamodel.rst:2553 msgid ":pep:`3135` - New super" msgstr "" -#: ../../reference/datamodel.rst:2550 +#: ../../reference/datamodel.rst:2554 msgid "Describes the implicit ``__class__`` closure reference" msgstr "" -#: ../../reference/datamodel.rst:2554 +#: ../../reference/datamodel.rst:2558 msgid "Uses for metaclasses" msgstr "" -#: ../../reference/datamodel.rst:2556 +#: ../../reference/datamodel.rst:2560 msgid "" "The potential uses for metaclasses are boundless. Some ideas that have been " "explored include enum, logging, interface checking, automatic delegation, " @@ -2931,17 +2935,17 @@ msgid "" "locking/synchronization." msgstr "" -#: ../../reference/datamodel.rst:2563 +#: ../../reference/datamodel.rst:2567 msgid "Customizing instance and subclass checks" msgstr "" -#: ../../reference/datamodel.rst:2565 +#: ../../reference/datamodel.rst:2569 msgid "" "The following methods are used to override the default behavior of the :func:" "`isinstance` and :func:`issubclass` built-in functions." msgstr "" -#: ../../reference/datamodel.rst:2568 +#: ../../reference/datamodel.rst:2572 msgid "" "In particular, the metaclass :class:`abc.ABCMeta` implements these methods " "in order to allow the addition of Abstract Base Classes (ABCs) as \"virtual " @@ -2949,21 +2953,21 @@ msgid "" "other ABCs." msgstr "" -#: ../../reference/datamodel.rst:2575 +#: ../../reference/datamodel.rst:2579 msgid "" "Return true if *instance* should be considered a (direct or indirect) " "instance of *class*. If defined, called to implement ``isinstance(instance, " "class)``." msgstr "" -#: ../../reference/datamodel.rst:2582 +#: ../../reference/datamodel.rst:2586 msgid "" "Return true if *subclass* should be considered a (direct or indirect) " "subclass of *class*. If defined, called to implement ``issubclass(subclass, " "class)``." msgstr "" -#: ../../reference/datamodel.rst:2587 +#: ../../reference/datamodel.rst:2591 msgid "" "Note that these methods are looked up on the type (metaclass) of a class. " "They cannot be defined as class methods in the actual class. This is " @@ -2971,11 +2975,11 @@ msgid "" "only in this case the instance is itself a class." msgstr "" -#: ../../reference/datamodel.rst:2594 +#: ../../reference/datamodel.rst:2598 msgid ":pep:`3119` - Introducing Abstract Base Classes" msgstr "" -#: ../../reference/datamodel.rst:2595 +#: ../../reference/datamodel.rst:2599 msgid "" "Includes the specification for customizing :func:`isinstance` and :func:" "`issubclass` behavior through :meth:`~class.__instancecheck__` and :meth:" @@ -2984,11 +2988,11 @@ msgid "" "language." msgstr "" -#: ../../reference/datamodel.rst:2603 +#: ../../reference/datamodel.rst:2607 msgid "Emulating generic types" msgstr "" -#: ../../reference/datamodel.rst:2605 +#: ../../reference/datamodel.rst:2609 msgid "" "When using :term:`type annotations`, it is often useful to " "*parameterize* a :term:`generic type` using Python's square-brackets " @@ -2996,65 +3000,65 @@ msgid "" "a :class:`list` in which all the elements are of type :class:`int`." msgstr "" -#: ../../reference/datamodel.rst:2612 +#: ../../reference/datamodel.rst:2616 msgid ":pep:`484` - Type Hints" msgstr "" -#: ../../reference/datamodel.rst:2613 +#: ../../reference/datamodel.rst:2617 msgid "Introducing Python's framework for type annotations" msgstr "" -#: ../../reference/datamodel.rst:2615 +#: ../../reference/datamodel.rst:2619 msgid ":ref:`Generic Alias Types`" msgstr ":ref:`泛型別名型別 `" -#: ../../reference/datamodel.rst:2616 +#: ../../reference/datamodel.rst:2620 msgid "Documentation for objects representing parameterized generic classes" msgstr "" -#: ../../reference/datamodel.rst:2618 +#: ../../reference/datamodel.rst:2622 msgid "" ":ref:`Generics`, :ref:`user-defined generics` and :" "class:`typing.Generic`" msgstr "" -#: ../../reference/datamodel.rst:2619 +#: ../../reference/datamodel.rst:2623 msgid "" "Documentation on how to implement generic classes that can be parameterized " "at runtime and understood by static type-checkers." msgstr "" -#: ../../reference/datamodel.rst:2622 +#: ../../reference/datamodel.rst:2626 msgid "" "A class can *generally* only be parameterized if it defines the special " "class method ``__class_getitem__()``." msgstr "" -#: ../../reference/datamodel.rst:2627 +#: ../../reference/datamodel.rst:2631 msgid "" "Return an object representing the specialization of a generic class by type " "arguments found in *key*." msgstr "" -#: ../../reference/datamodel.rst:2630 +#: ../../reference/datamodel.rst:2634 msgid "" "When defined on a class, ``__class_getitem__()`` is automatically a class " "method. As such, there is no need for it to be decorated with :func:" "`@classmethod` when it is defined." msgstr "" -#: ../../reference/datamodel.rst:2636 +#: ../../reference/datamodel.rst:2640 msgid "The purpose of *__class_getitem__*" msgstr "" -#: ../../reference/datamodel.rst:2638 +#: ../../reference/datamodel.rst:2642 msgid "" "The purpose of :meth:`~object.__class_getitem__` is to allow runtime " "parameterization of standard-library generic classes in order to more easily " "apply :term:`type hints` to these classes." msgstr "" -#: ../../reference/datamodel.rst:2642 +#: ../../reference/datamodel.rst:2646 msgid "" "To implement custom generic classes that can be parameterized at runtime and " "understood by static type-checkers, users should either inherit from a " @@ -3063,7 +3067,7 @@ msgid "" "own implementation of ``__class_getitem__()``." msgstr "" -#: ../../reference/datamodel.rst:2648 +#: ../../reference/datamodel.rst:2652 msgid "" "Custom implementations of :meth:`~object.__class_getitem__` on classes " "defined outside of the standard library may not be understood by third-party " @@ -3071,11 +3075,11 @@ msgid "" "purposes other than type hinting is discouraged." msgstr "" -#: ../../reference/datamodel.rst:2658 +#: ../../reference/datamodel.rst:2662 msgid "*__class_getitem__* versus *__getitem__*" msgstr "" -#: ../../reference/datamodel.rst:2660 +#: ../../reference/datamodel.rst:2664 msgid "" "Usually, the :ref:`subscription` of an object using square " "brackets will call the :meth:`~object.__getitem__` instance method defined " @@ -3085,14 +3089,14 @@ msgid "" "genericalias>` object if it is properly defined." msgstr "" -#: ../../reference/datamodel.rst:2667 +#: ../../reference/datamodel.rst:2671 msgid "" "Presented with the :term:`expression` ``obj[x]``, the Python interpreter " "follows something like the following process to decide whether :meth:" "`~object.__getitem__` or :meth:`~object.__class_getitem__` should be called::" msgstr "" -#: ../../reference/datamodel.rst:2695 +#: ../../reference/datamodel.rst:2699 msgid "" "In Python, all classes are themselves instances of other classes. The class " "of a class is known as that class's :term:`metaclass`, and most classes have " @@ -3102,40 +3106,40 @@ msgid "" "__class_getitem__` being called::" msgstr "" -#: ../../reference/datamodel.rst:2714 +#: ../../reference/datamodel.rst:2718 msgid "" "However, if a class has a custom metaclass that defines :meth:`~object." "__getitem__`, subscribing the class may result in different behaviour. An " "example of this can be found in the :mod:`enum` module::" msgstr "" -#: ../../reference/datamodel.rst:2737 +#: ../../reference/datamodel.rst:2741 msgid ":pep:`560` - Core Support for typing module and generic types" msgstr "" -#: ../../reference/datamodel.rst:2738 +#: ../../reference/datamodel.rst:2742 msgid "" "Introducing :meth:`~object.__class_getitem__`, and outlining when a :ref:" "`subscription` results in ``__class_getitem__()`` being " "called instead of :meth:`~object.__getitem__`" msgstr "" -#: ../../reference/datamodel.rst:2746 +#: ../../reference/datamodel.rst:2750 msgid "Emulating callable objects" msgstr "" -#: ../../reference/datamodel.rst:2753 +#: ../../reference/datamodel.rst:2757 msgid "" "Called when the instance is \"called\" as a function; if this method is " "defined, ``x(arg1, arg2, ...)`` roughly translates to ``type(x).__call__(x, " "arg1, ...)``." msgstr "" -#: ../../reference/datamodel.rst:2760 +#: ../../reference/datamodel.rst:2764 msgid "Emulating container types" msgstr "" -#: ../../reference/datamodel.rst:2762 +#: ../../reference/datamodel.rst:2766 msgid "" "The following methods can be defined to implement container objects. " "Containers usually are :term:`sequences ` (such as :class:`lists " @@ -3171,7 +3175,7 @@ msgid "" "should iterate through the values." msgstr "" -#: ../../reference/datamodel.rst:2803 +#: ../../reference/datamodel.rst:2807 msgid "" "Called to implement the built-in function :func:`len`. Should return the " "length of the object, an integer ``>=`` 0. Also, an object that doesn't " @@ -3179,7 +3183,7 @@ msgid "" "returns zero is considered to be false in a Boolean context." msgstr "" -#: ../../reference/datamodel.rst:2810 +#: ../../reference/datamodel.rst:2814 msgid "" "In CPython, the length is required to be at most :data:`sys.maxsize`. If the " "length is larger than :data:`!sys.maxsize` some features (such as :func:" @@ -3188,7 +3192,7 @@ msgid "" "`~object.__bool__` method." msgstr "" -#: ../../reference/datamodel.rst:2819 +#: ../../reference/datamodel.rst:2823 msgid "" "Called to implement :func:`operator.length_hint`. Should return an estimated " "length for the object (which may be greater or less than the actual length). " @@ -3198,20 +3202,20 @@ msgid "" "never required for correctness." msgstr "" -#: ../../reference/datamodel.rst:2833 +#: ../../reference/datamodel.rst:2837 msgid "" "Slicing is done exclusively with the following three methods. A call like ::" msgstr "" -#: ../../reference/datamodel.rst:2837 +#: ../../reference/datamodel.rst:2841 msgid "is translated to ::" msgstr "" -#: ../../reference/datamodel.rst:2841 +#: ../../reference/datamodel.rst:2845 msgid "and so forth. Missing slice items are always filled in with ``None``." msgstr "" -#: ../../reference/datamodel.rst:2846 +#: ../../reference/datamodel.rst:2850 msgid "" "Called to implement evaluation of ``self[key]``. For :term:`sequence` types, " "the accepted keys should be integers. Optionally, they may support :class:" @@ -3223,20 +3227,20 @@ msgid "" "`KeyError` should be raised." msgstr "" -#: ../../reference/datamodel.rst:2858 +#: ../../reference/datamodel.rst:2862 msgid "" ":keyword:`for` loops expect that an :exc:`IndexError` will be raised for " "illegal indexes to allow proper detection of the end of the sequence." msgstr "" -#: ../../reference/datamodel.rst:2863 +#: ../../reference/datamodel.rst:2867 msgid "" "When :ref:`subscripting` a *class*, the special class method :" "meth:`~object.__class_getitem__` may be called instead of ``__getitem__()``. " "See :ref:`classgetitem-versus-getitem` for more details." msgstr "" -#: ../../reference/datamodel.rst:2871 +#: ../../reference/datamodel.rst:2875 msgid "" "Called to implement assignment to ``self[key]``. Same note as for :meth:" "`__getitem__`. This should only be implemented for mappings if the objects " @@ -3245,7 +3249,7 @@ msgid "" "for improper *key* values as for the :meth:`__getitem__` method." msgstr "" -#: ../../reference/datamodel.rst:2880 +#: ../../reference/datamodel.rst:2884 msgid "" "Called to implement deletion of ``self[key]``. Same note as for :meth:" "`__getitem__`. This should only be implemented for mappings if the objects " @@ -3254,13 +3258,13 @@ msgid "" "values as for the :meth:`__getitem__` method." msgstr "" -#: ../../reference/datamodel.rst:2889 +#: ../../reference/datamodel.rst:2893 msgid "" "Called by :class:`dict`\\ .\\ :meth:`__getitem__` to implement ``self[key]`` " "for dict subclasses when key is not in the dictionary." msgstr "" -#: ../../reference/datamodel.rst:2895 +#: ../../reference/datamodel.rst:2899 msgid "" "This method is called when an :term:`iterator` is required for a container. " "This method should return a new iterator object that can iterate over all " @@ -3268,14 +3272,14 @@ msgid "" "of the container." msgstr "" -#: ../../reference/datamodel.rst:2903 +#: ../../reference/datamodel.rst:2907 msgid "" "Called (if present) by the :func:`reversed` built-in to implement reverse " "iteration. It should return a new iterator object that iterates over all " "the objects in the container in reverse order." msgstr "" -#: ../../reference/datamodel.rst:2907 +#: ../../reference/datamodel.rst:2911 msgid "" "If the :meth:`__reversed__` method is not provided, the :func:`reversed` " "built-in will fall back to using the sequence protocol (:meth:`__len__` and :" @@ -3284,7 +3288,7 @@ msgid "" "more efficient than the one provided by :func:`reversed`." msgstr "" -#: ../../reference/datamodel.rst:2914 +#: ../../reference/datamodel.rst:2918 msgid "" "The membership test operators (:keyword:`in` and :keyword:`not in`) are " "normally implemented as an iteration through a container. However, container " @@ -3292,14 +3296,14 @@ msgid "" "implementation, which also does not require the object be iterable." msgstr "" -#: ../../reference/datamodel.rst:2921 +#: ../../reference/datamodel.rst:2925 msgid "" "Called to implement membership test operators. Should return true if *item* " "is in *self*, false otherwise. For mapping objects, this should consider " "the keys of the mapping rather than the values or the key-item pairs." msgstr "" -#: ../../reference/datamodel.rst:2925 +#: ../../reference/datamodel.rst:2929 msgid "" "For objects that don't define :meth:`__contains__`, the membership test " "first tries iteration via :meth:`__iter__`, then the old sequence iteration " @@ -3307,11 +3311,11 @@ msgid "" "reference `." msgstr "" -#: ../../reference/datamodel.rst:2934 +#: ../../reference/datamodel.rst:2938 msgid "Emulating numeric types" msgstr "" -#: ../../reference/datamodel.rst:2936 +#: ../../reference/datamodel.rst:2940 msgid "" "The following methods can be defined to emulate numeric objects. Methods " "corresponding to operations that are not supported by the particular kind of " @@ -3319,7 +3323,7 @@ msgid "" "should be left undefined." msgstr "" -#: ../../reference/datamodel.rst:2962 +#: ../../reference/datamodel.rst:2966 msgid "" "These methods are called to implement the binary arithmetic operations " "(``+``, ``-``, ``*``, ``@``, ``/``, ``//``, ``%``, :func:`divmod`, :func:" @@ -3333,13 +3337,13 @@ msgid "" "function is to be supported." msgstr "" -#: ../../reference/datamodel.rst:2973 +#: ../../reference/datamodel.rst:2977 msgid "" "If one of those methods does not support the operation with the supplied " "arguments, it should return :data:`NotImplemented`." msgstr "" -#: ../../reference/datamodel.rst:2996 +#: ../../reference/datamodel.rst:3000 msgid "" "These methods are called to implement the binary arithmetic operations " "(``+``, ``-``, ``*``, ``@``, ``/``, ``//``, ``%``, :func:`divmod`, :func:" @@ -3352,13 +3356,13 @@ msgid "" "`NotImplemented`." msgstr "" -#: ../../reference/datamodel.rst:3008 +#: ../../reference/datamodel.rst:3012 msgid "" "Note that ternary :func:`pow` will not try calling :meth:`__rpow__` (the " "coercion rules would become too complicated)." msgstr "" -#: ../../reference/datamodel.rst:3013 +#: ../../reference/datamodel.rst:3017 msgid "" "If the right operand's type is a subclass of the left operand's type and " "that subclass provides a different implementation of the reflected method " @@ -3367,7 +3371,7 @@ msgid "" "ancestors' operations." msgstr "" -#: ../../reference/datamodel.rst:3034 +#: ../../reference/datamodel.rst:3038 msgid "" "These methods are called to implement the augmented arithmetic assignments " "(``+=``, ``-=``, ``*=``, ``@=``, ``/=``, ``//=``, ``%=``, ``**=``, ``<<=``, " @@ -3385,19 +3389,19 @@ msgid "" "data model." msgstr "" -#: ../../reference/datamodel.rst:3057 +#: ../../reference/datamodel.rst:3061 msgid "" "Called to implement the unary arithmetic operations (``-``, ``+``, :func:" "`abs` and ``~``)." msgstr "" -#: ../../reference/datamodel.rst:3070 +#: ../../reference/datamodel.rst:3074 msgid "" "Called to implement the built-in functions :func:`complex`, :func:`int` and :" "func:`float`. Should return a value of the appropriate type." msgstr "" -#: ../../reference/datamodel.rst:3077 +#: ../../reference/datamodel.rst:3081 msgid "" "Called to implement :func:`operator.index`, and whenever Python needs to " "losslessly convert the numeric object to an integer object (such as in " @@ -3406,14 +3410,14 @@ msgid "" "integer type. Must return an integer." msgstr "" -#: ../../reference/datamodel.rst:3083 +#: ../../reference/datamodel.rst:3087 msgid "" "If :meth:`__int__`, :meth:`__float__` and :meth:`__complex__` are not " "defined then corresponding built-in functions :func:`int`, :func:`float` " "and :func:`complex` fall back to :meth:`__index__`." msgstr "" -#: ../../reference/datamodel.rst:3095 +#: ../../reference/datamodel.rst:3099 msgid "" "Called to implement the built-in function :func:`round` and :mod:`math` " "functions :func:`~math.trunc`, :func:`~math.floor` and :func:`~math.ceil`. " @@ -3422,21 +3426,21 @@ msgid "" "(typically an :class:`int`)." msgstr "" -#: ../../reference/datamodel.rst:3101 +#: ../../reference/datamodel.rst:3105 msgid "" "The built-in function :func:`int` falls back to :meth:`__trunc__` if " "neither :meth:`__int__` nor :meth:`__index__` is defined." msgstr "" -#: ../../reference/datamodel.rst:3104 +#: ../../reference/datamodel.rst:3108 msgid "The delegation of :func:`int` to :meth:`__trunc__` is deprecated." msgstr "" -#: ../../reference/datamodel.rst:3111 +#: ../../reference/datamodel.rst:3115 msgid "With Statement Context Managers" msgstr "" -#: ../../reference/datamodel.rst:3113 +#: ../../reference/datamodel.rst:3117 msgid "" "A :dfn:`context manager` is an object that defines the runtime context to be " "established when executing a :keyword:`with` statement. The context manager " @@ -3446,32 +3450,32 @@ msgid "" "can also be used by directly invoking their methods." msgstr "" -#: ../../reference/datamodel.rst:3124 +#: ../../reference/datamodel.rst:3128 msgid "" "Typical uses of context managers include saving and restoring various kinds " "of global state, locking and unlocking resources, closing opened files, etc." msgstr "" -#: ../../reference/datamodel.rst:3127 +#: ../../reference/datamodel.rst:3131 msgid "" "For more information on context managers, see :ref:`typecontextmanager`." msgstr "" -#: ../../reference/datamodel.rst:3132 +#: ../../reference/datamodel.rst:3136 msgid "" "Enter the runtime context related to this object. The :keyword:`with` " "statement will bind this method's return value to the target(s) specified in " "the :keyword:`!as` clause of the statement, if any." msgstr "" -#: ../../reference/datamodel.rst:3139 +#: ../../reference/datamodel.rst:3143 msgid "" "Exit the runtime context related to this object. The parameters describe the " "exception that caused the context to be exited. If the context was exited " "without an exception, all three arguments will be :const:`None`." msgstr "" -#: ../../reference/datamodel.rst:3143 +#: ../../reference/datamodel.rst:3147 msgid "" "If an exception is supplied, and the method wishes to suppress the exception " "(i.e., prevent it from being propagated), it should return a true value. " @@ -3479,27 +3483,27 @@ msgid "" "method." msgstr "" -#: ../../reference/datamodel.rst:3147 +#: ../../reference/datamodel.rst:3151 msgid "" "Note that :meth:`~object.__exit__` methods should not reraise the passed-in " "exception; this is the caller's responsibility." msgstr "" -#: ../../reference/datamodel.rst:3153 +#: ../../reference/datamodel.rst:3157 msgid ":pep:`343` - The \"with\" statement" msgstr "" -#: ../../reference/datamodel.rst:3154 +#: ../../reference/datamodel.rst:3158 msgid "" "The specification, background, and examples for the Python :keyword:`with` " "statement." msgstr "" -#: ../../reference/datamodel.rst:3161 +#: ../../reference/datamodel.rst:3165 msgid "Customizing positional arguments in class pattern matching" msgstr "" -#: ../../reference/datamodel.rst:3163 +#: ../../reference/datamodel.rst:3167 msgid "" "When using a class name in a pattern, positional arguments in the pattern " "are not allowed by default, i.e. ``case MyClass(x, y)`` is typically invalid " @@ -3507,7 +3511,7 @@ msgid "" "pattern, the class needs to define a *__match_args__* attribute." msgstr "" -#: ../../reference/datamodel.rst:3170 +#: ../../reference/datamodel.rst:3174 msgid "" "This class variable can be assigned a tuple of strings. When this class is " "used in a class pattern with positional arguments, each positional argument " @@ -3516,7 +3520,7 @@ msgid "" "to setting it to ``()``." msgstr "" -#: ../../reference/datamodel.rst:3176 +#: ../../reference/datamodel.rst:3180 msgid "" "For example, if ``MyClass.__match_args__`` is ``(\"left\", \"center\", " "\"right\")`` that means that ``case MyClass(x, y)`` is equivalent to ``case " @@ -3526,19 +3530,19 @@ msgid "" "exc:`TypeError`." msgstr "" -#: ../../reference/datamodel.rst:3186 +#: ../../reference/datamodel.rst:3190 msgid ":pep:`634` - Structural Pattern Matching" msgstr "" -#: ../../reference/datamodel.rst:3187 +#: ../../reference/datamodel.rst:3191 msgid "The specification for the Python ``match`` statement." msgstr "" -#: ../../reference/datamodel.rst:3193 +#: ../../reference/datamodel.rst:3197 msgid "Emulating buffer types" msgstr "" -#: ../../reference/datamodel.rst:3195 +#: ../../reference/datamodel.rst:3199 msgid "" "The :ref:`buffer protocol ` provides a way for Python objects " "to expose efficient access to a low-level memory array. This protocol is " @@ -3546,13 +3550,13 @@ msgid "" "and third-party libraries may define additional buffer types." msgstr "" -#: ../../reference/datamodel.rst:3200 +#: ../../reference/datamodel.rst:3204 msgid "" "While buffer types are usually implemented in C, it is also possible to " "implement the protocol in Python." msgstr "" -#: ../../reference/datamodel.rst:3205 +#: ../../reference/datamodel.rst:3209 msgid "" "Called when a buffer is requested from *self* (for example, by the :class:" "`memoryview` constructor). The *flags* argument is an integer representing " @@ -3562,7 +3566,7 @@ msgid "" "`memoryview` object." msgstr "" -#: ../../reference/datamodel.rst:3214 +#: ../../reference/datamodel.rst:3218 msgid "" "Called when a buffer is no longer needed. The *buffer* argument is a :class:" "`memoryview` object that was previously returned by :meth:`~object." @@ -3571,28 +3575,28 @@ msgid "" "to perform any cleanup are not required to implement this method." msgstr "" -#: ../../reference/datamodel.rst:3225 +#: ../../reference/datamodel.rst:3229 msgid ":pep:`688` - Making the buffer protocol accessible in Python" msgstr "" -#: ../../reference/datamodel.rst:3226 +#: ../../reference/datamodel.rst:3230 msgid "" "Introduces the Python ``__buffer__`` and ``__release_buffer__`` methods." msgstr "" -#: ../../reference/datamodel.rst:3228 +#: ../../reference/datamodel.rst:3232 msgid ":class:`collections.abc.Buffer`" msgstr ":class:`collections.abc.Buffer`" -#: ../../reference/datamodel.rst:3229 +#: ../../reference/datamodel.rst:3233 msgid "ABC for buffer types." msgstr "" -#: ../../reference/datamodel.rst:3234 +#: ../../reference/datamodel.rst:3238 msgid "Special method lookup" msgstr "" -#: ../../reference/datamodel.rst:3236 +#: ../../reference/datamodel.rst:3240 msgid "" "For custom classes, implicit invocations of special methods are only " "guaranteed to work correctly if defined on an object's type, not in the " @@ -3600,7 +3604,7 @@ msgid "" "following code raises an exception::" msgstr "" -#: ../../reference/datamodel.rst:3251 +#: ../../reference/datamodel.rst:3255 msgid "" "The rationale behind this behaviour lies with a number of special methods " "such as :meth:`~object.__hash__` and :meth:`~object.__repr__` that are " @@ -3609,21 +3613,21 @@ msgid "" "invoked on the type object itself::" msgstr "" -#: ../../reference/datamodel.rst:3265 +#: ../../reference/datamodel.rst:3269 msgid "" "Incorrectly attempting to invoke an unbound method of a class in this way is " "sometimes referred to as 'metaclass confusion', and is avoided by bypassing " "the instance when looking up special methods::" msgstr "" -#: ../../reference/datamodel.rst:3274 +#: ../../reference/datamodel.rst:3278 msgid "" "In addition to bypassing any instance attributes in the interest of " "correctness, implicit special method lookup generally also bypasses the :" "meth:`~object.__getattribute__` method even of the object's metaclass::" msgstr "" -#: ../../reference/datamodel.rst:3300 +#: ../../reference/datamodel.rst:3304 msgid "" "Bypassing the :meth:`~object.__getattribute__` machinery in this fashion " "provides significant scope for speed optimisations within the interpreter, " @@ -3632,36 +3636,36 @@ msgid "" "consistently invoked by the interpreter)." msgstr "" -#: ../../reference/datamodel.rst:3311 +#: ../../reference/datamodel.rst:3315 msgid "Coroutines" msgstr "協程" -#: ../../reference/datamodel.rst:3315 +#: ../../reference/datamodel.rst:3319 msgid "Awaitable Objects" msgstr "" -#: ../../reference/datamodel.rst:3317 +#: ../../reference/datamodel.rst:3321 msgid "" "An :term:`awaitable` object generally implements an :meth:`~object." "__await__` method. :term:`Coroutine objects ` returned from :" "keyword:`async def` functions are awaitable." msgstr "" -#: ../../reference/datamodel.rst:3323 +#: ../../reference/datamodel.rst:3327 msgid "" "The :term:`generator iterator` objects returned from generators decorated " "with :func:`types.coroutine` are also awaitable, but they do not implement :" "meth:`~object.__await__`." msgstr "" -#: ../../reference/datamodel.rst:3329 +#: ../../reference/datamodel.rst:3333 msgid "" "Must return an :term:`iterator`. Should be used to implement :term:" "`awaitable` objects. For instance, :class:`asyncio.Future` implements this " "method to be compatible with the :keyword:`await` expression." msgstr "" -#: ../../reference/datamodel.rst:3335 +#: ../../reference/datamodel.rst:3339 msgid "" "The language doesn't place any restriction on the type or value of the " "objects yielded by the iterator returned by ``__await__``, as this is " @@ -3669,15 +3673,15 @@ msgid "" "g. :mod:`asyncio`) that will be managing the :term:`awaitable` object." msgstr "" -#: ../../reference/datamodel.rst:3343 +#: ../../reference/datamodel.rst:3347 msgid ":pep:`492` for additional information about awaitable objects." msgstr "" -#: ../../reference/datamodel.rst:3349 +#: ../../reference/datamodel.rst:3353 msgid "Coroutine Objects" msgstr "" -#: ../../reference/datamodel.rst:3351 +#: ../../reference/datamodel.rst:3355 msgid "" ":term:`Coroutine objects ` are :term:`awaitable` objects. A " "coroutine's execution can be controlled by calling :meth:`~object.__await__` " @@ -3688,18 +3692,18 @@ msgid "" "should not directly raise unhandled :exc:`StopIteration` exceptions." msgstr "" -#: ../../reference/datamodel.rst:3359 +#: ../../reference/datamodel.rst:3363 msgid "" "Coroutines also have the methods listed below, which are analogous to those " "of generators (see :ref:`generator-methods`). However, unlike generators, " "coroutines do not directly support iteration." msgstr "" -#: ../../reference/datamodel.rst:3363 +#: ../../reference/datamodel.rst:3367 msgid "It is a :exc:`RuntimeError` to await on a coroutine more than once." msgstr "" -#: ../../reference/datamodel.rst:3369 +#: ../../reference/datamodel.rst:3373 msgid "" "Starts or resumes execution of the coroutine. If *value* is ``None``, this " "is equivalent to advancing the iterator returned by :meth:`~object." @@ -3710,7 +3714,7 @@ msgid "" "value, described above." msgstr "" -#: ../../reference/datamodel.rst:3380 +#: ../../reference/datamodel.rst:3384 msgid "" "Raises the specified exception in the coroutine. This method delegates to " "the :meth:`~generator.throw` method of the iterator that caused the " @@ -3721,13 +3725,13 @@ msgid "" "not caught in the coroutine, it propagates back to the caller." msgstr "" -#: ../../reference/datamodel.rst:3391 +#: ../../reference/datamodel.rst:3395 msgid "" "The second signature \\(type\\[, value\\[, traceback\\]\\]\\) is deprecated " "and may be removed in a future version of Python." msgstr "" -#: ../../reference/datamodel.rst:3396 +#: ../../reference/datamodel.rst:3400 msgid "" "Causes the coroutine to clean itself up and exit. If the coroutine is " "suspended, this method first delegates to the :meth:`~generator.close` " @@ -3737,99 +3741,99 @@ msgid "" "is marked as having finished executing, even if it was never started." msgstr "" -#: ../../reference/datamodel.rst:3404 +#: ../../reference/datamodel.rst:3408 msgid "" "Coroutine objects are automatically closed using the above process when they " "are about to be destroyed." msgstr "" -#: ../../reference/datamodel.rst:3410 +#: ../../reference/datamodel.rst:3414 msgid "Asynchronous Iterators" msgstr "" -#: ../../reference/datamodel.rst:3412 +#: ../../reference/datamodel.rst:3416 msgid "" "An *asynchronous iterator* can call asynchronous code in its ``__anext__`` " "method." msgstr "" -#: ../../reference/datamodel.rst:3415 +#: ../../reference/datamodel.rst:3419 msgid "" "Asynchronous iterators can be used in an :keyword:`async for` statement." msgstr "" -#: ../../reference/datamodel.rst:3419 +#: ../../reference/datamodel.rst:3423 msgid "Must return an *asynchronous iterator* object." msgstr "" -#: ../../reference/datamodel.rst:3423 +#: ../../reference/datamodel.rst:3427 msgid "" "Must return an *awaitable* resulting in a next value of the iterator. " "Should raise a :exc:`StopAsyncIteration` error when the iteration is over." msgstr "" -#: ../../reference/datamodel.rst:3426 +#: ../../reference/datamodel.rst:3430 msgid "An example of an asynchronous iterable object::" msgstr "" -#: ../../reference/datamodel.rst:3443 +#: ../../reference/datamodel.rst:3447 msgid "" "Prior to Python 3.7, :meth:`~object.__aiter__` could return an *awaitable* " "that would resolve to an :term:`asynchronous iterator `." msgstr "" -#: ../../reference/datamodel.rst:3448 +#: ../../reference/datamodel.rst:3452 msgid "" "Starting with Python 3.7, :meth:`~object.__aiter__` must return an " "asynchronous iterator object. Returning anything else will result in a :exc:" "`TypeError` error." msgstr "" -#: ../../reference/datamodel.rst:3456 +#: ../../reference/datamodel.rst:3460 msgid "Asynchronous Context Managers" msgstr "" -#: ../../reference/datamodel.rst:3458 +#: ../../reference/datamodel.rst:3462 msgid "" "An *asynchronous context manager* is a *context manager* that is able to " "suspend execution in its ``__aenter__`` and ``__aexit__`` methods." msgstr "" -#: ../../reference/datamodel.rst:3461 +#: ../../reference/datamodel.rst:3465 msgid "" "Asynchronous context managers can be used in an :keyword:`async with` " "statement." msgstr "" -#: ../../reference/datamodel.rst:3465 +#: ../../reference/datamodel.rst:3469 msgid "" "Semantically similar to :meth:`~object.__enter__`, the only difference being " "that it must return an *awaitable*." msgstr "" -#: ../../reference/datamodel.rst:3470 +#: ../../reference/datamodel.rst:3474 msgid "" "Semantically similar to :meth:`~object.__exit__`, the only difference being " "that it must return an *awaitable*." msgstr "" -#: ../../reference/datamodel.rst:3473 +#: ../../reference/datamodel.rst:3477 msgid "An example of an asynchronous context manager class::" msgstr "" -#: ../../reference/datamodel.rst:3486 +#: ../../reference/datamodel.rst:3490 msgid "Footnotes" msgstr "註解" -#: ../../reference/datamodel.rst:3487 +#: ../../reference/datamodel.rst:3491 msgid "" "It *is* possible in some cases to change an object's type, under certain " "controlled conditions. It generally isn't a good idea though, since it can " "lead to some very strange behaviour if it is handled incorrectly." msgstr "" -#: ../../reference/datamodel.rst:3491 +#: ../../reference/datamodel.rst:3495 msgid "" "The :meth:`~object.__hash__`, :meth:`~object.__iter__`, :meth:`~object." "__reversed__`, and :meth:`~object.__contains__` methods have special " @@ -3837,7 +3841,7 @@ msgid "" "by relying on the behavior that ``None`` is not callable." msgstr "" -#: ../../reference/datamodel.rst:3497 +#: ../../reference/datamodel.rst:3501 msgid "" "\"Does not support\" here means that the class has no such method, or the " "method returns :data:`NotImplemented`. Do not set the method to ``None`` if " @@ -3845,47 +3849,47 @@ msgid "" "instead have the opposite effect of explicitly *blocking* such fallback." msgstr "" -#: ../../reference/datamodel.rst:3503 +#: ../../reference/datamodel.rst:3507 msgid "" "For operands of the same type, it is assumed that if the non-reflected " "method -- such as :meth:`~object.__add__` -- fails then the overall " "operation is not supported, which is why the reflected method is not called." msgstr "" -#: ../../reference/datamodel.rst:14 ../../reference/datamodel.rst:148 -#: ../../reference/datamodel.rst:159 ../../reference/datamodel.rst:180 -#: ../../reference/datamodel.rst:192 ../../reference/datamodel.rst:225 -#: ../../reference/datamodel.rst:246 ../../reference/datamodel.rst:261 -#: ../../reference/datamodel.rst:279 ../../reference/datamodel.rst:292 -#: ../../reference/datamodel.rst:324 ../../reference/datamodel.rst:359 -#: ../../reference/datamodel.rst:384 ../../reference/datamodel.rst:405 -#: ../../reference/datamodel.rst:423 ../../reference/datamodel.rst:443 -#: ../../reference/datamodel.rst:451 ../../reference/datamodel.rst:462 -#: ../../reference/datamodel.rst:479 ../../reference/datamodel.rst:515 -#: ../../reference/datamodel.rst:530 ../../reference/datamodel.rst:657 -#: ../../reference/datamodel.rst:795 ../../reference/datamodel.rst:819 -#: ../../reference/datamodel.rst:852 ../../reference/datamodel.rst:931 -#: ../../reference/datamodel.rst:1000 ../../reference/datamodel.rst:1027 -#: ../../reference/datamodel.rst:1089 ../../reference/datamodel.rst:1193 -#: ../../reference/datamodel.rst:1300 ../../reference/datamodel.rst:1400 -#: ../../reference/datamodel.rst:1814 ../../reference/datamodel.rst:2829 +#: ../../reference/datamodel.rst:14 ../../reference/datamodel.rst:152 +#: ../../reference/datamodel.rst:163 ../../reference/datamodel.rst:184 +#: ../../reference/datamodel.rst:196 ../../reference/datamodel.rst:229 +#: ../../reference/datamodel.rst:250 ../../reference/datamodel.rst:265 +#: ../../reference/datamodel.rst:283 ../../reference/datamodel.rst:296 +#: ../../reference/datamodel.rst:328 ../../reference/datamodel.rst:363 +#: ../../reference/datamodel.rst:388 ../../reference/datamodel.rst:409 +#: ../../reference/datamodel.rst:427 ../../reference/datamodel.rst:447 +#: ../../reference/datamodel.rst:455 ../../reference/datamodel.rst:466 +#: ../../reference/datamodel.rst:483 ../../reference/datamodel.rst:519 +#: ../../reference/datamodel.rst:534 ../../reference/datamodel.rst:661 +#: ../../reference/datamodel.rst:799 ../../reference/datamodel.rst:823 +#: ../../reference/datamodel.rst:856 ../../reference/datamodel.rst:935 +#: ../../reference/datamodel.rst:1004 ../../reference/datamodel.rst:1031 +#: ../../reference/datamodel.rst:1093 ../../reference/datamodel.rst:1197 +#: ../../reference/datamodel.rst:1304 ../../reference/datamodel.rst:1404 +#: ../../reference/datamodel.rst:1818 ../../reference/datamodel.rst:2833 msgid "object" msgstr "object（物件）" -#: ../../reference/datamodel.rst:14 ../../reference/datamodel.rst:122 +#: ../../reference/datamodel.rst:14 ../../reference/datamodel.rst:126 msgid "data" msgstr "data（資料）" -#: ../../reference/datamodel.rst:23 ../../reference/datamodel.rst:292 -#: ../../reference/datamodel.rst:339 ../../reference/datamodel.rst:423 -#: ../../reference/datamodel.rst:462 ../../reference/datamodel.rst:795 -#: ../../reference/datamodel.rst:1046 ../../reference/datamodel.rst:1483 -#: ../../reference/datamodel.rst:1725 ../../reference/datamodel.rst:1730 -#: ../../reference/datamodel.rst:1814 ../../reference/datamodel.rst:2370 -#: ../../reference/datamodel.rst:2799 ../../reference/datamodel.rst:2957 -#: ../../reference/datamodel.rst:2992 ../../reference/datamodel.rst:3006 -#: ../../reference/datamodel.rst:3055 ../../reference/datamodel.rst:3065 -#: ../../reference/datamodel.rst:3093 +#: ../../reference/datamodel.rst:23 ../../reference/datamodel.rst:296 +#: ../../reference/datamodel.rst:343 ../../reference/datamodel.rst:427 +#: ../../reference/datamodel.rst:466 ../../reference/datamodel.rst:799 +#: ../../reference/datamodel.rst:1050 ../../reference/datamodel.rst:1487 +#: ../../reference/datamodel.rst:1729 ../../reference/datamodel.rst:1734 +#: ../../reference/datamodel.rst:1818 ../../reference/datamodel.rst:2374 +#: ../../reference/datamodel.rst:2803 ../../reference/datamodel.rst:2961 +#: ../../reference/datamodel.rst:2996 ../../reference/datamodel.rst:3010 +#: ../../reference/datamodel.rst:3059 ../../reference/datamodel.rst:3069 +#: ../../reference/datamodel.rst:3097 msgid "built-in function" msgstr "built-in function（內建函式）" @@ -3893,8 +3897,8 @@ msgstr "built-in function（內建函式）" msgid "id" msgstr "id" -#: ../../reference/datamodel.rst:23 ../../reference/datamodel.rst:122 -#: ../../reference/datamodel.rst:2370 +#: ../../reference/datamodel.rst:23 ../../reference/datamodel.rst:126 +#: ../../reference/datamodel.rst:2374 msgid "type" msgstr "type（型別）" @@ -3930,878 +3934,878 @@ msgstr "reference counting（參照計數）" msgid "unreachable object" msgstr "unreachable object（不可達物件）" -#: ../../reference/datamodel.rst:95 ../../reference/datamodel.rst:931 +#: ../../reference/datamodel.rst:95 ../../reference/datamodel.rst:935 msgid "container" msgstr "container（容器）" -#: ../../reference/datamodel.rst:122 +#: ../../reference/datamodel.rst:126 msgid "hierarchy" msgstr "hierarchy（階層）" -#: ../../reference/datamodel.rst:122 +#: ../../reference/datamodel.rst:126 msgid "extension" msgstr "extension（擴充）" -#: ../../reference/datamodel.rst:122 ../../reference/datamodel.rst:396 -#: ../../reference/datamodel.rst:397 ../../reference/datamodel.rst:498 -#: ../../reference/datamodel.rst:852 ../../reference/datamodel.rst:872 -#: ../../reference/datamodel.rst:1046 +#: ../../reference/datamodel.rst:126 ../../reference/datamodel.rst:400 +#: ../../reference/datamodel.rst:401 ../../reference/datamodel.rst:502 +#: ../../reference/datamodel.rst:856 ../../reference/datamodel.rst:876 +#: ../../reference/datamodel.rst:1050 msgid "module" msgstr "module（模組）" -#: ../../reference/datamodel.rst:122 ../../reference/datamodel.rst:261 -#: ../../reference/datamodel.rst:795 +#: ../../reference/datamodel.rst:126 ../../reference/datamodel.rst:265 +#: ../../reference/datamodel.rst:799 msgid "C" msgstr "C" -#: ../../reference/datamodel.rst:122 ../../reference/datamodel.rst:261 -#: ../../reference/datamodel.rst:795 +#: ../../reference/datamodel.rst:126 ../../reference/datamodel.rst:265 +#: ../../reference/datamodel.rst:799 msgid "language" msgstr "language（語言）" -#: ../../reference/datamodel.rst:135 ../../reference/datamodel.rst:931 -#: ../../reference/datamodel.rst:949 ../../reference/datamodel.rst:1000 -#: ../../reference/datamodel.rst:1020 +#: ../../reference/datamodel.rst:139 ../../reference/datamodel.rst:935 +#: ../../reference/datamodel.rst:953 ../../reference/datamodel.rst:1004 +#: ../../reference/datamodel.rst:1024 msgid "attribute" msgstr "attribute（屬性）" -#: ../../reference/datamodel.rst:135 +#: ../../reference/datamodel.rst:139 msgid "special" msgstr "special" -#: ../../reference/datamodel.rst:135 +#: ../../reference/datamodel.rst:139 msgid "generic" msgstr "generic（泛型）" -#: ../../reference/datamodel.rst:180 +#: ../../reference/datamodel.rst:184 msgid "..." msgstr "..." -#: ../../reference/datamodel.rst:180 +#: ../../reference/datamodel.rst:184 msgid "ellipsis literal" msgstr "ellipsis literal（刪節號）" -#: ../../reference/datamodel.rst:192 ../../reference/datamodel.rst:1027 +#: ../../reference/datamodel.rst:196 ../../reference/datamodel.rst:1031 msgid "numeric" msgstr "numeric（數值）" -#: ../../reference/datamodel.rst:225 ../../reference/datamodel.rst:231 -#: ../../reference/datamodel.rst:339 +#: ../../reference/datamodel.rst:229 ../../reference/datamodel.rst:235 +#: ../../reference/datamodel.rst:343 msgid "integer" msgstr "integer（整數）" -#: ../../reference/datamodel.rst:231 +#: ../../reference/datamodel.rst:235 msgid "representation" msgstr "representation（表示）" -#: ../../reference/datamodel.rst:246 +#: ../../reference/datamodel.rst:250 msgid "Boolean" msgstr "Boolean（布林）" -#: ../../reference/datamodel.rst:246 +#: ../../reference/datamodel.rst:250 msgid "False" msgstr "False" -#: ../../reference/datamodel.rst:246 +#: ../../reference/datamodel.rst:250 msgid "True" msgstr "True" -#: ../../reference/datamodel.rst:261 +#: ../../reference/datamodel.rst:265 msgid "floating-point" msgstr "floating-point（浮點）" -#: ../../reference/datamodel.rst:261 ../../reference/datamodel.rst:279 +#: ../../reference/datamodel.rst:265 ../../reference/datamodel.rst:283 msgid "number" msgstr "number（數字）" -#: ../../reference/datamodel.rst:261 +#: ../../reference/datamodel.rst:265 msgid "Java" msgstr "Java" -#: ../../reference/datamodel.rst:279 ../../reference/datamodel.rst:3065 +#: ../../reference/datamodel.rst:283 ../../reference/datamodel.rst:3069 msgid "complex" msgstr "complex（複數）" -#: ../../reference/datamodel.rst:292 ../../reference/datamodel.rst:423 -#: ../../reference/datamodel.rst:462 ../../reference/datamodel.rst:2799 +#: ../../reference/datamodel.rst:296 ../../reference/datamodel.rst:427 +#: ../../reference/datamodel.rst:466 ../../reference/datamodel.rst:2803 msgid "len" msgstr "len" -#: ../../reference/datamodel.rst:292 ../../reference/datamodel.rst:1027 +#: ../../reference/datamodel.rst:296 ../../reference/datamodel.rst:1031 msgid "sequence" msgstr "sequence（序列）" -#: ../../reference/datamodel.rst:292 +#: ../../reference/datamodel.rst:296 msgid "index operation" msgstr "index operation（索引操作）" -#: ../../reference/datamodel.rst:292 +#: ../../reference/datamodel.rst:296 msgid "item selection" msgstr "item selection（項目選取）" -#: ../../reference/datamodel.rst:292 ../../reference/datamodel.rst:384 -#: ../../reference/datamodel.rst:462 +#: ../../reference/datamodel.rst:296 ../../reference/datamodel.rst:388 +#: ../../reference/datamodel.rst:466 msgid "subscription" msgstr "subscription（下標）" -#: ../../reference/datamodel.rst:307 ../../reference/datamodel.rst:384 +#: ../../reference/datamodel.rst:311 ../../reference/datamodel.rst:388 msgid "slicing" msgstr "slice（切片）" -#: ../../reference/datamodel.rst:324 +#: ../../reference/datamodel.rst:328 msgid "immutable sequence" msgstr "immutable sequence（不可變序列）" -#: ../../reference/datamodel.rst:324 +#: ../../reference/datamodel.rst:328 msgid "immutable" msgstr "immutable（不可變）" -#: ../../reference/datamodel.rst:335 ../../reference/datamodel.rst:1700 -#: ../../reference/datamodel.rst:1730 +#: ../../reference/datamodel.rst:339 ../../reference/datamodel.rst:1704 +#: ../../reference/datamodel.rst:1734 msgid "string" msgstr "string（字串）" -#: ../../reference/datamodel.rst:335 +#: ../../reference/datamodel.rst:339 msgid "immutable sequences" msgstr "immutable sequences（不可變序列）" -#: ../../reference/datamodel.rst:339 +#: ../../reference/datamodel.rst:343 msgid "chr" msgstr "chr" -#: ../../reference/datamodel.rst:339 +#: ../../reference/datamodel.rst:343 msgid "ord" msgstr "ord" -#: ../../reference/datamodel.rst:339 +#: ../../reference/datamodel.rst:343 msgid "character" msgstr "character（字元）" -#: ../../reference/datamodel.rst:339 +#: ../../reference/datamodel.rst:343 msgid "Unicode" msgstr "Unicode" -#: ../../reference/datamodel.rst:359 +#: ../../reference/datamodel.rst:363 msgid "tuple" msgstr "tuple（元組）" -#: ../../reference/datamodel.rst:359 +#: ../../reference/datamodel.rst:363 msgid "singleton" msgstr "singleton（單例）" -#: ../../reference/datamodel.rst:359 +#: ../../reference/datamodel.rst:363 msgid "empty" msgstr "empty（空的）" -#: ../../reference/datamodel.rst:372 ../../reference/datamodel.rst:1725 +#: ../../reference/datamodel.rst:376 ../../reference/datamodel.rst:1729 msgid "bytes" msgstr "bytes（位元組）" -#: ../../reference/datamodel.rst:372 +#: ../../reference/datamodel.rst:376 msgid "byte" msgstr "byte（位元組）" -#: ../../reference/datamodel.rst:384 +#: ../../reference/datamodel.rst:388 msgid "mutable sequence" msgstr "mutable sequence（可變序列）" -#: ../../reference/datamodel.rst:384 +#: ../../reference/datamodel.rst:388 msgid "mutable" msgstr "mutable（可變的）" -#: ../../reference/datamodel.rst:384 ../../reference/datamodel.rst:949 -#: ../../reference/datamodel.rst:1020 +#: ../../reference/datamodel.rst:388 ../../reference/datamodel.rst:953 +#: ../../reference/datamodel.rst:1024 msgid "assignment" msgstr "assignment（賦值）" -#: ../../reference/datamodel.rst:384 ../../reference/datamodel.rst:852 -#: ../../reference/datamodel.rst:1437 ../../reference/datamodel.rst:1619 -#: ../../reference/datamodel.rst:3120 +#: ../../reference/datamodel.rst:388 ../../reference/datamodel.rst:856 +#: ../../reference/datamodel.rst:1441 ../../reference/datamodel.rst:1623 +#: ../../reference/datamodel.rst:3124 msgid "statement" msgstr "statement（陳述式）" -#: ../../reference/datamodel.rst:396 +#: ../../reference/datamodel.rst:400 msgid "array" msgstr "array（陣列）" -#: ../../reference/datamodel.rst:397 +#: ../../reference/datamodel.rst:401 msgid "collections" msgstr "collections" -#: ../../reference/datamodel.rst:405 +#: ../../reference/datamodel.rst:409 msgid "list" msgstr "list（串列）" -#: ../../reference/datamodel.rst:412 +#: ../../reference/datamodel.rst:416 msgid "bytearray" msgstr "bytearray（位元組陣列）" -#: ../../reference/datamodel.rst:423 +#: ../../reference/datamodel.rst:427 msgid "set type" msgstr "set type（集合型別）" -#: ../../reference/datamodel.rst:443 +#: ../../reference/datamodel.rst:447 msgid "set" msgstr "set（集合）" -#: ../../reference/datamodel.rst:451 +#: ../../reference/datamodel.rst:455 msgid "frozenset" msgstr "frozenset（凍結集合）" -#: ../../reference/datamodel.rst:462 ../../reference/datamodel.rst:1027 +#: ../../reference/datamodel.rst:466 ../../reference/datamodel.rst:1031 msgid "mapping" msgstr "mapping（對映）" -#: ../../reference/datamodel.rst:479 ../../reference/datamodel.rst:931 -#: ../../reference/datamodel.rst:1814 +#: ../../reference/datamodel.rst:483 ../../reference/datamodel.rst:935 +#: ../../reference/datamodel.rst:1818 msgid "dictionary" msgstr "dictionary（字典）" -#: ../../reference/datamodel.rst:498 +#: ../../reference/datamodel.rst:502 msgid "dbm.ndbm" msgstr "dbm.ndbm" -#: ../../reference/datamodel.rst:498 +#: ../../reference/datamodel.rst:502 msgid "dbm.gnu" msgstr "dbm.gnu" -#: ../../reference/datamodel.rst:515 +#: ../../reference/datamodel.rst:519 msgid "callable" msgstr "callable（可呼叫物件）" -#: ../../reference/datamodel.rst:515 ../../reference/datamodel.rst:530 -#: ../../reference/datamodel.rst:739 ../../reference/datamodel.rst:757 -#: ../../reference/datamodel.rst:770 ../../reference/datamodel.rst:795 +#: ../../reference/datamodel.rst:519 ../../reference/datamodel.rst:534 +#: ../../reference/datamodel.rst:743 ../../reference/datamodel.rst:761 +#: ../../reference/datamodel.rst:774 ../../reference/datamodel.rst:799 msgid "function" msgstr "function （函式）" -#: ../../reference/datamodel.rst:515 ../../reference/datamodel.rst:931 -#: ../../reference/datamodel.rst:954 ../../reference/datamodel.rst:2751 +#: ../../reference/datamodel.rst:519 ../../reference/datamodel.rst:935 +#: ../../reference/datamodel.rst:958 ../../reference/datamodel.rst:2755 msgid "call" msgstr "call（呼叫）" -#: ../../reference/datamodel.rst:515 +#: ../../reference/datamodel.rst:519 msgid "invocation" msgstr "invocation（調用）" -#: ../../reference/datamodel.rst:515 +#: ../../reference/datamodel.rst:519 msgid "argument" msgstr "argument（引數）" -#: ../../reference/datamodel.rst:530 ../../reference/datamodel.rst:657 +#: ../../reference/datamodel.rst:534 ../../reference/datamodel.rst:661 msgid "user-defined" msgstr "user-defined（使用者定義）" -#: ../../reference/datamodel.rst:530 +#: ../../reference/datamodel.rst:534 msgid "user-defined function" msgstr "user-defined function（使用者定義函式）" -#: ../../reference/datamodel.rst:543 +#: ../../reference/datamodel.rst:547 msgid "__closure__ (function attribute)" msgstr "__closure__ （函式屬性）" -#: ../../reference/datamodel.rst:543 +#: ../../reference/datamodel.rst:547 msgid "__globals__ (function attribute)" msgstr "__globals__ （函式屬性）" -#: ../../reference/datamodel.rst:543 +#: ../../reference/datamodel.rst:547 msgid "global" msgstr "global（全域）" -#: ../../reference/datamodel.rst:543 ../../reference/datamodel.rst:872 +#: ../../reference/datamodel.rst:547 ../../reference/datamodel.rst:876 msgid "namespace" msgstr "namespace（命名空間）" -#: ../../reference/datamodel.rst:569 +#: ../../reference/datamodel.rst:573 msgid "__doc__ (function attribute)" msgstr "__doc__ （函式屬性）" -#: ../../reference/datamodel.rst:569 +#: ../../reference/datamodel.rst:573 msgid "__name__ (function attribute)" msgstr "__name__ （函式屬性）" -#: ../../reference/datamodel.rst:569 +#: ../../reference/datamodel.rst:573 msgid "__module__ (function attribute)" msgstr "__module__ （函式屬性）" -#: ../../reference/datamodel.rst:569 +#: ../../reference/datamodel.rst:573 msgid "__dict__ (function attribute)" msgstr "__dict__ （函式屬性）" -#: ../../reference/datamodel.rst:569 +#: ../../reference/datamodel.rst:573 msgid "__defaults__ (function attribute)" msgstr "__defaults__ （函式屬性）" -#: ../../reference/datamodel.rst:569 +#: ../../reference/datamodel.rst:573 msgid "__code__ (function attribute)" msgstr "__code__ （函式屬性）" -#: ../../reference/datamodel.rst:569 +#: ../../reference/datamodel.rst:573 msgid "__annotations__ (function attribute)" msgstr "__annotations__ （函式屬性）" -#: ../../reference/datamodel.rst:569 +#: ../../reference/datamodel.rst:573 msgid "__kwdefaults__ (function attribute)" msgstr "__kwdefaults__ （函式屬性）" -#: ../../reference/datamodel.rst:569 +#: ../../reference/datamodel.rst:573 msgid "__type_params__ (function attribute)" msgstr "__type_params__ （函式屬性）" -#: ../../reference/datamodel.rst:657 ../../reference/datamodel.rst:819 +#: ../../reference/datamodel.rst:661 ../../reference/datamodel.rst:823 msgid "method" msgstr "method（方法）" -#: ../../reference/datamodel.rst:657 +#: ../../reference/datamodel.rst:661 msgid "user-defined method" msgstr "user-defined method（使用者定義方法）" -#: ../../reference/datamodel.rst:665 +#: ../../reference/datamodel.rst:669 msgid "__func__ (method attribute)" msgstr "__func__ （方法屬性）" -#: ../../reference/datamodel.rst:665 +#: ../../reference/datamodel.rst:669 msgid "__self__ (method attribute)" msgstr "__self__ （方法屬性）" -#: ../../reference/datamodel.rst:665 +#: ../../reference/datamodel.rst:669 msgid "__doc__ (method attribute)" msgstr "__doc__ （方法屬性）" -#: ../../reference/datamodel.rst:665 +#: ../../reference/datamodel.rst:669 msgid "__name__ (method attribute)" msgstr "__name__ （方法屬性）" -#: ../../reference/datamodel.rst:665 +#: ../../reference/datamodel.rst:669 msgid "__module__ (method attribute)" msgstr "__module__ （方法屬性）" -#: ../../reference/datamodel.rst:739 ../../reference/datamodel.rst:1193 +#: ../../reference/datamodel.rst:743 ../../reference/datamodel.rst:1197 msgid "generator" msgstr "generator（產生器）" -#: ../../reference/datamodel.rst:739 +#: ../../reference/datamodel.rst:743 msgid "iterator" msgstr "itorator（疊代器）" -#: ../../reference/datamodel.rst:757 ../../reference/datamodel.rst:3307 +#: ../../reference/datamodel.rst:761 ../../reference/datamodel.rst:3311 msgid "coroutine" msgstr "coroutine（協程）" -#: ../../reference/datamodel.rst:770 +#: ../../reference/datamodel.rst:774 msgid "asynchronous generator" msgstr "asynchronous generator（非同步產生器）" -#: ../../reference/datamodel.rst:770 +#: ../../reference/datamodel.rst:774 msgid "asynchronous iterator" msgstr "asynchronous iterator（非同步疊代器）" -#: ../../reference/datamodel.rst:819 +#: ../../reference/datamodel.rst:823 msgid "built-in method" msgstr "built-in method（內建方法）" -#: ../../reference/datamodel.rst:819 +#: ../../reference/datamodel.rst:823 msgid "built-in" msgstr "built-in（內建）" -#: ../../reference/datamodel.rst:852 +#: ../../reference/datamodel.rst:856 msgid "import" msgstr "import（引入）" -#: ../../reference/datamodel.rst:872 +#: ../../reference/datamodel.rst:876 msgid "__name__ (module attribute)" msgstr "__name__ （模組屬性）" -#: ../../reference/datamodel.rst:872 +#: ../../reference/datamodel.rst:876 msgid "__doc__ (module attribute)" msgstr "__doc__ （模組屬性）" -#: ../../reference/datamodel.rst:872 +#: ../../reference/datamodel.rst:876 msgid "__file__ (module attribute)" msgstr "__file__ （模組屬性）" -#: ../../reference/datamodel.rst:872 +#: ../../reference/datamodel.rst:876 msgid "__annotations__ (module attribute)" msgstr "__annotations__ （模組屬性）" -#: ../../reference/datamodel.rst:903 +#: ../../reference/datamodel.rst:907 msgid "__dict__ (module attribute)" msgstr "__dict__ （模組屬性）" -#: ../../reference/datamodel.rst:931 ../../reference/datamodel.rst:949 -#: ../../reference/datamodel.rst:1000 ../../reference/datamodel.rst:1602 -#: ../../reference/datamodel.rst:2481 +#: ../../reference/datamodel.rst:935 ../../reference/datamodel.rst:953 +#: ../../reference/datamodel.rst:1004 ../../reference/datamodel.rst:1606 +#: ../../reference/datamodel.rst:2485 msgid "class" msgstr "class（類別）" -#: ../../reference/datamodel.rst:931 ../../reference/datamodel.rst:1000 -#: ../../reference/datamodel.rst:1020 +#: ../../reference/datamodel.rst:935 ../../reference/datamodel.rst:1004 +#: ../../reference/datamodel.rst:1024 msgid "class instance" msgstr "class instance（類別實例）" -#: ../../reference/datamodel.rst:931 ../../reference/datamodel.rst:1000 -#: ../../reference/datamodel.rst:2751 +#: ../../reference/datamodel.rst:935 ../../reference/datamodel.rst:1004 +#: ../../reference/datamodel.rst:2755 msgid "instance" msgstr "instance（實例）" -#: ../../reference/datamodel.rst:931 ../../reference/datamodel.rst:954 +#: ../../reference/datamodel.rst:935 ../../reference/datamodel.rst:958 msgid "class object" msgstr "class object（類別物件）" -#: ../../reference/datamodel.rst:958 +#: ../../reference/datamodel.rst:962 msgid "__name__ (class attribute)" msgstr "__name__ （類別屬性）" -#: ../../reference/datamodel.rst:958 +#: ../../reference/datamodel.rst:962 msgid "__module__ (class attribute)" msgstr "__module__ （類別屬性）" -#: ../../reference/datamodel.rst:958 +#: ../../reference/datamodel.rst:962 msgid "__dict__ (class attribute)" msgstr "__dict__ （類別屬性）" -#: ../../reference/datamodel.rst:958 +#: ../../reference/datamodel.rst:962 msgid "__bases__ (class attribute)" msgstr "__bases__ （類別屬性）" -#: ../../reference/datamodel.rst:958 +#: ../../reference/datamodel.rst:962 msgid "__doc__ (class attribute)" msgstr "__doc__ （類別屬性）" -#: ../../reference/datamodel.rst:958 +#: ../../reference/datamodel.rst:962 msgid "__annotations__ (class attribute)" msgstr "__annotations__ （類別屬性）" -#: ../../reference/datamodel.rst:958 +#: ../../reference/datamodel.rst:962 msgid "__type_params__ (class attribute)" msgstr "__type_params__ （類別屬性）" -#: ../../reference/datamodel.rst:1035 +#: ../../reference/datamodel.rst:1039 msgid "__dict__ (instance attribute)" msgstr "__dict__ （實例屬性）" -#: ../../reference/datamodel.rst:1035 +#: ../../reference/datamodel.rst:1039 msgid "__class__ (instance attribute)" msgstr "__class__ （實例屬性）" -#: ../../reference/datamodel.rst:1046 +#: ../../reference/datamodel.rst:1050 msgid "open" msgstr "open" -#: ../../reference/datamodel.rst:1046 +#: ../../reference/datamodel.rst:1050 msgid "io" msgstr "io" -#: ../../reference/datamodel.rst:1046 +#: ../../reference/datamodel.rst:1050 msgid "popen() (in module os)" msgstr "popen() （於 os 模組中）" -#: ../../reference/datamodel.rst:1046 +#: ../../reference/datamodel.rst:1050 msgid "makefile() (socket method)" msgstr "makefile() （socket 方法）" -#: ../../reference/datamodel.rst:1046 +#: ../../reference/datamodel.rst:1050 msgid "sys.stdin" msgstr "sys.stdin" -#: ../../reference/datamodel.rst:1046 +#: ../../reference/datamodel.rst:1050 msgid "sys.stdout" msgstr "sys.stdout" -#: ../../reference/datamodel.rst:1046 +#: ../../reference/datamodel.rst:1050 msgid "sys.stderr" msgstr "sys.stderr" -#: ../../reference/datamodel.rst:1046 +#: ../../reference/datamodel.rst:1050 msgid "stdio" msgstr "stdio" -#: ../../reference/datamodel.rst:1046 +#: ../../reference/datamodel.rst:1050 msgid "stdin (in module sys)" msgstr "stdin （sys 模組中）" -#: ../../reference/datamodel.rst:1046 +#: ../../reference/datamodel.rst:1050 msgid "stdout (in module sys)" msgstr "stdout （sys 模組中）" -#: ../../reference/datamodel.rst:1046 +#: ../../reference/datamodel.rst:1050 msgid "stderr (in module sys)" msgstr "stderr （sys 模組中）" -#: ../../reference/datamodel.rst:1075 +#: ../../reference/datamodel.rst:1079 msgid "internal type" msgstr "internal type（內部型別）" -#: ../../reference/datamodel.rst:1075 +#: ../../reference/datamodel.rst:1079 msgid "types, internal" msgstr "types（型別）, internal（內部）" -#: ../../reference/datamodel.rst:1089 +#: ../../reference/datamodel.rst:1093 msgid "bytecode" msgstr "bytecode（位元組碼）" -#: ../../reference/datamodel.rst:1089 +#: ../../reference/datamodel.rst:1093 msgid "code" msgstr "code（程式碼）" -#: ../../reference/datamodel.rst:1089 +#: ../../reference/datamodel.rst:1093 msgid "code object" msgstr "code object（程式碼物件）" -#: ../../reference/datamodel.rst:1100 +#: ../../reference/datamodel.rst:1104 msgid "co_argcount (code object attribute)" msgstr "co_argcount （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1100 +#: ../../reference/datamodel.rst:1104 msgid "co_posonlyargcount (code object attribute)" msgstr "co_posonlyargcount （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1100 +#: ../../reference/datamodel.rst:1104 msgid "co_kwonlyargcount (code object attribute)" msgstr "co_kwonlyargcount （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1100 +#: ../../reference/datamodel.rst:1104 msgid "co_code (code object attribute)" msgstr "co_code （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1100 +#: ../../reference/datamodel.rst:1104 msgid "co_consts (code object attribute)" msgstr "co_consts （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1100 +#: ../../reference/datamodel.rst:1104 msgid "co_filename (code object attribute)" msgstr "co_filename （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1100 +#: ../../reference/datamodel.rst:1104 msgid "co_firstlineno (code object attribute)" msgstr "co_firstlineno （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1100 +#: ../../reference/datamodel.rst:1104 msgid "co_flags (code object attribute)" msgstr "co_flags （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1100 +#: ../../reference/datamodel.rst:1104 msgid "co_lnotab (code object attribute)" msgstr "co_lnotab （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1100 +#: ../../reference/datamodel.rst:1104 msgid "co_name (code object attribute)" msgstr "co_name （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1100 +#: ../../reference/datamodel.rst:1104 msgid "co_names (code object attribute)" msgstr "co_names （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1100 +#: ../../reference/datamodel.rst:1104 msgid "co_nlocals (code object attribute)" msgstr "co_nlocals （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1100 +#: ../../reference/datamodel.rst:1104 msgid "co_stacksize (code object attribute)" msgstr "co_stacksize （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1100 +#: ../../reference/datamodel.rst:1104 msgid "co_varnames (code object attribute)" msgstr "co_varnames （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1100 +#: ../../reference/datamodel.rst:1104 msgid "co_cellvars (code object attribute)" msgstr "co_cellvars （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1100 +#: ../../reference/datamodel.rst:1104 msgid "co_freevars (code object attribute)" msgstr "co_freevars （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1100 +#: ../../reference/datamodel.rst:1104 msgid "co_qualname (code object attribute)" msgstr "co_qualname （程式碼物件屬性）" -#: ../../reference/datamodel.rst:1211 +#: ../../reference/datamodel.rst:1215 msgid "documentation string" msgstr "documentation string（文件字串）" -#: ../../reference/datamodel.rst:1300 +#: ../../reference/datamodel.rst:1304 msgid "frame" msgstr "frame" -#: ../../reference/datamodel.rst:1306 +#: ../../reference/datamodel.rst:1310 msgid "f_back (frame attribute)" msgstr "f_back （frame 屬性）" -#: ../../reference/datamodel.rst:1306 +#: ../../reference/datamodel.rst:1310 msgid "f_code (frame attribute)" msgstr "f_code （frame 屬性）" -#: ../../reference/datamodel.rst:1306 +#: ../../reference/datamodel.rst:1310 msgid "f_globals (frame attribute)" msgstr "f_globals （frame 屬性）" -#: ../../reference/datamodel.rst:1306 +#: ../../reference/datamodel.rst:1310 msgid "f_locals (frame attribute)" msgstr "f_locals （frame 屬性）" -#: ../../reference/datamodel.rst:1306 +#: ../../reference/datamodel.rst:1310 msgid "f_lasti (frame attribute)" msgstr "f_lasti （frame 屬性）" -#: ../../reference/datamodel.rst:1306 +#: ../../reference/datamodel.rst:1310 msgid "f_builtins (frame attribute)" msgstr "f_builtins （frame 屬性）" -#: ../../reference/datamodel.rst:1345 +#: ../../reference/datamodel.rst:1349 msgid "f_trace (frame attribute)" msgstr "f_trace （frame 屬性）" -#: ../../reference/datamodel.rst:1345 +#: ../../reference/datamodel.rst:1349 msgid "f_trace_lines (frame attribute)" msgstr "f_trace_lines （frame 屬性）" -#: ../../reference/datamodel.rst:1345 +#: ../../reference/datamodel.rst:1349 msgid "f_trace_opcodes (frame attribute)" msgstr "f_trace_opcodes （frame 屬性）" -#: ../../reference/datamodel.rst:1345 +#: ../../reference/datamodel.rst:1349 msgid "f_lineno (frame attribute)" msgstr "f_lineno （frame 屬性）" -#: ../../reference/datamodel.rst:1400 +#: ../../reference/datamodel.rst:1404 msgid "traceback" msgstr "traceback" -#: ../../reference/datamodel.rst:1400 +#: ../../reference/datamodel.rst:1404 msgid "stack" msgstr "stack（堆疊）" -#: ../../reference/datamodel.rst:1400 +#: ../../reference/datamodel.rst:1404 msgid "trace" msgstr "trace（追蹤）" -#: ../../reference/datamodel.rst:1400 +#: ../../reference/datamodel.rst:1404 msgid "exception" msgstr "exception（例外）" -#: ../../reference/datamodel.rst:1400 +#: ../../reference/datamodel.rst:1404 msgid "handler" msgstr "handler（處理器）" -#: ../../reference/datamodel.rst:1400 +#: ../../reference/datamodel.rst:1404 msgid "execution" msgstr "execution（執行）" -#: ../../reference/datamodel.rst:1400 +#: ../../reference/datamodel.rst:1404 msgid "exc_info (in module sys)" msgstr "exc_info （sys 模組中）" -#: ../../reference/datamodel.rst:1400 +#: ../../reference/datamodel.rst:1404 msgid "last_traceback (in module sys)" msgstr "last_traceback （sys 模組中）" -#: ../../reference/datamodel.rst:1400 +#: ../../reference/datamodel.rst:1404 msgid "sys.exc_info" msgstr "sys.exc_info" -#: ../../reference/datamodel.rst:1400 +#: ../../reference/datamodel.rst:1404 msgid "sys.exception" msgstr "sys.exception" -#: ../../reference/datamodel.rst:1400 +#: ../../reference/datamodel.rst:1404 msgid "sys.last_traceback" msgstr "sys.last_traceback" -#: ../../reference/datamodel.rst:1437 +#: ../../reference/datamodel.rst:1441 msgid "tb_frame (traceback attribute)" msgstr "tb_frame （traceback 屬性）" -#: ../../reference/datamodel.rst:1437 +#: ../../reference/datamodel.rst:1441 msgid "tb_lineno (traceback attribute)" msgstr "tb_lineno （traceback 屬性）" -#: ../../reference/datamodel.rst:1437 +#: ../../reference/datamodel.rst:1441 msgid "tb_lasti (traceback attribute)" msgstr "tb_lasti （traceback 屬性）" -#: ../../reference/datamodel.rst:1437 +#: ../../reference/datamodel.rst:1441 msgid "try" msgstr "try" -#: ../../reference/datamodel.rst:1467 +#: ../../reference/datamodel.rst:1471 msgid "tb_next (traceback attribute)" msgstr "tb_next （traceback 屬性）" -#: ../../reference/datamodel.rst:1483 ../../reference/datamodel.rst:2829 +#: ../../reference/datamodel.rst:1487 ../../reference/datamodel.rst:2833 msgid "slice" msgstr "slice（切片）" -#: ../../reference/datamodel.rst:1489 +#: ../../reference/datamodel.rst:1493 msgid "start (slice object attribute)" msgstr "start （slice 物件屬性）" -#: ../../reference/datamodel.rst:1489 +#: ../../reference/datamodel.rst:1493 msgid "stop (slice object attribute)" msgstr "stop （slice 物件屬性）" -#: ../../reference/datamodel.rst:1489 +#: ../../reference/datamodel.rst:1493 msgid "step (slice object attribute)" msgstr "step （slice 物件屬性）" -#: ../../reference/datamodel.rst:1537 +#: ../../reference/datamodel.rst:1541 msgid "operator" msgstr "operator（運算子）" -#: ../../reference/datamodel.rst:1537 +#: ../../reference/datamodel.rst:1541 msgid "overloading" msgstr "overloading（多載）" -#: ../../reference/datamodel.rst:1537 +#: ../../reference/datamodel.rst:1541 msgid "__getitem__() (mapping object method)" msgstr "__getitem__() （對映物件方法）" -#: ../../reference/datamodel.rst:1573 +#: ../../reference/datamodel.rst:1577 msgid "subclassing" msgstr "subclassing（子類別化）" -#: ../../reference/datamodel.rst:1573 +#: ../../reference/datamodel.rst:1577 msgid "immutable types" msgstr "immutable types（不可變型別）" -#: ../../reference/datamodel.rst:1602 +#: ../../reference/datamodel.rst:1606 msgid "constructor" msgstr "constructor（建構函式）" -#: ../../reference/datamodel.rst:1619 +#: ../../reference/datamodel.rst:1623 msgid "destructor" msgstr "destructor（解構函式）" -#: ../../reference/datamodel.rst:1619 +#: ../../reference/datamodel.rst:1623 msgid "finalizer" msgstr "finalizer（終結函式）" -#: ../../reference/datamodel.rst:1619 +#: ../../reference/datamodel.rst:1623 msgid "del" msgstr "del" -#: ../../reference/datamodel.rst:1683 +#: ../../reference/datamodel.rst:1687 msgid "repr() (built-in function)" msgstr "repr() （內建函式）" -#: ../../reference/datamodel.rst:1683 +#: ../../reference/datamodel.rst:1687 msgid "__repr__() (object method)" msgstr "__repr__() （物件方法）" -#: ../../reference/datamodel.rst:1700 +#: ../../reference/datamodel.rst:1704 msgid "__str__() (object method)" msgstr "__str__() （物件方法）" -#: ../../reference/datamodel.rst:1700 +#: ../../reference/datamodel.rst:1704 msgid "format() (built-in function)" msgstr "format() （內建函式）" -#: ../../reference/datamodel.rst:1700 +#: ../../reference/datamodel.rst:1704 msgid "print() (built-in function)" msgstr "print() （內建函式）" -#: ../../reference/datamodel.rst:1730 +#: ../../reference/datamodel.rst:1734 msgid "__format__() (object method)" msgstr "__format__() （物件方法）" -#: ../../reference/datamodel.rst:1730 +#: ../../reference/datamodel.rst:1734 msgid "conversion" msgstr "conversion" -#: ../../reference/datamodel.rst:1730 +#: ../../reference/datamodel.rst:1734 msgid "print" msgstr "print" -#: ../../reference/datamodel.rst:1769 +#: ../../reference/datamodel.rst:1773 msgid "comparisons" msgstr "comparison（比較）" -#: ../../reference/datamodel.rst:1814 +#: ../../reference/datamodel.rst:1818 msgid "hash" msgstr "hash（雜湊）" -#: ../../reference/datamodel.rst:1895 +#: ../../reference/datamodel.rst:1899 msgid "__len__() (mapping object method)" msgstr "__len__() （對映物件方法）" -#: ../../reference/datamodel.rst:1999 +#: ../../reference/datamodel.rst:2003 msgid "__getattr__ (module attribute)" msgstr "__getattr__ （模組屬性）" -#: ../../reference/datamodel.rst:1999 +#: ../../reference/datamodel.rst:2003 msgid "__dir__ (module attribute)" msgstr "__dir__ （模組屬性）" -#: ../../reference/datamodel.rst:1999 +#: ../../reference/datamodel.rst:2003 msgid "__class__ (module attribute)" msgstr "__class__ （模組屬性）" -#: ../../reference/datamodel.rst:2370 +#: ../../reference/datamodel.rst:2374 msgid "metaclass" msgstr "metaclass（元類別）" -#: ../../reference/datamodel.rst:2370 +#: ../../reference/datamodel.rst:2374 msgid "= (equals)" msgstr "= （等於）" -#: ../../reference/datamodel.rst:2370 +#: ../../reference/datamodel.rst:2374 msgid "class definition" msgstr "class definition（類別定義）" -#: ../../reference/datamodel.rst:2434 +#: ../../reference/datamodel.rst:2438 msgid "metaclass hint" msgstr "metaclass hint（元類別提示）" -#: ../../reference/datamodel.rst:2457 +#: ../../reference/datamodel.rst:2461 msgid "__prepare__ (metaclass method)" msgstr "__prepare__ （元類別方法）" -#: ../../reference/datamodel.rst:2481 +#: ../../reference/datamodel.rst:2485 msgid "body" msgstr "body" -#: ../../reference/datamodel.rst:2501 +#: ../../reference/datamodel.rst:2505 msgid "__class__ (method cell)" msgstr "__class__ （方法 cell）" -#: ../../reference/datamodel.rst:2501 +#: ../../reference/datamodel.rst:2505 msgid "__classcell__ (class namespace entry)" msgstr "__classcell__ （類別命名空間項目）" -#: ../../reference/datamodel.rst:2799 +#: ../../reference/datamodel.rst:2803 msgid "__bool__() (object method)" msgstr "__bool__() （物件方法）" -#: ../../reference/datamodel.rst:2957 ../../reference/datamodel.rst:2992 +#: ../../reference/datamodel.rst:2961 ../../reference/datamodel.rst:2996 msgid "divmod" msgstr "divmod" -#: ../../reference/datamodel.rst:2957 ../../reference/datamodel.rst:2992 -#: ../../reference/datamodel.rst:3006 +#: ../../reference/datamodel.rst:2961 ../../reference/datamodel.rst:2996 +#: ../../reference/datamodel.rst:3010 msgid "pow" msgstr "pow" -#: ../../reference/datamodel.rst:3055 +#: ../../reference/datamodel.rst:3059 msgid "abs" msgstr "abs" -#: ../../reference/datamodel.rst:3065 +#: ../../reference/datamodel.rst:3069 msgid "int" msgstr "int" -#: ../../reference/datamodel.rst:3065 +#: ../../reference/datamodel.rst:3069 msgid "float" msgstr "float" -#: ../../reference/datamodel.rst:3093 +#: ../../reference/datamodel.rst:3097 msgid "round" msgstr "round" -#: ../../reference/datamodel.rst:3120 +#: ../../reference/datamodel.rst:3124 msgid "with" msgstr "with" -#: ../../reference/datamodel.rst:3120 +#: ../../reference/datamodel.rst:3124 msgid "context manager" msgstr "context manager（情境管理器）" From 3f90eda4910e68658b37292c250867f48cc76417 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Mon, 12 Aug 2024 00:05:12 +0000 Subject: [PATCH 20/28] sync with cpython 92ad3be0 --- library/weakref.po | 18 +- reference/lexical_analysis.po | 359 +++++++++++++++++----------------- 2 files changed, 188 insertions(+), 189 deletions(-) diff --git a/library/weakref.po b/library/weakref.po index 4ff792d9fb..42a02bb018 100644 --- a/library/weakref.po +++ b/library/weakref.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-10-11 17:13+0000\n" +"POT-Creation-Date: 2024-08-12 00:03+0000\n" "PO-Revision-Date: 2024-05-22 20:58+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -321,9 +321,10 @@ msgstr "" msgid "A workaround would be to remove the key prior to reassignment::" msgstr "一個變通的解法是在重新賦值 (reassignment) 之前刪除鍵： ::" -#: ../../library/weakref.rst:199 -msgid "Added support for ``|`` and ``|=`` operators, specified in :pep:`584`." -msgstr "新增 :pep:`584` 所述對於 ``|`` 與 ``|=`` 運算子的支援。" +#: ../../library/weakref.rst:199 ../../library/weakref.rst:220 +msgid "" +"Added support for ``|`` and ``|=`` operators, as specified in :pep:`584`." +msgstr "新增對 ``|`` 和 ``|=`` 運算子的支持，如 :pep:`584` 中所說明。" #: ../../library/weakref.rst:202 msgid "" @@ -348,11 +349,6 @@ msgid "" "be discarded when no strong reference to the value exists any more." msgstr "弱參照值的對映類別。當不再存在對值的強參照時，字典中的條目將被丟棄。" -#: ../../library/weakref.rst:220 -msgid "" -"Added support for ``|`` and ``|=`` operators, as specified in :pep:`584`." -msgstr "新增對 ``|`` 和 ``|=`` 運算子的支持，如 :pep:`584` 中所說明。" - #: ../../library/weakref.rst:223 msgid "" ":class:`WeakValueDictionary` objects have an additional method that has the " @@ -723,3 +719,7 @@ msgstr "" "如果在程式結束時在常駐的 (daemonic) 執行緒中建立最終化器物件，則最終化器有可" "能在結束時不會被呼叫。然而，在常駐的執行緒中 :func:`atexit.register`、" "``try: ... finally: ...`` 和 ``with: ...`` 也不保證清理會發生。" + +#~ msgid "" +#~ "Added support for ``|`` and ``|=`` operators, specified in :pep:`584`." +#~ msgstr "新增 :pep:`584` 所述對於 ``|`` 與 ``|=`` 運算子的支援。" diff --git a/reference/lexical_analysis.po b/reference/lexical_analysis.po index 27e020ae40..52250fb17f 100644 --- a/reference/lexical_analysis.po +++ b/reference/lexical_analysis.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-20 00:03+0000\n" +"POT-Creation-Date: 2024-08-12 00:03+0000\n" "PO-Revision-Date: 2018-05-23 16:17+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -568,27 +568,26 @@ msgstr "" #: ../../reference/lexical_analysis.rst:505 msgid "" "Both string and bytes literals may optionally be prefixed with a letter " -"``'r'`` or ``'R'``; such strings are called :dfn:`raw strings` and treat " -"backslashes as literal characters. As a result, in string literals, " -"``'\\U'`` and ``'\\u'`` escapes in raw strings are not treated specially. " -"Given that Python 2.x's raw unicode literals behave differently than Python " -"3.x's the ``'ur'`` syntax is not supported." +"``'r'`` or ``'R'``; such constructs are called :dfn:`raw string literals` " +"and :dfn:`raw bytes literals` respectively and treat backslashes as literal " +"characters. As a result, in raw string literals, ``'\\U'`` and ``'\\u'`` " +"escapes are not treated specially." msgstr "" -#: ../../reference/lexical_analysis.rst:512 +#: ../../reference/lexical_analysis.rst:511 msgid "" "The ``'rb'`` prefix of raw bytes literals has been added as a synonym of " "``'br'``." msgstr "" -#: ../../reference/lexical_analysis.rst:516 +#: ../../reference/lexical_analysis.rst:515 msgid "" "Support for the unicode legacy literal (``u'value'``) was reintroduced to " "simplify the maintenance of dual Python 2.x and 3.x codebases. See :pep:" "`414` for more information." msgstr "" -#: ../../reference/lexical_analysis.rst:524 +#: ../../reference/lexical_analysis.rst:523 msgid "" "A string literal with ``'f'`` or ``'F'`` in its prefix is a :dfn:`formatted " "string literal`; see :ref:`f-strings`. The ``'f'`` may be combined with " @@ -596,7 +595,7 @@ msgid "" "are possible, but formatted bytes literals are not." msgstr "" -#: ../../reference/lexical_analysis.rst:529 +#: ../../reference/lexical_analysis.rst:528 msgid "" "In triple-quoted literals, unescaped newlines and quotes are allowed (and " "are retained), except that three unescaped quotes in a row terminate the " @@ -604,246 +603,246 @@ msgid "" "either ``'`` or ``\"``.)" msgstr "" -#: ../../reference/lexical_analysis.rst:552 +#: ../../reference/lexical_analysis.rst:551 msgid "Escape sequences" msgstr "跳脫序列" -#: ../../reference/lexical_analysis.rst:554 +#: ../../reference/lexical_analysis.rst:553 msgid "" "Unless an ``'r'`` or ``'R'`` prefix is present, escape sequences in string " "and bytes literals are interpreted according to rules similar to those used " "by Standard C. The recognized escape sequences are:" msgstr "" -#: ../../reference/lexical_analysis.rst:559 -#: ../../reference/lexical_analysis.rst:592 +#: ../../reference/lexical_analysis.rst:558 +#: ../../reference/lexical_analysis.rst:591 msgid "Escape Sequence" msgstr "" -#: ../../reference/lexical_analysis.rst:559 -#: ../../reference/lexical_analysis.rst:592 +#: ../../reference/lexical_analysis.rst:558 +#: ../../reference/lexical_analysis.rst:591 msgid "Meaning" msgstr "" -#: ../../reference/lexical_analysis.rst:559 -#: ../../reference/lexical_analysis.rst:592 +#: ../../reference/lexical_analysis.rst:558 +#: ../../reference/lexical_analysis.rst:591 msgid "Notes" msgstr "註解" -#: ../../reference/lexical_analysis.rst:561 +#: ../../reference/lexical_analysis.rst:560 msgid "``\\``\\ " msgstr "``\\``\\ " -#: ../../reference/lexical_analysis.rst:561 +#: ../../reference/lexical_analysis.rst:560 msgid "Backslash and newline ignored" msgstr "" -#: ../../reference/lexical_analysis.rst:561 +#: ../../reference/lexical_analysis.rst:560 msgid "\\(1)" msgstr "\\(1)" -#: ../../reference/lexical_analysis.rst:563 +#: ../../reference/lexical_analysis.rst:562 msgid "``\\\\``" msgstr "``\\\\``" -#: ../../reference/lexical_analysis.rst:563 +#: ../../reference/lexical_analysis.rst:562 msgid "Backslash (``\\``)" msgstr "" -#: ../../reference/lexical_analysis.rst:565 +#: ../../reference/lexical_analysis.rst:564 msgid "``\\'``" msgstr "``\\'``" -#: ../../reference/lexical_analysis.rst:565 +#: ../../reference/lexical_analysis.rst:564 msgid "Single quote (``'``)" msgstr "單引號 (``'``)" -#: ../../reference/lexical_analysis.rst:567 +#: ../../reference/lexical_analysis.rst:566 msgid "``\\\"``" msgstr "``\\\"``" -#: ../../reference/lexical_analysis.rst:567 +#: ../../reference/lexical_analysis.rst:566 msgid "Double quote (``\"``)" msgstr "雙引號 (``\"``)" -#: ../../reference/lexical_analysis.rst:569 +#: ../../reference/lexical_analysis.rst:568 msgid "``\\a``" msgstr "``\\a``" -#: ../../reference/lexical_analysis.rst:569 +#: ../../reference/lexical_analysis.rst:568 msgid "ASCII Bell (BEL)" msgstr "" -#: ../../reference/lexical_analysis.rst:571 +#: ../../reference/lexical_analysis.rst:570 msgid "``\\b``" msgstr "``\\b``" -#: ../../reference/lexical_analysis.rst:571 +#: ../../reference/lexical_analysis.rst:570 msgid "ASCII Backspace (BS)" msgstr "" -#: ../../reference/lexical_analysis.rst:573 +#: ../../reference/lexical_analysis.rst:572 msgid "``\\f``" msgstr "``\\f``" -#: ../../reference/lexical_analysis.rst:573 +#: ../../reference/lexical_analysis.rst:572 msgid "ASCII Formfeed (FF)" msgstr "" -#: ../../reference/lexical_analysis.rst:575 +#: ../../reference/lexical_analysis.rst:574 msgid "``\\n``" msgstr "``\\n``" -#: ../../reference/lexical_analysis.rst:575 +#: ../../reference/lexical_analysis.rst:574 msgid "ASCII Linefeed (LF)" msgstr "" -#: ../../reference/lexical_analysis.rst:577 +#: ../../reference/lexical_analysis.rst:576 msgid "``\\r``" msgstr "``\\r``" -#: ../../reference/lexical_analysis.rst:577 +#: ../../reference/lexical_analysis.rst:576 msgid "ASCII Carriage Return (CR)" msgstr "" -#: ../../reference/lexical_analysis.rst:579 +#: ../../reference/lexical_analysis.rst:578 msgid "``\\t``" msgstr "``\\t``" -#: ../../reference/lexical_analysis.rst:579 +#: ../../reference/lexical_analysis.rst:578 msgid "ASCII Horizontal Tab (TAB)" msgstr "" -#: ../../reference/lexical_analysis.rst:581 +#: ../../reference/lexical_analysis.rst:580 msgid "``\\v``" msgstr "``\\v``" -#: ../../reference/lexical_analysis.rst:581 +#: ../../reference/lexical_analysis.rst:580 msgid "ASCII Vertical Tab (VT)" msgstr "" -#: ../../reference/lexical_analysis.rst:583 +#: ../../reference/lexical_analysis.rst:582 msgid ":samp:`\\\\\\\\{ooo}`" msgstr ":samp:`\\\\\\\\{ooo}`" -#: ../../reference/lexical_analysis.rst:583 +#: ../../reference/lexical_analysis.rst:582 msgid "Character with octal value *ooo*" msgstr "" -#: ../../reference/lexical_analysis.rst:583 +#: ../../reference/lexical_analysis.rst:582 msgid "(2,4)" msgstr "(2,4)" -#: ../../reference/lexical_analysis.rst:586 +#: ../../reference/lexical_analysis.rst:585 msgid ":samp:`\\\\x{hh}`" msgstr ":samp:`\\\\x{hh}`" -#: ../../reference/lexical_analysis.rst:586 +#: ../../reference/lexical_analysis.rst:585 msgid "Character with hex value *hh*" msgstr "" -#: ../../reference/lexical_analysis.rst:586 +#: ../../reference/lexical_analysis.rst:585 msgid "(3,4)" msgstr "(3,4)" -#: ../../reference/lexical_analysis.rst:589 +#: ../../reference/lexical_analysis.rst:588 msgid "Escape sequences only recognized in string literals are:" msgstr "" -#: ../../reference/lexical_analysis.rst:594 +#: ../../reference/lexical_analysis.rst:593 msgid ":samp:`\\\\N\\\\{{name}\\\\}`" msgstr ":samp:`\\\\N\\\\{{name}\\\\}`" -#: ../../reference/lexical_analysis.rst:594 +#: ../../reference/lexical_analysis.rst:593 msgid "Character named *name* in the Unicode database" msgstr "" -#: ../../reference/lexical_analysis.rst:594 +#: ../../reference/lexical_analysis.rst:593 msgid "\\(5)" msgstr "\\(5)" -#: ../../reference/lexical_analysis.rst:597 +#: ../../reference/lexical_analysis.rst:596 msgid ":samp:`\\\\u{xxxx}`" msgstr ":samp:`\\\\u{xxxx}`" -#: ../../reference/lexical_analysis.rst:597 +#: ../../reference/lexical_analysis.rst:596 msgid "Character with 16-bit hex value *xxxx*" msgstr "" -#: ../../reference/lexical_analysis.rst:597 +#: ../../reference/lexical_analysis.rst:596 msgid "\\(6)" msgstr "\\(6)" -#: ../../reference/lexical_analysis.rst:600 +#: ../../reference/lexical_analysis.rst:599 msgid ":samp:`\\\\U{xxxxxxxx}`" msgstr ":samp:`\\\\U{xxxxxxxx}`" -#: ../../reference/lexical_analysis.rst:600 +#: ../../reference/lexical_analysis.rst:599 msgid "Character with 32-bit hex value *xxxxxxxx*" msgstr "" -#: ../../reference/lexical_analysis.rst:600 +#: ../../reference/lexical_analysis.rst:599 msgid "\\(7)" msgstr "\\(7)" -#: ../../reference/lexical_analysis.rst:604 +#: ../../reference/lexical_analysis.rst:603 msgid "Notes:" msgstr "註解：" -#: ../../reference/lexical_analysis.rst:607 +#: ../../reference/lexical_analysis.rst:606 msgid "A backslash can be added at the end of a line to ignore the newline::" msgstr "" -#: ../../reference/lexical_analysis.rst:613 +#: ../../reference/lexical_analysis.rst:612 msgid "" "The same result can be achieved using :ref:`triple-quoted strings " "`, or parentheses and :ref:`string literal concatenation `." msgstr "" -#: ../../reference/lexical_analysis.rst:618 +#: ../../reference/lexical_analysis.rst:617 msgid "As in Standard C, up to three octal digits are accepted." msgstr "" -#: ../../reference/lexical_analysis.rst:620 +#: ../../reference/lexical_analysis.rst:619 msgid "" "Octal escapes with value larger than ``0o377`` produce a :exc:" "`DeprecationWarning`." msgstr "" -#: ../../reference/lexical_analysis.rst:624 +#: ../../reference/lexical_analysis.rst:623 msgid "" "Octal escapes with value larger than ``0o377`` produce a :exc:" "`SyntaxWarning`. In a future Python version they will be eventually a :exc:" "`SyntaxError`." msgstr "" -#: ../../reference/lexical_analysis.rst:630 +#: ../../reference/lexical_analysis.rst:629 msgid "Unlike in Standard C, exactly two hex digits are required." msgstr "" -#: ../../reference/lexical_analysis.rst:633 +#: ../../reference/lexical_analysis.rst:632 msgid "" "In a bytes literal, hexadecimal and octal escapes denote the byte with the " "given value. In a string literal, these escapes denote a Unicode character " "with the given value." msgstr "" -#: ../../reference/lexical_analysis.rst:638 +#: ../../reference/lexical_analysis.rst:637 msgid "Support for name aliases [#]_ has been added." msgstr "" -#: ../../reference/lexical_analysis.rst:642 +#: ../../reference/lexical_analysis.rst:641 msgid "Exactly four hex digits are required." msgstr "" -#: ../../reference/lexical_analysis.rst:645 +#: ../../reference/lexical_analysis.rst:644 msgid "" "Any Unicode character can be encoded this way. Exactly eight hex digits are " "required." msgstr "" -#: ../../reference/lexical_analysis.rst:651 +#: ../../reference/lexical_analysis.rst:650 msgid "" "Unlike Standard C, all unrecognized escape sequences are left in the string " "unchanged, i.e., *the backslash is left in the result*. (This behavior is " @@ -853,17 +852,17 @@ msgid "" "category of unrecognized escapes for bytes literals." msgstr "" -#: ../../reference/lexical_analysis.rst:658 +#: ../../reference/lexical_analysis.rst:657 msgid "Unrecognized escape sequences produce a :exc:`DeprecationWarning`." msgstr "" -#: ../../reference/lexical_analysis.rst:661 +#: ../../reference/lexical_analysis.rst:660 msgid "" "Unrecognized escape sequences produce a :exc:`SyntaxWarning`. In a future " "Python version they will be eventually a :exc:`SyntaxError`." msgstr "" -#: ../../reference/lexical_analysis.rst:665 +#: ../../reference/lexical_analysis.rst:664 msgid "" "Even in a raw literal, quotes can be escaped with a backslash, but the " "backslash remains in the result; for example, ``r\"\\\"\"`` is a valid " @@ -876,11 +875,11 @@ msgid "" "continuation." msgstr "" -#: ../../reference/lexical_analysis.rst:678 +#: ../../reference/lexical_analysis.rst:677 msgid "String literal concatenation" msgstr "" -#: ../../reference/lexical_analysis.rst:680 +#: ../../reference/lexical_analysis.rst:679 msgid "" "Multiple adjacent string or bytes literals (delimited by whitespace), " "possibly using different quoting conventions, are allowed, and their meaning " @@ -890,7 +889,7 @@ msgid "" "lines, or even to add comments to parts of strings, for example::" msgstr "" -#: ../../reference/lexical_analysis.rst:691 +#: ../../reference/lexical_analysis.rst:690 msgid "" "Note that this feature is defined at the syntactical level, but implemented " "at compile time. The '+' operator must be used to concatenate string " @@ -900,11 +899,11 @@ msgid "" "with plain string literals." msgstr "" -#: ../../reference/lexical_analysis.rst:714 +#: ../../reference/lexical_analysis.rst:713 msgid "f-strings" msgstr "f-string（f 字串）" -#: ../../reference/lexical_analysis.rst:718 +#: ../../reference/lexical_analysis.rst:717 msgid "" "A :dfn:`formatted string literal` or :dfn:`f-string` is a string literal " "that is prefixed with ``'f'`` or ``'F'``. These strings may contain " @@ -913,14 +912,14 @@ msgid "" "are really expressions evaluated at run time." msgstr "" -#: ../../reference/lexical_analysis.rst:724 +#: ../../reference/lexical_analysis.rst:723 msgid "" "Escape sequences are decoded like in ordinary string literals (except when a " "literal is also marked as a raw string). After decoding, the grammar for " "the contents of the string is:" msgstr "" -#: ../../reference/lexical_analysis.rst:738 +#: ../../reference/lexical_analysis.rst:737 msgid "" "The parts of the string outside curly braces are treated literally, except " "that any doubled curly braces ``'{{'`` or ``'}}'`` are replaced with the " @@ -933,7 +932,7 @@ msgid "" "replacement field ends with a closing curly bracket ``'}'``." msgstr "" -#: ../../reference/lexical_analysis.rst:748 +#: ../../reference/lexical_analysis.rst:747 msgid "" "Expressions in formatted string literals are treated like regular Python " "expressions surrounded by parentheses, with a few exceptions. An empty " @@ -947,20 +946,20 @@ msgid "" "replacement fields must be closed in a different line." msgstr "" -#: ../../reference/lexical_analysis.rst:765 +#: ../../reference/lexical_analysis.rst:764 msgid "" "Prior to Python 3.7, an :keyword:`await` expression and comprehensions " "containing an :keyword:`async for` clause were illegal in the expressions in " "formatted string literals due to a problem with the implementation." msgstr "" -#: ../../reference/lexical_analysis.rst:770 +#: ../../reference/lexical_analysis.rst:769 msgid "" "Prior to Python 3.12, comments were not allowed inside f-string replacement " "fields." msgstr "" -#: ../../reference/lexical_analysis.rst:774 +#: ../../reference/lexical_analysis.rst:773 msgid "" "When the equal sign ``'='`` is provided, the output will have the expression " "text, the ``'='`` and the evaluated value. Spaces after the opening brace " @@ -971,18 +970,18 @@ msgid "" "r'`` is declared." msgstr "" -#: ../../reference/lexical_analysis.rst:782 +#: ../../reference/lexical_analysis.rst:781 msgid "The equal sign ``'='``." msgstr "等號 ``'='``。" -#: ../../reference/lexical_analysis.rst:785 +#: ../../reference/lexical_analysis.rst:784 msgid "" "If a conversion is specified, the result of evaluating the expression is " "converted before formatting. Conversion ``'!s'`` calls :func:`str` on the " "result, ``'!r'`` calls :func:`repr`, and ``'!a'`` calls :func:`ascii`." msgstr "" -#: ../../reference/lexical_analysis.rst:789 +#: ../../reference/lexical_analysis.rst:788 msgid "" "The result is then formatted using the :func:`format` protocol. The format " "specifier is passed to the :meth:`~object.__format__` method of the " @@ -991,7 +990,7 @@ msgid "" "value of the whole string." msgstr "" -#: ../../reference/lexical_analysis.rst:795 +#: ../../reference/lexical_analysis.rst:794 msgid "" "Top-level format specifiers may include nested replacement fields. These " "nested fields may include their own conversion fields and :ref:`format " @@ -1000,117 +999,117 @@ msgid "" "as that used by the :meth:`str.format` method." msgstr "" -#: ../../reference/lexical_analysis.rst:801 +#: ../../reference/lexical_analysis.rst:800 msgid "" "Formatted string literals may be concatenated, but replacement fields cannot " "be split across literals." msgstr "" -#: ../../reference/lexical_analysis.rst:804 +#: ../../reference/lexical_analysis.rst:803 msgid "Some examples of formatted string literals::" msgstr "" -#: ../../reference/lexical_analysis.rst:836 +#: ../../reference/lexical_analysis.rst:835 msgid "" "Reusing the outer f-string quoting type inside a replacement field is " "permitted::" msgstr "" -#: ../../reference/lexical_analysis.rst:843 +#: ../../reference/lexical_analysis.rst:842 msgid "" "Prior to Python 3.12, reuse of the same quoting type of the outer f-string " "inside a replacement field was not possible." msgstr "" -#: ../../reference/lexical_analysis.rst:847 +#: ../../reference/lexical_analysis.rst:846 msgid "" "Backslashes are also allowed in replacement fields and are evaluated the " "same way as in any other context::" msgstr "" -#: ../../reference/lexical_analysis.rst:857 +#: ../../reference/lexical_analysis.rst:856 msgid "" "Prior to Python 3.12, backslashes were not permitted inside an f-string " "replacement field." msgstr "" -#: ../../reference/lexical_analysis.rst:861 +#: ../../reference/lexical_analysis.rst:860 msgid "" "Formatted string literals cannot be used as docstrings, even if they do not " "include expressions." msgstr "" -#: ../../reference/lexical_analysis.rst:872 +#: ../../reference/lexical_analysis.rst:871 msgid "" "See also :pep:`498` for the proposal that added formatted string literals, " "and :meth:`str.format`, which uses a related format string mechanism." msgstr "" -#: ../../reference/lexical_analysis.rst:879 +#: ../../reference/lexical_analysis.rst:878 msgid "Numeric literals" msgstr "" -#: ../../reference/lexical_analysis.rst:885 +#: ../../reference/lexical_analysis.rst:884 msgid "" "There are three types of numeric literals: integers, floating-point numbers, " "and imaginary numbers. There are no complex literals (complex numbers can " "be formed by adding a real number and an imaginary number)." msgstr "" -#: ../../reference/lexical_analysis.rst:889 +#: ../../reference/lexical_analysis.rst:888 msgid "" "Note that numeric literals do not include a sign; a phrase like ``-1`` is " "actually an expression composed of the unary operator '``-``' and the " "literal ``1``." msgstr "" -#: ../../reference/lexical_analysis.rst:903 +#: ../../reference/lexical_analysis.rst:902 msgid "Integer literals" msgstr "" -#: ../../reference/lexical_analysis.rst:905 +#: ../../reference/lexical_analysis.rst:904 msgid "Integer literals are described by the following lexical definitions:" msgstr "" -#: ../../reference/lexical_analysis.rst:919 +#: ../../reference/lexical_analysis.rst:918 msgid "" "There is no limit for the length of integer literals apart from what can be " "stored in available memory." msgstr "" -#: ../../reference/lexical_analysis.rst:922 +#: ../../reference/lexical_analysis.rst:921 msgid "" "Underscores are ignored for determining the numeric value of the literal. " "They can be used to group digits for enhanced readability. One underscore " "can occur between digits, and after base specifiers like ``0x``." msgstr "" -#: ../../reference/lexical_analysis.rst:926 +#: ../../reference/lexical_analysis.rst:925 msgid "" "Note that leading zeros in a non-zero decimal number are not allowed. This " "is for disambiguation with C-style octal literals, which Python used before " "version 3.0." msgstr "" -#: ../../reference/lexical_analysis.rst:930 +#: ../../reference/lexical_analysis.rst:929 msgid "Some examples of integer literals::" msgstr "" -#: ../../reference/lexical_analysis.rst:936 -#: ../../reference/lexical_analysis.rst:968 +#: ../../reference/lexical_analysis.rst:935 +#: ../../reference/lexical_analysis.rst:967 msgid "Underscores are now allowed for grouping purposes in literals." msgstr "" -#: ../../reference/lexical_analysis.rst:947 +#: ../../reference/lexical_analysis.rst:946 msgid "Floating-point literals" msgstr "浮點數常數 (Floating-point literals)" -#: ../../reference/lexical_analysis.rst:949 +#: ../../reference/lexical_analysis.rst:948 msgid "" "Floating-point literals are described by the following lexical definitions:" msgstr "" -#: ../../reference/lexical_analysis.rst:959 +#: ../../reference/lexical_analysis.rst:958 msgid "" "Note that the integer and exponent parts are always interpreted using radix " "10. For example, ``077e010`` is legal, and denotes the same number as " @@ -1119,19 +1118,19 @@ msgid "" "grouping." msgstr "" -#: ../../reference/lexical_analysis.rst:964 +#: ../../reference/lexical_analysis.rst:963 msgid "Some examples of floating-point literals::" msgstr "一些浮點數常數的範例： ::" -#: ../../reference/lexical_analysis.rst:977 +#: ../../reference/lexical_analysis.rst:976 msgid "Imaginary literals" msgstr "" -#: ../../reference/lexical_analysis.rst:979 +#: ../../reference/lexical_analysis.rst:978 msgid "Imaginary literals are described by the following lexical definitions:" msgstr "" -#: ../../reference/lexical_analysis.rst:984 +#: ../../reference/lexical_analysis.rst:983 msgid "" "An imaginary literal yields a complex number with a real part of 0.0. " "Complex numbers are represented as a pair of floating-point numbers and have " @@ -1140,23 +1139,23 @@ msgid "" "Some examples of imaginary literals::" msgstr "" -#: ../../reference/lexical_analysis.rst:996 +#: ../../reference/lexical_analysis.rst:995 msgid "Operators" msgstr "" -#: ../../reference/lexical_analysis.rst:1000 +#: ../../reference/lexical_analysis.rst:999 msgid "The following tokens are operators:" msgstr "" -#: ../../reference/lexical_analysis.rst:1013 +#: ../../reference/lexical_analysis.rst:1012 msgid "Delimiters" msgstr "" -#: ../../reference/lexical_analysis.rst:1017 +#: ../../reference/lexical_analysis.rst:1016 msgid "The following tokens serve as delimiters in the grammar:" msgstr "" -#: ../../reference/lexical_analysis.rst:1026 +#: ../../reference/lexical_analysis.rst:1025 msgid "" "The period can also occur in floating-point and imaginary literals. A " "sequence of three periods has a special meaning as an ellipsis literal. The " @@ -1164,23 +1163,23 @@ msgid "" "as delimiters, but also perform an operation." msgstr "" -#: ../../reference/lexical_analysis.rst:1031 +#: ../../reference/lexical_analysis.rst:1030 msgid "" "The following printing ASCII characters have special meaning as part of " "other tokens or are otherwise significant to the lexical analyzer:" msgstr "" -#: ../../reference/lexical_analysis.rst:1038 +#: ../../reference/lexical_analysis.rst:1037 msgid "" "The following printing ASCII characters are not used in Python. Their " "occurrence outside string literals and comments is an unconditional error:" msgstr "" -#: ../../reference/lexical_analysis.rst:1047 +#: ../../reference/lexical_analysis.rst:1046 msgid "Footnotes" msgstr "註解" -#: ../../reference/lexical_analysis.rst:1048 +#: ../../reference/lexical_analysis.rst:1047 msgid "https://www.unicode.org/Public/15.0.0/ucd/NameAliases.txt" msgstr "https://www.unicode.org/Public/15.0.0/ucd/NameAliases.txt" @@ -1206,7 +1205,7 @@ msgstr "logical line（邏輯列）" #: ../../reference/lexical_analysis.rst:35 #: ../../reference/lexical_analysis.rst:114 -#: ../../reference/lexical_analysis.rst:533 +#: ../../reference/lexical_analysis.rst:532 msgid "physical line" msgstr "physical line（物理列）" @@ -1395,216 +1394,216 @@ msgstr "raw string literal（原始字串常數）" msgid "r\"" msgstr "r\"" -#: ../../reference/lexical_analysis.rst:520 +#: ../../reference/lexical_analysis.rst:519 msgid "f'" msgstr "f'" -#: ../../reference/lexical_analysis.rst:520 -#: ../../reference/lexical_analysis.rst:698 +#: ../../reference/lexical_analysis.rst:519 +#: ../../reference/lexical_analysis.rst:697 msgid "formatted string literal" msgstr "formatted string literal（格式化字串常數）" -#: ../../reference/lexical_analysis.rst:520 +#: ../../reference/lexical_analysis.rst:519 msgid "f\"" msgstr "f\"" -#: ../../reference/lexical_analysis.rst:533 +#: ../../reference/lexical_analysis.rst:532 msgid "escape sequence" msgstr "escape sequence（跳脫序列）" -#: ../../reference/lexical_analysis.rst:533 +#: ../../reference/lexical_analysis.rst:532 msgid "Standard C" msgstr "Standard C（標準 C）" -#: ../../reference/lexical_analysis.rst:533 +#: ../../reference/lexical_analysis.rst:532 msgid "C" msgstr "C" -#: ../../reference/lexical_analysis.rst:533 +#: ../../reference/lexical_analysis.rst:532 msgid "\\ (backslash)" msgstr "\\ （反斜線）" -#: ../../reference/lexical_analysis.rst:533 +#: ../../reference/lexical_analysis.rst:532 msgid "\\\\" msgstr "\\\\" -#: ../../reference/lexical_analysis.rst:533 +#: ../../reference/lexical_analysis.rst:532 msgid "\\a" msgstr "\\a" -#: ../../reference/lexical_analysis.rst:533 +#: ../../reference/lexical_analysis.rst:532 msgid "\\b" msgstr "\\b" -#: ../../reference/lexical_analysis.rst:533 +#: ../../reference/lexical_analysis.rst:532 msgid "\\f" msgstr "\\f" -#: ../../reference/lexical_analysis.rst:533 +#: ../../reference/lexical_analysis.rst:532 msgid "\\n" msgstr "\\n" -#: ../../reference/lexical_analysis.rst:533 +#: ../../reference/lexical_analysis.rst:532 msgid "\\r" msgstr "\\r" -#: ../../reference/lexical_analysis.rst:533 +#: ../../reference/lexical_analysis.rst:532 msgid "\\t" msgstr "\\t" -#: ../../reference/lexical_analysis.rst:533 +#: ../../reference/lexical_analysis.rst:532 msgid "\\v" msgstr "\\v" -#: ../../reference/lexical_analysis.rst:533 +#: ../../reference/lexical_analysis.rst:532 msgid "\\x" msgstr "\\x" -#: ../../reference/lexical_analysis.rst:533 +#: ../../reference/lexical_analysis.rst:532 msgid "\\N" msgstr "\\N" -#: ../../reference/lexical_analysis.rst:533 +#: ../../reference/lexical_analysis.rst:532 msgid "\\u" msgstr "\\u" -#: ../../reference/lexical_analysis.rst:533 +#: ../../reference/lexical_analysis.rst:532 msgid "\\U" msgstr "\\U" -#: ../../reference/lexical_analysis.rst:649 +#: ../../reference/lexical_analysis.rst:648 msgid "unrecognized escape sequence" msgstr "unrecognized escape sequence（無法辨識的跳脫序列）" -#: ../../reference/lexical_analysis.rst:698 +#: ../../reference/lexical_analysis.rst:697 msgid "interpolated string literal" msgstr "interpolated string literal（插值字串常數）" -#: ../../reference/lexical_analysis.rst:698 +#: ../../reference/lexical_analysis.rst:697 msgid "string" msgstr "string（字串）" -#: ../../reference/lexical_analysis.rst:698 +#: ../../reference/lexical_analysis.rst:697 msgid "formatted literal" msgstr "formatted literal（格式化常數）" -#: ../../reference/lexical_analysis.rst:698 +#: ../../reference/lexical_analysis.rst:697 msgid "interpolated literal" msgstr "interpolated literal（插值常數）" -#: ../../reference/lexical_analysis.rst:698 +#: ../../reference/lexical_analysis.rst:697 msgid "f-string" msgstr "f-string（f 字串）" -#: ../../reference/lexical_analysis.rst:698 +#: ../../reference/lexical_analysis.rst:697 msgid "fstring" msgstr "fstring（f 字串）" -#: ../../reference/lexical_analysis.rst:698 +#: ../../reference/lexical_analysis.rst:697 msgid "{} (curly brackets)" msgstr "{} （花括號）" -#: ../../reference/lexical_analysis.rst:698 +#: ../../reference/lexical_analysis.rst:697 msgid "in formatted string literal" msgstr "於格式化字串常數中" -#: ../../reference/lexical_analysis.rst:698 +#: ../../reference/lexical_analysis.rst:697 msgid "! (exclamation)" msgstr "! （驚嘆號）" -#: ../../reference/lexical_analysis.rst:698 +#: ../../reference/lexical_analysis.rst:697 msgid ": (colon)" msgstr ": （冒號）" -#: ../../reference/lexical_analysis.rst:698 +#: ../../reference/lexical_analysis.rst:697 msgid "= (equals)" msgstr "= （等於）" -#: ../../reference/lexical_analysis.rst:698 +#: ../../reference/lexical_analysis.rst:697 msgid "for help in debugging using string literals" msgstr "for help in debugging using string literals（使用字串常數進行除錯）" -#: ../../reference/lexical_analysis.rst:881 +#: ../../reference/lexical_analysis.rst:880 msgid "number" msgstr "number（數字）" -#: ../../reference/lexical_analysis.rst:881 +#: ../../reference/lexical_analysis.rst:880 msgid "numeric literal" msgstr "numeric literal（數值常數）" -#: ../../reference/lexical_analysis.rst:881 -#: ../../reference/lexical_analysis.rst:894 +#: ../../reference/lexical_analysis.rst:880 +#: ../../reference/lexical_analysis.rst:893 msgid "integer literal" msgstr "integer literal（整數常數）" -#: ../../reference/lexical_analysis.rst:881 +#: ../../reference/lexical_analysis.rst:880 msgid "floating-point literal" msgstr "floating-point literal（浮點數常數）" -#: ../../reference/lexical_analysis.rst:881 +#: ../../reference/lexical_analysis.rst:880 msgid "hexadecimal literal" msgstr "hexadecimal literal（十六進位常數）" -#: ../../reference/lexical_analysis.rst:881 +#: ../../reference/lexical_analysis.rst:880 msgid "octal literal" msgstr "octal literal（八進位常數）" -#: ../../reference/lexical_analysis.rst:881 +#: ../../reference/lexical_analysis.rst:880 msgid "binary literal" msgstr "binary literal（二進位常數）" -#: ../../reference/lexical_analysis.rst:881 +#: ../../reference/lexical_analysis.rst:880 msgid "decimal literal" msgstr "decimal literal（十進位常數）" -#: ../../reference/lexical_analysis.rst:881 +#: ../../reference/lexical_analysis.rst:880 msgid "imaginary literal" msgstr "imaginary literal（虛數常數）" -#: ../../reference/lexical_analysis.rst:881 +#: ../../reference/lexical_analysis.rst:880 msgid "complex literal" msgstr "complex literal（複數常數）" -#: ../../reference/lexical_analysis.rst:894 +#: ../../reference/lexical_analysis.rst:893 msgid "0b" msgstr "0b" -#: ../../reference/lexical_analysis.rst:894 +#: ../../reference/lexical_analysis.rst:893 msgid "0o" msgstr "0o" -#: ../../reference/lexical_analysis.rst:894 +#: ../../reference/lexical_analysis.rst:893 msgid "0x" msgstr "0x" -#: ../../reference/lexical_analysis.rst:894 -#: ../../reference/lexical_analysis.rst:940 +#: ../../reference/lexical_analysis.rst:893 +#: ../../reference/lexical_analysis.rst:939 msgid "_ (underscore)" msgstr "_ （底線）" -#: ../../reference/lexical_analysis.rst:894 -#: ../../reference/lexical_analysis.rst:940 -#: ../../reference/lexical_analysis.rst:972 +#: ../../reference/lexical_analysis.rst:893 +#: ../../reference/lexical_analysis.rst:939 +#: ../../reference/lexical_analysis.rst:971 msgid "in numeric literal" msgstr "於數值常數中" -#: ../../reference/lexical_analysis.rst:940 +#: ../../reference/lexical_analysis.rst:939 msgid ". (dot)" msgstr ". （點）" -#: ../../reference/lexical_analysis.rst:940 +#: ../../reference/lexical_analysis.rst:939 msgid "e" msgstr "e" -#: ../../reference/lexical_analysis.rst:972 +#: ../../reference/lexical_analysis.rst:971 msgid "j" msgstr "j" -#: ../../reference/lexical_analysis.rst:998 +#: ../../reference/lexical_analysis.rst:997 msgid "operators" msgstr "operators（運算子）" -#: ../../reference/lexical_analysis.rst:1015 +#: ../../reference/lexical_analysis.rst:1014 msgid "delimiters" msgstr "delimiters（分隔符號）" From 1f5e7447c916dc0932d6cae963a631a73ad8fb8a Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Thu, 15 Aug 2024 00:05:49 +0000 Subject: [PATCH 21/28] sync with cpython 9f153a2a --- library/enum.po | 140 ++++++++++++++++++++++++------------------------ 1 file changed, 70 insertions(+), 70 deletions(-) diff --git a/library/enum.po b/library/enum.po index 63e065d391..b359efa937 100644 --- a/library/enum.po +++ b/library/enum.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-15 00:03+0000\n" +"POT-Creation-Date: 2024-08-15 00:04+0000\n" "PO-Revision-Date: 2023-09-11 14:08+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -735,27 +735,27 @@ msgstr "回傳所有包含的非別名成員： ::" msgid "Returns number of members in flag::" msgstr "回傳旗標裡的成員數量： ::" -#: ../../library/enum.rst:565 +#: ../../library/enum.rst:567 msgid "Returns *True* if any members in flag, *False* otherwise::" msgstr "如果成員在旗標裡則回傳 *True*，否則回傳 *False*： ::" -#: ../../library/enum.rst:577 +#: ../../library/enum.rst:579 msgid "Returns current flag binary or'ed with other::" msgstr "回傳和 other 做 OR 過後的二進位旗標： ::" -#: ../../library/enum.rst:584 +#: ../../library/enum.rst:586 msgid "Returns current flag binary and'ed with other::" msgstr "回傳和 other 做 AND 過後的二進位旗標： ::" -#: ../../library/enum.rst:593 +#: ../../library/enum.rst:595 msgid "Returns current flag binary xor'ed with other::" msgstr "回傳和 other 做 XOR 過後的二進位旗標： ::" -#: ../../library/enum.rst:602 +#: ../../library/enum.rst:604 msgid "Returns all the flags in *type(self)* that are not in self::" msgstr "回傳所有在 *type(self)* 但不在 self 裡的旗標： ::" -#: ../../library/enum.rst:613 +#: ../../library/enum.rst:615 msgid "" "Function used to format any remaining unnamed numeric values. Default is " "the value's repr; common choices are :func:`hex` and :func:`oct`." @@ -763,17 +763,17 @@ msgstr "" "用來格式化任何剩下未命名數值的函式。預設是值的 repr，常見選擇是 :func:`hex` " "和 :func:`oct`。" -#: ../../library/enum.rst:618 +#: ../../library/enum.rst:620 msgid "" "Using :class:`auto` with :class:`Flag` results in integers that are powers " "of two, starting with ``1``." msgstr ":class:`Flag` 使用 :class:`auto` 會產生從 ``1`` 開始 2 的次方的整數。" -#: ../../library/enum.rst:621 +#: ../../library/enum.rst:623 msgid "The *repr()* of zero-valued flags has changed. It is now::" msgstr "值為 0 的旗標的 *repr()* 已改變。現在是： ::" -#: ../../library/enum.rst:629 +#: ../../library/enum.rst:631 msgid "" "*IntFlag* is the same as *Flag*, but its members are also integers and can " "be used anywhere that an integer can be used." @@ -781,38 +781,38 @@ msgstr "" "*IntFlag* 和 *Flag* 一樣，但其成員同時也是整數而可以被用在任何使用整數的地" "方。" -#: ../../library/enum.rst:643 +#: ../../library/enum.rst:645 msgid "" "If any integer operation is performed with an *IntFlag* member, the result " "is not an *IntFlag*::" msgstr "如果 *IntFlag* 成員經過任何整數運算，其結果不是 *IntFlag*： ::" -#: ../../library/enum.rst:649 +#: ../../library/enum.rst:651 msgid "If a *Flag* operation is performed with an *IntFlag* member and:" msgstr "如果 *IntFlag* 成員經過 *Flag* 操作且：" -#: ../../library/enum.rst:651 +#: ../../library/enum.rst:653 msgid "the result is a valid *IntFlag*: an *IntFlag* is returned" msgstr "結果是合法的 *IntFlag*：回傳 *IntFlag*" -#: ../../library/enum.rst:652 +#: ../../library/enum.rst:654 msgid "" "the result is not a valid *IntFlag*: the result depends on the " "*FlagBoundary* setting" msgstr "結果不是合法的 *IntFlag*：結果會根據 *FlagBoundary* 的設定" -#: ../../library/enum.rst:654 +#: ../../library/enum.rst:656 msgid "The *repr()* of unnamed zero-valued flags has changed. It is now:" msgstr "未命名且值為 0 的旗標的 *repr()* 已改變。現在是： ::" -#: ../../library/enum.rst:661 +#: ../../library/enum.rst:663 msgid "" "Using :class:`auto` with :class:`IntFlag` results in integers that are " "powers of two, starting with ``1``." msgstr "" ":class:`IntFlag` 使用 :class:`auto` 會產生從 ``1`` 開始 2 的次方的整數。" -#: ../../library/enum.rst:666 +#: ../../library/enum.rst:668 msgid "" ":meth:`~object.__str__` is now :meth:`!int.__str__` to better support the " "*replacement of existing constants* use-case. :meth:`~object.__format__` " @@ -822,7 +822,7 @@ msgstr "" "境，:meth:`~object.__str__` 現在會是 :meth:`!int.__str__`。為了同樣的理由，:" "meth:`~object.__format__` 已經是 :meth:`!int.__format__`。" -#: ../../library/enum.rst:670 +#: ../../library/enum.rst:672 msgid "" "Inversion of an :class:`!IntFlag` now returns a positive value that is the " "union of all flags not in the given flag, rather than a negative value. This " @@ -831,7 +831,7 @@ msgstr "" ":class:`!IntFlag` 的反轉 (inversion) 現在會回傳正值，該值是不在給定旗標的所有" "旗標聯集，而不是一個負值。這符合現有 :class:`Flag` 的行為。" -#: ../../library/enum.rst:676 +#: ../../library/enum.rst:678 msgid "" ":class:`!ReprEnum` uses the :meth:`repr() ` of :class:`Enum`, " "but the :class:`str() ` of the mixed-in data type:" @@ -839,15 +839,15 @@ msgstr "" ":class:`!ReprEnum` 使用 :class:`Enum` 的 :meth:`repr() `，但使" "用混合資料類型的 :class:`str() `：" -#: ../../library/enum.rst:679 +#: ../../library/enum.rst:681 msgid ":meth:`!int.__str__` for :class:`IntEnum` and :class:`IntFlag`" msgstr "對 :class:`IntEnum` 和 :class:`IntFlag` 是 :meth:`!int.__str__`" -#: ../../library/enum.rst:680 +#: ../../library/enum.rst:682 msgid ":meth:`!str.__str__` for :class:`StrEnum`" msgstr "對 :class:`StrEnum` 是 :meth:`!str.__str__`" -#: ../../library/enum.rst:682 +#: ../../library/enum.rst:684 msgid "" "Inherit from :class:`!ReprEnum` to keep the :class:`str() ` / :func:" "`format` of the mixed-in data type instead of using the :class:`Enum`-" @@ -856,7 +856,7 @@ msgstr "" "繼承 :class:`!ReprEnum` 來保留混合資料類型的 :class:`str() ` / :func:" "`format`，而不是使用 :class:`Enum` 預設的 :meth:`str() `。" -#: ../../library/enum.rst:691 +#: ../../library/enum.rst:693 msgid "" "*EnumCheck* contains the options used by the :func:`verify` decorator to " "ensure various constraints; failed constraints result in a :exc:`ValueError`." @@ -864,17 +864,17 @@ msgstr "" "*EnumCheck* 包含 :func:`verify` 裝飾器使用的選項，以確保多樣的限制，不符合限" "制會產生 :exc:`ValueError`。" -#: ../../library/enum.rst:696 +#: ../../library/enum.rst:698 msgid "Ensure that each value has only one name::" msgstr "確保每個值只有一個名稱： ::" -#: ../../library/enum.rst:712 +#: ../../library/enum.rst:714 msgid "" "Ensure that there are no missing values between the lowest-valued member and " "the highest-valued member::" msgstr "確保在最小值成員跟最大值成員間沒有缺少值： ::" -#: ../../library/enum.rst:727 +#: ../../library/enum.rst:729 msgid "" "Ensure that any flag groups/masks contain only named flags -- useful when " "values are specified instead of being generated by :func:`auto`::" @@ -882,35 +882,35 @@ msgstr "" "確保任何旗標群組 / 遮罩只包含命名旗標 -- 當值是用指定而不是透過 :func:`auto` " "產生時是很實用的： ::" -#: ../../library/enum.rst:744 +#: ../../library/enum.rst:746 msgid "" "CONTINUOUS and NAMED_FLAGS are designed to work with integer-valued members." msgstr "CONTINUOUS 和 NAMED_FLAGS 是設計用來運作在整數值的成員上。" -#: ../../library/enum.rst:750 +#: ../../library/enum.rst:752 msgid "" "*FlagBoundary* controls how out-of-range values are handled in *Flag* and " "its subclasses." msgstr "*FlagBoundary* 控制在 *Flag* 及其子類別中如何處理範圍外的值。" -#: ../../library/enum.rst:755 +#: ../../library/enum.rst:757 msgid "" "Out-of-range values cause a :exc:`ValueError` to be raised. This is the " "default for :class:`Flag`::" msgstr "範圍外的值會引發 :exc:`ValueError`。這是 :class:`Flag` 的預設行為： ::" -#: ../../library/enum.rst:773 +#: ../../library/enum.rst:775 msgid "" "Out-of-range values have invalid values removed, leaving a valid *Flag* " "value::" msgstr "範圍外的值會移除非法值，留下合法的 *Flag* 值： ::" -#: ../../library/enum.rst:787 +#: ../../library/enum.rst:789 msgid "" "Out-of-range values lose their *Flag* membership and revert to :class:`int`." msgstr "範圍外的值會失去它們的 *Flag* 成員資格且恢復成 :class:`int`。" -#: ../../library/enum.rst:800 +#: ../../library/enum.rst:802 msgid "" "Out-of-range values are kept, and the *Flag* membership is kept. This is the " "default for :class:`IntFlag`::" @@ -918,11 +918,11 @@ msgstr "" "範圍外的值會被保留，*Flag* 成員資格也會被保留。這是 :class:`IntFlag` 的預設行" "為： ::" -#: ../../library/enum.rst:817 +#: ../../library/enum.rst:819 msgid "Supported ``__dunder__`` names" msgstr "支援 ``__dunder__`` 名稱" -#: ../../library/enum.rst:819 +#: ../../library/enum.rst:821 msgid "" ":attr:`~EnumType.__members__` is a read-only ordered mapping of " "``member_name``:``member`` items. It is only available on the class." @@ -930,7 +930,7 @@ msgstr "" ":attr:`~EnumType.__members__` 是一個唯讀有序的\\ ``成員名稱``：``成員``\\ 項" "目的對映。只有在類別上可用。" -#: ../../library/enum.rst:822 +#: ../../library/enum.rst:824 msgid "" ":meth:`~Enum.__new__`, if specified, must create and return the enum " "members; it is also a very good idea to set the member's :attr:`!_value_` " @@ -940,26 +940,26 @@ msgstr "" "的 :attr:`!_value_` 也是一個很好的主意。一旦所有成員都建立之後就不會再被用" "到。" -#: ../../library/enum.rst:828 +#: ../../library/enum.rst:830 msgid "Supported ``_sunder_`` names" msgstr "支援 ``_sunder_`` 名稱" -#: ../../library/enum.rst:830 +#: ../../library/enum.rst:832 msgid ":attr:`~Enum._name_` -- name of the member" msgstr ":attr:`~Enum._name_` -- 成員名稱" -#: ../../library/enum.rst:831 +#: ../../library/enum.rst:833 msgid ":attr:`~Enum._value_` -- value of the member; can be set in ``__new__``" msgstr ":attr:`~Enum._value_` -- 成員的值；可以在 ``__new__`` 設定" -#: ../../library/enum.rst:832 +#: ../../library/enum.rst:834 msgid "" ":meth:`~Enum._missing_` -- a lookup function used when a value is not found; " "may be overridden" msgstr "" ":meth:`~Enum._missing_` -- 當值沒有被找到時會使用的查詢函式；可以被覆寫" -#: ../../library/enum.rst:834 +#: ../../library/enum.rst:836 msgid "" ":attr:`~Enum._ignore_` -- a list of names, either as a :class:`list` or a :" "class:`str`, that will not be transformed into members, and will be removed " @@ -968,7 +968,7 @@ msgstr "" ":attr:`~Enum._ignore_` -- 一個名稱的串列，可以是 :class:`list` 或 :class:" "`str`，它不會被轉換成成員，且在最後的類別上會被移除" -#: ../../library/enum.rst:837 +#: ../../library/enum.rst:839 msgid "" ":attr:`~Enum._order_` -- no longer used, kept for backward compatibility " "(class attribute, removed during class creation)" @@ -976,21 +976,21 @@ msgstr "" ":attr:`~Enum._order_` -- 不再被使用，僅為了向後相容而保留（類別屬性，在類別建" "立時移除）" -#: ../../library/enum.rst:839 +#: ../../library/enum.rst:841 msgid "" ":meth:`~Enum._generate_next_value_` -- used to get an appropriate value for " "an enum member; may be overridden" msgstr "" ":meth:`~Enum._generate_next_value_` -- 用來為列舉成員取得合適的值；可以被覆寫" -#: ../../library/enum.rst:844 +#: ../../library/enum.rst:846 msgid "" "For standard :class:`Enum` classes the next value chosen is the last value " "seen incremented by one." msgstr "" "對標準的 :class:`Enum` 類別來說，下一個被選擇的值是最後一個看見的值加一。" -#: ../../library/enum.rst:847 +#: ../../library/enum.rst:849 msgid "" "For :class:`Flag` classes the next value chosen will be the next highest " "power-of-two, regardless of the last value seen." @@ -998,19 +998,19 @@ msgstr "" "對 :class:`Flag` 類別來說，下一個被選擇的值是下一個最大的 2 的次方，不管最後" "一個看見的值是什麼。" -#: ../../library/enum.rst:850 +#: ../../library/enum.rst:852 msgid "``_missing_``, ``_order_``, ``_generate_next_value_``" msgstr "``_missing_``、``_order_``、``_generate_next_value_``" -#: ../../library/enum.rst:851 +#: ../../library/enum.rst:853 msgid "``_ignore_``" msgstr "``_ignore_``" -#: ../../library/enum.rst:856 +#: ../../library/enum.rst:858 msgid "Utilities and Decorators" msgstr "通用項目與裝飾器" -#: ../../library/enum.rst:860 +#: ../../library/enum.rst:862 msgid "" "*auto* can be used in place of a value. If used, the *Enum* machinery will " "call an *Enum*'s :meth:`~Enum._generate_next_value_` to get an appropriate " @@ -1026,16 +1026,16 @@ msgstr "" "2 的次方的數字；對 *StrEnum* 來說，是成員名稱的小寫版本。如果混用 *auto()* 和" "手動指定值的話要特別注意。" -#: ../../library/enum.rst:868 +#: ../../library/enum.rst:870 msgid "" "*auto* instances are only resolved when at the top level of an assignment:" msgstr "*auto* 實例只有在最上層的賦值時才會被解析：" -#: ../../library/enum.rst:870 +#: ../../library/enum.rst:872 msgid "``FIRST = auto()`` will work (auto() is replaced with ``1``);" msgstr "``FIRST = auto()`` 可以運作（auto() 會被取代成 ``1``）" -#: ../../library/enum.rst:871 +#: ../../library/enum.rst:873 msgid "" "``SECOND = auto(), -2`` will work (auto is replaced with ``2``, so ``2, -2`` " "is used to create the ``SECOND`` enum member;" @@ -1043,7 +1043,7 @@ msgstr "" "``SECOND = auto(), -2`` 可以運作（auto 會被取代成 ``2``, 因此 ``2, -2`` 會被" "用來建立列舉成員 ``SECOND``；" -#: ../../library/enum.rst:873 +#: ../../library/enum.rst:875 msgid "" "``THREE = [auto(), -3]`` will *not* work (``, -3`` is used to " "create the ``THREE`` enum member)" @@ -1051,19 +1051,19 @@ msgstr "" "``THREE = [auto(), -3]`` *無法*\\ 運作（\\ ``, -3`` 會被用來建立列" "舉成員 ``THREE``）" -#: ../../library/enum.rst:878 +#: ../../library/enum.rst:880 msgid "" "In prior versions, ``auto()`` had to be the only thing on the assignment " "line to work properly." msgstr "在之前的版本中，``auto()`` 必須是賦值行裡的唯一內容才能運作正確。" -#: ../../library/enum.rst:881 +#: ../../library/enum.rst:883 msgid "" "``_generate_next_value_`` can be overridden to customize the values used by " "*auto*." msgstr "可以覆寫 ``_generate_next_value_`` 來客製 *auto* 使用的值。" -#: ../../library/enum.rst:884 +#: ../../library/enum.rst:886 msgid "" "in 3.13 the default ``_generate_next_value_`` will always return the highest " "member value incremented by 1, and will fail if any member is an " @@ -1072,7 +1072,7 @@ msgstr "" "在 3.13 預設 ``_generate_next_value_`` 總是回傳最大的成員值加一，如果任何成員" "是不相容的類型就會失敗。" -#: ../../library/enum.rst:890 +#: ../../library/enum.rst:892 msgid "" "A decorator similar to the built-in *property*, but specifically for " "enumerations. It allows member attributes to have the same names as members " @@ -1081,7 +1081,7 @@ msgstr "" "和內建的 *property* 相似的裝飾器，但只專門針對列舉。它允許成員屬性和成員本身" "有相同名稱。" -#: ../../library/enum.rst:894 +#: ../../library/enum.rst:896 msgid "" "the *property* and the member must be defined in separate classes; for " "example, the *value* and *name* attributes are defined in the *Enum* class, " @@ -1091,7 +1091,7 @@ msgstr "" "*屬性*\\ 和成員必須定義在分開的類別裡；例如 *value* 和 *name* 屬性定義在 " "*Enum* 類別而 *Enum* 子類別可以定義成員名稱為 ``value`` 和 ``name``。" -#: ../../library/enum.rst:903 +#: ../../library/enum.rst:905 msgid "" "A :keyword:`class` decorator specifically for enumerations. It searches an " "enumeration's :attr:`~EnumType.__members__`, gathering any aliases it finds; " @@ -1101,7 +1101,7 @@ msgstr "" "__members__`，蒐集任何它找到的別名；如果有找到任何別名則引發 :exc:" "`ValueError` 並附上細節： ::" -#: ../../library/enum.rst:921 +#: ../../library/enum.rst:923 msgid "" "A :keyword:`class` decorator specifically for enumerations. Members from :" "class:`EnumCheck` are used to specify which constraints should be checked on " @@ -1110,15 +1110,15 @@ msgstr "" "專門針對列舉的 :keyword:`class` 裝飾器。使用 :class:`EnumCheck` 裡的成員來指" "定在裝飾的列舉上應該檢查什麼限制。" -#: ../../library/enum.rst:929 +#: ../../library/enum.rst:931 msgid "A decorator for use in enums: its target will become a member." msgstr "列舉所使用的裝飾器：其目標會變成成員。" -#: ../../library/enum.rst:935 +#: ../../library/enum.rst:937 msgid "A decorator for use in enums: its target will not become a member." msgstr "列舉所使用的裝飾器：其目標不會變成成員。" -#: ../../library/enum.rst:941 +#: ../../library/enum.rst:943 msgid "" "A decorator to change the :class:`str() ` and :func:`repr` of an enum " "to show its members as belonging to the module instead of its class. Should " @@ -1129,19 +1129,19 @@ msgstr "" "組而不是其類別。應該只有當列舉成員被匯出到模組的全域命名空間才使用（範例請參" "考 :class:`re.RegexFlag`）。" -#: ../../library/enum.rst:951 +#: ../../library/enum.rst:953 msgid "Return a list of all power-of-two integers contained in a flag *value*." msgstr "回傳在旗標\\ *值*\\ 中包含的所有 2 的次方的整數串列。" -#: ../../library/enum.rst:958 +#: ../../library/enum.rst:960 msgid "Notes" msgstr "備註" -#: ../../library/enum.rst:960 +#: ../../library/enum.rst:962 msgid ":class:`IntEnum`, :class:`StrEnum`, and :class:`IntFlag`" msgstr ":class:`IntEnum`、:class:`StrEnum` 及 :class:`IntFlag`" -#: ../../library/enum.rst:962 +#: ../../library/enum.rst:964 msgid "" "These three enum types are designed to be drop-in replacements for existing " "integer- and string-based values; as such, they have extra limitations:" @@ -1149,17 +1149,17 @@ msgstr "" "這三種列舉類型是設計來直接取代現有以整數及字串為基底的值；因此它們有額外的限" "制：" -#: ../../library/enum.rst:965 +#: ../../library/enum.rst:967 msgid "``__str__`` uses the value and not the name of the enum member" msgstr "``__str__`` 使用值而不是列舉成員的名稱" -#: ../../library/enum.rst:967 +#: ../../library/enum.rst:969 msgid "" "``__format__``, because it uses ``__str__``, will also use the value of the " "enum member instead of its name" msgstr "``__format__`` 因為使用 ``__str__``，也會使用值而不是列舉成員的名稱" -#: ../../library/enum.rst:970 +#: ../../library/enum.rst:972 msgid "" "If you do not need/want those limitations, you can either create your own " "base class by mixing in the ``int`` or ``str`` type yourself::" @@ -1167,7 +1167,7 @@ msgstr "" "如果你不需要或不想要這些限制，你可以透過混合 ``int`` 或 ``str`` 類型來建立自" "己的基礎類別： ::" -#: ../../library/enum.rst:977 +#: ../../library/enum.rst:979 msgid "or you can reassign the appropriate :meth:`str`, etc., in your enum::" msgstr "或者你也可以在你的列舉重新給定合適的 :meth:`str`： ::" From d71c63e8f47933d4d07fa14c60ee5bc1b0659557 Mon Sep 17 00:00:00 2001 From: Matt Wang Date: Sat, 17 Aug 2024 02:29:59 +0800 Subject: [PATCH 22/28] feat: add more translation from `deprecations` --- deprecations/c-api-pending-removal-in-3.14.po | 59 +- deprecations/c-api-pending-removal-in-3.15.po | 32 +- .../c-api-pending-removal-in-future.po | 45 +- deprecations/index.po | 161 ++++- deprecations/pending-removal-in-3.13.po | 87 +-- deprecations/pending-removal-in-3.14.po | 94 ++- deprecations/pending-removal-in-3.15.po | 40 +- deprecations/pending-removal-in-3.16.po | 8 +- whatsnew/3.11.po | 6 +- whatsnew/3.12.po | 612 +++++++++--------- whatsnew/3.7.po | 2 +- whatsnew/3.8.po | 2 +- whatsnew/3.9.po | 2 +- 13 files changed, 707 insertions(+), 443 deletions(-) diff --git a/deprecations/c-api-pending-removal-in-3.14.po b/deprecations/c-api-pending-removal-in-3.14.po index 7c5787b5d5..23ff68e87a 100644 --- a/deprecations/c-api-pending-removal-in-3.14.po +++ b/deprecations/c-api-pending-removal-in-3.14.po @@ -1,9 +1,7 @@ -# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # -#, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" @@ -18,41 +16,47 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:2 +#: ../../deprecations/pending-removal-in-3.14.rst:2 msgid "Pending Removal in Python 3.14" -msgstr "" +msgstr "Python 3.14 中待移除的項目" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:4 msgid "" "The ``ma_version_tag`` field in :c:type:`PyDictObject` for extension modules " "(:pep:`699`; :gh:`101193`)." msgstr "" +":c:type:`PyDictObject` 中的 ``ma_version_tag`` 欄位，用於擴充模組 (:pep:" +"`699`；:gh:`101193`)。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:7 msgid "" "Creating :c:data:`immutable types ` with mutable " "bases (:gh:`95388`)." msgstr "" +"使用可變基底建立\\ :c:data:`不可變型別 ` (:gh:" +"`95388`)。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:10 msgid "" "Functions to configure Python's initialization, deprecated in Python 3.11:" -msgstr "" +msgstr "設定 Python 初始化的函式，Python 3.11 中已被棄用：" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:12 msgid "``PySys_SetArgvEx()``: set :c:member:`PyConfig.argv` instead." -msgstr "" +msgstr "``PySys_SetArgvEx()``：請改以 :c:member:`PyConfig.argv` 設定。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:13 msgid "``PySys_SetArgv()``: set :c:member:`PyConfig.argv` instead." -msgstr "" +msgstr "``PySys_SetArgv()``：請改以 :c:member:`PyConfig.argv` 設定。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:14 msgid "``Py_SetProgramName()``: set :c:member:`PyConfig.program_name` instead." msgstr "" +"``Py_SetProgramName()``：請改以 :c:member:`PyConfig.program_name` 設定。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:15 msgid "``Py_SetPythonHome()``: set :c:member:`PyConfig.home` instead." -msgstr "" +msgstr "``Py_SetPythonHome()``：請改以 :c:member:`PyConfig.home` 設定。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:17 #: ../../deprecations/c-api-pending-removal-in-3.14.rst:45 @@ -60,118 +64,143 @@ msgid "" "The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" "`PyConfig` instead." msgstr "" +":c:func:`Py_InitializeFromConfig` API 應該與 :c:type:`PyConfig` 一起使用。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:20 msgid "Global configuration variables:" -msgstr "" +msgstr "全域設定變數：" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:22 msgid ":c:var:`Py_DebugFlag`: use :c:member:`PyConfig.parser_debug` instead." -msgstr "" +msgstr ":c:var:`Py_DebugFlag`：請改用 :c:member:`PyConfig.parser_debug`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:23 msgid ":c:var:`Py_VerboseFlag`: use :c:member:`PyConfig.verbose` instead." -msgstr "" +msgstr ":c:var:`Py_VerboseFlag`：請改用 :c:member:`PyConfig.verbose`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:24 msgid ":c:var:`Py_QuietFlag`: use :c:member:`PyConfig.quiet` instead." -msgstr "" +msgstr ":c:var:`Py_QuietFlag`：請改用 :c:member:`PyConfig.quiet`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:25 msgid "" ":c:var:`Py_InteractiveFlag`: use :c:member:`PyConfig.interactive` instead." -msgstr "" +msgstr ":c:var:`Py_InteractiveFlag`：請改用 :c:member:`PyConfig.interactive`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:26 msgid ":c:var:`Py_InspectFlag`: use :c:member:`PyConfig.inspect` instead." -msgstr "" +msgstr ":c:var:`Py_InspectFlag`：請改用 :c:member:`PyConfig.inspect`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:27 msgid "" ":c:var:`Py_OptimizeFlag`: use :c:member:`PyConfig.optimization_level` " "instead." msgstr "" +":c:var:`Py_OptimizeFlag`：請改用 :c:member:`PyConfig.optimization_level`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:28 msgid ":c:var:`Py_NoSiteFlag`: use :c:member:`PyConfig.site_import` instead." -msgstr "" +msgstr ":c:var:`Py_NoSiteFlag`：請改用 :c:member:`PyConfig.site_import`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:29 msgid "" ":c:var:`Py_BytesWarningFlag`: use :c:member:`PyConfig.bytes_warning` instead." msgstr "" +":c:var:`Py_BytesWarningFlag`：請改用 :c:member:`PyConfig.bytes_warning`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:30 msgid "" ":c:var:`Py_FrozenFlag`: use :c:member:`PyConfig.pathconfig_warnings` instead." msgstr "" +":c:var:`Py_FrozenFlag`：請改用 :c:member:`PyConfig.pathconfig_warnings`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:31 msgid "" ":c:var:`Py_IgnoreEnvironmentFlag`: use :c:member:`PyConfig.use_environment` " "instead." msgstr "" +":c:var:`Py_IgnoreEnvironmentFlag`：請改用 :c:member:`PyConfig." +"use_environment`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:32 msgid "" ":c:var:`Py_DontWriteBytecodeFlag`: use :c:member:`PyConfig.write_bytecode` " "instead." msgstr "" +":c:var:`Py_DontWriteBytecodeFlag`：請改用 :c:member:`PyConfig." +"write_bytecode`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:33 msgid "" ":c:var:`Py_NoUserSiteDirectory`: use :c:member:`PyConfig." "user_site_directory` instead." msgstr "" +":c:var:`Py_NoUserSiteDirectory`：請改用 :c:member:`PyConfig." +"user_site_directory`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:34 msgid "" ":c:var:`Py_UnbufferedStdioFlag`: use :c:member:`PyConfig.buffered_stdio` " "instead." msgstr "" +":c:var:`Py_UnbufferedStdioFlag`：請改用 :c:member:`PyConfig.buffered_stdio`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:35 msgid "" ":c:var:`Py_HashRandomizationFlag`: use :c:member:`PyConfig.use_hash_seed` " "and :c:member:`PyConfig.hash_seed` instead." msgstr "" +":c:var:`Py_HashRandomizationFlag`：請改用 :c:member:`PyConfig.use_hash_seed` " +"和 :c:member:`PyConfig.hash_seed`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:37 msgid ":c:var:`Py_IsolatedFlag`: use :c:member:`PyConfig.isolated` instead." -msgstr "" +msgstr ":c:var:`Py_IsolatedFlag`：請改用 :c:member:`PyConfig.isolated`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:38 msgid "" ":c:var:`Py_LegacyWindowsFSEncodingFlag`: use :c:member:`PyPreConfig." "legacy_windows_fs_encoding` instead." msgstr "" +":c:var:`Py_LegacyWindowsFSEncodingFlag`：請改用 :c:member:`PyPreConfig." +"legacy_windows_fs_encoding`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:39 msgid "" ":c:var:`Py_LegacyWindowsStdioFlag`: use :c:member:`PyConfig." "legacy_windows_stdio` instead." msgstr "" +":c:var:`Py_LegacyWindowsStdioFlag`：請改用 :c:member:`PyConfig." +"legacy_windows_stdio`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:40 msgid "" ":c:var:`!Py_FileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding` instead." msgstr "" +":c:var:`!Py_FileSystemDefaultEncoding`：請改用 :c:member:`PyConfig." +"filesystem_encoding`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:41 msgid "" ":c:var:`!Py_HasFileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding` instead." msgstr "" +":c:var:`!Py_HasFileSystemDefaultEncoding`：請改用 :c:member:`PyConfig." +"filesystem_encoding`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:42 msgid "" ":c:var:`!Py_FileSystemDefaultEncodeErrors`: use :c:member:`PyConfig." "filesystem_errors` instead." msgstr "" +":c:var:`!Py_FileSystemDefaultEncodeErrors`：請改用 :c:member:`PyConfig." +"filesystem_errors`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:43 msgid "" ":c:var:`!Py_UTF8Mode`: use :c:member:`PyPreConfig.utf8_mode` instead. (see :" "c:func:`Py_PreInitialize`)" msgstr "" +":c:var:`!Py_UTF8Mode`：請改用 :c:member:`PyPreConfig.utf8_mode`。（請見 :c:" +"func:`Py_PreInitialize`）" diff --git a/deprecations/c-api-pending-removal-in-3.15.po b/deprecations/c-api-pending-removal-in-3.15.po index 173866a164..02e27cbbcc 100644 --- a/deprecations/c-api-pending-removal-in-3.15.po +++ b/deprecations/c-api-pending-removal-in-3.15.po @@ -3,7 +3,6 @@ # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # -#, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" @@ -18,68 +17,75 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:2 +#: ../../deprecations/pending-removal-in-3.15.rst:2 msgid "Pending Removal in Python 3.15" -msgstr "" +msgstr "Python 3.15 中待移除的項目" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:4 msgid "The bundled copy of ``libmpdecimal``." -msgstr "" +msgstr "``libmpdecimal`` 的打包副本 (bundled copy)。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:5 msgid "" ":c:func:`PyImport_ImportModuleNoBlock`: use :c:func:`PyImport_ImportModule` " "instead." msgstr "" +":c:func:`PyImport_ImportModuleNoBlock`：請改用 :c:func:" +"`PyImport_ImportModule`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:6 msgid "" ":c:func:`PyWeakref_GET_OBJECT`: use :c:func:`!PyWeakref_GetRef` instead." -msgstr "" +msgstr ":c:func:`PyWeakref_GET_OBJECT`：請改用 :c:func:`!PyWeakref_GetRef`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:7 msgid ":c:func:`PyWeakref_GetObject`: use :c:func:`!PyWeakref_GetRef` instead." -msgstr "" +msgstr ":c:func:`PyWeakref_GetObject`：請改用 :c:func:`!PyWeakref_GetRef`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:8 msgid ":c:type:`!Py_UNICODE_WIDE` type: use :c:type:`wchar_t` instead." -msgstr "" +msgstr ":c:type:`!Py_UNICODE_WIDE` type：請改用 :c:type:`wchar_t`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:9 msgid ":c:type:`Py_UNICODE` type: use :c:type:`wchar_t` instead." -msgstr "" +msgstr ":c:type:`Py_UNICODE` type：請改用 :c:type:`wchar_t`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:10 msgid "Python initialization functions:" -msgstr "" +msgstr "Python 初始化函式：" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:12 msgid "" ":c:func:`PySys_ResetWarnOptions`: clear :data:`sys.warnoptions` and :data:`!" "warnings.filters` instead." msgstr "" +":c:func:`PySys_ResetWarnOptions`：請改為清除 :data:`sys.warnoptions` 和 :" +"data:`!warnings.filters`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:14 msgid ":c:func:`Py_GetExecPrefix`: get :data:`sys.exec_prefix` instead." -msgstr "" +msgstr ":c:func:`Py_GetExecPrefix`：請改用 :data:`sys.exec_prefix`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:15 msgid ":c:func:`Py_GetPath`: get :data:`sys.path` instead." -msgstr "" +msgstr ":c:func:`Py_GetPath`：請改用 :data:`sys.path`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:16 msgid ":c:func:`Py_GetPrefix`: get :data:`sys.prefix` instead." -msgstr "" +msgstr ":c:func:`Py_GetPrefix`：請改用 :data:`sys.prefix`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:17 msgid ":c:func:`Py_GetProgramFullPath`: get :data:`sys.executable` instead." -msgstr "" +msgstr ":c:func:`Py_GetProgramFullPath`：請改用 :data:`sys.executable`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:18 msgid ":c:func:`Py_GetProgramName`: get :data:`sys.executable` instead." -msgstr "" +msgstr ":c:func:`Py_GetProgramName`：請改用 :data:`sys.executable`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:19 msgid "" ":c:func:`Py_GetPythonHome`: get :c:member:`PyConfig.home` or the :envvar:" "`PYTHONHOME` environment variable instead." msgstr "" +":c:func:`Py_GetPythonHome`：請改用 :c:member:`PyConfig.home` 或 :envvar:" +"`PYTHONHOME` 環境變數。" diff --git a/deprecations/c-api-pending-removal-in-future.po b/deprecations/c-api-pending-removal-in-future.po index c0623d6206..bab38ba810 100644 --- a/deprecations/c-api-pending-removal-in-future.po +++ b/deprecations/c-api-pending-removal-in-future.po @@ -3,7 +3,6 @@ # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # -#, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" @@ -18,122 +17,136 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #: ../../deprecations/c-api-pending-removal-in-future.rst:2 +#: ../../deprecations/pending-removal-in-future.rst:2 msgid "Pending Removal in Future Versions" -msgstr "" +msgstr "未來版本中的待移除項目" #: ../../deprecations/c-api-pending-removal-in-future.rst:4 msgid "" "The following APIs are deprecated and will be removed, although there is " "currently no date scheduled for their removal." -msgstr "" +msgstr "下列 API 已被棄用並將會被移除，不過目前尚未訂定移除日期。" #: ../../deprecations/c-api-pending-removal-in-future.rst:7 msgid ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`: unneeded since Python 3.8." -msgstr "" +msgstr ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`：自 Python 3.8 起不再需要" #: ../../deprecations/c-api-pending-removal-in-future.rst:8 msgid ":c:func:`PyErr_Fetch`: use :c:func:`PyErr_GetRaisedException` instead." -msgstr "" +msgstr ":c:func:`PyErr_Fetch`：請改用 :c:func:`PyErr_GetRaisedException`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:9 msgid "" ":c:func:`PyErr_NormalizeException`: use :c:func:`PyErr_GetRaisedException` " "instead." msgstr "" +":c:func:`PyErr_NormalizeException`：請改用 :c:func:" +"`PyErr_GetRaisedException`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:10 msgid "" ":c:func:`PyErr_Restore`: use :c:func:`PyErr_SetRaisedException` instead." -msgstr "" +msgstr ":c:func:`PyErr_Restore`：請改用 :c:func:`PyErr_SetRaisedException`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:11 msgid "" ":c:func:`PyModule_GetFilename`: use :c:func:`PyModule_GetFilenameObject` " "instead." msgstr "" +":c:func:`PyModule_GetFilename`：請改用 :c:func:`PyModule_GetFilenameObject`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:12 msgid ":c:func:`PyOS_AfterFork`: use :c:func:`PyOS_AfterFork_Child` instead." -msgstr "" +msgstr ":c:func:`PyOS_AfterFork`：請改用 :c:func:`PyOS_AfterFork_Child`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:13 msgid "" ":c:func:`PySlice_GetIndicesEx`: use :c:func:`PySlice_Unpack` and :c:func:" "`PySlice_AdjustIndices` instead." msgstr "" +":c:func:`PySlice_GetIndicesEx`：請改用 :c:func:`PySlice_Unpack` 和 :c:func:" +"`PySlice_AdjustIndices`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:14 msgid "" ":c:func:`!PyUnicode_AsDecodedObject`: use :c:func:`PyCodec_Decode` instead." msgstr "" +":c:func:`!PyUnicode_AsDecodedObject`：請改用 :c:func:`PyCodec_Decode`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:15 msgid "" ":c:func:`!PyUnicode_AsDecodedUnicode`: use :c:func:`PyCodec_Decode` instead." msgstr "" +":c:func:`!PyUnicode_AsDecodedUnicode`：請改用 :c:func:`PyCodec_Decode`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:16 msgid "" ":c:func:`!PyUnicode_AsEncodedObject`: use :c:func:`PyCodec_Encode` instead." msgstr "" +":c:func:`!PyUnicode_AsEncodedObject`：請改用 :c:func:`PyCodec_Encode`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:17 msgid "" ":c:func:`!PyUnicode_AsEncodedUnicode`: use :c:func:`PyCodec_Encode` instead." msgstr "" +":c:func:`!PyUnicode_AsEncodedUnicode`：請改用 :c:func:`PyCodec_Encode`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:18 msgid ":c:func:`PyUnicode_READY`: unneeded since Python 3.12" -msgstr "" +msgstr ":c:func:`PyUnicode_READY`：自 Python 3.12 起不再需要" #: ../../deprecations/c-api-pending-removal-in-future.rst:19 msgid ":c:func:`!PyErr_Display`: use :c:func:`PyErr_DisplayException` instead." -msgstr "" +msgstr ":c:func:`!PyErr_Display`：請改用 :c:func:`PyErr_DisplayException`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:20 msgid "" ":c:func:`!_PyErr_ChainExceptions`: use ``_PyErr_ChainExceptions1`` instead." msgstr "" +":c:func:`!_PyErr_ChainExceptions`：請改用 ``_PyErr_ChainExceptions1``。" #: ../../deprecations/c-api-pending-removal-in-future.rst:21 msgid "" ":c:member:`!PyBytesObject.ob_shash` member: call :c:func:`PyObject_Hash` " "instead." msgstr "" +":c:member:`!PyBytesObject.ob_shash` 成員：請改為呼叫 :c:func:" +"`PyObject_Hash`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:23 msgid ":c:member:`!PyDictObject.ma_version_tag` member." -msgstr "" +msgstr ":c:member:`!PyDictObject.ma_version_tag` 成員。" #: ../../deprecations/c-api-pending-removal-in-future.rst:24 msgid "Thread Local Storage (TLS) API:" -msgstr "" +msgstr "執行緒局部儲存 (Thread Local Storage, TLS) API：" #: ../../deprecations/c-api-pending-removal-in-future.rst:26 msgid "" ":c:func:`PyThread_create_key`: use :c:func:`PyThread_tss_alloc` instead." -msgstr "" +msgstr ":c:func:`PyThread_create_key`：請改用 :c:func:`PyThread_tss_alloc`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:27 msgid ":c:func:`PyThread_delete_key`: use :c:func:`PyThread_tss_free` instead." -msgstr "" +msgstr ":c:func:`PyThread_delete_key`：請改用 :c:func:`PyThread_tss_free`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:28 msgid "" ":c:func:`PyThread_set_key_value`: use :c:func:`PyThread_tss_set` instead." -msgstr "" +msgstr ":c:func:`PyThread_set_key_value`：請改用 :c:func:`PyThread_tss_set`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:29 msgid "" ":c:func:`PyThread_get_key_value`: use :c:func:`PyThread_tss_get` instead." -msgstr "" +msgstr ":c:func:`PyThread_get_key_value`：請改用 :c:func:`PyThread_tss_get`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:30 msgid "" ":c:func:`PyThread_delete_key_value`: use :c:func:`PyThread_tss_delete` " "instead." msgstr "" +":c:func:`PyThread_delete_key_value`：請改用 :c:func:`PyThread_tss_delete`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:31 msgid ":c:func:`PyThread_ReInitTLS`: unneeded since Python 3.7." -msgstr "" +msgstr ":c:func:`PyThread_ReInitTLS`：自 Python 3.7 起不再需要。" diff --git a/deprecations/index.po b/deprecations/index.po index d1912b292a..1908e5762c 100644 --- a/deprecations/index.po +++ b/deprecations/index.po @@ -1,4 +1,3 @@ -# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. @@ -191,6 +190,9 @@ msgid "" "resources: Migrating from Legacy `_ (:gh:`106531`)" msgstr "" +"請改用 :func:`importlib.resources.files()`。請參閱 `importlib-resources: " +"Migrating from Legacy `_ (:gh:`106531`)" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:2 #: ../../deprecations/pending-removal-in-3.14.rst:2 @@ -203,6 +205,9 @@ msgid "" "argparse.BooleanOptionalAction` are deprecated and will be removed in 3.14. " "(Contributed by Nikita Sobolev in :gh:`92248`.)" msgstr "" +":mod:`argparse`：:class:`!argparse.BooleanOptionalAction` 的 *type*、" +"*choices* 和 *metavar* 參數已被棄用，將在 3.14 中移除。 (由 Nikita Sobolev " +"於 :gh:`92248` 貢獻。)" #: ../../deprecations/pending-removal-in-3.14.rst:9 msgid "" @@ -210,6 +215,8 @@ msgid "" "since Python 3.8, now cause a :exc:`DeprecationWarning` to be emitted at " "runtime when they are accessed or used, and will be removed in Python 3.14:" msgstr "" +":mod:`ast`：自 Python 3.8 起，下列功能已在文件中被棄用，現在在存取或使用時會" +"於 runtime 發出 :exc:`DeprecationWarning`，並將在 Python 3.14 中移除：" #: ../../deprecations/pending-removal-in-3.14.rst:13 msgid ":class:`!ast.Num`" @@ -236,7 +243,7 @@ msgid "" "Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka in :gh:" "`90953`.)" msgstr "" -"請改用 :class:`ast.Constant`。（由 Serhiy Storchaka 貢獻於 :gh:`90953`。）" +"請改用 :class:`ast.Constant`。（由 Serhiy Storchaka 於 :gh:`90953` 貢獻。）" #: ../../deprecations/pending-removal-in-3.14.rst:22 msgid ":mod:`asyncio`:" @@ -249,6 +256,10 @@ msgid "" "class:`~asyncio.SafeChildWatcher` are deprecated and will be removed in " "Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" +"已棄用並將在 Python 3.14 中移除的 child watcher 類別：:class:`~asyncio." +"MultiLoopChildWatcher`、:class:`~asyncio.FastChildWatcher`、:class:`~asyncio." +"AbstractChildWatcher` 和 :class:`~asyncio.SafeChildWatcher`。 (由 Kumar " +"Aditya 於 :gh:`94597` 貢獻。)" #: ../../deprecations/pending-removal-in-3.14.rst:30 msgid "" @@ -257,6 +268,10 @@ msgid "" "AbstractEventLoopPolicy.get_child_watcher` are deprecated and will be " "removed in Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" +":func:`asyncio.set_child_watcher`、:func:`asyncio.get_child_watcher`、:meth:" +"`asyncio.AbstractEventLoopPolicy.set_child_watcher` 和 :meth:`asyncio." +"AbstractEventLoopPolicy.get_child_watcher` 已被棄用並將在 Python 3.14 中移" +"除。（由 Kumar Aditya 於 :gh:`94597` 貢獻。）" #: ../../deprecations/pending-removal-in-3.14.rst:36 msgid "" @@ -265,6 +280,9 @@ msgid "" "and it decides to create one. (Contributed by Serhiy Storchaka and Guido van " "Rossum in :gh:`100160`.)" msgstr "" +"預設事件迴圈策略的 :meth:`~asyncio.get_event_loop` 方法現在會在沒有設定目前事" +"件迴圈且決定建立一個時發出 :exc:`DeprecationWarning`。 (由 Serhiy Storchaka " +"和 Guido van Rossum 於 :gh:`100160` 貢獻。)" #: ../../deprecations/pending-removal-in-3.14.rst:41 msgid "" @@ -273,18 +291,26 @@ msgid "" "typing, prefer a union, like ``bytes | bytearray``, or :class:`collections." "abc.Buffer`. (Contributed by Shantanu Jain in :gh:`91896`.)" msgstr "" +":mod:`collections.abc`：已棄用 :class:`~collections.abc.ByteString`。請改用 :" +"class:`!Sequence` 或 :class:`~collections.abc.Buffer`。在 typing 中使用時，請" +"改用聯集，如 ``bytes | bytearray``，或 :class:`collections.abc.Buffer`。（由 " +"Shantanu Jain 於 :gh:`91896` 貢獻。）" #: ../../deprecations/pending-removal-in-3.14.rst:47 msgid "" ":mod:`email`: Deprecated the *isdst* parameter in :func:`email.utils." "localtime`. (Contributed by Alan Williams in :gh:`72346`.)" msgstr "" +":mod:`email`：已棄用 :func:`email.utils.localtime` 中的 *isdst* 參數。（由 " +"Alan Williams 於 :gh:`72346` 貢獻。）" #: ../../deprecations/pending-removal-in-3.14.rst:50 msgid "" ":mod:`importlib`: ``__package__`` and ``__cached__`` will cease to be set or " "taken into consideration by the import system (:gh:`97879`)." msgstr "" +":mod:`importlib`：``__package__`` 和 ``__cached__`` 將不再被設定或被 import " +"系統考慮。 (:gh:`97879`)" #: ../../deprecations/pending-removal-in-3.14.rst:53 msgid ":mod:`importlib.abc` deprecated classes:" @@ -325,6 +351,9 @@ msgid "" "removed in 3.14 for a significant reduction in code volume and maintenance " "burden. (Contributed by Raymond Hettinger in :gh:`101588`.)" msgstr "" +":mod:`itertools` 有不以文件記錄、效率低下、過去常有 bug 且不一致的 copy、" +"deepcopy 和 pickle 操作支援。將在 3.14 中移除以大幅減少程式碼量和維護負擔。 " +"(由 Raymond Hettinger 於 :gh:`101588` 貢獻。)" #: ../../deprecations/pending-removal-in-3.14.rst:72 msgid "" @@ -336,12 +365,20 @@ msgid "" "set_start_method` APIs to explicitly specify when your code *requires* " "``'fork'``. See :ref:`multiprocessing-start-methods`." msgstr "" +":mod:`multiprocessing`：預設的啟動方法將在 Linux、BSD 和其他非 macOS POSIX 平" +"台上更改為更安全的 方法，目前 ``'fork'`` 是預設值 (:gh:`84559`)。對此增加一" +"個 runtime 警告被認為太過擾人，因為 大多數程式碼不會在意。請使用 :func:" +"`~multiprocessing.get_context` 或 :func:`~multiprocessing.set_start_method` " +"API 來明確指定你的程式碼何時\\ *需要* ``'fork'``。請參閱 :ref:" +"`multiprocessing-start-methods`。" #: ../../deprecations/pending-removal-in-3.14.rst:80 msgid "" ":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` and :meth:`~pathlib." "PurePath.relative_to`: passing additional arguments is deprecated." msgstr "" +":mod:`pathlib`：已棄用 :meth:`~pathlib.PurePath.is_relative_to` 和 :meth:" +"`~pathlib.PurePath.relative_to`：額外引數的傳遞已被棄用。" #: ../../deprecations/pending-removal-in-3.14.rst:84 msgid "" @@ -349,6 +386,9 @@ msgid "" "now raise :exc:`DeprecationWarning`; use :func:`importlib.util.find_spec` " "instead. (Contributed by Nikita Sobolev in :gh:`97850`.)" msgstr "" +":mod:`pkgutil`：:func:`~pkgutil.find_loader` 和 :func:`~pkgutil.get_loader` " +"現在會引發 :exc:`DeprecationWarning`；請改用 :func:`importlib.util." +"find_spec`。 (由 Nikita Sobolev 於 :gh:`97850` 貢獻。)" #: ../../deprecations/pending-removal-in-3.14.rst:89 msgid ":mod:`pty`:" @@ -376,12 +416,17 @@ msgid "" "ref:`named placeholders ` are used and *parameters* is " "a sequence instead of a :class:`dict`." msgstr "" +":meth:`~sqlite3.Cursor.execute` 和 :meth:`~sqlite3.Cursor.executemany`，如果" +"使用 :ref:`named placeholders ` 且 *parameters* 是序列" +"而不是 :class:`dict`。" #: ../../deprecations/pending-removal-in-3.14.rst:102 msgid "" "date and datetime adapter, date and timestamp converter: see the :mod:" "`sqlite3` documentation for suggested replacement recipes." msgstr "" +"date 和 datetime 的適配器 (adapter)、date 和 timestamp 轉換器 (converter)：請" +"參閱 :mod:`sqlite3` 文件以獲得建議的替代方案。" #: ../../deprecations/pending-removal-in-3.14.rst:105 msgid "" @@ -390,12 +435,18 @@ msgid "" "but it only got a proper :exc:`DeprecationWarning` in 3.12. May be removed " "in 3.14. (Contributed by Nikita Sobolev in :gh:`101866`.)" msgstr "" +":class:`types.CodeType`：自 3.10 起，存取 :attr:`~codeobject.co_lnotab` 已" +"在 :pep:`626` 中被棄用，並計劃在 3.12 中移除，但只在 3.12 中於適當時發出 :" +"exc:`DeprecationWarning`。可能在 3.14 中移除。（由 Nikita Sobolev 於 :gh:" +"`101866` 貢獻。）" #: ../../deprecations/pending-removal-in-3.14.rst:112 msgid "" ":mod:`typing`: :class:`~typing.ByteString`, deprecated since Python 3.9, now " "causes a :exc:`DeprecationWarning` to be emitted when it is used." msgstr "" +":mod:`typing`：自 Python 3.9 起已被棄用的 :class:`~typing.ByteString` 現在在" +"使用時會發出 :exc:`DeprecationWarning`。" #: ../../deprecations/pending-removal-in-3.14.rst:115 msgid "" @@ -403,6 +454,8 @@ msgid "" "intended to be a public API. (Contributed by Gregory P. Smith in :gh:" "`88168`.)" msgstr "" +":mod:`urllib`：:class:`!urllib.parse.Quoter` 已被棄用：它並非預期的公開 API。" +"(由 Gregory P. Smith 於 :gh:`88168` 貢獻。)" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:2 #: ../../deprecations/pending-removal-in-3.15.rst:2 @@ -416,6 +469,9 @@ msgid "" "rarely used. No direct replacement exists. *Anything* is better than CGI " "to interface a web server with a request handler." msgstr "" +":class:`http.server.CGIHTTPRequestHandler` 將會被移除，連同其相關的 ``--" +"cgi`` 旗標到 ``python -m http.server``。它已經過時且很少被使用。沒有直接的替" +"代方案。*任何東西*\\ 都比 CGI 更好的來介接一個帶有請求處理器的網頁伺服器。" #: ../../deprecations/pending-removal-in-3.15.rst:9 msgid "" @@ -425,6 +481,10 @@ msgid "" "func:`locale.getencoding()` and :func:`locale.getlocale()` instead. " "(Contributed by Hugo van Kemenade in :gh:`111187`.)" msgstr "" +":class:`locale`：:func:`locale.getdefaultlocale` 已在 Python 3.11 中被棄用，" +"原本計劃在 Python 3.13 中移除 (:gh:`90817`)，但被延後至 Python 3.15。請改用 :" +"func:`locale.setlocale()`、:func:`locale.getencoding()` 和 :func:`locale." +"getlocale()`。 (由 Hugo van Kemenade 於 :gh:`111187` 貢獻。)" #: ../../deprecations/pending-removal-in-3.15.rst:16 msgid "" @@ -432,6 +492,9 @@ msgid "" "scheduled for removal in Python 3.15. From Python 3.13 onwards, use ``os." "path.isreserved`` to detect reserved paths on Windows." msgstr "" +":mod:`pathlib`：:meth:`pathlib.PurePath.is_reserved` 已被棄用並計劃在 Python " +"3.15 中移除。從 Python 3.13 開始，請用 ``os.path.isreserved`` 來偵測 Windows " +"上的保留路徑。" #: ../../deprecations/pending-removal-in-3.15.rst:21 msgid "" @@ -439,6 +502,9 @@ msgid "" "removed in 3.15. It was largely untested, had a confusing API, and was only " "useful for Jython support. (Contributed by Nikita Sobolev in :gh:`116349`.)" msgstr "" +":mod:`platform`：:func:`~platform.java_ver` 已被棄用並將在 3.15 中移除。它幾" +"乎沒有被測試過，API 令人困惑並且只對 Jython 支援有用。 (由 Nikita Sobolev " +"於 :gh:`116349` 貢獻。)" #: ../../deprecations/pending-removal-in-3.15.rst:27 msgid "" @@ -448,6 +514,10 @@ msgid "" "will be removed from :func:`threading.RLock` in Python 3.15. (Contributed by " "Nikita Sobolev in :gh:`102029`.)" msgstr "" +":mod:`threading`：對 :func:`threading.RLock` 傳遞任何引數現在已被棄用。C 版本" +"允許任意數量的引數和關鍵字引數，但它們會被忽略。Python 版本不允許任何引數。所" +"有引數將在 Python 3.15 中從 :func:`threading.RLock` 中移除。 (由 Nikita " +"Sobolev 於 :gh:`102029` 貢獻。)" #: ../../deprecations/pending-removal-in-3.15.rst:34 msgid ":class:`typing.NamedTuple`:" @@ -460,6 +530,9 @@ msgid "" "disallowed in 3.15. Use the class-based syntax or the functional syntax " "instead." msgstr "" +"用於建立 :class:`!NamedTuple` 類別的未以文件記錄之關鍵字引數語法 (``NT = " +"NamedTuple(\"NT\", x=int)``) 已棄用，並將在 3.15 中被禁止。請改用基於類別的語" +"法或函式語法 (functional syntax)。" #: ../../deprecations/pending-removal-in-3.15.rst:40 msgid "" @@ -471,6 +544,11 @@ msgid "" "fields, use ``class NT(NamedTuple): pass`` or ``NT = NamedTuple(\"NT\", " "[])``." msgstr "" +"當使用函式語法來建立 :class:`!NamedTuple` 類別時，沒將值傳遞給 *fields* 參數" +"的方式 (``NT = NamedTuple(\"NT\")``) 已被棄用，將 ``None`` 傳遞給 *fields* 參" +"數（``NT = NamedTuple(\"NT\", None)``）也已被棄用。這兩者將在 Python 3.15 中" +"會被禁止。要建立一個沒有欄位的 :class:`!NamedTuple` 類別，請使用 ``class " +"NT(NamedTuple): pass`` 或 ``NT = NamedTuple(\"NT\", [])``。" #: ../../deprecations/pending-removal-in-3.15.rst:47 msgid "" @@ -481,6 +559,12 @@ msgid "" "be disallowed in Python 3.15. To create a :class:`!TypedDict` class with 0 " "fields, use ``class TD(TypedDict): pass`` or ``TD = TypedDict(\"TD\", {})``." msgstr "" +":class:`typing.TypedDict`：當使用函式語法來建立 :class:`!TypedDict` 類別時，" +"沒將值傳遞給 *fields* 參數的方式（``TD = TypedDict(\"TD\")``）已被棄用，將 " +"``None`` 傳遞給 *fields* 參數（``TD = TypedDict(\"TD\", None)``）也已被棄用。" +"這兩者將在 Python 3.15 中會被禁止。要建立一個沒有欄位的 :class:`!TypedDict` " +"類別，請使用 ``class TD(TypedDict): pass`` 或 ``TD = TypedDict(\"TD\", " +"{})``。" #: ../../deprecations/pending-removal-in-3.15.rst:54 msgid "" @@ -489,6 +573,9 @@ msgid "" "They will be removed in Python 3.15. (Contributed by Victor Stinner in :gh:" "`105096`.)" msgstr "" +":mod:`wave`：已棄用 :class:`wave.Wave_read` 和 :class:`wave.Wave_write` 類別" +"的 ``getmark()``、``setmark()`` 和 ``getmarkers()`` 方法。它們將在 Python " +"3.15 中被移除。 (由 Victor Stinner 於 :gh:`105096` 貢獻。)" #: ../../deprecations/pending-removal-in-3.16.rst:2 msgid "Pending Removal in Python 3.16" @@ -499,12 +586,16 @@ msgid "" ":mod:`array`: :class:`array.array` ``'u'`` type (:c:type:`wchar_t`): use the " "``'w'`` type instead (``Py_UCS4``)." msgstr "" +":mod:`array`：:class:`array.array` ``'u'`` 型別 (:c:type:`wchar_t`)：請改用 " +"``'w'`` 型別 (``Py_UCS4``)。" #: ../../deprecations/pending-removal-in-3.16.rst:8 msgid "" ":mod:`symtable`: Deprecate :meth:`symtable.Class.get_methods` due to the " "lack of interest. (Contributed by Bénédikt Tran in :gh:`119698`.)" msgstr "" +":mod:`symtable`：由於並沒有太多關注，已棄用 :meth:`symtable.Class." +"get_methods`。 (由 Bénédikt Tran 於 :gh:`119698` 貢獻。)" #: ../../deprecations/c-api-pending-removal-in-future.rst:2 #: ../../deprecations/pending-removal-in-future.rst:2 @@ -515,13 +606,13 @@ msgstr "未來版本中的待移除項目" msgid "" "The following APIs will be removed in the future, although there is " "currently no date scheduled for their removal." -msgstr "" +msgstr "以下 API 將在未來被移除，雖然目前尚未安排移除日期。" #: ../../deprecations/pending-removal-in-future.rst:7 msgid "" ":mod:`argparse`: Nesting argument groups and nesting mutually exclusive " "groups are deprecated." -msgstr "" +msgstr ":mod:`argparse`：已棄用巢狀引數群組和巢狀互斥群組。" #: ../../deprecations/pending-removal-in-future.rst:10 msgid ":mod:`array`'s ``'u'`` format code (:gh:`57281`)" @@ -533,7 +624,7 @@ msgstr ":mod:`builtins`：" #: ../../deprecations/pending-removal-in-future.rst:14 msgid "``~bool``, bitwise inversion on bool." -msgstr "" +msgstr "``~bool``，對 bool 進行位元反轉。" #: ../../deprecations/pending-removal-in-future.rst:15 msgid "``bool(NotImplemented)``." @@ -545,6 +636,8 @@ msgid "" "is deprecated: use ``throw(exc)`` and ``athrow(exc)`` instead, the single " "argument signature." msgstr "" +"產生器：``throw(type, exc, tb)`` 和 ``athrow(type, exc, tb)`` 簽名已被棄用：" +"請改用 ``throw(exc)`` 和 ``athrow(exc)``，為單引數簽名。" #: ../../deprecations/pending-removal-in-future.rst:19 msgid "" @@ -557,6 +650,12 @@ msgid "" "keyword:`is` and :keyword:`or`. In a future release it will be changed to a " "syntax error. (:gh:`87999`)" msgstr "" +"目前 Python 接受數值字面值後面立即接關鍵字，例如 ``0in x``、``1or x``、``0if " +"1else 2``。它讓表達式模糊且容易混淆，如 ``[0x1for x in y]``（可以解釋為 " +"``[0x1 for x in y]`` 或 ``[0x1f or x in y]``）。如果數值字面值後立即接 :" +"keyword:`and`、:keyword:`else`、:keyword:`for`、:keyword:`if`、:keyword:" +"`in`、:keyword:`is` 和 :keyword:`or` 之一的關鍵字，則會引發語法警告。在未來版" +"本中，它將被更改為語法錯誤。(:gh:`87999`)" #: ../../deprecations/pending-removal-in-future.rst:27 msgid "" @@ -564,6 +663,8 @@ msgid "" "these methods will be required to return an instance of a strict subclass " "of :class:`int`." msgstr "" +"``__index__()`` 和 ``__int__()`` 方法回傳非 int 型別的支援：這些方法將需要回" +"傳 :class:`int` 的嚴格子類別實例。" #: ../../deprecations/pending-removal-in-future.rst:30 msgid "" @@ -571,6 +672,8 @@ msgid "" "`float`: these methods will be required to return an instance of :class:" "`float`." msgstr "" +"回傳 :class:`float` 嚴格子類別 ``__float__()`` 方法的支援：這些方法將需要回" +"傳 :class:`float` 的實例。" #: ../../deprecations/pending-removal-in-future.rst:33 msgid "" @@ -578,10 +681,12 @@ msgid "" "`complex`: these methods will be required to return an instance of :class:" "`complex`." msgstr "" +"回傳 :class:`complex` 嚴格子類別 ``__complex__()`` 方法的支援：這些方法將需要" +"回傳 :class:`complex` 的實例。" #: ../../deprecations/pending-removal-in-future.rst:36 msgid "Delegation of ``int()`` to ``__trunc__()`` method." -msgstr "" +msgstr "將 ``int()`` 委派給 ``__trunc__()`` 方法。" #: ../../deprecations/pending-removal-in-future.rst:37 msgid "" @@ -590,6 +695,8 @@ msgid "" "single positional argument. (Contributed by Serhiy Storchaka in :gh:" "`109218`.)" msgstr "" +"在 :func:`complex` 建構子中將複數作為 *real* 或 *imag* 引數傳遞現在已被棄用；" +"它應該只作為單個位置引數傳遞。 (由 Serhiy Storchaka 於 :gh:`109218` 貢獻。)" #: ../../deprecations/pending-removal-in-future.rst:42 msgid "" @@ -597,6 +704,9 @@ msgid "" "are deprecated and replaced by :data:`calendar.JANUARY` and :data:`calendar." "FEBRUARY`. (Contributed by Prince Roshan in :gh:`103636`.)" msgstr "" +":mod:`calendar`：``calendar.January`` 和 ``calendar.February`` 常數已被棄用並" +"被 :data:`calendar.JANUARY` 和 :data:`calendar.FEBRUARY` 取代。 (由 Prince " +"Roshan 於 :gh:`103636` 貢獻。)" #: ../../deprecations/pending-removal-in-future.rst:47 msgid "" @@ -642,6 +752,8 @@ msgid "" ":func:`~importlib.util.cache_from_source` *debug_override* parameter is " "deprecated: use the *optimization* parameter instead." msgstr "" +":func:`~importlib.util.cache_from_source` *debug_override* 參數已被棄用：請改" +"用 *optimization* 參數。" #: ../../deprecations/pending-removal-in-future.rst:65 msgid ":mod:`importlib.metadata`:" @@ -649,17 +761,18 @@ msgstr ":mod:`importlib.metadata`：" #: ../../deprecations/pending-removal-in-future.rst:67 msgid "``EntryPoints`` tuple interface." -msgstr "" +msgstr "``EntryPoints`` 元組介面。" #: ../../deprecations/pending-removal-in-future.rst:68 msgid "Implicit ``None`` on return values." -msgstr "" +msgstr "回傳值上的隱式 ``None``。" #: ../../deprecations/pending-removal-in-future.rst:70 msgid "" ":mod:`mailbox`: Use of StringIO input and text mode is deprecated, use " "BytesIO and binary mode instead." msgstr "" +":mod:`mailbox`：已棄用 StringIO 輸入和文本模式，請改用 BytesIO 和二進位模式。" #: ../../deprecations/pending-removal-in-future.rst:73 msgid "" @@ -671,6 +784,8 @@ msgid "" ":class:`!pydoc.ErrorDuringImport`: A tuple value for *exc_info* parameter is " "deprecated, use an exception instance." msgstr "" +":class:`!pydoc.ErrorDuringImport`：*exc_info* 參數的元組值已被棄用，請用例外" +"實例。" #: ../../deprecations/pending-removal-in-future.rst:78 msgid "" @@ -680,6 +795,9 @@ msgid "" "replacement strings can now only contain ASCII letters and digits and " "underscore. (Contributed by Serhiy Storchaka in :gh:`91760`.)" msgstr "" +":mod:`re`：現在對正規表示式中的數值群組參照和群組名稱用了更嚴格的規則。現在只" +"有 ASCII 數碼序列被接受作為數值參照。位元組模式和替換字串中的群組名稱現在只能" +"包含 ASCII 字母、數碼和底線。（由 Serhiy Storchaka 於 :gh:`91760` 貢獻。）" #: ../../deprecations/pending-removal-in-future.rst:85 msgid "" @@ -807,12 +925,15 @@ msgid "" ":class:`unittest.IsolatedAsyncioTestCase`: it is deprecated to return a " "value that is not ``None`` from a test case." msgstr "" +":class:`unittest.IsolatedAsyncioTestCase`：從測試案例中回傳非 ``None`` 的值已" +"被棄用。" #: ../../deprecations/pending-removal-in-future.rst:126 msgid "" ":mod:`urllib.parse` deprecated functions: :func:`~urllib.parse.urlparse` " "instead" msgstr "" +":mod:`urllib.parse` 已棄用函式：請改用 :func:`~urllib.parse.urlparse`。" #: ../../deprecations/pending-removal-in-future.rst:128 msgid "``splitattr()``" @@ -864,6 +985,9 @@ msgid "" "`~urllib.request.FancyURLopener` style of invoking requests is deprecated. " "Use newer :func:`~urllib.request.urlopen` functions and methods." msgstr "" +":mod:`urllib.request`：呼叫請求的 :class:`~urllib.request.URLopener` 和 :" +"class:`~urllib.request.FancyURLopener` 風格已被棄用。請改用更新的 :func:" +"`~urllib.request.urlopen` 函式和方法。" #: ../../deprecations/pending-removal-in-future.rst:144 msgid "" @@ -878,12 +1002,17 @@ msgid "" "return ``True``. Prefer explicit ``len(elem)`` or ``elem is not None`` tests " "instead." msgstr "" +":mod:`xml.etree.ElementTree`：已棄用對 :class:`~xml.etree.ElementTree." +"Element` 的真值測試。在未來版本中，它將始終回傳 ``True``。請改用明確的 " +"``len(elem)`` 或 ``elem is not None`` 測試。" #: ../../deprecations/pending-removal-in-future.rst:152 msgid "" ":meth:`zipimport.zipimporter.load_module` is deprecated: use :meth:" "`~zipimport.zipimporter.exec_module` instead." msgstr "" +":meth:`zipimport.zipimporter.load_module` 已被棄用：請改用 :meth:`~zipimport." +"zipimporter.exec_module`。" #: ../../deprecations/index.rst:15 msgid "C API Deprecations" @@ -902,6 +1031,8 @@ msgid "" "Creating :c:data:`immutable types ` with mutable " "bases (:gh:`95388`)." msgstr "" +"使用可變基底建立\\ :c:data:`不可變型別 ` (:gh:" +"`95388`)。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:10 msgid "" @@ -1074,7 +1205,7 @@ msgstr "" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:4 msgid "The bundled copy of ``libmpdecimal``." -msgstr "" +msgstr "``libmpdecimal`` 的打包副本 (bundled copy)。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:5 msgid "" @@ -1110,6 +1241,8 @@ msgid "" ":c:func:`PySys_ResetWarnOptions`: clear :data:`sys.warnoptions` and :data:`!" "warnings.filters` instead." msgstr "" +":c:func:`PySys_ResetWarnOptions`：請改為清除 :data:`sys.warnoptions` 和 :" +"data:`!warnings.filters`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:14 msgid ":c:func:`Py_GetExecPrefix`: get :data:`sys.exec_prefix` instead." @@ -1125,23 +1258,25 @@ msgstr ":c:func:`Py_GetPrefix`：請改用 :data:`sys.prefix`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:17 msgid ":c:func:`Py_GetProgramFullPath`: get :data:`sys.executable` instead." -msgstr "" +msgstr ":c:func:`Py_GetProgramFullPath`：請改用 :data:`sys.executable`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:18 msgid ":c:func:`Py_GetProgramName`: get :data:`sys.executable` instead." -msgstr "" +msgstr ":c:func:`Py_GetProgramName`：請改用 :data:`sys.executable`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:19 msgid "" ":c:func:`Py_GetPythonHome`: get :c:member:`PyConfig.home` or the :envvar:" "`PYTHONHOME` environment variable instead." msgstr "" +":c:func:`Py_GetPythonHome`：請改用 :c:member:`PyConfig.home` 或 :envvar:" +"`PYTHONHOME` 環境變數。" #: ../../deprecations/c-api-pending-removal-in-future.rst:4 msgid "" "The following APIs are deprecated and will be removed, although there is " "currently no date scheduled for their removal." -msgstr "" +msgstr "下列 API 已被棄用並將會被移除，不過目前尚未訂定移除日期。" #: ../../deprecations/c-api-pending-removal-in-future.rst:7 msgid ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`: unneeded since Python 3.8." @@ -1235,7 +1370,7 @@ msgstr ":c:member:`!PyDictObject.ma_version_tag` 成員。" #: ../../deprecations/c-api-pending-removal-in-future.rst:24 msgid "Thread Local Storage (TLS) API:" -msgstr "" +msgstr "執行緒局部儲存 (Thread Local Storage, TLS) API：" #: ../../deprecations/c-api-pending-removal-in-future.rst:26 msgid "" diff --git a/deprecations/pending-removal-in-3.13.po b/deprecations/pending-removal-in-3.13.po index 18b2e0cfa2..b0fa712937 100644 --- a/deprecations/pending-removal-in-3.13.po +++ b/deprecations/pending-removal-in-3.13.po @@ -1,9 +1,7 @@ -# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # -#, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" @@ -19,167 +17,167 @@ msgstr "" #: ../../deprecations/pending-removal-in-3.13.rst:2 msgid "Pending Removal in Python 3.13" -msgstr "" +msgstr "Python 3.13 中待移除的項目" #: ../../deprecations/pending-removal-in-3.13.rst:4 msgid "Modules (see :pep:`594`):" -msgstr "" +msgstr "模組（請見 :pep:`594`）：" #: ../../deprecations/pending-removal-in-3.13.rst:6 msgid ":mod:`aifc`" -msgstr "" +msgstr ":mod:`aifc`" #: ../../deprecations/pending-removal-in-3.13.rst:7 msgid ":mod:`audioop`" -msgstr "" +msgstr ":mod:`audioop`" #: ../../deprecations/pending-removal-in-3.13.rst:8 msgid ":mod:`cgi`" -msgstr "" +msgstr ":mod:`cgi`" #: ../../deprecations/pending-removal-in-3.13.rst:9 msgid ":mod:`cgitb`" -msgstr "" +msgstr ":mod:`cgitb`" #: ../../deprecations/pending-removal-in-3.13.rst:10 msgid ":mod:`chunk`" -msgstr "" +msgstr ":mod:`chunk`" #: ../../deprecations/pending-removal-in-3.13.rst:11 msgid ":mod:`crypt`" -msgstr "" +msgstr ":mod:`crypt`" #: ../../deprecations/pending-removal-in-3.13.rst:12 msgid ":mod:`imghdr`" -msgstr "" +msgstr ":mod:`imghdr`" #: ../../deprecations/pending-removal-in-3.13.rst:13 msgid ":mod:`mailcap`" -msgstr "" +msgstr ":mod:`mailcap`" #: ../../deprecations/pending-removal-in-3.13.rst:14 msgid ":mod:`msilib`" -msgstr "" +msgstr ":mod:`msilib`" #: ../../deprecations/pending-removal-in-3.13.rst:15 msgid ":mod:`nis`" -msgstr "" +msgstr ":mod:`nis`" #: ../../deprecations/pending-removal-in-3.13.rst:16 msgid ":mod:`nntplib`" -msgstr "" +msgstr ":mod:`nntplib`" #: ../../deprecations/pending-removal-in-3.13.rst:17 msgid ":mod:`ossaudiodev`" -msgstr "" +msgstr ":mod:`ossaudiodev`" #: ../../deprecations/pending-removal-in-3.13.rst:18 msgid ":mod:`pipes`" -msgstr "" +msgstr ":mod:`pipes`" #: ../../deprecations/pending-removal-in-3.13.rst:19 msgid ":mod:`sndhdr`" -msgstr "" +msgstr ":mod:`sndhdr`" #: ../../deprecations/pending-removal-in-3.13.rst:20 msgid ":mod:`spwd`" -msgstr "" +msgstr ":mod:`spwd`" #: ../../deprecations/pending-removal-in-3.13.rst:21 msgid ":mod:`sunau`" -msgstr "" +msgstr ":mod:`sunau`" #: ../../deprecations/pending-removal-in-3.13.rst:22 msgid ":mod:`telnetlib`" -msgstr "" +msgstr ":mod:`telnetlib`" #: ../../deprecations/pending-removal-in-3.13.rst:23 msgid ":mod:`uu`" -msgstr "" +msgstr ":mod:`uu`" #: ../../deprecations/pending-removal-in-3.13.rst:24 msgid ":mod:`xdrlib`" -msgstr "" +msgstr ":mod:`xdrlib`" #: ../../deprecations/pending-removal-in-3.13.rst:26 msgid "Other modules:" -msgstr "" +msgstr "其他模組：" #: ../../deprecations/pending-removal-in-3.13.rst:28 msgid ":mod:`!lib2to3`, and the :program:`2to3` program (:gh:`84540`)" -msgstr "" +msgstr ":mod:`!lib2to3` 和 :program:`2to3` 程式 (:gh:`84540`)" #: ../../deprecations/pending-removal-in-3.13.rst:30 msgid "APIs:" -msgstr "" +msgstr "API：" #: ../../deprecations/pending-removal-in-3.13.rst:32 msgid ":class:`!configparser.LegacyInterpolation` (:gh:`90765`)" -msgstr "" +msgstr ":class:`!configparser.LegacyInterpolation` (:gh:`90765`)" #: ../../deprecations/pending-removal-in-3.13.rst:33 msgid "``locale.resetlocale()`` (:gh:`90817`)" -msgstr "" +msgstr "``locale.resetlocale()`` (:gh:`90817`)" #: ../../deprecations/pending-removal-in-3.13.rst:34 msgid ":meth:`!turtle.RawTurtle.settiltangle` (:gh:`50096`)" -msgstr "" +msgstr ":meth:`!turtle.RawTurtle.settiltangle` (:gh:`50096`)" #: ../../deprecations/pending-removal-in-3.13.rst:35 msgid ":func:`!unittest.findTestCases` (:gh:`50096`)" -msgstr "" +msgstr ":func:`!unittest.findTestCases` (:gh:`50096`)" #: ../../deprecations/pending-removal-in-3.13.rst:36 msgid ":func:`!unittest.getTestCaseNames` (:gh:`50096`)" -msgstr "" +msgstr ":func:`!unittest.getTestCaseNames` (:gh:`50096`)" #: ../../deprecations/pending-removal-in-3.13.rst:37 msgid ":func:`!unittest.makeSuite` (:gh:`50096`)" -msgstr "" +msgstr ":func:`!unittest.makeSuite` (:gh:`50096`)" #: ../../deprecations/pending-removal-in-3.13.rst:38 msgid ":meth:`!unittest.TestProgram.usageExit` (:gh:`67048`)" -msgstr "" +msgstr ":meth:`!unittest.TestProgram.usageExit` (:gh:`67048`)" #: ../../deprecations/pending-removal-in-3.13.rst:39 msgid ":class:`!webbrowser.MacOSX` (:gh:`86421`)" -msgstr "" +msgstr ":class:`!webbrowser.MacOSX` (:gh:`86421`)" #: ../../deprecations/pending-removal-in-3.13.rst:40 msgid ":class:`classmethod` descriptor chaining (:gh:`89519`)" -msgstr "" +msgstr ":class:`classmethod` 描述器鏈接 (:gh:`89519`)" #: ../../deprecations/pending-removal-in-3.13.rst:41 msgid ":mod:`importlib.resources` deprecated methods:" -msgstr "" +msgstr ":mod:`importlib.resources` 的已棄用方法：" #: ../../deprecations/pending-removal-in-3.13.rst:43 msgid "``contents()``" -msgstr "" +msgstr "``contents()``" #: ../../deprecations/pending-removal-in-3.13.rst:44 msgid "``is_resource()``" -msgstr "" +msgstr "``is_resource()``" #: ../../deprecations/pending-removal-in-3.13.rst:45 msgid "``open_binary()``" -msgstr "" +msgstr "``open_binary()``" #: ../../deprecations/pending-removal-in-3.13.rst:46 msgid "``open_text()``" -msgstr "" +msgstr "``open_text()``" #: ../../deprecations/pending-removal-in-3.13.rst:47 msgid "``path()``" -msgstr "" +msgstr "``path()``" #: ../../deprecations/pending-removal-in-3.13.rst:48 msgid "``read_binary()``" -msgstr "" +msgstr "``read_binary()``" #: ../../deprecations/pending-removal-in-3.13.rst:49 msgid "``read_text()``" -msgstr "" +msgstr "``read_text()``" #: ../../deprecations/pending-removal-in-3.13.rst:51 msgid "" @@ -187,3 +185,6 @@ msgid "" "resources: Migrating from Legacy `_ (:gh:`106531`)" msgstr "" +"請改用 :func:`importlib.resources.files()`。請參閱 `importlib-resources: " +"Migrating from Legacy `_ (:gh:`106531`)" diff --git a/deprecations/pending-removal-in-3.14.po b/deprecations/pending-removal-in-3.14.po index 391b88ca68..1ecb4d9f81 100644 --- a/deprecations/pending-removal-in-3.14.po +++ b/deprecations/pending-removal-in-3.14.po @@ -3,7 +3,6 @@ # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # -#, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" @@ -18,8 +17,9 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #: ../../deprecations/pending-removal-in-3.14.rst:2 +#: ../../deprecations/c-api-pending-removal-in-3.14.rst:2 msgid "Pending Removal in Python 3.14" -msgstr "" +msgstr "Python 3.14 中待移除的項目" #: ../../deprecations/pending-removal-in-3.14.rst:4 msgid "" @@ -27,6 +27,9 @@ msgid "" "argparse.BooleanOptionalAction` are deprecated and will be removed in 3.14. " "(Contributed by Nikita Sobolev in :gh:`92248`.)" msgstr "" +":mod:`argparse`：:class:`!argparse.BooleanOptionalAction` 的 *type*、" +"*choices* 和 *metavar* 參數已被棄用，將在 3.14 中移除。 (由 Nikita Sobolev " +"於 :gh:`92248` 貢獻。)" #: ../../deprecations/pending-removal-in-3.14.rst:9 msgid "" @@ -34,36 +37,39 @@ msgid "" "since Python 3.8, now cause a :exc:`DeprecationWarning` to be emitted at " "runtime when they are accessed or used, and will be removed in Python 3.14:" msgstr "" +":mod:`ast`：自 Python 3.8 起，下列功能已在文件中被棄用，現在在存取或使用時會" +"於 runtime 發出 :exc:`DeprecationWarning`，並將在 Python 3.14 中移除：" #: ../../deprecations/pending-removal-in-3.14.rst:13 msgid ":class:`!ast.Num`" -msgstr "" +msgstr ":class:`!ast.Num`" #: ../../deprecations/pending-removal-in-3.14.rst:14 msgid ":class:`!ast.Str`" -msgstr "" +msgstr ":class:`!ast.Str`" #: ../../deprecations/pending-removal-in-3.14.rst:15 msgid ":class:`!ast.Bytes`" -msgstr "" +msgstr ":class:`!ast.Bytes`" #: ../../deprecations/pending-removal-in-3.14.rst:16 msgid ":class:`!ast.NameConstant`" -msgstr "" +msgstr ":class:`!ast.NameConstant`" #: ../../deprecations/pending-removal-in-3.14.rst:17 msgid ":class:`!ast.Ellipsis`" -msgstr "" +msgstr ":class:`!ast.Ellipsis`" #: ../../deprecations/pending-removal-in-3.14.rst:19 msgid "" "Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka in :gh:" "`90953`.)" msgstr "" +"請改用 :class:`ast.Constant`。（由 Serhiy Storchaka 於 :gh:`90953` 貢獻。）" #: ../../deprecations/pending-removal-in-3.14.rst:22 msgid ":mod:`asyncio`:" -msgstr "" +msgstr ":mod:`asyncio`：" #: ../../deprecations/pending-removal-in-3.14.rst:24 msgid "" @@ -72,6 +78,10 @@ msgid "" "class:`~asyncio.SafeChildWatcher` are deprecated and will be removed in " "Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" +"已棄用並將在 Python 3.14 中移除的 child watcher 類別：:class:`~asyncio." +"MultiLoopChildWatcher`、:class:`~asyncio.FastChildWatcher`、:class:`~asyncio." +"AbstractChildWatcher` 和 :class:`~asyncio.SafeChildWatcher`。 (由 Kumar " +"Aditya 於 :gh:`94597` 貢獻。)" #: ../../deprecations/pending-removal-in-3.14.rst:30 msgid "" @@ -80,6 +90,10 @@ msgid "" "AbstractEventLoopPolicy.get_child_watcher` are deprecated and will be " "removed in Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" +":func:`asyncio.set_child_watcher`、:func:`asyncio.get_child_watcher`、:meth:" +"`asyncio.AbstractEventLoopPolicy.set_child_watcher` 和 :meth:`asyncio." +"AbstractEventLoopPolicy.get_child_watcher` 已被棄用並將在 Python 3.14 中移" +"除。（由 Kumar Aditya 於 :gh:`94597` 貢獻。）" #: ../../deprecations/pending-removal-in-3.14.rst:36 msgid "" @@ -88,6 +102,9 @@ msgid "" "and it decides to create one. (Contributed by Serhiy Storchaka and Guido van " "Rossum in :gh:`100160`.)" msgstr "" +"預設事件迴圈策略的 :meth:`~asyncio.get_event_loop` 方法現在會在沒有設定目前事" +"件迴圈且決定建立一個時發出 :exc:`DeprecationWarning`。 (由 Serhiy Storchaka " +"和 Guido van Rossum 於 :gh:`100160` 貢獻。)" #: ../../deprecations/pending-removal-in-3.14.rst:41 msgid "" @@ -96,50 +113,58 @@ msgid "" "typing, prefer a union, like ``bytes | bytearray``, or :class:`collections." "abc.Buffer`. (Contributed by Shantanu Jain in :gh:`91896`.)" msgstr "" +":mod:`collections.abc`：已棄用 :class:`~collections.abc.ByteString`。請改用 :" +"class:`!Sequence` 或 :class:`~collections.abc.Buffer`。在 typing 中使用時，請" +"改用聯集，如 ``bytes | bytearray``，或 :class:`collections.abc.Buffer`。（由 " +"Shantanu Jain 於 :gh:`91896` 貢獻。）" #: ../../deprecations/pending-removal-in-3.14.rst:47 msgid "" ":mod:`email`: Deprecated the *isdst* parameter in :func:`email.utils." "localtime`. (Contributed by Alan Williams in :gh:`72346`.)" msgstr "" +":mod:`email`：已棄用 :func:`email.utils.localtime` 中的 *isdst* 參數。（由 " +"Alan Williams 於 :gh:`72346` 貢獻。）" #: ../../deprecations/pending-removal-in-3.14.rst:50 msgid "" ":mod:`importlib`: ``__package__`` and ``__cached__`` will cease to be set or " "taken into consideration by the import system (:gh:`97879`)." msgstr "" +":mod:`importlib`：``__package__`` 和 ``__cached__`` 將不再被設定或被 import " +"系統考慮。 (:gh:`97879`)" #: ../../deprecations/pending-removal-in-3.14.rst:53 msgid ":mod:`importlib.abc` deprecated classes:" -msgstr "" +msgstr ":mod:`importlib.abc` 的已棄用類別：" #: ../../deprecations/pending-removal-in-3.14.rst:55 msgid ":class:`!importlib.abc.ResourceReader`" -msgstr "" +msgstr ":class:`!importlib.abc.ResourceReader`" #: ../../deprecations/pending-removal-in-3.14.rst:56 msgid ":class:`!importlib.abc.Traversable`" -msgstr "" +msgstr ":class:`!importlib.abc.Traversable`" #: ../../deprecations/pending-removal-in-3.14.rst:57 msgid ":class:`!importlib.abc.TraversableResources`" -msgstr "" +msgstr ":class:`!importlib.abc.TraversableResources`" #: ../../deprecations/pending-removal-in-3.14.rst:59 msgid "Use :mod:`importlib.resources.abc` classes instead:" -msgstr "" +msgstr "請改用 :mod:`importlib.resources.abc` 類別：" #: ../../deprecations/pending-removal-in-3.14.rst:61 msgid ":class:`importlib.resources.abc.Traversable`" -msgstr "" +msgstr ":class:`importlib.resources.abc.Traversable`" #: ../../deprecations/pending-removal-in-3.14.rst:62 msgid ":class:`importlib.resources.abc.TraversableResources`" -msgstr "" +msgstr ":class:`importlib.resources.abc.TraversableResources`" #: ../../deprecations/pending-removal-in-3.14.rst:64 msgid "(Contributed by Jason R. Coombs and Hugo van Kemenade in :gh:`93963`.)" -msgstr "" +msgstr "（由 Jason R. Coombs 和 Hugo van Kemenade 貢獻於 :gh:`93963`。）" #: ../../deprecations/pending-removal-in-3.14.rst:66 msgid "" @@ -148,6 +173,9 @@ msgid "" "removed in 3.14 for a significant reduction in code volume and maintenance " "burden. (Contributed by Raymond Hettinger in :gh:`101588`.)" msgstr "" +":mod:`itertools` 有不以文件記錄、效率低下、過去常有 bug 且不一致的 copy、" +"deepcopy 和 pickle 操作支援。將在 3.14 中移除以大幅減少程式碼量和維護負擔。 " +"(由 Raymond Hettinger 於 :gh:`101588` 貢獻。)" #: ../../deprecations/pending-removal-in-3.14.rst:72 msgid "" @@ -159,12 +187,20 @@ msgid "" "set_start_method` APIs to explicitly specify when your code *requires* " "``'fork'``. See :ref:`multiprocessing-start-methods`." msgstr "" +":mod:`multiprocessing`：預設的啟動方法將在 Linux、BSD 和其他非 macOS POSIX 平" +"台上更改為更安全的 方法，目前 ``'fork'`` 是預設值 (:gh:`84559`)。對此增加一" +"個 runtime 警告被認為太過擾人，因為 大多數程式碼不會在意。請使用 :func:" +"`~multiprocessing.get_context` 或 :func:`~multiprocessing.set_start_method` " +"API 來明確指定你的程式碼何時\\ *需要* ``'fork'``。請參閱 :ref:" +"`multiprocessing-start-methods`。" #: ../../deprecations/pending-removal-in-3.14.rst:80 msgid "" ":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` and :meth:`~pathlib." "PurePath.relative_to`: passing additional arguments is deprecated." msgstr "" +":mod:`pathlib`：已棄用 :meth:`~pathlib.PurePath.is_relative_to` 和 :meth:" +"`~pathlib.PurePath.relative_to`：額外引數的傳遞已被棄用。" #: ../../deprecations/pending-removal-in-3.14.rst:84 msgid "" @@ -172,26 +208,29 @@ msgid "" "now raise :exc:`DeprecationWarning`; use :func:`importlib.util.find_spec` " "instead. (Contributed by Nikita Sobolev in :gh:`97850`.)" msgstr "" +":mod:`pkgutil`：:func:`~pkgutil.find_loader` 和 :func:`~pkgutil.get_loader` " +"現在會引發 :exc:`DeprecationWarning`；請改用 :func:`importlib.util." +"find_spec`。 (由 Nikita Sobolev 於 :gh:`97850` 貢獻。)" #: ../../deprecations/pending-removal-in-3.14.rst:89 msgid ":mod:`pty`:" -msgstr "" +msgstr ":mod:`pty`：" #: ../../deprecations/pending-removal-in-3.14.rst:91 msgid "``master_open()``: use :func:`pty.openpty`." -msgstr "" +msgstr "``master_open()``：請用 :func:`pty.openpty`。" #: ../../deprecations/pending-removal-in-3.14.rst:92 msgid "``slave_open()``: use :func:`pty.openpty`." -msgstr "" +msgstr "``slave_open()``：請用 :func:`pty.openpty`。" #: ../../deprecations/pending-removal-in-3.14.rst:94 msgid ":mod:`sqlite3`:" -msgstr "" +msgstr ":mod:`sqlite3`：" #: ../../deprecations/pending-removal-in-3.14.rst:96 msgid ":data:`~sqlite3.version` and :data:`~sqlite3.version_info`." -msgstr "" +msgstr ":data:`~sqlite3.version` 和 :data:`~sqlite3.version_info`。" #: ../../deprecations/pending-removal-in-3.14.rst:98 msgid "" @@ -199,12 +238,17 @@ msgid "" "ref:`named placeholders ` are used and *parameters* is " "a sequence instead of a :class:`dict`." msgstr "" +":meth:`~sqlite3.Cursor.execute` 和 :meth:`~sqlite3.Cursor.executemany`，如果" +"使用 :ref:`named placeholders ` 且 *parameters* 是序列" +"而不是 :class:`dict`。" #: ../../deprecations/pending-removal-in-3.14.rst:102 msgid "" "date and datetime adapter, date and timestamp converter: see the :mod:" "`sqlite3` documentation for suggested replacement recipes." msgstr "" +"date 和 datetime 的適配器 (adapter)、date 和 timestamp 轉換器 (converter)：請" +"參閱 :mod:`sqlite3` 文件以獲得建議的替代方案。" #: ../../deprecations/pending-removal-in-3.14.rst:105 msgid "" @@ -213,12 +257,18 @@ msgid "" "but it only got a proper :exc:`DeprecationWarning` in 3.12. May be removed " "in 3.14. (Contributed by Nikita Sobolev in :gh:`101866`.)" msgstr "" +":class:`types.CodeType`：自 3.10 起，存取 :attr:`~codeobject.co_lnotab` 已" +"在 :pep:`626` 中被棄用，並計劃在 3.12 中移除，但只在 3.12 中於適當時發出 :" +"exc:`DeprecationWarning`。可能在 3.14 中移除。（由 Nikita Sobolev 於 :gh:" +"`101866` 貢獻。）" #: ../../deprecations/pending-removal-in-3.14.rst:112 msgid "" ":mod:`typing`: :class:`~typing.ByteString`, deprecated since Python 3.9, now " "causes a :exc:`DeprecationWarning` to be emitted when it is used." msgstr "" +":mod:`typing`：自 Python 3.9 起已被棄用的 :class:`~typing.ByteString` 現在在" +"使用時會發出 :exc:`DeprecationWarning`。" #: ../../deprecations/pending-removal-in-3.14.rst:115 msgid "" @@ -226,3 +276,5 @@ msgid "" "intended to be a public API. (Contributed by Gregory P. Smith in :gh:" "`88168`.)" msgstr "" +":mod:`urllib`：:class:`!urllib.parse.Quoter` 已被棄用：它並非預期的公開 API。" +"(由 Gregory P. Smith 於 :gh:`88168` 貢獻。)" diff --git a/deprecations/pending-removal-in-3.15.po b/deprecations/pending-removal-in-3.15.po index 265a821577..d5ed8c4898 100644 --- a/deprecations/pending-removal-in-3.15.po +++ b/deprecations/pending-removal-in-3.15.po @@ -3,7 +3,6 @@ # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # -#, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" @@ -18,8 +17,9 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #: ../../deprecations/pending-removal-in-3.15.rst:2 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:2 msgid "Pending Removal in Python 3.15" -msgstr "" +msgstr "Python 3.15 中待移除的項目" #: ../../deprecations/pending-removal-in-3.15.rst:4 msgid "" @@ -28,6 +28,9 @@ msgid "" "rarely used. No direct replacement exists. *Anything* is better than CGI " "to interface a web server with a request handler." msgstr "" +":class:`http.server.CGIHTTPRequestHandler` 將會被移除，連同其相關的 ``--" +"cgi`` 旗標到 ``python -m http.server``。它已經過時且很少被使用。沒有直接的替" +"代方案。*任何東西*\\ 都比 CGI 更好的來介接一個帶有請求處理器的網頁伺服器。" #: ../../deprecations/pending-removal-in-3.15.rst:9 msgid "" @@ -37,6 +40,10 @@ msgid "" "func:`locale.getencoding()` and :func:`locale.getlocale()` instead. " "(Contributed by Hugo van Kemenade in :gh:`111187`.)" msgstr "" +":class:`locale`：:func:`locale.getdefaultlocale` 已在 Python 3.11 中被棄用，" +"原本計劃在 Python 3.13 中移除 (:gh:`90817`)，但被延後至 Python 3.15。請改用 :" +"func:`locale.setlocale()`、:func:`locale.getencoding()` 和 :func:`locale." +"getlocale()`。 (由 Hugo van Kemenade 於 :gh:`111187` 貢獻。)" #: ../../deprecations/pending-removal-in-3.15.rst:16 msgid "" @@ -44,6 +51,9 @@ msgid "" "scheduled for removal in Python 3.15. From Python 3.13 onwards, use ``os." "path.isreserved`` to detect reserved paths on Windows." msgstr "" +":mod:`pathlib`：:meth:`pathlib.PurePath.is_reserved` 已被棄用並計劃在 Python " +"3.15 中移除。從 Python 3.13 開始，請用 ``os.path.isreserved`` 來偵測 Windows " +"上的保留路徑。" #: ../../deprecations/pending-removal-in-3.15.rst:21 msgid "" @@ -51,6 +61,9 @@ msgid "" "removed in 3.15. It was largely untested, had a confusing API, and was only " "useful for Jython support. (Contributed by Nikita Sobolev in :gh:`116349`.)" msgstr "" +":mod:`platform`：:func:`~platform.java_ver` 已被棄用並將在 3.15 中移除。它幾" +"乎沒有被測試過，API 令人困惑並且只對 Jython 支援有用。 (由 Nikita Sobolev " +"於 :gh:`116349` 貢獻。)" #: ../../deprecations/pending-removal-in-3.15.rst:27 msgid "" @@ -60,10 +73,14 @@ msgid "" "will be removed from :func:`threading.RLock` in Python 3.15. (Contributed by " "Nikita Sobolev in :gh:`102029`.)" msgstr "" +":mod:`threading`：對 :func:`threading.RLock` 傳遞任何引數現在已被棄用。C 版本" +"允許任意數量的引數和關鍵字引數，但它們會被忽略。Python 版本不允許任何引數。所" +"有引數將在 Python 3.15 中從 :func:`threading.RLock` 中移除。 (由 Nikita " +"Sobolev 於 :gh:`102029` 貢獻。)" #: ../../deprecations/pending-removal-in-3.15.rst:34 msgid ":class:`typing.NamedTuple`:" -msgstr "" +msgstr ":class:`typing.NamedTuple`：" #: ../../deprecations/pending-removal-in-3.15.rst:36 msgid "" @@ -72,6 +89,9 @@ msgid "" "disallowed in 3.15. Use the class-based syntax or the functional syntax " "instead." msgstr "" +"用於建立 :class:`!NamedTuple` 類別的未以文件記錄之關鍵字引數語法 (``NT = " +"NamedTuple(\"NT\", x=int)``) 已棄用，並將在 3.15 中被禁止。請改用基於類別的語" +"法或函式語法 (functional syntax)。" #: ../../deprecations/pending-removal-in-3.15.rst:40 msgid "" @@ -83,6 +103,11 @@ msgid "" "fields, use ``class NT(NamedTuple): pass`` or ``NT = NamedTuple(\"NT\", " "[])``." msgstr "" +"當使用函式語法來建立 :class:`!NamedTuple` 類別時，沒將值傳遞給 *fields* 參數" +"的方式 (``NT = NamedTuple(\"NT\")``) 已被棄用，將 ``None`` 傳遞給 *fields* 參" +"數（``NT = NamedTuple(\"NT\", None)``）也已被棄用。這兩者將在 Python 3.15 中" +"會被禁止。要建立一個沒有欄位的 :class:`!NamedTuple` 類別，請使用 ``class " +"NT(NamedTuple): pass`` 或 ``NT = NamedTuple(\"NT\", [])``。" #: ../../deprecations/pending-removal-in-3.15.rst:47 msgid "" @@ -93,6 +118,12 @@ msgid "" "be disallowed in Python 3.15. To create a :class:`!TypedDict` class with 0 " "fields, use ``class TD(TypedDict): pass`` or ``TD = TypedDict(\"TD\", {})``." msgstr "" +":class:`typing.TypedDict`：當使用函式語法來建立 :class:`!TypedDict` 類別時，" +"沒將值傳遞給 *fields* 參數的方式（``TD = TypedDict(\"TD\")``）已被棄用，將 " +"``None`` 傳遞給 *fields* 參數（``TD = TypedDict(\"TD\", None)``）也已被棄用。" +"這兩者將在 Python 3.15 中會被禁止。要建立一個沒有欄位的 :class:`!TypedDict` " +"類別，請使用 ``class TD(TypedDict): pass`` 或 ``TD = TypedDict(\"TD\", " +"{})``。" #: ../../deprecations/pending-removal-in-3.15.rst:54 msgid "" @@ -101,3 +132,6 @@ msgid "" "They will be removed in Python 3.15. (Contributed by Victor Stinner in :gh:" "`105096`.)" msgstr "" +":mod:`wave`：已棄用 :class:`wave.Wave_read` 和 :class:`wave.Wave_write` 類別" +"的 ``getmark()``、``setmark()`` 和 ``getmarkers()`` 方法。它們將在 Python " +"3.15 中被移除。 (由 Victor Stinner 於 :gh:`105096` 貢獻。)" diff --git a/deprecations/pending-removal-in-3.16.po b/deprecations/pending-removal-in-3.16.po index a38d082adc..a77fad9e91 100644 --- a/deprecations/pending-removal-in-3.16.po +++ b/deprecations/pending-removal-in-3.16.po @@ -1,9 +1,7 @@ -# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # -#, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" @@ -19,16 +17,20 @@ msgstr "" #: ../../deprecations/pending-removal-in-3.16.rst:2 msgid "Pending Removal in Python 3.16" -msgstr "" +msgstr "Python 3.16 中待移除的項目" #: ../../deprecations/pending-removal-in-3.16.rst:4 msgid "" ":mod:`array`: :class:`array.array` ``'u'`` type (:c:type:`wchar_t`): use the " "``'w'`` type instead (``Py_UCS4``)." msgstr "" +":mod:`array`：:class:`array.array` ``'u'`` 型別 (:c:type:`wchar_t`)：請改用 " +"``'w'`` 型別 (``Py_UCS4``)。" #: ../../deprecations/pending-removal-in-3.16.rst:8 msgid "" ":mod:`symtable`: Deprecate :meth:`symtable.Class.get_methods` due to the " "lack of interest. (Contributed by Bénédikt Tran in :gh:`119698`.)" msgstr "" +":mod:`symtable`：由於並沒有太多關注，已棄用 :meth:`symtable.Class." +"get_methods`。 (由 Bénédikt Tran 於 :gh:`119698` 貢獻。)" diff --git a/whatsnew/3.11.po b/whatsnew/3.11.po index 1e0b7ecf50..697d4d43aa 100644 --- a/whatsnew/3.11.po +++ b/whatsnew/3.11.po @@ -1101,7 +1101,7 @@ msgstr "（由 Yurii Karabas 於 :issue:`46014` 中所貢獻。）" #: ../../whatsnew/3.11.rst:774 msgid "gzip" -msgstr "" +msgstr "gzip" #: ../../whatsnew/3.11.rst:776 msgid "" @@ -2578,9 +2578,9 @@ msgid "" "html#regex-dna>`_ up to 10% faster than Python 3.10. (Contributed by Brandt " "Bucher in :gh:`91404`.)" msgstr "" -":mod:`re` 的正則表達式比對引擎部分被重構，且現在會有支援的平台上使用 " +":mod:`re` 的正規表示式比對引擎部分被重構，且現在會有支援的平台上使用 " "computed gotos（或者「執行緒程式碼 (threaded code)」），因此 Python 3.11 在執" -"行 `pyperformance 正則表達式基準量測 `_\\ 的表現上比起 Python 3.10 快了 10%。（由 " "Brandt Bucher 於 :gh:`91404` 中貢獻。）" diff --git a/whatsnew/3.12.po b/whatsnew/3.12.po index d14e974cdc..c4d03d212e 100644 --- a/whatsnew/3.12.po +++ b/whatsnew/3.12.po @@ -2,7 +2,6 @@ # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # -#, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" @@ -1242,6 +1241,8 @@ msgid "" "The :class:`tempfile.NamedTemporaryFile` function has a new optional " "parameter *delete_on_close* (Contributed by Evgeny Zorin in :gh:`58451`.)" msgstr "" +":class:`tempfile.NamedTemporaryFile` 函式新增了一個選擇性參數 " +"*delete_on_close* （由 Evgeny Zorin 於 :gh:`58451` 中貢獻。）" #: ../../whatsnew/3.12.rst:933 msgid "" @@ -1362,6 +1363,8 @@ msgid "" "Add ``frozen_default`` parameter to :func:`typing.dataclass_transform`. " "(Contributed by Erik De Bonte in :gh:`99957`.)" msgstr "" +"新增 ``frozen_default`` 參數至 :func:`typing.dataclass_transform`。（由 Erik " +"De Bonte 於 :gh:`99957` 中貢獻。）" #: ../../whatsnew/3.12.rst:1031 msgid "unicodedata" @@ -1395,6 +1398,8 @@ msgid "" "Add a :ref:`command-line interface `. (Contributed by Adam Chhina " "in :gh:`88597`.)" msgstr "" +"新增一個\\ :ref:`命令列介面 `。（由 Adam Chhina 於 :gh:`88597` 中貢" +"獻。）" #: ../../whatsnew/3.12.rst:1065 msgid "Optimizations" @@ -1560,6 +1565,9 @@ msgid "" "argparse.BooleanOptionalAction` are deprecated and will be removed in 3.14. " "(Contributed by Nikita Sobolev in :gh:`92248`.)" msgstr "" +":mod:`argparse`：:class:`!argparse.BooleanOptionalAction` 的 *type*、" +"*choices* 和 *metavar* 參數已被棄用，將在 3.14 中移除。 (由 Nikita Sobolev " +"於 :gh:`92248` 貢獻。)" #: ../../whatsnew/3.12.rst:1161 msgid "" @@ -1600,7 +1608,7 @@ msgid "" "Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka in :gh:" "`90953`.)" msgstr "" -"改用 :class:`ast.Constant`。（由 Serhiy Storchaka 在 :gh:`90953` 中貢獻。）" +"請改用 :class:`ast.Constant`。（由 Serhiy Storchaka 於 :gh:`90953` 貢獻。）" #: ../../whatsnew/3.12.rst:1174 #: ../../deprecations/pending-removal-in-3.14.rst:22 @@ -1623,6 +1631,10 @@ msgid "" "AbstractEventLoopPolicy.get_child_watcher` are deprecated and will be " "removed in Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" +":func:`asyncio.set_child_watcher`、:func:`asyncio.get_child_watcher`、:meth:" +"`asyncio.AbstractEventLoopPolicy.set_child_watcher` 和 :meth:`asyncio." +"AbstractEventLoopPolicy.get_child_watcher` 已被棄用並將在 Python 3.14 中移" +"除。（由 Kumar Aditya 於 :gh:`94597` 貢獻。）" #: ../../whatsnew/3.12.rst:1188 #: ../../deprecations/pending-removal-in-3.14.rst:36 @@ -1632,6 +1644,9 @@ msgid "" "and it decides to create one. (Contributed by Serhiy Storchaka and Guido van " "Rossum in :gh:`100160`.)" msgstr "" +"預設事件迴圈策略的 :meth:`~asyncio.get_event_loop` 方法現在會在沒有設定目前事" +"件迴圈且決定建立一個時發出 :exc:`DeprecationWarning`。 (由 Serhiy Storchaka " +"和 Guido van Rossum 於 :gh:`100160` 貢獻。)" #: ../../whatsnew/3.12.rst:1193 #: ../../deprecations/pending-removal-in-future.rst:42 @@ -1640,6 +1655,9 @@ msgid "" "are deprecated and replaced by :data:`calendar.JANUARY` and :data:`calendar." "FEBRUARY`. (Contributed by Prince Roshan in :gh:`103636`.)" msgstr "" +":mod:`calendar`：``calendar.January`` 和 ``calendar.February`` 常數已被棄用並" +"被 :data:`calendar.JANUARY` 和 :data:`calendar.FEBRUARY` 取代。 (由 Prince " +"Roshan 於 :gh:`103636` 貢獻。)" #: ../../whatsnew/3.12.rst:1197 msgid "" @@ -1706,7 +1724,7 @@ msgstr ":class:`importlib.resources.abc.TraversableResources`" #: ../../whatsnew/3.12.rst:1225 #: ../../deprecations/pending-removal-in-3.14.rst:64 msgid "(Contributed by Jason R. Coombs and Hugo van Kemenade in :gh:`93963`.)" -msgstr "（由 Jason R. Coombs 和 Hugo van Kemenade 於 :gh:`93963` 中貢獻。）" +msgstr "（由 Jason R. Coombs 和 Hugo van Kemenade 貢獻於 :gh:`93963`。）" #: ../../whatsnew/3.12.rst:1227 msgid "" @@ -1890,11 +1908,11 @@ msgstr "" #: ../../deprecations/pending-removal-in-3.13.rst:2 msgid "Pending Removal in Python 3.13" -msgstr "Python 3.13 中待決議的移除項目" +msgstr "Python 3.13 中待移除的項目" #: ../../deprecations/pending-removal-in-3.13.rst:4 msgid "Modules (see :pep:`594`):" -msgstr "模組（參見:pep:`594`）：" +msgstr "模組（請見 :pep:`594`）：" #: ../../deprecations/pending-removal-in-3.13.rst:6 msgid ":mod:`aifc`" @@ -1978,7 +1996,7 @@ msgstr "其他模組：" #: ../../deprecations/pending-removal-in-3.13.rst:28 msgid ":mod:`!lib2to3`, and the :program:`2to3` program (:gh:`84540`)" -msgstr ":mod:`!lib2to3` 以及 :program:`2to3` 程式 (:gh:`84540`)" +msgstr ":mod:`!lib2to3` 和 :program:`2to3` 程式 (:gh:`84540`)" #: ../../deprecations/pending-removal-in-3.13.rst:30 msgid "APIs:" @@ -2018,11 +2036,11 @@ msgstr ":class:`!webbrowser.MacOSX` (:gh:`86421`)" #: ../../deprecations/pending-removal-in-3.13.rst:40 msgid ":class:`classmethod` descriptor chaining (:gh:`89519`)" -msgstr ":class:`classmethod` 描述器鏈結 (:gh:`89519`)" +msgstr ":class:`classmethod` 描述器鏈接 (:gh:`89519`)" #: ../../deprecations/pending-removal-in-3.13.rst:41 msgid ":mod:`importlib.resources` deprecated methods:" -msgstr ":mod:`importlib.resources` 中被棄用的方法：" +msgstr ":mod:`importlib.resources` 的已棄用方法：" #: ../../deprecations/pending-removal-in-3.13.rst:43 msgid "``contents()``" @@ -2058,11 +2076,14 @@ msgid "" "resources: Migrating from Legacy `_ (:gh:`106531`)" msgstr "" +"請改用 :func:`importlib.resources.files()`。請參閱 `importlib-resources: " +"Migrating from Legacy `_ (:gh:`106531`)" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:2 #: ../../deprecations/pending-removal-in-3.14.rst:2 msgid "Pending Removal in Python 3.14" -msgstr "Python 3.14 中待決議的移除項目" +msgstr "Python 3.14 中待移除的項目" #: ../../deprecations/pending-removal-in-3.14.rst:9 msgid "" @@ -2070,6 +2091,8 @@ msgid "" "since Python 3.8, now cause a :exc:`DeprecationWarning` to be emitted at " "runtime when they are accessed or used, and will be removed in Python 3.14:" msgstr "" +":mod:`ast`：自 Python 3.8 起，下列功能已在文件中被棄用，現在在存取或使用時會" +"於 runtime 發出 :exc:`DeprecationWarning`，並將在 Python 3.14 中移除：" #: ../../deprecations/pending-removal-in-3.14.rst:24 msgid "" @@ -2078,6 +2101,10 @@ msgid "" "class:`~asyncio.SafeChildWatcher` are deprecated and will be removed in " "Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" +"已棄用並將在 Python 3.14 中移除的 child watcher 類別：:class:`~asyncio." +"MultiLoopChildWatcher`、:class:`~asyncio.FastChildWatcher`、:class:`~asyncio." +"AbstractChildWatcher` 和 :class:`~asyncio.SafeChildWatcher`。 (由 Kumar " +"Aditya 於 :gh:`94597` 貢獻。)" #: ../../deprecations/pending-removal-in-3.14.rst:41 msgid "" @@ -2086,26 +2113,30 @@ msgid "" "typing, prefer a union, like ``bytes | bytearray``, or :class:`collections." "abc.Buffer`. (Contributed by Shantanu Jain in :gh:`91896`.)" msgstr "" +":mod:`collections.abc`：已棄用 :class:`~collections.abc.ByteString`。請改用 :" +"class:`!Sequence` 或 :class:`~collections.abc.Buffer`。在 typing 中使用時，請" +"改用聯集，如 ``bytes | bytearray``，或 :class:`collections.abc.Buffer`。（由 " +"Shantanu Jain 於 :gh:`91896` 貢獻。）" #: ../../deprecations/pending-removal-in-3.14.rst:47 -#, fuzzy msgid "" ":mod:`email`: Deprecated the *isdst* parameter in :func:`email.utils." "localtime`. (Contributed by Alan Williams in :gh:`72346`.)" msgstr "" -":mod:`email`：棄用 :func:`email.utils.localtime` 中的 *isdst* 參數。（由 " -"Alan Williams 於 :gh:`72346` 中貢獻。）" +":mod:`email`：已棄用 :func:`email.utils.localtime` 中的 *isdst* 參數。（由 " +"Alan Williams 於 :gh:`72346` 貢獻。）" #: ../../deprecations/pending-removal-in-3.14.rst:50 msgid "" ":mod:`importlib`: ``__package__`` and ``__cached__`` will cease to be set or " "taken into consideration by the import system (:gh:`97879`)." msgstr "" +":mod:`importlib`：``__package__`` 和 ``__cached__`` 將不再被設定或被 import " +"系統考慮。 (:gh:`97879`)" #: ../../deprecations/pending-removal-in-3.14.rst:53 -#, fuzzy msgid ":mod:`importlib.abc` deprecated classes:" -msgstr ":mod:`importlib.resources` 中被棄用的方法：" +msgstr ":mod:`importlib.abc` 的已棄用類別：" #: ../../deprecations/pending-removal-in-3.14.rst:66 msgid "" @@ -2114,6 +2145,9 @@ msgid "" "removed in 3.14 for a significant reduction in code volume and maintenance " "burden. (Contributed by Raymond Hettinger in :gh:`101588`.)" msgstr "" +":mod:`itertools` 有不以文件記錄、效率低下、過去常有 bug 且不一致的 copy、" +"deepcopy 和 pickle 操作支援。將在 3.14 中移除以大幅減少程式碼量和維護負擔。 " +"(由 Raymond Hettinger 於 :gh:`101588` 貢獻。)" #: ../../deprecations/pending-removal-in-3.14.rst:72 msgid "" @@ -2125,12 +2159,20 @@ msgid "" "set_start_method` APIs to explicitly specify when your code *requires* " "``'fork'``. See :ref:`multiprocessing-start-methods`." msgstr "" +":mod:`multiprocessing`：預設的啟動方法將在 Linux、BSD 和其他非 macOS POSIX 平" +"台上更改為更安全的 方法，目前 ``'fork'`` 是預設值 (:gh:`84559`)。對此增加一" +"個 runtime 警告被認為太過擾人，因為 大多數程式碼不會在意。請使用 :func:" +"`~multiprocessing.get_context` 或 :func:`~multiprocessing.set_start_method` " +"API 來明確指定你的程式碼何時\\ *需要* ``'fork'``。請參閱 :ref:" +"`multiprocessing-start-methods`。" #: ../../deprecations/pending-removal-in-3.14.rst:80 msgid "" ":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` and :meth:`~pathlib." "PurePath.relative_to`: passing additional arguments is deprecated." msgstr "" +":mod:`pathlib`：已棄用 :meth:`~pathlib.PurePath.is_relative_to` 和 :meth:" +"`~pathlib.PurePath.relative_to`：額外引數的傳遞已被棄用。" #: ../../deprecations/pending-removal-in-3.14.rst:84 msgid "" @@ -2138,6 +2180,9 @@ msgid "" "now raise :exc:`DeprecationWarning`; use :func:`importlib.util.find_spec` " "instead. (Contributed by Nikita Sobolev in :gh:`97850`.)" msgstr "" +":mod:`pkgutil`：:func:`~pkgutil.find_loader` 和 :func:`~pkgutil.get_loader` " +"現在會引發 :exc:`DeprecationWarning`；請改用 :func:`importlib.util." +"find_spec`。 (由 Nikita Sobolev 於 :gh:`97850` 貢獻。)" #: ../../deprecations/pending-removal-in-3.14.rst:89 msgid ":mod:`pty`:" @@ -2145,15 +2190,15 @@ msgstr ":mod:`pty`：" #: ../../deprecations/pending-removal-in-3.14.rst:91 msgid "``master_open()``: use :func:`pty.openpty`." -msgstr "" +msgstr "``master_open()``：請用 :func:`pty.openpty`。" #: ../../deprecations/pending-removal-in-3.14.rst:92 msgid "``slave_open()``: use :func:`pty.openpty`." -msgstr "" +msgstr "``slave_open()``：請用 :func:`pty.openpty`。" #: ../../deprecations/pending-removal-in-3.14.rst:96 msgid ":data:`~sqlite3.version` and :data:`~sqlite3.version_info`." -msgstr "" +msgstr ":data:`~sqlite3.version` 和 :data:`~sqlite3.version_info`。" #: ../../deprecations/pending-removal-in-3.14.rst:98 msgid "" @@ -2161,12 +2206,17 @@ msgid "" "ref:`named placeholders ` are used and *parameters* is " "a sequence instead of a :class:`dict`." msgstr "" +":meth:`~sqlite3.Cursor.execute` 和 :meth:`~sqlite3.Cursor.executemany`，如果" +"使用 :ref:`named placeholders ` 且 *parameters* 是序列" +"而不是 :class:`dict`。" #: ../../deprecations/pending-removal-in-3.14.rst:102 msgid "" "date and datetime adapter, date and timestamp converter: see the :mod:" "`sqlite3` documentation for suggested replacement recipes." msgstr "" +"date 和 datetime 的適配器 (adapter)、date 和 timestamp 轉換器 (converter)：請" +"參閱 :mod:`sqlite3` 文件以獲得建議的替代方案。" #: ../../deprecations/pending-removal-in-3.14.rst:105 msgid "" @@ -2175,12 +2225,18 @@ msgid "" "but it only got a proper :exc:`DeprecationWarning` in 3.12. May be removed " "in 3.14. (Contributed by Nikita Sobolev in :gh:`101866`.)" msgstr "" +":class:`types.CodeType`：自 3.10 起，存取 :attr:`~codeobject.co_lnotab` 已" +"在 :pep:`626` 中被棄用，並計劃在 3.12 中移除，但只在 3.12 中於適當時發出 :" +"exc:`DeprecationWarning`。可能在 3.14 中移除。（由 Nikita Sobolev 於 :gh:" +"`101866` 貢獻。）" #: ../../deprecations/pending-removal-in-3.14.rst:112 msgid "" ":mod:`typing`: :class:`~typing.ByteString`, deprecated since Python 3.9, now " "causes a :exc:`DeprecationWarning` to be emitted when it is used." msgstr "" +":mod:`typing`：自 Python 3.9 起已被棄用的 :class:`~typing.ByteString` 現在在" +"使用時會發出 :exc:`DeprecationWarning`。" #: ../../deprecations/pending-removal-in-3.14.rst:115 msgid "" @@ -2188,11 +2244,13 @@ msgid "" "intended to be a public API. (Contributed by Gregory P. Smith in :gh:" "`88168`.)" msgstr "" +":mod:`urllib`：:class:`!urllib.parse.Quoter` 已被棄用：它並非預期的公開 API。" +"(由 Gregory P. Smith 於 :gh:`88168` 貢獻。)" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:2 #: ../../deprecations/pending-removal-in-3.15.rst:2 msgid "Pending Removal in Python 3.15" -msgstr "Python 3.15 中待決議的移除項目" +msgstr "Python 3.15 中待移除的項目" #: ../../deprecations/pending-removal-in-3.15.rst:4 msgid "" @@ -2201,6 +2259,9 @@ msgid "" "rarely used. No direct replacement exists. *Anything* is better than CGI " "to interface a web server with a request handler." msgstr "" +":class:`http.server.CGIHTTPRequestHandler` 將會被移除，連同其相關的 ``--" +"cgi`` 旗標到 ``python -m http.server``。它已經過時且很少被使用。沒有直接的替" +"代方案。*任何東西*\\ 都比 CGI 更好的來介接一個帶有請求處理器的網頁伺服器。" #: ../../deprecations/pending-removal-in-3.15.rst:9 msgid "" @@ -2210,6 +2271,10 @@ msgid "" "func:`locale.getencoding()` and :func:`locale.getlocale()` instead. " "(Contributed by Hugo van Kemenade in :gh:`111187`.)" msgstr "" +":class:`locale`：:func:`locale.getdefaultlocale` 已在 Python 3.11 中被棄用，" +"原本計劃在 Python 3.13 中移除 (:gh:`90817`)，但被延後至 Python 3.15。請改用 :" +"func:`locale.setlocale()`、:func:`locale.getencoding()` 和 :func:`locale." +"getlocale()`。 (由 Hugo van Kemenade 於 :gh:`111187` 貢獻。)" #: ../../deprecations/pending-removal-in-3.15.rst:16 msgid "" @@ -2217,6 +2282,9 @@ msgid "" "scheduled for removal in Python 3.15. From Python 3.13 onwards, use ``os." "path.isreserved`` to detect reserved paths on Windows." msgstr "" +":mod:`pathlib`：:meth:`pathlib.PurePath.is_reserved` 已被棄用並計劃在 Python " +"3.15 中移除。從 Python 3.13 開始，請用 ``os.path.isreserved`` 來偵測 Windows " +"上的保留路徑。" #: ../../deprecations/pending-removal-in-3.15.rst:21 msgid "" @@ -2224,6 +2292,9 @@ msgid "" "removed in 3.15. It was largely untested, had a confusing API, and was only " "useful for Jython support. (Contributed by Nikita Sobolev in :gh:`116349`.)" msgstr "" +":mod:`platform`：:func:`~platform.java_ver` 已被棄用並將在 3.15 中移除。它幾" +"乎沒有被測試過，API 令人困惑並且只對 Jython 支援有用。 (由 Nikita Sobolev " +"於 :gh:`116349` 貢獻。)" #: ../../deprecations/pending-removal-in-3.15.rst:27 msgid "" @@ -2233,11 +2304,14 @@ msgid "" "will be removed from :func:`threading.RLock` in Python 3.15. (Contributed by " "Nikita Sobolev in :gh:`102029`.)" msgstr "" +":mod:`threading`：對 :func:`threading.RLock` 傳遞任何引數現在已被棄用。C 版本" +"允許任意數量的引數和關鍵字引數，但它們會被忽略。Python 版本不允許任何引數。所" +"有引數將在 Python 3.15 中從 :func:`threading.RLock` 中移除。 (由 Nikita " +"Sobolev 於 :gh:`102029` 貢獻。)" #: ../../deprecations/pending-removal-in-3.15.rst:34 -#, fuzzy msgid ":class:`typing.NamedTuple`:" -msgstr ":class:`typing.Text` (:gh:`92332`)" +msgstr ":class:`typing.NamedTuple`：" #: ../../deprecations/pending-removal-in-3.15.rst:36 msgid "" @@ -2246,6 +2320,9 @@ msgid "" "disallowed in 3.15. Use the class-based syntax or the functional syntax " "instead." msgstr "" +"用於建立 :class:`!NamedTuple` 類別的未以文件記錄之關鍵字引數語法 (``NT = " +"NamedTuple(\"NT\", x=int)``) 已棄用，並將在 3.15 中被禁止。請改用基於類別的語" +"法或函式語法 (functional syntax)。" #: ../../deprecations/pending-removal-in-3.15.rst:40 msgid "" @@ -2257,6 +2334,11 @@ msgid "" "fields, use ``class NT(NamedTuple): pass`` or ``NT = NamedTuple(\"NT\", " "[])``." msgstr "" +"當使用函式語法來建立 :class:`!NamedTuple` 類別時，沒將值傳遞給 *fields* 參數" +"的方式 (``NT = NamedTuple(\"NT\")``) 已被棄用，將 ``None`` 傳遞給 *fields* 參" +"數（``NT = NamedTuple(\"NT\", None)``）也已被棄用。這兩者將在 Python 3.15 中" +"會被禁止。要建立一個沒有欄位的 :class:`!NamedTuple` 類別，請使用 ``class " +"NT(NamedTuple): pass`` 或 ``NT = NamedTuple(\"NT\", [])``。" #: ../../deprecations/pending-removal-in-3.15.rst:47 msgid "" @@ -2267,6 +2349,12 @@ msgid "" "be disallowed in Python 3.15. To create a :class:`!TypedDict` class with 0 " "fields, use ``class TD(TypedDict): pass`` or ``TD = TypedDict(\"TD\", {})``." msgstr "" +":class:`typing.TypedDict`：當使用函式語法來建立 :class:`!TypedDict` 類別時，" +"沒將值傳遞給 *fields* 參數的方式（``TD = TypedDict(\"TD\")``）已被棄用，將 " +"``None`` 傳遞給 *fields* 參數（``TD = TypedDict(\"TD\", None)``）也已被棄用。" +"這兩者將在 Python 3.15 中會被禁止。要建立一個沒有欄位的 :class:`!TypedDict` " +"類別，請使用 ``class TD(TypedDict): pass`` 或 ``TD = TypedDict(\"TD\", " +"{})``。" #: ../../deprecations/pending-removal-in-3.15.rst:54 msgid "" @@ -2275,58 +2363,62 @@ msgid "" "They will be removed in Python 3.15. (Contributed by Victor Stinner in :gh:" "`105096`.)" msgstr "" +":mod:`wave`：已棄用 :class:`wave.Wave_read` 和 :class:`wave.Wave_write` 類別" +"的 ``getmark()``、``setmark()`` 和 ``getmarkers()`` 方法。它們將在 Python " +"3.15 中被移除。 (由 Victor Stinner 於 :gh:`105096` 貢獻。)" #: ../../deprecations/pending-removal-in-3.16.rst:2 -#, fuzzy msgid "Pending Removal in Python 3.16" -msgstr "Python 3.13 中待決議的移除項目" +msgstr "Python 3.16 中待移除的項目" #: ../../deprecations/pending-removal-in-3.16.rst:4 msgid "" ":mod:`array`: :class:`array.array` ``'u'`` type (:c:type:`wchar_t`): use the " "``'w'`` type instead (``Py_UCS4``)." msgstr "" +":mod:`array`：:class:`array.array` ``'u'`` 型別 (:c:type:`wchar_t`)：請改用 " +"``'w'`` 型別 (``Py_UCS4``)。" #: ../../deprecations/pending-removal-in-3.16.rst:8 msgid "" ":mod:`symtable`: Deprecate :meth:`symtable.Class.get_methods` due to the " "lack of interest. (Contributed by Bénédikt Tran in :gh:`119698`.)" msgstr "" +":mod:`symtable`：由於並沒有太多關注，已棄用 :meth:`symtable.Class." +"get_methods`。 (由 Bénédikt Tran 於 :gh:`119698` 貢獻。)" #: ../../deprecations/c-api-pending-removal-in-future.rst:2 #: ../../deprecations/pending-removal-in-future.rst:2 msgid "Pending Removal in Future Versions" -msgstr "未來版本中待決議的移除項目" +msgstr "未來版本中的待移除項目" #: ../../deprecations/pending-removal-in-future.rst:4 -#, fuzzy msgid "" "The following APIs will be removed in the future, although there is " "currently no date scheduled for their removal." -msgstr "以下 API 已棄用，且將會被移除，雖目前尚未定下移除日期。" +msgstr "以下 API 將在未來被移除，雖然目前尚未安排移除日期。" #: ../../deprecations/pending-removal-in-future.rst:7 msgid "" ":mod:`argparse`: Nesting argument groups and nesting mutually exclusive " "groups are deprecated." -msgstr "" +msgstr ":mod:`argparse`：已棄用巢狀引數群組和巢狀互斥群組。" #: ../../deprecations/pending-removal-in-future.rst:10 msgid ":mod:`array`'s ``'u'`` format code (:gh:`57281`)" msgstr ":mod:`array` 的 ``'u'`` 格式碼 (:gh:`57281`)" #: ../../deprecations/pending-removal-in-future.rst:12 -#, fuzzy msgid ":mod:`builtins`:" -msgstr ":mod:`typing`：" +msgstr ":mod:`builtins`：" #: ../../deprecations/pending-removal-in-future.rst:14 msgid "``~bool``, bitwise inversion on bool." -msgstr "" +msgstr "``~bool``，對 bool 進行位元反轉。" #: ../../deprecations/pending-removal-in-future.rst:15 msgid "``bool(NotImplemented)``." -msgstr "" +msgstr "``bool(NotImplemented)``。" #: ../../deprecations/pending-removal-in-future.rst:16 msgid "" @@ -2334,6 +2426,8 @@ msgid "" "is deprecated: use ``throw(exc)`` and ``athrow(exc)`` instead, the single " "argument signature." msgstr "" +"產生器：``throw(type, exc, tb)`` 和 ``athrow(type, exc, tb)`` 簽名已被棄用：" +"請改用 ``throw(exc)`` 和 ``athrow(exc)``，為單引數簽名。" #: ../../deprecations/pending-removal-in-future.rst:19 msgid "" @@ -2346,6 +2440,12 @@ msgid "" "keyword:`is` and :keyword:`or`. In a future release it will be changed to a " "syntax error. (:gh:`87999`)" msgstr "" +"目前 Python 接受數值字面值後面立即接關鍵字，例如 ``0in x``、``1or x``、``0if " +"1else 2``。它讓表達式模糊且容易混淆，如 ``[0x1for x in y]``（可以解釋為 " +"``[0x1 for x in y]`` 或 ``[0x1f or x in y]``）。如果數值字面值後立即接 :" +"keyword:`and`、:keyword:`else`、:keyword:`for`、:keyword:`if`、:keyword:" +"`in`、:keyword:`is` 和 :keyword:`or` 之一的關鍵字，則會引發語法警告。在未來版" +"本中，它將被更改為語法錯誤。(:gh:`87999`)" #: ../../deprecations/pending-removal-in-future.rst:27 msgid "" @@ -2353,6 +2453,8 @@ msgid "" "these methods will be required to return an instance of a strict subclass " "of :class:`int`." msgstr "" +"``__index__()`` 和 ``__int__()`` 方法回傳非 int 型別的支援：這些方法將需要回" +"傳 :class:`int` 的嚴格子類別實例。" #: ../../deprecations/pending-removal-in-future.rst:30 msgid "" @@ -2360,6 +2462,8 @@ msgid "" "`float`: these methods will be required to return an instance of :class:" "`float`." msgstr "" +"回傳 :class:`float` 嚴格子類別 ``__float__()`` 方法的支援：這些方法將需要回" +"傳 :class:`float` 的實例。" #: ../../deprecations/pending-removal-in-future.rst:33 msgid "" @@ -2367,10 +2471,12 @@ msgid "" "`complex`: these methods will be required to return an instance of :class:" "`complex`." msgstr "" +"回傳 :class:`complex` 嚴格子類別 ``__complex__()`` 方法的支援：這些方法將需要" +"回傳 :class:`complex` 的實例。" #: ../../deprecations/pending-removal-in-future.rst:36 msgid "Delegation of ``int()`` to ``__trunc__()`` method." -msgstr "" +msgstr "將 ``int()`` 委派給 ``__trunc__()`` 方法。" #: ../../deprecations/pending-removal-in-future.rst:37 msgid "" @@ -2379,79 +2485,87 @@ msgid "" "single positional argument. (Contributed by Serhiy Storchaka in :gh:" "`109218`.)" msgstr "" +"在 :func:`complex` 建構子中將複數作為 *real* 或 *imag* 引數傳遞現在已被棄用；" +"它應該只作為單個位置引數傳遞。 (由 Serhiy Storchaka 於 :gh:`109218` 貢獻。)" #: ../../deprecations/pending-removal-in-future.rst:47 -#, fuzzy msgid "" ":attr:`codeobject.co_lnotab`: use the :meth:`codeobject.co_lines` method " "instead." -msgstr "程式碼物件的 :attr:`~codeobject.co_lnotab` 屬性。" +msgstr "" +":attr:`codeobject.co_lnotab`：請改用 :meth:`codeobject.co_lines` 方法。" #: ../../deprecations/pending-removal-in-future.rst:50 -#, fuzzy msgid ":mod:`datetime`:" -msgstr ":mod:`ast`：" +msgstr ":mod:`datetime`：" #: ../../deprecations/pending-removal-in-future.rst:52 msgid "" ":meth:`~datetime.datetime.utcnow`: use ``datetime.datetime.now(tz=datetime." "UTC)``." msgstr "" +":meth:`~datetime.datetime.utcnow`：請改用 ``datetime.datetime." +"now(tz=datetime.UTC)``。" #: ../../deprecations/pending-removal-in-future.rst:54 msgid "" ":meth:`~datetime.datetime.utcfromtimestamp`: use ``datetime.datetime." "fromtimestamp(timestamp, tz=datetime.UTC)``." msgstr "" +":meth:`~datetime.datetime.utcfromtimestamp`：請改用 ``datetime.datetime." +"fromtimestamp(timestamp, tz=datetime.UTC)``。" #: ../../deprecations/pending-removal-in-future.rst:57 msgid ":mod:`gettext`: Plural value must be an integer." -msgstr "" +msgstr ":mod:`gettext`：複數值必須是整數。" #: ../../deprecations/pending-removal-in-future.rst:59 -#, fuzzy msgid ":mod:`importlib`:" -msgstr ":mod:`importlib.abc`：" +msgstr ":mod:`importlib`：" #: ../../deprecations/pending-removal-in-future.rst:61 msgid "``load_module()`` method: use ``exec_module()`` instead." -msgstr "" +msgstr "``load_module()`` method：請改用 ``exec_module()``。" #: ../../deprecations/pending-removal-in-future.rst:62 msgid "" ":func:`~importlib.util.cache_from_source` *debug_override* parameter is " "deprecated: use the *optimization* parameter instead." msgstr "" +":func:`~importlib.util.cache_from_source` *debug_override* 參數已被棄用：請改" +"用 *optimization* 參數。" #: ../../deprecations/pending-removal-in-future.rst:65 -#, fuzzy msgid ":mod:`importlib.metadata`:" -msgstr ":mod:`importlib.abc`：" +msgstr ":mod:`importlib.metadata`：" #: ../../deprecations/pending-removal-in-future.rst:67 msgid "``EntryPoints`` tuple interface." -msgstr "" +msgstr "``EntryPoints`` 元組介面。" #: ../../deprecations/pending-removal-in-future.rst:68 msgid "Implicit ``None`` on return values." -msgstr "" +msgstr "回傳值上的隱式 ``None``。" #: ../../deprecations/pending-removal-in-future.rst:70 msgid "" ":mod:`mailbox`: Use of StringIO input and text mode is deprecated, use " "BytesIO and binary mode instead." msgstr "" +":mod:`mailbox`：已棄用 StringIO 輸入和文本模式，請改用 BytesIO 和二進位模式。" #: ../../deprecations/pending-removal-in-future.rst:73 msgid "" ":mod:`os`: Calling :func:`os.register_at_fork` in multi-threaded process." -msgstr "" +msgstr ":mod:`os`：在多執行緒行程中呼叫 :func:`os.register_at_fork`。" #: ../../deprecations/pending-removal-in-future.rst:75 msgid "" ":class:`!pydoc.ErrorDuringImport`: A tuple value for *exc_info* parameter is " "deprecated, use an exception instance." msgstr "" +":class:`!pydoc.ErrorDuringImport`：*exc_info* 參數的元組值已被棄用，請用例外" +"實例。" #: ../../deprecations/pending-removal-in-future.rst:78 msgid "" @@ -2461,184 +2575,189 @@ msgid "" "replacement strings can now only contain ASCII letters and digits and " "underscore. (Contributed by Serhiy Storchaka in :gh:`91760`.)" msgstr "" +":mod:`re`：現在對正規表示式中的數值群組參照和群組名稱用了更嚴格的規則。現在只" +"有 ASCII 數碼序列被接受作為數值參照。位元組模式和替換字串中的群組名稱現在只能" +"包含 ASCII 字母、數碼和底線。（由 Serhiy Storchaka 於 :gh:`91760` 貢獻。）" #: ../../deprecations/pending-removal-in-future.rst:85 msgid "" ":mod:`!sre_compile`, :mod:`!sre_constants` and :mod:`!sre_parse` modules." -msgstr "" +msgstr ":mod:`!sre_compile`、:mod:`!sre_constants` 和 :mod:`!sre_parse` 模組。" #: ../../deprecations/pending-removal-in-future.rst:87 msgid "" ":mod:`shutil`: :func:`~shutil.rmtree`'s *onerror* parameter is deprecated in " "Python 3.12; use the *onexc* parameter instead." msgstr "" +":mod:`shutil`：:func:`~shutil.rmtree` 的 *onerror* 參數在 Python 3.12 中已被" +"棄用；請改用 *onexc* 參數。" #: ../../deprecations/pending-removal-in-future.rst:90 msgid ":mod:`ssl` options and protocols:" -msgstr "" +msgstr ":mod:`ssl` 選項和協定：" #: ../../deprecations/pending-removal-in-future.rst:92 msgid ":class:`ssl.SSLContext` without protocol argument is deprecated." -msgstr "" +msgstr "不帶協定引數的 :class:`ssl.SSLContext` 已被棄用。" #: ../../deprecations/pending-removal-in-future.rst:93 msgid "" ":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` and :meth:" "`!selected_npn_protocol` are deprecated: use ALPN instead." msgstr "" +":class:`ssl.SSLContext`：:meth:`~ssl.SSLContext.set_npn_protocols` 和 :meth:" +"`!selected_npn_protocol` 已被棄用：請改用 ALPN。" #: ../../deprecations/pending-removal-in-future.rst:96 msgid "``ssl.OP_NO_SSL*`` options" -msgstr "" +msgstr "``ssl.OP_NO_SSL*`` 選項" #: ../../deprecations/pending-removal-in-future.rst:97 msgid "``ssl.OP_NO_TLS*`` options" -msgstr "" +msgstr "``ssl.OP_NO_TLS*`` 選項" #: ../../deprecations/pending-removal-in-future.rst:98 msgid "``ssl.PROTOCOL_SSLv3``" -msgstr "" +msgstr "``ssl.PROTOCOL_SSLv3``" #: ../../deprecations/pending-removal-in-future.rst:99 msgid "``ssl.PROTOCOL_TLS``" -msgstr "" +msgstr "``ssl.PROTOCOL_TLS``" #: ../../deprecations/pending-removal-in-future.rst:100 msgid "``ssl.PROTOCOL_TLSv1``" -msgstr "" +msgstr "``ssl.PROTOCOL_TLSv1``" #: ../../deprecations/pending-removal-in-future.rst:101 msgid "``ssl.PROTOCOL_TLSv1_1``" -msgstr "" +msgstr "``ssl.PROTOCOL_TLSv1_1``" #: ../../deprecations/pending-removal-in-future.rst:102 msgid "``ssl.PROTOCOL_TLSv1_2``" -msgstr "" +msgstr "``ssl.PROTOCOL_TLSv1_2``" #: ../../deprecations/pending-removal-in-future.rst:103 msgid "``ssl.TLSVersion.SSLv3``" -msgstr "" +msgstr "``ssl.TLSVersion.SSLv3``" #: ../../deprecations/pending-removal-in-future.rst:104 msgid "``ssl.TLSVersion.TLSv1``" -msgstr "" +msgstr "``ssl.TLSVersion.TLSv1``" #: ../../deprecations/pending-removal-in-future.rst:105 msgid "``ssl.TLSVersion.TLSv1_1``" -msgstr "" +msgstr "``ssl.TLSVersion.TLSv1_1``" #: ../../deprecations/pending-removal-in-future.rst:107 msgid "" ":func:`sysconfig.is_python_build` *check_home* parameter is deprecated and " "ignored." msgstr "" +":func:`sysconfig.is_python_build` 的 *check_home* 參數已被棄用並被忽略。" #: ../../deprecations/pending-removal-in-future.rst:110 -#, fuzzy msgid ":mod:`threading` methods:" -msgstr ":mod:`typing`：" +msgstr ":mod:`threading` 方法：" #: ../../deprecations/pending-removal-in-future.rst:112 msgid "" ":meth:`!threading.Condition.notifyAll`: use :meth:`~threading.Condition." "notify_all`." msgstr "" +":meth:`!threading.Condition.notifyAll`：請用 :meth:`~threading.Condition." +"notify_all`。" #: ../../deprecations/pending-removal-in-future.rst:113 msgid ":meth:`!threading.Event.isSet`: use :meth:`~threading.Event.is_set`." -msgstr "" +msgstr ":meth:`!threading.Event.isSet`：請用 :meth:`~threading.Event.is_set`。" #: ../../deprecations/pending-removal-in-future.rst:114 msgid "" ":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: use :" "attr:`threading.Thread.daemon` attribute." msgstr "" +":meth:`!threading.Thread.isDaemon`、:meth:`threading.Thread.setDaemon`：請" +"用 :attr:`threading.Thread.daemon` 屬性。" #: ../../deprecations/pending-removal-in-future.rst:116 msgid "" ":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: use :" "attr:`threading.Thread.name` attribute." msgstr "" +":meth:`!threading.Thread.getName`、:meth:`threading.Thread.setName`：請用 :" +"attr:`threading.Thread.name` 屬性。" #: ../../deprecations/pending-removal-in-future.rst:118 msgid ":meth:`!threading.currentThread`: use :meth:`threading.current_thread`." msgstr "" +":meth:`!threading.currentThread`：請用 :meth:`threading.current_thread`。" #: ../../deprecations/pending-removal-in-future.rst:119 msgid ":meth:`!threading.activeCount`: use :meth:`threading.active_count`." -msgstr "" +msgstr ":meth:`!threading.activeCount`：請用 :meth:`threading.active_count`。" #: ../../deprecations/pending-removal-in-future.rst:121 -#, fuzzy msgid ":class:`typing.Text` (:gh:`92332`)." -msgstr ":class:`typing.Text` (:gh:`92332`)" +msgstr ":class:`typing.Text` (:gh:`92332`)。" #: ../../deprecations/pending-removal-in-future.rst:123 msgid "" ":class:`unittest.IsolatedAsyncioTestCase`: it is deprecated to return a " "value that is not ``None`` from a test case." msgstr "" +":class:`unittest.IsolatedAsyncioTestCase`：從測試案例中回傳非 ``None`` 的值已" +"被棄用。" #: ../../deprecations/pending-removal-in-future.rst:126 msgid "" ":mod:`urllib.parse` deprecated functions: :func:`~urllib.parse.urlparse` " "instead" msgstr "" +":mod:`urllib.parse` 已棄用函式：請改用 :func:`~urllib.parse.urlparse`。" #: ../../deprecations/pending-removal-in-future.rst:128 -#, fuzzy msgid "``splitattr()``" -msgstr "``path()``" +msgstr "``splitattr()``" #: ../../deprecations/pending-removal-in-future.rst:129 -#, fuzzy msgid "``splithost()``" -msgstr "``path()``" +msgstr "``splithost()``" #: ../../deprecations/pending-removal-in-future.rst:130 -#, fuzzy msgid "``splitnport()``" -msgstr "``path()``" +msgstr "``splitnport()``" #: ../../deprecations/pending-removal-in-future.rst:131 -#, fuzzy msgid "``splitpasswd()``" -msgstr "``imp.reload()``" +msgstr "``splitpasswd()``" #: ../../deprecations/pending-removal-in-future.rst:132 -#, fuzzy msgid "``splitport()``" -msgstr "``path()``" +msgstr "``splitport()``" #: ../../deprecations/pending-removal-in-future.rst:133 -#, fuzzy msgid "``splitquery()``" -msgstr "``path()``" +msgstr "``splitquery()``" #: ../../deprecations/pending-removal-in-future.rst:134 -#, fuzzy msgid "``splittag()``" -msgstr "``imp.get_tag()``" +msgstr "``splittag()``" #: ../../deprecations/pending-removal-in-future.rst:135 -#, fuzzy msgid "``splittype()``" -msgstr "``path()``" +msgstr "``splittype()``" #: ../../deprecations/pending-removal-in-future.rst:136 -#, fuzzy msgid "``splituser()``" -msgstr "``path()``" +msgstr "``splituser()``" #: ../../deprecations/pending-removal-in-future.rst:137 -#, fuzzy msgid "``splitvalue()``" -msgstr "``path()``" +msgstr "``splitvalue()``" #: ../../deprecations/pending-removal-in-future.rst:138 -#, fuzzy msgid "``to_bytes()``" -msgstr "``contents()``" +msgstr "``to_bytes()``" #: ../../deprecations/pending-removal-in-future.rst:140 msgid "" @@ -2646,12 +2765,15 @@ msgid "" "`~urllib.request.FancyURLopener` style of invoking requests is deprecated. " "Use newer :func:`~urllib.request.urlopen` functions and methods." msgstr "" +":mod:`urllib.request`：呼叫請求的 :class:`~urllib.request.URLopener` 和 :" +"class:`~urllib.request.FancyURLopener` 風格已被棄用。請改用更新的 :func:" +"`~urllib.request.urlopen` 函式和方法。" #: ../../deprecations/pending-removal-in-future.rst:144 msgid "" ":mod:`wsgiref`: ``SimpleHandler.stdout.write()`` should not do partial " "writes." -msgstr "" +msgstr ":mod:`wsgiref`：``SimpleHandler.stdout.write()`` 不應該進行部分寫入。" #: ../../deprecations/pending-removal-in-future.rst:147 msgid "" @@ -2660,12 +2782,17 @@ msgid "" "return ``True``. Prefer explicit ``len(elem)`` or ``elem is not None`` tests " "instead." msgstr "" +":mod:`xml.etree.ElementTree`：已棄用對 :class:`~xml.etree.ElementTree." +"Element` 的真值測試。在未來版本中，它將始終回傳 ``True``。請改用明確的 " +"``len(elem)`` 或 ``elem is not None`` 測試。" #: ../../deprecations/pending-removal-in-future.rst:152 msgid "" ":meth:`zipimport.zipimporter.load_module` is deprecated: use :meth:" "`~zipimport.zipimporter.exec_module` instead." msgstr "" +":meth:`zipimport.zipimporter.load_module` 已被棄用：請改用 :meth:`~zipimport." +"zipimporter.exec_module`。" #: ../../whatsnew/3.12.rst:1355 ../../whatsnew/3.12.rst:2233 msgid "Removed" @@ -3487,7 +3614,7 @@ msgstr "" #: ../../whatsnew/3.12.rst:1792 msgid "Build Changes" -msgstr "" +msgstr "建置變更" #: ../../whatsnew/3.12.rst:1794 msgid "" @@ -4360,40 +4487,38 @@ msgid "" "The ``ma_version_tag`` field in :c:type:`PyDictObject` for extension modules " "(:pep:`699`; :gh:`101193`)." msgstr "" +":c:type:`PyDictObject` 中的 ``ma_version_tag`` 欄位，用於擴充模組 (:pep:" +"`699`；:gh:`101193`)。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:7 -#, fuzzy msgid "" "Creating :c:data:`immutable types ` with mutable " "bases (:gh:`95388`)." msgstr "" -"建立具有可變基底的\\ `不可變型別 ` (:gh:`95388`)。" +"使用可變基底建立\\ :c:data:`不可變型別 ` (:gh:" +"`95388`)。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:10 msgid "" "Functions to configure Python's initialization, deprecated in Python 3.11:" -msgstr "" +msgstr "設定 Python 初始化的函式，Python 3.11 中已被棄用：" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:12 -#, fuzzy msgid "``PySys_SetArgvEx()``: set :c:member:`PyConfig.argv` instead." -msgstr ":c:var:`Py_InspectFlag`: 請改用 :c:member:`PyConfig.inspect`" +msgstr "``PySys_SetArgvEx()``：請改以 :c:member:`PyConfig.argv` 設定。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:13 -#, fuzzy msgid "``PySys_SetArgv()``: set :c:member:`PyConfig.argv` instead." -msgstr ":c:var:`Py_InspectFlag`: 請改用 :c:member:`PyConfig.inspect`" +msgstr "``PySys_SetArgv()``：請改以 :c:member:`PyConfig.argv` 設定。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:14 msgid "``Py_SetProgramName()``: set :c:member:`PyConfig.program_name` instead." msgstr "" +"``Py_SetProgramName()``：請改以 :c:member:`PyConfig.program_name` 設定。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:15 -#, fuzzy msgid "``Py_SetPythonHome()``: set :c:member:`PyConfig.home` instead." -msgstr "" -":c:func:`Py_GetPythonHome`：取得 :c:member:`PyConfig.home` 或 :envvar:" -"`PYTHONHOME` 環境變數" +msgstr "``Py_SetPythonHome()``：請改以 :c:member:`PyConfig.home` 設定。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:17 #: ../../deprecations/c-api-pending-removal-in-3.14.rst:45 @@ -4401,391 +4526,345 @@ msgid "" "The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" "`PyConfig` instead." msgstr "" -":c:func:`Py_InitializeFromConfig` API 應改為與 :c:type:`PyConfig` 一起使用。" +":c:func:`Py_InitializeFromConfig` API 應該與 :c:type:`PyConfig` 一起使用。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:20 msgid "Global configuration variables:" -msgstr "全域配置變數：" +msgstr "全域設定變數：" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:22 -#, fuzzy msgid ":c:var:`Py_DebugFlag`: use :c:member:`PyConfig.parser_debug` instead." -msgstr ":c:var:`Py_DebugFlag`: 請改用 :c:member:`PyConfig.parser_debug`" +msgstr ":c:var:`Py_DebugFlag`：請改用 :c:member:`PyConfig.parser_debug`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:23 -#, fuzzy msgid ":c:var:`Py_VerboseFlag`: use :c:member:`PyConfig.verbose` instead." -msgstr ":c:var:`Py_VerboseFlag`: 請改用 :c:member:`PyConfig.verbose`" +msgstr ":c:var:`Py_VerboseFlag`：請改用 :c:member:`PyConfig.verbose`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:24 -#, fuzzy msgid ":c:var:`Py_QuietFlag`: use :c:member:`PyConfig.quiet` instead." -msgstr ":c:var:`Py_QuietFlag`: 請改用 :c:member:`PyConfig.quiet`" +msgstr ":c:var:`Py_QuietFlag`：請改用 :c:member:`PyConfig.quiet`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:25 -#, fuzzy msgid "" ":c:var:`Py_InteractiveFlag`: use :c:member:`PyConfig.interactive` instead." -msgstr ":c:var:`Py_InteractiveFlag`: 請改用 :c:member:`PyConfig.interactive`" +msgstr ":c:var:`Py_InteractiveFlag`：請改用 :c:member:`PyConfig.interactive`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:26 -#, fuzzy msgid ":c:var:`Py_InspectFlag`: use :c:member:`PyConfig.inspect` instead." -msgstr ":c:var:`Py_InspectFlag`: 請改用 :c:member:`PyConfig.inspect`" +msgstr ":c:var:`Py_InspectFlag`：請改用 :c:member:`PyConfig.inspect`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:27 -#, fuzzy msgid "" ":c:var:`Py_OptimizeFlag`: use :c:member:`PyConfig.optimization_level` " "instead." msgstr "" -":c:var:`Py_OptimizeFlag`: 請改用 :c:member:`PyConfig.optimization_level`" +":c:var:`Py_OptimizeFlag`：請改用 :c:member:`PyConfig.optimization_level`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:28 -#, fuzzy msgid ":c:var:`Py_NoSiteFlag`: use :c:member:`PyConfig.site_import` instead." -msgstr ":c:var:`Py_NoSiteFlag`: 請改用 :c:member:`PyConfig.site_import`" +msgstr ":c:var:`Py_NoSiteFlag`：請改用 :c:member:`PyConfig.site_import`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:29 -#, fuzzy msgid "" ":c:var:`Py_BytesWarningFlag`: use :c:member:`PyConfig.bytes_warning` instead." msgstr "" -":c:var:`Py_BytesWarningFlag`: 請改用 :c:member:`PyConfig.bytes_warning`" +":c:var:`Py_BytesWarningFlag`：請改用 :c:member:`PyConfig.bytes_warning`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:30 -#, fuzzy msgid "" ":c:var:`Py_FrozenFlag`: use :c:member:`PyConfig.pathconfig_warnings` instead." msgstr "" -":c:var:`Py_FrozenFlag`: 請改用 :c:member:`PyConfig.pathconfig_warnings`" +":c:var:`Py_FrozenFlag`：請改用 :c:member:`PyConfig.pathconfig_warnings`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:31 -#, fuzzy msgid "" ":c:var:`Py_IgnoreEnvironmentFlag`: use :c:member:`PyConfig.use_environment` " "instead." msgstr "" -":c:var:`Py_IgnoreEnvironmentFlag`: 請改用 :c:member:`PyConfig." -"use_environment`" +":c:var:`Py_IgnoreEnvironmentFlag`：請改用 :c:member:`PyConfig." +"use_environment`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:32 -#, fuzzy msgid "" ":c:var:`Py_DontWriteBytecodeFlag`: use :c:member:`PyConfig.write_bytecode` " "instead." msgstr "" -":c:var:`Py_DontWriteBytecodeFlag`: 請改用 :c:member:`PyConfig.write_bytecode`" +":c:var:`Py_DontWriteBytecodeFlag`：請改用 :c:member:`PyConfig." +"write_bytecode`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:33 -#, fuzzy msgid "" ":c:var:`Py_NoUserSiteDirectory`: use :c:member:`PyConfig." "user_site_directory` instead." msgstr "" -":c:var:`Py_NoUserSiteDirectory`: 請改用 :c:member:`PyConfig." -"user_site_directory`" +":c:var:`Py_NoUserSiteDirectory`：請改用 :c:member:`PyConfig." +"user_site_directory`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:34 -#, fuzzy msgid "" ":c:var:`Py_UnbufferedStdioFlag`: use :c:member:`PyConfig.buffered_stdio` " "instead." msgstr "" -":c:var:`Py_UnbufferedStdioFlag`: 請改用 :c:member:`PyConfig.buffered_stdio`" +":c:var:`Py_UnbufferedStdioFlag`：請改用 :c:member:`PyConfig.buffered_stdio`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:35 -#, fuzzy msgid "" ":c:var:`Py_HashRandomizationFlag`: use :c:member:`PyConfig.use_hash_seed` " "and :c:member:`PyConfig.hash_seed` instead." msgstr "" -":c:var:`Py_HashRandomizationFlag`: 請改用 :c:member:`PyConfig.use_hash_seed` " -"和 :c:member:`PyConfig.hash_seed`" +":c:var:`Py_HashRandomizationFlag`：請改用 :c:member:`PyConfig.use_hash_seed` " +"和 :c:member:`PyConfig.hash_seed`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:37 -#, fuzzy msgid ":c:var:`Py_IsolatedFlag`: use :c:member:`PyConfig.isolated` instead." -msgstr ":c:var:`Py_IsolatedFlag`: 請改用 :c:member:`PyConfig.isolated`" +msgstr ":c:var:`Py_IsolatedFlag`：請改用 :c:member:`PyConfig.isolated`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:38 -#, fuzzy msgid "" ":c:var:`Py_LegacyWindowsFSEncodingFlag`: use :c:member:`PyPreConfig." "legacy_windows_fs_encoding` instead." msgstr "" -":c:var:`Py_LegacyWindowsFSEncodingFlag`: 請改用 :c:member:`PyPreConfig." -"legacy_windows_fs_encoding`" +":c:var:`Py_LegacyWindowsFSEncodingFlag`：請改用 :c:member:`PyPreConfig." +"legacy_windows_fs_encoding`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:39 -#, fuzzy msgid "" ":c:var:`Py_LegacyWindowsStdioFlag`: use :c:member:`PyConfig." "legacy_windows_stdio` instead." msgstr "" -":c:var:`Py_LegacyWindowsStdioFlag`: 請改用 :c:member:`PyConfig." -"legacy_windows_stdio`" +":c:var:`Py_LegacyWindowsStdioFlag`：請改用 :c:member:`PyConfig." +"legacy_windows_stdio`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:40 -#, fuzzy msgid "" ":c:var:`!Py_FileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding` instead." msgstr "" -":c:var:`!Py_FileSystemDefaultEncoding`: 請改用 :c:member:`PyConfig." -"filesystem_encoding`" +":c:var:`!Py_FileSystemDefaultEncoding`：請改用 :c:member:`PyConfig." +"filesystem_encoding`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:41 -#, fuzzy msgid "" ":c:var:`!Py_HasFileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding` instead." msgstr "" -":c:var:`!Py_HasFileSystemDefaultEncoding`: 請改用 :c:member:`PyConfig." -"filesystem_encoding`" +":c:var:`!Py_HasFileSystemDefaultEncoding`：請改用 :c:member:`PyConfig." +"filesystem_encoding`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:42 -#, fuzzy msgid "" ":c:var:`!Py_FileSystemDefaultEncodeErrors`: use :c:member:`PyConfig." "filesystem_errors` instead." msgstr "" -":c:var:`!Py_FileSystemDefaultEncodeErrors`: 請改用 :c:member:`PyConfig." -"filesystem_errors`" +":c:var:`!Py_FileSystemDefaultEncodeErrors`：請改用 :c:member:`PyConfig." +"filesystem_errors`。" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:43 -#, fuzzy msgid "" ":c:var:`!Py_UTF8Mode`: use :c:member:`PyPreConfig.utf8_mode` instead. (see :" "c:func:`Py_PreInitialize`)" msgstr "" -":c:var:`!Py_UTF8Mode`: 請改用 :c:member:`PyPreConfig.utf8_mode`\\ （參見 :c:" +":c:var:`!Py_UTF8Mode`：請改用 :c:member:`PyPreConfig.utf8_mode`。（請見 :c:" "func:`Py_PreInitialize`）" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:4 msgid "The bundled copy of ``libmpdecimal``." -msgstr "" +msgstr "``libmpdecimal`` 的打包副本 (bundled copy)。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:5 -#, fuzzy msgid "" ":c:func:`PyImport_ImportModuleNoBlock`: use :c:func:`PyImport_ImportModule` " "instead." msgstr "" ":c:func:`PyImport_ImportModuleNoBlock`：請改用 :c:func:" -"`PyImport_ImportModule`" +"`PyImport_ImportModule`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:6 -#, fuzzy msgid "" ":c:func:`PyWeakref_GET_OBJECT`: use :c:func:`!PyWeakref_GetRef` instead." -msgstr ":c:func:`PyErr_Fetch`：請改用 :c:func:`PyErr_GetRaisedException`" +msgstr ":c:func:`PyWeakref_GET_OBJECT`：請改用 :c:func:`!PyWeakref_GetRef`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:7 -#, fuzzy msgid ":c:func:`PyWeakref_GetObject`: use :c:func:`!PyWeakref_GetRef` instead." -msgstr ":c:func:`PyErr_Fetch`：請改用 :c:func:`PyErr_GetRaisedException`" +msgstr ":c:func:`PyWeakref_GetObject`：請改用 :c:func:`!PyWeakref_GetRef`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:8 -#, fuzzy msgid ":c:type:`!Py_UNICODE_WIDE` type: use :c:type:`wchar_t` instead." -msgstr ":c:type:`!Py_UNICODE_WIDE` 型別：請改用 :c:type:`wchar_t`" +msgstr ":c:type:`!Py_UNICODE_WIDE` type：請改用 :c:type:`wchar_t`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:9 -#, fuzzy msgid ":c:type:`Py_UNICODE` type: use :c:type:`wchar_t` instead." -msgstr ":c:type:`Py_UNICODE` 型別：請改用 :c:type:`wchar_t`" +msgstr ":c:type:`Py_UNICODE` type：請改用 :c:type:`wchar_t`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:10 msgid "Python initialization functions:" msgstr "Python 初始化函式：" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:12 -#, fuzzy msgid "" ":c:func:`PySys_ResetWarnOptions`: clear :data:`sys.warnoptions` and :data:`!" "warnings.filters` instead." msgstr "" -":c:func:`PySys_ResetWarnOptions`：清除 :data:`sys.warnoptions` 和 :data:`!" -"warnings.filters`" +":c:func:`PySys_ResetWarnOptions`：請改為清除 :data:`sys.warnoptions` 和 :" +"data:`!warnings.filters`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:14 -#, fuzzy msgid ":c:func:`Py_GetExecPrefix`: get :data:`sys.exec_prefix` instead." -msgstr ":c:func:`Py_GetExecPrefix`：取得 :data:`sys.exec_prefix`" +msgstr ":c:func:`Py_GetExecPrefix`：請改用 :data:`sys.exec_prefix`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:15 -#, fuzzy msgid ":c:func:`Py_GetPath`: get :data:`sys.path` instead." -msgstr ":c:func:`Py_GetPath`：取得 :data:`sys.path`" +msgstr ":c:func:`Py_GetPath`：請改用 :data:`sys.path`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:16 -#, fuzzy msgid ":c:func:`Py_GetPrefix`: get :data:`sys.prefix` instead." -msgstr ":c:func:`Py_GetPrefix`：取得 :data:`sys.prefix`" +msgstr ":c:func:`Py_GetPrefix`：請改用 :data:`sys.prefix`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:17 -#, fuzzy msgid ":c:func:`Py_GetProgramFullPath`: get :data:`sys.executable` instead." -msgstr ":c:func:`Py_GetProgramFullPath`：取得 :data:`sys.executable`" +msgstr ":c:func:`Py_GetProgramFullPath`：請改用 :data:`sys.executable`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:18 -#, fuzzy msgid ":c:func:`Py_GetProgramName`: get :data:`sys.executable` instead." -msgstr ":c:func:`Py_GetProgramName`：取得 :data:`sys.executable`" +msgstr ":c:func:`Py_GetProgramName`：請改用 :data:`sys.executable`。" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:19 -#, fuzzy msgid "" ":c:func:`Py_GetPythonHome`: get :c:member:`PyConfig.home` or the :envvar:" "`PYTHONHOME` environment variable instead." msgstr "" -":c:func:`Py_GetPythonHome`：取得 :c:member:`PyConfig.home` 或 :envvar:" -"`PYTHONHOME` 環境變數" +":c:func:`Py_GetPythonHome`：請改用 :c:member:`PyConfig.home` 或 :envvar:" +"`PYTHONHOME` 環境變數。" #: ../../deprecations/c-api-pending-removal-in-future.rst:4 msgid "" "The following APIs are deprecated and will be removed, although there is " "currently no date scheduled for their removal." -msgstr "以下 API 已棄用，且將會被移除，雖目前尚未定下移除日期。" +msgstr "下列 API 已被棄用並將會被移除，不過目前尚未訂定移除日期。" #: ../../deprecations/c-api-pending-removal-in-future.rst:7 -#, fuzzy msgid ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`: unneeded since Python 3.8." msgstr ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`：自 Python 3.8 起不再需要" #: ../../deprecations/c-api-pending-removal-in-future.rst:8 -#, fuzzy msgid ":c:func:`PyErr_Fetch`: use :c:func:`PyErr_GetRaisedException` instead." -msgstr ":c:func:`PyErr_Fetch`：請改用 :c:func:`PyErr_GetRaisedException`" +msgstr ":c:func:`PyErr_Fetch`：請改用 :c:func:`PyErr_GetRaisedException`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:9 -#, fuzzy msgid "" ":c:func:`PyErr_NormalizeException`: use :c:func:`PyErr_GetRaisedException` " "instead." msgstr "" -":c:func:`PyErr_NormalizeException`：請改用 :c:func:`PyErr_GetRaisedException`" +":c:func:`PyErr_NormalizeException`：請改用 :c:func:" +"`PyErr_GetRaisedException`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:10 -#, fuzzy msgid "" ":c:func:`PyErr_Restore`: use :c:func:`PyErr_SetRaisedException` instead." -msgstr ":c:func:`PyErr_Restore`：請改用 :c:func:`PyErr_SetRaisedException`" +msgstr ":c:func:`PyErr_Restore`：請改用 :c:func:`PyErr_SetRaisedException`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:11 -#, fuzzy msgid "" ":c:func:`PyModule_GetFilename`: use :c:func:`PyModule_GetFilenameObject` " "instead." msgstr "" -":c:func:`PyModule_GetFilename`：請改用 :c:func:`PyModule_GetFilenameObject`" +":c:func:`PyModule_GetFilename`：請改用 :c:func:`PyModule_GetFilenameObject`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:12 -#, fuzzy msgid ":c:func:`PyOS_AfterFork`: use :c:func:`PyOS_AfterFork_Child` instead." -msgstr ":c:func:`PyOS_AfterFork`：請改用 :c:func:`PyOS_AfterFork_Child`" +msgstr ":c:func:`PyOS_AfterFork`：請改用 :c:func:`PyOS_AfterFork_Child`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:13 -#, fuzzy msgid "" ":c:func:`PySlice_GetIndicesEx`: use :c:func:`PySlice_Unpack` and :c:func:" "`PySlice_AdjustIndices` instead." msgstr "" ":c:func:`PySlice_GetIndicesEx`：請改用 :c:func:`PySlice_Unpack` 和 :c:func:" -"`PySlice_AdjustIndices`" +"`PySlice_AdjustIndices`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:14 -#, fuzzy msgid "" ":c:func:`!PyUnicode_AsDecodedObject`: use :c:func:`PyCodec_Decode` instead." -msgstr ":c:func:`!PyUnicode_AsDecodedObject`：請改用 :c:func:`PyCodec_Decode`" +msgstr "" +":c:func:`!PyUnicode_AsDecodedObject`：請改用 :c:func:`PyCodec_Decode`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:15 -#, fuzzy msgid "" ":c:func:`!PyUnicode_AsDecodedUnicode`: use :c:func:`PyCodec_Decode` instead." -msgstr ":c:func:`!PyUnicode_AsDecodedUnicode`：請改用 :c:func:`PyCodec_Decode`" +msgstr "" +":c:func:`!PyUnicode_AsDecodedUnicode`：請改用 :c:func:`PyCodec_Decode`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:16 -#, fuzzy msgid "" ":c:func:`!PyUnicode_AsEncodedObject`: use :c:func:`PyCodec_Encode` instead." -msgstr ":c:func:`!PyUnicode_AsEncodedObject`：請改用 :c:func:`PyCodec_Encode`" +msgstr "" +":c:func:`!PyUnicode_AsEncodedObject`：請改用 :c:func:`PyCodec_Encode`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:17 -#, fuzzy msgid "" ":c:func:`!PyUnicode_AsEncodedUnicode`: use :c:func:`PyCodec_Encode` instead." -msgstr ":c:func:`!PyUnicode_AsEncodedUnicode`：請改用 :c:func:`PyCodec_Encode`" +msgstr "" +":c:func:`!PyUnicode_AsEncodedUnicode`：請改用 :c:func:`PyCodec_Encode`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:18 msgid ":c:func:`PyUnicode_READY`: unneeded since Python 3.12" msgstr ":c:func:`PyUnicode_READY`：自 Python 3.12 起不再需要" #: ../../deprecations/c-api-pending-removal-in-future.rst:19 -#, fuzzy msgid ":c:func:`!PyErr_Display`: use :c:func:`PyErr_DisplayException` instead." -msgstr ":c:func:`!PyErr_Display`：請改用 :c:func:`PyErr_DisplayException`" +msgstr ":c:func:`!PyErr_Display`：請改用 :c:func:`PyErr_DisplayException`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:20 -#, fuzzy msgid "" ":c:func:`!_PyErr_ChainExceptions`: use ``_PyErr_ChainExceptions1`` instead." -msgstr ":c:func:`!_PyErr_ChainExceptions`：請改用 ``_PyErr_ChainExceptions1``" +msgstr "" +":c:func:`!_PyErr_ChainExceptions`：請改用 ``_PyErr_ChainExceptions1``。" #: ../../deprecations/c-api-pending-removal-in-future.rst:21 -#, fuzzy msgid "" ":c:member:`!PyBytesObject.ob_shash` member: call :c:func:`PyObject_Hash` " "instead." msgstr "" -":c:member:`!PyBytesObject.ob_shash` 成員：請改用 :c:func:`PyObject_Hash`" +":c:member:`!PyBytesObject.ob_shash` 成員：請改為呼叫 :c:func:" +"`PyObject_Hash`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:23 -#, fuzzy msgid ":c:member:`!PyDictObject.ma_version_tag` member." -msgstr ":c:member:`!PyDictObject.ma_version_tag` 成員" +msgstr ":c:member:`!PyDictObject.ma_version_tag` 成員。" #: ../../deprecations/c-api-pending-removal-in-future.rst:24 msgid "Thread Local Storage (TLS) API:" -msgstr "" +msgstr "執行緒局部儲存 (Thread Local Storage, TLS) API：" #: ../../deprecations/c-api-pending-removal-in-future.rst:26 -#, fuzzy msgid "" ":c:func:`PyThread_create_key`: use :c:func:`PyThread_tss_alloc` instead." -msgstr ":c:func:`PyThread_create_key`：請改用 :c:func:`PyThread_tss_alloc`" +msgstr ":c:func:`PyThread_create_key`：請改用 :c:func:`PyThread_tss_alloc`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:27 -#, fuzzy msgid ":c:func:`PyThread_delete_key`: use :c:func:`PyThread_tss_free` instead." -msgstr ":c:func:`PyThread_delete_key`：請改用 :c:func:`PyThread_tss_free`" +msgstr ":c:func:`PyThread_delete_key`：請改用 :c:func:`PyThread_tss_free`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:28 -#, fuzzy msgid "" ":c:func:`PyThread_set_key_value`: use :c:func:`PyThread_tss_set` instead." -msgstr ":c:func:`PyThread_set_key_value`：請改用 :c:func:`PyThread_tss_set`" +msgstr ":c:func:`PyThread_set_key_value`：請改用 :c:func:`PyThread_tss_set`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:29 -#, fuzzy msgid "" ":c:func:`PyThread_get_key_value`: use :c:func:`PyThread_tss_get` instead." -msgstr ":c:func:`PyThread_get_key_value`：請改用 :c:func:`PyThread_tss_get`" +msgstr ":c:func:`PyThread_get_key_value`：請改用 :c:func:`PyThread_tss_get`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:30 -#, fuzzy msgid "" ":c:func:`PyThread_delete_key_value`: use :c:func:`PyThread_tss_delete` " "instead." msgstr "" -":c:func:`PyThread_delete_key_value`：請改用 :c:func:`PyThread_tss_delete`" +":c:func:`PyThread_delete_key_value`：請改用 :c:func:`PyThread_tss_delete`。" #: ../../deprecations/c-api-pending-removal-in-future.rst:31 -#, fuzzy msgid ":c:func:`PyThread_ReInitTLS`: unneeded since Python 3.7." -msgstr ":c:func:`PyThread_ReInitTLS`：自 Python 3.7 起不再需要" +msgstr ":c:func:`PyThread_ReInitTLS`：自 Python 3.7 起不再需要。" #: ../../whatsnew/3.12.rst:2235 msgid "" @@ -4844,7 +4923,7 @@ msgstr "" #: ../../whatsnew/3.12.rst:2256 msgid "Notable changes in 3.12.4" -msgstr "3.12.4 中的明顯變更" +msgstr "3.12.4 中的顯著變更" #: ../../whatsnew/3.12.rst:2259 msgid "ipaddress" @@ -4859,13 +4938,12 @@ msgstr "" "的 ``is_global`` 和 ``is_private`` 行為。" #: ../../whatsnew/3.12.rst:2266 -#, fuzzy msgid "Notable changes in 3.12.5" -msgstr "3.12.4 中的明顯變更" +msgstr "3.12.5 中的顯著變更" #: ../../whatsnew/3.12.rst:2269 msgid "email" -msgstr "" +msgstr "email" #: ../../whatsnew/3.12.rst:2272 msgid "Headers with embedded newlines are now quoted on output." @@ -4880,89 +4958,3 @@ msgid "" "verify_generated_headers`. (Contributed by Bas Bloemsaat and Petr Viktorin " "in :gh:`121650`.)" msgstr "" - -#~ msgid "" -#~ "The following modules and APIs have been deprecated in earlier Python " -#~ "releases, and will be removed in Python 3.13." -#~ msgstr "" -#~ "以下模組和 API 在早期的 Python 版本中已被棄用，並將在 Python 3.13 中刪除。" - -#~ msgid "" -#~ "The following APIs have been deprecated and will be removed in Python " -#~ "3.14." -#~ msgstr "以下 API 已被棄用並將在 Python 3.14 中移除。" - -#~ msgid ":class:`!asyncio.MultiLoopChildWatcher`" -#~ msgstr ":class:`!asyncio.MultiLoopChildWatcher`" - -#~ msgid ":class:`!asyncio.FastChildWatcher`" -#~ msgstr ":class:`!asyncio.FastChildWatcher`" - -#~ msgid ":class:`!asyncio.AbstractChildWatcher`" -#~ msgstr ":class:`!asyncio.AbstractChildWatcher`" - -#~ msgid ":class:`!asyncio.SafeChildWatcher`" -#~ msgstr ":class:`!asyncio.SafeChildWatcher`" - -#~ msgid ":func:`!asyncio.set_child_watcher`" -#~ msgstr ":func:`!asyncio.set_child_watcher`" - -#~ msgid ":func:`!asyncio.get_child_watcher`," -#~ msgstr ":func:`!asyncio.get_child_watcher`、" - -#~ msgid ":meth:`!asyncio.AbstractEventLoopPolicy.set_child_watcher`" -#~ msgstr ":meth:`!asyncio.AbstractEventLoopPolicy.set_child_watcher`" - -#~ msgid ":meth:`!asyncio.AbstractEventLoopPolicy.get_child_watcher`" -#~ msgstr ":meth:`!asyncio.AbstractEventLoopPolicy.get_child_watcher`" - -#~ msgid ":mod:`collections.abc`: :class:`!collections.abc.ByteString`." -#~ msgstr ":mod:`collections.abc`: :class:`!collections.abc.ByteString`。" - -#~ msgid "" -#~ ":mod:`email`: the *isdst* parameter in :func:`email.utils.localtime`." -#~ msgstr ":mod:`email`：:func:`email.utils.localtime` 中的 *isdst* 參數。" - -#~ msgid ":mod:`itertools`: Support for copy, deepcopy, and pickle operations." -#~ msgstr ":mod:`itertools`：支援複製、深度複製 (deepcopy) 和 pickle 操作。" - -#~ msgid ":mod:`pkgutil`:" -#~ msgstr ":mod:`pkgutil`：" - -#~ msgid ":func:`!pkgutil.find_loader`" -#~ msgstr ":func:`!pkgutil.find_loader`" - -#~ msgid ":func:`!pkgutil.get_loader`." -#~ msgstr ":func:`!pkgutil.get_loader`。" - -#~ msgid ":func:`!pty.master_open`" -#~ msgstr ":func:`!pty.master_open`" - -#~ msgid ":func:`!pty.slave_open`" -#~ msgstr ":func:`!pty.slave_open`" - -#~ msgid ":mod:`shutil`: The *onerror* argument of :func:`shutil.rmtree`" -#~ msgstr ":mod:`shutil`：:func:`shutil.rmtree` 的 *onerror* 引數" - -#~ msgid ":mod:`typing`: :class:`!typing.ByteString`" -#~ msgstr ":mod:`typing`：:class:`!typing.ByteString`" - -#~ msgid "" -#~ ":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`xml." -#~ "etree.ElementTree.Element`." -#~ msgstr "" -#~ ":mod:`xml.etree.ElementTree`：測試 :class:`xml.etree.ElementTree.Element` " -#~ "的真值。" - -#~ msgid "The ``__package__`` and ``__cached__`` attributes on module objects." -#~ msgstr "模組物件上的 ``__package__`` 和 ``__cached__`` 屬性。" - -#~ msgid ":func:`locale.getdefaultlocale` (:gh:`90817`)" -#~ msgstr ":func:`locale.getdefaultlocale` (:gh:`90817`)" - -#~ msgid "" -#~ "The following APIs were deprecated in earlier Python versions and will be " -#~ "removed, although there is currently no date scheduled for their removal." -#~ msgstr "" -#~ "以下 API 在早期 Python 版本中已棄用，並將被刪除，但目前還沒有計劃刪除它們" -#~ "的日期。" diff --git a/whatsnew/3.7.po b/whatsnew/3.7.po index 60abd1fada..789ecaef6f 100644 --- a/whatsnew/3.7.po +++ b/whatsnew/3.7.po @@ -2490,7 +2490,7 @@ msgstr "" #: ../../whatsnew/3.7.rst:1758 msgid "Build Changes" -msgstr "" +msgstr "建置變更" #: ../../whatsnew/3.7.rst:1760 msgid "" diff --git a/whatsnew/3.8.po b/whatsnew/3.8.po index fa0fb7888a..789da68496 100644 --- a/whatsnew/3.8.po +++ b/whatsnew/3.8.po @@ -2930,7 +2930,7 @@ msgstr "" #: ../../whatsnew/3.8.rst:2307 msgid "urllib.parse" -msgstr "" +msgstr "urllib.parse" #: ../../whatsnew/3.8.rst:2309 msgid "" diff --git a/whatsnew/3.9.po b/whatsnew/3.9.po index f64f21aa1b..239234ce35 100644 --- a/whatsnew/3.9.po +++ b/whatsnew/3.9.po @@ -1740,7 +1740,7 @@ msgstr "（由 Mark Shannon 在 :issue:`39156` 中貢獻。）" #: ../../whatsnew/3.9.rst:1222 msgid "Build Changes" -msgstr "" +msgstr "建置變更" #: ../../whatsnew/3.9.rst:1224 msgid "" From 3ccc989d477dba7213b249e9ea770a5491e39d42 Mon Sep 17 00:00:00 2001 From: Matt Wang Date: Sat, 17 Aug 2024 02:31:06 +0800 Subject: [PATCH 23/28] chore: amend translation to align with conventions --- bugs.po | 32 ++++++++++++++++---------------- c-api/bytearray.po | 7 ++----- c-api/init.po | 2 +- c-api/long.po | 2 +- c-api/module.po | 13 ++++++------- c-api/object.po | 2 +- c-api/slice.po | 4 ++-- extending/index.po | 4 ++-- faq/windows.po | 2 +- howto/regex.po | 18 +++++++++--------- installing/index.po | 2 +- library/_thread.po | 2 +- library/cmath.po | 2 +- library/functions.po | 6 +++--- library/logging.po | 2 +- library/math.po | 2 +- library/ssl.po | 4 ++-- library/string.po | 2 +- library/wave.po | 2 +- library/zlib.po | 2 +- license.po | 2 +- tutorial/appendix.po | 2 +- tutorial/classes.po | 2 +- tutorial/index.po | 6 +++--- tutorial/interpreter.po | 2 +- tutorial/whatnow.po | 4 ++-- 26 files changed, 63 insertions(+), 67 deletions(-) diff --git a/bugs.po b/bugs.po index 67de6f1e46..b040a99bb9 100644 --- a/bugs.po +++ b/bugs.po @@ -36,7 +36,7 @@ msgid "" "like to know of any deficiencies you find in Python." msgstr "" "Python 已經是一個以穩定著稱的成熟程式語言。為了維持「穩定」的信譽，開發者們想" -"知道任何您在 Python 中發現的缺失。" +"知道任何你在 Python 中發現的缺失。" #: ../../bugs.rst:11 msgid "" @@ -58,8 +58,8 @@ msgid "" "improvement, please submit a bug report on the :ref:`tracker `. If you have a suggestion on how to fix it, include that as well." msgstr "" -"如果您在這份說明文件中發現了錯誤並想要幫助我們改進，請將錯誤報告提交到\\ :" -"ref:`追蹤系統 (tracker) `。如果您有相應的修正建議，請一併" +"如果你在這份說明文件中發現了錯誤並想要幫助我們改進，請將錯誤報告提交到\\ :" +"ref:`追蹤系統 (tracker) `。如果你有相應的修正建議，請一併" "提交。（譯者註：如果是繁體中文說明文件翻譯相關的錯誤，請提交到 https://" "github.com/python/python-docs-zh-tw/issues。）" @@ -85,9 +85,9 @@ msgid "" "'docs@' is a mailing list run by volunteers; your request will be noticed, " "though it may take a while to be processed." msgstr "" -"如果您的時間有限，也可以將說明文件的錯誤報告以電子郵件寄到 docs@python.org\\ " +"如果你的時間有限，也可以將說明文件的錯誤報告以電子郵件寄到 docs@python.org\\ " "（程式碼執行的錯誤可以寄到 python-list@python.org）。「docs@」是一個由志工們" -"所運行的郵寄清單；您的請求會被注意到，但可能需要一些時間才會被處理。" +"所運行的郵寄清單；你的請求會被注意到，但可能需要一些時間才會被處理。" #: ../../bugs.rst:36 msgid "`Documentation bugs`_" @@ -163,9 +163,9 @@ msgid "" "page." msgstr "" "填寫報告的第一步，是確認該問題是否已經被回報過了。這樣做的好處，除了可以節省" -"開發者的時間，也能讓您了解目前關於該問題的處理進度；有可能已經在下一個發行版" +"開發者的時間，也能讓你了解目前關於該問題的處理進度；有可能已經在下一個發行版" "本中修正了這個問題，也有可能需要更詳細的資訊（在這種情況下，如果可以，非常歡" -"迎您提供資訊！）。要確認是否重複回報，請使用頁面頂端的搜尋框來搜尋追蹤系統。" +"迎你提供資訊！）。要確認是否重複回報，請使用頁面頂端的搜尋框來搜尋追蹤系統。" #: ../../bugs.rst:66 msgid "" @@ -174,15 +174,15 @@ msgid "" "using the \"Sign up\" link. It is not possible to submit a bug report " "anonymously." msgstr "" -"如果您想回報的問題還沒有在問題列表出現過，請登入 GitHub。如果您還沒有 GitHub " -"帳戶，請點選「Sign up」連結來建立一個新的帳戶。您無法以匿名方式提交錯誤報告。" +"如果你想回報的問題還沒有在問題列表出現過，請登入 GitHub。如果你還沒有 GitHub " +"帳戶，請點選「Sign up」連結來建立一個新的帳戶。你無法以匿名方式提交錯誤報告。" #: ../../bugs.rst:71 msgid "" "Being now logged in, you can submit an issue. Click on the \"New issue\" " "button in the top bar to report a new issue." msgstr "" -"如果已經登入，那您就可以提交問題了。請點選列表頂端區域的「New issue」按鈕，來" +"如果已經登入，那你就可以提交問題了。請點選列表頂端區域的「New issue」按鈕，來" "回報一個新的問題。" #: ../../bugs.rst:74 @@ -203,8 +203,8 @@ msgid "" "extension modules were involved, and what hardware and software platform you " "were using (including version information as appropriate)." msgstr "" -"在「Comment」欄位，請詳細描述該問題，包括您預期發生的情況和實際發生的情況。請" -"確定說明中包含了涉及到的任何擴充模組，以及您當時所使用的硬體和軟體平台（視情" +"在「Comment」欄位，請詳細描述該問題，包括你預期發生的情況和實際發生的情況。請" +"確定說明中包含了涉及到的任何擴充模組，以及你當時所使用的硬體和軟體平台（視情" "況而定，可以附上版本資訊）。" #: ../../bugs.rst:84 @@ -214,7 +214,7 @@ msgid "" "time an action is taken on the issue." msgstr "" "每一份問題報告都會被一位開發人員查核，並由他決定要做出什麼變更來修正這個問" -"題。每當該問題有修正動作時，您會收到更新回報。" +"題。每當該問題有修正動作時，你會收到更新回報。" #: ../../bugs.rst:91 msgid "" @@ -259,7 +259,7 @@ msgid "" "the `core-mentorship mailing list`_ is a friendly place to get answers to " "any and all questions pertaining to the process of fixing issues in Python." msgstr "" -"除了只是回報您所發現的錯誤之外，同樣也歡迎您提交修正它們的修補程式 (patch)。" -"您可以在 `Python 開發者指南`_\\ 中找到如何開始修補 Python 的更多資訊。如果您" -"有任何問題，`核心導師郵寄清單`_\\ 是一個友善的地方，您可以在那裡得到，關於 " +"除了只是回報你所發現的錯誤之外，同樣也歡迎你提交修正它們的修補程式 (patch)。" +"你可以在 `Python 開發者指南`_\\ 中找到如何開始修補 Python 的更多資訊。如果你" +"有任何問題，`核心導師郵寄清單`_\\ 是一個友善的地方，你可以在那裡得到，關於 " "Python 修正錯誤的過程中，所有問題的答案。" diff --git a/c-api/bytearray.po b/c-api/bytearray.po index f32090bde8..b99829a933 100644 --- a/c-api/bytearray.po +++ b/c-api/bytearray.po @@ -71,14 +71,11 @@ msgstr "" #: ../../c-api/bytearray.rst:45 ../../c-api/bytearray.rst:52 #: ../../c-api/bytearray.rst:59 msgid "On failure, return ``NULL`` with an exception set." -msgstr "" +msgstr "在失敗時，會回傳 ``NULL`` 並設定例外。" #: ../../c-api/bytearray.rst:50 -#, fuzzy msgid "Create a new bytearray object from *string* and its length, *len*." -msgstr "" -"從 *string* 及其長度 *len* 建立一個新的位元組陣列物件。若失敗則回傳 " -"``NULL``。" +msgstr "從 *string* 及其長度 *len* 建立一個新的位元組陣列物件。" #: ../../c-api/bytearray.rst:57 msgid "" diff --git a/c-api/init.po b/c-api/init.po index be887b4ae4..49bf5d534c 100644 --- a/c-api/init.po +++ b/c-api/init.po @@ -2496,7 +2496,7 @@ msgstr "" #: ../../c-api/init.rst:2177 msgid "Thread Local Storage (TLS) API" -msgstr "" +msgstr "執行緒局部儲存 (Thread Local Storage, TLS) API：" #: ../../c-api/init.rst:2179 msgid "" diff --git a/c-api/long.po b/c-api/long.po index 4c722396b8..dc269967a2 100644 --- a/c-api/long.po +++ b/c-api/long.po @@ -343,7 +343,7 @@ msgstr "" #: ../../c-api/long.rst:333 msgid "On failure, return ``NULL`` with an exception set." -msgstr "" +msgstr "在失敗時，會回傳 ``NULL`` 並設定例外。" #: ../../c-api/long.rst:340 msgid "Return 1 if *op* is compact, 0 otherwise." diff --git a/c-api/module.po b/c-api/module.po index 538fd60d58..46245beb3f 100644 --- a/c-api/module.po +++ b/c-api/module.po @@ -1,5 +1,4 @@ -# SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2022, Python Software Foundation +# Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # # Translators: @@ -21,7 +20,7 @@ msgstr "" #: ../../c-api/module.rst:6 msgid "Module Objects" -msgstr "模組物件模組" +msgstr "模組物件" #: ../../c-api/module.rst:15 msgid "" @@ -53,7 +52,7 @@ msgstr "" #: ../../c-api/module.rst:46 ../../c-api/module.rst:270 #: ../../c-api/module.rst:445 msgid "Return ``NULL`` with an exception set on error." -msgstr "" +msgstr "在失敗時回傳 ``NULL`` 並設定例外。" #: ../../c-api/module.rst:50 msgid ":attr:`__package__` and :attr:`__loader__` are set to ``None``." @@ -128,7 +127,7 @@ msgstr "" #: ../../c-api/module.rst:131 msgid "Initializing C modules" -msgstr "" +msgstr "初始化 C 模組" #: ../../c-api/module.rst:133 msgid "" @@ -636,7 +635,7 @@ msgstr "" #: ../../c-api/module.rst:626 msgid "Module lookup" -msgstr "" +msgstr "模組查找" #: ../../c-api/module.rst:628 msgid "" @@ -689,7 +688,7 @@ msgstr "" #: ../../c-api/module.rst:659 msgid "Return ``-1`` with an exception set on error, ``0`` on success." -msgstr "" +msgstr "成功時回傳 ``0``，在失敗時回傳 ``-1`` 並設定例外。" #: ../../c-api/module.rst:665 msgid "" diff --git a/c-api/object.po b/c-api/object.po index 716eac90a8..eb0e3cc2c1 100644 --- a/c-api/object.po +++ b/c-api/object.po @@ -172,7 +172,7 @@ msgstr "" #: ../../c-api/object.rst:147 msgid "On failure, returns ``NULL`` with an exception set." -msgstr "" +msgstr "在失敗時，會回傳 ``NULL`` 並設定例外。" #: ../../c-api/object.rst:154 msgid "" diff --git a/c-api/slice.po b/c-api/slice.po index 62308eddf9..bd0ac6fc7e 100644 --- a/c-api/slice.po +++ b/c-api/slice.po @@ -83,7 +83,7 @@ msgstr "" #: ../../c-api/slice.rst:57 msgid "Return ``0`` on success and ``-1`` on error with an exception set." -msgstr "" +msgstr "成功時回傳 ``0`` ，在失敗時回傳 ``-1`` 並設定例外。" #: ../../c-api/slice.rst:60 msgid "" @@ -123,7 +123,7 @@ msgstr "" #: ../../c-api/slice.rst:100 msgid "Return ``-1`` with an exception set on error, ``0`` on success." -msgstr "" +msgstr "成功時回傳 ``0``，在失敗時回傳 ``-1`` 並設定例外。" #: ../../c-api/slice.rst:107 msgid "" diff --git a/extending/index.po b/extending/index.po index 50975d87e3..51fce044dc 100644 --- a/extending/index.po +++ b/extending/index.po @@ -48,7 +48,7 @@ msgid "" "documents the existing object types, functions and modules (both built-in " "and written in Python) that give the language its wide application range." msgstr "" -"這份說明文件假設您具備 Python 的基礎知識。關於此語言的非正式介紹，請參閱 :" +"這份說明文件假設你具備 Python 的基礎知識。關於此語言的非正式介紹，請參閱 :" "ref:`tutorial-index`。:ref:`reference-index`\\ 給予此語言更為正式的定義。:" "ref:`library-index` 記錄了賦予此語言廣泛應用範圍的物件型別、函式與（內建的和" "以 Python 編寫的）模組。" @@ -91,7 +91,7 @@ msgid "" "reasons why creating an extension module may be desirable in the first place." msgstr "" "Python 封裝使用者指南 (Python Packaging User Guide) 不僅涵蓋了數個可以用來簡" -"化二進制擴充建立過程的工具，也會討論為何建立一個擴充模組可能會是您的優先考" +"化二進制擴充建立過程的工具，也會討論為何建立一個擴充模組可能會是你的優先考" "量。" #: ../../extending/index.rst:45 diff --git a/faq/windows.po b/faq/windows.po index 84065e0718..c727619395 100644 --- a/faq/windows.po +++ b/faq/windows.po @@ -204,7 +204,7 @@ msgid "" msgstr "" "這個問題可能是由發生此問題的電腦上的病毒檢查軟體配置錯誤所引起的。目前已知某" "些病毒掃描程式，在它們被配置為監視來自檔案系統的所有讀取時，會引入兩個數量級" -"的啟動負擔。請試著檢查您系統上的病毒掃描軟體配置，以確保它們的配置確實相同。" +"的啟動負擔。請試著檢查你系統上的病毒掃描軟體配置，以確保它們的配置確實相同。" "當 McAfee 被配置為掃描所有檔案系統的讀取活動時，它是一個特定的違規者。" #: ../../faq/windows.rst:141 diff --git a/howto/regex.po b/howto/regex.po index 32e9cc6be4..1e193d2328 100644 --- a/howto/regex.po +++ b/howto/regex.po @@ -22,7 +22,7 @@ msgstr "" #: ../../howto/regex.rst:5 msgid "Regular Expression HOWTO" -msgstr "如何使用正規表達式" +msgstr "如何使用正規表示式" #: ../../howto/regex.rst:0 msgid "Author" @@ -42,7 +42,7 @@ msgid "" "Python with the :mod:`re` module. It provides a gentler introduction than " "the corresponding section in the Library Reference." msgstr "" -"此文件為如何在 Python 中使用 :mod:`re` 模組來撰寫正規表達式的入門指導。進階使" +"此文件為如何在 Python 中使用 :mod:`re` 模組來撰寫正規表示式的入門指導。進階使" "用及參考文件請見函式庫參考一章。" #: ../../howto/regex.rst:24 @@ -922,13 +922,13 @@ msgid "" "letters, too. Full Unicode matching also works unless the :const:`ASCII` " "flag is used to disable non-ASCII matches. When the Unicode patterns ``[a-" "z]`` or ``[A-Z]`` are used in combination with the :const:`IGNORECASE` flag, " -"they will match the 52 ASCII letters and 4 additional non-ASCII letters: " -"'İ' (U+0130, Latin capital letter I with dot above), 'ı' (U+0131, Latin " -"small letter dotless i), 'ſ' (U+017F, Latin small letter long s) and " -"'K' (U+212A, Kelvin sign). ``Spam`` will match ``'Spam'``, ``'spam'``, " -"``'spAM'``, or ``'ſpam'`` (the latter is matched only in Unicode mode). This " -"lowercasing doesn't take the current locale into account; it will if you " -"also set the :const:`LOCALE` flag." +"they will match the 52 ASCII letters and 4 additional non-ASCII letters: 'İ' " +"(U+0130, Latin capital letter I with dot above), 'ı' (U+0131, Latin small " +"letter dotless i), 'ſ' (U+017F, Latin small letter long s) and 'K' (U+212A, " +"Kelvin sign). ``Spam`` will match ``'Spam'``, ``'spam'``, ``'spAM'``, or " +"``'ſpam'`` (the latter is matched only in Unicode mode). This lowercasing " +"doesn't take the current locale into account; it will if you also set the :" +"const:`LOCALE` flag." msgstr "" #: ../../howto/regex.rst:581 diff --git a/installing/index.po b/installing/index.po index 7029017624..730c860782 100644 --- a/installing/index.po +++ b/installing/index.po @@ -60,7 +60,7 @@ msgid "" "creating and sharing your own Python projects, refer to the `Python " "packaging user guide`_." msgstr "" -"這份指南涵蓋了上述過程中的安裝部分。如果是要建立及分享您自己的 Python 專案，" +"這份指南涵蓋了上述過程中的安裝部分。如果是要建立及分享你自己的 Python 專案，" "請參考 `Python packaging user guide`_。" #: ../../installing/index.rst:28 diff --git a/library/_thread.po b/library/_thread.po index f0c9f44e0b..5ae5711abd 100644 --- a/library/_thread.po +++ b/library/_thread.po @@ -135,7 +135,7 @@ msgid "" "associated handler (if it exists). If you want to truly emit the signal, " "use :func:`signal.raise_signal`." msgstr "" -"這並不會發出對應的訊號，而是安排呼叫相應的處理器（如果存在的話）。如果您想真" +"這並不會發出對應的訊號，而是安排呼叫相應的處理器（如果存在的話）。如果你想真" "正發出訊號，請使用 :func:`signal.raise_signal`。" #: ../../library/_thread.rst:90 diff --git a/library/cmath.po b/library/cmath.po index f77646f1ee..2921911ca2 100644 --- a/library/cmath.po +++ b/library/cmath.po @@ -396,7 +396,7 @@ msgid "" "following:" msgstr "" "關於分枝切割的註釋：它們是沿著給定的不連續函式的曲線。它們是許多複變函數的必" -"要特徵。假設您需要使用複變函數進行計算，您將會了解分枝切割的概念。請參閱幾乎" +"要特徵。假設你需要使用複變函數進行計算，你將會了解分枝切割的概念。請參閱幾乎" "所有關於複變函數的（不是太初級的）書籍以獲得啟發。對於如何正確地基於數值目的" "選擇分枝切割的相關訊息，以下內容應該是一個很好的參考：" diff --git a/library/functions.po b/library/functions.po index 4d9586045c..df411e73a0 100644 --- a/library/functions.po +++ b/library/functions.po @@ -836,7 +836,7 @@ msgstr "" msgid "" "If you want to parse Python code into its AST representation, see :func:`ast." "parse`." -msgstr "如果您想解析 Python 程式碼為 AST 運算式，請參閱 :func:`ast.parse`。" +msgstr "如果你想解析 Python 程式碼為 AST 運算式，請參閱 :func:`ast.parse`。" #: ../../library/functions.rst:343 ../../library/functions.rst:345 msgid "" @@ -1302,7 +1302,7 @@ msgid "" "on *locals* after function :func:`exec` returns." msgstr "" "預設情況下，*locals* 的行為如下面 :func:`locals` 函式描述的一樣：不要試圖改變" -"預設的 *locals* dictionary。如果您想在 :func:`exec` 函式回傳時知道程式碼對 " +"預設的 *locals* dictionary。如果你想在 :func:`exec` 函式回傳時知道程式碼對 " "*locals* 的變動，請明確地傳遞 *locals* dictionary 。" #: ../../library/functions.rst:689 @@ -3306,7 +3306,7 @@ msgid "" "you are reading the code from a file, make sure to use newline conversion " "mode to convert Windows or Mac-style newlines." msgstr "" -"剖析器只接受 Unix 風格的行結束符。如果您從檔案中讀取程式碼，請確保用換行符號" +"剖析器只接受 Unix 風格的行結束符。如果你從檔案中讀取程式碼，請確保用換行符號" "轉換模式轉換 Windows 或 Mac 風格的換行符號。" #: ../../library/functions.rst:154 diff --git a/library/logging.po b/library/logging.po index a627508ed7..524fd25de4 100644 --- a/library/logging.po +++ b/library/logging.po @@ -61,7 +61,7 @@ msgid "" "third-party modules." msgstr "" "由標準函式庫模組提供的日誌記錄 API 的主要好處是，所有的 Python 模組都能參與日" -"誌記錄，因此您的應用程式日誌可以包含您自己的訊息，並與來自第三方模組的訊息整" +"誌記錄，因此你的應用程式日誌可以包含你自己的訊息，並與來自第三方模組的訊息整" "合在一起。" #: ../../library/logging.rst:33 diff --git a/library/math.po b/library/math.po index 9567206bfd..84f8ca2951 100644 --- a/library/math.po +++ b/library/math.po @@ -40,7 +40,7 @@ msgid "" "of the unexpected complex number used as a parameter, so that the programmer " "can determine how and why it was generated in the first place." msgstr "" -"這些函式不支援複數；若您需要計算複數，請使用 :mod:`cmath` 模組的同名函式。這" +"這些函式不支援複數；若你需要計算複數，請使用 :mod:`cmath` 模組的同名函式。這" "是因為大多數的使用者並不想學習那麼多理解複數所需的數學概念，所以根據支援複數" "與否分為兩種函式。收到一個例外而非複數回傳值，有助於程式設計師提早察覺參數中" "包含非預期的複數，進而從源頭查出導致此情況的原因。" diff --git a/library/ssl.po b/library/ssl.po index 84917745e2..3a92156679 100644 --- a/library/ssl.po +++ b/library/ssl.po @@ -249,10 +249,10 @@ msgid "" "org/wiki/POODLE>`_. If you still wish to continue to use this function but " "still allow SSL 3.0 connections you can re-enable them using::" msgstr "" -"如果您發現某些舊的客戶端或伺服器常適用此函式建立的 :class:`SSLContext` 連線" +"如果你發現某些舊的客戶端或伺服器常適用此函式建立的 :class:`SSLContext` 連線" "時，收到 \"Protocol or cipher suite mismatch\" 錯誤，這可能是因為他們的系統僅" "支援 SSL3.0，然而 SSL3.0 已被此函數用 :data:`OP_NO_SSLv3` 排除。目前廣泛認為 " -"SSL3.0 已經\\ `被完全破解 `_。如果您仍" +"SSL3.0 已經\\ `被完全破解 `_。如果你仍" "然希望在允許 SSL3.0 連線的情況下使用此函數，可以使用下面的方法： ::" #: ../../library/ssl.rst:177 diff --git a/library/string.po b/library/string.po index ac55687fce..78a87e58d3 100644 --- a/library/string.po +++ b/library/string.po @@ -1096,7 +1096,7 @@ msgid "" "these class attributes:" msgstr "" "進階用法：你可以衍生 :class:`Template` 類別來自定義佔位符號語法、左右定界符字" -"元，或者用於剖析模板字串的正則表達式。你可以透過覆寫這些類別屬性來達成：" +"元，或者用於剖析模板字串的正規表示式。你可以透過覆寫這些類別屬性來達成：" #: ../../library/string.rst:845 msgid "" diff --git a/library/wave.po b/library/wave.po index f28afe6da7..a20a92b95d 100644 --- a/library/wave.po +++ b/library/wave.po @@ -93,7 +93,7 @@ msgid "" "its ``close()`` method is called; it is the caller's responsibility to close " "the file object." msgstr "" -"如果您傳遞一個類檔案物件，當呼叫其 ``close()`` 方法時，wave 物件不會自動關閉" +"如果你傳遞一個類檔案物件，當呼叫其 ``close()`` 方法時，wave 物件不會自動關閉" "該物件；關閉檔案物件的責任會在呼叫者上。" #: ../../library/wave.rst:48 diff --git a/library/zlib.po b/library/zlib.po index 202a19ec8c..5ba7b2b7c1 100644 --- a/library/zlib.po +++ b/library/zlib.po @@ -437,7 +437,7 @@ msgid "" "subsequent :meth:`decompress` method call in order to get correct output." msgstr "" "一個位元組物件，包含前一次 :meth:`decompress` 的呼叫因超出了未壓縮資料緩衝區" -"的限制而沒消耗掉的任何資料。 zlib 機制尚未看到此資料，因此您必須將其（和可能" +"的限制而沒消耗掉的任何資料。 zlib 機制尚未看到此資料，因此你必須將其（和可能" "有和它串聯的其他資料）反饋給後續的 :meth:`decompress` 方法呼叫以獲得正確的輸" "出。" diff --git a/license.po b/license.po index 7c25b874bf..77f9d12a95 100644 --- a/license.po +++ b/license.po @@ -221,7 +221,7 @@ msgid "" "GPL; the others don't." msgstr "" "GPL 相容並不表示我們是在 GPL 下發佈 Python。不像 GPL，所有的 Python 授權都可" -"以讓您發佈修改後的版本，但不一定要使您的變更成為開源。GPL 相容的授權使得 " +"以讓你發佈修改後的版本，但不一定要使你的變更成為開源。GPL 相容的授權使得 " "Python 可以結合其他在 GPL 下發佈的軟體一起使用；但其它的授權則不行。" #: ../../license.rst:68 diff --git a/tutorial/appendix.po b/tutorial/appendix.po index 398fe96532..b93805d6f8 100644 --- a/tutorial/appendix.po +++ b/tutorial/appendix.po @@ -175,7 +175,7 @@ msgid "" "unless it is started with the :option:`-s` option to disable the automatic " "import." msgstr "" -"現在，您可以在該目錄中建立一個名為 :file:`usercustomize.py` 的檔案，並將您想" +"現在，你可以在該目錄中建立一個名為 :file:`usercustomize.py` 的檔案，並將你想" "要的任何內容放入其中。它會影響 Python 的每次呼叫，除非它以 :option:`-s` 選項" "啟動以禁用自動 import 。" diff --git a/tutorial/classes.po b/tutorial/classes.po index 5451a98cec..4d953cd898 100644 --- a/tutorial/classes.po +++ b/tutorial/classes.po @@ -471,7 +471,7 @@ msgid "" "docstring belonging to the class: ``\"A simple example class\"``." msgstr "" "那麼 ``MyClass.i`` 和 ``MyClass.f`` 都是有效的屬性參照，會分別回傳一個整數和" -"一個函式物件。Class 屬性也可以被指派 (assign)，所以您可以透過賦值改變 " +"一個函式物件。Class 屬性也可以被指派 (assign)，所以你可以透過賦值改變 " "``MyClass.i`` 的值。:attr:`!__doc__` 也是一個有效的屬性，會回傳屬於該 class " "的說明字串 (docstring)：``\"A simple example class\"``。" diff --git a/tutorial/index.po b/tutorial/index.po index ef40d056f7..8dd27a3e5c 100644 --- a/tutorial/index.po +++ b/tutorial/index.po @@ -80,7 +80,7 @@ msgid "" "ref:`c-api-index`. There are also several books covering Python in depth." msgstr "" "若想了解 Python 標準物件和模組的描述，請參閱 :ref:`library-index`。在 :ref:" -"`reference-index` 中，您可以學到 Python 語言更正規的定義。想用 C 或 C++ 寫延" +"`reference-index` 中，你可以學到 Python 語言更正規的定義。想用 C 或 C++ 寫延" "伸套件 (extensions) 的讀者，請閱讀 :ref:`extending-index` 和 :ref:`c-api-" "index` 。此外，市面上也能找到更深入的 Python 學習書。" @@ -94,8 +94,8 @@ msgid "" "the various Python library modules described in :ref:`library-index`." msgstr "" "這份教學中，我們不會介紹每一個功能，甚至，也不打算介紹完每一個常用功能。取而" -"代之，我們的重心將放在介紹 Python 中最值得一提的那些功能，幫助您了解 Python " -"語言的特色與風格。讀完教學後，您將有能力閱讀和撰寫 Python 模組與程式，也做好" +"代之，我們的重心將放在介紹 Python 中最值得一提的那些功能，幫助你了解 Python " +"語言的特色與風格。讀完教學後，你將有能力閱讀和撰寫 Python 模組與程式，也做好" "進一步學習 :ref:`library-index` 中各類型的 Python 函式庫模組的準備。" #: ../../tutorial/index.rst:40 diff --git a/tutorial/interpreter.po b/tutorial/interpreter.po index 3e01d7bfc2..f00855e3a9 100644 --- a/tutorial/interpreter.po +++ b/tutorial/interpreter.po @@ -217,7 +217,7 @@ msgstr "" "預設 Python 原始碼檔案的字元編碼使用 UTF-8。在這個編碼中，世界上多數語言的文" "字可以同時被使用在字串內容、識別名 (identifier) 及註解中 --- 雖然在標準函式庫" "中只使用 ASCII 字元作為識別名，這也是個任何 portable 程式碼需遵守的慣例。如果" -"要正確地顯示所有字元，您的編輯器需要能夠認識檔案為 UTF-8，並且需要能顯示檔案" +"要正確地顯示所有字元，你的編輯器需要能夠認識檔案為 UTF-8，並且需要能顯示檔案" "中所有字元的字型。" #: ../../tutorial/interpreter.rst:140 diff --git a/tutorial/whatnow.po b/tutorial/whatnow.po index 98a92305f5..4b5d65878b 100644 --- a/tutorial/whatnow.po +++ b/tutorial/whatnow.po @@ -31,7 +31,7 @@ msgid "" "--- you should be eager to apply Python to solving your real-world problems. " "Where should you go to learn more?" msgstr "" -"閱讀本教學可能增強您對於使用 Python 的興趣——您應該非常渴望使用 Python 來解決" +"閱讀本教學可能增強你對於使用 Python 的興趣——你應該非常渴望使用 Python 來解決" "在現實生活中所遭遇的問題。該從哪裡學習更多呢？" #: ../../tutorial/whatnow.rst:11 @@ -142,7 +142,7 @@ msgid "" "new features, and announcing new modules. Mailing list archives are " "available at https://mail.python.org/pipermail/." msgstr "" -"對於 Python 相關的疑問與問題回報，您可以張貼到新聞群組\\ :newsgroup:`comp." +"對於 Python 相關的疑問與問題回報，你可以張貼到新聞群組\\ :newsgroup:`comp." "lang.python`\\，或將它們寄至 python-list@python.org 的郵寄清單 (mailing " "list)。新聞群組和郵寄清單是個閘道，因此張貼到其中的郵件都將自動轉發給另一個。" "每天會有數以百計的內容，詢問（和回答）問題、建議新功能與發佈新的模組。郵寄清" From 14cb376e8c46a8b37deefef46c4d3b3fc1d152d7 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Sat, 17 Aug 2024 00:05:04 +0000 Subject: [PATCH 24/28] sync with cpython 41090b7b --- deprecations/c-api-pending-removal-in-3.14.po | 3 +-- deprecations/c-api-pending-removal-in-3.15.po | 3 +-- deprecations/c-api-pending-removal-in-future.po | 3 +-- deprecations/pending-removal-in-3.14.po | 3 +-- deprecations/pending-removal-in-3.15.po | 3 +-- 5 files changed, 5 insertions(+), 10 deletions(-) diff --git a/deprecations/c-api-pending-removal-in-3.14.po b/deprecations/c-api-pending-removal-in-3.14.po index 23ff68e87a..a8d1a702cf 100644 --- a/deprecations/c-api-pending-removal-in-3.14.po +++ b/deprecations/c-api-pending-removal-in-3.14.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-17 00:03+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -16,7 +16,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #: ../../deprecations/c-api-pending-removal-in-3.14.rst:2 -#: ../../deprecations/pending-removal-in-3.14.rst:2 msgid "Pending Removal in Python 3.14" msgstr "Python 3.14 中待移除的項目" diff --git a/deprecations/c-api-pending-removal-in-3.15.po b/deprecations/c-api-pending-removal-in-3.15.po index 02e27cbbcc..f9978c5575 100644 --- a/deprecations/c-api-pending-removal-in-3.15.po +++ b/deprecations/c-api-pending-removal-in-3.15.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-17 00:03+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -17,7 +17,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:2 -#: ../../deprecations/pending-removal-in-3.15.rst:2 msgid "Pending Removal in Python 3.15" msgstr "Python 3.15 中待移除的項目" diff --git a/deprecations/c-api-pending-removal-in-future.po b/deprecations/c-api-pending-removal-in-future.po index bab38ba810..3dc787ba8d 100644 --- a/deprecations/c-api-pending-removal-in-future.po +++ b/deprecations/c-api-pending-removal-in-future.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:03+0000\n" +"POT-Creation-Date: 2024-08-17 00:03+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -17,7 +17,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #: ../../deprecations/c-api-pending-removal-in-future.rst:2 -#: ../../deprecations/pending-removal-in-future.rst:2 msgid "Pending Removal in Future Versions" msgstr "未來版本中的待移除項目" diff --git a/deprecations/pending-removal-in-3.14.po b/deprecations/pending-removal-in-3.14.po index 1ecb4d9f81..85e1f5f2be 100644 --- a/deprecations/pending-removal-in-3.14.po +++ b/deprecations/pending-removal-in-3.14.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-25 00:04+0000\n" +"POT-Creation-Date: 2024-08-17 00:03+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -17,7 +17,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #: ../../deprecations/pending-removal-in-3.14.rst:2 -#: ../../deprecations/c-api-pending-removal-in-3.14.rst:2 msgid "Pending Removal in Python 3.14" msgstr "Python 3.14 中待移除的項目" diff --git a/deprecations/pending-removal-in-3.15.po b/deprecations/pending-removal-in-3.15.po index d5ed8c4898..df09fa8066 100644 --- a/deprecations/pending-removal-in-3.15.po +++ b/deprecations/pending-removal-in-3.15.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-25 00:04+0000\n" +"POT-Creation-Date: 2024-08-17 00:03+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -17,7 +17,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #: ../../deprecations/pending-removal-in-3.15.rst:2 -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:2 msgid "Pending Removal in Python 3.15" msgstr "Python 3.15 中待移除的項目" From 2216c1e6a3397614a4b143342492bd83cac70354 Mon Sep 17 00:00:00 2001 From: Matt Wang Date: Sat, 17 Aug 2024 13:56:39 +0800 Subject: [PATCH 25/28] fix: resolve fuzzy entries --- deprecations/index.po | 2 +- library/ast.po | 4 +- library/asyncio-future.po | 4 +- library/functions.po | 10 ++--- library/os.path.po | 1 - library/pathlib.po | 88 +++++++-------------------------------- sphinx.po | 65 +++++++++++++++++++++-------- whatsnew/3.12.po | 2 +- 8 files changed, 72 insertions(+), 104 deletions(-) diff --git a/deprecations/index.po b/deprecations/index.po index 1908e5762c..e0f777fd23 100644 --- a/deprecations/index.po +++ b/deprecations/index.po @@ -651,7 +651,7 @@ msgid "" "syntax error. (:gh:`87999`)" msgstr "" "目前 Python 接受數值字面值後面立即接關鍵字，例如 ``0in x``、``1or x``、``0if " -"1else 2``。它讓表達式模糊且容易混淆，如 ``[0x1for x in y]``（可以解釋為 " +"1else 2``。它讓表達式模糊且容易混淆，如 ``[0x1for x in y]``\\ （可以解釋為 " "``[0x1 for x in y]`` 或 ``[0x1f or x in y]``）。如果數值字面值後立即接 :" "keyword:`and`、:keyword:`else`、:keyword:`for`、:keyword:`if`、:keyword:" "`in`、:keyword:`is` 和 :keyword:`or` 之一的關鍵字，則會引發語法警告。在未來版" diff --git a/library/ast.po b/library/ast.po index 27f45561ee..8e1b9e8d98 100644 --- a/library/ast.po +++ b/library/ast.po @@ -1,4 +1,4 @@ -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # # Translators: @@ -646,7 +646,6 @@ msgid "" msgstr "``type_comment`` 是一個可選字串，其中的註解為型別註釋。" #: ../../library/ast.rst:883 -#, fuzzy msgid "" "An assignment with a type annotation. ``target`` is a single node and can be " "a :class:`Name`, an :class:`Attribute` or a :class:`Subscript`. " @@ -1166,7 +1165,6 @@ msgid "A ``return`` statement." msgstr "一個 ``return`` 陳述式。" #: ../../library/ast.rst:2006 -#, fuzzy msgid "" "A ``yield`` or ``yield from`` expression. Because these are expressions, " "they must be wrapped in an :class:`Expr` node if the value sent back is not " diff --git a/library/asyncio-future.po b/library/asyncio-future.po index 4d3b302694..48e90cd2ae 100644 --- a/library/asyncio-future.po +++ b/library/asyncio-future.po @@ -1,4 +1,4 @@ -# Copyright (C) 2001-2022, Python Software Foundation +# Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # # Translators: @@ -212,7 +212,6 @@ msgstr "" "`CancelledError` 例外。" #: ../../library/asyncio-future.rst:122 -#, fuzzy msgid "" "If the Future's result isn't yet available, this method raises an :exc:" "`InvalidStateError` exception." @@ -224,7 +223,6 @@ msgid "Mark the Future as *done* and set its result." msgstr "將 Future 標記為 *done* 並設定其結果。" #: ../../library/asyncio-future.rst:129 ../../library/asyncio-future.rst:136 -#, fuzzy msgid "" "Raises an :exc:`InvalidStateError` error if the Future is already *done*." msgstr "如果 Future 已經 *done* 則引發一個 :exc:`InvalidStateError` 錯誤。" diff --git a/library/functions.po b/library/functions.po index df411e73a0..e292dd464d 100644 --- a/library/functions.po +++ b/library/functions.po @@ -1660,7 +1660,6 @@ msgid "" msgstr "" #: ../../library/functions.rst:982 -#, fuzzy msgid "" "If the argument defines :meth:`~object.__int__`, ``int(x)`` returns ``x." "__int__()``. If the argument defines :meth:`~object.__index__`, it returns " @@ -1668,11 +1667,10 @@ msgid "" "returns ``x.__trunc__()``. For floating-point numbers, this truncates " "towards zero." msgstr "" -"回傳一個使用數字或字串 *x* 建構的整數物件，或者在沒有引數時回傳 ``0``。如果 " -"*x* 定義了 :meth:`~object.__int__`，則 ``int(x)`` 回傳 ``x.__int__()``。如果 " -"*x* 定義了 :meth:`~object.__index__` 則回傳 ``x.__index__()``。如果 *x* 定義" -"了 :meth:`~object.__trunc__` 則回傳 ``x.__trunc__()``。對於浮點數，則會向零的" -"方向無條件捨去。" +"如果引數定義了 :meth:`~object.__int__`，則 ``int(x)`` 回傳 ``x.__int__()``。" +"如果引數定義了 :meth:`~object.__index__` 則回傳 ``x.__index__()``。如果引數定" +"義了 :meth:`~object.__trunc__` 則回傳 ``x.__trunc__()``。對於浮點數，則會向零" +"的方向無條件捨去。" #: ../../library/functions.rst:988 msgid "" diff --git a/library/os.path.po b/library/os.path.po index 810a3795fa..d934e8f20b 100644 --- a/library/os.path.po +++ b/library/os.path.po @@ -138,7 +138,6 @@ msgstr "" "`basename` 函式回傳空字串（``''``）。" #: ../../library/os.path.rst:82 -#, fuzzy msgid "" "Return the longest common sub-path of each pathname in the sequence " "*paths*. Raise :exc:`ValueError` if *paths* contain both absolute and " diff --git a/library/pathlib.po b/library/pathlib.po index 8c3c876318..b6111fbbfe 100644 --- a/library/pathlib.po +++ b/library/pathlib.po @@ -761,7 +761,6 @@ msgstr "" "會回傳 ``False`` 而不是引發例外。" #: ../../library/pathlib.rst:910 -#, fuzzy msgid "" "Return an :class:`os.stat_result` object containing information about this " "path, like :func:`os.stat`. The result is looked up at each call to this " @@ -1475,7 +1474,6 @@ msgid ":func:`os.path.splitext`" msgstr ":func:`os.path.splitext`" #: ../../library/pathlib.rst:1535 -#, fuzzy msgid ":attr:`PurePath.stem`, :attr:`PurePath.suffix`" msgstr ":attr:`PurePath.stem` 和 :attr:`PurePath.suffix`" @@ -1484,9 +1482,8 @@ msgid ":func:`os.path.join`" msgstr ":func:`os.path.join`" #: ../../library/pathlib.rst:1536 -#, fuzzy msgid ":meth:`PurePath.joinpath`" -msgstr ":func:`PurePath.joinpath`" +msgstr ":meth:`PurePath.joinpath`" #: ../../library/pathlib.rst:1537 msgid ":func:`os.path.isabs`" @@ -1501,18 +1498,16 @@ msgid ":func:`os.path.relpath`" msgstr ":func:`os.path.relpath`" #: ../../library/pathlib.rst:1538 -#, fuzzy msgid ":meth:`PurePath.relative_to` [1]_" -msgstr ":meth:`PurePath.relative_to` [#]_" +msgstr ":meth:`PurePath.relative_to` [1]_" #: ../../library/pathlib.rst:1539 msgid ":func:`os.path.expanduser`" msgstr ":func:`os.path.expanduser`" #: ../../library/pathlib.rst:1539 -#, fuzzy msgid ":meth:`Path.expanduser` [2]_" -msgstr ":meth:`Path.absolute` [#]_" +msgstr ":meth:`Path.expanduser` [2]_" #: ../../library/pathlib.rst:1540 msgid ":func:`os.path.realpath`" @@ -1527,9 +1522,8 @@ msgid ":func:`os.path.abspath`" msgstr ":func:`os.path.abspath`" #: ../../library/pathlib.rst:1541 -#, fuzzy msgid ":meth:`Path.absolute` [3]_" -msgstr ":meth:`Path.absolute` [#]_" +msgstr ":meth:`Path.absolute` [3]_" #: ../../library/pathlib.rst:1542 msgid ":func:`os.path.exists`" @@ -1564,24 +1558,20 @@ msgid ":meth:`Path.is_symlink`" msgstr ":meth:`Path.is_symlink`" #: ../../library/pathlib.rst:1546 -#, fuzzy msgid ":func:`os.path.isjunction`" -msgstr ":func:`os.path.islink`" +msgstr ":func:`os.path.isjunction`" #: ../../library/pathlib.rst:1546 -#, fuzzy msgid ":meth:`Path.is_junction`" -msgstr ":meth:`Path.is_dir`" +msgstr ":meth:`Path.is_junction`" #: ../../library/pathlib.rst:1547 -#, fuzzy msgid ":func:`os.path.ismount`" -msgstr ":func:`os.path.islink`" +msgstr ":func:`os.path.ismount`" #: ../../library/pathlib.rst:1547 -#, fuzzy msgid ":meth:`Path.is_mount`" -msgstr ":meth:`Path.is_symlink`" +msgstr ":meth:`Path.is_mount`" #: ../../library/pathlib.rst:1548 msgid ":func:`os.path.samefile`" @@ -1596,28 +1586,24 @@ msgid ":func:`os.getcwd`" msgstr ":func:`os.getcwd`" #: ../../library/pathlib.rst:1549 -#, fuzzy msgid ":meth:`Path.cwd`" -msgstr ":meth:`Path.chmod`" +msgstr ":meth:`Path.cwd`" #: ../../library/pathlib.rst:1550 msgid ":func:`os.stat`" msgstr ":func:`os.stat`" #: ../../library/pathlib.rst:1550 -#, fuzzy msgid ":meth:`Path.stat`" -msgstr ":meth:`Path.exists`" +msgstr ":meth:`Path.stat`" #: ../../library/pathlib.rst:1551 -#, fuzzy msgid ":func:`os.lstat`" -msgstr ":func:`os.stat`" +msgstr ":func:`os.lstat`" #: ../../library/pathlib.rst:1551 -#, fuzzy msgid ":meth:`Path.lstat`" -msgstr ":meth:`Path.exists`" +msgstr ":meth:`Path.lstat`" #: ../../library/pathlib.rst:1552 msgid ":func:`os.listdir`" @@ -1632,14 +1618,12 @@ msgid ":func:`os.walk`" msgstr ":func:`os.walk`" #: ../../library/pathlib.rst:1553 -#, fuzzy msgid ":meth:`Path.walk` [4]_" -msgstr ":meth:`Path.walk`" +msgstr ":meth:`Path.walk` [4]_" #: ../../library/pathlib.rst:1554 -#, fuzzy msgid ":func:`os.mkdir`, :func:`os.makedirs`" -msgstr ":func:`os.remove`、:func:`os.unlink`" +msgstr ":func:`os.mkdir`、:func:`os.makedirs`" #: ../../library/pathlib.rst:1554 msgid ":meth:`Path.mkdir`" @@ -1710,14 +1694,12 @@ msgid ":meth:`Path.chmod`" msgstr ":meth:`Path.chmod`" #: ../../library/pathlib.rst:1563 -#, fuzzy msgid ":func:`os.lchmod`" -msgstr ":func:`os.chmod`" +msgstr ":func:`os.lchmod`" #: ../../library/pathlib.rst:1563 -#, fuzzy msgid ":meth:`Path.lchmod`" -msgstr ":meth:`Path.chmod`" +msgstr ":meth:`Path.lchmod`" #: ../../library/pathlib.rst:1567 msgid "Footnotes" @@ -1739,14 +1721,11 @@ msgid "" msgstr "" #: ../../library/pathlib.rst:1575 -#, fuzzy msgid "" ":func:`os.path.abspath` removes \"``..``\" components without resolving " "symlinks, which may change the meaning of the path, whereas :meth:`Path." "absolute` leaves any \"``..``\" components in the path." msgstr "" -":func:`os.path.abspath` 會標準化產生的路徑，因而當有符號連結的時候會改變其意" -"義，但 :meth:`Path.absolute` 不會。" #: ../../library/pathlib.rst:1578 msgid "" @@ -1762,38 +1741,3 @@ msgstr "path（路徑）" #: ../../library/pathlib.rst:11 msgid "operations" msgstr "operations（操作）" - -#~ msgid "" -#~ "Not all pairs of functions/methods below are equivalent. Some of them, " -#~ "despite having some overlapping use-cases, have different semantics. They " -#~ "include :func:`os.path.abspath` and :meth:`Path.absolute`, :func:`os.path." -#~ "relpath` and :meth:`PurePath.relative_to`." -#~ msgstr "" -#~ "不是以下所有一對的函式/方法都相等。其中有一些儘管有重疊的使用情境但有不同" -#~ "的語意。它們包含 :func:`os.path.abspath` 和 :meth:`Path.absolute`、:func:" -#~ "`os.path.relpath` 和 :meth:`PurePath.relative_to`。" - -#~ msgid ":func:`os.mkdir`" -#~ msgstr ":func:`os.mkdir`" - -#~ msgid ":func:`os.makedirs`" -#~ msgstr ":func:`os.makedirs`" - -#~ msgid ":func:`Path.cwd`" -#~ msgstr ":func:`Path.cwd`" - -#~ msgid ":meth:`Path.expanduser` and :meth:`Path.home`" -#~ msgstr ":meth:`Path.expanduser` 和 :meth:`Path.home`" - -#~ msgid ":meth:`Path.stat`, :meth:`Path.owner`, :meth:`Path.group`" -#~ msgstr ":meth:`Path.stat`、:meth:`Path.owner`、:meth:`Path.group`" - -#~ msgid "" -#~ ":meth:`PurePath.relative_to` requires ``self`` to be the subpath of the " -#~ "argument, but :func:`os.path.relpath` does not." -#~ msgstr "" -#~ ":meth:`PurePath.relative_to` 要求 ``self`` 是其引數的子路徑 (subpath)，" -#~ "但 :func:`os.path.relpath` 不用。" - -#~ msgid "Other methods" -#~ msgstr "其他方法" diff --git a/sphinx.po b/sphinx.po index 25a081891c..7834e242c4 100644 --- a/sphinx.po +++ b/sphinx.po @@ -38,129 +38,152 @@ msgid "Download" msgstr "下載" #: ../../tools/templates/download.html:14 -#, fuzzy msgid "Download Python %(release)s Documentation" -msgstr "下載說明文件" +msgstr "下載 Python %(release)s 說明文件" #: ../../tools/templates/download.html:16 msgid "Last updated on: %(last_updated)s." -msgstr "" +msgstr "最後更新時間：%(last_updated)s。" #: ../../tools/templates/download.html:18 msgid "" "To download an archive containing all the documents for this version of\n" "Python in one of various formats, follow one of links in this table." msgstr "" +"要下載包含這個 Python 版本所有文件的歸檔，可以遵循這個表格中的其中一個連結，" +"以取得各種格式的文件。" #: ../../tools/templates/download.html:23 msgid "Format" -msgstr "" +msgstr "格式" #: ../../tools/templates/download.html:24 msgid "Packed as .zip" -msgstr "" +msgstr "打包成 .zip" #: ../../tools/templates/download.html:25 msgid "Packed as .tar.bz2" -msgstr "" +msgstr "打包成 .tar.bz2" #: ../../tools/templates/download.html:28 msgid "PDF (US-Letter paper size)" -msgstr "" +msgstr "PDF（美國信紙大小）" #: ../../tools/templates/download.html:29 msgid "" "Download " "(ca. %(download_size)s MiB)" msgstr "" +"下載 (ca. " +"%(download_size)s MiB)" #: ../../tools/templates/download.html:30 msgid "" "Download (ca. %(download_size)s MiB)" msgstr "" +"下載 " +"(ca. %(download_size)s MiB)" #: ../../tools/templates/download.html:33 msgid "PDF (A4 paper size)" -msgstr "" +msgstr "PDF（A4 紙張大小）" #: ../../tools/templates/download.html:34 msgid "" "Download (ca. " "%(download_size)s MiB)" msgstr "" +"下載 (ca. " +"%(download_size)s MiB)" #: ../../tools/templates/download.html:35 msgid "" "Download " "(ca. %(download_size)s MiB)" msgstr "" +"下載 (ca. " +"%(download_size)s MiB)" #: ../../tools/templates/download.html:38 msgid "HTML" -msgstr "" +msgstr "HTML" #: ../../tools/templates/download.html:39 msgid "" "Download (ca. " "%(download_size)s MiB)" msgstr "" +"下載 (ca. " +"%(download_size)s MiB)" #: ../../tools/templates/download.html:40 msgid "" "Download " "(ca. %(download_size)s MiB)" msgstr "" +"下載 (ca. " +"%(download_size)s MiB)" #: ../../tools/templates/download.html:43 msgid "Plain text" -msgstr "" +msgstr "純文字" #: ../../tools/templates/download.html:44 msgid "" "Download (ca. " "%(download_size)s MiB)" msgstr "" +"下載 (ca. " +"%(download_size)s MiB)" #: ../../tools/templates/download.html:45 msgid "" "Download " "(ca. %(download_size)s MiB)" msgstr "" +"下載 (ca. " +"%(download_size)s MiB)" #: ../../tools/templates/download.html:48 msgid "Texinfo" -msgstr "" +msgstr "Texinfo" #: ../../tools/templates/download.html:49 msgid "" "Download (ca. " "%(download_size)s MiB)" msgstr "" +"下載 (ca. " +"%(download_size)s MiB)" #: ../../tools/templates/download.html:50 msgid "" "Download " "(ca. %(download_size)s MiB)" msgstr "" +"下載 (ca. " +"%(download_size)s MiB)" #: ../../tools/templates/download.html:53 msgid "EPUB" -msgstr "" +msgstr "EPUB" #: ../../tools/templates/download.html:54 msgid "" "Download (ca. " "%(download_size)s MiB)" msgstr "" +"下載 (ca. " +"%(download_size)s MiB)" #: ../../tools/templates/download.html:59 msgid "These archives contain all the content in the documentation." -msgstr "" +msgstr "這些歸檔包含了說明文件中的所有內容。" #: ../../tools/templates/download.html:62 msgid "Unpacking" -msgstr "" +msgstr "解壓縮" #: ../../tools/templates/download.html:64 msgid "" @@ -172,16 +195,22 @@ msgid "" "the\n" "best compression and fastest download times." msgstr "" +"Unix 使用者應該下載 .tar.bz2 歸檔；這些是 bzipped tar 歸檔，可以使用 tar 和 " +"bzip2 來處理。如果需要的話，可以使用 Info-ZIP 解壓縮程式來處理 ZIP 歸檔。.tar.bz2 歸檔提供最佳壓縮率和最" +"快的下載時間。" #: ../../tools/templates/download.html:70 msgid "" "Windows users can use the ZIP archives since those are customary on that\n" "platform. These are created on Unix using the Info-ZIP zip program." msgstr "" +"Windows 使用者可以使用 ZIP 歸檔，因為這在該平台上是常見的。這些是在 Unix 上使" +"用 Info-ZIP zip 程式建立的。" #: ../../tools/templates/download.html:74 msgid "Problems" -msgstr "" +msgstr "問題" #: ../../tools/templates/download.html:76 msgid "" @@ -189,6 +218,8 @@ msgid "" "send\n" "email to docs@python.org." msgstr "" +"如果你對 Python 說明文件有任何意見或建議，請寄電子郵件至 docs@python.org。" #: ../../tools/templates/dummy.html:6 msgid "CPython implementation detail:" @@ -376,11 +407,11 @@ msgstr "常被提出的問題（還有答案！）" #: ../../tools/templates/indexcontent.html:36 msgid "Deprecations" -msgstr "" +msgstr "棄用功能" #: ../../tools/templates/indexcontent.html:37 msgid "Deprecated functionality" -msgstr "" +msgstr "已棄用的功能" #: ../../tools/templates/indexcontent.html:41 msgid "Indices, glossary, and search:" diff --git a/whatsnew/3.12.po b/whatsnew/3.12.po index c4d03d212e..1f15c8c518 100644 --- a/whatsnew/3.12.po +++ b/whatsnew/3.12.po @@ -2441,7 +2441,7 @@ msgid "" "syntax error. (:gh:`87999`)" msgstr "" "目前 Python 接受數值字面值後面立即接關鍵字，例如 ``0in x``、``1or x``、``0if " -"1else 2``。它讓表達式模糊且容易混淆，如 ``[0x1for x in y]``（可以解釋為 " +"1else 2``。它讓表達式模糊且容易混淆，如 ``[0x1for x in y]``\\ （可以解釋為 " "``[0x1 for x in y]`` 或 ``[0x1f or x in y]``）。如果數值字面值後立即接 :" "keyword:`and`、:keyword:`else`、:keyword:`for`、:keyword:`if`、:keyword:" "`in`、:keyword:`is` 和 :keyword:`or` 之一的關鍵字，則會引發語法警告。在未來版" From 184aeb2daa0807a90d8e8a915e2b49d10406fff7 Mon Sep 17 00:00:00 2001 From: Matt Wang Date: Sat, 17 Aug 2024 14:02:44 +0800 Subject: [PATCH 26/28] fix: resolve fuzzy entries regarding auditing events --- c-api/file.po | 1 - c-api/init.po | 3 -- c-api/sys.po | 6 --- library/_thread.po | 1 - library/array.po | 3 +- library/ctypes.po | 94 +++++---------------------------------- library/ensurepip.po | 1 - library/fcntl.po | 4 -- library/ftplib.po | 2 - library/functions.po | 78 +++----------------------------- library/gc.po | 3 -- library/glob.po | 2 - library/http.client.po | 2 - library/imaplib.po | 5 +-- library/msvcrt.po | 7 +-- library/nntplib.po | 12 +---- library/poplib.po | 5 +-- library/sqlite3.po | 4 -- library/types.po | 2 - reference/simple_stmts.po | 1 - 20 files changed, 24 insertions(+), 212 deletions(-) diff --git a/c-api/file.po b/c-api/file.po index 5460b908b9..4a1d1c1e24 100644 --- a/c-api/file.po +++ b/c-api/file.po @@ -157,7 +157,6 @@ msgid "This function is safe to call before :c:func:`Py_Initialize`." msgstr "在 :c:func:`Py_Initialize` 之前呼叫此函式是安全的。" #: ../../c-api/file.rst:90 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``setopencodehook`` with no " "arguments." diff --git a/c-api/init.po b/c-api/init.po index 49bf5d534c..056d2a952e 100644 --- a/c-api/init.po +++ b/c-api/init.po @@ -612,7 +612,6 @@ msgid "" msgstr "" #: ../../c-api/init.rst:421 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``cpython." "_PySys_ClearAuditHooks`` with no arguments." @@ -1418,7 +1417,6 @@ msgid "" msgstr "" #: ../../c-api/init.rst:1227 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``cpython." "PyInterpreterState_New`` with no arguments." @@ -1433,7 +1431,6 @@ msgid "" msgstr "" #: ../../c-api/init.rst:1235 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``cpython." "PyInterpreterState_Clear`` with no arguments." diff --git a/c-api/sys.po b/c-api/sys.po index b8d271fe90..8508ebc7fe 100644 --- a/c-api/sys.po +++ b/c-api/sys.po @@ -537,9 +537,3 @@ msgstr "exit（C 函式）" #: ../../c-api/sys.rst:455 msgid "cleanup functions" msgstr "cleanup functions（清理函式）" - -#~ msgid "" -#~ "Raises an :ref:`auditing event ` ``sys.addaudithook`` with no " -#~ "arguments." -#~ msgstr "" -#~ "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.addaudithook``。" diff --git a/library/_thread.po b/library/_thread.po index 5ae5711abd..d7c0961c76 100644 --- a/library/_thread.po +++ b/library/_thread.po @@ -88,7 +88,6 @@ msgid "" msgstr "當函式引發 :exc:`SystemExit` 例外時，它會被靜默忽略。" #: ../../library/_thread.rst:60 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``_thread.start_new_thread`` with " "arguments ``function``, ``args``, ``kwargs``." diff --git a/library/array.po b/library/array.po index f9a44f3271..3a338d3ff8 100644 --- a/library/array.po +++ b/library/array.po @@ -280,12 +280,11 @@ msgstr "" "的地方使用。" #: ../../library/array.rst:96 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``array.__new__`` with arguments " "``typecode``, ``initializer``." msgstr "" -"引發\\ :ref:`稽核事件 (auditing event) ` ``array.__new__`` 並帶入引" +"引發\\ :ref:`稽核事件 (auditing event) ` ``array.__new__`` 並附帶引" "數 ``typecode``、``initializer``。" #: ../../library/array.rst:101 diff --git a/library/ctypes.po b/library/ctypes.po index 9c4bc22014..302fd410fb 100644 --- a/library/ctypes.po +++ b/library/ctypes.po @@ -1866,12 +1866,12 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:1886 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``ctypes.addressof`` with " "argument ``obj``." msgstr "" -"引發一個附帶引數 ``name`` 的\\ :ref:`稽核事件 ` ``ctypes.dlopen``。" +"引發一個附帶引數 ``obj`` 的\\ :ref:`稽核事件 ` ``ctypes." +"addressof``。" #: ../../library/ctypes.rst:1891 msgid "" @@ -1926,7 +1926,6 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:1930 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``ctypes.create_string_buffer`` " "with arguments ``init``, ``size``." @@ -1956,7 +1955,6 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:1947 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``ctypes.create_unicode_buffer`` " "with arguments ``init``, ``size``." @@ -2021,13 +2019,11 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:2005 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``ctypes.get_errno`` with no " "arguments." msgstr "" -"引發一個附帶引數 ``code`` 的\\ :ref:`稽核事件 ` ``ctypes." -"set_exception``。" +"引發一個不附帶引數的\\ :ref:`稽核事件 ` ``ctypes.get_errno``。" #: ../../library/ctypes.rst:2009 msgid "" @@ -2036,7 +2032,6 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:2012 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``ctypes.get_last_error`` with no " "arguments." @@ -2091,13 +2086,12 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:2057 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``ctypes.set_errno`` with " "argument ``errno``." msgstr "" -"引發一個附帶引數 ``code`` 的\\ :ref:`稽核事件 ` ``ctypes." -"set_exception``。" +"引發一個附帶引數 ``errno`` 的\\ :ref:`稽核事件 ` ``ctypes." +"set_errno``。" #: ../../library/ctypes.rst:2062 msgid "" @@ -2107,13 +2101,12 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:2066 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``ctypes.set_last_error`` with " "argument ``error``." msgstr "" -"引發一個附帶引數 ``code`` 的\\ :ref:`稽核事件 ` ``ctypes." -"set_exception``。" +"引發一個附帶引數 ``error`` 的\\ :ref:`稽核事件 ` ``ctypes." +"set_last_error``。" #: ../../library/ctypes.rst:2071 msgid "" @@ -2128,13 +2121,12 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:2081 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``ctypes.string_at`` with " "arguments ``ptr``, ``size``." msgstr "" -"引發一個附帶引數 ``library``、``name`` 的\\ :ref:`稽核事件 ` " -"``ctypes.dlsym``。" +"引發一個附帶引數 ``ptr``、``size`` 的\\ :ref:`稽核事件 ` ``ctypes." +"string_at``。" #: ../../library/ctypes.rst:2086 msgid "" @@ -2159,13 +2151,12 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:2104 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``ctypes.wstring_at`` with " "arguments ``ptr``, ``size``." msgstr "" -"引發一個附帶引數 ``library``、``name`` 的\\ :ref:`稽核事件 ` " -"``ctypes.dlsym``。" +"引發一個附帶引數 ``ptr``、``size`` 的\\ :ref:`稽核事件 ` ``ctypes." +"wstring_at``。" #: ../../library/ctypes.rst:2110 msgid "Data types" @@ -2197,7 +2188,6 @@ msgid "" msgstr "" #: ../../library/ctypes.rst:2133 ../../library/ctypes.rst:2143 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``ctypes.cdata/buffer`` with " "arguments ``pointer``, ``size``, ``offset``." @@ -2731,65 +2721,3 @@ msgid "" "Returns the object to which to pointer points. Assigning to this attribute " "changes the pointer to point to the assigned object." msgstr "" - -#, fuzzy -#~ msgid "" -#~ "Some ways to invoke foreign function calls may raise an auditing event " -#~ "ctypes.call_function with arguments function pointer and arguments." -#~ msgstr "" -#~ "引發一個附帶引數 ``func_pointer``、``arguments`` 的\\ :ref:`稽核事件 " -#~ "` ``ctypes.call_function``。" - -#, fuzzy -#~ msgid "Raises an auditing event ctypes.addressof with argument obj." -#~ msgstr "" -#~ "引發一個附帶引數 ``obj`` 的\\ :ref:`稽核事件 ` ``ctypes." -#~ "addressof``。" - -#, fuzzy -#~ msgid "Raises an auditing event ctypes.get_errno with no arguments." -#~ msgstr "" -#~ "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``ctypes.get_errno``。" - -#, fuzzy -#~ msgid "Raises an auditing event ctypes.set_errno with argument errno." -#~ msgstr "" -#~ "引發一個附帶引數 ``errno`` 的\\ :ref:`稽核事件 ` ``ctypes." -#~ "set_errno``。" - -#, fuzzy -#~ msgid "Raises an auditing event ctypes.set_last_error with argument error." -#~ msgstr "" -#~ "引發一個附帶引數 ``error`` 的\\ :ref:`稽核事件 ` ``ctypes." -#~ "get_last_error``。" - -#, fuzzy -#~ msgid "Raises an auditing event ctypes.string_at with arguments ptr, size." -#~ msgstr "" -#~ "引發一個附帶引數 ``ptr``、``size`` 的\\ :ref:`稽核事件 ` " -#~ "``ctypes.string_at``。" - -#, fuzzy -#~ msgid "Raises an auditing event ctypes.wstring_at with arguments ptr, size." -#~ msgstr "" -#~ "引發一個附帶引數 ``ptr``、``size`` 的\\ :ref:`稽核事件 ` " -#~ "``ctypes.wstring_at``。" - -#, fuzzy -#~ msgid "" -#~ "This method, and others that indirectly call this method, raises an " -#~ "auditing event ctypes.cdata with argument address." -#~ msgstr "" -#~ "引發一個附帶引數 ``address`` 的\\ :ref:`稽核事件 ` ``ctypes." -#~ "cdata``。" - -#, fuzzy -#~ msgid "" -#~ "Raises an :ref:`auditing event ` ``ctypes.dlsym/handle`` with " -#~ "arguments ``handle``, ``name``." -#~ msgstr "" -#~ "引發一個附帶引數 ``handle``、``name`` 的\\ :ref:`稽核事件 ` " -#~ "``ctypes.dlsym/handle``。" - -#~ msgid ":c:expr:`size_t`" -#~ msgstr ":c:expr:`size_t`" diff --git a/library/ensurepip.po b/library/ensurepip.po index ec37983bae..beed2826ca 100644 --- a/library/ensurepip.po +++ b/library/ensurepip.po @@ -237,7 +237,6 @@ msgstr "" "*verbosity* 用來控制初始建置操作內，對於 :data:`sys.stdout` 的輸出等級。" #: ../../library/ensurepip.rst:125 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``ensurepip.bootstrap`` with " "argument ``root``." diff --git a/library/fcntl.po b/library/fcntl.po index 98b1e70e34..3d3e47c648 100644 --- a/library/fcntl.po +++ b/library/fcntl.po @@ -114,7 +114,6 @@ msgid "If the :c:func:`fcntl` call fails, an :exc:`OSError` is raised." msgstr "" #: ../../library/fcntl.rst:85 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``fcntl.fcntl`` with arguments " "``fd``, ``cmd``, ``arg``." @@ -184,7 +183,6 @@ msgid "An example::" msgstr "範例： ::" #: ../../library/fcntl.rst:136 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``fcntl.ioctl`` with arguments " "``fd``, ``request``, ``arg``." @@ -206,7 +204,6 @@ msgid "" msgstr "" #: ../../library/fcntl.rst:148 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``fcntl.flock`` with arguments " "``fd``, ``operation``." @@ -277,7 +274,6 @@ msgid "" msgstr "" #: ../../library/fcntl.rst:194 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``fcntl.lockf`` with arguments " "``fd``, ``cmd``, ``len``, ``start``, ``whence``." diff --git a/library/ftplib.po b/library/ftplib.po index 7f901762fc..241aab64ef 100644 --- a/library/ftplib.po +++ b/library/ftplib.po @@ -214,7 +214,6 @@ msgid "" msgstr "連線嘗試的超時設定，以秒為單位（預設：全域預設超時設定）。" #: ../../library/ftplib.rst:187 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``ftplib.connect`` with arguments " "``self``, ``host``, ``port``." @@ -259,7 +258,6 @@ msgid "" msgstr "向伺服器發送一個簡單的命令字串並回傳回應字串。" #: ../../library/ftplib.rst:229 ../../library/ftplib.rst:238 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``ftplib.sendcmd`` with arguments " "``self``, ``cmd``." diff --git a/library/functions.po b/library/functions.po index e292dd464d..781b799f9d 100644 --- a/library/functions.po +++ b/library/functions.po @@ -547,13 +547,12 @@ msgid "" msgstr "請注意，如果 :func:`sys.breakpointhook` 被替換了，則無法保證此功能。" #: ../../library/functions.rst:180 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``builtins.breakpoint`` with " "argument ``breakpointhook``." msgstr "" -"引發一個附帶引數 ``prompt`` 的\\ :ref:`稽核事件 ` ``builtins." -"input``。" +"引發一個附帶引數 ``breakpointhook`` 的\\ :ref:`稽核事件 ` " +"``builtins.breakpoint``。" #: ../../library/functions.rst:190 msgid "" @@ -1610,13 +1609,11 @@ msgid "This is the address of the object in memory." msgstr "這是該物件在記憶體中的位址。" #: ../../library/functions.rst:929 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``builtins.id`` with argument " "``id``." msgstr "" -"引發一個附帶引數 ``prompt`` 的\\ :ref:`稽核事件 ` ``builtins." -"input``。" +"引發一個附帶引數 ``id`` 的\\ :ref:`稽核事件 ` ``builtins.id``。" #: ../../library/functions.rst:935 msgid "" @@ -2394,13 +2391,12 @@ msgstr "" "`shutil`。" #: ../../library/functions.rst:1443 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``open`` with arguments ``path``, " "``mode``, ``flags``." msgstr "" -"引發一個附帶引數 ``source``、``filename`` 的\\ :ref:`稽核事件 ` " -"``compile``。" +"引發一個附帶引數 ``path``、``mode``、``flags`` 的\\ :ref:`稽核事件 " +"` ``open``。" #: ../../library/functions.rst:1445 msgid "" @@ -3414,67 +3410,3 @@ msgstr "import（引入）" #: ../../library/functions.rst:2111 msgid "builtins" msgstr "builtins（內建）" - -#, fuzzy -#~ msgid "" -#~ "Raises an auditing event builtins.breakpoint with argument breakpointhook." -#~ msgstr "" -#~ "引發一個附帶引數 ``breakpointhook`` 的\\ :ref:`稽核事件 ` " -#~ "``builtins.breakpoint``。" - -#, fuzzy -#~ msgid "" -#~ "Raises an auditing event compile with arguments source and filename. This " -#~ "event may also be raised by implicit compilation." -#~ msgstr "" -#~ "引發一個附帶引數 ``source``、``filename`` 的\\ :ref:`稽核事件 ` " -#~ "``compile``。此事件也可能由隱式編譯 (implicit compilation) 所引發。" - -#, fuzzy -#~ msgid "" -#~ "Raises an auditing event exec with the code object as the argument. Code " -#~ "compilation events may also be raised." -#~ msgstr "" -#~ "引發一個附帶程式碼物件為引數的\\ :ref:`稽核事件 ` ``exec``。也可" -#~ "能會引發程式碼編譯事件。" - -#, fuzzy -#~ msgid "Raises an auditing event builtins.id with argument id." -#~ msgstr "" -#~ "引發一個附帶引數 ``id`` 的\\ :ref:`稽核事件 ` ``builtins.id``。" - -#, fuzzy -#~ msgid "" -#~ "Raises an auditing event builtins.input with argument prompt before " -#~ "reading input" -#~ msgstr "" -#~ "引發一個附帶讀取輸入前的引數 ``prompt`` 的\\ :ref:`稽核事件 ` " -#~ "``builtins.input``。" - -#, fuzzy -#~ msgid "" -#~ "Raises an auditing event builtins.input/result with the result after " -#~ "successfully reading input." -#~ msgstr "" -#~ "引發一個附帶成功讀取結果的\\ :ref:`稽核事件 ` ``builtins.input/" -#~ "result``。" - -#, fuzzy -#~ msgid "Raises an auditing event open with arguments path, mode, flags." -#~ msgstr "" -#~ "引發一個附帶引數 ``path``、``model``、``path`` 的\\ :ref:`稽核事件 " -#~ "` ``open``。" - -#~ msgid "" -#~ "Raises an :ref:`auditing event ` ``exec`` with argument " -#~ "``code_object``." -#~ msgstr "" -#~ "引發一個附帶引數 ``code_object`` 的\\ :ref:`稽核事件 ` " -#~ "``exec``。" - -#~ msgid "" -#~ "Raises an :ref:`auditing event ` ``builtins.input/result`` with " -#~ "argument ``result``." -#~ msgstr "" -#~ "引發一個附帶引數 ``result`` 的\\ :ref:`稽核事件 ` ``builtins." -#~ "input/result``。" diff --git a/library/gc.po b/library/gc.po index 02cc0e017b..98e9675951 100644 --- a/library/gc.po +++ b/library/gc.po @@ -119,7 +119,6 @@ msgid "New *generation* parameter." msgstr "新增 *generation* 參數。" #: ../../library/gc.rst:78 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``gc.get_objects`` with argument " "``generation``." @@ -236,7 +235,6 @@ msgstr "" "目的。" #: ../../library/gc.rst:149 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``gc.get_referrers`` with " "argument ``objs``." @@ -263,7 +261,6 @@ msgstr "" "或不出現在結果的 list 當中。" #: ../../library/gc.rst:162 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``gc.get_referents`` with " "argument ``objs``." diff --git a/library/glob.po b/library/glob.po index 5d101d2899..ad7eaed562 100644 --- a/library/glob.po +++ b/library/glob.po @@ -118,7 +118,6 @@ msgid "" msgstr "如果 *include_hidden* 為真，\"``**``\" 模式將匹配被隱藏的目錄。" #: ../../library/glob.rst:73 ../../library/glob.rst:100 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``glob.glob`` with arguments " "``pathname``, ``recursive``." @@ -127,7 +126,6 @@ msgstr "" "``glob.glob``。" #: ../../library/glob.rst:74 ../../library/glob.rst:101 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``glob.glob/2`` with arguments " "``pathname``, ``recursive``, ``root_dir``, ``dir_fd``." diff --git a/library/http.client.po b/library/http.client.po index a55e0d45dd..2949a0283a 100644 --- a/library/http.client.po +++ b/library/http.client.po @@ -444,7 +444,6 @@ msgid "" msgstr "" #: ../../library/http.client.rst:404 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``http.client.connect`` with " "arguments ``self``, ``host``, ``port``." @@ -524,7 +523,6 @@ msgid "" msgstr "" #: ../../library/http.client.rst:474 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``http.client.send`` with " "arguments ``self``, ``data``." diff --git a/library/imaplib.po b/library/imaplib.po index e8425cd390..7c9694762f 100644 --- a/library/imaplib.po +++ b/library/imaplib.po @@ -1,5 +1,4 @@ -# SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2022, Python Software Foundation +# Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # # Translators: @@ -420,7 +419,6 @@ msgid "" msgstr "" #: ../../library/imaplib.rst:371 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``imaplib.open`` with arguments " "``self``, ``host``, ``port``." @@ -495,7 +493,6 @@ msgid "Sends ``data`` to the remote server. You may override this method." msgstr "" #: ../../library/imaplib.rst:444 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``imaplib.send`` with arguments " "``self``, ``data``." diff --git a/library/msvcrt.po b/library/msvcrt.po index fa09c8e737..4edb26438d 100644 --- a/library/msvcrt.po +++ b/library/msvcrt.po @@ -66,7 +66,6 @@ msgid "" msgstr "" #: ../../library/msvcrt.rst:45 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``msvcrt.locking`` with arguments " "``fd``, ``mode``, ``nbytes``." @@ -107,13 +106,12 @@ msgid "" msgstr "" #: ../../library/msvcrt.rst:82 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``msvcrt.open_osfhandle`` with " "arguments ``handle``, ``flags``." msgstr "" -"引發一個附帶引數 ``arguments``、``handle``、``flags`` 的\\ :ref:`稽核事件 " -"` ``msvcrt.open_osfhandle``。" +"引發一個附帶引數 ``handle``、``flags`` 的\\ :ref:`稽核事件 ` " +"``msvcrt.open_osfhandle``。" #: ../../library/msvcrt.rst:87 msgid "" @@ -122,7 +120,6 @@ msgid "" msgstr "" #: ../../library/msvcrt.rst:90 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``msvcrt.get_osfhandle`` with " "argument ``fd``." diff --git a/library/nntplib.po b/library/nntplib.po index 222123b746..cfaad72d0d 100644 --- a/library/nntplib.po +++ b/library/nntplib.po @@ -86,13 +86,12 @@ msgid "" msgstr "" #: ../../library/nntplib.rst:105 ../../library/nntplib.rst:137 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``nntplib.connect`` with " "arguments ``self``, ``host``, ``port``." msgstr "" -"引發一個附帶引數 ``self``、``line`` 的\\ :ref:`稽核事件 ` " -"``nntplib.putline``。" +"引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " +"` ``nntplib.connect``。" #: ../../library/nntplib.rst:107 ../../library/nntplib.rst:109 #: ../../library/nntplib.rst:139 ../../library/nntplib.rst:141 @@ -582,10 +581,3 @@ msgstr "protocol（協定）" #: ../../library/nntplib.rst:10 msgid "Network News Transfer Protocol" msgstr "Network News Transfer Protocol（網路新聞傳輸協定）" - -#, fuzzy -#~ msgid "" -#~ "Raises an auditing event nntplib.connect with arguments self, host, port." -#~ msgstr "" -#~ "引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " -#~ "` ``nntplib.connect``。" diff --git a/library/poplib.po b/library/poplib.po index b5880a033a..c64749d17a 100644 --- a/library/poplib.po +++ b/library/poplib.po @@ -78,13 +78,12 @@ msgid "" msgstr "" #: ../../library/poplib.rst:44 ../../library/poplib.rst:66 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``poplib.connect`` with arguments " "``self``, ``host``, ``port``." msgstr "" -"引發一個附帶引數 ``self``、``line`` 的\\ :ref:`稽核事件 ` ``poplib." -"putline``。" +"引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " +"` ``poplib.connect``。" #: ../../library/poplib.rst:46 ../../library/poplib.rst:48 #: ../../library/poplib.rst:68 ../../library/poplib.rst:70 diff --git a/library/sqlite3.po b/library/sqlite3.po index e464b3bc16..8d092d3ce7 100644 --- a/library/sqlite3.po +++ b/library/sqlite3.po @@ -346,7 +346,6 @@ msgid "Return type" msgstr "" #: ../../library/sqlite3.rst:346 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``sqlite3.connect`` with argument " "``database``." @@ -355,7 +354,6 @@ msgstr "" "connect``。" #: ../../library/sqlite3.rst:347 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``sqlite3.connect/handle`` with " "argument ``connection_handle``." @@ -1066,7 +1064,6 @@ msgid "" msgstr "" #: ../../library/sqlite3.rst:1020 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``sqlite3.enable_load_extension`` " "with arguments ``connection``, ``enabled``." @@ -1096,7 +1093,6 @@ msgid "" msgstr "" #: ../../library/sqlite3.rst:1073 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``sqlite3.load_extension`` with " "arguments ``connection``, ``path``." diff --git a/library/types.po b/library/types.po index e1eb1e2361..8b744cac29 100644 --- a/library/types.po +++ b/library/types.po @@ -191,7 +191,6 @@ msgid "" msgstr "" #: ../../library/types.rst:159 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``function.__new__`` with " "argument ``code``." @@ -230,7 +229,6 @@ msgid "" msgstr "" #: ../../library/types.rst:193 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``code.__new__`` with arguments " "``code``, ``filename``, ``name``, ``argcount``, ``posonlyargcount``, " diff --git a/reference/simple_stmts.po b/reference/simple_stmts.po index 30df8ec5fa..88ac39fca8 100644 --- a/reference/simple_stmts.po +++ b/reference/simple_stmts.po @@ -846,7 +846,6 @@ msgid "" msgstr "" #: ../../reference/simple_stmts.rst:866 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``import`` with arguments " "``module``, ``filename``, ``sys.path``, ``sys.meta_path``, ``sys." From 109444001bc5a83b3fd209e3ca6817a0ce4eeadf Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Sun, 18 Aug 2024 00:06:03 +0000 Subject: [PATCH 27/28] sync with cpython e9d1bf35 --- library/socket.po | 503 +++++++++++++++++++++++----------------------- 1 file changed, 255 insertions(+), 248 deletions(-) diff --git a/library/socket.po b/library/socket.po index 0e75960f76..89645227d9 100644 --- a/library/socket.po +++ b/library/socket.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-08-04 00:03+0000\n" +"POT-Creation-Date: 2024-08-18 00:04+0000\n" "PO-Revision-Date: 2018-05-23 16:10+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -112,8 +112,8 @@ msgid "" "Previously, :const:`AF_UNIX` socket paths were assumed to use UTF-8 encoding." msgstr "" -#: ../../library/socket.rst:66 ../../library/socket.rst:1148 -#: ../../library/socket.rst:1190 ../../library/socket.rst:1951 +#: ../../library/socket.rst:66 ../../library/socket.rst:1155 +#: ../../library/socket.rst:1197 ../../library/socket.rst:1958 msgid "Writable :term:`bytes-like object` is now accepted." msgstr "" @@ -288,7 +288,7 @@ msgid "*feat* and *mask* are unsigned 32bit integers." msgstr "" #: ../../library/socket.rst:171 ../../library/socket.rst:589 -#: ../../library/socket.rst:1873 +#: ../../library/socket.rst:1880 msgid ":ref:`Availability `: Linux >= 2.6.38." msgstr ":ref:`適用 `：Linux >= 2.6.38。" @@ -759,7 +759,7 @@ msgid "" "the :meth:`~socket.socket.ioctl` method of socket objects." msgstr "" -#: ../../library/socket.rst:574 ../../library/socket.rst:1563 +#: ../../library/socket.rst:574 ../../library/socket.rst:1570 msgid "``SIO_LOOPBACK_FAST_PATH`` was added." msgstr "加入 ``SIO_LOOPBACK_FAST_PATH``。" @@ -834,8 +834,8 @@ msgstr "" msgid "Constants for Windows Hyper-V sockets for host/guest communications." msgstr "" -#: ../../library/socket.rst:679 ../../library/socket.rst:886 -#: ../../library/socket.rst:1979 +#: ../../library/socket.rst:679 ../../library/socket.rst:893 +#: ../../library/socket.rst:1986 msgid ":ref:`Availability `: Windows." msgstr ":ref:`適用 `：Windows。" @@ -849,20 +849,38 @@ msgstr "" msgid ":ref:`Availability `: Linux, FreeBSD, macOS." msgstr ":ref:`適用 `：Linux、FreeBSD、macOS。" -#: ../../library/socket.rst:700 +#: ../../library/socket.rst:702 +msgid "" +"These constants are used by the :meth:`~socket.socket.shutdown` method of " +"socket objects." +msgstr "" + +#: ../../library/socket.rst:704 ../../library/socket.rst:989 +#: ../../library/socket.rst:1005 ../../library/socket.rst:1018 +#: ../../library/socket.rst:1033 ../../library/socket.rst:1050 +#: ../../library/socket.rst:1061 ../../library/socket.rst:1072 +#: ../../library/socket.rst:1083 ../../library/socket.rst:1407 +#: ../../library/socket.rst:1454 ../../library/socket.rst:1468 +#: ../../library/socket.rst:1488 ../../library/socket.rst:1535 +#: ../../library/socket.rst:1580 ../../library/socket.rst:1964 +#: ../../library/socket.rst:1974 +msgid ":ref:`Availability `: not WASI." +msgstr ":ref:`適用 `：非 WASI。" + +#: ../../library/socket.rst:707 msgid "Functions" msgstr "函式" -#: ../../library/socket.rst:703 +#: ../../library/socket.rst:710 msgid "Creating sockets" msgstr "建立 sockets" -#: ../../library/socket.rst:705 +#: ../../library/socket.rst:712 msgid "" "The following functions all create :ref:`socket objects `." msgstr "" -#: ../../library/socket.rst:710 +#: ../../library/socket.rst:717 msgid "" "Create a new socket using the given address family, socket type and protocol " "number. The address family should be :const:`AF_INET` (the default), :const:" @@ -875,7 +893,7 @@ msgid "" "`CAN_J1939`." msgstr "" -#: ../../library/socket.rst:720 +#: ../../library/socket.rst:727 msgid "" "If *fileno* is specified, the values for *family*, *type*, and *proto* are " "auto-detected from the specified file descriptor. Auto-detection can be " @@ -886,12 +904,12 @@ msgid "" "This may help close a detached socket using :meth:`socket.close()`." msgstr "" -#: ../../library/socket.rst:729 ../../library/socket.rst:875 -#: ../../library/socket.rst:1382 ../../library/socket.rst:1476 +#: ../../library/socket.rst:736 ../../library/socket.rst:882 +#: ../../library/socket.rst:1389 ../../library/socket.rst:1483 msgid "The newly created socket is :ref:`non-inheritable `." msgstr "" -#: ../../library/socket.rst:731 +#: ../../library/socket.rst:738 #, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.__new__`` with arguments " @@ -900,44 +918,44 @@ msgstr "" "引發一個附帶引數 ``self``、``family``、``type``、``protocol`` 的\\ :ref:`稽核" "事件 ` ``socket.__new__``。" -#: ../../library/socket.rst:733 +#: ../../library/socket.rst:740 msgid "The AF_CAN family was added. The AF_RDS family was added." msgstr "" -#: ../../library/socket.rst:737 +#: ../../library/socket.rst:744 msgid "The CAN_BCM protocol was added." msgstr "新增 CAN_BCM 協定。" -#: ../../library/socket.rst:740 ../../library/socket.rst:877 +#: ../../library/socket.rst:747 ../../library/socket.rst:884 msgid "The returned socket is now non-inheritable." msgstr "" -#: ../../library/socket.rst:743 +#: ../../library/socket.rst:750 msgid "The CAN_ISOTP protocol was added." msgstr "新增 CAN_ISOTP 協定。" -#: ../../library/socket.rst:746 +#: ../../library/socket.rst:753 msgid "" "When :const:`SOCK_NONBLOCK` or :const:`SOCK_CLOEXEC` bit flags are applied " "to *type* they are cleared, and :attr:`socket.type` will not reflect them. " "They are still passed to the underlying system ``socket()`` call. Therefore," msgstr "" -#: ../../library/socket.rst:758 +#: ../../library/socket.rst:765 msgid "" "will still create a non-blocking socket on OSes that support " "``SOCK_NONBLOCK``, but ``sock.type`` will be set to ``socket.SOCK_STREAM``." msgstr "" -#: ../../library/socket.rst:762 +#: ../../library/socket.rst:769 msgid "The CAN_J1939 protocol was added." msgstr "新增 CAN_J1939 協定。" -#: ../../library/socket.rst:765 +#: ../../library/socket.rst:772 msgid "The IPPROTO_MPTCP protocol was added." msgstr "新增 IPPROTO_MPTCP 協定。" -#: ../../library/socket.rst:770 +#: ../../library/socket.rst:777 msgid "" "Build a pair of connected socket objects using the given address family, " "socket type, and protocol number. Address family, socket type, and protocol " @@ -946,25 +964,25 @@ msgid "" "default is :const:`AF_INET`." msgstr "" -#: ../../library/socket.rst:775 +#: ../../library/socket.rst:782 msgid "The newly created sockets are :ref:`non-inheritable `." msgstr "" -#: ../../library/socket.rst:777 +#: ../../library/socket.rst:784 msgid "" "The returned socket objects now support the whole socket API, rather than a " "subset." msgstr "" -#: ../../library/socket.rst:781 +#: ../../library/socket.rst:788 msgid "The returned sockets are now non-inheritable." msgstr "" -#: ../../library/socket.rst:784 +#: ../../library/socket.rst:791 msgid "Windows support added." msgstr "新增對 Windows 的支援。" -#: ../../library/socket.rst:790 +#: ../../library/socket.rst:797 msgid "" "Connect to a TCP service listening on the internet *address* (a 2-tuple " "``(host, port)``), and return the socket object. This is a higher-level " @@ -975,21 +993,21 @@ msgid "" "IPv4 and IPv6." msgstr "" -#: ../../library/socket.rst:798 +#: ../../library/socket.rst:805 msgid "" "Passing the optional *timeout* parameter will set the timeout on the socket " "instance before attempting to connect. If no *timeout* is supplied, the " "global default timeout setting returned by :func:`getdefaulttimeout` is used." msgstr "" -#: ../../library/socket.rst:803 +#: ../../library/socket.rst:810 msgid "" "If supplied, *source_address* must be a 2-tuple ``(host, port)`` for the " "socket to bind to as its source address before connecting. If host or port " "are '' or 0 respectively the OS default behavior will be used." msgstr "" -#: ../../library/socket.rst:807 +#: ../../library/socket.rst:814 msgid "" "When a connection cannot be created, an exception is raised. By default, it " "is the exception from the last address in the list. If *all_errors* is " @@ -997,21 +1015,21 @@ msgid "" "attempts." msgstr "" -#: ../../library/socket.rst:812 +#: ../../library/socket.rst:819 msgid "*source_address* was added." msgstr "新增 *source_address*。" -#: ../../library/socket.rst:815 +#: ../../library/socket.rst:822 msgid "*all_errors* was added." msgstr "新增 *all_errors*。" -#: ../../library/socket.rst:821 +#: ../../library/socket.rst:828 msgid "" "Convenience function which creates a TCP socket bound to *address* (a 2-" "tuple ``(host, port)``) and returns the socket object." msgstr "" -#: ../../library/socket.rst:824 +#: ../../library/socket.rst:831 msgid "" "*family* should be either :data:`AF_INET` or :data:`AF_INET6`. *backlog* is " "the queue size passed to :meth:`socket.listen`; if not specified , a default " @@ -1019,7 +1037,7 @@ msgid "" "`SO_REUSEPORT` socket option." msgstr "" -#: ../../library/socket.rst:829 +#: ../../library/socket.rst:836 msgid "" "If *dualstack_ipv6* is true and the platform supports it the socket will be " "able to accept both IPv4 and IPv6 connections, else it will raise :exc:" @@ -1032,20 +1050,20 @@ msgid "" "func:`has_dualstack_ipv6`:" msgstr "" -#: ../../library/socket.rst:851 +#: ../../library/socket.rst:858 msgid "" "On POSIX platforms the :data:`SO_REUSEADDR` socket option is set in order to " "immediately reuse previous sockets which were bound on the same *address* " "and remained in TIME_WAIT state." msgstr "" -#: ../../library/socket.rst:859 +#: ../../library/socket.rst:866 msgid "" "Return ``True`` if the platform supports creating a TCP socket which can " "handle both IPv4 and IPv6 connections." msgstr "" -#: ../../library/socket.rst:866 +#: ../../library/socket.rst:873 msgid "" "Duplicate the file descriptor *fd* (an integer as returned by a file " "object's :meth:`~io.IOBase.fileno` method) and build a socket object from " @@ -1058,34 +1076,34 @@ msgid "" "daemon). The socket is assumed to be in blocking mode." msgstr "" -#: ../../library/socket.rst:883 +#: ../../library/socket.rst:890 msgid "" "Instantiate a socket from data obtained from the :meth:`socket.share` " "method. The socket is assumed to be in blocking mode." msgstr "" -#: ../../library/socket.rst:893 +#: ../../library/socket.rst:900 msgid "" "This is a Python type object that represents the socket object type. It is " "the same as ``type(socket(...))``." msgstr "" -#: ../../library/socket.rst:898 +#: ../../library/socket.rst:905 msgid "Other functions" msgstr "其他函式" -#: ../../library/socket.rst:900 +#: ../../library/socket.rst:907 msgid "The :mod:`socket` module also offers various network-related services:" msgstr "" -#: ../../library/socket.rst:905 +#: ../../library/socket.rst:912 msgid "" "Close a socket file descriptor. This is like :func:`os.close`, but for " "sockets. On some platforms (most noticeable Windows) :func:`os.close` does " "not work for socket file descriptors." msgstr "" -#: ../../library/socket.rst:913 +#: ../../library/socket.rst:920 msgid "" "Translate the *host*/*port* argument into a sequence of 5-tuples that " "contain all the necessary arguments for creating a socket connected to that " @@ -1095,7 +1113,7 @@ msgid "" "and *port*, you can pass ``NULL`` to the underlying C API." msgstr "" -#: ../../library/socket.rst:920 +#: ../../library/socket.rst:927 msgid "" "The *family*, *type* and *proto* arguments can be optionally specified in " "order to narrow the list of addresses returned. Passing zero as a value for " @@ -1106,15 +1124,15 @@ msgid "" "domain name." msgstr "" -#: ../../library/socket.rst:928 +#: ../../library/socket.rst:935 msgid "The function returns a list of 5-tuples with the following structure:" msgstr "" -#: ../../library/socket.rst:930 +#: ../../library/socket.rst:937 msgid "``(family, type, proto, canonname, sockaddr)``" msgstr "``(family, type, proto, canonname, sockaddr)``" -#: ../../library/socket.rst:932 +#: ../../library/socket.rst:939 msgid "" "In these tuples, *family*, *type*, *proto* are all integers and are meant to " "be passed to the :func:`~socket.socket` function. *canonname* will be a " @@ -1126,7 +1144,7 @@ msgid "" "`AF_INET6`), and is meant to be passed to the :meth:`socket.connect` method." msgstr "" -#: ../../library/socket.rst:942 +#: ../../library/socket.rst:949 #, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.getaddrinfo`` with " @@ -1135,24 +1153,24 @@ msgstr "" "引發一個附帶引數 ``host``、``port``、``family``、``type``、``protocol`` 的" "\\ :ref:`稽核事件 ` ``socket.getaddrinfo``。" -#: ../../library/socket.rst:944 +#: ../../library/socket.rst:951 msgid "" "The following example fetches address information for a hypothetical TCP " "connection to ``example.org`` on port 80 (results may differ on your system " "if IPv6 isn't enabled)::" msgstr "" -#: ../../library/socket.rst:954 +#: ../../library/socket.rst:961 msgid "parameters can now be passed using keyword arguments." msgstr "" -#: ../../library/socket.rst:957 +#: ../../library/socket.rst:964 msgid "" "for IPv6 multicast addresses, string representing an address will not " "contain ``%scope_id`` part." msgstr "" -#: ../../library/socket.rst:963 +#: ../../library/socket.rst:970 msgid "" "Return a fully qualified domain name for *name*. If *name* is omitted or " "empty, it is interpreted as the local host. To find the fully qualified " @@ -1163,7 +1181,7 @@ msgid "" "``'0.0.0.0'``, the hostname from :func:`gethostname` is returned." msgstr "" -#: ../../library/socket.rst:974 +#: ../../library/socket.rst:981 msgid "" "Translate a host name to IPv4 address format. The IPv4 address is returned " "as a string, such as ``'100.50.200.5'``. If the host name is an IPv4 " @@ -1173,7 +1191,7 @@ msgid "" "stack support." msgstr "" -#: ../../library/socket.rst:980 ../../library/socket.rst:996 +#: ../../library/socket.rst:987 ../../library/socket.rst:1003 #, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.gethostbyname`` with " @@ -1182,18 +1200,7 @@ msgstr "" "引發一個附帶引數 ``hostname`` 的\\ :ref:`稽核事件 ` ``socket." "gethostbyname``。" -#: ../../library/socket.rst:982 ../../library/socket.rst:998 -#: ../../library/socket.rst:1011 ../../library/socket.rst:1026 -#: ../../library/socket.rst:1043 ../../library/socket.rst:1054 -#: ../../library/socket.rst:1065 ../../library/socket.rst:1076 -#: ../../library/socket.rst:1400 ../../library/socket.rst:1447 -#: ../../library/socket.rst:1461 ../../library/socket.rst:1481 -#: ../../library/socket.rst:1528 ../../library/socket.rst:1573 -#: ../../library/socket.rst:1957 ../../library/socket.rst:1967 -msgid ":ref:`Availability `: not WASI." -msgstr ":ref:`適用 `：非 WASI。" - -#: ../../library/socket.rst:987 +#: ../../library/socket.rst:994 msgid "" "Translate a host name to IPv4 address format, extended interface. Return a 3-" "tuple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is the host's " @@ -1205,13 +1212,13 @@ msgid "" "stack support." msgstr "" -#: ../../library/socket.rst:1003 +#: ../../library/socket.rst:1010 msgid "" "Return a string containing the hostname of the machine where the Python " "interpreter is currently executing." msgstr "" -#: ../../library/socket.rst:1006 +#: ../../library/socket.rst:1013 #, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.gethostname`` with no " @@ -1219,13 +1226,13 @@ msgid "" msgstr "" "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``socket.gethostname``。" -#: ../../library/socket.rst:1008 +#: ../../library/socket.rst:1015 msgid "" "Note: :func:`gethostname` doesn't always return the fully qualified domain " "name; use :func:`getfqdn` for that." msgstr "" -#: ../../library/socket.rst:1016 +#: ../../library/socket.rst:1023 msgid "" "Return a 3-tuple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is " "the primary host name responding to the given *ip_address*, *aliaslist* is a " @@ -1236,7 +1243,7 @@ msgid "" "`gethostbyaddr` supports both IPv4 and IPv6." msgstr "" -#: ../../library/socket.rst:1024 +#: ../../library/socket.rst:1031 #, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.gethostbyaddr`` with " @@ -1245,7 +1252,7 @@ msgstr "" "引發一個附帶引數 ``ip_address`` 的\\ :ref:`稽核事件 ` ``socket." "gethostbyaddr``。" -#: ../../library/socket.rst:1031 +#: ../../library/socket.rst:1038 msgid "" "Translate a socket address *sockaddr* into a 2-tuple ``(host, port)``. " "Depending on the settings of *flags*, the result can contain a fully " @@ -1253,18 +1260,18 @@ msgid "" "Similarly, *port* can contain a string port name or a numeric port number." msgstr "" -#: ../../library/socket.rst:1036 +#: ../../library/socket.rst:1043 msgid "" "For IPv6 addresses, ``%scope_id`` is appended to the host part if *sockaddr* " "contains meaningful *scope_id*. Usually this happens for multicast addresses." msgstr "" -#: ../../library/socket.rst:1039 +#: ../../library/socket.rst:1046 msgid "" "For more information about *flags* you can consult :manpage:`getnameinfo(3)`." msgstr "" -#: ../../library/socket.rst:1041 +#: ../../library/socket.rst:1048 #, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.getnameinfo`` with " @@ -1273,7 +1280,7 @@ msgstr "" "引發一個附帶引數 ``sockaddr`` 的\\ :ref:`稽核事件 ` ``socket." "getnameinfo``。" -#: ../../library/socket.rst:1048 +#: ../../library/socket.rst:1055 msgid "" "Translate an internet protocol name (for example, ``'icmp'``) to a constant " "suitable for passing as the (optional) third argument to the :func:`~socket." @@ -1282,14 +1289,14 @@ msgid "" "is chosen automatically if the protocol is omitted or zero." msgstr "" -#: ../../library/socket.rst:1059 +#: ../../library/socket.rst:1066 msgid "" "Translate an internet service name and protocol name to a port number for " "that service. The optional protocol name, if given, should be ``'tcp'`` or " "``'udp'``, otherwise any protocol will match." msgstr "" -#: ../../library/socket.rst:1063 +#: ../../library/socket.rst:1070 #, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.getservbyname`` with " @@ -1298,14 +1305,14 @@ msgstr "" "引發一個附帶引數 ``sockaddr``、``protocolname`` 的\\ :ref:`稽核事件 " "` ``socket.getservbyname``。" -#: ../../library/socket.rst:1070 +#: ../../library/socket.rst:1077 msgid "" "Translate an internet port number and protocol name to a service name for " "that service. The optional protocol name, if given, should be ``'tcp'`` or " "``'udp'``, otherwise any protocol will match." msgstr "" -#: ../../library/socket.rst:1074 +#: ../../library/socket.rst:1081 #, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.getservbyport`` with " @@ -1314,40 +1321,40 @@ msgstr "" "引發一個附帶引數 ``port``、``protocolname`` 的\\ :ref:`稽核事件 ` " "``socket.getservbyport``。" -#: ../../library/socket.rst:1081 +#: ../../library/socket.rst:1088 msgid "" "Convert 32-bit positive integers from network to host byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 4-byte swap operation." msgstr "" -#: ../../library/socket.rst:1088 +#: ../../library/socket.rst:1095 msgid "" "Convert 16-bit positive integers from network to host byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 2-byte swap operation." msgstr "" -#: ../../library/socket.rst:1092 ../../library/socket.rst:1110 +#: ../../library/socket.rst:1099 ../../library/socket.rst:1117 msgid "" "Raises :exc:`OverflowError` if *x* does not fit in a 16-bit unsigned integer." msgstr "" -#: ../../library/socket.rst:1099 +#: ../../library/socket.rst:1106 msgid "" "Convert 32-bit positive integers from host to network byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 4-byte swap operation." msgstr "" -#: ../../library/socket.rst:1106 +#: ../../library/socket.rst:1113 msgid "" "Convert 16-bit positive integers from host to network byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 2-byte swap operation." msgstr "" -#: ../../library/socket.rst:1117 +#: ../../library/socket.rst:1124 msgid "" "Convert an IPv4 address from dotted-quad string format (for example, " "'123.45.67.89') to 32-bit packed binary format, as a bytes object four " @@ -1356,26 +1363,26 @@ msgid "" "which is the C type for the 32-bit packed binary this function returns." msgstr "" -#: ../../library/socket.rst:1123 +#: ../../library/socket.rst:1130 msgid "" ":func:`inet_aton` also accepts strings with less than three dots; see the " "Unix manual page :manpage:`inet(3)` for details." msgstr "" -#: ../../library/socket.rst:1126 +#: ../../library/socket.rst:1133 msgid "" "If the IPv4 address string passed to this function is invalid, :exc:" "`OSError` will be raised. Note that exactly what is valid depends on the " "underlying C implementation of :c:func:`inet_aton`." msgstr "" -#: ../../library/socket.rst:1130 +#: ../../library/socket.rst:1137 msgid "" ":func:`inet_aton` does not support IPv6, and :func:`inet_pton` should be " "used instead for IPv4/v6 dual stack support." msgstr "" -#: ../../library/socket.rst:1136 +#: ../../library/socket.rst:1143 msgid "" "Convert a 32-bit packed IPv4 address (a :term:`bytes-like object` four bytes " "in length) to its standard dotted-quad string representation (for example, " @@ -1385,7 +1392,7 @@ msgid "" "argument." msgstr "" -#: ../../library/socket.rst:1143 +#: ../../library/socket.rst:1150 msgid "" "If the byte sequence passed to this function is not exactly 4 bytes in " "length, :exc:`OSError` will be raised. :func:`inet_ntoa` does not support " @@ -1393,7 +1400,7 @@ msgid "" "support." msgstr "" -#: ../../library/socket.rst:1154 +#: ../../library/socket.rst:1161 msgid "" "Convert an IP address from its family-specific string format to a packed, " "binary format. :func:`inet_pton` is useful when a library or network " @@ -1401,7 +1408,7 @@ msgid "" "`inet_aton`) or :c:struct:`in6_addr`." msgstr "" -#: ../../library/socket.rst:1159 +#: ../../library/socket.rst:1166 msgid "" "Supported values for *address_family* are currently :const:`AF_INET` and :" "const:`AF_INET6`. If the IP address string *ip_string* is invalid, :exc:" @@ -1410,15 +1417,15 @@ msgid "" "`inet_pton`." msgstr "" -#: ../../library/socket.rst:1165 ../../library/socket.rst:1185 +#: ../../library/socket.rst:1172 ../../library/socket.rst:1192 msgid ":ref:`Availability `: Unix, Windows." msgstr ":ref:`適用 `：Unix、Windows。" -#: ../../library/socket.rst:1167 ../../library/socket.rst:1187 +#: ../../library/socket.rst:1174 ../../library/socket.rst:1194 msgid "Windows support added" msgstr "" -#: ../../library/socket.rst:1173 +#: ../../library/socket.rst:1180 msgid "" "Convert a packed IP address (a :term:`bytes-like object` of some number of " "bytes) to its standard, family-specific string representation (for example, " @@ -1427,7 +1434,7 @@ msgid "" "(similar to :func:`inet_ntoa`) or :c:struct:`in6_addr`." msgstr "" -#: ../../library/socket.rst:1180 +#: ../../library/socket.rst:1187 msgid "" "Supported values for *address_family* are currently :const:`AF_INET` and :" "const:`AF_INET6`. If the bytes object *packed_ip* is not the correct length " @@ -1435,7 +1442,7 @@ msgid "" "`OSError` is raised for errors from the call to :func:`inet_ntop`." msgstr "" -#: ../../library/socket.rst:1202 +#: ../../library/socket.rst:1209 msgid "" "Return the total length, without trailing padding, of an ancillary data item " "with associated data of the given *length*. This value can often be used as " @@ -1446,16 +1453,16 @@ msgid "" "the permissible range of values." msgstr "" -#: ../../library/socket.rst:1211 ../../library/socket.rst:1234 +#: ../../library/socket.rst:1218 ../../library/socket.rst:1241 msgid ":ref:`Availability `: Unix, not Emscripten, not WASI." msgstr ":ref:`適用 `：Unix、非 Emscripten、非 WASI。" -#: ../../library/socket.rst:1213 ../../library/socket.rst:1705 -#: ../../library/socket.rst:1749 ../../library/socket.rst:1857 +#: ../../library/socket.rst:1220 ../../library/socket.rst:1712 +#: ../../library/socket.rst:1756 ../../library/socket.rst:1864 msgid "Most Unix platforms." msgstr "" -#: ../../library/socket.rst:1220 +#: ../../library/socket.rst:1227 msgid "" "Return the buffer size needed for :meth:`~socket.recvmsg` to receive an " "ancillary data item with associated data of the given *length*, along with " @@ -1465,7 +1472,7 @@ msgid "" "values." msgstr "" -#: ../../library/socket.rst:1228 +#: ../../library/socket.rst:1235 msgid "" "Note that some systems might support ancillary data without providing this " "function. Also note that setting the buffer size using the results of this " @@ -1473,31 +1480,31 @@ msgid "" "received, since additional data may be able to fit into the padding area." msgstr "" -#: ../../library/socket.rst:1236 +#: ../../library/socket.rst:1243 msgid "most Unix platforms." msgstr "" -#: ../../library/socket.rst:1243 +#: ../../library/socket.rst:1250 msgid "" "Return the default timeout in seconds (float) for new socket objects. A " "value of ``None`` indicates that new socket objects have no timeout. When " "the socket module is first imported, the default is ``None``." msgstr "" -#: ../../library/socket.rst:1250 +#: ../../library/socket.rst:1257 msgid "" "Set the default timeout in seconds (float) for new socket objects. When the " "socket module is first imported, the default is ``None``. See :meth:" "`~socket.settimeout` for possible values and their respective meanings." msgstr "" -#: ../../library/socket.rst:1258 +#: ../../library/socket.rst:1265 msgid "" "Set the machine's hostname to *name*. This will raise an :exc:`OSError` if " "you don't have enough rights." msgstr "" -#: ../../library/socket.rst:1261 +#: ../../library/socket.rst:1268 #, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.sethostname`` with " @@ -1506,114 +1513,114 @@ msgstr "" "引發一個附帶引數 ``name`` 的\\ :ref:`稽核事件 ` ``socket." "sethostname``。" -#: ../../library/socket.rst:1263 ../../library/socket.rst:1703 -#: ../../library/socket.rst:1747 +#: ../../library/socket.rst:1270 ../../library/socket.rst:1710 +#: ../../library/socket.rst:1754 msgid ":ref:`Availability `: Unix." msgstr ":ref:`適用 `：Unix。" -#: ../../library/socket.rst:1270 +#: ../../library/socket.rst:1277 msgid "" "Return a list of network interface information (index int, name string) " "tuples. :exc:`OSError` if the system call fails." msgstr "" -#: ../../library/socket.rst:1274 ../../library/socket.rst:1301 -#: ../../library/socket.rst:1318 ../../library/socket.rst:1335 -#: ../../library/socket.rst:1349 +#: ../../library/socket.rst:1281 ../../library/socket.rst:1308 +#: ../../library/socket.rst:1325 ../../library/socket.rst:1342 +#: ../../library/socket.rst:1356 msgid "" ":ref:`Availability `: Unix, Windows, not Emscripten, not WASI." msgstr ":ref:`適用 `：Unix、Windows、非 Emscripten、非 WASI。" -#: ../../library/socket.rst:1278 ../../library/socket.rst:1305 -#: ../../library/socket.rst:1322 +#: ../../library/socket.rst:1285 ../../library/socket.rst:1312 +#: ../../library/socket.rst:1329 msgid "Windows support was added." msgstr "增加對 Windows 的支援。" -#: ../../library/socket.rst:1283 +#: ../../library/socket.rst:1290 msgid "" "On Windows network interfaces have different names in different contexts " "(all names are examples):" msgstr "" -#: ../../library/socket.rst:1286 +#: ../../library/socket.rst:1293 msgid "UUID: ``{FB605B73-AAC2-49A6-9A2F-25416AEA0573}``" msgstr "UUID: ``{FB605B73-AAC2-49A6-9A2F-25416AEA0573}``" -#: ../../library/socket.rst:1287 +#: ../../library/socket.rst:1294 msgid "name: ``ethernet_32770``" msgstr "" -#: ../../library/socket.rst:1288 +#: ../../library/socket.rst:1295 msgid "friendly name: ``vEthernet (nat)``" msgstr "" -#: ../../library/socket.rst:1289 +#: ../../library/socket.rst:1296 msgid "description: ``Hyper-V Virtual Ethernet Adapter``" msgstr "" -#: ../../library/socket.rst:1291 +#: ../../library/socket.rst:1298 msgid "" "This function returns names of the second form from the list, " "``ethernet_32770`` in this example case." msgstr "" -#: ../../library/socket.rst:1297 +#: ../../library/socket.rst:1304 msgid "" "Return a network interface index number corresponding to an interface name. :" "exc:`OSError` if no interface with the given name exists." msgstr "" -#: ../../library/socket.rst:1309 ../../library/socket.rst:1326 +#: ../../library/socket.rst:1316 ../../library/socket.rst:1333 msgid "\"Interface name\" is a name as documented in :func:`if_nameindex`." msgstr "" -#: ../../library/socket.rst:1314 +#: ../../library/socket.rst:1321 msgid "" "Return a network interface name corresponding to an interface index number. :" "exc:`OSError` if no interface with the given index exists." msgstr "" -#: ../../library/socket.rst:1331 +#: ../../library/socket.rst:1338 msgid "" "Send the list of file descriptors *fds* over an :const:`AF_UNIX` socket " "*sock*. The *fds* parameter is a sequence of file descriptors. Consult :meth:" "`~socket.sendmsg` for the documentation of these parameters." msgstr "" -#: ../../library/socket.rst:1337 ../../library/socket.rst:1351 +#: ../../library/socket.rst:1344 ../../library/socket.rst:1358 msgid "" "Unix platforms supporting :meth:`~socket.sendmsg` and :const:`SCM_RIGHTS` " "mechanism." msgstr "" -#: ../../library/socket.rst:1345 +#: ../../library/socket.rst:1352 msgid "" "Receive up to *maxfds* file descriptors from an :const:`AF_UNIX` socket " "*sock*. Return ``(msg, list(fds), flags, addr)``. Consult :meth:`~socket." "recvmsg` for the documentation of these parameters." msgstr "" -#: ../../library/socket.rst:1358 +#: ../../library/socket.rst:1365 msgid "Any truncated integers at the end of the list of file descriptors." msgstr "" -#: ../../library/socket.rst:1364 +#: ../../library/socket.rst:1371 msgid "Socket Objects" msgstr "Socket 物件" -#: ../../library/socket.rst:1366 +#: ../../library/socket.rst:1373 msgid "" "Socket objects have the following methods. Except for :meth:`~socket." "makefile`, these correspond to Unix system calls applicable to sockets." msgstr "" -#: ../../library/socket.rst:1370 +#: ../../library/socket.rst:1377 msgid "" "Support for the :term:`context manager` protocol was added. Exiting the " "context manager is equivalent to calling :meth:`~socket.close`." msgstr "" -#: ../../library/socket.rst:1377 +#: ../../library/socket.rst:1384 msgid "" "Accept a connection. The socket must be bound to an address and listening " "for connections. The return value is a pair ``(conn, address)`` where *conn* " @@ -1622,27 +1629,27 @@ msgid "" "connection." msgstr "" -#: ../../library/socket.rst:1384 ../../library/socket.rst:1478 +#: ../../library/socket.rst:1391 ../../library/socket.rst:1485 msgid "The socket is now non-inheritable." msgstr "" -#: ../../library/socket.rst:1387 ../../library/socket.rst:1618 -#: ../../library/socket.rst:1632 ../../library/socket.rst:1709 -#: ../../library/socket.rst:1782 ../../library/socket.rst:1801 -#: ../../library/socket.rst:1818 ../../library/socket.rst:1863 +#: ../../library/socket.rst:1394 ../../library/socket.rst:1625 +#: ../../library/socket.rst:1639 ../../library/socket.rst:1716 +#: ../../library/socket.rst:1789 ../../library/socket.rst:1808 +#: ../../library/socket.rst:1825 ../../library/socket.rst:1870 msgid "" "If the system call is interrupted and the signal handler does not raise an " "exception, the method now retries the system call instead of raising an :exc:" "`InterruptedError` exception (see :pep:`475` for the rationale)." msgstr "" -#: ../../library/socket.rst:1395 +#: ../../library/socket.rst:1402 msgid "" "Bind the socket to *address*. The socket must not already be bound. (The " "format of *address* depends on the address family --- see above.)" msgstr "" -#: ../../library/socket.rst:1398 +#: ../../library/socket.rst:1405 #, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.bind`` with arguments " @@ -1651,7 +1658,7 @@ msgstr "" "引發一個附帶引數 ``self``、``address`` 的\\ :ref:`稽核事件 ` " "``socket.bind``。" -#: ../../library/socket.rst:1405 +#: ../../library/socket.rst:1412 msgid "" "Mark the socket closed. The underlying system resource (e.g. a file " "descriptor) is also closed when all file objects from :meth:`makefile()` are " @@ -1660,20 +1667,20 @@ msgid "" "flushed)." msgstr "" -#: ../../library/socket.rst:1411 +#: ../../library/socket.rst:1418 msgid "" "Sockets are automatically closed when they are garbage-collected, but it is " "recommended to :meth:`close` them explicitly, or to use a :keyword:`with` " "statement around them." msgstr "" -#: ../../library/socket.rst:1415 +#: ../../library/socket.rst:1422 msgid "" ":exc:`OSError` is now raised if an error occurs when the underlying :c:func:" "`close` call is made." msgstr "" -#: ../../library/socket.rst:1421 +#: ../../library/socket.rst:1428 msgid "" ":meth:`close()` releases the resource associated with a connection but does " "not necessarily close the connection immediately. If you want to close the " @@ -1681,13 +1688,13 @@ msgid "" "`close()`." msgstr "" -#: ../../library/socket.rst:1429 +#: ../../library/socket.rst:1436 msgid "" "Connect to a remote socket at *address*. (The format of *address* depends on " "the address family --- see above.)" msgstr "" -#: ../../library/socket.rst:1432 +#: ../../library/socket.rst:1439 msgid "" "If the connection is interrupted by a signal, the method waits until the " "connection completes, or raise a :exc:`TimeoutError` on timeout, if the " @@ -1697,7 +1704,7 @@ msgid "" "(or the exception raised by the signal handler)." msgstr "" -#: ../../library/socket.rst:1439 ../../library/socket.rst:1459 +#: ../../library/socket.rst:1446 ../../library/socket.rst:1466 #, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.connect`` with arguments " @@ -1706,7 +1713,7 @@ msgstr "" "引發一個附帶引數 ``self``、``address`` 的\\ :ref:`稽核事件 ` " "``socket.connect``。" -#: ../../library/socket.rst:1441 +#: ../../library/socket.rst:1448 msgid "" "The method now waits until the connection completes instead of raising an :" "exc:`InterruptedError` exception if the connection is interrupted by a " @@ -1714,7 +1721,7 @@ msgid "" "blocking or has a timeout (see the :pep:`475` for the rationale)." msgstr "" -#: ../../library/socket.rst:1452 +#: ../../library/socket.rst:1459 msgid "" "Like ``connect(address)``, but return an error indicator instead of raising " "an exception for errors returned by the C-level :c:func:`connect` call " @@ -1724,38 +1731,38 @@ msgid "" "asynchronous connects." msgstr "" -#: ../../library/socket.rst:1465 +#: ../../library/socket.rst:1472 msgid "" "Put the socket object into closed state without actually closing the " "underlying file descriptor. The file descriptor is returned, and can be " "reused for other purposes." msgstr "" -#: ../../library/socket.rst:1474 +#: ../../library/socket.rst:1481 msgid "Duplicate the socket." msgstr "" -#: ../../library/socket.rst:1486 +#: ../../library/socket.rst:1493 msgid "" "Return the socket's file descriptor (a small integer), or -1 on failure. " "This is useful with :func:`select.select`." msgstr "" -#: ../../library/socket.rst:1489 +#: ../../library/socket.rst:1496 msgid "" "Under Windows the small integer returned by this method cannot be used where " "a file descriptor can be used (such as :func:`os.fdopen`). Unix does not " "have this limitation." msgstr "" -#: ../../library/socket.rst:1495 +#: ../../library/socket.rst:1502 msgid "" "Get the :ref:`inheritable flag ` of the socket's file " "descriptor or socket's handle: ``True`` if the socket can be inherited in " "child processes, ``False`` if it cannot." msgstr "" -#: ../../library/socket.rst:1504 +#: ../../library/socket.rst:1511 msgid "" "Return the remote address to which the socket is connected. This is useful " "to find out the port number of a remote IPv4/v6 socket, for instance. (The " @@ -1763,14 +1770,14 @@ msgid "" "above.) On some systems this function is not supported." msgstr "" -#: ../../library/socket.rst:1512 +#: ../../library/socket.rst:1519 msgid "" "Return the socket's own address. This is useful to find out the port number " "of an IPv4/v6 socket, for instance. (The format of the address returned " "depends on the address family --- see above.)" msgstr "" -#: ../../library/socket.rst:1519 +#: ../../library/socket.rst:1526 msgid "" "Return the value of the given socket option (see the Unix man page :manpage:" "`getsockopt(2)`). The needed symbolic constants (:ref:`SO_\\* etc. `_ for more information." msgstr "" -#: ../../library/socket.rst:1557 +#: ../../library/socket.rst:1564 msgid "" "On other platforms, the generic :func:`fcntl.fcntl` and :func:`fcntl.ioctl` " "functions may be used; they accept a socket object as their first argument." msgstr "" -#: ../../library/socket.rst:1560 +#: ../../library/socket.rst:1567 msgid "" "Currently only the following control codes are supported: ``SIO_RCVALL``, " "``SIO_KEEPALIVE_VALS``, and ``SIO_LOOPBACK_FAST_PATH``." msgstr "" -#: ../../library/socket.rst:1568 +#: ../../library/socket.rst:1575 msgid "" "Enable a server to accept connections. If *backlog* is specified, it must " "be at least 0 (if it is lower, it is set to 0); it specifies the number of " @@ -1834,11 +1841,11 @@ msgid "" "connections. If not specified, a default reasonable value is chosen." msgstr "" -#: ../../library/socket.rst:1575 +#: ../../library/socket.rst:1582 msgid "The *backlog* parameter is now optional." msgstr "" -#: ../../library/socket.rst:1584 +#: ../../library/socket.rst:1591 msgid "" "Return a :term:`file object` associated with the socket. The exact returned " "type depends on the arguments given to :meth:`makefile`. These arguments " @@ -1847,28 +1854,28 @@ msgid "" "``'b'``, or a combination of those." msgstr "" -#: ../../library/socket.rst:1590 +#: ../../library/socket.rst:1597 msgid "" "The socket must be in blocking mode; it can have a timeout, but the file " "object's internal buffer may end up in an inconsistent state if a timeout " "occurs." msgstr "" -#: ../../library/socket.rst:1594 +#: ../../library/socket.rst:1601 msgid "" "Closing the file object returned by :meth:`makefile` won't close the " "original socket unless all other file objects have been closed and :meth:" "`socket.close` has been called on the socket object." msgstr "" -#: ../../library/socket.rst:1600 +#: ../../library/socket.rst:1607 msgid "" "On Windows, the file-like object created by :meth:`makefile` cannot be used " "where a file object with a file descriptor is expected, such as the stream " "arguments of :meth:`subprocess.Popen`." msgstr "" -#: ../../library/socket.rst:1607 +#: ../../library/socket.rst:1614 msgid "" "Receive data from the socket. The return value is a bytes object " "representing the data received. The maximum amount of data to be received " @@ -1878,13 +1885,13 @@ msgid "" "zero." msgstr "" -#: ../../library/socket.rst:1615 +#: ../../library/socket.rst:1622 msgid "" "For best match with hardware and network realities, the value of *bufsize* " "should be a relatively small power of 2, for example, 4096." msgstr "" -#: ../../library/socket.rst:1626 +#: ../../library/socket.rst:1633 msgid "" "Receive data from the socket. The return value is a pair ``(bytes, " "address)`` where *bytes* is a bytes object representing the data received " @@ -1894,14 +1901,14 @@ msgid "" "address family --- see above.)" msgstr "" -#: ../../library/socket.rst:1637 +#: ../../library/socket.rst:1644 msgid "" "For multicast IPv6 address, first item of *address* does not contain " "``%scope_id`` part anymore. In order to get full IPv6 address use :func:" "`getnameinfo`." msgstr "" -#: ../../library/socket.rst:1644 +#: ../../library/socket.rst:1651 msgid "" "Receive normal data (up to *bufsize* bytes) and ancillary data from the " "socket. The *ancbufsize* argument sets the size in bytes of the internal " @@ -1912,7 +1919,7 @@ msgid "" "*flags* argument defaults to 0 and has the same meaning as for :meth:`recv`." msgstr "" -#: ../../library/socket.rst:1654 +#: ../../library/socket.rst:1661 msgid "" "The return value is a 4-tuple: ``(data, ancdata, msg_flags, address)``. The " "*data* item is a :class:`bytes` object holding the non-ancillary data " @@ -1927,7 +1934,7 @@ msgid "" "socket, if available; otherwise, its value is unspecified." msgstr "" -#: ../../library/socket.rst:1668 +#: ../../library/socket.rst:1675 msgid "" "On some systems, :meth:`sendmsg` and :meth:`recvmsg` can be used to pass " "file descriptors between processes over an :const:`AF_UNIX` socket. When " @@ -1940,7 +1947,7 @@ msgid "" "descriptors received via this mechanism." msgstr "" -#: ../../library/socket.rst:1679 +#: ../../library/socket.rst:1686 msgid "" "Some systems do not indicate the truncated length of ancillary data items " "which have been only partially received. If an item appears to extend " @@ -1949,7 +1956,7 @@ msgid "" "provided it has not been truncated before the start of its associated data." msgstr "" -#: ../../library/socket.rst:1686 +#: ../../library/socket.rst:1693 msgid "" "On systems which support the :const:`SCM_RIGHTS` mechanism, the following " "function will receive up to *maxfds* file descriptors, returning the message " @@ -1958,7 +1965,7 @@ msgid "" "meth:`sendmsg`. ::" msgstr "" -#: ../../library/socket.rst:1717 +#: ../../library/socket.rst:1724 msgid "" "Receive normal data and ancillary data from the socket, behaving as :meth:" "`recvmsg` would, but scatter the non-ancillary data into a series of buffers " @@ -1971,7 +1978,7 @@ msgid "" "arguments have the same meaning as for :meth:`recvmsg`." msgstr "" -#: ../../library/socket.rst:1728 +#: ../../library/socket.rst:1735 msgid "" "The return value is a 4-tuple: ``(nbytes, ancdata, msg_flags, address)``, " "where *nbytes* is the total number of bytes of non-ancillary data written " @@ -1979,11 +1986,11 @@ msgid "" "for :meth:`recvmsg`." msgstr "" -#: ../../library/socket.rst:1733 +#: ../../library/socket.rst:1740 msgid "Example::" msgstr "範例： ::" -#: ../../library/socket.rst:1756 +#: ../../library/socket.rst:1763 msgid "" "Receive data from the socket, writing it into *buffer* instead of creating a " "new bytestring. The return value is a pair ``(nbytes, address)`` where " @@ -1993,7 +2000,7 @@ msgid "" "format of *address* depends on the address family --- see above.)" msgstr "" -#: ../../library/socket.rst:1766 +#: ../../library/socket.rst:1773 msgid "" "Receive up to *nbytes* bytes from the socket, storing the data into a buffer " "rather than creating a new bytestring. If *nbytes* is not specified (or 0), " @@ -2002,7 +2009,7 @@ msgid "" "of the optional argument *flags*; it defaults to zero." msgstr "" -#: ../../library/socket.rst:1775 +#: ../../library/socket.rst:1782 msgid "" "Send data to the socket. The socket must be connected to a remote socket. " "The optional *flags* argument has the same meaning as for :meth:`recv` " @@ -2012,7 +2019,7 @@ msgid "" "data. For further information on this topic, consult the :ref:`socket-howto`." msgstr "" -#: ../../library/socket.rst:1790 +#: ../../library/socket.rst:1797 msgid "" "Send data to the socket. The socket must be connected to a remote socket. " "The optional *flags* argument has the same meaning as for :meth:`recv` " @@ -2022,13 +2029,13 @@ msgid "" "to determine how much data, if any, was successfully sent." msgstr "" -#: ../../library/socket.rst:1797 +#: ../../library/socket.rst:1804 msgid "" "The socket timeout is no longer reset each time data is sent successfully. " "The socket timeout is now the maximum total duration to send all data." msgstr "" -#: ../../library/socket.rst:1810 +#: ../../library/socket.rst:1817 msgid "" "Send data to the socket. The socket should not be connected to a remote " "socket, since the destination socket is specified by *address*. The " @@ -2037,7 +2044,7 @@ msgid "" "address family --- see above.)" msgstr "" -#: ../../library/socket.rst:1816 +#: ../../library/socket.rst:1823 #, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.sendto`` with arguments " @@ -2046,7 +2053,7 @@ msgstr "" "引發一個附帶引數 ``self``、``address`` 的\\ :ref:`稽核事件 ` " "``socket.sendto``。" -#: ../../library/socket.rst:1826 +#: ../../library/socket.rst:1833 msgid "" "Send normal and ancillary data to the socket, gathering the non-ancillary " "data from a series of buffers and concatenating it into a single message. " @@ -2066,18 +2073,18 @@ msgid "" "bytes of non-ancillary data sent." msgstr "" -#: ../../library/socket.rst:1846 +#: ../../library/socket.rst:1853 msgid "" "The following function sends the list of file descriptors *fds* over an :" "const:`AF_UNIX` socket, on systems which support the :const:`SCM_RIGHTS` " "mechanism. See also :meth:`recvmsg`. ::" msgstr "" -#: ../../library/socket.rst:1855 +#: ../../library/socket.rst:1862 msgid ":ref:`Availability `: Unix, not WASI." msgstr ":ref:`適用 `：Unix、非 WASI。" -#: ../../library/socket.rst:1859 +#: ../../library/socket.rst:1866 #, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.sendmsg`` with arguments " @@ -2086,14 +2093,14 @@ msgstr "" "引發一個附帶引數 ``self``、``address`` 的\\ :ref:`稽核事件 ` " "``socket.sendmsg``。" -#: ../../library/socket.rst:1870 +#: ../../library/socket.rst:1877 msgid "" "Specialized version of :meth:`~socket.sendmsg` for :const:`AF_ALG` socket. " "Set mode, IV, AEAD associated data length and flags for :const:`AF_ALG` " "socket." msgstr "" -#: ../../library/socket.rst:1879 +#: ../../library/socket.rst:1886 msgid "" "Send a file until EOF is reached by using high-performance :mod:`os." "sendfile` and return the total number of bytes which were sent. *file* must " @@ -2107,38 +2114,38 @@ msgid "" "be of :const:`SOCK_STREAM` type. Non-blocking sockets are not supported." msgstr "" -#: ../../library/socket.rst:1895 +#: ../../library/socket.rst:1902 msgid "" "Set the :ref:`inheritable flag ` of the socket's file " "descriptor or socket's handle." msgstr "" -#: ../../library/socket.rst:1903 +#: ../../library/socket.rst:1910 msgid "" "Set blocking or non-blocking mode of the socket: if *flag* is false, the " "socket is set to non-blocking, else to blocking mode." msgstr "" -#: ../../library/socket.rst:1906 +#: ../../library/socket.rst:1913 msgid "" "This method is a shorthand for certain :meth:`~socket.settimeout` calls:" msgstr "" -#: ../../library/socket.rst:1908 +#: ../../library/socket.rst:1915 msgid "``sock.setblocking(True)`` is equivalent to ``sock.settimeout(None)``" msgstr "``sock.setblocking(True)`` 等價於 ``sock.settimeout(None)``" -#: ../../library/socket.rst:1910 +#: ../../library/socket.rst:1917 msgid "``sock.setblocking(False)`` is equivalent to ``sock.settimeout(0.0)``" msgstr "``sock.setblocking(False)`` 等價於 ``sock.settimeout(0.0)``" -#: ../../library/socket.rst:1912 +#: ../../library/socket.rst:1919 msgid "" "The method no longer applies :const:`SOCK_NONBLOCK` flag on :attr:`socket." "type`." msgstr "" -#: ../../library/socket.rst:1919 +#: ../../library/socket.rst:1926 msgid "" "Set a timeout on blocking socket operations. The *value* argument can be a " "nonnegative floating-point number expressing seconds, or ``None``. If a non-" @@ -2148,19 +2155,19 @@ msgid "" "blocking mode. If ``None`` is given, the socket is put in blocking mode." msgstr "" -#: ../../library/socket.rst:1926 +#: ../../library/socket.rst:1933 msgid "" "For further information, please consult the :ref:`notes on socket timeouts " "`." msgstr "" -#: ../../library/socket.rst:1928 +#: ../../library/socket.rst:1935 msgid "" "The method no longer toggles :const:`SOCK_NONBLOCK` flag on :attr:`socket." "type`." msgstr "" -#: ../../library/socket.rst:1941 +#: ../../library/socket.rst:1948 msgid "" "Set the value of the given socket option (see the Unix manual page :manpage:" "`setsockopt(2)`). The needed symbolic constants are defined in this module " @@ -2173,11 +2180,11 @@ msgid "" "C function with ``optval=NULL`` and ``optlen=optlen``." msgstr "" -#: ../../library/socket.rst:1954 +#: ../../library/socket.rst:1961 msgid "setsockopt(level, optname, None, optlen: int) form added." msgstr "" -#: ../../library/socket.rst:1962 +#: ../../library/socket.rst:1969 msgid "" "Shut down one or both halves of the connection. If *how* is :const:" "`SHUT_RD`, further receives are disallowed. If *how* is :const:`SHUT_WR`, " @@ -2185,7 +2192,7 @@ msgid "" "and receives are disallowed." msgstr "" -#: ../../library/socket.rst:1972 +#: ../../library/socket.rst:1979 msgid "" "Duplicate a socket and prepare it for sharing with a target process. The " "target process must be provided with *process_id*. The resulting bytes " @@ -2196,48 +2203,48 @@ msgid "" "process." msgstr "" -#: ../../library/socket.rst:1984 +#: ../../library/socket.rst:1991 msgid "" "Note that there are no methods :meth:`read` or :meth:`write`; use :meth:" "`~socket.recv` and :meth:`~socket.send` without *flags* argument instead." msgstr "" -#: ../../library/socket.rst:1987 +#: ../../library/socket.rst:1994 msgid "" "Socket objects also have these (read-only) attributes that correspond to the " "values given to the :class:`~socket.socket` constructor." msgstr "" -#: ../../library/socket.rst:1993 +#: ../../library/socket.rst:2000 msgid "The socket family." msgstr "" -#: ../../library/socket.rst:1998 +#: ../../library/socket.rst:2005 msgid "The socket type." msgstr "" -#: ../../library/socket.rst:2003 +#: ../../library/socket.rst:2010 msgid "The socket protocol." msgstr "" -#: ../../library/socket.rst:2010 +#: ../../library/socket.rst:2017 msgid "Notes on socket timeouts" msgstr "" -#: ../../library/socket.rst:2012 +#: ../../library/socket.rst:2019 msgid "" "A socket object can be in one of three modes: blocking, non-blocking, or " "timeout. Sockets are by default always created in blocking mode, but this " "can be changed by calling :func:`setdefaulttimeout`." msgstr "" -#: ../../library/socket.rst:2016 +#: ../../library/socket.rst:2023 msgid "" "In *blocking mode*, operations block until complete or the system returns an " "error (such as connection timed out)." msgstr "" -#: ../../library/socket.rst:2019 +#: ../../library/socket.rst:2026 msgid "" "In *non-blocking mode*, operations fail (with an error that is unfortunately " "system-dependent) if they cannot be completed immediately: functions from " @@ -2245,14 +2252,14 @@ msgid "" "available for reading or writing." msgstr "" -#: ../../library/socket.rst:2024 +#: ../../library/socket.rst:2031 msgid "" "In *timeout mode*, operations fail if they cannot be completed within the " "timeout specified for the socket (they raise a :exc:`timeout` exception) or " "if the system returns an error." msgstr "" -#: ../../library/socket.rst:2029 +#: ../../library/socket.rst:2036 msgid "" "At the operating system level, sockets in *timeout mode* are internally set " "in non-blocking mode. Also, the blocking and timeout modes are shared " @@ -2261,11 +2268,11 @@ msgid "" "you decide to use the :meth:`~socket.fileno()` of a socket." msgstr "" -#: ../../library/socket.rst:2036 +#: ../../library/socket.rst:2043 msgid "Timeouts and the ``connect`` method" msgstr "" -#: ../../library/socket.rst:2038 +#: ../../library/socket.rst:2045 msgid "" "The :meth:`~socket.connect` operation is also subject to the timeout " "setting, and in general it is recommended to call :meth:`~socket.settimeout` " @@ -2275,24 +2282,24 @@ msgid "" "setting." msgstr "" -#: ../../library/socket.rst:2046 +#: ../../library/socket.rst:2053 msgid "Timeouts and the ``accept`` method" msgstr "" -#: ../../library/socket.rst:2048 +#: ../../library/socket.rst:2055 msgid "" "If :func:`getdefaulttimeout` is not :const:`None`, sockets returned by the :" "meth:`~socket.accept` method inherit that timeout. Otherwise, the behaviour " "depends on settings of the listening socket:" msgstr "" -#: ../../library/socket.rst:2052 +#: ../../library/socket.rst:2059 msgid "" "if the listening socket is in *blocking mode* or in *timeout mode*, the " "socket returned by :meth:`~socket.accept` is in *blocking mode*;" msgstr "" -#: ../../library/socket.rst:2055 +#: ../../library/socket.rst:2062 msgid "" "if the listening socket is in *non-blocking mode*, whether the socket " "returned by :meth:`~socket.accept` is in blocking or non-blocking mode is " @@ -2300,11 +2307,11 @@ msgid "" "it is recommended you manually override this setting." msgstr "" -#: ../../library/socket.rst:2064 +#: ../../library/socket.rst:2071 msgid "Example" msgstr "範例" -#: ../../library/socket.rst:2066 +#: ../../library/socket.rst:2073 msgid "" "Here are four minimal example programs using the TCP/IP protocol: a server " "that echoes all data that it receives back (servicing only one client), and " @@ -2317,11 +2324,11 @@ msgid "" "on the new socket returned by :meth:`~socket.accept`." msgstr "" -#: ../../library/socket.rst:2076 +#: ../../library/socket.rst:2083 msgid "The first two examples support IPv4 only. ::" msgstr "前兩個範例只支援 IPv4： ::" -#: ../../library/socket.rst:2107 +#: ../../library/socket.rst:2114 msgid "" "The next two examples are identical to the above two, but support both IPv4 " "and IPv6. The server side will listen to the first address family available " @@ -2331,73 +2338,73 @@ msgid "" "resolution, and sends traffic to the first one connected successfully. ::" msgstr "" -#: ../../library/socket.rst:2179 +#: ../../library/socket.rst:2186 msgid "" "The next example shows how to write a very simple network sniffer with raw " "sockets on Windows. The example requires administrator privileges to modify " "the interface::" msgstr "" -#: ../../library/socket.rst:2204 +#: ../../library/socket.rst:2211 msgid "" "The next example shows how to use the socket interface to communicate to a " "CAN network using the raw socket protocol. To use CAN with the broadcast " "manager protocol instead, open a socket with::" msgstr "" -#: ../../library/socket.rst:2210 +#: ../../library/socket.rst:2217 msgid "" "After binding (:const:`CAN_RAW`) or connecting (:const:`CAN_BCM`) the " "socket, you can use the :meth:`socket.send` and :meth:`socket.recv` " "operations (and their counterparts) on the socket object as usual." msgstr "" -#: ../../library/socket.rst:2214 +#: ../../library/socket.rst:2221 msgid "This last example might require special privileges::" msgstr "" -#: ../../library/socket.rst:2254 +#: ../../library/socket.rst:2261 msgid "" "Running an example several times with too small delay between executions, " "could lead to this error::" msgstr "" -#: ../../library/socket.rst:2259 +#: ../../library/socket.rst:2266 msgid "" "This is because the previous execution has left the socket in a " "``TIME_WAIT`` state, and can't be immediately reused." msgstr "" -#: ../../library/socket.rst:2262 +#: ../../library/socket.rst:2269 msgid "" "There is a :mod:`socket` flag to set, in order to prevent this, :const:" "`socket.SO_REUSEADDR`::" msgstr "" -#: ../../library/socket.rst:2269 +#: ../../library/socket.rst:2276 msgid "" "the :data:`SO_REUSEADDR` flag tells the kernel to reuse a local socket in " "``TIME_WAIT`` state, without waiting for its natural timeout to expire." msgstr "" -#: ../../library/socket.rst:2275 +#: ../../library/socket.rst:2282 msgid "" "For an introduction to socket programming (in C), see the following papers:" msgstr "" -#: ../../library/socket.rst:2277 +#: ../../library/socket.rst:2284 msgid "" "*An Introductory 4.3BSD Interprocess Communication Tutorial*, by Stuart " "Sechrest" msgstr "" -#: ../../library/socket.rst:2279 +#: ../../library/socket.rst:2286 msgid "" "*An Advanced 4.3BSD Interprocess Communication Tutorial*, by Samuel J. " "Leffler et al," msgstr "" -#: ../../library/socket.rst:2282 +#: ../../library/socket.rst:2289 msgid "" "both in the UNIX Programmer's Manual, Supplementary Documents 1 (sections " "PS1:7 and PS1:8). The platform-specific reference material for the various " @@ -2416,18 +2423,18 @@ msgstr "object（物件）" msgid "socket" msgstr "socket" -#: ../../library/socket.rst:1582 +#: ../../library/socket.rst:1589 msgid "I/O control" msgstr "I/O control（I/O 控制）" -#: ../../library/socket.rst:1582 +#: ../../library/socket.rst:1589 msgid "buffering" msgstr "buffering（緩衝）" -#: ../../library/socket.rst:1939 +#: ../../library/socket.rst:1946 msgid "module" msgstr "module（模組）" -#: ../../library/socket.rst:1939 +#: ../../library/socket.rst:1946 msgid "struct" msgstr "struct" From 0b97a4a7c23da9d1084c47a9131a1c03808d8686 Mon Sep 17 00:00:00 2001 From: Matt Wang Date: Sun, 18 Aug 2024 19:48:40 +0800 Subject: [PATCH 28/28] fix: resolve fuzzy entries regarding auditing events --- library/marshal.po | 6 +- library/mmap.po | 4 +- library/os.po | 46 +------- library/pathlib.po | 2 - library/pdb.po | 4 +- library/pickle.po | 1 - library/pty.po | 4 +- library/resource.po | 5 +- library/shutil.po | 9 -- library/signal.po | 4 +- library/smtplib.po | 18 +--- library/socket.po | 13 --- library/sys.po | 191 +--------------------------------- library/syslog.po | 4 - library/telnetlib.po | 2 - library/tempfile.po | 2 - library/webbrowser.po | 1 - library/winreg.po | 18 ---- reference/datamodel.po | 45 -------- reference/lexical_analysis.po | 3 +- using/cmdline.po | 51 +-------- 21 files changed, 18 insertions(+), 415 deletions(-) diff --git a/library/marshal.po b/library/marshal.po index f484936b19..6470b60402 100644 --- a/library/marshal.po +++ b/library/marshal.po @@ -1,5 +1,4 @@ -# SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2022, Python Software Foundation +# Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # # Translators: @@ -131,7 +130,6 @@ msgid "" msgstr "*version* 引數指明 ``dump`` 應該使用的資料格式（見下文）。" #: ../../library/marshal.rst:69 ../../library/marshal.rst:101 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``marshal.dumps`` with arguments " "``value``, ``version``." @@ -151,7 +149,6 @@ msgstr "" "`ValueError` 或 :exc:`TypeError`。檔案必須為可讀取的 :term:`binary file`。" #: ../../library/marshal.rst:79 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``marshal.load`` with no " "arguments." @@ -200,7 +197,6 @@ msgstr "" "略。" #: ../../library/marshal.rst:110 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``marshal.loads`` with argument " "``bytes``." diff --git a/library/mmap.po b/library/mmap.po index 8a790454b0..efd708f69d 100644 --- a/library/mmap.po +++ b/library/mmap.po @@ -1,5 +1,4 @@ -# SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2022, Python Software Foundation +# Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # # Translators: @@ -122,7 +121,6 @@ msgid "" msgstr "" #: ../../library/mmap.rst:72 ../../library/mmap.rst:163 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``mmap.__new__`` with arguments " "``fileno``, ``length``, ``access``, ``offset``." diff --git a/library/os.po b/library/os.po index 41c0d93ed9..d8857b4514 100644 --- a/library/os.po +++ b/library/os.po @@ -1,5 +1,4 @@ -# SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2022, Python Software Foundation +# Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # # Translators: @@ -706,7 +705,6 @@ msgid "" msgstr "" #: ../../library/os.rst:569 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.putenv`` with arguments " "``key``, ``value``." @@ -930,7 +928,6 @@ msgid "" msgstr "" #: ../../library/os.rst:807 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.unsetenv`` with argument " "``key``." @@ -1140,7 +1137,6 @@ msgstr "" #: ../../library/os.rst:1002 ../../library/os.rst:2069 #: ../../library/os.rst:2166 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.chmod`` with arguments " "``path``, ``mode``, ``dir_fd``." @@ -1166,7 +1162,6 @@ msgstr "" #: ../../library/os.rst:1017 ../../library/os.rst:2091 #: ../../library/os.rst:2179 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.chown`` with arguments " "``path``, ``uid``, ``gid``, ``dir_fd``." @@ -1250,7 +1245,6 @@ msgid "" msgstr "" #: ../../library/os.rst:1095 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.truncate`` with arguments " "``fd``, ``length``." @@ -1295,13 +1289,12 @@ msgid "" msgstr "" #: ../../library/os.rst:1136 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.lockf`` with arguments " "``fd``, ``cmd``, ``len``." msgstr "" -"引發一個附帶引數 ``fd``、``length`` 的\\ :ref:`稽核事件 ` ``os." -"truncate``。" +"引發一個附帶引數 ``fd``、``cmd``、``len`` 的\\ :ref:`稽核事件 ` " +"``os.lockf``。" #: ../../library/os.rst:1148 msgid "Flags that specify what action :func:`lockf` will take." @@ -1442,7 +1435,6 @@ msgid "" msgstr "" #: ../../library/os.rst:1242 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``open`` with arguments ``path``, " "``mode``, ``flags``." @@ -2183,7 +2175,6 @@ msgid "" msgstr "" #: ../../library/os.rst:1989 ../../library/os.rst:2122 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.chdir`` with argument " "``path``." @@ -2256,7 +2247,6 @@ msgid "" msgstr "" #: ../../library/os.rst:2019 ../../library/os.rst:2148 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.chflags`` with arguments " "``path``, ``flags``." @@ -2462,7 +2452,6 @@ msgid "" msgstr "" #: ../../library/os.rst:2195 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.link`` with arguments " "``src``, ``dst``, ``src_dir_fd``, ``dst_dir_fd``." @@ -2511,7 +2500,6 @@ msgid "" msgstr "" #: ../../library/os.rst:2225 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.listdir`` with argument " "``path``." @@ -2553,7 +2541,6 @@ msgid "May raise :exc:`OSError` if an error occurs collecting the drive names." msgstr "" #: ../../library/os.rst:2258 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.listdrives`` with no " "arguments." @@ -2590,7 +2577,6 @@ msgid "" msgstr "" #: ../../library/os.rst:2282 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.listmounts`` with argument " "``volume``." @@ -2616,7 +2602,6 @@ msgid "May raise :exc:`OSError` if an error occurs collecting the volumes." msgstr "" #: ../../library/os.rst:2302 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.listvolumes`` with no " "arguments." @@ -2696,7 +2681,6 @@ msgid "" msgstr "" #: ../../library/os.rst:2369 ../../library/os.rst:2406 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.mkdir`` with arguments " "``path``, ``mode``, ``dir_fd``." @@ -2889,7 +2873,6 @@ msgstr "" #: ../../library/os.rst:2573 ../../library/os.rst:2595 #: ../../library/os.rst:3437 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.remove`` with arguments " "``path``, ``dir_fd``." @@ -2948,7 +2931,6 @@ msgstr "" #: ../../library/os.rst:2624 ../../library/os.rst:2645 #: ../../library/os.rst:2662 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.rename`` with arguments " "``src``, ``dst``, ``src_dir_fd``, ``dst_dir_fd``." @@ -2997,7 +2979,6 @@ msgid "" msgstr "" #: ../../library/os.rst:2680 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.rmdir`` with arguments " "``path``, ``dir_fd``." @@ -3037,7 +3018,6 @@ msgid "" msgstr "" #: ../../library/os.rst:2717 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.scandir`` with argument " "``path``." @@ -3826,7 +3806,6 @@ msgid "" msgstr "" #: ../../library/os.rst:3380 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.symlink`` with arguments " "``src``, ``dst``, ``dir_fd``." @@ -3855,7 +3834,6 @@ msgid "" msgstr "" #: ../../library/os.rst:3417 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.truncate`` with arguments " "``path``, ``length``." @@ -3913,7 +3891,6 @@ msgid "" msgstr "" #: ../../library/os.rst:3476 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.utime`` with arguments " "``path``, ``times``, ``ns``, ``dir_fd``." @@ -4019,7 +3996,6 @@ msgid "" msgstr "" #: ../../library/os.rst:3575 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.walk`` with arguments " "``top``, ``topdown``, ``onerror``, ``followlinks``." @@ -4067,7 +4043,6 @@ msgid "" msgstr "" #: ../../library/os.rst:3636 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.fwalk`` with arguments " "``top``, ``topdown``, ``onerror``, ``follow_symlinks``, ``dir_fd``." @@ -4219,7 +4194,6 @@ msgid "" msgstr "" #: ../../library/os.rst:3808 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.getxattr`` with arguments " "``path``, ``attribute``." @@ -4241,7 +4215,6 @@ msgid "" msgstr "" #: ../../library/os.rst:3824 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.listxattr`` with argument " "``path``." @@ -4257,7 +4230,6 @@ msgid "" msgstr "" #: ../../library/os.rst:3840 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.removexattr`` with arguments " "``path``, ``attribute``." @@ -4284,7 +4256,6 @@ msgid "" msgstr "" #: ../../library/os.rst:3865 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.setxattr`` with arguments " "``path``, ``attribute``, ``value``, ``flags``." @@ -4363,7 +4334,6 @@ msgid "" msgstr "" #: ../../library/os.rst:3929 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.add_dll_directory`` with " "argument ``path``." @@ -4449,7 +4419,6 @@ msgid "" msgstr "" #: ../../library/os.rst:3998 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.exec`` with arguments " "``path``, ``args``, ``env``." @@ -4587,7 +4556,6 @@ msgid "" msgstr "" #: ../../library/os.rst:4165 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.fork`` with no arguments." msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``os.fork``。" @@ -4655,7 +4623,6 @@ msgid "" msgstr "" #: ../../library/os.rst:4214 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.forkpty`` with no arguments." msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``os.forkpty``。" @@ -4695,7 +4662,6 @@ msgid "See also :func:`signal.pthread_kill`." msgstr "另請參閱 :func:`signal.pthread_kill`。" #: ../../library/os.rst:4252 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.kill`` with arguments " "``pid``, ``sig``." @@ -4708,7 +4674,6 @@ msgid "Send the signal *sig* to the process group *pgid*." msgstr "" #: ../../library/os.rst:4268 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.killpg`` with arguments " "``pgid``, ``sig``." @@ -4925,7 +4890,6 @@ msgid "" msgstr "" #: ../../library/os.rst:4430 ../../library/os.rst:4446 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.posix_spawn`` with arguments " "``path``, ``argv``, ``env``." @@ -5065,7 +5029,6 @@ msgid "" msgstr "" #: ../../library/os.rst:4550 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.spawn`` with arguments " "``mode``, ``path``, ``args``, ``env``." @@ -5168,7 +5131,6 @@ msgid "" msgstr "" #: ../../library/os.rst:4635 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.startfile`` with arguments " "``path``, ``operation``." @@ -5177,7 +5139,6 @@ msgstr "" "``os.startfile``。" #: ../../library/os.rst:4637 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.startfile/2`` with arguments " "``path``, ``operation``, ``arguments``, ``cwd``, ``show_cmd``." @@ -5233,7 +5194,6 @@ msgid "" msgstr "" #: ../../library/os.rst:4674 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``os.system`` with argument " "``command``." diff --git a/library/pathlib.po b/library/pathlib.po index b6111fbbfe..1b62d32d6e 100644 --- a/library/pathlib.po +++ b/library/pathlib.po @@ -1042,7 +1042,6 @@ msgid "" msgstr "在很大的目錄樹裡使用 \"``**``\" 可能會耗費過多的時間。" #: ../../library/pathlib.rst:1206 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``pathlib.Path.glob`` with " "arguments ``self``, ``pattern``." @@ -1069,7 +1068,6 @@ msgstr "" "相同： ::" #: ../../library/pathlib.rst:1234 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``pathlib.Path.rglob`` with " "arguments ``self``, ``pattern``." diff --git a/library/pdb.po b/library/pdb.po index 8d5700c923..47840f05d9 100644 --- a/library/pdb.po +++ b/library/pdb.po @@ -1,5 +1,4 @@ -# SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2022, Python Software Foundation +# Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # # Translators: @@ -236,7 +235,6 @@ msgid "Example call to enable tracing with *skip*::" msgstr "" #: ../../library/pdb.rst:210 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``pdb.Pdb`` with no arguments." msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``pdb.Pdb``。" diff --git a/library/pickle.po b/library/pickle.po index 7f0a69858e..27678c7e3f 100644 --- a/library/pickle.po +++ b/library/pickle.po @@ -616,7 +616,6 @@ msgid "" msgstr "" #: ../../library/pickle.rst:460 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``pickle.find_class`` with " "arguments ``module``, ``name``." diff --git a/library/pty.po b/library/pty.po index c6a507151e..e05c28d58f 100644 --- a/library/pty.po +++ b/library/pty.po @@ -1,5 +1,4 @@ -# SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2022, Python Software Foundation +# Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # # Translators: @@ -125,7 +124,6 @@ msgid "" msgstr "" #: ../../library/pty.rst:82 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``pty.spawn`` with argument " "``argv``." diff --git a/library/resource.po b/library/resource.po index 3721e26b24..76bb99ff9e 100644 --- a/library/resource.po +++ b/library/resource.po @@ -1,5 +1,4 @@ -# SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2022, Python Software Foundation +# Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # # Translators: @@ -115,7 +114,6 @@ msgid "VxWorks only supports setting :data:`RLIMIT_NOFILE`." msgstr "" #: ../../library/resource.rst:83 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``resource.setrlimit`` with " "arguments ``resource``, ``limits``." @@ -147,7 +145,6 @@ msgid "" msgstr "" #: ../../library/resource.rst:102 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``resource.prlimit`` with " "arguments ``pid``, ``resource``, ``limits``." diff --git a/library/shutil.po b/library/shutil.po index 8beba86a04..f738c3c9ef 100644 --- a/library/shutil.po +++ b/library/shutil.po @@ -94,7 +94,6 @@ msgstr "" #: ../../library/shutil.rst:70 ../../library/shutil.rst:177 #: ../../library/shutil.rst:208 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``shutil.copyfile`` with " "arguments ``src``, ``dst``." @@ -143,7 +142,6 @@ msgid "" msgstr "" #: ../../library/shutil.rst:106 ../../library/shutil.rst:179 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``shutil.copymode`` with " "arguments ``src``, ``dst``." @@ -209,7 +207,6 @@ msgid "Please see :data:`os.supports_follow_symlinks` for more information." msgstr "更多資訊請見 :data:`os.supports_follow_symlinks`。" #: ../../library/shutil.rst:153 ../../library/shutil.rst:210 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``shutil.copystat`` with " "arguments ``src``, ``dst``." @@ -355,7 +352,6 @@ msgid "" msgstr "" #: ../../library/shutil.rst:275 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``shutil.copytree`` with " "arguments ``src``, ``dst``." @@ -426,7 +422,6 @@ msgid "" msgstr "" #: ../../library/shutil.rst:330 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``shutil.rmtree`` with arguments " "``path``, ``dir_fd``." @@ -500,7 +495,6 @@ msgid "" msgstr "" #: ../../library/shutil.rst:380 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``shutil.move`` with arguments " "``src``, ``dst``." @@ -559,7 +553,6 @@ msgid "See also :func:`os.chown`, the underlying function." msgstr "" #: ../../library/shutil.rst:427 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``shutil.chown`` with arguments " "``path``, ``user``, ``group``." @@ -785,7 +778,6 @@ msgid "The *verbose* argument is unused and deprecated." msgstr "" #: ../../library/shutil.rst:616 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``shutil.make_archive`` with " "arguments ``base_name``, ``format``, ``root_dir``, ``base_dir``." @@ -922,7 +914,6 @@ msgid "" msgstr "" #: ../../library/shutil.rst:704 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``shutil.unpack_archive`` with " "arguments ``filename``, ``extract_dir``, ``format``." diff --git a/library/signal.po b/library/signal.po index e0cb35ca69..d2ea696943 100644 --- a/library/signal.po +++ b/library/signal.po @@ -1,5 +1,4 @@ -# SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2022, Python Software Foundation +# Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # # Translators: @@ -498,7 +497,6 @@ msgid "" msgstr "" #: ../../library/signal.rst:435 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``signal.pthread_kill`` with " "arguments ``thread_id``, ``signalnum``." diff --git a/library/smtplib.po b/library/smtplib.po index b41f1e9c53..6ee4100e93 100644 --- a/library/smtplib.po +++ b/library/smtplib.po @@ -126,9 +126,8 @@ msgid "*context* was added." msgstr "新增 *context*。" #: ../../library/smtplib.rst:95 -#, fuzzy msgid "The *source_address* argument was added." -msgstr "新增 source_address 引數。" +msgstr "新增 *source_address* 引數。" #: ../../library/smtplib.rst:98 msgid "" @@ -310,13 +309,12 @@ msgid "" msgstr "" #: ../../library/smtplib.rst:253 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``smtplib.connect`` with " "arguments ``self``, ``host``, ``port``." msgstr "" -"引發一個附帶引數 ``self``、``data`` 的\\ :ref:`稽核事件 ` " -"``smtplib.send``。" +"引發一個附帶引數 ``self``、``host``、``port`` 的\\ :ref:`稽核事件 " +"` ``smtplib.connect``。" #: ../../library/smtplib.rst:258 msgid "" @@ -746,13 +744,3 @@ msgstr "protocol（協定）" #: ../../library/smtplib.rst:11 msgid "Simple Mail Transfer Protocol" msgstr "Simple Mail Transfer Protocol（簡單郵件傳輸協定）" - -#, fuzzy -#~ msgid "" -#~ "All commands will raise an auditing event smtplib.SMTP.send with " -#~ "arguments self and data, where data is the bytes about to be sent to the " -#~ "remote host." -#~ msgstr "" -#~ "所有指令都會引發一個附帶引數 ``self``、``data`` 的\\ :ref:`稽核事件 " -#~ "` ``smtplib.SMTP.send``，其中 ``data`` 為即將傳送至遠端的位元" -#~ "組。" diff --git a/library/socket.po b/library/socket.po index 89645227d9..e857fb0d96 100644 --- a/library/socket.po +++ b/library/socket.po @@ -910,7 +910,6 @@ msgid "The newly created socket is :ref:`non-inheritable `." msgstr "" #: ../../library/socket.rst:738 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.__new__`` with arguments " "``self``, ``family``, ``type``, ``protocol``." @@ -1145,7 +1144,6 @@ msgid "" msgstr "" #: ../../library/socket.rst:949 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.getaddrinfo`` with " "arguments ``host``, ``port``, ``family``, ``type``, ``protocol``." @@ -1192,7 +1190,6 @@ msgid "" msgstr "" #: ../../library/socket.rst:987 ../../library/socket.rst:1003 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.gethostbyname`` with " "argument ``hostname``." @@ -1219,7 +1216,6 @@ msgid "" msgstr "" #: ../../library/socket.rst:1013 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.gethostname`` with no " "arguments." @@ -1244,7 +1240,6 @@ msgid "" msgstr "" #: ../../library/socket.rst:1031 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.gethostbyaddr`` with " "argument ``ip_address``." @@ -1272,7 +1267,6 @@ msgid "" msgstr "" #: ../../library/socket.rst:1048 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.getnameinfo`` with " "argument ``sockaddr``." @@ -1297,7 +1291,6 @@ msgid "" msgstr "" #: ../../library/socket.rst:1070 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.getservbyname`` with " "arguments ``servicename``, ``protocolname``." @@ -1313,7 +1306,6 @@ msgid "" msgstr "" #: ../../library/socket.rst:1081 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.getservbyport`` with " "arguments ``port``, ``protocolname``." @@ -1505,7 +1497,6 @@ msgid "" msgstr "" #: ../../library/socket.rst:1268 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.sethostname`` with " "argument ``name``." @@ -1650,7 +1641,6 @@ msgid "" msgstr "" #: ../../library/socket.rst:1405 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.bind`` with arguments " "``self``, ``address``." @@ -1705,7 +1695,6 @@ msgid "" msgstr "" #: ../../library/socket.rst:1446 ../../library/socket.rst:1466 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.connect`` with arguments " "``self``, ``address``." @@ -2045,7 +2034,6 @@ msgid "" msgstr "" #: ../../library/socket.rst:1823 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.sendto`` with arguments " "``self``, ``address``." @@ -2085,7 +2073,6 @@ msgid ":ref:`Availability `: Unix, not WASI." msgstr ":ref:`適用 `：Unix、非 WASI。" #: ../../library/socket.rst:1866 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``socket.sendmsg`` with arguments " "``self``, ``address``." diff --git a/library/sys.po b/library/sys.po index 97e4c782ab..684febadfc 100644 --- a/library/sys.po +++ b/library/sys.po @@ -272,12 +272,11 @@ msgid "" msgstr "" #: ../../library/sys.rst:214 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``sys._current_frames`` with no " "arguments." msgstr "" -"引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.addaudithook``。" +"引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys._current_frames``。" #: ../../library/sys.rst:218 msgid "" @@ -292,7 +291,6 @@ msgid "This is most useful for statistical profiling." msgstr "" #: ../../library/sys.rst:227 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``sys._current_exceptions`` with " "no arguments." @@ -1107,7 +1105,6 @@ msgid "" msgstr "" #: ../../library/sys.rst:886 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``sys._getframe`` with argument " "``frame``." @@ -1131,7 +1128,6 @@ msgid "" msgstr "" #: ../../library/sys.rst:902 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``sys._getframemodulename`` with " "argument ``depth``." @@ -1919,12 +1915,10 @@ msgid "A C function has raised an exception. *arg* is the C function object." msgstr "" #: ../../library/sys.rst:1517 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``sys.setprofile`` with no " "arguments." -msgstr "" -"引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.addaudithook``。" +msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.setprofile``。" #: ../../library/sys.rst:1522 msgid "" @@ -2086,12 +2080,10 @@ msgid "For more information on code and frame objects, refer to :ref:`types`." msgstr "" #: ../../library/sys.rst:1635 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``sys.settrace`` with no " "arguments." -msgstr "" -"引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.addaudithook``。" +msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.settrace``。" #: ../../library/sys.rst:1639 msgid "" @@ -2125,7 +2117,6 @@ msgid "" msgstr "" #: ../../library/sys.rst:1663 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``sys." "set_asyncgen_hooks_firstiter`` with no arguments." @@ -2134,7 +2125,6 @@ msgstr "" "set_asyncgen_hooks_firstiter``。" #: ../../library/sys.rst:1665 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``sys." "set_asyncgen_hooks_finalizer`` with no arguments." @@ -2637,178 +2627,3 @@ msgstr "interpreter prompt（直譯器提示）" #: ../../library/sys.rst:1435 msgid "..." msgstr "..." - -#, fuzzy -#~ msgid "" -#~ "Calling sys.addaudithook() will itself raise an auditing event named sys." -#~ "addaudithook with no arguments. If any existing hooks raise an exception " -#~ "derived from RuntimeError, the new hook will not be added and the " -#~ "exception suppressed. As a result, callers cannot assume that their hook " -#~ "has been added unless they control all existing hooks." -#~ msgstr "" -#~ "呼叫 :func:`sys.addaudithook` 本身會引發一個不帶任何引數、名為 ``sys." -#~ "addaudithook`` 的稽核事件。如果任何現有的 hook 引發從 :class:" -#~ "`RuntimeError` 衍生的例外，則不會添加新的 hook 並抑制異常。因此，除非呼叫" -#~ "者控制所有已存在的 hook，他們不能假設他們的 hook 已被添加。" - -#, fuzzy -#~ msgid "Raises an auditing event sys._current_frames with no arguments." -#~ msgstr "" -#~ "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys." -#~ "_current_frames``。" - -#, fuzzy -#~ msgid "" -#~ "Raises an auditing event cpython.run_interactivehook with the hook object " -#~ "as the argument when the hook is called on startup." -#~ msgstr "" -#~ "引發一個附帶引數 ``hook`` 的\\ :ref:`稽核事件 ` ``cpython." -#~ "run_interactivehook``。" - -#, fuzzy -#~ msgid "Raises an auditing event sys.setprofile with no arguments." -#~ msgstr "" -#~ "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.setprofile``。" - -#, fuzzy -#~ msgid "Raises an auditing event sys.settrace with no arguments." -#~ msgstr "" -#~ "引發一個不附帶引數的\\ :ref:`稽核事件 ` ``sys.setprofile``。" - -#~ msgid "" -#~ "Raises an :ref:`auditing event ` ``sys.excepthook`` with " -#~ "arguments ``hook``, ``type``, ``value``, ``traceback``." -#~ msgstr "" -#~ "引發一個附帶引數 ``hook``、``type``、``value``、``traceback`` 的\\ :ref:`" -#~ "稽核事件 ` ``sys.excepthook``。" - -#, fuzzy -#~ msgid "" -#~ "Raises an :ref:`auditing event ` ``sys.unraisablehook`` with " -#~ "arguments ``hook``, ``unraisable``." -#~ msgstr "" -#~ "引發一個附帶引數 ``hook``、``unraisable`` 的\\ :ref:`稽核事件 ` " -#~ "``sys.unraisablehook``。" - -#~ msgid "See also :data:`sys.argv`." -#~ msgstr "另請參閱 :data:`sys.argv`。" - -#~ msgid "Attribute" -#~ msgstr "屬性" - -#~ msgid "Explanation" -#~ msgstr "解釋" - -#~ msgid ":const:`emscripten_version`" -#~ msgstr ":const:`emscripten_version`" - -#~ msgid ":const:`runtime`" -#~ msgstr ":const:`runtime`" - -#~ msgid ":const:`pthreads`" -#~ msgstr ":const:`pthreads`" - -#~ msgid ":const:`shared_memory`" -#~ msgstr ":const:`shared_memory`" - -#~ msgid "flag" -#~ msgstr "旗標" - -#~ msgid ":const:`debug`" -#~ msgstr ":const:`debug`" - -#~ msgid ":const:`inspect`" -#~ msgstr ":const:`inspect`" - -#~ msgid ":const:`interactive`" -#~ msgstr ":const:`interactive`" - -#~ msgid ":const:`isolated`" -#~ msgstr ":const:`isolated`" - -#~ msgid ":const:`optimize`" -#~ msgstr ":const:`optimize`" - -#~ msgid ":const:`dont_write_bytecode`" -#~ msgstr ":const:`dont_write_bytecode`" - -#~ msgid ":const:`no_user_site`" -#~ msgstr ":const:`no_user_site`" - -#~ msgid ":const:`no_site`" -#~ msgstr ":const:`no_site`" - -#~ msgid ":const:`ignore_environment`" -#~ msgstr ":const:`ignore_environment`" - -#~ msgid ":const:`verbose`" -#~ msgstr ":const:`verbose`" - -#~ msgid ":const:`bytes_warning`" -#~ msgstr ":const:`bytes_warning`" - -#~ msgid ":const:`quiet`" -#~ msgstr ":const:`quiet`" - -#~ msgid ":const:`hash_randomization`" -#~ msgstr ":const:`hash_randomization`" - -#~ msgid ":const:`dev_mode`" -#~ msgstr ":const:`dev_mode`" - -#~ msgid ":const:`utf8_mode`" -#~ msgstr ":const:`utf8_mode`" - -#~ msgid ":const:`safe_path`" -#~ msgstr ":const:`safe_path`" - -#~ msgid ":const:`int_max_str_digits`" -#~ msgstr ":const:`int_max_str_digits`" - -#~ msgid ":const:`warn_default_encoding`" -#~ msgstr ":const:`warn_default_encoding`" - -#~ msgid ":const:`width`" -#~ msgstr ":const:`width`" - -#~ msgid ":const:`modulus`" -#~ msgstr ":const:`modulus`" - -#~ msgid ":const:`inf`" -#~ msgstr ":const:`inf`" - -#~ msgid ":const:`nan`" -#~ msgstr ":const:`nan`" - -#~ msgid ":const:`imag`" -#~ msgstr ":const:`imag`" - -#~ msgid ":const:`algorithm`" -#~ msgstr ":const:`algorithm`" - -#~ msgid ":const:`hash_bits`" -#~ msgstr ":const:`hash_bits`" - -#~ msgid ":const:`seed_bits`" -#~ msgstr ":const:`seed_bits`" - -#~ msgid ":const:`bits_per_digit`" -#~ msgstr ":const:`bits_per_digit`" - -#~ msgid ":const:`sizeof_digit`" -#~ msgstr ":const:`sizeof_digit`" - -#~ msgid ":const:`default_max_str_digits`" -#~ msgstr ":const:`default_max_str_digits`" - -#~ msgid ":const:`str_digits_check_threshold`" -#~ msgstr ":const:`str_digits_check_threshold`" - -#~ msgid ":const:`name`" -#~ msgstr ":const:`name`" - -#~ msgid ":const:`lock`" -#~ msgstr ":const:`lock`" - -#~ msgid ":const:`version`" -#~ msgstr ":const:`version`" diff --git a/library/syslog.po b/library/syslog.po index 6bacea69e6..c007ab6903 100644 --- a/library/syslog.po +++ b/library/syslog.po @@ -61,7 +61,6 @@ msgid "" msgstr "" #: ../../library/syslog.rst:36 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``syslog.syslog`` with arguments " "``priority``, ``message``." @@ -103,7 +102,6 @@ msgid "" msgstr "" #: ../../library/syslog.rst:64 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``syslog.openlog`` with arguments " "``ident``, ``logoption``, ``facility``." @@ -139,7 +137,6 @@ msgid "" msgstr "" #: ../../library/syslog.rst:87 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``syslog.closelog`` with no " "arguments." @@ -157,7 +154,6 @@ msgid "" msgstr "" #: ../../library/syslog.rst:106 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``syslog.setlogmask`` with " "argument ``maskpri``." diff --git a/library/telnetlib.po b/library/telnetlib.po index 1e5ae67217..3dfd3a09f1 100644 --- a/library/telnetlib.po +++ b/library/telnetlib.po @@ -197,7 +197,6 @@ msgid "Do not try to reopen an already connected instance." msgstr "" #: ../../library/telnetlib.rst:150 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``telnetlib.Telnet.open`` with " "arguments ``self``, ``host``, ``port``." @@ -238,7 +237,6 @@ msgid "" msgstr "" #: ../../library/telnetlib.rst:187 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``telnetlib.Telnet.write`` with " "arguments ``self``, ``buffer``." diff --git a/library/tempfile.po b/library/tempfile.po index 77fc10ccca..f7021e105a 100644 --- a/library/tempfile.po +++ b/library/tempfile.po @@ -137,7 +137,6 @@ msgstr "" #: ../../library/tempfile.rst:68 ../../library/tempfile.rst:137 #: ../../library/tempfile.rst:264 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``tempfile.mkstemp`` with " "argument ``fullpath``." @@ -390,7 +389,6 @@ msgstr "" "非常有用。" #: ../../library/tempfile.rst:210 ../../library/tempfile.rst:290 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``tempfile.mkdtemp`` with " "argument ``fullpath``." diff --git a/library/webbrowser.po b/library/webbrowser.po index 88a3064ca8..f77a90e39a 100644 --- a/library/webbrowser.po +++ b/library/webbrowser.po @@ -112,7 +112,6 @@ msgid "" msgstr "" #: ../../library/webbrowser.rst:69 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``webbrowser.open`` with argument " "``url``." diff --git a/library/winreg.po b/library/winreg.po index 2a5e3cab5a..8c2d39516f 100644 --- a/library/winreg.po +++ b/library/winreg.po @@ -80,7 +80,6 @@ msgid "" msgstr "" #: ../../library/winreg.rst:56 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg.ConnectRegistry`` with " "arguments ``computer_name``, ``key``." @@ -130,7 +129,6 @@ msgid "If the key already exists, this function opens the existing key." msgstr "" #: ../../library/winreg.rst:80 ../../library/winreg.rst:112 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg.CreateKey`` with " "arguments ``key``, ``sub_key``, ``access``." @@ -140,7 +138,6 @@ msgstr "" #: ../../library/winreg.rst:82 ../../library/winreg.rst:114 #: ../../library/winreg.rst:324 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg.OpenKey/result`` with " "argument ``key``." @@ -182,7 +179,6 @@ msgid "" msgstr "" #: ../../library/winreg.rst:137 ../../library/winreg.rst:168 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg.DeleteKey`` with " "arguments ``key``, ``sub_key``, ``access``." @@ -218,7 +214,6 @@ msgid "*value* is a string that identifies the value to remove." msgstr "" #: ../../library/winreg.rst:185 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg.DeleteValue`` with " "arguments ``key``, ``value``." @@ -242,7 +237,6 @@ msgid "" msgstr "" #: ../../library/winreg.rst:201 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg.EnumKey`` with arguments " "``key``, ``index``." @@ -311,7 +305,6 @@ msgid "" msgstr "" #: ../../library/winreg.rst:236 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg.EnumValue`` with " "arguments ``key``, ``index``." @@ -326,7 +319,6 @@ msgid "" msgstr "" #: ../../library/winreg.rst:253 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg." "ExpandEnvironmentStrings`` with argument ``str``." @@ -393,7 +385,6 @@ msgid "" msgstr "" #: ../../library/winreg.rst:299 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg.LoadKey`` with arguments " "``key``, ``sub_key``, ``file_name``." @@ -431,7 +422,6 @@ msgid "If the function fails, :exc:`OSError` is raised." msgstr "" #: ../../library/winreg.rst:322 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg.OpenKey`` with arguments " "``key``, ``sub_key``, ``access``." @@ -462,7 +452,6 @@ msgid "" msgstr "" #: ../../library/winreg.rst:356 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg.QueryInfoKey`` with " "argument ``key``." @@ -491,7 +480,6 @@ msgid "" msgstr "" #: ../../library/winreg.rst:375 ../../library/winreg.rst:400 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg.QueryValue`` with " "arguments ``key``, ``sub_key``, ``value_name``." @@ -550,7 +538,6 @@ msgid "This function passes ``NULL`` for *security_attributes* to the API." msgstr "" #: ../../library/winreg.rst:425 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg.SaveKey`` with arguments " "``key``, ``file_name``." @@ -599,7 +586,6 @@ msgid "" msgstr "" #: ../../library/winreg.rst:453 ../../library/winreg.rst:483 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg.SetValue`` with " "arguments ``key``, ``sub_key``, ``type``, ``value``." @@ -659,7 +645,6 @@ msgid "" msgstr "" #: ../../library/winreg.rst:501 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg.DisableReflectionKey`` " "with argument ``key``." @@ -677,7 +662,6 @@ msgid "" msgstr "" #: ../../library/winreg.rst:516 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg.EnableReflectionKey`` " "with argument ``key``." @@ -694,7 +678,6 @@ msgid "Returns ``True`` if reflection is disabled." msgstr "" #: ../../library/winreg.rst:531 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg.QueryReflectionKey`` " "with argument ``key``." @@ -989,7 +972,6 @@ msgid "" msgstr "" #: ../../library/winreg.rst:784 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``winreg.PyHKEY.Detach`` with " "argument ``key``." diff --git a/reference/datamodel.po b/reference/datamodel.po index a175709e58..e64f4904c9 100644 --- a/reference/datamodel.po +++ b/reference/datamodel.po @@ -4808,48 +4808,3 @@ msgstr "with" #: ../../reference/datamodel.rst:3124 msgid "context manager" msgstr "context manager（情境管理器）" - -#, fuzzy -#~ msgid "" -#~ "For certain sensitive attribute accesses, raises an auditing event object." -#~ "__getattr__ with arguments obj and name." -#~ msgstr "" -#~ "存取此屬性會引發一個附帶引數 ``obj`` 與 ``\"tb_frame\"`` 的\\ :ref:`稽核事" -#~ "件 ` ``object.__getattr__``。" - -#, fuzzy -#~ msgid "" -#~ "For certain sensitive attribute assignments, raises an auditing event " -#~ "object.__setattr__ with arguments obj, name, value." -#~ msgstr "" -#~ "存取此屬性會引發一個附帶引數 ``obj`` 與 ``\"tb_frame\"`` 的\\ :ref:`稽核事" -#~ "件 ` ``object.__getattr__``。" - -#, fuzzy -#~ msgid "" -#~ "For certain sensitive attribute deletions, raises an auditing event " -#~ "object.__delattr__ with arguments obj and name." -#~ msgstr "" -#~ "存取此屬性會引發一個附帶引數 ``obj`` 與 ``\"tb_frame\"`` 的\\ :ref:`稽核事" -#~ "件 ` ``object.__getattr__``。" - -#~ msgid "" -#~ "Raises an :ref:`auditing event ` ``object.__getattr__`` with " -#~ "arguments ``obj``, ``name``." -#~ msgstr "" -#~ "引發一個附帶引數 ``obj``、``name`` 的\\ :ref:`稽核事件 ` " -#~ "``object.__getattr__``。" - -#~ msgid "" -#~ "Raises an :ref:`auditing event ` ``object.__setattr__`` with " -#~ "arguments ``obj``, ``name``, ``value``." -#~ msgstr "" -#~ "引發一個附帶引數 ``obj``、``name``、``value`` 的\\ :ref:`稽核事件 " -#~ "` ``object.__setattr__``。" - -#~ msgid "" -#~ "Raises an :ref:`auditing event ` ``object.__delattr__`` with " -#~ "arguments ``obj``, ``name``." -#~ msgstr "" -#~ "引發一個附帶引數 ``obj``、``name`` 的\\ :ref:`稽核事件 ` " -#~ "``object.__delattr__``。" diff --git a/reference/lexical_analysis.po b/reference/lexical_analysis.po index 52250fb17f..2f3d276239 100644 --- a/reference/lexical_analysis.po +++ b/reference/lexical_analysis.po @@ -1,5 +1,4 @@ -# SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2022, Python Software Foundation +# Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # # Translators: diff --git a/using/cmdline.po b/using/cmdline.po index f73e538d53..0ea621fbac 100644 --- a/using/cmdline.po +++ b/using/cmdline.po @@ -1,4 +1,4 @@ -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # # Translators: @@ -118,7 +118,6 @@ msgid "" msgstr "" #: ../../using/cmdline.rst:73 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``cpython.run_command`` with " "argument ``command``." @@ -179,7 +178,6 @@ msgid "" msgstr "" #: ../../using/cmdline.rst:115 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``cpython.run_module`` with " "argument ``module-name``." @@ -221,7 +219,6 @@ msgid "" msgstr "" #: ../../using/cmdline.rst:140 ../../using/cmdline.rst:723 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``cpython.run_stdin`` with no " "arguments." @@ -264,13 +261,12 @@ msgid "" msgstr "" #: ../../using/cmdline.rst:167 -#, fuzzy msgid "" "Raises an :ref:`auditing event ` ``cpython.run_file`` with " "argument ``filename``." msgstr "" "引發一個附帶引數 ``filename`` 的\\ :ref:`稽核事件 ` ``cpython." -"run_startup``。" +"run_file``。" #: ../../using/cmdline.rst:170 msgid ":func:`runpy.run_path`" @@ -1323,46 +1319,3 @@ msgid "" "If set, Python will dump objects and reference counts still alive after " "shutting down the interpreter into a file called *FILENAME*." msgstr "" - -#, fuzzy -#~ msgid "" -#~ "Raises an auditing event cpython.run_startup with the filename as the " -#~ "argument when called on startup." -#~ msgstr "" -#~ "引發一個附帶呼叫啟動時的檔案名稱為引數的\\ :ref:`稽核事件 ` " -#~ "``cpython.run_startup``。" - -#~ msgid "Added the ``-X faulthandler`` option." -#~ msgstr "新增 ``-X faulthandler`` 選項。" - -#~ msgid "Added the ``-X showrefcount`` and ``-X tracemalloc`` options." -#~ msgstr "新增 ``-X showrefcount`` 和 ``-X tracemalloc`` 選項。" - -#~ msgid "Added the ``-X importtime``, ``-X dev`` and ``-X utf8`` options." -#~ msgstr "新增 ``-X importtime``、``-X dev`` 和 ``-X utf8`` 選項。" - -#~ msgid "The ``-X showalloccount`` option has been removed." -#~ msgstr "``-X showalloccount`` 選項已被移除。" - -#~ msgid "" -#~ "Added the ``-X warn_default_encoding`` option. Removed the ``-X " -#~ "oldparser`` option." -#~ msgstr "" -#~ "新增 ``-X warn_default_encoding`` 選項。``-X oldparser`` 選項已被移除。" - -#~ msgid "" -#~ "Added the ``-X no_debug_ranges``, ``-X frozen_modules`` and ``-X " -#~ "int_max_str_digits`` options." -#~ msgstr "新增 ``-X importtime``、``-X dev`` 和 ``-X utf8`` 選項。" - -#~ msgid "The :option:`-X` option was added." -#~ msgstr "新增 :option:`-X` 選項。" - -#~ msgid "The ``-X no_debug_ranges`` option." -#~ msgstr "``-X no_debug_ranges`` 選項。" - -#~ msgid "The ``-X frozen_modules`` option." -#~ msgstr "``-X frozen_modules`` 選項。" - -#~ msgid "The ``-X int_max_str_digits`` option." -#~ msgstr "``-X int_max_str_digits`` 選項。"