Section
std::back_insert_iterator
std::back_insert_iterator is a LegacyOutputIterator that appends elements to a container for which it was constructed. The container’s push_back() member function is called whenever the iterator (whether dereferenced or not) is assigned to. Incrementing the std::back_insert_iterator is a no-op.
# Declarations
template< class Container >
class back_insert_iterator
: public std::iterator<std::output_iterator_tag, void, void, void, void>
(until C++17)
template< class Container >
class back_insert_iterator;
(since C++17)
# Example
#include <algorithm>
#include <iostream>
#include <iterator>
#include <vector>
int main()
{
std::vector<int> v;
std::generate_n(
std::back_insert_iterator<std::vector<int>>(v),
// Or use std::back_inserter helper
// Or use std::back_insert_iterator(v) C++17's syntax
10,
[n = 0]() mutable { return ++n; }
);
for (int n : v)
std::cout << n << ' ';
std::cout << '\n';
}