Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::basic_string::operator+= — dodavanje u niz

std::basic_string::operator+= dodaje znakove na kraj postojećeg niza i vraća referencu na njega. Prihvaća drugi niz, jedan znak, niz završen nul-znakom, inicijalizacijski popis ili tip kompatibilan sa string_view.

Verzija: 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+= mijenja lijevi operand dodavanjem sadržaja na njegov kraj. Za std::string je charT jednak char; uključite <string>. Rezultat je tipa basic_string& i odnosi se na isti objekt, što omogućuje izraze poput (text += "a") += "b".

Pet preopterećenja prihvaća const basic_string&, const charT*, charT, std::initializer_list<charT> i const T&. Posljednje sudjeluje u odabiru preopterećenja samo ako se const T& može pretvoriti u std::basic_string_view<charT, traits>, ali ne i u const charT*. Operacije odgovaraju pozivima append; znakovno preopterećenje dodaje točno jedan znak.

Preopterećenje s pokazivačem zahtijeva valjan niz završen nul-znakom i zaustavlja kopiranje prije prvog nul-znaka; nemojte proslijediti null pokazivač. Preopterećenja za niz i pogled čuvaju ugrađene nul-znakove zahvaljujući njihovim izričitim duljinama. Za dodavanje međuspremnika poznate veličine upotrijebite append(data, count).

Dodavanje može alocirati memoriju i poništiti reference, pokazivače i iteratore na elemente. Prekoračenje max_size() uzrokuje std::length_error; ako operacija baci iznimku, objekt niza ostaje nepromijenjen. Navedeni izvori predstavljaju razvojni nacrt standarda, a ne nepromijenjeni tekst C++23.

Primjeri

#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!!

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori