Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

En 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