CANN/asc-devkit：GetShape函数API文档

GetShape

【免费下载链接】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 训练系列产品：不支持

功能说明

需要包含的头文件为：#include "tensor_api/tensor.h"。

GetShape用于从Layout中提取Shape部分：

• 不指定模板参数Is...：返回完整的Shape元组。
• 指定模板参数Is...：从Shape顶层tuple中选择对应索引的元素。指定单个索引时返回该元素；指定多个索引时返回由这些顶层元素组成的新tuple。

函数原型

template <size_t... Is, typename ShapeType, typename StrideType> __aicore__ inline constexpr auto GetShape(const Layout<ShapeType, StrideType>& layout) template <size_t... Is, typename ShapeType, typename StrideType> __aicore__ inline constexpr auto GetShape(Layout<ShapeType, StrideType>& layout)

参数说明

表1模板参数说明

表2参数说明

返回值说明

返回描述张量形状的Shape对象（或其子结构）。

约束说明

Is...必须在Shape顶层tuple的有效范围内。

调用示例

using namespace AscendC::Te; auto layout = MakeLayout(MakeShape(10, 20, 30)); // 不指定Is... → 返回完整shape元组 auto fullShape = GetShape(layout); // (10, 20, 30) // 指定单个索引 → 返回对应元素 auto s0 = GetShape<0>(layout); // 10 // 指定多个索引 → 组成新tuple auto s01 = GetShape<0, 1>(layout); // (10, 20)

【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言，原生支持C和C++标准规范，主要由类库和语言扩展层构成，提供多层级API，满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit