bsl::basic_string::insert

Insert a null-terminated character string at the given position.

Synopsis

Declared in <bslstl_string.h>

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

Description

Insert at the specified position in this string the specified null-terminated characterString (of length CHAR_TRAITS::length(characterString)), and return a reference providing modifiable access to this string. Throw out_of_range if position > length().

Return Value

reference providing modifiable access to this string

Parameters

NameDescription
positionindex at which to insert
characterStringnull-terminated string to insert