Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

Dodavanje na kraj niza znakova: std::basic_string::append

Odaberi preopterećenje `append` prema izvoru: cijeli niz, njegov dio ili međuspremnik poznate duljine. Izričito dodaj razdjelnike i sačuvaj nul-znakove unutar podataka.

Verzija: 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 zaglavlja <string> dodaje elemente CharT na kraj postojećeg niza znakova (std::string je specijalizacija za char). Vraća *this po referenci pa možeš ulančati pozive. Za razliku od assign, ne zamjenjuje postojeći sadržaj i ne umeće razdjelnike automatski. Za jedan znak upotrijebi push_back(ch) ili += ch; push_back vraća void.

append(str) kopira cijeli niz. append(str, pos, count) kopira najviše count elemenata od indeksa pos u izvoru, bez prelaska njegova kraja. Izostavi count ili proslijedi npos za kopiranje do kraja. U izvoru pos == size() daje prazan odsječak, a pos > size() baca std::out_of_range. Preopterećenja za tipove pretvorive u pogled, dostupna od C++17, rade jednako. U C++23 oba sudjeluju u odabiru preopterećenja samo ako je const T& implicitno pretvoriv u std::basic_string_view<CharT, Traits>. Samo preopterećenje za cijeli izvor dodatno zahtijeva da const T& nije implicitno pretvoriv u const CharT*.

append(p) zahtijeva valjan niz završen nul-znakom i kopira do prvog nul-znaka, ne uključujući ga. append(p, count) kopira točno count elemenata, uključujući nul-znakove unutar podataka. Broj ne ograničava na duljinu međuspremnika: provjeri ga prema stvarnoj veličini međuspremnika jer nevaljan raspon dovodi do nedefiniranog ponašanja. Primatelju koji prihvaća podatke s izričito navedenom duljinom proslijedi i data() i size().

append(count, ch) dodaje count kopija znaka ch. Možeš proslijediti i valjan raspon ulaznih iteratora [first, last) ili inicijalizacijsku listu. Ta su preopterećenja funkcije append od C++20 constexpr. append_range(range) zasebna je članska funkcija uvedena u C++23; provjeri podržava li je tvoja standardna biblioteka.

Dodavanje može poništiti valjanost pokazivača, referenci i iteratora na elemente odredišnog niza, a time i pogleda na njegovu memoriju. Dohvati ih ponovno nakon izmjene. Prekoračenje max_size() baca std::length_error; dodjela memorije također može ne uspjeti. Ako poziv funkcije append baci iznimku, odredišni niz ostaje u stanju u kojem je bio neposredno prije tog poziva.

Primjeri

#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 provjerava sadrži li zaglavlje obvezni znak `=` usporedbom rezultata `find` sa `std::string::npos`. Zatim dodaje dio prije `=`, izričito navedeni razdjelnik `:` i tri bajta podataka. Primatelj uspoređuje svih osam bajtova, uključujući unutarnji `\0`. Poziv `append(payload)` bez duljine kopirao bi samo `A`.

Povezane lekcije

  • C++ · Lekcija 58 · Napredno · Verzija: 3

Izvori