Namespaces
Variants

    std::back_insert_iterator

    Depuis fr.cppreference.net
     
    C++
    Support du compilateur
    Autonome et hébergé
    Langage
    Bibliothèque standard
    En-têtes de la bibliothèque standard
    Exigences nommées
    Macros de test de fonctionnalités (C++20)
    Bibliothèque de support linguistique
    Bibliothèque de concepts (C++20)
    Bibliothèque de diagnostics
    Bibliothèque de gestion de la mémoire
    Bibliothèque de métaprogrammation (C++11)
    Bibliothèque d'utilitaires généraux
    Bibliothèque de conteneurs
    Bibliothèque d'itérateurs
    Bibliothèque de plages (C++20)
    Bibliothèque d'algorithmes
    Bibliothèque de chaînes
    Bibliothèque de traitement de texte
    Bibliothèque numérique
    Bibliothèque de date et heure
    Bibliothèque d'entrée/sortie
    Bibliothèque de système de fichiers (C++17)
    Bibliothèque de support de concurrence (C++11)
    Bibliothèque de contrôle d'exécution (C++26)
    Spécifications techniques
    Index des symboles
    Bibliothèques externes
     
    Bibliothèque d'itérateurs
    Concepts d'itérateurs
    Primitives d'itérateurs
    Concepts et utilitaires d'algorithmes
    Concepts d'appel indirect
    Exigences communes des algorithmes
    (C++20)
    (C++20)
    (C++20)
    Utilitaires
    (C++20)
    Adaptateurs d'itérateurs
    Accès aux plages
    (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) se voit assigner une valeur. Incrémenter le std::back_insert_iterator n'a aucun effet.

    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)