Insert characters from a range into this string.
Declared in <bslstl_string.h>
template<class RANGE>
iterator
insert_range(
const_iterator position,
RANGE&& range);
Insert at the specified position in this string the characters from the specified range and return an iterator providing non-modifiable access to the first inserted character, or a non-const copy of position if true == bsl::ranges.empty(). The behavior is undefined unless position is an iterator in the range [begin() .. end()] (both endpoints included). Note that range must meet the requirements of an input range and the values from range must have a type matching or convertible to (template parameter) CHAR_TYPE>
iterator to the first inserted character
| Name | Description |
|---|---|
| range | input range of characters |
| position | starting index |