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

Name

Description

position

index at which to insert

characterString

null‐terminated string to insert

Created with MrDocs