vector::insert

Inserta un elemento o varios elementos o un intervalo de elementos del vector en una posición especificada.

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
   );

Parámetros

Parámetro	Descripción
_Where	la posición en el vector donde se inserta el primer elemento.
_Val	El valor del elemento que se incrusta en el vector.
_Count	El número de elementos que están incrustados en el vector.
_First	La posición del primer elemento del intervalo de elementos que se copiarán.
_Last	La posición del primer elemento más allá del intervalo de elementos que se copiarán.

Valor devuelto

Las primeras dos funciones de insert devuelven un iterador que señale a la posición donde el nuevo elemento se ha insertado en el vector.

Comentarios

Cualquier operación de inserción puede ser muy costosa, vea clase vector para una descripción del rendimiento de vector .

Ejemplo

// vector_insert.cpp
// compile with: /EHsc
#include <vector>
#include <iostream>

int main( )
{
   using namespace std;   
   vector <int> v1;
   vector <int>::iterator Iter;
   
   v1.push_back( 10 );
   v1.push_back( 20 );
   v1.push_back( 30 );

   cout << "v1 =" ;
   for ( Iter = v1.begin( ) ; Iter != v1.end( ) ; Iter++ )
      cout << " " << *Iter;
   cout << endl;

   v1.insert( v1.begin( ) + 1, 40 );
   cout << "v1 =";
   for ( Iter = v1.begin( ) ; Iter != v1.end( ) ; Iter++ )
      cout << " " << *Iter;
   cout << endl;
   v1.insert( v1.begin( ) + 2, 4, 50 );

   cout << "v1 =";
   for ( Iter = v1.begin( ) ; Iter != v1.end( ) ; Iter++ )
      cout << " " << *Iter;
   cout << endl;

   v1.insert( v1.begin( )+1, v1.begin( )+2, v1.begin( )+4 );
   cout << "v1 =";
   for (Iter = v1.begin( ); Iter != v1.end( ); Iter++ )
      cout << " " << *Iter;
   cout << endl;

// initialize a vector of vectors by moving v1
   vector < vector <int> > vv1;

   vv1.insert( vv1.begin(), move( v1 ) );
   if ( vv1.size( ) != 0 && vv1[0].size( ) != 0 )
      {
      vector < vector <int> >::iterator Iter;
      cout << "vv1[0] =";
      for (Iter = vv1[0].begin( ); Iter != vv1[0].end( ); Iter++ )
         cout << " " << *Iter;
      cout << endl;
      }
}

Requisitos

encabezado: <vector>

espacio de nombres: std

Vea también

Referencia

vector Class

Biblioteca de plantillas estándar