SQLite3::querySingle

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

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

説明

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

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

パラメータ

query

実行したい SQL クエリ。

entireRow

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

戻り値

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

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

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top