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