WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::back_insert_iterator — Anhängen über einen Ausgabeiterator

std::back_insert_iterator ist ein Ausgabeiterator-Adapter, der eine Wertzuweisung in einen Aufruf von push_back für den Container umsetzt. Damit lassen sich Elemente mit *out++ = value anhängen, ohne vorhandene Elemente zu überschreiben.

Version: 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> aus dem Header <iterator> ist ein Ausgabeiterator-Adapter. Sein Konstruktor nimmt Container& entgegen und speichert die Adresse des Containers; der Adapter besitzt ihn nicht. Der Container muss während der Verwendung des Adapters gültig bleiben und die passende push_back-Operation bereitstellen.

Eine Wertzuweisung über den Adapter hängt ein Element an: Die Überladung für const Container::value_type& ruft push_back(value) auf, während die Überladung für Container::value_type&& push_back(std::move(value)) aufruft. operator* gibt den Adapter selbst zurück, keine Elementreferenz. Die ++-Operatoren verschieben weder eine Position noch fügen sie Elemente hinzu; daher hängt *out++ = value genau ein Element an.

Dieses Werkzeug dient zum Schreiben, nicht zum Lesen oder Durchlaufen von Elementen. Es hängt neue Elemente an, statt vorhandene zu überschreiben. Die Funktion std::back_inserter(container) erstellt denselben Adaptertyp, ohne dass der Containertyp ausdrücklich angegeben werden muss.

Im Beispiel enthält der Container anfangs 10; zwei Zuweisungen hängen 20 und 30 an. Der Code ist für die lokale Kompilierung mit -std=c++23 vorgesehen. Die zitierten Seiten stellen den fortlaufend weiterentwickelten Arbeitsentwurf dar, keine eingefrorene Veröffentlichung von C++23.

Beispiele

#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';
}

Ergebnis

10 20 30

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen