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

Name

Description

position

starting index

character

character value

values

initializer list of characters

other

string or character sequence to compare or use

characterString

null‐terminated string to insert

numChars

number of characters

first

beginning of the range (inclusive)

last

end of the range (exclusive)

sourcePosition

starting index in the source string

Created with MrDocs