forked from AFPy/python-docs-fr
373 lines
12 KiB
Plaintext
373 lines
12 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: 2021-03-19 16:59+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"
|
||
|
||
#: library/gc.rst:2
|
||
msgid ":mod:`gc` --- Garbage Collector interface"
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:12
|
||
msgid ""
|
||
"This module provides an interface to the optional garbage collector. It "
|
||
"provides the ability to disable the collector, tune the collection "
|
||
"frequency, and set debugging options. It also provides access to "
|
||
"unreachable objects that the collector found but cannot free. Since the "
|
||
"collector supplements the reference counting already used in Python, you can "
|
||
"disable the collector if you are sure your program does not create reference "
|
||
"cycles. Automatic collection can be disabled by calling ``gc.disable()``. "
|
||
"To debug a leaking program call ``gc.set_debug(gc.DEBUG_LEAK)``. Notice that "
|
||
"this includes ``gc.DEBUG_SAVEALL``, causing garbage-collected objects to be "
|
||
"saved in gc.garbage for inspection."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:23
|
||
#, fuzzy
|
||
msgid "The :mod:`gc` module provides the following functions:"
|
||
msgstr "Le module :mod:`abc` fournit également la fonction suivante :"
|
||
|
||
#: library/gc.rst:28
|
||
msgid "Enable automatic garbage collection."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:33
|
||
msgid "Disable automatic garbage collection."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:38
|
||
msgid "Return ``True`` if automatic collection is enabled."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:43
|
||
msgid ""
|
||
"With no arguments, run a full collection. The optional argument "
|
||
"*generation* may be an integer specifying which generation to collect (from "
|
||
"0 to 2). A :exc:`ValueError` is raised if the generation number is "
|
||
"invalid. The number of unreachable objects found is returned."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:48
|
||
msgid ""
|
||
"The free lists maintained for a number of built-in types are cleared "
|
||
"whenever a full collection or collection of the highest generation (2) is "
|
||
"run. Not all items in some free lists may be freed due to the particular "
|
||
"implementation, in particular :class:`float`."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:56
|
||
msgid ""
|
||
"Set the garbage collection debugging flags. Debugging information will be "
|
||
"written to ``sys.stderr``. See below for a list of debugging flags which "
|
||
"can be combined using bit operations to control debugging."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:63
|
||
msgid "Return the debugging flags currently set."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:68
|
||
msgid ""
|
||
"Returns a list of all objects tracked by the collector, excluding the list "
|
||
"returned. If *generation* is not None, return only the objects tracked by "
|
||
"the collector that are in that generation."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:72
|
||
msgid "New *generation* parameter."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:75
|
||
msgid ""
|
||
"Raises an :ref:`auditing event <auditing>` ``gc.get_objects`` with argument "
|
||
"``generation``."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:79
|
||
msgid ""
|
||
"Return a list of three per-generation dictionaries containing collection "
|
||
"statistics since interpreter start. The number of keys may change in the "
|
||
"future, but currently each dictionary will contain the following items:"
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:84
|
||
msgid "``collections`` is the number of times this generation was collected;"
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:86
|
||
msgid ""
|
||
"``collected`` is the total number of objects collected inside this "
|
||
"generation;"
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:89
|
||
msgid ""
|
||
"``uncollectable`` is the total number of objects which were found to be "
|
||
"uncollectable (and were therefore moved to the :data:`garbage` list) inside "
|
||
"this generation."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:98
|
||
msgid ""
|
||
"Set the garbage collection thresholds (the collection frequency). Setting "
|
||
"*threshold0* to zero disables collection."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:101
|
||
msgid ""
|
||
"The GC classifies objects into three generations depending on how many "
|
||
"collection sweeps they have survived. New objects are placed in the "
|
||
"youngest generation (generation ``0``). If an object survives a collection "
|
||
"it is moved into the next older generation. Since generation ``2`` is the "
|
||
"oldest generation, objects in that generation remain there after a "
|
||
"collection. In order to decide when to run, the collector keeps track of "
|
||
"the number object allocations and deallocations since the last collection. "
|
||
"When the number of allocations minus the number of deallocations exceeds "
|
||
"*threshold0*, collection starts. Initially only generation ``0`` is "
|
||
"examined. If generation ``0`` has been examined more than *threshold1* "
|
||
"times since generation ``1`` has been examined, then generation ``1`` is "
|
||
"examined as well. With the third generation, things are a bit more "
|
||
"complicated, see `Collecting the oldest generation <https://devguide.python."
|
||
"org/garbage_collector/#collecting-the-oldest-generation>`_ for more "
|
||
"information."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:118
|
||
msgid ""
|
||
"Return the current collection counts as a tuple of ``(count0, count1, "
|
||
"count2)``."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:124
|
||
msgid ""
|
||
"Return the current collection thresholds as a tuple of ``(threshold0, "
|
||
"threshold1, threshold2)``."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:130
|
||
msgid ""
|
||
"Return the list of objects that directly refer to any of objs. This function "
|
||
"will only locate those containers which support garbage collection; "
|
||
"extension types which do refer to other objects but do not support garbage "
|
||
"collection will not be found."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:135
|
||
msgid ""
|
||
"Note that objects which have already been dereferenced, but which live in "
|
||
"cycles and have not yet been collected by the garbage collector can be "
|
||
"listed among the resulting referrers. To get only currently live objects, "
|
||
"call :func:`collect` before calling :func:`get_referrers`."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:141
|
||
msgid ""
|
||
"Care must be taken when using objects returned by :func:`get_referrers` "
|
||
"because some of them could still be under construction and hence in a "
|
||
"temporarily invalid state. Avoid using :func:`get_referrers` for any purpose "
|
||
"other than debugging."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:146
|
||
msgid ""
|
||
"Raises an :ref:`auditing event <auditing>` ``gc.get_referrers`` with "
|
||
"argument ``objs``."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:151
|
||
msgid ""
|
||
"Return a list of objects directly referred to by any of the arguments. The "
|
||
"referents returned are those objects visited by the arguments' C-level :c:"
|
||
"member:`~PyTypeObject.tp_traverse` methods (if any), and may not be all "
|
||
"objects actually directly reachable. :c:member:`~PyTypeObject.tp_traverse` "
|
||
"methods are supported only by objects that support garbage collection, and "
|
||
"are only required to visit objects that may be involved in a cycle. So, for "
|
||
"example, if an integer is directly reachable from an argument, that integer "
|
||
"object may or may not appear in the result list."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:159
|
||
msgid ""
|
||
"Raises an :ref:`auditing event <auditing>` ``gc.get_referents`` with "
|
||
"argument ``objs``."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:163
|
||
msgid ""
|
||
"Returns ``True`` if the object is currently tracked by the garbage "
|
||
"collector, ``False`` otherwise. As a general rule, instances of atomic "
|
||
"types aren't tracked and instances of non-atomic types (containers, user-"
|
||
"defined objects...) are. However, some type-specific optimizations can be "
|
||
"present in order to suppress the garbage collector footprint of simple "
|
||
"instances (e.g. dicts containing only atomic keys and values)::"
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:188
|
||
msgid ""
|
||
"Returns ``True`` if the given object has been finalized by the garbage "
|
||
"collector, ``False`` otherwise. ::"
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:209
|
||
msgid ""
|
||
"Freeze all the objects tracked by gc - move them to a permanent generation "
|
||
"and ignore all the future collections. This can be used before a POSIX "
|
||
"fork() call to make the gc copy-on-write friendly or to speed up collection. "
|
||
"Also collection before a POSIX fork() call may free pages for future "
|
||
"allocation which can cause copy-on-write too so it's advised to disable gc "
|
||
"in parent process and freeze before fork and enable gc in child process."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:221
|
||
msgid ""
|
||
"Unfreeze the objects in the permanent generation, put them back into the "
|
||
"oldest generation."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:229
|
||
msgid "Return the number of objects in the permanent generation."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:234
|
||
msgid ""
|
||
"The following variables are provided for read-only access (you can mutate "
|
||
"the values but should not rebind them):"
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:239
|
||
msgid ""
|
||
"A list of objects which the collector found to be unreachable but could not "
|
||
"be freed (uncollectable objects). Starting with Python 3.4, this list "
|
||
"should be empty most of the time, except when using instances of C extension "
|
||
"types with a non-``NULL`` ``tp_del`` slot."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:244
|
||
msgid ""
|
||
"If :const:`DEBUG_SAVEALL` is set, then all unreachable objects will be added "
|
||
"to this list rather than freed."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:247
|
||
msgid ""
|
||
"If this list is non-empty at :term:`interpreter shutdown`, a :exc:"
|
||
"`ResourceWarning` is emitted, which is silent by default. If :const:"
|
||
"`DEBUG_UNCOLLECTABLE` is set, in addition all uncollectable objects are "
|
||
"printed."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:253
|
||
msgid ""
|
||
"Following :pep:`442`, objects with a :meth:`__del__` method don't end up in :"
|
||
"attr:`gc.garbage` anymore."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:259
|
||
msgid ""
|
||
"A list of callbacks that will be invoked by the garbage collector before and "
|
||
"after collection. The callbacks will be called with two arguments, *phase* "
|
||
"and *info*."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:263
|
||
msgid "*phase* can be one of two values:"
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:265
|
||
msgid "\"start\": The garbage collection is about to start."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:267
|
||
msgid "\"stop\": The garbage collection has finished."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:269
|
||
msgid ""
|
||
"*info* is a dict providing more information for the callback. The following "
|
||
"keys are currently defined:"
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:272
|
||
msgid "\"generation\": The oldest generation being collected."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:274
|
||
msgid ""
|
||
"\"collected\": When *phase* is \"stop\", the number of objects successfully "
|
||
"collected."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:277
|
||
msgid ""
|
||
"\"uncollectable\": When *phase* is \"stop\", the number of objects that "
|
||
"could not be collected and were put in :data:`garbage`."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:280
|
||
msgid ""
|
||
"Applications can add their own callbacks to this list. The primary use "
|
||
"cases are:"
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:283
|
||
msgid ""
|
||
"Gathering statistics about garbage collection, such as how often various "
|
||
"generations are collected, and how long the collection takes."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:287
|
||
msgid ""
|
||
"Allowing applications to identify and clear their own uncollectable types "
|
||
"when they appear in :data:`garbage`."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:293
|
||
msgid "The following constants are provided for use with :func:`set_debug`:"
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:298
|
||
msgid ""
|
||
"Print statistics during collection. This information can be useful when "
|
||
"tuning the collection frequency."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:304
|
||
msgid "Print information on collectable objects found."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:309
|
||
msgid ""
|
||
"Print information of uncollectable objects found (objects which are not "
|
||
"reachable but cannot be freed by the collector). These objects will be "
|
||
"added to the ``garbage`` list."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:313
|
||
msgid ""
|
||
"Also print the contents of the :data:`garbage` list at :term:`interpreter "
|
||
"shutdown`, if it isn't empty."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:319
|
||
msgid ""
|
||
"When set, all unreachable objects found will be appended to *garbage* rather "
|
||
"than being freed. This can be useful for debugging a leaking program."
|
||
msgstr ""
|
||
|
||
#: library/gc.rst:325
|
||
msgid ""
|
||
"The debugging flags necessary for the collector to print information about a "
|
||
"leaking program (equal to ``DEBUG_COLLECTABLE | DEBUG_UNCOLLECTABLE | "
|
||
"DEBUG_SAVEALL``)."
|
||
msgstr ""
|