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

CKTIS / Python

io.StringIO

StringIO пази текст в Unicode в паметта и при запис приема str.

Версия: Python 3.14; repository image, production runtime not attested

Синтаксис

io.StringIO(initial_value='', newline='\n')

StringIO пази текст в Unicode в паметта и при запис приема str.

При данни, завършващи с CRLF, newline=None нормализира края на реда до LF, а newline='' го запазва. Извикването на getvalue() след close() предизвиква ValueError. Дори при начален текст 'abc' позицията започва от нула, така че записването на 'X' дава 'Xbc'. След seek(0, 2) символът '!' се добавя в края. getvalue() връща целия текст без промяна на позицията.

Записът на bytes предизвиква TypeError.

import io
s=io.StringIO('éa')
assert s.tell()==0 and s.read(1)=='é'
s.seek(0)
assert s.write('猫')==1 and s.getvalue()=='猫a'
s.seek(0,2)
s.write('!')
assert s.getvalue()=='猫a!'
try: s.write(b'x')
except TypeError: pass
else: raise AssertionError
for newline,expected in [(None,'x\n'),('','x\r\n')]:
    with io.StringIO('x\r\n',newline=newline) as text:
        assert text.read()==expected
    try: text.getvalue()
    except ValueError: pass
    else: raise AssertionError

io.StringIO.read · io.StringIO.write · io.StringIO.getvalue

read(size) прочита от текущата позиция най-много size знака и я премества. При пропуснат или отрицателен размер чете до края, където връща празен низ. write връща броя записани знаци, а getvalue целия текст без промяна на позицията.

from io import StringIO
with StringIO("éxy") as s:
    assert s.read(1)=="é" and s.tell()==1
    assert s.write("A")==1 and s.getvalue()=="éAy" and s.tell()==2
    assert s.read(8)=="y" and s.read(1)==""
    s.seek(0)
    assert s.read()=="éAy"

Примери

import io
with io.StringIO("abc") as stream:
    stream.write("X")
    print(stream.getvalue())
    stream.seek(0, 2)
    stream.write("!")
    print(stream.getvalue())

Резултат

Xbc
Xbc!

Записът на bytes предизвиква TypeError.

Източници