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__函 数。

函 数 原 型

Text

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

参 数 说 明

表 1 接 口 参 数 说 明

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

返 回 值 说 明

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

约 束 说 明

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

调 用 示 例

Text

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