Movatterモバイル変換

4.5`StringIO` -- Read and write strings as files

This module implements a file-like class,StringIO,that reads and writes a string buffer (also known asmemoryfiles). See the description of file objects for operations (section3.9).

class StringIO( [buffer]): When aStringIO object is created, it can be initializedto an existing string by passing the string to the constructor.If no string is given, theStringIO will start empty.In both cases, the initial file position starts at zero.
TheStringIO object can accept either Unicode or 8-bitstrings, but mixing the two may take some care. If both are used,8-bit strings that cannot be interpreted as 7-bit ASCII (thatuse the 8th bit) will cause aUnicodeError to be raisedwhengetvalue() is called.

The following methods ofStringIO objects require specialmention:

getvalue( ): Retrieve the entire contents of the ``file'' at any time before theStringIO object'sclose() method is called. See thenote above for information about mixing Unicode and 8-bit strings;such mixing can cause this method to raiseUnicodeError.

close( ): Free the memory buffer.

Example usage:

import StringIOoutput = 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()

Release 2.5.2, documentation updated on 21st February, 2008.

SeeAbout this document... for information on suggesting changes.

[8]ページ先頭

Movatterモバイル変換

4.5StringIO -- Read and write strings as files

4.5`StringIO` -- Read and write strings as files