Spec-Zone.ru › C++

std::ranges::drop_view<V>::begin

constexpr auto begin()
    requires (!(/*simple-view*/<V> &&
                 ranges::random_access_range<const V> &&
                 ranges::sized_range<const V>));
(1) (начиная с C++20)
constexpr auto begin() const
    requires ranges::random_access_range<const V> &&
             ranges::sized_range<const V>;
(2) (начиная с C++20)

Возвращает итератор к первому элементу drop_view, то есть итератор к N-му элементу базового представления или к концу базового представления, если в нём меньше N элементов.

Если V не является random_access_range или sized_range, перегрузка (1) кэширует результат во внутреннем объекте cache_ для последующего использования, чтобы обеспечить требуемую концепцией range амортизированную константную временную сложность.

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

ranges::next(ranges::begin(base_), count_,ranges::end(base_)).

Пример

#include <array>
#include <concepts>
#include <iostream>
#include <iterator>
#include <ranges>

void println(std::ranges::range auto const& range)
{
    for (auto const& elem : range)
        std::cout << elem;
    std::cout << '\n';
}

int main()
{
    std::array hi{'H', 'e', 'l', 'l', 'o', ',', ' ', 'C', '+', '+', '2', '0', '!'};
    println(hi);

    const auto pos = std::distance(hi.begin(), std::ranges::find(hi, 'C'));
    auto cxx = std::ranges::drop_view{hi, pos};
    std::cout << "*drop_view::begin() == '" << *cxx.begin() << "'\n";
//  *cxx.begin() = 'c'; // undefined: 'views' are to be used as observers
    println(cxx);
}

Вывод:

Hello, C++20!
*drop_view::begin() == 'C'
C++20!

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были ретроактивно применены к ранее опубликованным стандартам C++.

Отчёт об ошибке Применён к Опубликованное поведение Правильное поведение
LWG 3482 C++20 константную перегрузку можно вызвать с диапазонами неизвестного размера для константной перегрузки требуется sized_range

См. также

end
возвращает итератор или сентинел, указывающий на конец
(открытая функция-член)
ranges::begin
(C++20)
возвращает итератор к началу диапазона
(объект-точка настройки)
ranges::end
(C++20)
возвращает сентинел, указывающий на конец диапазона
(объект-точка настройки)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/ranges/drop_view/begin

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API