cStringIO
index
/usr/local/lib/python2.3/lib-dynload/cStringIO.so

A simple fast partial StringIO replacement.
 
This module provides a simple useful replacement for
the StringIO module that is written in C.  It does not provide the
full generality of StringIO, but it provides enough for most
applications and is especially useful in conjunction with the
pickle module.
 
Usage:
 
  from cStringIO import StringIO
 
  an_output_stream=StringIO()
  an_output_stream.write(some_stuff)
  ...
  value=an_output_stream.getvalue()
 
  an_input_stream=StringIO(a_string)
  spam=an_input_stream.readline()
  spam=an_input_stream.read(5)
  an_input_stream.seek(0)           # OK, start over
  spam=an_input_stream.read()       # and read it all
  
If someone else wants to provide a more complete implementation,
go for it. :-)  
 
cStringIO.c,v 1.29 1999/06/15 14:10:27 jim Exp

 
Classes
       
__builtin__.object
StringI
StringO

 
InputType = class StringI(__builtin__.object)
    Simple type for treating strings as input file streams
 
  Methods defined here:
__iter__(...)
x.__iter__() <==> iter(x)
close(...)
close(): explicitly release resources held.
flush(...)
flush(): does nothing.
getvalue(...)
getvalue([use_pos]) -- Get the string value.
If use_pos is specified and is a true value, then the string returned
will include only the text up to the current file position.
isatty(...)
isatty(): always returns 0
next(...)
x.next() -> the next value, or raise StopIteration
read(...)
read([s]) -- Read s characters, or the rest of the string
readline(...)
readline() -- Read one line
readlines(...)
readlines() -- Read all lines
reset(...)
reset() -- Reset the file position to the beginning
seek(...)
seek(position)       -- set the current position
seek(position, mode) -- mode 0: absolute; 1: relative; 2: relative to EOF
tell(...)
tell() -- get the current position.
truncate(...)
truncate(): truncate the file at the current position.

Data and other attributes defined here:
closed = <attribute 'closed' of 'cStringIO.StringI' objects>
True if the file is closed

 
OutputType = class StringO(__builtin__.object)
    Simple type for output to strings.
 
  Methods defined here:
__iter__(...)
x.__iter__() <==> iter(x)
close(...)
close(): explicitly release resources held.
flush(...)
flush(): does nothing.
getvalue(...)
getvalue([use_pos]) -- Get the string value.
If use_pos is specified and is a true value, then the string returned
will include only the text up to the current file position.
isatty(...)
isatty(): always returns 0
next(...)
x.next() -> the next value, or raise StopIteration
read(...)
read([s]) -- Read s characters, or the rest of the string
readline(...)
readline() -- Read one line
readlines(...)
readlines() -- Read all lines
reset(...)
reset() -- Reset the file position to the beginning
seek(...)
seek(position)       -- set the current position
seek(position, mode) -- mode 0: absolute; 1: relative; 2: relative to EOF
tell(...)
tell() -- get the current position.
truncate(...)
truncate(): truncate the file at the current position.
write(...)
write(s) -- Write a string to the file
 
Note (hack:) writing None resets the buffer
writelines(...)
writelines(sequence_of_strings): write each string

Data and other attributes defined here:
closed = <attribute 'closed' of 'cStringIO.StringO' objects>
True if the file is closed
softspace = <member 'softspace' of 'cStringIO.StringO' objects>
flag indicating that a space needs to be printed; used by print

 
Functions
       
StringIO(...)
StringIO([s]) -- Return a StringIO-like stream for reading or writing

 
Data
        cStringIO_CAPI = <PyCObject object>