diff options
author | Fred Drake <fdrake@acm.org> | 1998-07-24 13:56:11 (GMT) |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 1998-07-24 13:56:11 (GMT) |
commit | 64e3b43583c0b660e49d430f1f4128460adea033 (patch) | |
tree | e02c5c6de79911e742e5f5976fdccb0d422b0d14 /Doc/lib/libstringio.tex | |
parent | 889f53d4e0c3b701d5de0892a0ab8caabeb689b8 (diff) | |
download | cpython-64e3b43583c0b660e49d430f1f4128460adea033.zip cpython-64e3b43583c0b660e49d430f1f4128460adea033.tar.gz cpython-64e3b43583c0b660e49d430f1f4128460adea033.tar.bz2 |
Move files around to get the names to match the module names except for
case. Two modules (SocketServer, BaseHTTPServer) still don't match; those
names are just too long!
Diffstat (limited to 'Doc/lib/libstringio.tex')
-rw-r--r-- | Doc/lib/libstringio.tex | 46 |
1 files changed, 46 insertions, 0 deletions
diff --git a/Doc/lib/libstringio.tex b/Doc/lib/libstringio.tex new file mode 100644 index 0000000..6b7d2c5 --- /dev/null +++ b/Doc/lib/libstringio.tex @@ -0,0 +1,46 @@ +\section{Standard Module \module{StringIO}} +\declaremodule{standard}{StringIO} + + +\modulesynopsis{Read and write strings as if they were files.} + + +This module implements a file-like class, \class{StringIO}, +that reads and writes a string buffer (also known as \emph{memory +files}). See the description on file objects for operations. + +\begin{classdesc}{StringIO}{\optional{buffer}} +When a \class{StringIO} object is created, it can be initialized +to an existing string by passing the string to the constructor. +If no string is given, the \class{StringIO} will start empty. +\end{classdesc} + +The following methods of \class{StringIO} objects require special +mention: + +\begin{methoddesc}{getvalue}{} +Retrieve the entire contents of the ``file'' at any time before the +\class{StringIO} object's \method{close()} method is called. +\end{methoddesc} + +\begin{methoddesc}{close}{} +Free the memory buffer. +\end{methoddesc} + + +\section{Built-in Module \module{cStringIO}} +\declaremodule{builtin}{cStringIO} + +\modulesynopsis{Faster version of \module{StringIO}, but not subclassable.} + + +% This section was written by Fred L. Drake, Jr. <fdrake@acm.org> + +The module \module{cStringIO} provides an interface similar to that of +the \module{StringIO} module. Heavy use of \class{StringIO.StringIO} +objects can be made more efficient by using the function +\function{StringIO()} from this module instead. + +Since this module provides a factory function which returns objects of +built-in types, there's no way to build your own version using +subclassing. Use the original \module{StringIO} module in that case. |