CKTIS / C++
std::back_insert_iterator — přidávání pomocí výstupního iterátoru
std::back_insert_iterator je adaptér výstupního iterátoru, který přiřazení hodnoty převádí na volání push_back kontejneru. Umožňuje přidávat prvky zápisem *out++ = value, aniž by se přepisovaly stávající prvky.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <iterator>
std::back_insert_iterator<Container> out(container);
*out++ = value;
// Equivalent factory:
auto out2 = std::back_inserter(container);std::back_insert_iterator<Container> z hlavičky <iterator> je adaptér výstupního iterátoru. Jeho konstruktor přijímá Container& a ukládá adresu kontejneru; adaptér kontejner nevlastní. Kontejner musí zůstat po dobu používání adaptéru platný a poskytovat odpovídající operaci push_back.
Přiřazení hodnoty prostřednictvím adaptéru přidá prvek: přetížení pro const Container::value_type& volá push_back(value), zatímco přetížení pro Container::value_type&& volá push_back(std::move(value)). operator* vrací samotný adaptér, nikoli referenci na prvek. Operátory ++ neposouvají žádnou pozici ani nepřidávají prvky; výraz *out++ = value proto přidá přesně jeden prvek.
Tento nástroj slouží k zápisu, nikoli ke čtení nebo procházení prvků. Přidává nové prvky namísto přepisování stávajících. Funkce std::back_inserter(container) vytvoří stejný typ adaptéru, aniž by bylo nutné výslovně uvést typ kontejneru.
V příkladu kontejner zpočátku obsahuje 10 a dvě přiřazení přidají 20 a 30. Kód je určen k místnímu překladu s -std=c++23. Citované stránky představují průběžně se vyvíjející pracovní návrh, nikoli neměnné vydání C++23.
Příklady
#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';
}
Výsledek
10 20 30
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.