std::layout_stride::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_stride::mapping

成員函式

mapping::mapping

觀察器

mapping::extents

mapping::strides

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_stride::mapping) (C++26)

 

定義於標頭檔案 <mdspan>
template< class Extents > class layout_stride::mapping;		(C++23 起)

類模板 layout_stride::mapping 控制多維索引如何透過使用者定義的步幅對映到表示偏移量的一維值。

每個 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_stride

成員常量

成員	定義
constexpr rank_type rank_ (private) [static]	extents_type::rank() （僅用於解釋的靜態成員常量*）

資料成員

成員	定義
extents_type extents_ (private)	擴充套件物件 (僅用於闡釋的成員物件*)
std::array<index_type, rank_> strides_ (private)	步幅陣列 (僅用於闡釋的成員物件*)

成員函式

(建構函式)	構造一個新對映 (public member function)
operator= (顯式預設)	賦值一個對映 (public member function)
觀察器
extents	獲取區段物件 (public member function)
strides	獲取步幅陣列 (public member function)
required_span_size	返回對映的所需大小 (public member function)
operator()	將多維索引對映到偏移量值 (public member function)
is_unique [靜態]	確定此對映是否唯一（索引的每個組合對映到不同的底層元素） (public static member function)
is_exhaustive	確定此對映是否詳盡（每個底層元素都可以透過某些索引組合訪問） (public member function)
is_strided [靜態]	確定此對映是否帶步幅（在每個維度中，每次增加一個索引都跳過相同數量的底層元素） (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_stride 的佈局對映與其他對映進行比較 (函式模板)
submdspan_mapping(std::layout_stride::mapping) (C++26)	計算用於 subdmspan 的對映和資料控制代碼偏移量 (public member function)

參見

mapping	layout_left 的佈局對映 (std::layout_left 的公有成員類模板)
mapping	layout_right 的佈局對映 (std::layout_right 的公有成員類模板)