ストリングの切り捨て

出力ストリングがバッファーに入りきらない場合、Db2® ODBC はバッファーのサイズに合わせてストリングを切り捨て、NUL 終止符を書き込みます。該当する SQLSTATE を用いて、ストリング・データを入力または出力で切り捨てることができます。

切り捨てが行われると、関数は SQL_SUCCESS_WITH_INFO およびデータ 切り捨てを示す SQLSTATE 01004 を戻します。 これにより、アプリケーションはバッファー長と出力長を比較し て、切り捨てられたストリングを判別することができます。

例えば、SQLFetch() が、SQL_SUCCESS_WITH_INFO およ び SQLSTATE 01004 を戻した場合には、 列にバインドされたバッファーのうちの少なくとも 1 つが、 小さ過ぎてデータを保持できないことになります。 アプリケーションは、 列にバインドされたそれぞれのバッファーごとに、バッファー長と 出力長を比較して、切り捨てられた列を判別することができます。

ODBC は、該当する SQLSTATE を用いて、ストリング・データが入力または出力で切り捨て可能であることを、 指定します。 データ・ソースとして、Db2 は、 入力においてはデータを切り捨てませんが、 出力においてはデータの整合性を維持するために切り捨てることがあります。 入力では、Db2 は、負の SQLCODE (-302) と SQLSTATE 22001 を 用いて、ストリングの切り捨てをリジェクトします。 出力では、Db2 は、データを切り捨て、SQL_SUCCESS_WITH_INFO およ び SQLSTATE 01004 を出します。