%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 番目 のパラメーターが指定されている場合、小数点以下の桁数がゼロである 数値でなければなりません。 指定されていない場合 には、65535 がデフォルト値です。

1 番目のパラメーターは、少なくとも 2 番目のパラメーターによって指定された 長さの記憶域を指し示している必要があります。

エラー条件:

  1. 長さパラメーター 1 から 65535 の範囲内にない 場合、エラーとなります。
  2. ポインターが設定されていない場合、エラーとなります。
  3. ポインターによってアドレスされた記憶域が、長さパラメーターによって 示された長さより短いと、次のいずれかの状況になります。
    1. エラーとなります。
    2. データ破壊が起こります。

詳細については、ストリング命令または 組み込み関数を参照してください。