# 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 <[email protected]>, 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 <[email protected]>, 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"

#: ../../c-api/function.rst:6

msgid "Function Objects"

msgstr "Function 对象"

#: ../../c-api/function.rst:10

msgid "There are a few functions specific to Python functions."

msgstr "有一些特定于 Python 函数的函数。"

#: ../../c-api/function.rst:15

msgid "The C structure used for functions."

msgstr "用于函数的 C 结构体。"

#: ../../c-api/function.rst:22

msgid ""

"This is an instance of :c:type:`PyTypeObject` and represents the Python "

"function type. It is exposed to Python programmers as "

"``types.FunctionType``."

msgstr ""

"这是一个 :c:type:`PyTypeObject` 实例并表示 Python 函数类型。 它作为 ``types.FunctionType`` 向 "

"Python 程序员公开。"

#: ../../c-api/function.rst:28

msgid ""

"Return true if *o* is a function object (has type "

":c:data:`PyFunction_Type`). The parameter must not be ``NULL``. This "

"function always succeeds."

msgstr ""

"如果 *o* 是一个函数对象 (类型为 :c:data:`PyFunction_Type`) 则返回真值。 形参必须不为 ``NULL``。 "

"此函数总是会成功执行。"

#: ../../c-api/function.rst:34

msgid ""

"Return a new function object associated with the code object *code*. "

"*globals* must be a dictionary with the global variables accessible to the "

"function."

msgstr "返回与代码对象 *code* 关联的新函数对象。 *globals* 必须是一个字典，该函数可以访问全局变量。"

#: ../../c-api/function.rst:37

msgid ""

"The function's docstring and name are retrieved from the code object. "

":attr:`~function.__module__` is retrieved from *globals*. The argument "

"defaults, annotations and closure are set to ``NULL``. "

":attr:`~function.__qualname__` is set to the same value as the code object's"

" :attr:`~codeobject.co_qualname` field."

msgstr ""

"函数的文档字符串和名称是从代码对象中提取的。 :attr:`~function.__module__` 是从 *globals* 中提取的。 参数 "

"defaults, annotations 和 closure 被设为 ``NULL``。 :attr:`~function.__qualname__`"

" 被设为与代码对象的 :attr:`~codeobject.co_qualname` 字段相同的值。"

#: ../../c-api/function.rst:46

msgid ""

"As :c:func:`PyFunction_New`, but also allows setting the function object's "

":attr:`~function.__qualname__` attribute. *qualname* should be a unicode "

"object or ``NULL``; if ``NULL``, the :attr:`!__qualname__` attribute is set "

"to the same value as the code object's :attr:`~codeobject.co_qualname` "

"field."

msgstr ""

"类似 :c:func:`PyFunction_New`，但还允许设置函数对象的 :attr:`~function.__qualname__` 属性。 "

"*qualname* 应当是一个 unicode 对象或为 ``NULL``；如为 ``NULL``，则 :attr:`!__qualname__` "

"属性会被设为与代码对象的 :attr:`~codeobject.co_qualname` 字段相同的值。"

#: ../../c-api/function.rst:57

msgid "Return the code object associated with the function object *op*."

msgstr "返回与函数对象 *op* 关联的代码对象。"

#: ../../c-api/function.rst:62

msgid ""

"Return the globals dictionary associated with the function object *op*."

msgstr "返回与函数对象*op*相关联的全局字典。"

#: ../../c-api/function.rst:67

msgid ""

"Return a :term:`borrowed reference` to the :attr:`~function.__module__` "

"attribute of the :ref:`function object <user-defined-funcs>` *op*. It can be"

" *NULL*."

msgstr ""

"向 :ref:`函数对象 <user-defined-funcs>` *op* 的 :attr:`~function.__module__` "

"属性返回一个 :term:`borrowed reference`。 该值可以为 *NULL*。"

#: ../../c-api/function.rst:71

msgid ""

"This is normally a :class:`string <str>` containing the module name, but can"

" be set to any other object by Python code."

msgstr "这通常为一个包含模块名称的 :class:`字符串 <str>`，但可以通过 Python 代码设为任何其他对象。"

#: ../../c-api/function.rst:77

msgid ""

"Return the argument default values of the function object *op*. This can be "

"a tuple of arguments or ``NULL``."

msgstr "返回函数对象 *op* 的参数默认值。 这可以是一个参数元组或 ``NULL``。"

#: ../../c-api/function.rst:83

msgid ""

"Set the argument default values for the function object *op*. *defaults* "

"must be ``Py_None`` or a tuple."

msgstr "为函数对象 *op* 设置参数默认值。 *defaults* 必须为 ``Py_None`` 或一个元组。"

#: ../../c-api/function.rst:86 ../../c-api/function.rst:109

#: ../../c-api/function.rst:123

msgid "Raises :exc:`SystemError` and returns ``-1`` on failure."

msgstr "失败时引发 :exc:`SystemError` 异常并返回 ``-1`` 。"

#: ../../c-api/function.rst:91

msgid "Set the vectorcall field of a given function object *func*."

msgstr "设置给定函数对象 *func* 的 vectorcall 字段。"

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

msgid ""

"Warning: extensions using this API must preserve the behavior of the "

"unaltered (default) vectorcall function!"

msgstr "警告：使用此 API 的扩展必须保留未修改的（默认） vectorcall 函数的行为！"

#: ../../c-api/function.rst:100

msgid ""

"Return the closure associated with the function object *op*. This can be "

"``NULL`` or a tuple of cell objects."

msgstr "返回关联到函数对象 *op* 的闭包。 这可以是 ``NULL`` 或 cell 对象的元组。"

#: ../../c-api/function.rst:106

msgid ""

"Set the closure associated with the function object *op*. *closure* must be "

"``Py_None`` or a tuple of cell objects."

msgstr "设置关联到函数对象 *op* 的闭包。 *closure* 必须为 ``Py_None`` 或 cell 对象的元组。"

#: ../../c-api/function.rst:114

msgid ""

"Return the annotations of the function object *op*. This can be a mutable "

"dictionary or ``NULL``."

msgstr "返回函数对象 *op* 的标注。 这可以是一个可变字典或 ``NULL``。"

#: ../../c-api/function.rst:120

msgid ""

"Set the annotations for the function object *op*. *annotations* must be a "

"dictionary or ``Py_None``."

msgstr "设置函数对象 *op* 的标注。 *annotations* 必须为一个字典或 ``Py_None``。"

#: ../../c-api/function.rst:128

msgid ""

"Register *callback* as a function watcher for the current interpreter. "

"Return an ID which may be passed to :c:func:`PyFunction_ClearWatcher`. In "

"case of error (e.g. no more watcher IDs available), return ``-1`` and set an"

" exception."

msgstr ""

"注册 *callback* 作为当前解释器的函数监视器。 返回一个可被传给 :c:func:`PyFunction_ClearWatcher` 的 "

"ID。 如果出现错误（比如没有足够的可用监视器 ID），则返回 ``-1`` 并设置一个异常。"

#: ../../c-api/function.rst:138

msgid ""

"Clear watcher identified by *watcher_id* previously returned from "

":c:func:`PyFunction_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 ""

"清空当前解释器在之前从Clear watcher identified by previously returned from "

":c:func:`PyFunction_AddWatcher` 返回的由 *watcher_id* 所标识的监视器。 成功时返回 "

"``0``，或者出错时（比如当给定的 *watcher_id* 未被注册）返回 ``-1`` 并设置一个异常。"

#: ../../c-api/function.rst:148

msgid "Enumeration of possible function watcher events:"

msgstr "由可能的函数监视事件组成的枚举："

#: ../../c-api/function.rst:150

msgid "``PyFunction_EVENT_CREATE``"

msgstr "``PyFunction_EVENT_CREATE``"

#: ../../c-api/function.rst:151

msgid "``PyFunction_EVENT_DESTROY``"

msgstr "``PyFunction_EVENT_DESTROY``"

#: ../../c-api/function.rst:152

msgid "``PyFunction_EVENT_MODIFY_CODE``"

msgstr "``PyFunction_EVENT_MODIFY_CODE``"

#: ../../c-api/function.rst:153

msgid "``PyFunction_EVENT_MODIFY_DEFAULTS``"

msgstr "``PyFunction_EVENT_MODIFY_DEFAULTS``"

#: ../../c-api/function.rst:154

msgid "``PyFunction_EVENT_MODIFY_KWDEFAULTS``"

msgstr "``PyFunction_EVENT_MODIFY_KWDEFAULTS``"

#: ../../c-api/function.rst:161

msgid "Type of a function watcher callback function."

msgstr "函数监视器回调函数的类型。"

#: ../../c-api/function.rst:163

msgid ""

"If *event* is ``PyFunction_EVENT_CREATE`` or ``PyFunction_EVENT_DESTROY`` "

"then *new_value* will be ``NULL``. Otherwise, *new_value* will hold a "

":term:`borrowed reference` to the new value that is about to be stored in "

"*func* for the attribute that is being modified."

msgstr ""

"如果 *event* 为 ``PyFunction_EVENT_CREATE`` 或 ``PyFunction_EVENT_DESTROY`` 则 "

"*new_value* 将为 ``NULL``。 在其他情况下，*new_value* 将为被修改的属性持有一个指向要保存在 *func* 中的新值的 "

":term:`borrowed reference`。"

#: ../../c-api/function.rst:168

msgid ""

"The callback may inspect but must not modify *func*; doing so could have "

"unpredictable effects, including infinite recursion."

msgstr "该回调可以检查但不能修改 *func*; 这样做可能具有不可预知的影响，包括无限递归。"

#: ../../c-api/function.rst:171

msgid ""

"If *event* is ``PyFunction_EVENT_CREATE``, then the callback is invoked "

"after `func` has been fully initialized. Otherwise, the callback is invoked "

"before the modification to *func* takes place, so the prior state of *func* "

"can be inspected. The runtime is permitted to optimize away the creation of "

"function objects when possible. In such cases no event will be emitted. "

"Although this creates the possibility of an observable difference of runtime"

" behavior depending on optimization decisions, it does not change the "

"semantics of the Python code being executed."

msgstr ""

"如果 *event* 是 ``PyFunction_EVENT_CREATE``，则该回调会在 `func` 完成初始化之后被唤起。 "

"在其他情况下，该回调会在对 *func* 进行修改之前被唤起，这样就可以检查 *func* 之前的状态。 如有可能函数对象的创建允许被运行时优化掉。 "

"在此情况下将不发出任何事件。 虽然根据不同的优化决定这会产生可被观察到的运行时行为变化，但是它不会改变被运行的 Python 代码的语义。"

#: ../../c-api/function.rst:180

msgid ""

"If *event* is ``PyFunction_EVENT_DESTROY``, Taking a reference in the "

"callback to the about-to-be-destroyed function will resurrect it, preventing"

" 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 ""

"如果 *event* 是 "

"``PyFunction_EVENT_DESTROY``，则在回调中接受一个即将销毁的函数的引用将使其重生，并阻止其在此时被释放。 "

"当重生的对象以后再被销毁时，任何在当时已激活的监视器回调将再次被调用。"

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

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 ""

"如果该回调设置了一个异常，则它必须返回 ``-1``；此异常将作为不可引发的异常使用 :c:func:`PyErr_WriteUnraisable` "

"打印出来。 在其他情况下它应当返回 ``0``。"

#: ../../c-api/function.rst:189

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 ""

"在进入回调时可能已经设置了尚未处理的异常。 在此情况下，回调应当返回 ``0`` 并仍然设置同样的异常。 这意味着该回调可能不会调用任何其他可设置异常的"

" API 除非它先保存并清空异常状态，并在返回之前恢复它。"

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

msgid "object"

msgstr "object -- 对象"

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

msgid "function"

msgstr "function -- 函数"

#: ../../c-api/function.rst:20

msgid "MethodType (in module types)"

msgstr "MethodType (types 模块)"