SQLite3::querySingle

Executes a query and returns a single result

&reftitle.description; public `mixed` `SQLite3::querySingle` `string` `query` `bool` `entire_row` false

Executes a query and returns a single result.

&reftitle.parameters;

`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.

&reftitle.returnvalues;

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;.

&reftitle.examples;

### `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));
    ?>

&example.outputs.similar;

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