pure.db.oci8
[ class tree: pure.db.oci8 ] [ index: pure.db.oci8 ] [ all elements ]

Class: OciResultSet

Source Location: /package/pure/db/oci8/OciResultSet.inc

Class Overview

PURE_Class
   |
   --OciResultSet

OCI8を利用したステートメントから結果セットのみを管理するクラスです。 OciStatementクラスのfetchメソッドが返します。


Methods



Class Details

[line 25]
OCI8を利用したステートメントから結果セットのみを管理するクラスです。 OciStatementクラスのfetchメソッドが返します。

OciResultSetクラスはOciStatementクラスのfetchメソッドが生成した後は、ステートメントとは無関係になります。 取得されたOciResultSetクラスのインスタンスは取得元のOciStatementクラスのインスタンスに依存しません。 fetchメソッド発行時の結果のスナップショットを保持します。 そのため、ステートメントをクローズした後でもOciResultSetクラスのインスタンスは取得した内容を保持し続けます。




[ Top ]


Class Methods


constructor __construct [line 47]

OciResultSet __construct( array $fields, array $values)

コンストラクタです。

通常、OciResultSetクラスは独自にインスタンスを作成しないでください。 OciResultSetクラスのインスタンスはOciStatementクラスのfetchメソッドが生成します。




Tags:

access:  public


Parameters:

array   $fields   フィールド情報を保持する配列
array   $values   フィールド値を保持する配列

[ Top ]

method fieldCount [line 58]

int fieldCount( )

カラム数を取得します。



Tags:

return:  カラム数
access:  public


[ Top ]

method fieldName [line 73]

string fieldName( int $col)

カラムの名前を取得します。

$col引数はカラムのインデックスを整数値で指定します。 インデックスの範囲は1~fieldCountメソッドの返り値の範囲になります。




Tags:

return:  カラム名
throws:  EIlligalParameterException インデックスが不正
access:  public


Parameters:

int   $col   カラムインデックス

[ Top ]

method fieldPrecision [line 108]

int fieldPrecision( string $name)

指定の名前のカラムの精度を取得します。



Tags:

return:  カラムの精度
throws:  EOciException フィールドが見付からない
access:  public


Parameters:

string   $name   カラム名

[ Top ]

method fieldScale [line 125]

int fieldScale( string $name)

指定の名前のカラムの位取りを取得します。



Tags:

return:  カラムの位取り
throws:  EOciException フィールドが見付からない
access:  public


Parameters:

string   $name   カラム名

[ Top ]

method fieldType [line 91]

string fieldType( string $name)

指定の名前のカラムの型を取得します。



Tags:

return:  カラムの型
throws:  EOciException フィールドが見付からない
access:  public


Parameters:

string   $name   カラム名

[ Top ]

method isNull [line 196]

bool isNull( string $name)

結果からカラムがNULLか否かを取得します。



Tags:

return:  カラムがNULLか否か
throws:  EOciException レコードが取得されていない、フィールド名が不明
access:  public


Parameters:

string   $name   カラム名

[ Top ]

method value [line 149]

mixed value( string $name, [mixed $nvl = null])

結果からカラムの値を取得します。

PHP標準のOCI8関数とことなり、OciStatementクラスはOracleのデータ型にある程度即した型で返却します。 カラムがNULL値の場合には明示的にnullが返されます。 カラムがNUMBER型の場合、位取りが0ならばint型、それ以外はfloat型で返します。 カラムがDATE型の場合、OciConnectionクラスが設定したNLS_DATE_FORMATパラメータの設定値の状態でパース可能であればUNIX EPOCHによる日時 (整数値) に変換して返却します。 それ以外はOCI8関数の動作に従います。




Tags:

return:  カラムの値
throws:  EOciException レコードが取得されていない、フィールド名が不明
access:  public


Parameters:

string   $name   カラム名
mixed   $nvl   値がNULLの場合に返す値

[ Top ]


Documentation generated on Sun, 06 Jan 2008 01:33:21 +0900 by phpDocumentor 1.3.2