Synopsis

template<
      typename Sequence
    , typename In = |unspecified|
    >
struct copy
{
    typedef |unspecified| type;
};

Description

Returns a copy of the original sequence.

|transformation algorithm disclaimer|

Header

#include <boost/mpl/copy.hpp>

Model of

|Reversible Algorithm|

Parameters

Expression semantics

|Semantics disclaimer...| |Reversible Algorithm|.

For any |Forward Sequence| s, and an |Inserter| in:

typedef copy<s,in>::type r;

typedef fold< s,in::state,in::operation >::type r;

Complexity

Linear. Exactly size<s>::value applications of in::operation.

Example

typedef vector_c<int,0,1,2,3,4,5,6,7,8,9> numbers;
typedef copy<
      range_c<int,10,20>
    , back_inserter< numbers >
    >::type result;
BOOST_MPL_ASSERT_RELATION( size<result>::value, ==, 20 );
BOOST_MPL_ASSERT(( equal< result,range_c<int,0,20> > ));

See also

|Transformation Algorithms|, |Reversible Algorithm|, |reverse_copy|, |copy_if|, |transform|