(PHP 5 >= 5.3.0, PHP 7, PHP 8)
SQLite3::querySingle — Exécute une requête et retourne un seul résultat
Description
public
SQLite3::querySingle(string
$query
, bool
$entireRow
=
false
): mixed
Liste de paramètres
-
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.
Valeurs de retour
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
.
Exemples
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
)