Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti