|
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
template<container-compatible-range<CharT> R> constexprstd::basic_string& append_range( R&& rg); | (since C++23) | |
Appends all characters from the rangerg.
Equivalent to
return append(std::basic_string(std::from_range, std::forward<R>(rg), get_allocator()));
Contents |
| rg | - | acontainer compatible range |
*this
Linear in size ofrg.
If the operation would causesize() to exceedmax_size(), throwsstd::length_error.
If an exception is thrown for any reason, this function has no effect (strong exception safety guarantee).
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_containers_ranges | 202202L | (C++23) | member functions that acceptcontainer compatible range |
#include <cassert>#include <string> int main(){std::string head{"long long"};constauto tail={' ','i','n','t'}; #ifdef __cpp_lib_containers_ranges head.append_range(tail);#else head.append(tail.begin(), tail.end());#endif assert(head=="long long int");}
| appends characters to the end (public member function)[edit] |