CStringArray Klasa

Obsługuje tablice CString obiektów.

Składnia

class CStringArray : public CObject

Elementy członkowskie

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

CObject* CObArray::GetAt( int <nIndex> ) const;

na przykład przekłada się na

const CString& CStringArray::GetAt( int <nIndex> ) const;

oraz

void SetAt( int <nIndex>, CObject* <newElement> )

przekłada się na

void SetAt( int <nIndex>, LPCTSTR <newElement> )

Konstruktory publiczne

Nazwa/nazwisko	opis
CStringArray::CStringArray	Tworzy pustą tablicę.

Metody publiczne

Nazwa/nazwisko	opis
CStringArray::Add	Dodaje element na końcu tablicy; w razie potrzeby zwiększa tablicę.
CStringArray::Append	Dołącza kolejną tablicę do tablicy; w razie potrzeby zwiększa tablicę.
CStringArray::Copy	Kopiuje kolejną tablicę do tablicy; w razie potrzeby zwiększa tablicę.
CStringArray::ElementAt	Zwraca tymczasowe odwołanie do wskaźnika elementu w tablicy.
CStringArray::FreeExtra	Zwalnia całą nieużywaną pamięć powyżej bieżącej górnej granicy.
CStringArray::GetAt	Zwraca wartość dla danego indeksu.
CStringArray::GetCount	Pobiera liczbę elementów w tej tablicy.
CStringArray::GetData	Umożliwia dostęp do elementów w tablicy. Może to być NULL.
CStringArray::GetSize	Pobiera liczbę elementów w tej tablicy.
CStringArray::GetUpperBound	Zwraca największy prawidłowy indeks.
CStringArray::InsertAt	Wstawia element (lub wszystkie elementy w innej tablicy) w określonym indeksie.
CStringArray::IsEmpty	Określa, czy tablica jest pusta.
CStringArray::RemoveAll	Usuwa wszystkie elementy z tej tablicy.
CStringArray::RemoveAt	Usuwa element w określonym indeksie.
CStringArray::SetAt	Ustawia wartość dla danego indeksu; tablica nie może rosnąć.
CStringArray::SetAtGrow	Ustawia wartość dla danego indeksu; w razie potrzeby zwiększa tablicę.
CStringArray::SetSize	Ustawia liczbę elementów, które mają być zawarte w tej tablicy.

Operatory publiczne

Nazwa/nazwisko	opis
CStringArray::operator [ ]	Ustawia lub pobiera element w określonym indeksie.

Uwagi

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

Uwaga

Przed użyciem tablicy użyj polecenia SetSize , aby ustanowić jego rozmiar i przydzielić dla niej pamięć. Jeśli nie używasz polecenia SetSize, dodanie elementów do tablicy powoduje, że jest on często ponownie przydzielany i kopiowany. Częste reallokowanie i kopiowanie są nieefektywne i mogą fragmentować pamięć.

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

Gdy tablica CString zostanie usunięta lub gdy jej elementy zostaną usunięte, pamięć ciągu zostanie zwolniona zgodnie z potrzebami.

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

Hierarchia dziedziczenia

CObject

CStringArray

Wymagania

Nagłówek: afxcoll.h

Zobacz też

CObject Klasa
Wykres hierarchii