CKTIS / Python
io.StringIO: lezen, schrijven en de hele buffer ophalen
Gebruik `read()` om vanaf de huidige positie te lezen, `write()` om uitvoer in delen op te bouwen en `getvalue()` om alle tekst op te halen zonder de positie te wijzigen.
Versie: 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 is io.StringIO een tekststroom in het geheugen, geen bestand op schijf. Je kunt de invoertekst meteen meegeven en een aparte, lege stroom gebruiken om uitvoer te verzamelen. De beginpositie ligt aan het begin van de buffer, ook wanneer die al tekst bevat.
read() geeft een str terug vanaf de huidige positie tot het einde en schuift de positie voorbij de gelezen tekst. read(n) leest hoogstens n tekens als n niet-negatief is. Aan het einde van de stroom geeft read() '' terug. write(s) schrijft een str op de huidige positie, schuift de positie op en geeft het aantal geschreven tekens terug. Het voegt niet altijd achteraan toe: bestaande tekst kan worden overschreven. Als je bytes aan write() doorgeeft, krijg je een TypeError.
getvalue() neemt geen argumenten aan en geeft de hele buffer terug als str, ongeacht de huidige positie. Het wijzigt de positie niet en maakt de buffer niet leeg, dus seek(0) is niet nodig. Regeleinden worden op dezelfde manier geïnterpreteerd als bij read(), volgens de instelling newline.
Haal het resultaat op voordat je het with-blok verlaat: bij het sluiten van de stroom verdwijnt de buffer en geeft een latere aanroep van getvalue() een uitzondering. De eerder opgehaalde str blijft beschikbaar.
Voorbeelden
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)Resultaat
'' [GO]
Het voorbeeld leest `go` en bouwt `[GO]` op met twee schrijfopdrachten. `getvalue()` haalt het hele resultaat op zonder de positie te wijzigen. De volgende `read()` geeft `''` terug omdat de positie nog steeds aan het einde ligt. Je kunt het opgeslagen resultaat na het sluiten van de stroom afdrukken.
Gerelateerde lessen
- Python · Les 32 · Gemiddeld · Versie: 3
Bronnen
- 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