aclrtcCreateProg

产品支持情况

产品	是否支持
Ascend 950PR/Ascend 950DT	x
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas A2 推理系列产品	√

功能说明

通过给定的参数，创建编译程序的实例。

函数原型

aclError aclrtcCreateProg(aclrtcProg *prog, const char *src, const char *name, int numHeaders, const char **headers, const char **includeNames)

参数说明

表 1 接口参数说明

参数名	输入/输出	描述
prog	输出	运行时编译程序的句柄。
src	输入	以字符串形式提供的Ascend C Device侧源代码内容。
name	输入	用户自定义的程序名称，用于标识和区分不同的编译程序，默认值为"default_program"。
numHeaders	输入	指定要包含的头文件数量，必须为非负整数。 无需包含头文件或者Ascend C Device侧源代码中已包含所需头文件时，此参数需设置为0。
headers	输入	一个指向数组的指针，数组中的每个元素都是以'\0'结尾的字符串，表示头文件的源代码内容。当numHeaders为0时，此参数可以设置为nullptr。
includeNames	输入	一个指向数组的指针，数组中的每个元素都是以'\0'结尾的字符串，表示头文件的名称。 这些名称必须与源代码中#include指令中包含的头文件名称完全一致。

返回值说明

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

约束说明

无

调用示例

aclrtcProg prog;
const char *src = R""""(
#include "kernel_operator.h"
#include "my_const_a.h"
#include "my_const_b.h"

extern "C" __global__ __aicore__ void hello_world(GM_ADDR x)
{
	KERNEL_TASK_TYPE_DEFAULT(KERNEL_TYPE_AIC_ONLY);
	*x = *x + MY_CONST_A + MY_CONST_B;
}
)"""";
const char* headerSrcA = R"(
#ifndef CONST_A_H
#define CONST_A_H
const int MY_CONST_A = 100;
#endif // CONST_A_H
)";
const char* includeNameA = "my_const_a.h";

const char* headerSrcB = R"(
#ifndef CONST_B_H
#define CONST_B_H
const int MY_CONST_B = 50;
#endif // CONST_B_H
)";

const char* includeNameB = "my_const_b.h";
const char* headersArray[] = { headerSrcA, headerSrcB };
const char* includeNameArray[] = { includeNameA, includeNameB };
aclError result = aclrtcCreateProg(&prog, src, "hello_world", 2,  headersArray,  includeNameArray);