Spec-Zone.ru › C++

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

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

Возвращает sentinel или итератор, представляющий конец 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 являются представлениями с одинаковыми типами итераторов и sentinel).

Параметры

(нет)

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

Результат зависит от концепций, которым удовлетворяет, возможно, константный тип базового представления 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
нет 1) /*sentinel*/<false>{ranges::end(base_)} 2) /*sentinel*/<true>{ranges::end(base_)}

Пример

#include <iostream>
#include <iterator>
#include <list>
#include <ranges>
#include <type_traits>
namespace ranges = std::ranges;
namespace views = std::views;

int main()
{
    const auto list1 = {3, 1, 4, 1, 5};
    const auto seq1{list1 | views::take(4)};
    static_assert(ranges::sized_range<decltype(seq1)> and
                  ranges::random_access_range<decltype(seq1)> and
                  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 | views::take(4)};
    static_assert(ranges::sized_range<decltype(seq2)> and
                  not ranges::random_access_range<decltype(seq2)> and
                  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++.

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

См. также

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

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

Spec-Zone.ru

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