bsl::basic_string::insert

Synopsis

Declared in <bslstl_string.h>

basic_string&
insert(
    size_type position,
    basic_string const& other,
    size_type sourcePosition,
    size_type numChars = npos);

Description

Insert at the specified position in this string the optionally specified numChars characters starting at the specified sourcePosition in the specified other string, or the suffix of other starting at sourcePosition if `sourcePosition + numChars > other.length(). If numChars is not specified, npos` is used. Return a reference providing modifiable access to this string. Throw out_of_range if position > length() or `sourcePosition > other.length()`.

Return Value

reference providing modifiable access to this string

Parameters

Name	Description
position	starting index
other	string or character sequence to compare or use
sourcePosition	starting index in the source string
numChars	number of characters