CKTIS / C++
std::back_insert_iterator — toevoegen via een uitvoeriterator
std::back_insert_iterator is een uitvoeriterator-adapter die een waardetoewijzing omzet in een aanroep van push_back op de container. Zo kun je elementen toevoegen met *out++ = value zonder bestaande elementen te overschrijven.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <iterator>
std::back_insert_iterator<Container> out(container);
*out++ = value;
// Equivalent factory:
auto out2 = std::back_inserter(container);std::back_insert_iterator<Container>, gedeclareerd in <iterator>, is een uitvoeriterator-adapter. De constructor neemt Container& aan en bewaart het adres van de container; de adapter is er geen eigenaar van. De container moet geldig blijven zolang de adapter wordt gebruikt en de juiste push_back-bewerking aanbieden.
Een waarde toewijzen via de adapter voegt een element toe: de overload voor const Container::value_type& roept push_back(value) aan, terwijl de overload voor Container::value_type&& push_back(std::move(value)) aanroept. operator* geeft de adapter zelf terug, geen verwijzing naar een element. De ++-operatoren verplaatsen geen positie en voegen geen elementen toe; daarom voegt *out++ = value precies één element toe.
Dit hulpmiddel is bedoeld om te schrijven, niet om elementen te lezen of te doorlopen. Het voegt nieuwe elementen toe in plaats van bestaande te overschrijven. De functie std::back_inserter(container) maakt hetzelfde type adapter zonder dat je het containertype expliciet hoeft te noemen.
In het voorbeeld bevat de container aanvankelijk 10, en voegen twee toewijzingen 20 en 30 toe. De code is bedoeld om lokaal te compileren met -std=c++23. De geciteerde pagina’s tonen het voortdurend bijgewerkte working draft, niet een bevroren publicatie van C++23.
Voorbeelden
#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';
}
Resultaat
10 20 30
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.