liste : : insertion (STL/CLR)
Ajoute les éléments à une position spécifiée.
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);
Paramètres
count
Nombre d'éléments à insérer.first
Début de la plage à insérer.last
Fin de la plage à insérer.right
Énumération à insérer.val
Valeur de l'élément à insérer.where
Où insérer avant dans le conteneur.
Notes
Chaque méthode insère, avant l'élément pointé par where dans la séquence contrôlée, une séquence qui est spécifiée par les opérandes restantes.
La première méthode insère un élément qui a la valeur val et retourne un itérateur qui indique l'élément récemment inséré. Vous l'utilisez pour insérer un élément avant une position indiquée par un itérateur.
La deuxième fonction membre insère une répétition des éléments count de la valeur val. Vous l'utilisez pour insérer des zéro ou plusieurs éléments contigus qui sont tous des copies de la même valeur.
Si InIt est un type entier, la troisième méthode se comporte de la même manière que insert(where, (size_type)first, (value_type)last). Sinon, il insère la séquence [first, last). Vous l'utilisez pour insérer zéro ou plusieurs éléments contigus copiés à partir d'une autre séquence.
La quatrième méthode insère la séquence indiquée par right. Vous l'utilisez pour insérer une séquence décrite par un énumérateur.
En insérant un élément unique, le nombre de copies d'éléments est linéaire par rapport au nombre d'éléments entre le point d'insertion et la fin plus proche de la séquence. (En insérant un ou plusieurs éléments à l'un ou l'autre bout de la séquence, la copie d'élément n'a pas lieu.) Si InIt est un itérateur d'entrée, la troisième fonction membre exécute effectivement une insertion pour chaque élément de la séquence. Autrement, quand N éléments sont insérés, le nombre de copies d'éléments est linéaire par rapport à N ainsi qu'aux nombre d'éléments entre le point d'insertion et la fin la plus proche de la séquence.
Exemple
// 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);
}
Configuration requise
En-tête : <cliext/list>
Espace de noms : cliext