База знанияИзпитен център
BGБългарски
Избери език13

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

Източници