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