SQLite3::querySingle

(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

Exécute une requête et retourne un seul résultat.

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
)