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 ) ; |
(desde C++23) | |
Reemplaza el contenido de la cadena con los valores en el rango rg .
Equivalente a
return assign( std::basic_string( std::from_range, std::forward<R>(rg), get_allocator()) );
Contenidos |
Parámetros
| rg | - | un container compatible range |
Valor de retorno
* this
Complejidad
Lineal en tamaño de rg .
Excepciones
Si la operación causara que
size()
exceda
max_size()
, lanza
std::length_error
.
Si se lanza una excepción por cualquier razón, esta función no tiene efecto ( strong exception safety guarantee ).
Notas
| Macro de prueba de características | Valor | Std | Característica |
|---|---|---|---|
__cpp_lib_containers_ranges
|
202202L
|
(C++23) | Funciones miembro que aceptan rango compatible con contenedor |
Ejemplo
#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"); }
Véase también
|
asignar caracteres a una cadena
(función miembro pública) |
|
|
asigna valores a la cadena
(función miembro pública) |
|
construye un
basic_string
(función miembro pública) |