Klasa CPtrArray
Obsługuje tablice wskaźników void.
Składnia
class CPtrArray : public CObject
Elementy członkowskie
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
CPtrArray
Wymagania
Nagłówek: afxcoll.h