std::basic_string<CharT,Traits,Allocator>:: append_range
| Classes | ||||
|
(C++17)
|
||||
|
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
template
<
container-compatible-range
<
CharT
>
R
>
constexpr std:: basic_string & append_range ( R && rg ) ; |
(desde C++23) | |
Añade todos los caracteres del rango rg .
Equivalente a
return append(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() { std::string head{"long long"}; const auto 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"); }
Véase también
|
añade caracteres al final
(función miembro pública) |