std::layout_right::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_right::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_right::mapping) (C++26)

 

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

类模板 layout_right::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_right

数据成员

成员	定义
extents_type extents_ (private)	extents 对象 (仅为说明目的的成员对象*)

成员函数

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

非成员函数

operator==	将 layout_right 的此布局映射与其他 mapping 进行比较 (function template)
submdspan_mapping(std::layout_right::mapping) (C++26)	计算用于 subdmspan 的 mapping 和数据句柄偏移量 (public member function)

参见

mapping	layout_left 的布局映射 (public member class template of std::layout_left)
mapping	layout_stride 的布局映射 (public member class template of std::layout_stride)