Defined in header <iterator> | ||
|---|---|---|
template< class Container >
class front_insert_iterator :
public std::iterator< std::output_iterator_tag, void, void, void, void >
| (until C++17) | |
template< class Container > class front_insert_iterator; | (since C++17) |
std::front_insert_iterator is a LegacyOutputIterator that prepends elements to a container for which it was constructed. The container's push_front() member function is called whenever the iterator (whether dereferenced or not) is assigned to. Incrementing the std::front_insert_iterator is a no-op.
| 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 new front_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 name | Definition |
|---|---|
container (protected) | a pointer of type Container* |
#include <algorithm>
#include <deque>
#include <iostream>
#include <iterator>
#include <vector>
namespace stb {
void println(auto, auto const& d)
{
std::ranges::copy(d, std::ostream_iterator<int>(std::cout, " "));
std::cout << '\n';
}
}
int main()
{
std::vector<int> v{1, 2, 3, 4, 5};
std::deque<int> d;
std::copy(v.begin(), v.end(),
std::front_insert_iterator<std::deque<int>>(d));
// or std::front_inserter(d)
stb::println("{}", d);
}Output:
5 4 3 2 1
creates a std::front_insert_iterator of type inferred from the argument (function template) |
|
| iterator adaptor for insertion at the end of a container (class template) |
|
| iterator adaptor for insertion into a container (class template) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/iterator/front_insert_iterator