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

CKTIS / C++

Dodajanje na konec niza: std::basic_string::append

Izberi preobremenitev `append` glede na vir: celoten niz, njegov odsek ali medpomnilnik znane dolžine. Ločila dodaj izrecno in ohrani ničelne znake znotraj podatkov.

Različica: ISO C++23; implementation support may vary

Sintaksa

In <string>, for std::basic_string<CharT, Traits, Allocator> dst (C++23):
dst.append(str);                     // whole basic_string
dst.append(str, pos, count = npos);  // slice of a basic_string
dst.append(viewLike);                // whole view
dst.append(viewLike, pos, count = npos); // slice of a view
dst.append(p);                       // null-terminated sequence
dst.append(p, count);                // exactly count elements
dst.append(count, ch);               // count copies of ch
dst.append(first, last);              // valid input-iterator range [first, last)
dst.append({ch1, ch2});               // initializer list
All forms return basic_string&. The notation count = npos denotes a default argument, not an assignment at the call site. append_range(range) is a separate C++23 member.

std::basic_string::append iz glave <string> doda elemente CharT na konec obstoječega niza (std::string je specializacija za char). Vrne *this po referenci, zato lahko klice verižiš. V nasprotju z assign ne zamenja obstoječe vsebine in ne vstavi ločil samodejno. Za en znak uporabi push_back(ch) ali += ch; push_back vrne void.

append(str) kopira celoten niz. append(str, pos, count) kopira največ count elementov od indeksa pos v viru, ne da bi šel čez konec vira. Izpusti count ali podaj npos, če želiš kopirati do konca. V viru pos == size() pomeni prazen odsek, pos > size() pa sproži std::out_of_range. Preobremenitve za tipe, pretvorljive v pogled, so na voljo od C++17 in delujejo enako. V C++23 se pri izbiri preobremenitve obe upoštevata le, če je const T& implicitno pretvorljiv v std::basic_string_view<CharT, Traits>. Le preobremenitev za celoten vir dodatno zahteva, da const T& ni implicitno pretvorljiv v const CharT*.

append(p) zahteva veljavno zaporedje, končano z ničelnim znakom, in kopira do prvega ničelnega znaka, ne da bi ga vključil. append(p, count) kopira natanko count elementov, vključno z ničelnimi znaki znotraj podatkov. Števila ne omeji na dolžino medpomnilnika: primerjaj ga z dejansko velikostjo medpomnilnika, saj neveljaven obseg povzroči nedefinirano vedenje. Prejemniku, ki sprejema podatke z izrecno podano dolžino, podaj data() in size().

append(count, ch) doda count kopij znaka ch. Podaš lahko tudi veljaven obseg vhodnih iteratorjev [first, last) ali inicializacijski seznam. Te preobremenitve append so od C++20 constexpr. append_range(range) je ločena članska funkcija iz C++23; preveri, ali jo tvoja standardna knjižnica podpira.

Dodajanje lahko razveljavi kazalce, reference in iteratorje na elemente ciljnega niza s tem pa tudi poglede na njegov pomnilnik. Po spremembi jih pridobi znova. Prekoračitev max_size() sproži std::length_error; tudi dodelitev pomnilnika lahko spodleti. Če klic append sproži izjemo, ciljni niz ostane tak, kot je bil neposredno pred tem klicem.

Primeri

#include <iostream>
#include <string>
#include <string_view>

int main() {
    const std::string header = "kind=sample";
    const char payload[] = {'A', '\0', 'B'};

    const auto cut = header.find('=');
    if (cut == std::string::npos) {
        return 1;
    }

    std::string message;
    message.append(header, 0, cut)
           .append(1, ':')
           .append(payload, sizeof payload);

    const std::string_view received{message.data(), message.size()};
    if (received != std::string_view{"kind:A\0B", 8}) {
        return 2;
    }

    std::cout << "accepted: " << received.size() << " bytes\n";
}

Rezultat

accepted: 8 bytes

Program preveri, ali glava vsebuje obvezni znak `=`, tako da primerja rezultat `find` z `std::string::npos`. Nato doda odsek pred `=`, izrecno ločilo `:` in tri bajte podatkov. Prejemnik primerja vseh osem bajtov, vključno z notranjim `\0`. Klic `append(payload)` brez podatka o dolžini bi kopiral le `A`.

Povezane lekcije

  • C++ · Lekcija 58 · Napredna · Različica: 3

Viri