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

replace_copy()

Library:  Algorithms


Function

Local Index

No Entries

Summary

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

Synopsis

#include <algorithm>

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

Description

The replace_copy() algorithm leaves the original sequence intact and places the revised sequence into result. For the range [start, finish), the algorithm compares elements referred to by iterator i with old_value. If *i does not compare equal to old_value, then replace_copy() copies *i to result+(start-i). If *i==old_value, then replace_copy() copies new_value to result+(start-i). replace_copy() returns result+(finish-start).

Complexity

Exactly finish - start comparisons between values are done.

Example

See Also

replace(), replace_if(), replace_copy_if()

Standards Conformance

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



Previous fileTop of DocumentContentsIndex pageNext file