KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen