bsl::basic_string::insert

insert overloads

Synopses

Declared in <bslstl_string.h>

Insert characters into this string.

iterator
insert(
    const_iterator position,
    CHAR_TYPE character);
» more...

Insert characters into this string.

iterator
insert(
    const_iterator position,
    std::initializer_list<CHAR_TYPE> values);
» more...

Insert characters into this string.

basic_string&
insert(
    size_type position,
    basic_string const& other);
» more...

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

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

Insert characters into this string.

template<class STRING_VIEW_LIKE_TYPE>
basic_string&
insert(
    size_type position,
    STRING_VIEW_LIKE_TYPE const& other);
» more...

Insert characters into this string.

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

Insert characters into this string.

basic_string&
insert(
    size_type position,
    size_type numChars,
    CHAR_TYPE character);
» more...

Insert characters into this string.

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

Insert characters into this string.

template<class INPUT_ITER>
iterator
insert(
    const_iterator position,
    INPUT_ITER first,
    INPUT_ITER last);
» more...

Insert characters into this string.

basic_string&
insert(
    size_type position,
    basic_string const& other,
    size_type sourcePosition,
    size_type numChars = npos);
» more...

Insert characters into this string.

template<class STRING_VIEW_LIKE_TYPE>
basic_string&
insert(
    size_type position,
    STRING_VIEW_LIKE_TYPE const& other,
    size_type sourcePosition,
    size_type numChars = npos);
» more...

Return Value

  • iterator referring to the first inserted character
  • reference providing modifiable access to this string

Parameters

NameDescription
positionstarting index
charactercharacter value
valuesinitializer list of characters
otherstring or character sequence to compare or use
characterStringnull-terminated string to insert
numCharsnumber of characters
firstbeginning of the range (inclusive)
lastend of the range (exclusive)
sourcePositionstarting index in the source string