DB_common::limitQuery()

説明

SQL クエリを実行しますが、指定した行数のみしか取得しません。 MySQL の LIMIT オプションの挙動をエミュレートしたものです。

パラメータ

返り値

mixed - 結果を返すクエリ (例えば SELECT クエリなど) の場合は新しい DB_result オブジェクト、 データを操作するクエリ (例えば INSERT クエリなど) の場合は DB_OK、 あるいは失敗した場合には DB_Error オブジェクトを返します。

例外・エラー

注意

この関数は、スタティックにコールする ことはできません。

データベースの種類によっては、 query() に比べてそれほど速度が速くならないこともあります。 limitQuery() の利点は、 結果セット内の不要な行をできるだけ早いうちに削除しておけるという点にあります。 これにより、メモリの消費量を減らすことができます。

また、$from と $count はエスケープされないことに注意しましょう。 入力値のエスケープは自己責任で行う必要があります。 さもないと、SQL インジェクション攻撃に対して脆弱になってしまいます。

例

<?php
// $db という名前の DB オブジェクトを取得しているとします...
$res =& $db->limitQuery('SELECT * FROM foo', 49, 10);

if (PEAR::isError($res)) {
    die($res->getMessage());
}
?>

参照

query()