Synopsis

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

Description

Returns a new sequence that contains all elements from |begin/end<Sequence>| range except those that are identical to T.

|transformation algorithm disclaimer|

Header

#include <boost/mpl/remove.hpp>

Model of

|Reversible Algorithm|

Parameters

Expression semantics

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

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

typedef remove<s,x,in>::type r;

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

Complexity

Linear. Performs exactly size<s>::value comparisons for equality, and at most size<s>::value insertions.

Example

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

See also

|Transformation Algorithms|, |Reversible Algorithm|, |reverse_remove|, |remove_if|, |copy|, |replace|