# std::basic_string<CharT,Traits,Allocator>::append_range

From cppreference.com
< cpp‎ | string‎ | basic string

template< container-compatible-range<CharT> R > constexpr std::basic_string& append_range( R&& rg ); |  | (since C++23)

Appends all characters from the range rg.

Equivalent to

    return append(std::basic_string( std::from_range, std​::​forward<R>(rg), get_allocator()));

### Parameters

rg | - | a container compatible range

### Return value

*this

### Complexity

Linear in size of rg.

### Exceptions

If the operation would result in `size`() >`` `max_size`(), throws std::length_error.

If an exception is thrown for any reason, this function has no effect (strong exception safety guarantee).

### Notes

Feature-test macro | Value | Std | Comment
--- | --- | --- | ---
`__cpp_lib_containers_ranges` | 202202L | (C++23) | member functions that accept container compatible range

### Example

| This section is incomplete Reason: no example

### See also

append | appends characters to the end (public member function)

Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/string/basic_string/append_range&oldid=155509"