std::span<T,Extent>::operator[]

 

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

推導指引

 

constexpr reference operator[]( size_type idx ) const;		(C++20 起)

返回序列中第 idx 個元素的引用。如果 idx 超出範圍（即大於或等於 size()），則行為未定義。

引數

idx

-

要訪問元素的索引

返回值

對序列中第 idx 個元素的引用，即 data()[idx]。

異常

不丟擲任何異常。

示例

執行此程式碼

#include <cstddef>
#include <iostream>
#include <span>
#include <utility>
 
void reverse(std::span<int> span)
{
    for (std::size_t i = 0, j = std::size(span); i < j; ++i)
    {
        --j;
        std::swap(span[i], span[j]);
    }
}
 
void print(std::span<const int> const span)
{
    for (int element : span)
        std::cout << element << ' ';
    std::cout << '\n';
}
 
int main()
{
    int data[]{1, 2, 3, 4, 5};
    print(data);
    reverse(data);
    print(data);
}

輸出

1 2 3 4 5
5 4 3 2 1

參閱

at (C++26)	訪問指定的元素，帶邊界檢查 (公共成員函式)
data	直接訪問底層連續儲存 (公共成員函式)
size	返回元素數量 (公共成員函式)
as_bytesas_writable_bytes (C++20)	將 `span` 轉換為其底層位元組的檢視 (函式模板)