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

# dbx_fetch_row

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

dbx_fetch_row — `DBX_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() - クエリを送信し、(ある場合には)結果を全て取得する