---
title: Ascend C API列表
description: "Ascend C提供一组类库API，开发者使用标准C++语法和类库API进行编程。Ascend C编程类库API示意图如下所示，分为：- 基础数据结构：kernel API中使用到的基础数据结构，比如GlobalTensor和LocalTensor。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendcopapi/context/vector_compute/asc_set_mask_count.md
sourcePath: /source/zh/canncommercial/900/API/ascendcopapi/atlasascendc_api_07_0003.html
indexId: aa2f81add8b794bf563936bd7916b11b284fc33acce7bad9d9a423b616f8619076
---
# Ascend C API列表

Ascend C提供一组类库API，开发者使用标准C++语法和类库API进行编程。Ascend C编程类库API示意图如下所示，分为：- 基础数据结构：kernel API中使用到的基础数据结构，比如GlobalTensor和LocalTensor。
- 语言扩展层 C API：开放芯片完备编程能力，支持数组分配内存，一般基于指针编程，提供与业界一致的C语言编程体验。
- 基础API：实现对硬件能力的抽象，开放芯片的能力，保证完备性和兼容性。标注为ISASI（Instruction Set Architecture Special Interface，硬件体系结构相关的接口）类别的API，不能保证跨硬件版本兼容。
- 高阶API：实现一些常用的计算算法，用于提高编程开发效率，通常会调用多种基础API实现。高阶API包括数学库、Matmul、Softmax等API。高阶API可以保证兼容性。
- SIMT API：单指令多线程API。以单条指令多个线程的形式来实现并行计算。SIMT编程主要用于向量计算，特别适合处理离散访问、复杂控制逻辑等场景。
- Utils API（公共辅助函数）：丰富的通用工具类，涵盖标准库、平台信息获取、运行时编译及日志输出等功能，支持开发者高效实现算子开发与性能优化。


#### 基础数据结构


**表1 基础数据结构列表**

| 接口名 | 功能描述 |
| --- | --- |
| LocalTensor | LocalTensor用于存放AI Core中Local Memory（内部存储）的数据，支持逻辑位置TPosition为VECIN、VECOUT、VECCALC、A1、A2、B1、B2、CO1、CO2。 |
| GlobalTensor | GlobalTensor用来存放Global Memory（外部存储）的全局数据。 |
| Coordinate | Coordinate本质上是一个元组（tuple），用于表示张量在不同维度的位置信息，即坐标值。 |
| Layout | Layout<Shape, Stride>数据结构是描述多维张量内存布局的基础模板类，通过编译时的形状（Shape）和步长（Stride）信息，实现逻辑坐标空间到一维内存地址空间的映射，为复杂张量操作和硬件优化提供基础支持。 |
| TensorTrait | TensorTrait数据结构是描述Tensor相关信息的基础模板类，包含Tensor的数据类型、逻辑位置和Layout内存布局。 |


#### 基础API


**表2 Memory数据搬运API列表**

| 接口名 | 功能描述 |
| --- | --- |
| DataCopy | 数据搬运接口，包括普通数据搬运、增强数据搬运、切片数据搬运、随路格式转换。 |
| Copy | VECIN、VECCALC、VECOUT之间的搬运指令，支持mask操作和DataBlock间隔操作。 |


**表3 Memory矢量计算API列表**

| 分类 | 接口名 | 功能描述 |
| --- | --- | --- |
| 基础算术 | Exp | 按元素取自然指数。 |
| 基础算术 | Ln | 按元素取自然对数。 |
| 基础算术 | Abs | 按元素取绝对值。 |
| 基础算术 | Reciprocal | 按元素取倒数。 |
| 基础算术 | Sqrt | 按元素做开方。 |
| 基础算术 | Rsqrt | 按元素做开方后取倒数。 |
| 基础算术 | Relu | 按元素做线性整流Relu。 |
| 基础算术 | Add | 按元素求和。 |
| 基础算术 | Sub | 按元素求差。 |
| 基础算术 | Mul | 按元素求积。 |
| 基础算术 | Div | 按元素求商。 |
| 基础算术 | Max | 按元素求最大值。 |
| 基础算术 | Min | 按元素求最小值。 |
| 基础算术 | Adds | 矢量内每个元素与标量求和。 |
| 基础算术 | Muls | 矢量内每个元素与标量求积。 |
| 基础算术 | Maxs | 源操作数矢量内每个元素与标量相比，如果比标量大，则取源操作数值，比标量的值小，则取标量值。 |
| 基础算术 | Mins | 源操作数矢量内每个元素与标量相比，如果比标量大，则取标量值，比标量的值小，则取源操作数值。 |
| 基础算术 | LeakyRelu | 按元素做带泄露线性整流Leaky ReLU。 |
| 基础算术 | Subs | 矢量内每个元素和标量间做减法，支持标量在前和标量在后两种场景，其中标量输入支持配置LocalTensor单点元素。 |
| 基础算术 | Divs | 矢量内每个元素和标量间做除法，支持标量在前和标量在后两种场景，其中标量输入支持配置LocalTensor单点元素。 |
| 逻辑计算 | Not | 按元素做按位取反。 |
| 逻辑计算 | And | 针对每对元素执行按位与运算。 |
| 逻辑计算 | Or | 针对每对元素执行按位或运算。 |
| 逻辑计算 | ShiftLeft | 对源操作数中的每个元素进行左移操作，左移的位数由输入参数scalarValue决定。 |
| 逻辑计算 | ShiftRight | 对源操作数中的每个元素进行右移操作，右移的位数由输入参数scalarValue决定。 |
| 逻辑计算 | Ands | 矢量内每个元素和标量间做与操作，支持标量在前和标量在后两种场景，其中标量输入支持配置LocalTensor单点元素。 |
| 逻辑计算 | Ors | 矢量内每个元素和标量间做或操作，支持标量在前和标量在后两种场景，其中标量输入支持配置LocalTensor单点元素。 |
| 复合计算 | Axpy | 源操作数中每个元素与标量求积后和目的操作数中的对应元素相加。 |
| 复合计算 | CastDequant | 对输入做量化并进行精度转换。 |
| 复合计算 | AddRelu | 按元素求和，结果和0对比取较大值。 |
| 复合计算 | AddReluCast | 按元素求和，结果和0对比取较大值，并根据源操作数和目的操作数Tensor的数据类型进行精度转换。 |
| 复合计算 | AddDeqRelu | 依次计算按元素求和、结果进行deq量化后再进行relu计算（结果和0对比取较大值）。 |
| 复合计算 | SubRelu | 按元素求差，结果和0对比取较大值。 |
| 复合计算 | SubReluCast | 按元素求差，结果和0对比取较大值，并根据源操作数和目的操作数Tensor的数据类型进行精度转换。 |
| 复合计算 | MulAddDst | 按元素将src0Local和src1Local相乘并和dstLocal相加，将最终结果存放进dstLocal中。 |
| 复合计算 | MulCast | 按元素求积，并根据源操作数和目的操作数Tensor的数据类型进行精度转换。 |
| 复合计算 | FusedMulAdd | 按元素将src0Local和dstLocal相乘并加上src1Local，最终结果存放入dstLocal。 |
| 复合计算 | MulAddRelu | 按元素将src0Local和dstLocal相乘并加上src1Local，将结果和0作比较，取较大值，最终结果存放进dstLocal中。 |
| 比较与选择 | Compare | 逐元素比较两个tensor大小，如果比较后的结果为真，则输出结果的对应比特位为1，否则为0。 |
| 比较与选择 | Compare（结果存放入寄存器） | 逐元素比较两个tensor大小，如果比较后的结果为真，则输出结果的对应比特位为1，否则为0。Compare接口需要mask参数时，可以使用此接口。计算结果存放入寄存器中。 |
| 比较与选择 | Compares | 逐元素比较一个tensor中的元素和另一个Scalar的大小，如果比较后的结果为真，则输出结果的对应比特位为1，否则为0。 |
| 比较与选择 | Select | 给定两个源操作数src0和src1，根据selMask（用于选择的Mask掩码）的比特位值选取元素，得到目的操作数dst。选择的规则为：当selMask的比特位是1时，从src0中选取，比特位是0时从src1选取。 |
| 比较与选择 | GatherMask | 以内置固定模式对应的二进制或者用户自定义输入的Tensor数值对应的二进制为gather mask（数据收集的掩码），从源操作数中选取元素写入目的操作数中。 |
| 精度转换指令 | Cast | 根据源操作数和目的操作数Tensor的数据类型进行精度转换。 |
| 归约计算 | ReduceMax | 在所有的输入数据中找出最大值及最大值对应的索引位置。 |
| 归约计算 | ReduceMin | 在所有的输入数据中找出最小值及最小值对应的索引位置。 |
| 归约计算 | ReduceSum | 对所有的输入数据求和。 |
| 归约计算 | WholeReduceMax | 每个repeat内所有数据求最大值以及其索引index。 |
| 归约计算 | WholeReduceMin | 每个repeat内所有数据求最小值以及其索引index。 |
| 归约计算 | WholeReduceSum | 每个repeat内所有数据求和。 |
| 归约计算 | BlockReduceMax | 对每个repeat内所有元素求最大值。 |
| 归约计算 | BlockReduceMin | 对每个repeat内所有元素求最小值。 |
| 归约计算 | BlockReduceSum | 对每个repeat内所有元素求和。源操作数相加采用二叉树方式，两两相加。 |
| 归约计算 | PairReduceSum | PairReduceSum：相邻两个（奇偶）元素求和。 |
| 归约计算 | RepeatReduceSum | 每个repeat内所有数据求和。和WholeReduceSum接口相比，不支持mask逐bit模式。建议使用功能更全面的WholeReduceSum接口。 |
| 数据转换 | Transpose | 可实现16\*16的二维矩阵数据块的转置和[N,C,H,W]与[N,H,W,C]互相转换。 |
| 数据转换 | TransDataTo5HD | 数据格式转换，一般用于将NCHW格式转换成NC1HWC0格式。特别的，也可以用于二维矩阵数据块的转置。 |
| 数据填充 | Duplicate | 将一个变量或一个立即数，复制多次并填充到向量。 |
| 数据填充 | Brcb | 给定一个输入张量，每一次取输入张量中的8个数填充到结果张量的8个datablock（32Bytes）中去，每个数对应一个datablock。 |
| 数据填充 | CreateVecIndex | 以firstValue为起始值创建向量索引。 |
| 数据分散/数据收集 | Gather | 给定输入的张量和一个地址偏移张量，Gather指令根据偏移地址将输入张量按元素收集到结果张量中。 |
| 掩码操作 | SetMaskCount | 设置mask模式为Counter模式。该模式下，不需要开发者去感知迭代次数、处理非对齐的尾块等操作，可直接传入计算数据量，实际迭代次数由Vector计算单元自动推断。 |
| 掩码操作 | SetMaskNorm | 设置mask模式为Normal模式。该模式为系统默认模式，支持开发者配置迭代次数。 |
| 掩码操作 | SetVectorMask | 用于在矢量计算时设置mask。 |
| 掩码操作 | ResetMask | 恢复mask的值为默认值（全1），表示矢量计算中每次迭代内的所有元素都将参与运算。 |
| 量化设置 | SetDeqScale | 设置DEQSCALE寄存器的值。 |


**表4 标量计算API列表**

| 接口名 | 功能描述 |
| --- | --- |
| GetBitCount | 获取一个uint64\_t类型数字的二进制中0或者1的个数。 |
| CountLeadingZero | 计算一个uint64\_t类型数字前导0的个数（二进制从最高位到第一个1一共有多少个0）。 |
| Cast（float转half、int32\_t） | 将一个scalar的类型转换为指定的类型。 |
| CountBitsCntSameAsSignBit | 计算一个uint64\_t类型数字的二进制中，从最高数值位开始与符号位相同的连续比特位的个数。 |
| GetSFFValue | 获取一个uint64\_t类型数字的二进制中第一个0或1出现的位置。 |
| Cast（float转bfloat16\_t） | float类型标量数据转换成bfloat16\_t类型标量数据。 |
| Cast（多类型转float） | bfloat16\_t类型标量数据转换成float类型标量数据。 |


**表5 资源管理API列表**

| 接口名 | 功能描述 |
| --- | --- |
| TPipe | TPipe是用来管理全局内存等资源的框架。通过TPipe类提供的接口可以完成内存等资源的分配管理操作。 |
| GetTPipePtr | 获取框架当前管理全局内存的TPipe指针，用户获取指针后，可进行TPipe相关的操作。 |
| TBufPool | TPipe可以管理全局内存资源，而TBufPool可以手动管理或复用Unified Buffer/L1 Buffer物理内存，主要用于多个stage计算中Unified Buffer/L1 Buffer物理内存不足的场景。 |
| TQue | 提供入队出队等接口，通过队列（Queue）完成任务间同步。 |
| TQueBind | TQueBind绑定源逻辑位置和目的逻辑位置，根据源位置和目的位置，来确定内存分配的位置 、插入对应的同步事件，帮助开发者解决内存分配和管理、同步等问题。 |
| TBuf | 使用Ascend C编程的过程中，可能会用到一些临时变量。这些临时变量占用的内存可以使用TBuf数据结构来管理。 |
| InitSpmBuffer | 初始化SPM Buffer。 |
| WriteSpmBuffer | 将需要溢出暂存的数据拷贝到SPM Buffer中。 |
| ReadSpmBuffer | 从SPM Buffer读回到local数据中。 |
| GetUserWorkspace | 获取用户使用的workspace指针。 |
| SetSysWorkSpace | 在进行融合算子编程时，由于框架通信机制需要使用到workspace，也就是系统workspace，所以在该场景下，开发者要调用该接口，设置系统workspace的指针。 |
| GetSysWorkSpacePtr | 获取系统workspace指针。 |


**表6 同步控制API列表**

| 接口名 | 功能描述 |
| --- | --- |
| TQueSync | TQueSync类提供同步控制接口，开发者可以使用这类API来自行完成同步控制。 |
| IBSet | 当不同核之间操作同一块全局内存且可能存在读后写、写后读以及写后写等数据依赖问题时，通过调用该函数来插入同步语句来避免上述数据依赖时可能出现的数据读写错误问题。调用IBSet设置某一个核的标志位，与IBWait成对出现配合使用，表示核之间的同步等待指令，等待某一个核操作完成。 |
| IBWait | 当不同核之间操作同一块全局内存且可能存在读后写、写后读以及写后写等数据依赖问题时，通过调用该函数来插入同步语句来避免上述数据依赖时可能出现的数据读写错误问题。IBWait与IBSet成对出现配合使用，表示核之间的同步等待指令，等待某一个核操作完成。 |
| SyncAll | 当不同核之间操作同一块全局内存且可能存在读后写、写后读以及写后写等数据依赖问题时，通过调用该函数来插入同步语句来避免上述数据依赖时可能出现的数据读写错误问题。目前多核同步分为硬同步和软同步，硬件同步是利用硬件自带的全核同步指令由硬件保证多核同步，软件同步是使用软件算法模拟实现。 |
| InitDetermineComputeWorkspace | 初始化GM共享内存的值，完成初始化后才可以调用WaitPreBlock和NotifyNextBlock。 |
| WaitPreBlock | 通过读GM地址中的值，确认是否需要继续等待，当GM的值满足当前核的等待条件时，该核即可往下执行，进行下一步操作。 |
| NotifyNextBlock | 通过写GM地址，通知下一个核当前核的操作已完成，下一个核可以进行操作。 |
| SetNextTaskStart | 在SuperKernel的子Kernel中调用，调用后的指令可以和后续其他的子Kernel实现并行，提升整体性能。 |
| WaitPreTaskEnd | 在SuperKernel的子Kernel中调用，调用前的指令可以和前序其他的子Kernel实现并行，提升整体性能。 |


**表7 缓存处理API列表**

| 接口名 | 功能描述 |
| --- | --- |
| DataCachePreload | 从源地址所在的特定DDR地址预加载数据到data cache中。 |
| DataCacheCleanAndInvalid | 该接口用来刷新Cache，保证Cache的一致性。 |


**表8 系统变量访问API列表**

| 接口名 | 功能描述 |
| --- | --- |
| GetBlockNum | 获取当前任务配置的Block数，用于代码内部的多核逻辑控制等。 |
| GetBlockIdx | 获取当前core的index，用于代码内部的多核逻辑控制及多核偏移量计算等。 |
| GetDataBlockSizeInBytes | 获取当前芯片版本一个datablock的大小，单位为byte。开发者根据datablock的大小来计算API指令中待传入的repeatTime 、DataBlock Stride、Repeat Stride等参数值。 |
| GetArchVersion | 获取当前AI处理器架构版本号。 |
| InitSocState | 由于AI Core上存在一些全局状态，如原子累加状态、Mask模式等，在实际运行中，这些值可以被前序执行的算子修改而导致计算出现不符合预期的行为，在静态Tensor编程(https://www.hiascend.comdocument/detail/zh/canncommercial/900/programug/Ascendcopdevg/atlas\_ascendc\_10\_00019.html)的场景中用户必须在Kernel入口处调用此函数来初始化AI Core状态 。 |


**表9 原子操作接口列表**

| 接口名 | 功能描述 |
| --- | --- |
| SetAtomicAdd | 设置接下来从VECOUT到GM，L0C到GM，L1到GM的数据传输是否进行原子累加，可根据参数不同设定不同的累加数据类型。 |
| SetAtomicType | 通过设置模板参数来设定原子操作不同的数据类型。 |
| DisableDmaAtomic | 原子操作函数，清空原子操作的状态。 |
| AtomicAdd | 调用该接口后，可在指定GM地址上进行原子加操作。 |
| AtomicMin | 调用该接口后，可在指定GM地址上进行原子比较取小操作。 |
| AtomicMax | 调用该接口后，可在指定GM地址上进行原子取大操作。 |
| AtomicCas | 调用该接口后，可在指定GM地址上进行原子比较，如果和value1相等，则把value2的值赋值到GM上；如果和value1不相等，则GM上的值不变。 |
| AtomicExch | 在GM内存中执行原子交换操作。具体来说，它读取指定GM地址上的数据，并将新的值存储回同一地址。函数返回旧值。 |


**表10 调试接口列表**

| 接口名 | 功能描述 |
| --- | --- |
| DumpTensor | 基于算子工程开发的算子，可以使用该接口Dump指定Tensor的内容。 |
| printf | 基于算子工程开发的算子，可以使用该接口实现CPU侧/NPU侧调试场景下的格式化输出功能。 |
| ascendc\_assert | ascendc\_assert提供了一种在CPU/NPU域实现断言功能的接口。当断言条件不满足时，系统会输出断言信息并格式化打印在屏幕上。 |
| assert | 基于算子工程开发的算子，可以使用该接口实现CPU/NPU域assert断言功能。 |
| DumpAccChkPoint | 基于算子工程开发的算子，可以使用该接口Dump指定Tensor的内容。该接口可以支持指定偏移位置的Tensor打印。 |
| PrintTimeStamp | 提供时间戳打点功能，用于在算子Kernel代码中标记关键执行点。 |
| Trap | 当软件产生异常后，使用该指令使kernel中止运行。 |
| GmAlloc | 进行核函数的CPU侧运行验证时，用于创建共享内存：在/tmp目录下创建一个共享文件，并返回该文件的映射指针。 |
| ICPU\_RUN\_KF | 进行核函数的CPU侧运行验证时，CPU调测总入口，完成CPU侧的算子程序调用。 |
| ICPU\_SET\_TILING\_KEY | 用于指定本次CPU调测使用的tilingKey。调测执行时，将只执行算子核函数中该tilingKey对应的分支。 |
| GmFree | 进行核函数的CPU侧运行验证时，用于释放通过GmAlloc申请的共享内存。 |
| SetKernelMode | CPU调测时，设置内核模式为单AIV模式，单AIC模式或者MIX模式，以分别支持单AIV矢量算子，单AIC矩阵算子，MIX混合算子的CPU调试。 |
| TRACE\_START | 通过CAModel进行算子性能仿真时，可对算子任意运行阶段打点，从而分析不同指令的流水图，以便进一步性能调优。 用于表示起始位置打点，一般与TRACE\_STOP配套使用。 |
| TRACE\_STOP | 通过CAModel进行算子性能仿真时，可对算子任意运行阶段打点，从而分析不同指令的流水图，以便进一步性能调优。 用于表示终止位置打点，一般与TRACE\_START配套使用。 |
| MetricsProfStart | 用于设置性能数据采集信号启动，和MetricsProfStop配合使用。使用算子调优（msProf）(https://www.hiascend.com/document/detail/zh/canncommercial/900/devaids/optool/docs/zh/user\_guide/msopprof\_user\_guide.md)工具进行算子上板调优时，可在kernel侧代码段前后分别调用MetricsProfStart和MetricsProfStop来指定需要调优的代码段范围。 |
| MetricsProfStop | 设置性能数据采集信号停止，和MetricsProfStart配合使用。使用算子调优（msProf）(https://www.hiascend.com/document/detail/zh/canncommercial/900/devaids/optool/docs/zh/user\_guide/msopprof\_user\_guide.md)工具进行算子上板调优时，可在kernel侧代码段前后分别调用MetricsProfStart和MetricsProfStop来指定需要调优的代码段范围。 |


**表11 工具函数接口列表**

| 接口名 | 功能描述 |
| --- | --- |
| Async | Async提供了一个统一的接口，用于在不同模式下（AIC或AIV）执行特定函数，从而避免代码中直接的硬件条件判断（如使用ASCEND\_IS\_AIV或ASCEND\_IS\_AIC）。 |
| NumericLimits | NumericLimits工具类，用于查询指定数据类型的最大值/最小值等属性。 |
| GetTaskRatio | 适用于Cube/Vector分离模式，用来获取Cube/Vector的配比。 |
| GetUBSizeInBytes | 获取UB空间的大小，单位为byte。 |
| GetRuntimeUBSize | 获取运行时UB空间的大小，单位为byte。开发者根据UB的大小来计算循环次数等参数值。 |


**表12 Kernel Tiling接口列表**

| 接口名 | 功能描述 |
| --- | --- |
| GET\_TILING\_DATA | 用于获取算子kernel入口函数传入的tiling信息，并填入注册的Tiling结构体中，此函数会以宏展开的方式进行编译。如果用户注册了多个TilingData结构体，使用该接口返回默认注册的结构体。 |
| GET\_TILING\_DATA\_WITH\_STRUCT | 使用该接口指定结构体名称，可获取指定的tiling信息，并填入对应的Tiling结构体中，此函数会以宏展开的方式进行编译。 |
| GET\_TILING\_DATA\_MEMBER | 用于获取tiling结构体的成员变量。 |
| TILING\_KEY\_IS | 在核函数中判断本次执行时的tiling\_key是否等于某个key，从而标识tiling\_key==key的一条kernel分支。 |
| REGISTER\_TILING\_DEFAULT | 用于在kernel侧注册用户使用标准C++语法自定义的默认TilingData结构体。 |
| REGISTER\_TILING\_FOR\_TILINGKEY | 用于在kernel侧注册与TilingKey相匹配的TilingData自定义结构体；该接口需提供一个逻辑表达式，逻辑表达式以字符串“TILING\_KEY\_VAR”代指实际TilingKey，表达TIlingKey所满足的范围。 |
| REGISTER\_NONE\_TILING | 在Kernel侧使用标准C++语法自定义的TilingData结构体时，若用户不确定需要注册哪些结构体，可使用该接口告知框架侧需使用未注册的标准C++语法来定义TilingData，并配套GET\_TILING\_DATA\_WITH\_STRUCT，GET\_TILING\_DATA\_MEMBER，GET\_TILING\_DATA\_PTR\_WITH\_STRUCT来获取对应的TilingData。 |
| KERNEL\_TASK\_TYPE\_DEFAULT | 设置全局默认的kernel type，对所有的tiling key生效。 |
| KERNEL\_TASK\_TYPE | 设置某一个具体的tiling key对应的kernel type。 |


**表13 ISASI接口列表**

| 分类 | 接口名 | 功能描述 |
| --- | --- | --- |
| 标量计算 | WriteGmByPassDCache | 不经过DCache向GM地址上写数据。 |
| 标量计算 | ReadGmByPassDCache | 不经过DCache从GM地址上读数据。 |
| 矢量计算 | VectorPadding | 根据padMode（pad模式）与padSide（pad方向）对源操作数按照datablock进行填充操作。 |
| 矢量计算 | BilinearInterpolation | 双线性插值操作，分为垂直迭代和水平迭代。 |
| 矢量计算 | GetCmpMask | 获取Compare（结果存入寄存器）指令的比较结果。 |
| 矢量计算 | SetCmpMask | 为Select不传入mask参数的接口设置比较寄存器。 |
| 矢量计算 | GetReduceRepeatSumSpr | 获取ReduceSum（针对tensor前n个数据计算）接口的计算结果。 |
| 矢量计算 | GetReduceRepeatMaxMinSpr | 获取ReduceMax、ReduceMin连续场景下的最大/最小值以及相应的索引值。 |
| 矢量计算 | ProposalConcat | 将连续元素合入Region Proposal内对应位置，每次迭代会将16个连续元素合入到16个Region Proposals的对应位置里。 |
| 矢量计算 | ProposalExtract | 与ProposalConcat功能相反，从Region Proposals内将相应位置的单个元素抽取后重排，每次迭代处理16个Region Proposals，抽取16个元素后连续排列。 |
| 矢量计算 | RpSort16 | 根据Region Proposals中的score域对其进行排序（score大的排前面），每次排16个Region Proposals。 |
| 矢量计算 | MrgSort4 | 将已经排好序的最多4 条region proposals队列，排列并合并成1条队列，结果按照score域由大到小排序。 |
| 矢量计算 | Sort32 | 排序函数，一次迭代可以完成32个数的排序。 |
| 矢量计算 | MrgSort | 将已经排好序的最多4 条队列，合并排列成 1 条队列，结果按照score域由大到小排序。 |
| 矢量计算 | GetMrgSortResult | 获取MrgSort或MrgSort4已经处理过的队列里的Region Proposal个数，并依次存储在四个List入参中。 |
| 矢量计算 | Gatherb | 给定一个输入的张量和一个地址偏移张量，Gatherb指令根据偏移地址将输入张量收集到结果张量中。 |
| 矢量计算 | Scatter | 给定一个连续的输入张量和一个目的地址偏移张量，Scatter指令根据偏移地址生成新的结果张量后将输入张量分散到结果张量中。 |
| 矢量计算 | Prelu | 源操作数src0大于0的情况下直接将src0写入目的操作数dst，否则将源操作数src0 \* src1的结果写入dst。 |
| 矢量计算 | Mull | 对前count个输入数据src0、src1按元素相乘操作，将结果写入dst0Local，溢出部分写入dst1Local。 |
| 矢量计算 | AbsSub | 将src0Local与src1相减再求绝对值， 并将计算结果写入dst。 |
| 矢量计算 | ExpSub | src0与src1相减，将差值作为指数计算自然常数e的幂次， 并将计算结果写入dst。 |
| 矢量计算 | MulsCast | 将矢量源操作数前count个数据与标量相乘再按照CAST\_ROUND模式转换成half类型， 并将计算结果写入dst，此接口支持标量在前和标量在后两种场景。 |
| 矢量计算 | Truncate | 将源操作数的浮点数元素截断到整数位，同时源操作数的数据类型保持不变。 |
| 矢量计算 | Interleave | 给定源操作数src0和src1，将src0和src1中的元素交织存入结果操作数dst0和dst1中。 |
| 矢量计算 | DeInterleave | 给定源操作数src0和src1，将src0和src1中的元素解交织存入结果操作数dst0和dst1中。 |
| 数据搬运 | DataCopyPad | 该接口提供数据非对齐搬运的功能。 |
| 数据搬运 | SetPadValue | 设置DataCopyPad接口填充的数值。 |
| 矩阵计算 | Mmad | 完成矩阵乘加操作。 |
| 矩阵计算 | MmadWithSparse | 完成矩阵乘加操作，传入的左矩阵A为稀疏矩阵， 右矩阵B为稠密矩阵 。 |
| 矩阵计算 | SetHF32Mode | 此接口同SetHF32TransMode、SetMMRowMajor以及SetMMColumnMajor一样，都用于设置寄存器的值。SetHF32Mode接口用于设置MMAD的HF32模式。 |
| 矩阵计算 | SetHF32TransMode | 此接口同SetHF32Mode、SetMMRowMajor以及SetMMColumnMajor一样，都用于设置寄存器的值。SetHF32TransMode用于设置MMAD的HF32取整模式，仅在MMAD的HF32模式生效时有效。 |
| 矩阵计算 | SetMMRowMajor | 此接口同SetHF32Mode、SetHF32TransMode一样，都用于设置寄存器的值，本接口用于设置MMAD计算时优先通过N方向。 |
| 矩阵计算 | SetMMColumnMajor | 此接口同SetHF32Mode、SetHF32TransMode一样，都用于设置寄存器的值，本接口用于设置MMAD计算时优先通过M方向。 |
| 矩阵计算 | Conv2D | 计算给定输入张量和权重张量的2\-D卷积，输出结果张量。Conv2d卷积层多用于图像识别，使用过滤器提取图像中的特征。 |
| 矩阵计算 | Gemm | 根据输入的切分规则，将给定的两个输入张量做矩阵乘，输出至结果张量。将A和B两个输入矩阵乘法在一起，得到一个输出矩阵C。 |
| 矩阵计算 | SetFixPipeConfig | DataCopy（CO1\->GM、CO1\->A1）过程中进行随路量化时，通过调用该接口设置量化流程中tensor量化参数。 |
| 矩阵计算 | SetFixpipeNz2ndFlag | DataCopy（CO1\->GM、CO1\->A1）过程中进行随路格式转换（NZ2ND）时，通过调用该接口设置NZ2ND相关配置。 |
| 矩阵计算 | SetFixpipePreQuantFlag | DataCopy（CO1\->GM、CO1\->A1）过程中进行随路量化时，通过调用该接口设置量化流程中scalar量化参数。 |
| 矩阵计算 | SetFixPipeClipRelu | DataCopy（CO1\->GM）过程中进行随路量化后，通过调用该接口设置ClipRelu操作的最大值。 |
| 矩阵计算 | SetFixPipeAddr | DataCopy（CO1\->GM）过程中进行随路量化后，通过调用该接口设置element\-wise操作时LocalTensor的地址。 |
| 矩阵计算 | Fill | 初始化LocalTensor（TPosition为A1/A2/B1/B2）为某一个具体的数值。 |
| 矩阵计算 | LoadData | LoadData包括Load2D和Load3D数据加载功能。 |
| 矩阵计算 | LoadDataWithTranspose | 该接口实现带转置的2D格式数据从A1/B1到A2/B2的加载。 |
| 矩阵计算 | SetAippFunctions | 设置图片预处理（AIPP，AI core pre\-process）相关参数。 |
| 矩阵计算 | LoadImageToLocal | 将图像数据从GM搬运到A1/B1。 搬运过程中可以完成图像预处理操作：包括图像翻转，改变图像尺寸（抠图，裁边，缩放，伸展），以及色域转换，类型转换等。 |
| 矩阵计算 | LoadUnZipIndex | 加载GM上的压缩索引表到内部寄存器。 |
| 矩阵计算 | LoadDataUnzip | 将GM上的数据解压并搬运到A1/B1/B2上。 |
| 矩阵计算 | LoadDataWithSparse | 用于搬运存放在B1里的512B的稠密权重矩阵到B2里，同时读取128B的索引矩阵用于稠密矩阵的稀疏化。 |
| 矩阵计算 | SetFmatrix | 用于调用Load3Dv1/Load3Dv2时设置FeatureMap的属性描述。 |
| 矩阵计算 | SetLoadDataBoundary | 设置Load3D时A1/B1边界值。 |
| 矩阵计算 | SetLoadDataRepeat | 用于设置Load3Dv2接口的repeat参数。设置repeat参数后，可以通过调用一次Load3Dv2接口完成多个迭代的数据搬运。 |
| 矩阵计算 | SetLoadDataPaddingValue | 设置padValue，用于Load3Dv1/Load3Dv2。 |
| 矩阵计算 | Fixpipe | 矩阵计算完成后，对结果进行处理，例如对计算结果进行量化操作，并把数据从CO1搬迁到Global Memory中。 |
| 同步控制 | SetFlag/WaitFlag | 同一核内不同流水线之间的同步指令。具有数据依赖的不同流水指令之间需要插此同步。 |
| 同步控制 | PipeBarrier | 阻塞相同流水，具有数据依赖的相同流水之间需要插此同步。 |
| 同步控制 | DataSyncBarrier | 用于阻塞后续的指令执行，直到所有之前的内存访问指令（需要等待的内存位置可通过参数控制）执行结束。 |
| 同步控制 | CrossCoreSetFlag | 针对分离模式，AI Core上的Cube核（AIC）与Vector核（AIV）之间的同步设置指令。 |
| 同步控制 | CrossCoreWaitFlag | 针对分离模式，AI Core上的Cube核（AIC）与Vector核（AIV）之间的同步等待指令。 |
| 同步控制 | Mutex | Mutex用于核内异步流水指令之间的同步处理，其功能类似于传统CPU中的锁机制。通过锁定指定流水再释放流水来完成流水间的同步依赖。每个锁有固定的一个MutexID，该ID可通过用户自定义（范围为0\-27）或者通过AllocMutexID/ReleaseMutexID进行申请释放。 |
| 同步控制 | AllocMutexID | 从框架获取并占用一个MutexID，与ReleaseMutexID配合使用，管理MutexID的获取和释放。 |
| 同步控制 | ReleaseMutexID | 从框架释放一个MutexID，与AllocMutexID配合使用。 |
| 缓存处理 | ICachePreLoad | 从指令所在DDR地址预加载指令到ICache中。 |
| 缓存处理 | GetICachePreloadStatus | 获取ICACHE的PreLoad的状态。 |
| 系统变量访问 | GetProgramCounter | 获取程序计数器的指针，程序计数器用于记录当前程序执行的位置。 |
| 系统变量访问 | GetSubBlockNum | 获取AI Core上Vector核的数量。 |
| 系统变量访问 | GetSubBlockIdx | 获取AI Core上Vector核的ID。 |
| 系统变量访问 | GetSystemCycle | 获取当前系统cycle数，若换算成时间需要按照50MHz的频率，时间单位为us，换算公式为：time = (cycle数/50) us 。 |
| 系统变量访问 | SetCtrlSpr | 对CTRL寄存器（控制寄存器）的特定比特位进行设置。 |
| 系统变量访问 | GetCtrlSpr | 读取CTRL寄存器（控制寄存器）特定比特位上的值。 |
| 系统变量访问 | ResetCtrlSpr | 对CTRL寄存器（控制寄存器）的特定比特位做重置。 |
| 原子操作 | SetAtomicMax | 原子操作函数，设置后续从VECOUT传输到GM的数据是否执行原子比较，将待拷贝的内容和GM已有内容进行比较，将最大值写入GM。 |
| 原子操作 | SetAtomicMin | 原子操作函数，设置后续从VECOUT传输到GM的数据是否执行原子比较，将待拷贝的内容和GM已有内容进行比较，将最小值写入GM。 |
| 原子操作 | SetStoreAtomicConfig | 设置原子操作使能位与原子操作类型。 |
| 原子操作 | GetStoreAtomicConfig | 获取原子操作使能位与原子操作类型的值。 |
| 调试接口 | CheckLocalMemoryIA | 监视设定范围内的UB读写行为，如果监视到有设定范围的读写行为则会出现EXCEPTION报错，未监视到设定范围的读写行为则不会报错。 |
| Cube分组管理 | CubeResGroupHandle | CubeResGroupHandle用于在分离模式下通过软同步控制AIC和AIV之间进行通讯，实现AI Core计算资源分组。 |
| Cube分组管理 | GroupBarrier | 当同一个CubeResGroupHandle中的两个AIV任务之间存在依赖关系时，可以使用GroupBarrier控制同步。 |
| Cube分组管理 | KfcWorkspace | KfcWorkspace为通信空间描述符，管理不同CubeResGroupHandle的消息通信区划分，与CubeResGroupHandle配合使用。KfcWorkspace的构造函数用于创建KfcWorkspace对象。 |


#### 高阶API


**表14 数学计算API列表**

| 接口名 | 功能描述 |
| --- | --- |
| Acos | 按元素做反余弦函数计算。 |
| Acosh | 按元素做双曲反余弦函数计算。 |
| Asin | 按元素做反正弦函数计算。 |
| Asinh | 按元素做反双曲正弦函数计算。 |
| Atan | 按元素做三角函数反正切运算。 |
| Atanh | 按元素做反双曲正切余弦函数计算。 |
| Axpy | 源操作数中每个元素与标量求积后和目的操作数中的对应元素相加。 |
| Ceil | 获取大于或等于x的最小的整数值，即向正无穷取整操作。 |
| ClampMax | 将srcTensor中大于scalar的数替换为scalar，小于等于scalar的数保持不变，作为dstTensor输出。 |
| ClampMin | 将srcTensor中小于scalar的数替换为scalar，大于等于scalar的数保持不变，作为dstTensor输出。 |
| Cos | 按元素做三角函数余弦运算。 |
| Cosh | 按元素做双曲余弦函数计算。 |
| CumSum | 对数据按行依次累加或按列依次累加。 |
| Digamma | 按元素计算x的gamma函数的对数导数。 |
| Erf | 按元素做误差函数计算，也称为高斯误差函数。 |
| Erfc | 返回输入x的互补误差函数结果，积分区间为x到无穷大。 |
| Exp | 按元素取自然指数。 |
| Floor | 获取小于或等于x的最小的整数值，即向负无穷取整操作。 |
| Fmod | 按元素计算两个浮点数相除后的余数。 |
| Frac | 按元素做取小数计算。 |
| Hypot | 按元素计算两个浮点数平方和的平方根。 |
| IsFinite | 按元素判断输入的浮点数是否非NAN、非±INF。 |
| Lgamma | 按元素计算x的gamma函数的绝对值并求自然对数。 |
| Log | 按元素以e、2、10为底做对数运算。 |
| Power | 实现按元素做幂运算功能。 |
| Round | 将输入的元素四舍五入到最接近的整数。 |
| Sign | 按元素执行Sign操作，Sign是指返回输入数据的符号。 |
| Sin | 按元素做正弦函数计算。 |
| Sinh | 按元素做双曲正弦函数计算。 |
| Tan | 按元素做正切函数计算。 |
| Tanh | 按元素做逻辑回归Tanh。 |
| Trunc | 按元素做浮点数截断操作，即向零取整操作。 |
| Xor | 按元素执行Xor（异或）运算。 |
| Fma | 按元素计算两个输入相乘后与第三个输入相加的结果。 |
| IsNan | 按元素判断输入的浮点数是否为nan。 |
| IsInf | 按元素判断输入的浮点数是否为±INF。 |
| Rint | 获取与输入数据最接近的整数。 |
| SinCos | 按元素进行正弦计算和余弦计算，分别获得正弦和余弦的结果。 |
| LogicalNot | 按元素进行取反操作。 |
| LogicalAnd | 按元素进行与操作。 |
| LogicalAnds | 输入矢量内的每个元素与标量进行与操作。 |
| LogicalOr | 按元素进行或操作。 |
| LogicalOrs | 输入矢量内的每个元素与标量进行或操作。 |
| LogicalXor | 按元素进行逻辑异或操作。 |
| BitwiseNot | 逐比特对输入进行取反。 |
| BitwiseAnd | 逐比特对两个输入进行与操作。 |
| BitwiseOr | 逐比特对两个输入进行或操作。 |
| BitwiseXor | 逐比特对两个输入进行异或操作。 |
| Where | 根据指定的条件，从两个源操作数中选择元素，生成目标操作数。 |


**表15 量化操作API列表**

| 接口名 | 功能描述 |
| --- | --- |
| AntiQuantize | 按元素做伪量化计算，比如将int8\_t数据类型伪量化为half数据类型。 |
| AscendAntiQuant | 按元素做伪量化计算，比如将int8\_t数据类型伪量化为half数据类型。 |
| Dequantize | 按元素做反量化计算，比如将int32\_t数据类型反量化为half/float等数据类型。 |
| AscendDequant | 按元素做反量化计算，比如将int32\_t数据类型反量化为half/float等数据类型。 |
| Quantize | 按元素做量化计算，比如将half/float数据类型量化为int8\_t数据类型。 |
| AscendQuant | 按元素做量化计算，比如将half/float数据类型量化为int8\_t数据类型。 |


**表16 归一化操作API列表**

| 接口名 | 功能描述 |
| --- | --- |
| BatchNorm | 对于每个batch中的样本，对其输入的每个特征在batch的维度上进行归一化。 |
| DeepNorm | 在深层神经网络训练过程中，可以替代LayerNorm的一种归一化方法。 |
| GroupNorm | 将输入的C维度分为groupNum组，对每一组数据进行标准化。 |
| LayerNorm | 将输入数据收敛到[0, 1]之间，可以规范网络层输入输出数据分布的一种归一化方法。 |
| LayerNormGrad | 用于计算LayerNorm的反向传播梯度。 |
| LayerNormGradBeta | 用于获取反向beta/gmma的数值，和LayerNormGrad共同输出pdx, gmma和beta。 |
| Normalize | LayerNorm中，已知均值和方差，计算shape为[A，R]的输入数据的标准差的倒数rstd和归一化输出y。 |
| RmsNorm | 实现对shape大小为[B，S，H]的输入数据的RmsNorm归一化。 |
| WelfordUpdate | 实现Welford算法的前处理。 |
| WelfordFinalize | 实现Welford算法的后处理。 |


**表17 激活函数API列表**

| 接口名 | 功能描述 |
| --- | --- |
| AdjustSoftMaxRes | 用于对SoftMax相关计算结果做后处理，调整SoftMax的计算结果为指定的值。 |
| FasterGelu | FastGelu化简版本的一种激活函数。 |
| FasterGeluV2 | 实现FastGeluV2版本的一种激活函数。 |
| GeGLU | 采用GeLU作为激活函数的GLU变体。 |
| Gelu | GELU是一个重要的激活函数，其灵感来源于relu和dropout，在激活中引入了随机正则的思想。 |
| LogSoftMax | 对输入tensor做LogSoftmax计算。 |
| ReGlu | 一种GLU变体，使用Relu作为激活函数。 |
| Sigmoid | 按元素做逻辑回归Sigmoid。 |
| Silu | 按元素做Silu运算。 |
| SimpleSoftMax | 使用计算好的sum和max数据对输入tensor做softmax计算。 |
| SoftMax | 对输入tensor按行做Softmax计算。 |
| SoftmaxFlash | SoftMax增强版本，除了可以对输入tensor做softmaxflash计算，还可以根据上一次softmax计算的sum和max来更新本次的softmax计算结果。 |
| SoftmaxFlashV2 | SoftmaxFlash增强版本，对应FlashAttention\-2算法。 |
| SoftmaxFlashV3 | SoftmaxFlash增强版本，对应Softmax PASA算法。 |
| SoftmaxGrad | 对输入tensor做grad反向计算的一种方法。 |
| SoftmaxGradFront | 对输入tensor做grad反向计算的一种方法。 |
| SwiGLU | 采用Swish作为激活函数的GLU变体。 |
| Swish | 神经网络中的Swish激活函数。 |


**表18 归约操作API列表**

| 接口名 | 功能描述 |
| --- | --- |
| Sum | 获取最后一个维度的元素总和。 |
| Mean | 根据最后一轴的方向对各元素求平均值。 |
| ReduceXorSum | 按照元素执行Xor（按位异或）运算，并将计算结果ReduceSum求和。 |
| ReduceSum | 对一个多维向量按照指定的维度进行数据累加。 |
| ReduceMean | 对一个多维向量按照指定的维度求平均值。 |
| ReduceMax | 对一个多维向量在指定的维度求最大值。 |
| ReduceMin | 对一个多维向量在指定的维度求最小值。 |
| ReduceAny | 对一个多维向量在指定的维度求逻辑或。 |
| ReduceAll | 对一个多维向量在指定的维度求逻辑与。 |
| ReduceProd | 对一个多维向量在指定的维度求积。 |


**表19 排序操作API列表**

| 接口名 | 功能描述 |
| --- | --- |
| TopK | 获取最后一个维度的前k个最大值或最小值及其对应的索引。 |
| Concat | 对数据进行预处理，将要排序的源操作数srcLocal一一对应的合入目标数据concatLocal中，数据预处理完后，可以进行Sort。 |
| Extract | 处理Sort的结果数据，输出排序后的value和index。 |
| Sort | 排序函数，按照数值大小进行降序排序。 |
| MrgSort | 将已经排好序的最多4条队列，合并排列成1条队列，结果按照score域由大到小排序。 |


**表20 数据过滤API列表**

| 接口名 | 功能描述 |
| --- | --- |
| Select | 给定两个源操作数src0和src1，根据maskTensor相应位置的值（非bit位）选取元素，得到目的操作数dst。 |
| DropOut | 提供根据MaskTensor对源操作数进行过滤的功能，得到目的操作数。 |


**表21 张量变换API列表**

| 接口名 | 功能描述 |
| --- | --- |
| Transpose | 对输入数据进行数据排布及Reshape操作。 |
| TransData | 将输入数据的排布格式转换为目标排布格式。 |
| Broadcast | 将输入按照输出shape进行广播。 |
| Pad | 对height \* width的二维Tensor在width方向上pad到32B对齐。 |
| UnPad | 对height \* width的二维Tensor在width方向上进行unpad。 |
| Fill | 将Global Memory上的数据初始化为指定值。 |


**表22 索引计算API列表**

| 接口名 | 功能描述 |
| --- | --- |
| Arange | 给定起始值，等差值和长度，返回一个等差数列。 |


**表23 矩阵计算API列表**

| 接口名 | 功能描述 |
| --- | --- |
| Matmul | Matmul矩阵乘法的运算。 |


**表24 HCCL通信类API列表**

| 接口名 | 功能描述 |
| --- | --- |
| HCCL通信类 | 在AI Core侧编排集合通信任务。 |


**表25 卷积计算API列表**

| 接口名 | 功能描述 |
| --- | --- |
| Conv3D | 3维卷积正向矩阵运算。 |
| Conv3DBackpropInput | 卷积的反向运算，求解特征矩阵的反向传播误差。 |
| Conv3DBackpropFilter | 卷积的反向运算，求解权重的反向传播误差。 |


**表26 随机函数API列表**

| 接口名 | 功能描述 |
| --- | --- |
| PhiloxRandom | 基于Philox随机数生成算法，给定随机数种子，生成若干的随机数。 |


#### SIMT API


**表27 核函数定义API**

| 接口名 | 功能描述 |
| --- | --- |
| asc\_vf\_call | 启动SIMT VF（Vector Function）子任务，启动指定数目的线程，执行指定的SIMT核函数。 |


**表28 同步函数**

| 接口名 | 功能描述 |
| --- | --- |
| asc\_syncthreads | 等待当前thread block内所有thread代码都执行到该函数位置。 |
| asc\_threadfence | 用于保证不同核对同一份全局、共享内存的访问过程中，写入操作的时序性。 |
| asc\_threadfence\_block | 用于协调同一线程块（Thread Block）内线程之间的内存操作顺序，确保某一线程在调用asc\_threadfence\_block()之前的所有内存读写操作对同一线程块内的其他线程可见。 |


**表29 数学函数**

| 接口名 | 功能描述 |
| --- | --- |
| tanf | 获取输入数据的三角函数正切值。 |
| tanhf | 获取输入数据的三角函数双曲正切值。 |
| htanh | 获取输入数据的三角函数双曲正切值。 |
| h2tanh | 获取输入数据各元素的三角函数双曲正切值。 |
| tanpif | 获取输入数据与π相乘的正切值。 |
| atanf | 获取输入数据的反正切值。 |
| atan2f | 获取输入数据y/x的反正切值。 |
| atanhf | 获取输入数据的反双曲正切值。 |
| expf | 指定输入x，获取e的x次方。 |
| hexp | 指定输入x，获取e的x次方。 |
| h2exp | 指定输入x，对x的各元素，获取e的该元素次方。 |
| exp2f | 指定输入x，获取2的x次方。 |
| hexp2 | 指定输入x，获取2的x次方。 |
| h2exp2 | 指定输入x，对x的各元素，获取2的该元素次方。 |
| exp10f | 指定输入x，获取10的x次方。 |
| hexp10 | 指定输入x，获取10的x次方。 |
| h2exp10 | 指定输入x，对x的各元素，获取10的该元素次方。 |
| expm1f | 指定输入x，获取e的x次方减1。 |
| logf | 获取以e为底，输入数据的对数。 |
| hlog | 获取以e为底，输入数据的对数。 |
| h2log | 获取以e为底，输入数据各元素的对数。 |
| log2f | 获取以2为底，输入数据的对数。 |
| hlog2 | 获取以2为底，输入数据的对数。 |
| h2log2 | 获取以2为底，输入数据各元素的对数。 |
| log10f | 获取以10为底，输入数据的对数。 |
| hlog10 | 获取以10为底，输入数据的对数。 |
| h2log10 | 获取以10为底，输入数据各元素的对数。 |
| log1pf | 获取以e为底，输入数据加1的对数。 |
| logbf | 计算以2为底，输入数据的对数，并对结果向下取整，返回浮点数。 |
| ilogbf | 计算以2为底，输入数据的对数，并对结果向下取整，返回整数。 |
| cosf | 获取输入数据的三角函数余弦值。 |
| hcos | 获取输入数据的三角函数余弦值。 |
| h2cos | 获取输入数据各元素的三角函数余弦值。 |
| coshf | 获取输入数据的双曲余弦值。 |
| cospif | 获取输入数据与π相乘的余弦值。 |
| acosf | 获取输入数据的反余弦值。 |
| acoshf | 获取输入数据的双曲反余弦值。 |
| sinf | 获取输入数据的三角函数正弦值。 |
| hsin | 获取输入数据的三角函数正弦值。 |
| h2sin | 获取输入数据各元素的三角函数正弦值。 |
| sinhf | 获取输入数据的双曲正弦值。 |
| sinpif | 获取输入数据与π相乘的正弦值。 |
| asinf | 获取输入数据的反正弦值。 |
| asinhf | 获取输入数据的双曲反正弦值。 |
| sincosf | 获取输入数据的三角函数正弦值和余弦值。 |
| sincospif | 获取输入数据与π相乘的三角函数正弦值和余弦值。 |
| frexpf | 将x转换为归一化[1/2, 1)的有符号数乘以2的积分幂。 |
| ldexpf | 获取输入x乘以2的exp次幂的结果。 |
| sqrtf | 获取输入数据x的平方根。 |
| hsqrt | 获取输入数据x的平方根。 |
| h2sqrt | 获取输入数据x各元素的平方根。 |
| rsqrtf | 获取输入数据x的平方根的倒数。 |
| hrsqrt | 获取输入数据x的平方根的倒数。 |
| h2rsqrt | 获取输入数据x各元素的平方根的倒数。 |
| hrcp | 获取输入数据x的倒数。 |
| h2rcp | 获取输入数据x各元素的倒数。 |
| hypotf | 获取输入数据x、y的平方和x^2 + y^2的平方根。 |
| rhypotf | 获取输入数据x、y的平方和x^2 + y^2的平方根的倒数。 |
| powf | 获取输入数据x的y次幂。 |
| norm3df | 获取输入数据a、b、c的平方和a^2 + b^2 + c^2的平方根。 |
| rnorm3df | 获取输入数据a、b、c的平方和a^2 + b^2 + c^2的平方根的倒数。 |
| norm4df | 获取输入数据a、b、c、d的平方和a^2 + b^2+ c^2+ d^2的平方根。 |
| rnorm4df | 获取输入数据a、b、c、d的平方和a^2 + b^2 + c^2 + d^2的平方根的倒数。 |
| normf | 获取输入数据a中前n个元素的平方和a[0]^2 + a[1]^2 +...+ a[n\-1]^2的平方根。 |
| rnormf | 获取输入数据a中前n个元素的平方和a[0]^2 + a[1]^2 + ...+ a[n\-1]^2的平方根的倒数。 |
| cbrtf | 获取输入数据x的立方根。 |
| rcbrtf | 获取输入数据x的立方根的倒数。 |
| erff | 获取输入数据的误差函数值。 |
| erfcf | 获取输入数据的互补误差函数值。 |
| erfinvf | 获取输入数据的逆误差函数值。 |
| erfcinvf | 获取输入数据的逆互补误差函数值。 |
| erfcxf | 获取输入数据的缩放互补误差函数值。 |
| tgammaf | 获取输入数据x的伽马函数值。 |
| lgammaf | 获取输入数据x伽马值的绝对值并求自然对数。 |
| cyl\_bessel\_i0f | 获取输入数据x的0阶常规修正圆柱贝塞尔函数的值。 |
| cyl\_bessel\_i1f | 获取输入数据x的1阶常规修正圆柱贝塞尔函数的值。 |
| normcdff | 获取输入数据x的标准正态分布的累积分布函数值。 |
| normcdfinvf | 获取输入数据x的标准正态累积分布的逆函数 |
| j0f | 获取输入数据x的0阶第一类贝塞尔函数j0的值。 |
| j1f | 获取输入数据x的1阶第一类贝塞尔函数j1的值。 |
| jnf | 获取输入数据x的n阶第一类贝塞尔函数jn的值。 |
| y0f | 获取输入数据x的0阶第二类贝塞尔函数y0的值。 |
| y1f | 获取输入数据x的1阶第二类贝塞尔函数y1的值。 |
| ynf | 获取输入数据x的n阶第二类贝塞尔函数yn的值。 |
| fabsf | 获取输入数据的绝对值。 |
| \_\_habs | 获取输入数据的绝对值。 |
| fmaf | 对输入数据x、y、z，计算x与y相乘加上z的结果。 |
| \_\_hfma | 对输入数据x、y、z，计算x与y相乘加上z的结果。 |
| fmaxf | 获取两个输入数据中的最大值。 |
| \_\_hmax | 获取两个输入数据中的最大值。 |
| fminf | 获取两个输入数据中的最小值。 |
| \_\_hmin | 获取两个输入数据中的最小值。 |
| fdimf | 获取输入数据的差值，差值小于0时，返回0。 |
| remquof | 获取输入数据x除以y的余数。求余数时，商取最接近x除以y浮点数结果的整数，当x除以y的浮点数结果与左右最接近的整数距离相等时，商取偶数，同时将商赋值给指针变量quo。 |
| fmodf | 获取输入数据x除以y的余数。求余数时，商取x除以y浮点数结果的整数部分。 |
| remainderf | 获取输入数据x除以y的余数。求余数时，商取最接近x除以y浮点数结果的整数，当x除以y的浮点数结果与左右最接近的整数距离相等时，商取偶数。 |
| copysignf | 获取由第一个输入x的数值部分和第二个输入y的符号部分拼接得到的浮点数。 |
| nearbyIntf | 获取与输入浮点数最接近的整数，输入浮点数与左右整数的距离相等时，返回偶数。 |
| nextafterf | 如果y大于x，返回比x大的下一个可表示的浮点值，即浮点数二进制最低位加1。 如果y小于x，返回比x小的下一个可表示的浮点值，即浮点数二进制最低位减1。 如果y等于x，返回x。 |
| scalbnf | 获取输入数据x与2的n次方的乘积。 |
| scalblnf | 获取输入数据x与2的n次方的乘积。 |
| modff | 将输入数据分解为小数部分和整数部分。 |
| labs | 获取输入数据的绝对值。 |
| llabs | 获取输入数据的绝对值。 |
| llmax | 获取两个输入数据中的最大值。 |
| ullmax | 获取两个输入数据中的最大值。 |
| umax | 获取两个输入数据中的最大值。 |
| llmin | 获取两个输入数据中的最小值。 |
| ullmin | 获取两个输入数据中的最小值。 |
| umin | 获取两个输入数据中的最小值。 |
| fdivdef | 获取两个输入数据相除的结果。 |
| signbit | 获取输入数据的符号位。 |
| \_\_mulhi | 获取输入int32类型数据x和y乘积的高32位。 |
| \_\_umulhi | 获取输入uint32类型数据x和y乘积的高32位。 |
| \_\_mul64hi | 获取输入int64类型数据x和y乘积的高64位。 |
| \_\_umul64hi | 获取输入uint64类型数据x和y乘积的高64位。 |
| \_\_mul\_i32toi64 | 计算输入32位整数x和y的乘积，返回64位结果。 |
| \_\_brev | 将输入数据的位序反转，返回反转后的值。 |
| \_\_clz | 从输入数据的二进制最高有效位开始，返回连续的前导零的位数。 |
| \_\_ffs | 从二进制输入数据的最低位开始，查找第一个值为1的比特位的位置，并返回该位置的索引，索引从1开始计数；如果二进制数据中没有1，则返回0。 |
| \_\_popc | 统计输入数据从二进制的高位到低位比特位为1的数量。 |
| \_\_byte\_perm | 由输入的两个4字节的uint32\_t类型数据组成一个8个字节的64比特位的整数，通过选择器s指定选取其中的4个字节，将这4个字节从低位到高位拼成一个uint32\_t类型的整数。 |


**表30 精度转换**

| 接口名 | 功能描述 |
| --- | --- |
| rintf | 获取与输入数据最接近的整数，若存在两个同样接近的整数，则获取其中的偶数。 |
| hrint | 获取与输入数据最接近的整数，若存在两个同样接近的整数，则获取其中的偶数。 |
| h2rint | 获取与输入数据各元素最接近的整数，若存在两个同样接近的整数，则获取其中的偶数。 |
| lrintf | 获取与输入数据最接近的整数，若存在两个同样接近的整数，则获取其中的偶数。 |
| llrintf | 获取与输入数据最接近的整数，若存在两个同样接近的整数，则获取其中的偶数。 |
| roundf | 获取对输入数据四舍五入后的整数。 |
| lroundf | 获取对输入数据四舍五入后的整数。 |
| llroundf | 获取对输入数据四舍五入后的整数。 |
| floorf | 获取小于或等于输入数据的最大整数值。 |
| hfloor | 获取小于或等于输入数据的最大整数值。 |
| h2floor | 获取小于或等于输入数据各元素的最大整数值。 |
| ceilf | 获取大于或等于输入数据的最小整数值。 |
| hceil | 获取大于或等于输入数据的最小整数值。 |
| h2ceil | 获取大于或等于输入数据各元素的最小整数值。 |
| truncf | 获取对输入数据的浮点数截断后的整数。 |
| htrunc | 获取对输入数据的浮点数截断后的整数。 |
| h2trunc | 获取对输入数据各元素的浮点数截断后的整数。 |


**表31 比较函数**

| 接口名 | 功能描述 |
| --- | --- |
| isfinite | 判断浮点数是否为有限数（非inf、非nan）。 |
| isnan | 判断浮点数是否为nan。 |
| \_\_hisnan | 判断浮点数是否为nan。 |
| isinf | 判断浮点数是否为无穷。 |
| \_\_hisinf | 判断浮点数是否为无穷。 |


**表32 Atomic函数**

| 接口名 | 功能描述 |
| --- | --- |
| asc\_atomic\_add | 对Unified Buffer或Global Memory上的数据与指定数据执行原子加操作，即将指定数据累加到Unified Buffer或Global Memory的数据中。 |
| asc\_atomic\_sub | 对Unified Buffer或Global Memory上的数据与指定数据执行原子减操作，即在Unified Buffer或Global Memory的数据上减去指定数据。 |
| asc\_atomic\_exch | 对Unified Buffer或Global Memory地址做原子赋值操作，即将指定数据赋值到Unified Buffer或Global Memory地址中。 |
| asc\_atomic\_max | 对Unified Buffer或Global Memory数据做原子求最大值操作，即将Unified Buffer或Global Memory的数据与指定数据中的最大值赋值到Unified Buffer或Global Memory地址中。 |
| asc\_atomic\_min | 对Unified Buffer或Global Memory数据做原子求最小值操作，即将Unified Buffer或Global Memory的数据与指定数据中的最小值赋值到Unified Buffer或Global Memory地址中。 |
| asc\_atomic\_inc | 对Unified Buffer或Global Memory上address的数值进行原子加1操作，如果address上的数值大于等于指定数值val，则对address赋值为0，否则将address上数值加1。 |
| asc\_atomic\_dec | 对Unified Buffer或Global Memory上address的数值进行原子减1操作，如果address上的数值等于0或大于指定数值val，则对address赋值为val，否则将address上数值减1。 |
| asc\_atomic\_cas | 对Unified Buffer或Global Memory上address的数值进行原子比较赋值操作，如果address上的数值等于指定数值compare，则对address赋值为指定数值val，否则address的数值不变。 |
| asc\_atomic\_and | 对Unified Buffer或Global Memory上address的数值与指定数值val进行原子与（&）操作，即将address数值与（&）val的结果赋值到Unified Buffer或Global Memory上。 |
| asc\_atomic\_or | 对Unified Buffer或Global Memory上address的数值与指定数值val进行原子或（\|）操作，即将address数值或（\|）val的结果赋值到Unified Buffer或Global Memory上。 |
| asc\_atomic\_xor | 对Unified Buffer或Global Memory上address的数值与指定数值val进行原子异或（^）操作，即将address数值异或（^）val的结果赋值到Unified Buffer或Global Memory上。 |


**表33 Warp函数**

| 接口名 | 功能描述 |
| --- | --- |
| asc\_all | 判断是否所有活跃线程的输入均不为0。 |
| asc\_any | 判断是否有活跃线程的输入不为0。 |
| asc\_ballot | 判断Warp内每个活跃线程的输入是否不为0。 |
| asc\_activemask | 查看Warp内所有线程是否为活跃状态。 |
| asc\_shfl | 获取Warp内指定线程srcLane输入的用于交换的var值。 |
| asc\_shfl\_up | 获取Warp内当前线程向前偏移delta（当前线程LaneId\-delta）的线程输入的用于交换的var值。 |
| asc\_shfl\_down | 获取Warp内当前线程向后偏移delta（当前线程LaneId+delta）的线程输入的用于交换的var值。 |
| asc\_shfl\_xor | 获取Warp内当前线程LaneId与输入laneMask做异或操作（LaneId^laneMask）得到的dstLaneId对应线程输入的用于交换的var值。 |
| asc\_reduce\_add | 对Warp内所有活跃线程输入的val求和。 |
| asc\_reduce\_max | 对Warp内所有活跃线程输入的val求最大值。 |
| asc\_reduce\_min | 对Warp内所有活跃线程输入val求最小值。 |


**表34 类型转换**

| 接口名 | 功能描述 |
| --- | --- |
| \_\_float2float\_rn | 获取输入遵循CAST\_RINT模式取整后的浮点数。 |
| \_\_float2float\_rz | 获取输入遵循CAST\_TRUNC模式取整后的浮点数。 |
| \_\_float2float\_rd | 获取输入遵循CAST\_FLOOR模式取整后的浮点数。 |
| \_\_float2float\_ru | 获取输入遵循CAST\_CEIL模式取整后的浮点数。 |
| \_\_float2float\_rna | 获取输入遵循CAST\_ROUND模式取整后的浮点数。 |
| \_\_float2half | 获取输入遵循CAST\_RINT模式转换成的半精度浮点数。 |
| \_\_float2half\_rn | 获取输入遵循CAST\_RINT模式转换成的半精度浮点数。 |
| \_\_float2half\_rn\_sat | 饱和模式下获取输入遵循CAST\_RINT模式转换成的半精度浮点数。 |
| \_\_float2half\_rz | 获取输入遵循CAST\_TRUNC模式转换成的半精度浮点数。 |
| \_\_float2half\_rz\_sat | 饱和模式下获取输入遵循CAST\_TRUNC模式转换成的半精度浮点数。 |
| \_\_float2half\_rd | 获取输入遵循CAST\_FLOOR模式转换成的半精度浮点数。 |
| \_\_float2half\_rd\_sat | 饱和模式下获取输入遵循CAST\_FLOOR模式转换成的半精度浮点数。 |
| \_\_float2half\_ru | 获取输入遵循CAST\_CEIL模式转换成的半精度浮点数。 |
| \_\_float2half\_ru\_sat | 饱和模式下获取输入遵循CAST\_CEIL模式转换成的半精度浮点数。 |
| \_\_float2half\_rna | 获取输入遵循CAST\_ROUND模式转换成的半精度浮点数。 |
| \_\_float2half\_rna\_sat | 饱和模式下获取输入遵循CAST\_ROUND模式转换成的半精度浮点数。 |
| \_\_float2half\_ro | 获取输入遵循CAST\_ODD模式转换成的半精度浮点数。 |
| \_\_float2half\_ro\_sat | 饱和模式下获取输入遵循CAST\_ODD模式转换成的半精度浮点数。 |
| \_\_float2bfloat16 | 获取输入遵循CAST\_RINT模式转换成的bfloat16类型数据。 |
| \_\_float2bfloat16\_rn | 获取输入遵循CAST\_RINT模式转换成的bfloat16类型数据。 |
| \_\_float2bfloat16\_rn\_sat | 饱和模式下获取输入遵循CAST\_RINT模式转换成的bfloat16类型数据。 |
| \_\_float2bfloat16\_rz | 获取输入遵循CAST\_TRUNC模式转换成的bfloat16类型数据。 |
| \_\_float2bfloat16\_rz\_sat | 饱和模式下获取输入遵循CAST\_TRUNC模式转换成的bfloat16类型数据。 |
| \_\_float2bfloat16\_rd | 获取输入遵循CAST\_FLOOR模式转换成的bfloat16类型数据。 |
| \_\_float2bfloat16\_rd\_sat | 饱和模式下获取输入遵循CAST\_FLOOR模式转换成的bfloat16类型数据。 |
| \_\_float2bfloat16\_ru | 获取输入遵循CAST\_CEIL模式转换成的bfloat16类型数据。 |
| \_\_float2bfloat16\_ru\_sat | 饱和模式下获取输入遵循CAST\_CEIL模式转换成的bfloat16类型数据。 |
| \_\_float2bfloat16\_rna | 获取输入遵循CAST\_ROUND模式转换成的bfloat16类型数据。 |
| \_\_float2bfloat16\_rna\_sat | 饱和模式下获取输入遵循CAST\_ROUND模式转换成的bfloat16类型数据。 |
| \_\_float2uint\_rn | 获取输入遵循CAST\_RINT模式转换成的无符号整数。 |
| \_\_float2uint\_rz | 获取输入遵循CAST\_TRUNC模式转换成的无符号整数。 |
| \_\_float2uint\_rd | 获取输入遵循CAST\_FLOOR模式转换成的无符号整数。 |
| \_\_float2uint\_ru | 获取输入遵循CAST\_CEIL模式转换成的无符号整数。 |
| \_\_float2uint\_rna | 获取输入遵循CAST\_ROUND模式转换成的无符号整数。 |
| \_\_float2int\_rn | 获取输入遵循CAST\_RINT模式转换成的有符号整数。 |
| \_\_float2int\_rz | 获取输入遵循CAST\_TRUNC模式转换成的有符号整数。 |
| \_\_float2int\_rd | 获取输入遵循CAST\_FLOOR模式转换成的有符号整数。 |
| \_\_float2int\_ru | 获取输入遵循CAST\_CEIL模式转换成的有符号整数。 |
| \_\_float2int\_rna | 获取输入遵循CAST\_ROUND模式转换成的有符号整数。 |
| \_\_float2ull\_rn | 获取输入遵循CAST\_RINT模式转换成的64位无符号整数。 |
| \_\_float2ull\_rz | 获取输入遵循CAST\_TRUNC模式转换成的64位无符号整数。 |
| \_\_float2ull\_rd | 获取输入遵循CAST\_FLOOR模式转换成的64位无符号整数。 |
| \_\_float2ull\_ru | 获取输入遵循CAST\_CEIL模式转换成的64位无符号整数。 |
| \_\_float2ull\_rna | 获取输入遵循CAST\_ROUND模式转换成的64位无符号整数。 |
| \_\_float2ll\_rn | 获取输入遵循CAST\_RINT模式转换成的64位有符号整数。 |
| \_\_float2ll\_rz | 获取输入遵循CAST\_TRUNC模式转换成的64位有符号整数。 |
| \_\_float2ll\_rd | 获取输入遵循CAST\_FLOOR模式转换成的64位有符号整数。 |
| \_\_float2ll\_ru | 获取输入遵循CAST\_CEIL模式转换成的64位有符号整数。 |
| \_\_float2ll\_rna | 获取输入遵循CAST\_ROUND模式转换成的64位有符号整数。 |
| \_\_float22half2\_rn\_sat | 饱和模式下获取输入的两个分量遵循CAST\_RINT模式转换成的half2类型数据。 |
| \_\_float22half2\_rz | 获取输入的两个分量遵循CAST\_TRUNC模式转换成的half2类型数据。 |
| \_\_float22half2\_rz\_sat | 饱和模式下获取输入的两个分量遵循CAST\_TRUNC模式转换成的half2类型数据。 |
| \_\_float22half2\_rd | 获取输入的两个分量遵循CAST\_FLOOR模式转换成的half2类型数据。 |
| \_\_float22half2\_rd\_sat | 饱和模式下获取输入的两个分量遵循CAST\_FLOOR模式转换成的half2类型数据。 |
| \_\_float22half2\_ru | 获取输入的两个分量遵循CAST\_CEIL模式转换成的half2类型数据。 |
| \_\_float22half2\_ru\_sat | 饱和模式下获取输入的两个分量遵循CAST\_CEIL模式转换成的half2类型数据。 |
| \_\_float22half2\_rna | 获取输入的两个分量遵循CAST\_ROUND模式转换成的half2类型数据。 |
| \_\_float22half2\_rna\_sat | 饱和模式下获取输入的两个分量遵循CAST\_ROUND模式转换成的half2类型数据。 |
| \_\_float22half2\_ro | 获取输入的两个分量遵循CAST\_ODD模式转换成的half2类型数据。 |
| \_\_float22half2\_ro\_sat | 饱和模式下获取输入的两个分量遵循CAST\_ODD模式转换成的half2类型数据。 |
| \_\_float22bfloat162\_rn\_sat | 饱和模式下获取输入的两个分量遵循CAST\_RINT模式转换成的bfloat16x2\_t类型数据。 |
| \_\_float22bfloat162\_rz | 获取输入的两个分量遵循CAST\_TRUNC模式转换成的bfloat16x2\_t类型数据。 |
| \_\_float22bfloat162\_rz\_sat | 饱和模式下获取输入的两个分量遵循CAST\_TRUNC模式转换成的bfloat16x2\_t类型数据。 |
| \_\_float22bfloat162\_rd | 获取输入的两个分量遵循CAST\_FLOOR模式转换成的bfloat16x2\_t类型数据。 |
| \_\_float22bfloat162\_rd\_sat | 饱和模式下获取输入的两个分量遵循CAST\_FLOOR模式转换成的bfloat16x2\_t类型数据。 |
| \_\_float22bfloat162\_ru | 获取输入的两个分量遵循CAST\_CEIL模式转换成的bfloat16x2\_t类型数据。 |
| \_\_float22bfloat162\_ru\_sat | 饱和模式下获取输入的两个分量遵循CAST\_CEIL模式转换成的bfloat16x2\_t类型数据。 |
| \_\_float22bfloat162\_rna | 获取输入的两个分量遵循CAST\_ROUND模式转换成的bfloat16x2\_t类型数据。 |
| \_\_float22bfloat162\_rna\_sat | 饱和模式下获取输入的两个分量遵循CAST\_ROUND模式转换成的bfloat16x2\_t类型数据。 |
| \_\_float22hif82\_rna | 获取输入的两个分量遵循CAST\_ROUND模式转换成的hifloat8x2\_t类型数据。 |
| \_\_float22hif82\_rna\_sat | 饱和模式下获取输入的两个分量遵循CAST\_ROUND模式转换成的hifloat8x2\_t类型数据。 |
| \_\_float22hif82\_rh | 获取输入的两个分量遵循CAST\_HYBRID模式转换成的hifloat8x2\_t类型数据。 |
| \_\_float22hif82\_rh\_sat | 饱和模式下获取输入的两个分量遵循CAST\_HYBRID模式转换成的hifloat8x2\_t类型数据。 |
| \_\_asc\_cvt\_float2\_to\_fp8x2 | 输入的两个分量遵循CAST\_RINT模式，根据指定的8位浮点数类型和指定的饱和模式，转换成\_\_asc\_fp8x2\_storage\_t类型数据。 |
| \_\_half2float | 获取输入转换成的浮点数。 |
| \_\_half2half\_rn | 获取输入遵循CAST\_RINT模式取整后的half类型数据。 |
| \_\_half2half\_rz | 获取输入遵循CAST\_TRUNC模式取整后的half类型数据。 |
| \_\_half2half\_rd | 获取输入遵循CAST\_FLOOR模式取整后的half类型数据。 |
| \_\_half2half\_ru | 获取输入遵循CAST\_CEIL模式取整后的half类型数据。 |
| \_\_half2half\_rna | 获取输入遵循CAST\_ROUND模式取整后的half类型数据。 |
| \_\_half2bfloat16\_rn | 获取输入遵循CAST\_RINT模式转换成的bfloat16类型数据。 |
| \_\_half2bfloat16\_rz | 获取输入遵循CAST\_TRUNC模式转换成的bfloat16类型数据。 |
| \_\_half2bfloat16\_rd | 获取输入遵循CAST\_FLOOR模式转换成的bfloat16类型数据。 |
| \_\_half2bfloat16\_ru | 获取输入遵循CAST\_CEIL模式转换成的bfloat16类型数据。 |
| \_\_half2bfloat16\_rna | 获取输入遵循CAST\_ROUND模式转换成的bfloat16类型数据。 |
| \_\_half2uint\_rn | 获取输入遵循CAST\_RINT模式转换成的无符号整数。 |
| \_\_half2uint\_rz | 获取输入遵循CAST\_TRUNC模式转换成的无符号整数。 |
| \_\_half2uint\_rd | 获取输入遵循CAST\_FLOOR模式转换成的无符号整数。 |
| \_\_half2uint\_ru | 获取输入遵循CAST\_CEIL模式转换成的无符号整数。 |
| \_\_half2uint\_rna | 获取输入遵循CAST\_ROUND模式转换成的无符号整数。 |
| \_\_half2int\_rn | 获取输入遵循CAST\_RINT模式转换成的有符号整数。 |
| \_\_half2int\_rz | 获取输入遵循CAST\_TRUNC模式转换成的有符号整数。 |
| \_\_half2int\_rd | 获取输入遵循CAST\_FLOOR模式转换成的有符号整数。 |
| \_\_half2int\_ru | 获取输入遵循CAST\_CEIL模式转换成的有符号整数。 |
| \_\_half2int\_rna | 获取输入遵循CAST\_ROUND模式转换成的有符号整数。 |
| \_\_half2ull\_rn | 获取输入遵循CAST\_RINT模式转换成的64位无符号整数。 |
| \_\_half2ull\_rz | 获取输入遵循CAST\_TRUNC模式转换成的64位无符号整数。 |
| \_\_half2ull\_rd | 获取输入遵循CAST\_FLOOR模式转换成的64位无符号整数。 |
| \_\_half2ull\_ru | 获取输入遵循CAST\_CEIL模式转换成的64位无符号整数。 |
| \_\_half2ull\_rna | 获取输入遵循CAST\_ROUND模式转换成的64位无符号整数。 |
| \_\_half2ll\_rn | 获取输入遵循CAST\_RINT模式转换成的64位有符号整数。 |
| \_\_half2ll\_rz | 获取输入遵循CAST\_TRUNC模式转换成的64位有符号整数。 |
| \_\_half2ll\_rd | 获取输入遵循CAST\_FLOOR模式转换成的64位有符号整数。 |
| \_\_half2ll\_ru | 获取输入遵循CAST\_CEIL模式转换成的64位有符号整数。 |
| \_\_half2ll\_rna | 获取输入遵循CAST\_ROUND模式转换成的64位有符号整数。 |
| \_\_half22hif82\_rna | 获取输入的两个分量遵循CAST\_ROUND模式转换成的hifloat8x2\_t类型数据。 |
| \_\_half22hif82\_rna\_sat | 饱和模式下获取输入的两个分量遵循CAST\_ROUND模式转换成的hifloat8x2\_t类型数据。 |
| \_\_half22hif82\_rh | 获取输入的两个分量遵循CAST\_HYBRID模式转换成的hifloat8x2\_t类型数据。 |
| \_\_half22hif82\_rh\_sat | 饱和模式下获取输入的两个分量遵循CAST\_HYBRID模式转换成的hifloat8x2\_t类型数据。 |
| \_\_bfloat162half\_rn | 获取输入遵循CAST\_RINT模式转换成的half类型数据。 |
| \_\_bfloat162half\_rn\_sat | 饱和模式下获取输入遵循CAST\_RINT模式转换成的half类型数据。 |
| \_\_bfloat162half\_rz | 获取输入遵循CAST\_TRUNC模式转换成的half类型数据。 |
| \_\_bfloat162half\_rz\_sat | 饱和模式下获取输入遵循CAST\_TRUNC模式转换成的half类型数据。 |
| \_\_bfloat162half\_rd | 获取输入遵循CAST\_FLOOR模式转换成的half类型数据。 |
| \_\_bfloat162half\_rd\_sat | 饱和模式下获取输入遵循CAST\_FLOOR模式转换成的half类型数据。 |
| \_\_bfloat162half\_ru | 获取输入遵循CAST\_CEIL模式转换成的half类型数据。 |
| \_\_bfloat162half\_ru\_sat | 饱和模式下获取输入遵循CAST\_CEIL模式转换成的half类型数据。 |
| \_\_bfloat162half\_rna | 获取输入遵循CAST\_ROUND模式转换成的half类型数据。 |
| \_\_bfloat162half\_rna\_sat | 饱和模式下获取输入遵循CAST\_ROUND模式转换成的half类型数据。 |
| \_\_bfloat162float | 获取输入转换为浮点数的结果。 |
| \_\_bfloat162bfloat16\_rn | 获取输入遵循CAST\_RINT模式取整后的bfloat16\_t类型数据。 |
| \_\_bfloat162bfloat16\_rz | 获取输入遵循CAST\_TRUNC模式取整后的bfloat16\_t类型数据。 |
| \_\_bfloat162bfloat16\_rd | 获取输入遵循CAST\_FLOOR模式取整后的bfloat16\_t类型数据。 |
| \_\_bfloat162bfloat16\_ru | 获取输入遵循CAST\_CEIL模式取整后的bfloat16\_t类型数据。 |
| \_\_bfloat162bfloat16\_rna | 获取输入遵循CAST\_ROUND模式取整后的bfloat16\_t类型数据。 |
| \_\_bfloat162uint\_rn | 获取输入遵循CAST\_RINT模式转换成的无符号整数。 |
| \_\_bfloat162uint\_rz | 获取输入遵循CAST\_TRUNC模式转换成的无符号整数。 |
| \_\_bfloat162uint\_rd | 获取输入遵循CAST\_FLOOR模式转换成的无符号整数。 |
| \_\_bfloat162uint\_ru | 获取输入遵循CAST\_CEIL模式转换成的无符号整数。 |
| \_\_bfloat162uint\_rna | 获取输入遵循CAST\_ROUND模式转换成的无符号整数。 |
| \_\_bfloat162int\_rn | 获取输入遵循CAST\_RINT模式转换成的有符号整数。 |
| \_\_bfloat162int\_rz | 获取输入遵循CAST\_TRUNC模式转换成的有符号整数。 |
| \_\_bfloat162int\_rd | 获取输入遵循CAST\_FLOOR模式转换成的有符号整数。 |
| \_\_bfloat162int\_ru | 获取输入遵循CAST\_CEIL模式转换成的有符号整数。 |
| \_\_bfloat162int\_rna | 获取输入遵循CAST\_ROUND模式转换成的有符号整数。 |
| \_\_bfloat162ull\_rn | 获取输入遵循CAST\_RINT模式转换成的64位无符号整数。 |
| \_\_bfloat162ull\_rz | 获取输入遵循CAST\_TRUNC模式转换成的64位无符号整数。 |
| \_\_bfloat162ull\_rd | 获取输入遵循CAST\_FLOOR模式转换成的64位无符号整数。 |
| \_\_bfloat162ull\_ru | 获取输入遵循CAST\_CEIL模式转换成的64位无符号整数。 |
| \_\_bfloat162ull\_rna | 获取输入遵循CAST\_ROUND模式转换成的64位无符号整数。 |
| \_\_bfloat162ll\_rn | 获取输入遵循CAST\_RINT模式转换成的64位有符号整数。 |
| \_\_bfloat162ll\_rz | 获取输入遵循CAST\_TRUNC模式转换成的64位有符号整数。 |
| \_\_bfloat162ll\_rd | 获取输入遵循CAST\_FLOOR模式转换成的64位有符号整数。 |
| \_\_bfloat162ll\_ru | 获取输入遵循CAST\_CEIL模式转换成的64位有符号整数。 |
| \_\_bfloat162ll\_rna | 获取输入遵循CAST\_ROUND模式转换成的64位有符号整数。 |
| \_\_uint2float\_rn | 获取输入遵循CAST\_RINT模式转换成的浮点数。 |
| \_\_uint2float\_rz | 获取输入遵循CAST\_TRUNC模式转换成的浮点数。 |
| \_\_uint2float\_rd | 获取输入遵循CAST\_FLOOR模式转换成的浮点数。 |
| \_\_uint2float\_ru | 获取输入遵循CAST\_CEIL模式转换成的浮点数。 |
| \_\_uint2float\_rna | 获取输入遵循CAST\_ROUND模式转换成的浮点数。 |
| \_\_uint2half\_rn | 获取输入遵循CAST\_RINT模式转换成的half类型数据。 |
| \_\_uint2half\_rn\_sat | 饱和模式下获取输入的uint32数据转换成的half数据，并遵循CAST\_RINT模式。 |
| \_\_uint2half\_rz | 获取输入遵循CAST\_TRUNC模式转换成的half类型数据。 |
| \_\_uint2half\_rz\_sat | 饱和模式下获取输入的uint32数据转换成的half数据，并遵循CAST\_TRUNC模式。 |
| \_\_uint2half\_rd | 获取输入遵循CAST\_FLOOR模式转换成的half类型数据。 |
| \_\_uint2half\_rd\_sat | 饱和模式下获取输入的uint32数据转换成的half数据，并遵循CAST\_FLOOR模式。 |
| \_\_uint2half\_ru | 获取输入遵循CAST\_CEIL模式转换成的half类型数据。 |
| \_\_uint2half\_ru\_sat | 饱和模式下获取输入的uint32数据转换成的half数据，并遵循CAST\_CEIL模式。 |
| \_\_uint2half\_rna | 获取输入遵循CAST\_ROUND模式转换成的half类型数据。 |
| \_\_uint2half\_rna\_sat | 饱和模式下获取输入的uint32数据转换成的half数据，并遵循CAST\_ROUND模式。 |
| \_\_uint2bfloat16\_rn | 获取输入遵循CAST\_RINT模式转换成的bfloat16类型数据。 |
| \_\_uint2bfloat16\_rz | 获取输入遵循CAST\_TRUNC模式转换成的bfloat16类型数据。 |
| \_\_uint2bfloat16\_rd | 获取输入遵循CAST\_FLOOR模式转换成的bfloat16类型数据。 |
| \_\_uint2bfloat16\_ru | 获取输入遵循CAST\_CEIL模式转换成的bfloat16类型数据。 |
| \_\_uint2bfloat16\_rna | 获取输入遵循CAST\_ROUND模式转换成的bfloat16类型数据。 |
| \_\_int2float\_rn | 获取输入遵循CAST\_RINT模式转换成的浮点数。 |
| \_\_int2float\_rz | 获取输入遵循CAST\_TRUNC模式转换成的浮点数。 |
| \_\_int2float\_rd | 获取输入遵循CAST\_FLOOR模式转换成的浮点数。 |
| \_\_int2float\_ru | 获取输入遵循CAST\_CEIL模式转换成的浮点数。 |
| \_\_int2float\_rna | 获取输入遵循CAST\_ROUND模式转换成的浮点数。 |
| \_\_int2half\_rn | 获取输入遵循CAST\_RINT模式转换成的half类型数据。 |
| \_\_int2half\_rn\_sat | 饱和模式下获取输入的int32数据转换成的half数据，并遵循CAST\_RINT模式。 |
| \_\_int2half\_rz | 获取输入遵循CAST\_TRUNC模式转换成的half类型数据。 |
| \_\_int2half\_rz\_sat | 饱和模式下获取输入的int32数据转换成的half数据，并遵循CAST\_TRUNC模式。 |
| \_\_int2half\_rd | 获取输入遵循CAST\_FLOOR模式转换成的half类型数据。 |
| \_\_int2half\_rd\_sat | 饱和模式下获取输入的int32数据转换成的half数据，并遵循CAST\_FLOOR模式。 |
| \_\_int2half\_ru | 获取输入遵循CAST\_CEIL模式转换成的half类型数据。 |
| \_\_int2half\_ru\_sat | 饱和模式下获取输入的int32数据转换成的half数据，并遵循CAST\_CEIL模式。 |
| \_\_int2half\_rna | 获取输入遵循CAST\_ROUND模式转换成的half类型数据。 |
| \_\_int2half\_rna\_sat | 饱和模式下获取输入的int32数据转换成的half数据，并遵循CAST\_ROUND模式。 |
| \_\_int2bfloat16\_rn | 获取输入遵循CAST\_RINT模式转换成的bfloat16类型数据。 |
| \_\_int2bfloat16\_rz | 获取输入遵循CAST\_TRUNC模式转换成的bfloat16类型数据。 |
| \_\_int2bfloat16\_rd | 获取输入遵循CAST\_FLOOR模式转换成的bfloat16类型数据。 |
| \_\_int2bfloat16\_ru | 获取输入遵循CAST\_CEIL模式转换成的bfloat16类型数据。 |
| \_\_int2bfloat16\_rna | 获取输入遵循CAST\_ROUND模式转换成的bfloat16类型数据。 |
| \_\_ull2float\_rn | 获取输入遵循CAST\_RINT模式转换成的浮点数。 |
| \_\_ull2float\_rz | 获取输入遵循CAST\_TRUNC模式转换成的浮点数。 |
| \_\_ull2float\_rd | 获取输入遵循CAST\_FLOOR模式转换成的浮点数。 |
| \_\_ull2float\_ru | 获取输入遵循CAST\_CEIL模式转换成的浮点数。 |
| \_\_ull2float\_rna | 获取输入遵循CAST\_ROUND模式转换成的浮点数。 |
| \_\_ull2half\_rn | 获取输入遵循CAST\_RINT模式转换成的half类型数据。 |
| \_\_ull2half\_rz | 获取输入遵循CAST\_TRUNC模式转换成的half类型数据。 |
| \_\_ull2half\_rd | 获取输入遵循CAST\_FLOOR模式转换成的half类型数据。 |
| \_\_ull2half\_ru | 获取输入遵循CAST\_CEIL模式转换成的half类型数据。 |
| \_\_ull2half\_rna | 获取输入遵循CAST\_ROUND模式转换成的half类型数据。 |
| \_\_ull2bfloat16\_rn | 获取输入遵循CAST\_RINT模式转换成的bfloat16类型数据。 |
| \_\_ull2bfloat16\_rz | 获取输入遵循CAST\_TRUNC模式转换成的bfloat16类型数据。 |
| \_\_ull2bfloat16\_rd | 获取输入遵循CAST\_FLOOR模式转换成的bfloat16类型数据。 |
| \_\_ull2bfloat16\_ru | 获取输入遵循CAST\_CEIL模式转换成的bfloat16类型数据。 |
| \_\_ull2bfloat16\_rna | 获取输入遵循CAST\_ROUND模式转换成的bfloat16类型数据。 |
| \_\_ll2float\_rn | 获取输入遵循CAST\_RINT模式转换成的浮点数。 |
| \_\_ll2float\_rz | 获取输入遵循CAST\_TRUNC模式转换成的浮点数。 |
| \_\_ll2float\_rd | 获取输入遵循CAST\_FLOOR模式转换成的浮点数。 |
| \_\_ll2float\_ru | 获取输入遵循CAST\_CEIL模式转换成的浮点数。 |
| \_\_ll2float\_rna | 获取输入遵循CAST\_ROUND模式转换成的浮点数。 |
| \_\_ll2half\_rn | 获取输入遵循CAST\_RINT模式转换成的half类型数据。 |
| \_\_ll2half\_rz | 获取输入遵循CAST\_TRUNC模式转换成的half类型数据。 |
| \_\_ll2half\_rd | 获取输入遵循CAST\_FLOOR模式转换成的half类型数据。 |
| \_\_ll2half\_ru | 获取输入遵循CAST\_CEIL模式转换成的half类型数据。 |
| \_\_ll2half\_rna | 获取输入遵循CAST\_ROUND模式转换成的half类型数据。 |
| \_\_ll2bfloat16\_rn | 获取输入遵循CAST\_RINT模式转换成的bfloat16类型数据。 |
| \_\_ll2bfloat16\_rz | 获取输入遵循CAST\_TRUNC模式转换成的bfloat16类型数据。 |
| \_\_ll2bfloat16\_rd | 获取输入遵循CAST\_FLOOR模式转换成的bfloat16类型数据。 |
| \_\_ll2bfloat16\_ru | 获取输入遵循CAST\_CEIL模式转换成的bfloat16类型数据。 |
| \_\_ll2bfloat16\_rna | 获取输入遵循CAST\_ROUND模式转换成的bfloat16类型数据。 |
| \_\_hif822float2 | 获取hifloat8x2\_t类型输入转换成的float2类型数据。 |
| \_\_hif822half2 | 获取hifloat8x2\_t类型输入转换成的half2类型数据。 |
| \_\_e4m3x22float2 | 获取float8\_e4m3x2\_t类型输入转换成的float2类型数据。 |
| \_\_e5m2x22float2 | 获取float8\_e5m2x2\_t类型输入转换成的float2类型数据。 |
| \_\_float2bfloat162\_rn | 将float类型数据遵循CAST\_RINT模式转换为bfloat16类型并填充到bfloat16x2的前后两部分，返回填充后的bfloat16x2类型数据。 |
| \_\_floats2bfloat162\_rn | 将输入的数据x，y遵循CAST\_RINT模式分别转换为bfloat16类型并填充到bfloat16x2的前后两部分，返回转换后的bfloat16x2类型数据。 |
| \_\_float22bfloat162\_rn | 将float2类型数据遵循CAST\_RINT模式转换为bfloat16x2类型，返回转换后的bfloat16x2类型数据。 |
| \_\_bfloat162bfloat162 | 将输入的数据的填充为bfloat16x2前后两个分量，返回转换后的bfloat16x2类型数据。 |
| \_\_halves2bfloat162 | 将输入的数据分别填充为bfloat16x2前后两个分量，返回填充后数据。 |
| \_\_high2bfloat16 | 提取输入bfloat16x2的高16位，并返回。 |
| \_\_high2bfloat162 | 将输入数据的高16位填充到bfloat16x2并返回结果。 |
| \_\_high2float | 将输入数据的高16位转换为float类型并返回结果。 |
| \_\_highs2bfloat162 | 分别提取两个bfloat162输入的高16位，并填充到bfloat162中。返回填充后的数据。 |
| \_\_low2bfloat16 | 返回输入数据的低16位。 |
| \_\_low2bfloat162 | 将输入数据的低16位填充到bfloat16x2并返回。 |
| \_\_low2float | 将输入数据的低16位转换为浮点数并返回结果。 |
| \_\_lowhigh2highlow | 将输入数据的高低16位进行交换并返回。 |
| \_\_lows2bfloat162 | 分别提取两个bfloat162输入的低16位，并填充到bfloat162中。返回填充后的数据。 |
| \_\_bfloat1622float2 | 将bfloat16x2的两个分量分别转换为float，并填充到float2返回。 |
| \_\_floats2half2\_rn | 将输入的数据x，y遵循CAST\_RINT模式分别转换为bfloat16类型并填充到half2的前后两部分，返回转换后的half2类型数据。 |
| \_\_float22half2\_rn | 将float2类型数据遵循CAST\_RINT模式转换为half2类型，返回转换后的half2类型数据。 |
| \_\_low2half | 返回输入数据的低16位。 |
| \_\_low2half2 | 将输入数据的低16位填充到half2并返回。 |
| \_\_high2half | 提取输入half2的高16位，并返回 |
| \_\_high2half2 | 将输入数据的的高16位填充到half2并返回结果。 |
| \_\_highs2half2 | 分别提取两个half2输入的高16位，并填充到half2中。返回填充后的数据。 |
| \_\_lows2half2 | 分别提取两个half2输入的低16位，并填充到half2中。返回填充后的数据。 |
| \_\_halves2half2 | 将输入的数据分别填充为half2前后两个分量，返回填充后数据。 |
| \_\_half22float2 | 将half2的两个分量分别转换为float，并填充到float2返回。 |
| \_\_int\_as\_float | 将整数中的位重新解释为浮点数。 |
| \_\_uint\_as\_float | 将无符号整数中的位重新解释为浮点数。 |
| \_\_float\_as\_int | 将浮点数中的位重新解释为有符号整数。 |
| \_\_float\_as\_uint | 将浮点数中的位重新解释为无符号整数。 |
| \_\_ushort\_as\_half | 将unsigned short int的按位重新解释为half，即将unsigned short int的数据存储的位按照half的格式进行读取。 |
| \_\_ushort\_as\_bfloat16 | 将unsigned short int的按位重新解释为bfloat16，即将unsigned short int的数据存储的位按照bfloat16的格式进行读取。 |


**表35 向量类型构造函数**

| 接口名 | 功能描述 |
| --- | --- |
| make\_int2 | 从两个int类型数据创建int2类型的向量。 |
| make\_int4 | 从四个int类型数据创建int4类型的向量。 |
| make\_uint2 | 从两个unsigned int类型数据创建uint2类型的向量。 |
| make\_uint4 | 从四个unsigned int类型数据创建uint4类型的向量。 |
| make\_ulonglong2 | 从两个unsigned long long int类型数据创建ulonglong2类型的向量。 |
| make\_ulonglong4 | 从四个unsigned long long int类型数据创建ulonglong4类型的向量。 |
| make\_longlong2 | 从两个long long int类型数据创建longlong2类型的向量。 |
| make\_longlong4 | 从四个long long int类型数据创建longlong4类型的向量。 |
| make\_ulong2 | 从两个unsigned long int类型数据创建ulong2类型的向量。 |
| make\_ulong4 | 从四个unsigned long int类型数据创建ulong4类型的向量。 |
| make\_long2 | 从两个long int类型数据创建long2类型的向量。 |
| make\_long4 | 从四个long int类型数据创建long4类型的向量。 |
| make\_float2 | 从两个float类型数据创建float2类型的向量。 |
| make\_float4 | 从四个float类型数据创建float4类型的向量。 |
| make\_short2 | 从两个short类型数据创建short2类型的向量。 |
| make\_short4 | 从四个short类型数据创建short4类型的向量。 |
| make\_ushort2 | 从两个unsigned short类型数据创建ushort2类型的向量。 |
| make\_ushort4 | 从四个unsigned short类型数据创建ushort4类型的向量。 |
| make\_uchar2 | 从两个unsigned char类型数据创建uchar2类型的向量。 |
| make\_uchar4 | 从四个unsigned char类型数据创建uchar4类型的向量。 |
| make\_char2 | 从两个signed char类型数据创建char2类型的向量。 |
| make\_char4 | 从四个signed char类型数据创建char4类型的向量。 |
| make\_half2 | 从两个half类型数据创建half2类型的向量。 |
| make\_bfloat162 | 从两个bfloat16\_t类型数据创建bfloat16x2\_t类型的向量。 |


**表36 使能Cache Hints的Load/Store函数**

| 接口名 | 功能描述 |
| --- | --- |
| asc\_ldcg | 从L2 Cache加载缓存的数据，如果缓存命中，则直接返回数据。若未命中，则从Global Memory地址预加载数据缓存至L2 Cache，并返回数据。 |
| asc\_ldca | 首先从Data Cache加载缓存数据，若未命中，则尝试从L2 Cache加载。如果Data Cache和L2 Cache中均未找到所需数据，则从Global Memory中读取数据，然后将其缓存到L2 Cache和Data Cache中。 |
| asc\_stcg | 将指定数据存储到Global Memory的地址address中，并缓存到L2 Cache，但不缓存至Data Cache。 |
| asc\_stwt | 将指定数据存储到Global Memory的地址address中，并缓存至Data Cache和L2 Cache。 |


#### Utils API


**表37 C++标准库API列表**

| 接口名 | 功能描述 |
| --- | --- |
| max | 比较相同数据类型的两个数中的最大值。 |
| min | 比较相同数据类型的两个数中的最小值。 |
| abs | 获取输入数据的绝对值。 |
| sqrt | 计算输入数据的平方根。 |
| integer\_sequence | 用于生成一个整数序列。 |
| tuple | 允许存储多个不同类型元素的容器。 |
| get | 从tuple容器中提取指定位置的元素。 |
| make\_tuple | 用于便捷地创建tuple对象。 |
| is\_convertible | 在程序编译时判断两个类型之间是否可以进行隐式转换。 |
| is\_base\_of | 在程序编译时判断一个类型是否为另一个类型的基类。 |
| is\_same | 在程序编译时判断两个类型是否完全相同。 |
| is\_void | 在程序编译时，检测一个类型是否为void类型。 |
| is\_integral | 在程序编译时，检测一个类型是否为整数类型。 |
| is\_floating\_point | 在程序编译时，检测一个类型是否为浮点类型。 |
| is\_array | 在程序编译时，检测一个类型是否为数组类型。 |
| is\_pointer | 在程序编译时，判断一个类型是否为指针类型。 |
| is\_reference | 在程序编译时，检测一个类型是否为引用类型。 |
| is\_const | 在程序编译时，检测一个类型是否为const限定的类型。 |
| remove\_const | 在程序编译时，对传入的模板参数类型移除const限定符。 |
| remove\_volatile | 在程序编译时，对传入的模板参数类型移除volatile限定符。 |
| remove\_cv | 在程序编译时，对传入的模板参数类型移除const限定符或volatile限定符，或同时移除这两种限定符。 |
| remove\_reference | 在程序编译时，从给定类型中移除引用限定符。 |
| remove\_pointer | 在程序编译时，从给定类型中移除指针限定符。 |
| add\_const | 在程序编译时，为指定类型添加const限定符。 |
| add\_volatile | 在程序编译时，为指定类型添加volatile限定符。 |
| add\_cv | 在程序编译时，为指定类型添加const和volatile限定符。 |
| add\_pointer | 在程序编译时，为指定类型添加指针限定符。 |
| add\_lvalue\_reference | 在程序编译时，为指定类型添加左值引用限定符。 |
| add\_rvalue\_reference | 在程序编译时，为指定类型添加右值引用限定符。 |
| enable\_if | 在程序编译时根据某个条件启用或禁用特定的函数模板、类模板或模板特化。 |
| conditional | 在程序编译时根据一个布尔条件从两个类型中选择一个类型。 |
| integral\_constant | 用于封装一个编译时常量整数值，是标准库中许多类型特性和编译时计算的基础组件。 |


**表38 平台信息获取API列表**

| 接口名 | 功能描述 |
| --- | --- |
| PlatformAscendC | 在实现Host侧的Tiling函数时，可能需要获取一些硬件平台的信息，来支撑Tiling的计算，比如获取硬件平台的核数等信息。PlatformAscendC类提供获取这些平台信息的功能。 |
| PlatformAscendCManager | 基于Kernel Launch算子工程，通过基础调用（Kernel Launch）方式调用算子的场景下，可能需要获取硬件平台相关信息，比如获取硬件平台的核数。PlatformAscendCManager类提供获取平台信息的功能。 |


**表39 原型注册与管理API列表**

| 接口名 | 功能描述 |
| --- | --- |
| 原型注册接口（OP\_ADD） | 注册算子的原型定义。 |
| OpDef | 用于算子原型定义。 |
| OpParamDef | 用于算子参数定义。 |
| OpAttrDef | 用于算子属性定义。 |
| OpAICoreDef | 用于定义AI处理器上相关实现信息，并关联Tiling实现、Shape推导等函数。 |
| OpAICoreConfig | 用于配置AI Core配置信息。 |
| OpMC2Def | 该类用于在host侧配置通算融合算子的通信域名称。配置后在kernel侧可以获取通信域对应的context地址。 |


**表40 Tiling数据结构注册API列表**

| 接口名 | 功能描述 |
| --- | --- |
| TilingData结构定义 | 定义一个TilingData的类，添加所需的成员变量（TilingData字段），用于保存所需TilingData参数。完成该TilingData类的定义后，该类通过继承TilingDef类（用来存放、处理用户自定义Tiling结构体成员变量的基类）提供TilingData字段设置、序列化和保存等接口。 |
| TilingData结构注册 | 注册定义的TilingData结构体并和自定义算子绑定。 |


**表41 Tiling调测API列表**

| 接口名 | 功能描述 |
| --- | --- |
| OpTilingRegistry | OpTilingRegistry类属于context\_ascendc命名空间，主要用于加载Tiling实现的动态库，并获取算子的Tiling函数指针以进行调试和验证。 |
| ContextBuilder | ContextBuilder类提供一系列的API接口，支持手动构造TilingContext(https://www.hiascend.comdocument/detail/zh/canncommercial/900/maintenref/basicdataapi/atlasopapi\_07\_00223.html)类来验证Tiling函数以及KernelContext类用于TilingParse函数的验证。 |


**表42 Tiling模板编程API列表**

| 接口名 | 功能描述 |
| --- | --- |
| 模板参数定义 | 通过该类接口进行模板参数ASCENDC\_TPL\_ARGS\_DECL和模板参数组合ASCENDC\_TPL\_ARGS\_SEL（即可使用的模板）的定义。 |
| GET\_TPL\_TILING\_KEY | Tiling模板编程时，开发者通过调用此接口自动生成TilingKey。该接口将传入的模板参数通过定义的位宽，转成二进制，按照顺序组合后转成uint64数值，即TilingKey。 |
| ASCENDC\_TPL\_SEL\_PARAM | Tiling模板编程时，开发者通过调用此接口自动生成并配置TilingKey。 |


**表43 Tiling下沉API列表**

| 接口名 | 功能描述 |
| --- | --- |
| DEVICE\_IMPL\_OP\_OPTILING | 在Tiling下沉(https://www.hiascend.comdocument/detail/zh/canncommercial/900/programug/Ascendcopdevg/atlas\_ascendc\_10\_00014.html)场景中，该宏定义用于生成Tiling下沉的注册类，再通过调用注册类的成员函数来注册需要下沉的Tiling函数。 |


**表44 RTC API列表**

| 接口名 | 功能描述 |
| --- | --- |
| aclrtcCompileProg | 编译接口，编译指定的程序。 |
| aclrtcCreateProg | 通过给定的参数，创建编译程序的实例。 |
| aclrtcDestroyProg | 销毁编译程序的实例。 |
| aclrtcGetBinData | 获取编译后的二进制数据。 |
| aclrtcGetBinDataSize | 获取编译的二进制数据大小。用于在aclrtcGetBinData获取二进制数据时分配对应大小的内存空间。 |
| aclrtcGetCompileLogSize | 获取编译日志的大小。用于在aclrtcGetCompileLog获取日志内容时分配对应大小的内存空间。 |
| aclrtcGetCompileLog | 获取编译日志的内容，以字符串形式保存。 |


**表45 log API列表**

| 接口名 | 功能描述 |
| --- | --- |
| ASC\_CPU\_LOG | 提供Host侧打印Log的功能。开发者可以在算子的TilingFunc代码中使用ASC\_CPU\_LOG\_XXX接口来输出相关内容。 |


**表46 调测接口列表**

| 接口名 | 功能描述 |
| --- | --- |
| printf | 在算子Kernel侧的实现代码中，需要输出日志信息时，调用printf接口打印相关内容。 |
| assert | 本接口在SIMT VF调试场景下提供assert断言功能。在算子Kernel侧的SIMT VF实现代码中，如果assert的内部条件判断不为真，则会输出assert条件，并将输入的信息格式化打印在屏幕上。 |
| \_\_trap | 在SIMT VF实现代码中调用此接口会中断算子的运行。 |
| clock | 本接口在SIMT VF调试场景中提供Clock时间戳功能，用于记录从程序启动到接口调用时刻所经历的时钟周期数（Cycle Count），便于精确分析执行延迟和性能瓶颈。 |


#### AI CPU API


**表47 AI CPU API列表**

| 接口名 | 功能描述 |
| --- | --- |
| printf | 该接口提供AI CPU算子Kernel调试场景下的格式化输出功能，默认将输出内容解析并打印在屏幕上。 |
| assert | 该接口实现AI CPU算子Kernel调试场景下的assert断言功能。 |