Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::basic_string::push_back — pridanie jednej kódovej jednotky

Pridajte jednu kódovú jednotku na koniec reťazca priamo alebo cez výstupný iterátor a zachovajte nulové znaky v údajoch so známou dĺžkou.

Verzia: ISO C++23; implementation support may vary

Syntax

constexpr void push_back(CharT ch);

std::basic_string::push_back je nekonštantná členská funkcia deklarovaná v <string> a od C++20 je constexpr. Prijíma jeden CharT hodnotou (char pre std::string), pridá ho na koniec aj prázdneho reťazca, zvýši size() o jeden a vracia void. Nemá preťaženie pre reťazec ani rozsah. s.append(1, ch) a s += ch majú rovnaký účinok, ale vracajú referenciu na s. Na pridanie platného rozsahu n prvkov od p použite s.append(p, n).

Jedno volanie pridá jednu kódovú jednotku, nie nevyhnutne celý znak Unicode. Text nekóduje ani nekontroluje jeho platnosť. V std::string je pridaný '\0' súčasťou obsahu a započítava sa do size(). Líši sa od dodatočného ukončovacieho znaku na s.data()[s.size()]. Ak údaje obsahujú vnútorné nulové znaky, odovzdajte data() aj size() rozhraniu, ktoré rešpektuje dĺžku.

Pridávanie trvá amortizovane konštantný čas, ale jednotlivé volanie môže alokovať pamäť a presunúť doterajší obsah. Volanie reserve() pred sériou pridaní môže obmedziť alokácie. Zmena môže zneplatniť ukazovatele, referencie a iterátory na prvky; potom ich získajte znova, vrátane ukazovateľa z data(). Prekročenie max_size() vyvolá std::length_error; zlyhať môže aj alokácia. Ak volanie vyvolá výnimku, reťazec zostane nezmenený.

std::back_inserter(s) z <iterator> vytvorí výstupný iterátor typu std::back_insert_iterator. Priradenie ako *out++ = ch zavolá s.push_back(ch) namiesto prepísania existujúceho prvku. Adaptér odkazuje na objekt reťazca, nie na jeho vyrovnávaciu pamäť. Reťazec musí počas zápisu existovať a adaptér nezabraňuje alokáciám.

Prí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ýsledok

ID:
size: 6
embedded NUL: true

`push_back(':')` pridá oddeľovač a `std::copy` cez adaptér pridá všetky tri prvky rozsahu s explicitnou dĺžkou. Kontrola veľkosti chráni čítanie na indexe 4, ktoré potvrdí nulový znak bez jeho vypísania.

Súvisiace lekcie

  • C++ · Lekcia 46 · Pokročilá · Verzia: 3
  • C++ · Lekcia 53 · Pokročilá · Verzia: 3
  • C++ · Lekcia 58 · Pokročilá · Verzia: 3

Zdroje