CANN/asc-devkit原子异或API文档

asc_atomic_xor

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

产品支持情况

功能说明

对Unified Buffer或Global Memory上address的数值与指定数值val进行原子异或（^）操作，即将address数值异或（^）val的结果赋值到Unified Buffer或Global Memory上。

函数原型

• Unified Buffer数据的原子异或操作

  __simt_callee__ inline int32_t asc_atomic_xor(__ubuf__ int32_t *address, int32_t val)
  

  __simt_callee__ inline uint32_t asc_atomic_xor(__ubuf__ uint32_t *address, uint32_t val)
  

• Global Memory数据的原子异或操作

  __simt_callee__ inline int32_t asc_atomic_xor(__gm__ int32_t *address, int32_t val)
  

  __simt_callee__ inline uint32_t asc_atomic_xor(__gm__ uint32_t *address, uint32_t val)
  

  __simt_callee__ inline int64_t asc_atomic_xor(__gm__ int64_t *address, int64_t val)
  

  __simt_callee__ inline uint64_t asc_atomic_xor(__gm__ uint64_t *address, uint64_t val)
  

参数说明

表 1 参数说明

返回值说明

Unified Buffer或Global Memory上的初始数据。

约束说明

无

需要包含的头文件

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

#include "simt_api/device_atomic_functions.h"

调用示例

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

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