bsl::basic_string::replace

Synopsis

Declared in <bslstl_string.h>

basic_string&
replace(
    size_type outPosition,
    size_type outNumChars,
    CHAR_TYPE const* characterString,
    size_type numChars);

Description

Replace the specified outNumChars characters starting at the specified outPosition in this string (or the suffix of this string starting at outPosition if outPosition + outNumChars > length()) with the specified initial numChars characters in the specified characterString. Return a reference providing modifiable access to this string. Throw out_of_range if outPosition > length(). The behavior is undefined unless characterString is at least numChars long.

Return Value

reference providing modifiable access to this string

Parameters

Name	Description
outPosition	index at which replacement begins
outNumChars	number of characters to replace
characterString	pointer to characters
numChars	number of characters