Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

Pripojenie na koniec reťazca: std::basic_string::append

Vyber preťaženie `append` podľa zdroja: celý reťazec, jeho časť alebo buffer so známou dĺžkou. Pridávaj oddeľovače výslovne a zachovaj nulové znaky vo vnútri údajov.

Verzia: ISO C++23; implementation support may vary

Syntax

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 z hlavičky <string> pridáva prvky CharT na koniec existujúceho reťazca (std::string je špecializácia pre char). Vracia *this referenciou, takže volania možno reťaziť. Na rozdiel od assign nenahrádza existujúci obsah a nevkladá oddeľovače automaticky. Pre jeden znak použi push_back(ch) alebo += ch; push_back vracia void.

append(str) skopíruje celý reťazec. append(str, pos, count) kopíruje od indexu pos v zdroji najviac count prvkov a zastaví sa na konci zdroja. Vynechaj count alebo odovzdaj npos, ak chceš kopírovať až do konca. V zdroji znamená pos == size() prázdnu časť, kým pos > size() vyvolá std::out_of_range. Preťaženia pre typy konvertovateľné na pohľad na reťazec, dostupné od C++17, fungujú rovnako. V C++23 sa pri výbere preťaženia zvažujú obe iba vtedy, keď sa const T& dá implicitne konvertovať na std::basic_string_view<CharT, Traits>. Iba preťaženie pre celý zdroj navyše vyžaduje, aby sa const T& nedalo implicitne konvertovať na const CharT*.

append(p) vyžaduje platnú postupnosť ukončenú nulovým znakom a kopíruje až po prvú nulu bez nej. append(p, count) kopíruje presne count prvkov vrátane núl vo vnútri údajov. Počet neobmedzuje podľa dĺžky buffera: skontroluj ho podľa skutočnej veľkosti buffera, pretože neplatný rozsah vedie k nedefinovanému správaniu. Príjemcovi, ktorý prijíma údaje s výslovne uvedenou dĺžkou, odovzdaj data() aj size().

append(count, ch) pridá count kópií ch. Môžeš odovzdať aj platný rozsah vstupných iterátorov [first, last) alebo inicializačný zoznam. Tieto preťaženia append sú od C++20 constexpr. append_range(range) je samostatná členská funkcia z C++23; over, či ju tvoja štandardná knižnica podporuje.

Pripojenie môže zneplatniť ukazovatele, referencie a iterátory na prvky cieľového reťazca, a tým aj pohľady do jeho pamäte. Po zmene ich získaj znova. Prekročenie max_size() vyvolá std::length_error; zlyhať môže aj alokácia pamäte. Ak volanie append vyvolá výnimku, cieľový reťazec zostane v stave tesne pred týmto volaním.

Príklady

#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";
}

Výsledok

accepted: 8 bytes

Program overuje prítomnosť povinného `=` v hlavičke porovnaním výsledku `find` s `std::string::npos`. Potom pripojí časť pred `=`, výslovne uvedený oddeľovač `:` a tri bajty údajov. Príjemca porovná všetkých osem bajtov vrátane vnútorného `\0`. Volanie `append(payload)` bez uvedenia dĺžky by skopírovalo iba `A`.

Súvisiace lekcie

  • C++ · Lekcia 58 · Pokročilá · Verzia: 3

Zdroje