Namespaces
Variants

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

From cppreference.net
C++
Strings library
std::basic_string
void push_back ( CharT ch ) ;
(constexpr depuis C++20)

Ajoute le caractère donné ch à la fin de la chaîne.

Table des matières

Paramètres

ch - le caractère à ajouter

Valeur de retour

(aucun)

Complexité

Amorti constant.

Exceptions

Si l'opération devait entraîner le dépassement de size() par rapport à max_size() , lève std::length_error .

Si une exception est levée pour quelque raison que ce soit, cette fonction n'a aucun effet ( garantie forte de sûreté face aux exceptions ).

Exemple

Exécuter ce code 
#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';
}

Sortie : 

1) "Short string", size: 12
2) "Short string!", size: 13

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

DR Appliqué à Comportement publié Comportement corrigé
LWG 7 C++98 1) la description était manquante dans le standard C++
2) le type du paramètre était const CharT 		1) description ajoutée
2) modifié en CharT
LWG 847 C++98 il n'y avait aucune garantie de sûreté des exceptions garantie de sûreté forte des exceptions ajoutée

Voir aussi

( DR* )
supprime le dernier caractère
(fonction membre publique)