vector::insert (STL/CLR)
Agrega elementos en una posición especificada.
iterator insert(iterator where, value_type val);
void insert(iterator where, size_type count, value_type val);
template<typename InIt>
void insert(iterator where, InIt first, InIt last);
void insert(iterator where,
System::Collections::Generic::IEnumerable<Value>^ right);
Parámetros
count
Número de elementos que se va a insertar.first
Inicio del intervalo que se va a insertar.last
Final del intervalo que se va a insertar.right
Enumeración que se va a insertar.val
Valor del elemento que se va a insertar.donde
Donde en el contenedor insertar antes.
Comentarios
Cada una de las funciones miembro inserta, antes del elemento indicada por where en la secuencia controlada, una secuencia especificada por los operandos restantes.
La primera función miembro inserta un elemento con el valor val y devuelve un iterador que señala el elemento insertado recientemente.Se utiliza para insertar un único elemento antes de un lugar designado por un iterador.
La segunda función miembro inserta una repetición de los elementos de count de valor val.Se utiliza para insertar elementos cero o más contiguo que son todas las copias del mismo valor.
Si InIt es un tipo entero, la tercera función miembro se comporta igual que insert(where, (size_type)first, (value_type)last).Si no, inserte la secuencia [first,last).Se utiliza para insertar elementos cero o más contiguo copiados de otra secuencia.
La cuarta función miembro inserta la secuencia indicada por right.Se utiliza para insertar una secuencia descrita por un enumerador.
Al insertar un elemento único, el número de copias del elemento es lineal del número de elementos entre el punto de inserción y el final más próximo de la secuencia.(Al incrustar uno o más elementos en el final de la secuencia, ninguna copia del elemento aparece.) Si InIt es un iterador de entrada, la tercera función miembro realiza eficazmente una sola inserción para cada elemento de la secuencia.Si no, al insertar los elementos de N , el número de copias del elemento es lineal en N más el número de elementos entre el punto de inserción y el final más próximo de la secuencia.
Ejemplo
// cliext_vector_insert.cpp
// compile with: /clr
#include <cliext/vector>
int main()
{
cliext::vector<wchar_t> c1;
c1.push_back(L'a');
c1.push_back(L'b');
c1.push_back(L'c');
// display initial contents " a b c"
for each (wchar_t elem in c1)
System::Console::Write(" {0}", elem);
System::Console::WriteLine();
// insert a single value using iterator
cliext::vector<wchar_t>::iterator it = c1.begin();
System::Console::WriteLine("insert(begin()+1, L'x') = {0}",
*c1.insert(++it, L'x'));
for each (wchar_t elem in c1)
System::Console::Write(" {0}", elem);
System::Console::WriteLine();
// insert a repetition of values
cliext::vector<wchar_t> c2;
c2.insert(c2.begin(), 2, L'y');
for each (wchar_t elem in c2)
System::Console::Write(" {0}", elem);
System::Console::WriteLine();
// insert an iterator range
it = c1.end();
c2.insert(c2.end(), c1.begin(), --it);
for each (wchar_t elem in c2)
System::Console::Write(" {0}", elem);
System::Console::WriteLine();
// insert an enumeration
c2.insert(c2.begin(), // NOTE: cast is not needed
(System::Collections::Generic::IEnumerable<wchar_t>^)%c1);
for each (wchar_t elem in c2)
System::Console::Write(" {0}", elem);
System::Console::WriteLine();
return (0);
}
Requisitos
encabezado: <cliext/vector>
Cliext deespacio de nombres: