Reference
C Library
IOstream Library
Strings library
STL Containers
STL Algorithms
Miscellaneous
Miscellaneous
complex
exception
functional
iterator
limits
locale
memory
new
numeric
stdexcept
typeinfo
utility
valarray
iterator
advance
back_inserter
distance
front_inserter
inserter
iterator
iterator_traits
iterator categories:
BidirectionalIterator
ForwardIterator
InputIterator
OutputIterator
RandomAccessIterator
predefined iterators:
back_insert_iterator
front_insert_iterator
insert_iterator
istreambuf_iterator
istream_iterator
ostreambuf_iterator
ostream_iterator
reverse_iterator


back_inserter

function template
<iterator>
template <class Container>
  back_insert_iterator<Container> back_inserter (Container& x);

Construct a back insert iterator

This function generates a back insert iterator for a container.

A back insert iterator is a special type of output iterator specifically designed to allow algorithms that usually overwrite elements (such as copy) to instead insert new elements at the end of the container.

Parameters

x
Container for which the back insert iterator is constructed.

Return value

A back_insert_iterator that inserts elements at the end of container x.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// back_inserter example
#include <iostream>
#include <iterator>
#include <vector>
using namespace std;
int main () {
  vector<int> firstvector, secondvector;
  for (int i=1; i<=5; i++)
  { firstvector.push_back(i); secondvector.push_back(i*10); }
  copy (secondvector.begin(),secondvector.end(),back_inserter(firstvector));
  vector<int>::iterator it;
  for ( it = firstvector.begin(); it!= firstvector.end(); ++it )
	  cout << *it << " ";
  cout << endl;
  return 0;
}


Output:

1 2 3 4 5 10 20 30 40 50

See also