list::insert (STL/CLR)
Aggiunge elementi a una posizione specificata.
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);
Parametri
Conteggio
Numero di elementi da inserire.innanzitutto
A partire dall'intervallo da inserire.last
Estremità di intervallo da inserire.right
Enumerazione da inserire.val
Valore dell'elemento da inserire.where
La posizione del contenitore inserire prima.
Note
Ognuna delle funzioni membro di inserimento, prima dell'elemento fa riferimento da where nella sequenza selezionata, una sequenza specificata dagli operandi rimanenti.
La prima funzione membro inserire un elemento con valore val e restituisce un iteratore che definisce l'elemento appena inserito.La si utilizza per inserire un singolo elemento prima di un percorso definito da un iteratore.
La seconda funzione membro inserire una ripetizione degli elementi di count di valore val.La si utilizza per inserire elementi zero o più adiacenti presenti tutte le copie dello stesso valore.
Se InIt è un tipo integer, la terza funzione membro si comporta lo stesso di insert(where, (size_type)first, (value_type)last).In caso contrario, inserire la sequenza [first,last).La si utilizza per inserire elementi zero o più contigui copiati da un'altra sequenza.
La quarta funzione membro inserire la sequenza definita da right.La si utilizza per inserire una sequenza descritta da un enumeratore.
Quando si inseriscono un singolo elemento, il numero di copie dell'elemento è lineare al numero di elementi tra il punto di inserimento e la fine più vicina della sequenza.(Quando si inserisce uno o più elementi alla fine della sequenza, alcuna copia dell'elemento si verifica.) Se InIt è un iteratore di input, la terza funzione membro effettivamente esegue un singolo inserimento per ogni elemento della sequenza.In caso contrario quando si inserisce gli elementi di N , il numero di copie dell'elemento è lineare in N più il numero di elementi tra il punto di inserimento e la fine più vicina della sequenza.
Esempio
// cliext_list_insert.cpp
// compile with: /clr
#include <cliext/list>
int main()
{
cliext::list<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::list<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::list<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();
// insert a single value using index
it = c2.begin();
++it, ++it, ++it;
c2.insert(it, L'z');
for each (wchar_t elem in c2)
System::Console::Write(" {0}", elem);
System::Console::WriteLine();
return (0);
}
Requisiti
intestazione: <cliext/elenco>
Cliext diSpazio dei nomi: