Sierra Toolkit Version of the Day
Inherits eastl::iterator< Category, T, Distance, Pointer, Reference >.
|insert_iterator &||operator= (const insert_iterator &x)|
|insert_iterator (Container &x, iterator_type itNew)|
|insert_iterator &||operator= (const_reference value)|
|insert_iterator &||operator* ()|
|insert_iterator &||operator++ ()|
|insert_iterator &||operator++ (int)|
insert_iterator is an iterator adaptor that functions as an OutputIterator: assignment through an insert_iterator inserts an object into a container. Specifically, if ii is an insert_iterator, then ii keeps track of a container c and an insertion point p; the expression *ii = x performs the insertion c.insert(p, x).
If you assign through an insert_iterator several times, then you will be inserting several elements into the underlying container. In the case of a sequence, they will appear at a particular location in the underlying sequence, in the order in which they were inserted: one of the arguments to insert_iterator's constructor is an iterator p, and the new range will be inserted immediately before p.