# Copyright (C) 2001 Python Software Foundation

# This file is distributed under the same license as the Python package.

#

# Translators:

msgid ""

msgstr ""

"Project-Id-Version: Python 3.14\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2026-01-15 00:15+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-"

"tw)\n"

"Language: zh_TW\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../c-api/code.rst:8

msgid "Code Objects"

msgstr "程式碼物件"

#: ../../c-api/code.rst:12

msgid ""

"Code objects are a low-level detail of the CPython implementation. Each one "

"represents a chunk of executable code that hasn't yet been bound into a "

"function."

msgstr ""

"程式碼物件是 CPython 實作的低階細節。每個程式碼物件都代表一段尚未綁定到函式的可執行程式碼。"

#: ../../c-api/code.rst:18

msgid ""

"The C structure of the objects used to describe code objects. The fields of "

"this type are subject to change at any time."

msgstr "用於描述程式碼物件的 C 結構。此型別的欄位隨時可能變更。"

#: ../../c-api/code.rst:24

msgid ""

"This is an instance of :c:type:`PyTypeObject` representing the Python :ref:"

"`code object <code-objects>`."

msgstr ""

"這是 :c:type:`PyTypeObject` 的一個實例，代表 Python 的\\ :ref:`程式碼物件 <code-objects>`。"

#: ../../c-api/code.rst:30

msgid ""

"Return true if *co* is a :ref:`code object <code-objects>`. This function "

"always succeeds."

msgstr ""

"如果 *co* 是\\ :ref:`程式碼物件 <code-objects>`，則回傳 true。此函式總會成功執行。"

#: ../../c-api/code.rst:35

msgid ""

"Return the number of :term:`free (closure) variables <closure variable>` in "

"a code object."

msgstr "回傳程式碼物件中\\ :term:`自由（閉包）變數 <closure variable>`\\ 的數量。"

#: ../../c-api/code.rst:40

msgid ""

"Return the position of the first :term:`free (closure) variable <closure "

"variable>` in a code object."

msgstr "回傳程式碼物件中第一個\\ :term:`自由（閉包）變數 <closure variable>`\\ 的位置。"

#: ../../c-api/code.rst:45

msgid ""

"Renamed from ``PyCode_GetFirstFree`` 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:51

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:54

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:57

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:61

msgid "Added ``qualname`` and ``exceptiontable`` parameters."

msgstr "新增 ``qualname`` 和 ``exceptiontable`` 參數。"

#: ../../c-api/code.rst:68

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:77

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:80

msgid "as ``PyCode_NewWithPosOnlyArgs``"

msgstr "名為 ``PyCode_NewWithPosOnlyArgs``"

#: ../../c-api/code.rst:82

msgid "Added ``qualname`` and ``exceptiontable`` parameters."

msgstr "新增 ``qualname`` 和 ``exceptiontable`` 參數。"

#: ../../c-api/code.rst:87

msgid ""

"Renamed to ``PyUnstable_Code_NewWithPosOnlyArgs``. The old name is "

"deprecated, but will remain available until the signature changes again."

msgstr ""

"重新命名為 ``PyUnstable_Code_NewWithPosOnlyArgs``。舊的名稱已被棄用，但在簽名再次變更前仍可使用。"

#: ../../c-api/code.rst:93

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:99

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:102

msgid ""

"For efficiently iterating over the line numbers in a code object, use :pep:"

"`the API described in PEP 626 <0626#out-of-process-debuggers-and-profilers>`."

msgstr ""

#: ../../c-api/code.rst:107

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:111

msgid "Returns ``1`` if the function succeeds and 0 otherwise."

msgstr "如果函式成功則回傳 ``1``，否則回傳 ``0``。"

#: ../../c-api/code.rst:117

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:122

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:130

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:139

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:148

msgid ""

"Equivalent to the Python code ``getattr(co, 'co_freevars')``. Returns a new "

"reference to a :c:type:`PyTupleObject` containing the names of the :term:"

"`free (closure) variables <closure variable>`. On error, ``NULL`` is "

"returned and an exception is raised."

msgstr ""

#: ../../c-api/code.rst:157

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:166

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:175

msgid ""

"Enumeration of possible code object watcher events: - "

"``PY_CODE_EVENT_CREATE`` - ``PY_CODE_EVENT_DESTROY``"

msgstr ""

#: ../../c-api/code.rst:183

msgid "Type of a code object watcher callback function."

msgstr ""

#: ../../c-api/code.rst:185

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:190

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:195

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 "

"and timing of creation and destruction of code objects. While changes in "

"these details may result in differences observable by watchers (including "

"whether a callback is invoked or not), it does not change the semantics of "

"the Python code being executed."

msgstr ""

#: ../../c-api/code.rst:202

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:206

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 "

"set. This means the callback may not call any other API that can set an "

"exception unless it saves and clears the exception state first, and restores "

"it before returning."

msgstr ""

#: ../../c-api/code.rst:217

msgid "This is a :term:`soft deprecated` function that does nothing."

msgstr ""

#: ../../c-api/code.rst:219

msgid ""

"Prior to Python 3.10, this function would perform basic optimizations to a "

"code object."

msgstr ""

#: ../../c-api/code.rst:222

msgid "This function now does nothing."

msgstr ""

#: ../../c-api/code.rst:229

msgid "Code Object Flags"

msgstr "程式碼物件旗標"

#: ../../c-api/code.rst:231

msgid ""

"Code objects contain a bit-field of flags, which can be retrieved as the :"

"attr:`~codeobject.co_flags` Python attribute (for example using :c:func:"

"`PyObject_GetAttrString`), and set using a *flags* argument to :c:func:"

"`PyUnstable_Code_New` and similar functions."

msgstr ""

#: ../../c-api/code.rst:236

msgid ""

"Flags whose names start with ``CO_FUTURE_`` correspond to features normally "

"selectable by :ref:`future statements <future>`. These flags can be used in :"

"c:member:`PyCompilerFlags.cf_flags`. Note that many ``CO_FUTURE_`` flags are "

"mandatory in current versions of Python, and setting them has no effect."

msgstr ""

#: ../../c-api/code.rst:242

msgid ""

"The following flags are available. For their meaning, see the linked "

"documentation of their Python equivalents."

msgstr ""

#: ../../c-api/code.rst:250

msgid "Flag"

msgstr "旗標"

#: ../../c-api/code.rst:251

msgid "Meaning"

msgstr "意義"

#: ../../c-api/code.rst:253

msgid ":py:data:`inspect.CO_OPTIMIZED`"

msgstr ":py:data:`inspect.CO_OPTIMIZED`"

#: ../../c-api/code.rst:255

msgid ":py:data:`inspect.CO_NEWLOCALS`"

msgstr ":py:data:`inspect.CO_NEWLOCALS`"

#: ../../c-api/code.rst:257

msgid ":py:data:`inspect.CO_VARARGS`"

msgstr ":py:data:`inspect.CO_VARARGS`"

#: ../../c-api/code.rst:259

msgid ":py:data:`inspect.CO_VARKEYWORDS`"

msgstr ":py:data:`inspect.CO_VARKEYWORDS`"

#: ../../c-api/code.rst:261

msgid ":py:data:`inspect.CO_NESTED`"

msgstr ":py:data:`inspect.CO_NESTED`"

#: ../../c-api/code.rst:263

msgid ":py:data:`inspect.CO_GENERATOR`"

msgstr ":py:data:`inspect.CO_GENERATOR`"

#: ../../c-api/code.rst:265

msgid ":py:data:`inspect.CO_COROUTINE`"

msgstr ":py:data:`inspect.CO_COROUTINE`"

#: ../../c-api/code.rst:267

msgid ":py:data:`inspect.CO_ITERABLE_COROUTINE`"

msgstr ":py:data:`inspect.CO_ITERABLE_COROUTINE`"

#: ../../c-api/code.rst:269

msgid ":py:data:`inspect.CO_ASYNC_GENERATOR`"

msgstr ":py:data:`inspect.CO_ASYNC_GENERATOR`"

#: ../../c-api/code.rst:271

msgid ":py:data:`inspect.CO_HAS_DOCSTRING`"

msgstr ":py:data:`inspect.CO_HAS_DOCSTRING`"

#: ../../c-api/code.rst:273

msgid ":py:data:`inspect.CO_METHOD`"

msgstr ":py:data:`inspect.CO_METHOD`"

#: ../../c-api/code.rst:276

msgid "no effect (:py:data:`__future__.division`)"

msgstr "無效果（:py:data:`__future__.division`）"

#: ../../c-api/code.rst:278

msgid "no effect (:py:data:`__future__.absolute_import`)"

msgstr "無效果（:py:data:`__future__.absolute_import`）"

#: ../../c-api/code.rst:280

msgid "no effect (:py:data:`__future__.with_statement`)"

msgstr "無效果（:py:data:`__future__.with_statement`）"

#: ../../c-api/code.rst:282

msgid "no effect (:py:data:`__future__.print_function`)"

msgstr "無效果（:py:data:`__future__.print_function`）"

#: ../../c-api/code.rst:284

msgid "no effect (:py:data:`__future__.unicode_literals`)"

msgstr "無效果（:py:data:`__future__.unicode_literals`）"

#: ../../c-api/code.rst:286

msgid "no effect (:py:data:`__future__.generator_stop`)"

msgstr "無效果（:py:data:`__future__.generator_stop`）"

#: ../../c-api/code.rst:288

msgid ":py:data:`__future__.annotations`"

msgstr ":py:data:`__future__.annotations`"

#: ../../c-api/code.rst:292

msgid "Extra information"

msgstr "額外資訊"

#: ../../c-api/code.rst:294

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:298

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:307

msgid "Return a new opaque index value used to adding data to code objects."

msgstr ""

#: ../../c-api/code.rst:309

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:313

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:317

msgid "as ``_PyEval_RequestCodeExtraIndex``"

msgstr "名為 ``_PyEval_RequestCodeExtraIndex``"

#: ../../c-api/code.rst:321

msgid ""

"Renamed to ``PyUnstable_Eval_RequestCodeExtraIndex``. The old private name "

"is deprecated, but will be available until the API changes."

msgstr ""

"重新命名為 ``PyUnstable_Eval_RequestCodeExtraIndex``。舊的私有名稱已被棄用，但在 API "

"變更前仍可使用。"

#: ../../c-api/code.rst:330

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:333

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:336

msgid "as ``_PyCode_GetExtra``"

msgstr "名為 ``_PyCode_GetExtra``"

#: ../../c-api/code.rst:340

msgid ""

"Renamed to ``PyUnstable_Code_GetExtra``. The old private name is deprecated, "

"but will be available until the API changes."

msgstr ""

"重新命名為 ``PyUnstable_Code_GetExtra``。舊的私有名稱已被棄用，但在 API 變更前仍可使用。"

#: ../../c-api/code.rst:349

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:352

msgid "as ``_PyCode_SetExtra``"

msgstr "名為 ``_PyCode_SetExtra``"

#: ../../c-api/code.rst:356

msgid ""

"Renamed to ``PyUnstable_Code_SetExtra``. The old private name is deprecated, "

"but will be available until the API changes."

msgstr ""

"重新命名為 ``PyUnstable_Code_SetExtra``。舊的私有名稱已被棄用，但在 API 變更前仍可使用。"

#: ../../c-api/code.rst:3

msgid "object"

msgstr "object（物件）"

#: ../../c-api/code.rst:3

msgid "code"

msgstr "code（程式碼）"

#: ../../c-api/code.rst:3

msgid "code object"

msgstr "code object（程式碼物件）"

#: ../../c-api/code.rst:64

msgid "PyCode_New (C function)"

msgstr "PyCode_New（C 函式）"