Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

io.BufferedIOBase

Cette classe définit l’interface des flux binaires tamponnés.

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

Syntaxe

io.BufferedIOBase()

Cette classe définit l’interface des flux binaires tamponnés.

La fermeture est héritée de IOBase. Le flux concret implémente les opérations prises en charge parmi read, read1, write et detach. Les méthodes fournies readinto et readinto1 remplissent le tampon modifiable passé en argument et renvoient le nombre d’octets écrits. readable() et writable() indiquent les opérations disponibles. Sur b'abc', les appels à read(2) du BufferedReader donnent b'ab', b'c' puis b''. Le dernier bloc de données peut être court. read(0) renvoie aussi b'' avant la fin.

Écrire dans ce lecteur lève io.UnsupportedOperation.

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

Exemples

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))

Résultat

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

Écrire dans ce lecteur lève io.UnsupportedOperation.

Sources