std::layout_left::mapping

 

C++

编译器支持

独立和宿主

语言

标准库

标准库头文件

具名要求

特性测试宏 (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​ 时。

模板形参

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)	extents 对象 (仅用于演示的成员对象*)

成员函数

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

非成员函数

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

参见

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