Skip to content

Compares

产品支持情况​

  • Ascend 950PR&950DT系列产品:支持
  • Atlas A3系列产品:不支持
  • Atlas A2系列产品:不支持
  • Atlas 200I/500 A2推理产品:不支持
  • Atlas推理系列产品AI Core:不支持
  • Atlas推理系列产品Vector Core:不支持
  • Atlas训练系列产品:不支持
  • Kirin 9050处理器系列产品:支持
  • KirinDev0001处理器系列产品:支持
  • KirinDev0002处理器系列产品:支持
  • KirinDev0003处理器系列产品:支持

功能说明​

头文件路径为:"basic_api/reg_compute/kernel_reg_compute_vec_cmpsel_intf.h"。

该接口用于逐元素比较源操作数中每个元素与一个标量的大小关系,根据模板参数指定的比较模式(LT/GT/GE/EQ/NE/LE)判断结果是否为真,若为真则输出MaskReg对应比特位置1,否则置0。

函数原型​

C++
template <typename T = DefaultType, CMPMODE mode = CMPMODE::EQ, typename U, typename S>
__simd_callee__ inline void Compares(MaskReg& dst, U& srcReg, S scalarValue, MaskReg& mask)

参数说明​

表1 模板参数说明

参数名描述
T矢量源操作数数据类型。
mode比较模式。支持如下取值:
• LT:小于
• GT:大于
• GE:大于或等于
• EQ:等于
• NE:不等于
• LE:小于或等于
U矢量源操作数的RegTensor类型,由编译器自动推导,用户不需要填写。
S标量操作数数据类型。

表2 参数说明

参数名输入/输出描述
dst输出MaskReg类型,目的操作数。
srcReg输入源操作数。
类型为RegTensor。
scalarValue输入源操作数。
类型为标量。
mask输入源操作数元素操作的有效指示,详细说明请参考MaskReg。

返回值说明​

无

数据类型​

表3 数据类型组合

srcReg和scalarValue数据类型dst数据类型
int8_tMaskReg
uint8_tMaskReg
int16_tMaskReg
uint16_tMaskReg
halfMaskReg
bfloat16_tMaskReg
int32_tMaskReg
uint32_tMaskReg
floatMaskReg
int64_tMaskReg
uint64_tMaskReg

约束说明​

通过mask参数控制的未选中元素在目的操作数中被置零。

调用示例​

C++
template<typename T>
__simd_vf__ inline void ComparesVF(__ubuf__ T* dstAddr, __ubuf__ T* src0Addr, __ubuf__ T* src1Addr, T scalarValue, uint32_t count, uint32_t oneRepeatSize, uint16_t repeatTimes)
{
    AscendC::Reg::RegTensor<T> srcReg0;
    AscendC::Reg::RegTensor<T> srcReg1;
    AscendC::Reg::RegTensor<T> dstReg;
    AscendC::Reg::MaskReg mask;
    AscendC::Reg::MaskReg cmpMaskReg;
    for (uint16_t i = 0; i < repeatTimes; i++) {
        mask = AscendC::Reg::UpdateMask<T>(count);
        AscendC::Reg::LoadAlign(srcReg0, src0Addr + i * oneRepeatSize);
        AscendC::Reg::LoadAlign(srcReg1, src1Addr + i * oneRepeatSize);       
        AscendC::Reg::Compares<T, AscendC::CMPMODE::EQ>(cmpMaskReg, srcReg0, scalarValue, mask);
        AscendC::Reg::Select(dstReg, srcReg0, srcReg1, cmpMaskReg);
        AscendC::Reg::StoreAlign(dstAddr + i * oneRepeatSize, dstReg, mask);
    }
}

免责声明:本站内容由 asc-devkit 仓 master 分支自动编译生成,属于持续开发版本,可能存在缺陷,仅供预览与参考。如需稳定及商用资料,请查阅官方 昇腾社区。