rest25/library/dbhash.rst => rest262/library/dbhash.rst
n1- 
2:mod:`dbhash` --- DBM-style interface to the BSD database library
3=================================================================
4
5.. module:: dbhash
n6-   :platform: Unix, Windows
7   :synopsis: DBM-style interface to the BSD database library.
8.. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org>
9
n8+.. deprecated:: 2.6
9+    The :mod:`dbhash` module has been deprecated for removal in Python 3.0.
10
11.. index:: module: bsddb
12
13The :mod:`dbhash` module provides a function to open databases using the BSD
14``db`` library.  This module mirrors the interface of the other Python database
15modules that provide access to DBM-style databases.  The :mod:`bsddb` module is
16required  to use :mod:`dbhash`.
17
24   for :exc:`bsddb.error`.
25
26
27.. function:: open(path[, flag[, mode]])
28
29   Open a ``db`` database and return the database object.  The *path* argument is
30   the name of the database file.
31
t32-   The *flag* argument can be ``'r'`` (the default), ``'w'``, ``'c'`` (which
t32+   The *flag* argument can be:
33-   creates the database if it doesn't exist), or ``'n'`` (which always creates a
33+ 
34-   new empty database). For platforms on which the BSD ``db`` library supports
34+   +---------+-------------------------------------------+
35+   | Value   | Meaning                                   |
36+   +=========+===========================================+
37+   | ``'r'`` | Open existing database for reading only   |
38+   |         | (default)                                 |
39+   +---------+-------------------------------------------+
40+   | ``'w'`` | Open existing database for reading and    |
41+   |         | writing                                   |
42+   +---------+-------------------------------------------+
43+   | ``'c'`` | Open database for reading and writing,    |
44+   |         | creating it if it doesn't exist           |
45+   +---------+-------------------------------------------+
46+   | ``'n'`` | Always create a new, empty database, open |
47+   |         | for reading and writing                   |
48+   +---------+-------------------------------------------+
49+ 
50+   For platforms on which the BSD ``db`` library supports locking, an ``'l'``
35-   locking, an ``'l'`` can be appended to indicate that locking should be used.
51+   can be appended to indicate that locking should be used.
36
37   The optional *mode* parameter is used to indicate the Unix permission bits that
38   should be set if a new database must be created; this will be masked by the
39   current umask value for the process.
40
41
42.. seealso::
43
Legends
Colors
 Added 
Changed
Deleted
Links
(f)irst change
(n)ext change
(t)op