list (STL/CLR)

Artykuł
06/10/2015

Klasa szablon opisuje obiekt, który kontroluje różnicowania długość sekwencji elementów z dostępem do dwukierunkowego.Użyj kontener list Zarządzanie sekwencja elementów jako dwukierunkowy połączonej listy węzłów, w każdym przechowywania jeden element.

W polu Opis poniżej GValue jest taka sama jak Value o ile ten ostatni typ 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.

Elementy członkowskie

Definicja typu	Opis
list::const_iterator (STL/CLR)	Typ iteratora stałego dla kontrolowanej sekwencji.
list::const_reference (STL/CLR)	Typ stałego odwołania do elementu.
list::const_reverse_iterator (STL/CLR)	Typ stałej sterująca wstecznego w kontrolowanej sekwencji.
list::difference_type (STL/CLR)	Typ podpisanej odległości między dwoma elementami.
list::generic_container (STL/CLR)	Typ rodzajowy interfejs dla kontenera.
list::generic_iterator (STL/CLR)	Typ iteratora rodzajowy interfejsów dla kontenera.
list::generic_reverse_iterator (STL/CLR)	Typ wstecznego sterująca rodzajowy interfejsów dla kontenera.
list::generic_value (STL/CLR)	Typ elementu dla rodzajowego interfejsu dla kontenera.
list::iterator (STL/CLR)	Typ iteratora dla kontrolowanej sekwencji.
list::reference (STL/CLR)	Typ odwołania do elementu.
list::reverse_iterator (STL/CLR)	Typ wstecznego sterująca w kontrolowanej sekwencji.
list::size_type (STL/CLR)	Typ podpisanej odległości między dwoma elementami.
list::value_type (STL/CLR)	Typ elementu.

Funkcji członka	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 kontrolowanej 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 kontrolowanej sekwencji.
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)	Konstruuje obiekt kontenera.
list::merge (STL/CLR)	Scalenia dwóch zamówione kontrolowanej sekwencji.
list::pop_back (STL/CLR)	Usuwa ostatni element.
list::pop_front (STL/CLR)	Usuwa pierwszego elementu.
list::push_back (STL/CLR)	Dodaje nowy ostatni element.
list::push_front (STL/CLR)	Dodaje nowy pierwszego elementu.
list::rbegin (STL/CLR)	Określa początek odwrócone kontrolowanej sekwencji.
list::remove (STL/CLR)	Usuwa element z określoną wartością.
list::remove_if (STL/CLR)	Usuwa elementy, które przechodzą określony test.
list::rend (STL/CLR)	Określa koniec odwrócone kontrolowanej sekwencji.
list::resize (STL/CLR)	Zmienia liczbę elementów.
list::reverse (STL/CLR)	Odwraca kontrolowanej sekwencji.
list::size (STL/CLR)	Oblicza liczbę elementów.
list::sort (STL/CLR)	Zamówień kontrolowanej sekwencji.
list::splice (STL/CLR)	Zszywa ponownie łącza między węzłami.
list::swap (STL/CLR)	Zamienia zawartość dwa kontenery.
list::to_array (STL/CLR)	Kopiuje kontrolowanej sekwencji do nowej tablicy.
list::unique (STL/CLR)	Usuwa elementy sąsiadujące, które przechodzą określony test.

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 kontrolowanej 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 obiekt jest mniejsza niż innego 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 obiekt 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 przez elementy.
ICollection	Obsługa grupy elementów.
IEnumerable	Sekwencji przez elementy maszynowy.
ICollection	Obsługa grupy elementów maszynowy.
IList<wartości>	Obsługa rodzajowy kontenera.

Uwagi

Obiekt przydziela i zwalnia pamięci masowej w sekwencji, które kontroluje jako pojedynczych węzłów na liście łącze dwukierunkowe.Przestawia elementów przez zmianę łączy między węzłami nigdy, kopiując zawartość z jednego węzła do innego.Oznacza to można wstawiać i usunąć elementy swobodnie bez pozostałych pierwiastków przeszkadzających.Tak więc lista jest dobrym kandydatem do podstawowej kontener dla szablonu klasy queue (STL/CLR) lub szablonu klasy stack (STL/CLR).

A list obiekt obsługuje Iteratory dwukierunkowe, co oznacza, że można przejść do sąsiednich elementów, biorąc pod uwagę iterację opisująca elementu w kontrolowanej sekwencji.Specjalne węzła głównego odpowiada sterująca zwrócone przez list::end (STL/CLR)().To sterująca do osiągnięcia ostatniego elementu w kontrolowanej sekwencji można zmniejszyć, jeśli jest obecna.Mógł zwiększyć wartość sterująca listy, aby dotrzeć do węzła głównego, a następnie porównaj równa end().Ale nie cofnięcia odwołania sterująca zwrócone przez end().

Należy zauważyć, że nie może odwoływać się do elementu listy bezpośrednio biorąc pod uwagę jego pozycję numeryczny--wymagającej sterująca dostępie losowym.Tak jest lista not można używać jako podstawowej kontener dla szablonu klasy priority_queue (STL/CLR).

Sterująca listy przechowuje dojście do węzła listy skojarzonej, który z kolei przechowuje dojście do jego skojarzony kontenera.Iteratory można użyć tylko z ich kontenera skojarzone obiekty.Sterująca listy zachowuje ważność tak długo, jak długo jego węzła listy skojarzonej wiąże się z niektórych listy.Ponadto, prawidłowe iteratora jest dereferencable--służy do dostępu lub zmienić wartość elementu wyznacza ona--tak długo, jak nie jest równa end().

Wymazywanie lub usunięcie elementu wywołuje destruktor dla swojej przechowywanej wartości.Niszczenie kontenera powoduje wymazanie wszystkich elementów.W efekcie kontenera, którego typ elementu jest klasą ref daje pewność, że elementy nie przeżyje kontenera.Należy jednak zauważyć, że kontener uchwyty nie not zniszczyć jego elementów.