list::erase (STL/CLR)
Supprime les éléments placés aux positions spécifiées.
iterator erase(iterator where);
iterator erase(iterator first, iterator last);
Paramètres
tout d'abord
Début de la plage à effacer.last
Fin de la plage à effacer.where
Élément à effacer.
Notes
La première fonction membre supprime l'élément de la séquence contrôlée désignée par where.Vous l'utilisez pour supprimer un seul élément.
La deuxième fonction membre supprime les éléments de la séquence contrôlée dans la plage [first,last).Vous l'utilisez pour supprimer des éléments zéro ou plus contigus.
Les deux fonctions membres retournent un itérateur qui indique le premier élément restant au delà de tous les éléments supprimés, ou list::end (STL/CLR)() s'il n'existe aucun élément.
En effaçant les éléments, le nombre de copies d'élément est linéaire dans le nombre d'éléments entre la fin de l'effacement et la fin plus proche de la séquence.(En effaçant un ou plusieurs éléments à chaque extrémité de la séquence, copie d'élément ne se produit pas.)
Exemple
// cliext_list_erase.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();
// erase an element and reinspect
System::Console::WriteLine("erase(begin()) = {0}",
*c1.erase(c1.begin()));
// add elements and display " b c d e"
c1.push_back(L'd');
c1.push_back(L'e');
for each (wchar_t elem in c1)
System::Console::Write(" {0}", elem);
System::Console::WriteLine();
// erase all but end
cliext::list<wchar_t>::iterator it = c1.end();
System::Console::WriteLine("erase(begin(), end()-1) = {0}",
*c1.erase(c1.begin(), --it));
System::Console::WriteLine("size() = {0}", c1.size());
return (0);
}
Configuration requise
en-tête :<cliext/liste>
Cliext del'espace de noms :