CANN AscendC ShiftRights函数
# ShiftRights【免费下载链接】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 训练系列产品不支持功能说明头文件路径为basic_api/reg_compute/kernel_reg_compute_vec_binary_scalar_intf.h。ShiftRights指令根据mask对源操作数srcReg按照scalarValue进行右移操作将结果写入目的操作数dstReg。根据源操作数的数据类型右移操作分为以下两种情况数据类型为无符号类型执行逻辑右移。逻辑右移会将二进制数整体向右移动指定的位数最低位被丢弃最高位用0填充。例如二进制数1010101010101010uint16_t类型逻辑右移1位后结果为0101010101010101。数据类型为有符号类型执行算术右移。算术右移会将二进制数整体向右移动指定的位数最低位被丢弃最高位复制符号位。例如二进制数1010101010101010int16_t类型算术右移1位后结果为1101010101010101算术右移3位后结果为1111010101010101。$$ dstReg_i srcReg_i \gg scalarValue $$函数原型template typename T DefaultType, typename U, MaskMergeMode mode MaskMergeMode::ZEROING, typename S __simd_callee__ inline void ShiftRights(S dstReg, S srcReg, U scalarValue, MaskReg mask)参数说明表1模板参数说明参数名描述T矢量目的操作数和源操作数的数据类型。U标量源操作数的数据类型。modeMaskMergeMode枚举类型。选择MERGING模式或ZEROING模式。• ZEROING模式下mask未筛选的元素在dstReg中置零。• MERGING模式当前不支持。S矢量目的操作数和源操作数的RegTensor类型例如RegTensoruint16_t由编译器自动推导用户不需要填写。表2参数说明参数名输入/输出描述dstReg输出目的操作数。类型为RegTensor。srcReg输入源操作数。类型为RegTensor。数据类型需要与目的操作数保持一致。scalarValue输入源操作数。类型为一个标量。不支持设置为负数负数行为未定义。mask输入源操作数元素操作的有效指示详细说明请参考MaskReg。返回值说明无数据类型表3数据类型支持情况dstRegsrcRegscalarValueint8_tint8_tint16_tuint8_tuint8_tint16_tint16_tint16_tint16_tuint16_tuint16_tint16_tint32_tint32_tint16_tuint32_tuint32_tint16_tint64_tint64_tint16_tuint64_tuint64_tint16_t约束说明对于逻辑位移无符号数据类型如果位移量scalarValue大于数据类型位宽则输出为0。对于算术位移有符号数据类型如果srcReg小于0位移量大于数据类型位宽则输出-1如果srcReg大于0位移量大于数据类型位宽则输出0。scalarValue不支持设置为负数负数行为未定义。调用示例templatetypename T, typename U __simd_vf__ inline void ShiftRightsVF(__ubuf__ T* dstAddr, __ubuf__ T* srcAddr, U scalarValue, uint32_t count, uint32_t oneRepeatSize, uint16_t repeatTimes) { AscendC::Reg::RegTensorT srcReg; AscendC::Reg::RegTensorT dstReg; AscendC::Reg::MaskReg mask; for (uint16_t i 0; i repeatTimes; i) { AscendC::Reg::LoadAlign(srcReg, srcAddr i * oneRepeatSize); mask AscendC::Reg::UpdateMaskT(count); AscendC::Reg::ShiftRights(dstReg, srcReg, scalarValue, mask); AscendC::Reg::StoreAlign(dstAddr i * oneRepeatSize, dstReg, mask); } }【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言原生支持C和C标准规范主要由类库和语言扩展层构成提供多层级API满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考