summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libuserdict.tex
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>1997-03-27 14:56:18 (GMT)
committerGuido van Rossum <guido@python.org>1997-03-27 14:56:18 (GMT)
commit7f3b0421deb42d5dbf049f734e6d49ff816608a3 (patch)
tree786634290f2c31b9bd66e0af8b6f09b728e8e3ef /Doc/lib/libuserdict.tex
parentb6a80262e10a2817db0ea181ed7a9c58df858bef (diff)
downloadcpython-7f3b0421deb42d5dbf049f734e6d49ff816608a3.zip
cpython-7f3b0421deb42d5dbf049f734e6d49ff816608a3.tar.gz
cpython-7f3b0421deb42d5dbf049f734e6d49ff816608a3.tar.bz2
Added docs for UserDict,UserList
Diffstat (limited to 'Doc/lib/libuserdict.tex')
-rw-r--r--Doc/lib/libuserdict.tex27
1 files changed, 27 insertions, 0 deletions
diff --git a/Doc/lib/libuserdict.tex b/Doc/lib/libuserdict.tex
new file mode 100644
index 0000000..e47babd
--- /dev/null
+++ b/Doc/lib/libuserdict.tex
@@ -0,0 +1,27 @@
+\section{Standard Modules \sectcode{UserDict} and \sectcode{UserList}}
+Each of these modules defines a class that acts as a wrapper around
+either dictionary or list objects. They're useful base classes for
+your own dictionary-like or list-like classes, which can inherit from
+them and override existing methods or add new ones. In this way one
+can add new behaviours to dictionaries or lists.
+
+\renewcommand{\indexsubitem}{(in module UserDict)}
+The \code{UserDict} module defines the \code{UserDict} class:
+
+\begin{funcdesc}{UserDict}{}
+Return a class instance that simulates a dictionary. The instance's
+contents are kept in a regular dictionary, which is accessible via the
+\code{data} attribute of \code{UserDict} instances.
+\end{funcdesc}
+
+\renewcommand{\indexsubitem}{(in module UserList)}
+The \code{UserList} module defines the \code{UserList} class:
+
+\begin{funcdesc}{UserList}{\optional{list}}
+Return a class instance that simulates a list. The instance's
+contents are kept in a regular list, which is accessible via the
+\code{data} attribute of \code{UserList} instances. The instance's
+contents are initially set to c copy of \var{list}, defaulting to the
+empty list \code{[]}. \var{list} can be either a regular Python list,
+or an instance of \code{UserList} (or a subclass).
+\end{funcdesc}