printf
产品支持情况
功能说明
头文件路径为："basic_api/kernel_operator_dump_tensor_intf.h"。
该接口提供CPU域/NPU域调试场景下的格式化输出功能。
在算子kernel侧实现代码中需要输出日志信息的地方调用printf接口打印相关内容。样例如下：
#include "kernel_operator.h"
AscendC::printf("fmt string %d\n", 0x123);
注意
该接口主要用于调试分析，开启后会对算子性能产生一定影响，通常在调试阶段使用，生产环境建议关闭。
默认情况下，调用该接口就会打印相关内容，开发者可以参考关闭ASCENDC_DUMP说明，按需关闭该接口功能。
函数原型
template <class... Args>
__aicore__ inline void printf(__gm__ const char* fmt, Args&&... args)
参数说明
表 参数说明
| 参数名称 | 输入/输出 | 描述 |
|---|---|---|
| fmt | 输入 | 格式控制字符串，包含两种类型的对象：普通字符和转换说明。 •普通字符将原样不动地打印输出。 •转换说明并不直接输出而是用于控制printf中参数的转换和打印。每个转换说明都由一个百分号字符（%）开始，以转换说明结束，从而说明输出数据的类型。 •支持的转换类型包括： ▪%d / %i：输出十进制数，支持打印的数据类型：bool、int8_t、int16_t、int32_t、int64_t。 ▪%f：输出实数，支持打印的数据类型：half、float、bfloat16。 ▪%x：输出十六进制整数，支持打印的数据类型：int8_t、uint8_t、int16_t、uint16_t、int32_t、uint32_t、int64_t、uint64_t。 ▪%s：输出字符串。 ▪%u：输出unsigned类型数据，支持打印的数据类型：bool、uint8_t、uint16_t、uint32_t、uint64_t。 ▪%p：输出指针地址。 注意： •上文列出的数据类型是NPU域调试支持的数据类型，CPU域调试时，支持的数据类型和C/C++规范保持一致。 •在转换类型为%x，即输出十六进制整数时，NPU域上的输出为64位，CPU域上的输出为32位。 |
| args | 输入 | 附加参数，个数和类型可变的参数列表：根据不同的fmt字符串，函数可能需要一系列的附加参数，每个参数包含了一个要被插入的值，替换了fmt参数中指定的每个%标签。参数的个数应与%标签的个数相同。 |
返回值说明
无
约束说明
可以参考utils目录SIMD约束下的printf说明。
调用示例
#include "kernel_operator.h"
// 整型打印：
AscendC::printf("fmt string %d\n", 0x123);
// 浮点型打印：
float a = 3.14;
AscendC::printf("fmt string %f\n", a);
// 指针打印：
int b = 0x123;
int *c = &b;
AscendC::printf("TEST %p\n", c);
NPU模式下，程序运行时打印效果如下：
fmt string 291
fmt string 291
fmt string 3.140000
fmt string 3.140000
TEST 0x357f9c
TEST 0x357f9c