std::span<T,Extent>::front

constexpr reference front() const;

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

Возвращает ссылку на первый элемент span.

Если empty() имеет значение true, поведение не определено.

(до C++26)

Если empty() имеет значение true:

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

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

Возвращаемое значение

Ссылка на первый элемент.

Сложность

Постоянная.

Примечания

Для span c выражение c.front() эквивалентно *c.begin().

Пример

#include <iostream>
#include <span>

void print(std::span<const int> const data)
{
    for (auto offset{0U}; offset != data.size(); ++offset)
        std::cout << data.subspan(offset).front() << ' ';
    std::cout << '\n';
}

int main()
{
    constexpr int data[]{0, 1, 2, 3, 4, 5, 6};
    print({data, 4});
}

Вывод:

0 1 2 3

См. также

back	доступ к последнему элементу (открытая функция-член)

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