DESCRIPTION.

Teste si une chaine de caractères pourrait être une commande SQL valide.

SYNTAXE.

Variable = sqlite3.complete_statement ( commande )

Variable = ⇨ variable qui recevra la valeur [ optionnel ]

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

commande ⇨ chaine de caractères à tester [ OBLIGATOIRE ]

GENERALITES. 

commande doit être un str ( ) quelconque mais valide et se terminant par un point virgule (;).

L'appel de la méthode sqlite3.complete_statement ( ) retourne True si commande s'apparente à une commande SQL valide et complète. Si commande est une instruction SQL valide, la méthode  sqlite3.complete_statement ( ) retournera False si la totalité de commande n'est pas interprétable comme une commande SQL valide.

Si l'appel de la méthode sqlite3.complete_statement ( ) ne vérifie pas la syntaxe générale de commande et elle peut donc retourner True alors que commande ne sera pas accepté comme commande SQL valide par la gestion de la base de données.

La méthode sqlite3.complete_statement ( ) pourra être utilisée, par exemple, pour tester si une saisie de l'utilisateur peut être valide dans un appel de la méthode objet.execute ( ), ou s'il faut lui suggérer de la corriger.

Aller à présentation des commandes SQL pour plus de détails sur les principales commandes SQL.

EXEMPLE. 

import sqlite3

BDD_Connexion = sqlite3.connect ( ":memory:" )

print ( sqlite3.complete_statement ( " INSERT INTO matable ( ) VALUES ( ) ; " ) )

print ( sqlite3.complete_statement ( " INSERT INTO matable ( ) VALUES ( ) " ) )

print ( sqlite3.complete_statement ( " SELECT * FROM matable " ) )

print ( sqlite3.complete_statement ( " SELECT * FROM matable ; " ) )

print ( sqlite3.complete_statement ( " SELECT FROM ; " ) )

BDD_Connexion.close ( )