Namespaces
Variants

std:: back_insert_iterator

From cppreference.net
C++
Iterator library
Iterator concepts
Iterator primitives
Algorithm concepts and utilities
Indirect callable concepts
Common algorithm requirements
(C++20)
(C++20)
(C++20)
Utilities
(C++20)
Iterator adaptors
Range access
(C++11) (C++14)
(C++14) (C++14)
(C++11) (C++14)
(C++14) (C++14)
(C++17) (C++20)
(C++17)
(C++17)
std::back_insert_iterator
Défini dans l'en-tête <iterator>
template < class Container >

class back_insert_iterator

: public std:: iterator < std:: output_iterator_tag , void , void , void , void >
(jusqu'à C++17)
template < class Container >
class back_insert_iterator ;
(depuis C++17)

std::back_insert_iterator est un LegacyOutputIterator qui ajoute des éléments à un conteneur pour lequel il a été construit. La fonction membre push_back() du conteneur est appelée chaque fois que l'itérateur (qu'il soit déréférencé ou non) est assigné. L'incrémentation du std::back_insert_iterator est une opération sans effet.

Table des matières

Types membres

Type de membre Définition
iterator_category std:: output_iterator_tag
value_type void
difference_type

void

(jusqu'en C++20)

std::ptrdiff_t

(depuis C++20)
pointer void
reference void
container_type Container

Les types membres iterator_category , value_type , difference_type , pointer et reference doivent être obtenus en héritant de std:: iterator < std:: output_iterator_tag , void , void , void , void > .

(jusqu'à C++17)

Fonctions membres

construit un nouveau back_insert_iterator
(fonction membre publique)
insère un objet dans le conteneur associé
(fonction membre publique)
opération nulle
(fonction membre publique)
opération nulle
(fonction membre publique)

Objets membres

Nom du membre Définition
container (protégé) un pointeur de type Container*

Exemple

Exécuter ce code 
#include <algorithm>
#include <iostream>
#include <iterator>
#include <vector>
int main()
{
    std::vector<int> v;
    std::generate_n(
        std::back_insert_iterator<std::vector<int>>(v),
            // Ou utiliser l'assistant std::back_inserter
            // Ou utiliser la syntaxe C++17 std::back_insert_iterator(v)
        10,
        [n = 0]() mutable { return ++n; }
    );
    for (int n : v)
        std::cout << n << ' ';
    std::cout << '\n';
}

Sortie : 

1 2 3 4 5 6 7 8 9 10

Voir aussi

crée un std::back_insert_iterator dont le type est déduit de l'argument
(modèle de fonction)
adaptateur d'itérateur pour l'insertion au début d'un conteneur
(modèle de classe)
adaptateur d'itérateur pour l'insertion dans un conteneur
(modèle de classe)