%STR (ヌル文字で終了するストリングの入手または保管)
%STR(basing pointer{: max-length})(right-hand-side)
%STR(basing pointer : max-length)(left-hand-side)
%STR は、ヌル文字で終了する文字ストリングを作成または 使用するために使用します。このストリングは、C および C++ アプリケーションで 非常に一般的に使用されています。
最初のパラメーターは基底ポインター値でなければなりません。 ("%ADDR(DATA)" や "P+1" など、どのような基底ポインター式でも有効です。) 2 番目 のパラメーターが指定されている場合、小数点以下の桁数がゼロである 数値でなければなりません。 指定されない場合、文字変数定義の最大許容長がデフォルト値になります。
1 番目のパラメーターは、少なくとも 2 番目のパラメーターによって指定された 長さの記憶域を指し示している必要があります。
エラー条件:
- 長さパラメーターが 1 未満である場合、または最大許容長よりも大きい場合には、エラーとなります。
- ポインターが設定されていない場合、エラーとなります。
- ポインターによってアドレスされた記憶域が、長さパラメーターによって
示された長さより短いと、次のいずれかの状況になります。
- エラーとなります。
- データ破壊が起こります。