已关闭
[Documentation|文档反馈]: IsIn 两篇文档函数原型参数错误(参数顺序互换 / 输出参数类型错,照原型编译失败) #3328
dihidao创建于  11 天前关闭于  10 天前
dihidao
dihidao
11 天前 创建

场景:开发者按 aclnnIsIn 文档原型编写两段式调用代码。

问题与位置(master 2026-09-28 核实):

  1. experimental/math/equal/docs/aclnnIsInScalarTensor.md:18-25 原型第 1 参写 const aclTensor* self、第 2 参 const aclScalar* element(Tensor 在前)—— 实际 math/equal/op_api/aclnn_isin.h:34-36 为 (const aclScalar* element, const aclTensor* testElements, ...)(Scalar 在前);同文档示例 :321-329 按代码侧顺序调用,原型与自身示例矛盾;
  2. experimental/math/equal/docs/aclnnIsInTensorScalar.md:18-25 原型输出参数写 aclScalar* out(:23)—— 实际 aclnn_isin_tensor_scalar.h:32-34 为 aclTensor* out(aclScalar 为 host 侧标量不可能作 device 输出);同文档示例 :317 亦为 aclTensor* out,原型自相矛盾。

影响:照文档原型传参(Tensor 传给 Scalar 形参 / 输出用 aclScalar)→ C++ 编译失败。

复现:master 对应行与头文件比对即见(原型+示例+头文件三方证据)。
修复建议:两篇原型按头文件实际签名修正。已检索本仓历史 issues:#3096 涉及同算子的报错日志格式与 dtype 列表问题(已关闭),与本条函数原型参数错误为不同维度,未见本问题报告。

likedislike
陈思
陈思成员
10 天前 评论:

您好,感谢反馈!核对 master(commit 77f7e4c2286fb5a6c5f473f6df25b07236fe49d7)后,文档原型确有两处与接口头文件不一致:aclnnIsInScalarTensorGetWorkspaceSize 的实际参数顺序是 element、testElements、assumeUnique、invert、out、workspaceSize、executor;aclnnIsInTensorScalarGetWorkspaceSize 的 out 类型是 aclTensor*。第二段调用均为 aclnn... (workspace, workspaceSize, executor, stream)。因此按当前两篇文档原型编写的调用可能出现参数类型不匹配或编译失败。

文档修订时应以头文件声明为准,并同步检查示例中的第一段接口实参顺序及输出张量类型。核查依据:IsInScalarTensor 文档、IsInScalarTensor 接口头文件、IsInTensorScalar 文档、IsInTensorScalar 接口头文件。

likedislike
陈思陈思成员
10 天前 关联了pull request:docs(isin): 修正两篇 API 文档的函数原型
CANN-robotCANN-robot成员
10 天前 关闭了 issue
CANN-robotCANN-robot成员
10 天前 添加了label:resolved
liuchenghao
liuchenghao
3 天前 评论:

【Multica 同步】状态:done;说明:社区侧已由 PR !6040(chensi79:「docs(isin): 修正两篇 API 文档的函数原型」,2026-09-29 合入)解决本需求,Multica 跟踪单同步关闭,感谢社区贡献者 chensi79;详情:Multica issue AI4ME-541

likedislike