bsl::basic_string::append

append overloads

Synopses

Declared in <bslstl_string.h>

Append to this string each CHAR_TYPE object in the specified values initializer list, and return a reference providing modifiable access to this string.

basic_string&
append(std::initializer_list<CHAR_TYPE> values);
» more...

Append to this string the specified suffix, and return a reference providing modifiable access to this string.

basic_string&
append(basic_string const& suffix);
» more...

Append characters to this string.

basic_string&
append(CHAR_TYPE const* characterString);
» more...

Append characters to this string.

template<class STRING_VIEW_LIKE_TYPE>
basic_string&
append(STRING_VIEW_LIKE_TYPE const& suffix);
» more...

Append the specified numChars copies of the specified character to this string, and return a reference providing modifiable access to this string.

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

Append characters to this string.

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

Append the characters in the iterator range [first, last)].

template<class INPUT_ITER>
basic_string&
append(
    INPUT_ITER first,
    INPUT_ITER last);
» more...

Append a substring of suffix to this string.

basic_string&
append(
    basic_string const& suffix,
    size_type position,
    size_type numChars = npos);
» more...

Append characters to this string.

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

Return Value

  • reference providing modifiable access to this string
  • a reference to this string

Parameters

NameDescription
valuesinitializer list of characters
suffixcharacters to append
characterStringpointer to characters
numCharsnumber of characters
charactercharacter value
firstbeginning of the character range to append
lastend of the character range to append (one past last)
positionstarting index in suffix