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.
Declared in <bslstl_string.h>
template<class INPUT_ITER>
iterator
insert(
const_iterator position,
INPUT_ITER first,
INPUT_ITER last);