diff --git a/c-api/capsule.po b/c-api/capsule.po index 42a0ea59ac..8962dc66fc 100644 --- a/c-api/capsule.po +++ b/c-api/capsule.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-01 22:24+0800\n" +"POT-Creation-Date: 2025-06-29 00:17+0000\n" "PO-Revision-Date: 2018-05-23 14:30+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -150,15 +150,29 @@ msgstr "" #: ../../c-api/capsule.rst:108 msgid "" +"This function splits *name* on the ``.`` character, and imports the first " +"element. It then processes further elements using attribute lookups." +msgstr "" + +#: ../../c-api/capsule.rst:111 +msgid "" "Return the capsule's internal *pointer* on success. On failure, set an " "exception and return ``NULL``." msgstr "" -#: ../../c-api/capsule.rst:111 +#: ../../c-api/capsule.rst:116 +msgid "" +"If *name* points to an attribute of some submodule or subpackage, this " +"submodule or subpackage must be previously imported using other means (for " +"example, by using :c:func:`PyImport_ImportModule`) for the attribute lookups " +"to succeed." +msgstr "" + +#: ../../c-api/capsule.rst:121 msgid "*no_block* has no effect anymore." msgstr "" -#: ../../c-api/capsule.rst:117 +#: ../../c-api/capsule.rst:127 msgid "" "Determines whether or not *capsule* is a valid capsule. A valid capsule is " "non-``NULL``, passes :c:func:`PyCapsule_CheckExact`, has a non-``NULL`` " @@ -167,41 +181,41 @@ msgid "" "compared.)" msgstr "" -#: ../../c-api/capsule.rst:123 +#: ../../c-api/capsule.rst:133 msgid "" "In other words, if :c:func:`PyCapsule_IsValid` returns a true value, calls " "to any of the accessors (any function starting with ``PyCapsule_Get``) are " "guaranteed to succeed." msgstr "" -#: ../../c-api/capsule.rst:127 +#: ../../c-api/capsule.rst:137 msgid "" "Return a nonzero value if the object is valid and matches the name passed " "in. Return ``0`` otherwise. This function will not fail." msgstr "" -#: ../../c-api/capsule.rst:133 +#: ../../c-api/capsule.rst:143 msgid "Set the context pointer inside *capsule* to *context*." msgstr "" -#: ../../c-api/capsule.rst:135 ../../c-api/capsule.rst:142 -#: ../../c-api/capsule.rst:151 ../../c-api/capsule.rst:159 +#: ../../c-api/capsule.rst:145 ../../c-api/capsule.rst:152 +#: ../../c-api/capsule.rst:161 ../../c-api/capsule.rst:169 msgid "" "Return ``0`` on success. Return nonzero and set an exception on failure." msgstr "" -#: ../../c-api/capsule.rst:140 +#: ../../c-api/capsule.rst:150 msgid "Set the destructor inside *capsule* to *destructor*." msgstr "" -#: ../../c-api/capsule.rst:147 +#: ../../c-api/capsule.rst:157 msgid "" "Set the name inside *capsule* to *name*. If non-``NULL``, the name must " "outlive the capsule. If the previous *name* stored in the capsule was not " "``NULL``, no attempt is made to free it." msgstr "" -#: ../../c-api/capsule.rst:156 +#: ../../c-api/capsule.rst:166 msgid "" "Set the void pointer inside *capsule* to *pointer*. The pointer may not be " "``NULL``." diff --git a/deprecations/c-api-pending-removal-in-3.15.po b/deprecations/c-api-pending-removal-in-3.15.po index 4faa829fa8..0c0d7a791b 100644 --- a/deprecations/c-api-pending-removal-in-3.15.po +++ b/deprecations/c-api-pending-removal-in-3.15.po @@ -5,7 +5,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-22 00:13+0000\n" +"POT-Creation-Date: 2025-07-03 00:17+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-" @@ -20,77 +20,76 @@ msgid "Pending Removal in Python 3.15" msgstr "Python 3.15 中待移除的項目" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:4 -msgid "The bundled copy of ``libmpdecimal``." -msgstr "``libmpdecimal`` 的打包副本 (bundled copy)。" - -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:5 msgid "" -"The :c:func:`PyImport_ImportModuleNoBlock`: " -"Use :c:func:`PyImport_ImportModule` instead." +"The :c:func:`PyImport_ImportModuleNoBlock`: Use :c:func:" +"`PyImport_ImportModule` instead." msgstr "" -":c:func:`PyImport_ImportModuleNoBlock`：請改" -"用 :c:func:`PyImport_ImportModule`。" +":c:func:`PyImport_ImportModuleNoBlock`：請改用 :c:func:" +"`PyImport_ImportModule`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:7 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:6 msgid "" -":c:func:`PyWeakref_GetObject` and :c:func:`PyWeakref_GET_OBJECT`: " -"Use :c:func:`PyWeakref_GetRef` instead." +":c:func:`PyWeakref_GetObject` and :c:func:`PyWeakref_GET_OBJECT`: Use :c:" +"func:`PyWeakref_GetRef` instead." msgstr "" -":c:func:`PyWeakref_GetObject` 和 :c:func:`PyWeakref_GET_OBJECT`：請改" -"用 :c:func:`PyWeakref_GetRef`。" +":c:func:`PyWeakref_GetObject` 和 :c:func:`PyWeakref_GET_OBJECT`：請改用 :c:" +"func:`PyWeakref_GetRef`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:9 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:8 msgid "" -":c:type:`Py_UNICODE` type and the :c:macro:`!Py_UNICODE_WIDE` macro: " -"Use :c:type:`wchar_t` instead." +":c:type:`Py_UNICODE` type and the :c:macro:`!Py_UNICODE_WIDE` macro: Use :c:" +"type:`wchar_t` instead." msgstr "" -":c:type:`Py_UNICODE` 型別與 :c:macro:`!Py_UNICODE_WIDE` 巨集：請改" -"用 :c:type:`wchar_t`。" +":c:type:`Py_UNICODE` 型別與 :c:macro:`!Py_UNICODE_WIDE` 巨集：請改用 :c:type:" +"`wchar_t`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:11 +#: ../../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:13 +#: ../../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`。" +":c:func:`PySys_ResetWarnOptions`：請改為清除 :data:`sys.warnoptions` 和 :" +"data:`!warnings.filters`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:15 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:14 msgid "" -":c:func:`Py_GetExecPrefix`: Get :data:`sys.base_exec_prefix` " -"and :data:`sys.exec_prefix` instead." +":c:func:`Py_GetExecPrefix`: Get :data:`sys.base_exec_prefix` and :data:`sys." +"exec_prefix` instead." msgstr "" -":c:func:`Py_GetExecPrefix`：請改用 :data:`sys.base_exec_prefix` " -"與 :data:`sys.exec_prefix`。" +":c:func:`Py_GetExecPrefix`：請改用 :data:`sys.base_exec_prefix` 與 :data:" +"`sys.exec_prefix`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:17 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:16 msgid ":c:func:`Py_GetPath`: Get :data:`sys.path` instead." msgstr ":c:func:`Py_GetPath`：請改用 :data:`sys.path`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:19 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:18 msgid "" ":c:func:`Py_GetPrefix`: Get :data:`sys.base_prefix` and :data:`sys.prefix` " "instead." msgstr "" -":c:func:`Py_GetPrefix`：請改用 :data:`sys.base_prefix` " -"與 :data:`sys.prefix`。" +":c:func:`Py_GetPrefix`：請改用 :data:`sys.base_prefix` 與 :data:`sys." +"prefix`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:21 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:20 msgid ":c:func:`Py_GetProgramFullPath`: Get :data:`sys.executable` instead." msgstr ":c:func:`Py_GetProgramFullPath`：請改用 :data:`sys.executable`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:23 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:22 msgid ":c:func:`Py_GetProgramName`: Get :data:`sys.executable` instead." msgstr ":c:func:`Py_GetProgramName`：請改用 :data:`sys.executable`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:25 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:24 msgid "" -":c:func:`Py_GetPythonHome`: Get :c:member:`PyConfig.home` or " -"the :envvar:`PYTHONHOME` environment variable instead." +":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` 環境變數。" + +#~ msgid "The bundled copy of ``libmpdecimal``." +#~ msgstr "``libmpdecimal`` 的打包副本 (bundled copy)。" diff --git a/deprecations/c-api-pending-removal-in-3.16.po b/deprecations/c-api-pending-removal-in-3.16.po new file mode 100644 index 0000000000..3fc534b800 --- /dev/null +++ b/deprecations/c-api-pending-removal-in-3.16.po @@ -0,0 +1,26 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, 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.13\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-07-03 00:17+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.16.rst:2 +msgid "Pending removal in Python 3.16" +msgstr "" + +#: ../../deprecations/c-api-pending-removal-in-3.16.rst:4 +msgid "The bundled copy of ``libmpdec``." +msgstr "" diff --git a/deprecations/index.po b/deprecations/index.po index 9933eacdd4..0b75d47190 100644 --- a/deprecations/index.po +++ b/deprecations/index.po @@ -5,7 +5,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-06-27 07:36+0000\n" +"POT-Creation-Date: 2025-07-03 00:17+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-" @@ -437,11 +437,10 @@ msgid "" "since Python 3.13. Use ``class TD(TypedDict): pass`` or ``TD = " "TypedDict(\"TD\", {})`` to create a TypedDict with zero field." msgstr "" -"當使用 :class:`~typing.TypedDict` 的函式語法時，未傳遞值給 *fields* " -"參數 (``TD = TypedDict(\"TD\")``) 或傳遞 ``None`` (``TD = " -"TypedDict(\"TD\", None)``) 的做法自 Python 3.13 起已被棄用。請" -"使用 ``class TD(TypedDict): pass`` 或 ``TD = " -"TypedDict(\"TD\", {})`` 來建立具有零個欄位的 TypedDict。" +"當使用 :class:`~typing.TypedDict` 的函式語法時，未傳遞值給 *fields* 參數 " +"(``TD = TypedDict(\"TD\")``) 或傳遞 ``None`` (``TD = TypedDict(\"TD\", " +"None)``) 的做法自 Python 3.13 起已被棄用。請使用 ``class TD(TypedDict): " +"pass`` 或 ``TD = TypedDict(\"TD\", {})`` 來建立具有零個欄位的 TypedDict。" #: ../../deprecations/pending-removal-in-3.15.rst:95 msgid "" @@ -1165,10 +1164,6 @@ msgstr "" "func:`Py_PreInitialize`）" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:4 -msgid "The bundled copy of ``libmpdecimal``." -msgstr "``libmpdecimal`` 的打包副本 (bundled copy)。" - -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:5 msgid "" "The :c:func:`PyImport_ImportModuleNoBlock`: Use :c:func:" "`PyImport_ImportModule` instead." @@ -1176,7 +1171,7 @@ msgstr "" ":c:func:`PyImport_ImportModuleNoBlock`：請改用 :c:func:" "`PyImport_ImportModule`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:7 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:6 msgid "" ":c:func:`PyWeakref_GetObject` and :c:func:`PyWeakref_GET_OBJECT`: Use :c:" "func:`PyWeakref_GetRef` instead." @@ -1184,7 +1179,7 @@ msgstr "" ":c:func:`PyWeakref_GetObject` 和 :c:func:`PyWeakref_GET_OBJECT`：請改用 :c:" "func:`PyWeakref_GetRef`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:9 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:8 msgid "" ":c:type:`Py_UNICODE` type and the :c:macro:`!Py_UNICODE_WIDE` macro: Use :c:" "type:`wchar_t` instead." @@ -1192,11 +1187,11 @@ msgstr "" ":c:type:`Py_UNICODE` 型別與 :c:macro:`!Py_UNICODE_WIDE` 巨集：請改用 :c:type:" "`wchar_t`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:11 +#: ../../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:13 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:12 msgid "" ":c:func:`PySys_ResetWarnOptions`: Clear :data:`sys.warnoptions` and :data:`!" "warnings.filters` instead." @@ -1204,7 +1199,7 @@ msgstr "" ":c:func:`PySys_ResetWarnOptions`：請改為清除 :data:`sys.warnoptions` 和 :" "data:`!warnings.filters`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:15 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:14 msgid "" ":c:func:`Py_GetExecPrefix`: Get :data:`sys.base_exec_prefix` and :data:`sys." "exec_prefix` instead." @@ -1212,11 +1207,11 @@ msgstr "" ":c:func:`Py_GetExecPrefix`：請改用 :data:`sys.base_exec_prefix` 與 :data:" "`sys.exec_prefix`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:17 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:16 msgid ":c:func:`Py_GetPath`: Get :data:`sys.path` instead." msgstr ":c:func:`Py_GetPath`：請改用 :data:`sys.path`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:19 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:18 msgid "" ":c:func:`Py_GetPrefix`: Get :data:`sys.base_prefix` and :data:`sys.prefix` " "instead." @@ -1224,15 +1219,15 @@ msgstr "" ":c:func:`Py_GetPrefix`：請改用 :data:`sys.base_prefix` 與 :data:`sys." "prefix`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:21 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:20 msgid ":c:func:`Py_GetProgramFullPath`: Get :data:`sys.executable` instead." msgstr ":c:func:`Py_GetProgramFullPath`：請改用 :data:`sys.executable`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:23 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:22 msgid ":c:func:`Py_GetProgramName`: Get :data:`sys.executable` instead." msgstr ":c:func:`Py_GetProgramName`：請改用 :data:`sys.executable`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:25 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:24 msgid "" ":c:func:`Py_GetPythonHome`: Get :c:member:`PyConfig.home` or the :envvar:" "`PYTHONHOME` environment variable instead." @@ -1371,5 +1366,8 @@ msgstr "" msgid ":c:func:`PyThread_ReInitTLS`: Unneeded since Python 3.7." msgstr ":c:func:`PyThread_ReInitTLS`：自 Python 3.7 起不再需要。" +#~ msgid "The bundled copy of ``libmpdecimal``." +#~ msgstr "``libmpdecimal`` 的打包副本 (bundled copy)。" + #~ msgid ":mod:`array`'s ``'u'`` format code (:gh:`57281`)" #~ msgstr ":mod:`array` 的 ``'u'`` 格式碼 (:gh:`57281`)" diff --git a/howto/functional.po b/howto/functional.po index ff0682092a..f302283661 100644 --- a/howto/functional.po +++ b/howto/functional.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-06-27 07:36+0000\n" +"POT-Creation-Date: 2025-07-04 00:16+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-" @@ -1970,7 +1970,7 @@ msgstr "" #: ../../howto/functional.rst:1220 msgid "" -"https://www.defmacro.org/ramblings/fp.html: A general introduction to " +"https://defmacro.org/2006/06/19/fp.html: A general introduction to " "functional programming that uses Java examples and has a lengthy historical " "introduction." msgstr "" diff --git a/howto/isolating-extensions.po b/howto/isolating-extensions.po index 7b72abc5c8..bdaa271023 100644 --- a/howto/isolating-extensions.po +++ b/howto/isolating-extensions.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-06-27 07:36+0000\n" +"POT-Creation-Date: 2025-07-03 00:17+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-" @@ -952,16 +952,15 @@ msgstr "" #: ../../howto/isolating-extensions.rst:629 msgid "" -"Discussions about improving the situation are best held on the `capi-sig " -"mailing list `__." +"Discussions about improving the situation are best held on the `discuss " +"forum under c-api tag `__." msgstr "" -#: ../../howto/isolating-extensions.rst:634 +#: ../../howto/isolating-extensions.rst:633 msgid "Per-Class Scope" msgstr "" -#: ../../howto/isolating-extensions.rst:636 +#: ../../howto/isolating-extensions.rst:635 msgid "" "It is currently (as of Python 3.11) not possible to attach state to " "individual *types* without relying on CPython implementation details (which " @@ -969,11 +968,11 @@ msgid "" "per-class scope)." msgstr "" -#: ../../howto/isolating-extensions.rst:643 +#: ../../howto/isolating-extensions.rst:642 msgid "Lossless Conversion to Heap Types" msgstr "" -#: ../../howto/isolating-extensions.rst:645 +#: ../../howto/isolating-extensions.rst:644 msgid "" "The heap type API was not designed for \"lossless\" conversion from static " "types; that is, creating a type that works exactly like a given static type." diff --git a/library/codecs.po b/library/codecs.po index d12006bce7..0079868039 100644 --- a/library/codecs.po +++ b/library/codecs.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-13 00:40+0000\n" +"POT-Creation-Date: 2025-07-01 00:18+0000\n" "PO-Revision-Date: 2018-05-23 14:40+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -71,17 +71,26 @@ msgid "" "information on codec error handling." msgstr "" -#: ../../library/codecs.rst:56 +#: ../../library/codecs.rst:58 +msgid "" +"Return a mapping suitable for encoding with a custom single-byte encoding. " +"Given a :class:`str` *string* of up to 256 characters representing a " +"decoding table, returns either a compact internal mapping object " +"``EncodingMap`` or a :class:`dictionary ` mapping character ordinals " +"to byte values. Raises a :exc:`TypeError` on invalid input." +msgstr "" + +#: ../../library/codecs.rst:64 msgid "The full details for each codec can also be looked up directly:" msgstr "" -#: ../../library/codecs.rst:60 +#: ../../library/codecs.rst:68 msgid "" "Looks up the codec info in the Python codec registry and returns a :class:" "`CodecInfo` object as defined below." msgstr "" -#: ../../library/codecs.rst:63 +#: ../../library/codecs.rst:71 msgid "" "Encodings are first looked up in the registry's cache. If not found, the " "list of registered search functions is scanned. If no :class:`CodecInfo` " @@ -89,17 +98,17 @@ msgid "" "`CodecInfo` object is stored in the cache and returned to the caller." msgstr "" -#: ../../library/codecs.rst:70 +#: ../../library/codecs.rst:78 msgid "" "Codec details when looking up the codec registry. The constructor arguments " "are stored in attributes of the same name:" msgstr "" -#: ../../library/codecs.rst:76 +#: ../../library/codecs.rst:84 msgid "The name of the encoding." msgstr "" -#: ../../library/codecs.rst:82 +#: ../../library/codecs.rst:90 msgid "" "The stateless encoding and decoding functions. These must be functions or " "methods which have the same interface as the :meth:`~Codec.encode` and :meth:" @@ -108,7 +117,7 @@ msgid "" "mode." msgstr "" -#: ../../library/codecs.rst:92 +#: ../../library/codecs.rst:100 msgid "" "Incremental encoder and decoder classes or factory functions. These have to " "provide the interface defined by the base classes :class:" @@ -116,77 +125,77 @@ msgid "" "Incremental codecs can maintain state." msgstr "" -#: ../../library/codecs.rst:101 +#: ../../library/codecs.rst:109 msgid "" "Stream writer and reader classes or factory functions. These have to provide " "the interface defined by the base classes :class:`StreamWriter` and :class:" "`StreamReader`, respectively. Stream codecs can maintain state." msgstr "" -#: ../../library/codecs.rst:106 +#: ../../library/codecs.rst:114 msgid "" "To simplify access to the various codec components, the module provides " "these additional functions which use :func:`lookup` for the codec lookup:" msgstr "" -#: ../../library/codecs.rst:111 +#: ../../library/codecs.rst:119 msgid "" "Look up the codec for the given encoding and return its encoder function." msgstr "" -#: ../../library/codecs.rst:113 ../../library/codecs.rst:120 -#: ../../library/codecs.rst:146 ../../library/codecs.rst:154 +#: ../../library/codecs.rst:121 ../../library/codecs.rst:128 +#: ../../library/codecs.rst:154 ../../library/codecs.rst:162 msgid "Raises a :exc:`LookupError` in case the encoding cannot be found." msgstr "" -#: ../../library/codecs.rst:118 +#: ../../library/codecs.rst:126 msgid "" "Look up the codec for the given encoding and return its decoder function." msgstr "" -#: ../../library/codecs.rst:125 +#: ../../library/codecs.rst:133 msgid "" "Look up the codec for the given encoding and return its incremental encoder " "class or factory function." msgstr "" -#: ../../library/codecs.rst:128 +#: ../../library/codecs.rst:136 msgid "" "Raises a :exc:`LookupError` in case the encoding cannot be found or the " "codec doesn't support an incremental encoder." msgstr "" -#: ../../library/codecs.rst:134 +#: ../../library/codecs.rst:142 msgid "" "Look up the codec for the given encoding and return its incremental decoder " "class or factory function." msgstr "" -#: ../../library/codecs.rst:137 +#: ../../library/codecs.rst:145 msgid "" "Raises a :exc:`LookupError` in case the encoding cannot be found or the " "codec doesn't support an incremental decoder." msgstr "" -#: ../../library/codecs.rst:143 +#: ../../library/codecs.rst:151 msgid "" "Look up the codec for the given encoding and return its :class:" "`StreamReader` class or factory function." msgstr "" -#: ../../library/codecs.rst:151 +#: ../../library/codecs.rst:159 msgid "" "Look up the codec for the given encoding and return its :class:" "`StreamWriter` class or factory function." msgstr "" -#: ../../library/codecs.rst:156 +#: ../../library/codecs.rst:164 msgid "" "Custom codecs are made available by registering a suitable codec search " "function:" msgstr "" -#: ../../library/codecs.rst:161 +#: ../../library/codecs.rst:169 msgid "" "Register a codec search function. Search functions are expected to take one " "argument, being the encoding name in all lower case letters with hyphens and " @@ -195,17 +204,17 @@ msgid "" "``None``." msgstr "" -#: ../../library/codecs.rst:167 +#: ../../library/codecs.rst:175 msgid "Hyphens and spaces are converted to underscore." msgstr "" -#: ../../library/codecs.rst:173 +#: ../../library/codecs.rst:181 msgid "" "Unregister a codec search function and clear the registry's cache. If the " "search function is not registered, do nothing." msgstr "" -#: ../../library/codecs.rst:179 +#: ../../library/codecs.rst:187 msgid "" "While the builtin :func:`open` and the associated :mod:`io` module are the " "recommended approach for working with encoded text files, this module " @@ -213,14 +222,14 @@ msgid "" "wider range of codecs when working with binary files:" msgstr "" -#: ../../library/codecs.rst:186 +#: ../../library/codecs.rst:194 msgid "" "Open an encoded file using the given *mode* and return an instance of :class:" "`StreamReaderWriter`, providing transparent encoding/decoding. The default " "file mode is ``'r'``, meaning to open the file in read mode." msgstr "" -#: ../../library/codecs.rst:192 +#: ../../library/codecs.rst:200 msgid "" "If *encoding* is not ``None``, then the underlying encoded files are always " "opened in binary mode. No automatic conversion of ``'\\n'`` is done on " @@ -228,38 +237,38 @@ msgid "" "to the built-in :func:`open` function; the ``'b'`` is automatically added." msgstr "" -#: ../../library/codecs.rst:198 +#: ../../library/codecs.rst:206 msgid "" "*encoding* specifies the encoding which is to be used for the file. Any " "encoding that encodes to and decodes from bytes is allowed, and the data " "types supported by the file methods depend on the codec used." msgstr "" -#: ../../library/codecs.rst:202 +#: ../../library/codecs.rst:210 msgid "" "*errors* may be given to define the error handling. It defaults to " "``'strict'`` which causes a :exc:`ValueError` to be raised in case an " "encoding error occurs." msgstr "" -#: ../../library/codecs.rst:205 +#: ../../library/codecs.rst:213 msgid "" "*buffering* has the same meaning as for the built-in :func:`open` function. " "It defaults to -1 which means that the default buffer size will be used." msgstr "" -#: ../../library/codecs.rst:208 +#: ../../library/codecs.rst:216 msgid "The ``'U'`` mode has been removed." msgstr "" -#: ../../library/codecs.rst:214 +#: ../../library/codecs.rst:222 msgid "" "Return a :class:`StreamRecoder` instance, a wrapped version of *file* which " "provides transparent transcoding. The original file is closed when the " "wrapped version is closed." msgstr "" -#: ../../library/codecs.rst:218 +#: ../../library/codecs.rst:226 msgid "" "Data written to the wrapped file is decoded according to the given " "*data_encoding* and then written to the original file as bytes using " @@ -267,18 +276,18 @@ msgid "" "*file_encoding*, and the result is encoded using *data_encoding*." msgstr "" -#: ../../library/codecs.rst:224 +#: ../../library/codecs.rst:232 msgid "If *file_encoding* is not given, it defaults to *data_encoding*." msgstr "" -#: ../../library/codecs.rst:226 +#: ../../library/codecs.rst:234 msgid "" "*errors* may be given to define the error handling. It defaults to " "``'strict'``, which causes :exc:`ValueError` to be raised in case an " "encoding error occurs." msgstr "" -#: ../../library/codecs.rst:233 +#: ../../library/codecs.rst:241 msgid "" "Uses an incremental encoder to iteratively encode the input provided by " "*iterator*. This function is a :term:`generator`. The *errors* argument (as " @@ -286,14 +295,14 @@ msgid "" "encoder." msgstr "" -#: ../../library/codecs.rst:238 +#: ../../library/codecs.rst:246 msgid "" "This function requires that the codec accept text :class:`str` objects to " "encode. Therefore it does not support bytes-to-bytes encoders such as " "``base64_codec``." msgstr "" -#: ../../library/codecs.rst:245 +#: ../../library/codecs.rst:253 msgid "" "Uses an incremental decoder to iteratively decode the input provided by " "*iterator*. This function is a :term:`generator`. The *errors* argument (as " @@ -301,7 +310,7 @@ msgid "" "decoder." msgstr "" -#: ../../library/codecs.rst:250 +#: ../../library/codecs.rst:258 msgid "" "This function requires that the codec accept :class:`bytes` objects to " "decode. Therefore it does not support text-to-text encoders such as " @@ -309,13 +318,13 @@ msgid "" "`iterencode`." msgstr "" -#: ../../library/codecs.rst:256 +#: ../../library/codecs.rst:264 msgid "" "The module also provides the following constants which are useful for " "reading and writing to platform dependent files:" msgstr "" -#: ../../library/codecs.rst:271 +#: ../../library/codecs.rst:279 msgid "" "These constants define various byte sequences, being Unicode byte order " "marks (BOMs) for several encodings. They are used in UTF-16 and UTF-32 data " @@ -327,18 +336,18 @@ msgid "" "represent the BOM in UTF-8 and UTF-32 encodings." msgstr "" -#: ../../library/codecs.rst:285 +#: ../../library/codecs.rst:293 msgid "Codec Base Classes" msgstr "" -#: ../../library/codecs.rst:287 +#: ../../library/codecs.rst:295 msgid "" "The :mod:`codecs` module defines a set of base classes which define the " "interfaces for working with codec objects, and can also be used as the basis " "for custom codec implementations." msgstr "" -#: ../../library/codecs.rst:291 +#: ../../library/codecs.rst:299 msgid "" "Each codec has to define four interfaces to make it usable as codec in " "Python: stateless encoder, stateless decoder, stream reader and stream " @@ -347,69 +356,69 @@ msgid "" "how the codec will handle encoding and decoding errors." msgstr "" -#: ../../library/codecs.rst:302 +#: ../../library/codecs.rst:310 msgid "Error Handlers" msgstr "" -#: ../../library/codecs.rst:304 +#: ../../library/codecs.rst:312 msgid "" "To simplify and standardize error handling, codecs may implement different " "error handling schemes by accepting the *errors* string argument:" msgstr "" -#: ../../library/codecs.rst:324 +#: ../../library/codecs.rst:332 msgid "" "The following error handlers can be used with all Python :ref:`standard-" "encodings` codecs:" msgstr "" -#: ../../library/codecs.rst:330 ../../library/codecs.rst:373 -#: ../../library/codecs.rst:393 +#: ../../library/codecs.rst:338 ../../library/codecs.rst:381 +#: ../../library/codecs.rst:401 msgid "Value" msgstr "" -#: ../../library/codecs.rst:330 ../../library/codecs.rst:373 -#: ../../library/codecs.rst:393 ../../library/codecs.rst:1331 -#: ../../library/codecs.rst:1399 ../../library/codecs.rst:1454 +#: ../../library/codecs.rst:338 ../../library/codecs.rst:381 +#: ../../library/codecs.rst:401 ../../library/codecs.rst:1339 +#: ../../library/codecs.rst:1407 ../../library/codecs.rst:1462 msgid "Meaning" msgstr "含義" -#: ../../library/codecs.rst:332 +#: ../../library/codecs.rst:340 msgid "``'strict'``" msgstr "``'strict'``" -#: ../../library/codecs.rst:332 +#: ../../library/codecs.rst:340 msgid "" "Raise :exc:`UnicodeError` (or a subclass), this is the default. Implemented " "in :func:`strict_errors`." msgstr "" -#: ../../library/codecs.rst:336 +#: ../../library/codecs.rst:344 msgid "``'ignore'``" msgstr "``'ignore'``" -#: ../../library/codecs.rst:336 +#: ../../library/codecs.rst:344 msgid "" "Ignore the malformed data and continue without further notice. Implemented " "in :func:`ignore_errors`." msgstr "" -#: ../../library/codecs.rst:340 +#: ../../library/codecs.rst:348 msgid "``'replace'``" msgstr "``'replace'``" -#: ../../library/codecs.rst:340 +#: ../../library/codecs.rst:348 msgid "" "Replace with a replacement marker. On encoding, use ``?`` (ASCII character). " "On decoding, use ``�`` (U+FFFD, the official REPLACEMENT CHARACTER). " "Implemented in :func:`replace_errors`." msgstr "" -#: ../../library/codecs.rst:346 +#: ../../library/codecs.rst:354 msgid "``'backslashreplace'``" msgstr "``'backslashreplace'``" -#: ../../library/codecs.rst:346 +#: ../../library/codecs.rst:354 msgid "" "Replace with backslashed escape sequences. On encoding, use hexadecimal form " "of Unicode code point with formats :samp:`\\\\x{hh}` :samp:`\\\\u{xxxx}` :" @@ -417,11 +426,11 @@ msgid "" "format :samp:`\\\\x{hh}`. Implemented in :func:`backslashreplace_errors`." msgstr "" -#: ../../library/codecs.rst:355 +#: ../../library/codecs.rst:363 msgid "``'surrogateescape'``" msgstr "``'surrogateescape'``" -#: ../../library/codecs.rst:355 +#: ../../library/codecs.rst:363 msgid "" "On decoding, replace byte with individual surrogate code ranging from " "``U+DC80`` to ``U+DCFF``. This code will then be turned back into the same " @@ -429,92 +438,92 @@ msgid "" "data. (See :pep:`383` for more.)" msgstr "" -#: ../../library/codecs.rst:369 +#: ../../library/codecs.rst:377 msgid "" "The following error handlers are only applicable to encoding (within :term:" "`text encodings `):" msgstr "" -#: ../../library/codecs.rst:375 +#: ../../library/codecs.rst:383 msgid "``'xmlcharrefreplace'``" msgstr "``'xmlcharrefreplace'``" -#: ../../library/codecs.rst:375 +#: ../../library/codecs.rst:383 msgid "" "Replace with XML/HTML numeric character reference, which is a decimal form " "of Unicode code point with format :samp:`&#{num};`. Implemented in :func:" "`xmlcharrefreplace_errors`." msgstr "" -#: ../../library/codecs.rst:381 +#: ../../library/codecs.rst:389 msgid "``'namereplace'``" msgstr "``'namereplace'``" -#: ../../library/codecs.rst:381 +#: ../../library/codecs.rst:389 msgid "" "Replace with ``\\N{...}`` escape sequences, what appears in the braces is " "the Name property from Unicode Character Database. Implemented in :func:" "`namereplace_errors`." msgstr "" -#: ../../library/codecs.rst:390 +#: ../../library/codecs.rst:398 msgid "" "In addition, the following error handler is specific to the given codecs:" msgstr "" -#: ../../library/codecs.rst:13 ../../library/codecs.rst:393 +#: ../../library/codecs.rst:13 ../../library/codecs.rst:401 msgid "Codecs" msgstr "" -#: ../../library/codecs.rst:395 +#: ../../library/codecs.rst:403 msgid "``'surrogatepass'``" msgstr "``'surrogatepass'``" -#: ../../library/codecs.rst:395 +#: ../../library/codecs.rst:403 msgid "utf-8, utf-16, utf-32, utf-16-be, utf-16-le, utf-32-be, utf-32-le" msgstr "utf-8, utf-16, utf-32, utf-16-be, utf-16-le, utf-32-be, utf-32-le" -#: ../../library/codecs.rst:395 +#: ../../library/codecs.rst:403 msgid "" "Allow encoding and decoding surrogate code point (``U+D800`` - ``U+DFFF``) " "as normal code point. Otherwise these codecs treat the presence of surrogate " "code point in :class:`str` as an error." msgstr "" -#: ../../library/codecs.rst:402 +#: ../../library/codecs.rst:410 msgid "The ``'surrogateescape'`` and ``'surrogatepass'`` error handlers." msgstr "" -#: ../../library/codecs.rst:405 +#: ../../library/codecs.rst:413 msgid "" "The ``'surrogatepass'`` error handler now works with utf-16\\* and utf-32\\* " "codecs." msgstr "" -#: ../../library/codecs.rst:409 +#: ../../library/codecs.rst:417 msgid "The ``'namereplace'`` error handler." msgstr "" -#: ../../library/codecs.rst:412 +#: ../../library/codecs.rst:420 msgid "" "The ``'backslashreplace'`` error handler now works with decoding and " "translating." msgstr "" -#: ../../library/codecs.rst:416 +#: ../../library/codecs.rst:424 msgid "" "The set of allowed values can be extended by registering a new named error " "handler:" msgstr "" -#: ../../library/codecs.rst:421 +#: ../../library/codecs.rst:429 msgid "" "Register the error handling function *error_handler* under the name *name*. " "The *error_handler* argument will be called during encoding and decoding in " "case of an error, when *name* is specified as the errors parameter." msgstr "" -#: ../../library/codecs.rst:425 +#: ../../library/codecs.rst:433 msgid "" "For encoding, *error_handler* will be called with a :exc:" "`UnicodeEncodeError` instance, which contains information about the location " @@ -529,66 +538,66 @@ msgid "" "position is out of bound an :exc:`IndexError` will be raised." msgstr "" -#: ../../library/codecs.rst:437 +#: ../../library/codecs.rst:445 msgid "" "Decoding and translating works similarly, except :exc:`UnicodeDecodeError` " "or :exc:`UnicodeTranslateError` will be passed to the handler and that the " "replacement from the error handler will be put into the output directly." msgstr "" -#: ../../library/codecs.rst:442 +#: ../../library/codecs.rst:450 msgid "" "Previously registered error handlers (including the standard error handlers) " "can be looked up by name:" msgstr "" -#: ../../library/codecs.rst:447 +#: ../../library/codecs.rst:455 msgid "Return the error handler previously registered under the name *name*." msgstr "" -#: ../../library/codecs.rst:449 +#: ../../library/codecs.rst:457 msgid "Raises a :exc:`LookupError` in case the handler cannot be found." msgstr "" -#: ../../library/codecs.rst:451 +#: ../../library/codecs.rst:459 msgid "" "The following standard error handlers are also made available as module " "level functions:" msgstr "" -#: ../../library/codecs.rst:456 +#: ../../library/codecs.rst:464 msgid "Implements the ``'strict'`` error handling." msgstr "" -#: ../../library/codecs.rst:458 +#: ../../library/codecs.rst:466 msgid "Each encoding or decoding error raises a :exc:`UnicodeError`." msgstr "" -#: ../../library/codecs.rst:463 +#: ../../library/codecs.rst:471 msgid "Implements the ``'ignore'`` error handling." msgstr "" -#: ../../library/codecs.rst:465 +#: ../../library/codecs.rst:473 msgid "" "Malformed data is ignored; encoding or decoding is continued without further " "notice." msgstr "" -#: ../../library/codecs.rst:471 +#: ../../library/codecs.rst:479 msgid "Implements the ``'replace'`` error handling." msgstr "" -#: ../../library/codecs.rst:473 +#: ../../library/codecs.rst:481 msgid "" "Substitutes ``?`` (ASCII character) for encoding errors or ``�`` (U+FFFD, " "the official REPLACEMENT CHARACTER) for decoding errors." msgstr "" -#: ../../library/codecs.rst:479 +#: ../../library/codecs.rst:487 msgid "Implements the ``'backslashreplace'`` error handling." msgstr "" -#: ../../library/codecs.rst:481 +#: ../../library/codecs.rst:489 msgid "" "Malformed data is replaced by a backslashed escape sequence. On encoding, " "use the hexadecimal form of Unicode code point with formats :samp:`\\\\x{hh}" @@ -596,30 +605,30 @@ msgid "" "hexadecimal form of byte value with format :samp:`\\\\x{hh}`." msgstr "" -#: ../../library/codecs.rst:487 +#: ../../library/codecs.rst:495 msgid "Works with decoding and translating." msgstr "" -#: ../../library/codecs.rst:493 +#: ../../library/codecs.rst:501 msgid "" "Implements the ``'xmlcharrefreplace'`` error handling (for encoding within :" "term:`text encoding` only)." msgstr "" -#: ../../library/codecs.rst:496 +#: ../../library/codecs.rst:504 msgid "" "The unencodable character is replaced by an appropriate XML/HTML numeric " "character reference, which is a decimal form of Unicode code point with " "format :samp:`&#{num};` ." msgstr "" -#: ../../library/codecs.rst:503 +#: ../../library/codecs.rst:511 msgid "" "Implements the ``'namereplace'`` error handling (for encoding within :term:" "`text encoding` only)." msgstr "" -#: ../../library/codecs.rst:506 +#: ../../library/codecs.rst:514 msgid "" "The unencodable character is replaced by a ``\\N{...}`` escape sequence. The " "set of characters that appear in the braces is the Name property from " @@ -627,17 +636,17 @@ msgid "" "will be converted to byte sequence ``\\N{LATIN SMALL LETTER SHARP S}`` ." msgstr "" -#: ../../library/codecs.rst:517 +#: ../../library/codecs.rst:525 msgid "Stateless Encoding and Decoding" msgstr "" -#: ../../library/codecs.rst:519 +#: ../../library/codecs.rst:527 msgid "" "The base :class:`Codec` class defines these methods which also define the " "function interfaces of the stateless encoder and decoder:" msgstr "" -#: ../../library/codecs.rst:527 +#: ../../library/codecs.rst:535 msgid "" "Encodes the object *input* and returns a tuple (output object, length " "consumed). For instance, :term:`text encoding` converts a string object to a " @@ -645,26 +654,26 @@ msgid "" "``iso-8859-1``)." msgstr "" -#: ../../library/codecs.rst:532 ../../library/codecs.rst:554 +#: ../../library/codecs.rst:540 ../../library/codecs.rst:562 msgid "" "The *errors* argument defines the error handling to apply. It defaults to " "``'strict'`` handling." msgstr "" -#: ../../library/codecs.rst:535 +#: ../../library/codecs.rst:543 msgid "" "The method may not store state in the :class:`Codec` instance. Use :class:" "`StreamWriter` for codecs which have to keep state in order to make encoding " "efficient." msgstr "" -#: ../../library/codecs.rst:539 +#: ../../library/codecs.rst:547 msgid "" "The encoder must be able to handle zero length input and return an empty " "object of the output object type in this situation." msgstr "" -#: ../../library/codecs.rst:545 +#: ../../library/codecs.rst:553 msgid "" "Decodes the object *input* and returns a tuple (output object, length " "consumed). For instance, for a :term:`text encoding`, decoding converts a " @@ -672,31 +681,31 @@ msgid "" "object." msgstr "" -#: ../../library/codecs.rst:550 +#: ../../library/codecs.rst:558 msgid "" "For text encodings and bytes-to-bytes codecs, *input* must be a bytes object " "or one which provides the read-only buffer interface -- for example, buffer " "objects and memory mapped files." msgstr "" -#: ../../library/codecs.rst:557 +#: ../../library/codecs.rst:565 msgid "" "The method may not store state in the :class:`Codec` instance. Use :class:" "`StreamReader` for codecs which have to keep state in order to make decoding " "efficient." msgstr "" -#: ../../library/codecs.rst:561 +#: ../../library/codecs.rst:569 msgid "" "The decoder must be able to handle zero length input and return an empty " "object of the output object type in this situation." msgstr "" -#: ../../library/codecs.rst:566 +#: ../../library/codecs.rst:574 msgid "Incremental Encoding and Decoding" msgstr "" -#: ../../library/codecs.rst:568 +#: ../../library/codecs.rst:576 msgid "" "The :class:`IncrementalEncoder` and :class:`IncrementalDecoder` classes " "provide the basic interface for incremental encoding and decoding. Encoding/" @@ -707,7 +716,7 @@ msgid "" "during method calls." msgstr "" -#: ../../library/codecs.rst:576 +#: ../../library/codecs.rst:584 msgid "" "The joined output of calls to the :meth:`~IncrementalEncoder.encode`/:meth:" "`~IncrementalDecoder.decode` method is the same as if all the single inputs " @@ -715,36 +724,36 @@ msgid "" "encoder/decoder." msgstr "" -#: ../../library/codecs.rst:585 +#: ../../library/codecs.rst:593 msgid "IncrementalEncoder Objects" msgstr "IncrementalEncoder 物件" -#: ../../library/codecs.rst:587 +#: ../../library/codecs.rst:595 msgid "" "The :class:`IncrementalEncoder` class is used for encoding an input in " "multiple steps. It defines the following methods which every incremental " "encoder must define in order to be compatible with the Python codec registry." msgstr "" -#: ../../library/codecs.rst:594 +#: ../../library/codecs.rst:602 msgid "Constructor for an :class:`IncrementalEncoder` instance." msgstr "" -#: ../../library/codecs.rst:596 +#: ../../library/codecs.rst:604 msgid "" "All incremental encoders must provide this constructor interface. They are " "free to add additional keyword arguments, but only the ones defined here are " "used by the Python codec registry." msgstr "" -#: ../../library/codecs.rst:600 +#: ../../library/codecs.rst:608 msgid "" "The :class:`IncrementalEncoder` may implement different error handling " "schemes by providing the *errors* keyword argument. See :ref:`error-" "handlers` for possible values." msgstr "" -#: ../../library/codecs.rst:604 +#: ../../library/codecs.rst:612 msgid "" "The *errors* argument will be assigned to an attribute of the same name. " "Assigning to this attribute makes it possible to switch between different " @@ -752,21 +761,21 @@ msgid "" "`IncrementalEncoder` object." msgstr "" -#: ../../library/codecs.rst:612 +#: ../../library/codecs.rst:620 msgid "" "Encodes *object* (taking the current state of the encoder into account) and " "returns the resulting encoded object. If this is the last call to :meth:" "`encode` *final* must be true (the default is false)." msgstr "" -#: ../../library/codecs.rst:619 +#: ../../library/codecs.rst:627 msgid "" "Reset the encoder to the initial state. The output is discarded: call ``." "encode(object, final=True)``, passing an empty byte or text string if " "necessary, to reset the encoder and to get the output." msgstr "" -#: ../../library/codecs.rst:626 +#: ../../library/codecs.rst:634 msgid "" "Return the current state of the encoder which must be an integer. The " "implementation should make sure that ``0`` is the most common state. (States " @@ -775,42 +784,42 @@ msgid "" "into an integer.)" msgstr "" -#: ../../library/codecs.rst:635 +#: ../../library/codecs.rst:643 msgid "" "Set the state of the encoder to *state*. *state* must be an encoder state " "returned by :meth:`getstate`." msgstr "" -#: ../../library/codecs.rst:642 +#: ../../library/codecs.rst:650 msgid "IncrementalDecoder Objects" msgstr "IncrementalDecoder 物件" -#: ../../library/codecs.rst:644 +#: ../../library/codecs.rst:652 msgid "" "The :class:`IncrementalDecoder` class is used for decoding an input in " "multiple steps. It defines the following methods which every incremental " "decoder must define in order to be compatible with the Python codec registry." msgstr "" -#: ../../library/codecs.rst:651 +#: ../../library/codecs.rst:659 msgid "Constructor for an :class:`IncrementalDecoder` instance." msgstr "" -#: ../../library/codecs.rst:653 +#: ../../library/codecs.rst:661 msgid "" "All incremental decoders must provide this constructor interface. They are " "free to add additional keyword arguments, but only the ones defined here are " "used by the Python codec registry." msgstr "" -#: ../../library/codecs.rst:657 +#: ../../library/codecs.rst:665 msgid "" "The :class:`IncrementalDecoder` may implement different error handling " "schemes by providing the *errors* keyword argument. See :ref:`error-" "handlers` for possible values." msgstr "" -#: ../../library/codecs.rst:661 +#: ../../library/codecs.rst:669 msgid "" "The *errors* argument will be assigned to an attribute of the same name. " "Assigning to this attribute makes it possible to switch between different " @@ -818,7 +827,7 @@ msgid "" "`IncrementalDecoder` object." msgstr "" -#: ../../library/codecs.rst:669 +#: ../../library/codecs.rst:677 msgid "" "Decodes *object* (taking the current state of the decoder into account) and " "returns the resulting decoded object. If this is the last call to :meth:" @@ -829,11 +838,11 @@ msgid "" "(which might raise an exception)." msgstr "" -#: ../../library/codecs.rst:680 +#: ../../library/codecs.rst:688 msgid "Reset the decoder to the initial state." msgstr "" -#: ../../library/codecs.rst:685 +#: ../../library/codecs.rst:693 msgid "" "Return the current state of the decoder. This must be a tuple with two " "items, the first must be the buffer containing the still undecoded input. " @@ -848,59 +857,59 @@ msgid "" "bytes of the resulting string into an integer.)" msgstr "" -#: ../../library/codecs.rst:700 +#: ../../library/codecs.rst:708 msgid "" "Set the state of the decoder to *state*. *state* must be a decoder state " "returned by :meth:`getstate`." msgstr "" -#: ../../library/codecs.rst:705 +#: ../../library/codecs.rst:713 msgid "Stream Encoding and Decoding" msgstr "" -#: ../../library/codecs.rst:708 +#: ../../library/codecs.rst:716 msgid "" "The :class:`StreamWriter` and :class:`StreamReader` classes provide generic " "working interfaces which can be used to implement new encoding submodules " "very easily. See :mod:`!encodings.utf_8` for an example of how this is done." msgstr "" -#: ../../library/codecs.rst:716 +#: ../../library/codecs.rst:724 msgid "StreamWriter Objects" msgstr "StreamWriter 物件" -#: ../../library/codecs.rst:718 +#: ../../library/codecs.rst:726 msgid "" "The :class:`StreamWriter` class is a subclass of :class:`Codec` and defines " "the following methods which every stream writer must define in order to be " "compatible with the Python codec registry." msgstr "" -#: ../../library/codecs.rst:725 +#: ../../library/codecs.rst:733 msgid "Constructor for a :class:`StreamWriter` instance." msgstr "" -#: ../../library/codecs.rst:727 +#: ../../library/codecs.rst:735 msgid "" "All stream writers must provide this constructor interface. They are free to " "add additional keyword arguments, but only the ones defined here are used by " "the Python codec registry." msgstr "" -#: ../../library/codecs.rst:731 +#: ../../library/codecs.rst:739 msgid "" "The *stream* argument must be a file-like object open for writing text or " "binary data, as appropriate for the specific codec." msgstr "" -#: ../../library/codecs.rst:734 +#: ../../library/codecs.rst:742 msgid "" "The :class:`StreamWriter` may implement different error handling schemes by " "providing the *errors* keyword argument. See :ref:`error-handlers` for the " "standard error handlers the underlying stream codec may support." msgstr "" -#: ../../library/codecs.rst:738 +#: ../../library/codecs.rst:746 msgid "" "The *errors* argument will be assigned to an attribute of the same name. " "Assigning to this attribute makes it possible to switch between different " @@ -908,70 +917,70 @@ msgid "" "object." msgstr "" -#: ../../library/codecs.rst:744 +#: ../../library/codecs.rst:752 msgid "Writes the object's contents encoded to the stream." msgstr "" -#: ../../library/codecs.rst:749 +#: ../../library/codecs.rst:757 msgid "" "Writes the concatenated iterable of strings to the stream (possibly by " "reusing the :meth:`write` method). Infinite or very large iterables are not " "supported. The standard bytes-to-bytes codecs do not support this method." msgstr "" -#: ../../library/codecs.rst:757 ../../library/codecs.rst:852 +#: ../../library/codecs.rst:765 ../../library/codecs.rst:860 msgid "Resets the codec buffers used for keeping internal state." msgstr "" -#: ../../library/codecs.rst:759 +#: ../../library/codecs.rst:767 msgid "" "Calling this method should ensure that the data on the output is put into a " "clean state that allows appending of new fresh data without having to rescan " "the whole stream to recover state." msgstr "" -#: ../../library/codecs.rst:764 +#: ../../library/codecs.rst:772 msgid "" "In addition to the above methods, the :class:`StreamWriter` must also " "inherit all other methods and attributes from the underlying stream." msgstr "" -#: ../../library/codecs.rst:771 +#: ../../library/codecs.rst:779 msgid "StreamReader Objects" msgstr "StreamReader 物件" -#: ../../library/codecs.rst:773 +#: ../../library/codecs.rst:781 msgid "" "The :class:`StreamReader` class is a subclass of :class:`Codec` and defines " "the following methods which every stream reader must define in order to be " "compatible with the Python codec registry." msgstr "" -#: ../../library/codecs.rst:780 +#: ../../library/codecs.rst:788 msgid "Constructor for a :class:`StreamReader` instance." msgstr "" -#: ../../library/codecs.rst:782 +#: ../../library/codecs.rst:790 msgid "" "All stream readers must provide this constructor interface. They are free to " "add additional keyword arguments, but only the ones defined here are used by " "the Python codec registry." msgstr "" -#: ../../library/codecs.rst:786 +#: ../../library/codecs.rst:794 msgid "" "The *stream* argument must be a file-like object open for reading text or " "binary data, as appropriate for the specific codec." msgstr "" -#: ../../library/codecs.rst:789 +#: ../../library/codecs.rst:797 msgid "" "The :class:`StreamReader` may implement different error handling schemes by " "providing the *errors* keyword argument. See :ref:`error-handlers` for the " "standard error handlers the underlying stream codec may support." msgstr "" -#: ../../library/codecs.rst:793 +#: ../../library/codecs.rst:801 msgid "" "The *errors* argument will be assigned to an attribute of the same name. " "Assigning to this attribute makes it possible to switch between different " @@ -979,24 +988,24 @@ msgid "" "object." msgstr "" -#: ../../library/codecs.rst:797 +#: ../../library/codecs.rst:805 msgid "" "The set of allowed values for the *errors* argument can be extended with :" "func:`register_error`." msgstr "" -#: ../../library/codecs.rst:803 +#: ../../library/codecs.rst:811 msgid "Decodes data from the stream and returns the resulting object." msgstr "" -#: ../../library/codecs.rst:805 +#: ../../library/codecs.rst:813 msgid "" "The *chars* argument indicates the number of decoded code points or bytes to " "return. The :func:`read` method will never return more data than requested, " "but it might return less, if there is not enough available." msgstr "" -#: ../../library/codecs.rst:810 +#: ../../library/codecs.rst:818 msgid "" "The *size* argument indicates the approximate maximum number of encoded " "bytes or code points to read for decoding. The decoder can modify this " @@ -1005,13 +1014,13 @@ msgid "" "huge files in one step." msgstr "" -#: ../../library/codecs.rst:817 +#: ../../library/codecs.rst:825 msgid "" "The *firstline* flag indicates that it would be sufficient to only return " "the first line, if there are decoding errors on later lines." msgstr "" -#: ../../library/codecs.rst:821 +#: ../../library/codecs.rst:829 msgid "" "The method should use a greedy read strategy meaning that it should read as " "much data as is allowed within the definition of the encoding and the given " @@ -1019,68 +1028,68 @@ msgid "" "the stream, these should be read too." msgstr "" -#: ../../library/codecs.rst:829 +#: ../../library/codecs.rst:837 msgid "Read one line from the input stream and return the decoded data." msgstr "" -#: ../../library/codecs.rst:831 +#: ../../library/codecs.rst:839 msgid "" "*size*, if given, is passed as size argument to the stream's :meth:`read` " "method." msgstr "" -#: ../../library/codecs.rst:834 +#: ../../library/codecs.rst:842 msgid "" "If *keepends* is false line-endings will be stripped from the lines returned." msgstr "" -#: ../../library/codecs.rst:840 +#: ../../library/codecs.rst:848 msgid "" "Read all lines available on the input stream and return them as a list of " "lines." msgstr "" -#: ../../library/codecs.rst:843 +#: ../../library/codecs.rst:851 msgid "" "Line-endings are implemented using the codec's :meth:`decode` method and are " "included in the list entries if *keepends* is true." msgstr "" -#: ../../library/codecs.rst:846 +#: ../../library/codecs.rst:854 msgid "" "*sizehint*, if given, is passed as the *size* argument to the stream's :meth:" "`read` method." msgstr "" -#: ../../library/codecs.rst:854 +#: ../../library/codecs.rst:862 msgid "" "Note that no stream repositioning should take place. This method is " "primarily intended to be able to recover from decoding errors." msgstr "" -#: ../../library/codecs.rst:858 +#: ../../library/codecs.rst:866 msgid "" "In addition to the above methods, the :class:`StreamReader` must also " "inherit all other methods and attributes from the underlying stream." msgstr "" -#: ../../library/codecs.rst:864 +#: ../../library/codecs.rst:872 msgid "StreamReaderWriter Objects" msgstr "StreamReaderWriter 物件" -#: ../../library/codecs.rst:866 +#: ../../library/codecs.rst:874 msgid "" "The :class:`StreamReaderWriter` is a convenience class that allows wrapping " "streams which work in both read and write modes." msgstr "" -#: ../../library/codecs.rst:869 ../../library/codecs.rst:893 +#: ../../library/codecs.rst:877 ../../library/codecs.rst:901 msgid "" "The design is such that one can use the factory functions returned by the :" "func:`lookup` function to construct the instance." msgstr "" -#: ../../library/codecs.rst:875 +#: ../../library/codecs.rst:883 msgid "" "Creates a :class:`StreamReaderWriter` instance. *stream* must be a file-like " "object. *Reader* and *Writer* must be factory functions or classes providing " @@ -1089,24 +1098,24 @@ msgid "" "writers." msgstr "" -#: ../../library/codecs.rst:880 +#: ../../library/codecs.rst:888 msgid "" ":class:`StreamReaderWriter` instances define the combined interfaces of :" "class:`StreamReader` and :class:`StreamWriter` classes. They inherit all " "other methods and attributes from the underlying stream." msgstr "" -#: ../../library/codecs.rst:888 +#: ../../library/codecs.rst:896 msgid "StreamRecoder Objects" msgstr "StreamRecoder 物件" -#: ../../library/codecs.rst:890 +#: ../../library/codecs.rst:898 msgid "" "The :class:`StreamRecoder` translates data from one encoding to another, " "which is sometimes useful when dealing with different encoding environments." msgstr "" -#: ../../library/codecs.rst:899 +#: ../../library/codecs.rst:907 msgid "" "Creates a :class:`StreamRecoder` instance which implements a two-way " "conversion: *encode* and *decode* work on the frontend — the data visible to " @@ -1114,17 +1123,17 @@ msgid "" "while *Reader* and *Writer* work on the backend — the data in *stream*." msgstr "" -#: ../../library/codecs.rst:905 +#: ../../library/codecs.rst:913 msgid "" "You can use these objects to do transparent transcodings, e.g., from Latin-1 " "to UTF-8 and back." msgstr "" -#: ../../library/codecs.rst:908 +#: ../../library/codecs.rst:916 msgid "The *stream* argument must be a file-like object." msgstr "" -#: ../../library/codecs.rst:910 +#: ../../library/codecs.rst:918 msgid "" "The *encode* and *decode* arguments must adhere to the :class:`Codec` " "interface. *Reader* and *Writer* must be factory functions or classes " @@ -1132,24 +1141,24 @@ msgid "" "interface respectively." msgstr "" -#: ../../library/codecs.rst:915 +#: ../../library/codecs.rst:923 msgid "" "Error handling is done in the same way as defined for the stream readers and " "writers." msgstr "" -#: ../../library/codecs.rst:919 +#: ../../library/codecs.rst:927 msgid "" ":class:`StreamRecoder` instances define the combined interfaces of :class:" "`StreamReader` and :class:`StreamWriter` classes. They inherit all other " "methods and attributes from the underlying stream." msgstr "" -#: ../../library/codecs.rst:927 +#: ../../library/codecs.rst:935 msgid "Encodings and Unicode" msgstr "" -#: ../../library/codecs.rst:929 +#: ../../library/codecs.rst:937 msgid "" "Strings are stored internally as sequences of code points in range " "``U+0000``--``U+10FFFF``. (See :pep:`393` for more details about the " @@ -1161,7 +1170,7 @@ msgid "" "which are collectivity referred to as :term:`text encodings `." msgstr "" -#: ../../library/codecs.rst:939 +#: ../../library/codecs.rst:947 msgid "" "The simplest text encoding (called ``'latin-1'`` or ``'iso-8859-1'``) maps " "the code points 0--255 to the bytes ``0x0``--``0xff``, which means that a " @@ -1172,7 +1181,7 @@ msgid "" "position 3: ordinal not in range(256)``." msgstr "" -#: ../../library/codecs.rst:947 +#: ../../library/codecs.rst:955 msgid "" "There's another group of encodings (the so called charmap encodings) that " "choose a different subset of all Unicode code points and how these code " @@ -1182,7 +1191,7 @@ msgid "" "that shows you which character is mapped to which byte value." msgstr "" -#: ../../library/codecs.rst:954 +#: ../../library/codecs.rst:962 msgid "" "All of these encodings can only encode 256 of the 1114112 code points " "defined in Unicode. A simple and straightforward way that can store each " @@ -1212,7 +1221,7 @@ msgid "" "normal character that will be decoded like any other." msgstr "" -#: ../../library/codecs.rst:980 +#: ../../library/codecs.rst:988 msgid "" "There's another encoding that is able to encode the full range of Unicode " "characters: UTF-8. UTF-8 is an 8-bit encoding, which means there are no " @@ -1223,59 +1232,59 @@ msgid "" "which when concatenated give the Unicode character):" msgstr "" -#: ../../library/codecs.rst:989 +#: ../../library/codecs.rst:997 msgid "Range" msgstr "" -#: ../../library/codecs.rst:989 +#: ../../library/codecs.rst:997 msgid "Encoding" msgstr "" -#: ../../library/codecs.rst:991 +#: ../../library/codecs.rst:999 msgid "``U-00000000`` ... ``U-0000007F``" msgstr "``U-00000000`` ... ``U-0000007F``" -#: ../../library/codecs.rst:991 +#: ../../library/codecs.rst:999 msgid "0xxxxxxx" msgstr "0xxxxxxx" -#: ../../library/codecs.rst:993 +#: ../../library/codecs.rst:1001 msgid "``U-00000080`` ... ``U-000007FF``" msgstr "``U-00000080`` ... ``U-000007FF``" -#: ../../library/codecs.rst:993 +#: ../../library/codecs.rst:1001 msgid "110xxxxx 10xxxxxx" msgstr "110xxxxx 10xxxxxx" -#: ../../library/codecs.rst:995 +#: ../../library/codecs.rst:1003 msgid "``U-00000800`` ... ``U-0000FFFF``" msgstr "``U-00000800`` ... ``U-0000FFFF``" -#: ../../library/codecs.rst:995 +#: ../../library/codecs.rst:1003 msgid "1110xxxx 10xxxxxx 10xxxxxx" msgstr "1110xxxx 10xxxxxx 10xxxxxx" -#: ../../library/codecs.rst:997 +#: ../../library/codecs.rst:1005 msgid "``U-00010000`` ... ``U-0010FFFF``" msgstr "``U-00010000`` ... ``U-0010FFFF``" -#: ../../library/codecs.rst:997 +#: ../../library/codecs.rst:1005 msgid "11110xxx 10xxxxxx 10xxxxxx 10xxxxxx" msgstr "11110xxx 10xxxxxx 10xxxxxx 10xxxxxx" -#: ../../library/codecs.rst:1000 +#: ../../library/codecs.rst:1008 msgid "" "The least significant bit of the Unicode character is the rightmost x bit." msgstr "" -#: ../../library/codecs.rst:1002 +#: ../../library/codecs.rst:1010 msgid "" "As UTF-8 is an 8-bit encoding no BOM is required and any ``U+FEFF`` " "character in the decoded string (even if it's the first character) is " "treated as a ``ZERO WIDTH NO-BREAK SPACE``." msgstr "" -#: ../../library/codecs.rst:1006 +#: ../../library/codecs.rst:1014 msgid "" "Without external information it's impossible to reliably determine which " "encoding was used for encoding a string. Each charmap encoding can decode " @@ -1301,7 +1310,7 @@ msgstr "" msgid "INVERTED QUESTION MARK" msgstr "" -#: ../../library/codecs.rst:1022 +#: ../../library/codecs.rst:1030 msgid "" "in iso-8859-1), this increases the probability that a ``utf-8-sig`` encoding " "can be correctly guessed from the byte sequence. So here the BOM is not used " @@ -1313,11 +1322,11 @@ msgid "" "the use of the BOM is discouraged and should generally be avoided." msgstr "" -#: ../../library/codecs.rst:1035 +#: ../../library/codecs.rst:1043 msgid "Standard Encodings" msgstr "" -#: ../../library/codecs.rst:1037 +#: ../../library/codecs.rst:1045 msgid "" "Python comes with a number of codecs built-in, either implemented as C " "functions or with dictionaries as mapping tables. The following table lists " @@ -1329,7 +1338,7 @@ msgid "" "alias for the ``'utf_8'`` codec." msgstr "" -#: ../../library/codecs.rst:1047 +#: ../../library/codecs.rst:1055 msgid "" "Some common encodings can bypass the codecs lookup machinery to improve " "performance. These optimization opportunities are only recognized by CPython " @@ -1339,11 +1348,11 @@ msgid "" "Using alternative aliases for these encodings may result in slower execution." msgstr "" -#: ../../library/codecs.rst:1055 +#: ../../library/codecs.rst:1063 msgid "Optimization opportunity recognized for us-ascii." msgstr "" -#: ../../library/codecs.rst:1058 +#: ../../library/codecs.rst:1066 msgid "" "Many of the character sets support the same languages. They vary in " "individual characters (e.g. whether the EURO SIGN is supported or not), and " @@ -1351,504 +1360,504 @@ msgid "" "languages in particular, the following variants typically exist:" msgstr "" -#: ../../library/codecs.rst:1063 +#: ../../library/codecs.rst:1071 msgid "an ISO 8859 codeset" msgstr "" -#: ../../library/codecs.rst:1065 +#: ../../library/codecs.rst:1073 msgid "" "a Microsoft Windows code page, which is typically derived from an 8859 " "codeset, but replaces control characters with additional graphic characters" msgstr "" -#: ../../library/codecs.rst:1068 +#: ../../library/codecs.rst:1076 msgid "an IBM EBCDIC code page" msgstr "" -#: ../../library/codecs.rst:1070 +#: ../../library/codecs.rst:1078 msgid "an IBM PC code page, which is ASCII compatible" msgstr "" -#: ../../library/codecs.rst:1075 ../../library/codecs.rst:1331 -#: ../../library/codecs.rst:1399 ../../library/codecs.rst:1454 +#: ../../library/codecs.rst:1083 ../../library/codecs.rst:1339 +#: ../../library/codecs.rst:1407 ../../library/codecs.rst:1462 msgid "Codec" msgstr "" -#: ../../library/codecs.rst:1075 ../../library/codecs.rst:1331 -#: ../../library/codecs.rst:1399 ../../library/codecs.rst:1454 +#: ../../library/codecs.rst:1083 ../../library/codecs.rst:1339 +#: ../../library/codecs.rst:1407 ../../library/codecs.rst:1462 msgid "Aliases" msgstr "" -#: ../../library/codecs.rst:1075 +#: ../../library/codecs.rst:1083 msgid "Languages" msgstr "語言" -#: ../../library/codecs.rst:1077 +#: ../../library/codecs.rst:1085 msgid "ascii" msgstr "ascii" -#: ../../library/codecs.rst:1077 +#: ../../library/codecs.rst:1085 msgid "646, us-ascii" msgstr "646, us-ascii" -#: ../../library/codecs.rst:1077 ../../library/codecs.rst:1083 -#: ../../library/codecs.rst:1091 +#: ../../library/codecs.rst:1085 ../../library/codecs.rst:1091 +#: ../../library/codecs.rst:1099 msgid "English" msgstr "英文" -#: ../../library/codecs.rst:1079 +#: ../../library/codecs.rst:1087 msgid "big5" msgstr "big5" -#: ../../library/codecs.rst:1079 +#: ../../library/codecs.rst:1087 msgid "big5-tw, csbig5" msgstr "big5-tw, csbig5" -#: ../../library/codecs.rst:1079 ../../library/codecs.rst:1081 -#: ../../library/codecs.rst:1140 +#: ../../library/codecs.rst:1087 ../../library/codecs.rst:1089 +#: ../../library/codecs.rst:1148 msgid "Traditional Chinese" msgstr "繁體中文" -#: ../../library/codecs.rst:1081 +#: ../../library/codecs.rst:1089 msgid "big5hkscs" msgstr "big5hkscs" -#: ../../library/codecs.rst:1081 +#: ../../library/codecs.rst:1089 msgid "big5-hkscs, hkscs" msgstr "big5-hkscs, hkscs" -#: ../../library/codecs.rst:1083 +#: ../../library/codecs.rst:1091 msgid "cp037" msgstr "cp037" -#: ../../library/codecs.rst:1083 +#: ../../library/codecs.rst:1091 msgid "IBM037, IBM039" msgstr "IBM037, IBM039" -#: ../../library/codecs.rst:1085 +#: ../../library/codecs.rst:1093 msgid "cp273" msgstr "cp273" -#: ../../library/codecs.rst:1085 +#: ../../library/codecs.rst:1093 msgid "273, IBM273, csIBM273" msgstr "273, IBM273, csIBM273" -#: ../../library/codecs.rst:1085 +#: ../../library/codecs.rst:1093 msgid "German" msgstr "德文" -#: ../../library/codecs.rst:1089 +#: ../../library/codecs.rst:1097 msgid "cp424" msgstr "cp424" -#: ../../library/codecs.rst:1089 +#: ../../library/codecs.rst:1097 msgid "EBCDIC-CP-HE, IBM424" msgstr "EBCDIC-CP-HE, IBM424" -#: ../../library/codecs.rst:1089 ../../library/codecs.rst:1109 -#: ../../library/codecs.rst:1119 ../../library/codecs.rst:1163 -#: ../../library/codecs.rst:1226 +#: ../../library/codecs.rst:1097 ../../library/codecs.rst:1117 +#: ../../library/codecs.rst:1127 ../../library/codecs.rst:1171 +#: ../../library/codecs.rst:1234 msgid "Hebrew" msgstr "希伯來文" -#: ../../library/codecs.rst:1091 +#: ../../library/codecs.rst:1099 msgid "cp437" msgstr "cp437" -#: ../../library/codecs.rst:1091 +#: ../../library/codecs.rst:1099 msgid "437, IBM437" msgstr "437, IBM437" -#: ../../library/codecs.rst:1093 +#: ../../library/codecs.rst:1101 msgid "cp500" msgstr "cp500" -#: ../../library/codecs.rst:1093 +#: ../../library/codecs.rst:1101 msgid "EBCDIC-CP-BE, EBCDIC-CP-CH, IBM500" msgstr "EBCDIC-CP-BE, EBCDIC-CP-CH, IBM500" -#: ../../library/codecs.rst:1093 ../../library/codecs.rst:1102 -#: ../../library/codecs.rst:1113 ../../library/codecs.rst:1150 -#: ../../library/codecs.rst:1157 ../../library/codecs.rst:1210 -#: ../../library/codecs.rst:1238 ../../library/codecs.rst:1266 +#: ../../library/codecs.rst:1101 ../../library/codecs.rst:1110 +#: ../../library/codecs.rst:1121 ../../library/codecs.rst:1158 +#: ../../library/codecs.rst:1165 ../../library/codecs.rst:1218 +#: ../../library/codecs.rst:1246 ../../library/codecs.rst:1274 msgid "Western Europe" msgstr "" -#: ../../library/codecs.rst:1096 +#: ../../library/codecs.rst:1104 msgid "cp720" msgstr "cp720" -#: ../../library/codecs.rst:1096 ../../library/codecs.rst:1123 -#: ../../library/codecs.rst:1165 ../../library/codecs.rst:1222 +#: ../../library/codecs.rst:1104 ../../library/codecs.rst:1131 +#: ../../library/codecs.rst:1173 ../../library/codecs.rst:1230 msgid "Arabic" msgstr "阿拉伯文" -#: ../../library/codecs.rst:1098 +#: ../../library/codecs.rst:1106 msgid "cp737" msgstr "cp737" -#: ../../library/codecs.rst:1098 ../../library/codecs.rst:1129 -#: ../../library/codecs.rst:1133 ../../library/codecs.rst:1159 -#: ../../library/codecs.rst:1224 ../../library/codecs.rst:1259 +#: ../../library/codecs.rst:1106 ../../library/codecs.rst:1137 +#: ../../library/codecs.rst:1141 ../../library/codecs.rst:1167 +#: ../../library/codecs.rst:1232 ../../library/codecs.rst:1267 msgid "Greek" msgstr "希臘文" -#: ../../library/codecs.rst:1100 +#: ../../library/codecs.rst:1108 msgid "cp775" msgstr "cp775" -#: ../../library/codecs.rst:1100 +#: ../../library/codecs.rst:1108 msgid "IBM775" msgstr "IBM775" -#: ../../library/codecs.rst:1100 ../../library/codecs.rst:1167 -#: ../../library/codecs.rst:1217 ../../library/codecs.rst:1234 +#: ../../library/codecs.rst:1108 ../../library/codecs.rst:1175 +#: ../../library/codecs.rst:1225 ../../library/codecs.rst:1242 msgid "Baltic languages" msgstr "" -#: ../../library/codecs.rst:1102 +#: ../../library/codecs.rst:1110 msgid "cp850" msgstr "cp850" -#: ../../library/codecs.rst:1102 +#: ../../library/codecs.rst:1110 msgid "850, IBM850" msgstr "850, IBM850" -#: ../../library/codecs.rst:1104 +#: ../../library/codecs.rst:1112 msgid "cp852" msgstr "cp852" -#: ../../library/codecs.rst:1104 +#: ../../library/codecs.rst:1112 msgid "852, IBM852" msgstr "852, IBM852" -#: ../../library/codecs.rst:1104 ../../library/codecs.rst:1152 -#: ../../library/codecs.rst:1213 ../../library/codecs.rst:1263 +#: ../../library/codecs.rst:1112 ../../library/codecs.rst:1160 +#: ../../library/codecs.rst:1221 ../../library/codecs.rst:1271 msgid "Central and Eastern Europe" msgstr "" -#: ../../library/codecs.rst:1106 +#: ../../library/codecs.rst:1114 msgid "cp855" msgstr "cp855" -#: ../../library/codecs.rst:1106 +#: ../../library/codecs.rst:1114 msgid "855, IBM855" msgstr "855, IBM855" -#: ../../library/codecs.rst:1106 ../../library/codecs.rst:1154 -#: ../../library/codecs.rst:1219 ../../library/codecs.rst:1256 +#: ../../library/codecs.rst:1114 ../../library/codecs.rst:1162 +#: ../../library/codecs.rst:1227 ../../library/codecs.rst:1264 msgid "Belarusian, Bulgarian, Macedonian, Russian, Serbian" msgstr "" -#: ../../library/codecs.rst:1109 +#: ../../library/codecs.rst:1117 msgid "cp856" msgstr "cp856" -#: ../../library/codecs.rst:1111 +#: ../../library/codecs.rst:1119 msgid "cp857" msgstr "cp857" -#: ../../library/codecs.rst:1111 +#: ../../library/codecs.rst:1119 msgid "857, IBM857" msgstr "857, IBM857" -#: ../../library/codecs.rst:1111 ../../library/codecs.rst:1144 -#: ../../library/codecs.rst:1161 ../../library/codecs.rst:1228 -#: ../../library/codecs.rst:1268 +#: ../../library/codecs.rst:1119 ../../library/codecs.rst:1152 +#: ../../library/codecs.rst:1169 ../../library/codecs.rst:1236 +#: ../../library/codecs.rst:1276 msgid "Turkish" msgstr "土耳其文" -#: ../../library/codecs.rst:1113 +#: ../../library/codecs.rst:1121 msgid "cp858" msgstr "cp858" -#: ../../library/codecs.rst:1113 +#: ../../library/codecs.rst:1121 msgid "858, IBM858" msgstr "858, IBM858" -#: ../../library/codecs.rst:1115 +#: ../../library/codecs.rst:1123 msgid "cp860" msgstr "cp860" -#: ../../library/codecs.rst:1115 +#: ../../library/codecs.rst:1123 msgid "860, IBM860" msgstr "860, IBM860" -#: ../../library/codecs.rst:1115 +#: ../../library/codecs.rst:1123 msgid "Portuguese" msgstr "" -#: ../../library/codecs.rst:1117 +#: ../../library/codecs.rst:1125 msgid "cp861" msgstr "cp861" -#: ../../library/codecs.rst:1117 +#: ../../library/codecs.rst:1125 msgid "861, CP-IS, IBM861" msgstr "861, CP-IS, IBM861" -#: ../../library/codecs.rst:1117 ../../library/codecs.rst:1261 +#: ../../library/codecs.rst:1125 ../../library/codecs.rst:1269 msgid "Icelandic" msgstr "" -#: ../../library/codecs.rst:1119 +#: ../../library/codecs.rst:1127 msgid "cp862" msgstr "cp862" -#: ../../library/codecs.rst:1119 +#: ../../library/codecs.rst:1127 msgid "862, IBM862" msgstr "862, IBM862" -#: ../../library/codecs.rst:1121 +#: ../../library/codecs.rst:1129 msgid "cp863" msgstr "cp863" -#: ../../library/codecs.rst:1121 +#: ../../library/codecs.rst:1129 msgid "863, IBM863" msgstr "863, IBM863" -#: ../../library/codecs.rst:1121 +#: ../../library/codecs.rst:1129 msgid "Canadian" msgstr "" -#: ../../library/codecs.rst:1123 +#: ../../library/codecs.rst:1131 msgid "cp864" msgstr "cp864" -#: ../../library/codecs.rst:1123 +#: ../../library/codecs.rst:1131 msgid "IBM864" msgstr "IBM864" -#: ../../library/codecs.rst:1125 +#: ../../library/codecs.rst:1133 msgid "cp865" msgstr "cp865" -#: ../../library/codecs.rst:1125 +#: ../../library/codecs.rst:1133 msgid "865, IBM865" msgstr "865, IBM865" -#: ../../library/codecs.rst:1125 +#: ../../library/codecs.rst:1133 msgid "Danish, Norwegian" msgstr "" -#: ../../library/codecs.rst:1127 +#: ../../library/codecs.rst:1135 msgid "cp866" msgstr "cp866" -#: ../../library/codecs.rst:1127 +#: ../../library/codecs.rst:1135 msgid "866, IBM866" msgstr "866, IBM866" -#: ../../library/codecs.rst:1127 ../../library/codecs.rst:1244 +#: ../../library/codecs.rst:1135 ../../library/codecs.rst:1252 msgid "Russian" msgstr "俄羅斯文" -#: ../../library/codecs.rst:1129 +#: ../../library/codecs.rst:1137 msgid "cp869" msgstr "cp869" -#: ../../library/codecs.rst:1129 +#: ../../library/codecs.rst:1137 msgid "869, CP-GR, IBM869" msgstr "869, CP-GR, IBM869" -#: ../../library/codecs.rst:1131 +#: ../../library/codecs.rst:1139 msgid "cp874" msgstr "cp874" -#: ../../library/codecs.rst:1131 +#: ../../library/codecs.rst:1139 msgid "Thai" msgstr "泰文" -#: ../../library/codecs.rst:1133 +#: ../../library/codecs.rst:1141 msgid "cp875" msgstr "cp875" -#: ../../library/codecs.rst:1135 +#: ../../library/codecs.rst:1143 msgid "cp932" msgstr "cp932" -#: ../../library/codecs.rst:1135 +#: ../../library/codecs.rst:1143 msgid "932, ms932, mskanji, ms-kanji, windows-31j" msgstr "932, ms932, mskanji, ms-kanji, windows-31j" -#: ../../library/codecs.rst:1135 ../../library/codecs.rst:1171 -#: ../../library/codecs.rst:1173 ../../library/codecs.rst:1175 -#: ../../library/codecs.rst:1192 ../../library/codecs.rst:1195 +#: ../../library/codecs.rst:1143 ../../library/codecs.rst:1179 +#: ../../library/codecs.rst:1181 ../../library/codecs.rst:1183 #: ../../library/codecs.rst:1200 ../../library/codecs.rst:1203 -#: ../../library/codecs.rst:1205 ../../library/codecs.rst:1273 -#: ../../library/codecs.rst:1276 ../../library/codecs.rst:1279 +#: ../../library/codecs.rst:1208 ../../library/codecs.rst:1211 +#: ../../library/codecs.rst:1213 ../../library/codecs.rst:1281 +#: ../../library/codecs.rst:1284 ../../library/codecs.rst:1287 msgid "Japanese" msgstr "日文" -#: ../../library/codecs.rst:1138 +#: ../../library/codecs.rst:1146 msgid "cp949" msgstr "cp949" -#: ../../library/codecs.rst:1138 +#: ../../library/codecs.rst:1146 msgid "949, ms949, uhc" msgstr "949, ms949, uhc" -#: ../../library/codecs.rst:1138 ../../library/codecs.rst:1177 -#: ../../library/codecs.rst:1207 ../../library/codecs.rst:1242 +#: ../../library/codecs.rst:1146 ../../library/codecs.rst:1185 +#: ../../library/codecs.rst:1215 ../../library/codecs.rst:1250 msgid "Korean" msgstr "韓文" -#: ../../library/codecs.rst:1140 +#: ../../library/codecs.rst:1148 msgid "cp950" msgstr "cp950" -#: ../../library/codecs.rst:1140 +#: ../../library/codecs.rst:1148 msgid "950, ms950" msgstr "950, ms950" -#: ../../library/codecs.rst:1142 +#: ../../library/codecs.rst:1150 msgid "cp1006" msgstr "cp1006" -#: ../../library/codecs.rst:1142 +#: ../../library/codecs.rst:1150 msgid "Urdu" msgstr "" -#: ../../library/codecs.rst:1144 +#: ../../library/codecs.rst:1152 msgid "cp1026" msgstr "cp1026" -#: ../../library/codecs.rst:1144 +#: ../../library/codecs.rst:1152 msgid "ibm1026" msgstr "ibm1026" -#: ../../library/codecs.rst:1146 +#: ../../library/codecs.rst:1154 msgid "cp1125" msgstr "cp1125" -#: ../../library/codecs.rst:1146 +#: ../../library/codecs.rst:1154 msgid "1125, ibm1125, cp866u, ruscii" msgstr "1125, ibm1125, cp866u, ruscii" -#: ../../library/codecs.rst:1146 ../../library/codecs.rst:1250 +#: ../../library/codecs.rst:1154 ../../library/codecs.rst:1258 msgid "Ukrainian" msgstr "烏克蘭文" -#: ../../library/codecs.rst:1150 +#: ../../library/codecs.rst:1158 msgid "cp1140" msgstr "cp1140" -#: ../../library/codecs.rst:1150 +#: ../../library/codecs.rst:1158 msgid "ibm1140" msgstr "ibm1140" -#: ../../library/codecs.rst:1152 +#: ../../library/codecs.rst:1160 msgid "cp1250" msgstr "cp1250" -#: ../../library/codecs.rst:1152 +#: ../../library/codecs.rst:1160 msgid "windows-1250" msgstr "windows-1250" -#: ../../library/codecs.rst:1154 +#: ../../library/codecs.rst:1162 msgid "cp1251" msgstr "cp1251" -#: ../../library/codecs.rst:1154 +#: ../../library/codecs.rst:1162 msgid "windows-1251" msgstr "windows-1251" -#: ../../library/codecs.rst:1157 +#: ../../library/codecs.rst:1165 msgid "cp1252" msgstr "cp1252" -#: ../../library/codecs.rst:1157 +#: ../../library/codecs.rst:1165 msgid "windows-1252" msgstr "windows-1252" -#: ../../library/codecs.rst:1159 +#: ../../library/codecs.rst:1167 msgid "cp1253" msgstr "cp1253" -#: ../../library/codecs.rst:1159 +#: ../../library/codecs.rst:1167 msgid "windows-1253" msgstr "windows-1253" -#: ../../library/codecs.rst:1161 +#: ../../library/codecs.rst:1169 msgid "cp1254" msgstr "cp1254" -#: ../../library/codecs.rst:1161 +#: ../../library/codecs.rst:1169 msgid "windows-1254" msgstr "windows-1254" -#: ../../library/codecs.rst:1163 +#: ../../library/codecs.rst:1171 msgid "cp1255" msgstr "cp1255" -#: ../../library/codecs.rst:1163 +#: ../../library/codecs.rst:1171 msgid "windows-1255" msgstr "windows-1255" -#: ../../library/codecs.rst:1165 +#: ../../library/codecs.rst:1173 msgid "cp1256" msgstr "cp1256" -#: ../../library/codecs.rst:1165 +#: ../../library/codecs.rst:1173 msgid "windows-1256" msgstr "windows-1256" -#: ../../library/codecs.rst:1167 +#: ../../library/codecs.rst:1175 msgid "cp1257" msgstr "cp1257" -#: ../../library/codecs.rst:1167 +#: ../../library/codecs.rst:1175 msgid "windows-1257" msgstr "windows-1257" -#: ../../library/codecs.rst:1169 +#: ../../library/codecs.rst:1177 msgid "cp1258" msgstr "cp1258" -#: ../../library/codecs.rst:1169 +#: ../../library/codecs.rst:1177 msgid "windows-1258" msgstr "windows-1258" -#: ../../library/codecs.rst:1169 +#: ../../library/codecs.rst:1177 msgid "Vietnamese" msgstr "越南文" -#: ../../library/codecs.rst:1171 +#: ../../library/codecs.rst:1179 msgid "euc_jp" msgstr "euc_jp" -#: ../../library/codecs.rst:1171 +#: ../../library/codecs.rst:1179 msgid "eucjp, ujis, u-jis" msgstr "eucjp, ujis, u-jis" -#: ../../library/codecs.rst:1173 +#: ../../library/codecs.rst:1181 msgid "euc_jis_2004" msgstr "euc_jis_2004" -#: ../../library/codecs.rst:1173 +#: ../../library/codecs.rst:1181 msgid "jisx0213, eucjis2004" msgstr "jisx0213, eucjis2004" -#: ../../library/codecs.rst:1175 +#: ../../library/codecs.rst:1183 msgid "euc_jisx0213" msgstr "euc_jisx0213" -#: ../../library/codecs.rst:1175 +#: ../../library/codecs.rst:1183 msgid "eucjisx0213" msgstr "eucjisx0213" -#: ../../library/codecs.rst:1177 +#: ../../library/codecs.rst:1185 msgid "euc_kr" msgstr "euc_kr" -#: ../../library/codecs.rst:1177 +#: ../../library/codecs.rst:1185 msgid "euckr, korean, ksc5601, ks_c-5601, ks_c-5601-1987, ksx1001, ks_x-1001" msgstr "euckr, korean, ksc5601, ks_c-5601, ks_c-5601-1987, ksx1001, ks_x-1001" -#: ../../library/codecs.rst:1181 +#: ../../library/codecs.rst:1189 msgid "gb2312" msgstr "gb2312" -#: ../../library/codecs.rst:1181 +#: ../../library/codecs.rst:1189 msgid "" "chinese, csiso58gb231280, euc-cn, euccn, eucgb2312-cn, gb2312-1980, " "gb2312-80, iso-ir-58" @@ -1856,446 +1865,446 @@ msgstr "" "chinese, csiso58gb231280, euc-cn, euccn, eucgb2312-cn, gb2312-1980, " "gb2312-80, iso-ir-58" -#: ../../library/codecs.rst:1181 ../../library/codecs.rst:1190 +#: ../../library/codecs.rst:1189 ../../library/codecs.rst:1198 msgid "Simplified Chinese" msgstr "簡體中文" -#: ../../library/codecs.rst:1186 +#: ../../library/codecs.rst:1194 msgid "gbk" msgstr "gbk" -#: ../../library/codecs.rst:1186 +#: ../../library/codecs.rst:1194 msgid "936, cp936, ms936" msgstr "936, cp936, ms936" -#: ../../library/codecs.rst:1186 ../../library/codecs.rst:1188 +#: ../../library/codecs.rst:1194 ../../library/codecs.rst:1196 msgid "Unified Chinese" msgstr "" -#: ../../library/codecs.rst:1188 +#: ../../library/codecs.rst:1196 msgid "gb18030" msgstr "gb18030" -#: ../../library/codecs.rst:1188 +#: ../../library/codecs.rst:1196 msgid "gb18030-2000" msgstr "gb18030-2000" -#: ../../library/codecs.rst:1190 +#: ../../library/codecs.rst:1198 msgid "hz" msgstr "hz" -#: ../../library/codecs.rst:1190 +#: ../../library/codecs.rst:1198 msgid "hzgb, hz-gb, hz-gb-2312" msgstr "hzgb, hz-gb, hz-gb-2312" -#: ../../library/codecs.rst:1192 +#: ../../library/codecs.rst:1200 msgid "iso2022_jp" msgstr "iso2022_jp" -#: ../../library/codecs.rst:1192 +#: ../../library/codecs.rst:1200 msgid "csiso2022jp, iso2022jp, iso-2022-jp" msgstr "csiso2022jp, iso2022jp, iso-2022-jp" -#: ../../library/codecs.rst:1195 +#: ../../library/codecs.rst:1203 msgid "iso2022_jp_1" msgstr "iso2022_jp_1" -#: ../../library/codecs.rst:1195 +#: ../../library/codecs.rst:1203 msgid "iso2022jp-1, iso-2022-jp-1" msgstr "iso2022jp-1, iso-2022-jp-1" -#: ../../library/codecs.rst:1197 +#: ../../library/codecs.rst:1205 msgid "iso2022_jp_2" msgstr "iso2022_jp_2" -#: ../../library/codecs.rst:1197 +#: ../../library/codecs.rst:1205 msgid "iso2022jp-2, iso-2022-jp-2" msgstr "iso2022jp-2, iso-2022-jp-2" -#: ../../library/codecs.rst:1197 +#: ../../library/codecs.rst:1205 msgid "Japanese, Korean, Simplified Chinese, Western Europe, Greek" msgstr "" -#: ../../library/codecs.rst:1200 +#: ../../library/codecs.rst:1208 msgid "iso2022_jp_2004" msgstr "iso2022_jp_2004" -#: ../../library/codecs.rst:1200 +#: ../../library/codecs.rst:1208 msgid "iso2022jp-2004, iso-2022-jp-2004" msgstr "iso2022jp-2004, iso-2022-jp-2004" -#: ../../library/codecs.rst:1203 +#: ../../library/codecs.rst:1211 msgid "iso2022_jp_3" msgstr "iso2022_jp_3" -#: ../../library/codecs.rst:1203 +#: ../../library/codecs.rst:1211 msgid "iso2022jp-3, iso-2022-jp-3" msgstr "iso2022jp-3, iso-2022-jp-3" -#: ../../library/codecs.rst:1205 +#: ../../library/codecs.rst:1213 msgid "iso2022_jp_ext" msgstr "iso2022_jp_ext" -#: ../../library/codecs.rst:1205 +#: ../../library/codecs.rst:1213 msgid "iso2022jp-ext, iso-2022-jp-ext" msgstr "iso2022jp-ext, iso-2022-jp-ext" -#: ../../library/codecs.rst:1207 +#: ../../library/codecs.rst:1215 msgid "iso2022_kr" msgstr "iso2022_kr" -#: ../../library/codecs.rst:1207 +#: ../../library/codecs.rst:1215 msgid "csiso2022kr, iso2022kr, iso-2022-kr" msgstr "csiso2022kr, iso2022kr, iso-2022-kr" -#: ../../library/codecs.rst:1210 +#: ../../library/codecs.rst:1218 msgid "latin_1" msgstr "latin_1" -#: ../../library/codecs.rst:1210 +#: ../../library/codecs.rst:1218 msgid "iso-8859-1, iso8859-1, 8859, cp819, latin, latin1, L1" msgstr "iso-8859-1, iso8859-1, 8859, cp819, latin, latin1, L1" -#: ../../library/codecs.rst:1213 +#: ../../library/codecs.rst:1221 msgid "iso8859_2" msgstr "iso8859_2" -#: ../../library/codecs.rst:1213 +#: ../../library/codecs.rst:1221 msgid "iso-8859-2, latin2, L2" msgstr "iso-8859-2, latin2, L2" -#: ../../library/codecs.rst:1215 +#: ../../library/codecs.rst:1223 msgid "iso8859_3" msgstr "iso8859_3" -#: ../../library/codecs.rst:1215 +#: ../../library/codecs.rst:1223 msgid "iso-8859-3, latin3, L3" msgstr "iso-8859-3, latin3, L3" -#: ../../library/codecs.rst:1215 +#: ../../library/codecs.rst:1223 msgid "Esperanto, Maltese" msgstr "" -#: ../../library/codecs.rst:1217 +#: ../../library/codecs.rst:1225 msgid "iso8859_4" msgstr "iso8859_4" -#: ../../library/codecs.rst:1217 +#: ../../library/codecs.rst:1225 msgid "iso-8859-4, latin4, L4" msgstr "iso-8859-4, latin4, L4" -#: ../../library/codecs.rst:1219 +#: ../../library/codecs.rst:1227 msgid "iso8859_5" msgstr "iso8859_5" -#: ../../library/codecs.rst:1219 +#: ../../library/codecs.rst:1227 msgid "iso-8859-5, cyrillic" msgstr "iso-8859-5, cyrillic" -#: ../../library/codecs.rst:1222 +#: ../../library/codecs.rst:1230 msgid "iso8859_6" msgstr "iso8859_6" -#: ../../library/codecs.rst:1222 +#: ../../library/codecs.rst:1230 msgid "iso-8859-6, arabic" msgstr "iso-8859-6, arabic" -#: ../../library/codecs.rst:1224 +#: ../../library/codecs.rst:1232 msgid "iso8859_7" msgstr "iso8859_7" -#: ../../library/codecs.rst:1224 +#: ../../library/codecs.rst:1232 msgid "iso-8859-7, greek, greek8" msgstr "iso-8859-7, greek, greek8" -#: ../../library/codecs.rst:1226 +#: ../../library/codecs.rst:1234 msgid "iso8859_8" msgstr "iso8859_8" -#: ../../library/codecs.rst:1226 +#: ../../library/codecs.rst:1234 msgid "iso-8859-8, hebrew" msgstr "iso-8859-8, hebrew" -#: ../../library/codecs.rst:1228 +#: ../../library/codecs.rst:1236 msgid "iso8859_9" msgstr "iso8859_9" -#: ../../library/codecs.rst:1228 +#: ../../library/codecs.rst:1236 msgid "iso-8859-9, latin5, L5" msgstr "iso-8859-9, latin5, L5" -#: ../../library/codecs.rst:1230 +#: ../../library/codecs.rst:1238 msgid "iso8859_10" msgstr "iso8859_10" -#: ../../library/codecs.rst:1230 +#: ../../library/codecs.rst:1238 msgid "iso-8859-10, latin6, L6" msgstr "iso-8859-10, latin6, L6" -#: ../../library/codecs.rst:1230 +#: ../../library/codecs.rst:1238 msgid "Nordic languages" msgstr "" -#: ../../library/codecs.rst:1232 +#: ../../library/codecs.rst:1240 msgid "iso8859_11" msgstr "iso8859_11" -#: ../../library/codecs.rst:1232 +#: ../../library/codecs.rst:1240 msgid "iso-8859-11, thai" msgstr "iso-8859-11, thai" -#: ../../library/codecs.rst:1232 +#: ../../library/codecs.rst:1240 msgid "Thai languages" msgstr "泰語" -#: ../../library/codecs.rst:1234 +#: ../../library/codecs.rst:1242 msgid "iso8859_13" msgstr "iso8859_13" -#: ../../library/codecs.rst:1234 +#: ../../library/codecs.rst:1242 msgid "iso-8859-13, latin7, L7" msgstr "iso-8859-13, latin7, L7" -#: ../../library/codecs.rst:1236 +#: ../../library/codecs.rst:1244 msgid "iso8859_14" msgstr "iso8859_14" -#: ../../library/codecs.rst:1236 +#: ../../library/codecs.rst:1244 msgid "iso-8859-14, latin8, L8" msgstr "iso-8859-14, latin8, L8" -#: ../../library/codecs.rst:1236 +#: ../../library/codecs.rst:1244 msgid "Celtic languages" msgstr "" -#: ../../library/codecs.rst:1238 +#: ../../library/codecs.rst:1246 msgid "iso8859_15" msgstr "iso8859_15" -#: ../../library/codecs.rst:1238 +#: ../../library/codecs.rst:1246 msgid "iso-8859-15, latin9, L9" msgstr "iso-8859-15, latin9, L9" -#: ../../library/codecs.rst:1240 +#: ../../library/codecs.rst:1248 msgid "iso8859_16" msgstr "iso8859_16" -#: ../../library/codecs.rst:1240 +#: ../../library/codecs.rst:1248 msgid "iso-8859-16, latin10, L10" msgstr "iso-8859-16, latin10, L10" -#: ../../library/codecs.rst:1240 +#: ../../library/codecs.rst:1248 msgid "South-Eastern Europe" msgstr "" -#: ../../library/codecs.rst:1242 +#: ../../library/codecs.rst:1250 msgid "johab" msgstr "" -#: ../../library/codecs.rst:1242 +#: ../../library/codecs.rst:1250 msgid "cp1361, ms1361" msgstr "cp1361, ms1361" -#: ../../library/codecs.rst:1244 +#: ../../library/codecs.rst:1252 msgid "koi8_r" msgstr "koi8_r" -#: ../../library/codecs.rst:1246 +#: ../../library/codecs.rst:1254 msgid "koi8_t" msgstr "koi8_t" -#: ../../library/codecs.rst:1246 +#: ../../library/codecs.rst:1254 msgid "Tajik" msgstr "" -#: ../../library/codecs.rst:1250 +#: ../../library/codecs.rst:1258 msgid "koi8_u" msgstr "koi8_u" -#: ../../library/codecs.rst:1252 +#: ../../library/codecs.rst:1260 msgid "kz1048" msgstr "kz1048" -#: ../../library/codecs.rst:1252 +#: ../../library/codecs.rst:1260 msgid "kz_1048, strk1048_2002, rk1048" msgstr "kz_1048, strk1048_2002, rk1048" -#: ../../library/codecs.rst:1252 ../../library/codecs.rst:1270 +#: ../../library/codecs.rst:1260 ../../library/codecs.rst:1278 msgid "Kazakh" msgstr "" -#: ../../library/codecs.rst:1256 +#: ../../library/codecs.rst:1264 msgid "mac_cyrillic" msgstr "mac_cyrillic" -#: ../../library/codecs.rst:1256 +#: ../../library/codecs.rst:1264 msgid "maccyrillic" msgstr "" -#: ../../library/codecs.rst:1259 +#: ../../library/codecs.rst:1267 msgid "mac_greek" msgstr "mac_greek" -#: ../../library/codecs.rst:1259 +#: ../../library/codecs.rst:1267 msgid "macgreek" msgstr "" -#: ../../library/codecs.rst:1261 +#: ../../library/codecs.rst:1269 msgid "mac_iceland" msgstr "mac_iceland" -#: ../../library/codecs.rst:1261 +#: ../../library/codecs.rst:1269 msgid "maciceland" msgstr "" -#: ../../library/codecs.rst:1263 +#: ../../library/codecs.rst:1271 msgid "mac_latin2" msgstr "mac_latin2" -#: ../../library/codecs.rst:1263 +#: ../../library/codecs.rst:1271 msgid "maclatin2, maccentraleurope, mac_centeuro" msgstr "maclatin2, maccentraleurope, mac_centeuro" -#: ../../library/codecs.rst:1266 +#: ../../library/codecs.rst:1274 msgid "mac_roman" msgstr "mac_roman" -#: ../../library/codecs.rst:1266 +#: ../../library/codecs.rst:1274 msgid "macroman, macintosh" msgstr "macroman, macintosh" -#: ../../library/codecs.rst:1268 +#: ../../library/codecs.rst:1276 msgid "mac_turkish" msgstr "mac_turkish" -#: ../../library/codecs.rst:1268 +#: ../../library/codecs.rst:1276 msgid "macturkish" msgstr "" -#: ../../library/codecs.rst:1270 +#: ../../library/codecs.rst:1278 msgid "ptcp154" msgstr "ptcp154" -#: ../../library/codecs.rst:1270 +#: ../../library/codecs.rst:1278 msgid "csptcp154, pt154, cp154, cyrillic-asian" msgstr "csptcp154, pt154, cp154, cyrillic-asian" -#: ../../library/codecs.rst:1273 +#: ../../library/codecs.rst:1281 msgid "shift_jis" msgstr "shift_jis" -#: ../../library/codecs.rst:1273 +#: ../../library/codecs.rst:1281 msgid "csshiftjis, shiftjis, sjis, s_jis" msgstr "csshiftjis, shiftjis, sjis, s_jis" -#: ../../library/codecs.rst:1276 +#: ../../library/codecs.rst:1284 msgid "shift_jis_2004" msgstr "shift_jis_2004" -#: ../../library/codecs.rst:1276 +#: ../../library/codecs.rst:1284 msgid "shiftjis2004, sjis_2004, sjis2004" msgstr "shiftjis2004, sjis_2004, sjis2004" -#: ../../library/codecs.rst:1279 +#: ../../library/codecs.rst:1287 msgid "shift_jisx0213" msgstr "shift_jisx0213" -#: ../../library/codecs.rst:1279 +#: ../../library/codecs.rst:1287 msgid "shiftjisx0213, sjisx0213, s_jisx0213" msgstr "shiftjisx0213, sjisx0213, s_jisx0213" -#: ../../library/codecs.rst:1282 +#: ../../library/codecs.rst:1290 msgid "utf_32" msgstr "utf_32" -#: ../../library/codecs.rst:1282 +#: ../../library/codecs.rst:1290 msgid "U32, utf32" msgstr "U32, utf32" -#: ../../library/codecs.rst:1282 ../../library/codecs.rst:1284 -#: ../../library/codecs.rst:1286 ../../library/codecs.rst:1288 #: ../../library/codecs.rst:1290 ../../library/codecs.rst:1292 #: ../../library/codecs.rst:1294 ../../library/codecs.rst:1296 -#: ../../library/codecs.rst:1298 +#: ../../library/codecs.rst:1298 ../../library/codecs.rst:1300 +#: ../../library/codecs.rst:1302 ../../library/codecs.rst:1304 +#: ../../library/codecs.rst:1306 msgid "all languages" msgstr "" -#: ../../library/codecs.rst:1284 +#: ../../library/codecs.rst:1292 msgid "utf_32_be" msgstr "utf_32_be" -#: ../../library/codecs.rst:1284 +#: ../../library/codecs.rst:1292 msgid "UTF-32BE" msgstr "UTF-32BE" -#: ../../library/codecs.rst:1286 +#: ../../library/codecs.rst:1294 msgid "utf_32_le" msgstr "utf_32_le" -#: ../../library/codecs.rst:1286 +#: ../../library/codecs.rst:1294 msgid "UTF-32LE" msgstr "UTF-32LE" -#: ../../library/codecs.rst:1288 +#: ../../library/codecs.rst:1296 msgid "utf_16" msgstr "utf_16" -#: ../../library/codecs.rst:1288 +#: ../../library/codecs.rst:1296 msgid "U16, utf16" msgstr "U16, utf16" -#: ../../library/codecs.rst:1290 +#: ../../library/codecs.rst:1298 msgid "utf_16_be" msgstr "utf_16_be" -#: ../../library/codecs.rst:1290 +#: ../../library/codecs.rst:1298 msgid "UTF-16BE" msgstr "UTF-16BE" -#: ../../library/codecs.rst:1292 +#: ../../library/codecs.rst:1300 msgid "utf_16_le" msgstr "utf_16_le" -#: ../../library/codecs.rst:1292 +#: ../../library/codecs.rst:1300 msgid "UTF-16LE" msgstr "UTF-16LE" -#: ../../library/codecs.rst:1294 +#: ../../library/codecs.rst:1302 msgid "utf_7" msgstr "utf_7" -#: ../../library/codecs.rst:1294 +#: ../../library/codecs.rst:1302 msgid "U7, unicode-1-1-utf-7" msgstr "U7, unicode-1-1-utf-7" -#: ../../library/codecs.rst:1296 +#: ../../library/codecs.rst:1304 msgid "utf_8" msgstr "utf_8" -#: ../../library/codecs.rst:1296 +#: ../../library/codecs.rst:1304 msgid "U8, UTF, utf8, cp65001" msgstr "U8, UTF, utf8, cp65001" -#: ../../library/codecs.rst:1298 +#: ../../library/codecs.rst:1306 msgid "utf_8_sig" msgstr "utf_8_sig" -#: ../../library/codecs.rst:1301 +#: ../../library/codecs.rst:1309 msgid "" "The utf-16\\* and utf-32\\* encoders no longer allow surrogate code points " "(``U+D800``--``U+DFFF``) to be encoded. The utf-32\\* decoders no longer " "decode byte sequences that correspond to surrogate code points." msgstr "" -#: ../../library/codecs.rst:1307 +#: ../../library/codecs.rst:1315 msgid "``cp65001`` is now an alias to ``utf_8``." msgstr "" -#: ../../library/codecs.rst:1312 +#: ../../library/codecs.rst:1320 msgid "Python Specific Encodings" msgstr "" -#: ../../library/codecs.rst:1314 +#: ../../library/codecs.rst:1322 msgid "" "A number of predefined codecs are specific to Python, so their codec names " "have no meaning outside Python. These are listed in the tables below based " @@ -2305,268 +2314,268 @@ msgid "" "asymmetric codecs, the stated meaning describes the encoding direction." msgstr "" -#: ../../library/codecs.rst:1322 +#: ../../library/codecs.rst:1330 msgid "Text Encodings" msgstr "" -#: ../../library/codecs.rst:1324 +#: ../../library/codecs.rst:1332 msgid "" "The following codecs provide :class:`str` to :class:`bytes` encoding and :" "term:`bytes-like object` to :class:`str` decoding, similar to the Unicode " "text encodings." msgstr "" -#: ../../library/codecs.rst:1333 +#: ../../library/codecs.rst:1341 msgid "idna" msgstr "idna" -#: ../../library/codecs.rst:1333 +#: ../../library/codecs.rst:1341 msgid "" "Implement :rfc:`3490`, see also :mod:`encodings.idna`. Only " "``errors='strict'`` is supported." msgstr "" -#: ../../library/codecs.rst:1339 +#: ../../library/codecs.rst:1347 msgid "mbcs" msgstr "mbcs" -#: ../../library/codecs.rst:1339 +#: ../../library/codecs.rst:1347 msgid "ansi, dbcs" msgstr "ansi, dbcs" -#: ../../library/codecs.rst:1339 +#: ../../library/codecs.rst:1347 msgid "" "Windows only: Encode the operand according to the ANSI codepage (CP_ACP)." msgstr "" -#: ../../library/codecs.rst:1343 +#: ../../library/codecs.rst:1351 msgid "oem" msgstr "oem" -#: ../../library/codecs.rst:1343 +#: ../../library/codecs.rst:1351 msgid "" "Windows only: Encode the operand according to the OEM codepage (CP_OEMCP)." msgstr "" -#: ../../library/codecs.rst:1349 +#: ../../library/codecs.rst:1357 msgid "palmos" msgstr "" -#: ../../library/codecs.rst:1349 +#: ../../library/codecs.rst:1357 msgid "Encoding of PalmOS 3.5." msgstr "" -#: ../../library/codecs.rst:1351 +#: ../../library/codecs.rst:1359 msgid "punycode" msgstr "" -#: ../../library/codecs.rst:1351 +#: ../../library/codecs.rst:1359 msgid "Implement :rfc:`3492`. Stateful codecs are not supported." msgstr "" -#: ../../library/codecs.rst:1355 +#: ../../library/codecs.rst:1363 msgid "raw_unicode_escape" msgstr "raw_unicode_escape" -#: ../../library/codecs.rst:1355 +#: ../../library/codecs.rst:1363 msgid "" "Latin-1 encoding with :samp:`\\\\u{XXXX}` and :samp:`\\\\U{XXXXXXXX}` for " "other code points. Existing backslashes are not escaped in any way. It is " "used in the Python pickle protocol." msgstr "" -#: ../../library/codecs.rst:1365 +#: ../../library/codecs.rst:1373 msgid "undefined" msgstr "" -#: ../../library/codecs.rst:1365 +#: ../../library/codecs.rst:1373 msgid "" "Raise an exception for all conversions, even empty strings. The error " "handler is ignored." msgstr "" -#: ../../library/codecs.rst:1370 +#: ../../library/codecs.rst:1378 msgid "unicode_escape" msgstr "unicode_escape" -#: ../../library/codecs.rst:1370 +#: ../../library/codecs.rst:1378 msgid "" "Encoding suitable as the contents of a Unicode literal in ASCII-encoded " "Python source code, except that quotes are not escaped. Decode from Latin-1 " "source code. Beware that Python source code actually uses UTF-8 by default." msgstr "" -#: ../../library/codecs.rst:1382 +#: ../../library/codecs.rst:1390 msgid "\"unicode_internal\" codec is removed." msgstr "" -#: ../../library/codecs.rst:1389 +#: ../../library/codecs.rst:1397 msgid "Binary Transforms" msgstr "" -#: ../../library/codecs.rst:1391 +#: ../../library/codecs.rst:1399 msgid "" "The following codecs provide binary transforms: :term:`bytes-like object` " "to :class:`bytes` mappings. They are not supported by :meth:`bytes.decode` " "(which only produces :class:`str` output)." msgstr "" -#: ../../library/codecs.rst:1399 +#: ../../library/codecs.rst:1407 msgid "Encoder / decoder" msgstr "" -#: ../../library/codecs.rst:1401 +#: ../../library/codecs.rst:1409 msgid "base64_codec [#b64]_" msgstr "base64_codec [#b64]_" -#: ../../library/codecs.rst:1401 +#: ../../library/codecs.rst:1409 msgid "base64, base_64" msgstr "base64, base_64" -#: ../../library/codecs.rst:1401 +#: ../../library/codecs.rst:1409 msgid "" "Convert the operand to multiline MIME base64 (the result always includes a " "trailing ``'\\n'``)." msgstr "" -#: ../../library/codecs.rst:1406 +#: ../../library/codecs.rst:1414 msgid "" "accepts any :term:`bytes-like object` as input for encoding and decoding" msgstr "" -#: ../../library/codecs.rst:1401 +#: ../../library/codecs.rst:1409 msgid ":meth:`base64.encodebytes` / :meth:`base64.decodebytes`" msgstr ":meth:`base64.encodebytes` / :meth:`base64.decodebytes`" -#: ../../library/codecs.rst:1412 +#: ../../library/codecs.rst:1420 msgid "bz2_codec" msgstr "bz2_codec" -#: ../../library/codecs.rst:1412 +#: ../../library/codecs.rst:1420 msgid "bz2" msgstr "bz2" -#: ../../library/codecs.rst:1412 +#: ../../library/codecs.rst:1420 msgid "Compress the operand using bz2." msgstr "" -#: ../../library/codecs.rst:1412 +#: ../../library/codecs.rst:1420 msgid ":meth:`bz2.compress` / :meth:`bz2.decompress`" msgstr ":meth:`bz2.compress` / :meth:`bz2.decompress`" -#: ../../library/codecs.rst:1415 +#: ../../library/codecs.rst:1423 msgid "hex_codec" msgstr "hex_codec" -#: ../../library/codecs.rst:1415 +#: ../../library/codecs.rst:1423 msgid "hex" msgstr "hex" -#: ../../library/codecs.rst:1415 +#: ../../library/codecs.rst:1423 msgid "" "Convert the operand to hexadecimal representation, with two digits per byte." msgstr "" -#: ../../library/codecs.rst:1415 +#: ../../library/codecs.rst:1423 msgid ":meth:`binascii.b2a_hex` / :meth:`binascii.a2b_hex`" msgstr ":meth:`binascii.b2a_hex` / :meth:`binascii.a2b_hex`" -#: ../../library/codecs.rst:1420 +#: ../../library/codecs.rst:1428 msgid "quopri_codec" msgstr "quopri_codec" -#: ../../library/codecs.rst:1420 +#: ../../library/codecs.rst:1428 msgid "quopri, quotedprintable, quoted_printable" msgstr "quopri, quotedprintable, quoted_printable" -#: ../../library/codecs.rst:1420 +#: ../../library/codecs.rst:1428 msgid "Convert the operand to MIME quoted printable." msgstr "" -#: ../../library/codecs.rst:1420 +#: ../../library/codecs.rst:1428 msgid ":meth:`quopri.encode` with ``quotetabs=True`` / :meth:`quopri.decode`" msgstr ":meth:`quopri.encode` with ``quotetabs=True`` / :meth:`quopri.decode`" -#: ../../library/codecs.rst:1424 +#: ../../library/codecs.rst:1432 msgid "uu_codec" msgstr "uu_codec" -#: ../../library/codecs.rst:1424 +#: ../../library/codecs.rst:1432 msgid "uu" msgstr "uu" -#: ../../library/codecs.rst:1424 +#: ../../library/codecs.rst:1432 msgid "Convert the operand using uuencode." msgstr "" -#: ../../library/codecs.rst:1427 +#: ../../library/codecs.rst:1435 msgid "zlib_codec" msgstr "zlib_codec" -#: ../../library/codecs.rst:1427 +#: ../../library/codecs.rst:1435 msgid "zip, zlib" msgstr "zip, zlib" -#: ../../library/codecs.rst:1427 +#: ../../library/codecs.rst:1435 msgid "Compress the operand using gzip." msgstr "" -#: ../../library/codecs.rst:1427 +#: ../../library/codecs.rst:1435 msgid ":meth:`zlib.compress` / :meth:`zlib.decompress`" msgstr ":meth:`zlib.compress` / :meth:`zlib.decompress`" -#: ../../library/codecs.rst:1431 +#: ../../library/codecs.rst:1439 msgid "" "In addition to :term:`bytes-like objects `, " "``'base64_codec'`` also accepts ASCII-only instances of :class:`str` for " "decoding" msgstr "" -#: ../../library/codecs.rst:1435 +#: ../../library/codecs.rst:1443 msgid "Restoration of the binary transforms." msgstr "" -#: ../../library/codecs.rst:1438 +#: ../../library/codecs.rst:1446 msgid "Restoration of the aliases for the binary transforms." msgstr "" -#: ../../library/codecs.rst:1445 +#: ../../library/codecs.rst:1453 msgid "Text Transforms" msgstr "" -#: ../../library/codecs.rst:1447 +#: ../../library/codecs.rst:1455 msgid "" "The following codec provides a text transform: a :class:`str` to :class:" "`str` mapping. It is not supported by :meth:`str.encode` (which only " "produces :class:`bytes` output)." msgstr "" -#: ../../library/codecs.rst:1456 +#: ../../library/codecs.rst:1464 msgid "rot_13" msgstr "rot_13" -#: ../../library/codecs.rst:1456 +#: ../../library/codecs.rst:1464 msgid "rot13" msgstr "" -#: ../../library/codecs.rst:1456 +#: ../../library/codecs.rst:1464 msgid "Return the Caesar-cypher encryption of the operand." msgstr "" -#: ../../library/codecs.rst:1461 +#: ../../library/codecs.rst:1469 msgid "Restoration of the ``rot_13`` text transform." msgstr "" -#: ../../library/codecs.rst:1464 +#: ../../library/codecs.rst:1472 msgid "Restoration of the ``rot13`` alias." msgstr "" -#: ../../library/codecs.rst:1469 +#: ../../library/codecs.rst:1477 msgid "" ":mod:`encodings.idna` --- Internationalized Domain Names in Applications" msgstr "" -#: ../../library/codecs.rst:1475 +#: ../../library/codecs.rst:1483 msgid "" "This module implements :rfc:`3490` (Internationalized Domain Names in " "Applications) and :rfc:`3492` (Nameprep: A Stringprep Profile for " @@ -2574,13 +2583,13 @@ msgid "" "encoding and :mod:`stringprep`." msgstr "" -#: ../../library/codecs.rst:1480 +#: ../../library/codecs.rst:1488 msgid "" "If you need the IDNA 2008 standard from :rfc:`5891` and :rfc:`5895`, use the " "third-party :pypi:`idna` module." msgstr "" -#: ../../library/codecs.rst:1483 +#: ../../library/codecs.rst:1491 msgid "" "These RFCs together define a protocol to support non-ASCII characters in " "domain names. A domain name containing non-ASCII characters (such as ``www." @@ -2594,7 +2603,7 @@ msgid "" "presenting them to the user." msgstr "" -#: ../../library/codecs.rst:1494 +#: ../../library/codecs.rst:1502 msgid "" "Python supports this conversion in several ways: the ``idna`` codec " "performs conversion between Unicode and ACE, separating an input string into " @@ -2611,14 +2620,14 @@ msgid "" "sends that field at all)." msgstr "" -#: ../../library/codecs.rst:1507 +#: ../../library/codecs.rst:1515 msgid "" "When receiving host names from the wire (such as in reverse name lookup), no " "automatic conversion to Unicode is performed: applications wishing to " "present such host names to the user should decode them to Unicode." msgstr "" -#: ../../library/codecs.rst:1511 +#: ../../library/codecs.rst:1519 msgid "" "The module :mod:`encodings.idna` also implements the nameprep procedure, " "which performs certain normalizations on host names, to achieve case-" @@ -2626,49 +2635,49 @@ msgid "" "characters. The nameprep functions can be used directly if desired." msgstr "" -#: ../../library/codecs.rst:1519 +#: ../../library/codecs.rst:1527 msgid "" "Return the nameprepped version of *label*. The implementation currently " "assumes query strings, so ``AllowUnassigned`` is true." msgstr "" -#: ../../library/codecs.rst:1525 +#: ../../library/codecs.rst:1533 msgid "" "Convert a label to ASCII, as specified in :rfc:`3490`. ``UseSTD3ASCIIRules`` " "is assumed to be false." msgstr "" -#: ../../library/codecs.rst:1531 +#: ../../library/codecs.rst:1539 msgid "Convert a label to Unicode, as specified in :rfc:`3490`." msgstr "" -#: ../../library/codecs.rst:1535 +#: ../../library/codecs.rst:1543 msgid ":mod:`encodings.mbcs` --- Windows ANSI codepage" msgstr "" -#: ../../library/codecs.rst:1540 +#: ../../library/codecs.rst:1548 msgid "This module implements the ANSI codepage (CP_ACP)." msgstr "" -#: ../../library/codecs.rst:1542 +#: ../../library/codecs.rst:1550 msgid "Availability" msgstr "" -#: ../../library/codecs.rst:1544 +#: ../../library/codecs.rst:1552 msgid "" "Before 3.2, the *errors* argument was ignored; ``'replace'`` was always used " "to encode, and ``'ignore'`` to decode." msgstr "" -#: ../../library/codecs.rst:1548 +#: ../../library/codecs.rst:1556 msgid "Support any error handler." msgstr "" -#: ../../library/codecs.rst:1553 +#: ../../library/codecs.rst:1561 msgid ":mod:`encodings.utf_8_sig` --- UTF-8 codec with BOM signature" msgstr "" -#: ../../library/codecs.rst:1559 +#: ../../library/codecs.rst:1567 msgid "" "This module implements a variant of the UTF-8 codec. On encoding, a UTF-8 " "encoded BOM will be prepended to the UTF-8 encoded bytes. For the stateful " @@ -2697,71 +2706,71 @@ msgstr "streams（串流）" msgid "stackable" msgstr "stackable（可堆疊）" -#: ../../library/codecs.rst:312 +#: ../../library/codecs.rst:320 msgid "strict" msgstr "strict" -#: ../../library/codecs.rst:312 ../../library/codecs.rst:364 -#: ../../library/codecs.rst:387 +#: ../../library/codecs.rst:320 ../../library/codecs.rst:372 +#: ../../library/codecs.rst:395 msgid "error handler's name" msgstr "error handler's name（錯誤處理器名稱）" -#: ../../library/codecs.rst:312 +#: ../../library/codecs.rst:320 msgid "ignore" msgstr "ignore" -#: ../../library/codecs.rst:312 +#: ../../library/codecs.rst:320 msgid "replace" msgstr "replace" -#: ../../library/codecs.rst:312 +#: ../../library/codecs.rst:320 msgid "backslashreplace" msgstr "backslashreplace" -#: ../../library/codecs.rst:312 +#: ../../library/codecs.rst:320 msgid "surrogateescape" msgstr "surrogateescape" -#: ../../library/codecs.rst:312 +#: ../../library/codecs.rst:320 msgid "? (question mark)" msgstr "? （問號）" -#: ../../library/codecs.rst:312 +#: ../../library/codecs.rst:320 msgid "replacement character" msgstr "replacement character（替代字元）" -#: ../../library/codecs.rst:312 +#: ../../library/codecs.rst:320 msgid "\\ (backslash)" msgstr "\\ （反斜線）" -#: ../../library/codecs.rst:312 ../../library/codecs.rst:364 +#: ../../library/codecs.rst:320 ../../library/codecs.rst:372 msgid "escape sequence" msgstr "escape sequence（跳脫序列）" -#: ../../library/codecs.rst:312 +#: ../../library/codecs.rst:320 msgid "\\x" msgstr "\\x" -#: ../../library/codecs.rst:312 +#: ../../library/codecs.rst:320 msgid "\\u" msgstr "\\u" -#: ../../library/codecs.rst:312 +#: ../../library/codecs.rst:320 msgid "\\U" msgstr "\\U" -#: ../../library/codecs.rst:364 +#: ../../library/codecs.rst:372 msgid "xmlcharrefreplace" msgstr "xmlcharrefreplace" -#: ../../library/codecs.rst:364 +#: ../../library/codecs.rst:372 msgid "namereplace" msgstr "namereplace" -#: ../../library/codecs.rst:364 +#: ../../library/codecs.rst:372 msgid "\\N" msgstr "\\N" -#: ../../library/codecs.rst:387 +#: ../../library/codecs.rst:395 msgid "surrogatepass" msgstr "surrogatepass" diff --git a/library/csv.po b/library/csv.po index ca8bece800..2967c027b5 100644 --- a/library/csv.po +++ b/library/csv.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-06-27 07:36+0000\n" +"POT-Creation-Date: 2025-07-01 00:18+0000\n" "PO-Revision-Date: 2023-11-08 15:06+0800\n" "Last-Translator: RockLeon \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -118,8 +118,8 @@ msgid "" "`QUOTE_NONNUMERIC` format option is specified (in which case unquoted fields " "are transformed into floats)." msgstr "" -"從 CSV 檔案讀取的每一列會回傳為一個字串列表。除非格式選項 " -":data:`QUOTE_NONNUMERIC` 有被指定（在這個情況之下，沒有引號的欄位都會被轉換成浮點" +"從 CSV 檔案讀取的每一列會回傳為一個字串列表。除非格式選項 :data:" +"`QUOTE_NONNUMERIC` 有被指定（在這個情況之下，沒有引號的欄位都會被轉換成浮點" "數），否則不會進行自動資料型別轉換。" #: ../../library/csv.rst:76 ../../library/csv.rst:106 ../../library/csv.rst:181 @@ -524,10 +524,11 @@ msgid "Instructs :class:`writer` objects to quote all fields." msgstr "引導 :class:`writer` 物件引用所有欄位。" #: ../../library/csv.rst:325 +#, fuzzy msgid "" "Instructs :class:`writer` objects to only quote those fields which contain " -"special characters such as *delimiter*, *quotechar* or any of the characters " -"in *lineterminator*." +"special characters such as *delimiter*, *quotechar*, ``'\\r'``, ``'\\n'`` or " +"any of the characters in *lineterminator*." msgstr "" "引導 :class:`writer` 物件只引用包含特殊字元的欄位，例如：*分隔符號*、*引號*、" "或是 *分行符號* 的其他字元。" @@ -551,23 +552,26 @@ msgid "" msgstr "" #: ../../library/csv.rst:345 +#, fuzzy msgid "" -"Instructs :class:`writer` objects to never quote fields. When the current " -"*delimiter* occurs in output data it is preceded by the current *escapechar* " -"character. If *escapechar* is not set, the writer will raise :exc:`Error` " -"if any characters that require escaping are encountered." +"Instructs :class:`writer` objects to never quote fields. When the current " +"*delimiter*, *quotechar*, *escapechar*, ``'\\r'``, ``'\\n'`` or any of the " +"characters in *lineterminator* occurs in output data it is preceded by the " +"current *escapechar* character. If *escapechar* is not set, the writer will " +"raise :exc:`Error` if any characters that require escaping are encountered. " +"Set *quotechar* to ``None`` to prevent its escaping." msgstr "" "引導 :class:`writer` 物件不得引用欄位。目前的 *分隔符號* 出現在輸出資料時，在" "他之前的字元是目前的\\*逸出字元 (escape character)*。如果沒有設定\\*逸出字元" "*\\，若遇到任何字元需要逸出，寫入器則會引發 :exc:`Error` 。" -#: ../../library/csv.rst:350 +#: ../../library/csv.rst:353 msgid "" "Instructs :class:`reader` objects to perform no special processing of quote " "characters." msgstr "引導 :class:`reader` 物件不對引號進行特別處理。" -#: ../../library/csv.rst:354 +#: ../../library/csv.rst:357 msgid "" "Instructs :class:`writer` objects to quote all fields which are not " "``None``. This is similar to :data:`QUOTE_ALL`, except that if a field " @@ -576,7 +580,7 @@ msgstr "" "引導 :class:`writer` 物件引用所有非 ``None`` 的欄位。這與 :data:`QUOTE_ALL` " "相似，除非如果欄位值為 ``None``，該欄位則被寫成空（沒有引號）字串。" -#: ../../library/csv.rst:358 +#: ../../library/csv.rst:361 msgid "" "Instructs :class:`reader` objects to interpret an empty (unquoted) field as " "``None`` and to otherwise behave as :data:`QUOTE_ALL`." @@ -584,7 +588,7 @@ msgstr "" "引導 :class:`reader` 物件將空（沒有引號）欄位直譯 (interpret) 為 ``None``，否" "則會和 :data:`QUOTE_ALL` 有相同的表現方式。" -#: ../../library/csv.rst:365 +#: ../../library/csv.rst:368 msgid "" "Instructs :class:`writer` objects to always place quotes around fields which " "are strings. This is similar to :data:`QUOTE_NONNUMERIC`, except that if a " @@ -594,7 +598,7 @@ msgstr "" "`QUOTE_NONNUMERIC` 相似，除非如果欄位值為 ``None``，該欄位則被寫成空（沒有引" "號）字串。" -#: ../../library/csv.rst:369 +#: ../../library/csv.rst:372 msgid "" "Instructs :class:`reader` objects to interpret an empty (unquoted) string as " "``None`` and to otherwise behave as :data:`QUOTE_NONNUMERIC`." @@ -602,19 +606,19 @@ msgstr "" "引導 :class:`reader` 物件將空（沒有引號）字串直譯為 ``None``，否則會和 :data:" "`QUOTE_ALL` 有相同的表現方式。" -#: ../../library/csv.rst:374 +#: ../../library/csv.rst:377 msgid "The :mod:`csv` module defines the following exception:" msgstr ":mod:`csv` 模組定義下列例外：" -#: ../../library/csv.rst:379 +#: ../../library/csv.rst:382 msgid "Raised by any of the functions when an error is detected." msgstr "當偵測到錯誤時，任何函式都可以引發。" -#: ../../library/csv.rst:384 +#: ../../library/csv.rst:387 msgid "Dialects and Formatting Parameters" msgstr "Dialect 與格式參數" -#: ../../library/csv.rst:386 +#: ../../library/csv.rst:389 msgid "" "To make it easier to specify the format of input and output records, " "specific formatting parameters are grouped together into dialects. A " @@ -633,16 +637,16 @@ msgstr "" "代，在\\ *dialect*\\ 參數中，程式設計師可以指定個別的格式化參數，其與 :class:" "`Dialect` 類別定義的屬性具有相同的名字。" -#: ../../library/csv.rst:396 +#: ../../library/csv.rst:399 msgid "Dialects support the following attributes:" msgstr "Dialect 支援下列屬性：" -#: ../../library/csv.rst:401 +#: ../../library/csv.rst:404 msgid "" "A one-character string used to separate fields. It defaults to ``','``." msgstr "一個單一字元 (one-character) 的字串可已用來分割欄位。預設為 ``','``。" -#: ../../library/csv.rst:406 +#: ../../library/csv.rst:409 msgid "" "Controls how instances of *quotechar* appearing inside a field should " "themselves be quoted. When :const:`True`, the character is doubled. When :" @@ -653,7 +657,7 @@ msgstr "" "為 :const:`True`，字元會是雙引號。若為 :const:`False`，在 *quotechar* 之前會" "先使用 *escapechar* 作為前綴字。預設為 :const:`True`。" -#: ../../library/csv.rst:411 +#: ../../library/csv.rst:414 msgid "" "On output, if *doublequote* is :const:`False` and no *escapechar* is set, :" "exc:`Error` is raised if a *quotechar* is found in a field." @@ -661,30 +665,50 @@ msgstr "" "在輸出時，若 *doublequote* 是 :const:`False` 且\\ *逸出字元*\\ 沒有被設定，當" "一個\\ *引號*\\ 在欄位中被發現時，:exc:`Error` 會被引發。" -#: ../../library/csv.rst:417 +#: ../../library/csv.rst:420 msgid "" -"A one-character string used by the writer to escape the *delimiter* if " -"*quoting* is set to :const:`QUOTE_NONE` and the *quotechar* if *doublequote* " -"is :const:`False`. On reading, the *escapechar* removes any special meaning " -"from the following character. It defaults to :const:`None`, which disables " -"escaping." +"A one-character string used by the writer to escape characters that require " +"escaping:" +msgstr "" + +#: ../../library/csv.rst:423 +msgid "" +"the *delimiter*, the *quotechar*, ``'\\r'``, ``'\\n'`` and any of the " +"characters in *lineterminator* are escaped if *quoting* is set to :const:" +"`QUOTE_NONE`;" +msgstr "" + +#: ../../library/csv.rst:426 +msgid "the *quotechar* is escaped if *doublequote* is :const:`False`;" +msgstr "" + +#: ../../library/csv.rst:427 +#, fuzzy +msgid "the *escapechar* itself." +msgstr "*escapechar* 為空是不被接受的。" + +#: ../../library/csv.rst:429 +#, fuzzy +msgid "" +"On reading, the *escapechar* removes any special meaning from the following " +"character. It defaults to :const:`None`, which disables escaping." msgstr "" "一個會被寫入器使用的單一字元的字串，當 *quoting* 設定為 :const:`QUOTE_NONE` " "時逸出\\ *分隔符號*；當 *doublequote* 設定為 :const:`False` 時逸出\\ *引號*。" "在讀取時，*逸出字元*\\ 會移除後面的字元以及任何特殊意義。預設為 :const:" "`None`，表示禁止逸出。" -#: ../../library/csv.rst:422 +#: ../../library/csv.rst:432 msgid "An empty *escapechar* is not allowed." msgstr "*escapechar* 為空是不被接受的。" -#: ../../library/csv.rst:427 +#: ../../library/csv.rst:437 msgid "" "The string used to terminate lines produced by the :class:`writer`. It " "defaults to ``'\\r\\n'``." msgstr "由 :class:`writer` 產生被用來分行的字串。預設為 ``'\\r\\n'``。" -#: ../../library/csv.rst:432 +#: ../../library/csv.rst:442 msgid "" "The :class:`reader` is hard-coded to recognise either ``'\\r'`` or ``'\\n'`` " "as end-of-line, and ignores *lineterminator*. This behavior may change in " @@ -693,29 +717,34 @@ msgstr "" ":class:`reader` 是 hard-coded 辨別 ``'\\r'`` or ``'\\n'`` 作為行尾 (end-of-" "line)，並忽略\\ *分行符號*。未來可能會改變這個行為。" -#: ../../library/csv.rst:439 +#: ../../library/csv.rst:449 +#, fuzzy msgid "" "A one-character string used to quote fields containing special characters, " -"such as the *delimiter* or *quotechar*, or which contain new-line " -"characters. It defaults to ``'\"'``." +"such as the *delimiter* or the *quotechar*, or which contain new-line " +"characters (``'\\r'``, ``'\\n'`` or any of the characters in " +"*lineterminator*). It defaults to ``'\"'``. Can be set to ``None`` to " +"prevent escaping ``'\"'`` if *quoting* is set to :const:`QUOTE_NONE`." msgstr "" "一個單一字元的字串被用於引用包含特殊字元的欄位，像是 *delimiter*、" "*quotechar* 或是換行字元。預設為 ``'\"'``。" -#: ../../library/csv.rst:443 +#: ../../library/csv.rst:456 msgid "An empty *quotechar* is not allowed." msgstr "*quotechar* 為空是不被允許的。" -#: ../../library/csv.rst:448 +#: ../../library/csv.rst:461 +#, fuzzy msgid "" "Controls when quotes should be generated by the writer and recognised by the " "reader. It can take on any of the :ref:`QUOTE_\\* constants ` and defaults to :const:`QUOTE_MINIMAL`." +"constants>` and defaults to :const:`QUOTE_MINIMAL` if *quotechar* is not " +"``None``, and :const:`QUOTE_NONE` otherwise." msgstr "" "控制 writer 何時產生引號，以及 reader 如何辨識引號。他可以使用任何 :ref:" "`QUOTE_\\* 常數 `\\ 且預設為 :const:`QUOTE_MINIMAL`。" -#: ../../library/csv.rst:455 +#: ../../library/csv.rst:469 msgid "" "When :const:`True`, spaces immediately following the *delimiter* are " "ignored. The default is :const:`False`." @@ -723,18 +752,18 @@ msgstr "" "若為 :const:`True`，在緊接著\\ *分隔符號*\\ 後的空格會被忽略。預設為 :const:" "`False`。" -#: ../../library/csv.rst:461 +#: ../../library/csv.rst:475 msgid "" "When ``True``, raise exception :exc:`Error` on bad CSV input. The default is " "``False``." msgstr "" "若為 ``True``，若有錯誤的 CSV 輸入則會引發 :exc:`Error`。預設為 ``False``。" -#: ../../library/csv.rst:467 +#: ../../library/csv.rst:481 msgid "Reader Objects" msgstr "讀取器物件" -#: ../../library/csv.rst:469 +#: ../../library/csv.rst:483 msgid "" "Reader objects (:class:`DictReader` instances and objects returned by the :" "func:`reader` function) have the following public methods:" @@ -742,7 +771,7 @@ msgstr "" "讀取器物件（:func:`reader` 函式回傳的 :class:`DictReader` 實例與物件）有下列" "公用方法 (public method)：" -#: ../../library/csv.rst:474 +#: ../../library/csv.rst:488 msgid "" "Return the next row of the reader's iterable object as a list (if the object " "was returned from :func:`reader`) or a dict (if it is a :class:`DictReader` " @@ -753,25 +782,25 @@ msgstr "" "傳）或是一個 dict（若為 :class:`DictReader` 實例），會依據目前的 :class:" "`Dialect` 進行剖析。通常會用 ``next(reader)`` 來進行呼叫。" -#: ../../library/csv.rst:480 +#: ../../library/csv.rst:494 msgid "Reader objects have the following public attributes:" msgstr "讀取器物件有下列公用屬性 (public attributes)：" -#: ../../library/csv.rst:484 +#: ../../library/csv.rst:498 msgid "A read-only description of the dialect in use by the parser." msgstr "dialect 的唯讀敘述，會被剖析器使用。" -#: ../../library/csv.rst:489 +#: ../../library/csv.rst:503 msgid "" "The number of lines read from the source iterator. This is not the same as " "the number of records returned, as records can span multiple lines." msgstr "來源疊代器所讀取的行數。這與回傳的紀錄數不同，因為可以進行跨行紀錄。" -#: ../../library/csv.rst:493 +#: ../../library/csv.rst:507 msgid "DictReader objects have the following public attribute:" msgstr "DictReader 物件有下列公用屬性：" -#: ../../library/csv.rst:497 +#: ../../library/csv.rst:511 msgid "" "If not passed as a parameter when creating the object, this attribute is " "initialized upon first access or when the first record is read from the file." @@ -779,11 +808,11 @@ msgstr "" "若在建立物件時沒有作為參數傳遞，這個屬性會在第一次存取之前或是第一筆資料被讀" "取之前進行初始化 (initialize)。" -#: ../../library/csv.rst:504 +#: ../../library/csv.rst:518 msgid "Writer Objects" msgstr "寫入器物件" -#: ../../library/csv.rst:506 +#: ../../library/csv.rst:520 msgid "" ":class:`writer` objects (:class:`DictWriter` instances and objects returned " "by the :func:`writer` function) have the following public methods. A *row* " @@ -801,7 +830,7 @@ msgstr "" "遞）。請注意，在寫入複數 (complex number) 時會用小括號 (parens) 包起來。這可" "能在其他程式讀取 CSV 檔案時導致某些問題（假設他們完全支援複雜數字）。" -#: ../../library/csv.rst:517 +#: ../../library/csv.rst:531 msgid "" "Write the *row* parameter to the writer's file object, formatted according " "to the current :class:`Dialect`. Return the return value of the call to the " @@ -810,11 +839,11 @@ msgstr "" "將參數 *row* 寫入至寫入器的檔案物件中，並依照目前的 :class:`Dialect` 進行格式" "化。回傳下層檔案物件 *write* 方法的回傳值。" -#: ../../library/csv.rst:521 +#: ../../library/csv.rst:535 msgid "Added support of arbitrary iterables." msgstr "新增對任意可疊代物件 (arbitrary iterables) 的支援。" -#: ../../library/csv.rst:526 +#: ../../library/csv.rst:540 msgid "" "Write all elements in *rows* (an iterable of *row* objects as described " "above) to the writer's file object, formatted according to the current " @@ -823,19 +852,19 @@ msgstr "" "將 *rows* 中所有元素（為上述的一個可疊代的 *row* 物件）寫入至寫入器的檔案物件" "中，並依照目前的 dialect 進行格式化。" -#: ../../library/csv.rst:530 +#: ../../library/csv.rst:544 msgid "Writer objects have the following public attribute:" msgstr "寫入器物件有下列公用屬性：" -#: ../../library/csv.rst:535 +#: ../../library/csv.rst:549 msgid "A read-only description of the dialect in use by the writer." msgstr "dialect 的唯讀敘述，會被寫入器使用。" -#: ../../library/csv.rst:538 +#: ../../library/csv.rst:552 msgid "DictWriter objects have the following public method:" msgstr "DictWriter 物件有下列公用方法：" -#: ../../library/csv.rst:543 +#: ../../library/csv.rst:557 msgid "" "Write a row with the field names (as specified in the constructor) to the " "writer's file object, formatted according to the current dialect. Return the " @@ -845,7 +874,7 @@ msgstr "" "中，並依照目前的 dialect 進行格式化。回傳內部呼叫 :meth:`csvwriter.writerow` " "的回傳值。" -#: ../../library/csv.rst:548 +#: ../../library/csv.rst:562 msgid "" ":meth:`writeheader` now also returns the value returned by the :meth:" "`csvwriter.writerow` method it uses internally." @@ -853,15 +882,15 @@ msgstr "" ":meth:`writeheader` 現在也會回傳內部呼叫 :meth:`csvwriter.writerow` 的回傳" "值。" -#: ../../library/csv.rst:556 +#: ../../library/csv.rst:570 msgid "Examples" msgstr "範例" -#: ../../library/csv.rst:558 +#: ../../library/csv.rst:572 msgid "The simplest example of reading a CSV file::" msgstr "最簡單的讀取 CSV 檔案範例： ::" -#: ../../library/csv.rst:560 +#: ../../library/csv.rst:574 msgid "" "import csv\n" "with open('some.csv', newline='') as f:\n" @@ -875,11 +904,11 @@ msgstr "" " for row in reader:\n" " print(row)" -#: ../../library/csv.rst:566 +#: ../../library/csv.rst:580 msgid "Reading a file with an alternate format::" msgstr "讀取一個其他格式的檔案： ::" -#: ../../library/csv.rst:568 +#: ../../library/csv.rst:582 msgid "" "import csv\n" "with open('passwd', newline='') as f:\n" @@ -893,11 +922,11 @@ msgstr "" " for row in reader:\n" " print(row)" -#: ../../library/csv.rst:574 +#: ../../library/csv.rst:588 msgid "The corresponding simplest possible writing example is::" msgstr "相對最簡單、可行的寫入範例為： ::" -#: ../../library/csv.rst:576 +#: ../../library/csv.rst:590 msgid "" "import csv\n" "with open('some.csv', 'w', newline='') as f:\n" @@ -905,7 +934,7 @@ msgid "" " writer.writerows(someiterable)" msgstr "" -#: ../../library/csv.rst:581 +#: ../../library/csv.rst:595 msgid "" "Since :func:`open` is used to open a CSV file for reading, the file will by " "default be decoded into unicode using the system default encoding (see :func:" @@ -916,7 +945,7 @@ msgstr "" "碼格式（請見 :func:`locale.getencoding`），並解碼為 unicode。若要使用不同編碼" "格式進行檔案解碼，請使用 open 函式的 ``encoding`` 引數： ::" -#: ../../library/csv.rst:586 +#: ../../library/csv.rst:600 msgid "" "import csv\n" "with open('some.csv', newline='', encoding='utf-8') as f:\n" @@ -930,7 +959,7 @@ msgstr "" " for row in reader:\n" " print(row)" -#: ../../library/csv.rst:592 +#: ../../library/csv.rst:606 msgid "" "The same applies to writing in something other than the system default " "encoding: specify the encoding argument when opening the output file." @@ -938,11 +967,11 @@ msgstr "" "同理可以應用到使用不同編碼格式進行寫入：當開啟輸出檔案時，指定 ``encoding`` " "引數。" -#: ../../library/csv.rst:595 +#: ../../library/csv.rst:609 msgid "Registering a new dialect::" msgstr "註冊一個新的 dialect ： ::" -#: ../../library/csv.rst:597 +#: ../../library/csv.rst:611 msgid "" "import csv\n" "csv.register_dialect('unixpwd', delimiter=':', quoting=csv.QUOTE_NONE)\n" @@ -954,13 +983,13 @@ msgstr "" "with open('passwd', newline='') as f:\n" " reader = csv.reader(f, 'unixpwd')" -#: ../../library/csv.rst:602 +#: ../../library/csv.rst:616 msgid "" "A slightly more advanced use of the reader --- catching and reporting " "errors::" msgstr "稍微進階的讀取器用法 -- 擷取及回報錯誤： ::" -#: ../../library/csv.rst:604 +#: ../../library/csv.rst:618 msgid "" "import csv, sys\n" "filename = 'some.csv'\n" @@ -982,13 +1011,13 @@ msgstr "" " except csv.Error as e:\n" " sys.exit(f'file {filename}, line {reader.line_num}: {e}')" -#: ../../library/csv.rst:614 +#: ../../library/csv.rst:628 msgid "" "And while the module doesn't directly support parsing strings, it can easily " "be done::" msgstr "而當模組無法直接支援剖析字串時，仍可以輕鬆的解決： ::" -#: ../../library/csv.rst:617 +#: ../../library/csv.rst:631 msgid "" "import csv\n" "for row in csv.reader(['one,two,three']):\n" @@ -998,11 +1027,11 @@ msgstr "" "for row in csv.reader(['one,two,three']):\n" " print(row)" -#: ../../library/csv.rst:623 +#: ../../library/csv.rst:637 msgid "Footnotes" msgstr "註解" -#: ../../library/csv.rst:624 +#: ../../library/csv.rst:638 msgid "" "If ``newline=''`` is not specified, newlines embedded inside quoted fields " "will not be interpreted correctly, and on platforms that use ``\\r\\n`` " diff --git a/library/math.po b/library/math.po index 8eee7acf44..5a2a58d37e 100644 --- a/library/math.po +++ b/library/math.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-06-27 07:36+0000\n" +"POT-Creation-Date: 2025-07-01 00:18+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-" @@ -1374,8 +1374,8 @@ msgid "" "The mathematical constant *τ* = 6.283185..., to available precision. Tau is " "a circle constant equal to 2\\ *π*, the ratio of a circle's circumference to " "its radius. To learn more about Tau, check out Vi Hart's video `Pi is " -"(still) Wrong `_, and start " -"celebrating `Tau day `_ by eating twice as much pie!" +"(still) Wrong `_, and start celebrating `Tau " +"day `_ by eating twice as much pie!" msgstr "" #: ../../library/math.rst:785 diff --git a/library/time.po b/library/time.po index 8d53a79a3b..b0d8a3fc71 100644 --- a/library/time.po +++ b/library/time.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-03-10 00:13+0000\n" +"POT-Creation-Date: 2025-07-01 00:18+0000\n" "PO-Revision-Date: 2024-11-20 15:25+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -264,14 +264,14 @@ msgstr "" #: ../../library/time.rst:153 ../../library/time.rst:165 #: ../../library/time.rst:178 ../../library/time.rst:187 #: ../../library/time.rst:200 ../../library/time.rst:209 -#: ../../library/time.rst:747 ../../library/time.rst:771 -#: ../../library/time.rst:867 ../../library/time.rst:878 -#: ../../library/time.rst:888 ../../library/time.rst:898 -#: ../../library/time.rst:907 ../../library/time.rst:916 -#: ../../library/time.rst:925 ../../library/time.rst:936 -#: ../../library/time.rst:944 ../../library/time.rst:955 -#: ../../library/time.rst:966 ../../library/time.rst:975 -#: ../../library/time.rst:988 +#: ../../library/time.rst:752 ../../library/time.rst:776 +#: ../../library/time.rst:872 ../../library/time.rst:883 +#: ../../library/time.rst:893 ../../library/time.rst:903 +#: ../../library/time.rst:912 ../../library/time.rst:921 +#: ../../library/time.rst:930 ../../library/time.rst:941 +#: ../../library/time.rst:949 ../../library/time.rst:960 +#: ../../library/time.rst:971 ../../library/time.rst:980 +#: ../../library/time.rst:993 msgid "Availability" msgstr "" @@ -1287,7 +1287,8 @@ msgstr "" "為屬性存取日曆日期的組成部分。" #: ../../library/time.rst:715 -msgid "On Windows, call ``GetSystemTimeAsFileTime()``." +#, fuzzy +msgid "On Windows, call ``GetSystemTimePreciseAsFileTime()``." msgstr "在 Windows 上，呼叫 ``GetSystemTimeAsFileTime()``。" #: ../../library/time.rst:716 @@ -1304,13 +1305,20 @@ msgid "" "type." msgstr "使用 :func:`time_ns` 以避免 :class:`float` 型別造成的精確度損失。" -#: ../../library/time.rst:725 +#: ../../library/time.rst:724 +#, fuzzy +msgid "" +"On Windows, calls ``GetSystemTimePreciseAsFileTime()`` instead of " +"``GetSystemTimeAsFileTime()``." +msgstr "在 Windows 上，呼叫 ``GetSystemTimeAsFileTime()``。" + +#: ../../library/time.rst:730 msgid "" "Similar to :func:`~time.time` but returns time as an integer number of " "nanoseconds since the epoch_." msgstr "類似於 :func:`~time.time`，但回傳自 epoch_ 起的以奈秒為單位的整數。" -#: ../../library/time.rst:738 +#: ../../library/time.rst:743 msgid "" "Return the value (in fractional seconds) of the sum of the system and user " "CPU time of the current thread. It does not include time elapsed during " @@ -1322,22 +1330,22 @@ msgstr "" "期間經過的時間。根據定義，這是執行緒特定 (thread-specific) 的。回傳值的參照點" "未定義，因此只有同一執行緒中兩次呼叫結果之間的差異才是有效的。" -#: ../../library/time.rst:744 +#: ../../library/time.rst:749 msgid "" "Use :func:`thread_time_ns` to avoid the precision loss caused by the :class:" "`float` type." msgstr "" "使用 :func:`thread_time_ns` 以避免 :class:`float` 型別造成的精確度損失。" -#: ../../library/time.rst:749 +#: ../../library/time.rst:754 msgid "Unix systems supporting ``CLOCK_THREAD_CPUTIME_ID``." msgstr "有支援 ``CLOCK_THREAD_CPUTIME_ID`` 的 Unix 系統。" -#: ../../library/time.rst:756 +#: ../../library/time.rst:761 msgid "Similar to :func:`thread_time` but return time as nanoseconds." msgstr "類似於 :func:`thread_time`，但回傳以奈秒為單位的時間。" -#: ../../library/time.rst:763 +#: ../../library/time.rst:768 msgid "" "Reset the time conversion rules used by the library routines. The " "environment variable :envvar:`TZ` specifies how this is done. It will also " @@ -1354,7 +1362,7 @@ msgstr "" "``daylight``\\ （如果該時區沒有日光節約時間規則，則設定為 0；如果在過去、現在" "或未來的某個時間有日光節約時間規則，則設置為非零的值）。" -#: ../../library/time.rst:775 +#: ../../library/time.rst:780 msgid "" "Although in many cases, changing the :envvar:`TZ` environment variable may " "affect the output of functions like :func:`localtime` without calling :func:" @@ -1363,30 +1371,30 @@ msgstr "" "雖然在許多情況下，更改 :envvar:`TZ` 環境變數可能會在沒有呼叫 :func:`tzset` 的" "情況下影響 :func:`localtime` 等函式的輸出，但是這種行為是不該被依賴的。" -#: ../../library/time.rst:779 +#: ../../library/time.rst:784 msgid "The :envvar:`TZ` environment variable should contain no whitespace." msgstr ":envvar:`TZ` 環境變數不應包含空格字元。" -#: ../../library/time.rst:781 +#: ../../library/time.rst:786 msgid "" "The standard format of the :envvar:`TZ` environment variable is (whitespace " "added for clarity)::" msgstr "" ":envvar:`TZ` 環境變數的標準格式為（為了清楚表達，中間增加了空格字元）： ::" -#: ../../library/time.rst:784 +#: ../../library/time.rst:789 msgid "std offset [dst [offset [,start[/time], end[/time]]]]" msgstr "std offset [dst [offset [,start[/time], end[/time]]]]" -#: ../../library/time.rst:786 +#: ../../library/time.rst:791 msgid "Where the components are:" msgstr "其中各個組成部分為：" -#: ../../library/time.rst:788 +#: ../../library/time.rst:793 msgid "``std`` and ``dst``" msgstr "``std`` 和 ``dst``" -#: ../../library/time.rst:789 +#: ../../library/time.rst:794 msgid "" "Three or more alphanumerics giving the timezone abbreviations. These will be " "propagated into time.tzname" @@ -1394,11 +1402,11 @@ msgstr "" "三個或更多字母與數字 (alphanumerics) 組成的時區縮寫。這些縮寫會被傳播到 time." "tzname 中。" -#: ../../library/time.rst:792 +#: ../../library/time.rst:797 msgid "``offset``" msgstr "``offset``" -#: ../../library/time.rst:793 +#: ../../library/time.rst:798 msgid "" "The offset has the form: ``± hh[:mm[:ss]]``. This indicates the value added " "the local time to arrive at UTC. If preceded by a '-', the timezone is east " @@ -1409,22 +1417,22 @@ msgstr "" "果以 '-' 開頭，則表示該時區位於本初子午線以東；否則，位於其西。如果 dst 之後" "沒有偏移量，則假定日光時間比標準時間快一小時。" -#: ../../library/time.rst:798 +#: ../../library/time.rst:803 msgid "``start[/time], end[/time]``" msgstr "``start[/time], end[/time]``" -#: ../../library/time.rst:799 +#: ../../library/time.rst:804 msgid "" "Indicates when to change to and back from DST. The format of the start and " "end dates are one of the following:" msgstr "" "表示何時切換至日光節約時間及何時切換回來。開始和結束日期的格式如以下其一：" -#: ../../library/time.rst:802 +#: ../../library/time.rst:807 msgid ":samp:`J{n}`" msgstr ":samp:`J{n}`" -#: ../../library/time.rst:803 +#: ../../library/time.rst:808 msgid "" "The Julian day *n* (1 <= *n* <= 365). Leap days are not counted, so in all " "years February 28 is day 59 and March 1 is day 60." @@ -1432,22 +1440,22 @@ msgstr "" "儒略日 (Julian day) *n*（1 <= *n* <= 365）。閏日不計算，因此在所有年份中，2 " "月 28 日是第 59 天，3 月 1 日是第 60 天。" -#: ../../library/time.rst:806 +#: ../../library/time.rst:811 msgid ":samp:`{n}`" msgstr ":samp:`{n}`" -#: ../../library/time.rst:807 +#: ../../library/time.rst:812 msgid "" "The zero-based Julian day (0 <= *n* <= 365). Leap days are counted, and it " "is possible to refer to February 29." msgstr "" "從 0 開始的儒略日 (0 <= *n* <= 365)。閏日會計算，因此可以適用至 2 月 29 日。" -#: ../../library/time.rst:810 +#: ../../library/time.rst:815 msgid ":samp:`M{m}.{n}.{d}`" msgstr ":samp:`M{m}.{n}.{d}`" -#: ../../library/time.rst:811 +#: ../../library/time.rst:816 msgid "" "The *d*'th day (0 <= *d* <= 6) of week *n* of month *m* of the year (1 <= " "*n* <= 5, 1 <= *m* <= 12, where week 5 means \"the last *d* day in month " @@ -1458,7 +1466,7 @@ msgstr "" "*m* <= 12，其中 *n* 為 5 表示「該月的最後一個第 *d* 天」，這可能出現在第四或" "第五週）。第 1 週是 *d* 天首次出現的那一週。第零天為星期天。" -#: ../../library/time.rst:817 +#: ../../library/time.rst:822 msgid "" "``time`` has the same format as ``offset`` except that no leading sign ('-' " "or '+') is allowed. The default, if time is not given, is 02:00:00." @@ -1466,7 +1474,7 @@ msgstr "" "``time`` 的格式與 ``offset`` 相同，但不允許出現前導符號（'-' 或 '+'）。如果未" "指定時間，則預設為 02:00:00。" -#: ../../library/time.rst:822 +#: ../../library/time.rst:827 msgid "" ">>> os.environ['TZ'] = 'EST+05EDT,M4.1.0,M10.5.0'\n" ">>> time.tzset()\n" @@ -1486,7 +1494,7 @@ msgstr "" ">>> time.strftime('%X %x %Z')\n" "'16:08:12 05/08/03 AEST'" -#: ../../library/time.rst:831 +#: ../../library/time.rst:836 msgid "" "On many Unix systems (including \\*BSD, Linux, Solaris, and Darwin), it is " "more convenient to use the system's zoneinfo (:manpage:`tzfile(5)`) " @@ -1503,7 +1511,7 @@ msgstr "" "Eastern'``、``'Australia/Melbourne'``、``'Egypt'`` 或 ``'Europe/" "Amsterdam'``。 ::" -#: ../../library/time.rst:839 +#: ../../library/time.rst:844 msgid "" ">>> os.environ['TZ'] = 'US/Eastern'\n" ">>> time.tzset()\n" @@ -1523,24 +1531,24 @@ msgstr "" ">>> time.tzname\n" "('EET', 'EEST')" -#: ../../library/time.rst:852 +#: ../../library/time.rst:857 msgid "Clock ID Constants" msgstr "時鐘 ID 常數" -#: ../../library/time.rst:854 +#: ../../library/time.rst:859 msgid "" "These constants are used as parameters for :func:`clock_getres` and :func:" "`clock_gettime`." msgstr "這些常數用作 :func:`clock_getres` 和 :func:`clock_gettime` 的參數。" -#: ../../library/time.rst:859 +#: ../../library/time.rst:864 msgid "" "Identical to :data:`CLOCK_MONOTONIC`, except it also includes any time that " "the system is suspended." msgstr "" "與 :data:`CLOCK_MONOTONIC` 基本相同，不同之處在於它還包括系統暫停的任何時間。" -#: ../../library/time.rst:862 +#: ../../library/time.rst:867 msgid "" "This allows applications to get a suspend-aware monotonic clock without " "having to deal with the complications of :data:`CLOCK_REALTIME`, which may " @@ -1551,7 +1559,7 @@ msgstr "" "`CLOCK_REALTIME` 的複雜情況，後者在使用 ``settimeofday()`` 或類似函式更改時間" "時可能會出現不連續的情況。" -#: ../../library/time.rst:874 +#: ../../library/time.rst:879 msgid "" "The Solaris OS has a ``CLOCK_HIGHRES`` timer that attempts to use an optimal " "hardware source, and may give close to nanosecond resolution. " @@ -1560,13 +1568,13 @@ msgstr "" "Solaris 作業系統具有 ``CLOCK_HIGHRES`` 計時器，它嘗試使用最佳的硬體資源，並可" "能提供接近奈秒的解析度。``CLOCK_HIGHRES`` 是不可調整且高解析度的時鐘。" -#: ../../library/time.rst:885 +#: ../../library/time.rst:890 msgid "" "Clock that cannot be set and represents monotonic time since some " "unspecified starting point." msgstr "該時鐘無法被設定，其表示自某個未指定起點以來的單調時間。" -#: ../../library/time.rst:895 +#: ../../library/time.rst:900 msgid "" "Similar to :data:`CLOCK_MONOTONIC`, but provides access to a raw hardware-" "based time that is not subject to NTP adjustments." @@ -1574,7 +1582,7 @@ msgstr "" "類似於 :data:`CLOCK_MONOTONIC`，但提供對基於硬體的原始時間的存取，此時間不受 " "NTP 調整的影響。" -#: ../../library/time.rst:904 +#: ../../library/time.rst:909 msgid "" "Similar to :data:`CLOCK_MONOTONIC_RAW`, but reads a value cached by the " "system at context switch and hence has less accuracy." @@ -1582,11 +1590,11 @@ msgstr "" "類似於 :data:`CLOCK_MONOTONIC_RAW`，但讀取的是系統在情境切換時快取的值，因此" "精準度較低。" -#: ../../library/time.rst:914 ../../library/time.rst:923 +#: ../../library/time.rst:919 ../../library/time.rst:928 msgid "High-resolution per-process timer from the CPU." msgstr "來自 CPU 的高解析度每個行程的計時器。" -#: ../../library/time.rst:931 +#: ../../library/time.rst:936 msgid "" "`International Atomic Time `_" @@ -1594,18 +1602,18 @@ msgstr "" "`國際原子時間 `_" -#: ../../library/time.rst:933 +#: ../../library/time.rst:938 msgid "" "The system must have a current leap second table in order for this to give " "the correct answer. PTP or NTP software can maintain a leap second table." msgstr "" "系統必須擁有目前的閏秒表才能給出正確答案。PTP 或 NTP 軟體可以維護閏秒表。" -#: ../../library/time.rst:942 +#: ../../library/time.rst:947 msgid "Thread-specific CPU-time clock." msgstr "執行緒相關的 CPU 時間時鐘。" -#: ../../library/time.rst:951 +#: ../../library/time.rst:956 msgid "" "Time whose absolute value is the time the system has been running and not " "suspended, providing accurate uptime measurement, both absolute and interval." @@ -1613,7 +1621,7 @@ msgstr "" "表示系統運作且無暫停的絕對時間，提供包括絕對時間 (absolute) 和時間區間 " "(interval) 的精確的正常上線時間 (uptime) 測量。" -#: ../../library/time.rst:962 +#: ../../library/time.rst:967 msgid "" "Clock that increments monotonically, tracking the time since an arbitrary " "point, unaffected by frequency or time adjustments and not incremented while " @@ -1622,7 +1630,7 @@ msgstr "" "單調增量的時鐘，從某個任意點開始計時，不受頻率或時間調整影響，並且在系統休眠" "時不增量。" -#: ../../library/time.rst:972 +#: ../../library/time.rst:977 msgid "" "Like :data:`CLOCK_UPTIME_RAW`, but the value is cached by the system at " "context switches and therefore has less accuracy." @@ -1630,23 +1638,23 @@ msgstr "" "類似於 :data:`CLOCK_UPTIME_RAW`，但該值在情境切換時由系統快取，因此精準度較" "低。" -#: ../../library/time.rst:979 +#: ../../library/time.rst:984 msgid "" "The following constant is the only parameter that can be sent to :func:" "`clock_settime`." msgstr "以下常數是唯一可以傳遞給 :func:`clock_settime` 的參數。" -#: ../../library/time.rst:985 +#: ../../library/time.rst:990 msgid "" "System-wide real-time clock. Setting this clock requires appropriate " "privileges." msgstr "涵蓋整個系統的即時時鐘。設定此時鐘需要適當的權限。" -#: ../../library/time.rst:996 +#: ../../library/time.rst:1001 msgid "Timezone Constants" msgstr "時區常數" -#: ../../library/time.rst:1000 +#: ../../library/time.rst:1005 msgid "" "The offset of the local DST timezone, in seconds west of UTC, if one is " "defined. This is negative if the local DST timezone is east of UTC (as in " @@ -1657,11 +1665,11 @@ msgstr "" "為單位）。若本地 DST 時區位於 UTC 以東（例如包括英國在內的西歐），則此值為負" "值。僅在 ``daylight`` 為非零時使用此值。詳情請參見下方註釋。" -#: ../../library/time.rst:1006 +#: ../../library/time.rst:1011 msgid "Nonzero if a DST timezone is defined. See note below." msgstr "如果定義了 DST 時區，則為非零值。詳情請參見下方註釋。" -#: ../../library/time.rst:1010 +#: ../../library/time.rst:1015 msgid "" "The offset of the local (non-DST) timezone, in seconds west of UTC (negative " "in most of Western Europe, positive in the US, zero in the UK). See note " @@ -1670,7 +1678,7 @@ msgstr "" "本地（非 DST）時區相對於 UTC 以西的偏移量（以秒為單位），西歐大多數地區為負，" "美國為正，英國為零。詳情請參見下方註釋。" -#: ../../library/time.rst:1015 +#: ../../library/time.rst:1020 msgid "" "A tuple of two strings: the first is the name of the local non-DST timezone, " "the second is the name of the local DST timezone. If no DST timezone is " @@ -1679,7 +1687,7 @@ msgstr "" "一個包含兩個字串的元組：第一個是本地非 DST 時區的名稱，第二個是本地 DST 時區" "的名稱。如果沒有定義 DST 時區，則不應使用第二個字串。詳情請參見下方註釋。" -#: ../../library/time.rst:1021 +#: ../../library/time.rst:1026 msgid "" "For the above Timezone constants (:data:`altzone`, :data:`daylight`, :data:" "`timezone`, and :data:`tzname`), the value is determined by the timezone " @@ -1693,19 +1701,19 @@ msgstr "" "決定，且過去的時間可能會不準確。建議使用 :func:`localtime` 回傳的 :attr:" "`~struct_time.tm_gmtoff` 和 :attr:`~struct_time.tm_zone` 來取得時區資訊。" -#: ../../library/time.rst:1030 +#: ../../library/time.rst:1035 msgid "Module :mod:`datetime`" msgstr ":mod:`datetime` 模組" -#: ../../library/time.rst:1031 +#: ../../library/time.rst:1036 msgid "More object-oriented interface to dates and times." msgstr "更多物件導向的日期和時間介面。" -#: ../../library/time.rst:1033 +#: ../../library/time.rst:1038 msgid "Module :mod:`locale`" msgstr ":mod:`locale` 模組" -#: ../../library/time.rst:1034 +#: ../../library/time.rst:1039 msgid "" "Internationalization services. The locale setting affects the " "interpretation of many format specifiers in :func:`strftime` and :func:" @@ -1714,11 +1722,11 @@ msgstr "" "國際化服務。區域設定會影響 :func:`strftime` 和 :func:`strptime` 中許多格式指" "定符號 (format specifiers) 的解譯。" -#: ../../library/time.rst:1037 +#: ../../library/time.rst:1042 msgid "Module :mod:`calendar`" msgstr ":mod:`calendar` 模組" -#: ../../library/time.rst:1038 +#: ../../library/time.rst:1043 msgid "" "General calendar-related functions. :func:`~calendar.timegm` is the " "inverse of :func:`gmtime` from this module." @@ -1726,11 +1734,11 @@ msgstr "" "通用的日曆相關函式。:func:`~calendar.timegm` 是本模組中 :func:`gmtime` 的反函" "式。" -#: ../../library/time.rst:1042 +#: ../../library/time.rst:1047 msgid "Footnotes" msgstr "註解" -#: ../../library/time.rst:1043 +#: ../../library/time.rst:1048 msgid "" "The use of ``%Z`` is now deprecated, but the ``%z`` escape that expands to " "the preferred hour/minute offset is not supported by all ANSI C libraries. " @@ -1775,15 +1783,15 @@ msgid "Daylight Saving Time" msgstr "Daylight Saving Time（日光節約時間）" #: ../../library/time.rst:323 ../../library/time.rst:358 -#: ../../library/time.rst:733 +#: ../../library/time.rst:738 msgid "benchmarking" msgstr "benchmarking（基準測試）" -#: ../../library/time.rst:358 ../../library/time.rst:733 +#: ../../library/time.rst:358 ../../library/time.rst:738 msgid "CPU time" msgstr "CPU time（CPU 時間）" -#: ../../library/time.rst:358 ../../library/time.rst:733 +#: ../../library/time.rst:358 ../../library/time.rst:738 msgid "processor time" msgstr "processor time（處理器時間）" diff --git a/using/configure.po b/using/configure.po index b23391790f..9a9fe6d900 100644 --- a/using/configure.po +++ b/using/configure.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-22 08:51+0000\n" +"POT-Creation-Date: 2025-07-04 00:16+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-" @@ -46,8 +46,8 @@ msgstr "在 Windows 上需要 Microsoft Visual Studio 2017 或更新版本。" #: ../../using/configure.rst:19 msgid "" "Support for `IEEE 754 `_ floating-" -"point numbers and `floating-point Not-a-Number (NaN) `_." +"point numbers and `floating-point Not-a-Number (NaN) `_." msgstr "" "支援 `IEEE 754 `_ 浮點數與\\ `浮點數" "非數值 (NaN) `_。" @@ -74,15 +74,21 @@ msgstr "" #: ../../using/configure.rst:32 msgid "" -"Autoconf 2.71 and aclocal 1.16.5 are required to regenerate " -"the :file:`configure` script." +"`libmpdec `_ 2.5.0 for " +"the :mod:`decimal` module." msgstr "" #: ../../using/configure.rst:35 +msgid "" +"Autoconf 2.71 and aclocal 1.16.5 are required to regenerate the :file:" +"`configure` script." +msgstr "" + +#: ../../using/configure.rst:38 msgid "Tcl/Tk version 8.3.1 is now required." msgstr "Tcl/Tk version 8.3.1 現在是必要的。" -#: ../../using/configure.rst:38 +#: ../../using/configure.rst:41 msgid "" "On Windows, Visual Studio 2015 or later is now required. Tcl/Tk version 8.4 " "is now required." @@ -90,48 +96,48 @@ msgstr "" "在 Windows 上，Visual Studio 2015 或更新版本與 Tcl/Tk version 8.4 現在是必要" "的。" -#: ../../using/configure.rst:42 +#: ../../using/configure.rst:45 msgid "" "Selected C99 features are now required, like ```` and ``static " "inline`` functions." msgstr "" -#: ../../using/configure.rst:46 +#: ../../using/configure.rst:49 msgid "Thread support and OpenSSL 1.0.2 are now required." msgstr "對執行緒與 OpenSSL 1.0.2 的支援現在是必要的。" -#: ../../using/configure.rst:49 +#: ../../using/configure.rst:52 msgid "OpenSSL 1.1.1 is now required. Require SQLite 3.7.15." msgstr "OpenSSL 1.1.1 現在是必要的。需要 SQLite 3.7.15。" -#: ../../using/configure.rst:53 +#: ../../using/configure.rst:56 msgid "" "C11 compiler, IEEE 754 and NaN support are now required. On Windows, Visual " "Studio 2017 or later is required. Tcl/Tk version 8.5.12 is now required for " "the :mod:`tkinter` module." msgstr "" -#: ../../using/configure.rst:58 +#: ../../using/configure.rst:61 msgid "Autoconf 2.71, aclocal 1.16.5 and SQLite 3.15.2 are now required." msgstr "" -#: ../../using/configure.rst:61 +#: ../../using/configure.rst:64 msgid "" "See also :pep:`7` \"Style Guide for C Code\" and :pep:`11` \"CPython " "platform support\"." msgstr "" -#: ../../using/configure.rst:66 +#: ../../using/configure.rst:69 msgid "Generated files" msgstr "產生的檔案" -#: ../../using/configure.rst:68 +#: ../../using/configure.rst:71 msgid "" "To reduce build dependencies, Python source code contains multiple generated " "files. Commands to regenerate all generated files::" msgstr "" -#: ../../using/configure.rst:71 +#: ../../using/configure.rst:74 msgid "" "make regen-all\n" "make regen-stdlib-module-names\n" @@ -143,17 +149,17 @@ msgstr "" "make regen-limited-abi\n" "make regen-configure" -#: ../../using/configure.rst:76 +#: ../../using/configure.rst:79 msgid "" "The ``Makefile.pre.in`` file documents generated files, their inputs, and " "tools used to regenerate them. Search for ``regen-*`` make targets." msgstr "" -#: ../../using/configure.rst:80 +#: ../../using/configure.rst:83 msgid "configure script" msgstr "設定腳本" -#: ../../using/configure.rst:82 +#: ../../using/configure.rst:85 msgid "" "The ``make regen-configure`` command regenerates the ``aclocal.m4`` file and " "the ``configure`` script using the ``Tools/build/regen-configure.sh`` shell " @@ -161,107 +167,107 @@ msgid "" "have a reproducible output." msgstr "" -#: ../../using/configure.rst:87 +#: ../../using/configure.rst:90 msgid "The container is optional, the following command can be run locally::" msgstr "" -#: ../../using/configure.rst:89 +#: ../../using/configure.rst:92 msgid "autoreconf -ivf -Werror" msgstr "autoreconf -ivf -Werror" -#: ../../using/configure.rst:91 +#: ../../using/configure.rst:94 msgid "" "The generated files can change depending on the exact ``autoconf-archive``, " "``aclocal`` and ``pkg-config`` versions." msgstr "" -#: ../../using/configure.rst:98 +#: ../../using/configure.rst:101 msgid "Configure Options" msgstr "設定選項" -#: ../../using/configure.rst:100 +#: ../../using/configure.rst:103 msgid "List all :file:`configure` script options using::" msgstr "使用以下命令列出所有 :file:`configure` 腳本選項： ::" -#: ../../using/configure.rst:102 +#: ../../using/configure.rst:105 msgid "./configure --help" msgstr "./configure --help" -#: ../../using/configure.rst:104 +#: ../../using/configure.rst:107 msgid "" "See also the :file:`Misc/SpecialBuilds.txt` in the Python source " "distribution." msgstr "請見 Python 原始碼發行版中的 :file:`Misc/SpecialBuilds.txt`。" -#: ../../using/configure.rst:107 +#: ../../using/configure.rst:110 msgid "General Options" msgstr "一般選項" -#: ../../using/configure.rst:111 +#: ../../using/configure.rst:114 msgid "" "Support loadable extensions in the :mod:`!_sqlite` extension module (default " "is no) of the :mod:`sqlite3` module." msgstr "" -#: ../../using/configure.rst:114 +#: ../../using/configure.rst:117 msgid "" -"See the :meth:`sqlite3.Connection.enable_load_extension` method of " -"the :mod:`sqlite3` module." +"See the :meth:`sqlite3.Connection.enable_load_extension` method of the :mod:" +"`sqlite3` module." msgstr "" "請見 :mod:`sqlite3` 模組的 :meth:`sqlite3.Connection.enable_load_extension` " "方法。" -#: ../../using/configure.rst:121 +#: ../../using/configure.rst:124 msgid "" -"Disable IPv6 support (enabled by default if supported), see " -"the :mod:`socket` module." +"Disable IPv6 support (enabled by default if supported), see the :mod:" +"`socket` module." msgstr "停用 IPv6 支援（如果支援的話預設是啟用的），請見 :mod:`socket` 模組。" -#: ../../using/configure.rst:126 +#: ../../using/configure.rst:129 msgid "Define the size in bits of Python :class:`int` digits: 15 or 30 bits." msgstr "" -#: ../../using/configure.rst:128 +#: ../../using/configure.rst:131 msgid "By default, the digit size is 30." msgstr "" -#: ../../using/configure.rst:130 +#: ../../using/configure.rst:133 msgid "Define the ``PYLONG_BITS_IN_DIGIT`` to ``15`` or ``30``." msgstr "將 ``PYLONG_BITS_IN_DIGIT`` 定義為 ``15`` 或 ``30``。" -#: ../../using/configure.rst:132 +#: ../../using/configure.rst:135 msgid "See :data:`sys.int_info.bits_per_digit `." msgstr "參閱 :data:`sys.int_info.bits_per_digit `。" -#: ../../using/configure.rst:136 +#: ../../using/configure.rst:139 msgid "Set the Python executable suffix to *SUFFIX*." msgstr "將 Python 執行檔的後綴設定為 *SUFFIX*。" -#: ../../using/configure.rst:138 +#: ../../using/configure.rst:141 msgid "" "The default suffix is ``.exe`` on Windows and macOS (``python.exe`` " -"executable), ``.js`` on Emscripten node, ``.html`` on Emscripten browser, " -"``.wasm`` on WASI, and an empty string on other platforms (``python`` " +"executable), ``.js`` on Emscripten node, ``.html`` on Emscripten browser, ``." +"wasm`` on WASI, and an empty string on other platforms (``python`` " "executable)." msgstr "" "在 Windows 和 macOS 上預設的後綴是 ``.exe`` （``python.exe`` 執行檔）、在 " "Emscripten node 上為 ``.js``、在 Emscripten 瀏覽器為 ``.html``、在 WASI 上為 " "``.wasm``，以及在其他平台為空字串（``python`` 執行檔）。" -#: ../../using/configure.rst:143 +#: ../../using/configure.rst:146 msgid "" -"The default suffix on WASM platform is one of ``.js``, ``.html`` or " -"``.wasm``." +"The default suffix on WASM platform is one of ``.js``, ``.html`` or ``." +"wasm``." msgstr "在 WASM 平台上預設的後綴是 ``.js``、``.html`` 或 ``.wasm`` 中的一個。" -#: ../../using/configure.rst:149 +#: ../../using/configure.rst:152 msgid "" "Select the default time zone search path for :const:`zoneinfo.TZPATH`. See " "the :ref:`Compile-time configuration ` of " "the :mod:`zoneinfo` module." msgstr "" -#: ../../using/configure.rst:153 +#: ../../using/configure.rst:156 msgid "" "Default: ``/usr/share/zoneinfo:/usr/lib/zoneinfo:/usr/share/lib/zoneinfo:/" "etc/zoneinfo``." @@ -269,156 +275,156 @@ msgstr "" "預設值：``/usr/share/zoneinfo:/usr/lib/zoneinfo:/usr/share/lib/zoneinfo:/etc/" "zoneinfo``。" -#: ../../using/configure.rst:155 +#: ../../using/configure.rst:158 msgid "See :data:`os.pathsep` path separator." msgstr "請見 :data:`os.pathsep` 路徑分隔符號。" -#: ../../using/configure.rst:161 +#: ../../using/configure.rst:164 msgid "" "Build the ``_decimal`` extension module using a thread-local context rather " "than a coroutine-local context (default), see the :mod:`decimal` module." msgstr "" -#: ../../using/configure.rst:164 +#: ../../using/configure.rst:167 msgid "See :const:`decimal.HAVE_CONTEXTVAR` and the :mod:`contextvars` module." msgstr "請見 :const:`decimal.HAVE_CONTEXTVAR` 與 :mod:`contextvars` 模組。" -#: ../../using/configure.rst:170 +#: ../../using/configure.rst:173 msgid "Override order to check db backends for the :mod:`dbm` module" msgstr "" -#: ../../using/configure.rst:172 +#: ../../using/configure.rst:175 msgid "" "A valid value is a colon (``:``) separated string with the backend names:" msgstr "" -#: ../../using/configure.rst:174 +#: ../../using/configure.rst:177 msgid "``ndbm``;" msgstr "``ndbm``;" -#: ../../using/configure.rst:175 +#: ../../using/configure.rst:178 msgid "``gdbm``;" msgstr "``gdbm``;" -#: ../../using/configure.rst:176 +#: ../../using/configure.rst:179 msgid "``bdb``." msgstr "``bdb``." -#: ../../using/configure.rst:180 +#: ../../using/configure.rst:183 msgid "Disable C locale coercion to a UTF-8 based locale (enabled by default)." msgstr "" -#: ../../using/configure.rst:182 +#: ../../using/configure.rst:185 msgid "Don't define the ``PY_COERCE_C_LOCALE`` macro." msgstr "不要定義 ``PY_COERCE_C_LOCALE`` 巨集。" -#: ../../using/configure.rst:184 +#: ../../using/configure.rst:187 msgid "See :envvar:`PYTHONCOERCECLOCALE` and the :pep:`538`." msgstr "請見 :envvar:`PYTHONCOERCECLOCALE` 與 :pep:`538`。" -#: ../../using/configure.rst:188 +#: ../../using/configure.rst:191 msgid "Disable all freelists except the empty tuple singleton." msgstr "" -#: ../../using/configure.rst:194 +#: ../../using/configure.rst:197 msgid "Python library directory name (default is ``lib``)." msgstr "Python 函式庫目錄名稱（預設為 ``lib`` ）。" -#: ../../using/configure.rst:196 +#: ../../using/configure.rst:199 msgid "Fedora and SuSE use ``lib64`` on 64-bit platforms." msgstr "Fedora 和 SuSE 在 64 位元平台上使用 ``lib64``。" -#: ../../using/configure.rst:198 +#: ../../using/configure.rst:201 msgid "See :data:`sys.platlibdir`." msgstr "參閱 :data:`sys.platlibdir`。" -#: ../../using/configure.rst:204 +#: ../../using/configure.rst:207 msgid "" "Directory of wheel packages used by the :mod:`ensurepip` module (none by " "default)." msgstr "" -#: ../../using/configure.rst:207 +#: ../../using/configure.rst:210 msgid "" "Some Linux distribution packaging policies recommend against bundling " "dependencies. For example, Fedora installs wheel packages in the ``/usr/" -"share/python-wheels/`` directory and don't install the :mod:`!" -"ensurepip._bundled` package." +"share/python-wheels/`` directory and don't install the :mod:`!ensurepip." +"_bundled` package." msgstr "" -#: ../../using/configure.rst:216 +#: ../../using/configure.rst:219 msgid "" "Whether configure should use :program:`pkg-config` to detect build " "dependencies." msgstr "" -#: ../../using/configure.rst:219 +#: ../../using/configure.rst:222 msgid "``check`` (default): :program:`pkg-config` is optional" msgstr "``check``\\ （預設）：:program:`pkg-config` 是可選的" -#: ../../using/configure.rst:220 +#: ../../using/configure.rst:223 msgid "``yes``: :program:`pkg-config` is mandatory" msgstr "``yes``：:program:`pkg-config` 是必要的" -#: ../../using/configure.rst:221 +#: ../../using/configure.rst:224 msgid "``no``: configure does not use :program:`pkg-config` even when present" msgstr "``no``：即使存在也不使用 :program:`pkg-config` 來配置" -#: ../../using/configure.rst:227 +#: ../../using/configure.rst:230 msgid "Turn on internal Python performance statistics gathering." msgstr "" -#: ../../using/configure.rst:229 +#: ../../using/configure.rst:232 msgid "" "By default, statistics gathering is off. Use ``python3 -X pystats`` command " "or set ``PYTHONSTATS=1`` environment variable to turn on statistics " "gathering at Python startup." msgstr "" -#: ../../using/configure.rst:233 +#: ../../using/configure.rst:236 msgid "" "At Python exit, dump statistics if statistics gathering was on and not " "cleared." msgstr "" -#: ../../using/configure.rst:236 ../../using/configure.rst:725 +#: ../../using/configure.rst:239 ../../using/configure.rst:728 msgid "Effects:" msgstr "效果：" -#: ../../using/configure.rst:238 +#: ../../using/configure.rst:241 msgid "Add :option:`-X pystats <-X>` command line option." msgstr "新增 :option:`-X pystats <-X>` 命令列選項。" -#: ../../using/configure.rst:239 +#: ../../using/configure.rst:242 msgid "Add :envvar:`!PYTHONSTATS` environment variable." msgstr "新增 :envvar:`!PYTHONSTATS` 環境變數。" -#: ../../using/configure.rst:240 +#: ../../using/configure.rst:243 msgid "Define the ``Py_STATS`` macro." msgstr "定義 ``Py_STATS`` 巨集。" -#: ../../using/configure.rst:241 +#: ../../using/configure.rst:244 msgid "Add functions to the :mod:`sys` module:" msgstr "新增函式到 :mod:`sys` 模組。" -#: ../../using/configure.rst:243 +#: ../../using/configure.rst:246 msgid ":func:`!sys._stats_on`: Turns on statistics gathering." msgstr ":func:`!sys._stats_on`：啟用統計資料收集。" -#: ../../using/configure.rst:244 +#: ../../using/configure.rst:247 msgid ":func:`!sys._stats_off`: Turns off statistics gathering." msgstr ":func:`!sys._stats_off`：關閉統計資料收集。" -#: ../../using/configure.rst:245 +#: ../../using/configure.rst:248 msgid ":func:`!sys._stats_clear`: Clears the statistics." msgstr ":func:`!sys._stats_clear`：清除統計資料。" -#: ../../using/configure.rst:246 +#: ../../using/configure.rst:249 msgid "" ":func:`!sys._stats_dump`: Dump statistics to file, and clears the statistics." msgstr ":func:`!sys._stats_dump`：將統計資料轉儲到檔案，並清除統計資料。" -#: ../../using/configure.rst:248 +#: ../../using/configure.rst:251 msgid "" "The statistics will be dumped to a arbitrary (probably unique) file in ``/" "tmp/py_stats/`` (Unix) or ``C:\\temp\\py_stats\\`` (Windows). If that " @@ -428,377 +434,377 @@ msgstr "" "(Windows) 中的任意（可能是唯一的）檔案。如果該目錄不存在，結果將被列印到 " "stderr。" -#: ../../using/configure.rst:252 +#: ../../using/configure.rst:255 msgid "Use ``Tools/scripts/summarize_stats.py`` to read the stats." msgstr "使用 ``Tools/scripts/summarize_stats.py`` 來讀取統計資料。" -#: ../../using/configure.rst:254 +#: ../../using/configure.rst:257 msgid "Statistics:" msgstr "" -#: ../../using/configure.rst:256 +#: ../../using/configure.rst:259 msgid "Opcode:" msgstr "" -#: ../../using/configure.rst:258 +#: ../../using/configure.rst:261 msgid "Specialization: success, failure, hit, deferred, miss, deopt, failures;" msgstr "" -#: ../../using/configure.rst:259 +#: ../../using/configure.rst:262 msgid "Execution count;" msgstr "" -#: ../../using/configure.rst:260 +#: ../../using/configure.rst:263 msgid "Pair count." msgstr "" -#: ../../using/configure.rst:262 +#: ../../using/configure.rst:265 msgid "Call:" msgstr "" -#: ../../using/configure.rst:264 +#: ../../using/configure.rst:267 msgid "Inlined Python calls;" msgstr "" -#: ../../using/configure.rst:265 +#: ../../using/configure.rst:268 msgid "PyEval calls;" msgstr "" -#: ../../using/configure.rst:266 +#: ../../using/configure.rst:269 msgid "Frames pushed;" msgstr "" -#: ../../using/configure.rst:267 +#: ../../using/configure.rst:270 msgid "Frame object created;" msgstr "" -#: ../../using/configure.rst:268 +#: ../../using/configure.rst:271 msgid "" "Eval calls: vector, generator, legacy, function VECTORCALL, build class, " "slot, function \"ex\", API, method." msgstr "" -#: ../../using/configure.rst:271 +#: ../../using/configure.rst:274 msgid "Object:" msgstr "物件：" -#: ../../using/configure.rst:273 +#: ../../using/configure.rst:276 msgid "incref and decref;" msgstr "" -#: ../../using/configure.rst:274 +#: ../../using/configure.rst:277 msgid "interpreter incref and decref;" msgstr "" -#: ../../using/configure.rst:275 +#: ../../using/configure.rst:278 msgid "allocations: all, 512 bytes, 4 kiB, big;" msgstr "" -#: ../../using/configure.rst:276 +#: ../../using/configure.rst:279 msgid "free;" msgstr "" -#: ../../using/configure.rst:277 +#: ../../using/configure.rst:280 msgid "to/from free lists;" msgstr "" -#: ../../using/configure.rst:278 +#: ../../using/configure.rst:281 msgid "dictionary materialized/dematerialized;" msgstr "" -#: ../../using/configure.rst:279 +#: ../../using/configure.rst:282 msgid "type cache;" msgstr "" -#: ../../using/configure.rst:280 +#: ../../using/configure.rst:283 msgid "optimization attempts;" msgstr "最佳化嘗試；" -#: ../../using/configure.rst:281 +#: ../../using/configure.rst:284 msgid "optimization traces created/executed;" msgstr "" -#: ../../using/configure.rst:282 +#: ../../using/configure.rst:285 msgid "uops executed." msgstr "" -#: ../../using/configure.rst:284 +#: ../../using/configure.rst:287 msgid "Garbage collector:" msgstr "" -#: ../../using/configure.rst:286 +#: ../../using/configure.rst:289 msgid "Garbage collections;" msgstr "" -#: ../../using/configure.rst:287 +#: ../../using/configure.rst:290 msgid "Objects visited;" msgstr "" -#: ../../using/configure.rst:288 +#: ../../using/configure.rst:291 msgid "Objects collected." msgstr "" -#: ../../using/configure.rst:296 +#: ../../using/configure.rst:299 msgid "" -"Enables **experimental** support for running Python without " -"the :term:`global interpreter lock` (GIL): free threading build." +"Enables **experimental** support for running Python without the :term:" +"`global interpreter lock` (GIL): free threading build." msgstr "" -#: ../../using/configure.rst:299 +#: ../../using/configure.rst:302 msgid "" -"Defines the ``Py_GIL_DISABLED`` macro and adds ``\"t\"`` " -"to :data:`sys.abiflags`." +"Defines the ``Py_GIL_DISABLED`` macro and adds ``\"t\"`` to :data:`sys." +"abiflags`." msgstr "" -#: ../../using/configure.rst:302 +#: ../../using/configure.rst:305 msgid "See :ref:`whatsnew313-free-threaded-cpython` for more detail." msgstr "" -#: ../../using/configure.rst:308 +#: ../../using/configure.rst:311 msgid "" "Indicate how to integrate the :ref:`JIT compiler `." msgstr "" -#: ../../using/configure.rst:310 +#: ../../using/configure.rst:313 msgid "``no`` - build the interpreter without the JIT." msgstr "" -#: ../../using/configure.rst:311 +#: ../../using/configure.rst:314 msgid "``yes`` - build the interpreter with the JIT." msgstr "" -#: ../../using/configure.rst:312 +#: ../../using/configure.rst:315 msgid "" "``yes-off`` - build the interpreter with the JIT but disable it by default." msgstr "" -#: ../../using/configure.rst:313 +#: ../../using/configure.rst:316 msgid "" "``interpreter`` - build the interpreter without the JIT, but with the tier 2 " "enabled interpreter." msgstr "" -#: ../../using/configure.rst:315 +#: ../../using/configure.rst:318 msgid "" "By convention, ``--enable-experimental-jit`` is a shorthand for ``--enable-" "experimental-jit=yes``." msgstr "" -#: ../../using/configure.rst:319 +#: ../../using/configure.rst:322 msgid "" "When building CPython with JIT enabled, ensure that your system has Python " "3.11 or later installed." msgstr "" -#: ../../using/configure.rst:325 +#: ../../using/configure.rst:328 msgid "Path to ``pkg-config`` utility." msgstr "" -#: ../../using/configure.rst:330 +#: ../../using/configure.rst:333 msgid "``pkg-config`` options." msgstr "``pkg-config`` 選項。" -#: ../../using/configure.rst:334 +#: ../../using/configure.rst:337 msgid "C compiler options" msgstr "C 編譯器選項。" -#: ../../using/configure.rst:338 ../../using/configure.rst:1251 +#: ../../using/configure.rst:341 ../../using/configure.rst:1254 msgid "C compiler command." msgstr "C 編譯器指令。" -#: ../../using/configure.rst:342 ../../using/configure.rst:1263 +#: ../../using/configure.rst:345 ../../using/configure.rst:1266 msgid "C compiler flags." msgstr "C 編譯器旗標。" -#: ../../using/configure.rst:346 +#: ../../using/configure.rst:349 msgid "C preprocessor command." msgstr "C 預處理器指令。" -#: ../../using/configure.rst:350 +#: ../../using/configure.rst:353 msgid "C preprocessor flags, e.g. :samp:`-I{include_dir}`." msgstr "C 預處理器旗標，例如：:samp:`-I{include_dir}`。" -#: ../../using/configure.rst:354 ../../using/configure.rst:796 +#: ../../using/configure.rst:357 ../../using/configure.rst:799 msgid "Linker options" msgstr "" -#: ../../using/configure.rst:358 +#: ../../using/configure.rst:361 msgid "Linker flags, e.g. :samp:`-L{library_directory}`." msgstr "" -#: ../../using/configure.rst:362 +#: ../../using/configure.rst:365 msgid "Libraries to pass to the linker, e.g. :samp:`-l{library}`." msgstr "" -#: ../../using/configure.rst:366 +#: ../../using/configure.rst:369 msgid "Name for machine-dependent library files." msgstr "" -#: ../../using/configure.rst:370 +#: ../../using/configure.rst:373 msgid "Options for third-party dependencies" msgstr "" -#: ../../using/configure.rst:377 +#: ../../using/configure.rst:380 msgid "" "C compiler and linker flags to link Python to ``libbz2``, used by :mod:`bz2` " "module, overriding ``pkg-config``." msgstr "" -#: ../../using/configure.rst:383 +#: ../../using/configure.rst:386 msgid "" -"C compiler and linker flags for ``libncurses`` or ``libncursesw``, used " -"by :mod:`curses` module, overriding ``pkg-config``." +"C compiler and linker flags for ``libncurses`` or ``libncursesw``, used by :" +"mod:`curses` module, overriding ``pkg-config``." msgstr "" -#: ../../using/configure.rst:389 +#: ../../using/configure.rst:392 msgid "C compiler and linker flags for ``gdbm``." msgstr "" -#: ../../using/configure.rst:394 +#: ../../using/configure.rst:397 msgid "" "C compiler and linker flags for ``libb2`` (:ref:`BLAKE2 `), " "used by :mod:`hashlib` module, overriding ``pkg-config``." msgstr "" -#: ../../using/configure.rst:400 +#: ../../using/configure.rst:403 msgid "" "C compiler and linker flags for ``libedit``, used by :mod:`readline` module, " "overriding ``pkg-config``." msgstr "" -#: ../../using/configure.rst:406 +#: ../../using/configure.rst:409 msgid "" "C compiler and linker flags for ``libffi``, used by :mod:`ctypes` module, " "overriding ``pkg-config``." msgstr "" -#: ../../using/configure.rst:412 +#: ../../using/configure.rst:415 msgid "" "C compiler and linker flags for ``libmpdec``, used by :mod:`decimal` module, " "overriding ``pkg-config``." msgstr "" -#: ../../using/configure.rst:417 +#: ../../using/configure.rst:420 msgid "" "These environment variables have no effect unless :option:`--with-system-" "libmpdec` is specified." msgstr "" -#: ../../using/configure.rst:423 +#: ../../using/configure.rst:426 msgid "" "C compiler and linker flags for ``liblzma``, used by :mod:`lzma` module, " "overriding ``pkg-config``." msgstr "" -#: ../../using/configure.rst:429 +#: ../../using/configure.rst:432 msgid "" "C compiler and linker flags for ``libreadline``, used by :mod:`readline` " "module, overriding ``pkg-config``." msgstr "" -#: ../../using/configure.rst:435 +#: ../../using/configure.rst:438 msgid "" "C compiler and linker flags for ``libsqlite3``, used by :mod:`sqlite3` " "module, overriding ``pkg-config``." msgstr "" -#: ../../using/configure.rst:441 +#: ../../using/configure.rst:444 msgid "" "C compiler and linker flags for ``libuuid``, used by :mod:`uuid` module, " "overriding ``pkg-config``." msgstr "" -#: ../../using/configure.rst:447 +#: ../../using/configure.rst:450 msgid "C compiler and linker flags for PANEL, overriding ``pkg-config``." msgstr "" -#: ../../using/configure.rst:449 +#: ../../using/configure.rst:452 msgid "" -"C compiler and linker flags for ``libpanel`` or ``libpanelw``, used " -"by :mod:`curses.panel` module, overriding ``pkg-config``." +"C compiler and linker flags for ``libpanel`` or ``libpanelw``, used by :mod:" +"`curses.panel` module, overriding ``pkg-config``." msgstr "" -#: ../../using/configure.rst:455 +#: ../../using/configure.rst:458 msgid "C compiler and linker flags for TCLTK, overriding ``pkg-config``." msgstr "" -#: ../../using/configure.rst:460 +#: ../../using/configure.rst:463 msgid "" "C compiler and linker flags for ``libzlib``, used by :mod:`gzip` module, " "overriding ``pkg-config``." msgstr "" -#: ../../using/configure.rst:465 +#: ../../using/configure.rst:468 msgid "WebAssembly Options" msgstr "WebAssembly 選項" -#: ../../using/configure.rst:469 +#: ../../using/configure.rst:472 msgid "Set build flavor for ``wasm32-emscripten``." msgstr "" -#: ../../using/configure.rst:471 +#: ../../using/configure.rst:474 msgid "``browser`` (default): preload minimal stdlib, default MEMFS." msgstr "" -#: ../../using/configure.rst:472 +#: ../../using/configure.rst:475 msgid "``node``: NODERAWFS and pthread support." msgstr "``node``：對 NODERAWFS 和 pthread 支援。" -#: ../../using/configure.rst:478 +#: ../../using/configure.rst:481 msgid "Turn on dynamic linking support for WASM." msgstr "" -#: ../../using/configure.rst:480 +#: ../../using/configure.rst:483 msgid "" "Dynamic linking enables ``dlopen``. File size of the executable increases " "due to limited dead code elimination and additional features." msgstr "" -#: ../../using/configure.rst:487 +#: ../../using/configure.rst:490 msgid "Turn on pthreads support for WASM." msgstr "" -#: ../../using/configure.rst:493 +#: ../../using/configure.rst:496 msgid "Install Options" msgstr "安裝選項" -#: ../../using/configure.rst:497 +#: ../../using/configure.rst:500 msgid "" -"Install architecture-independent files in PREFIX. On Unix, it defaults " -"to :file:`/usr/local`." +"Install architecture-independent files in PREFIX. On Unix, it defaults to :" +"file:`/usr/local`." msgstr "" -#: ../../using/configure.rst:500 +#: ../../using/configure.rst:503 msgid "This value can be retrieved at runtime using :data:`sys.prefix`." msgstr "這個值可以在 runtime 使用 :data:`sys.prefix` 取得。" -#: ../../using/configure.rst:502 +#: ../../using/configure.rst:505 msgid "" "As an example, one can use ``--prefix=\"$HOME/.local/\"`` to install a " "Python in its home directory." msgstr "" -#: ../../using/configure.rst:507 +#: ../../using/configure.rst:510 msgid "" "Install architecture-dependent files in EPREFIX, defaults to :option:`--" "prefix`." msgstr "" -#: ../../using/configure.rst:509 +#: ../../using/configure.rst:512 msgid "This value can be retrieved at runtime using :data:`sys.exec_prefix`." msgstr "這個值可以在 runtime 使用 :data:`sys.exec_prefix` 取得" -#: ../../using/configure.rst:513 +#: ../../using/configure.rst:516 msgid "" -"Don't build nor install test modules, like the :mod:`test` package or " -"the :mod:`!_testcapi` extension module (built and installed by default)." +"Don't build nor install test modules, like the :mod:`test` package or the :" +"mod:`!_testcapi` extension module (built and installed by default)." msgstr "" -#: ../../using/configure.rst:520 +#: ../../using/configure.rst:523 msgid "Select the :mod:`ensurepip` command run on Python installation:" msgstr "選擇在 Python 安裝時執行的 :mod:`ensurepip` 命令：" -#: ../../using/configure.rst:522 +#: ../../using/configure.rst:525 msgid "" "``upgrade`` (default): run ``python -m ensurepip --altinstall --upgrade`` " "command." @@ -806,45 +812,45 @@ msgstr "" "``upgrade`` （預設）：執行 ``python -m ensurepip --altinstall --upgrade`` 命" "令。" -#: ../../using/configure.rst:524 +#: ../../using/configure.rst:527 msgid "``install``: run ``python -m ensurepip --altinstall`` command;" msgstr "``install``：執行 ``python -m ensurepip --altinstall`` 命令；" -#: ../../using/configure.rst:525 +#: ../../using/configure.rst:528 msgid "``no``: don't run ensurepip;" msgstr "``no``：不要執行 ensurepip；" -#: ../../using/configure.rst:531 +#: ../../using/configure.rst:534 msgid "Performance options" msgstr "效能選項" -#: ../../using/configure.rst:533 +#: ../../using/configure.rst:536 msgid "" "Configuring Python using ``--enable-optimizations --with-lto`` (PGO + LTO) " "is recommended for best performance. The experimental ``--enable-bolt`` flag " "can also be used to improve performance." msgstr "" -#: ../../using/configure.rst:539 +#: ../../using/configure.rst:542 msgid "" "Enable Profile Guided Optimization (PGO) using :envvar:`PROFILE_TASK` " "(disabled by default)." msgstr "" -#: ../../using/configure.rst:542 +#: ../../using/configure.rst:545 msgid "" "The C compiler Clang requires ``llvm-profdata`` program for PGO. On macOS, " "GCC also requires it: GCC is just an alias to Clang on macOS." msgstr "" -#: ../../using/configure.rst:545 +#: ../../using/configure.rst:548 msgid "" "Disable also semantic interposition in libpython if ``--enable-shared`` and " "GCC is used: add ``-fno-semantic-interposition`` to the compiler and linker " "flags." msgstr "" -#: ../../using/configure.rst:551 +#: ../../using/configure.rst:554 msgid "" "During the build, you may encounter compiler warnings about profile data not " "being available for some source files. These warnings are harmless, as only " @@ -853,58 +859,58 @@ msgid "" "profile-instr-unprofiled`` to :envvar:`CFLAGS`." msgstr "" -#: ../../using/configure.rst:560 +#: ../../using/configure.rst:563 msgid "Use ``-fno-semantic-interposition`` on GCC." msgstr "在 GCC 上使用 ``-fno-semantic-interposition``。" -#: ../../using/configure.rst:565 +#: ../../using/configure.rst:568 msgid "" "Environment variable used in the Makefile: Python command line arguments for " "the PGO generation task." msgstr "" -#: ../../using/configure.rst:568 +#: ../../using/configure.rst:571 msgid "Default: ``-m test --pgo --timeout=$(TESTTIMEOUT)``." msgstr "預設值：``-m test --pgo --timeout=$(TESTTIMEOUT)``。" -#: ../../using/configure.rst:572 +#: ../../using/configure.rst:575 msgid "Task failure is no longer ignored silently." msgstr "" -#: ../../using/configure.rst:577 +#: ../../using/configure.rst:580 msgid "Enable Link Time Optimization (LTO) in any build (disabled by default)." msgstr "" -#: ../../using/configure.rst:579 +#: ../../using/configure.rst:582 msgid "" "The C compiler Clang requires ``llvm-ar`` for LTO (``ar`` on macOS), as well " "as an LTO-aware linker (``ld.gold`` or ``lld``)." msgstr "" -#: ../../using/configure.rst:584 +#: ../../using/configure.rst:587 msgid "To use ThinLTO feature, use ``--with-lto=thin`` on Clang." msgstr "" -#: ../../using/configure.rst:587 +#: ../../using/configure.rst:590 msgid "" "Use ThinLTO as the default optimization policy on Clang if the compiler " "accepts the flag." msgstr "" -#: ../../using/configure.rst:592 +#: ../../using/configure.rst:595 msgid "" "Enable usage of the `BOLT post-link binary optimizer `_ (disabled by default)." msgstr "" -#: ../../using/configure.rst:596 +#: ../../using/configure.rst:599 msgid "" "BOLT is part of the LLVM project but is not always included in their binary " "distributions. This flag requires that ``llvm-bolt`` and ``merge-fdata`` are " "available." msgstr "" -#: ../../using/configure.rst:600 +#: ../../using/configure.rst:603 msgid "" "BOLT is still a fairly new project so this flag should be considered " "experimental for now. Because this tool operates on machine code its success " @@ -915,124 +921,124 @@ msgid "" "encouraged." msgstr "" -#: ../../using/configure.rst:608 +#: ../../using/configure.rst:611 msgid "" -"The :envvar:`!BOLT_INSTRUMENT_FLAGS` and :envvar:`!" -"BOLT_APPLY_FLAGS` :program:`configure` variables can be defined to override " -"the default set of arguments for :program:`llvm-bolt` to instrument and " -"apply BOLT data to binaries, respectively." +"The :envvar:`!BOLT_INSTRUMENT_FLAGS` and :envvar:`!BOLT_APPLY_FLAGS` :" +"program:`configure` variables can be defined to override the default set of " +"arguments for :program:`llvm-bolt` to instrument and apply BOLT data to " +"binaries, respectively." msgstr "" -#: ../../using/configure.rst:617 +#: ../../using/configure.rst:620 msgid "" "Arguments to ``llvm-bolt`` when creating a `BOLT optimized binary `_." msgstr "" -#: ../../using/configure.rst:624 +#: ../../using/configure.rst:627 msgid "Arguments to ``llvm-bolt`` when instrumenting binaries." msgstr "" -#: ../../using/configure.rst:630 +#: ../../using/configure.rst:633 msgid "" "Enable computed gotos in evaluation loop (enabled by default on supported " "compilers)." msgstr "" -#: ../../using/configure.rst:635 +#: ../../using/configure.rst:638 msgid "" "Disable the fast :ref:`mimalloc ` allocator (enabled by default)." msgstr "" -#: ../../using/configure.rst:638 ../../using/configure.rst:645 +#: ../../using/configure.rst:641 ../../using/configure.rst:648 msgid "See also :envvar:`PYTHONMALLOC` environment variable." msgstr "另請參閱 :envvar:`PYTHONMALLOC` 環境變數。" -#: ../../using/configure.rst:642 +#: ../../using/configure.rst:645 msgid "" "Disable the specialized Python memory allocator :ref:`pymalloc ` " "(enabled by default)." msgstr "" -#: ../../using/configure.rst:649 +#: ../../using/configure.rst:652 msgid "" "Disable static documentation strings to reduce the memory footprint (enabled " "by default). Documentation strings defined in Python are not affected." msgstr "" -#: ../../using/configure.rst:652 +#: ../../using/configure.rst:655 msgid "Don't define the ``WITH_DOC_STRINGS`` macro." msgstr "不要定義 ``WITH_DOC_STRINGS`` 巨集。" -#: ../../using/configure.rst:654 +#: ../../using/configure.rst:657 msgid "See the ``PyDoc_STRVAR()`` macro." msgstr "請見 ``PyDoc_STRVAR()`` 巨集。" -#: ../../using/configure.rst:658 +#: ../../using/configure.rst:661 msgid "Enable C-level code profiling with ``gprof`` (disabled by default)." msgstr "" -#: ../../using/configure.rst:662 +#: ../../using/configure.rst:665 msgid "" "Add ``-fstrict-overflow`` to the C compiler flags (by default we add ``-fno-" "strict-overflow`` instead)." msgstr "" -#: ../../using/configure.rst:669 +#: ../../using/configure.rst:672 msgid "Python Debug Build" msgstr "" -#: ../../using/configure.rst:671 +#: ../../using/configure.rst:674 msgid "" "A debug build is Python built with the :option:`--with-pydebug` configure " "option." msgstr "" -#: ../../using/configure.rst:674 +#: ../../using/configure.rst:677 msgid "Effects of a debug build:" msgstr "" -#: ../../using/configure.rst:676 +#: ../../using/configure.rst:679 msgid "" "Display all warnings by default: the list of default warning filters is " "empty in the :mod:`warnings` module." msgstr "" -#: ../../using/configure.rst:678 +#: ../../using/configure.rst:681 msgid "Add ``d`` to :data:`sys.abiflags`." msgstr "新增 ``d`` 到 :data:`sys.abiflags`。" -#: ../../using/configure.rst:679 +#: ../../using/configure.rst:682 msgid "Add :func:`!sys.gettotalrefcount` function." msgstr "新增 :func:`!sys.gettotalrefcount` 函式。" -#: ../../using/configure.rst:680 +#: ../../using/configure.rst:683 msgid "Add :option:`-X showrefcount <-X>` command line option." msgstr "新增 :option:`-X showrefcount <-X>` 命令列選項。" -#: ../../using/configure.rst:681 +#: ../../using/configure.rst:684 msgid "" "Add :option:`-d` command line option and :envvar:`PYTHONDEBUG` environment " "variable to debug the parser." msgstr "" -#: ../../using/configure.rst:683 +#: ../../using/configure.rst:686 msgid "" "Add support for the ``__lltrace__`` variable: enable low-level tracing in " "the bytecode evaluation loop if the variable is defined." msgstr "" -#: ../../using/configure.rst:685 +#: ../../using/configure.rst:688 msgid "" "Install :ref:`debug hooks on memory allocators ` " "to detect buffer overflow and other memory errors." msgstr "" -#: ../../using/configure.rst:687 +#: ../../using/configure.rst:690 msgid "Define ``Py_DEBUG`` and ``Py_REF_DEBUG`` macros." msgstr "定義 ``Py_DEBUG`` 和 ``Py_REF_DEBUG`` 巨集。" -#: ../../using/configure.rst:688 +#: ../../using/configure.rst:691 msgid "" "Add runtime checks: code surrounded by ``#ifdef Py_DEBUG`` and ``#endif``. " "Enable ``assert(...)`` and ``_PyObject_ASSERT(...)`` assertions: don't set " @@ -1040,56 +1046,56 @@ msgid "" "option). Main runtime checks:" msgstr "" -#: ../../using/configure.rst:693 +#: ../../using/configure.rst:696 msgid "Add sanity checks on the function arguments." msgstr "" -#: ../../using/configure.rst:694 +#: ../../using/configure.rst:697 msgid "" "Unicode and int objects are created with their memory filled with a pattern " "to detect usage of uninitialized objects." msgstr "" -#: ../../using/configure.rst:696 +#: ../../using/configure.rst:699 msgid "" "Ensure that functions which can clear or replace the current exception are " "not called with an exception raised." msgstr "" -#: ../../using/configure.rst:698 +#: ../../using/configure.rst:701 msgid "Check that deallocator functions don't change the current exception." msgstr "" -#: ../../using/configure.rst:699 +#: ../../using/configure.rst:702 msgid "" "The garbage collector (:func:`gc.collect` function) runs some basic checks " "on objects consistency." msgstr "" -#: ../../using/configure.rst:701 +#: ../../using/configure.rst:704 msgid "" "The :c:macro:`!Py_SAFE_DOWNCAST()` macro checks for integer underflow and " "overflow when downcasting from wide types to narrow types." msgstr "" -#: ../../using/configure.rst:704 +#: ../../using/configure.rst:707 msgid "" "See also the :ref:`Python Development Mode ` and the :option:`--" "with-trace-refs` configure option." msgstr "" -#: ../../using/configure.rst:707 +#: ../../using/configure.rst:710 msgid "" "Release builds and debug builds are now ABI compatible: defining the " -"``Py_DEBUG`` macro no longer implies the ``Py_TRACE_REFS`` macro (see " -"the :option:`--with-trace-refs` option)." +"``Py_DEBUG`` macro no longer implies the ``Py_TRACE_REFS`` macro (see the :" +"option:`--with-trace-refs` option)." msgstr "" -#: ../../using/configure.rst:714 +#: ../../using/configure.rst:717 msgid "Debug options" msgstr "偵錯選項" -#: ../../using/configure.rst:718 +#: ../../using/configure.rst:721 msgid "" ":ref:`Build Python in debug mode `: define the ``Py_DEBUG`` " "macro (disabled by default)." @@ -1097,23 +1103,23 @@ msgstr "" ":ref:`以偵錯模式建置 Python `：定義 ``Py_DEBUG`` 巨集（預設不啟" "用）。" -#: ../../using/configure.rst:723 +#: ../../using/configure.rst:726 msgid "Enable tracing references for debugging purpose (disabled by default)." msgstr "以偵錯為目的啟用參照追蹤（預設不啟用）。" -#: ../../using/configure.rst:727 +#: ../../using/configure.rst:730 msgid "Define the ``Py_TRACE_REFS`` macro." msgstr "定義 ``Py_TRACE_REFS`` 巨集。" -#: ../../using/configure.rst:728 +#: ../../using/configure.rst:731 msgid "Add :func:`sys.getobjects` function." msgstr "新增 :func:`sys.getobjects` 函式。" -#: ../../using/configure.rst:729 +#: ../../using/configure.rst:732 msgid "Add :envvar:`PYTHONDUMPREFS` environment variable." msgstr "新增 :envvar:`PYTHONDUMPREFS` 環境變數。" -#: ../../using/configure.rst:731 +#: ../../using/configure.rst:734 msgid "" "The :envvar:`PYTHONDUMPREFS` environment variable can be used to dump " "objects and reference counts still alive at Python exit." @@ -1121,11 +1127,11 @@ msgstr "" ":envvar:`PYTHONDUMPREFS` 環境變數可以用來在 Python 結束時轉儲仍然有效的物件和" "參照計數。" -#: ../../using/configure.rst:734 +#: ../../using/configure.rst:737 msgid ":ref:`Statically allocated objects ` are not traced." msgstr "不追蹤\\ :ref:`靜態配置的物件 `。" -#: ../../using/configure.rst:738 +#: ../../using/configure.rst:741 msgid "" "This build is now ABI compatible with release build and :ref:`debug build " "`." @@ -1133,21 +1139,21 @@ msgstr "" "這個建置現在與發佈版本建置和\\ :ref:`偵錯建置 `\\ 具有 ABI 相容" "性。" -#: ../../using/configure.rst:744 +#: ../../using/configure.rst:747 msgid "" "Build with C assertions enabled (default is no): ``assert(...);`` and " "``_PyObject_ASSERT(...);``." msgstr "" -"啟用 C 斷言建置（預設不啟用）：``assert(...);`` 和 " -"``_PyObject_ASSERT(...);``。" +"啟用 C 斷言建置（預設不啟用）：``assert(...);`` 和 ``_PyObject_ASSERT(...);" +"``。" -#: ../../using/configure.rst:747 +#: ../../using/configure.rst:750 msgid "" "If set, the ``NDEBUG`` macro is not defined in the :envvar:`OPT` compiler " "variable." msgstr "如果設定，``NDEBUG`` 巨集不會在 :envvar:`OPT` 編譯器變數中定義。" -#: ../../using/configure.rst:750 +#: ../../using/configure.rst:753 msgid "" "See also the :option:`--with-pydebug` option (:ref:`debug build `) which also enables assertions." @@ -1155,46 +1161,46 @@ msgstr "" "另請參閱 :option:`--with-pydebug` 選項（:ref:`debug build `），" "它也啟用了斷言。" -#: ../../using/configure.rst:757 +#: ../../using/configure.rst:760 msgid "Enable Valgrind support (default is no)." msgstr "啟用 Valgrind 支援（預設不啟用）。" -#: ../../using/configure.rst:761 +#: ../../using/configure.rst:764 msgid "Enable DTrace support (default is no)." msgstr "啟用 DTrace 支援（預設不啟用）。" -#: ../../using/configure.rst:763 +#: ../../using/configure.rst:766 msgid "" "See :ref:`Instrumenting CPython with DTrace and SystemTap `." msgstr "" "請參閱\\ :ref:`使用 DTrace 和 SystemTap 檢測 CPython `。" -#: ../../using/configure.rst:770 +#: ../../using/configure.rst:773 msgid "" "Enable AddressSanitizer memory error detector, ``asan`` (default is no)." msgstr "啟用 AddressSanitizer 記憶體錯誤偵測器 ``asan``\\ （預設不啟用）。" -#: ../../using/configure.rst:776 +#: ../../using/configure.rst:779 msgid "" "Enable MemorySanitizer allocation error detector, ``msan`` (default is no)." msgstr "啟用 MemorySanitizer 分配錯誤偵測器 ``msan``\\ （預設不啟用）。" -#: ../../using/configure.rst:782 +#: ../../using/configure.rst:785 msgid "" "Enable UndefinedBehaviorSanitizer undefined behaviour detector, ``ubsan`` " "(default is no)." msgstr "" "啟用 UndefinedBehaviorSanitizer 未定義行為偵測器 ``ubsan``\\ （預設不啟用）。" -#: ../../using/configure.rst:789 +#: ../../using/configure.rst:792 msgid "Enable ThreadSanitizer data race detector, ``tsan`` (default is no)." msgstr "啟用 ThreadSanitizer 資料競爭偵測器 ``tsan``\\ （預設不啟用）。" -#: ../../using/configure.rst:800 +#: ../../using/configure.rst:803 msgid "Enable building a shared Python library: ``libpython`` (default is no)." msgstr "啟用建置共享 Python 函式庫：``libpython``\\ （預設不啟用）。" -#: ../../using/configure.rst:804 +#: ../../using/configure.rst:807 msgid "" "Do not build ``libpythonMAJOR.MINOR.a`` and do not install ``python.o`` " "(built and enabled by default)." @@ -1202,233 +1208,233 @@ msgstr "" "不要建置 ``libpythonMAJOR.MINOR.a`` 並且不要安裝 ``python.o``\\ （預設會建置" "並啟用）。" -#: ../../using/configure.rst:811 +#: ../../using/configure.rst:814 msgid "Libraries options" msgstr "函式庫選項" -#: ../../using/configure.rst:815 +#: ../../using/configure.rst:818 msgid "Link against additional libraries (default is no)." msgstr "" -#: ../../using/configure.rst:819 +#: ../../using/configure.rst:822 msgid "" "Build the :mod:`!pyexpat` module using an installed ``expat`` library " "(default is no)." msgstr "使用已安裝的 ``expat`` 函式庫建置 :mod:`!pyexpat` 模組（預設不建置）。" -#: ../../using/configure.rst:824 +#: ../../using/configure.rst:827 msgid "" "Build the ``_decimal`` extension module using an installed ``mpdecimal`` " "library, see the :mod:`decimal` module (default is yes)." msgstr "" -"使用已安裝的 ``mpdecimal`` 函式庫建置 ``_decimal`` 擴充模組，請參" -"閱 :mod:`decimal` 模組（預設建置）。" +"使用已安裝的 ``mpdecimal`` 函式庫建置 ``_decimal`` 擴充模組，請參閱 :mod:" +"`decimal` 模組（預設建置）。" -#: ../../using/configure.rst:829 +#: ../../using/configure.rst:832 msgid "Default to using the installed ``mpdecimal`` library." msgstr "預設使用已安裝的 ``mpdecimal`` 函式庫。" -#: ../../using/configure.rst:832 +#: ../../using/configure.rst:835 msgid "" "A copy of the ``mpdecimal`` library sources will no longer be distributed " "with Python 3.15." msgstr "Python 3.15 不再隨附 ``mpdecimal`` 函式庫的原始碼副本。" -#: ../../using/configure.rst:836 +#: ../../using/configure.rst:839 msgid ":option:`LIBMPDEC_CFLAGS` and :option:`LIBMPDEC_LIBS`." msgstr ":option:`LIBMPDEC_CFLAGS` 和 :option:`LIBMPDEC_LIBS`。" -#: ../../using/configure.rst:840 +#: ../../using/configure.rst:843 msgid "Designate a backend library for the :mod:`readline` module." msgstr "" -#: ../../using/configure.rst:842 +#: ../../using/configure.rst:845 msgid "readline: Use readline as the backend." msgstr "" -#: ../../using/configure.rst:843 +#: ../../using/configure.rst:846 msgid "editline: Use editline as the backend." msgstr "" -#: ../../using/configure.rst:849 +#: ../../using/configure.rst:852 msgid "Don't build the :mod:`readline` module (built by default)." msgstr "不要建置 :mod:`readline` 模組（預設會建置）。" -#: ../../using/configure.rst:851 +#: ../../using/configure.rst:854 msgid "Don't define the ``HAVE_LIBREADLINE`` macro." msgstr "不要定義 ``HAVE_LIBREADLINE`` 巨集。" -#: ../../using/configure.rst:857 +#: ../../using/configure.rst:860 msgid "" "Override ``libm`` math library to *STRING* (default is system-dependent)." msgstr "" -#: ../../using/configure.rst:861 +#: ../../using/configure.rst:864 msgid "Override ``libc`` C library to *STRING* (default is system-dependent)." msgstr "" -#: ../../using/configure.rst:865 +#: ../../using/configure.rst:868 msgid "Root of the OpenSSL directory." msgstr "OpenSSL 目錄的根目錄。" -#: ../../using/configure.rst:871 +#: ../../using/configure.rst:874 msgid "Set runtime library directory (rpath) for OpenSSL libraries:" msgstr "" -#: ../../using/configure.rst:873 +#: ../../using/configure.rst:876 msgid "``no`` (default): don't set rpath;" msgstr "" -#: ../../using/configure.rst:874 +#: ../../using/configure.rst:877 msgid "" "``auto``: auto-detect rpath from :option:`--with-openssl` and ``pkg-config``;" msgstr "" -#: ../../using/configure.rst:876 +#: ../../using/configure.rst:879 msgid "*DIR*: set an explicit rpath." msgstr "" -#: ../../using/configure.rst:882 +#: ../../using/configure.rst:885 msgid "Security Options" msgstr "安全性選項" -#: ../../using/configure.rst:886 +#: ../../using/configure.rst:889 msgid "Select hash algorithm for use in ``Python/pyhash.c``:" msgstr "" -#: ../../using/configure.rst:888 +#: ../../using/configure.rst:891 msgid "``siphash13`` (default);" msgstr "``siphash13``\\ （預設）；" -#: ../../using/configure.rst:889 +#: ../../using/configure.rst:892 msgid "``siphash24``;" msgstr "``siphash24``；" -#: ../../using/configure.rst:890 +#: ../../using/configure.rst:893 msgid "``fnv``." msgstr "``fnv``。" -#: ../../using/configure.rst:894 +#: ../../using/configure.rst:897 msgid "``siphash13`` is added and it is the new default." msgstr "" -#: ../../using/configure.rst:899 +#: ../../using/configure.rst:902 msgid "Built-in hash modules:" msgstr "內建雜湊模組：" -#: ../../using/configure.rst:901 +#: ../../using/configure.rst:904 msgid "``md5``;" msgstr "``md5``；" -#: ../../using/configure.rst:902 +#: ../../using/configure.rst:905 msgid "``sha1``;" msgstr "``sha1``；" -#: ../../using/configure.rst:903 +#: ../../using/configure.rst:906 msgid "``sha256``;" msgstr "``sha256``；" -#: ../../using/configure.rst:904 +#: ../../using/configure.rst:907 msgid "``sha512``;" msgstr "``sha512``；" -#: ../../using/configure.rst:905 +#: ../../using/configure.rst:908 msgid "``sha3`` (with shake);" msgstr "" -#: ../../using/configure.rst:906 +#: ../../using/configure.rst:909 msgid "``blake2``." msgstr "``blake2``。" -#: ../../using/configure.rst:912 +#: ../../using/configure.rst:915 msgid "Override the OpenSSL default cipher suites string:" msgstr "" -#: ../../using/configure.rst:914 +#: ../../using/configure.rst:917 msgid "``python`` (default): use Python's preferred selection;" msgstr "" -#: ../../using/configure.rst:915 +#: ../../using/configure.rst:918 msgid "``openssl``: leave OpenSSL's defaults untouched;" msgstr "" -#: ../../using/configure.rst:916 +#: ../../using/configure.rst:919 msgid "*STRING*: use a custom string" msgstr "" -#: ../../using/configure.rst:918 +#: ../../using/configure.rst:921 msgid "See the :mod:`ssl` module." msgstr "請見 :mod:`ssl` 模組。" -#: ../../using/configure.rst:924 +#: ../../using/configure.rst:927 msgid "" "The settings ``python`` and *STRING* also set TLS 1.2 as minimum protocol " "version." msgstr "" -#: ../../using/configure.rst:928 +#: ../../using/configure.rst:931 msgid "macOS Options" msgstr "macOS 選項" -#: ../../using/configure.rst:930 +#: ../../using/configure.rst:933 msgid "See :source:`Mac/README.rst`." msgstr "參閱 :source:`Mac/README.rst`。" -#: ../../using/configure.rst:935 +#: ../../using/configure.rst:938 msgid "" "Create a universal binary build. *SDKDIR* specifies which macOS SDK should " "be used to perform the build (default is no)." msgstr "" -#: ../../using/configure.rst:941 +#: ../../using/configure.rst:944 msgid "" "Create a Python.framework rather than a traditional Unix install. Optional " "*INSTALLDIR* specifies the installation path (default is no)." msgstr "" -#: ../../using/configure.rst:946 +#: ../../using/configure.rst:949 msgid "" "Specify the kind of universal binary that should be created. This option is " "only valid when :option:`--enable-universalsdk` is set." msgstr "" -#: ../../using/configure.rst:949 +#: ../../using/configure.rst:952 msgid "Options:" msgstr "選項：" -#: ../../using/configure.rst:951 +#: ../../using/configure.rst:954 msgid "``universal2`` (x86-64 and arm64);" msgstr "``universal2``\\ （x86-64 與 arm64）；" -#: ../../using/configure.rst:952 +#: ../../using/configure.rst:955 msgid "``32-bit`` (PPC and i386);" msgstr "``32-bit``\\ （PPC 與 i386）；" -#: ../../using/configure.rst:953 +#: ../../using/configure.rst:956 msgid "``64-bit`` (PPC64 and x86-64);" msgstr "``64-bit``\\ （PPC64 與 x86-64）；" -#: ../../using/configure.rst:954 +#: ../../using/configure.rst:957 msgid "``3-way`` (i386, PPC and x86-64);" msgstr "``3-way``\\ （i386、PPC 與 x86-64）；" -#: ../../using/configure.rst:955 +#: ../../using/configure.rst:958 msgid "``intel`` (i386 and x86-64);" msgstr "``intel``\\ （i386 與 x86-64）；" -#: ../../using/configure.rst:956 +#: ../../using/configure.rst:959 msgid "``intel-32`` (i386);" msgstr "``intel-32``\\ （i386）；" -#: ../../using/configure.rst:957 +#: ../../using/configure.rst:960 msgid "``intel-64`` (x86-64);" msgstr "``intel-64``\\ （x86-64）；" -#: ../../using/configure.rst:958 +#: ../../using/configure.rst:961 msgid "``all`` (PPC, i386, PPC64 and x86-64)." msgstr "``all``\\ （PPC、i386、PPC64 與 x86-64）。" -#: ../../using/configure.rst:960 +#: ../../using/configure.rst:963 msgid "" "Note that values for this configuration item are *not* the same as the " "identifiers used for universal binary wheels on macOS. See the Python " @@ -1437,13 +1443,13 @@ msgid "" "platform-compatibility-tags/#macos>`_" msgstr "" -#: ../../using/configure.rst:968 +#: ../../using/configure.rst:971 msgid "" -"Specify the name for the python framework on macOS only valid " -"when :option:`--enable-framework` is set (default: ``Python``)." +"Specify the name for the python framework on macOS only valid when :option:" +"`--enable-framework` is set (default: ``Python``)." msgstr "" -#: ../../using/configure.rst:974 +#: ../../using/configure.rst:977 msgid "" "The Python standard library contains strings that are known to trigger " "automated inspection tool errors when submitted for distribution by the " @@ -1452,29 +1458,29 @@ msgid "" "can also be specified. This option is disabled by default." msgstr "" -#: ../../using/configure.rst:983 +#: ../../using/configure.rst:986 msgid "iOS Options" msgstr "iOS 選項" -#: ../../using/configure.rst:985 +#: ../../using/configure.rst:988 msgid "See :source:`iOS/README.rst`." msgstr "參閱 :source:`iOS/README.rst`。" -#: ../../using/configure.rst:989 +#: ../../using/configure.rst:992 msgid "" "Create a Python.framework. Unlike macOS, the *INSTALLDIR* argument " "specifying the installation path is mandatory." msgstr "" -#: ../../using/configure.rst:994 +#: ../../using/configure.rst:997 msgid "Specify the name for the framework (default: ``Python``)." msgstr "指定框架的名稱（預設值：``Python``）。" -#: ../../using/configure.rst:998 +#: ../../using/configure.rst:1001 msgid "Cross Compiling Options" msgstr "" -#: ../../using/configure.rst:1000 +#: ../../using/configure.rst:1003 msgid "" "Cross compiling, also known as cross building, can be used to build Python " "for another CPU architecture or platform. Cross compiling requires a Python " @@ -1482,28 +1488,28 @@ msgid "" "match the version of the cross compiled host Python." msgstr "" -#: ../../using/configure.rst:1007 +#: ../../using/configure.rst:1010 msgid "" "configure for building on BUILD, usually guessed by :program:`config.guess`." msgstr "" -#: ../../using/configure.rst:1011 +#: ../../using/configure.rst:1014 msgid "cross-compile to build programs to run on HOST (target platform)" msgstr "" -#: ../../using/configure.rst:1015 +#: ../../using/configure.rst:1018 msgid "path to build ``python`` binary for cross compiling" msgstr "" -#: ../../using/configure.rst:1021 +#: ../../using/configure.rst:1024 msgid "An environment variable that points to a file with configure overrides." msgstr "" -#: ../../using/configure.rst:1023 +#: ../../using/configure.rst:1026 msgid "Example *config.site* file:" msgstr "範例 *config.site* 檔案：" -#: ../../using/configure.rst:1025 +#: ../../using/configure.rst:1028 msgid "" "# config.site-aarch64\n" "ac_cv_buggy_getaddrinfo=no\n" @@ -1515,15 +1521,15 @@ msgstr "" "ac_cv_file__dev_ptmx=yes\n" "ac_cv_file__dev_ptc=no" -#: ../../using/configure.rst:1034 +#: ../../using/configure.rst:1037 msgid "Program to run CPython for the host platform for cross-compilation." msgstr "" -#: ../../using/configure.rst:1039 +#: ../../using/configure.rst:1042 msgid "Cross compiling example::" msgstr "" -#: ../../using/configure.rst:1041 +#: ../../using/configure.rst:1044 msgid "" "CONFIG_SITE=config.site-aarch64 ../configure \\\n" " --build=x86_64-pc-linux-gnu \\\n" @@ -1535,65 +1541,65 @@ msgstr "" " --host=aarch64-unknown-linux-gnu \\\n" " --with-build-python=../x86_64/python" -#: ../../using/configure.rst:1048 +#: ../../using/configure.rst:1051 msgid "Python Build System" msgstr "Python 建置系統" -#: ../../using/configure.rst:1051 +#: ../../using/configure.rst:1054 msgid "Main files of the build system" msgstr "建置系統的主要檔案" -#: ../../using/configure.rst:1053 +#: ../../using/configure.rst:1056 msgid ":file:`configure.ac` => :file:`configure`;" msgstr ":file:`configure.ac` => :file:`configure`；" -#: ../../using/configure.rst:1054 +#: ../../using/configure.rst:1057 msgid "" ":file:`Makefile.pre.in` => :file:`Makefile` (created by :file:`configure`);" msgstr "" ":file:`Makefile.pre.in` => :file:`Makefile`\\ （由 :file:`configure` 建立）；" -#: ../../using/configure.rst:1055 +#: ../../using/configure.rst:1058 msgid ":file:`pyconfig.h` (created by :file:`configure`);" msgstr ":file:`pyconfig.h`\\ （由 :file:`configure` 建立）；" -#: ../../using/configure.rst:1056 +#: ../../using/configure.rst:1059 msgid "" -":file:`Modules/Setup`: C extensions built by the Makefile " -"using :file:`Module/makesetup` shell script;" +":file:`Modules/Setup`: C extensions built by the Makefile using :file:" +"`Module/makesetup` shell script;" msgstr "" -#: ../../using/configure.rst:1060 +#: ../../using/configure.rst:1063 msgid "Main build steps" msgstr "主要建置步驟" -#: ../../using/configure.rst:1062 +#: ../../using/configure.rst:1065 msgid "C files (``.c``) are built as object files (``.o``)." msgstr "C 檔案（``.c``）被建置為目的檔（``.o``）。" -#: ../../using/configure.rst:1063 +#: ../../using/configure.rst:1066 msgid "A static ``libpython`` library (``.a``) is created from objects files." msgstr "" -#: ../../using/configure.rst:1064 +#: ../../using/configure.rst:1067 msgid "" "``python.o`` and the static ``libpython`` library are linked into the final " "``python`` program." msgstr "" -#: ../../using/configure.rst:1066 +#: ../../using/configure.rst:1069 msgid "C extensions are built by the Makefile (see :file:`Modules/Setup`)." msgstr "" -#: ../../using/configure.rst:1069 +#: ../../using/configure.rst:1072 msgid "Main Makefile targets" msgstr "主要 Makefile 目標" -#: ../../using/configure.rst:1072 +#: ../../using/configure.rst:1075 msgid "make" msgstr "make" -#: ../../using/configure.rst:1074 +#: ../../using/configure.rst:1077 msgid "" "For the most part, when rebuilding after editing some code or refreshing " "your checkout from upstream, all you need to do is execute ``make``, which " @@ -1604,20 +1610,20 @@ msgid "" "all`` will build. The three choices are:" msgstr "" -#: ../../using/configure.rst:1083 +#: ../../using/configure.rst:1086 msgid "``profile-opt`` (configured with ``--enable-optimizations``)" msgstr "``profile-opt``\\ （使用 ``--enable-optimizations`` 配置）" -#: ../../using/configure.rst:1084 +#: ../../using/configure.rst:1087 msgid "``build_wasm`` (configured with ``--with-emscripten-target``)" msgstr "``build_wasm``\\ （使用 ``--with-emscripten-target`` 配置）" -#: ../../using/configure.rst:1085 +#: ../../using/configure.rst:1088 msgid "" "``build_all`` (configured without explicitly using either of the others)" msgstr "``build_all``\\ （未明確使用其他選項進行配置）" -#: ../../using/configure.rst:1087 +#: ../../using/configure.rst:1090 msgid "" "Depending on the most recent source file changes, Make will rebuild any " "targets (object files and executables) deemed out-of-date, including running " @@ -1630,11 +1636,11 @@ msgid "" "problems, at the expense of longer build times." msgstr "" -#: ../../using/configure.rst:1100 +#: ../../using/configure.rst:1103 msgid "make platform" msgstr "make platform" -#: ../../using/configure.rst:1102 +#: ../../using/configure.rst:1105 msgid "" "Build the ``python`` program, but don't build the standard library extension " "modules. This generates a file named ``platform`` which contains a single " @@ -1642,81 +1648,81 @@ msgid "" "arm64-3.12`` or ``linux-x86_64-3.13``." msgstr "" -#: ../../using/configure.rst:1109 +#: ../../using/configure.rst:1112 msgid "make profile-opt" msgstr "make profile-opt" -#: ../../using/configure.rst:1111 +#: ../../using/configure.rst:1114 msgid "" "Build Python using profile-guided optimization (PGO). You can use the " "configure :option:`--enable-optimizations` option to make this the default " "target of the ``make`` command (``make all`` or just ``make``)." msgstr "" -#: ../../using/configure.rst:1119 +#: ../../using/configure.rst:1122 msgid "make clean" msgstr "make clean" -#: ../../using/configure.rst:1121 +#: ../../using/configure.rst:1124 msgid "Remove built files." msgstr "移除建置的檔案。" -#: ../../using/configure.rst:1125 +#: ../../using/configure.rst:1128 msgid "make distclean" msgstr "make distclean" -#: ../../using/configure.rst:1127 +#: ../../using/configure.rst:1130 msgid "" "In addition to the work done by ``make clean``, remove files created by the " "configure script. ``configure`` will have to be run before building again. " "[#]_" msgstr "" -#: ../../using/configure.rst:1133 +#: ../../using/configure.rst:1136 msgid "make install" msgstr "make install" -#: ../../using/configure.rst:1135 +#: ../../using/configure.rst:1138 msgid "Build the ``all`` target and install Python." msgstr "建置 ``all`` 目標並安裝 Python。" -#: ../../using/configure.rst:1139 +#: ../../using/configure.rst:1142 msgid "make test" msgstr "make test" -#: ../../using/configure.rst:1141 +#: ../../using/configure.rst:1144 msgid "" "Build the ``all`` target and run the Python test suite with the ``--fast-" "ci`` option. Variables:" msgstr "" -#: ../../using/configure.rst:1144 +#: ../../using/configure.rst:1147 msgid "``TESTOPTS``: additional regrtest command-line options." msgstr "``TESTOPTS``：額外的 regrtest 命令列選項。" -#: ../../using/configure.rst:1145 +#: ../../using/configure.rst:1148 msgid "``TESTPYTHONOPTS``: additional Python command-line options." msgstr "``TESTPYTHONOPTS``：額外的 Python 命令列選項。" -#: ../../using/configure.rst:1146 +#: ../../using/configure.rst:1149 msgid "``TESTTIMEOUT``: timeout in seconds (default: 10 minutes)." msgstr "``TESTTIMEOUT``：秒數表示的超時設定（預設值：10 分鐘）。" -#: ../../using/configure.rst:1150 +#: ../../using/configure.rst:1153 msgid "make buildbottest" msgstr "make buildbottest" -#: ../../using/configure.rst:1152 +#: ../../using/configure.rst:1155 msgid "" "This is similar to ``make test``, but uses the ``--slow-ci`` option and " "default timeout of 20 minutes, instead of ``--fast-ci`` option." msgstr "" -#: ../../using/configure.rst:1157 +#: ../../using/configure.rst:1160 msgid "make regen-all" msgstr "make regen-all" -#: ../../using/configure.rst:1159 +#: ../../using/configure.rst:1162 msgid "" "Regenerate (almost) all generated files. These include (but are not limited " "to) bytecode cases, and parser generator file. ``make regen-stdlib-module-" @@ -1724,18 +1730,18 @@ msgid "" "files <#generated-files>`_." msgstr "" -#: ../../using/configure.rst:1166 +#: ../../using/configure.rst:1169 msgid "C extensions" msgstr "C 擴充模組" -#: ../../using/configure.rst:1168 +#: ../../using/configure.rst:1171 msgid "" "Some C extensions are built as built-in modules, like the ``sys`` module. " "They are built with the ``Py_BUILD_CORE_BUILTIN`` macro defined. Built-in " "modules have no ``__file__`` attribute:" msgstr "" -#: ../../using/configure.rst:1172 +#: ../../using/configure.rst:1175 msgid "" ">>> import sys\n" ">>> sys\n" @@ -1753,30 +1759,30 @@ msgstr "" " File \"\", line 1, in \n" "AttributeError: module 'sys' has no attribute '__file__'" -#: ../../using/configure.rst:1182 +#: ../../using/configure.rst:1185 msgid "" "Other C extensions are built as dynamic libraries, like the ``_asyncio`` " "module. They are built with the ``Py_BUILD_CORE_MODULE`` macro defined. " "Example on Linux x86-64:" msgstr "" -#: ../../using/configure.rst:1186 +#: ../../using/configure.rst:1189 msgid "" ">>> import _asyncio\n" ">>> _asyncio\n" -"\n" +"\n" ">>> _asyncio.__file__\n" "'/usr/lib64/python3.9/lib-dynload/_asyncio.cpython-39-x86_64-linux-gnu.so'" msgstr "" ">>> import _asyncio\n" ">>> _asyncio\n" -"\n" +"\n" ">>> _asyncio.__file__\n" "'/usr/lib64/python3.9/lib-dynload/_asyncio.cpython-39-x86_64-linux-gnu.so'" -#: ../../using/configure.rst:1194 +#: ../../using/configure.rst:1197 msgid "" ":file:`Modules/Setup` is used to generate Makefile targets to build C " "extensions. At the beginning of the files, C extensions are built as built-" @@ -1784,174 +1790,172 @@ msgid "" "dynamic libraries." msgstr "" -#: ../../using/configure.rst:1198 +#: ../../using/configure.rst:1201 msgid "" -"The :c:macro:`!PyAPI_FUNC()`, :c:macro:`!PyAPI_DATA()` " -"and :c:macro:`PyMODINIT_FUNC` macros of :file:`Include/exports.h` are " -"defined differently depending if the ``Py_BUILD_CORE_MODULE`` macro is " -"defined:" +"The :c:macro:`!PyAPI_FUNC()`, :c:macro:`!PyAPI_DATA()` and :c:macro:" +"`PyMODINIT_FUNC` macros of :file:`Include/exports.h` are defined differently " +"depending if the ``Py_BUILD_CORE_MODULE`` macro is defined:" msgstr "" -#: ../../using/configure.rst:1202 +#: ../../using/configure.rst:1205 msgid "Use ``Py_EXPORTED_SYMBOL`` if the ``Py_BUILD_CORE_MODULE`` is defined" msgstr "如果定義了 ``Py_BUILD_CORE_MODULE``，則使用 ``Py_EXPORTED_SYMBOL``" -#: ../../using/configure.rst:1203 +#: ../../using/configure.rst:1206 msgid "Use ``Py_IMPORTED_SYMBOL`` otherwise." msgstr "否則使用 ``Py_IMPORTED_SYMBOL``。" -#: ../../using/configure.rst:1205 +#: ../../using/configure.rst:1208 msgid "" "If the ``Py_BUILD_CORE_BUILTIN`` macro is used by mistake on a C extension " "built as a shared library, its :samp:`PyInit_{xxx}()` function is not " "exported, causing an :exc:`ImportError` on import." msgstr "" -#: ../../using/configure.rst:1211 +#: ../../using/configure.rst:1214 msgid "Compiler and linker flags" msgstr "" -#: ../../using/configure.rst:1213 +#: ../../using/configure.rst:1216 msgid "" "Options set by the ``./configure`` script and environment variables and used " "by ``Makefile``." msgstr "" -#: ../../using/configure.rst:1217 +#: ../../using/configure.rst:1220 msgid "Preprocessor flags" msgstr "預處理器旗標" -#: ../../using/configure.rst:1221 +#: ../../using/configure.rst:1224 msgid "" "Value of :envvar:`CPPFLAGS` variable passed to the ``./configure`` script." msgstr "" -#: ../../using/configure.rst:1227 +#: ../../using/configure.rst:1230 msgid "" "(Objective) C/C++ preprocessor flags, e.g. :samp:`-I{include_dir}` if you " "have headers in a nonstandard directory *include_dir*." msgstr "" -#: ../../using/configure.rst:1230 ../../using/configure.rst:1420 +#: ../../using/configure.rst:1233 ../../using/configure.rst:1423 msgid "" "Both :envvar:`CPPFLAGS` and :envvar:`LDFLAGS` need to contain the shell's " "value to be able to build extension modules using the directories specified " "in the environment variables." msgstr "" -#: ../../using/configure.rst:1240 +#: ../../using/configure.rst:1243 msgid "" "Extra preprocessor flags added for building the interpreter object files." msgstr "" -#: ../../using/configure.rst:1242 +#: ../../using/configure.rst:1245 msgid "" -"Default: ``$(BASECPPFLAGS) -I. -I$(srcdir)/Include $(CONFIGURE_CPPFLAGS) $" -"(CPPFLAGS)``." +"Default: ``$(BASECPPFLAGS) -I. -I$(srcdir)/Include $(CONFIGURE_CPPFLAGS) " +"$(CPPFLAGS)``." msgstr "" -#: ../../using/configure.rst:1247 +#: ../../using/configure.rst:1250 msgid "Compiler flags" msgstr "編譯器旗標" -#: ../../using/configure.rst:1253 +#: ../../using/configure.rst:1256 msgid "Example: ``gcc -pthread``." msgstr "範例：``gcc -pthread``。" -#: ../../using/configure.rst:1257 +#: ../../using/configure.rst:1260 msgid "C++ compiler command." msgstr "C++ 編譯器指令。" -#: ../../using/configure.rst:1259 +#: ../../using/configure.rst:1262 msgid "Example: ``g++ -pthread``." msgstr "範例：``g++ -pthread``。" -#: ../../using/configure.rst:1267 +#: ../../using/configure.rst:1270 msgid "" ":envvar:`CFLAGS_NODIST` is used for building the interpreter and stdlib C " -"extensions. Use it when a compiler flag should *not* be part " -"of :envvar:`CFLAGS` once Python is installed (:gh:`65320`)." +"extensions. Use it when a compiler flag should *not* be part of :envvar:" +"`CFLAGS` once Python is installed (:gh:`65320`)." msgstr "" -#: ../../using/configure.rst:1271 +#: ../../using/configure.rst:1274 msgid "In particular, :envvar:`CFLAGS` should not contain:" msgstr "" -#: ../../using/configure.rst:1273 +#: ../../using/configure.rst:1276 msgid "" "the compiler flag ``-I`` (for setting the search path for include files). " -"The ``-I`` flags are processed from left to right, and any flags " -"in :envvar:`CFLAGS` would take precedence over user- and package-supplied ``-" -"I`` flags." +"The ``-I`` flags are processed from left to right, and any flags in :envvar:" +"`CFLAGS` would take precedence over user- and package-supplied ``-I`` flags." msgstr "" -#: ../../using/configure.rst:1278 +#: ../../using/configure.rst:1281 msgid "" "hardening flags such as ``-Werror`` because distributions cannot control " "whether packages installed by users conform to such heightened standards." msgstr "" -#: ../../using/configure.rst:1286 +#: ../../using/configure.rst:1289 msgid "" "Options passed to the :mod:`compileall` command line when building PYC files " "in ``make install``. Default: ``-j0``." msgstr "" -#: ../../using/configure.rst:1293 +#: ../../using/configure.rst:1296 msgid "Extra C compiler flags." msgstr "額外的 C 編譯器旗標。" -#: ../../using/configure.rst:1297 +#: ../../using/configure.rst:1300 msgid "" "Value of :envvar:`CFLAGS` variable passed to the ``./configure`` script." msgstr "" -#: ../../using/configure.rst:1304 +#: ../../using/configure.rst:1307 msgid "" "Value of :envvar:`CFLAGS_NODIST` variable passed to the ``./configure`` " "script." msgstr "" -#: ../../using/configure.rst:1311 +#: ../../using/configure.rst:1314 msgid "Base compiler flags." msgstr "基本編譯器旗標。" -#: ../../using/configure.rst:1315 +#: ../../using/configure.rst:1318 msgid "Optimization flags." msgstr "最佳化旗標。" -#: ../../using/configure.rst:1319 +#: ../../using/configure.rst:1322 msgid "Strict or non-strict aliasing flags used to compile ``Python/dtoa.c``." msgstr "" -#: ../../using/configure.rst:1325 +#: ../../using/configure.rst:1328 msgid "Compiler flags used to build a shared library." msgstr "用於建置共享函式庫的編譯器旗標。" -#: ../../using/configure.rst:1327 +#: ../../using/configure.rst:1330 msgid "For example, ``-fPIC`` is used on Linux and on BSD." msgstr "例如說 ``-fPIC`` 被使用於 Linux 與 BSD 上。" -#: ../../using/configure.rst:1331 +#: ../../using/configure.rst:1334 msgid "Extra C flags added for building the interpreter object files." msgstr "用於建置直譯器目的檔的額外 C 旗標。" -#: ../../using/configure.rst:1333 +#: ../../using/configure.rst:1336 msgid "" "Default: ``$(CCSHARED)`` when :option:`--enable-shared` is used, or an empty " "string otherwise." msgstr "" "預設值：當使用 :option:`--enable-shared` 時為 ``$(CCSHARED)``，否則為空字串。" -#: ../../using/configure.rst:1338 +#: ../../using/configure.rst:1341 msgid "" -"Default: ``$(BASECFLAGS) $(OPT) $(CONFIGURE_CFLAGS) $(CFLAGS) $" -"(EXTRA_CFLAGS)``." +"Default: ``$(BASECFLAGS) $(OPT) $(CONFIGURE_CFLAGS) $(CFLAGS) " +"$(EXTRA_CFLAGS)``." msgstr "" -"預設值：``$(BASECFLAGS) $(OPT) $(CONFIGURE_CFLAGS) $(CFLAGS) $" -"(EXTRA_CFLAGS)``。" +"預設值：``$(BASECFLAGS) $(OPT) $(CONFIGURE_CFLAGS) $(CFLAGS) " +"$(EXTRA_CFLAGS)``。" -#: ../../using/configure.rst:1342 +#: ../../using/configure.rst:1345 msgid "" "Default: ``$(CONFIGURE_CFLAGS_NODIST) $(CFLAGS_NODIST) -I$(srcdir)/Include/" "internal``." @@ -1959,139 +1963,138 @@ msgstr "" "預設值：``$(CONFIGURE_CFLAGS_NODIST) $(CFLAGS_NODIST) -I$(srcdir)/Include/" "internal``。" -#: ../../using/configure.rst:1348 +#: ../../using/configure.rst:1351 msgid "C flags used for building the interpreter object files." msgstr "用於建置直譯器目的檔的 C 旗標。" -#: ../../using/configure.rst:1350 +#: ../../using/configure.rst:1353 msgid "" -"Default: ``$(PY_CFLAGS) $(PY_CFLAGS_NODIST) $(PY_CPPFLAGS) $" -"(CFLAGSFORSHARED)``." +"Default: ``$(PY_CFLAGS) $(PY_CFLAGS_NODIST) $(PY_CPPFLAGS) " +"$(CFLAGSFORSHARED)``." msgstr "" -"預設值：``$(PY_CFLAGS) $(PY_CFLAGS_NODIST) $(PY_CPPFLAGS) $" -"(CFLAGSFORSHARED)``。" +"預設值：``$(PY_CFLAGS) $(PY_CFLAGS_NODIST) $(PY_CPPFLAGS) " +"$(CFLAGSFORSHARED)``。" -#: ../../using/configure.rst:1356 +#: ../../using/configure.rst:1359 msgid "Default: ``$(PY_STDMODULE_CFLAGS) -DPy_BUILD_CORE``." msgstr "預設值：``$(PY_STDMODULE_CFLAGS) -DPy_BUILD_CORE``。" -#: ../../using/configure.rst:1362 +#: ../../using/configure.rst:1365 msgid "" "Compiler flags to build a standard library extension module as a built-in " "module, like the :mod:`posix` module." msgstr "" -#: ../../using/configure.rst:1365 +#: ../../using/configure.rst:1368 msgid "Default: ``$(PY_STDMODULE_CFLAGS) -DPy_BUILD_CORE_BUILTIN``." msgstr "預設值：``$(PY_STDMODULE_CFLAGS) -DPy_BUILD_CORE_BUILTIN``。" -#: ../../using/configure.rst:1371 +#: ../../using/configure.rst:1374 msgid "Purify command. Purify is a memory debugger program." msgstr "" -#: ../../using/configure.rst:1373 +#: ../../using/configure.rst:1376 msgid "Default: empty string (not used)." msgstr "預設值：空字串（未使用）。" -#: ../../using/configure.rst:1377 +#: ../../using/configure.rst:1380 msgid "Linker flags" msgstr "" -#: ../../using/configure.rst:1381 +#: ../../using/configure.rst:1384 msgid "" "Linker command used to build programs like ``python`` and ``_testembed``." msgstr "" -#: ../../using/configure.rst:1383 +#: ../../using/configure.rst:1386 msgid "Default: ``$(PURIFY) $(CC)``." msgstr "預設值：``$(PURIFY) $(CC)``。" -#: ../../using/configure.rst:1387 +#: ../../using/configure.rst:1390 msgid "" "Value of :envvar:`LDFLAGS` variable passed to the ``./configure`` script." msgstr "" -#: ../../using/configure.rst:1389 +#: ../../using/configure.rst:1392 msgid "" "Avoid assigning :envvar:`CFLAGS`, :envvar:`LDFLAGS`, etc. so users can use " "them on the command line to append to these values without stomping the pre-" "set values." msgstr "" -#: ../../using/configure.rst:1397 +#: ../../using/configure.rst:1400 msgid "" -":envvar:`LDFLAGS_NODIST` is used in the same manner " -"as :envvar:`CFLAGS_NODIST`. Use it when a linker flag should *not* be part " -"of :envvar:`LDFLAGS` once Python is installed (:gh:`65320`)." +":envvar:`LDFLAGS_NODIST` is used in the same manner as :envvar:" +"`CFLAGS_NODIST`. Use it when a linker flag should *not* be part of :envvar:" +"`LDFLAGS` once Python is installed (:gh:`65320`)." msgstr "" -#: ../../using/configure.rst:1401 +#: ../../using/configure.rst:1404 msgid "In particular, :envvar:`LDFLAGS` should not contain:" msgstr "" -#: ../../using/configure.rst:1403 +#: ../../using/configure.rst:1406 msgid "" "the compiler flag ``-L`` (for setting the search path for libraries). The ``-" -"L`` flags are processed from left to right, and any flags " -"in :envvar:`LDFLAGS` would take precedence over user- and package-supplied " -"``-L`` flags." +"L`` flags are processed from left to right, and any flags in :envvar:" +"`LDFLAGS` would take precedence over user- and package-supplied ``-L`` flags." msgstr "" -#: ../../using/configure.rst:1410 +#: ../../using/configure.rst:1413 msgid "" "Value of :envvar:`LDFLAGS_NODIST` variable passed to the ``./configure`` " "script." msgstr "" -#: ../../using/configure.rst:1417 +#: ../../using/configure.rst:1420 msgid "" "Linker flags, e.g. :samp:`-L{lib_dir}` if you have libraries in a " "nonstandard directory *lib_dir*." msgstr "" -#: ../../using/configure.rst:1426 +#: ../../using/configure.rst:1429 msgid "" "Linker flags to pass libraries to the linker when linking the Python " "executable." msgstr "" -#: ../../using/configure.rst:1429 +#: ../../using/configure.rst:1432 msgid "Example: ``-lrt``." msgstr "範例：``-lrt``。" -#: ../../using/configure.rst:1433 +#: ../../using/configure.rst:1436 msgid "Command to build a shared library." msgstr "建置共享函式庫的指令。" -#: ../../using/configure.rst:1435 +#: ../../using/configure.rst:1438 msgid "Default: ``@LDSHARED@ $(PY_LDFLAGS)``." msgstr "預設值：``@LDSHARED@ $(PY_LDFLAGS)``。" -#: ../../using/configure.rst:1439 +#: ../../using/configure.rst:1442 msgid "Command to build ``libpython`` shared library." msgstr "建置 ``libpython`` 共享函式庫的指令。" -#: ../../using/configure.rst:1441 +#: ../../using/configure.rst:1444 msgid "Default: ``@BLDSHARED@ $(PY_CORE_LDFLAGS)``." msgstr "預設值：``@BLDSHARED@ $(PY_CORE_LDFLAGS)``。" -#: ../../using/configure.rst:1445 +#: ../../using/configure.rst:1448 msgid "Default: ``$(CONFIGURE_LDFLAGS) $(LDFLAGS)``." msgstr "預設值：``$(CONFIGURE_LDFLAGS) $(LDFLAGS)``。" -#: ../../using/configure.rst:1449 +#: ../../using/configure.rst:1452 msgid "Default: ``$(CONFIGURE_LDFLAGS_NODIST) $(LDFLAGS_NODIST)``." msgstr "預設值：``$(CONFIGURE_LDFLAGS_NODIST) $(LDFLAGS_NODIST)``。" -#: ../../using/configure.rst:1455 +#: ../../using/configure.rst:1458 msgid "Linker flags used for building the interpreter object files." msgstr "" -#: ../../using/configure.rst:1461 +#: ../../using/configure.rst:1464 msgid "Footnotes" msgstr "註腳" -#: ../../using/configure.rst:1462 +#: ../../using/configure.rst:1465 msgid "" "``git clean -fdx`` is an even more extreme way to \"clean\" your checkout. " "It removes all files not known to Git. When bug hunting using ``git " diff --git a/whatsnew/3.12.po b/whatsnew/3.12.po index eece8f6a4f..39d5d07948 100644 --- a/whatsnew/3.12.po +++ b/whatsnew/3.12.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-06-27 07:36+0000\n" +"POT-Creation-Date: 2025-07-03 00:17+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-" @@ -2673,11 +2673,10 @@ msgid "" "since Python 3.13. Use ``class TD(TypedDict): pass`` or ``TD = " "TypedDict(\"TD\", {})`` to create a TypedDict with zero field." msgstr "" -"當使用 :class:`~typing.TypedDict` 的函式語法時，未傳遞值給 *fields* " -"參數 (``TD = TypedDict(\"TD\")``) 或傳遞 ``None`` (``TD = " -"TypedDict(\"TD\", None)``) 的做法自 Python 3.13 起已被棄用。請" -"使用 ``class TD(TypedDict): pass`` 或 ``TD = " -"TypedDict(\"TD\", {})`` 來建立具有零個欄位的 TypedDict。" +"當使用 :class:`~typing.TypedDict` 的函式語法時，未傳遞值給 *fields* 參數 " +"(``TD = TypedDict(\"TD\")``) 或傳遞 ``None`` (``TD = TypedDict(\"TD\", " +"None)``) 的做法自 Python 3.13 起已被棄用。請使用 ``class TD(TypedDict): " +"pass`` 或 ``TD = TypedDict(\"TD\", {})`` 來建立具有零個欄位的 TypedDict。" #: ../../deprecations/pending-removal-in-3.15.rst:95 msgid "" @@ -2703,6 +2702,7 @@ msgstr "" "`~wave.Wave_read.getmark`、:meth:`!setmark` 和 :meth:`~wave.Wave_read." "getmarkers` 方法自 Python 3.13 被棄用。" +#: ../../deprecations/c-api-pending-removal-in-3.16.rst:2 #: ../../deprecations/pending-removal-in-3.16.rst:2 msgid "Pending removal in Python 3.16" msgstr "Python 3.16 中待移除的項目" @@ -3198,7 +3198,7 @@ msgstr "" ":meth:`zipimport.zipimporter.load_module` 已被棄用：請改用 :meth:`~zipimport." "zipimporter.exec_module`。" -#: ../../whatsnew/3.12.rst:1355 ../../whatsnew/3.12.rst:2237 +#: ../../whatsnew/3.12.rst:1355 ../../whatsnew/3.12.rst:2239 msgid "Removed" msgstr "已移除" @@ -5153,10 +5153,6 @@ msgstr "" "func:`Py_PreInitialize`）" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:4 -msgid "The bundled copy of ``libmpdecimal``." -msgstr "``libmpdecimal`` 的打包副本 (bundled copy)。" - -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:5 msgid "" "The :c:func:`PyImport_ImportModuleNoBlock`: Use :c:func:" "`PyImport_ImportModule` instead." @@ -5164,7 +5160,7 @@ msgstr "" ":c:func:`PyImport_ImportModuleNoBlock`：請改用 :c:func:" "`PyImport_ImportModule`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:7 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:6 msgid "" ":c:func:`PyWeakref_GetObject` and :c:func:`PyWeakref_GET_OBJECT`: Use :c:" "func:`PyWeakref_GetRef` instead." @@ -5172,7 +5168,7 @@ msgstr "" ":c:func:`PyWeakref_GetObject` 和 :c:func:`PyWeakref_GET_OBJECT`：請改用 :c:" "func:`PyWeakref_GetRef`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:9 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:8 msgid "" ":c:type:`Py_UNICODE` type and the :c:macro:`!Py_UNICODE_WIDE` macro: Use :c:" "type:`wchar_t` instead." @@ -5180,11 +5176,11 @@ msgstr "" ":c:type:`Py_UNICODE` 型別與 :c:macro:`!Py_UNICODE_WIDE` 巨集：請改用 :c:type:" "`wchar_t`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:11 +#: ../../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:13 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:12 msgid "" ":c:func:`PySys_ResetWarnOptions`: Clear :data:`sys.warnoptions` and :data:`!" "warnings.filters` instead." @@ -5192,7 +5188,7 @@ msgstr "" ":c:func:`PySys_ResetWarnOptions`：請改為清除 :data:`sys.warnoptions` 和 :" "data:`!warnings.filters`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:15 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:14 msgid "" ":c:func:`Py_GetExecPrefix`: Get :data:`sys.base_exec_prefix` and :data:`sys." "exec_prefix` instead." @@ -5200,11 +5196,11 @@ msgstr "" ":c:func:`Py_GetExecPrefix`：請改用 :data:`sys.base_exec_prefix` 與 :data:" "`sys.exec_prefix`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:17 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:16 msgid ":c:func:`Py_GetPath`: Get :data:`sys.path` instead." msgstr ":c:func:`Py_GetPath`：請改用 :data:`sys.path`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:19 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:18 msgid "" ":c:func:`Py_GetPrefix`: Get :data:`sys.base_prefix` and :data:`sys.prefix` " "instead." @@ -5212,15 +5208,15 @@ msgstr "" ":c:func:`Py_GetPrefix`：請改用 :data:`sys.base_prefix` 與 :data:`sys." "prefix`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:21 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:20 msgid ":c:func:`Py_GetProgramFullPath`: Get :data:`sys.executable` instead." msgstr ":c:func:`Py_GetProgramFullPath`：請改用 :data:`sys.executable`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:23 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:22 msgid ":c:func:`Py_GetProgramName`: Get :data:`sys.executable` instead." msgstr ":c:func:`Py_GetProgramName`：請改用 :data:`sys.executable`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:25 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:24 msgid "" ":c:func:`Py_GetPythonHome`: Get :c:member:`PyConfig.home` or the :envvar:" "`PYTHONHOME` environment variable instead." @@ -5228,6 +5224,11 @@ msgstr "" ":c:func:`Py_GetPythonHome`：請改用 :c:member:`PyConfig.home` 或 :envvar:" "`PYTHONHOME` 環境變數。" +#: ../../deprecations/c-api-pending-removal-in-3.16.rst:4 +#, fuzzy +msgid "The bundled copy of ``libmpdec``." +msgstr "``libmpdecimal`` 的打包副本 (bundled copy)。" + #: ../../deprecations/c-api-pending-removal-in-future.rst:4 msgid "" "The following APIs are deprecated and will be removed, although there is " @@ -5359,7 +5360,7 @@ msgstr "" msgid ":c:func:`PyThread_ReInitTLS`: Unneeded since Python 3.7." msgstr ":c:func:`PyThread_ReInitTLS`：自 Python 3.7 起不再需要。" -#: ../../whatsnew/3.12.rst:2239 +#: ../../whatsnew/3.12.rst:2241 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 " @@ -5369,47 +5370,47 @@ msgstr "" "`token.h` 標頭檔案的設計是僅限用於 Python 內部。（由 Victor Stinner 於 :gh:" "`92651` 中貢獻。）" -#: ../../whatsnew/3.12.rst:2244 +#: ../../whatsnew/3.12.rst:2246 msgid "Legacy Unicode APIs have been removed. See :pep:`623` for detail." msgstr "" -#: ../../whatsnew/3.12.rst:2246 +#: ../../whatsnew/3.12.rst:2248 msgid ":c:macro:`!PyUnicode_WCHAR_KIND`" msgstr ":c:macro:`!PyUnicode_WCHAR_KIND`" -#: ../../whatsnew/3.12.rst:2247 +#: ../../whatsnew/3.12.rst:2249 msgid ":c:func:`!PyUnicode_AS_UNICODE`" msgstr ":c:func:`!PyUnicode_AS_UNICODE`" -#: ../../whatsnew/3.12.rst:2248 +#: ../../whatsnew/3.12.rst:2250 msgid ":c:func:`!PyUnicode_AsUnicode`" msgstr ":c:func:`!PyUnicode_AsUnicode`" -#: ../../whatsnew/3.12.rst:2249 +#: ../../whatsnew/3.12.rst:2251 msgid ":c:func:`!PyUnicode_AsUnicodeAndSize`" msgstr ":c:func:`!PyUnicode_AsUnicodeAndSize`" -#: ../../whatsnew/3.12.rst:2250 +#: ../../whatsnew/3.12.rst:2252 msgid ":c:func:`!PyUnicode_AS_DATA`" msgstr ":c:func:`!PyUnicode_AS_DATA`" -#: ../../whatsnew/3.12.rst:2251 +#: ../../whatsnew/3.12.rst:2253 msgid ":c:func:`!PyUnicode_FromUnicode`" msgstr ":c:func:`!PyUnicode_FromUnicode`" -#: ../../whatsnew/3.12.rst:2252 +#: ../../whatsnew/3.12.rst:2254 msgid ":c:func:`!PyUnicode_GET_SIZE`" msgstr ":c:func:`!PyUnicode_GET_SIZE`" -#: ../../whatsnew/3.12.rst:2253 +#: ../../whatsnew/3.12.rst:2255 msgid ":c:func:`!PyUnicode_GetSize`" msgstr ":c:func:`!PyUnicode_GetSize`" -#: ../../whatsnew/3.12.rst:2254 +#: ../../whatsnew/3.12.rst:2256 msgid ":c:func:`!PyUnicode_GET_DATA_SIZE`" msgstr ":c:func:`!PyUnicode_GET_DATA_SIZE`" -#: ../../whatsnew/3.12.rst:2256 +#: ../../whatsnew/3.12.rst:2258 msgid "" "Remove the ``PyUnicode_InternImmortal()`` function macro. (Contributed by " "Victor Stinner in :gh:`85858`.)" diff --git a/whatsnew/3.13.po b/whatsnew/3.13.po index f41a44f35d..aee667e920 100644 --- a/whatsnew/3.13.po +++ b/whatsnew/3.13.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-06-27 07:36+0000\n" +"POT-Creation-Date: 2025-07-03 00:17+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-" @@ -1643,7 +1643,7 @@ msgid "" "gh:`113117`.)" msgstr "" -#: ../../whatsnew/3.13.rst:1097 ../../whatsnew/3.13.rst:2837 +#: ../../whatsnew/3.13.rst:1097 ../../whatsnew/3.13.rst:2839 msgid "os.path" msgstr "os.path" @@ -1912,7 +1912,7 @@ msgid "" "`113117`.)" msgstr "" -#: ../../whatsnew/3.13.rst:1287 ../../whatsnew/3.13.rst:2827 +#: ../../whatsnew/3.13.rst:1287 ../../whatsnew/3.13.rst:2829 msgid "sys" msgstr "sys" @@ -3016,9 +3016,9 @@ msgid "" "has yet to be supported by any major type checker. (Contributed by Alex " "Waygood in :gh:`106309`.)" msgstr "" -"棄用 :func:`typing.no_type_check_decorator` 裝飾器函式。" -"將在 Python 3.15 中移除。在 :mod:`typing` 模組中經過八年後，" -"它至今仍未被任何主要的型別檢查器所支援。（由 Alex Waygood 在 :gh:`106309` 中貢獻。）" +"棄用 :func:`typing.no_type_check_decorator` 裝飾器函式。將在 Python 3.15 中移" +"除。在 :mod:`typing` 模組中經過八年後，它至今仍未被任何主要的型別檢查器所支" +"援。（由 Alex Waygood 在 :gh:`106309` 中貢獻。）" #: ../../whatsnew/3.13.rst:2013 msgid "" @@ -3436,11 +3436,10 @@ msgid "" "since Python 3.13. Use ``class TD(TypedDict): pass`` or ``TD = " "TypedDict(\"TD\", {})`` to create a TypedDict with zero field." msgstr "" -"當使用 :class:`~typing.TypedDict` 的函式語法時，未傳遞值給 *fields* " -"參數 (``TD = TypedDict(\"TD\")``) 或傳遞 ``None`` (``TD = " -"TypedDict(\"TD\", None)``) 的做法自 Python 3.13 起已被棄用。請" -"使用 ``class TD(TypedDict): pass`` 或 ``TD = " -"TypedDict(\"TD\", {})`` 來建立具有零個欄位的 TypedDict。" +"當使用 :class:`~typing.TypedDict` 的函式語法時，未傳遞值給 *fields* 參數 " +"(``TD = TypedDict(\"TD\")``) 或傳遞 ``None`` (``TD = TypedDict(\"TD\", " +"None)``) 的做法自 Python 3.13 起已被棄用。請使用 ``class TD(TypedDict): " +"pass`` 或 ``TD = TypedDict(\"TD\", {})`` 來建立具有零個欄位的 TypedDict。" #: ../../deprecations/pending-removal-in-3.15.rst:95 msgid "" @@ -3462,6 +3461,7 @@ msgstr "" "`~wave.Wave_read.getmark`、:meth:`!setmark` 和 :meth:`~wave.Wave_read." "getmarkers` 方法自 Python 3.13 被棄用。" +#: ../../deprecations/c-api-pending-removal-in-3.16.rst:2 #: ../../deprecations/pending-removal-in-3.16.rst:2 msgid "Pending removal in Python 3.16" msgstr "Python 3.16 中待移除的項目" @@ -4794,7 +4794,7 @@ msgid "Deprecate old Python initialization functions:" msgstr "棄用舊的 Python 初始化函式：" #: ../../whatsnew/3.13.rst:2501 -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:13 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:12 msgid "" ":c:func:`PySys_ResetWarnOptions`: Clear :data:`sys.warnoptions` and :data:`!" "warnings.filters` instead." @@ -4807,7 +4807,7 @@ msgid ":c:func:`Py_GetExecPrefix`: Get :data:`sys.exec_prefix` instead." msgstr ":c:func:`Py_GetExecPrefix`：請改用 :data:`sys.exec_prefix`。" #: ../../whatsnew/3.13.rst:2505 -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:17 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:16 msgid ":c:func:`Py_GetPath`: Get :data:`sys.path` instead." msgstr ":c:func:`Py_GetPath`：請改用 :data:`sys.path`。" @@ -4816,17 +4816,17 @@ msgid ":c:func:`Py_GetPrefix`: Get :data:`sys.prefix` instead." msgstr ":c:func:`Py_GetPrefix`：請改用 :data:`sys.prefix`。" #: ../../whatsnew/3.13.rst:2509 -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:21 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:20 msgid ":c:func:`Py_GetProgramFullPath`: Get :data:`sys.executable` instead." msgstr ":c:func:`Py_GetProgramFullPath`：請改用 :data:`sys.executable`。" #: ../../whatsnew/3.13.rst:2511 -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:23 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:22 msgid ":c:func:`Py_GetProgramName`: Get :data:`sys.executable` instead." msgstr ":c:func:`Py_GetProgramName`：請改用 :data:`sys.executable`。" #: ../../whatsnew/3.13.rst:2513 -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:25 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:24 msgid "" ":c:func:`Py_GetPythonHome`: Get :c:member:`PyConfig.home` or the :envvar:" "`PYTHONHOME` environment variable instead." @@ -5087,10 +5087,6 @@ msgstr "" "func:`Py_PreInitialize`）" #: ../../deprecations/c-api-pending-removal-in-3.15.rst:4 -msgid "The bundled copy of ``libmpdecimal``." -msgstr "``libmpdecimal`` 的打包副本 (bundled copy)。" - -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:5 msgid "" "The :c:func:`PyImport_ImportModuleNoBlock`: Use :c:func:" "`PyImport_ImportModule` instead." @@ -5098,7 +5094,7 @@ msgstr "" ":c:func:`PyImport_ImportModuleNoBlock`：請改用 :c:func:" "`PyImport_ImportModule`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:7 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:6 msgid "" ":c:func:`PyWeakref_GetObject` and :c:func:`PyWeakref_GET_OBJECT`: Use :c:" "func:`PyWeakref_GetRef` instead." @@ -5106,7 +5102,7 @@ msgstr "" ":c:func:`PyWeakref_GetObject` 和 :c:func:`PyWeakref_GET_OBJECT`：請改用 :c:" "func:`PyWeakref_GetRef`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:9 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:8 msgid "" ":c:type:`Py_UNICODE` type and the :c:macro:`!Py_UNICODE_WIDE` macro: Use :c:" "type:`wchar_t` instead." @@ -5114,11 +5110,11 @@ msgstr "" ":c:type:`Py_UNICODE` 型別與 :c:macro:`!Py_UNICODE_WIDE` 巨集：請改用 :c:type:" "`wchar_t`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:11 +#: ../../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:15 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:14 msgid "" ":c:func:`Py_GetExecPrefix`: Get :data:`sys.base_exec_prefix` and :data:`sys." "exec_prefix` instead." @@ -5126,7 +5122,7 @@ msgstr "" ":c:func:`Py_GetExecPrefix`：請改用 :data:`sys.base_exec_prefix` 與 :data:" "`sys.exec_prefix`。" -#: ../../deprecations/c-api-pending-removal-in-3.15.rst:19 +#: ../../deprecations/c-api-pending-removal-in-3.15.rst:18 msgid "" ":c:func:`Py_GetPrefix`: Get :data:`sys.base_prefix` and :data:`sys.prefix` " "instead." @@ -5134,6 +5130,11 @@ msgstr "" ":c:func:`Py_GetPrefix`：請改用 :data:`sys.base_prefix` 與 :data:`sys." "prefix`。" +#: ../../deprecations/c-api-pending-removal-in-3.16.rst:4 +#, fuzzy +msgid "The bundled copy of ``libmpdec``." +msgstr "``libmpdecimal`` 的打包副本 (bundled copy)。" + #: ../../deprecations/c-api-pending-removal-in-future.rst:4 msgid "" "The following APIs are deprecated and will be removed, although there is " @@ -5265,56 +5266,56 @@ msgstr "" msgid ":c:func:`PyThread_ReInitTLS`: Unneeded since Python 3.7." msgstr ":c:func:`PyThread_ReInitTLS`：自 Python 3.7 起不再需要。" -#: ../../whatsnew/3.13.rst:2562 +#: ../../whatsnew/3.13.rst:2564 msgid "Build Changes" msgstr "建置變更" -#: ../../whatsnew/3.13.rst:2564 +#: ../../whatsnew/3.13.rst:2566 msgid "" "``arm64-apple-ios`` and ``arm64-apple-ios-simulator`` are both now :pep:`11` " "tier 3 platforms. (:ref:`PEP 730 ` written and " "implementation contributed by Russell Keith-Magee in :gh:`114099`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2569 +#: ../../whatsnew/3.13.rst:2571 msgid "" "``aarch64-linux-android`` and ``x86_64-linux-android`` are both now :pep:" "`11` tier 3 platforms. (:ref:`PEP 738 ` " "written and implementation contributed by Malcolm Smith in :gh:`116622`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2574 +#: ../../whatsnew/3.13.rst:2576 msgid "" "``wasm32-wasi`` is now a :pep:`11` tier 2 platform. (Contributed by Brett " "Cannon in :gh:`115192`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2577 +#: ../../whatsnew/3.13.rst:2579 msgid "" "``wasm32-emscripten`` is no longer a :pep:`11` supported platform. " "(Contributed by Brett Cannon in :gh:`115192`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2580 +#: ../../whatsnew/3.13.rst:2582 msgid "" "Building CPython now requires a compiler with support for the C11 atomic " "library, GCC built-in atomic functions, or MSVC interlocked intrinsics." msgstr "" -#: ../../whatsnew/3.13.rst:2583 +#: ../../whatsnew/3.13.rst:2585 msgid "" "Autoconf 2.71 and aclocal 1.16.5 are now required to regenerate the :file:" "`configure` script. (Contributed by Christian Heimes in :gh:`89886` and by " "Victor Stinner in :gh:`112090`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2587 +#: ../../whatsnew/3.13.rst:2589 msgid "" "SQLite 3.15.2 or newer is required to build the :mod:`sqlite3` extension " "module. (Contributed by Erlend Aasland in :gh:`105875`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2591 +#: ../../whatsnew/3.13.rst:2593 msgid "" "CPython now bundles the `mimalloc library`_ by default. It is licensed under " "the MIT license; see :ref:`mimalloc license `. The bundled " @@ -5322,28 +5323,27 @@ msgid "" "Dino Viehland in :gh:`109914`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2599 +#: ../../whatsnew/3.13.rst:2601 msgid "" "The :file:`configure` option :option:`--with-system-libmpdec` now defaults " -"to ``yes``. The bundled copy of ``libmpdecimal`` will be removed in Python " -"3.15." +"to ``yes``. The bundled copy of ``libmpdec`` will be removed in Python 3.16." msgstr "" -#: ../../whatsnew/3.13.rst:2603 +#: ../../whatsnew/3.13.rst:2605 msgid "" "Python built with :file:`configure` :option:`--with-trace-refs` (tracing " "references) is now ABI compatible with the Python release build and :ref:" "`debug build `. (Contributed by Victor Stinner in :gh:`108634`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2608 +#: ../../whatsnew/3.13.rst:2610 msgid "" "On POSIX systems, the pkg-config (``.pc``) filenames now include the ABI " "flags. For example, the free-threaded build generates ``python-3.13t.pc`` " "and the debug build generates ``python-3.13d.pc``." msgstr "" -#: ../../whatsnew/3.13.rst:2612 +#: ../../whatsnew/3.13.rst:2614 msgid "" "The ``errno``, ``fcntl``, ``grp``, ``md5``, ``pwd``, ``resource``, " "``termios``, ``winsound``, ``_ctypes_test``, ``_multiprocessing." @@ -5353,27 +5353,27 @@ msgid "" "`85283`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2621 +#: ../../whatsnew/3.13.rst:2623 msgid "Porting to Python 3.13" msgstr "移植至 Python 3.13" -#: ../../whatsnew/3.13.rst:2623 +#: ../../whatsnew/3.13.rst:2625 msgid "" "This section lists previously described changes and other bugfixes that may " "require changes to your code." msgstr "" -#: ../../whatsnew/3.13.rst:2627 +#: ../../whatsnew/3.13.rst:2629 msgid "Changes in the Python API" msgstr "Python API 的變更" -#: ../../whatsnew/3.13.rst:2631 +#: ../../whatsnew/3.13.rst:2633 msgid "" ":ref:`PEP 667 ` introduces several changes to " "the semantics of :func:`locals` and :attr:`f_locals `:" msgstr "" -#: ../../whatsnew/3.13.rst:2634 +#: ../../whatsnew/3.13.rst:2636 msgid "" "Calling :func:`locals` in an :term:`optimized scope` now produces an " "independent snapshot on each call, and hence no longer implicitly updates " @@ -5385,7 +5385,7 @@ msgid "" "scope. (Changed as part of :pep:`667`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2643 +#: ../../whatsnew/3.13.rst:2645 msgid "" "Calling :func:`locals` from a comprehension at module or class scope " "(including via ``exec`` or ``eval``) once more behaves as if the " @@ -5395,7 +5395,7 @@ msgid "" "implementing :pep:`709`. (Changed as part of :pep:`667`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2650 +#: ../../whatsnew/3.13.rst:2652 msgid "" "Accessing :attr:`FrameType.f_locals ` in an :term:`optimized " "scope` now returns a write-through proxy rather than a snapshot that gets " @@ -5404,7 +5404,7 @@ msgid "" "of :pep:`667`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2656 +#: ../../whatsnew/3.13.rst:2658 msgid "" ":class:`functools.partial` now emits a :exc:`FutureWarning` when used as a " "method. The behavior will change in future Python versions. Wrap it in :func:" @@ -5412,14 +5412,14 @@ msgid "" "Serhiy Storchaka in :gh:`121027`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2662 +#: ../../whatsnew/3.13.rst:2664 msgid "" "An :exc:`OSError` is now raised by :func:`getpass.getuser` for any failure " "to retrieve a username, instead of :exc:`ImportError` on non-Unix platforms " "or :exc:`KeyError` on Unix platforms where the password database is empty." msgstr "" -#: ../../whatsnew/3.13.rst:2667 +#: ../../whatsnew/3.13.rst:2669 msgid "" "The value of the :attr:`!mode` attribute of :class:`gzip.GzipFile` is now a " "string (``'rb'`` or ``'wb'``) instead of an integer (``1`` or ``2``). The " @@ -5428,13 +5428,13 @@ msgid "" "(Contributed by Serhiy Storchaka in :gh:`115961`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2673 +#: ../../whatsnew/3.13.rst:2675 msgid "" ":class:`mailbox.Maildir` now ignores files with a leading dot (``.``). " "(Contributed by Zackery Spytz in :gh:`65559`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2676 +#: ../../whatsnew/3.13.rst:2678 msgid "" ":meth:`pathlib.Path.glob` and :meth:`~pathlib.Path.rglob` now return both " "files and directories if a pattern that ends with \"``**``\" is given, " @@ -5442,25 +5442,25 @@ msgid "" "behavior and only match directories." msgstr "" -#: ../../whatsnew/3.13.rst:2681 +#: ../../whatsnew/3.13.rst:2683 msgid "" "The :mod:`threading` module now expects the :mod:`!_thread` module to have " "an :func:`!_is_main_interpreter` function. This function takes no arguments " "and returns ``True`` if the current interpreter is the main interpreter." msgstr "" -#: ../../whatsnew/3.13.rst:2686 +#: ../../whatsnew/3.13.rst:2688 msgid "" "Any library or application that provides a custom :mod:`!_thread` module " "must provide :func:`!_is_main_interpreter`, just like the module's other " "\"private\" attributes. (:gh:`112826`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2693 +#: ../../whatsnew/3.13.rst:2695 msgid "Changes in the C API" msgstr "C API 中的改動" -#: ../../whatsnew/3.13.rst:2695 +#: ../../whatsnew/3.13.rst:2697 msgid "" "``Python.h`` no longer includes the ```` standard header. It was " "included for the :c:func:`!finite` function which is now provided by the " @@ -5469,7 +5469,7 @@ msgid "" "`108765`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2701 +#: ../../whatsnew/3.13.rst:2703 msgid "" "``Python.h`` no longer includes these standard header files: ````, " "```` and ````. If needed, they should now be " @@ -5480,7 +5480,7 @@ msgid "" "Victor Stinner in :gh:`108765`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2709 +#: ../../whatsnew/3.13.rst:2711 msgid "" "On Windows, ``Python.h`` no longer includes the ```` standard " "header file. If needed, it should now be included explicitly. For example, " @@ -5490,7 +5490,7 @@ msgid "" "(Contributed by Victor Stinner in :gh:`108765`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2716 +#: ../../whatsnew/3.13.rst:2718 msgid "" "If the :c:macro:`Py_LIMITED_API` macro is defined, :c:macro:`!" "Py_BUILD_CORE`, :c:macro:`!Py_BUILD_CORE_BUILTIN` and :c:macro:`!" @@ -5498,18 +5498,18 @@ msgid "" "(Contributed by Victor Stinner in :gh:`85283`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2721 +#: ../../whatsnew/3.13.rst:2723 msgid "" "The old trashcan macros ``Py_TRASHCAN_SAFE_BEGIN`` and " "``Py_TRASHCAN_SAFE_END`` were removed. They should be replaced by the new " "macros ``Py_TRASHCAN_BEGIN`` and ``Py_TRASHCAN_END``." msgstr "" -#: ../../whatsnew/3.13.rst:2725 +#: ../../whatsnew/3.13.rst:2727 msgid "A ``tp_dealloc`` function that has the old macros, such as::" msgstr "有舊巨集的 ``tp_dealloc`` 函式，例如： ::" -#: ../../whatsnew/3.13.rst:2727 +#: ../../whatsnew/3.13.rst:2729 msgid "" "static void\n" "mytype_dealloc(mytype *p)\n" @@ -5529,11 +5529,11 @@ msgstr "" " Py_TRASHCAN_SAFE_END\n" "}" -#: ../../whatsnew/3.13.rst:2736 +#: ../../whatsnew/3.13.rst:2738 msgid "should migrate to the new macros as follows::" msgstr "應該改為使用新的巨集，如下所示： ::" -#: ../../whatsnew/3.13.rst:2738 +#: ../../whatsnew/3.13.rst:2740 msgid "" "static void\n" "mytype_dealloc(mytype *p)\n" @@ -5553,7 +5553,7 @@ msgstr "" " Py_TRASHCAN_END\n" "}" -#: ../../whatsnew/3.13.rst:2747 +#: ../../whatsnew/3.13.rst:2749 msgid "" "Note that ``Py_TRASHCAN_BEGIN`` has a second argument which should be the " "deallocation function it is in. The new macros were added in Python 3.8 and " @@ -5561,13 +5561,13 @@ msgid "" "in :gh:`105111`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2754 +#: ../../whatsnew/3.13.rst:2756 msgid "" ":ref:`PEP 667 ` introduces several changes to " "frame-related functions:" msgstr "" -#: ../../whatsnew/3.13.rst:2757 +#: ../../whatsnew/3.13.rst:2759 msgid "" "The effects of mutating the dictionary returned from :c:func:" "`PyEval_GetLocals` in an :term:`optimized scope` have changed. New dict " @@ -5581,7 +5581,7 @@ msgid "" "being used, so refer to the deprecation notice on the function for details." msgstr "" -#: ../../whatsnew/3.13.rst:2770 +#: ../../whatsnew/3.13.rst:2772 msgid "" "Calling :c:func:`PyFrame_GetLocals` in an :term:`optimized scope` now " "returns a write-through proxy rather than a snapshot that gets updated at " @@ -5590,40 +5590,40 @@ msgid "" "`PyEval_GetFrameLocals` API." msgstr "" -#: ../../whatsnew/3.13.rst:2777 +#: ../../whatsnew/3.13.rst:2779 msgid "" ":c:func:`!PyFrame_FastToLocals` and :c:func:`!PyFrame_FastToLocalsWithError` " "no longer have any effect. Calling these functions has been redundant since " "Python 3.11, when :c:func:`PyFrame_GetLocals` was first introduced." msgstr "" -#: ../../whatsnew/3.13.rst:2782 +#: ../../whatsnew/3.13.rst:2784 msgid "" ":c:func:`!PyFrame_LocalsToFast` no longer has any effect. Calling this " "function is redundant now that :c:func:`PyFrame_GetLocals` returns a write-" "through proxy for :term:`optimized scopes `." msgstr "" -#: ../../whatsnew/3.13.rst:2786 +#: ../../whatsnew/3.13.rst:2788 msgid "" "Python 3.13 removed many private functions. Some of them can be replaced " "using these alternatives:" msgstr "" -#: ../../whatsnew/3.13.rst:2789 +#: ../../whatsnew/3.13.rst:2791 msgid "``_PyDict_Pop()``: :c:func:`PyDict_Pop` or :c:func:`PyDict_PopString`;" msgstr "" "``_PyDict_Pop()``：:c:func:`PyDict_Pop` 或 :c:func:`PyDict_PopString`；" -#: ../../whatsnew/3.13.rst:2790 +#: ../../whatsnew/3.13.rst:2792 msgid "``_PyDict_GetItemWithError()``: :c:func:`PyDict_GetItemRef`;" msgstr "``_PyDict_GetItemWithError()``：:c:func:`PyDict_GetItemRef`；" -#: ../../whatsnew/3.13.rst:2791 +#: ../../whatsnew/3.13.rst:2793 msgid "``_PyErr_WriteUnraisableMsg()``: :c:func:`PyErr_FormatUnraisable`;" msgstr "``_PyErr_WriteUnraisableMsg()``：:c:func:`PyErr_FormatUnraisable`；" -#: ../../whatsnew/3.13.rst:2792 +#: ../../whatsnew/3.13.rst:2794 msgid "" "``_PyEval_SetTrace()``: :c:func:`PyEval_SetTrace` or :c:func:" "`PyEval_SetTraceAllThreads`;" @@ -5631,43 +5631,43 @@ msgstr "" "``_PyEval_SetTrace()``：:c:func:`PyEval_SetTrace` 或 :c:func:" "`PyEval_SetTraceAllThreads`；" -#: ../../whatsnew/3.13.rst:2793 +#: ../../whatsnew/3.13.rst:2795 msgid "``_PyList_Extend()``: :c:func:`PyList_Extend`;" msgstr "``_PyList_Extend()``：:c:func:`PyList_Extend`；" -#: ../../whatsnew/3.13.rst:2794 +#: ../../whatsnew/3.13.rst:2796 msgid "``_PyLong_AsInt()``: :c:func:`PyLong_AsInt`;" msgstr "``_PyLong_AsInt()``：:c:func:`PyLong_AsInt`；" -#: ../../whatsnew/3.13.rst:2795 +#: ../../whatsnew/3.13.rst:2797 msgid "``_PyMem_RawStrdup()``: ``strdup()``;" msgstr "``_PyMem_RawStrdup()``：``strdup()``；" -#: ../../whatsnew/3.13.rst:2796 +#: ../../whatsnew/3.13.rst:2798 msgid "``_PyMem_Strdup()``: ``strdup()``;" msgstr "``_PyMem_Strdup()``：``strdup()``；" -#: ../../whatsnew/3.13.rst:2797 +#: ../../whatsnew/3.13.rst:2799 msgid "``_PyObject_ClearManagedDict()``: :c:func:`PyObject_ClearManagedDict`;" msgstr "" "``_PyObject_ClearManagedDict()``：:c:func:`PyObject_ClearManagedDict`；" -#: ../../whatsnew/3.13.rst:2798 +#: ../../whatsnew/3.13.rst:2800 msgid "``_PyObject_VisitManagedDict()``: :c:func:`PyObject_VisitManagedDict`;" msgstr "" "``_PyObject_VisitManagedDict()``：:c:func:`PyObject_VisitManagedDict`；" -#: ../../whatsnew/3.13.rst:2799 +#: ../../whatsnew/3.13.rst:2801 msgid "" "``_PyThreadState_UncheckedGet()``: :c:func:`PyThreadState_GetUnchecked()`;" msgstr "" "``_PyThreadState_UncheckedGet()``：:c:func:`PyThreadState_GetUnchecked()`；" -#: ../../whatsnew/3.13.rst:2800 +#: ../../whatsnew/3.13.rst:2802 msgid "``_PyTime_AsSecondsDouble()``: :c:func:`PyTime_AsSecondsDouble`;" msgstr "``_PyTime_AsSecondsDouble()``：:c:func:`PyTime_AsSecondsDouble`；" -#: ../../whatsnew/3.13.rst:2801 +#: ../../whatsnew/3.13.rst:2803 msgid "" "``_PyTime_GetMonotonicClock()``: :c:func:`PyTime_Monotonic` or :c:func:" "`PyTime_MonotonicRaw`;" @@ -5675,7 +5675,7 @@ msgstr "" "``_PyTime_GetMonotonicClock()``：:c:func:`PyTime_Monotonic` 或 :c:func:" "`PyTime_MonotonicRaw`；" -#: ../../whatsnew/3.13.rst:2802 +#: ../../whatsnew/3.13.rst:2804 msgid "" "``_PyTime_GetPerfCounter()``: :c:func:`PyTime_PerfCounter` or :c:func:" "`PyTime_PerfCounterRaw`;" @@ -5683,7 +5683,7 @@ msgstr "" "``_PyTime_GetPerfCounter()``：:c:func:`PyTime_PerfCounter` 或 :c:func:" "`PyTime_PerfCounterRaw`；" -#: ../../whatsnew/3.13.rst:2803 +#: ../../whatsnew/3.13.rst:2805 msgid "" "``_PyTime_GetSystemClock()``: :c:func:`PyTime_Time` or :c:func:" "`PyTime_TimeRaw`;" @@ -5691,27 +5691,27 @@ msgstr "" "``_PyTime_GetSystemClock()``：:c:func:`PyTime_Time` 或 :c:func:" "`PyTime_TimeRaw`；" -#: ../../whatsnew/3.13.rst:2804 +#: ../../whatsnew/3.13.rst:2806 msgid "``_PyTime_MAX``: :c:var:`PyTime_MAX`;" msgstr "``_PyTime_MAX``：:c:var:`PyTime_MAX`；" -#: ../../whatsnew/3.13.rst:2805 +#: ../../whatsnew/3.13.rst:2807 msgid "``_PyTime_MIN``: :c:var:`PyTime_MIN`;" msgstr "``_PyTime_MIN``：:c:var:`PyTime_MIN`；" -#: ../../whatsnew/3.13.rst:2806 +#: ../../whatsnew/3.13.rst:2808 msgid "``_PyTime_t``: :c:type:`PyTime_t`;" msgstr "``_PyTime_t``：:c:type:`PyTime_t`；" -#: ../../whatsnew/3.13.rst:2807 +#: ../../whatsnew/3.13.rst:2809 msgid "``_Py_HashPointer()``: :c:func:`Py_HashPointer`;" msgstr "``_Py_HashPointer()``：:c:func:`Py_HashPointer`；" -#: ../../whatsnew/3.13.rst:2808 +#: ../../whatsnew/3.13.rst:2810 msgid "``_Py_IsFinalizing()``: :c:func:`Py_IsFinalizing`." msgstr "``_Py_IsFinalizing()``：:c:func:`Py_IsFinalizing`。" -#: ../../whatsnew/3.13.rst:2810 +#: ../../whatsnew/3.13.rst:2812 msgid "" "The `pythoncapi-compat project`_ can be used to get most of these new " "functions on Python 3.12 and older." @@ -5719,11 +5719,11 @@ msgstr "" "可以使用 `pythoncapi-compat 專案`_\\ 來在 Python 3.12 及更舊的版本中取用大部" "分的這些新函式。" -#: ../../whatsnew/3.13.rst:2814 +#: ../../whatsnew/3.13.rst:2816 msgid "Regression Test Changes" msgstr "迴歸測試的變更" -#: ../../whatsnew/3.13.rst:2816 +#: ../../whatsnew/3.13.rst:2818 msgid "" "Python built with :file:`configure` :option:`--with-pydebug` now supports a :" "option:`-X presite=package.module <-X>` command-line option. If used, it " @@ -5736,11 +5736,11 @@ msgstr "" "該在解譯器生命週期的早期階段、在執行 ``site.py`` 之前被引入的模組。(由 " "Łukasz Langa 在 :gh:`110769` 中貢獻。)" -#: ../../whatsnew/3.13.rst:2824 +#: ../../whatsnew/3.13.rst:2826 msgid "Notable changes in 3.13.1" msgstr "Python 3.13.1 中顯著的變更" -#: ../../whatsnew/3.13.rst:2829 +#: ../../whatsnew/3.13.rst:2831 msgid "" "The previously undocumented special function :func:`sys.getobjects`, which " "only exists in specialized builds of Python, may now return objects from " @@ -5749,11 +5749,11 @@ msgstr "" "先前未以文件記錄的特殊函式 :func:`sys.getobjects`，只存在於 Python 的特殊建置" "中，現在可能會回傳來自於呼叫它的直譯器之外的物件。" -#: ../../whatsnew/3.13.rst:2834 +#: ../../whatsnew/3.13.rst:2836 msgid "Notable changes in 3.13.4" msgstr "Python 3.13.4 中顯著的變更" -#: ../../whatsnew/3.13.rst:2839 +#: ../../whatsnew/3.13.rst:2841 msgid "" "The *strict* parameter to :func:`os.path.realpath` accepts a new value, :" "data:`os.path.ALLOW_MISSING`. If used, errors other than :exc:" @@ -5762,25 +5762,25 @@ msgid "" "`2025-4517`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2846 +#: ../../whatsnew/3.13.rst:2848 msgid "tarfile" msgstr "tarfile" -#: ../../whatsnew/3.13.rst:2848 +#: ../../whatsnew/3.13.rst:2850 msgid "" ":func:`~tarfile.data_filter` now normalizes symbolic link targets in order " "to avoid path traversal attacks.Add commentMore actions (Contributed by Petr " "Viktorin in :gh:`127987` and :cve:`2025-4138`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2851 +#: ../../whatsnew/3.13.rst:2853 msgid "" ":func:`~tarfile.TarFile.extractall` now skips fixing up directory attributes " "when a directory was removed or replaced by another kind of file. " "(Contributed by Petr Viktorin in :gh:`127987` and :cve:`2024-12718`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2854 +#: ../../whatsnew/3.13.rst:2856 msgid "" ":func:`~tarfile.TarFile.extract` and :func:`~tarfile.TarFile.extractall` now " "(re-)apply the extraction filter when substituting a link (hard or symbolic) " @@ -5790,7 +5790,7 @@ msgid "" "cve:`2024-12718`.)" msgstr "" -#: ../../whatsnew/3.13.rst:2860 +#: ../../whatsnew/3.13.rst:2862 msgid "" ":func:`~tarfile.TarFile.extract` and :func:`~tarfile.TarFile.extractall` no " "longer extract rejected members when :func:`~tarfile.TarFile.errorlevel` is "