CKTIS / Python
`io.StringIO.read`: tekst uit het geheugen lezen
Lees vanaf de huidige positie in een `StringIO`-tekststream en onderscheid dat van het ophalen van de volledige buffer met `getvalue()`.
Versie: Python 3.12
Syntax
stream.read(size=-1, /) -> str # Method signature; stream is an io.StringIO instanceio.StringIO.read is een instantiemethode van de klasse StringIO uit de module io. De methode leest vanaf de huidige positie in een tekstbuffer in het geheugen en geeft een str terug, geen bytes. Een nieuwe stream staat aan het begin van de buffer, ook als je begintekst meegeeft.
Geef size als positioneel argument door: stream.read(2) geeft hoogstens twee tekens terug en schuift op met het aantal gelezen tekens. Zonder argument, met een negatieve waarde of met None leest read() tot het einde van de stream. Aan het einde geeft een volgende leesaanroep '' terug. Ook read(0) geeft '' terug zonder de positie te wijzigen en is dus geen test op het einde van de stream. Gebruik seek(0) om opnieuw vanaf het begin te lezen.
write(s) schrijft tekst op de huidige positie, schuift die vooruit en geeft het aantal geschreven tekens terug. De methode kan bestaande tekst overschrijven in plaats van tekst achteraan toe te voegen. getvalue() geeft alle tekst in de buffer terug zonder de positie te wijzigen; vooraf seek(0) aanroepen is dus niet nodig. Haal het resultaat op binnen het with-blok: bij het verlaten ervan wordt de stream gesloten en de buffer weggegooid. Lezen na het sluiten leidt tot ValueError.
Voorbeelden
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))Resultaat
'ab' 'cde' '' 'ab' 'ab|cde'
`repr()` maakt het lege resultaat zichtbaar als `''`. Na `seek(0)` levert de invoerstream opnieuw `'ab'`, terwijl `getvalue()` de tekst `'ab|cde'` uit de uitvoerstream haalt zonder die terug te zetten.
Gerelateerde lessen
- Python · Les 32 · Gemiddeld · Versie: 3