# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2025, 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>, 2025
# 
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.12\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-07-25 16:03+0000\n"
"PO-Revision-Date: 2025-07-18 19:57+0000\n"
"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2025\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 the dictionary 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:28
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."
msgstr ""
"尽可能模拟交互式 Python 解释器的行为。此类建立在 :class:`InteractiveInterpreter` 的基础上，使用熟悉的 "
"``sys.ps1`` 和 ``sys.ps2`` 作为输入提示符，并有输入缓冲。"

#: ../../library/code.rst:35
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.  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` 构造器以用作解析器循环的默认命名空间。 实例的 "
":meth:`~InteractiveConsole.interact` 方法将随后运行并传入 *banner* 和 *exitmsg* "
"以用作标题和退出消息，如果有提供的话。 控制台对象在使用后将被丢弃。"

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

#: ../../library/code.rst:50
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:57
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:62
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:72
msgid "Interactive Interpreter Objects"
msgstr "交互解释器对象"

#: ../../library/code.rst:77
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:81
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:86
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:89
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:93
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:99
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:103
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:110
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:119
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:123
msgid ""
"The full chained traceback is displayed instead of just the primary "
"traceback."
msgstr "将显示完整的链式回溯，而不只是主回溯。"

#: ../../library/code.rst:129
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:136
msgid "Interactive Console Objects"
msgstr "交互式控制台对象"

#: ../../library/code.rst:138
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:145
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:151
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:155
msgid "To suppress printing any banner, pass an empty string."
msgstr "要禁止打印任何条幅消息，请传递一个空字符串。"

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

#: ../../library/code.rst:164
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:176
msgid "Remove any unhandled source text from the input buffer."
msgstr "从输入缓冲区中删除所有未处理的内容。"

#: ../../library/code.rst:181
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`` 读取；子类可以用其他实现代替。"