(PHP 5 >= 5.3.0, PHP 7)
SQLite3::querySingle — Executes a query and returns a single result
public SQLite3::querySingle ( string $query [, bool $entire_row = false ] ) : mixed
Executes a query and returns a single result.
query
The SQL query to execute.
entire_row
By default, querySingle() returns the value of the first column returned by the query. If entire_row
is true
, then it returns an array of the entire first row.
Returns the value of the first column of results or an array of the entire first row (if entire_row
is true
).
If the query is valid but no results are returned, then null
will be returned if entire_row
is false
, otherwise an empty array is returned.
Invalid or failing queries will return false
.
Example #1 SQLite3::querySingle() example
<?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)); ?>
The above example will output something similar to:
string(5) "Scott" Array ( [username] => Scott [email] => [email protected] )
© 1997–2020 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://www.php.net/manual/en/sqlite3.querysingle.php