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.