DESCRIPTION.

Retourne tous les enregistrements restant dans la pile des résultats trouvés, suite à une requête SQL. 

SYNTAXE.

LST_Donnees = CUR_Curseur.fetchall ( )

LST_Donnees = ⇨ variable qui recevra la valeur [ optionnel ]

CUR_Curseur ⇨ objet curseur de la base de données [ OBLIGATOIRE ]

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

REMARQUES. 

La méthode curseur.fetchall ( ) permet de récupérer tous les enregistrements, restant dans la pile des résultats, dans une list ( ) composée de tuple ( ). Chaque tuple ( ) représente un enregistrement de la table, et les éléments d'un tuple ( ) retournent la valeur du champ correspondant. Si la pile des résultats est vide, la méthode curseur.fetchall ( ) retourne une list ( ) vide, [ ],

Pour connaitre les entêtes des colonnes, ou noms des champs, il faut associer à l'attribut curseur.row_factory l'objet-ligne : sqlite3.Row. Les enregistrements retournées par le méthodes curseur.fetchall ( ),  curseur.fetchone ( ) et curseur.fetchmany ( ), ne seront plus des tuple ( ) avec la valeurs du champs des objets-ligne.

Voir la classe sqlite3.Row ( ) pour plus de détails sur les objets lignes.

EXEMPLE. 

import sqlite3

BDD_Connexion = sqlite3.Connection ( "ON - sgbd.db" )

CUR_Curseur = sqlite3.Cursor ( BDD_Connexion )

CUR_Curseur.execute ( " CREATE TABLE IF NOT EXISTS MonCarnet ( Nom text , Taille real , Poids integer ) " )

kclientes = [ ( "Marie" , 158.5 , 58 ) , ( "Emanuelle" , 160 , 52 ) , ( "Parker" , 176.3 , 64 ) , ( "Cécile" , 171 , 62 ) ]

CUR_Curseur.executemany ( " INSERT INTO MonCarnet ( Nom , Taille , Poids ) VALUES ( ? , ? , ? ) " , kclientes )

BDD_Connexion.commit ( )

CUR_Curseur.execute ( " SELECT * FROM MonCarnet " )

print ( CUR_Curseur.fetchall ( ) )

BDD_Connexion.close ( )