WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

`io.StringIO.read`: Text aus dem Speicher lesen

Lies Text ab der aktuellen Position in einem `StringIO`-Stream und unterscheide diesen Lesevorgang vom Abruf des gesamten Puffers mit `getvalue()`.

Version: Python 3.12

Syntax

stream.read(size=-1, /) -> str  # Method signature; stream is an io.StringIO instance

io.StringIO.read ist eine Instanzmethode der Klasse StringIO aus dem Modul io. Sie liest ab der aktuellen Position in einem Textpuffer im Speicher und gibt einen str zurück, keine bytes. Ein neuer Stream steht am Anfang des Puffers, auch wenn du einen Anfangstext übergibst.

Übergib size als Positionsargument: stream.read(2) gibt höchstens zwei Zeichen zurück und rückt um die Anzahl der gelesenen Zeichen vor. Ohne Argument, mit einem negativen Wert oder mit None liest read() bis zum Streamende. Dort liefert ein weiterer Leseaufruf ''. Auch read(0) liefert '', ohne die Position zu ändern, und eignet sich daher nicht als Test auf das Streamende. Mit seek(0) kannst du erneut von vorn lesen.

write(s) schreibt Text an der aktuellen Position, rückt diese vor und gibt die Anzahl der geschriebenen Zeichen zurück. Dabei kann vorhandener Text überschrieben werden, statt neuen Text anzuhängen. getvalue() gibt den gesamten gepufferten Text zurück, ohne die Position zu ändern; ein vorheriges seek(0) ist nicht nötig. Rufe das Ergebnis innerhalb des with-Blocks ab: Beim Verlassen wird der Stream geschlossen und der Puffer verworfen. Ein anschließender Leseversuch löst ValueError aus.

Beispiele

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))

Ergebnis

'ab'
'cde'
''
'ab'
'ab|cde'

`repr()` macht das leere Ergebnis als `''` sichtbar. Nach `seek(0)` liefert die Eingabe erneut `'ab'`, während `getvalue()` den Text `'ab|cde'` aus dem Ausgabestream abruft, ohne ihn zurückzusetzen.

Zugehörige Lektionen

  • Python · Lektion 32 · Mittlere Stufe · Version: 3

Quellen