CKTIS / Python
Écrire, lire et récupérer du texte avec io.StringIO
Utilisez `write()` pour écrire du texte en mémoire par morceaux, `read()` pour lire à partir de la position courante et `getvalue()` pour récupérer tout le tampon sans revenir au début.
Version : Python 3.12
Syntaxe
Python 3.12 — method signatures for a stream created with io.StringIO(...):
stream.write(s, /) -> int
stream.read(size=-1, /) -> str
stream.getvalue() -> strio.StringIO est un flux de texte en mémoire, pas un fichier sur disque. Un flux créé avec io.StringIO(texte) est positionné au début : une écriture immédiate peut donc écraser le texte initial. Pour ajouter du texte à la fin, appelez d’abord stream.seek(0, io.SEEK_END).
stream.write(s) écrit une chaîne str à la position courante, avance cette position et renvoie le nombre de caractères écrits, pas un nombre d’octets ni le texte. Passer des bytes lève TypeError ; pour des données binaires en mémoire, utilisez io.BytesIO. write() n’ajoute pas de fin de ligne. La valeur par défaut newline='\n' ne transforme pas les fins de ligne à l’écriture. Dans une signature, / indique que les paramètres qui le précèdent sont exclusivement positionnels.
stream.read(n) renvoie au plus n caractères sous forme de str à partir de la position courante et avance au-delà des caractères lus. Sans taille, avec None ou avec une taille négative, read() lit jusqu’à la fin ; à la fin, read() renvoie ''. Pour relire depuis le début, utilisez stream.seek(0).
stream.getvalue() renvoie tout le tampon sous forme de str sans modifier la position. Récupérez le résultat avant d’appeler close() ou de quitter le bloc with : la fermeture détruit le tampon et empêche d’utiliser ces méthodes, mais une chaîne déjà récupérée reste utilisable.
Exemples
import io
with io.StringIO("red blue") as source, io.StringIO() as target:
first = target.write(source.read(3).upper())
second = target.write(source.read().upper())
result = target.getvalue()
print(first, second)
print(repr(target.read()))
print(result)
Résultat
3 5 '' RED BLUE
Les lectures consomment `red`, puis ` blue`. Les deux écritures mettent ces morceaux en majuscules et renvoient `3` et `5` ; le deuxième morceau comprend une espace. `getvalue()` récupère tout `RED BLUE`, tandis que `target.read()` renvoie `''` parce que la position reste à la fin.
Leçons associées
- Python · Leçon 32 · Intermédiaire · Version : 3