PHP マニュアル
前のページ |  | 次のページ

# PDOStatement::getColumnMeta

(no version information, might be only in CVS)

PDOStatement::getColumnMeta -- 結果セットのカラムに対するメタデータを返す

## 説明

mixed PDOStatement::getColumnMeta ( int column )

結果セットの 0 から始まるカラムに対するメタデータを連想配列で取得します。

警告
PDO ドライバの全てが PDOStatement::getColumnMeta() をサポートしているわけではありません。

## パラメータ

column

  結果セットの 0 から始まるカラムを指定します。

## 返り値

1つのカラムについてのメタデータに相当する次の値を含んだ連想配列を返します。

表 1. カラムのメタデータ

名前 | 値
--- | ---
native_type | カラム値を表現するために使用される PHP のネイティブ型
driver:decl_type | データベースにおけるカラム値を表現するために使用される SQL 型。 もし、結果セットのカラムが関数から返される場合、 この値は PDOStatement::getColumnMeta() よって返されません。
flags | このカラムにセットされているあらゆるフラグ
name | データベースによって返されるこのカラムの名前
len | カラム長。浮動小数点数以外の型については通常 -1 となる。
precision | カラムの数値精度。浮動小数点数以外の型については通常 0 となる。
pdo_type | PDO::PARAM_* 定数によって表現されるカラムの型

要求されたかラムが結果セットに存在しない、 もしくは結果セットが存在しない場合、`FALSE` を返します。

## 例

例 1. カラムのメタデータを取得する

以下の例は、PDO_SQLITE ドライバでの関数 (COUNT) によって生成された単一のカラムに対するメタデータの 取得結果を表示します。

`<?php $select = $DB->query('SELECT COUNT(*) FROM fruit'); $meta = $select->getColumnMeta(0); var_dump($meta); ?>`

上の例の出力は以下となります。

    array(6) {
      ["native_type"]=>
      string(7) "integer"
      ["flags"]=>
      array(0) {
      }
      ["name"]=>
      string(8) "COUNT(*)"
      ["len"]=>
      int(-1)
      ["precision"]=>
      int(0)
      ["pdo_type"]=>
      int(2)
    }

## 参考

PDOStatement::columnCount()
PDOStatement::rowCount()

前のページ | ホーム | 次のページ
PDOStatement::getAttribute | 上に戻る | PDOStatement::nextRowset