std::extents, std::dextents, std::dims

 

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::extents

成員函式

extents::extents

觀察器

extents::rank

extents::rank_dynamic

extents::static_extent

extents::extent

輔助函式

extents::fwd-prod-of-extents

extents::rev-prod-of-extents

extents::index-cast

extents::dynamic-index

extents::dynamic-index-inv

非成員函式

extents::operator==

推導指引

 

定義於標頭檔案 <mdspan>
template< class IndexType, std::size_t... Extents > class extents;	(1)	(C++23 起)
template< class IndexType, std::size_t Rank > using dextents = /* see below */	(2)	(C++23 起)
template< std::size_t Rank, class IndexType = std::size_t > using dims = std::dextents<IndexType, Rank>;	(3)	(C++26 起)

1) 表示一個多維索引空間，其秩等於 sizeof...(Extents)。

2) 一個方便的別名模板，用於全動態的 extents。令 d 表示 std::dynamic_extent，它的每個特化 dextents<IndexType, Rank> 等價於 extents<IndexType /*, d, d, ..., d*/> （即 d 重複了 Rank 次）。

3) 一個方便的別名模板，用於全動態的 extents，其中預設索引型別為 std::size_t。

extents 的每個特化都符合 regular 概念，並且是 TriviallyCopyable 的。

模板引數

IndexType	-	每個非動態 Extents 的型別。應為有符號或無符號整數型別。否則，程式格式錯誤
Extents	-	表示每個秩索引的範圍（整數區間的尺寸）。它的每個元素要麼等於 std::dynamic_extent （在這種情況下，它表示一個*動態範圍*，範圍大小將動態確定），要麼可以表示為 IndexType 型別的值（此時它表示一個*靜態範圍*，範圍大小就是它的值），否則程式格式錯誤
Rank	-	表示全動態 extents 的秩

成員型別

成員型別	定義
index_type	IndexType
size_type	std::make_unsigned_t<index_type>
rank_type	std::size_t

資料成員

成員名稱 (Member name)	定義
std::array<index_type, rank_dynamic()> dynamic-extents (private)	一個儲存每個動態範圍大小的陣列。 (僅用於闡釋的成員物件*)

成員函式

(建構函式)	構造一個 extents (公共成員函式)
觀察器
rank [靜態]	返回 extents 的靜態秩 (公共靜態成員函式)
rank_dynamic [靜態]	返回 extents 的動態秩 (公共靜態成員函式)
static_extent [靜態]	返回特定等級索引處 extents 的靜態範圍大小 (公共靜態成員函式)
extent	返回 extents 在特定秩索引處的動態範圍大小 (公共成員函式)
輔助函式
fwd-prod-of-extents	返回範圍 [​0​, i) 內的範圍大小的乘積 (僅用於說明的成員函式*)
rev-prod-of-extents	返回範圍 [i + 1, rank()) 內的範圍大小的乘積 (僅用於說明的成員函式*)
index-cast	將輸入轉換為整數型別 (僅用於說明的成員函式*)
dynamic-index (私有)	返回某個秩索引以下動態範圍的數量 (僅用於說明的成員函式*)
dynamic-index-inv (私有)	返回數字 r，使得對於某個引數 i，範圍 [​0​, r + 1) 中恰好有 i + 1 個動態範圍 (僅用於說明的成員函式*)

非成員函式

operator== (C++23)

比較兩個 extents 在每個維度上的底層範圍 (函式)

另見

rank (C++11)	獲取陣列型別的維數 (類模板)
extent (C++11)	獲取陣列型別在指定維度上的大小 (類模板)