CountLeadingZero

产品支持情况

产品	是否支持
Ascend 950PR/Ascend 950DT	√
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas A2 推理系列产品	√
Atlas 200I/500 A2 推理产品	x
Atlas 推理系列产品AI Core	√
Atlas 推理系列产品Vector Core	x
Atlas 训练系列产品	x
Kirin X90	√
Kirin 9030	√

功能说明

头文件路径为："basic_api/kernel_operator_scalar_intf.h"。

统计uint64_t类型数值的二进制表示中前导0的个数（二进制表示中最高有效位到第一个'1'的'0'的数量，输入为0时返回64）。

以如下CountLeadingZero调用为例：

int64_t leadingZeros = AscendC::CountLeadingZero(0x0100000000000020ULL); // 返回7

其计算结果如下图所示：

图 1 CountLeadingZero计算示意图

函数原型

__aicore__ inline int64_t CountLeadingZero(uint64_t valueIn)

参数说明

表 1 参数说明

参数名称	输入/输出	描述
valueIn	输入	被统计的二进制数字。

返回值说明

返回valueIn的前导0的个数。

约束说明

无

调用示例

int64_t leadingZeros;
uint64_t valueIn = 0x000000000000FFFFULL;          // 二进制表示有48个前导0
leadingZeros = AscendC::CountLeadingZero(valueIn); // 返回48

valueIn = 0;                                       // 二进制表示全为0
leadingZeros = AscendC::CountLeadingZero(valueIn); // 返回64

valueIn = 0xFFFFFFFFFFFFFFFFULL;                   // 二进制表示全为1
leadingZeros = AscendC::CountLeadingZero(valueIn); // 返回0