Liste (STL/CLR)

Artikel
02/26/2013

Die Vorlagenklasse beschreibt ein Objekt, das eine VARYING LENGTH-Folge von Elementen steuert, die bidirektionale Zugriff hat.Sie verwenden den Container list, um eine Sequenz von Elementen als bidirektionale verknüpfte Liste von Knoten, die jeweils ein Element zu speichernde verwalten.

In der unten GValue interaktiven Beschreibung, ist dasselbe wie Value, es sei denn, das zweite ein ref-Typ ist. In diesem Fall wird Value^ ist.

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.

Mitglieder

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 Verweis 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 signierten Lücke 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 eines 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 signierten Lücke 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.
list::begin (STL/CLR)	Legt den Anfang der kontrollierten Sequenz fest.
list::clear (STL/CLR)	Entfernt alle Elemente.
list::empty (STL/CLR)	Überprüft, ob 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 an einer angegebenen Position hinzu.
list::list (STL/CLR)	Erstellt ein Containerobjekt.
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 aus.
list::push_back (STL/CLR)	Fügt ein neues letztes 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 angegebenen 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)	Gibt 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)	Restitches-Links zwischen Knoten.
list::swap (STL/CLR)	Vertauscht den Inhalt von zwei Containern.
list::to_array (STL/CLR)	Kopiert die gesteuerte Sequenz in ein neues 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.
list::front_item (STL/CLR)	Greift auf das erste Element zu.

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

Schnittstellen

Schnittstelle	Beschreibung
ICloneable	Duplizieren Sie ein Objekt.
IEnumerable	Sequenz von Elementen.
ICollection	Behalten Sie unter ItemGroup.
IEnumerable<T>	Sequenz von typisierten Elemente.
ICollection<T>	Behalten Sie die Gruppe typisierte Elemente beibehalten.
IList<Wert>	Warten Sie generischen Container.

Hinweise

Das Objekt wird auf und gibt Speicherplatz für die Sequenz frei, die er während einer bidirektionalen Link einzelne Knoten in der Liste steuert.Er verschiebt Elemente angezeigt, indem die Links zwischen Knoten nie ändert, indem der Inhalt von einem Knoten auf einen anderen kopiert.Das bedeutet, dass Sie Elemente frei einfügen und löschen können, ohne übrigen Elemente zu beeinträchtigen.Daher ist eine Liste ein guter Kandidat für den zugrunde liegenden Container für Vorlagenklasse Warteschlange (STL/CLR) oder Vorlagenklasse Stapel (STL/CLR).

Ein list-Objekt unterstützt bidirektionale Iteratoren. Das bedeutet, dass Sie den benachbarten angegebenen Elemente treten können ein Iterator, der eines Elements in der kontrollierten Sequenz.Ein spezieller Hauptknoten entspricht dem Iterator, der von list::end (STL/CLR)() zurückgegeben wurde.Sie können diesen Iterator verringern, um das letzte Element in der kontrollierten Sequenz erreicht hat, falls vorhanden.Sie können einen Listen iterator erhöhen, um den Hauptknoten zu erreichen, und vergleicht dann gleich end().Aber Sie können den Iterator, der von end() keine Dereferenzierung zurückgegeben wird.

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

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

Entfernen oder Löschen eines Elements wird der Destruktor für den gespeicherten Wert an.Der Container zerstörend, löscht alle Elemente.Dies garantiert ein Container, dessen Elementtyp eine Verweisklasse wird, dass keine Elemente Überleben Container.Beachten Sie jedoch, dem ein Container, not Handle zerstört seine Elemente.