asc_clear_nthbit

产品支持情况

• Ascend 950PR/Ascend 950DT：支持

• Atlas A3 训练系列产品/Atlas A3 推理系列产品：支持

• Atlas A2 训练系列产品/Atlas A2 推理系列产品：支持

• Atlas 200I/500 A2 推理产品：不支持

• Atlas 推理系列产品AI Core：不支持

• Atlas 推理系列产品Vector Core：不支持

• Atlas 训练系列产品：不支持

功能说明

位操作函数，用于将一个uint64_t整数bits的第idx位设置为0。

函数原型

C++

__aicore__ inline uint64_t asc_clear_nthbit(uint64_t bits, int64_t idx)

参数说明

表1 参数说明

参数名	输入/输出	描述
bits	输入	表示需要修改的值。执行此计算后输入数据不变。
idx	输入	位索引，表示需要设置为0的位的位置。取值范围为：[0, 63]。

返回值说明

执行计算得到的结果（uint64_t类型）。

流水类型

PIPE_S

约束说明

当idx > 63或者idx < 0时，计算逻辑是：(idx % 64 + 64) % 64，得到结果位，设置结果位为0。

调用示例

C++

uint64_t bits = 0x7;
int64_t idx = 0x2;
uint64_t res = asc_clear_nthbit(bits, idx);