std:: mdspan

std::mdspan は、多次元インデックスを配列の要素にマッピングする多次元配列ビューです。マッピングと要素アクセスのポリシーは設定可能であり、基盤となる配列は連続している必要はなく、メモリ内に存在する必要さえありません。

各特殊化 MDS は mdspan のモデルであり、 copyable コンセプトを満たし、以下を満たします：

• std:: is_nothrow_move_constructible_v < MDS > が true であり、
• std:: is_nothrow_move_assignable_v < MDS > が true であり、かつ
• std:: is_nothrow_swappable_v < MDS > が true である。

mdspan の特殊化は、 TriviallyCopyable 型である。ただし、その accessor_type 、 mapping_type 、および data_handle_type が TriviallyCopyable 型である場合に限る。

テンプレートパラメータ

メンバー型

データメンバ

メンバー関数

非メンバー関数

ヘルパー型とテンプレート

推論ガイド

注記

例

#include <cstddef>
#include <mdspan>
#include <print>
#include <vector>
int main()
{
    std::vector v{1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12};
    // データを6つのintからなる2行として連続メモリで表示
    auto ms2 = std::mdspan(v.data(), 2, 6);
    // 同じデータを3次元配列 2 x 3 x 2 として表示
    auto ms3 = std::mdspan(v.data(), 2, 3, 2);
    // 2Dビューを使用してデータを書き込み
    for (std::size_t i = 0; i != ms2.extent(0); i++)
        for (std::size_t j = 0; j != ms2.extent(1); j++)
            ms2[i, j] = i * 1000 + j;
    // 3Dビューを使用して読み戻し
    for (std::size_t i = 0; i != ms3.extent(0); i++)
    {
        std::println("slice @ i = {}", i);
        for (std::size_t j = 0; j != ms3.extent(1); j++)
        {
            for (std::size_t k = 0; k != ms3.extent(2); k++)
                std::print("{} ", ms3[i, j, k]);
            std::println("");
        }
    }
}

slice @ i = 0
0 1
2 3
4 5
slice @ i = 1
1000 1001
1002 1003
1004 1005

関連項目