1997-03-03 16:01:21 +00:00
|
|
|
\section{Standard Module \sectcode{StringIO}}
|
1997-07-17 16:29:04 +00:00
|
|
|
\label{module-StringIO}
|
1997-03-03 16:01:21 +00:00
|
|
|
|
|
|
|
\stmodindex{StringIO}
|
|
|
|
|
1998-03-27 05:27:08 +00:00
|
|
|
This module implements a file-like class, \class{StringIO},
|
1998-01-14 14:51:31 +00:00
|
|
|
that reads and writes a string buffer (also known as \emph{memory
|
1997-03-03 16:01:21 +00:00
|
|
|
files}). See the description on file objects for operations.
|
|
|
|
|
1998-03-27 05:27:08 +00:00
|
|
|
\begin{classdesc}{StringIO}{\optional{buffer}}
|
|
|
|
When a \class{StringIO} object is created, it can be initialized
|
1997-03-03 16:01:21 +00:00
|
|
|
to an existing string by passing the string to the constructor.
|
1998-03-27 05:27:08 +00:00
|
|
|
If no string is given, the \class{StringIO} will start empty.
|
|
|
|
\end{classdesc}
|
1997-03-03 16:01:21 +00:00
|
|
|
|
1998-03-27 05:27:08 +00:00
|
|
|
\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}
|