CKTIS / C++
std::basic_string::push_back — dodajanje ene kodne enote
Na konec niza dodajte eno kodno enoto neposredno ali prek izhodnega iteratorja in ohranite ničelne znake v podatkih z znano dolžino.
Različica: ISO C++23; implementation support may vary
Sintaksa
constexpr void push_back(CharT ch);std::basic_string::push_back je nekonstantna članska funkcija, deklarirana v <string>, in je od C++20 constexpr. Sprejme en CharT po vrednosti (char za std::string), ga doda na konec tudi pri praznem nizu, poveča size() za ena in vrne void. Nima preobremenitve za niz ali obseg. s.append(1, ch) in s += ch imata enak učinek, vendar vrneta referenco na s. Za dodajanje veljavnega obsega n elementov od p uporabite s.append(p, n).
En klic doda eno kodno enoto, ne nujno celotnega znaka Unicode, in besedila ne kodira ali preverja. V std::string je dodani '\0' del vsebine in šteje v size(). Ni isto kot dodatni zaključni znak na s.data()[s.size()]. Pri podatkih z vključenimi ničelnimi znaki posredujte data() in size() vmesniku, ki upošteva dolžino.
Dodajanje ima amortizirano konstantno časovno zahtevnost, vendar lahko posamezen klic dodeli pomnilnik in premakne obstoječo vsebino. Klic reserve() pred nizom dodajanj lahko zmanjša število dodelitev. Sprememba lahko razveljavi kazalce, reference in iteratorje do elementov; po njej jih znova pridobite, tudi kazalec iz data(). Prekoračitev max_size() sproži std::length_error; spodleti lahko tudi dodelitev pomnilnika. Če klic sproži izjemo, niz ostane nespremenjen.
std::back_inserter(s) iz <iterator> ustvari izhodni iterator tipa std::back_insert_iterator. Prireditev, kot je *out++ = ch, pokliče s.push_back(ch), namesto da bi prepisala obstoječi element. Vmesnik iteratorja se sklicuje na objekt niza, ne na njegov pomnilniški medpomnilnik. Niz mora med pisanjem obstajati, ta vmesnik pa ne preprečuje dodeljevanja pomnilnika.
Primeri
#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';
}
Rezultat
ID: size: 6 embedded NUL: true
`push_back(':')` doda ločilo, nato `std::copy` prek izhodnega iteratorja doda vse tri elemente obsega z izrecno dolžino. Preverjanje velikosti varuje branje na indeksu 4, ki potrdi ničelni znak, ne da bi ga izpisalo.
Povezane lekcije
- C++ · Lekcija 46 · Napredna · Različica: 3
- C++ · Lekcija 53 · Napredna · Različica: 3
- C++ · Lekcija 58 · Napredna · Različica: 3
Viri
- [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++