CKTIS / C++
std::basic_string::operator+= — aan een tekenreeks toevoegen
std::basic_string::operator+= voegt tekens toe aan het einde van een bestaande tekenreeks en geeft er een verwijzing naar terug. De operator accepteert een andere tekenreeks, één teken, een nulbeëindigde tekenreeks, een initialisatielijst of een string_view-compatibel type.
Versie: 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+= wijzigt de linkeroperand door inhoud aan het einde toe te voegen. Voor std::string is charT gelijk aan char; neem <string> op. Het resultaat heeft het type basic_string& en verwijst naar hetzelfde object, zodat expressies zoals (text += "a") += "b" mogelijk zijn.
De vijf overloads accepteren const basic_string&, const charT*, charT, std::initializer_list<charT> en const T&. De laatste doet alleen mee aan de overloadresolutie als const T& converteerbaar is naar std::basic_string_view<charT, traits>, maar niet naar const charT*. De bewerkingen komen overeen met aanroepen van append; de tekenoverload voegt precies één teken toe.
De aanwijzeroverload vereist een geldige nulbeëindigde tekenreeks en stopt met kopiëren vóór het eerste nulteken; geef geen null-aanwijzer door. De tekenreeks- en view-overloads behouden ingebedde nultekens dankzij hun expliciete lengtes. Gebruik append(data, count) om een buffer met bekende grootte toe te voegen.
Toevoegen kan geheugen reserveren en verwijzingen, aanwijzers en iterators naar elementen ongeldig maken. Overschrijding van max_size() veroorzaakt std::length_error; als de bewerking een uitzondering veroorzaakt, blijft het tekenreeksobject ongewijzigd. De aangeleverde bronnen tonen het evoluerende standaardontwerp, niet een vastgelegde C++23-tekst.
Voorbeelden
#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;
}
Resultaat
C++ is useful!!
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.