Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri