python-docs-fr/c-api/tuple.po

275 lines
7.8 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: 2020-08-24 09:01+0200\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/tuple.rst:6
msgid "Tuple Objects"
msgstr ""
#: c-api/tuple.rst:13
#, fuzzy
msgid "This subtype of :c:type:`PyObject` represents a Python tuple object."
msgstr ""
"Ce sous-type de :c:type:`PyObject` représente un objet ``bytearray`` Python."
#: c-api/tuple.rst:18
#, fuzzy
msgid ""
"This instance of :c:type:`PyTypeObject` represents the Python tuple type; it "
"is the same object as :class:`tuple` in the Python layer."
msgstr ""
"Cette instance de :c:type:`PyTypeObject` représente le type Python "
"*bytearray*, c'est le même que :class:`bytearray` côté Python."
#: c-api/tuple.rst:24
msgid ""
"Return true if *p* is a tuple object or an instance of a subtype of the "
"tuple type."
msgstr ""
#: c-api/tuple.rst:30
msgid ""
"Return true if *p* is a tuple object, but not an instance of a subtype of "
"the tuple type."
msgstr ""
#: c-api/tuple.rst:36
msgid "Return a new tuple object of size *len*, or ``NULL`` on failure."
msgstr ""
#: c-api/tuple.rst:41
msgid ""
"Return a new tuple object of size *n*, or ``NULL`` on failure. The tuple "
"values are initialized to the subsequent *n* C arguments pointing to Python "
"objects. ``PyTuple_Pack(2, a, b)`` is equivalent to "
"``Py_BuildValue(\"(OO)\", a, b)``."
msgstr ""
#: c-api/tuple.rst:48
msgid "Take a pointer to a tuple object, and return the size of that tuple."
msgstr ""
#: c-api/tuple.rst:53
msgid ""
"Return the size of the tuple *p*, which must be non-``NULL`` and point to a "
"tuple; no error checking is performed."
msgstr ""
#: c-api/tuple.rst:59
msgid ""
"Return the object at position *pos* in the tuple pointed to by *p*. If "
"*pos* is out of bounds, return ``NULL`` and set an :exc:`IndexError` "
"exception."
msgstr ""
#: c-api/tuple.rst:65
msgid "Like :c:func:`PyTuple_GetItem`, but does no checking of its arguments."
msgstr ""
#: c-api/tuple.rst:70
msgid ""
"Return the slice of the tuple pointed to by *p* between *low* and *high*, or "
"``NULL`` on failure. This is the equivalent of the Python expression "
"``p[low:high]``. Indexing from the end of the list is not supported."
msgstr ""
#: c-api/tuple.rst:77
msgid ""
"Insert a reference to object *o* at position *pos* of the tuple pointed to "
"by *p*. Return ``0`` on success. If *pos* is out of bounds, return ``-1`` "
"and set an :exc:`IndexError` exception."
msgstr ""
#: c-api/tuple.rst:83
msgid ""
"This function \"steals\" a reference to *o* and discards a reference to an "
"item already in the tuple at the affected position."
msgstr ""
#: c-api/tuple.rst:89
msgid ""
"Like :c:func:`PyTuple_SetItem`, but does no error checking, and should "
"*only* be used to fill in brand new tuples."
msgstr ""
#: c-api/tuple.rst:94
msgid ""
"This macro \"steals\" a reference to *o*, and, unlike :c:func:"
"`PyTuple_SetItem`, does *not* discard a reference to any item that is being "
"replaced; any reference in the tuple at position *pos* will be leaked."
msgstr ""
#: c-api/tuple.rst:102
msgid ""
"Can be used to resize a tuple. *newsize* will be the new length of the "
"tuple. Because tuples are *supposed* to be immutable, this should only be "
"used if there is only one reference to the object. Do *not* use this if the "
"tuple may already be known to some other part of the code. The tuple will "
"always grow or shrink at the end. Think of this as destroying the old tuple "
"and creating a new one, only more efficiently. Returns ``0`` on success. "
"Client code should never assume that the resulting value of ``*p`` will be "
"the same as before calling this function. If the object referenced by ``*p`` "
"is replaced, the original ``*p`` is destroyed. On failure, returns ``-1`` "
"and sets ``*p`` to ``NULL``, and raises :exc:`MemoryError` or :exc:"
"`SystemError`."
msgstr ""
#: c-api/tuple.rst:115
msgid "Struct Sequence Objects"
msgstr ""
#: c-api/tuple.rst:117
msgid ""
"Struct sequence objects are the C equivalent of :func:`~collections."
"namedtuple` objects, i.e. a sequence whose items can also be accessed "
"through attributes. To create a struct sequence, you first have to create a "
"specific struct sequence type."
msgstr ""
#: c-api/tuple.rst:124
msgid ""
"Create a new struct sequence type from the data in *desc*, described below. "
"Instances of the resulting type can be created with :c:func:"
"`PyStructSequence_New`."
msgstr ""
#: c-api/tuple.rst:130
msgid "Initializes a struct sequence type *type* from *desc* in place."
msgstr ""
#: c-api/tuple.rst:135
msgid ""
"The same as ``PyStructSequence_InitType``, but returns ``0`` on success and "
"``-1`` on failure."
msgstr ""
#: c-api/tuple.rst:143
msgid "Contains the meta information of a struct sequence type to create."
msgstr ""
#: c-api/tuple.rst:146 c-api/tuple.rst:169
msgid "Field"
msgstr "Champ"
#: c-api/tuple.rst:146 c-api/tuple.rst:169
msgid "C Type"
msgstr "Type C"
#: c-api/tuple.rst:146 c-api/tuple.rst:169
msgid "Meaning"
msgstr "Signification"
#: c-api/tuple.rst:148 c-api/tuple.rst:171
msgid "``name``"
msgstr "``name``"
#: c-api/tuple.rst:148 c-api/tuple.rst:150 c-api/tuple.rst:171
#: c-api/tuple.rst:176
msgid "``const char *``"
msgstr ""
#: c-api/tuple.rst:148
msgid "name of the struct sequence type"
msgstr ""
#: c-api/tuple.rst:150 c-api/tuple.rst:176
msgid "``doc``"
msgstr ""
#: c-api/tuple.rst:150
msgid "pointer to docstring for the type or ``NULL`` to omit"
msgstr ""
#: c-api/tuple.rst:153
msgid "``fields``"
msgstr ""
#: c-api/tuple.rst:153
msgid "``PyStructSequence_Field *``"
msgstr "``PyStructSequence_Field *``"
#: c-api/tuple.rst:153
msgid "pointer to ``NULL``-terminated array with field names of the new type"
msgstr ""
#: c-api/tuple.rst:156
msgid "``n_in_sequence``"
msgstr "``n_in_sequence``"
#: c-api/tuple.rst:156
msgid "``int``"
msgstr "``int``"
#: c-api/tuple.rst:156
msgid "number of fields visible to the Python side (if used as tuple)"
msgstr ""
#: c-api/tuple.rst:163
msgid ""
"Describes a field of a struct sequence. As a struct sequence is modeled as a "
"tuple, all fields are typed as :c:type:`PyObject*`. The index in the :attr:"
"`fields` array of the :c:type:`PyStructSequence_Desc` determines which field "
"of the struct sequence is described."
msgstr ""
#: c-api/tuple.rst:171
msgid ""
"name for the field or ``NULL`` to end the list of named fields, set to :c:"
"data:`PyStructSequence_UnnamedField` to leave unnamed"
msgstr ""
#: c-api/tuple.rst:176
msgid "field docstring or ``NULL`` to omit"
msgstr ""
#: c-api/tuple.rst:182
msgid "Special value for a field name to leave it unnamed."
msgstr ""
#: c-api/tuple.rst:184
msgid "The type was changed from ``char *``."
msgstr ""
#: c-api/tuple.rst:190
msgid ""
"Creates an instance of *type*, which must have been created with :c:func:"
"`PyStructSequence_NewType`."
msgstr ""
#: c-api/tuple.rst:196
msgid ""
"Return the object at position *pos* in the struct sequence pointed to by "
"*p*. No bounds checking is performed."
msgstr ""
#: c-api/tuple.rst:202
msgid "Macro equivalent of :c:func:`PyStructSequence_GetItem`."
msgstr ""
#: c-api/tuple.rst:207
msgid ""
"Sets the field at index *pos* of the struct sequence *p* to value *o*. "
"Like :c:func:`PyTuple_SET_ITEM`, this should only be used to fill in brand "
"new instances."
msgstr ""
#: c-api/tuple.rst:213 c-api/tuple.rst:222
msgid "This function \"steals\" a reference to *o*."
msgstr ""
#: c-api/tuple.rst:218
msgid "Macro equivalent of :c:func:`PyStructSequence_SetItem`."
msgstr ""