CKTIS / C++
std::basic_string::operator+= — připojení k řetězci
std::basic_string::operator+= připojuje znaky na konec existujícího řetězce a vrací na něj odkaz. Přijímá jiný řetězec, jeden znak, řetězec ukončený nulovým znakem, inicializační seznam nebo typ kompatibilní se string_view.
Verze: 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+= mění levý operand přidáním obsahu na jeho konec. Pro std::string je charT rovno char; vložte hlavičku <string>. Výsledek má typ basic_string& a odkazuje na tentýž objekt, takže lze psát například (text += "a") += "b".
Pět přetížení přijímá const basic_string&, const charT*, charT, std::initializer_list<charT> a const T&. Poslední se účastní výběru přetížení pouze tehdy, když je const T& převoditelné na std::basic_string_view<charT, traits>, ale nikoli na const charT*. Operace odpovídají voláním append; znakové přetížení připojí přesně jeden znak.
Ukazatelové přetížení vyžaduje platný řetězec ukončený nulovým znakem a kopírování zastaví před prvním nulovým znakem; nepředávejte nulový ukazatel. Řetězcová přetížení a přetížení s pohledem zachovávají vložené nulové znaky díky explicitním délkám. Chcete-li připojit buffer o známé velikosti, použijte append(data, count).
Připojování může alokovat paměť a zneplatnit reference, ukazatele a iterátory na prvky. Překročení max_size() vyvolá std::length_error; pokud operace vyvolá výjimku, objekt řetězce zůstane nezměněn. Dodané zdroje představují průběžně se vyvíjející návrh standardu, nikoli zmrazený text C++23.
Pří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ýsledek
C++ is useful!!
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.