CKTIS / C++
std::basic_string::operator+= — aggiungere a una stringa
std::basic_string::operator+= aggiunge caratteri alla fine di una stringa esistente e ne restituisce un riferimento. Accetta un’altra stringa, un singolo carattere, una stringa terminata da zero, una lista di inizializzazione o un tipo compatibile con string_view.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
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+= modifica l’operando a sinistra aggiungendo contenuto alla fine. Per std::string, charT è char; includi <string>. Il risultato ha tipo basic_string& e si riferisce allo stesso oggetto, consentendo espressioni come (text += "a") += "b".
Le cinque overload accettano const basic_string&, const charT*, charT, std::initializer_list<charT> e const T&. L’ultima partecipa alla risoluzione delle overload solo se const T& è convertibile in std::basic_string_view<charT, traits>, ma non in const charT*. Le operazioni corrispondono a chiamate a append; l’overload per carattere aggiunge esattamente un carattere.
L’overload per puntatore richiede una stringa valida terminata da zero e interrompe la copia prima del primo carattere nullo; non passare un puntatore nullo. Le overload per stringa e vista conservano i caratteri nulli incorporati grazie alle lunghezze esplicite. Per aggiungere un buffer di dimensione nota, usa append(data, count).
L’aggiunta può allocare memoria e invalidare riferimenti, puntatori e iteratori agli elementi. Il superamento di max_size() genera std::length_error; se l’operazione genera un’eccezione, l’oggetto stringa rimane invariato. Le fonti fornite presentano la bozza in evoluzione dello standard, non un testo C++23 definitivo.
Esempi
#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;
}
Risultato
C++ is useful!!
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.