string::append

`string::append`

Append characters to the string.

Synopsis

string&
append(
    std::size_t count,
    char ch); (1)

string&
append(
    string_view sv); (2)

template<
    class InputIt>
string&
append(
    InputIt first,
    InputIt last); (3)

Description

(1) appends count copies of ch.
(2) appends copies of characters of sv, preserving order.
(3) appends characters from the range [first, last), preserving order.

Preconditions

[first, last) shall be a valid range.

Constraints

InputIt satisfies LegacyInputIterator.

Exception Safety

Strong guarantee.

Template Parameters

Type Description

Type	Description
`InputIt`	The type of the iterators.

InputIt

The type of the iterators.

Return Value

*this.

Parameters

Name Description

Name	Description
`count`	The number of characters to append.
`ch`	The character to append.
`sv`	The `string_view` to append.
`first`	An iterator representing the first character to append.
`last`	An iterator one past the last character to append.

count

The number of characters to append.

ch

The character to append.

sv

The string_view to append.

first

An iterator representing the first character to append.

last

An iterator one past the last character to append.

Exceptions

Type Thrown On

Type	Thrown On
`boost::system::system_error`	The size of the string after the operation would exceed `max_size()`.

boost::system::system_error

The size of the string after the operation would exceed max_size().

Edit this page