std::basic_string<CharT,Traits,Allocator>:: assign_range
| Classes | ||||
|
(C++17)
|
||||
|
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
template
<
container-compatible-range
<
CharT
>
R
>
constexpr std:: basic_string & assign_range ( R && rg ) ; |
(seit C++23) | |
Ersetzt den Inhalt der Zeichenkette durch die Werte im Bereich rg .
Entspricht
return assign( std::basic_string( std::from_range, std::forward<R>(rg), get_allocator()) );
Inhaltsverzeichnis |
Parameter
| rg | - | ein container compatible range |
Rückgabewert
* this
Komplexität
Linear in der Größe von rg .
Exceptions
Falls die Operation dazu führen würde, dass
size()
die
max_size()
überschreitet, wird
std::length_error
ausgelöst.
Wenn aus irgendeinem Grund eine Exception ausgelöst wird, hat diese Funktion keine Wirkung ( strong exception safety guarantee ).
Hinweise
| Feature-Test Makro | Wert | Std | Feature |
|---|---|---|---|
__cpp_lib_containers_ranges
|
202202L
|
(C++23) | Memberfunktionen, die container compatible range akzeptieren |
Beispiel
#include <cassert> #include <string> int main() { const auto 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"); }
Siehe auch
|
Zeichen einer Zeichenkette zuweisen
(öffentliche Elementfunktion) |
|
|
weist Werte der Zeichenkette zu
(öffentliche Elementfunktion) |
|
konstruiert einen
basic_string
(öffentliche Elementfunktion) |