;ò ëŒü?c@stdZydklZWnej o dZnXdgZdfd„ƒYZd„Zedjo eƒndS(s File-like objects that read from or write to a string buffer. This implements (nearly) all stdio methods. f = StringIO() # ready for writing f = StringIO(buf) # ready for reading f.close() # explicitly release resources held flag = f.isatty() # always false pos = f.tell() # get current position f.seek(pos) # set current position f.seek(pos, mode) # mode 0: absolute; 1: relative; 2: relative to EOF buf = f.read() # read until EOF buf = f.read(n) # read up to n bytes buf = f.readline() # read until end of line (' ') or EOF list = f.readlines()# list of f.readline() results until EOF f.truncate([size]) # truncate file at to at most size (default: current pos) f.write(buf) # write at current position f.writelines(list) # for line in list: f.write(line) f.getvalue() # return whole file's contents as a string Notes: - Using a real file is often faster (but less convenient). - There's also a much faster implementation in C, called cStringIO, but it's not subclassable. - fileno() is left unimplemented so that code which uses it triggers an exception early. - Seeking far beyond EOF and then writing will insert real null bytes that occupy space in the buffer. - There's a simple test set (see end of this file). (sEINVALisStringIOcBs§tZdZdd„Zd„Zd„Zd„Zd„Zdd„Zd „Z d d „Z e d „Z dd „Z e d„Zd„Zd„Zd„Zd„ZRS(sôclass StringIO([buffer]) When a 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 StringIO will start empty. The StringIO object can accept either Unicode or 8-bit strings, but mixing the two may take some care. If both are used, 8-bit strings that cannot be interpreted as 7-bit ASCII (that use the 8th bit) will cause a UnicodeError to be raised when getvalue() is called. scCsat|tƒ ot|ƒ}n||_t|ƒ|_g|_d|_d|_d|_ dS(Ni( s isinstancesbufs basestringsstrsselfslensbuflistsposscloseds softspace(sselfsbuf((s%/mit/python/lib/python2.3/StringIO.pys__init__2s    cCs|SdS(N(sself(sself((s%/mit/python/lib/python2.3/StringIO.pys__iter__=scCs:|io t‚n|iƒ}| o t‚n|SdS(N(sselfscloseds StopIterationsreadlinesr(sselfsr((s%/mit/python/lib/python2.3/StringIO.pysnext@s     cCs(|i od|_|`|`ndS(s Free the memory buffer. iN(sselfsclosedsbufspos(sself((s%/mit/python/lib/python2.3/StringIO.pyscloseHs  cCs|io td‚ntSdS(NsI/O operation on closed file(sselfscloseds ValueErrorsFalse(sself((s%/mit/python/lib/python2.3/StringIO.pysisattyOs  icCs›|io td‚n|io(|idi|iƒ7_g|_n|djo||i7}n|djo||i7}nt d|ƒ|_dS(NsI/O operation on closed filesiii( sselfscloseds ValueErrorsbuflistsbufsjoinsmodesposslensmax(sselfspossmode((s%/mit/python/lib/python2.3/StringIO.pysseekTs      cCs"|io td‚n|iSdS(NsI/O operation on closed file(sselfscloseds ValueErrorspos(sself((s%/mit/python/lib/python2.3/StringIO.pystell`s  iÿÿÿÿcCs |io td‚n|io(|idi|iƒ7_g|_n|djo |i}nt |i ||iƒ}|i|i |!}||_ |SdS(NsI/O operation on closed filesi( sselfscloseds ValueErrorsbuflistsbufsjoinsnslensnewpossminspossr(sselfsnsnewpossr((s%/mit/python/lib/python2.3/StringIO.pysreades       cCsß|io td‚n|io(|idi|iƒ7_g|_n|iid|iƒ}|djo |i }n |d}|t j o)|i||jo|i|}q»n|i|i|!}||_|SdS(NsI/O operation on closed filess ii(sselfscloseds ValueErrorsbuflistsbufsjoinsfindspossislensnewposslengthsNonesr(sselfslengthsisnewpossr((s%/mit/python/lib/python2.3/StringIO.pysreadliness         cCs{d}g}|iƒ}xX|oP|i|ƒ|t|ƒ7}d|jo |jnoPn|iƒ}qW|SdS(Ni(stotalslinessselfsreadlineslinesappendslenssizehint(sselfssizehintslinesslinestotal((s%/mit/python/lib/python2.3/StringIO.pys readlines…s  cCs…|io td‚n|tjo |i}n>|djottdƒ‚n||ijo ||_n|iƒ| |_ dS(NsI/O operation on closed fileisNegative size not allowed( sselfscloseds ValueErrorssizesNonespossIOErrorsEINVALsgetvaluesbuf(sselfssize((s%/mit/python/lib/python2.3/StringIO.pystruncate‘s      cCsœ|io td‚n| odSnt|tƒ ot|ƒ}n|i|ijo5|i i |ƒ|it|ƒ|_|_dSn|i|ijo.|i i d|i|iƒ|i|_n|it|ƒ}|i|ijo|i o(|i di |i ƒ7_ g|_ n|i |i ||i |g|_ d|_ ||ijo ||_qn|i i |ƒ||_||_dS(NsI/O operation on closed filess(sselfscloseds ValueErrorsss isinstances basestringsstrsposslensbuflistsappendsnewpossbufsjoin(sselfsssnewpos((s%/mit/python/lib/python2.3/StringIO.pyswriteœs2    #  cCs|idi|ƒƒdS(Ns(sselfswritesjoinslist(sselfslist((s%/mit/python/lib/python2.3/StringIO.pys writelines¸scCs|io td‚ndS(NsI/O operation on closed file(sselfscloseds ValueError(sself((s%/mit/python/lib/python2.3/StringIO.pysflush»s cCs=|io(|idi|iƒ7_g|_n|iSdS(sº Retrieve the entire contents of the "file" at any time before the StringIO object's close() method is called. The StringIO object can accept either Unicode or 8-bit strings, but mixing the two may take some care. If both are used, 8-bit strings that cannot be interpreted as 7-bit ASCII (that use the 8th bit) will cause a UnicodeError to be raised when getvalue() is called. sN(sselfsbuflistsbufsjoin(sself((s%/mit/python/lib/python2.3/StringIO.pysgetvalue¿s   (s__name__s __module__s__doc__s__init__s__iter__snextsclosesisattysseekstellsreadsNonesreadlines readlinesstruncateswrites writelinessflushsgetvalue(((s%/mit/python/lib/python2.3/StringIO.pysStringIO&s           c Cs8dk}|ido|id}nd}t|dƒiƒ}t|dƒiƒ}tƒ}x|d D]}|i |ƒqlW|i |dƒ|i ƒ|jo td‚n|iƒ}dG|GH|it|dƒƒ|i |dƒ|idƒdG|iƒ GHd G|iƒGH|iƒ}d G| GH|it|ƒ dƒ|it|ƒƒ}||jo td ‚n|it|ƒdƒ|iƒ}|d }|i|iƒt|ƒƒ|iƒ}||jo td ‚ndGt|ƒGdGHdG|iƒGH|iƒ|jo td‚n|iƒdS(Nis /etc/passwdsriþÿÿÿs write faileds File length =is First line =s Position =s Second line =sbad result after seek backiÿÿÿÿs#bad result after seek back from EOFsReads more liness bad length(ssyssargvsfilesopens readlinesslinessreadstextsStringIOsfslineswrites writelinessgetvalues RuntimeErrorstellslengthsseekslensreadlinesline2slistsclose( sfstextslinessline2ssysslistslengthsfilesline((s%/mit/python/lib/python2.3/StringIO.pystestÒsL                 s__main__N(s__doc__serrnosEINVALs ImportErrors__all__sStringIOstests__name__(s__all__sStringIOstestsEINVAL((s%/mit/python/lib/python2.3/StringIO.pys?s  ¬ (