iframe-proxy | Sunbelt Computer Software

197 lines (168 loc) · 6.09 KB
# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-23 09:47+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: c-api/capsule.rst:6
msgid "Capsules"
msgstr "Capsules"
#: c-api/capsule.rst:10
"Refer to :ref:`using-capsules` for more information on using these objects."
"Reportez-vous à :ref:`using-capsules` pour plus d'informations sur "
"l'utilisation de ces objets."
#: c-api/capsule.rst:17
"This subtype of :c:type:`PyObject` represents an opaque value, useful for C "
"extension modules who need to pass an opaque value (as a :c:type:`void*` "
"pointer) through Python code to other C code.  It is often used to make a C "
"function pointer defined in one module available to other modules, so the "
"regular import mechanism can be used to access C APIs defined in dynamically "
"loaded modules."
#: c-api/capsule.rst:27
msgid "The type of a destructor callback for a capsule.  Defined as::"
#: c-api/capsule.rst:31
"See :c:func:`PyCapsule_New` for the semantics of PyCapsule_Destructor "
"callbacks."
#: c-api/capsule.rst:37
msgid "Return true if its argument is a :c:type:`PyCapsule`."
#: c-api/capsule.rst:42
"Create a :c:type:`PyCapsule` encapsulating the *pointer*.  The *pointer* "
"argument may not be ``NULL``."
#: c-api/capsule.rst:45
msgid "On failure, set an exception and return ``NULL``."
#: c-api/capsule.rst:47
"The *name* string may either be ``NULL`` or a pointer to a valid C string.  "
"If non-``NULL``, this string must outlive the capsule.  (Though it is "
"permitted to free it inside the *destructor*.)"
#: c-api/capsule.rst:51
"If the *destructor* argument is not ``NULL``, it will be called with the "
"capsule as its argument when it is destroyed."
#: c-api/capsule.rst:54
"If this capsule will be stored as an attribute of a module, the *name* "
"should be specified as ``modulename.attributename``.  This will enable other "
"modules to import the capsule using :c:func:`PyCapsule_Import`."
#: c-api/capsule.rst:61
"Retrieve the *pointer* stored in the capsule.  On failure, set an exception "
"and return ``NULL``."
#: c-api/capsule.rst:64
"The *name* parameter must compare exactly to the name stored in the capsule. "
"If the name stored in the capsule is ``NULL``, the *name* passed in must "
"also be ``NULL``.  Python uses the C function :c:func:`strcmp` to compare "
"capsule names."
#: c-api/capsule.rst:72
"Return the current destructor stored in the capsule.  On failure, set an "
"exception and return ``NULL``."
#: c-api/capsule.rst:75
"It is legal for a capsule to have a ``NULL`` destructor.  This makes a "
"``NULL`` return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :"
"c:func:`PyErr_Occurred` to disambiguate."
#: c-api/capsule.rst:82
"Return the current context stored in the capsule.  On failure, set an "
"exception and return ``NULL``."
#: c-api/capsule.rst:85
"It is legal for a capsule to have a ``NULL`` context.  This makes a ``NULL`` "
"return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :c:func:"
"`PyErr_Occurred` to disambiguate."
#: c-api/capsule.rst:92
"Return the current name stored in the capsule.  On failure, set an exception "
"and return ``NULL``."
#: c-api/capsule.rst:95
"It is legal for a capsule to have a ``NULL`` name.  This makes a ``NULL`` "
"return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :c:func:"
"`PyErr_Occurred` to disambiguate."
#: c-api/capsule.rst:102
"Import a pointer to a C object from a capsule attribute in a module.  The "
"*name* parameter should specify the full name to the attribute, as in "
"``module.attribute``.  The *name* stored in the capsule must match this "
"string exactly.  If *no_block* is true, import the module without blocking "
"(using :c:func:`PyImport_ImportModuleNoBlock`).  If *no_block* is false, "
"import the module conventionally (using :c:func:`PyImport_ImportModule`)."
#: c-api/capsule.rst:109
"Return the capsule's internal *pointer* on success.  On failure, set an "
"exception and return ``NULL``."
#: c-api/capsule.rst:115
"Determines whether or not *capsule* is a valid capsule.  A valid capsule is "
"non-``NULL``, passes :c:func:`PyCapsule_CheckExact`, has a non-``NULL`` "
"pointer stored in it, and its internal name matches the *name* parameter.  "
"(See :c:func:`PyCapsule_GetPointer` for information on how capsule names are "
"compared.)"
#: c-api/capsule.rst:121
"In other words, if :c:func:`PyCapsule_IsValid` returns a true value, calls "
"to any of the accessors (any function starting with :c:func:`PyCapsule_Get`) "
"are guaranteed to succeed."
#: c-api/capsule.rst:125
"Return a nonzero value if the object is valid and matches the name passed "
"in. Return ``0`` otherwise.  This function will not fail."
#: c-api/capsule.rst:131
msgid "Set the context pointer inside *capsule* to *context*."
#: c-api/capsule.rst:140 c-api/capsule.rst:157
"Return ``0`` on success.  Return nonzero and set an exception on failure."
#: c-api/capsule.rst:138
msgid "Set the destructor inside *capsule* to *destructor*."
#: c-api/capsule.rst:145
"Set the name inside *capsule* to *name*.  If non-``NULL``, the name must "
"outlive the capsule.  If the previous *name* stored in the capsule was not "
"``NULL``, no attempt is made to free it."
#: c-api/capsule.rst:154
"Set the void pointer inside *capsule* to *pointer*.  The pointer may not be "
"``NULL``."
Sunbelt Computer Software

PL/B Language Development and Support

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

Sunbelt Computer Software

PL/B Language Development and Support

Uh oh!

Uh oh!

FilesExpand file tree

capsule.po

Latest commit

History

capsule.po

File metadata and controls
