remove_copy.qbk 1.1 KB

123456789101112131415161718192021222324252627282930313233343536373839
  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 remove_copy]
  7. [heading Prototype]
  8. ``
  9. template<class ForwardRange, class Outputiterator, class Value>
  10. OutputIterator
  11. remove_copy(ForwardRange& rng, OutputIterator out, const Value& val);
  12. template<class ForwardRange, class OutputIterator, class Value>
  13. OutputIterator
  14. remove_copy(const ForwardRange& rng, OutputIterator out, const Value& val);
  15. ``
  16. [heading Description]
  17. `remove_copy` copied all of the elements `x` from `rng` for which `x == val` is `false`.
  18. [heading Definition]
  19. Defined in the header file `boost/range/algorithm/remove_copy.hpp`
  20. [heading Requirements]
  21. * `ForwardRange` is a model of the __forward_range__ Concept.
  22. * `ForwardRange` is mutable.
  23. * `Value` is a model of the `EqualityComparableConcept`.
  24. * Objects of type `Value` can be compared for equality with objects of `ForwardRange`'s value type.
  25. [heading Complexity]
  26. Linear. `remove_copy` performs exactly `distance(rng)` comparisons for equality.
  27. [endsect]