Partager via


vector::insert

Insère un élément, un certain nombre d'éléments ou une plage d'éléments à la position spécifiée dans le vecteur.

iterator insert(    const_iterator _Where,    const Type& _Val ); iterator insert(    const_iterator _Where,    Type&& _Val ); void insert(    const_iterator _Where,    size_type _Count,    const Type& _Val ); template<class InputIterator>    void insert(       const_iterator _Where,       InputIterator _First,       InputIterator _Last    );

Paramètres

Paramètre

Description

_Where

Position dans le vecteur où le premier élément est inséré.

_Val

Valeur de l'élément inséré dans le vecteur.

_Count

Nombre d'éléments insérés dans le vecteur.

_First

Position du premier élément de la plage d'éléments à copier.

_Last

Position du premier élément au-delà de la plage d'éléments à copier.

Valeur de retour

Les deux premières fonctions insert retournent un itérateur qui pointe vers la position où le nouvel élément a été inséré dans le vecteur.

Notes

Une opération d'insertion peut s'avérer coûteuse en ressources. Consultez la classe vector pour en savoir plus sur les performances de vector.

Exemple

// vector_insert.cpp
// compile with: /EHsc
#include <vector>
#include <iostream>
using namespace std;
int main( )
{
      
   vector <int> vec;
    vector <int>::iterator pos;

    vec.push_back(10);
    vec.push_back(20);
    vec.push_back(30);

    
    vec.insert(vec.begin() + 1, 40);
    cout << "After insert vec =";
    for (pos = vec.begin(); pos != vec.end(); ++pos)
    {
        cout << " " << *pos;
    }
        
    cout << endl;
    
}
  

Configuration requise

En-tête : <vector>

Espace de noms : std

Voir aussi

Référence

vector, classe

Bibliothèque STL (Standard Template Library)