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
- [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++