[Python-checkins] r50905 - python/trunk/Doc/lib/libanydbm.tex

[andrew.kuchling]

Author: andrew.kuchling
Date: Fri Jul 28 14:48:07 2006
New Revision: 50905

Modified:
   python/trunk/Doc/lib/libanydbm.tex
Log:
Add example.  Should I propagate this example to all the other DBM-ish modules, too?

Modified: python/trunk/Doc/lib/libanydbm.tex
==============================================================================
--- python/trunk/Doc/lib/libanydbm.tex	(original)
+++ python/trunk/Doc/lib/libanydbm.tex	Fri Jul 28 14:48:07 2006
@@ -46,6 +46,32 @@
 \method{keys()} methods are available.  Keys and values must always be
 strings.
 
+The following example records some hostnames and a corresponding title, 
+and then prints out the contents of the database:
+
+\begin{verbatim}
+import anydbm
+
+# Open database, creating it if necessary.
+db = anydbm.open('cache', 'c')
+
+# Record some values
+db['www.python.org'] = 'Python Website'
+db['www.cnn.com'] = 'Cable News Network'
+
+# Loop through contents.  Other dictionary methods
+# such as .keys(), .values() also work.
+for k, v in db.iteritems():
+    print k, '\t', v
+
+# Storing a non-string key or value will raise an exception (most
+# likely a TypeError).
+db['www.yahoo.com'] = 4
+
+# Close when done.
+db.close()
+\end{verbatim}
+
 
 \begin{seealso}
   \seemodule{dbhash}{BSD \code{db} database interface.}