CKTIS / C++
std::basic_string::operator+= — dodavanje u niz
std::basic_string::operator+= dodaje znakove na kraj postojećeg niza i vraća referencu na njega. Prihvaća drugi niz, jedan znak, niz završen nul-znakom, inicijalizacijski popis ili tip kompatibilan sa string_view.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
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+= mijenja lijevi operand dodavanjem sadržaja na njegov kraj. Za std::string je charT jednak char; uključite <string>. Rezultat je tipa basic_string& i odnosi se na isti objekt, što omogućuje izraze poput (text += "a") += "b".
Pet preopterećenja prihvaća const basic_string&, const charT*, charT, std::initializer_list<charT> i const T&. Posljednje sudjeluje u odabiru preopterećenja samo ako se const T& može pretvoriti u std::basic_string_view<charT, traits>, ali ne i u const charT*. Operacije odgovaraju pozivima append; znakovno preopterećenje dodaje točno jedan znak.
Preopterećenje s pokazivačem zahtijeva valjan niz završen nul-znakom i zaustavlja kopiranje prije prvog nul-znaka; nemojte proslijediti null pokazivač. Preopterećenja za niz i pogled čuvaju ugrađene nul-znakove zahvaljujući njihovim izričitim duljinama. Za dodavanje međuspremnika poznate veličine upotrijebite append(data, count).
Dodavanje može alocirati memoriju i poništiti reference, pokazivače i iteratore na elemente. Prekoračenje max_size() uzrokuje std::length_error; ako operacija baci iznimku, objekt niza ostaje nepromijenjen. Navedeni izvori predstavljaju razvojni nacrt standarda, a ne nepromijenjeni tekst C++23.
Primjeri
#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;
}
Rezultat
C++ is useful!!
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.