Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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