Kelas CPtrArray
Mendukung array penunjuk kekosongan.
Sintaks
class CPtrArray : public CObject
Anggota
Fungsi CPtrArray 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 penunjuk sebagai parameter fungsi atau mengembalikan nilai, ganti penunjuk ke void.
CObject* CObArray::GetAt( int <nIndex> ) const;
misalnya, diterjemahkan ke
void* CPtrArray::GetAt( int <nIndex> ) const;
Konstruktor Publik
| Nama | Deskripsi |
|---|---|
| CPtrArray::CPtrArray | Membuat array kosong. |
Metode Publik
| Nama | Deskripsi |
|---|---|
| CPtrArray::Tambahkan | Menambahkan elemen ke akhir array; menumbuhkan array jika perlu. |
| CPtrArray::Tambahkan | Menambahkan array lain ke array; menumbuhkan array jika perlu. |
| CPtrArray::Copy | Menyalin array lain ke array; menumbuhkan array jika perlu. |
| CPtrArray::ElementAt | Mengembalikan referensi sementara ke penunjuk elemen dalam array. |
| CPtrArray::FreeExtra | Membebaskan semua memori yang tidak digunakan di atas batas atas saat ini. |
| CPtrArray::GetAt | Mengembalikan nilai pada indeks tertentu. |
| CPtrArray::GetCount | Mendapatkan jumlah elemen dalam array ini. |
| CPtrArray::GetData | Memungkinkan akses ke elemen dalam array. Bisa jadi NULL. |
| CPtrArray::GetSize | Mendapatkan jumlah elemen dalam array ini. |
| CPtrArray::GetUpperBound | Mengembalikan indeks valid terbesar. |
| CPtrArray::InsertAt | Menyisipkan elemen (atau semua elemen dalam array lain) pada indeks tertentu. |
| CPtrArray::IsEmpty | Menentukan apakah array kosong. |
| CPtrArray::RemoveAll | Menghapus semua elemen dari array ini. |
| CPtrArray::RemoveAt | Menghapus elemen pada indeks tertentu. |
| CPtrArray::SetAt | Mengatur nilai untuk indeks tertentu; array tidak diizinkan untuk tumbuh. |
| CPtrArray::SetAtGrow | Mengatur nilai untuk indeks tertentu; menumbuhkan array jika perlu. |
| CPtrArray::SetSize | Mengatur jumlah elemen yang akan dimuat dalam array ini. |
Operator Publik
| Nama | Deskripsi |
|---|---|
| CPtrArray::operator [ ] | Mengatur atau mendapatkan elemen pada indeks yang ditentukan. |
Keterangan
CPtrArray menggabungkan makro IMPLEMENT_DYNAMIC untuk mendukung akses jenis run-time dan pembuangan ke CDumpContext objek. Jika Anda memerlukan cadangan elemen array pointer individual, Anda harus mengatur kedalaman konteks cadangan ke 1 atau lebih besar.
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.
Array penunjuk tidak dapat diserialisasikan.
Saat array pointer dihapus, atau ketika elemennya dihapus, hanya pointer yang dihapus, bukan entitas yang mereka referensikan.
Untuk informasi selengkapnya tentang menggunakan CPtrArray, lihat artikel Koleksi.
Hierarki Warisan
CPtrArray
Persyaratan
Header: afxcoll.h