std::ranges::chunk_view<V>::inner-iterator

< cpp‎ | ranges‎ | chunk view
class /*inner-iterator*/
 (since C++23)

The return type of chunk_view::outer-iterator::value_type::begin if V models input_range.

The name of this class (shown here as /*inner-iterator*/) is unspecified.

Data members

Typical implementations of /*inner-iterator*/ hold only one non-static data member – a pointer parent_ (the name is for exposition purposes only) to the "parent object" of type ranges::chunk_view*.

Member types

Member type Definition
iterator_concept std::input_iterator_tag
difference_type ranges::range_difference_t<V>
value_type ranges::range_value_t<V>

Member functions

(C++23)
 constructs an iterator
(public member function)
(C++23)
 move assigns another iterator
(public member function)
(C++23)
 returns an iterator to the current element
(public member function)
(C++23)
 accesses the element
(public member function)
(C++23)
 increments the iterator
(public member function)

Non-member functions

(C++23)
 compares the iterator with default sentinel
(function)
(C++23)
 calculates the remained number of elements
(function)
(C++23)
 casts the result of dereferencing the underlying iterator to its associated rvalue reference type
(function)
(C++23)
 swaps the objects pointed to by two underlying iterators
(function)

Example

A link to Compiler Explorer

#include <iostream>
#include <iterator>
#include <sstream>
#include <ranges>
 
int main()
{
    auto letters = std::istringstream{"ABCDEFGHIJK"};
 
    auto chunks = std::ranges::istream_view<char>(letters)
                | std::views::chunk(4);
 
    for (auto chunk : chunks)
    {
        // chunk is an object of type chunk_view::outer_iterator::value_type
        std::cout << '[';
        for (auto inner_iter = chunk.begin(); inner_iter != std::default_sentinel;
             ++inner_iter)
            std::cout << *inner_iter;
        std::cout << "] ";
    }
    std::cout << '\n';
}

Output:

[ABCD] [EFGH] [IJK]

References

  • C++23 standard (ISO/IEC 14882:2023):
  • 26.7.28.5 Class chunk_view::inner-iterator [range.chunk.inner.iter]

See also