CANN Ascend C调试接口assert断言
assert【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言原生支持C和C标准规范主要由类库和语言扩展层构成提供多层级API满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit产品支持情况Ascend 950PR/Ascend 950DT支持Atlas A3 训练系列产品/Atlas A3 推理系列产品支持Atlas A2 训练系列产品/Atlas A2 推理系列产品支持Atlas 200I/500 A2 推理产品支持Atlas 推理系列产品AI Core支持Atlas 推理系列产品Vector Core不支持Atlas 训练系列产品不支持Kirin X90支持Kirin 9030支持功能说明头文件路径为utils/debug/asc_assert.h。该接口实现CPU/NPU域assert断言功能。算子执行中如果assert内部条件判断不为真则输出assert条件并将输入的信息格式化打印在屏幕上。在算子Kernel侧实现代码中需要增加断言的地方使用assert检查代码并格式化输出一些调测信息。示例如下int assertFlag 10; assert(assertFlag 10);[!CAUTION]注意 该接口主要用于调试分析开启后会对算子性能产生一定影响通常在调试阶段使用生产环境建议关闭。默认情况下调用该接口就会打印相关内容开发者可以参考关闭ASCENDC_DUMP说明按需关闭该接口功能。函数原型define assert(expr) define assert(expr, __gm__ const char *fmt, Args... args)参数说明表1参数说明参数名称输入/输出描述expr输入assert断言是否终止程序的条件。为true则程序继续执行为false则终止程序。fmt输入格式控制字符串包含两种类型的对象普通字符和转换说明。•普通字符将原样不动地打印输出。•转换说明并不直接输出而是用于控制printf中参数的转换和打印。每个转换说明都由一个百分号字符%开始以转换说明结束从而说明输出数据的类型。•支持的转换类型包括▪%d / %i输出十进制数支持打印的数据类型bool、int8_t、int16_t、int32_t、int64_t。▪%f输出实数支持打印的数据类型float、half。▪%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参数中指定的每个%标签。参数的个数应与%标签的个数相同。数据类型无返回值说明无约束说明单次调用本接口打印的数据总量不可超过30KB。使用时应注意如果超出这个限制则数据不会被打印。在cmake工程的release模式下默认使能NDEBUG宏定义assert打印信息失效。调用示例int assertFlag 10; // 断言条件 assert(assertFlag ! 10);程序运行时会触发assert打印效果如下[ASSERT] /home/.../add_custom.cpp:44: Assertion assertFlag ! 10【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言原生支持C和C标准规范主要由类库和语言扩展层构成提供多层级API满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考