Previous fileTop of DocumentContentsIndex pageNext file
Apache C++ Standard Library Reference Guide

replace_copy_if()

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