# Boost.Range

## Range Adaptors

#### `replaced`

>     rng | boost::adaptors::replaced( new_value, old_value )

>     boost::make_replaced_range( rng, new_value, old_value )

- Precondition:
  - `new_value` is convertible to the value-type of the range.
  - `old_value` is convertible to the value-type of the range.
- Postcondition: For all elements `x` in the returned range, the value `x` is equal to the value of `(y == old_value) ? new_value : y` where `y` is the corresponding element in the original range.
- Range Category: ForwardRange

### Example

            #include <boost/range/adaptor/replaced.hpp>
            #include <boost/range/algorithm/copy.hpp>
            #include <boost/assign.hpp>
            #include <algorithm>
            #include <iostream>
            #include <vector>

            int main(int argc, const char* argv[])
            {
                using namespace boost::adaptors;
                using namespace boost::assign;

                std::vector<int> input;
                input += 1,2,3,2,5,2,7,2,9;

                boost::copy(
                    input | replaced(2, 10),
                    std::ostream_iterator<int>(std::cout, ","));

                return 0;
            }

This produces the output:
`1,10,3,10,5,10,7,10,9`

(C) Copyright Neil Groves 2009 (C) Copyright Thorsten Ottosen 2003-2004