bsl::basic_string::insert

Synopsis

Declared in <bslstl_string.h>

template<class STRING_VIEW_LIKE_TYPE>
basic_string&
insert(
    size_type position,
    STRING_VIEW_LIKE_TYPE 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 bsl::string_view object, obtained from the specified other, or the suffix of this object 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(). Throw length_error if the length of the resulting string exceeds max_size().

Return Value

reference providing modifiable access to this string

Parameters

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