CKTIS / Python
io.StringIO: leer, escribir y recuperar todo el búfer
Usa `read()` para leer desde la posición actual, `write()` para construir la salida por partes y `getvalue()` para recuperar todo el texto sin cambiar la posición.
Versión: Python 3.12
Sintaxis
io.StringIO(initial_value='', newline='\n')
Methods on a StringIO instance (signature notation):
read(size=-1, /) -> str
write(s, /) -> int
getvalue() -> strEn Python 3.12, io.StringIO es un flujo de texto en memoria, no un archivo en disco. Puedes proporcionar un texto inicial como entrada y usar otro flujo, inicialmente vacío, para acumular la salida. La posición inicial está al principio del búfer, aunque ya contenga texto.
read() devuelve un str desde la posición actual hasta el final y avanza la posición más allá del texto leído. read(n) lee como máximo n caracteres si n no es negativo. Al final del flujo, read() devuelve ''. write(s) escribe un str en la posición actual, avanza la posición y devuelve el número de caracteres escritos. No siempre añade al final: puede sobrescribir texto existente. Pasar bytes a write() provoca un TypeError.
getvalue() no recibe argumentos y devuelve todo el búfer como str, independientemente de la posición actual. No cambia la posición ni vacía el búfer, por lo que no hace falta llamar a seek(0). Interpreta los saltos de línea igual que read(), según el ajuste newline.
Recupera el resultado antes de salir del bloque with: al cerrar el flujo se descarta su búfer y cualquier llamada posterior a getvalue() provoca una excepción. El str recuperado sigue disponible.
Ejemplos
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)Resultado
'' [GO]
El ejemplo lee `go` y construye `[GO]` mediante dos escrituras. `getvalue()` recupera todo el resultado sin cambiar la posición. El siguiente `read()` devuelve `''` porque la posición sigue al final. El resultado guardado se puede imprimir después de cerrar el flujo.
Lecciones relacionadas
- Python · Lección 32 · Intermedio · Versión: 3
Fuentes
- 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