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

来自cppreference.com
< cpp‎ | ranges‎ | take view
 
 
范围库
范围适配器
 
 
constexpr auto end() requires (!/*simple-view*/<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_tranges::range_iterator_t<V>
2) 返回 take_view::/*sentinel*/<true>std::default_sentinel_tranges::range_iterator_t<const V>

重载 (1) 仅若 V简单视图(即若 Vconst V 均为视图且拥有相同迭代器与哨位类型)才参与重载决议。

参数

(无)

返回值

结果依赖于可能为 const 限定的底层视图类型 Base,即对于 (1)V 或对于 (2)const V

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 有符号与无符号整数类间的隐式转换可能失败 使之为显式

参阅

返回指向起始的迭代器
(公开成员函数)
对到范围结尾距离进行跟踪的迭代器适配器
(类模板)
比较哨位与 take_view::begin 返回的迭代器
(函数)