DESCRIPTION.

Crée un nouvel un objet curseur pour accéder aux enregistrements de la base de données.

SYNTAXE.

CUR_Curseur = BDD_Base.cursor ( forme )

CUR_Curseur = ⇨ variable qui recevra le nouvel objet curseur [ optionnel ]

BDD_Base ⇨ objet connexion avec une base de données [ OBLIGATOIRE ]

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

forme ⇨ type des objets retournés [ optionnel ]

REMARQUES. 

forme doit être une référence à un type d'objet : curseur, ligne, ... , valide indiquznt sous quelle forme sera retourné les valeurs d'un enregistrement d'une table de la base de données, lors d'une consultation.

L'appel de la méthode objet.cursor ( ) crée une instance de la classe sqlite3.Cursor ( ) et le lie à la base de données connectée par l'objet-connexion appelant. Un objet curseur créée avec objet.cursor ( ) sera fermée avec l'appel de la méthode objet.close ( ) de l'objet-connexion.

La création d'un objet curseur est facultative. Toutes les méthodes de la classe sqlite3.Cursor ( ) : curseur.execute ( ), curseur.fetchall ( ), ... , peuvent être appelées anonymement. Dans ce cas Python crée un objet curseur éphémère, utilise la méthode appelée, directement, de cette objet curseur éphémère, puis ferme cette objet curseur éphémère. Toutefois la création d'un objet curseur avec la méthode CUR_Curseur = BDD_Basse.cursor ( ) est vivement conseillée. 

Voir la classe sqlite3.Cursor ( ) pour plus d'information sur les objets curseur.

EXEMPLE. 

import sqlite3

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

CUR_Curseur = BDD_Connexion.cursor ( )

CUR_Curseur.execute ( " CREATE TABLE IF NOT EXISTS Contact ( Prenon TEXT , Nom TEXT , Site TEXT ) " )

kcontact = ( "Origine" , "NERD" , "Mon Python" )

CUR_Curseur.execute ( " INSERT INTO Contact ( Prenon , Nom , Site ) VALUES ( ? , ? , ? ) " , kcontact )

BDD_Connexion.commit ( )

BDD_Connexion.close ( )