forked from AFPy/python-docs-fr
202 lines
6.0 KiB
Plaintext
202 lines
6.0 KiB
Plaintext
# Copyright (C) 2001-2018, Python Software Foundation
|
|
# For licence information, see README file.
|
|
#
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Python 3\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2022-03-23 18:39+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
|
|
msgid ""
|
|
"Refer to :ref:`using-capsules` for more information on using these objects."
|
|
msgstr ""
|
|
"Reportez-vous à :ref:`using-capsules` pour plus d'informations sur "
|
|
"l'utilisation de ces objets."
|
|
|
|
#: c-api/capsule.rst:17
|
|
msgid ""
|
|
"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."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:27
|
|
msgid "The type of a destructor callback for a capsule. Defined as::"
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:31
|
|
msgid ""
|
|
"See :c:func:`PyCapsule_New` for the semantics of PyCapsule_Destructor "
|
|
"callbacks."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:37
|
|
msgid ""
|
|
"Return true if its argument is a :c:type:`PyCapsule`. This function always "
|
|
"succeeds."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:43
|
|
msgid ""
|
|
"Create a :c:type:`PyCapsule` encapsulating the *pointer*. The *pointer* "
|
|
"argument may not be ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:46
|
|
msgid "On failure, set an exception and return ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:48
|
|
msgid ""
|
|
"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*.)"
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:52
|
|
msgid ""
|
|
"If the *destructor* argument is not ``NULL``, it will be called with the "
|
|
"capsule as its argument when it is destroyed."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:55
|
|
msgid ""
|
|
"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`."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:62
|
|
msgid ""
|
|
"Retrieve the *pointer* stored in the capsule. On failure, set an exception "
|
|
"and return ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:65
|
|
msgid ""
|
|
"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."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:73
|
|
msgid ""
|
|
"Return the current destructor stored in the capsule. On failure, set an "
|
|
"exception and return ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:76
|
|
msgid ""
|
|
"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."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:83
|
|
msgid ""
|
|
"Return the current context stored in the capsule. On failure, set an "
|
|
"exception and return ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:86
|
|
msgid ""
|
|
"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."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:93
|
|
msgid ""
|
|
"Return the current name stored in the capsule. On failure, set an exception "
|
|
"and return ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:96
|
|
msgid ""
|
|
"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."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:103
|
|
msgid ""
|
|
"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."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:108
|
|
msgid ""
|
|
"Return the capsule's internal *pointer* on success. On failure, set an "
|
|
"exception and return ``NULL``."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:111
|
|
msgid "*no_block* has no effect anymore."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:117
|
|
msgid ""
|
|
"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.)"
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:123
|
|
msgid ""
|
|
"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."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:127
|
|
msgid ""
|
|
"Return a nonzero value if the object is valid and matches the name passed "
|
|
"in. Return ``0`` otherwise. This function will not fail."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:133
|
|
msgid "Set the context pointer inside *capsule* to *context*."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:142 c-api/capsule.rst:159
|
|
msgid ""
|
|
"Return ``0`` on success. Return nonzero and set an exception on failure."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:140
|
|
msgid "Set the destructor inside *capsule* to *destructor*."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:147
|
|
msgid ""
|
|
"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."
|
|
msgstr ""
|
|
|
|
#: c-api/capsule.rst:156
|
|
msgid ""
|
|
"Set the void pointer inside *capsule* to *pointer*. The pointer may not be "
|
|
"``NULL``."
|
|
msgstr ""
|