(PHP 5 >= 5.3.0, PHP 7)
SQLite3::querySingle — クエリを実行し、単一の結果を返す
クエリを実行し、単一の結果を返します。
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 )