Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::back_insert_iterator — aggiungere tramite un iteratore di output

std::back_insert_iterator è un adattatore di iteratore di output che trasforma l’assegnazione di un valore in una chiamata a push_back sul contenitore. Consente di aggiungere elementi con *out++ = value senza sovrascrivere quelli esistenti.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

#include <iterator>
std::back_insert_iterator<Container> out(container);
*out++ = value;
// Equivalent factory:
auto out2 = std::back_inserter(container);

std::back_insert_iterator<Container>, dichiarato in <iterator>, è un adattatore di iteratore di output. Il suo costruttore accetta Container& e memorizza l’indirizzo del contenitore; l’adattatore non ne è proprietario. Il contenitore deve rimanere valido durante l’uso dell’adattatore e fornire l’operazione push_back appropriata.

L’assegnazione di un valore tramite l’adattatore aggiunge un elemento: l’overload per const Container::value_type& chiama push_back(value), mentre quello per Container::value_type&& chiama push_back(std::move(value)). operator* restituisce l’adattatore stesso, non un riferimento a un elemento. Gli operatori ++ non avanzano alcuna posizione né aggiungono elementi; di conseguenza, *out++ = value aggiunge esattamente un elemento.

Questo strumento serve per scrivere, non per leggere o scorrere gli elementi. Aggiunge nuovi elementi invece di sovrascrivere quelli esistenti. La funzione std::back_inserter(container) crea lo stesso tipo di adattatore senza dover specificare esplicitamente il tipo del contenitore.

Nell’esempio, il contenitore contiene inizialmente 10 e due assegnazioni aggiungono 20 e 30. Il codice è pensato per la compilazione locale con -std=c++23. Le pagine citate presentano il working draft in evoluzione, non una pubblicazione C++23 immutabile.

Esempi

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

Risultato

10 20 30

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti