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