Udostępnij za pośrednictwem


Klasa CWordArray

Obsługuje tablice 16-bitowych wyrazów.

Składnia

class CWordArray : public CObject

Elementy członkowskie

Funkcje CWordArray 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 widzisz wskaźnik CObject jako parametr funkcji lub wartość zwracaną, zastąp element WORD.

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

na przykład przekłada się na

WORD CWordArray::GetAt( int <nIndex> ) const;

Konstruktory publiczne

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

Metody publiczne

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

Operatory publiczne

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

Uwagi

CWordArrayuwzględnia makro IMPLEMENT_SERIAL w celu wspierania serializacji i dumpingu jej elementów. Jeśli tablica wyrazów jest przechowywana w archiwum, z przeciążonym operatorem wstawiania lub z funkcją składową CObject::Serialize , 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 zrzutu poszczególnych elementów w tablicy, musisz ustawić głębokość kontekstu zrzutu na 1 lub większą.

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

Hierarchia dziedziczenia

Obiekt CObject

CWordArray

Wymagania

Nagłówek: afxcoll.h

Zobacz też

Przykład MFC COLLECT
Klasa CObject
Wykres hierarchii