forked from AFPy/python-docs-fr
258 lines
9.6 KiB
Plaintext
258 lines
9.6 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/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 ""
|