# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001-2016, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2016-10-30 10:40+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../Doc/c-api/capsule.rst:6 msgid "Capsules" msgstr "Capsules" #: ../Doc/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." #: ../Doc/c-api/capsule.rst:15 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 "" #: ../Doc/c-api/capsule.rst:24 msgid "The type of a destructor callback for a capsule. Defined as::" msgstr "" #: ../Doc/c-api/capsule.rst:28 msgid "" "See :c:func:`PyCapsule_New` for the semantics of PyCapsule_Destructor " "callbacks." msgstr "" #: ../Doc/c-api/capsule.rst:34 msgid "Return true if its argument is a :c:type:`PyCapsule`." msgstr "" #: ../Doc/c-api/capsule.rst:39 msgid "" "Create a :c:type:`PyCapsule` encapsulating the *pointer*. The *pointer* " "argument may not be *NULL*." msgstr "" #: ../Doc/c-api/capsule.rst:42 msgid "On failure, set an exception and return *NULL*." msgstr "" #: ../Doc/c-api/capsule.rst:44 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 "" #: ../Doc/c-api/capsule.rst:48 msgid "" "If the *destructor* argument is not *NULL*, it will be called with the " "capsule as its argument when it is destroyed." msgstr "" #: ../Doc/c-api/capsule.rst:51 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 "" #: ../Doc/c-api/capsule.rst:58 msgid "" "Retrieve the *pointer* stored in the capsule. On failure, set an exception " "and return *NULL*." msgstr "" #: ../Doc/c-api/capsule.rst:61 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 "" #: ../Doc/c-api/capsule.rst:69 msgid "" "Return the current destructor stored in the capsule. On failure, set an " "exception and return *NULL*." msgstr "" #: ../Doc/c-api/capsule.rst:72 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 "" #: ../Doc/c-api/capsule.rst:79 msgid "" "Return the current context stored in the capsule. On failure, set an " "exception and return *NULL*." msgstr "" #: ../Doc/c-api/capsule.rst:82 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 "" #: ../Doc/c-api/capsule.rst:89 msgid "" "Return the current name stored in the capsule. On failure, set an exception " "and return *NULL*." msgstr "" #: ../Doc/c-api/capsule.rst:92 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 "" #: ../Doc/c-api/capsule.rst:99 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. 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`)." msgstr "" #: ../Doc/c-api/capsule.rst:106 msgid "" "Return the capsule's internal *pointer* on success. On failure, set an " "exception and return *NULL*. However, if :c:func:`PyCapsule_Import` failed " "to import the module, and *no_block* was true, no exception is set." msgstr "" #: ../Doc/c-api/capsule.rst:112 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 "" #: ../Doc/c-api/capsule.rst:118 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 "" #: ../Doc/c-api/capsule.rst:122 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 "" #: ../Doc/c-api/capsule.rst:127 msgid "Set the context pointer inside *capsule* to *context*." msgstr "" #: ../Doc/c-api/capsule.rst:129 ../Doc/c-api/capsule.rst:135 #: ../Doc/c-api/capsule.rst:143 ../Doc/c-api/capsule.rst:150 msgid "Return 0 on success. Return nonzero and set an exception on failure." msgstr "" #: ../Doc/c-api/capsule.rst:133 msgid "Set the destructor inside *capsule* to *destructor*." msgstr "" #: ../Doc/c-api/capsule.rst:139 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 "" #: ../Doc/c-api/capsule.rst:147 msgid "" "Set the void pointer inside *capsule* to *pointer*. The pointer may not be " "*NULL*." msgstr ""