std::ranges::take_view<V>::end

constexpr auto end() requires (!__SimpleView<V>);	(1)	(с C++20)
constexpr auto end() const requires ranges::range<const V>;	(2)	(с C++20)

Возвращает конечную метку или итератор, представляющий конец take_view. Конец take_view — это либо позиция, следующая за элементом подлежащего диапазона с индексом count, либо конец подлежащего диапазона, если в последнем меньше чем count элементов.

1) Возвращает take_view::/*sentinel*/<false>, std::default_sentinel_t, или ranges::iterator_t<V>.

2) Возвращает take_view::/*sentinel*/<true>, std::default_sentinel_t, или ranges::iterator_t<const V>.

Перегрузка (1) не участвует в разрешении перегрузки, если V является простым представлением (то есть, если V и const V являются представлениями с одинаковыми типами итератора и конечной метки).

Параметры

(нет)

Значение результата

Результат зависит от понятий, которым удовлетворяет потенциально квалифицированный константный тип базового представления Base_, а именно V (для перегрузки (1)) или const V (для перегрузки (2)).

Пусть base_ — базовое представление.

Базовое представление удовлетворяет ...		`random_access_range`
Базовое представление удовлетворяет ...		да	нет
`sized_range`	да	`ranges::begin(base_) + ranges::range_difference_t<Base_>(this->size())`	`std::default_sentinel`
`sized_range`	нет	1) `/sentinel/<false>{ranges::end(base_)` 2) `/sentinel/<true>{ranges::end(base_)`

Пример

#include <iostream>
#include <iterator>
#include <list>
#include <ranges>
#include <type_traits>
 
int main()
{
    const auto list1 = {3, 1, 4, 1, 5};
    const auto seq1 = list1 | std::views::take(4);
    static_assert(std::ranges::sized_range<decltype(seq1)> &&
                  std::ranges::random_access_range<decltype(seq1)> &&
                  std::is_same_v<decltype(seq1.end()), decltype(list1.end())>);
    for (auto it = seq1.begin(); it != seq1.end(); ++it)
        std::cout << *it << ' ';
    std::cout << '\n';
 
    std::list list2 = {2, 7, 1, 8, 2};
    const auto seq2 = list2 | std::views::take(4);
    static_assert(std::ranges::sized_range<decltype(seq2)> &&
                  not std::ranges::random_access_range<decltype(seq2)> &&
                  std::is_same_v<decltype(seq2.end()), std::default_sentinel_t>);
    for (auto it = seq2.begin(); it != std::default_sentinel; ++it)
        std::cout << *it << ' ';
    std::cout << '\n';
}

Вывод:

3 1 4 1
2 7 1 8

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

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

DR	Применено к	Поведение, как опубликовано	Корректное поведение
P2393R1	C++20	неявные преобразования между целыми типами со знаком и без знака могут завершиться неудачей	делается явным

См. также

begin (C++20)	возвращает итератор к началу (публичный член-функция)
counted_iterator (C++20)	адаптер итератора, отслеживающий расстояние до конца диапазона (шаблон класса)
operator== (C++20)	сравнивает конечную метку с итератором, возвращаемым из `take_view::begin` (функция)

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