DESCRIPTION.

Retourne d'enregistrement suivant dans la pile des résultats trouvés suite à une requête SQL.  

SYNTAXE.

TPL_Donnees = CUR_Curseur.fetchone ( )

TPL_Donnees = ⇨ variable qui recevra la valeur [ optionnel ]

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

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

REMARQUES. 

La méthode curseur.fetchone ( ) permet de récupérer l'enregistrement suivant dans la pile des résultats, dans un tuple ( ) contenant la valeur des champs de la fiche. Si la pile des résultats est vide, la méthode curseur.fetchone ( ) retourne une None,

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

while True :

kfiche = CUR_Curseur.fetchone ( )

if kfiche == [ ] : break

print ( kfiche )

BDD_Connexion.close ( )