diff Doc/lib/libstringio.tex @ 39211:61c0fe48376a legacy-trunk

Add example
author Andrew M. Kuchling <amk@amk.ca>
date Thu, 27 Jul 2006 18:37:33 +0000
parents dad2b6204974
children 9918989b733b
line wrap: on
line diff
--- a/Doc/lib/libstringio.tex	Thu Jul 27 16:08:15 2006 +0000
+++ b/Doc/lib/libstringio.tex	Thu Jul 27 18:37:33 2006 +0000
@@ -37,6 +37,24 @@
 Free the memory buffer.
 \end{methoddesc}
 
+Example usage:
+
+\begin{verbatim}
+import StringIO
+
+output = StringIO.StringIO()
+output.write('First line.\n')
+print >>output, 'Second line.'
+
+# Retrieve file contents -- this will be
+# 'First line.\nSecond line.\n'
+contents = output.getvalue()
+
+# Close object and discard memory buffer -- 
+# .getvalue() will now raise an exception.
+output.close()
+\end{verbatim}
+
 
 \section{\module{cStringIO} ---
          Faster version of \module{StringIO}}
@@ -82,3 +100,22 @@
 
 There is a C API to the module as well; refer to the module source for 
 more information.
+
+Example usage:
+
+\begin{verbatim}
+import cStringIO
+
+output = cStringIO.StringIO()
+output.write('First line.\n')
+print >>output, 'Second line.'
+
+# Retrieve file contents -- this will be
+# 'First line.\nSecond line.\n'
+contents = output.getvalue()
+
+# Close object and discard memory buffer -- 
+# .getvalue() will now raise an exception.
+output.close()
+\end{verbatim}
+