sync with cpython 321ec5e0

Author: github-actions[bot]

c-api/code.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-07-30 00:03+0000\n"
+"POT-Creation-Date: 2024-02-10 00:03+0000\n"
 "PO-Revision-Date: 2015-12-09 17:51+0000\n"
 "Last-Translator: Liang-Bo Wang <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -37,181 +37,181 @@ msgstr ""
 
 #: ../../c-api/code.rst:24
 msgid ""
-"This is an instance of :c:type:`PyTypeObject` representing the Python :class:"
-"`code` type."
+"This is an instance of :c:type:`PyTypeObject` representing the Python :ref:"
+"`code object <code-objects>`."
 msgstr ""
 
 #: ../../c-api/code.rst:30
 msgid ""
-"Return true if *co* is a :class:`code` object.  This function always "
-"succeeds."
+"Return true if *co* is a :ref:`code object <code-objects>`. This function "
+"always succeeds."
 msgstr ""
 
-#: ../../c-api/code.rst:34
+#: ../../c-api/code.rst:35
 msgid "Return the number of free variables in *co*."
 msgstr ""
 
-#: ../../c-api/code.rst:38
+#: ../../c-api/code.rst:39
 msgid ""
 "Return a new code object.  If you need a dummy code object to create a "
 "frame, use :c:func:`PyCode_NewEmpty` instead."
 msgstr ""
 
-#: ../../c-api/code.rst:41
+#: ../../c-api/code.rst:42
 msgid ""
 "Since the definition of the bytecode changes often, calling :c:func:"
 "`PyUnstable_Code_New` directly can bind you to a precise Python version."
 msgstr ""
 
-#: ../../c-api/code.rst:44
+#: ../../c-api/code.rst:45
 msgid ""
 "The many arguments of this function are inter-dependent in complex ways, "
 "meaning that subtle changes to values are likely to result in incorrect "
 "execution or VM crashes. Use this function only with extreme care."
 msgstr ""
 
-#: ../../c-api/code.rst:48
+#: ../../c-api/code.rst:49
 msgid "Added ``qualname`` and ``exceptiontable`` parameters."
 msgstr "新增 ``qualname`` 和 ``exceptiontable`` 參數。"
 
-#: ../../c-api/code.rst:55
+#: ../../c-api/code.rst:56
 msgid ""
 "Renamed from ``PyCode_New`` as part of :ref:`unstable-c-api`. The old name "
 "is deprecated, but will remain available until the signature changes again."
 msgstr ""
 
-#: ../../c-api/code.rst:61
+#: ../../c-api/code.rst:62
 msgid ""
 "Similar to :c:func:`PyUnstable_Code_New`, but with an extra "
 "\"posonlyargcount\" for positional-only arguments. The same caveats that "
 "apply to ``PyUnstable_Code_New`` also apply to this function."
 msgstr ""
 
-#: ../../c-api/code.rst:66
+#: ../../c-api/code.rst:67
 msgid "as ``PyCode_NewWithPosOnlyArgs``"
 msgstr ""
 
-#: ../../c-api/code.rst:68
+#: ../../c-api/code.rst:69
 msgid "Added ``qualname`` and  ``exceptiontable`` parameters."
 msgstr "新增 ``qualname`` 和 ``exceptiontable`` 參數。"
 
-#: ../../c-api/code.rst:73
+#: ../../c-api/code.rst:74
 msgid ""
 "Renamed to ``PyUnstable_Code_NewWithPosOnlyArgs``. The old name is "
 "deprecated, but will remain available until the signature changes again."
 msgstr ""
 
-#: ../../c-api/code.rst:79
+#: ../../c-api/code.rst:80
 msgid ""
 "Return a new empty code object with the specified filename, function name, "
 "and first line number. The resulting code object will raise an ``Exception`` "
 "if executed."
 msgstr ""
 
-#: ../../c-api/code.rst:85
+#: ../../c-api/code.rst:86
 msgid ""
 "Return the line number of the instruction that occurs on or before "
 "``byte_offset`` and ends after it. If you just need the line number of a "
 "frame, use :c:func:`PyFrame_GetLineNumber` instead."
 msgstr ""
 
-#: ../../c-api/code.rst:88
+#: ../../c-api/code.rst:89
 msgid ""
 "For efficiently iterating over the line numbers in a code object, use `the "
 "API described in PEP 626 <https://peps.python.org/pep-0626/#out-of-process-"
 "debuggers-and-profilers>`_."
 msgstr ""
 
-#: ../../c-api/code.rst:93
+#: ../../c-api/code.rst:94
 msgid ""
 "Sets the passed ``int`` pointers to the source code line and column numbers "
 "for the instruction at ``byte_offset``. Sets the value to ``0`` when "
 "information is not available for any particular element."
 msgstr ""
 
-#: ../../c-api/code.rst:97
+#: ../../c-api/code.rst:98
 msgid "Returns ``1`` if the function succeeds and 0 otherwise."
 msgstr ""
 
-#: ../../c-api/code.rst:103
+#: ../../c-api/code.rst:104
 msgid ""
 "Equivalent to the Python code ``getattr(co, 'co_code')``. Returns a strong "
 "reference to a :c:type:`PyBytesObject` representing the bytecode in a code "
 "object. On error, ``NULL`` is returned and an exception is raised."
 msgstr ""
 
-#: ../../c-api/code.rst:108
+#: ../../c-api/code.rst:109
 msgid ""
 "This ``PyBytesObject`` may be created on-demand by the interpreter and does "
 "not necessarily represent the bytecode actually executed by CPython. The "
 "primary use case for this function is debuggers and profilers."
 msgstr ""
 
-#: ../../c-api/code.rst:116
+#: ../../c-api/code.rst:117
 msgid ""
 "Equivalent to the Python code ``getattr(co, 'co_varnames')``. Returns a new "
 "reference to a :c:type:`PyTupleObject` containing the names of the local "
 "variables. On error, ``NULL`` is returned and an exception is raised."
 msgstr ""
 
-#: ../../c-api/code.rst:125
+#: ../../c-api/code.rst:126
 msgid ""
 "Equivalent to the Python code ``getattr(co, 'co_cellvars')``. Returns a new "
 "reference to a :c:type:`PyTupleObject` containing the names of the local "
 "variables that are referenced by nested functions. On error, ``NULL`` is "
 "returned and an exception is raised."
 msgstr ""
 
-#: ../../c-api/code.rst:134
+#: ../../c-api/code.rst:135
 msgid ""
 "Equivalent to the Python code ``getattr(co, 'co_freevars')``. Returns a new "
 "reference to a :c:type:`PyTupleObject` containing the names of the free "
 "variables. On error, ``NULL`` is returned and an exception is raised."
 msgstr ""
 
-#: ../../c-api/code.rst:142
+#: ../../c-api/code.rst:143
 msgid ""
 "Register *callback* as a code object watcher for the current interpreter. "
 "Return an ID which may be passed to :c:func:`PyCode_ClearWatcher`. In case "
 "of error (e.g. no more watcher IDs available), return ``-1`` and set an "
 "exception."
 msgstr ""
 
-#: ../../c-api/code.rst:151
+#: ../../c-api/code.rst:152
 msgid ""
 "Clear watcher identified by *watcher_id* previously returned from :c:func:"
 "`PyCode_AddWatcher` for the current interpreter. Return ``0`` on success, or "
 "``-1`` and set an exception on error (e.g. if the given *watcher_id* was "
 "never registered.)"
 msgstr ""
 
-#: ../../c-api/code.rst:160
+#: ../../c-api/code.rst:161
 msgid ""
 "Enumeration of possible code object watcher events: - "
 "``PY_CODE_EVENT_CREATE`` - ``PY_CODE_EVENT_DESTROY``"
 msgstr ""
 
-#: ../../c-api/code.rst:168
+#: ../../c-api/code.rst:169
 msgid "Type of a code object watcher callback function."
 msgstr ""
 
-#: ../../c-api/code.rst:170
+#: ../../c-api/code.rst:171
 msgid ""
 "If *event* is ``PY_CODE_EVENT_CREATE``, then the callback is invoked after "
 "`co` has been fully initialized. Otherwise, the callback is invoked before "
 "the destruction of *co* takes place, so the prior state of *co* can be "
 "inspected."
 msgstr ""
 
-#: ../../c-api/code.rst:175
+#: ../../c-api/code.rst:176
 msgid ""
 "If *event* is ``PY_CODE_EVENT_DESTROY``, taking a reference in the callback "
 "to the about-to-be-destroyed code object will resurrect it and prevent it "
 "from being freed at this time. When the resurrected object is destroyed "
 "later, any watcher callbacks active at that time will be called again."
 msgstr ""
 
-#: ../../c-api/code.rst:180
+#: ../../c-api/code.rst:181
 msgid ""
 "Users of this API should not rely on internal runtime implementation "
 "details. Such details may include, but are not limited to, the exact order "
@@ -221,14 +221,14 @@ msgid ""
 "the Python code being executed."
 msgstr ""
 
-#: ../../c-api/code.rst:187
+#: ../../c-api/code.rst:188
 msgid ""
 "If the callback sets an exception, it must return ``-1``; this exception "
 "will be printed as an unraisable exception using :c:func:"
 "`PyErr_WriteUnraisable`. Otherwise it should return ``0``."
 msgstr ""
 
-#: ../../c-api/code.rst:191
+#: ../../c-api/code.rst:192
 msgid ""
 "There may already be a pending exception set on entry to the callback. In "
 "this case, the callback should return ``0`` with the same exception still "
@@ -237,85 +237,85 @@ msgid ""
 "it before returning."
 msgstr ""
 
-#: ../../c-api/code.rst:201
+#: ../../c-api/code.rst:202
 msgid "Extra information"
 msgstr ""
 
-#: ../../c-api/code.rst:203
+#: ../../c-api/code.rst:204
 msgid ""
 "To support low-level extensions to frame evaluation, such as external just-"
 "in-time compilers, it is possible to attach arbitrary extra data to code "
 "objects."
 msgstr ""
 
-#: ../../c-api/code.rst:207
+#: ../../c-api/code.rst:208
 msgid ""
 "These functions are part of the unstable C API tier: this functionality is a "
 "CPython implementation detail, and the API may change without deprecation "
 "warnings."
 msgstr ""
 
-#: ../../c-api/code.rst:213
+#: ../../c-api/code.rst:214
 msgid "Return a new an opaque index value used to adding data to code objects."
 msgstr ""
 
-#: ../../c-api/code.rst:215
+#: ../../c-api/code.rst:216
 msgid ""
 "You generally call this function once (per interpreter) and use the result "
 "with ``PyCode_GetExtra`` and ``PyCode_SetExtra`` to manipulate data on "
 "individual code objects."
 msgstr ""
 
-#: ../../c-api/code.rst:219
+#: ../../c-api/code.rst:220
 msgid ""
 "If *free* is not ``NULL``: when a code object is deallocated, *free* will be "
 "called on non-``NULL`` data stored under the new index. Use :c:func:"
 "`Py_DecRef` when storing :c:type:`PyObject`."
 msgstr ""
 
-#: ../../c-api/code.rst:225
+#: ../../c-api/code.rst:226
 msgid "as ``_PyEval_RequestCodeExtraIndex``"
 msgstr ""
 
-#: ../../c-api/code.rst:229
+#: ../../c-api/code.rst:230
 msgid ""
 "Renamed to ``PyUnstable_Eval_RequestCodeExtraIndex``. The old private name "
 "is deprecated, but will be available until the API changes."
 msgstr ""
 
-#: ../../c-api/code.rst:235
+#: ../../c-api/code.rst:236
 msgid ""
 "Set *extra* to the extra data stored under the given index. Return 0 on "
 "success. Set an exception and return -1 on failure."
 msgstr ""
 
-#: ../../c-api/code.rst:238
+#: ../../c-api/code.rst:239
 msgid ""
 "If no data was set under the index, set *extra* to ``NULL`` and return 0 "
 "without setting an exception."
 msgstr ""
 
-#: ../../c-api/code.rst:243
+#: ../../c-api/code.rst:244
 msgid "as ``_PyCode_GetExtra``"
 msgstr ""
 
-#: ../../c-api/code.rst:247
+#: ../../c-api/code.rst:248
 msgid ""
 "Renamed to ``PyUnstable_Code_GetExtra``. The old private name is deprecated, "
 "but will be available until the API changes."
 msgstr ""
 
-#: ../../c-api/code.rst:253
+#: ../../c-api/code.rst:254
 msgid ""
 "Set the extra data stored under the given index to *extra*. Return 0 on "
 "success. Set an exception and return -1 on failure."
 msgstr ""
 
-#: ../../c-api/code.rst:258
+#: ../../c-api/code.rst:259
 msgid "as ``_PyCode_SetExtra``"
 msgstr ""
 
-#: ../../c-api/code.rst:262
+#: ../../c-api/code.rst:263
 msgid ""
 "Renamed to ``PyUnstable_Code_SetExtra``. The old private name is deprecated, "
 "but will be available until the API changes."
@@ -333,22 +333,22 @@ msgstr "code（程式碼）"
 msgid "code object"
 msgstr "code object（程式碼物件）"
 
-#: ../../c-api/code.rst:51
+#: ../../c-api/code.rst:52
 msgid "PyCode_New"
 msgstr "PyCode_New"
 
-#: ../../c-api/code.rst:64
+#: ../../c-api/code.rst:65
 msgid "PyCode_NewWithPosOnlyArgs"
 msgstr "PyCode_NewWithPosOnlyArgs"
 
-#: ../../c-api/code.rst:223
+#: ../../c-api/code.rst:224
 msgid "_PyEval_RequestCodeExtraIndex"
 msgstr "_PyEval_RequestCodeExtraIndex"
 
-#: ../../c-api/code.rst:241
+#: ../../c-api/code.rst:242
 msgid "_PyCode_GetExtra"
 msgstr "_PyCode_GetExtra"
 
-#: ../../c-api/code.rst:256
+#: ../../c-api/code.rst:257
 msgid "_PyCode_SetExtra"
 msgstr "_PyCode_SetExtra"