Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::basic_string::push_back — dodavanje jedne kodne jedinice

Dodajte jednu kodnu jedinicu na kraj znakovnog niza, izravno ili preko izlaznog iteratora, i sačuvajte nul-znakove u podacima poznate duljine.

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

Sintaksa

constexpr void push_back(CharT ch);

std::basic_string::push_back nekonstantna je funkcija članica deklarirana u <string> i od C++20 ima oznaku constexpr. Prima jedan CharT po vrijednosti (char za std::string), dodaje ga na kraj čak i praznog niza, povećava size() za jedan i vraća void. Nema preopterećenja za niz ili raspon. s.append(1, ch) i s += ch imaju isti učinak, ali vraćaju referencu na s. Za dodavanje valjanog raspona od n elemenata počevši od p upotrijebite s.append(p, n).

Jedan poziv dodaje jednu kodnu jedinicu, ne nužno cijeli znak Unicode, i ne kodira niti provjerava tekst. U std::string dodani '\0' dio je sadržaja i uračunava se u size(). Razlikuje se od dodatnog završnog znaka na s.data()[s.size()]. Za podatke s nul-znakovima u sadržaju proslijedite data() i size() sučelju koje poštuje duljinu.

Dodavanje traje amortizirano konstantno vrijeme, ali pojedini poziv može dodijeliti memoriju i premjestiti postojeći sadržaj. Poziv reserve() prije niza dodavanja može smanjiti broj dodjela memorije. Izmjena može poništiti valjanost pokazivača, referenci i iteratora na elemente; nakon nje ponovno ih dohvatite, uključujući pokazivač iz data(). Prekoračenje max_size() izaziva std::length_error, a može zakazati i dodjela memorije. Ako poziv baci iznimku, niz ostaje nepromijenjen.

std::back_inserter(s) iz <iterator> stvara izlazni iterator tipa std::back_insert_iterator. Pridruživanje poput *out++ = ch poziva s.push_back(ch) umjesto da prepiše postojeći element. Prilagodnik upućuje na objekt niza, a ne na njegov međuspremnik. Niz mora postojati dok se preko njega piše, a prilagodnik ne sprječava dodjelu memorije.

Primjeri

#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(':')` dodaje razdjelnik, a `std::copy` preko prilagodnika dodaje sva tri elementa raspona s izričito zadanom duljinom. Provjera veličine štiti čitanje na indeksu 4, koje potvrđuje nul-znak bez njegova ispisa.

Povezane lekcije

  • C++ · Lekcija 46 · Napredno · Verzija: 3
  • C++ · Lekcija 53 · Napredno · Verzija: 3
  • C++ · Lekcija 58 · Napredno · Verzija: 3

Izvori