位逻辑运算
本页收录标准函数分类“位逻辑运算”下的完整 API 合同。
布尔与
AND_BIT
可执行
标准函数 AND_BIT:对两个 BOOL 做逻辑与。
声明层
已声明验证层
已验证执行层
可执行
签名
BOOL AND_BIT(BOOL left, BOOL right)
参数
leftBOOL- 左侧布尔值。
rightBOOL- 右侧布尔值。
返回值
returnBOOL- 两侧都为 true 时为 true。
行为说明
- 这是 BOOL 1-bit 逻辑,不是整数逐位与。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
组合就绪与安全条件。
BOOL permit = AND_BIT(ready, safe);
相关 API
暂无已核实关系。
复位指定位
BIT_RESET
可执行
标准函数 BIT_RESET:把目标寄存器的指定位置 0。
声明层
已声明验证层
已验证执行层
可执行
签名
BIT_RESET(LINT register, INT position) -> VOID result
参数
registerLINT- 已声明且可分配寄存器的标识符。
positionINT- 位号。
输出
resultVOID- 无返回值;直接修改目标寄存器。
行为说明
- 目标寄存器号在编译期静态绑定。
- 该位清 0,其余位不变。
- BIT_RESET 与 BIT_CLR 为同义别名。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、BIT_INDEX_OUT_OF_RANGE。
示例
把状态字第 3 位清 0。
BIT_RESET(statusWord, 3);
相关 API
暂无已核实关系。
设置指定位
BIT_SET
可执行
标准函数 BIT_SET:把目标寄存器的指定位置 1。
声明层
已声明验证层
已验证执行层
可执行
签名
BIT_SET(LINT register, INT position) -> VOID result
参数
registerLINT- 已声明且可分配寄存器的标识符。
positionINT- 位号。
输出
resultVOID- 无返回值;直接修改目标寄存器。
行为说明
- 目标寄存器号在编译期静态绑定。
- 该位置 1,其余位不变。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、BIT_INDEX_OUT_OF_RANGE。
示例
把控制字第 5 位置 1。
BIT_SET(controlWord, 5);
相关 API
暂无已核实关系。
测试指定位
BIT_TEST
可执行
标准函数 BIT_TEST:读取已声明寄存器变量的指定位。
声明层
已声明验证层
已验证执行层
可执行
签名
BOOL BIT_TEST(LINT register, INT position)
参数
registerLINT- 已声明且可分配寄存器的标识符。
positionINT- 位号。
返回值
returnBOOL- 目标位为 1 时 true,否则 false。
行为说明
- 目标寄存器号在编译期静态绑定。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、BIT_INDEX_OUT_OF_RANGE。
示例
读取状态字第 3 位。
BOOL enabled = BIT_TEST(statusWord, 3);
相关 API
暂无已核实关系。
布尔非
NOT_BIT
可执行
标准函数 NOT_BIT:对 BOOL 执行逻辑取反。
声明层
已声明验证层
已验证执行层
可执行
签名
BOOL NOT_BIT(BOOL value)
参数
valueBOOL- 输入布尔值。
返回值
returnBOOL- 逻辑取反结果。
行为说明
- NOT_BIT 是布尔短逻辑非(1-bit),区别于 NOT_WORD 的字级按位取反。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
取反活跃状态。
BOOL off = NOT_BIT(active);
相关 API
暂无已核实关系。
字级按位取反
NOT_WORD
可执行
标准函数 NOT_WORD:对整字执行按位取反(~a)。
声明层
已声明验证层
已验证执行层
可执行
签名
LINT NOT_WORD(LINT value)
参数
valueLINT- 输入整数。
返回值
returnLINT- 按位取反结果。
行为说明
- 字级按位取反(~a, int64),区别于 NOT_BIT 的布尔短逻辑非。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
对掩码按位取反。
LINT inverted = NOT_WORD(mask);
相关 API
暂无已核实关系。
布尔或
OR_BIT
可执行
标准函数 OR_BIT:执行两个布尔值的逻辑或运算。
声明层
已声明验证层
已验证执行层
可执行
签名
BOOL OR_BIT(BOOL a, BOOL b)
参数
aBOOL- 第一个布尔输入。
bBOOL- 第二个布尔输入。
返回值
returnBOOL- 逻辑或结果。
行为说明
- 布尔 1-bit 短逻辑运算。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
两个标志位取或。
BOOL active = OR_BIT(flag1, flag2);
相关 API
暂无已核实关系。
循环左移
ROL
可执行
标准函数 ROL:按位循环左移。
声明层
已声明验证层
已验证执行层
可执行
签名
LINT ROL(LINT value, INT count)
参数
valueLINT- 待循环移位数值。
countINT- 循环移位位数。
返回值
returnLINT- 循环左移结果。
行为说明
- 移位量对 64 取模。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
循环左移 4 位。
LINT rotated = ROL(value, 4);
相关 API
暂无已核实关系。
循环右移
ROR
可执行
标准函数 ROR:按位循环右移。
声明层
已声明验证层
已验证执行层
可执行
签名
LINT ROR(LINT value, INT count)
参数
valueLINT- 待循环移位数值。
countINT- 循环移位位数。
返回值
returnLINT- 循环右移结果。
行为说明
- 移位量对 64 取模。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
循环右移 4 位。
LINT rotated = ROR(value, 4);
相关 API
暂无已核实关系。
算术右移
SAR
可执行
标准函数 SAR:按位算术右移(符号位填充)。
声明层
已声明验证层
已验证执行层
可执行
签名
LINT SAR(LINT value, INT count)
参数
valueLINT- 待移位数值。
countINT- 移位位数。
返回值
returnLINT- 算术右移结果。
行为说明
- 算术右移(符号位填充),区别于 SHR 的逻辑右移(零填充)。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
算术右移 2 位。
LINT shifted = SAR(value, 2);
相关 API
暂无已核实关系。
逻辑左移
SHL
可执行
标准函数 SHL:把整数值逻辑左移指定的位数。
声明层
已声明验证层
已验证执行层
可执行
签名
LINT SHL(LINT value, INT count)
参数
valueLINT- 被移位值。
countINT- 左移位数。
返回值
returnLINT- 逻辑左移后的整数值。
行为说明
- 按 64 位整数逻辑左移。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
生成通道位掩码。
LINT mask = SHL(1, channel);
相关 API
暂无已核实关系。
逻辑右移
SHR
可执行
标准函数 SHR:把整数值逻辑右移指定的位数。
声明层
已声明验证层
已验证执行层
可执行
签名
LINT SHR(LINT value, INT count)
参数
valueLINT- 被移位值。
countINT- 右移位数。
返回值
returnLINT- 逻辑右移后的整数值。
行为说明
- 这是逻辑右移;算术右移属于标准函数 SAR。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把高位字段移到低位。
LINT field = SHR(wordValue, 8);
相关 API
暂无已核实关系。
布尔异或
XOR_BIT
可执行
标准函数 XOR_BIT:按 BOOL 语义执行二元异或。
声明层
已声明验证层
已验证执行层
可执行
签名
BOOL XOR_BIT(BOOL left, BOOL right)
参数
leftBOOL- 左侧布尔值。
rightBOOL- 右侧布尔值。
返回值
returnBOOL- 两侧布尔值不同时为 true。
行为说明
- 这是 BOOL 1-bit 逻辑,不是整数逐位异或。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
检测两个布尔状态是否不同。
BOOL changed = XOR_BIT(previous, current);
相关 API
暂无已核实关系。
共享错误码
以下错误码在本分类的多个 API 条目中重复出现,统一在此说明以避免冗余。各条目的"错误与限制"小节仅列出该 API 专属的错误码。
错误码前缀对照
| 前缀 | 含义 | 示例 |
|---|---|---|
BIT_INDEX_ | 位索引 | BIT_INDEX_OUT_OF_RANGE |
COMPILE_ | 编译参数:SCL 参数类型/范围/枚举校验 | COMPILE_ARGUMENT_ERROR |
BIT_INDEX_OUT_OF_RANGE
BIT_INDEX_ 位索引
出现在 3 个 API 条目中。
- 位号不在 0..63,或目标不是可静态绑定变量时失败。
COMPILE_ARGUMENT_ERROR
COMPILE_ 编译参数:SCL 参数类型/范围/枚举校验
出现在 13 个 API 条目中。
- 缺少必需实参或参数类型不匹配时编译失败。