| Iterator concepts | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Iterator primitives | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Algorithm concepts and utilities | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Indirect callable concepts | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Common algorithm requirements | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Utilities | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Iterator adaptors | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defined in header <iterator> | ||
template<class Container> class back_insert_iterator | (until C++17) | |
template<class Container> class back_insert_iterator; | (since C++17) | |
std::back_insert_iterator is aLegacyOutputIterator that appends elements to a container for which it was constructed. The container'spush_back() member function is called whenever the iterator (whether dereferenced or not) is assigned to. Incrementing thestd::back_insert_iterator is a no-op.
Contents |
| 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) |
constructs a newback_insert_iterator(public member function)[edit] | |
| inserts an object into the associated container (public member function)[edit] | |
| no-op (public member function)[edit] | |
| no-op (public member function)[edit] |
| Member name | Definition |
container(protected) | a pointer of typeContainer* |
#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 syntax10,[n=0]() mutable{return++n;}); for(int n: v)std::cout<< n<<' ';std::cout<<'\n';}
Output:
1 2 3 4 5 6 7 8 9 10
| creates astd::back_insert_iterator of type inferred from the argument (function template)[edit] | |
| iterator adaptor for insertion at the front of a container (class template)[edit] | |
| iterator adaptor for insertion into a container (class template)[edit] |