Kelas CByteArray
Mendukung array byte dinamis.
Sintaks
class CByteArray : public CObject
Anggota
Fungsi CByteArray anggota mirip dengan fungsi anggota kelas CObArray. Karena kesamaan ini, Anda dapat menggunakan CObArray dokumentasi referensi untuk spesifik fungsi anggota. Di mana pun Anda melihat CObject pointer sebagai parameter fungsi atau mengembalikan nilai, ganti BYTE.
CObject* CObArray::GetAt( int <nIndex> ) const;
misalnya, diterjemahkan ke
BYTE CByteArray::GetAt( int <nIndex> ) const;
Konstruktor Publik
| Nama | Deskripsi |
|---|---|
| CByteArray::CByteArray | Membuat array kosong. |
Metode Publik
| Nama | Deskripsi |
|---|---|
| CByteArray::Add | Menambahkan elemen ke akhir array; menumbuhkan array jika perlu. |
| CByteArray::Tambahkan | Menambahkan array lain ke array; menumbuhkan array jika perlu. |
| CByteArray::Copy | Menyalin array lain ke array; menumbuhkan array jika perlu. |
| CByteArray::ElementAt | Mengembalikan referensi sementara ke byte dalam array. |
| CByteArray::FreeExtra | Membebaskan semua memori yang tidak digunakan di atas batas atas saat ini. |
| CByteArray::GetAt | Mengembalikan nilai pada indeks tertentu. |
| CByteArray::GetCount | Mendapatkan jumlah elemen dalam array ini. |
| CByteArray::GetData | Memungkinkan akses ke elemen dalam array. Bisa NULL. |
| CByteArray::GetSize | Mendapatkan jumlah elemen dalam array ini. |
| CByteArray::GetUpperBound | Mengembalikan indeks valid terbesar. |
| CByteArray::InsertAt | Menyisipkan elemen (atau semua elemen dalam array lain) pada indeks tertentu. |
| CByteArray::IsEmpty | Menentukan apakah array kosong. |
| CByteArray::RemoveAll | Menghapus semua elemen dari array ini. |
| CByteArray::RemoveAt | Menghapus elemen pada indeks tertentu. |
| CByteArray::SetAt | Mengatur nilai untuk indeks tertentu; array tidak diizinkan untuk tumbuh. |
| CByteArray::SetAtGrow | Mengatur nilai untuk indeks tertentu; menumbuhkan array jika perlu. |
| CByteArray::SetSize | Mengatur jumlah elemen yang akan dimuat dalam array ini. |
Operator Publik
| Nama | Deskripsi |
|---|---|
| CByteArray::operator [ ] | Mengatur atau mendapatkan elemen pada indeks yang ditentukan. |
Keterangan
CByteArray menggabungkan makro IMPLEMENT_SERIAL untuk mendukung serialisasi dan pembuangan elemennya. Jika array byte disimpan ke arsip, baik dengan operator penyisipan berlebih ( <<) atau dengan Serialize fungsi anggota, setiap elemen, pada gilirannya, diserialisasikan.
Catatan
Sebelum menggunakan array, gunakan SetSize untuk menetapkan ukurannya dan mengalokasikan memori untuk array tersebut. Jika Anda tidak menggunakan SetSize, menambahkan elemen ke array Anda menyebabkannya sering direalokasi dan disalin. Realokasi dan penyalinan yang sering tidak efisien dan dapat memfragmentasi memori.
Jika Anda memerlukan output debug dari elemen individual dalam array, Anda harus mengatur kedalaman CDumpContext objek ke 1 atau lebih besar.
Untuk informasi selengkapnya tentang menggunakan CByteArray, lihat artikel Koleksi.
Hierarki Warisan
CByteArray
Persyaratan
Header: afxcoll.h