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
CStringList
Wymagania
Nagłówek: afxcoll.h