ZHCU947E June 2015 – January 2023
以下内置替代符号函数使您能够根据替代符号的字符串值做出决定。这些函数总是会返回值，并可以在表达式中使用。内置替代符号函数在条件汇编表达式中特别有用。这些函数的参数是替代符号或字符串常量。
在#GUID-D0988306-88FC-4B4C-8B9B-4092901C3950/STDZ0733238 所示的函数定义中，a 和 b 是表示替代符号或字符串常量的参数。术语字符串 指的是参数的字符串值。符号 ch 表示字符常量。
| 函数 | 返回值 |
|---|---|
| $symlen (a) | 字符串 a 的长度 |
| $symcmp (a,b) | < 0 if a < b; 0 if a = b; > 0 if a > b |
| $firstch (a,ch) | 字符常量 ch 在字符串 a 中第一次出现的索引 |
| $lastch (a,ch) | 字符常量 ch 在字符串 a 中最后一次出现的索引 |
| $isdefed (a) | 如果在符号表中定义了字符串 a，则为 1 |
| 如果在符号表中未定义字符串 a，则为 0 | |
| $ismember (a,b) | 列表 b 的顶部成员被分配给字符串 a |
| 如果 b 是空字符串，则为 0 | |
| $iscons (a) | 如果字符串 a 是二进制常量，则为 1 |
| 如果字符串 a 是八进制常量，则为 2 | |
| 如果字符串 a 是十六进制常量，则为 3 | |
| 如果字符串 a 是字符常量，则为 4 | |
| 如果字符串 a 是十进制常量，则为 5 | |
| $isname (a) | 如果字符串 a 是有效的符号名称，则为 1 |
| 如果字符串 a 不是有效的符号名称，则为 0 | |
| $isreg (a)(1) | 如果字符串 a 是有效的预定义寄存器名称，则为 1 |
| 如果字符串 a 不是有效的预定义寄存器名称，则为 0 |
以下示例显示了内置替代符号函数。
pushx .macro list
!
! Push more than one item
! $ismember removes the first item in the list
.var item
.loop
.break ($ismember(item, list) = 0)
STW item,*B15--[1]
.endloop
.endm
pushx A0,A1,A2,A3