pypto_pro.language.simt.clz

产品支持情况

• Ascend 950PR&950DT系列产品：支持

• Atlas A3系列产品：不支持

• Atlas A2系列产品：不支持

功能说明

统计value固定位宽二进制表示中，从最高位开始连续为0的比特数量。

函数原型

pypto_pro.language.simt.clz(
    value: Scalar,
) -> Scalar

参数说明

参数	输入/输出	说明
value	输入	源操作数，Scalar类型，支持DT_INT32和DT_INT64。按其二进制补码位模式进行统计。Tensor或Tile元素需通过下标访问后传入。

约束说明

只能在由@pypto_pro.language.vector_function(mode=”simt”)定义的SIMT入口函数或辅助函数中调用。

返回值说明

返回前导零数量，数据类型为DT_INT32。输入为DT_INT32的零时返回32，输入为DT_INT64的零时返回64；负数的最高位为1，因此返回0。

调用示例

import pypto_pro.language as pl


@pl.vector_function(mode="simt", max_threads=64)
def clz_example(
    value: pl.Tensor[[1, 64], pl.DT_INT32],
    output: pl.Tensor[[1, 64], pl.DT_INT32],
):
    tid = pl.simt.linear_thread_idx()
    output[0, tid] = pl.simt.clz(value[0, tid])


@pl.jit()
def clz_kernel(
    value: pl.Tensor[[1, 64], pl.DT_INT32],
    output: pl.Tensor[[1, 64], pl.DT_INT32],
):
    with pl.section_vector():
        clz_example[64](value, output)