...one of the most highly
regarded and expertly designed C++ library projects in the
world.

— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards

This is the documentation for a snapshot of the develop branch, built from commit 02172d0631.

Front Page / Algorithms / Transformation Algorithms / replace |

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

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

[*Note:* This wording applies to a no-inserter version(s) of the algorithm. See the
Expression semantics subsection for a precise specification of the algorithm's
details in all cases — *end note*]

#include <boost/mpl/replace.hpp>

Parameter | Requirement | Description |
---|---|---|

Sequence |
Forward Sequence | A original sequence. |

OldType |
Any type | A type to be replaced. |

NewType |
Any type | A type to replace with. |

In |
Inserter | An inserter. |

The semantics of an expression are defined only where they differ from, or are not defined in Reversible Algorithm.

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

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

Return type: | A type. |
---|---|

Semantics: | Equivalent to typedef replace_if< s,y,is_same<_,x>,in >::type r; |

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