CStringArray Kelas
Mendukung array CString objek.
Sintaks
class CStringArray : public CObject
Anggota
Fungsi CStringArray 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 nilai pengembalian, ganti CString objek (bukan CString penunjuk). Di mana pun Anda melihat CObject penunjuk sebagai parameter fungsi, ganti LPCTSTR.
CObject* CObArray::GetAt( int <nIndex> ) const;
misalnya, diterjemahkan ke
const CString& CStringArray::GetAt( int <nIndex> ) const;
dan
void SetAt( int <nIndex>, CObject* <newElement> )
diterjemahkan ke
void SetAt( int <nIndex>, LPCTSTR <newElement> )
Konstruktor Publik
| Nama | Deskripsi |
|---|---|
CStringArray::CStringArray |
Membuat array kosong. |
Metode Publik
| Nama | Deskripsi |
|---|---|
CStringArray::Add |
Menambahkan elemen ke akhir array; menumbuhkan array jika perlu. |
CStringArray::Append |
Menambahkan array lain ke array; menumbuhkan array jika perlu. |
CStringArray::Copy |
Menyalin array lain ke array; menumbuhkan array jika perlu. |
CStringArray::ElementAt |
Mengembalikan referensi sementara ke penunjuk elemen dalam array. |
CStringArray::FreeExtra |
Membebaskan semua memori yang tidak digunakan di atas batas atas saat ini. |
CStringArray::GetAt |
Mengembalikan nilai pada indeks tertentu. |
CStringArray::GetCount |
Mendapatkan jumlah elemen dalam array ini. |
CStringArray::GetData |
Memungkinkan akses ke elemen dalam array. Bisa jadi NULL. |
CStringArray::GetSize |
Mendapatkan jumlah elemen dalam array ini. |
CStringArray::GetUpperBound |
Mengembalikan indeks valid terbesar. |
CStringArray::InsertAt |
Menyisipkan elemen (atau semua elemen dalam array lain) pada indeks tertentu. |
CStringArray::IsEmpty |
Menentukan apakah array kosong. |
CStringArray::RemoveAll |
Menghapus semua elemen dari array ini. |
CStringArray::RemoveAt |
Menghapus elemen pada indeks tertentu. |
CStringArray::SetAt |
Mengatur nilai untuk indeks tertentu; array tidak diizinkan untuk tumbuh. |
CStringArray::SetAtGrow |
Mengatur nilai untuk indeks tertentu; menumbuhkan array jika perlu. |
CStringArray::SetSize |
Mengatur jumlah elemen yang akan dimuat dalam array ini. |
Operator Publik
| Nama | Deskripsi |
|---|---|
CStringArray::operator [ ] |
Mengatur atau mendapatkan elemen pada indeks yang ditentukan. |
Keterangan
CStringArray menggabungkan IMPLEMENT_SERIAL makro untuk mendukung serialisasi dan pembuangan elemennya. Jika array CString objek disimpan ke arsip, baik dengan operator penyisipan yang kelebihan beban atau dengan Serialize fungsi anggota, setiap elemen diserialisasikan pada gilirannya.
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 cadangan elemen string individual dalam array, Anda harus mengatur kedalaman konteks cadangan ke 1 atau lebih besar.
CString Saat array dihapus, atau ketika elemennya dihapus, memori string dibebaskan sesuai.
Untuk informasi selengkapnya tentang menggunakan CStringArray, lihat artikel Koleksi.
Hierarki Warisan
CStringArray
Persyaratan
Header: afxcoll.h