std::basic_string<CharT,Traits,Allocator>:: push_back
| Classes | ||||
|
(C++17)
|
||||
|
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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) |