std::layout_left::mapping

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

容器库

序列

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

hive (C++26)

deque

forward_list (C++11)

list

关联

set

multiset

map

multimap

无序关联

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

适配器

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

视图

span (C++20)

mdspan (C++23)

表格

迭代器失效

成员函数表格

非成员函数表格

 

std::mdspan

成员函数 mdspan::mdspan mdspan::operator= 元素访问 mdspan::operator[] 观察器 mdspan::rank mdspan::rank_dynamic mdspan::static_extent mdspan::extent mdspan::size mdspan::empty mdspan::stride mdspan::extents mdspan::data_handle mdspan::mapping mdspan::accessor mdspan::is_uniquemdspan::is_exhaustivemdspan::is_stridedmdspan::is_always_uniquemdspan::is_always_exhaustivemdspan::is_always_strided

非成员函数 swap(std::mdspan) 子视图 submdspan (C++26) submdspan_extents (C++26) 辅助类型和模板 extentsdextents dims (C++26) default_accessor aligned_accessor (C++26) 布局映射策略 layout_left layout_right layout_stride layout_left_padded (C++26) layout_right_padded (C++26) 子视图辅助项 full_extent (C++26) strided_slice (C++26) submdspan_mapping_result (C++26) 推导指引

 

std::layout_left::mapping

成员函数

mapping::mapping

观察器

mapping::extents

mapping::required_span_size

mapping::operator()

mapping::is_uniquemapping::is_exhaustivemapping::is_stridedmapping::is_always_uniquemapping::is_always_exhaustivemapping::is_always_strided

mapping::stride

非成员函数

operator==

submdspan_mapping(std::layout_left::mapping) (C++26)

 

定义于头文件 <mdspan>
template< class Extents > class layout_left::mapping;		(C++23 起)

类模板 layout_left::mapping 控制多维索引如何以列主序方式映射到表示偏移量的一维值。该映射在最左边的扩展处步幅为 1，并且步幅从左到右随着扩展的乘积而增加。

mapping 的每个特化都是一个 LayoutMapping 和一个 TriviallyCopyable 类型，它满足 regular。

如果多维索引空间 Extents() 的大小无法表示为类型 Extents::index_type 的值，当 Extents::rank_dynamic() 为 ​0​ 时，程序是 ill-formed 的。

模板参数

Extents

-

指定维度数、它们的大小以及哪些在编译时已知。必须是 std::extents 的特化。

成员类型

成员类型	定义
extents_type	Extents
index_type	extents_type::index_type
size_type	extents_type::size_type
rank_type	extents_type::rank_type
layout_type	std::layout_left

数据成员

成员	定义
extents_type extents_ (private)	扩展对象 (仅用于阐释的成员对象*)

成员函数

(构造函数)	构造一个新映射 (public 成员函数)
operator= (显式默认)	赋值一个映射 (public 成员函数)
观察器
extents	获取区段对象 (public 成员函数)
required_span_size	返回映射的所需大小 (public 成员函数)
operator()	将多维索引映射到偏移量值 (public 成员函数)
is_unique [静态]	确定此映射是否唯一（索引的每个组合映射到不同的底层元素） (public static 成员函数)
is_exhaustive [静态]	确定此映射是否详尽（每个底层元素都可以通过某些索引组合访问） (public static 成员函数)
is_strided [静态]	确定此映射是否带步幅（在每个维度中，每次增加一个索引都跳过相同数量的底层元素） (public static 成员函数)
is_always_unique [静态]	确定此布局映射是否总是唯一的 (public static 成员函数)
is_always_exhaustive [静态]	确定此布局映射是否总是详尽的 (public static 成员函数)
is_always_strided [静态]	确定此布局映射是否总是带步幅的 (public static 成员函数)
stride	获取沿指定维度的步长 (public 成员函数)

非成员函数

operator==	将此 layout_left 的布局映射与其他映射进行比较 (函数模板)
submdspan_mapping(std::layout_left::mapping) (C++26)	计算用于 subdmspan 的映射和数据句柄偏移量 (public 成员函数)

另请参阅

mapping	layout_right 的布局映射 (std::layout_right 的公共成员类模板)
mapping	layout_stride 的布局映射 (std::layout_stride 的公共成员类模板)