SQLite3::querySingle

(PHP 5 >= 5.3.0)

SQLite3::querySingle — Exécute une requête et retourne un seul résultat

Description

public mixed SQLite3::querySingle ( string $query [, bool $entire_row = false ] )

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

Liste de paramètres

query: La requête SQL à exécuter.
entire_row: Par défaut, cette fonction retourne la valeur de la première colonne retournée par la requête. Si ce paramètre 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ésultats, ou une tableau contenant toute la première ligne (si le paramètre entire_row vaut TRUE).

Si la requête est valide mais ne retourne aucun résultat, NULL sera retourné si entire_row 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));
?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

string(5) "Scott"
Array
(
    [username] => Scott
    [email] => scott@example.com
)