SQLite3::querySingle

(PHP 5 >= 5.3.0, PHP 7)

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

説明

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

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

パラメータ

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] => [email protected]
)