Partager via


forward_list::insert_after

Ajoute des éléments à la liste en avant après un emplacement spécifié.

iterator insert_after(
    const_iterator Where, 
     const Type& Val);
void insert_after(
     const_iterator Where, 
     size_type Count, 
    const Type& Val);
void insert_after(
    const iterator Where,
    initializer_list<Type> IList
);
iterator insert_after(
    const_iterator Where, 
    Type&& Val
);
template<class InputIterator>
    void insert_after(
        const_iterator Where, 
        InputIterator First,
        InputIterator Last
    );

Paramètres

Paramètre

Description

Where

La position, dans la forward list cible, où l'élément est inséré.

Count

Nombre d'éléments à insérer.

First

Début de la plage d'insertion.

Last

Valeur de fin de la plage d'insertion.

Val

L'élément ajouté à la forward_list.

IList

L'initializer_list à insérer.

Valeur de retour

Un itérateur qui indique que l'élément récemment inséré (première et la dernière fonctions membres uniquement).

Notes

Chaque fonction membre insert - juste après l'élément pointé par Where dans la séquence controléz - une séquence qui est spécifiée par les opérandes restantes.

La première fonction membre insère un élément qui a la valeur Val et retourne un itérateur qui indique l'élément récemment inséré.

La deuxième fonction membre insère une répétition des éléments Count de la valeur Val.

Si InputIterator est un type entier, la troisième fonction membre se comporte de la même manière que insert(it, (size_type)First, (Type)Last). Sinon, il insère la séquence [First, Last), qui ne doit pas superposer la séquence initiale controlée.

La quatrième fonction membre insère la séquence qui est spécifiée par un objet de classe initializer_list<Type>.

La dernière fonction membre est identique à la première, mais avec une référence rvalue.

Insertion des appels de constructeur N de causes d'éléments N. Redistribution se produit, mais aucun itérateur ou ref n'est valide.

Si une exception est levée pendant l'insertion d'un ou plusieurs éléments, le conteneur reste inchangé et l'exception est à nouveau levée.

Configuration requise

En-tête : <forward_list>

Espace de noms : std

Voir aussi

Référence

forward_list, classe