oci_fetch_row
oci_field_is_null
OCI8 関数
PHP Manual

# oci_fetch

(PHP 5, PECL OCI8 >= 1.1.0)

oci_fetch — クエリの次の行を内部バッファに取得する

### 説明

bool oci_fetch ( resource `$statement` )

クエリの次の行を内部バッファに取得します。このバッファへは 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 Venice
oci_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 Venice
oci_free_statement($stid);
oci_close($conn);
?>`

### 注意

> 注意: PHP 5.0.0 より前のバージョンでは、かわりに ocifetch() を使用します。現在のバージョンでは、古い関数名もまだ使えます。 しかし、これは廃止予定であり非推奨です。

### 参考

- oci_define_by_name() - PHP の変数を、クエリで取得するカラムに関連づける
- oci_fetch_all() - クエリからの複数の行を二次元配列に取得する
- oci_fetch_array() - クエリの次の行を連想配列あるいは数値添字配列で返す
- oci_fetch_assoc() - クエリの次の行を連想配列で返す
- oci_fetch_object() - クエリの次の行をオブジェクトとして返す
- oci_fetch_row() - クエリの次の行を配列で返す
- oci_result() - フェッチした行からフィールドの値を取得する

oci_fetch_row
oci_field_is_null
OCI8 関数
PHP Manual