CKTIS / Python
Text mit io.StringIO schreiben, lesen und abrufen
Mit `write()` schreibst du Text stückweise in den Speicher, mit `read()` liest du ab der aktuellen Position und mit `getvalue()` rufst du den ganzen Puffer ab, ohne zurückzuspringen.
Version: Python 3.12
Syntax
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 ist ein Textstrom im Arbeitsspeicher, keine Datei auf einem Datenträger. Ein mit io.StringIO(text) erzeugter Strom beginnt an Position null. Wenn du sofort schreibst, kannst du den Anfangstext überschreiben. Zum Anhängen rufst du zuerst stream.seek(0, io.SEEK_END) auf.
stream.write(s) schreibt einen str an der aktuellen Position, rückt diese vor und gibt die Anzahl der geschriebenen Zeichen zurück, nicht die Anzahl der Bytes oder den Text. bytes löst einen TypeError aus; für Binärdaten im Speicher ist io.BytesIO gedacht. write() fügt keinen Zeilenumbruch hinzu. Mit der Voreinstellung newline='\n' werden Zeilenenden beim Schreiben nicht umgewandelt. In einer Signatur kennzeichnet / alle Parameter davor als rein positional.
stream.read(n) liest ab der aktuellen Position bis zu n Zeichen als str und rückt um die gelesenen Zeichen vor. Ohne Größenangabe oder mit None oder einer negativen Größe liest read() bis zum Ende. Am Ende liefert read() den leeren String ''. Mit stream.seek(0) liest du wieder von vorn.
stream.getvalue() liefert den gesamten Puffer als str, ohne die Position zu ändern. Hole das Ergebnis vor close() oder vor dem Verlassen des with-Blocks: Beim Schließen wird der Puffer verworfen, und die Methoden sind nicht mehr nutzbar. Ein bereits abgerufener String bleibt verwendbar.
Beispiele
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)
Ergebnis
3 5 '' RED BLUE
Gelesen werden zuerst `red` und dann ` blue`. Die beiden Schreibaufrufe schreiben die Teile in Großbuchstaben und liefern `3` und `5`; der zweite Teil enthält ein Leerzeichen. `getvalue()` liefert das ganze `RED BLUE`, obwohl `target.read()` am unveränderten Ende `''` zurückgibt.
Zugehörige Lektionen
- Python · Lektion 32 · Mittlere Stufe · Version: 3