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