Synopsis

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

Description

Returns a copy of the original sequence where every type identical to OldType has been replaced with NewType.

|transformation algorithm disclaimer|

Header

#include <boost/mpl/replace.hpp>

Model of

|Reversible Algorithm|

Parameters

Expression semantics

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

For any |Forward Sequence| s, an |Inserter| in, and arbitrary types x and y:

typedef replace<s,x,y,in>::type r;

typedef replace_if< s,y,is_same<_,x>,in >::type r;

Complexity

Linear. Performs exactly size<s>::value comparisons for identity / insertions.

Example

typedef vector<int,float,char,float,float,double> types;
typedef vector<int,double,char,double,double,double> expected;
typedef replace< types,float,double >::type result;
BOOST_MPL_ASSERT(( equal< result,expected > ));

See also

|Transformation Algorithms|, |Reversible Algorithm|, |reverse_replace|, |replace_if|, |remove|, |transform|