Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

9.78 GET_CHAR_AREA

Note

注意 9.1 組み込み関数の規則     利用オプション

文字データ・エリアから文字列を取得します。 

...

番号

タイプ

必須/任意

記述

最小長

最大長

最小小数桁数

最大小数桁数

1

A

必須

データ・エリア名

1

10



2

A

任意

ライブラリ名

デフォルト:*LIBL

データ・エリアが、LIBL。データ・エリアが、*LDAまたは*GDAの場合、この引数は *LIBLとする必要があります。

1

10



3

A

任意

データ・エリアのロック

Y - データ・エリアをロックする 

N - データ・エリアをロックしない

デフォルト:N

データ・エリアが、デフォルト:N  データ・エリアが、*LDAまたは*GDAの場合、この引数は無視されます。

1

1



4


N


任意

取得開始位置。デフォルト:1桁目

1

5

0

0

必須

データ・エリアが*LDAまたは*GDAの場合





5


N


任意

取得長さ

デフォルト:完全長

1

4

0

0

必須

データ・エリアが*LDAまたは*GDAの場合





Note

注:注意:開始位置、長さを指定する場合は、必ず「両方」の値を引数に指定する必要があります。 

...

     USE    BUILTIN(GET_CHAR_AREA)
       WITH_ARGS(USERINFO QTEMP N 101 10) TO_GET(#OUTQ)
Warning

注意:警告:LDAまたは*GDAを処理する場合は、開始位置と長さを指定する必要があります。これらの引数が指定されていない場合、プログラムは異常終了します。 GDAを処理する場合は、開始位置と長さを指定する必要があります。これらの引数が指定されていない場合、プログラムは異常終了します。 ローカル・データ・エリア(*LDA)の1バイト目から30バイトの情報を取得します。

Warningnote

注意:ファンクションの引数でロックするように指定されていても、*LDAデータ・エリアはロックされません。

     DEFINE    FIELD(#RETVAL) TYPE(*CHAR) LENGTH(30)
USE       BUILTIN(GET_CHAR_AREA) WITH_ARGS('''*LDA''' '''*LIBL''' N 1 30) TO_GET(#RETVAL)

...