oci_field_is_null

(PHP 5, PHP 7, PECL OCI8 >= 1.1.0)

oci_field_is_null — フェッチしたフィールドが NULL であるかどうかを確認する

説明

bool oci_field_is_null ( resource $statement , mixed $field )

statement の現在の行の、指定したフィールド field が NULL であるかどうかを調べます。

パラメータ

statement: 有効な OCI ステートメント ID。
field: (1 から始まる) フィールド番号、またはフィールド名。

返り値

field が NULL の場合に TRUE、それ以外の場合に FALSE を返します。

例

例1 oci_field_name() の例


<?php

// 以下のテーブルを用意します
//   CREATE TABLE mytab (c1 NUMBER);
//   INSERT INTO mytab VALUES (1);
//   INSERT INTO mytab VALUES (NULL);

$conn = oci_connect("hr", "hrpwd", "localhost/XE");
if (!$conn) {
    $m = oci_error();
    trigger_error(htmlentities($m['message']), E_USER_ERROR);
}

$stid = oci_parse($conn, "SELECT * FROM mytab");
oci_execute($stid);

while (($row = oci_fetch_array($stid, OCI_RETURN_NULLS)) != false) {
    $ncols = oci_num_fields($stid);
    for ($col = 1; $col <= $ncols; $col++) {
        var_dump(oci_field_is_null($stid, $col));
    }    
}

// 出力は
//    bool(false)
//    bool(true)

oci_free_statement($stid);
oci_close($conn);

?>

注意

注意:
PHP バージョン 5.0.0 以前では、代わりに ocicolumnisnull() を使用しなければなりません。まだこの名前を使用することができ、下位互換性のため oci_field_is_null() への別名として残されていますが、推奨されません。