Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje