SQLite3::querySingle

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

説明

public mixed SQLite3::querySingle(string $query, bool $entireRow = false)

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

パラメータ

query: 実行したい SQL クエリ。
entireRow: デフォルトでは、querySingle はクエリが返す結果の最初のカラムの値を返します。 entireRow が true の場合は、最初の行全体を配列で返します。

戻り値

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

クエリ自体は有効であるけれども結果が返されなかった場合の戻り値は、 entireRow が 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
)