跳到主要内容

位逻辑运算

共 13 个 API(13 个可执行)

本页收录标准函数分类“位逻辑运算”下的完整 API 合同。

布尔与​

AND_BIT 可执行

标准函数 AND_BIT:对两个 BOOL 做逻辑与。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

BIT_RESET(LINT register, INT position) -> VOID result

参数​

registerLINT
  • 输入/输出
  • 必填
  • 约束 必须是变量标识符,不能是字面量或复合表达式。
已声明且可分配寄存器的标识符。
positionINT
  • 输入
  • 必填
  • 约束 必须满足 0 <= position < 64;常量在编译期校验,非常量在运行期校验。
位号。

输出​

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。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

BIT_SET(LINT register, INT position) -> VOID result

参数​

registerLINT
  • 输入/输出
  • 必填
  • 约束 必须是变量标识符,不能是字面量或复合表达式。
已声明且可分配寄存器的标识符。
positionINT
  • 输入
  • 必填
  • 约束 必须满足 0 <= position < 64;常量在编译期校验,非常量在运行期校验。
位号。

输出​

resultVOID
无返回值;直接修改目标寄存器。

行为说明​

  • 目标寄存器号在编译期静态绑定。
  • 该位置 1,其余位不变。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、BIT_INDEX_OUT_OF_RANGE。

示例​

把控制字第 5 位置 1。
BIT_SET(controlWord, 5);

相关 API​

暂无已核实关系。

测试指定位​

BIT_TEST 可执行

标准函数 BIT_TEST:读取已声明寄存器变量的指定位。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

BOOL BIT_TEST(LINT register, INT position)

参数​

registerLINT
  • 输入
  • 必填
  • 约束 必须是变量标识符,不能是字面量或复合表达式。
已声明且可分配寄存器的标识符。
positionINT
  • 输入
  • 必填
  • 约束 必须满足 0 <= position < 64;常量在编译期校验,非常量在运行期校验。
位号。

返回值​

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 执行逻辑取反。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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)。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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:执行两个布尔值的逻辑或运算。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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:按位循环左移。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LINT ROL(LINT value, INT count)

参数​

valueLINT
  • 输入
  • 必填
待循环移位数值。
countINT
  • 输入
  • 必填
  • 约束 常量移位量须 0 <= N < 64;非常量移位量在运行期对 64 取模。
循环移位位数。

返回值​

returnLINT
循环左移结果。

行为说明​

  • 移位量对 64 取模。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

循环左移 4 位。
LINT rotated = ROL(value, 4);

相关 API​

暂无已核实关系。

循环右移​

ROR 可执行

标准函数 ROR:按位循环右移。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LINT ROR(LINT value, INT count)

参数​

valueLINT
  • 输入
  • 必填
待循环移位数值。
countINT
  • 输入
  • 必填
  • 约束 常量移位量须 0 <= N < 64;非常量移位量在运行期对 64 取模。
循环移位位数。

返回值​

returnLINT
循环右移结果。

行为说明​

  • 移位量对 64 取模。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

循环右移 4 位。
LINT rotated = ROR(value, 4);

相关 API​

暂无已核实关系。

算术右移​

SAR 可执行

标准函数 SAR:按位算术右移(符号位填充)。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LINT SAR(LINT value, INT count)

参数​

valueLINT
  • 输入
  • 必填
待移位数值。
countINT
  • 输入
  • 必填
  • 约束 常量移位量须 0 <= N < 64;非常量移位量在运行期对 64 取模。
移位位数。

返回值​

returnLINT
算术右移结果。

行为说明​

  • 算术右移(符号位填充),区别于 SHR 的逻辑右移(零填充)。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

算术右移 2 位。
LINT shifted = SAR(value, 2);

相关 API​

暂无已核实关系。

逻辑左移​

SHL 可执行

标准函数 SHL:把整数值逻辑左移指定的位数。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LINT SHL(LINT value, INT count)

参数​

valueLINT
  • 输入
  • 必填
被移位值。
countINT
  • 输入
  • 必填
  • 约束 编译期常量必须满足 0 <= count < 64。
左移位数。

返回值​

returnLINT
逻辑左移后的整数值。

行为说明​

  • 按 64 位整数逻辑左移。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

生成通道位掩码。
LINT mask = SHL(1, channel);

相关 API​

暂无已核实关系。

逻辑右移​

SHR 可执行

标准函数 SHR:把整数值逻辑右移指定的位数。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LINT SHR(LINT value, INT count)

参数​

valueLINT
  • 输入
  • 必填
被移位值。
countINT
  • 输入
  • 必填
  • 约束 编译期常量必须满足 0 <= count < 64。
右移位数。

返回值​

returnLINT
逻辑右移后的整数值。

行为说明​

  • 这是逻辑右移;算术右移属于标准函数 SAR。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。

示例​

把高位字段移到低位。
LINT field = SHR(wordValue, 8);

相关 API​

暂无已核实关系。

布尔异或​

XOR_BIT 可执行

标准函数 XOR_BIT:按 BOOL 语义执行二元异或。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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 条目中。

  • 缺少必需实参或参数类型不匹配时编译失败。