bsl::basic_string::assign

Assign a new value to this string.

Synopsis

Declared in <bslstl_string.h>

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

Description

Assign to this string the value of the optionally specified numChars characters starting at the specified position in the specified replacement, or the suffix of the 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 position > replacement.length().

Return Value

reference providing modifiable access to this string

Parameters

NameDescription
numCharsnumber of characters
replacementreplacement character sequence
positionstarting index