ansi_substring オプション

On、Off

On

個別の接続または PUBLIC に対して設定できます。PUBLIC または別のユーザ／ロールに対してこのオプションを設定するには SET ANY PUBLIC OPTION システム権限が必要です。

ansi_substring オプションを On に設定した場合、SUBSTRING 関数は ANSI/ISO SQL/2008 と同じ動作をします。開始オフセットが負または 0 の場合は、文字列の左側が文字以外で埋められているかのように扱われ、このときに負の長さが指定されるとエラーになります。

このオプションを Off にすると、SUBSTRING 関数の動作が以前のリリースの SQL Anywhere と同じになります。つまり、負の開始オフセットは、文字列の末尾からのオフセットになり、負の長さは、開始オフセットから左に向かって望ましい部分文字列までの終端の長さになります。また、開始オフセット 0 を使用した場合、開始オフセット 1 と同じ結果となります。

このオプションの設定は、BYTE_SUBSTR 関数の動作には影響しません。SUBSTRING 関数では、開始オフセットを正でない値に設定したり負の長さを指定したりしないことをおすすめします。可能なかぎり、SUBSTRING 関数の代わりに LEFT 関数または RIGHT 関数を使用してください。

次の例は、ansi_substring オプションの設定によって SUBSTRING 関数の戻り値がどのように変わるかを示しています。

SUBSTRING( 'abcdefgh',-2,4 );
  ansi_substring = Off ==> 'gh' // substring starts at second-last character
  ansi_substring = On  ==> 'a'  // takes the first 4 characters of 
                                // ???abcdefgh and discards all ?
SUBSTRING( 'abcdefgh',4,-2 );
  ansi_substring = Off ==> 'cd'
  ansi_substring = On  ==> value -2 out of range for destination

SUBSTRING( 'abcdefgh',0,4 );
  ansi_substring = Off ==> 'abcd'
  ansi_substring = On  ==> 'abc'

ansi_substring オプション

指定可能な値

デフォルト

スコープ

備考

参照

例