DESCRIPTION.

Créer une instance d'un objet-ligne, sqlite3.Row ( ) hautement optimisée pour les objets sqlite3.Connection ( ).

SYNTAXE.

CUR_curseur.row_factory = sqlite3.Row

CUR_curseur = ⇨ objet curseur d'une connexion valide et vivant [ OBLIGATOIRE ]

row_factory ⇨ attribut définissant le type d'objet retourné pour la consultation [ OBLIGATOIRE ]

sqlite3.Row ⇨ les valeurs sont retournée dans un objet de type tkinter.Row [ OBLIGATOIRE ]

GENERALITES. 

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.

Un objet-ligne contient autant d'éléments, ayant la forme champ : valeur, qu'une la fiche de la table contient de champs. Bien qu'un objet-ligne ne soit pas un dict ( ), on pourra consulter ses éléments avec le mêmes protocoles de base. Par exemple, la méthode sqlite3.Row ( ).keys ( ) d'un objet-ligne retourne une list ( ) contenant toutes les clés des colonnes, c'est-à-dire les intitulés des champs de la table. On pourra ensuite, utiliser les éléments de cette list ( ) ou ses index pour retourner la valeur affectée à un champs de l'enregistrement.

La forme curseur.row_factory = None rétablit la forme par défaut de l'objet-curseur, qui retournera de nouveau des tuple ( ).

Le constructeur de classe sqlite3.Row ( ) ne doit être appelé qu'avec la syntaxe CUR_curseur.row_factory = sqlite3.Row.

Aller à tutoriel du module sqlite3.

Aller à présentation des commandes SQL.

LISTE DES METHODES DE LA CLASSE ROW. 

keys ( ) : retourne les entêtes des colonnes d'une table.