# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
# 
# Translators:
# Rafael Fontenelle <rffontenelle@gmail.com>, 2026
# 
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-05-08 19:31+0000\n"
"PO-Revision-Date: 2026-05-08 17:17+0000\n"
"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2026\n"
"Language-Team: Chinese (China) (https://app.transifex.com/python-doc/teams/5390/zh_CN/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: zh_CN\n"
"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../library/code.rst:2
msgid ":mod:`!code` --- Interpreter base classes"
msgstr ":mod:`!code` --- 解释器基类"

#: ../../library/code.rst:7
msgid "**Source code:** :source:`Lib/code.py`"
msgstr "**源代码：** :source:`Lib/code.py`"

#: ../../library/code.rst:11
msgid ""
"The ``code`` module provides facilities to implement read-eval-print loops "
"in Python.  Two classes and convenience functions are included which can be "
"used to build applications which provide an interactive interpreter prompt."
msgstr ""
"``code`` 模块提供了在 Python 中实现 read-eval-print "
"循环的功能。它包含两个类和一些快捷功能，可用于构建提供交互式解释器的应用程序。"

#: ../../library/code.rst:18
msgid ""
"This class deals with parsing and interpreter state (the user's namespace); "
"it does not deal with input buffering or prompting or input file naming (the"
" filename is always passed in explicitly). The optional *locals* argument "
"specifies a mapping to use as the namespace in which code will be executed; "
"it defaults to a newly created dictionary with key ``'__name__'`` set to "
"``'__console__'`` and key ``'__doc__'`` set to ``None``."
msgstr ""
"这个类会处理解析和解释器状态（用户的命名空间）；它不会处理输入缓冲、提示或输入文件命名（文件名总是显式地传入）。 可选的 *locals* "
"参数指定一个映射作为代码执行所在的命名空间；它默认是一个新创建的字典，该字典中的键 ``'__name__'`` 设为 "
"``'__console__'`` 而键 ``'__doc__'`` 设为 ``None``。"

#: ../../library/code.rst:25
msgid ""
"Note that functions and classes objects created under an "
":class:`!InteractiveInterpreter` instance will belong to the namespace "
"specified by *locals*. They are only pickleable if *locals* is the namespace"
" of an existing module."
msgstr ""
"请注意在 :class:`!InteractiveInterpreter` 实例下创建的函数和类对象将属于由 *locals* 指定的命名空间。 只有当"
" *locals* 是现有模块的命名空间时它们才是可 pickle 的。"

#: ../../library/code.rst:34
msgid ""
"Closely emulate the behavior of the interactive Python interpreter. This "
"class builds on :class:`InteractiveInterpreter` and adds prompting using the"
" familiar ``sys.ps1`` and ``sys.ps2``, and input buffering. If *local_exit* "
"is true, ``exit()`` and ``quit()`` in the console will not raise "
":exc:`SystemExit`, but instead return to the calling code."
msgstr ""
"高度模仿交互式 Python 解释器的行为。 这个类基于 :class:`InteractiveInterpreter` 构建并使用熟悉的 "
"``sys.ps1`` 和 ``sys.ps2`` 来增加提示，以及输入缓冲功能。 如果 *local_exit* 为真值，控制台中的 "
"``exit()`` 和 ``quit()`` 将不会引发 :exc:`SystemExit`，而是返回到调用方代码。"

#: ../../library/code.rst:40 ../../library/code.rst:58
msgid "Added *local_exit* parameter."
msgstr "增加了 *local_exit* 形参。"

#: ../../library/code.rst:45
msgid ""
"Convenience function to run a read-eval-print loop.  This creates a new "
"instance of :class:`InteractiveConsole` and sets *readfunc* to be used as "
"the :meth:`InteractiveConsole.raw_input` method, if provided.  If *local* is"
" provided, it is passed to the :class:`InteractiveConsole` constructor for "
"use as the default namespace for the interpreter loop.  If *local_exit* is "
"provided, it is passed to the :class:`InteractiveConsole` constructor.  The "
":meth:`~InteractiveConsole.interact` method of the instance is then run with"
" *banner* and *exitmsg* passed as the banner and exit message to use, if "
"provided.  The console object is discarded after use."
msgstr ""
"运行一个读取-求值-打印循环的便捷函数。 这会创建一个新的 :class:`InteractiveConsole` 实例并设置 *readfunc* "
"作为 :meth:`InteractiveConsole.raw_input` 方法，如果有提供的话。 如果提供了 *local*，它将被传给 "
":class:`InteractiveConsole` 构造器以用作解释器循环的默认命名空间。 如果提供了 *local_exit*，它将被传给 "
":class:`InteractiveConsole` 构造器。 实例的 :meth:`~InteractiveConsole.interact` "
"方法将随后运行并传入 *banner* 和 *exitmsg* 以作为标题和退出消息，如果有提供的话。 控制台对象在使用后将被丢弃。"

#: ../../library/code.rst:55
msgid "Added *exitmsg* parameter."
msgstr "加入 *exitmsg* 参数。"

#: ../../library/code.rst:63
msgid ""
"This function is useful for programs that want to emulate Python's "
"interpreter main loop (a.k.a. the read-eval-print loop).  The tricky part is"
" to determine when the user has entered an incomplete command that can be "
"completed by entering more text (as opposed to a complete command or a "
"syntax error).  This function *almost* always makes the same decision as the"
" real interpreter main loop."
msgstr ""
"这个函数主要用来模拟 Python 解释器的主循环（即 read-eval-print "
"循环）。难点的部分是当用户输入不完整命令时，判断能否通过之后的输入来完成（要么成为完整的命令，要么语法错误）。该函数  *几乎* "
"和实际的解释器主循环的判断是相同的。"

#: ../../library/code.rst:70
msgid ""
"*source* is the source string; *filename* is the optional filename from "
"which source was read, defaulting to ``'<input>'``; and *symbol* is the "
"optional grammar start symbol, which should be ``'single'`` (the default), "
"``'eval'`` or ``'exec'``."
msgstr ""
"*source* 是源字符串；*filename* 是可选的用作读取源的文件名，默认为 ``'<input>'``；*symbol* "
"是可选的语法开启符号，应为 ``'single'`` (默认), ``'eval'`` 或 ``'exec'``。"

#: ../../library/code.rst:75
msgid ""
"Returns a code object (the same as ``compile(source, filename, symbol)``) if"
" the command is complete and valid; ``None`` if the command is incomplete; "
"raises :exc:`SyntaxError` if the command is complete and contains a syntax "
"error, or raises :exc:`OverflowError` or :exc:`ValueError` if the command "
"contains an invalid literal."
msgstr ""
"如果命令完整且有效则返回一个代码对象 (等价于 ``compile(source, filename, symbol)``)；如果命令不完整则返回 "
"``None``；如果命令完整但包含语法错误则会引发 :exc:`SyntaxError` 或 :exc:`OverflowError` "
"而如果命令包含无效字面值则将引发 :exc:`ValueError`。"

#: ../../library/code.rst:85
msgid "Interactive Interpreter Objects"
msgstr "交互解释器对象"

#: ../../library/code.rst:90
msgid ""
"Compile and run some source in the interpreter. Arguments are the same as "
"for :func:`compile_command`; the default for *filename* is ``'<input>'``, "
"and for *symbol* is ``'single'``.  One of several things can happen:"
msgstr ""
"在解释器中编译并运行一段源码。 所用参数与 :func:`compile_command` 一样；*filename* 的默认值为 "
"``'<input>'``，*symbol* 则为 ``'single'``。 可能发生以下情况之一："

#: ../../library/code.rst:94
msgid ""
"The input is incorrect; :func:`compile_command` raised an exception "
"(:exc:`SyntaxError` or :exc:`OverflowError`).  A syntax traceback will be "
"printed by calling the :meth:`showsyntaxerror` method.  :meth:`runsource` "
"returns ``False``."
msgstr ""
"输入不正确；:func:`compile_command` 引发了一个异常 (:exc:`SyntaxError` 或 "
":exc:`OverflowError`)。 将通过调用 :meth:`showsyntaxerror` 方法打印语法回溯信息。 "
":meth:`runsource` 返回 ``False``。"

#: ../../library/code.rst:99
msgid ""
"The input is incomplete, and more input is required; :func:`compile_command`"
" returned ``None``. :meth:`runsource` returns ``True``."
msgstr ""
"输入不完整，需要更多输入；函数 :func:`compile_command` 返回 ``None`` 。方法 :meth:`runsource` 返回"
" ``True`` 。"

#: ../../library/code.rst:102
msgid ""
"The input is complete; :func:`compile_command` returned a code object.  The "
"code is executed by calling the :meth:`runcode` (which also handles run-time"
" exceptions, except for :exc:`SystemExit`). :meth:`runsource` returns "
"``False``."
msgstr ""
"输入完整；:func:`compile_command` 返回了一个代码对象。 将通过调用 :meth:`runcode` "
"执行代码（该方法也会处理运行时异常，:exc:`SystemExit` 除外）。 :meth:`runsource` 返回 ``False``。"

#: ../../library/code.rst:106
msgid ""
"The return value can be used to decide whether to use ``sys.ps1`` or "
"``sys.ps2`` to prompt the next line."
msgstr "该返回值用于决定使用 ``sys.ps1`` 还是 ``sys.ps2`` 来作为下一行的输入提示符。"

#: ../../library/code.rst:112
msgid ""
"Execute a code object. When an exception occurs, :meth:`showtraceback` is "
"called to display a traceback.  All exceptions are caught except "
":exc:`SystemExit`, which is allowed to propagate."
msgstr ""
"执行一个代码对象。当发生异常时，调用 :meth:`showtraceback` 来显示回溯。除 :exc:`SystemExit` "
"（允许传播）以外的所有异常都会被捕获。"

#: ../../library/code.rst:116
msgid ""
"A note about :exc:`KeyboardInterrupt`: this exception may occur elsewhere in"
" this code, and may not always be caught.  The caller should be prepared to "
"deal with it."
msgstr ""
"有关 :exc:`KeyboardInterrupt` 的说明，该异常可能发生于此代码的其他位置，并且并不总能被捕获。 调用者应当准备好处理它。"

#: ../../library/code.rst:123
msgid ""
"Display the syntax error that just occurred.  This does not display a stack "
"trace because there isn't one for syntax errors. If *filename* is given, it "
"is stuffed into the exception instead of the default filename provided by "
"Python's parser, because it always uses ``'<string>'`` when reading from a "
"string. The output is written by the :meth:`write` method."
msgstr ""
"显示刚发生的语法错误。 这不会显示堆栈回溯因为语法错误并无此种信息。 如果给出了 *filename*，它会被放入异常来替代 Python "
"解析器所提供的默认文件名，因为它在从一个字符串读取时总是会使用 ``'<string>'``。 输出将由 :meth:`write` 方法来写入。"

#: ../../library/code.rst:132
msgid ""
"Display the exception that just occurred.  We remove the first stack item "
"because it is within the interpreter object implementation. The output is "
"written by the :meth:`write` method."
msgstr "显示刚发生的异常。 我们移除了第一个堆栈条目因为它从属于解释器对象的实现。 输出将由 :meth:`write` 方法来写入。"

#: ../../library/code.rst:136
msgid ""
"The full chained traceback is displayed instead of just the primary "
"traceback."
msgstr "将显示完整的链式回溯，而不只是主回溯。"

#: ../../library/code.rst:142
msgid ""
"Write a string to the standard error stream (``sys.stderr``). Derived "
"classes should override this to provide the appropriate output handling as "
"needed."
msgstr "将一个字符串写入到标准错误流 (``sys.stderr``)。 派生类应重写此方法以提供必要的正确输出处理。"

#: ../../library/code.rst:149
msgid "Interactive Console Objects"
msgstr "交互式控制台对象"

#: ../../library/code.rst:151
msgid ""
"The :class:`InteractiveConsole` class is a subclass of "
":class:`InteractiveInterpreter`, and so offers all the methods of the "
"interpreter objects as well as the following additions."
msgstr ""
":class:`InteractiveConsole` 类是 :class:`InteractiveInterpreter` "
"的子类，因此它提供了解释器对象的所有方法，还有以下的额外方法。"

#: ../../library/code.rst:158
msgid ""
"Closely emulate the interactive Python console. The optional *banner* "
"argument specify the banner to print before the first interaction; by "
"default it prints a banner similar to the one printed by the standard Python"
" interpreter, followed by the class name of the console object in "
"parentheses (so as not to confuse this with the real interpreter -- since "
"it's so close!)."
msgstr ""
"近似地模拟交互式 Python 终端。 可选的 *banner* 参数指定要在第一次交互前打印的条幅；默认情况下会类似于标准 Python "
"解释器所打印的内容，并附上外加圆括号的终端对象类名（这样就不会与真正的解释器混淆 —— 因为确实太像了！）"

#: ../../library/code.rst:164
msgid ""
"The optional *exitmsg* argument specifies an exit message printed when "
"exiting. Pass the empty string to suppress the exit message. If *exitmsg* is"
" not given or ``None``, a default message is printed."
msgstr ""
"可选的 *exitmsg* 参数指定要在退出时打印的退出消息。 传入空字符串可以屏蔽退出消息。 如果 *exitmsg* 未给出或为 "
"``None``，则将打印默认消息。"

#: ../../library/code.rst:168
msgid "To suppress printing any banner, pass an empty string."
msgstr "要禁止打印任何条幅消息，请传递一个空字符串。"

#: ../../library/code.rst:171
msgid "Print an exit message when exiting."
msgstr "退出时打印退出消息。"

#: ../../library/code.rst:177
msgid ""
"Push a line of source text to the interpreter. The line should not have a "
"trailing newline; it may have internal newlines.  The line is appended to a "
"buffer and the interpreter's :meth:`~InteractiveInterpreter.runsource` "
"method is called with the concatenated contents of the buffer as source.  If"
" this indicates that the command was executed or invalid, the buffer is "
"reset; otherwise, the command is incomplete, and the buffer is left as it "
"was after the line was appended.  The return value is ``True`` if more input"
" is required, ``False`` if the line was dealt with in some way (this is the "
"same as :meth:`!runsource`)."
msgstr ""
"将一行源代码文本推入解释器。 行内容不应带有末尾换行符；它可以有内部换行符。 行内容会被添加到一缓冲区然后调用解释器的 "
":meth:`~InteractiveInterpreter.runsource` 方法并附带缓冲区内容的拼接结果作为源文本。 "
"如果提示命令已执行或不合法，缓冲区将被重置；在其他情况下，则命令不完整，缓冲区将在添加行后保持原样。 如果需要更多的输入则返回值为 "
"``True``，如果行已按某种方式被处理则返回值为 ``False`` (这与 :meth:`!runsource` 相同)。"

#: ../../library/code.rst:189
msgid "Remove any unhandled source text from the input buffer."
msgstr "从输入缓冲区中删除所有未处理的内容。"

#: ../../library/code.rst:194
msgid ""
"Write a prompt and read a line.  The returned line does not include the "
"trailing newline.  When the user enters the EOF key sequence, "
":exc:`EOFError` is raised. The base implementation reads from ``sys.stdin``;"
" a subclass may replace this with a different implementation."
msgstr ""
"输出提示并读取一行。返回的行不包含末尾的换行符。当用户输入 EOF 键序列时，会引发 :exc:`EOFError` 异常。默认实现是从 "
"``sys.stdin`` 读取；子类可以用其他实现代替。"