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