[ceph.git] / ceph / src / boost / libs / range / doc / reference / algorithm / remove_copy_if.qbk

[/
    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:remove_copy_if remove_copy_if]

[heading Prototype]

``
template<class ForwardRange, class Outputiterator, class UnaryPred>
OutputIterator
remove_copy_if(ForwardRange& rng, OutputIterator out, UnaryPred pred);

template<class ForwardRange, class OutputIterator, class UnaryPred>
OutputIterator
remove_copy_if(const ForwardRange& rng, OutputIterator out, UnaryPred pred);
``

[heading Description]

`remove_copy_if` copied all of the elements `x` from `rng` for which `pred(x)` is `false`.

[heading Definition]

Defined in the header file `boost/range/algorithm/remove_copy_if.hpp`

[heading Requirements]

* `ForwardRange` is a model of the __forward_range__ Concept.
* `ForwardRange` is mutable.
* `UnaryPred` is a model of the `UnaryPredicateConcept`.

[heading Complexity]

Linear. `remove_copy_if` performs exactly `distance(rng)` comparisons with UnaryPred.

[endsect]
Commit	Line	Data
7c673cae FG	1	[/
	2	Copyright 2010 Neil Groves
	3	Distributed under the Boost Software License, Version 1.0.
	4	(See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
	5	/]
	6	[section:remove_copy_if remove_copy_if]
	7
	8	[heading Prototype]
	9
	10	``
	11	template<class ForwardRange, class Outputiterator, class UnaryPred>
	12	OutputIterator
	13	remove_copy_if(ForwardRange& rng, OutputIterator out, UnaryPred pred);
	14
	15	template<class ForwardRange, class OutputIterator, class UnaryPred>
	16	OutputIterator
	17	remove_copy_if(const ForwardRange& rng, OutputIterator out, UnaryPred pred);
	18	``
	19
	20	[heading Description]
	21
	22	`remove_copy_if` copied all of the elements `x` from `rng` for which `pred(x)` is `false`.
	23
	24	[heading Definition]
	25
	26	Defined in the header file `boost/range/algorithm/remove_copy_if.hpp`
	27
	28	[heading Requirements]
	29
	30	* `ForwardRange` is a model of the __forward_range__ Concept.
	31	* `ForwardRange` is mutable.
	32	* `UnaryPred` is a model of the `UnaryPredicateConcept`.
	33
	34	[heading Complexity]
	35
	36	Linear. `remove_copy_if` performs exactly `distance(rng)` comparisons with UnaryPred.
	37
	38	[endsect]