CKTIS / C++
std::back_insert_iterator — dodavanje pomoću izlaznog iteratora
std::back_insert_iterator je prilagodnik izlaznog iteratora koji dodjelu vrijednosti pretvara u poziv push_back spremnika. Omogućuje dodavanje elemenata zapisom *out++ = value bez prepisivanja postojećih elemenata.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <iterator>
std::back_insert_iterator<Container> out(container);
*out++ = value;
// Equivalent factory:
auto out2 = std::back_inserter(container);std::back_insert_iterator<Container> iz zaglavlja <iterator> prilagodnik je izlaznog iteratora. Njegov konstruktor prima Container& i pohranjuje adresu spremnika; prilagodnik ga ne posjeduje. Spremnik mora ostati valjan dok se prilagodnik upotrebljava i pružati odgovarajuću operaciju push_back.
Dodjela vrijednosti putem prilagodnika dodaje element: preopterećenje za const Container::value_type& poziva push_back(value), dok preopterećenje za Container::value_type&& poziva push_back(std::move(value)). operator* vraća sam prilagodnik, a ne referencu na element. Operatori ++ ne pomiču položaj niti dodaju elemente; zato *out++ = value dodaje točno jedan element.
Ovaj je alat namijenjen pisanju, a ne čitanju ili prolasku kroz elemente. Dodaje nove elemente umjesto da prepisuje postojeće. Funkcija std::back_inserter(container) stvara istu vrstu prilagodnika bez potrebe za izričitim navođenjem tipa spremnika.
U primjeru spremnik isprva sadrži 10, a dvije dodjele dodaju 20 i 30. Kod je namijenjen lokalnom prevođenju uz -std=c++23. Citirane stranice prikazuju radni nacrt koji se razvija, a ne nepromjenjivo izdanje C++23.
Primjeri
#include <cstddef>
#include <iostream>
#include <iterator>
#include <vector>
int main() {
std::vector<int> values{10};
std::back_insert_iterator<std::vector<int>> out(values);
*out++ = 20;
*out++ = 30;
for (std::size_t i = 0; i < values.size(); ++i) {
if (i != 0) {
std::cout << ' ';
}
std::cout << values[i];
}
std::cout << '\n';
}
Rezultat
10 20 30
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.