Klasa CByteArray

Obsługuje dynamiczne tablice bajtów.

Składnia

class CByteArray : public CObject

Członkowie

Funkcje CByteArray 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ść BYTE.

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

na przykład przekłada się na

BYTE CByteArray::GetAt( int <nIndex> ) const;

Konstruktory publiczne

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

Metody publiczne

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

Operatory publiczne

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

Uwagi

CByteArray uwzględnia makro IMPLEMENT_SERIAL w celu wspierania serializacji i dumpingu jego elementów. Jeśli tablica bajtów jest przechowywana w archiwum, z przeciążonym operatorem wstawiania ( <<) lub z Serialize funkcją 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 CByteArray, zobacz artykuł Kolekcje.

Hierarchia dziedziczenia

Cobject

CByteArray

Wymagania

Nagłówek: afxcoll.h

Zobacz też

Klasa CObject
Wykres hierarchii
Klasa CObArray