# 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-03-25 00:20+0000\n"

"PO-Revision-Date: 2018-05-23 14:38+0000\n"

"Last-Translator: Adrian Liaw <[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"

#: ../../library/ast.rst:2

msgid ":mod:`!ast` --- Abstract syntax trees"

msgstr ":mod:`!ast` --- 抽象語法樹 (Abstract Syntax Trees)"

#: ../../library/ast.rst:14

msgid "**Source code:** :source:`Lib/ast.py`"

msgstr "**原始碼：**\\ :source:`Lib/ast.py`"

#: ../../library/ast.rst:18

msgid ""

"The :mod:`!ast` module helps Python applications to process trees of the "

"Python abstract syntax grammar. The abstract syntax itself might change "

"with each Python release; this module helps to find out programmatically "

"what the current grammar looks like."

msgstr ""

":mod:`!ast` 模組可以幫助 Python 應用程式處理 Python 抽象語法文法 (abstract "

"syntax grammar) 樹狀資料結構。抽象語法本身可能會隨著每個 Python 版本發布而改"

"變；此模組有助於以程式化的方式來得知目前文法的面貌。"

#: ../../library/ast.rst:23

msgid ""

"An abstract syntax tree can be generated by passing :data:`ast."

"PyCF_ONLY_AST` as a flag to the :func:`compile` built-in function, or using "

"the :func:`parse` helper provided in this module. The result will be a tree "

"of objects whose classes all inherit from :class:`ast.AST`. An abstract "

"syntax tree can be compiled into a Python code object using the built-in :"

"func:`compile` function."

msgstr ""

"要生成抽象語法樹，可以透過將 :data:`ast.PyCF_ONLY_AST` 作為旗標傳遞給內建函"

"式 :func:`compile` 或使用此模組所提供的 :func:`parse` 輔助函式。結果將會是一"

"個物件的樹，其類別都繼承自 :class:`ast.AST`。可以使用內建的 :func:`compile` "

"函式將抽象語法樹編譯成 Python 程式碼物件。"

#: ../../library/ast.rst:33

msgid "Abstract grammar"

msgstr "抽象文法 (Abstract Grammar)"

#: ../../library/ast.rst:35

msgid "The abstract grammar is currently defined as follows:"

msgstr "抽象文法目前定義如下："

#: ../../library/ast.rst:37

msgid ""

"-- ASDL's 4 builtin types are:\n"

"-- identifier, int, string, constant\n"

"\n"

"module Python\n"

"{\n"

" mod = Module(stmt* body, type_ignore* type_ignores)\n"

" | Interactive(stmt* body)\n"

" | Expression(expr body)\n"

" | FunctionType(expr* argtypes, expr returns)\n"

"\n"

" stmt = FunctionDef(identifier name, arguments args,\n"

" stmt* body, expr* decorator_list, expr? returns,\n"

" string? type_comment, type_param* type_params)\n"

" | AsyncFunctionDef(identifier name, arguments args,\n"

" stmt* body, expr* decorator_list, expr? "

"returns,\n"

" string? type_comment, type_param* type_params)\n"

"\n"

" | ClassDef(identifier name,\n"

" expr* bases,\n"

" keyword* keywords,\n"

" stmt* body,\n"

" expr* decorator_list,\n"

" type_param* type_params)\n"

" | Return(expr? value)\n"

"\n"

" | Delete(expr* targets)\n"

" | Assign(expr* targets, expr value, string? type_comment)\n"

" | TypeAlias(expr name, type_param* type_params, expr value)\n"

" | AugAssign(expr target, operator op, expr value)\n"

" -- 'simple' indicates that we annotate simple name without parens\n"

" | AnnAssign(expr target, expr annotation, expr? value, int "

"simple)\n"

"\n"

" -- use 'orelse' because else is a keyword in target languages\n"

" | For(expr target, expr iter, stmt* body, stmt* orelse, string? "

"type_comment)\n"

" | AsyncFor(expr target, expr iter, stmt* body, stmt* orelse, "

"string? type_comment)\n"

" | While(expr test, stmt* body, stmt* orelse)\n"

" | If(expr test, stmt* body, stmt* orelse)\n"

" | With(withitem* items, stmt* body, string? type_comment)\n"

" | AsyncWith(withitem* items, stmt* body, string? type_comment)\n"

"\n"

" | Match(expr subject, match_case* cases)\n"

"\n"

" | Raise(expr? exc, expr? cause)\n"

" | Try(stmt* body, excepthandler* handlers, stmt* orelse, stmt* "

"finalbody)\n"

" | TryStar(stmt* body, excepthandler* handlers, stmt* orelse, stmt* "

"finalbody)\n"

" | Assert(expr test, expr? msg)\n"

"\n"

" | Import(alias* names)\n"

" | ImportFrom(identifier? module, alias* names, int? level)\n"

"\n"

" | Global(identifier* names)\n"

" | Nonlocal(identifier* names)\n"

" | Expr(expr value)\n"

" | Pass | Break | Continue\n"

"\n"

" -- col_offset is the byte offset in the utf8 string the parser "

"uses\n"

" attributes (int lineno, int col_offset, int? end_lineno, int? "

"end_col_offset)\n"

"\n"

" -- BoolOp() can use left & right?\n"

" expr = BoolOp(boolop op, expr* values)\n"

" | NamedExpr(expr target, expr value)\n"

" | BinOp(expr left, operator op, expr right)\n"

" | UnaryOp(unaryop op, expr operand)\n"

" | Lambda(arguments args, expr body)\n"

" | IfExp(expr test, expr body, expr orelse)\n"

" | Dict(expr?* keys, expr* values)\n"

" | Set(expr* elts)\n"

" | ListComp(expr elt, comprehension* generators)\n"

" | SetComp(expr elt, comprehension* generators)\n"

" | DictComp(expr key, expr value, comprehension* generators)\n"

" | GeneratorExp(expr elt, comprehension* generators)\n"

" -- the grammar constrains where yield expressions can occur\n"

" | Await(expr value)\n"

" | Yield(expr? value)\n"

" | YieldFrom(expr value)\n"

" -- need sequences for compare to distinguish between\n"

" -- x < 4 < 3 and (x < 4) < 3\n"

" | Compare(expr left, cmpop* ops, expr* comparators)\n"

" | Call(expr func, expr* args, keyword* keywords)\n"

" | FormattedValue(expr value, int conversion, expr? format_spec)\n"

" | Interpolation(expr value, constant str, int conversion, expr? "

"format_spec)\n"

" | JoinedStr(expr* values)\n"

" | TemplateStr(expr* values)\n"

" | Constant(constant value, string? kind)\n"

"\n"

" -- the following expression can appear in assignment context\n"

" | Attribute(expr value, identifier attr, expr_context ctx)\n"

" | Subscript(expr value, expr slice, expr_context ctx)\n"

" | Starred(expr value, expr_context ctx)\n"

" | Name(identifier id, expr_context ctx)\n"

" | List(expr* elts, expr_context ctx)\n"

" | Tuple(expr* elts, expr_context ctx)\n"

"\n"

" -- can appear only in Subscript\n"

" | Slice(expr? lower, expr? upper, expr? step)\n"

"\n"

" -- col_offset is the byte offset in the utf8 string the parser "

"uses\n"

" attributes (int lineno, int col_offset, int? end_lineno, int? "

"end_col_offset)\n"

"\n"

" expr_context = Load | Store | Del\n"

"\n"

" boolop = And | Or\n"

"\n"

" operator = Add | Sub | Mult | MatMult | Div | Mod | Pow | LShift\n"

" | RShift | BitOr | BitXor | BitAnd | FloorDiv\n"

"\n"

" unaryop = Invert | Not | UAdd | USub\n"

"\n"

" cmpop = Eq | NotEq | Lt | LtE | Gt | GtE | Is | IsNot | In | NotIn\n"

"\n"

" comprehension = (expr target, expr iter, expr* ifs, int is_async)\n"

"\n"

" excepthandler = ExceptHandler(expr? type, identifier? name, stmt* body)\n"

" attributes (int lineno, int col_offset, int? end_lineno, "

"int? end_col_offset)\n"

"\n"

" arguments = (arg* posonlyargs, arg* args, arg? vararg, arg* kwonlyargs,\n"

" expr?* kw_defaults, arg? kwarg, expr* defaults)\n"

"\n"

" arg = (identifier arg, expr? annotation, string? type_comment)\n"

" attributes (int lineno, int col_offset, int? end_lineno, int? "

"end_col_offset)\n"

"\n"

" -- keyword arguments supplied to call (NULL identifier for **kwargs)\n"

" keyword = (identifier? arg, expr value)\n"

" attributes (int lineno, int col_offset, int? end_lineno, int? "

"end_col_offset)\n"

"\n"

" -- import name with optional 'as' alias.\n"

" alias = (identifier name, identifier? asname)\n"

" attributes (int lineno, int col_offset, int? end_lineno, int? "

"end_col_offset)\n"

"\n"

" withitem = (expr context_expr, expr? optional_vars)\n"

"\n"

" match_case = (pattern pattern, expr? guard, stmt* body)\n"

"\n"

" pattern = MatchValue(expr value)\n"

" | MatchSingleton(constant value)\n"

" | MatchSequence(pattern* patterns)\n"

" | MatchMapping(expr* keys, pattern* patterns, identifier? rest)\n"

" | MatchClass(expr cls, pattern* patterns, identifier* kwd_attrs, "

"pattern* kwd_patterns)\n"

"\n"

" | MatchStar(identifier? name)\n"

" -- The optional \"rest\" MatchMapping parameter handles "

"capturing extra mapping keys\n"

"\n"

" | MatchAs(pattern? pattern, identifier? name)\n"

" | MatchOr(pattern* patterns)\n"

"\n"

" attributes (int lineno, int col_offset, int end_lineno, int "

"end_col_offset)\n"

"\n"

" type_ignore = TypeIgnore(int lineno, string tag)\n"

"\n"

" type_param = TypeVar(identifier name, expr? bound, expr? default_value)\n"

" | ParamSpec(identifier name, expr? default_value)\n"

" | TypeVarTuple(identifier name, expr? default_value)\n"

" attributes (int lineno, int col_offset, int end_lineno, int "

"end_col_offset)\n"

"}\n"

msgstr ""

"-- ASDL's 4 builtin types are:\n"

"-- identifier, int, string, constant\n"

"\n"

"module Python\n"

"{\n"

" mod = Module(stmt* body, type_ignore* type_ignores)\n"

" | Interactive(stmt* body)\n"

" | Expression(expr body)\n"

" | FunctionType(expr* argtypes, expr returns)\n"

"\n"

" stmt = FunctionDef(identifier name, arguments args,\n"

" stmt* body, expr* decorator_list, expr? returns,\n"

" string? type_comment, type_param* type_params)\n"

" | AsyncFunctionDef(identifier name, arguments args,\n"

" stmt* body, expr* decorator_list, expr? "

"returns,\n"

" string? type_comment, type_param* type_params)\n"

"\n"

" | ClassDef(identifier name,\n"

" expr* bases,\n"

" keyword* keywords,\n"

" stmt* body,\n"

" expr* decorator_list,\n"

" type_param* type_params)\n"

" | Return(expr? value)\n"

"\n"

" | Delete(expr* targets)\n"

" | Assign(expr* targets, expr value, string? type_comment)\n"

" | TypeAlias(expr name, type_param* type_params, expr value)\n"

" | AugAssign(expr target, operator op, expr value)\n"

" -- 'simple' indicates that we annotate simple name without parens\n"

" | AnnAssign(expr target, expr annotation, expr? value, int "

"simple)\n"

"\n"

" -- use 'orelse' because else is a keyword in target languages\n"

" | For(expr target, expr iter, stmt* body, stmt* orelse, string? "

"type_comment)\n"

" | AsyncFor(expr target, expr iter, stmt* body, stmt* orelse, "

"string? type_comment)\n"

" | While(expr test, stmt* body, stmt* orelse)\n"

" | If(expr test, stmt* body, stmt* orelse)\n"

" | With(withitem* items, stmt* body, string? type_comment)\n"

" | AsyncWith(withitem* items, stmt* body, string? type_comment)\n"

"\n"

" | Match(expr subject, match_case* cases)\n"

"\n"

" | Raise(expr? exc, expr? cause)\n"

" | Try(stmt* body, excepthandler* handlers, stmt* orelse, stmt* "

"finalbody)\n"

" | TryStar(stmt* body, excepthandler* handlers, stmt* orelse, stmt* "

"finalbody)\n"

" | Assert(expr test, expr? msg)\n"

"\n"

" | Import(alias* names)\n"

" | ImportFrom(identifier? module, alias* names, int? level)\n"

"\n"

" | Global(identifier* names)\n"

" | Nonlocal(identifier* names)\n"

" | Expr(expr value)\n"

" | Pass | Break | Continue\n"

"\n"

" -- col_offset is the byte offset in the utf8 string the parser "

"uses\n"

" attributes (int lineno, int col_offset, int? end_lineno, int? "

"end_col_offset)\n"

"\n"

" -- BoolOp() can use left & right?\n"

" expr = BoolOp(boolop op, expr* values)\n"

" | NamedExpr(expr target, expr value)\n"

" | BinOp(expr left, operator op, expr right)\n"

" | UnaryOp(unaryop op, expr operand)\n"

" | Lambda(arguments args, expr body)\n"

" | IfExp(expr test, expr body, expr orelse)\n"

" | Dict(expr?* keys, expr* values)\n"

" | Set(expr* elts)\n"

" | ListComp(expr elt, comprehension* generators)\n"

" | SetComp(expr elt, comprehension* generators)\n"

" | DictComp(expr key, expr value, comprehension* generators)\n"

" | GeneratorExp(expr elt, comprehension* generators)\n"

" -- the grammar constrains where yield expressions can occur\n"

" | Await(expr value)\n"

" | Yield(expr? value)\n"

" | YieldFrom(expr value)\n"

" -- need sequences for compare to distinguish between\n"

" -- x < 4 < 3 and (x < 4) < 3\n"

" | Compare(expr left, cmpop* ops, expr* comparators)\n"

" | Call(expr func, expr* args, keyword* keywords)\n"

" | FormattedValue(expr value, int conversion, expr? format_spec)\n"

" | Interpolation(expr value, constant str, int conversion, expr? "

"format_spec)\n"

" | JoinedStr(expr* values)\n"

" | TemplateStr(expr* values)\n"

" | Constant(constant value, string? kind)\n"

"\n"

" -- the following expression can appear in assignment context\n"

" | Attribute(expr value, identifier attr, expr_context ctx)\n"

" | Subscript(expr value, expr slice, expr_context ctx)\n"

" | Starred(expr value, expr_context ctx)\n"

" | Name(identifier id, expr_context ctx)\n"

" | List(expr* elts, expr_context ctx)\n"

" | Tuple(expr* elts, expr_context ctx)\n"

"\n"

" -- can appear only in Subscript\n"

" | Slice(expr? lower, expr? upper, expr? step)\n"

"\n"

" -- col_offset is the byte offset in the utf8 string the parser "

"uses\n"

" attributes (int lineno, int col_offset, int? end_lineno, int? "

"end_col_offset)\n"

"\n"

" expr_context = Load | Store | Del\n"

"\n"

" boolop = And | Or\n"

"\n"

" operator = Add | Sub | Mult | MatMult | Div | Mod | Pow | LShift\n"

" | RShift | BitOr | BitXor | BitAnd | FloorDiv\n"

"\n"

" unaryop = Invert | Not | UAdd | USub\n"

"\n"

" cmpop = Eq | NotEq | Lt | LtE | Gt | GtE | Is | IsNot | In | NotIn\n"

"\n"

" comprehension = (expr target, expr iter, expr* ifs, int is_async)\n"

"\n"

" excepthandler = ExceptHandler(expr? type, identifier? name, stmt* body)\n"

" attributes (int lineno, int col_offset, int? end_lineno, "

"int? end_col_offset)\n"

"\n"

" arguments = (arg* posonlyargs, arg* args, arg? vararg, arg* kwonlyargs,\n"

" expr?* kw_defaults, arg? kwarg, expr* defaults)\n"

"\n"

" arg = (identifier arg, expr? annotation, string? type_comment)\n"

" attributes (int lineno, int col_offset, int? end_lineno, int? "

"end_col_offset)\n"

"\n"

" -- keyword arguments supplied to call (NULL identifier for **kwargs)\n"

" keyword = (identifier? arg, expr value)\n"

" attributes (int lineno, int col_offset, int? end_lineno, int? "

"end_col_offset)\n"

"\n"

" -- import name with optional 'as' alias.\n"

" alias = (identifier name, identifier? asname)\n"

" attributes (int lineno, int col_offset, int? end_lineno, int? "

"end_col_offset)\n"

"\n"

" withitem = (expr context_expr, expr? optional_vars)\n"

"\n"

" match_case = (pattern pattern, expr? guard, stmt* body)\n"

"\n"

" pattern = MatchValue(expr value)\n"

" | MatchSingleton(constant value)\n"

" | MatchSequence(pattern* patterns)\n"

" | MatchMapping(expr* keys, pattern* patterns, identifier? rest)\n"

" | MatchClass(expr cls, pattern* patterns, identifier* kwd_attrs, "

"pattern* kwd_patterns)\n"

"\n"

" | MatchStar(identifier? name)\n"

" -- The optional \"rest\" MatchMapping parameter handles "

"capturing extra mapping keys\n"

"\n"

" | MatchAs(pattern? pattern, identifier? name)\n"

" | MatchOr(pattern* patterns)\n"

"\n"

" attributes (int lineno, int col_offset, int end_lineno, int "

"end_col_offset)\n"

"\n"

" type_ignore = TypeIgnore(int lineno, string tag)\n"

"\n"

" type_param = TypeVar(identifier name, expr? bound, expr? default_value)\n"

" | ParamSpec(identifier name, expr? default_value)\n"

" | TypeVarTuple(identifier name, expr? default_value)\n"

" attributes (int lineno, int col_offset, int end_lineno, int "

"end_col_offset)\n"

"}\n"

#: ../../library/ast.rst:42

msgid "Node classes"

msgstr "節點 (Node) 類別"

#: ../../library/ast.rst:46

msgid ""

"This is the base of all AST node classes. The actual node classes are "

"derived from the :file:`Parser/Python.asdl` file, which is reproduced :ref:"

"`above <abstract-grammar>`. They are defined in the :mod:`!_ast` C module "

"and re-exported in :mod:`!ast`."

msgstr ""

"這是所有 AST 節點類別的基礎。實際的節點類別是衍生自 :file:`Parser/Python."

"asdl` 檔案，該檔案在\\ :ref:`上方 <abstract-grammar>` 重現。它們被定義於 :"

"mod:`!_ast` 的 C 模組中，並於 :mod:`!ast` 中重新匯出。"

#: ../../library/ast.rst:51

msgid ""

"There is one class defined for each left-hand side symbol in the abstract "

"grammar (for example, :class:`ast.stmt` or :class:`ast.expr`). In addition, "

"there is one class defined for each constructor on the right-hand side; "

"these classes inherit from the classes for the left-hand side trees. For "

"example, :class:`ast.BinOp` inherits from :class:`ast.expr`. For production "

"rules with alternatives (aka \"sums\"), the left-hand side class is "

"abstract: only instances of specific constructor nodes are ever created."

msgstr ""

"抽象文法中為每個左側符號定義了一個類別（例如 :class:`ast.stmt` 或 :class:"

"`ast.expr`）。此外，也為每個右側的建構函式 (constructor) 定義了一個類別；這些"

"類別繼承自左側樹的類別。例如，:class:`ast.BinOp` 繼承自 :class:`ast.expr`。對"

"於具有替代方案（即為「和 (sums)」）的生產規則，左側類別是抽象的：僅有特定建構"

"函式節點的實例會被建立。"

#: ../../library/ast.rst:64

msgid ""

"Each concrete class has an attribute :attr:`!_fields` which gives the names "

"of all child nodes."

msgstr "每個具體類別都有一個屬性 :attr:`!_fields`，它會給出所有子節點的名稱。"

#: ../../library/ast.rst:67

msgid ""

"Each instance of a concrete class has one attribute for each child node, of "

"the type as defined in the grammar. For example, :class:`ast.BinOp` "

"instances have an attribute :attr:`left` of type :class:`ast.expr`."

msgstr ""

"具體類別的每個實例對於每個子節點都有一個屬性，其型別如文法中所定義。例如，:"

"class:`ast.BinOp` 實例具有型別為 :class:`ast.expr` 的屬性 :attr:`left`。"

#: ../../library/ast.rst:71

msgid ""

"If these attributes are marked as optional in the grammar (using a question "

"mark), the value might be ``None``. If the attributes can have zero-or-more "

"values (marked with an asterisk), the values are represented as Python "

"lists. All possible attributes must be present and have valid values when "

"compiling an AST with :func:`compile`."

msgstr ""

"如果這些屬性在文法中被標記為可選（使用問號），則該值可能為 ``None``。如果屬性"

"可以有零個或多個值（用星號標記），則這些值將表示為 Python 串列。使用 :func:"

"`compile` 編譯 AST 時，所有可能的屬性都必須存在並且具有有效值。"

#: ../../library/ast.rst:79

msgid ""

"The :attr:`!_field_types` attribute on each concrete class is a dictionary "

"mapping field names (as also listed in :attr:`_fields`) to their types."

msgstr ""

"每個具體類別上的 :attr:`!_field_types` 屬性是將欄位名稱（也在 :attr:"

"`_fields` 中列出）對映到其型別的字典。"

#: ../../library/ast.rst:82

msgid ""

">>> ast.TypeVar._field_types\n"

"{'name': <class 'str'>, 'bound': ast.expr | None, 'default_value': ast.expr "

"| None}"

msgstr ""

">>> ast.TypeVar._field_types\n"

"{'name': <class 'str'>, 'bound': ast.expr | None, 'default_value': ast.expr "

"| None}"

#: ../../library/ast.rst:94

msgid ""

"Instances of :class:`ast.expr` and :class:`ast.stmt` subclasses have :attr:"

"`lineno`, :attr:`col_offset`, :attr:`end_lineno`, and :attr:`end_col_offset` "

"attributes. The :attr:`lineno` and :attr:`end_lineno` are the first and "

"last line numbers of source text span (1-indexed so the first line is line "

"1) and the :attr:`col_offset` and :attr:`end_col_offset` are the "

"corresponding UTF-8 byte offsets of the first and last tokens that generated "

"the node. The UTF-8 offset is recorded because the parser uses UTF-8 "

"internally."

msgstr ""

":class:`ast.expr` 和 :class:`ast.stmt` 子類別的實例具有 :attr:`lineno`、:"

"attr:`col_offset`、:attr:`end_lineno` 和 :attr:`end_col_offset` 屬性。:attr:"

"`lineno` 和 :attr:`end_lineno` 是原始文本跨度 (source text span) 的第一個和最"

"後一個列號（1-indexed，因此第一列號是 1）以及 :attr:`col_offset` 和 :attr:"

"`end_col_offset` 是生成節點的第一個和最後一個標記對應的 UTF-8 位元組偏移量。"

"會記錄 UTF-8 偏移量是因為剖析器 (parser) 內部使用 UTF-8。"

#: ../../library/ast.rst:103

msgid ""

"Note that the end positions are not required by the compiler and are "

"therefore optional. The end offset is *after* the last symbol, for example "

"one can get the source segment of a one-line expression node using "

"``source_line[node.col_offset : node.end_col_offset]``."

msgstr ""

"請注意，編譯器並不需要結束位置，因此其為可選的。結束偏移量在最後一個符號\\ *"

"之後*，例如可以使用 ``source_line[node.col_offset : node.end_col_offset]`` 來"

"取得單列運算式節點 (expression node) 的原始片段。"

#: ../../library/ast.rst:108

msgid ""

"The constructor of a class :class:`ast.T` parses its arguments as follows:"

msgstr ":class:`ast.T` 類別的建構函式按以下方式剖析其引數："

#: ../../library/ast.rst:110

msgid ""

"If there are positional arguments, there must be as many as there are items "

"in :attr:`T._fields`; they will be assigned as attributes of these names."

msgstr ""

"如果有位置引數，則必須與 :attr:`T._fields` 中的項目一樣多；它們將被賦値為這些"

"名稱的屬性。"

#: ../../library/ast.rst:112

msgid ""

"If there are keyword arguments, they will set the attributes of the same "

"names to the given values."

msgstr "如果有關鍵字引數，它們會將相同名稱的屬性設定為給定值。"

#: ../../library/ast.rst:115

msgid ""

"For example, to create and populate an :class:`ast.UnaryOp` node, you could "

"use ::"

msgstr ""

"例如，要建立並填充 (populate) :class:`ast.UnaryOp` 節點，你可以使用： ::"

#: ../../library/ast.rst:118

msgid ""

"node = ast.UnaryOp(ast.USub(), ast.Constant(5, lineno=0, col_offset=0),\n"

" lineno=0, col_offset=0)"

msgstr ""

"node = ast.UnaryOp(ast.USub(), ast.Constant(5, lineno=0, col_offset=0),\n"

" lineno=0, col_offset=0)"

#: ../../library/ast.rst:121

msgid ""

"If a field that is optional in the grammar is omitted from the constructor, "

"it defaults to ``None``. If a list field is omitted, it defaults to the "

"empty list. If a field of type :class:`!ast.expr_context` is omitted, it "

"defaults to :class:`Load() <ast.Load>`. If any other field is omitted, a :"

"exc:`DeprecationWarning` is raised and the AST node will not have this "

"field. In Python 3.15, this condition will raise an error."

msgstr ""

"如果建構函式中省略了文法中可選的欄位，則它預設為 ``None``。如果省略串列欄位，"

"則預設為空串列。如果省略 :class:`!ast.expr_context` 型別的欄位，則預設為 :"

"class:`Load() <ast.Load>`。如果省略任何其他欄位，則會引發 :exc:"

"`DeprecationWarning`，且 AST 節點將沒有此欄位。在 Python 3.15 中，這種情況會"

"引發錯誤。"

#: ../../library/ast.rst:130

msgid "Class :class:`ast.Constant` is now used for all constants."

msgstr ":class:`ast.Constant` 類別現在用於所有常數。"

#: ../../library/ast.rst:134

msgid ""

"Simple indices are represented by their value, extended slices are "

"represented as tuples."

msgstr "以它們的值表示簡單索引，擴充切片 (slice) 則以元組 (tuple) 表示。"

#: ../../library/ast.rst:139

msgid ""

"AST node constructors were changed to provide sensible defaults for omitted "

"fields: optional fields now default to ``None``, list fields default to an "

"empty list, and fields of type :class:`!ast.expr_context` default to :class:"

"`Load() <ast.Load>`. Previously, omitted attributes would not exist on "

"constructed nodes (accessing them raised :exc:`AttributeError`)."

msgstr ""

#: ../../library/ast.rst:147

msgid ""

"The :meth:`~object.__repr__` output of :class:`~ast.AST` nodes includes the "

"values of the node fields."

msgstr ""

":class:`~ast.AST` 節點的 :meth:`~object.__repr__` 輸出包含節點欄位的值。"

#: ../../library/ast.rst:152

msgid ""

"Previous versions of Python provided the AST classes :class:`!ast.Num`, :"

"class:`!ast.Str`, :class:`!ast.Bytes`, :class:`!ast.NameConstant` and :class:"

"`!ast.Ellipsis`, which were deprecated in Python 3.8. These classes were "

"removed in Python 3.14, and their functionality has been replaced with :"

"class:`ast.Constant`."

msgstr ""

"過去的 Python 版本提供了 AST 類別 :class:`!ast.Num`、:class:`!ast.Str`、:"

"class:`!ast.Bytes`、:class:`!ast.NameConstant` 和 :class:`!ast.Ellipsis`，這"

"些類別在 Python 3.8 中已被棄用。這些類別在 Python 3.14 中被移除，其功能已被 :"

"class:`ast.Constant` 取代。"

#: ../../library/ast.rst:160

msgid ""

"Old classes :class:`!ast.Index` and :class:`!ast.ExtSlice` are still "

"available, but they will be removed in future Python releases. In the "

"meantime, instantiating them will return an instance of a different class."

msgstr ""

"舊的類別 :class:`!ast.Index` 和 :class:`!ast.ExtSlice` 仍然可用，但它們將在未"

"來的 Python 版本中刪除。同時，實例化它們會回傳不同類別的實例。"

#: ../../library/ast.rst:167

msgid ""

"Previous versions of Python allowed the creation of AST nodes that were "

"missing required fields. Similarly, AST node constructors allowed arbitrary "

"keyword arguments that were set as attributes of the AST node, even if they "

"did not match any of the fields of the AST node. This behavior is deprecated "

"and will be removed in Python 3.15."

msgstr ""

"先前版本的 Python 允許建立缺少必填欄位的 AST 節點。同樣地，AST 節點建構函式允"

"許將任意關鍵字引數設為 AST 節點的屬性，即使它們與 AST 節點的任何欄位都不匹"

"配。此行為已被棄用，並將在 Python 3.15 中刪除。"

#: ../../library/ast.rst:174

msgid ""

"The descriptions of the specific node classes displayed here were initially "

"adapted from the fantastic `Green Tree Snakes <https://greentreesnakes."

"readthedocs.io/en/latest/>`__ project and all its contributors."

msgstr ""

"這裡顯示的特定節點類別的描述最初是從出色的 `Green Tree Snakes <https://"

"greentreesnakes.readthedocs.io/en/latest/>`__ 專案和所有貢獻者那裡改編而來"

"的。"

#: ../../library/ast.rst:183

msgid "Root nodes"

msgstr "根節點"

#: ../../library/ast.rst:187

msgid ""

"A Python module, as with :ref:`file input <file-input>`. Node type generated "

"by :func:`ast.parse` in the default ``\"exec\"`` *mode*."

msgstr ""

"一個 Python 模組，與\\ :ref:`檔案輸入 <file-input>` 一樣。由 :func:`ast."

"parse` 在預設的 ``\"exec\"`` *mode* 下生成的節點型別。"

#: ../../library/ast.rst:190

msgid "``body`` is a :class:`list` of the module's :ref:`ast-statements`."

msgstr "``body`` 是模組的\\ :ref:`ast-statements` 的一個 :class:`list`。"

#: ../../library/ast.rst:192

msgid ""

"``type_ignores`` is a :class:`list` of the module's type ignore comments; "

"see :func:`ast.parse` for more details."

msgstr ""

"``type_ignores`` 是模組的忽略型別註解的 :class:`list`；有關更多詳細資訊，請參"

"閱 :func:`ast.parse`。"

#: ../../library/ast.rst:195

msgid ""

">>> print(ast.dump(ast.parse('x = 1'), indent=4))\n"

"Module(\n"

" body=[\n"

" Assign(\n"

" targets=[\n"

" Name(id='x', ctx=Store())],\n"

" value=Constant(value=1))])"

msgstr ""

">>> print(ast.dump(ast.parse('x = 1'), indent=4))\n"

"Module(\n"

" body=[\n"

" Assign(\n"

" targets=[\n"

" Name(id='x', ctx=Store())],\n"

" value=Constant(value=1))])"

#: ../../library/ast.rst:208

msgid ""

"A single Python :ref:`expression input <expression-input>`. Node type "

"generated by :func:`ast.parse` when *mode* is ``\"eval\"``."

msgstr ""

"單個 Python :ref:`運算式輸入 <expression-input>`。當 *mode* 是 ``\"eval\"`` "

"時節點型別由 :func:`ast.parse` 生成。"

#: ../../library/ast.rst:211

msgid ""

"``body`` is a single node, one of the :ref:`expression types <ast-"

"expressions>`."

msgstr ""

"``body`` 是單個節點，是\\ :ref:`運算式型別 <ast-expressions>`\\ 的其中之一。"

#: ../../library/ast.rst:214 ../../library/ast.rst:284

msgid ""

">>> print(ast.dump(ast.parse('123', mode='eval'), indent=4))\n"

"Expression(\n"

" body=Constant(value=123))"

msgstr ""

">>> print(ast.dump(ast.parse('123', mode='eval'), indent=4))\n"

"Expression(\n"

" body=Constant(value=123))"

#: ../../library/ast.rst:223

msgid ""

"A single :ref:`interactive input <interactive>`, like in :ref:`tut-interac`. "

"Node type generated by :func:`ast.parse` when *mode* is ``\"single\"``."

msgstr ""

"單個\\ :ref:`互動式輸入 <interactive>`，和\\ :ref:`tut-interac`\\ 中所述的相"

"似。當 *mode* 是 ``\"single\"`` 時節點型別由 :func:`ast.parse` 生成。"

#: ../../library/ast.rst:226

msgid "``body`` is a :class:`list` of :ref:`statement nodes <ast-statements>`."

msgstr ""

"``body`` 是\\ :ref:`陳述式節點 (statement nodes) <ast-statements>` 的 :class:"

"`list`。"

#: ../../library/ast.rst:228

msgid ""

">>> print(ast.dump(ast.parse('x = 1; y = 2', mode='single'), indent=4))\n"

"Interactive(\n"

" body=[\n"

" Assign(\n"

" targets=[\n"

" Name(id='x', ctx=Store())],\n"

" value=Constant(value=1)),\n"

" Assign(\n"

" targets=[\n"

" Name(id='y', ctx=Store())],\n"

" value=Constant(value=2))])"

msgstr ""

">>> print(ast.dump(ast.parse('x = 1; y = 2', mode='single'), indent=4))\n"

"Interactive(\n"

" body=[\n"

" Assign(\n"

" targets=[\n"

" Name(id='x', ctx=Store())],\n"

" value=Constant(value=1)),\n"

" Assign(\n"

" targets=[\n"

" Name(id='y', ctx=Store())],\n"

" value=Constant(value=2))])"

#: ../../library/ast.rst:245

msgid ""

"A representation of an old-style type comments for functions, as Python "

"versions prior to 3.5 didn't support :pep:`484` annotations. Node type "

"generated by :func:`ast.parse` when *mode* is ``\"func_type\"``."

msgstr ""

"函式的舊式型別註解的表示法，因為 3.5 之前的 Python 版本不支援 :pep:`484` 註"

"釋。當 *mode* 是 ``\"func_type\"`` 時節點型別由 :func:`ast.parse` 生成。"

#: ../../library/ast.rst:249

msgid "Such type comments would look like this::"

msgstr "這種型別的註解看起來像這樣： ::"

#: ../../library/ast.rst:251

msgid ""

"def sum_two_number(a, b):\n"

" # type: (int, int) -> int\n"

" return a + b"

msgstr ""

"def sum_two_number(a, b):\n"

" # type: (int, int) -> int\n"

" return a + b"

#: ../../library/ast.rst:255

msgid ""

"``argtypes`` is a :class:`list` of :ref:`expression nodes <ast-expressions>`."

msgstr ""

"``argtypes`` 是\\ :ref:`運算式節點 <ast-expressions>`\\ 的 :class:`list`。"

#: ../../library/ast.rst:257

msgid "``returns`` is a single :ref:`expression node <ast-expressions>`."

msgstr "``returns`` 是單個\\ :ref:`運算式節點 <ast-expressions>`。"

#: ../../library/ast.rst:259

msgid ""

">>> print(ast.dump(ast.parse('(int, str) -> List[int]', mode='func_type'), "

"indent=4))\n"

"FunctionType(\n"

" argtypes=[\n"

" Name(id='int', ctx=Load()),\n"

" Name(id='str', ctx=Load())],\n"

" returns=Subscript(\n"

" value=Name(id='List', ctx=Load()),\n"

" slice=Name(id='int', ctx=Load()),\n"

" ctx=Load()))"

msgstr ""

">>> print(ast.dump(ast.parse('(int, str) -> List[int]', mode='func_type'), "

"indent=4))\n"

"FunctionType(\n"

" argtypes=[\n"

" Name(id='int', ctx=Load()),\n"

" Name(id='str', ctx=Load())],\n"

" returns=Subscript(\n"

" value=Name(id='List', ctx=Load()),\n"

" slice=Name(id='int', ctx=Load()),\n"

" ctx=Load()))"

#: ../../library/ast.rst:275

msgid "Literals"

msgstr "文本 (Literals)"

#: ../../library/ast.rst:279

msgid ""

"A constant value. The ``value`` attribute of the ``Constant`` literal "

"contains the Python object it represents. The values represented can be "

"instances of :class:`str`, :class:`bytes`, :class:`int`, :class:`float`, :"

"class:`complex`, and :class:`bool`, and the constants :data:`None` and :data:"

"`Ellipsis`."

msgstr ""

"一個常數值。``Constant`` 文本的 ``value`` 屬性包含它所代表的 Python 物件。表"

"示的值可以是 :class:`str`、:class:`bytes`、:class:`int`、:class:`float`、:"

"class:`complex` 和 :class:`bool` 的實例，以及常數 :data:`None` 和 :data:"

"`Ellipsis`。"

#: ../../library/ast.rst:293

msgid ""

"Node representing a single formatting field in an f-string. If the string "

"contains a single formatting field and nothing else the node can be isolated "

"otherwise it appears in :class:`JoinedStr`."

msgstr ""

"表示 f 字串 (f-string) 中的單個格式化欄位的節點。如果字串包含單個格式欄位並且"

"沒有其他內容，則可以隔離 (isolate) 該節點，否則它將出現在 :class:`JoinedStr` "

"中。"

#: ../../library/ast.rst:297

msgid ""

"``value`` is any expression node (such as a literal, a variable, or a "

"function call)."

msgstr "``value`` 為任何運算式節點（例如文字、變數或函式呼叫）。"

#: ../../library/ast.rst:299 ../../library/ast.rst:381

msgid "``conversion`` is an integer:"

msgstr "``conversion`` 是一個整數："

#: ../../library/ast.rst:301

msgid "-1: no formatting"

msgstr "-1: 無格式化"

#: ../../library/ast.rst:302

msgid "97 (``ord('a')``): ``!a`` :func:`ASCII <ascii>` formatting"

msgstr "97 (``ord('a')``)：``！a`` :func:`ASCII <ascii>` 格式化"

#: ../../library/ast.rst:303

msgid "114 (``ord('r')``): ``!r`` :func:`repr` formatting"

msgstr "114 (``ord('r')``)：``!r`` :func:`repr` 格式化"

#: ../../library/ast.rst:304

msgid "115 (``ord('s')``): ``!s`` :func:`string <str>` formatting"

msgstr "115 (``ord('s')``)：``!s`` :func:`string <str>` 格式化"

#: ../../library/ast.rst:306

msgid ""

"``format_spec`` is a :class:`JoinedStr` node representing the formatting of "

"the value, or ``None`` if no format was specified. Both ``conversion`` and "

"``format_spec`` can be set at the same time."

msgstr ""

"``format_spec`` 是一個 :class:`JoinedStr` 節點，表示值的格式，若未指定格式則"

"為 ``None``。``conversion`` 和 ``format_spec`` 可以同時設定。"

#: ../../library/ast.rst:313

msgid ""

"An f-string, comprising a series of :class:`FormattedValue` and :class:"

"`Constant` nodes."

msgstr ""

"一個 f 字串，包含一系列 :class:`FormattedValue` 和 :class:`Constant` 節點。"

#: ../../library/ast.rst:316

msgid ""

">>> print(ast.dump(ast.parse('f\"sin({a}) is {sin(a):.3}\"', mode='eval'), "

"indent=4))\n"

"Expression(\n"

" body=JoinedStr(\n"

" values=[\n"

" Constant(value='sin('),\n"

" FormattedValue(\n"

" value=Name(id='a', ctx=Load()),\n"

" conversion=-1),\n"

" Constant(value=') is '),\n"

" FormattedValue(\n"

" value=Call(\n"

" func=Name(id='sin', ctx=Load()),\n"

" args=[\n"

" Name(id='a', ctx=Load())]),\n"

" conversion=-1,\n"

" format_spec=JoinedStr(\n"

" values=[\n"

" Constant(value='.3')]))]))"

msgstr ""

">>> print(ast.dump(ast.parse('f\"sin({a}) is {sin(a):.3}\"', mode='eval'), "

"indent=4))\n"

"Expression(\n"

" body=JoinedStr(\n"

" values=[\n"

" Constant(value='sin('),\n"

" FormattedValue(\n"

" value=Name(id='a', ctx=Load()),\n"

" conversion=-1),\n"

" Constant(value=') is '),\n"

" FormattedValue(\n"

" value=Call(\n"

" func=Name(id='sin', ctx=Load()),\n"

" args=[\n"

" Name(id='a', ctx=Load())]),\n"

" conversion=-1,\n"

" format_spec=JoinedStr(\n"

" values=[\n"

" Constant(value='.3')]))]))"

#: ../../library/ast.rst:342

msgid ""

"Node representing a template string literal, comprising a series of :class:"

"`Interpolation` and :class:`Constant` nodes. These nodes may be any order, "

"and do not need to be interleaved."

msgstr ""

"表示模板字串字面值的節點，由一系列 :class:`Interpolation` 和 :class:"

"`Constant` 節點組成。這些節點可以是任意順序，不需要交錯排列。"

#: ../../library/ast.rst:346

msgid ""

">>> expr = ast.parse('t\"{name} finished {place:ordinal}\"', mode='eval')\n"

">>> print(ast.dump(expr, indent=4))\n"

"Expression(\n"

" body=TemplateStr(\n"

" values=[\n"

" Interpolation(\n"

" value=Name(id='name', ctx=Load()),\n"

" str='name',\n"

" conversion=-1),\n"

" Constant(value=' finished '),\n"

" Interpolation(\n"

" value=Name(id='place', ctx=Load()),\n"

" str='place',\n"

" conversion=-1,\n"

" format_spec=JoinedStr(\n"

" values=[\n"

" Constant(value='ordinal')]))]))"

msgstr ""

">>> expr = ast.parse('t\"{name} finished {place:ordinal}\"', mode='eval')\n"

">>> print(ast.dump(expr, indent=4))\n"

"Expression(\n"

" body=TemplateStr(\n"

" values=[\n"

" Interpolation(\n"

" value=Name(id='name', ctx=Load()),\n"

" str='name',\n"

" conversion=-1),\n"

" Constant(value=' finished '),\n"

" Interpolation(\n"

" value=Name(id='place', ctx=Load()),\n"

" str='place',\n"

" conversion=-1,\n"

" format_spec=JoinedStr(\n"

" values=[\n"

" Constant(value='ordinal')]))]))"

#: ../../library/ast.rst:370

msgid ""

"Node representing a single interpolation field in a template string literal."

msgstr "表示模板字串字面值中單一插值欄位的節點。"

#: ../../library/ast.rst:372

msgid ""

"``value`` is any expression node (such as a literal, a variable, or a "

"function call). This has the same meaning as ``FormattedValue.value``."

msgstr ""

"``value`` 為任何運算式節點（例如文字、變數或函式呼叫）。這和 "

"``FormattedValue.value`` 的意思相同。"

#: ../../library/ast.rst:375

msgid ""

"``str`` is a constant containing the text of the interpolation expression."

msgstr "``str`` 是一個包含插值運算式文字的常數。"

#: ../../library/ast.rst:377

msgid ""

"If ``str`` is set to ``None``, then ``value`` is used to generate code when "

"calling :func:`ast.unparse`. This no longer guarantees that the generated "

"code is identical to the original and is intended for code generation."

msgstr ""

"如果 ``str`` 被設為 ``None``，則在呼叫 :func:`ast.unparse` 時會使用 "

"``value`` 來產生程式碼。這不再保證產生的程式碼與原始程式碼相同，且適用於程式"

"碼產生。"

#: ../../library/ast.rst:383

msgid "-1: no conversion"

msgstr "-1：無規範"

#: ../../library/ast.rst:384

msgid "97 (``ord('a')``): ``!a`` :func:`ASCII <ascii>` conversion"

msgstr "97 (``ord('a')``)：``!a`` :func:`ASCII <ascii>` 轉換"

#: ../../library/ast.rst:385

msgid "114 (``ord('r')``): ``!r`` :func:`repr` conversion"

msgstr "114 (``ord('r')``)：``!r`` :func:`repr` 轉換"

#: ../../library/ast.rst:386

msgid "115 (``ord('s')``): ``!s`` :func:`string <str>` conversion"

msgstr "115 (``ord('s')``)：``!s`` :func:`string <str>` 轉換"