deque : : 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.premier
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 fonction membre 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 fonction membre 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 d'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 toutes les copies de la même valeur.
Si InIt est un type entier, le troisième membre 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 fonction membre 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 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'une ou l'autre fin 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 efficacement une insertion pour chaque élément de la séquence. Autrement, quand des éléments de N 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_deque_insert.cpp
// compile with: /clr
#include <cliext/deque>
int main()
{
cliext::deque<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::deque<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::deque<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);
}
Configuration requise
En-tête : <cliext/deque>
Espace de nommage : cliext