stdinsert_iterator(3)
std::insert_iterator - std::insert_iterator
Synopsis
Defined in header<iterator>
template <class Container>
class insert_iterator : public std::iterator<std::output_iterator_tag, (until C++ 17)
void,
void, void, void>
template <class Container>
(since C++ 17)
class insert_iterator;std::insert_iterator is a LegacyOutputIterator that inserts elements into a container for which it was constructed, at the position pointed to by the supplied iterator. The container’s insert() member function is called whenever the iterator (whether dereferenced or not) is assigned to. Incrementing the std::insert_iterator is a no-op.
Member types
Member type Definition container_type Container
Member functions
Member objects
Member name Definition
container (protected member object) a pointer of type Container*
Member types
Member type Definition value_type void difference_type void pointer void reference void iterator_category std::output_iterator_tag
These member types are required to be obtained by inheriting from std::iterator<std::output_iterator_tag, void, void, void, void>. (until C++17)
Example
// Run this code
#include <vector>
#include <list>
#include <iostream>
#include <iterator>
#include <algorithm>
int main()
{
std::vector<int> v{1, 2, 3, 4, 5};
std::list<int> l{-1, -2, -3};
std::copy(v.begin(), v.end(), // may be simplified with std::inserter
std::insert_iterator<std::list<int>>(l, std::next(l.begin())));
for (int n : l)
std::cout << n << ’ ‘;
std::cout << ‘\n’;
}
Output:
See also