Insert characters into this string.

Synopsis

Declared in <bslstl_string.h>

iterator
insert(
    const_iterator position,
    size_type numChars,
    CHAR_TYPE character);

Description

Insert at the specified position in this string the specified numChars copies of the specified character, and return an iterator providing modifiable access to the first inserted character, or a non‐`const` copy of position if 0 == numChars. The behavior is undefined unless position is a valid iterator on this string.

Return Value

iterator referring to the first inserted character

Parameters

Name

Description

position

starting index

numChars

number of characters

character

character value

Created with MrDocs