Klasa CByteArray
Obsługuje dynamiczne tablice bajtów.
Składnia
class CByteArray : public CObject
Elementy członkowskie
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
CByteArray
Wymagania
Nagłówek: afxcoll.h