|
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
template<container-compatible-range<CharT> R> constexprstd::basic_string& assign_range( R&& rg); | (since C++23) | |
Replaces the contents of the string with the values in the rangerg.
Equivalent to
return assign(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(){constauto source={'s','o','u','r','c','e'};std::string destination{"destination"}; #ifdef __cpp_lib_containers_ranges destination.assign_range(source);#else destination.assign(source.begin(), source.end());#endif assert(destination=="source");}
| assign characters to a string (public member function)[edit] | |
| assigns values to the string (public member function)[edit] | |
constructs abasic_string(public member function)[edit] |
