list (STL/CLR)

Article
06/07/2013

La classe de modèle décrit un objet qui contrôle une séquence de la longueur variée d'éléments qui a accès bidirectionnel.Vous utilisez le conteneur list pour gérer une séquence d'éléments en tant liste liée bidirectionnelle de nœuds, chaque un élément d'inscription.

Dans la description ci-après, GValue est identique qu' Value à moins que ce dernier soit un type référence, auquel cas c'est Value^.

template<typename Value>
    ref class list
        :   public
        System::ICloneable,
        System::Collections::IEnumerable,
        System::Collections::ICollection,
        System::Collections::Generic::IEnumerable<GValue>,
        System::Collections::Generic::ICollection<GValue>,
        Microsoft::VisualC::StlClr::IList<GValue>
    { ..... };

Paramètres

Valeur
Le type d'un élément de la séquence contrôlée.

Membres

Définition de type	Description
list::const_iterator (STL/CLR)	Le type d'un itérateur constante pour la séquence contrôlée.
list::const_reference (STL/CLR)	Le type d'une référence à une constante à un élément.
list::const_reverse_iterator (STL/CLR)	Le type d'un itérateur inverse constante pour la séquence contrôlée.
list::difference_type (STL/CLR)	Le type d'une distance signée entre deux éléments.
list::generic_container (STL/CLR)	Le type de l'interface générique pour le conteneur.
list::generic_iterator (STL/CLR)	Le type d'un itérateur pour l'interface générique pour le conteneur.
list::generic_reverse_iterator (STL/CLR)	Le type d'un itérateur inverse pour l'interface générique pour le conteneur.
list::generic_value (STL/CLR)	Le type d'un élément de l'interface générique pour le conteneur.
list::iterator (STL/CLR)	Le type d'un itérateur pour la séquence contrôlée.
list::reference (STL/CLR)	Le type d'une référence à un élément.
list::reverse_iterator (STL/CLR)	Le type d'un itérateur inverse pour la séquence contrôlée.
list::size_type (STL/CLR)	Le type d'une distance signée entre deux éléments.
list::value_type (STL/CLR)	Le type d'un élément.

Fonction membre	Description
list::assign (STL/CLR)	Remplace tous les éléments.
list::back (STL/CLR)	Accède au dernier élément.
list::begin (STL/CLR)	Indique le début de la séquence contrôlée.
list::clear (STL/CLR)	Supprime tous les éléments.
list::empty (STL/CLR)	Teste si aucun élément n'est présent.
list::end (STL/CLR)	Indique la fin de la séquence contrôlée.
list::erase (STL/CLR)	Supprime des éléments aux positions spécifiées.
list::front (STL/CLR)	Accède au premier élément.
list::insert (STL/CLR)	Ajoute des éléments à une position spécifiée.
list::list (STL/CLR)	Construit un objet.
list::merge (STL/CLR)	Fusionne deux séquences contrôlées classées.
list::pop_back (STL/CLR)	Supprime le dernier élément.
list::pop_front (STL/CLR)	Supprime le premier élément.
list::push_back (STL/CLR)	Ajoute un nouveau dernier élément.
list::push_front (STL/CLR)	Ajoute un nouvel premier élément.
list::rbegin (STL/CLR)	Indique le début de la séquence contrôlée inversée.
list::remove (STL/CLR)	Supprime un élément avec une valeur spécifiée.
list::remove_if (STL/CLR)	Supprime les éléments qui passent un test spécifié.
list::rend (STL/CLR)	Indique la fin de la séquence contrôlée inversée.
list::resize (STL/CLR)	Modifie le nombre d'éléments.
list::reverse (STL/CLR)	Permute la séquence contrôlée.
list::size (STL/CLR)	Comptabilise le nombre d'éléments.
list::sort (STL/CLR)	Classe la séquence contrôlée.
list::splice (STL/CLR)	Liens de Restitches entre les nœuds.
list::swap (STL/CLR)	Permute le contenu de deux conteneurs.
list::to_array (STL/CLR)	Copie la séquence contrôlée à un nouveau tableau.
list::unique (STL/CLR)	Supprime les éléments adjacents qui passent un test spécifié.

Propriété	Description
list::back_item (STL/CLR)	Accède au dernier élément.
list::front_item (STL/CLR)	Accède au premier élément.

Opérateur	Description
list::operator= (STL/CLR)	Remplace la séquence contrôlée.
operator!= (list) (STL/CLR)	Détermine si un objet d' list n'est pas égal à un autre objet d' list .
operator< (list) (STL/CLR)	Détermine si un objet d' list est inférieure un autre objet d' list .
operator<= (list) (STL/CLR)	Détermine si un objet d' list est inférieur ou égal à un autre objet d' list .
operator== (list) (STL/CLR)	Détermine si un objet d' list équivaut à un autre objet d' list .
operator> (list) (STL/CLR)	Détermine si un objet d' list est supérieur à un autre objet d' list .
operator>= (list) (STL/CLR)	Détermine si un objet d' list est supérieure ou égale à un autre objet d' list .

Interfaces

Interface	Description
ICloneable	Dupliquez un objet.
IEnumerable	Séquence de parcourir les éléments.
ICollection	Maintenez le groupe d'éléments.
IEnumerable<T>	Séquence par des éléments typés.
ICollection<T>	Maintenez le groupe d'éléments typés.
IList<valeur>	Maintenez le conteneur générique.

Notes

L'objet alloue et libère le stockage pour la séquence qu'il contrôle comme des nœuds individuels dans une liste de liens bidirectionnelle.Il positionne les éléments en modifiant les liens entre les nœuds, jamais en copiant le contenu d'un nœud à un autre.Cela signifie que vous pouvez insérer et supprimer des éléments librement sans éléments restants inquiétants.Ainsi, une liste est un bon candidat pour le conteneur sous-jacent pour la classe de modèle queue (STL/CLR) ou la classe de modèle stack (STL/CLR).

Un objet d' list prend en charge des itérateurs bidirectionnelles, ce qui signifie que vous pouvez exécuter pas aux éléments adjacents dotés d'un itérateur qui indique un élément dans la séquence contrôlée.Un nœud principal particulier correspond à l'itérateur retourné par list::end (STL/CLR)().Vous pouvez décrémenter cet itérateur pour atteindre le dernier élément de la séquence contrôlée, le cas échéant.Vous pouvez incrémenter un itérateur de liste pour atteindre le nœud principal, et il comparera ensuite égale à end().Mais vous ne pouvez pas déréférencement l'itérateur retourné par end().

Notez que vous ne pouvez pas faire référence à un élément de liste directement donné sa position numérique -- cette opération nécessite un itérateurs d'accès aléatoire.Donc une liste est not utilisable en tant que conteneur sous-jacent pour la classe de modèle priority_queue (STL/CLR).

Un itérateur de liste enregistre un handle vers son nœud connexe de liste, qui enregistre ensuite un handle à son conteneur associé.Vous pouvez utiliser des itérateurs uniquement avec leurs objets conteneurs associés.Un itérateur de liste reste valide tant que son nœud connexe de liste soit associé à une certaine liste.De plus, un itérateur valide est dereferencable -- vous pouvez l'utiliser pour accéder ou modifier sa valeur d'élément qu'il indique -- en sachant qu'il ne soit pas égal à end().

Effaçant ou suppression d'un élément appelle le destructeur de sa valeur stockée.Détruire le conteneur efface tous les éléments.Ainsi, un conteneur dont le type d'élément est une classe de référence garantit qu'élément ne survit pas au conteneur.La notez, cependant, un conteneur de handles fait not destroy ses éléments.