std::dynamic_extent

 

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

成員函式

span::span

span::operator=

元素訪問

span::front

span::back

span::at (C++26)

span::operator[]

span::data

迭代器

span::beginspan::cbegin (C++23)

span::endspan::cend (C++23)

span::rbeginspan::crbegin (C++23)

span::rendspan::crend (C++23)

觀察器

span::empty

span::size

span::size_bytes

子檢視

span::first

span::last

span::subspan

非成員函式

as_bytesas_writable_bytes

非成員常量

dynamic_extent

推導指引

 

在標頭檔案 <span> 中定義
inline constexpr std::size_t dynamic_extent = std::numeric_limits<std::size_t>::max();		(C++20 起)

std::dynamic_extent 是一個 std::size_t 型別的常量，通常用於指示任何使用 std::dynamic_extent 的型別將動態地儲存其值（例如，大小），而不是在型別中靜態地已知該值。

它在以下幾個上下文中使用：

• 用於區分靜態和動態範圍的 std::span。

用於指示在 std::extents 中，特定秩索引處的範圍將動態儲存。

(C++23 起)

用於指示 std::mdspan 的填充佈局將動態儲存其填充值。

(C++26 起)

注意

由於 std::size_t 是一個無符號型別，因此等效的定義是

inline constexpr std::size_t dynamic_extent = -1;

參見 整數轉換。

示例

執行此程式碼

#include <array>
#include <cassert>
#include <cstddef>
#include <iostream>
#include <span>
#include <string_view>
#include <vector>
 
int main()
{
    auto print = [](std::string_view const name, std::size_t ex)
    {
        std::cout << name << ", ";
        if (std::dynamic_extent == ex)
            std::cout << "dynamic extent\n";
        else
            std::cout << "static extent = " << ex << '\n';
    };
 
    int a[]{1, 2, 3, 4, 5};
 
    std::span span1{a};
    print("span1", span1.extent);
 
    std::span<int, std::dynamic_extent> span2{a};
    print("span2", span2.extent);
 
    std::array ar{1, 2, 3, 4, 5};
    std::span span3{ar};
    print("span3", span3.extent);
 
    std::vector v{1, 2, 3, 4, 5};
    std::span span4{v};
    print("span4", span4.extent);
}

輸出

span1, static extent = 5
span2, dynamic extent
span3, static extent = 5
span4, dynamic extent

另請參見

span (C++20)	一個連續物件序列的非擁有檢視 (類模板)
extents (C++23)	某個秩的多維索引空間的描述符 (類模板)