C++ In a Nutshell

Name

replace function template — Replaces all occurrences of one value with another value

Synopsis

template<typename FwdIter, typename T>
  void replace(FwdIter first, FwdIter last, const T& old_value, 
               const T& new_value);

The replace function template replaces all occurrences of old_value in [first, last) with new_value. See Figure 13-14 (under replace_copy) for an example of the replacement process.

Technical Notes

The replace function template assigns *i = (*i == old_value) ? new_value : *i for all i in [first, last).

Complexity is linear: exactly last - first comparisons are performed.

See Also

remove function template, replace_copy function template, replace_copy_if function template, replace_if function template, transform function template