string::assign (6 of 7 overloads)

Assign characters to a string.

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

Replaces the contents with copies of characters in the range {first, last).

Linear in std::distance(first, last).

Strong guarantee. Calls to memory_resource::allocate may throw.

Type	Description
`InputIt`	The type of the iterators.

InputIt satisfies InputIterator.

*this

Name	Description
`first`	An input iterator pointing to the first character to insert, or pointing to the end of the range.
`last`	An input iterator pointing to the end of the range.

Type	Thrown On
boost::system::system_error	`std::distance(first, last) > max_size()`.