python-docs-fr/library/dbm.po

# 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 <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/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 <https://www.jcea.es/programacion/pybsddb."
"htm>`_ 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 ""