Namespaces
Variants

std::basic_string<CharT,Traits,Allocator>:: push_back

From cppreference.net
std::basic_string
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)