Klasa CList

Artykuł
02/27/2013

Obsługuje uporządkowane listy obiektów nieunikatowy dostępne sekwencyjnie lub wartość.

template< class TYPE, class ARG_TYPE = const TYPE& > 
class CList : public CObject

Członkowie

Publiczne konstruktory

Nazwa	Opis
CList::CList	Tworzy pustą listę zamówione.

Metody publiczne

Nazwa	Opis
CList::AddHead	Dodaje element (lub wszystkie elementy na innej liście) szefowi listy (sprawia, że nowe head).
CList::AddTail	Dodaje element (lub wszystkich elementów listy) do ogona listy (sprawia, że nowe ogona).
CList::Find	Pobiera element określony przez wartość wskaźnika położenia.
CList::FindIndex	Pobiera z pozycji określonych według indeksu elementu.
CList::GetAt	Pobiera element w danym miejscu.
CList::GetCount	Zwraca liczbę elementów na tej liście.
CList::GetHead	Zwraca wartość elementu nagłówkowego listy (nie może być puste).
CList::GetHeadPosition	Zwraca pozycję głowy elementu listy.
CList::GetNext	Iterowanie pobiera następnego elementu.
CList::GetPrev	Iterowanie pobiera poprzedniego elementu.
CList::GetSize	Zwraca liczbę elementów na tej liście.
CList::GetTail	Zwraca element ogona listy (nie może być puste).
CList::GetTailPosition	Zwraca pozycję ogona elementu listy.
CList::InsertAfter	Wstawia nowy element po danej pozycji.
CList::InsertBefore	Wstawia nowy element przed danej pozycji.
CList::IsEmpty	Testy dla warunku pustą listę (Brak elementów).
CList::RemoveAll	Usuwa wszystkie elementy z tej listy.
CList::RemoveAt	Usuwa element z listy określona według pozycji.
CList::RemoveHead	Usuwa element z listy głowy.
CList::RemoveTail	Usuwa element z ogona listy.
CList::SetAt	Ustawia elementu w danym miejscu.

Parametry

TYPE
Typ obiektu przechowywanego na liście.
ARG*_*TYPE
Typ używany do obiektów przechowywanych na liście.Może być odwołaniem.

Uwagi

CListlist zachowują się jak list podwójnie połączone.

Zmienna typu stanowisko jest kluczem do listy.Można użyć stanowisko zmienną jako iterację przechodzenie przez listę sekwencyjnie i zakładki do miejsca przechowywania.Pozycja nie jest taki sam jak indeks, jednak.

Element wstawiania jest bardzo szybkie w listy głowy, ogona oraz znanego stanowisko.Kolejne wyszukiwanie jest niezbędne do wyszukiwania wartości lub indeksu elementu.Wyszukiwanie może być powolne, jeśli lista jest długa.

Zrzut poszczególnych elementów na liście, należy należy ustawić głębokość kontekstu zrzutu 1 lub większą.

Niektórych funkcji elementów członkowskich tego wywołania klasa helper globalnego funkcji, które muszą być dostosowane dla większości zastosowań CList klasy.Zobacz Pomocnicy klasy kolekcji w sekcji "Makr i Globals".

Aby uzyskać więcej informacji na temat używania CList, zobacz artykuł kolekcji.

Przykład

// CList is a template class that takes two template arguments.
// The first argument is type stored internally by the list, the
// second argument is the type used in the arguments for the
// CList methods.

// This code defines a list of ints.
CList<int,int> myIntList;

// This code defines a list of CStrings
CList<CString,CString&> myStringList;

// This code defines a list of MYTYPEs,
// NOTE: MYTYPE could be any struct, class or type definition
CList<MYTYPE,MYTYPE&> myTypeList;