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