[#bsl-basic_string-0e-append-07]
= xref:bsl.adoc[bsl]::xref:bsl/basic_string-0e.adoc[basic_string<wchar_t>]::append
:relfileprefix: ../../
:mrdocs:

`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.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/basic_string-0faf.adoc[basic_string<wchar_t>]&
xref:bsl/basic_string-0e/append-0eb.adoc[append](std::initializer_list<wchar_t> values);
----

[.small]#xref:bsl/basic_string-0e/append-0eb.adoc[_» more..._]#

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


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/basic_string-0faf.adoc[basic_string<wchar_t>]&
xref:bsl/basic_string-0e/append-09.adoc[append](xref:bsl/basic_string-0faf.adoc[basic_string<wchar_t>] const& suffix);
----

[.small]#xref:bsl/basic_string-0e/append-09.adoc[_» more..._]#

Append the specified null‐terminated `characterString` (of length `CHAR_TRAITS::length(characterString)`) to this string, and return a reference providing modifiable access to this string.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/basic_string-0faf.adoc[basic_string<wchar_t>]&
xref:bsl/basic_string-0e/append-0ed.adoc[append](wchar_t const* characterString);
----

[.small]#xref:bsl/basic_string-0e/append-0ed.adoc[_» more..._]#

Append to this string the `bsl::string_view` object, obtained from the specified `suffix`, and return a reference providing modifiable access to this string. Throw `length_error` if the length of the resulting string exceeds `max_size()`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class STRING_VIEW_LIKE_TYPE>
xref:bsl/basic_string-0faf.adoc[basic_string<wchar_t>]&
xref:bsl/basic_string-0e/append-0ec.adoc[append](STRING_VIEW_LIKE_TYPE const& suffix);
----

[.small]#xref:bsl/basic_string-0e/append-0ec.adoc[_» more..._]#

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


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/basic_string-0faf.adoc[basic_string<wchar_t>]&
xref:bsl/basic_string-0e/append-0f.adoc[append](
    xref:bsl/basic_string-0e/size_type.adoc[size_type] numChars,
    wchar_t character);
----

[.small]#xref:bsl/basic_string-0e/append-0f.adoc[_» more..._]#

Append to this string the specified initial `numChars` characters from the specified `characterString`, and return a reference providing modifiable access to this string. The behavior is undefined unless `characterString` is at least `numChars` long.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/basic_string-0faf.adoc[basic_string<wchar_t>]&
xref:bsl/basic_string-0e/append-050.adoc[append](
    wchar_t const* characterString,
    xref:bsl/basic_string-0e/size_type.adoc[size_type] numChars);
----

[.small]#xref:bsl/basic_string-0e/append-050.adoc[_» more..._]#

Append to this string the characters in the range starting at the specified `first` iterator and ending right before the specified `last` iterator of the (template parameter) type `INPUT_ITER`. Return a reference providing modifiable access to this string. The behavior is undefined unless `first` and `last` refer to a sequence of valid values where `first` is at a position at or before `last`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class INPUT_ITER>
xref:bsl/basic_string-0faf.adoc[basic_string<wchar_t>]&
xref:bsl/basic_string-0e/append-054.adoc[append](
    INPUT_ITER first,
    INPUT_ITER last);
----

[.small]#xref:bsl/basic_string-0e/append-054.adoc[_» more..._]#

Append to this string the optionally specified `numChars` characters starting at the specified `position` in the specified `suffix`, or the tail of `suffix` starting at `position` if `position + numChars > suffix.length()`. If `numChars` is not specified, `npos` is used. Return a reference providing modifiable access to this string. Throw `out_of_range` if `position > suffix.length()`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/basic_string-0faf.adoc[basic_string<wchar_t>]&
xref:bsl/basic_string-0e/append-0a.adoc[append](
    xref:bsl/basic_string-0faf.adoc[basic_string<wchar_t>] const& suffix,
    xref:bsl/basic_string-0e/size_type.adoc[size_type] position,
    xref:bsl/basic_string-0e/size_type.adoc[size_type] numChars = npos);
----

[.small]#xref:bsl/basic_string-0e/append-0a.adoc[_» more..._]#

Append to this string the optionally specified `numChars` characters starting at the specified `position` in the `bsl::string_view` object, obtained from the specified `suffix`, or its tail starting at `position` if `numChars` exceeds the length of this tail. If `numChars` is not specified, `npos` is used. Return a reference providing modifiable access to this string. Throw `out_of_range` if `position > strView.length()`. Throw `length_error` if the length of the resulting string exceeds `max_size()`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class STRING_VIEW_LIKE_TYPE>
xref:bsl/basic_string-0faf.adoc[basic_string<wchar_t>]&
xref:bsl/basic_string-0e/append-04.adoc[append](
    STRING_VIEW_LIKE_TYPE const& suffix,
    xref:bsl/basic_string-0e/size_type.adoc[size_type] position,
    xref:bsl/basic_string-0e/size_type.adoc[size_type] numChars = npos);
----

[.small]#xref:bsl/basic_string-0e/append-04.adoc[_» more..._]#


[.small]#Created with https://www.mrdocs.com[MrDocs]#