forked from AFPy/python-docs-fr
419 lines
18 KiB
Plaintext
419 lines
18 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 1990-2016, Python Software Foundation
|
|
# This file is distributed under the same license as the Python package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Python 2.7\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2016-10-30 10:44+0100\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"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../Doc/c-api/object.rst:6
|
|
msgid "Object Protocol"
|
|
msgstr "Protocole Objet"
|
|
|
|
#: ../Doc/c-api/object.rst:11
|
|
msgid ""
|
|
"Print an object *o*, on file *fp*. Returns ``-1`` on error. The flags "
|
|
"argument is used to enable certain printing options. The only option "
|
|
"currently supported is :const:`Py_PRINT_RAW`; if given, the :func:`str` of "
|
|
"the object is written instead of the :func:`repr`."
|
|
msgstr ""
|
|
"Écrit un objet *o*, dans le fichier *fp*. Renvoie ``-1`` en cas d'erreur. "
|
|
"L'argument *flags* est utilisé pour permettre certaines options de rendu. La "
|
|
"seule option actuellement gérée est :const:`Py_PRINT_RAW` ; si cet argument "
|
|
"est fourni, le :func:`str` de l'objet est utilisé pour le rendu à la place "
|
|
"de :func:`repr`."
|
|
|
|
#: ../Doc/c-api/object.rst:19 ../Doc/c-api/object.rst:26
|
|
msgid ""
|
|
"Returns ``1`` if *o* has the attribute *attr_name*, and ``0`` otherwise. "
|
|
"This is equivalent to the Python expression ``hasattr(o, attr_name)``. This "
|
|
"function always succeeds."
|
|
msgstr ""
|
|
"Renvoie ``1`` si *o* a l'attribut *attr_name*, et ``0`` sinon. Ceci est "
|
|
"équivalent à l'expression Python ``hasattr(o, attr_name)``. Cette fonction "
|
|
"réussit toujours."
|
|
|
|
#: ../Doc/c-api/object.rst:33
|
|
msgid ""
|
|
"Retrieve an attribute named *attr_name* from object *o*. Returns the "
|
|
"attribute value on success, or *NULL* on failure. This is the equivalent of "
|
|
"the Python expression ``o.attr_name``."
|
|
msgstr ""
|
|
"Récupère l'attribut nommé *attr_name* de l'objet *o*. Renvoie la valeur de "
|
|
"l'attribut en cas de succès, ou *NULL* en cas d'échec. Ceci est équivalent à "
|
|
"l'expression Python ``o.attr_name``."
|
|
|
|
#: ../Doc/c-api/object.rst:40
|
|
msgid ""
|
|
"Retrieve an attribute named *attr_name* from object *o*. Returns the "
|
|
"attribute value on success, or *NULL* on failure. This is the equivalent of "
|
|
"the Python expression ``o.attr_name``."
|
|
msgstr ""
|
|
"Récupère un attribut nommé *attr_name* de l'objet *o*. Renvoie la valeur de "
|
|
"l'attribut en cas de succès, ou *NULL* en cas d'échec. Ceci est équivalent à "
|
|
"l'expression Python ``o.attr_name``."
|
|
|
|
#: ../Doc/c-api/object.rst:47
|
|
msgid ""
|
|
"Generic attribute getter function that is meant to be put into a type "
|
|
"object's ``tp_getattro`` slot. It looks for a descriptor in the dictionary "
|
|
"of classes in the object's MRO as well as an attribute in the object's :attr:"
|
|
"`~object.__dict__` (if present). As outlined in :ref:`descriptors`, data "
|
|
"descriptors take preference over instance attributes, while non-data "
|
|
"descriptors don't. Otherwise, an :exc:`AttributeError` is raised."
|
|
msgstr ""
|
|
"Accesseur d'attribut générique destiné à être mis dans le *slot* "
|
|
"``tp_getattro`` d'un objet type. Recherche un descripteur dans le "
|
|
"dictionnaire de classes du MRO de l'objet ainsi qu'un attribut dans le :attr:"
|
|
"`~object.__dict__` de l'objet (si présent). Comme défini dans :ref:"
|
|
"`descriptors`, les descripteurs de données sont prioritaires sur les "
|
|
"attributs d'instance, contrairement aux autres descripteurs. Sinon, une :exc:"
|
|
"`AttributeError` est levée."
|
|
|
|
#: ../Doc/c-api/object.rst:57 ../Doc/c-api/object.rst:64
|
|
msgid ""
|
|
"Set the value of the attribute named *attr_name*, for object *o*, to the "
|
|
"value *v*. Returns ``-1`` on failure. This is the equivalent of the Python "
|
|
"statement ``o.attr_name = v``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:71
|
|
msgid ""
|
|
"Generic attribute setter function that is meant to be put into a type "
|
|
"object's ``tp_setattro`` slot. It looks for a data descriptor in the "
|
|
"dictionary of classes in the object's MRO, and if found it takes preference "
|
|
"over setting the attribute in the instance dictionary. Otherwise, the "
|
|
"attribute is set in the object's :attr:`~object.__dict__` (if present). "
|
|
"Otherwise, an :exc:`AttributeError` is raised and ``-1`` is returned."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:81 ../Doc/c-api/object.rst:87
|
|
msgid ""
|
|
"Delete attribute named *attr_name*, for object *o*. Returns ``-1`` on "
|
|
"failure. This is the equivalent of the Python statement ``del o.attr_name``."
|
|
msgstr ""
|
|
"Supprime l'attribut nommé *attr_name*, pour l'objet *o*. Renvoie ``-1`` en "
|
|
"cas d'échec. Ceci est l'équivalent de l'expression Python ``del o."
|
|
"attr_name``."
|
|
|
|
#: ../Doc/c-api/object.rst:93
|
|
msgid ""
|
|
"Compare the values of *o1* and *o2* using the operation specified by *opid*, "
|
|
"which must be one of :const:`Py_LT`, :const:`Py_LE`, :const:`Py_EQ`, :const:"
|
|
"`Py_NE`, :const:`Py_GT`, or :const:`Py_GE`, corresponding to ``<``, ``<=``, "
|
|
"``==``, ``!=``, ``>``, or ``>=`` respectively. This is the equivalent of the "
|
|
"Python expression ``o1 op o2``, where ``op`` is the operator corresponding "
|
|
"to *opid*. Returns the value of the comparison on success, or *NULL* on "
|
|
"failure."
|
|
msgstr ""
|
|
"Compare les valeurs de *o1* et *o2* en utilisant l'opération spécifiée par "
|
|
"*opid*, qui doit être :const:`Py_LT`, :const:`Py_LE`, :const:`Py_EQ`, :const:"
|
|
"`Py_NE`, :const:`Py_GT`, ou :const:`Py_GE`, correspondant à ``<``, ``<=``, "
|
|
"``==``, ``!=``, ``>``, ou ``>=`` respectivement. Ceci est l'équivalent de "
|
|
"l'expression Python ``o1 op o2``, où ``op`` est l'opérateur correspondant à "
|
|
"*opid*. Renvoie la valeur de la comparaison en cas de succès, ou *NULL* en "
|
|
"cas d'échec."
|
|
|
|
#: ../Doc/c-api/object.rst:103
|
|
msgid ""
|
|
"Compare the values of *o1* and *o2* using the operation specified by *opid*, "
|
|
"which must be one of :const:`Py_LT`, :const:`Py_LE`, :const:`Py_EQ`, :const:"
|
|
"`Py_NE`, :const:`Py_GT`, or :const:`Py_GE`, corresponding to ``<``, ``<=``, "
|
|
"``==``, ``!=``, ``>``, or ``>=`` respectively. Returns ``-1`` on error, "
|
|
"``0`` if the result is false, ``1`` otherwise. This is the equivalent of the "
|
|
"Python expression ``o1 op o2``, where ``op`` is the operator corresponding "
|
|
"to *opid*."
|
|
msgstr ""
|
|
"Compare les valeurs de *o1* et *o2* en utilisant l'opération spécifiée par "
|
|
"*opid*, qui doit être :const:`Py_LT`, :const:`Py_LE`, :const:`Py_EQ`, :const:"
|
|
"`Py_NE`, :const:`Py_GT`, ou :const:`Py_GE`, correspondant à ``<``, ``<=``, "
|
|
"``==``, ``!=``, ``>``, ou ``>=`` respectivement. Renvoie ``-1`` en cas "
|
|
"d'erreur, ``0`` si le résultat est faux, et ``1`` sinon. Ceci est "
|
|
"l'équivalent de l'expression Python ``o1 op o2``, où ``op`` est l'opérateur "
|
|
"correspondant à *opid*."
|
|
|
|
#: ../Doc/c-api/object.rst:112
|
|
msgid ""
|
|
"If *o1* and *o2* are the same object, :c:func:`PyObject_RichCompareBool` "
|
|
"will always return ``1`` for :const:`Py_EQ` and ``0`` for :const:`Py_NE`."
|
|
msgstr ""
|
|
"Si *o1* et *o2* sont le même objet, :c:func:`PyObject_RichCompareBool` "
|
|
"renvoie toujours ``1`` pour :const:`Py_EQ` et ``0`` pour :const:`Py_NE`."
|
|
|
|
#: ../Doc/c-api/object.rst:119
|
|
msgid ""
|
|
"Compare the values of *o1* and *o2* using a routine provided by *o1*, if one "
|
|
"exists, otherwise with a routine provided by *o2*. The result of the "
|
|
"comparison is returned in *result*. Returns ``-1`` on failure. This is the "
|
|
"equivalent of the Python statement ``result = cmp(o1, o2)``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:129
|
|
msgid ""
|
|
"Compare the values of *o1* and *o2* using a routine provided by *o1*, if one "
|
|
"exists, otherwise with a routine provided by *o2*. Returns the result of "
|
|
"the comparison on success. On error, the value returned is undefined; use :"
|
|
"c:func:`PyErr_Occurred` to detect an error. This is equivalent to the "
|
|
"Python expression ``cmp(o1, o2)``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:140
|
|
msgid ""
|
|
"Compute a string representation of object *o*. Returns the string "
|
|
"representation on success, *NULL* on failure. This is the equivalent of the "
|
|
"Python expression ``repr(o)``. Called by the :func:`repr` built-in function "
|
|
"and by reverse quotes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:150
|
|
msgid ""
|
|
"Compute a string representation of object *o*. Returns the string "
|
|
"representation on success, *NULL* on failure. This is the equivalent of the "
|
|
"Python expression ``str(o)``. Called by the :func:`str` built-in function "
|
|
"and by the :keyword:`print` statement."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:160
|
|
msgid ""
|
|
"Compute a bytes representation of object *o*. In 2.x, this is just an alias "
|
|
"for :c:func:`PyObject_Str`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:168
|
|
msgid ""
|
|
"Compute a Unicode string representation of object *o*. Returns the Unicode "
|
|
"string representation on success, *NULL* on failure. This is the equivalent "
|
|
"of the Python expression ``unicode(o)``. Called by the :func:`unicode` "
|
|
"built-in function."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:176
|
|
msgid ""
|
|
"Returns ``1`` if *inst* is an instance of the class *cls* or a subclass of "
|
|
"*cls*, or ``0`` if not. On error, returns ``-1`` and sets an exception. If "
|
|
"*cls* is a type object rather than a class object, :c:func:"
|
|
"`PyObject_IsInstance` returns ``1`` if *inst* is of type *cls*. If *cls* is "
|
|
"a tuple, the check will be done against every entry in *cls*. The result "
|
|
"will be ``1`` when at least one of the checks returns ``1``, otherwise it "
|
|
"will be ``0``. If *inst* is not a class instance and *cls* is neither a type "
|
|
"object, nor a class object, nor a tuple, *inst* must have a :attr:`~instance."
|
|
"__class__` attribute --- the class relationship of the value of that "
|
|
"attribute with *cls* will be used to determine the result of this function."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:189
|
|
msgid "Support for a tuple as the second argument added."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:192
|
|
msgid ""
|
|
"Subclass determination is done in a fairly straightforward way, but includes "
|
|
"a wrinkle that implementors of extensions to the class system may want to be "
|
|
"aware of. If :class:`A` and :class:`B` are class objects, :class:`B` is a "
|
|
"subclass of :class:`A` if it inherits from :class:`A` either directly or "
|
|
"indirectly. If either is not a class object, a more general mechanism is "
|
|
"used to determine the class relationship of the two objects. When testing "
|
|
"if *B* is a subclass of *A*, if *A* is *B*, :c:func:`PyObject_IsSubclass` "
|
|
"returns true. If *A* and *B* are different objects, *B*'s :attr:`~class."
|
|
"__bases__` attribute is searched in a depth-first fashion for *A* --- the "
|
|
"presence of the :attr:`~class.__bases__` attribute is considered sufficient "
|
|
"for this determination."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:206
|
|
msgid ""
|
|
"Returns ``1`` if the class *derived* is identical to or derived from the "
|
|
"class *cls*, otherwise returns ``0``. In case of an error, returns ``-1``. "
|
|
"If *cls* is a tuple, the check will be done against every entry in *cls*. "
|
|
"The result will be ``1`` when at least one of the checks returns ``1``, "
|
|
"otherwise it will be ``0``. If either *derived* or *cls* is not an actual "
|
|
"class object (or tuple), this function uses the generic algorithm described "
|
|
"above."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:215
|
|
msgid ""
|
|
"Older versions of Python did not support a tuple as the second argument."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:221
|
|
msgid ""
|
|
"Determine if the object *o* is callable. Return ``1`` if the object is "
|
|
"callable and ``0`` otherwise. This function always succeeds."
|
|
msgstr ""
|
|
"Détermine si l'objet *o* est appelable. Renvoie ``1`` si c'est le cas, et "
|
|
"``0`` sinon. Cette fonction réussit toujours."
|
|
|
|
#: ../Doc/c-api/object.rst:229
|
|
msgid ""
|
|
"Call a callable Python object *callable_object*, with arguments given by the "
|
|
"tuple *args*, and named arguments given by the dictionary *kw*. If no named "
|
|
"arguments are needed, *kw* may be *NULL*. *args* must not be *NULL*, use an "
|
|
"empty tuple if no arguments are needed. Returns the result of the call on "
|
|
"success, or *NULL* on failure. This is the equivalent of the Python "
|
|
"expression ``apply(callable_object, args, kw)`` or ``callable_object(*args, "
|
|
"**kw)``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:243
|
|
msgid ""
|
|
"Call a callable Python object *callable_object*, with arguments given by the "
|
|
"tuple *args*. If no arguments are needed, then *args* may be *NULL*. "
|
|
"Returns the result of the call on success, or *NULL* on failure. This is "
|
|
"the equivalent of the Python expression ``apply(callable_object, args)`` or "
|
|
"``callable_object(*args)``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:254
|
|
msgid ""
|
|
"Call a callable Python object *callable*, with a variable number of C "
|
|
"arguments. The C arguments are described using a :c:func:`Py_BuildValue` "
|
|
"style format string. The format may be *NULL*, indicating that no arguments "
|
|
"are provided. Returns the result of the call on success, or *NULL* on "
|
|
"failure. This is the equivalent of the Python expression ``apply(callable, "
|
|
"args)`` or ``callable(*args)``. Note that if you only pass :c:type:`PyObject "
|
|
"\\*` args, :c:func:`PyObject_CallFunctionObjArgs` is a faster alternative."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:265
|
|
msgid ""
|
|
"Call the method named *method* of object *o* with a variable number of C "
|
|
"arguments. The C arguments are described by a :c:func:`Py_BuildValue` "
|
|
"format string that should produce a tuple. The format may be *NULL*, "
|
|
"indicating that no arguments are provided. Returns the result of the call on "
|
|
"success, or *NULL* on failure. This is the equivalent of the Python "
|
|
"expression ``o.method(args)``. Note that if you only pass :c:type:`PyObject "
|
|
"\\*` args, :c:func:`PyObject_CallMethodObjArgs` is a faster alternative."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:276
|
|
msgid ""
|
|
"Call a callable Python object *callable*, with a variable number of :c:type:"
|
|
"`PyObject\\*` arguments. The arguments are provided as a variable number of "
|
|
"parameters followed by *NULL*. Returns the result of the call on success, or "
|
|
"*NULL* on failure."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:286
|
|
msgid ""
|
|
"Calls a method of the object *o*, where the name of the method is given as a "
|
|
"Python string object in *name*. It is called with a variable number of :c:"
|
|
"type:`PyObject\\*` arguments. The arguments are provided as a variable "
|
|
"number of parameters followed by *NULL*. Returns the result of the call on "
|
|
"success, or *NULL* on failure."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:299
|
|
msgid ""
|
|
"Compute and return the hash value of an object *o*. On failure, return "
|
|
"``-1``. This is the equivalent of the Python expression ``hash(o)``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:305
|
|
msgid ""
|
|
"Set a :exc:`TypeError` indicating that ``type(o)`` is not hashable and "
|
|
"return ``-1``. This function receives special treatment when stored in a "
|
|
"``tp_hash`` slot, allowing a type to explicitly indicate to the interpreter "
|
|
"that it is not hashable."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:315
|
|
msgid ""
|
|
"Returns ``1`` if the object *o* is considered to be true, and ``0`` "
|
|
"otherwise. This is equivalent to the Python expression ``not not o``. On "
|
|
"failure, return ``-1``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:322
|
|
msgid ""
|
|
"Returns ``0`` if the object *o* is considered to be true, and ``1`` "
|
|
"otherwise. This is equivalent to the Python expression ``not o``. On "
|
|
"failure, return ``-1``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:331
|
|
msgid ""
|
|
"When *o* is non-*NULL*, returns a type object corresponding to the object "
|
|
"type of object *o*. On failure, raises :exc:`SystemError` and returns "
|
|
"*NULL*. This is equivalent to the Python expression ``type(o)``. This "
|
|
"function increments the reference count of the return value. There's really "
|
|
"no reason to use this function instead of the common expression ``o-"
|
|
">ob_type``, which returns a pointer of type :c:type:`PyTypeObject\\*`, "
|
|
"except when the incremented reference count is needed."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:342
|
|
msgid ""
|
|
"Return true if the object *o* is of type *type* or a subtype of *type*. "
|
|
"Both parameters must be non-*NULL*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:353
|
|
msgid ""
|
|
"Return the length of object *o*. If the object *o* provides either the "
|
|
"sequence and mapping protocols, the sequence length is returned. On error, "
|
|
"``-1`` is returned. This is the equivalent to the Python expression "
|
|
"``len(o)``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:357
|
|
msgid ""
|
|
"These functions returned an :c:type:`int` type. This might require changes "
|
|
"in your code for properly supporting 64-bit systems."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:364
|
|
msgid ""
|
|
"Return element of *o* corresponding to the object *key* or *NULL* on "
|
|
"failure. This is the equivalent of the Python expression ``o[key]``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:370
|
|
msgid ""
|
|
"Map the object *key* to the value *v*. Returns ``-1`` on failure. This is "
|
|
"the equivalent of the Python statement ``o[key] = v``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:376
|
|
msgid ""
|
|
"Delete the mapping for *key* from *o*. Returns ``-1`` on failure. This is "
|
|
"the equivalent of the Python statement ``del o[key]``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:382
|
|
msgid ""
|
|
"Derives a file descriptor from a Python object. If the object is an integer "
|
|
"or long integer, its value is returned. If not, the object's :meth:`fileno` "
|
|
"method is called if it exists; the method must return an integer or long "
|
|
"integer, which is returned as the file descriptor value. Returns ``-1`` on "
|
|
"failure."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:390
|
|
msgid ""
|
|
"This is equivalent to the Python expression ``dir(o)``, returning a "
|
|
"(possibly empty) list of strings appropriate for the object argument, or "
|
|
"*NULL* if there was an error. If the argument is *NULL*, this is like the "
|
|
"Python ``dir()``, returning the names of the current locals; in this case, "
|
|
"if no execution frame is active then *NULL* is returned but :c:func:"
|
|
"`PyErr_Occurred` will return false."
|
|
msgstr ""
|
|
|
|
#: ../Doc/c-api/object.rst:399
|
|
msgid ""
|
|
"This is equivalent to the Python expression ``iter(o)``. It returns a new "
|
|
"iterator for the object argument, or the object itself if the object is "
|
|
"already an iterator. Raises :exc:`TypeError` and returns *NULL* if the "
|
|
"object cannot be iterated."
|
|
msgstr ""
|