CKTIS / C++
std::basic_string::operator+= — an eine Zeichenkette anhängen
std::basic_string::operator+= hängt Zeichen an das Ende einer vorhandenen Zeichenkette an und gibt eine Referenz auf sie zurück. Akzeptiert werden eine weitere Zeichenkette, ein einzelnes Zeichen, eine nullterminierte Zeichenkette, eine Initialisierungsliste oder ein mit string_view kompatibler Typ.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
constexpr basic_string& operator+=(const basic_string& str);
template<class T> constexpr basic_string& operator+=(const T& t);
constexpr basic_string& operator+=(const charT* s);
constexpr basic_string& operator+=(charT c);
constexpr basic_string& operator+=(std::initializer_list<charT> il);std::basic_string::operator+= verändert den linken Operanden, indem es Inhalte an dessen Ende anfügt. Bei std::string ist charT gleich char; binde <string> ein. Das Ergebnis hat den Typ basic_string& und verweist auf dasselbe Objekt. Dadurch sind Ausdrücke wie (text += "a") += "b" möglich.
Die fünf Überladungen akzeptieren const basic_string&, const charT*, charT, std::initializer_list<charT> und const T&. Die letzte nimmt nur dann an der Überladungsauflösung teil, wenn const T& in std::basic_string_view<charT, traits>, aber nicht in const charT* konvertierbar ist. Die Operationen entsprechen Aufrufen von append; die Zeichenüberladung hängt genau ein Zeichen an.
Die Zeigerüberladung erfordert eine gültige nullterminierte Zeichenkette und beendet das Kopieren vor dem ersten Nullzeichen; übergib keinen Nullzeiger. Zeichenketten- und View-Überladungen erhalten eingebettete Nullzeichen dank ihrer expliziten Länge. Um einen Puffer bekannter Größe anzuhängen, verwende append(data, count).
Das Anhängen kann Speicher reservieren und Referenzen, Zeiger und Iteratoren auf Elemente ungültig machen. Wird max_size() überschritten, wird std::length_error ausgelöst; falls die Operation eine Ausnahme auslöst, bleibt das Zeichenkettenobjekt unverändert. Die bereitgestellten Quellen zeigen den sich weiterentwickelnden Standardentwurf, keinen festgeschriebenen C++23-Text.
Beispiele
#include <iostream>
#include <string>
#include <string_view>
int main() {
std::string text = "C";
text += std::string("++");
text += ' ';
text += "is";
text += std::string_view(" useful");
(text += {'!', '!'}) += '\n';
std::cout << text;
}
Ergebnis
C++ is useful!!
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.