forked from boostorg/range
55 lines
1.5 KiB
Plaintext
55 lines
1.5 KiB
Plaintext
[/
|
|
Copyright 2010 Neil Groves
|
|
Distributed under the Boost Software License, Version 1.0.
|
|
(See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
|
/]
|
|
[section:replaced replaced]
|
|
|
|
[table
|
|
[[Syntax] [Code]]
|
|
[[Pipe] [`rng | boost::adaptors::replaced(new_value, old_value)`]]
|
|
[[Function] [`boost::adaptors::replace(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:] __forward_range__
|
|
* [*Range Return Type:] `boost::replaced_range<typeof(rng)>`
|
|
* [*Returned Range Category:] The range category of `rng`.
|
|
|
|
[section:replaced_example replaced 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;
|
|
}
|
|
``
|
|
[endsect]
|
|
|
|
This would produce the output:
|
|
``
|
|
1,10,3,10,5,10,7,10,9
|
|
``
|
|
[endsect]
|
|
|
|
|