std::full_extent, std::full_extent_t

 

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) 推導指引

 

定義於標頭檔案 <mdspan>
struct full_extent_t { explicit full_extent_t() = default; };	(1)	(C++26 起)
inline constexpr std::full_extent_t full_extent {};	(2)	(C++26 起)

1) 類 std::full_extent_t 是一種切片指定符型別，可在 std::submdspan 中使用。

2) (1) 中對應的 std::full_extent 例項是一個切片指定符，用於在 std::submdspan 中指示指定範圍的完整索引範圍。

示例

執行此程式碼

#include <mdspan>
#include <print>
 
void print(auto view)
{
    static_assert(view.rank() <= 2);
 
    if constexpr (view.rank() == 2)
    {
        for (std::size_t i = 0; i != view.extent(0); ++i)
        {
            for (std::size_t j = 0; j != view.extent(1); ++j)
                std::print("{} ", view[i, j]);
            std::println();
        }
    }
    else if constexpr (view.rank() == 1)
    {
        for (std::size_t i = 0; i != view.extent(0); ++i)
            std::print("{} ", view[i]);
        std::println();
    }
    else
        std::println("{}", view[]);
 
    std::println();
}
 
int main()
{
    const char letters []{'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I'};
    const std::mdspan view(letters, 3, 3);
 
    print(view);
    print(std::submdspan(view, std::full_extent, std::full_extent));
    print(std::submdspan(view, std::full_extent, 1));
    print(std::submdspan(view, 1, std::full_extent));
    print(std::submdspan(view, 2, 1));
}

可能的輸出

A B C
D E F
G H I
 
A B C
D E F
G H I
 
B E H
 
D E F
 
H

參閱

submdspan (C++26)

返回一個現有 mdspan 的子集檢視 (函式模板)