CANN/Ascend C标量计算函数GetSFFValue

GetSFFValue

【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言，原生支持C和C++标准规范，主要由类库和语言扩展层构成，提供多层级API，满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit

产品支持情况

• Ascend 950PR/Ascend 950DT：支持

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

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

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

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

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

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

• Kirin X90：支持

• Kirin 9030：支持

功能说明

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

查找uint64_t类型数值的二进制表示中从最低有效位开始的首个指定比特值（0或1）的位置，如果没找到则返回-1。

以如下GetSFFValue调用为例：

int64_t sffValue = AscendC::GetSFFValue<1>(0x1000000000000100ULL); // 返回8

其计算结果如下图所示：

图1使用GetSFFValue查找从最低有效位开始首个1的位置

![使用GetSFFValue查找从最低有效位开始首个1的位置](https://raw.gitcode.com/cann/asc-devkit/raw/1cd1d1192e01ae4a8684cd07552c35e13e5c4bdf/docs/zh/api/figures/GetSFFValue.png "使用GetSFFValue查找从最低有效位开始首个1的位置"?utm_source=gitcode_repo_files)

函数原型

template <int countValue> __aicore__ inline int64_t GetSFFValue(uint64_t valueIn)

参数说明

表1模板参数说明

表2参数说明

返回值说明

返回valueIn中第一个0或1出现的位置。

约束说明

无

调用示例

int64_t sffValue; uint64_t valueIn = 0xFFFFFFFFFFFFFFFFULL; // 二进制表示全为1 sffValue = AscendC::GetSFFValue<0>(valueIn); // 返回-1 valueIn = 0; // 二进制表示全为0 sffValue = AscendC::GetSFFValue<1>(valueIn); // 返回-1 valueIn = 0xFF00ULL; sffValue = AscendC::GetSFFValue<0>(valueIn); // 返回0 sffValue = AscendC::GetSFFValue<1>(valueIn); // 返回8 valueIn = 0x00FFULL; sffValue = AscendC::GetSFFValue<0>(valueIn); // 返回8 sffValue = AscendC::GetSFFValue<1>(valueIn); // 返回0

【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言，原生支持C和C++标准规范，主要由类库和语言扩展层构成，提供多层级API，满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit