Rogue Wave banner
Previous fileTop of DocumentContentsIndex pageNext file
Standard C++ Library Module Reference Guide
Rogue Wave web site:  Home Page  |  Main Documentation Page

replace_copy_if()

Module:  Standard C++ Library   Library:  Algorithms


Function

Local Index

No Entries

Summary

An algorithm that substitutes elements in a collection with new values, and moves the revised sequence into result

Synopsis

#include <algorithm>

namespace std {
  template <class InputIterator,
            class OutputIterator,
            class Predicate,
            class T>
  OutputIterator replace_copy_if(InputIterator start,
                                 InputIterator finish,
                                 OutputIterator result,
                                 Predicate pred,
                                 const T& new_value);
}

Description

The replace_copy_if() algorithm leaves the original sequence intact and places a revised sequence into result. For the range [start,finish), the algorithm compares each element *i with the conditions specified by pred. If pred(*i)==false, replace_copy_if() copies *i to result+(start-i). If pred(*i)==true, then the algorithm copies new_value to result+(start-i). replace_copy_if() returns result+(finish-start).

Complexity

Exactly finish - start applications of the predicate are performed.

Example

See Also

replace(), replace_if(), replace_copy()

Standards Conformance

ISO/IEC 14882:1998 -- International Standard for Information Systems -- Programming Language C++, Section 25.2.4



Previous fileTop of DocumentContentsIndex pageNext file

Copyright (c) 1994-2006 Rogue Wave Software, a Quovadx Division.
Licensed under the Apache License, Version 2.0.
Contact Rogue Wave about documentation or support issues. You can also seek help from other developers through the Apache stdcxx community (see below).

For more information on the Rogue Wave Standard C++ Library under open source, see Section 1.2 of the user's guide.