printf

函数功能

基于算子工程开发的算子,可以使用该接口实现NPU域上板调试场景下的格式化输出功能。算子执行结束之后,待输出内容会被解析并打印在屏幕上。具体使用方法如下:

  1. 增加算子工程编译选项-DASCENDC_DUMP:修改算子工程op_kernel目录下的CMakeLists.txt文件,首行增加编译选项,打开DUMP开关,样例如下:
    add_ops_compile_options(ALL OPTIONS -DASCENDC_DUMP)
  2. 在算子kernel侧实现代码中需要输出日志信息的地方调用PRINTF接口打印相关内容。
    printf("fmt string %d", 0x123);
    PRINTF("fmt string %d", 0x123);

函数原型

void printf(__gm__ const char* fmt, Args&&... args);

void PRINTF(__gm__ const char* fmt, Args&&... args);

参数说明

参数名

输入/输出

描述

fmt

输入

格式控制字符串,包含两种类型的对象:普通字符和转换说明。

  • 普通字符将原样不动地打印输出。
  • 转换说明并不直接输出而是用于控制PRINTF中参数的转换和打印。每个转换说明都由一个百分号字符(%)开始,以转换说明结束,从而说明输出数据的类型 。支持的转换类型包括:
    • %d / %i:输出十进制数
    • %f:输出实数
    • %x:输出十六进制整数
    • %s:输出字符串
    • %u:输出unsigned类型数据
    • %p:输出指针地址

args

输入

附加参数,个数和类型可变的输出列表:根据不同的fmt字符串,函数可能需要一系列的附加参数,每个参数包含了一个要被插入的值,替换了fmt参数中指定的每个%标签。参数的个数应与%标签的个数相同。

返回值

支持的型号

Atlas A2训练系列产品

Atlas推理系列产品AI Core

注意事项

调用示例

// 整型打印:
printf("fmt string %d", 0x123);
PRINTF("fmt string %d", 0x123);

// 指针打印:
int *a;
printf("TEST %p", a);
PRINTF("TEST %p", a);