aclrtcAddNameExpr

产品支持情况

产品	是否支持
Ascend 950PR/Ascend 950DT	√
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas A2 推理系列产品	√
Atlas 200I/500 A2 推理产品	x
Atlas 推理系列产品AI Core	x
Atlas 推理系列产品Vector Core	x
Atlas 训练系列产品	x

功能说明

注册指定的名称表达式，该表达式代表了一个__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);