SQLite3::query
SQLite3::version
SQLite3
PHP Manual

# SQLite3::querySingle

(PHP 5 >= 5.3.0)

SQLite3::querySingle — クエリを実行し、単一の結果を返す

### 説明

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

クエリを実行し、単一の結果を返します。

### パラメータ

`query`

  実行したい SQL クエリ。

`entire_row`

  デフォルトでは、 querySingle() はクエリが返す結果の最初のカラムの値を返します。 `entire_row` が `TRUE` の場合は、最初の行全体を配列で返します。

### 返り値

結果の最初のカラムの値あるいは最初の行全体の配列 (`entire_row` が `TRUE` の場合) を返します。

クエリ自体は有効であるけれども結果が返されなかった場合の返り値は、 `entire_row` が `FALSE` なら `NULL`、 そうでなければ空の配列となります。

クエリが無効な場合やクエリの実行に失敗した場合は `FALSE` を返します。

### 例

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

上の例の出力は、 たとえば以下のようになります。

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

SQLite3::query
SQLite3::version
SQLite3
PHP Manual