list (STL/CLR)

Artykuł
06/07/2013

Klasa szablonu opisuje obiekt, który kontroluje różne długości sekwencji elementów dwukierunkowy dostępem.Użyj kontenera list do zarządzania sekwencja elementów jako dwukierunkowy połączonej listy węzłów, każdy przechowywania jeden element.

W opisie poniżej GValue jest taka sama, jak Value jest typem odwołania, w którym to przypadku jest 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>
    { ..... };

Parametry

Wartość
Typ elementu w kontrolowanej sekwencji.

Członkowie

Definicja typu	Opis
list::const_iterator (STL/CLR)	Typ stałej iteratora kontrolowanych sekwencji numerów.
list::const_reference (STL/CLR)	Typ stałej odwołanie do elementu.
list::const_reverse_iterator (STL/CLR)	Typ stałej iteratora wstecznego kontrolowanych sekwencji numerów.
list::difference_type (STL/CLR)	Typ podpisane odległość między dwoma elementami.
list::generic_container (STL/CLR)	Typ rodzajowy interfejs dla kontenera.
list::generic_iterator (STL/CLR)	Typ iterację rodzajowy interfejs dla kontenera.
list::generic_reverse_iterator (STL/CLR)	Typ wstecznego iteratora rodzajowy interfejs dla kontenera.
list::generic_value (STL/CLR)	Typ elementu dla rodzajowego interfejsu dla kontenera.
list::Iterator (STL/CLR)	Typ iterację kontrolowanych sekwencji numerów.
list::Reference (STL/CLR)	Typ odwołania do elementu.
list::reverse_iterator (STL/CLR)	Typ wstecznego iteratora kontrolowanych sekwencji numerów.
list::size_type (STL/CLR)	Typ podpisane odległość między dwoma elementami.
list::value_type (STL/CLR)	Typ elementu.

Funkcja Członkowskie	Opis
list::assign (STL/CLR)	Zastępuje wszystkie elementy.
list::back (STL/CLR)	Uzyskuje dostęp do ostatniego elementu.
list::begin (STL/CLR)	Określa początek kontrolowanych sekwencji.
list::clear (STL/CLR)	Usuwa wszystkie elementy.
list::empty (STL/CLR)	Badania, czy elementy nie są obecnie.
list::end (STL/CLR)	Określa koniec sekwencji kontrolowane.
list::erase (STL/CLR)	Usuwa elementy na określonych pozycjach.
list::front (STL/CLR)	Uzyskuje dostęp do pierwszego elementu.
list::insert (STL/CLR)	Dodaje elementy w określonym położeniu.
list::list (STL/CLR)	Tworzy obiekt kontenera.
list::merge (STL/CLR)	Łączy dwa uporządkowane kontrolowanych sekwencji.
list::pop_back (STL/CLR)	Usuwa ostatni element.
list::pop_front (STL/CLR)	Usuwa pierwszego elementu.
list::push_back (STL/CLR)	Dodaje nowe ostatni element.
list::push_front (STL/CLR)	Dodaje nowy element pierwszy.
list::rbegin (STL/CLR)	Określa początek odwróconą kolejność kontrolowanych.
list::remove (STL/CLR)	Usuwa element z określoną wartością.
list::remove_if (STL/CLR)	Usuwa elementy, które przechodzą badania określony.
list::rend (STL/CLR)	Określa koniec odwróconą kolejność kontrolowanych.
list::resize (STL/CLR)	Zmienia liczbę elementów.
list::reverse (STL/CLR)	Odwraca sekwencję kontrolowane.
list::size (STL/CLR)	Zlicza liczbę elementów.
list::sort (STL/CLR)	Zamówień kontrolowanych sekwencji.
list::splice (STL/CLR)	Restitches łącza między węzłami.
list::swap (STL/CLR)	Zamienia zawartość dwóch kontenerów.
list::to_array (STL/CLR)	Kopiuje kontrolowanych sekwencji nowej tablicy.
list::unique (STL/CLR)	Usuwa sąsiadujących elementów, które przechodzą badania określonego.

Właściwość	Opis
list::back_item (STL/CLR)	Uzyskuje dostęp do ostatniego elementu.
list::front_item (STL/CLR)	Uzyskuje dostęp do pierwszego elementu.

Operator	Opis
list::operator= (STL/CLR)	Zastępuje kontrolowanych sekwencji.
operator!= (list) (STL/CLR)	Określa, czy list obiekt nie jest równa innej list obiektu.
operator< (list) (STL/CLR)	Określa, czy list obiektu jest mniejsza niż inna list obiektu.
operator<= (list) (STL/CLR)	Określa, czy list obiekt jest mniejsza lub równa drugiemu list obiektu.
operator== (list) (STL/CLR)	Określa, czy list obiekt jest równa innej list obiektu.
operator> (list) (STL/CLR)	Określa, czy list obiektu jest większy niż inny list obiektu.
operator>= (list) (STL/CLR)	Określa, czy list obiektu jest większa niż lub równa innej list obiektu.

Interfejsy

Interfejs	Opis
ICloneable	Duplikowanie obiektów.
IEnumerable	Sekwencji za pomocą elementów.
ICollection	Zachować grupy elementów.
IEnumerable<T>	Sekwencji poprzez maszynowy elementów.
ICollection<T>	Zachować grupy elementów określonego typu.
Elementy IList <Value>	Utrzymanie kontenerem.

Uwagi

Obiekt przydziela i zwalnia przechowywania sekwencji numerów, które kontroluje jako pojedynczych węzłów na liście łącze do dwukierunkowego.Zmieniając łącza między węzłami nigdy, kopiując zawartość jednego węzła do innego go ponownie rozmieszcza elementy.Oznacza to, można wstawiać i usuwanie elementów swobodnie bez pozostałych pierwiastków przeszkadzających.Tak więc lista jest odpowiednie do pełnienia funkcji podstawowych kontener dla szablonu klasy queue (STL/CLR) lub szablonu klasy stack (STL/CLR).

A list obiekt obsługuje Iteratory dwukierunkowe, co oznacza można krok do sąsiadujących elementów podanych iterację, wyznaczający element w kontrolowanej sekwencji.Specjalne węzła głównego odpowiada iteratora, zwrócony przez list::end (STL/CLR)().Można zmniejszyć iteratora to osiągać ostatni element w sekwencji kontrolowanych, jeśli jest obecna.Można zwiększyć iteratora listy do węzła głównego, a następnie będzie porównaj równa end().Ale nie nieprawidłowego iteratora, zwrócony przez end().

Należy zauważyć, że nie może odwoływać się do elementu listy bezpośrednio podanych pozycji numerycznych--wymagającej z iteratora losowy dostęp.Lista jest not jako podstawowej kontener dla szablonu klasy priority_queue (STL/CLR).

Iteratora listy przechowuje dojście do węzła skojarzona lista, która z kolei przechowuje dojście do jego kontenera skojarzone.Iteratory służy tylko z ich obiekty skojarzone kontenera.Iteratora listy zachowuje ważność tak długo, jak długo jego węzeł skojarzona lista jest skojarzony z niektóre listy.Ponadto ważne iteratora jest dereferencable--służy do dostępu lub zmienić wartość elementu ustanowi--tak długo, jak nie jest równa end().

Wymazywanie lub usunięcie elementu wymaga destruktor jego wartości przechowywanej.Niszczenie kontenera powoduje wymazanie wszystkich elementów.W ten sposób kontener, którego typ elementu jest klasa ref zapewnia żadnych elementów przetrwać dłużej niż kontenera.Należy jednak zauważyć, że kontener uchwyty nie not zniszczyć jego elementów.