iframe-proxy | Sunbelt Computer Software

270 lines (227 loc) · 8.12 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2024, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
"Project-Id-Version: Python 3.12\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-11-27 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: c-api/function.rst:6
msgid "Function Objects"
#: c-api/function.rst:10
msgid "There are a few functions specific to Python functions."
#: c-api/function.rst:15
msgid "The C structure used for functions."
#: c-api/function.rst:22
"This is an instance of :c:type:`PyTypeObject` and represents the Python "
"function type.  It is exposed to Python programmers as ``types."
"FunctionType``."
#: c-api/function.rst:28
"Return true if *o* is a function object (has type :c:data:"
"`PyFunction_Type`). The parameter must not be ``NULL``.  This function "
"always succeeds."
#: c-api/function.rst:34
"Return a new function object associated with the code object *code*. "
"*globals* must be a dictionary with the global variables accessible to the "
"function."
#: c-api/function.rst:37
"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."
#: c-api/function.rst:46
"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."
#: c-api/function.rst:57
msgid "Return the code object associated with the function object *op*."
#: c-api/function.rst:62
msgid "Return the globals dictionary associated with the function object *op*."
#: c-api/function.rst:67
"Return a :term:`borrowed reference` to the :attr:`~function.__module__` "
"attribute of the :ref:`function object <user-defined-funcs>` *op*. It can be "
#: c-api/function.rst:71
"This is normally a :class:`string <str>` containing the module name, but can "
"be set to any other object by Python code."
#: c-api/function.rst:77
"Return the argument default values of the function object *op*. This can be "
"a tuple of arguments or ``NULL``."
#: c-api/function.rst:83
"Set the argument default values for the function object *op*. *defaults* "
"must be ``Py_None`` or a tuple."
#: c-api/function.rst:125 c-api/function.rst:139
msgid "Raises :exc:`SystemError` and returns ``-1`` on failure."
#: c-api/function.rst:91
msgid "Set the vectorcall field of a given function object *func*."
#: c-api/function.rst:93
"Warning: extensions using this API must preserve the behavior of the "
"unaltered (default) vectorcall function!"
#: c-api/function.rst:101
"Return the keyword-only argument default values of the function object *op*. "
"This can be a dictionary of arguments or ``NULL``."
#: c-api/function.rst:107
"Set the keyword-only argument default values of the function object *op*. "
"*defaults* must be a dictionary of keyword-only arguments or ``Py_None``."
#: c-api/function.rst:110
"This function returns ``0`` on success, and returns ``-1`` with an exception "
"set on failure."
#: c-api/function.rst:116
"Return the closure associated with the function object *op*. This can be "
"``NULL`` or a tuple of cell objects."
#: c-api/function.rst:122
"Set the closure associated with the function object *op*. *closure* must be "
"``Py_None`` or a tuple of cell objects."
#: c-api/function.rst:130
"Return the annotations of the function object *op*. This can be a mutable "
"dictionary or ``NULL``."
#: c-api/function.rst:136
"Set the annotations for the function object *op*. *annotations* must be a "
"dictionary or ``Py_None``."
#: c-api/function.rst:150
"These functions are similar to their ``PyFunction_Get*`` counterparts, but "
"do not do type checking. Passing anything other than an instance of :c:data:"
"`PyFunction_Type` is undefined behavior."
#: c-api/function.rst:157
"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."
#: c-api/function.rst:167
"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.)"
#: c-api/function.rst:177
msgid "Enumeration of possible function watcher events:"
#: c-api/function.rst:179
msgid "``PyFunction_EVENT_CREATE``"
#: c-api/function.rst:180
msgid "``PyFunction_EVENT_DESTROY``"
#: c-api/function.rst:181
msgid "``PyFunction_EVENT_MODIFY_CODE``"
#: c-api/function.rst:182
msgid "``PyFunction_EVENT_MODIFY_DEFAULTS``"
#: c-api/function.rst:183
msgid "``PyFunction_EVENT_MODIFY_KWDEFAULTS``"
#: c-api/function.rst:190
msgid "Type of a function watcher callback function."
#: c-api/function.rst:192
"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."
#: c-api/function.rst:197
"The callback may inspect but must not modify *func*; doing so could have "
"unpredictable effects, including infinite recursion."
#: c-api/function.rst:200
"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."
#: c-api/function.rst:209
"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."
#: c-api/function.rst:214
"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``."
#: c-api/function.rst:218
"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."
#: c-api/function.rst:8
msgid "object"
#: c-api/function.rst:8
msgid "function"
#: c-api/function.rst:20
msgid "MethodType (in module types)"
Sunbelt Computer Software

PL/B Language Development and Support

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Sunbelt Computer Software

PL/B Language Development and Support

Uh oh!

FilesExpand file tree

function.po

Latest commit

History

function.po

File metadata and controls
