SUBSTR関数

関数

SUBSTR{START[,SIZE[,ADJUST]]}

関数処理の対象文字列から、引数STARTで指定された位置から引数SIZEで指定したバイト数分の文字列を返します。

= 備考 =

SUBSTR関数の処理（引数STARTが正の場合）は、出力情報で開始位置と出力サイズの指定した場合の処理と類似していますが、以下の点が異なります。

対象文字列がNタイプの場合、次に示す処理の違いがあります。
- 出力情報で指定した場合は、シフトコードを付加する前に文字列を処理します。
- SUBSTR関数の場合は、シフトコードを付加した後に文字列を処理します。
出力情報で指定した場合の処理は開始位置を1から数えますが、SUBSTR関数の処理の場合は開始位置を0から数えます。

パラメータ

START

開始位置を数値（0、負の値も可）で指定します（省略不可）。

正の場合（0を含む）：

先頭から数えてSTARTに指定した開始位置から、末尾に向けてSIZEバイトの文字列を返します。

(例)

文字列「abcdef」の場合、開始位置0は「a」、開始位置2は「c」です。

開始位置が対象文字列の文字列長を超える場合は、0バイトの文字列を返します。

負の場合：

末尾から数えてSTARTに指定した開始位置から、末尾に向けてSIZEバイトの文字列を返します。開始位置が対象文字列の文字列長を超える場合は、先頭から数えて文字列を返します。

SIZE

取り出したいバイト数を指定します（省略可）。

省略すると、開始位置からすべての文字列を返します。

0または負の数値を指定した場合は実行時エラーとなります。

開始位置からの対象文字列がSIZEバイトを満たさず、SIZEバイト分取り出せない場合は、途中まで取り出した文字列を返します（エラーになりません）。

ADJUST

可変長文字（Mタイプ、CSV文字列、XML文字列）の開始位置、終了位置を調整します（省略可）。

省略すると、可変長文字の開始位置と終了位置は調整しません。

表A.13 可変長文字の開始、終了位置
設定値	設定内容
LL	開始位置が１つの文字コードの途中の場合は開始位置を先頭方向(左)にずらします。終了位置が１つの文字コードの途中の場合は終了位置を先頭方向(左)にずらします。
LR	開始位置が１つの文字コードの途中の場合は開始位置を先頭方向(左)にずらします。終了位置が１つの文字コードの途中の場合は終了位置を末尾方向(右)にずらします。
RL	開始位置が１つの文字コードの途中の場合は開始位置を末尾方向(右)にずらします。終了位置が１つの文字コードの途中の場合は終了位置を先頭方向(左)にずらします。
RR	開始位置が１つの文字コードの途中の場合は開始位置を末尾方向(右)にずらします。終了位置が１つの文字コードの途中の場合は終了位置を末尾方向(右)にずらします。
上記以外	エラーになります。