Staging
v0.5.1
v0.5.1
https://github.com/python/cpython
Tip revision: 0e5088fcc44b42879b728a495456f4b6d4181de0 authored by cvs2svn on 17 October 1998, 19:44:20 UTC
This commit was manufactured by cvs2svn to create tag 'r152a2'.
This commit was manufactured by cvs2svn to create tag 'r152a2'.
Tip revision: 0e5088f
libdbm.tex
\section{\module{dbm} ---
The standard ``database'' interface, based on ndbm.}
\declaremodule{builtin}{dbm}
\modulesynopsis{The standard ``database'' interface, based on ndbm.}
The \code{dbm} module provides an interface to the \UNIX{}
\code{(n)dbm} library. Dbm objects behave like mappings
(dictionaries), except that keys and values are always strings.
Printing a dbm object doesn't print the keys and values, and the
\code{items()} and \code{values()} methods are not supported.
See also the \code{gdbm} module, which provides a similar interface
using the GNU GDBM library.
\refbimodindex{gdbm}
The module defines the following constant and functions:
\begin{excdesc}{error}
Raised on dbm-specific errors, such as I/O errors. \code{KeyError} is
raised for general mapping errors like specifying an incorrect key.
\end{excdesc}
\begin{funcdesc}{open}{filename, \optional{flag, \optional{mode}}}
Open a dbm database and return a dbm object. The \var{filename}
argument is the name of the database file (without the \file{.dir} or
\file{.pag} extensions).
The optional \var{flag} argument can be
\code{'r'} (to open an existing database for reading only --- default),
\code{'w'} (to open an existing database for reading and writing),
\code{'c'} (which creates the database if it doesn't exist), or
\code{'n'} (which always creates a new empty database).
The optional \var{mode} argument is the \UNIX{} mode of the file, used
only when the database has to be created. It defaults to octal
\code{0666}.
\end{funcdesc}