LENGTH 関数
LENGTH 関数は、英数字文字位置での引数の長さに等しい整数を返す。
または、引数の字類に応じて各国文字位置での引数の長さに等しい整数を返す。
この関数の型は整数である。
一般形式
引数
- argument-1 は、文字定数または任意の字類または項類のデータ項目でもよい。
- argument-1 またはそれに属するデータ項目に、OCCURS 句の DEPENDING が指定されている場合、DEPENDING で指定されたデータ名が参照するデータ項目の内容が、LENGTH 関数が評価される時点で使用される。
戻り値
- argument-1 が、英数字定数、各国文字以外の字類の基本データ項目、または可変反復データ項目を含まない集団データ項目である場合、戻り値は英数字文字位置での argument-1 の長さに等しい整数となる。
argument-1 が、字類が各国文字である基本データ項目または各国文字定数である場合、戻り値は各国文字位置での argument-1 の長さに等しい整数となる。
- argument-1 が可変反復データ項目を含む集団データ項目である場合、その可変反復データ項目の OCCURS 句の DEPENDING 指定で指定するデータ項目の評価結果の整数値が戻り値となる。この評価は、送信側データ項目としてデータ項目を処理する OCCURS 句の規則に従って行われる。「データ部 - ファイル記述項およびデータ記述項」の章の「OCCURS 句」セクションを参照。
- 返却値には、暗黙の FILLER 文字 (ある場合) が含まれる。