# 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: 2022-03-23 18:39+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: FRENCH \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: library/dbm.rst:2 msgid ":mod:`dbm` --- Interfaces to Unix \"databases\"" msgstr "" #: library/dbm.rst:7 #, fuzzy msgid "**Source code:** :source:`Lib/dbm/__init__.py`" msgstr "**Source code:** :source:`Lib/html/__init__.py`" #: library/dbm.rst:11 msgid "" ":mod:`dbm` is a generic interface to variants of the DBM database --- :mod:" "`dbm.gnu` or :mod:`dbm.ndbm`. If none of these modules is installed, the " "slow-but-simple implementation in module :mod:`dbm.dumb` will be used. " "There is a `third party interface `_ to the Oracle Berkeley DB." msgstr "" #: library/dbm.rst:20 msgid "" "A tuple containing the exceptions that can be raised by each of the " "supported modules, with a unique exception also named :exc:`dbm.error` as " "the first item --- the latter is used when :exc:`dbm.error` is raised." msgstr "" #: library/dbm.rst:27 msgid "" "This function attempts to guess which of the several simple database modules " "available --- :mod:`dbm.gnu`, :mod:`dbm.ndbm` or :mod:`dbm.dumb` --- should " "be used to open a given file." msgstr "" #: library/dbm.rst:31 msgid "" "Returns one of the following values: ``None`` if the file can't be opened " "because it's unreadable or doesn't exist; the empty string (``''``) if the " "file's format can't be guessed; or a string containing the required module " "name, such as ``'dbm.ndbm'`` or ``'dbm.gnu'``." msgstr "" #: library/dbm.rst:210 library/dbm.rst:393 msgid "Accepts :term:`path-like object` for filename." msgstr "" #: library/dbm.rst:41 msgid "Open the database file *file* and return a corresponding object." msgstr "" #: library/dbm.rst:43 msgid "" "If the database file already exists, the :func:`whichdb` function is used to " "determine its type and the appropriate module is used; if it does not exist, " "the first module listed above that can be imported is used." msgstr "" #: library/dbm.rst:166 library/dbm.rst:357 msgid "The optional *flag* argument can be:" msgstr "" #: library/dbm.rst:169 library/dbm.rst:287 library/dbm.rst:360 msgid "Value" msgstr "Valeur" #: library/dbm.rst:169 library/dbm.rst:287 library/dbm.rst:360 msgid "Meaning" msgstr "Signification" #: library/dbm.rst:171 library/dbm.rst:362 msgid "``'r'``" msgstr "``'r'``" #: library/dbm.rst:171 library/dbm.rst:362 msgid "Open existing database for reading only (default)" msgstr "" #: library/dbm.rst:174 library/dbm.rst:365 msgid "``'w'``" msgstr "``'w'``" #: library/dbm.rst:174 library/dbm.rst:365 msgid "Open existing database for reading and writing" msgstr "" #: library/dbm.rst:177 library/dbm.rst:368 msgid "``'c'``" msgstr "``'c'``" #: library/dbm.rst:177 library/dbm.rst:368 msgid "Open database for reading and writing, creating it if it doesn't exist" msgstr "" #: library/dbm.rst:180 library/dbm.rst:371 msgid "``'n'``" msgstr "``'n'``" #: library/dbm.rst:180 library/dbm.rst:371 msgid "Always create a new, empty database, open for reading and writing" msgstr "" #: library/dbm.rst:302 library/dbm.rst:375 msgid "" "The optional *mode* argument is the Unix mode of the file, used only when " "the database has to be created. It defaults to octal ``0o666`` (and will be " "modified by the prevailing umask)." msgstr "" #: library/dbm.rst:70 msgid "" "The object returned by :func:`.open` supports the same basic functionality " "as dictionaries; keys and their corresponding values can be stored, " "retrieved, and deleted, and the :keyword:`in` operator and the :meth:`keys` " "method are available, as well as :meth:`get` and :meth:`setdefault`." msgstr "" #: library/dbm.rst:75 msgid "" ":meth:`get` and :meth:`setdefault` are now available in all database modules." msgstr "" #: library/dbm.rst:78 msgid "" "Deleting a key from a read-only database raises database module specific " "error instead of :exc:`KeyError`." msgstr "" #: library/dbm.rst:82 msgid "Accepts :term:`path-like object` for file." msgstr "" #: library/dbm.rst:85 msgid "" "Key and values are always stored as bytes. This means that when strings are " "used they are implicitly converted to the default encoding before being " "stored." msgstr "" #: library/dbm.rst:89 msgid "" "These objects also support being used in a :keyword:`with` statement, which " "will automatically close them when done." msgstr "" #: library/dbm.rst:92 msgid "" "Added native support for the context management protocol to the objects " "returned by :func:`.open`." msgstr "" #: library/dbm.rst:96 msgid "" "The following example records some hostnames and a corresponding title, and " "then prints out the contents of the database::" msgstr "" #: library/dbm.rst:126 msgid "Module :mod:`shelve`" msgstr "" #: library/dbm.rst:127 msgid "Persistence module which stores non-string data." msgstr "" #: library/dbm.rst:130 msgid "The individual submodules are described in the following sections." msgstr "" #: library/dbm.rst:134 msgid ":mod:`dbm.gnu` --- GNU's reinterpretation of dbm" msgstr "" #: library/dbm.rst:140 #, fuzzy msgid "**Source code:** :source:`Lib/dbm/gnu.py`" msgstr "**Code source :** :source:`Lib/bdb.py`" #: library/dbm.rst:144 msgid "" "This module is quite similar to the :mod:`dbm` module, but uses the GNU " "library ``gdbm`` instead to provide some additional functionality. Please " "note that the file formats created by :mod:`dbm.gnu` and :mod:`dbm.ndbm` are " "incompatible." msgstr "" #: library/dbm.rst:148 msgid "" "The :mod:`dbm.gnu` module provides an interface to the GNU DBM library. " "``dbm.gnu.gdbm`` objects behave like mappings (dictionaries), except that " "keys and values are always converted to bytes before storing. Printing a " "``gdbm`` object doesn't print the keys and values, and the :meth:`items` " "and :meth:`values` methods are not supported." msgstr "" #: library/dbm.rst:157 msgid "" "Raised on :mod:`dbm.gnu`-specific errors, such as I/O errors. :exc:" "`KeyError` is raised for general mapping errors like specifying an incorrect " "key." msgstr "" #: library/dbm.rst:163 msgid "" "Open a ``gdbm`` database and return a :class:`gdbm` object. The *filename* " "argument is the name of the database file." msgstr "" #: library/dbm.rst:184 msgid "" "The following additional characters may be appended to the flag to control " "how the database is opened:" msgstr "" #: library/dbm.rst:190 msgid "``'f'``" msgstr "``'f'``" #: library/dbm.rst:190 msgid "" "Open the database in fast mode. Writes to the database will not be " "synchronized." msgstr "" #: library/dbm.rst:193 msgid "``'s'``" msgstr "``'s'``" #: library/dbm.rst:193 msgid "" "Synchronized mode. This will cause changes to the database to be immediately " "written to the file." msgstr "" #: library/dbm.rst:197 msgid "``'u'``" msgstr "``'u'``" #: library/dbm.rst:197 msgid "Do not lock database." msgstr "" #: library/dbm.rst:200 msgid "" "Not all flags are valid for all versions of ``gdbm``. The module constant :" "const:`open_flags` is a string of supported flag characters. The exception :" "exc:`error` is raised if an invalid flag is specified." msgstr "" #: library/dbm.rst:204 msgid "" "The optional *mode* argument is the Unix mode of the file, used only when " "the database has to be created. It defaults to octal ``0o666``." msgstr "" #: library/dbm.rst:207 msgid "" "In addition to the dictionary-like methods, ``gdbm`` objects have the " "following methods:" msgstr "" #: library/dbm.rst:215 msgid "" "It's possible to loop over every key in the database using this method and " "the :meth:`nextkey` method. The traversal is ordered by ``gdbm``'s internal " "hash values, and won't be sorted by the key values. This method returns the " "starting key." msgstr "" #: library/dbm.rst:222 msgid "" "Returns the key that follows *key* in the traversal. The following code " "prints every key in the database ``db``, without having to create a list in " "memory that contains them all::" msgstr "" #: library/dbm.rst:233 msgid "" "If you have carried out a lot of deletions and would like to shrink the " "space used by the ``gdbm`` file, this routine will reorganize the database. " "``gdbm`` objects will not shorten the length of a database file except by " "using this reorganization; otherwise, deleted file space will be kept and " "reused as new (key, value) pairs are added." msgstr "" #: library/dbm.rst:241 msgid "" "When the database has been opened in fast mode, this method forces any " "unwritten data to be written to the disk." msgstr "" #: library/dbm.rst:246 msgid "Close the ``gdbm`` database." msgstr "" #: library/dbm.rst:249 msgid ":mod:`dbm.ndbm` --- Interface based on ndbm" msgstr "" #: library/dbm.rst:255 #, fuzzy msgid "**Source code:** :source:`Lib/dbm/ndbm.py`" msgstr "**Code source :** :source:`Lib/bdb.py`" #: library/dbm.rst:259 msgid "" "The :mod:`dbm.ndbm` module provides an interface to the Unix \"(n)dbm\" " "library. Dbm objects behave like mappings (dictionaries), except that keys " "and values are always stored as bytes. Printing a ``dbm`` object doesn't " "print the keys and values, and the :meth:`items` and :meth:`values` methods " "are not supported." msgstr "" #: library/dbm.rst:264 msgid "" "This module can be used with the \"classic\" ndbm interface or the GNU GDBM " "compatibility interface. On Unix, the :program:`configure` script will " "attempt to locate the appropriate header file to simplify building this " "module." msgstr "" #: library/dbm.rst:270 msgid "" "Raised on :mod:`dbm.ndbm`-specific errors, such as I/O errors. :exc:" "`KeyError` is raised for general mapping errors like specifying an incorrect " "key." msgstr "" #: library/dbm.rst:276 msgid "Name of the ``ndbm`` implementation library used." msgstr "" #: library/dbm.rst:281 msgid "" "Open a dbm database and return a ``ndbm`` object. The *filename* argument " "is the name of the database file (without the :file:`.dir` or :file:`.pag` " "extensions)." msgstr "" #: library/dbm.rst:284 msgid "The optional *flag* argument must be one of these values:" msgstr "" #: library/dbm.rst:306 msgid "" "In addition to the dictionary-like methods, ``ndbm`` objects provide the " "following method:" msgstr "" #: library/dbm.rst:314 msgid "Close the ``ndbm`` database." msgstr "" #: library/dbm.rst:318 msgid ":mod:`dbm.dumb` --- Portable DBM implementation" msgstr "" #: library/dbm.rst:323 #, fuzzy msgid "**Source code:** :source:`Lib/dbm/dumb.py`" msgstr "**Code source :** :source:`Lib/bdb.py`" #: library/dbm.rst:329 msgid "" "The :mod:`dbm.dumb` module is intended as a last resort fallback for the :" "mod:`dbm` module when a more robust module is not available. The :mod:`dbm." "dumb` module is not written for speed and is not nearly as heavily used as " "the other database modules." msgstr "" #: library/dbm.rst:336 msgid "" "The :mod:`dbm.dumb` module provides a persistent dictionary-like interface " "which is written entirely in Python. Unlike other modules such as :mod:`dbm." "gnu` no external library is required. As with other persistent mappings, " "the keys and values are always stored as bytes." msgstr "" #: library/dbm.rst:341 msgid "The module defines the following:" msgstr "Le module définit :" #: library/dbm.rst:346 msgid "" "Raised on :mod:`dbm.dumb`-specific errors, such as I/O errors. :exc:" "`KeyError` is raised for general mapping errors like specifying an incorrect " "key." msgstr "" #: library/dbm.rst:352 msgid "" "Open a ``dumbdbm`` database and return a dumbdbm object. The *filename* " "argument is the basename of the database file (without any specific " "extensions). When a dumbdbm database is created, files with :file:`.dat` " "and :file:`.dir` extensions are created." msgstr "" #: library/dbm.rst:380 #, fuzzy msgid "" "It is possible to crash the Python interpreter when loading a database with " "a sufficiently large/complex entry due to stack depth limitations in " "Python's AST compiler." msgstr "" "Il est possible de faire planter l'interpréteur Python avec des chaînes " "suffisamment grandes ou complexes lors de la compilation d'un objet AST dû à " "la limitation de la profondeur de la pile d'appels." #: library/dbm.rst:384 msgid "" ":func:`.open` always creates a new database when the flag has the value " "``'n'``." msgstr "" #: library/dbm.rst:388 msgid "" "A database opened with flags ``'r'`` is now read-only. Opening with flags " "``'r'`` and ``'w'`` no longer creates a database if it does not exist." msgstr "" #: library/dbm.rst:396 msgid "" "In addition to the methods provided by the :class:`collections.abc." "MutableMapping` class, :class:`dumbdbm` objects provide the following " "methods:" msgstr "" #: library/dbm.rst:402 msgid "" "Synchronize the on-disk directory and data files. This method is called by " "the :meth:`Shelve.sync` method." msgstr "" #: library/dbm.rst:407 msgid "Close the ``dumbdbm`` database." msgstr ""