CKTIS / Python
io.StringIO
StringIO conserve du texte Unicode en mémoire et accepte des str en écriture.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
io.StringIO(initial_value='', newline='\n')StringIO conserve du texte Unicode en mémoire et accepte des str en écriture.
Pour des données terminées par CRLF, newline=None normalise la fin de ligne en LF et newline='' la conserve. Appeler getvalue() après close() lève ValueError. Même avec le texte initial 'abc', le curseur commence à zéro, donc écrire 'X' donne 'Xbc'. Après seek(0, 2), écrire '!' ajoute ce caractère à la fin. getvalue() renvoie tout le texte sans déplacer le curseur.
Écrire des bytes lève TypeError.
import io
s=io.StringIO('éa')
assert s.tell()==0 and s.read(1)=='é'
s.seek(0)
assert s.write('猫')==1 and s.getvalue()=='猫a'
s.seek(0,2)
s.write('!')
assert s.getvalue()=='猫a!'
try: s.write(b'x')
except TypeError: pass
else: raise AssertionError
for newline,expected in [(None,'x\n'),('','x\r\n')]:
with io.StringIO('x\r\n',newline=newline) as text:
assert text.read()==expected
try: text.getvalue()
except ValueError: pass
else: raise AssertionError
io.StringIO.read · io.StringIO.write · io.StringIO.getvalue
read(size) lit au plus size caractères à partir du curseur et l’avance. Une taille omise ou négative lit jusqu’à la fin, où la lecture donne la chaîne vide. write renvoie le nombre de caractères écrits et getvalue tout le texte sans déplacement.
from io import StringIO
with StringIO("éxy") as s:
assert s.read(1)=="é" and s.tell()==1
assert s.write("A")==1 and s.getvalue()=="éAy" and s.tell()==2
assert s.read(8)=="y" and s.read(1)==""
s.seek(0)
assert s.read()=="éAy"
Exemples
import io
with io.StringIO("abc") as stream:
stream.write("X")
print(stream.getvalue())
stream.seek(0, 2)
stream.write("!")
print(stream.getvalue())
Résultat
Xbc Xbc!
Écrire des bytes lève TypeError.