__clz

产品支持情况

• Ascend 950PR/Ascend 950DT：支持

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

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

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

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

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

功能说明

从输入数据的二进制最高有效位开始，返回连续的前导零的位数。

函数原型

C++

int __clz(int x)

C++

int __clz(long long x)

C++

int __clz(long x)

参数说明

表1 参数说明

参数名	输入/输出	描述
x	输入	源操作数。

返回值说明

返回输入整数二进制表示中连续高位零的数量。

约束说明

无

需要包含的头文件

使用该接口需要包含"simt_api/device_functions.h"头文件。

C++

#include "simt_api/device_functions.h"

调用示例

• SIMT编程场景：

  C++

  __global__ __launch_bounds__(1024) void KernelClz(int* dst, int* x)
  {
      int idx = threadIdx.x + blockIdx.x * blockDim.x;
      dst[idx] = __clz(x[idx]);
  }
  

  C++

  __global__ __launch_bounds__(1024) void KernelClz(int* dst, long long* x)
  {
      int idx = threadIdx.x + blockIdx.x * blockDim.x;
      dst[idx] = __clz(x[idx]);
  }
  

• SIMD与SIMT混合编程场景：

  C++

  __simt_vf__ __launch_bounds__(1024) inline void KernelClz(__gm__ int* dst, __gm__ int* x)
  {
      int idx = threadIdx.x + blockIdx.x * blockDim.x;
      dst[idx] = __clz(x[idx]);
  }
  

  C++

  __simt_vf__ __launch_bounds__(1024) inline void KernelClz(__gm__ int* dst, __gm__ long long* x)
  {
      int idx = threadIdx.x + blockIdx.x * blockDim.x;
      dst[idx] = __clz(x[idx]);
  }