cpp/regex/regex replace

uses a regular expression to perform substitution on a sequence of characters:

@1@ Copies characters in the range to, replacing any sequences that match  with characters formatted by. In other words:


 * Constructs a std object as if by, and uses it to step through every match of  within the sequence.
 * For each such match, copies the non-matched subsequence (cpp/regex/match_results/prefix) into as if by  and then replaces the matched subsequence with the formatted replacement string as if by calling cpp/regex/match_results/format.
 * When no more matches are found, copies the remaining non-matched characters to as if by  where  is a copy of the last match found.
 * If there are no matches, copies the entire sequence into as-is, by
 * If contains std, the non-matched subsequences are not copied into.
 * If contains std, only the first match is replaced.

@2@ same as 1), but the formatted replacement is performed as if by calling cpp/regex/match_results/format

@3-4@ Constructs an empty string of type  and calls.

@5-6@Constructs an empty string of type  and calls.

Return value
@1-2@ Returns a copy of the output iterator after all the insertions. @3-6@ Returns the string which contains the output.

Exceptions
May throw std to indicate an error condition.