bsl::basic_string::replace

Synopsis

Declared in <bslstl_string.h>

template<class STRING_VIEW_LIKE_TYPE>
basic_string&
replace(
    size_type outPosition,
    size_type outNumChars,
    STRING_VIEW_LIKE_TYPE const& replacement,
    size_type position,
    size_type numChars = npos);

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 optionally specified numChars characters starting at the specified position in the specified replacement (or the suffix of replacement starting at position if `position + numChars > replacement.length()). If numChars is not specified, npos` is used. Return a reference providing modifiable access to this string. Throw out_of_range if outPosition > length() or `position > replacement.length()`.

Return Value

reference providing modifiable access to this string

Parameters

Name	Description
numChars	number of characters
outPosition	index at which replacement begins
outNumChars	number of characters to replace
replacement	replacement character sequence
position	starting index