%STR (取得或儲存以空值結尾的字串)

%STR(basing pointer{: max-length})(right-hand-side)
%STR(basing pointer : max-length)(left-hand-side)

%STR 用於建立或使用以空值結尾的 字元 字串,這些字串在 C 及 C++ 應用程式中非常常用。

第一個參數必須是基本指標值。 (任何基本指標表示式都有效,例如 "%ADDR (DATA)" 或 "P+1"。) 第二個參數 (如果指定的話) 必須是具有零小數位數的數值。 如果未指定,它會預設為定義字元變數所容許的長度上限。

第一個參數必須指向至少與第二個參數給定的長度一樣長的儲存體。

附註: %STR 的長度運算元一律參照位元組數。
錯誤狀況:
  1. 如果長度參數小於 1 或大於容許的長度上限,則會發生錯誤。
  2. 如果未設定指標,則會發生錯誤。
  3. 如果指標所定址的儲存體比長度參數所指示的還短,則
    1. 將發生錯誤
    2. 將發生資料毀損。

如需相關資訊,請參閱 字串作業內建函數