DESCRIPTION.

Ecrit des d'octets dans un objet BLOB.

SYNTAXE.

BLB_Blob.write ( donnees )

BLB_Blob ⇨ objet BLOB valide [ OBLIGATOIRE ]

.write ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

donnees ⇨ données à écrire [ OBLIGATOIRE ]

REMARQUES. 

donnees doit être un bytes ( ) quelconque mais valide.

Les octets contenus dans donnees seront écrite à partir de la position du curseur dans le BLOB, en remplaçant ceux déjà présents. 

L'appel de la méthode blob.write ( ) ne doit pas modifier la longueur du BLOB sinon Python lèvera une exception.

Il est vivement recommandé de toujours utiliser des BLOB, qui sont assimilables à des fichiers, dans un bloc de script with, qui gère efficacement la sortie et la fermeture du BLOB. Il ne devrait donc jamais utile de faire un appel à la méthode blob.close ( ).

EXEMPLE. 

import sqlite3

BDD_Connexion = sqlite3.connect ( ":memory:" )

CUR_Curseur = BDD_Connexion.cursor ( )

CUR_Curseur.execute ( " CREATE TABLE IF NOT EXISTS affichage ( langue TEXT , message BLOB ) " ) 

CUR_Curseur.execute ( " INSERT INTO affichage ( langue , message ) VALUES ( ? , zeroblob ( 20 ) ) " , ( "Francais" , ) ) 

CUR_Curseur.execute ( " INSERT INTO affichage ( langue , message ) VALUES ( ? , zeroblob ( 20 ) ) " , ( "Anglais" , ) )  

BDD_Connexion.commit ( ) 

CUR_Curseur.execute ( " SELECT * FROM affichage " )

for kfiche in CUR_Curseur.fetchall ( ) : print ( kfiche ) 

print ( )

with BDD_Connexion.blobopen ( "affichage" , "message" , 1 ) as BLB_Blob :

BLB_Blob.write ( b"Bonjour le Monde." )

with BDD_Connexion.blobopen ( "affichage" , "message" , 2 ) as BLB_Blob :

BLB_Blob.write ( b"Hello World." )

with BDD_Connexion.blobopen ( "affichage" , "message" , 1 ) as BLB_Blob :

print ( BLB_Blob.read ( ) )

with BDD_Connexion.blobopen ( "affichage" , "message" , 2 ) as BLB_Blob :

print ( BLB_Blob.read ( ) )

print ( )

CUR_Curseur.execute ( " SELECT * FROM affichage " )

for kfiche in CUR_Curseur.fetchall ( ) : print ( kfiche ) 

BDD_Connexion.close ( )