Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources