dbx_fetch_row

(PHP 5 < 5.1.0, PECL dbx >= 1.1.0)

dbx_fetch_rowDBX_RESULT_UNBUFFERED フラグを指定した クエリ結果から、行を取得する

説明

dbx_fetch_row ( object $result_identifier ) : mixed

dbx_fetch_row() は、 DBX_RESULT_UNBUFFERED フラグを指定したクエリ結果から、行を取得します。

クエリで DBX_RESULT_UNBUFFERED が指定されていない場合、 dbx_fetch_row() は失敗します。なぜなら、すでにすべての 行は取得されて data プロパティに格納されているからです。

副作用として、dbx_fetch_row() のコールのたびに クエリ結果オブジェクトの rows プロパティの 値が加算されます。

パラメータ

result_identifier

dbx_query() が返す結果セット。

返り値

成功した場合にオブジェクトを返します。このオブジェクトには、 dbx_query() の結果における data プロパティの内容と同じ情報が含まれ、dbx_query() で設定した内容に応じてインデックスあるいはフィールド名でアクセスが可能です。

失敗した場合 (例: 行がもうない場合) には 0 を返します。

例1 返り値を処理する方法

<?php
$result 
dbx_query($link'SELECT id, parentid, description FROM table'DBX_RESULT_UNBUFFERED);

echo 
"<table>\n";
while (
$row dbx_fetch_row($result)) {
    echo 
"<tr>\n";
    foreach (
$row as $field) {
        echo 
"<td>$field</td>";
    }
    echo 
"</tr>\n";
}
echo 
"</table>\n";
?>

参考

  • dbx_query() - クエリを送信し、(ある場合には)結果を全て取得する