oci_fetch
(PHP 5, PHP 7, PECL OCI8 >= 1.1.0)
oci_fetch — クエリの次の行を内部バッファに取得する
説明
oci_fetch
( resource $statement
) : bool
クエリの次の行を内部バッファに取得します。このバッファへは oci_result() でアクセスできます。あるいは、 oci_define_by_name() で事前に定義した変数を使ってアクセスすることもできます。
データの取得に関する全般的な情報は oci_fetch_array() を参照ください。
パラメータ
statement
- oci_parse() で作成して oci_execute() で実行した有効な OCI8 ステートメント ID、 あるいは
REF CURSOR
ステートメント ID。
返り値
成功した場合に true
、
statement
にもう行がない場合に
false
を返します。
例
例1 oci_fetch() での定義済みの変数の使用
<?php$conn = oci_connect('hr', 'welcome', 'localhost/XE');if (!$conn) { $e = oci_error(); trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);}$sql = 'SELECT location_id, city FROM locations WHERE location_id < 1200';$stid = oci_parse($conn, $sql);// 実行前に定義しておく必要がありますoci_define_by_name($stid, 'LOCATION_ID', $locid);oci_define_by_name($stid, 'CITY', $city);oci_execute($stid);// フェッチするたびに、次の行のデータが定義済みの変数に格納されますwhile (oci_fetch($stid)) { echo "Location id $locid is $city<br>\n";}// 表示:// Location id 1000 is Roma// Location id 1100 is Veniceoci_free_statement($stid);oci_close($conn);?>
例2 oci_fetch() と oci_result() の使用例
<?php$conn = oci_connect('hr', 'welcome', 'localhost/XE');if (!$conn) { $e = oci_error(); trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);}$sql = 'SELECT location_id, city FROM locations WHERE location_id < 1200';$stid = oci_parse($conn, $sql);oci_execute($stid);while (oci_fetch($stid)) { echo oci_result($stid, 'LOCATION_ID') . " is "; echo oci_result($stid, 'CITY') . "<br>\n";}// 表示:// 1000 is Roma// 1100 is Veniceoci_free_statement($stid);oci_close($conn);?>
注意
注意:
Oracle Database の暗黙の結果セットからの行は返しません。 代わりに oci_fetch_array() を使いましょう。
参考
- oci_define_by_name() - PHP の変数を、クエリで取得するカラムに関連づける
- oci_fetch_all() - クエリからの複数の行を二次元配列に取得する
- oci_fetch_array() - クエリの次の行を連想配列あるいは数値添字配列で返す
- oci_fetch_assoc() - クエリの次の行を連想配列で返す
- oci_fetch_object() - クエリの次の行をオブジェクトとして返す
- oci_fetch_row() - クエリの次の行を配列で返す
- oci_result() - フェッチした行からフィールドの値を取得する