CKTIS / Python
`io.StringIO.read`: leer texto en memoria
Lee desde la posición actual de un flujo de texto `StringIO` y distingue esa lectura de la recuperación del búfer completo con `getvalue()`.
Versión: Python 3.12
Sintaxis
stream.read(size=-1, /) -> str # Method signature; stream is an io.StringIO instanceio.StringIO.read es un método de instancia de la clase StringIO del módulo io. Lee desde la posición actual de un búfer de texto en memoria y devuelve un str, no bytes. Un flujo nuevo empieza al principio del búfer, aunque le proporciones texto inicial.
Pasa size como argumento posicional: stream.read(2) devuelve como máximo dos caracteres y avanza tantos caracteres como haya leído. Sin argumento, con un tamaño negativo o con None, read() lee hasta el final del flujo. Al llegar al final, otra lectura devuelve ''. read(0) también devuelve '' sin mover la posición, así que no sirve para detectar el fin del flujo. Usa seek(0) para volver a leer desde el principio.
write(s) escribe texto en la posición actual, la hace avanzar y devuelve el número de caracteres escritos. Puede sobrescribir texto existente en lugar de añadirlo al final. getvalue() devuelve todo el texto del búfer sin cambiar la posición, así que no hace falta llamar antes a seek(0). Recupera el resultado dentro del bloque with: al salir se cierra el flujo y se descarta el búfer. Leer después del cierre provoca un ValueError.
Ejemplos
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))Resultado
'ab' 'cde' '' 'ab' 'ab|cde'
`repr()` muestra el resultado vacío como `''`. Tras `seek(0)`, el flujo de entrada vuelve a dar `'ab'`, mientras que `getvalue()` recupera `'ab|cde'` del flujo de salida sin volver a su inicio.
Lecciones relacionadas
- Python · Lección 32 · Intermedio · Versión: 3