template<typename CONTAINER>
class cpp::push_iterator< CONTAINER >
Push iterator
A push_iterator is a special type of output iterator designed to allow algorithms that usually overwrite elements (such as copy) to instead push new elements automatically into the container.
The container needs to have a push() member function (such as the standard containers queue and stack).
Using the assignment operator on the returned iterator (either dereferenced or not), causes the container to expand by one element, which is initialized to the value assigned.
The returned iterator supports all other typical operations of output iterators but have no effect: all values assigned are pushed into the container.