CKTIS / Python
io.StringIO: четене, запис и извличане на целия буфер
Използвай `read()` за четене от текущата позиция, `write()` за събиране на изхода на части и `getvalue()` за извличане на целия текст без промяна на позицията.
Версия: Python 3.12
Синтаксис
io.StringIO(initial_value='', newline='\n')
Methods on a StringIO instance (signature notation):
read(size=-1, /) -> str
write(s, /) -> int
getvalue() -> strВ Python 3.12 io.StringIO е текстов поток в паметта, а не файл на диск. Можеш да подадеш начален текст като вход и да използваш отделен празен поток, за да събираш изхода. Началната позиция е в началото на буфера, дори ако той вече съдържа текст.
read() връща str от текущата позиция до края и премества позицията след прочетения текст. read(n) прочита най-много n знака, ако n е неотрицателно. В края на потока read() връща ''. write(s) записва str на текущата позиция, премества я напред и връща броя на записаните знаци. Не добавя винаги в края: може да презапише съществуващ текст. Подаването на bytes на write() предизвиква TypeError.
getvalue() не приема аргументи и връща целия буфер като str независимо от текущата позиция. Не премества позицията и не изпразва буфера, затова не е нужно да извикваш seek(0). Обработва знаците за край на реда както read(), според настройката newline.
Извлечи резултата, преди да излезеш от блока with: при затваряне на потока буферът се освобождава, а последващо извикване на getvalue() предизвиква изключение. Вече извлеченият str остава достъпен.
Примери
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)Резултат
'' [GO]
Примерът прочита `go` и съставя `[GO]` с два записа. `getvalue()` извлича целия резултат, без да мести позицията. Следващото извикване на `read()` връща `''`, защото позицията все още е в края. Запазеният резултат може да се отпечата след затваряне на потока.
Свързани уроци
- Python · Урок 32 · Средно · Версия: 3
Източници
- 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