diff Doc/lib/libstringio.tex @ 8730:8a306dfd9f33 legacy-trunk

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!
author Fred Drake <fdrake@acm.org>
date Fri, 24 Jul 1998 13:56:11 +0000
parents
children acfffe14628e
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Doc/lib/libstringio.tex	Fri Jul 24 13:56:11 1998 +0000
@@ -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.