.. Algorithms/Inserters//back_inserter

back_inserter
=============

Synopsis
--------

.. parsed-literal::
    
    template<
          typename Seq
        >
    struct back_inserter
    {
        // |unspecified|
        // |...|
    };


Description
-----------

Inserts elements at the end of the sequence.

Header
------

.. parsed-literal::
    
    #include <boost/mpl/back_inserter.hpp>

Model of
--------

|Inserter|


Parameters
----------

+---------------+-------------------------------+---------------------------------------+
| Parameter     | Requirement                   | Description                           |
+===============+===============================+=======================================+
| ``Seq``       | |Back Extensible Sequence|    | A sequence to bind the inserter to.   |
+---------------+-------------------------------+---------------------------------------+


Expression semantics
--------------------

|Semantics disclaimer...| |Inserter|.

For any |Back Extensible Sequence| ``s``:

+---------------------------+-------------------------------------------------------+
| Expression                | Semantics                                             |
+===========================+=======================================================+
| ``back_inserter<s>``      | An |Inserter| ``in``, equivalent to                   |
|                           |                                                       |
|                           | .. parsed-literal::                                   |
|                           |                                                       |
|                           |   struct in : inserter<s,push_back<_1,_2> > {};       |
+---------------------------+-------------------------------------------------------+


Complexity
----------

Amortized constant time.


Example
-------

.. parsed-literal::

    typedef copy<
          range_c<int,5,10>
        , back_inserter< vector_c<int,0,1,2,3,4> >
        >::type range;
       
    BOOST_MPL_ASSERT(( equal< range, range_c<int,0,10> > ));


See also
--------

|Algorithms|, |Inserter|, |Reversible Algorithm|, |[inserter]|, |front_inserter|, |push_back|


.. copyright:: Copyright ©  2001-2009 Aleksey Gurtovoy and David Abrahams
   Distributed under the Boost Software License, Version 1.0. (See accompanying
   file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)