%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 或大於容許的長度上限,則會發生錯誤。
- 如果未設定指標,則會發生錯誤。
- 如果指標所定址的儲存體比長度參數所指示的還短,則
- 將發生錯誤
- 將發生資料毀損。