std::basic_string<CharT,Traits,Allocator>:: push_back
| Classes | ||||
|
(C++17)
|
||||
|
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
void
push_back
(
CharT ch
)
;
|
(constexpr desde C++20) | |
Añade el carácter dado ch al final de la cadena.
Contenidos |
Parámetros
| ch | - | el carácter a añadir |
Valor de retorno
(ninguno)
Complejidad
Constante amortizada.
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 ).
Ejemplo
#include <iomanip> #include <iostream> #include <string> int main() { std::string str{"Short string"}; std::cout << "1) " << std::quoted(str) << ", size: " << str.size() << '\n'; str.push_back('!'); std::cout << "2) " << std::quoted(str) << ", size: " << str.size() << '\n'; }
Salida:
1) "Short string", size: 12 2) "Short string!", size: 13
Informes de defectos
Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.
| DR | Aplicado a | Comportamiento publicado | Comportamiento correcto |
|---|---|---|---|
| LWG 7 | C++98 |
1) la descripción faltaba en el estándar de C++
2) el tipo del parámetro era const CharT |
1) descripción añadida
2) cambiado a
CharT
|
| LWG 847 | C++98 | no existía garantía de seguridad de excepciones | añadida garantía fuerte de seguridad de excepciones |
Véase también
|
(
DR*
)
|
elimina el último carácter
(función miembro pública) |