Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for an old version of Boost. Click here to view this page for the latest version.
PrevUpHomeNext
string::append (3 of 3 overloads)

Append a range of characters.

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

Appends characters from the range {first, last) to the end of the string.

Precondition

{first, last)shall be a valid range

Exception Safety

Strong guarantee.

Template Parameters

Type

Description

InputIt

The type of the iterators.

Constraints

InputItsatisfies InputIterator.

Return Value

*this

Parameters

Name

Description

first

An iterator representing the first character to append.

last

An iterator one past the last character to append.

Exceptions

Type

Thrown On

std::length_error

size() + insert_count > max_size()


PrevUpHomeNext