表19-15は、この項で説明しているOCI参照(REF
)関数を示しています。
表19-15 REF関数
関数 | 用途 |
---|---|
|
1つの |
|
|
|
16進文字列を |
|
|
|
2つの |
|
|
|
|
パラメータ
オブジェクト・モードで初期化されたOCI環境ハンドルです。
OCIエラー・ハンドルです。エラーがある場合は、err
に記録され、OCI_ERROR
が戻されます。OCIErrorGet()をコールして診断情報を取得します。
コピー元のREF
です。
コピー先のREF
です。
構文
sword OCIRefFromHex ( OCIEnv *env, OCIError *err, const OCISvcCtx *svc, const OraText *hex, ub4 length, OCIRef **ref );
パラメータ
オブジェクト・モードで初期化されたOCI環境ハンドルです。
OCIエラー・ハンドルです。エラーがある場合は、err
に記録され、OCI_ERROR
が戻されます。OCIErrorGet()をコールして診断情報を取得します。
OCIサービス・コンテキスト・ハンドルです(結果のREF
がこのサービス・コンテキストで初期化される場合)。
REF
に変換する16進テキスト文字列で、以前にOCIRefToHex()
によって出力されたものです。
16進文字列の長さです。
16進文字列が変換先となるREF
です。入力時に*ref
がNULL
の場合は、そのREF
用の領域がオブジェクト・キャッシュ内に割り当てられます。それ以外の場合は、指定のREF
によって占有されているメモリーが再利用されます。
構文
sword OCIRefToHex ( OCIEnv *env, OCIError *err, const OCIRef *ref, OraText *hex, ub4 *hex_length );
パラメータ
オブジェクト・モードで初期化されたOCI環境ハンドルです。
OCIエラー・ハンドルです。エラーがある場合は、err
に記録され、OCI_ERROR
が戻されます。OCIErrorGet()をコールして診断情報を取得します。
16進文字列に変換するREF
です。ref
がNULL
のREF
(つまり、OCIRefIsNull
(ref
) == TRUE
)の場合は、0(ゼロ)のhex_length
値が戻されます。
結果の16進文字列を格納するのに十分なバッファです。文字列の内容は、コール元にとっては不透明になります。
入力ではhex
バッファのサイズを指定し、出力ではhex
で戻される16進文字列の実際のサイズを指定します。