bsl::basic_string::assign

Assign a new value to this string.

Synopsis

Declared in <bslstl_string.h>

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

Description

Assign 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 range (inclusive)
lastend of the range (exclusive)