Spec-Zone.ru › C++

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

constexpr auto begin()
    requires (!(__SimpleView<V> &&
                 ranges::random_access_range<const V> &&
                 ranges::sized_range<const V>));
(1) (since C++20)
constexpr auto begin() const
    requires ranges::random_access_range<const V> &&
             ranges::sized_range<const V>;
(2) (since C++20)

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

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

Параметры

(нет)

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

ranges::next(ranges::begin(base_), count_, ranges::end(base_)), где base_ — это базовое представление, а count_ — количество элементов для пропущения.

Пример

#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++.

DR Применено к Поведение, как опубликовано Корректное поведение
LWG 3482 C++20 перегрузка const может вызываться с несчитанными диапазонами перегрузка const требует sized_range

См. также

end
(C++20)
возвращает итератор или конечную точку до конца
(общедоступная функция-член)
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/w/cpp/ranges/drop_view/begin

Spec-Zone.ru

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