Namespaces
Variants
Views
Actions

std::ranges::chunk_view<V>::end

From cppreference.com
< cpp‎ | ranges‎ | chunk view
 
 
Ranges library
Range access
Range conversions
(C++23)

Range primitives



Dangling iterator handling
Range concepts
Views

Range factories
Range adaptors
Range generators
Range adaptor objects
Range adaptor closure objects
Helper items
(until C++23)(C++23)


 
std::ranges::chunk_view
Member functions
chunk_view::end
Classes for input_ranges
Deduction guides
outer-iterator
outer-iterator::value_type
inner-iterator
 
V models only input_range
constexpr std::default_sentinel_t end() const noexcept;
(1) (since C++23)
V models forward_range
constexpr auto end() requires (!__simple_view<V>);
(2) (since C++23)
constexpr auto end() const requires ranges::forward_range<const V>;
(3) (since C++23)

Returns an iterator or a std::default_sentinel that compares equal to the end iterator of the chunk_view.

1) Available only if V models input_range. Equivalent to: return std::default_sentinel.
2,3) Available if V models forward_range. Let base_ denote the underlying adapted view, n_ denote the stored chunk size, and iterator denote the nested iterator class.
2) Equivalent to:
if constexpr (ranges::common_range<V> && ranges::sized_range<V>)
{
    auto missing = (n_ - ranges::distance(base_) % n_) % n_;
    return iterator<false>(this, ranges::end(base_), missing);
}
else if constexpr (ranges::common_range<V> && !ranges::bidirectional_range<V>)
    return iterator<false>(this, ranges::end(base_));
else
    return std::default_sentinel;
3) Equivalent to:
if constexpr (ranges::common_range<const V> && ranges::sized_range<const V>)
{
    auto missing = (n_ - ranges::distance(base_) % n_) % n_;
    return iterator<true>(this, ranges::end(base_), missing);
}
else if constexpr (ranges::common_range<const V> && !ranges::bidirectional_range<const V>)
    return iterator<true>(this, ranges::end(base_));
else
    return std::default_sentinel;

Contents

[edit] Parameters

(none)

[edit] Return value

An iterator or sentinel representing the end of the chunk_view, as described above.

[edit] Example

[edit] See also

(C++23)
returns an iterator to the beginning
(public member function) [edit]
returns a sentinel indicating the end of a range
(customization point object)[edit]