Udostępnij za pośrednictwem


Klasa CDWordArray

Obsługuje tablice 32-bitowych doublewords.

Składnia

class CDWordArray : public CObject

Elementy członkowskie

Funkcje CDWordArray 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 wartość DWORD.

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

na przykład przekłada się na

DWORD CDWordArray::GetAt( int <nIndex> ) const;

Konstruktory publiczne

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

Metody publiczne

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

Operatory publiczne

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

Uwagi

CDWordArrayIMPLEMENT_SERIAL uwzględnia makro w celu wspierania serializacji i dumpingu jej elementów. Jeśli tablica podwójnych słów jest przechowywana w archiwum, z przeciążonym operatorem wstawiania ( <<) lub z funkcją Serialize składową, każdy element jest z kolei serializowany.

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 danych wyjściowych debugowania z poszczególnych elementów tablicy, musisz ustawić głębokość CDumpContext obiektu na 1 lub większą.

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

Wymagania

Nagłówek: afxcoll.h

Zobacz też

Klasa CObject
Wykres hierarchii
Klasa CObArray