Insert characters into this string.
Synopsis
Declared in <bslstl_string.h>
template<class INPUT_ITER>
iterator
insert(
const_iterator position,
INPUT_ITER first,
INPUT_ITER last);
Description
Insert at the specified position in this string the characters in the range starting at the specified first iterator and ending right before the specified last iterator of the (template parameter) type INPUT_ITER, and return an iterator providing modifiable access to the first inserted character, or a non‐`const` copy of position if `first == last`. The behavior is undefined unless position` is a valid iterator on this string, and `first and last refer to a sequence of valid values where first is at a position at or before last.
Return Value
iterator referring to the first inserted character
Parameters
Name |
Description |
position |
starting index |
first |
beginning of the range (inclusive) |
last |
end of the range (exclusive) |
Created with MrDocs