bsl::basic_string::append

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

Synopsis

Declared in <bslstl_string.h>

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

Description

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.

Return Value

reference providing modifiable access to this string

Parameters

NameDescription
firstbeginning of the character range to append
lastend of the character range to append (one past last)