get_stride

产品支持情况

  • Ascend 950PR/Ascend 950DT:支持
  • Atlas A3 训练系列产品/Atlas A3 推理系列产品:不支持
  • Atlas A2 训练系列产品/Atlas A2 推理系列产品:不支持
  • Atlas 200I/500 A2 推理产品:不支持
  • Atlas 推理系列产品AI Core:不支持
  • Atlas 推理系列产品Vector Core:不支持
  • Atlas 训练系列产品:不支持

功能说明

头文件路径为:tensor_api/tensor.h

get_stride用于从layout中提取stride部分:

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

函数原型

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

参数说明

表1 模板参数说明

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

表2 参数说明

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

返回值说明

返回描述内存访问步长的stride对象(或其子结构)。

约束说明

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

调用示例

#include "tensor_api/tensor.h"

using namespace asc::te;

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

// 不指定Is... → 返回完整stride元组
auto full_stride = get_stride(layout);         // (1, 10, 200)

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

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