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

CKTIS / Python

Escribir, leer y recuperar texto con io.StringIO

Usa `write()` para escribir texto en memoria por partes, `read()` para leer desde la posición actual y `getvalue()` para recuperar todo el búfer sin volver al principio.

Versión: Python 3.12

Sintaxis

Python 3.12 — method signatures for a stream created with io.StringIO(...):
stream.write(s, /) -> int
stream.read(size=-1, /) -> str
stream.getvalue() -> str

io.StringIO es un flujo de texto en memoria, no un archivo en disco. Un flujo creado con io.StringIO(texto) se sitúa al principio, de modo que escribir de inmediato puede sobrescribir el texto inicial. Para añadir texto al final, llama primero a stream.seek(0, io.SEEK_END).

stream.write(s) escribe un str en la posición actual, avanza esa posición y devuelve el número de caracteres escritos, no el número de bytes ni el texto. Pasar bytes provoca TypeError; para datos binarios en memoria, usa io.BytesIO. write() no añade un salto de línea. El valor predeterminado newline='\n' no convierte los finales de línea al escribir. En una firma, / indica que los parámetros anteriores solo se pueden pasar por posición.

stream.read(n) devuelve como str hasta n caracteres desde la posición actual y la avanza más allá de lo leído. Sin indicar tamaño, con None o con un tamaño negativo, read() lee hasta el final; cuando ya está al final, devuelve ''. Usa stream.seek(0) para leer desde el principio.

stream.getvalue() devuelve todo el búfer como str sin cambiar la posición. Recupera el resultado antes de llamar a close() o de salir del bloque with: el cierre descarta el búfer e impide seguir usando estos métodos, pero la cadena ya recuperada sigue siendo utilizable.

Ejemplos

import io

with io.StringIO("red blue") as source, io.StringIO() as target:
    first = target.write(source.read(3).upper())
    second = target.write(source.read().upper())
    result = target.getvalue()
    print(first, second)
    print(repr(target.read()))

print(result)

Resultado

3 5
''
RED BLUE

Las lecturas consumen `red` y después ` blue`. Las dos escrituras guardan los fragmentos en mayúsculas y devuelven `3` y `5`; el segundo fragmento incluye un espacio. `getvalue()` recupera todo `RED BLUE`, aunque `target.read()` devuelve `''` porque la posición sigue al final.

Lecciones relacionadas

  • Python · Lección 32 · Intermedio · Versión: 3

Fuentes