[Python-checkins] python/dist/src/Doc/lib libbsddb.tex, 1.11, 1.12 libdbhash.tex, 1.6, 1.7

Fri Sep 12 00:33:39 EDT 2003

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1:/tmp/cvs-serv4051/Doc/lib
Modified Files:
	libbsddb.tex libdbhash.tex 
Log Message:
SF #662923
Add support for the iterator and mapping protocols.
For Py2.3, this was done for shelve, dumbdbm and other mapping objects, but
not for bsddb and dbhash which were inadvertently missed.
Index: libbsddb.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libbsddb.tex,v
retrieving revision 1.11
retrieving revision 1.12
diff -C2 -d -r1.11 -r1.12
*** libbsddb.tex	28 May 2003 16:20:03 -0000	1.11
--- libbsddb.tex	12 Sep 2003 06:33:37 -0000	1.12
***************
*** 101,106 ****
 \subsection{Hash, BTree and Record Objects \label{bsddb-objects}}

! Once instantiated, hash, btree and record objects support the following
! methods:

 \begin{methoddesc}{close}{}
--- 101,107 ----
 \subsection{Hash, BTree and Record Objects \label{bsddb-objects}}

! Once instantiated, hash, btree and record objects support
! the same methods as dictionaries. In addition, they support
! the following methods:

 \begin{methoddesc}{close}{}
***************
*** 178,181 ****
--- 179,196 ----
 >>> db.previous() 
 ('1', '1')
+ >>> for k, v in db.iteritems():
+ ... print k, v
+ 0 0
+ 1 1
+ 2 4
+ 3 9
+ 4 16
+ 5 25
+ 6 36
+ 7 49
+ 8 64
+ 9 81
+ >>> 8 in db
+ True
 >>> db.sync()
 0
Index: libdbhash.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libdbhash.tex,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -d -r1.6 -r1.7
*** libdbhash.tex	10 Sep 2003 04:44:29 -0000	1.6
--- libdbhash.tex	12 Sep 2003 06:33:37 -0000	1.7
***************
*** 52,61 ****

 The database objects returned by \function{open()} provide the methods 
! common to all the DBM-style databases. The following methods are
! available in addition to the standard methods.

 \begin{methoddesc}[dbhash]{first}{}
! It's possible to loop over every key in the database using this method 
! and the \method{next()} method. The traversal is ordered by
 the databases internal hash values, and won't be sorted by the key
 values. This method returns the starting key.
--- 52,61 ----

 The database objects returned by \function{open()} provide the methods 
! common to all the DBM-style databases and mapping objects. The following
! methods are available in addition to the standard methods.

 \begin{methoddesc}[dbhash]{first}{}
! It's possible to loop over every key/value pair in the database using
! this method and the \method{next()} method. The traversal is ordered by
 the databases internal hash values, and won't be sorted by the key
 values. This method returns the starting key.
***************
*** 63,72 ****

 \begin{methoddesc}[dbhash]{last}{}
! Return the last key in a database traversal. This may be used to
 begin a reverse-order traversal; see \method{previous()}.
 \end{methoddesc}

 \begin{methoddesc}[dbhash]{next}{}
! Returns the key next key in a database traversal. The
 following code prints every key in the database \code{db}, without
 having to create a list in memory that contains them all:
--- 63,72 ----

 \begin{methoddesc}[dbhash]{last}{}
! Return the last key/value pair in a database traversal. This may be used to
 begin a reverse-order traversal; see \method{previous()}.
 \end{methoddesc}

 \begin{methoddesc}[dbhash]{next}{}
! Returns the key next key/value pair in a database traversal. The
 following code prints every key in the database \code{db}, without
 having to create a list in memory that contains them all:
***************
*** 80,84 ****

 \begin{methoddesc}[dbhash]{previous}{}
! Returns the previous key in a forward-traversal of the database.
 In conjunction with \method{last()}, this may be used to implement
 a reverse-order traversal.
--- 80,84 ----

 \begin{methoddesc}[dbhash]{previous}{}
! Returns the previous key/value pair in a forward-traversal of the database.
 In conjunction with \method{last()}, this may be used to implement
 a reverse-order traversal.