vector::insert
Insere um elemento ou um número de elementos ou um intervalo de elementos no vetor em uma posição 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 |
Descrição |
_Where |
A posição no vetor onde o primeiro elemento é inserido. |
_Val |
O valor do elemento que está sendo inserido no vetor. |
_Count |
O número de elementos que estão sendo inseridos no vetor. |
_First |
A posição do primeiro elemento no intervalo de elementos ser copiado. |
_Last |
A posição do primeiro elemento além do intervalo de elementos ser copiado. |
Valor de retorno
As duas primeiras funções de insert retornam um iterador que aponta para a posição onde o novo elemento foi inserido no vetor.
Comentários
Qualquer operação de inserção pode ser cara, consulte classe vetorial para uma discussão de desempenho de vector .
Exemplo
// 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
Cabeçalho: <vector>
namespace: STD