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

CObject

CStringArray

Persyaratan

Header: afxcoll.h

Lihat juga

CObject Kelas
Bagan Hierarki