CKTIS / C++
std::basic_string::operator+= — pripájanie k reťazcu
std::basic_string::operator+= pripája znaky na koniec existujúceho reťazca a vracia naň referenciu. Prijíma iný reťazec, jeden znak, reťazec ukončený nulovým znakom, inicializačný zoznam alebo typ kompatibilný so string_view.
Verzia: 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+= mení ľavý operand pridaním obsahu na jeho koniec. Pre std::string je charT rovné char; vložte hlavičku <string>. Výsledok má typ basic_string& a odkazuje na ten istý objekt, takže možno písať napríklad (text += "a") += "b".
Päť preťažení prijíma const basic_string&, const charT*, charT, std::initializer_list<charT> a const T&. Posledné sa zúčastňuje výberu preťaženia iba vtedy, keď je const T& konvertibilné na std::basic_string_view<charT, traits>, ale nie na const charT*. Operácie zodpovedajú volaniam append; znakové preťaženie pripojí presne jeden znak.
Preťaženie s ukazovateľom vyžaduje platný reťazec ukončený nulovým znakom a kopírovanie zastaví pred prvým nulovým znakom; neodovzdávajte nulový ukazovateľ. Reťazcové preťaženia a preťaženia s pohľadom zachovávajú vložené nulové znaky vďaka explicitným dĺžkam. Ak chcete pripojiť buffer so známou veľkosťou, použite append(data, count).
Pripájanie môže alokovať pamäť a zneplatniť referencie, ukazovatele a iterátory na prvky. Prekročenie max_size() vyvolá std::length_error; ak operácia vyvolá výnimku, objekt reťazca zostane nezmenený. Dodané zdroje predstavujú priebežne sa vyvíjajúci návrh štandardu, nie zmrazený text C++23.
Príklady
#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;
}
Výsledok
C++ is useful!!
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.