Namespaces
Variants

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

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

Fügt das angegebene Zeichen ch am Ende der Zeichenkette an.

Inhaltsverzeichnis

Parameter

ch - das anzuhängende Zeichen

Rückgabewert

(keine)

Komplexität

Amortisiert konstant.

Exceptions

Falls die Operation dazu führen würde, dass size() die max_size() überschreitet, wird std::length_error ausgelöst.

Wenn aus irgendeinem Grund eine Exception ausgelöst wird, hat diese Funktion keine Wirkung ( strong exception safety guarantee ).

Beispiel

#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';
}

Ausgabe:

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

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR Angewendet auf Verhalten wie veröffentlicht Korrigiertes Verhalten
LWG 7 C++98 1) die Beschreibung fehlte im C++-Standard
2) der Parametertyp war const CharT
1) Beschreibung hinzugefügt
2) geändert zu CharT
LWG 847 C++98 es gab keine Exception-Sicherheitsgarantie starke Exception-Sicherheitsgarantie hinzugefügt

Siehe auch

( DR* )
entfernt das letzte Zeichen
(öffentliche Elementfunktion)