DESCRIPTION.

Lit, et retourne, un certain nombre d'octets dans un objet BLOB.

SYNTAXE.

BYT_Bytes = BLB_Blob.read ( quota )

BYT_Bytes = ⇨ variable qui recevra les données retournées [ optionnel ]

BLB_Blob ⇨ objet BLOB valide [ OBLIGATOIRE ]

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

quora ⇨ nombre de données à retourner [ optionnel ]

REMARQUES. 

quota doit être un int ( ) indiquant le nombre d'octets qui devront être lues et retournées, à partir de la position du curseur dans le BLOB. SI quota est supérieur à la quantité d'octets restants à lire, seuls ces octets seront retournés. Si quota est absent ou négatif, toutes les données restantes dans le fichier sont retournés. 

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