list (STL/CLR)

Artikel
06/10/2015

Die Vorlagenklasse beschreibt ein Objekt, das eine VARYINGLängen-Folge von Elementen steuert, die bidirektionalen Zugriff hat. Mit dem Container list, um eine Sequenz von Elementen als bidirektionale verknüpfte Liste von Knoten, jedes speichernde ein Element zu verwalten.

In der unten stehenden Beschreibung, GValue ist das Value identisch, es sei denn, das zweite ein Referenz-Typ ist, in diesem Fall Value^ dar.

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>
    { ..... };

Parameter

Wert
Der Typ eines Elements in der kontrollierten Sequenz.

Member

Typdefinition	Beschreibung
list::const_iterator (STL/CLR)	Der Typ eines konstanten Iterators für die gesteuerte Sequenz.
list::const_reference (STL/CLR)	Der Typ eines konstanten Verweises auf ein Element.
list::const_reverse_iterator (STL/CLR)	Der Typ eines konstanten umgekehrten Iterators für die gesteuerte Sequenz.
list::difference_type (STL/CLR)	Der Typ eines Abstands mit Vorzeichen zwischen zwei Elementen.
list::generic_container (STL/CLR)	Der Typ der generischen Schnittstelle für den Container.
list::generic_iterator (STL/CLR)	Der Typ eines Iterators für die generische Schnittstelle für den Container.
list::generic_reverse_iterator (STL/CLR)	Der Typ eines umgekehrten Iterators für die generische Schnittstelle für den Container.
list::generic_value (STL/CLR)	Der Typ des Elements für die generische Schnittstelle für den Container.
list::iterator (STL/CLR)	Der Typ eines Iterators für die gesteuerte Sequenz.
list::reference (STL/CLR)	Der Typ eines Verweises auf ein Element.
list::reverse_iterator (STL/CLR)	Der Typ eines umgekehrten Iterators für die gesteuerte Sequenz.
list::size_type (STL/CLR)	Der Typ eines Abstands mit Vorzeichen zwischen zwei Elementen.
list::value_type (STL/CLR)	Der Typ eines Elements.

Memberfunktion	Beschreibung
list::assign (STL/CLR)	Ersetzt alle Elemente.
list::back (STL/CLR)	Greift auf das letzte Element zu.
list::begin (STL/CLR)	Legt den Anfang der kontrollierten Sequenz fest.
list::clear (STL/CLR)	Entfernt alle Elemente.
list::empty (STL/CLR)	Testet, dass keine Elemente vorhanden sind.
list::end (STL/CLR)	Legt das Ende der kontrollierten Sequenz fest.
list::erase (STL/CLR)	Entfernt Elemente an den angegebenen Positionen.
list::front (STL/CLR)	Greift auf das erste Element zu.
list::insert (STL/CLR)	Fügt Elemente in einer bestimmten Position hinzu.
list::list (STL/CLR)	Erstellt ein container-Objekt.
list::merge (STL/CLR)	Führt zwei geordnete kontrollierte Sequenzen zusammen.
list::pop_back (STL/CLR)	Entfernt das letzte Element.
list::pop_front (STL/CLR)	Entfernt das erste Element.
list::push_back (STL/CLR)	Fügt ein neues letzte Element hinzu.
list::push_front (STL/CLR)	Fügt ein neues erstes Element hinzu.
list::rbegin (STL/CLR)	Legt den Anfang der umgekehrten kontrollierten Sequenz fest.
list::remove (STL/CLR)	Entfernt ein Element mit einem angegebenen Wert.
list::remove_if (STL/CLR)	Entfernt Elemente, die einen bestimmten Test übergeben.
list::rend (STL/CLR)	Legt das Ende der umgekehrten kontrollierten Sequenz fest.
list::resize (STL/CLR)	Ändert die Anzahl der Elemente.
list::reverse (STL/CLR)	Kehrt die gesteuerte Sequenz um.
list::size (STL/CLR)	Ermittelt die Anzahl der Elemente.
list::sort (STL/CLR)	Sortiert die kontrollierte Sequenz.
list::splice (STL/CLR)	Erneuert Links zwischen Knoten.
list::swap (STL/CLR)	Vertauscht den Inhalt von zwei Containern.
list::to_array (STL/CLR)	Kopiert die gesteuerte Sequenz zu einem neuen Array.
list::unique (STL/CLR)	Entfernt benachbarte Elemente, die einen angegebenen Test bestehen.

Eigenschaft	Beschreibung
list::back_item (STL/CLR)	Greift auf das letzte Element zu.
list::front_item (STL/CLR)	Greift auf das erste Element zu.

Operator	Beschreibung
list::operator= (STL/CLR)	Ersetzt die gesteuerte Sequenz.
operator!= (list) (STL/CLR)	Bestimmt, ob ein list-Objekt nicht gleich ein anderes list-Objekt ist.
operator< (list) (STL/CLR)	Bestimmt, ob ein list-Objekt kleiner als ein anderes list-Objekt ist.
operator<= (list) (STL/CLR)	Bestimmt, ob ein list-Objekt maximal ein anderes list-Objekt ist.
operator== (list) (STL/CLR)	Bestimmt, ob ein list-Objekt ein anderes Objekt gleich list ist.
operator> (list) (STL/CLR)	Bestimmt, ob ein list-Objekt größer als ein anderes list-Objekt ist.
operator>= (list) (STL/CLR)	Bestimmt, ob ein list-Objekt größer oder gleich einem anderen list-Objekt ist.

Schnittstellen

Schnittstelle	Beschreibung
ICloneable	Ein Objekt duplizieren.
IEnumerable	Sequenz durch Elemente.
ICollection	Unbegrenztes Beibehalten Elementgruppe bei.
IEnumerable	Sequenz von typisierten Elemente.
ICollection	Unbegrenztes Beibehalten Gruppe typisierten Elemente bei.
IListValue <>	Warten Sie generischen Container.

Hinweise

Das Objekt belegt und gibt die Sequenz für Speicher frei, die, er während einzelner Knoten in einer bidirektionalen Linkliste steuert. Sie weist Elemente neu indem die Links zwischen Knoten, nie ändert, indem der Inhalt von einem Knoten zum anderen kopiert. Das bedeutet, dass Sie Elemente beunruhigende ohne verbleibende Elemente frei einfügen und löschen können. Daher ist eine Liste gut für den zugrunde liegenden Container für Vorlagenklasse queue (STL/CLR) oder Vorlagenklasse stack (STL/CLR).

Ein list-Objekt unterstützt bidirektionale Iteratoren, dass Sie zu benachbarten Elementen werden kann, dass ein Iterator angegeben werden, der ein Element in der Sequenz gesteuerten festlegt. Ein spezieller Hauptknoten entspricht dem Iterator, der durch list::end (STL/CLR)() zurückgegeben wird. Sie können diesen Iterator Dekrementieren, um das letzte Element der gesteuerten Sequenz erreicht, wenn vorhanden. Sie können einen Listeniterator erhöhen, um den Hauptknoten erreicht, und vergleicht er dann gleich end(). Sie können jedoch den Iterator nicht möglich, der von end() zurückgegeben wird.

Beachten Sie, dass Sie ein Listenelement nicht zugreifen können, das direkt die numerische Position angegeben wird - das erfordert einen Iterator mit wahlfreier Zugriff. Daher ist eine Liste not, das als zugrunde liegender Container für Vorlagenklasse priority_queue (STL/CLR) verwendbar ist.

Ein Listeniterator speichert ein Handle auf dem zugeordneten Listenknoten, der wiederum ein Handle auf dem zugeordneten Container speichert. Sie können Iteratoren nur mit ihren zugeordneten Containerobjekten verwenden. Ein Listeniterator bleibt gültig, solange der zugehörige Listenknoten mit einer Liste zugeordnet wird. Darüber hinaus ist ein gültiger dereferencable Iterator - Sie können ihn verwenden, um auf den Elementwert zuzugreifen oder zu ändern, der festlegt wird - solange er nicht gleich end() ist.

Ein Element Löschen oder entfernen, wird der Destruktor für den gespeicherten Wert auf. Die Container Löschen eines Auflistungsobjekts, löscht alle Elemente. Somit wird sichergestellt ein Container, dessen Elementtyp eine Verweisklasse, ist, dass keine Elemente den Container Beibehaltene Objekte. Beachten Sie jedoch dem Container Handles not bewirkt, zerstören seine Elemente.