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