CKTIS / C++
std::basic_string::operator+= — dodajanje v niz
std::basic_string::operator+= doda znake na konec obstoječega niza in vrne sklic nanj. Sprejme drug niz, en znak, niz, zaključen z ničelnim znakom, inicializacijski seznam ali tip, združljiv s string_view.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
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+= spremeni levi operand tako, da na njegov konec doda vsebino. Pri std::string je charT enak char; vključite <string>. Rezultat ima tip basic_string& in se nanaša na isti objekt, zato so mogoči izrazi, kot je (text += "a") += "b".
Pet preobremenitev sprejema const basic_string&, const charT*, charT, std::initializer_list<charT> in const T&. Zadnja sodeluje pri izbiri preobremenitve samo, če je const T& mogoče pretvoriti v std::basic_string_view<charT, traits>, ne pa v const charT*. Operacije ustrezajo klicem append; preobremenitev za znak doda natanko en znak.
Preobremenitev s kazalcem zahteva veljaven niz, zaključen z ničelnim znakom, kopiranje pa ustavi pred prvim ničelnim znakom; ne podajte ničelnega kazalca. Preobremenitvi za niz in pogled ohranita vdelane ničelne znake zaradi izrecno podanih dolžin. Če želite dodati medpomnilnik z znano velikostjo, uporabite append(data, count).
Dodajanje lahko dodeli pomnilnik in razveljavi reference, kazalce ter iteratorje do elementov. Prekoračitev max_size() sproži std::length_error; če operacija sproži izjemo, objekt niza ostane nespremenjen. Navedeni viri predstavljajo razvijajoči se osnutek standarda, ne nespremenjenega besedila C++23.
Primeri
#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;
}
Rezultat
C++ is useful!!
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.