CKTIS / Python
io.StringIO: lesen, schreiben und den gesamten Puffer abrufen
Mit `read()` liest du ab der aktuellen Position, mit `write()` baust du die Ausgabe schrittweise auf, und mit `getvalue()` holst du den gesamten Text, ohne die Position zu ändern.
Version: Python 3.12
Syntax
io.StringIO(initial_value='', newline='\n')
Methods on a StringIO instance (signature notation):
read(size=-1, /) -> str
write(s, /) -> int
getvalue() -> strIn Python 3.12 ist io.StringIO ein Textstrom im Arbeitsspeicher und keine Datei auf dem Datenträger. Du kannst einen Anfangstext als Eingabe übergeben und die Ausgabe in einem separaten, leeren Strom sammeln. Die Position liegt zunächst am Pufferanfang, auch wenn der Puffer bereits Text enthält.
read() liefert ab der aktuellen Position bis zum Ende einen str und rückt die Position über den gelesenen Text hinaus vor. read(n) liest höchstens n Zeichen, wenn n nicht negativ ist. Am Stromende liefert read() ''. write(s) schreibt einen str an der aktuellen Position, rückt die Position vor und liefert die Anzahl der geschriebenen Zeichen. Es hängt nicht immer an, sondern kann vorhandenen Text überschreiben. Übergibst du bytes an write(), wird TypeError ausgelöst.
getvalue() erwartet keine Argumente und liefert den gesamten Puffer als str, unabhängig von der aktuellen Position. Die Methode ändert die Position nicht und leert den Puffer nicht; seek(0) ist daher unnötig. Zeilenumbrüche werden wie bei read() entsprechend der Einstellung newline behandelt.
Rufe das Ergebnis vor dem Verlassen des with-Blocks ab: Beim Schließen wird der Puffer verworfen, und ein späterer Aufruf von getvalue() löst eine Ausnahme aus. Der zuvor abgerufene str bleibt verfügbar.
Beispiele
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)Ergebnis
'' [GO]
Das Beispiel liest `go` und erzeugt `[GO]` mit zwei Schreibvorgängen. `getvalue()` liefert das vollständige Ergebnis, ohne die Position zu ändern. Das anschließende `read()` liefert `''`, weil die Position weiterhin am Ende liegt. Das gespeicherte Ergebnis lässt sich nach dem Schließen ausgeben.
Zugehörige Lektionen
- Python · Lektion 32 · Mittlere Stufe · Version: 3
Quellen
- io — Core tools for working with streams: StringIO.getvalue()
- io — Core tools for working with streams: StringIO
- io — Core tools for working with streams: TextIOBase.read()
- io — Core tools for working with streams: TextIOBase.write()
- io — Core tools for working with streams: IOBase
- io — Core tools for working with streams: Overview