トップページ　→関数リファレンス　→データベース関連　→ベンダー固有のモジュール　→OCI8　→OCI8 関数

関数・クラス解説

oci_field_size

version:PHP 5, PHP 7, PECL OCI8 >= 1.1.0 (公式)

フィールドサイズを返す

公式リファレンス

書式

oci_field_size ( resource $statement , mixed $field ) : int

説明

フィールド field のサイズを返します。

パラメータ

statement: 有効な OCI ステートメント ID。
field: フィールドのインデックス (1 から始まるもの) あるいは名前。

返値

フィールド field のサイズを表すバイト数、あるいはエラー時に FALSE を返します。

注意

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

サンプル

例1 oci_field_size() の例 


// 以下のテーブルを用意します
//   CREATE TABLE mytab (number_col NUMBER, varchar2_col varchar2(1), 
//                       clob_col CLOB, date_col DATE);

$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, OCI_DESCRIBE_ONLY); // 行をフェッチしない場合は OCI_DESCRIBE_ONLY を使います

echo "\n";
echo "";
echo "Name";
echo "Type";
echo "Length";
echo "\n";

$ncols = oci_num_fields($stid);

for ($i = 1; $i <= $ncols; $i++) {
    $column_name  = oci_field_name($stid, $i);
    $column_type  = oci_field_type($stid, $i);
    $column_size  = oci_field_size($stid, $i);

    echo "";
    echo "$column_name";
    echo "$column_type";
    echo "$column_size";
    echo "\n";
}

echo "\n";

// 出力は
//    Name           Type       Length
//    NUMBER_COL    NUMBER        22
//    VARCHAR2_COL  VARCHAR2       1
//    CLOB_COL      CLOB        4000
//    DATE_COL      DATE           7

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