CKTIS / C++
std::back_insert_iterator — dodajanje z izhodnim iteratorjem
std::back_insert_iterator je prilagodilnik izhodnega iteratorja, ki prirejanje vrednosti pretvori v klic push_back vsebnika. Omogoča dodajanje elementov z zapisom *out++ = value, ne da bi prepisali obstoječe elemente.
Različica: 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 glave <iterator> je prilagodilnik izhodnega iteratorja. Njegov konstruktor sprejme Container& in shrani naslov vsebnika; prilagodilnik ga ne poseduje. Vsebnik mora ostati veljaven ves čas uporabe prilagodilnika in zagotavljati ustrezno operacijo push_back.
Prirejanje vrednosti prek prilagodilnika doda element: različica operatorja prirejanja, ki sprejme const Container::value_type&, pokliče push_back(value), različica, ki sprejme Container::value_type&&, pa pokliče push_back(std::move(value)). operator* vrne sam prilagodilnik, ne reference na element. Operatorji ++ ne premaknejo položaja in ne dodajo elementov; zato *out++ = value doda natanko en element.
To orodje je namenjeno pisanju, ne branju ali pregledovanju elementov. Dodaja nove elemente, namesto da bi prepisovalo obstoječe. Funkcija std::back_inserter(container) ustvari enako vrsto prilagodilnika, ne da bi bilo treba izrecno navesti tip vsebnika.
V primeru vsebnik sprva vsebuje 10, dve prirejanji pa dodata 20 in 30. Koda je namenjena lokalnemu prevajanju z -std=c++23. Navedene strani predstavljajo sproti razvijani delovni osnutek, ne nespremenjene izdaje C++23.
Primeri
#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
Prikazana koda, ki vključuje `#include <cstddef>`, in navedeni izpis sta bila preverjena v izoliranem okolju po metodi, zapisani v dokazilu o preverjanju te različice.