forked from AFPy/python-docs-fr
455 lines
15 KiB
Plaintext
455 lines
15 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2001-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 3.5\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2016-10-30 10:42+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/library/collections.abc.rst:2
|
|
msgid ":mod:`collections.abc` --- Abstract Base Classes for Containers"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:10
|
|
msgid "Formerly, this module was part of the :mod:`collections` module."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:13
|
|
msgid "**Source code:** :source:`Lib/_collections_abc.py`"
|
|
msgstr "**Code source :** :source:`Lib/_collections_abc.py`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:23
|
|
msgid ""
|
|
"This module provides :term:`abstract base classes <abstract base class>` "
|
|
"that can be used to test whether a class provides a particular interface; "
|
|
"for example, whether it is hashable or whether it is a mapping."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:31
|
|
msgid "Collections Abstract Base Classes"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:33
|
|
msgid ""
|
|
"The collections module offers the following :term:`ABCs <abstract base "
|
|
"class>`:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:38
|
|
msgid "ABC"
|
|
msgstr "ABC"
|
|
|
|
#: ../Doc/library/collections.abc.rst:38
|
|
msgid "Inherits from"
|
|
msgstr "Hérite de"
|
|
|
|
#: ../Doc/library/collections.abc.rst:38
|
|
msgid "Abstract Methods"
|
|
msgstr "Méthodes abstraites"
|
|
|
|
#: ../Doc/library/collections.abc.rst:38
|
|
msgid "Mixin Methods"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:40
|
|
msgid ":class:`Container`"
|
|
msgstr ":class:`Container`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:40
|
|
msgid "``__contains__``"
|
|
msgstr "``__contains__``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:41
|
|
msgid ":class:`Hashable`"
|
|
msgstr ":class:`Hashable`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:41
|
|
msgid "``__hash__``"
|
|
msgstr "``__hash__``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:42 ../Doc/library/collections.abc.rst:43
|
|
msgid ":class:`Iterable`"
|
|
msgstr ":class:`Iterable`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:42 ../Doc/library/collections.abc.rst:43
|
|
msgid "``__iter__``"
|
|
msgstr "``__iter__``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:43 ../Doc/library/collections.abc.rst:44
|
|
msgid ":class:`Iterator`"
|
|
msgstr ":class:`Iterator`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:43
|
|
msgid "``__next__``"
|
|
msgstr "``__next__``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:44
|
|
msgid ":class:`Generator`"
|
|
msgstr ":class:`Generator`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:44 ../Doc/library/collections.abc.rst:89
|
|
msgid "``send``, ``throw``"
|
|
msgstr "``send``, ``throw``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:44
|
|
msgid "``close``, ``__iter__``, ``__next__``"
|
|
msgstr "``close``, ``__iter__``, ``__next__``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:45 ../Doc/library/collections.abc.rst:82
|
|
msgid ":class:`Sized`"
|
|
msgstr ":class:`Sized`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:45 ../Doc/library/collections.abc.rst:82
|
|
msgid "``__len__``"
|
|
msgstr "``__len__``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:46
|
|
msgid ":class:`Callable`"
|
|
msgstr ":class:`Callable`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:46
|
|
msgid "``__call__``"
|
|
msgstr "``__call__``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:48 ../Doc/library/collections.abc.rst:52
|
|
#: ../Doc/library/collections.abc.rst:58
|
|
msgid ":class:`Sequence`"
|
|
msgstr ":class:`Sequence`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:48 ../Doc/library/collections.abc.rst:61
|
|
#: ../Doc/library/collections.abc.rst:71
|
|
msgid ":class:`Sized`, :class:`Iterable`, :class:`Container`"
|
|
msgstr ":class:`Sized`, :class:`Iterable`, :class:`Container`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:48 ../Doc/library/collections.abc.rst:58
|
|
msgid "``__getitem__``, ``__len__``"
|
|
msgstr "``__getitem__``, ``__len__``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:48
|
|
msgid ""
|
|
"``__contains__``, ``__iter__``, ``__reversed__``, ``index``, and ``count``"
|
|
msgstr ""
|
|
"``__contains__``, ``__iter__``, ``__reversed__``, ``index``, and ``count``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:52
|
|
msgid ":class:`MutableSequence`"
|
|
msgstr ":class:`MutableSequence`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:52
|
|
msgid ""
|
|
"``__getitem__``, ``__setitem__``, ``__delitem__``, ``__len__``, ``insert``"
|
|
msgstr ""
|
|
"``__getitem__``, ``__setitem__``, ``__delitem__``, ``__len__``, ``insert``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:52
|
|
msgid ""
|
|
"Inherited :class:`Sequence` methods and ``append``, ``reverse``, ``extend``, "
|
|
"``pop``, ``remove``, and ``__iadd__``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:58
|
|
msgid ":class:`ByteString`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:58
|
|
msgid "Inherited :class:`Sequence` methods"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:61 ../Doc/library/collections.abc.rst:65
|
|
msgid ":class:`Set`"
|
|
msgstr ":class:`Set`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:61
|
|
msgid "``__contains__``, ``__iter__``, ``__len__``"
|
|
msgstr "``__contains__``, ``__iter__``, ``__len__``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:61
|
|
msgid ""
|
|
"``__le__``, ``__lt__``, ``__eq__``, ``__ne__``, ``__gt__``, ``__ge__``, "
|
|
"``__and__``, ``__or__``, ``__sub__``, ``__xor__``, and ``isdisjoint``"
|
|
msgstr ""
|
|
"``__le__``, ``__lt__``, ``__eq__``, ``__ne__``, ``__gt__``, ``__ge__``, "
|
|
"``__and__``, ``__or__``, ``__sub__``, ``__xor__``, and ``isdisjoint``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:65
|
|
msgid ":class:`MutableSet`"
|
|
msgstr ":class:`MutableSet`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:65
|
|
msgid "``__contains__``, ``__iter__``, ``__len__``, ``add``, ``discard``"
|
|
msgstr "``__contains__``, ``__iter__``, ``__len__``, ``add``, ``discard``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:65
|
|
msgid ""
|
|
"Inherited :class:`Set` methods and ``clear``, ``pop``, ``remove``, "
|
|
"``__ior__``, ``__iand__``, ``__ixor__``, and ``__isub__``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:71 ../Doc/library/collections.abc.rst:75
|
|
msgid ":class:`Mapping`"
|
|
msgstr ":class:`Mapping`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:71
|
|
msgid "``__getitem__``, ``__iter__``, ``__len__``"
|
|
msgstr "``__getitem__``, ``__iter__``, ``__len__``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:71
|
|
msgid ""
|
|
"``__contains__``, ``keys``, ``items``, ``values``, ``get``, ``__eq__``, and "
|
|
"``__ne__``"
|
|
msgstr ""
|
|
"``__contains__``, ``keys``, ``items``, ``values``, ``get``, ``__eq__``, and "
|
|
"``__ne__``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:75
|
|
msgid ":class:`MutableMapping`"
|
|
msgstr ":class:`MutableMapping`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:75
|
|
msgid ""
|
|
"``__getitem__``, ``__setitem__``, ``__delitem__``, ``__iter__``, ``__len__``"
|
|
msgstr ""
|
|
"``__getitem__``, ``__setitem__``, ``__delitem__``, ``__iter__``, ``__len__``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:75
|
|
msgid ""
|
|
"Inherited :class:`Mapping` methods and ``pop``, ``popitem``, ``clear``, "
|
|
"``update``, and ``setdefault``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:82 ../Doc/library/collections.abc.rst:87
|
|
msgid ":class:`MappingView`"
|
|
msgstr ":class:`MappingView`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:83
|
|
msgid ":class:`ItemsView`"
|
|
msgstr ":class:`ItemsView`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:83 ../Doc/library/collections.abc.rst:85
|
|
msgid ":class:`MappingView`, :class:`Set`"
|
|
msgstr ":class:`MappingView`, :class:`Set`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:83 ../Doc/library/collections.abc.rst:85
|
|
#: ../Doc/library/collections.abc.rst:87
|
|
msgid "``__contains__``, ``__iter__``"
|
|
msgstr "``__contains__``, ``__iter__``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:85
|
|
msgid ":class:`KeysView`"
|
|
msgstr ":class:`KeysView`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:87
|
|
msgid ":class:`ValuesView`"
|
|
msgstr ":class:`ValuesView`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:88 ../Doc/library/collections.abc.rst:89
|
|
msgid ":class:`Awaitable`"
|
|
msgstr ":class:`Awaitable`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:88
|
|
msgid "``__await__``"
|
|
msgstr "``__await__``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:89
|
|
msgid ":class:`Coroutine`"
|
|
msgstr ":class:`Coroutine`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:89
|
|
msgid "``close``"
|
|
msgstr "``close``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:90 ../Doc/library/collections.abc.rst:91
|
|
msgid ":class:`AsyncIterable`"
|
|
msgstr ":class:`AsyncIterable`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:90 ../Doc/library/collections.abc.rst:91
|
|
msgid "``__aiter__``"
|
|
msgstr "``__aiter__``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:91
|
|
msgid ":class:`AsyncIterator`"
|
|
msgstr ":class:`AsyncIterator`"
|
|
|
|
#: ../Doc/library/collections.abc.rst:91
|
|
msgid "``__anext__``"
|
|
msgstr "``__anext__``"
|
|
|
|
#: ../Doc/library/collections.abc.rst:100
|
|
msgid ""
|
|
"ABCs for classes that provide respectively the methods :meth:"
|
|
"`__contains__`, :meth:`__hash__`, :meth:`__len__`, and :meth:`__call__`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:105
|
|
msgid ""
|
|
"ABC for classes that provide the :meth:`__iter__` method. See also the "
|
|
"definition of :term:`iterable`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:110
|
|
msgid ""
|
|
"ABC for classes that provide the :meth:`~iterator.__iter__` and :meth:"
|
|
"`~iterator.__next__` methods. See also the definition of :term:`iterator`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:116
|
|
msgid ""
|
|
"ABC for generator classes that implement the protocol defined in :pep:`342` "
|
|
"that extends iterators with the :meth:`~generator.send`, :meth:`~generator."
|
|
"throw` and :meth:`~generator.close` methods. See also the definition of :"
|
|
"term:`generator`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:127
|
|
msgid "ABCs for read-only and mutable :term:`sequences <sequence>`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:129
|
|
msgid ""
|
|
"Implementation note: Some of the mixin methods, such as :meth:`__iter__`, :"
|
|
"meth:`__reversed__` and :meth:`index`, make repeated calls to the "
|
|
"underlying :meth:`__getitem__` method. Consequently, if :meth:`__getitem__` "
|
|
"is implemented with constant access speed, the mixin methods will have "
|
|
"linear performance; however, if the underlying method is linear (as it would "
|
|
"be with a linked list), the mixins will have quadratic performance and will "
|
|
"likely need to be overridden."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:138
|
|
msgid "The index() method added support for *stop* and *start* arguments."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:145
|
|
msgid "ABCs for read-only and mutable sets."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:150
|
|
msgid "ABCs for read-only and mutable :term:`mappings <mapping>`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:157
|
|
msgid ""
|
|
"ABCs for mapping, items, keys, and values :term:`views <dictionary view>`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:161
|
|
msgid ""
|
|
"ABC for :term:`awaitable` objects, which can be used in :keyword:`await` "
|
|
"expressions. Custom implementations must provide the :meth:`__await__` "
|
|
"method."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:165
|
|
msgid ""
|
|
":term:`Coroutine` objects and instances of the :class:`~collections.abc."
|
|
"Coroutine` ABC are all instances of this ABC."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:169
|
|
msgid ""
|
|
"In CPython, generator-based coroutines (generators decorated with :func:"
|
|
"`types.coroutine` or :func:`asyncio.coroutine`) are *awaitables*, even "
|
|
"though they do not have an :meth:`__await__` method. Using "
|
|
"``isinstance(gencoro, Awaitable)`` for them will return ``False``. Use :func:"
|
|
"`inspect.isawaitable` to detect them."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:179
|
|
msgid ""
|
|
"ABC for coroutine compatible classes. These implement the following "
|
|
"methods, defined in :ref:`coroutine-objects`: :meth:`~coroutine.send`, :meth:"
|
|
"`~coroutine.throw`, and :meth:`~coroutine.close`. Custom implementations "
|
|
"must also implement :meth:`__await__`. All :class:`Coroutine` instances are "
|
|
"also instances of :class:`Awaitable`. See also the definition of :term:"
|
|
"`coroutine`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:187
|
|
msgid ""
|
|
"In CPython, generator-based coroutines (generators decorated with :func:"
|
|
"`types.coroutine` or :func:`asyncio.coroutine`) are *awaitables*, even "
|
|
"though they do not have an :meth:`__await__` method. Using "
|
|
"``isinstance(gencoro, Coroutine)`` for them will return ``False``. Use :func:"
|
|
"`inspect.isawaitable` to detect them."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:197
|
|
msgid ""
|
|
"ABC for classes that provide ``__aiter__`` method. See also the definition "
|
|
"of :term:`asynchronous iterable`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:204
|
|
msgid ""
|
|
"ABC for classes that provide ``__aiter__`` and ``__anext__`` methods. See "
|
|
"also the definition of :term:`asynchronous iterator`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:210
|
|
msgid ""
|
|
"These ABCs allow us to ask classes or instances if they provide particular "
|
|
"functionality, for example::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:217
|
|
msgid ""
|
|
"Several of the ABCs are also useful as mixins that make it easier to develop "
|
|
"classes supporting container APIs. For example, to write a class supporting "
|
|
"the full :class:`Set` API, it is only necessary to supply the three "
|
|
"underlying abstract methods: :meth:`__contains__`, :meth:`__iter__`, and :"
|
|
"meth:`__len__`. The ABC supplies the remaining methods such as :meth:"
|
|
"`__and__` and :meth:`isdisjoint`::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:246
|
|
msgid "Notes on using :class:`Set` and :class:`MutableSet` as a mixin:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:249
|
|
msgid ""
|
|
"Since some set operations create new sets, the default mixin methods need a "
|
|
"way to create new instances from an iterable. The class constructor is "
|
|
"assumed to have a signature in the form ``ClassName(iterable)``. That "
|
|
"assumption is factored-out to an internal classmethod called :meth:"
|
|
"`_from_iterable` which calls ``cls(iterable)`` to produce a new set. If the :"
|
|
"class:`Set` mixin is being used in a class with a different constructor "
|
|
"signature, you will need to override :meth:`_from_iterable` with a "
|
|
"classmethod that can construct new instances from an iterable argument."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:260
|
|
msgid ""
|
|
"To override the comparisons (presumably for speed, as the semantics are "
|
|
"fixed), redefine :meth:`__le__` and :meth:`__ge__`, then the other "
|
|
"operations will automatically follow suit."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:265
|
|
msgid ""
|
|
"The :class:`Set` mixin provides a :meth:`_hash` method to compute a hash "
|
|
"value for the set; however, :meth:`__hash__` is not defined because not all "
|
|
"sets are hashable or immutable. To add set hashability using mixins, "
|
|
"inherit from both :meth:`Set` and :meth:`Hashable`, then define ``__hash__ = "
|
|
"Set._hash``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:273
|
|
msgid ""
|
|
"`OrderedSet recipe <https://code.activestate.com/recipes/576694/>`_ for an "
|
|
"example built on :class:`MutableSet`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/collections.abc.rst:276
|
|
msgid "For more about ABCs, see the :mod:`abc` module and :pep:`3119`."
|
|
msgstr ""
|