CKTIS / C++
Připojení na konec řetězce: std::basic_string::append
Vyber přetížení `append` podle zdroje: celý řetězec, jeho část nebo buffer se známou délkou. Přidávej oddělovače výslovně a zachovej nulové znaky uvnitř dat.
Verze: ISO C++23; implementation support may vary
Syntaxe
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> přidává prvky CharT na konec existujícího řetězce (std::string je specializace pro char). Vrací *this referencí, takže volání lze řetězit. Na rozdíl od assign nenahrazuje stávající obsah a nevkládá oddělovače automaticky. Pro jeden znak použij push_back(ch) nebo += ch; push_back vrací void.
append(str) zkopíruje celý řetězec. append(str, pos, count) kopíruje od indexu pos ve zdroji nejvýše count prvků a zastaví se na konci zdroje. Vynech count nebo předej npos, chceš-li kopírovat až do konce. Ve zdroji znamená pos == size() prázdnou část, zatímco pos > size() vyvolá std::out_of_range. Přetížení pro typy převoditelné na pohled na řetězec, dostupná od C++17, fungují stejně. V C++23 se při výběru přetížení obě zvažují jen tehdy, když lze const T& implicitně převést na std::basic_string_view<CharT, Traits>. Pouze přetížení pro celý zdroj navíc vyžaduje, aby const T& nebylo možné implicitně převést na const CharT*.
append(p) vyžaduje platnou sekvenci zakončenou nulovým znakem a kopíruje po první nulu, kterou nezahrnuje. append(p, count) kopíruje přesně count prvků včetně nul uvnitř dat. Počet neomezuje podle délky bufferu: porovnej jej se skutečnou velikostí bufferu, protože neplatný rozsah vede k nedefinovanému chování. Příjemci, který přijímá data s výslovně uvedenou délkou, předej data() i size().
append(count, ch) přidá count kopií ch. Můžeš předat také platný rozsah vstupních iterátorů [first, last) nebo inicializační seznam. Tato přetížení append jsou od C++20 constexpr. append_range(range) je samostatná členská funkce z C++23; ověř, zda ji tvoje standardní knihovna podporuje.
Připojení může zneplatnit ukazatele, reference a iterátory na prvky cílového řetězce, a tím i pohledy do jeho paměti. Po změně si je vyžádej znovu. Překročení max_size() vyvolá std::length_error; selhat může i alokace paměti. Pokud volání append vyvolá výjimku, cílový řetězec zůstane ve stavu těsně před tímto voláním.
Pří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ýsledek
accepted: 8 bytes
Program hledá povinný znak `=` v hlavičce porovnáním výsledku `find` s `std::string::npos`. Poté připojí část před `=`, výslovně uvedený oddělovač `:` a tři bajty dat. Příjemce porovná všech osm bajtů včetně vnitřního `\0`. Volání `append(payload)` bez uvedení délky by zkopírovalo jen `A`.
Související lekce
- C++ · Lekce 58 · Pokročilá · Verze: 3