CKTIS / Python
`io.StringIO.read` : lire du texte en mémoire
Lisez à partir de la position courante d’un flux texte `StringIO` et distinguez cette lecture de la récupération du tampon entier avec `getvalue()`.
Version : Python 3.12
Syntaxe
stream.read(size=-1, /) -> str # Method signature; stream is an io.StringIO instanceio.StringIO.read est une méthode d’instance de la classe StringIO du module io. Elle lit à partir de la position courante dans un tampon de texte en mémoire et renvoie un str, pas des bytes. Un nouveau flux est positionné au début du tampon, même si vous fournissez un texte initial.
Passez size comme argument positionnel : stream.read(2) renvoie au plus deux caractères et avance d’autant de caractères que ceux lus. Sans argument, avec une taille négative ou avec None, read() lit jusqu’à la fin du flux. À la fin, une nouvelle lecture renvoie ''. read(0) renvoie aussi '', sans changer la position : ce n’est donc pas un test de fin de flux. Appelez seek(0) pour relire depuis le début.
write(s) écrit à la position courante, fait avancer cette position et renvoie le nombre de caractères écrits. Cette méthode peut remplacer du texte existant plutôt qu’en ajouter à la fin. getvalue() renvoie tout le texte du tampon sans déplacer la position : inutile d’appeler seek(0) auparavant. Récupérez le résultat dans le bloc with : à sa sortie, le flux est fermé et le tampon est libéré. Toute tentative de lecture après fermeture lève ValueError.
Exemples
import io
with io.StringIO('abcde') as source, io.StringIO() as target:
first = source.read(2)
rest = source.read()
print(repr(first))
print(repr(rest))
print(repr(source.read(1)))
source.seek(0)
print(repr(source.read(2)))
target.write(first)
target.write('|')
target.write(rest)
result = target.getvalue()
print(repr(result))Résultat
'ab' 'cde' '' 'ab' 'ab|cde'
`repr()` rend le résultat vide visible sous la forme `''`. Après `seek(0)`, le flux d’entrée renvoie de nouveau `'ab'`, tandis que `getvalue()` récupère `'ab|cde'` dans le flux de sortie sans revenir à son début.
Leçons associées
- Python · Leçon 32 · Intermédiaire · Version : 3