WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

io.BufferedIOBase

Die Basisklasse beschreibt gepufferte Binärströme.

Version: Python 3.14; repository image, production runtime not attested

Syntax

io.BufferedIOBase()

Die Basisklasse beschreibt gepufferte Binärströme.

Das Schließen wird von IOBase geerbt. Der konkrete Strom implementiert die unterstützten Operationen read, read1, write und detach. Die bereitgestellten Methoden readinto und readinto1 füllen einen übergebenen beschreibbaren Puffer und liefern die Zahl der geschriebenen Bytes. readable() und writable() zeigen die Fähigkeiten des konkreten Stroms an. Bei b'abc' liefert der BufferedReader für read(2) nacheinander b'ab', b'c' und b''. Gegen Dateiende kann der Block kürzer sein. read(0) liefert auch vor dem Ende b''.

Schreiben auf diesen Leser löst io.UnsupportedOperation aus.

import io
with io.BufferedReader(io.BytesIO(b'xy')) as reader:
    assert reader.read(0)==b'' and reader.read(1)==b'x'
    assert reader.read(10)==b'y' and reader.read(1)==b''
    try: reader.write(b'z')
    except io.UnsupportedOperation: pass
    else: raise AssertionError
with io.BufferedWriter(io.BytesIO()) as writer:
    assert isinstance(writer, io.BufferedIOBase) and writer.write(b'x')==1
with io.BufferedReader(io.BytesIO(b'xyz')) as reader:
    target=bytearray(2)
    assert reader.readinto(target)==2 and target==b'xy'
    assert reader.readinto1(target)==1 and target==b'zy'
    assert reader.readinto(target)==0

Beispiele

import io
with io.BufferedReader(io.BytesIO(b"abc")) as stream:
    print(isinstance(stream, io.BufferedIOBase))
    print(stream.read(2), stream.read(2), stream.read(2))

Ergebnis

True
b'ab' b'c' b''

Schreiben auf diesen Leser löst io.UnsupportedOperation aus.

Quellen