python-docs-fr/library/gc.po

# 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/library/gc.rst:3
msgid ":mod:`gc` --- Garbage Collector interface"
msgstr ""

#: ../Doc/library/gc.rst:11
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 ""

#: ../Doc/library/gc.rst:22
msgid "The :mod:`gc` module provides the following functions:"
msgstr ""

#: ../Doc/library/gc.rst:27
msgid "Enable automatic garbage collection."
msgstr ""

#: ../Doc/library/gc.rst:32
msgid "Disable automatic garbage collection."
msgstr ""

#: ../Doc/library/gc.rst:37
msgid "Returns true if automatic collection is enabled."
msgstr ""

#: ../Doc/library/gc.rst:42
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 ""

#: ../Doc/library/gc.rst:47
msgid "The optional *generation* argument was added."
msgstr ""

#: ../Doc/library/gc.rst:50
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:`int` and :class:`float`."
msgstr ""

#: ../Doc/library/gc.rst:59
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 ""

#: ../Doc/library/gc.rst:66
msgid "Return the debugging flags currently set."
msgstr ""

#: ../Doc/library/gc.rst:71
msgid ""
"Returns a list of all objects tracked by the collector, excluding the list "
"returned."
msgstr ""

#: ../Doc/library/gc.rst:79
msgid ""
"Set the garbage collection thresholds (the collection frequency). Setting "
"*threshold0* to zero disables collection."
msgstr ""

#: ../Doc/library/gc.rst:82
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.  Similarly, *threshold2* controls the number of "
"collections of generation ``1`` before collecting generation ``2``."
msgstr ""

#: ../Doc/library/gc.rst:99
msgid ""
"Return the current collection  counts as a tuple of ``(count0, count1, "
"count2)``."
msgstr ""

#: ../Doc/library/gc.rst:107
msgid ""
"Return the current collection thresholds as a tuple of ``(threshold0, "
"threshold1, threshold2)``."
msgstr ""

#: ../Doc/library/gc.rst:113
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 ""

#: ../Doc/library/gc.rst:118
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 ""

#: ../Doc/library/gc.rst:123
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 ""

#: ../Doc/library/gc.rst:133
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 ""

#: ../Doc/library/gc.rst:145
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 ""

#: ../Doc/library/gc.rst:168
msgid ""
"The following variable is provided for read-only access (you can mutate its "
"value but should not rebind it):"
msgstr ""

#: ../Doc/library/gc.rst:174
msgid ""
"A list of objects which the collector found to be unreachable but could not "
"be freed (uncollectable objects).  By default, this list contains only "
"objects with :meth:`__del__` methods. [#]_ Objects that have :meth:`__del__` "
"methods and are part of a reference cycle cause the entire reference cycle "
"to be uncollectable, including objects not necessarily in the cycle but "
"reachable only from it. Python doesn't collect such cycles automatically "
"because, in general, it isn't possible for Python to guess a safe order in "
"which to run the :meth:`__del__` methods.  If you know a safe order, you can "
"force the issue by examining the *garbage* list, and explicitly breaking "
"cycles due to your objects within the list.  Note that these objects are "
"kept alive even so by virtue of being in the *garbage* list, so they should "
"be removed from *garbage* too.  For example, after breaking cycles, do ``del "
"gc.garbage[:]`` to empty the list.  It's generally better to avoid the issue "
"by not creating cycles containing objects with :meth:`__del__` methods, and "
"*garbage* can be examined in that case to verify that no such cycles are "
"being created."
msgstr ""

#: ../Doc/library/gc.rst:190
msgid ""
"If :const:`DEBUG_SAVEALL` is set, then all unreachable objects will be added "
"to this list rather than freed."
msgstr ""

#: ../Doc/library/gc.rst:193
msgid "The following constants are provided for use with :func:`set_debug`:"
msgstr ""

#: ../Doc/library/gc.rst:198
msgid ""
"Print statistics during collection.  This information can be useful when "
"tuning the collection frequency."
msgstr ""

#: ../Doc/library/gc.rst:204
msgid "Print information on collectable objects found."
msgstr ""

#: ../Doc/library/gc.rst:209
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 ""

#: ../Doc/library/gc.rst:216
msgid ""
"When :const:`DEBUG_COLLECTABLE` or :const:`DEBUG_UNCOLLECTABLE` is set, "
"print information about instance objects found."
msgstr ""

#: ../Doc/library/gc.rst:222
msgid ""
"When :const:`DEBUG_COLLECTABLE` or :const:`DEBUG_UNCOLLECTABLE` is set, "
"print information about objects other than instance objects found."
msgstr ""

#: ../Doc/library/gc.rst:228
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 ""

#: ../Doc/library/gc.rst:234
msgid ""
"The debugging flags necessary for the collector to print information about a "
"leaking program (equal to ``DEBUG_COLLECTABLE | DEBUG_UNCOLLECTABLE | "
"DEBUG_INSTANCES | DEBUG_OBJECTS | DEBUG_SAVEALL``)."
msgstr ""

#: ../Doc/library/gc.rst:239
msgid "Footnotes"
msgstr "Notes"

#: ../Doc/library/gc.rst:240
msgid ""
"Prior to Python 2.2, the list contained all instance objects in unreachable "
"cycles,  not only those with :meth:`__del__` methods."
msgstr ""