sync with cpython d2fced71

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: 2024-02-12 00:03+0000\n"
+"POT-Creation-Date: 2024-02-22 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-"
@@ -48,170 +48,174 @@ msgid ""
 msgstr ""
 
 #: ../../c-api/code.rst:35
-msgid "Return the number of free variables in *co*."
+msgid "Return the number of free variables in a code object."
 msgstr ""
 
 #: ../../c-api/code.rst:39
+msgid "Return the position of the first free variable in a code object."
+msgstr ""
+
+#: ../../c-api/code.rst:43
 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:42
+#: ../../c-api/code.rst:46
 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:45
+#: ../../c-api/code.rst:49
 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:49
+#: ../../c-api/code.rst:53
 msgid "Added ``qualname`` and ``exceptiontable`` parameters."
 msgstr "新增 ``qualname`` 和 ``exceptiontable`` 參數。"
 
-#: ../../c-api/code.rst:56
+#: ../../c-api/code.rst:60
 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:62
+#: ../../c-api/code.rst:66
 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:67
+#: ../../c-api/code.rst:71
 msgid "as ``PyCode_NewWithPosOnlyArgs``"
 msgstr ""
 
-#: ../../c-api/code.rst:69
+#: ../../c-api/code.rst:73
 msgid "Added ``qualname`` and  ``exceptiontable`` parameters."
 msgstr "新增 ``qualname`` 和 ``exceptiontable`` 參數。"
 
-#: ../../c-api/code.rst:74
+#: ../../c-api/code.rst:78
 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:80
+#: ../../c-api/code.rst:84
 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:86
+#: ../../c-api/code.rst:90
 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:89
+#: ../../c-api/code.rst:93
 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:94
+#: ../../c-api/code.rst:98
 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:98
+#: ../../c-api/code.rst:102
 msgid "Returns ``1`` if the function succeeds and 0 otherwise."
 msgstr ""
 
-#: ../../c-api/code.rst:104
+#: ../../c-api/code.rst:108
 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:109
+#: ../../c-api/code.rst:113
 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:117
+#: ../../c-api/code.rst:121
 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:126
+#: ../../c-api/code.rst:130
 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:135
+#: ../../c-api/code.rst:139
 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:143
+#: ../../c-api/code.rst:147
 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:152
+#: ../../c-api/code.rst:156
 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:161
+#: ../../c-api/code.rst:165
 msgid ""
 "Enumeration of possible code object watcher events: - "
 "``PY_CODE_EVENT_CREATE`` - ``PY_CODE_EVENT_DESTROY``"
 msgstr ""
 
-#: ../../c-api/code.rst:169
+#: ../../c-api/code.rst:173
 msgid "Type of a code object watcher callback function."
 msgstr ""
 
-#: ../../c-api/code.rst:171
+#: ../../c-api/code.rst:175
 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:176
+#: ../../c-api/code.rst:180
 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:181
+#: ../../c-api/code.rst:185
 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 +225,14 @@ msgid ""
 "the Python code being executed."
 msgstr ""
 
-#: ../../c-api/code.rst:188
+#: ../../c-api/code.rst:192
 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:192
+#: ../../c-api/code.rst:196
 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 +241,85 @@ msgid ""
 "it before returning."
 msgstr ""
 
-#: ../../c-api/code.rst:202
+#: ../../c-api/code.rst:206
 msgid "Extra information"
 msgstr ""
 
-#: ../../c-api/code.rst:204
+#: ../../c-api/code.rst:208
 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:208
+#: ../../c-api/code.rst:212
 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:214
+#: ../../c-api/code.rst:218
 msgid "Return a new an opaque index value used to adding data to code objects."
 msgstr ""
 
-#: ../../c-api/code.rst:216
+#: ../../c-api/code.rst:220
 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:220
+#: ../../c-api/code.rst:224
 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:226
+#: ../../c-api/code.rst:230
 msgid "as ``_PyEval_RequestCodeExtraIndex``"
 msgstr ""
 
-#: ../../c-api/code.rst:230
+#: ../../c-api/code.rst:234
 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:236
+#: ../../c-api/code.rst:240
 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:239
+#: ../../c-api/code.rst:243
 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:244
+#: ../../c-api/code.rst:248
 msgid "as ``_PyCode_GetExtra``"
 msgstr ""
 
-#: ../../c-api/code.rst:248
+#: ../../c-api/code.rst:252
 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:254
+#: ../../c-api/code.rst:258
 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:259
+#: ../../c-api/code.rst:263
 msgid "as ``_PyCode_SetExtra``"
 msgstr ""
 
-#: ../../c-api/code.rst:263
+#: ../../c-api/code.rst:267
 msgid ""
 "Renamed to ``PyUnstable_Code_SetExtra``. The old private name is deprecated, "
 "but will be available until the API changes."
@@ -333,27 +337,27 @@ msgstr "code（程式碼）"
 msgid "code object"
 msgstr "code object（程式碼物件）"
 
-#: ../../c-api/code.rst:52
+#: ../../c-api/code.rst:56
 #, fuzzy
 msgid "PyCode_New (C function)"
 msgstr "PyCode_New"
 
-#: ../../c-api/code.rst:65
+#: ../../c-api/code.rst:69
 #, fuzzy
 msgid "PyCode_NewWithPosOnlyArgs (C function)"
 msgstr "PyCode_NewWithPosOnlyArgs"
 
-#: ../../c-api/code.rst:224
+#: ../../c-api/code.rst:228
 #, fuzzy
 msgid "_PyEval_RequestCodeExtraIndex (C function)"
 msgstr "_PyEval_RequestCodeExtraIndex"
 
-#: ../../c-api/code.rst:242
+#: ../../c-api/code.rst:246
 #, fuzzy
 msgid "_PyCode_GetExtra (C function)"
 msgstr "_PyCode_GetExtra"
 
-#: ../../c-api/code.rst:257
+#: ../../c-api/code.rst:261
 #, fuzzy
 msgid "_PyCode_SetExtra (C function)"
 msgstr "_PyCode_SetExtra"