sqlite_query

(PHP 5)

sqlite_query

(no version information, might be only in CVS)

SQLiteDatabase->query -- Exécute une requête SQLite et lit le résultat

Description

resource sqlite_query ( resource dbhandle, string query )

resource sqlite_query ( string query, resource dbhandle )

Style orienté objet (méthode)

class SQLiteDatabase {

SQLiteResult query ( string query )

}

sqlite_query() exécute la requête SQL query dans la base SQLite dbhandle.

Retourne une ressource de résultat ou FALSE en cas d'échec. Pour les requêtes qui retournent des lignes, la ressource de résultat peut être utilisée avec les fonctions comme sqlite_fetch_array() et sqlite_seek().

Indépendamment du type, cette fonction retournera FALSE si la requête échoue.

sqlite_query() retourne un résultat bufferisé. C'est très pratique pour des résultats de petites tailles, où vous aurez besoin d'accéder aléatoirement aux lignes. Les résultats bufferisés allouent la mémoire nécessaire pour stocker tout le résultat, et ne se termineront qu'une fois toutes ces données lues. Si vous n'avez besoin que d'un accès séquentiel aux données, il est recommandé d'utiliser sqlite_unbuffered_query().

Note : Deux syntaxes alternatives sont supportées pour assurer la compatibilité avec les autres bases de données (telles que MySQL) : La forme recommandée est la première, où le paramètre dbhandle est le premier dans la fonction.

Avertissement

SQLite va exécuter les requêtes multiples, séparées par des points-virgules, ce qui vous permet d'exécuter plusieurs requêtes SQL en une seule fois.

Lorsque vous exécutez des requêtes multiples, la valeur retournée par cette fonction sera FALSE si une erreur s'est produite, mais indéfini dans les autres cas (cela peut être TRUE en cas de succès, ou bien elle peut retourner un résultat).

Voir aussi sqlite_unbuffered_query() et sqlite_array_query().