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

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

コンテナライブラリ

シーケンス

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 = /* 以下参照 */	(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) 全て動的 (all-dynamic) な extents の便利なエイリアステンプレートです。d を std::dynamic_extent とすると、dextents<IndexType, Rank> の各特殊化は extents<IndexType /*, d, d, ..., d*/> (すなわち、d が合計 Rank 回繰り返される) と等価です。

3) デフォルトのインデックス型として std::size_t を使用する、全て動的な extents の便利なエイリアステンプレートです。

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

データメンバ

メンバ名	定義
std::array<index_type, rank_dynamic()> dynamic-extents (private)	各動的範囲のサイズを格納する配列。 (説明用のメンバオブジェクト*)

メンバ関数

(コンストラクタ)	extents を構築します。 (public member function)
監視
rank [static]	extents の静的ランクを返します。 (public static member function)
rank_dynamic [static]	extents の動的ランクを返します。 (public static member function)
static_extent [static]	指定されたランクインデックスにおける extents の静的なエクステントサイズを返します (public static member function)
extent	特定のランクインデックスにおける extents の動的なエクステントサイズを返します。 (public member function)
ヘルパー
fwd-prod-of-extents	[​0​, i) の範囲の範囲サイズの積を返します。 (exposition-only member function*)
rev-prod-of-extents	[i + 1, rank()) の範囲の範囲サイズの積を返します。 (exposition-only member function*)
index-cast	入力を整数型にキャストします。 (exposition-only member function*)
dynamic-index (private)	指定されたランクインデックスより下にある動的範囲の数を返します。 (exposition-only member function*)
dynamic-index-inv (private)	指定された引数 i に対して、範囲 [​0​, r + 1) 内にちょうど i + 1 個の動的範囲があるような r を返します。 (exposition-only member function*)

非メンバ関数

operator== (C++23)

2つの extents の各次元における基となる範囲を比較します。 (function)

関連項目

rank (C++11)	配列型の次元数を取得する (クラステンプレート)
extent (C++11)	指定された次元に沿った配列型のサイズを取得する (クラステンプレート)