aclrtcAddNameExpr

产品支持情况

• Ascend 950PR/Ascend 950DT：支持

• Atlas A3 训练系列产品/Atlas A3 推理系列产品：支持

• Atlas A2 训练系列产品/Atlas A2 推理系列产品：支持

• Atlas 200I/500 A2 推理产品：不支持

• Atlas 推理系列产品AI Core：不支持

• Atlas 推理系列产品Vector Core：不支持

• Atlas 训练系列产品：不支持

功能说明

注册指定的名称表达式，该表达式代表了一个__global__函数。

主要用于__global__函数为模板函数的场景，调用本接口后，可以通过aclrtcGetLoweredName接口获取函数的mangling name，在launch阶段调用对应的模板__global__函数。

函数原型

aclError aclrtcAddNameExpr(aclrtcProg prog, const char *const nameExpression)

参数说明

表1 接口参数说明

参数名	输入/输出	描述
prog	输入	运行时编译程序的句柄。
nameExpression	输入	一个常量表达式，通常为字符串字面量，用于指明某个__global__函数。

返回值说明

aclError为int类型变量，详细说明请参考RTC错误码。

约束说明

该接口需要在aclrtcCompileProg编译接口前使用。

调用示例

aclrtcProg prog;
const char* kernelNameExpr = "add_custom<float>";
aclError result = aclrtcAddNameExpr(prog, kernelNameExpr);