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.