| Defined in header <iterator>
|
||
| 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) | |
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.
Member types
| Member type | Definition | ||||
iterator_category
|
std::output_iterator_tag | ||||
value_type
|
void | ||||
difference_type
|
| ||||
pointer
|
void | ||||
reference
|
void | ||||
container_type
|
Container
|
|
Member types |
(until C++17) |
Member functions
constructs a new back_insert_iterator (public member function) | |
| inserts an object into the associated container (public member function) | |
| no-op (public member function) | |
| no-op (public member function) |
Member objects
| Member name | Definition |
container (protected)
|
a pointer of type Container*
|
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';
}1 2 3 4 5 6 7 8 9 10See also
| creates a std::back_insert_iterator of type inferred from the argument (function template) | |
| iterator adaptor for insertion at the front of a container (class template) | |
| iterator adaptor for insertion into a container (class template) |
Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.