Vは、選択リストまたはバインド変数の値を格納するデータ・バッファのアドレスからなる配列のポインタです。
記述子を割り当てると、SQLSQLDAAlloc()
によってアドレスの配列にあるV[0]
からV[N - 1]
の要素が0(ゼロ)に設定されます。
選択記述子の場合は、FETCHコマンドを発行する前にデータ・バッファを割り当てて、この配列を設定する必要があります。文
EXEC SQL FETCH ... USING DESCRIPTOR ...
この文は、FETCHされた選択リストの値を、V[0]
からV[N - 1]
が指しているデータ・バッファに格納するようにOracleに指示します。Oracleにより、i番目の選択リストの値が、V[i]
が指しているデータ・バッファに格納されます。
バインド記述子の場合は、OPENコマンドを発行する前に、この配列を設定する必要があります。文
EXEC SQL OPEN ... USING DESCRIPTOR ...
この文では、V[0]
からV[N - 1]
が指しているバインド変数の値を使用して動的SQL文を実行するようにOracleに指示します。Oracleでは、V[
i]
が指しているデータ・バッファでi番目のバインド変数の値が参照されます。
Lは、データ・バッファに格納されている選択リストまたはバインド変数の値の長さからなる配列のポインタです。
選択記述子の場合、この配列は、DESCRIBE SELECT LISTによって、各選択リスト項目に予想される最大値に設定されます。しかし、FETCHコマンドを発行する前に長さを再設定する場合も考えられます。FETCHでは最大でn文字が戻されます(nは、FETCHを実行する前のL[
i]
の値です)。
長さの形式はOracleデータ型によって異なります。CHARまたはVARCHAR2の選択リスト項目については、DESCRIBE SELECT LISTはL[
i]
を選択リスト項目の最大長に設定します。NUMBER型の選択リスト項目については、位取りおよび精度が変数の下位バイトおよびその次の上位側バイトにそれぞれ戻されます。精度と位取りの値をL[
i]
から抽出するには、ライブラリ関数SQLNumberPrecV6()
を使用できます。精度と位取りの抽出も参照してください。
FETCHする前に、L[
i]
を必要なデータ・バッファの長さに再設定する必要があります。たとえば、NUMBERをC言語のchar文字列に強制変換する場合は、L[
i]
を精度の数値に符号と小数点のための2を加えたものに設定します。NUMBER型をC言語のfloat型に強制変換する場合は、L[
i]
をシステム上のfloat型の長さに設定します。強制変換したデータ型の長さの詳細は、データの変換を参照してください。
バインド記述子の場合は、OPENコマンドを発行する前に、配列の長さを設定する必要があります。たとえば、strlen()
を使用してユーザーが入力したバインド変数文字列の長さを取得してから、適切な配列要素を設定します。
Oracleは、V[
i]
に格納されているアドレスを使用して間接的にデータ・バッファにアクセスするため、データ・バッファ内の値の長さは認識しません。i番目の選択リスト値またはバインド変数値に対してOracleが使用する長さを変更する場合は、L[
i]
を必要な長さに再設定してください。入力バッファまたは出力バッファにはそれぞれ異なる長さを指定できます。
Tは、選択リストまたはバインド変数の値のデータ型コードからなる配列のポインタです。これらのデータ型コードは、V配列の要素が指示するデータ・バッファにOracleデータが格納されるときのデータの変換方法を決定します。
関連項目:
選択記述子の場合、DESCRIBE SELECT LISTはデータ型コードの配列を選択リスト内の項目の内部データ型(CHAR、NUMBER、DATEなど)に設定します。
Oracleデータ型の内部形式は処理が複雑なため、FETCHする前にデータ型をいくつか再設定する必要がある場合があります。表示用データのときは、一般には選択リストの値のデータ型をVARCHAR2またはSTRINGに強制変換することをお薦めします。計算用データのときは、Oracleの数値をC言語の形式に強制変換する必要がある場合があります。
関連項目:
T[
i]
の上位ビットの設定は、i番目の選択リスト項目のNULL/NOT NULLステータスを示します。OPENコマンドまたはFETCHコマンドを発行する前に、常にこのビットを消去する必要があります。データ型コードを取り出してNULL/NOT NULLビットを消去するには、ライブラリ関数SQLColumnNullCheck()
を使用します。
関連項目:
OracleのNUMBER内部データ型は、V[
i]
が指すC言語のデータ・バッファと互換性のある外部データ型に変更する必要があります。
バインド記述子の場合、データ型コードの配列はDESCRIBE BIND VARIABLESによって0に設定されます。OPENコマンドを発行する前に、各要素に格納されたデータ型を設定する必要があります。コードは、V[
i]
が指すデータ・バッファの外部(C)データ型を表します。バインド変数の値が文字列に格納され、データ型配列の要素が1(VARCHAR2データ型コード)に設定されることがよくあります。データ型コード5(STRING)を使用することもできます。
i番目の選択リストまたはバインド変数の値のデータ型を変更するには、T[
i]
を変更するデータ型に再設定してください。
Iは、標識変数値を格納するデータ・バッファのアドレスの配列へのポインタです。
アドレスの配列のI[0]
からI[N - 1]
の要素を設定する必要があります。
選択記述子の場合は、FETCHコマンドを発行する前に、アドレスの配列を設定する必要があります。次の文を実行するとします。
EXEC SQL FETCH ... USING DESCRIPTOR ...
この場合、戻されたi番目の選択リスト値がNULLの場合は、I[
i]
が指す標識変数値が-1に設定されます。それ以外の場合は、(値がNULLでない) 0または(値が切り捨てられている)正の整数に設定されます。
バインド記述子の場合は、OPENコマンドを発行する前に、アドレスの配列とそれに対応付けられた標識変数を設定する必要があります。次の文を実行するとします。
EXEC SQL OPEN ... USING DESCRIPTOR ...
この場合、I[
i]
が指しているデータ・バッファはi番目のバインド変数の値がNULLであるかどうかを決定します。標識変数の値が-1のとき、関連するバインド変数の値はNULLです。