Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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