DB_result::fetchInto()
DB_result::fetchInto() – 結果セットの行を変数に取得する
Synopsis
integer fetchInto (
array &$arr
,
integer $fetchMode =
= DB_FETCHMODE_DEFAULT
,
integer $rowNum
= = null
)
Description
結果セットからデータの行を取得し、指定した変数に保存した後で
結果ポインタを次の行に移動します。データの形式は、配列あるいは
オブジェクトとなります。
Parameter
-
mixed
$arr
-
行の内容を保存する変数への参照。
-
integer
$fetchMode
-
使用するフェッチモード。デフォルトは
DB_FETCHMODE_DEFAULT で、この場合は
DB の現在のフェッチモードを使用します。
DB の現在のデフォルトフェッチモードは、
setFetchMode() を使用して変更可能です。
とりうる値は以下のようになります。
-
DB_FETCHMODE_ORDERED
-
DB_FETCHMODE_ASSOC
-
DB_FETCHMODE_OBJECT
-
integer
$rowNum
-
取得する行の番号。0 は最初の行、1 は 2 番目の行、などといったように
なることに注意しましょう。
Return value
integer - 行が処理された場合に DB_OK、
結果セットの最後に到達した場合に NULL、
あるいは失敗した場合に DB_Error オブジェクトを返します。
Note
This function can not be called
statically.
Example
<?php
// $db という名前の DB オブジェクトが作成済みであると仮定します...
$res =& $db->query('SELECT * FROM mytable');
while ($res->fetchInto($row)) {
// DB のデフォルトフェッチモードが
// DB_FETCHMODE_ORDERED であると仮定します
echo $row[0] . "\n";
}
?>