Udostępnij za pośrednictwem


CStringList Klasa

Obsługuje listy CString obiektów.

Składnia

class CStringList : public CObject

Elementy członkowskie

Funkcje CStringList składowe klasy są podobne do funkcji składowych klasy CObList. Ze względu na to podobieństwo można użyć dokumentacji referencyjnej CObList dla specyfiki funkcji składowych. Wszędzie tam, gdzie wskaźnik jest widoczny CObject jako wartość zwracana, zastąp CString wartość (a nie wskaźnikiem CString ). Wszędzie tam, gdzie wskaźnik jest wyświetlany CObject jako parametr funkcji, zastąp element LPCTSTR.

CObject*& CObList::GetHead() const;

na przykład przekłada się na

CString& CStringList::GetHead() const;

oraz

POSITION AddHead( CObject* <newElement> );

przekłada się na

POSITION AddHead( LPCTSTR <newElement> );

Konstruktory publiczne

Nazwa/nazwisko opis
CStringList::CStringList Tworzy pustą listę.

Metody publiczne

Nazwa/nazwisko opis
CStringList::AddHead Dodaje element (lub wszystkie elementy na innej liście) do nagłówka listy (tworzy nową głowę).
CStringList::AddTail Dodaje element (lub wszystkie elementy na innej liście) do końca listy (tworzy nowy ogon).
CStringList::Find Pobiera położenie elementu określonego przez wartość wskaźnika.
CStringList::FindIndex Pobiera pozycję elementu określonego przez indeks oparty na zerze.
CStringList::GetAt Pobiera element na danej pozycji.
CStringList::GetCount Zwraca liczbę elementów na tej liście.
CStringList::GetHead Zwraca element główny listy (nie może być pusty).
CStringList::GetHeadPosition Zwraca położenie elementu głównego listy.
CStringList::GetNext Pobiera następny element do iteracji.
CStringList::GetPrev Pobiera poprzedni element na potrzeby iteracji.
CStringList::GetSize Zwraca liczbę elementów na tej liście.
CStringList::GetTail Zwraca element końcowy listy (nie może być pusty).
CStringList::GetTailPosition Zwraca położenie elementu końcowego listy.
CStringList::InsertAfter Wstawia nowy element po danej pozycji.
CStringList::InsertBefore Wstawia nowy element przed daną pozycją.
CStringList::IsEmpty Testuje pusty warunek listy (brak elementów).
CStringList::RemoveAll Usuwa wszystkie elementy z tej listy.
CStringList::RemoveAt Usuwa element z tej listy określony przez pozycję.
CStringList::RemoveHead Usuwa element z nagłówka listy.
CStringList::RemoveTail Usuwa element z końca listy.
CStringList::SetAt Ustawia element na danej pozycji.

Uwagi

Wszystkie porównania są wykonywane według wartości, co oznacza, że znaki w ciągu są porównywane zamiast adresów ciągów.

CStringListIMPLEMENT_SERIAL uwzględnia makro w celu wspierania serializacji i dumpingu jej elementów. Jeśli lista CString obiektów jest przechowywana w archiwum, z przeciążonym operatorem wstawiania lub z Serialize funkcją składową, każdy CString element jest serializowany z kolei.

Jeśli potrzebujesz zrzutu poszczególnych CString elementów, musisz ustawić głębokość kontekstu zrzutu na 1 lub większą.

Aby uzyskać więcej informacji na temat korzystania z programu CStringList, zobacz artykuł Kolekcje.

Hierarchia dziedziczenia

CObject

CStringList

Wymagania

Nagłówek: afxcoll.h

Zobacz też

Przykład MFC COLLECT
CObject Klasa
Wykres hierarchii