Closed
[Documentation|文档反馈]: trans_quant_param_v2/v3 调用示例与 examples 实体示例代码不一致 #8667
cuijieAdd on  9 days agoClosed at  9 days ago
cuijie
cuijieCollaborators
9 days ago Create

Document Link(文档链接)

Issues Section(问题文档片段)

文档调用示例中包含、而实体示例 cpp 缺失的内容(V2/V3 相同):

#include <cstdint>
#include <cstdio>
    CHECK_RET(*tensor != nullptr, LOG_PRINT("aclCreateTensor failed.
"); return ACL_ERROR_INVALID_PARAM);
    aclrtStream stream = nullptr;   // cpp 侧为未初始化的 aclrtStream stream;

V3 独有:

    aclOpExecutor* executor = nullptr;   // cpp 侧为未初始化的 aclOpExecutor* executor;

Existing Issues(存在的问题)

提交 0f6d17096(2026-11-09,文档规范化)更新了 md 内嵌调用示例(V2 与 V3 两份 md 均在其改动清单内),但未同步 examples 目录下的实体示例 test_aclnn_trans_quant_param_v2.cpp 与 test_aclnn_trans_quant_param_v3.cpp,md 与示例代码自此不一致:

  • cpp 缺少 #include <cstdint>、#include <cstdio>;
  • cpp 的 aclCreateTensor 返回后无判空检查,创建失败会继续执行后续逻辑;
  • cpp 的 main 中 aclrtStream stream 未初始化,一旦中途失败,Finalize 会对未初始化的流调用 aclrtDestroyStream(未定义行为);
  • V3 的 aclOpExecutor* executor 未初始化。

建议将实体示例同步为文档示例版本。

关联 PR: !14295

likedislike
cuijiecuijieCollaborators
9 days ago Added label: documentation
cuijiecuijieCollaborators
9 days ago Assign cuijie25 as responsible person
cuijiecuijieCollaborators
9 days ago Change title to "[Documentation|文档反馈]: trans_quant_param_v2/v3 调用示例与 examples 实体示例代码不一致", originally titled "[Documentation|文档反馈]: trans_quant_param_v2 调用示例与 examples 实体示例代码不一致".
cuijiecuijieCollaborators
9 days ago Modify description of issue
CANN-robotCANN-robotCollaborators
9 days ago Close issue
CANN-robotCANN-robotCollaborators
9 days ago changed custom state from 待办的 to 已完成
CANN-robotCANN-robotCollaborators
9 days ago Added label: resolved