CKTIS / C++
std::basic_string::push_back — přidání jedné kódové jednotky
Přidejte jednu kódovou jednotku na konec řetězce přímo nebo přes výstupní iterátor a zachovejte nulové znaky v datech se známou délkou.
Verze: ISO C++23; implementation support may vary
Syntaxe
constexpr void push_back(CharT ch);std::basic_string::push_back je nekonstantní členská funkce deklarovaná v <string> a od C++20 je constexpr. Přijímá jeden CharT hodnotou (char pro std::string), přidá ho na konec i prázdného řetězce, zvýší size() o jedna a vrací void. Nemá přetížení pro řetězec ani rozsah. s.append(1, ch) a s += ch mají stejný účinek, ale vracejí referenci na s. Pro přidání platného rozsahu n prvků od p použijte s.append(p, n).
Jedno volání přidá jednu kódovou jednotku, ne nutně celý znak Unicode. Text nekóduje ani nekontroluje jeho platnost. V std::string je přidaný '\0' součástí obsahu a započítává se do size(). Liší se od dodatečného ukončovacího znaku na s.data()[s.size()]. Pokud data obsahují vnitřní nulové znaky, předejte data() i size() rozhraní, které délku respektuje.
Přidání trvá amortizovaně konstantní čas, ale jedno volání může alokovat paměť a přesunout dosavadní obsah. Volání reserve() před řadou přidání může omezit alokace. Změna může zneplatnit ukazatele, reference a iterátory na prvky; potom je získejte znovu, včetně ukazatele z data(). Překročení max_size() vyvolá std::length_error; selhat může i alokace. Pokud volání vyvolá výjimku, řetězec zůstane beze změny.
std::back_inserter(s) z <iterator> vytvoří výstupní iterátor typu std::back_insert_iterator. Přiřazení jako *out++ = ch zavolá s.push_back(ch), místo aby přepsalo existující prvek. Adaptér odkazuje na objekt řetězce, ne na jeho vyrovnávací paměť. Řetězec musí během zápisu existovat a adaptér nezabraňuje alokacím.
Příklady
#include <algorithm>
#include <iostream>
#include <iterator>
#include <string>
#include <string_view>
int main() {
constexpr std::string_view payload{"4\0" "2", 3};
std::string record{"ID"};
record.push_back(':');
std::copy(payload.begin(), payload.end(), std::back_inserter(record));
const bool has_embedded_nul = record.size() == 6 && record.data()[4] == '\0';
std::cout << record.substr(0, 3) << '\n'
<< "size: " << static_cast<unsigned long long>(record.size()) << '\n'
<< "embedded NUL: " << std::boolalpha << has_embedded_nul << '\n';
}
Výsledek
ID: size: 6 embedded NUL: true
`push_back(':')` přidá oddělovač a `std::copy` pomocí adaptéru přidá všechny tři prvky rozsahu s explicitní délkou. Kontrola velikosti chrání čtení na indexu 4, které ověří nulový znak, aniž by ho vypsalo.
Související lekce
- C++ · Lekce 46 · Pokročilá · Verze: 3
- C++ · Lekce 53 · Pokročilá · Verze: 3
- C++ · Lekce 58 · Pokročilá · Verze: 3
Zdroje
- [string.append] — basic_string::append and push_back
- [string.op.append] — basic_string::operator+=
- [string.require] — basic_string general requirements
- [basic.string.general] — basic_string storage and terminator
- [string.capacity] — basic_string size, capacity and reserve
- [back.insert.iterator] — back_insert_iterator and back_inserter
- std::basic_string<CharT,Traits,Allocator>::push_back — cppreference
- N4950 — Working Draft, Standard for Programming Language C++