frame.po

# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-02-28 00:16+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\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"

#: ../../c-api/frame.rst:4
msgid "Frame Objects"
msgstr "Frame 物件"

#: ../../c-api/frame.rst:8
msgid "The C structure of the objects used to describe frame objects."
msgstr "用來描述 frame 物件的 C 結構。"

#: ../../c-api/frame.rst:10
msgid "There are no public members in this structure."
msgstr "在這個結構中沒有公開的成員。"

#: ../../c-api/frame.rst:12
msgid ""
"The members of this structure were removed from the public C API. Refer to "
"the :ref:`What's New entry <pyframeobject-3.11-hiding>` for details."
msgstr ""

#: ../../c-api/frame.rst:17
msgid ""
"The :c:func:`PyEval_GetFrame` and :c:func:`PyThreadState_GetFrame` functions "
"can be used to get a frame object."
msgstr ""

#: ../../c-api/frame.rst:20
msgid "See also :ref:`Reflection <reflection>`."
msgstr "另請參閱 :ref:`Reflection <reflection>`。"

#: ../../c-api/frame.rst:24
msgid ""
"The type of frame objects. It is the same object as :py:class:`types."
"FrameType` in the Python layer."
msgstr ""

#: ../../c-api/frame.rst:29
msgid ""
"Previously, this type was only available after including ``<frameobject.h>``."
msgstr ""

#: ../../c-api/frame.rst:34
msgid ""
"Create a new frame object. This function returns a :term:`strong reference` "
"to the new frame object on success, and returns ``NULL`` with an exception "
"set on failure."
msgstr ""

#: ../../c-api/frame.rst:40
msgid "Return non-zero if *obj* is a frame object."
msgstr ""

#: ../../c-api/frame.rst:44
msgid ""
"Previously, this function was only available after including ``<frameobject."
"h>``."
msgstr ""

#: ../../c-api/frame.rst:49
msgid "Get the *frame* next outer frame."
msgstr ""

#: ../../c-api/frame.rst:51
msgid ""
"Return a :term:`strong reference`, or ``NULL`` if *frame* has no outer "
"frame. This raises no exceptions."
msgstr ""
"回傳一個 :term:`strong reference`，如果 *frame* 沒有外層 frame 則回傳 "
"``NULL``。此函式不會引發例外。"

#: ../../c-api/frame.rst:60
msgid "Get the *frame*'s :attr:`~frame.f_builtins` attribute."
msgstr "取得 *frame* 的 :attr:`~frame.f_builtins` 屬性。"

#: ../../c-api/frame.rst:62 ../../c-api/frame.rst:93
msgid "Return a :term:`strong reference`. The result cannot be ``NULL``."
msgstr "回傳 :term:`strong reference`。結果不能為 ``NULL``。"

#: ../../c-api/frame.rst:69
msgid "Get the *frame* code."
msgstr ""

#: ../../c-api/frame.rst:71 ../../c-api/frame.rst:137
msgid "Return a :term:`strong reference`."
msgstr "回傳 :term:`strong reference`。"

#: ../../c-api/frame.rst:73
msgid "The result (frame code) cannot be ``NULL``."
msgstr ""

#: ../../c-api/frame.rst:80
msgid ""
"Get the generator, coroutine, or async generator that owns this frame, or "
"``NULL`` if this frame is not owned by a generator. Does not raise an "
"exception, even if the return value is ``NULL``."
msgstr ""

#: ../../c-api/frame.rst:84
msgid "Return a :term:`strong reference`, or ``NULL``."
msgstr "回傳 :term:`strong reference` 或 ``NULL``。"

#: ../../c-api/frame.rst:91
msgid "Get the *frame*'s :attr:`~frame.f_globals` attribute."
msgstr "取得 *frame* 的 :attr:`~frame.f_globals` 屬性。"

#: ../../c-api/frame.rst:100
msgid "Get the *frame*'s :attr:`~frame.f_lasti` attribute."
msgstr "取得 *frame* 的 :attr:`~frame.f_lasti` 屬性。"

#: ../../c-api/frame.rst:102
msgid "Returns -1 if ``frame.f_lasti`` is ``None``."
msgstr "如果 ``frame.f_lasti`` 是 ``None`` 則回傳 -1。"

#: ../../c-api/frame.rst:109
msgid "Get the variable *name* of *frame*."
msgstr "取得 *frame* 的變數 *name*。"

#: ../../c-api/frame.rst:111
msgid "Return a :term:`strong reference` to the variable value on success."
msgstr "在成功時回傳變數值的 :term:`strong reference`。"

#: ../../c-api/frame.rst:112
msgid ""
"Raise :exc:`NameError` and return ``NULL`` if the variable does not exist."
msgstr "如果變數不存在，則引發 :exc:`NameError` 並回傳 ``NULL``。"

#: ../../c-api/frame.rst:113
msgid "Raise an exception and return ``NULL`` on error."
msgstr "在錯誤時引發例外並回傳 ``NULL``。"

#: ../../c-api/frame.rst:115
msgid "*name* type must be a :class:`str`."
msgstr "*name* 的型別必須是 :class:`str`。"

#: ../../c-api/frame.rst:122
msgid ""
"Similar to :c:func:`PyFrame_GetVar`, but the variable name is a C string "
"encoded in UTF-8."
msgstr ""

#: ../../c-api/frame.rst:130
msgid ""
"Get the *frame*'s :attr:`~frame.f_locals` attribute. If the frame refers to "
"an :term:`optimized scope`, this returns a write-through proxy object that "
"allows modifying the locals. In all other cases (classes, modules, :func:"
"`exec`, :func:`eval`) it returns the mapping representing the frame locals "
"directly (as described for :func:`locals`)."
msgstr ""

#: ../../c-api/frame.rst:141
msgid ""
"As part of :pep:`667`, return an instance of :c:var:"
"`PyFrameLocalsProxy_Type`."
msgstr ""

#: ../../c-api/frame.rst:147
msgid "Return the line number that *frame* is currently executing."
msgstr ""

#: ../../c-api/frame.rst:151
msgid "Frame Locals Proxies"
msgstr ""

#: ../../c-api/frame.rst:155
msgid ""
"The :attr:`~frame.f_locals` attribute on a :ref:`frame object <frame-"
"objects>` is an instance of a \"frame-locals proxy\". The proxy object "
"exposes a write-through view of the underlying locals dictionary for the "
"frame. This ensures that the variables exposed by ``f_locals`` are always up "
"to date with the live local variables in the frame itself."
msgstr ""

#: ../../c-api/frame.rst:161
msgid "See :pep:`667` for more information."
msgstr "更多資訊請參閱 :pep:`667`。"

#: ../../c-api/frame.rst:165
msgid "The type of frame :func:`locals` proxy objects."
msgstr ""

#: ../../c-api/frame.rst:169
msgid "Return non-zero if *obj* is a frame :func:`locals` proxy."
msgstr ""

#: ../../c-api/frame.rst:173
msgid "Legacy Local Variable APIs"
msgstr ""

#: ../../c-api/frame.rst:175
msgid ""
"These APIs are :term:`soft deprecated`. As of Python 3.13, they do nothing. "
"They exist solely for backwards compatibility."
msgstr ""

#: ../../c-api/frame.rst:181 ../../c-api/frame.rst:195
#: ../../c-api/frame.rst:208
msgid "This function is :term:`soft deprecated` and does nothing."
msgstr ""

#: ../../c-api/frame.rst:183
msgid ""
"Prior to Python 3.13, this function would copy the :attr:`~frame.f_locals` "
"attribute of *f* to the internal \"fast\" array of local variables, allowing "
"changes in frame objects to be visible to the interpreter. If *clear* was "
"true, this function would process variables that were unset in the locals "
"dictionary."
msgstr ""

#: ../../c-api/frame.rst:189 ../../c-api/frame.rst:202
#: ../../c-api/frame.rst:214
msgid "This function now does nothing."
msgstr ""

#: ../../c-api/frame.rst:197
msgid ""
"Prior to Python 3.13, this function would copy the internal \"fast\" array "
"of local variables (which is used by the interpreter) to the :attr:`~frame."
"f_locals` attribute of *f*, allowing changes in local variables to be "
"visible to frame objects."
msgstr ""

#: ../../c-api/frame.rst:210
msgid ""
"Prior to Python 3.13, this function was similar to :c:func:"
"`PyFrame_FastToLocals`, but would return ``0`` on success, and ``-1`` with "
"an exception set on failure."
msgstr ""

#: ../../c-api/frame.rst:219
msgid ":pep:`667`"
msgstr ":pep:`667`"

#: ../../c-api/frame.rst:223
msgid "Internal Frames"
msgstr ""

#: ../../c-api/frame.rst:225
msgid "Unless using :pep:`523`, you will not need this."
msgstr ""

#: ../../c-api/frame.rst:229
msgid "The interpreter's internal frame representation."
msgstr ""

#: ../../c-api/frame.rst:235
msgid "Return a :term:`strong reference` to the code object for the frame."
msgstr ""

#: ../../c-api/frame.rst:242
msgid "Return the byte offset into the last executed instruction."
msgstr ""

#: ../../c-api/frame.rst:249
msgid ""
"Return the currently executing line number, or -1 if there is no line number."
msgstr ""