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

CKTIS / Python

io.StringIO : lire, écrire et récupérer tout le tampon

Utilisez `read()` pour lire depuis la position courante, `write()` pour construire la sortie par morceaux et `getvalue()` pour récupérer tout le texte sans déplacer la position.

Version : Python 3.12

Syntaxe

io.StringIO(initial_value='', newline='\n')

Methods on a StringIO instance (signature notation):
read(size=-1, /) -> str
write(s, /) -> int
getvalue() -> str

Dans Python 3.12, io.StringIO est un flux de texte stocké en mémoire, et non un fichier sur disque. Vous pouvez fournir un texte initial en entrée et utiliser un flux distinct et vide pour recueillir la sortie. La position initiale est au début du tampon, même si celui-ci contient déjà du texte.

read() renvoie un str de la position courante jusqu’à la fin et avance la position au-delà du texte lu. read(n) lit au plus n caractères si n est positif ou nul. À la fin du flux, read() renvoie ''. write(s) écrit un str à la position courante, avance cette position et renvoie le nombre de caractères écrits. Cette méthode n’ajoute pas toujours le texte à la fin : elle peut écraser du texte existant. Passer des bytes à write() lève une exception TypeError.

getvalue() ne prend aucun argument et renvoie tout le tampon sous forme de str, quelle que soit la position courante. La méthode ne déplace pas la position et ne vide pas le tampon : aucun appel à seek(0) n’est nécessaire. Les fins de ligne sont traitées comme avec read(), selon le réglage newline.

Récupérez le résultat avant de quitter le bloc with : la fermeture du flux libère son tampon et tout appel ultérieur à getvalue() lève une exception. Le str déjà récupéré reste disponible.

Exemples

import io

with io.StringIO("go") as src, io.StringIO() as dst:
    text = src.read()
    dst.write("[")
    dst.write(text.upper() + "]")

    position = dst.tell()
    result = dst.getvalue()
    assert dst.tell() == position
    print(repr(dst.read()))

print(result)

Résultat

''
[GO]

L’exemple lit `go` et construit `[GO]` en deux écritures. `getvalue()` récupère le résultat entier sans déplacer la position. Le `read()` suivant renvoie `''`, car la position est toujours à la fin. Le résultat enregistré peut être affiché après la fermeture du flux.

Leçons associées

  • Python · Leçon 32 · Intermédiaire · Version : 3

Sources