ストリング引数の長さ

出力および入力両方のストリング引数は長さ引数と関連があります。常に有効な出力長さ引数を使用してください。

入力ストリング引数の場合は、関連した長さ引数は、Db2® ODBC に以下のタイプの情報を 1 つ渡します。
  • ストリングの正確な長さ (NUL 終止符は含まず)
  • NUL 終了ストリングを示す特殊値 SQL_NTS
  • NULL 値を受け渡す SQL_NULL_DATA
長さを SQL_NTS に設定すると、Db2 ODBC は NUL 終止符を見つけて、ストリングの長さを判別します。 入出力ストリングの長さ引数は、すべて、文字のカウントとして受け渡されます。 ストリング・データと非ストリング・データの両方を参照できる長さ引数は、バイト・カウントと て受け渡されます。

出力ストリング引数には、2 つの関連した長さ引数があります。 1 つは割り当てられる出力バッファーの長さを指定する入力長さ 引数で、もう 1 つは Db2 ODBC が戻したストリングの実際の長さを 戻す出力長さ引数です。戻される長さの値は、それがバッファーに収まるかどうかに関係なく、 戻りに使用可能なストリングの合計の長さです。

SQL 列データの場合、出力が NULL 値であれば、SQL_NULL_DATA が 長さ引数に戻され、出力バッファーは考慮されません。

出力長さ引数に NULL ポインターを用いて関数が呼び出されると、Db2 ODBC は、長さを戻さず、 さらにデータ・バッファーの大きさはデータを保持するのに十分であると見なします。 出力データが NULL 値であっても、Db2 ODBC はその値が NULL であることを示すことはできません。 結果セットの列に NULL 値が入る可能性がある場合は、出力長さ引数を指す有効なポインター を必ず指定する必要があります。

推奨事項: 常に有効な出力長さ引数を使用してください。

長さ引数 (pcbValue) と出力バッファー (rgbValue) が メモリー内で隣接している場合は、Db2 ODBC は、両方の値をより効率的に 戻すことができ、アプリケーションのパフォーマンスが向上します。 例えば、次の構造が定義済みであり、&buffer.pcbValue およ び buffer.rgbValue が SQLBindCol() に渡される 場合、Db2 ODBC は 1 回の操作で両方の値を更新します。
struct
{   SQLINTEGER pcbValue;
    SQLCHAR    rgbValue [BUFFER_SIZE];
} buffer;