bsl::basic_string::insert

Insert characters into this string.

Synopsis

Declared in <bslstl_string.h>

basic_string&
insert(
    size_type position,
    CHAR_TYPE const* characterString,
    size_type numChars);

Description

Insert at the specified position in this string the specified initial numChars characters in the specified characterString, and return a reference providing modifiable access to this string. Throw out_of_range if position > length(). The behavior is undefined unless characterString is at least numChars long.

Return Value

reference providing modifiable access to this string

Parameters

Name

Description

position

starting index

characterString

pointer to characters

numChars

number of characters

Created with MrDocs