(PHP 5 >= 5.3.0, PHP 7, PHP 8)
SQLite3::querySingle — Exécute une requête et retourne un seul résultat
Exécute une requête et retourne un seul résultat.
query
La requête SQL à exécuter.
entireRow
Par défaut, cette fonction retourne la valeur de la première colonne retournée par la requête. Si entireRow
vaut true
, alors la fonction retournera un tableau contenant toute la première ligne.
Retourne la valeur de la première colonne du résultat, ou un tableau contenant toute la première ligne (si le paramètre entireRow
vaut true
).
Si la requête est valide mais ne retourne aucun résultat, null
sera retourné si entireRow
est false
, sinon un tableau vide est retourné.
Les requêtes invalides retourneront false
.
Exemple #1 Exemple avec SQLite3::querySingle()
<?php
$db = new SQLite3('mysqlitedb.db');
var_dump($db->querySingle('SELECT username FROM user WHERE userid=1'));
print_r($db->querySingle('SELECT username, email FROM user WHERE userid=1', true));
?>
Résultat de l'exemple ci-dessus est similaire à :
string(5) "Scott" Array ( [username] => Scott [email] => scott@example.com )