Klasa CPtrArray

Obsługuje tablice wskaźników void.

Składnia

class CPtrArray : public CObject

Członkowie

Funkcje CPtrArray składowe klasy CObArray 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 wyświetlany CObject jako parametr funkcji lub wartość zwracana, zastąp wskaźnik wskaźnikiem .void

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

na przykład przekłada się na

void* CPtrArray::GetAt( int <nIndex> ) const;

Konstruktory publiczne

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

Metody publiczne

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

Operatory publiczne

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

Uwagi

CPtrArray zawiera makro IMPLEMENT_DYNAMIC do obsługi dostępu typu czasu wykonywania i dumpingu CDumpContext do obiektu. Jeśli potrzebujesz zrzutu pojedynczych elementów tablicy wskaźników, musisz ustawić głębokość kontekstu zrzutu na 1 lub większą.

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ęć.

Tablice wskaźników nie mogą być serializowane.

Gdy tablica wskaźnika zostanie usunięta lub gdy jego elementy zostaną usunięte, zostaną usunięte tylko wskaźniki, a nie jednostki, do których się odwołują.

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

Hierarchia dziedziczenia

Cobject

CPtrArray

Wymagania

Nagłówek: afxcoll.h

Zobacz też

Klasa CObject
Wykres hierarchii
Klasa CObArray