iframe-proxy | Sunbelt Computer Software

567 lines (452 loc) · 16.5 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
# Translators:
# Vladimir, 2025
# python-doc bot, 2025
"Project-Id-Version: Python 3.15\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-09-01 17:31+0000\n"
"PO-Revision-Date: 2025-09-16 00:01+0000\n"
"Last-Translator: python-doc bot, 2025\n"
"Language-Team: Russian (https://app.transifex.com/python-doc/teams/5390/"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: ru\n"
"Plural-Forms: nplurals=4; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && "
"n%10<=4 && (n%100<12 || n%100>14) ? 1 : n%10==0 || (n%10>=5 && n%10<=9) || "
"(n%100>=11 && n%100<=14)? 2 : 3);\n"
msgid ":mod:`!dbm` --- Interfaces to Unix \"databases\""
msgid "**Source code:** :source:`Lib/dbm/__init__.py`"
msgid ":mod:`!dbm` is a generic interface to variants of the DBM database:"
msgid ":mod:`dbm.sqlite3`"
msgid ":mod:`dbm.gnu`"
msgid ":mod:`dbm.ndbm`"
"If none of these modules are 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."
"None of the underlying modules will automatically shrink the disk space used "
"by the database file. However, :mod:`dbm.sqlite3`, :mod:`dbm.gnu` and :mod:"
"`dbm.dumb` provide a :meth:`!reorganize` method that can be used for this "
"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."
"This function attempts to guess which of the several simple database modules "
"available --- :mod:`dbm.sqlite3`, :mod:`dbm.gnu`, :mod:`dbm.ndbm`, or :mod:"
"`dbm.dumb` --- should be used to open a given file."
msgid "Return one of the following values:"
"``None`` if the file can't be opened because it's unreadable or doesn't exist"
msgid "the empty string (``''``) if the file's format can't be guessed"
"a string containing the required module name, such as ``'dbm.ndbm'`` or "
"``'dbm.gnu'``"
msgid "*filename* accepts a :term:`path-like object`."
msgid "Open a database and return the corresponding database object."
msgid "Parameters"
"The database file to open.  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 submodule listed above that can be "
"imported is used."
msgid "The database file to open."
"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 submodule listed above that can be imported is used."
"* ``'r'`` (default): |flag_r| * ``'w'``: |flag_w| * ``'c'``: |flag_c| * "
"``'n'``: |flag_n|"
msgid "``'r'`` (default): |flag_r|"
msgid "``'w'``: |flag_w|"
msgid "``'c'``: |flag_c|"
msgid "``'n'``: |flag_n|"
msgid "|mode_param_doc|"
msgid "*file* accepts a :term:`path-like object`."
"The object returned by :func:`~dbm.open` supports the basic functionality of "
"mutable :term:`mappings <mapping>`; keys and their corresponding values can "
"be stored, retrieved, and deleted, and iteration, the :keyword:`in` operator "
"and methods :meth:`!keys`, :meth:`!get`, :meth:`!setdefault` and :meth:`!"
"clear` are available. The :meth:`!keys` method returns a list instead of a "
"view object. The :meth:`!setdefault` method requires two arguments."
"Key and values are always stored as :class:`bytes`. This means that when "
"strings are used they are implicitly converted to the default encoding "
"before being stored."
"These objects also support being used in a :keyword:`with` statement, which "
"will automatically close them when done."
":meth:`!get` and :meth:`!setdefault` methods are now available for all :mod:"
"`!dbm` backends."
"Added native support for the context management protocol to the objects "
"returned by :func:`~dbm.open`."
"Deleting a key from a read-only database raises a database module specific "
"exception instead of :exc:`KeyError`."
msgid ":meth:`!clear` methods are now available for all :mod:`!dbm` backends."
"The following example records some hostnames and a corresponding title,  and "
"then prints out the contents of the database::"
"import dbm\n"
"# Open database, creating it if necessary.\n"
"with dbm.open('cache', 'c') as db:\n"
"    # Record some values\n"
"    db[b'hello'] = b'there'\n"
"    db['www.python.org'] = 'Python Website'\n"
"    db['www.cnn.com'] = 'Cable News Network'\n"
"    # Note that the keys are considered bytes now.\n"
"    assert db[b'www.python.org'] == b'Python Website'\n"
"    # Notice how the value is now in bytes.\n"
"    assert db['www.cnn.com'] == b'Cable News Network'\n"
"    # Often-used methods of the dict interface work too.\n"
"    print(db.get('python.org', b'not present'))\n"
"    # Storing a non-string key or value will raise an exception (most\n"
"    # likely a TypeError).\n"
"    db['www.yahoo.com'] = 4\n"
"# db is automatically closed when leaving the with statement."
msgid "Module :mod:`shelve`"
msgid "Persistence module which stores non-string data."
msgid "The individual submodules are described in the following sections."
msgid ":mod:`!dbm.sqlite3` --- SQLite backend for dbm"
msgid "**Source code:** :source:`Lib/dbm/sqlite3.py`"
"This module uses the standard library :mod:`sqlite3` module to provide an "
"SQLite backend for the :mod:`!dbm` module. The files created by :mod:`!dbm."
"sqlite3` can thus be opened by :mod:`sqlite3`, or any other SQLite browser, "
"including the SQLite CLI."
msgid "Availability"
"This module does not work or is not available on WebAssembly. See :ref:`wasm-"
"availability` for more information."
msgid "Open an SQLite database."
msgid "The path to the database to be opened."
"The Unix file access mode of the file (default: octal ``0o666``), used only "
"when the database has to be created."
"The returned database object behaves similar to a mutable :term:`mapping`, "
"but the :meth:`!keys` method returns a list, and the :meth:`!setdefault` "
"method requires two arguments. It also supports a \"closing\" context "
"manager via the :keyword:`with` keyword."
msgid "The following methods are also provided:"
msgid "Close the SQLite database."
"If you have carried out a lot of deletions and would like to shrink the "
"space used on disk, this method will reorganize the database; otherwise, "
"deleted file space will be kept and reused as new (key, value) pairs are "
"While reorganizing, as much as two times the size of the original database "
"is required in free disk space. However, be aware that this factor changes "
"for each :mod:`!dbm` submodule."
msgid ":mod:`!dbm.gnu` --- GNU database manager"
msgid "**Source code:** :source:`Lib/dbm/gnu.py`"
"The :mod:`!dbm.gnu` module provides an interface to the :abbr:`GDBM (GNU "
"dbm)` library, similar to the :mod:`dbm.ndbm` module, but with additional "
"functionality like crash tolerance."
"The file formats created by :mod:`!dbm.gnu` and :mod:`dbm.ndbm` are "
"incompatible and can not be used interchangeably."
"This module is not supported on :ref:`mobile platforms <mobile-"
"availability>` or :ref:`WebAssembly platforms <wasm-availability>`."
"Raised on :mod:`!dbm.gnu`-specific errors, such as I/O errors. :exc:"
"`KeyError` is raised for general mapping errors like specifying an incorrect "
"A string of characters the *flag* parameter of :meth:`~dbm.gnu.open` "
"supports."
msgid "Open a GDBM database and return a :class:`!gdbm` object."
"* ``'r'`` (default): |flag_r| * ``'w'``: |flag_w| * ``'c'``: |flag_c| * "
"``'n'``: |flag_n|  The following additional characters may be appended to "
"control how the database is opened:  * ``'f'``: Open the database in fast "
"mode.   Writes to the database will not be synchronized. * ``'s'``: "
"Synchronized mode.   Changes to the database will be written immediately to "
"the file. * ``'u'``: Do not lock database.  Not all flags are valid for all "
"versions of GDBM. See the :data:`open_flags` member for a list of supported "
"flag characters."
"The following additional characters may be appended to control how the "
"database is opened:"
"``'f'``: Open the database in fast mode. Writes to the database will not be "
"synchronized."
"``'s'``: Synchronized mode. Changes to the database will be written "
"immediately to the file."
msgid "``'u'``: Do not lock database."
"Not all flags are valid for all versions of GDBM. See the :data:`open_flags` "
"member for a list of supported flag characters."
msgid "Raises"
msgid "If an invalid *flag* argument is passed."
":class:`!gdbm` objects behave similar to mutable :term:`mappings <mapping>`, "
"but methods :meth:`!items`, :meth:`!values`, :meth:`!pop`, :meth:`!popitem`, "
"and :meth:`!update` are not supported, the :meth:`!keys` method returns a "
"list, and the :meth:`!setdefault` method requires two arguments. It also "
"supports a \"closing\" context manager via the :keyword:`with` keyword."
msgid "Added the :meth:`!get` and :meth:`!setdefault` methods."
msgid "Added the :meth:`!clear` method."
msgid "Close the GDBM database."
"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."
"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::"
"k = db.firstkey()\n"
"while k is not None:\n"
"    print(k)\n"
"    k = db.nextkey(k)"
"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.  :"
"class:`!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."
"While reorganizing, as much as one time the size of the original database is "
"required in free disk space. However, be aware that this factor changes for "
"each :mod:`!dbm` submodule."
"When the database has been opened in fast mode, this method forces any "
"unwritten data to be written to the disk."
msgid ":mod:`!dbm.ndbm` --- New Database Manager"
msgid "**Source code:** :source:`Lib/dbm/ndbm.py`"
"The :mod:`!dbm.ndbm` module provides an interface to the :abbr:`NDBM (New "
"Database Manager)` library. This module can be used with the \"classic\" "
"NDBM interface or the :abbr:`GDBM (GNU dbm)` compatibility interface."
"The file formats created by :mod:`dbm.gnu` and :mod:`!dbm.ndbm` are "
"incompatible and can not be used interchangeably."
"The NDBM library shipped as part of macOS has an undocumented limitation on "
"the size of values, which can result in corrupted database files when "
"storing values larger than this limit. Reading such corrupted files can "
"result in a hard crash (segmentation fault)."
"Raised on :mod:`!dbm.ndbm`-specific errors, such as I/O errors. :exc:"
"`KeyError` is raised for general mapping errors like specifying an incorrect "
msgid "Name of the NDBM implementation library used."
msgid "Open an NDBM database and return an :class:`!ndbm` object."
"The basename of the database file (without the :file:`.dir` or :file:`.pag` "
"extensions)."
msgid "Accepts :term:`path-like object` for filename."
":class:`!ndbm` objects behave similar to mutable :term:`mappings <mapping>`, "
"but methods :meth:`!items`, :meth:`!values`, :meth:`!pop`, :meth:`!popitem`, "
"and :meth:`!update` are not supported, the :meth:`!keys` method returns a "
"list, and the :meth:`!setdefault` method requires two arguments. It also "
"supports a \"closing\" context manager via the :keyword:`with` keyword."
msgid "The following method is also provided:"
msgid "Close the NDBM database."
msgid ":mod:`!dbm.dumb` --- Portable DBM implementation"
msgid "**Source code:** :source:`Lib/dbm/dumb.py`"
"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."
"The :mod:`!dbm.dumb` module provides a persistent :class:`dict`-like "
"interface which is written entirely in Python. Unlike other :mod:`!dbm` "
"backends, such as :mod:`dbm.gnu`, no external library is required."
msgid "The :mod:`!dbm.dumb` module defines the following:"
"Raised on :mod:`!dbm.dumb`-specific errors, such as I/O errors.  :exc:"
"`KeyError` is raised for general mapping errors like specifying an incorrect "
msgid "Open a :mod:`!dbm.dumb` database."
"The basename of the database file (without extensions). A new database "
"creates the following files:  - :file:`{filename}.dat` - :file:`{filename}."
"The basename of the database file (without extensions). A new database "
"creates the following files:"
msgid ":file:`{filename}.dat`"
msgid ":file:`{filename}.dir`"
"* ``'r'``: |flag_r| * ``'w'``: |flag_w| * ``'c'`` (default): |flag_c| * "
"``'n'``: |flag_n|"
msgid "``'r'``: |flag_r|"
msgid "``'c'`` (default): |flag_c|"
"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."
":mod:`!dbm.dumb` does not support concurrent read/write access. (Multiple "
"simultaneous read accesses are safe.) When a program has the database open "
"for writing, no other program should have it open for reading or writing."
":func:`~dbm.dumb.open` always creates a new database when *flag* is ``'n'``."
"A database opened read-only if *flag* is ``'r'``. A database is not created "
"if it does not exist if *flag* is ``'r'`` or ``'w'``."
"The returned database object behaves similar to a mutable :term:`mapping`, "
"but the :meth:`!keys` and :meth:`!items` methods return lists, and the :meth:"
"`!setdefault` method requires two arguments. It also supports a \"closing\" "
"context manager via the :keyword:`with` keyword."
msgid "Close the database."
"If you have carried out a lot of deletions and would like to shrink the "
"space used on disk, this method will reorganize the database; otherwise, "
"deleted file space will not be reused."
"While reorganizing, no additional free disk space is required. However, be "
"aware that this factor changes for each :mod:`!dbm` submodule."
"Synchronize the on-disk directory and data files.  This method is called by "
"the :meth:`shelve.Shelf.sync` method."
msgid "databases"
Sunbelt Computer Software

PL/B Language Development and Support

Navigation Menu

Uh oh!

Sunbelt Computer Software

PL/B Language Development and Support

Uh oh!

FilesExpand file tree

dbm.po

Latest commit

History

dbm.po

File metadata and controls
