Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje