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

constexpr reference operator[]( size_type idx ) const;

(начиная с C++20)

Возвращает ссылку на элемент последовательности с индексом idx.

Если idx < size() равен false, поведение не определено.

(до C++26)

Если idx < size() равен false:

Если реализация защищена, происходит нарушение контракта.
Если реализация не защищена, поведение не определено.

(начиная с C++26)

Параметры

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(const std::span<const int> 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` в представление его базовых байтов (шаблон функции)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/container/span/operator_at