get_shape

产品支持情况

• Ascend 950PR&950DT系列产品：支持

• Atlas A3系列产品：不支持

• Atlas A2系列产品：不支持

• Atlas 200I/500 A2推理产品：不支持

• Atlas推理系列产品AI Core：不支持

• Atlas推理系列产品Vector Core：不支持

• Atlas训练系列产品：不支持

功能说明

头文件路径为：tensor_api/tensor.h。

get_shape用于从layout中提取shape部分：

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

函数原型

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

参数说明

表1 模板参数说明

参数名	输入/输出	描述
Is...	输入	可选。用于选择shape顶层tuple中的一个或多个索引。
Layout	输入	layout对象的类型。

表2 参数说明

参数名	输入/输出	描述
layout	输入	layout对象。

返回值说明

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

约束说明

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

调用示例

#include "tensor_api/tensor.h"

using namespace asc::te;

auto layout = make_layout(make_shape(10, 20, 30));

// 不指定Is... → 返回完整shape元组
auto full_shape = get_shape(layout);           // (10, 20, 30)

// 指定单个索引 → 返回对应元素
auto s0 = get_shape<0>(layout);              // 10

// 指定多个索引 → 组成新tuple
auto s01 = get_shape<0, 1>(layout);          // (10, 20)