On、Off

Off

ansi_blanks オプションが効力を持つのは、データベースが文字列の比較で後続ブランクを無視し、フェッチした文字列を文字配列に埋め込む場合に限られます。これは、N の値が M 以上の場合に、データ型 CHAR(N) の値が C char(M) 変数に読み込まれるたびトランケーションエラーを強制的に発生させます。ansi_blanks が Off に設定されていると、トランケーションエラーは、少なくともブランク以外の文字がトランケートされた場合にのみ発生します。

Embedded SQL で ansi_blanks オプションが On に設定されている場合、データ型 DT_STRING の値を挿入するときには、sqllen フィールドを値が保存されているバッファーの長さ (最低でも値の長さに末尾の NULL 文字を加えた長さ) に設定する必要があります。ansi_blanks が Off の場合、長さは NULL 文字の位置でのみ決定されます。ansi_blanks オプションの値は、接続が確立されたときに決定されます。接続が確立された後で ansi_blanks オプションの値を変更しても、sqllen Embedded SQL の動作には影響しません。

ブランク埋め込みが有効になっているデータベースでは、このオプションの設定によって、フェッチする式が CHAR または NCHAR であり (VARCHAR または NVARCHAR ではない)、ホスト変数 char または nchar (VARCHAR または NVARCHAR ではない) に格納される場合に、トランケーション警告をクライアントに送信するかどうかが決まります。これらの条件が該当し、ホスト変数が小さすぎるために、フェッチされた式の最大長までブランクが埋め込まれることにより、変数に式を格納できなくなる場合は、トランケーション警告が発生し、フェッチされた式の最大長までブランクが埋め込まれた場合に式の格納に必要となる最小バイト数がインジケーターに挿入されます。式が CHAR(N) または NCHAR(N) である場合、返される値の文字セット変換と文字長セマンティクスが考慮され、インジケーターが N 以外の値に設定されることがあります。

• 互換性オプション
• ansi_blanks 接続プロパティ
• Sybase Open Client と jConnect 接続の特性
• sp_tsql_environment システムプロシージャー