CKTIS / C++
std::basic_string::operator+= — ajouter à une chaîne
std::basic_string::operator+= ajoute des caractères à la fin d’une chaîne existante et renvoie une référence vers celle-ci. Il accepte une autre chaîne, un caractère, une chaîne terminée par zéro, une liste d’initialisation ou un type compatible avec string_view.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
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+= modifie son opérande de gauche en ajoutant du contenu à la fin. Pour std::string, charT est char ; incluez <string>. Le résultat est de type basic_string& et désigne le même objet, ce qui permet des expressions telles que (text += "a") += "b".
Les cinq surcharges acceptent const basic_string&, const charT*, charT, std::initializer_list<charT> et const T&. La dernière ne participe à la résolution de surcharge que si const T& est convertible en std::basic_string_view<charT, traits>, mais pas en const charT*. Les opérations correspondent à des appels à append ; la surcharge prenant un caractère ajoute exactement un caractère.
La surcharge prenant un pointeur exige une chaîne valide terminée par zéro et arrête la copie avant le premier caractère nul ; ne transmettez pas de pointeur nul. Les surcharges prenant une chaîne ou une vue préservent les caractères nuls intégrés grâce à leurs longueurs explicites. Pour ajouter un tampon de taille connue, utilisez append(data, count).
L’ajout peut allouer de la mémoire et invalider les références, pointeurs et itérateurs vers les éléments. Dépasser max_size() déclenche std::length_error ; si l’opération lève une exception, l’objet chaîne reste inchangé. Les sources fournies présentent le projet de norme en évolution, et non un texte C++23 figé.
Exemples
#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;
}
Résultat
C++ is useful!!
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.