mirror of
https://github.com/python/cpython.git
synced 2024-11-24 10:24:35 +08:00
Document changed semantics -- open() now guesses the db type and error
is now a tuple of various and sundry exceptions.
This commit is contained in:
parent
fc1f64d90d
commit
2aefe8d7c0
@ -11,6 +11,12 @@ be used.
|
||||
|
||||
\begin{funcdesc}{open}{filename\optional{, flag\optional{, mode}}}
|
||||
Open the database file \var{filename} and return a corresponding object.
|
||||
|
||||
If the database file already exists, the \module{whichdb} module is
|
||||
used to determine its type and the appropriate module is used; if it
|
||||
doesn't exist, the first module listed above that can be imported is
|
||||
used.
|
||||
|
||||
The optional \var{flag} argument can be
|
||||
\code{'r'} to open an existing database for reading only,
|
||||
\code{'w'} to open an existing database for reading and writing,
|
||||
@ -24,8 +30,10 @@ only when the database has to be created. It defaults to octal
|
||||
\end{funcdesc}
|
||||
|
||||
\begin{excdesc}{error}
|
||||
An alternate name for the \exception{error} exception defined by the
|
||||
underlying database implementation.
|
||||
A tuple containing the exceptions that can be raised by each of the
|
||||
supported modules, with a unique exception \exception{anydbm.error} as
|
||||
the first item --- the latter is used when \exception{anydbm.error} is
|
||||
raised.
|
||||
\end{excdesc}
|
||||
|
||||
The object returned by \function{open()} supports most of the same
|
||||
|
@ -11,6 +11,12 @@ be used.
|
||||
|
||||
\begin{funcdesc}{open}{filename\optional{, flag\optional{, mode}}}
|
||||
Open the database file \var{filename} and return a corresponding object.
|
||||
|
||||
If the database file already exists, the \module{whichdb} module is
|
||||
used to determine its type and the appropriate module is used; if it
|
||||
doesn't exist, the first module listed above that can be imported is
|
||||
used.
|
||||
|
||||
The optional \var{flag} argument can be
|
||||
\code{'r'} to open an existing database for reading only,
|
||||
\code{'w'} to open an existing database for reading and writing,
|
||||
@ -24,8 +30,10 @@ only when the database has to be created. It defaults to octal
|
||||
\end{funcdesc}
|
||||
|
||||
\begin{excdesc}{error}
|
||||
An alternate name for the \exception{error} exception defined by the
|
||||
underlying database implementation.
|
||||
A tuple containing the exceptions that can be raised by each of the
|
||||
supported modules, with a unique exception \exception{anydbm.error} as
|
||||
the first item --- the latter is used when \exception{anydbm.error} is
|
||||
raised.
|
||||
\end{excdesc}
|
||||
|
||||
The object returned by \function{open()} supports most of the same
|
||||
|
Loading…
Reference in New Issue
Block a user