Kelas CSimpleArray

Kelas ini menyediakan metode untuk mengelola array sederhana.

Sintaks

template <class T, class TEqual = CSimpleArrayEqualHelper<T>>
class CSimpleArray

Parameter

T
Jenis data yang akan disimpan dalam array.

TEqual
Objek sifat, menentukan uji kesetaraan untuk elemen jenis T.

Anggota

Konstruktor Publik

Metode Publik

Operator Publik

Keterangan

CSimpleArray menyediakan metode untuk membuat dan mengelola array sederhana, dari jenis Ttertentu .

Parameter TEqual menyediakan sarana untuk menentukan fungsi kesetaraan untuk dua elemen jenis T. Dengan membuat kelas yang mirip dengan CSimpleArrayEqualHelper, dimungkinkan untuk mengubah perilaku uji kesetaraan untuk array tertentu. Misalnya, saat berhadapan dengan array pointer, mungkin berguna untuk menentukan kesetaraan sebagai tergantung pada nilai referensi pointer. Implementasi default menggunakan operator=().

CSimpleMap CSimpleArray dan dirancang untuk sejumlah kecil elemen. CAtlArray dan CAtlMap harus digunakan ketika array berisi sejumlah besar elemen.

Persyaratan

Header: atlsimpcoll.h

Contoh

// Create an array of integers
CSimpleArray<int> iArray;

// Create an array of char pointers
// and use a new equality function
CSimpleArray<char *, MyEqualityEqualHelper<char *> > cMyArray;   

CSimpleArray::Add

Menambahkan elemen baru ke array.

BOOL Add(const T& t);

Parameter

t
Elemen yang akan ditambahkan ke array.

Tampilkan Nilai

Mengembalikan TRUE jika elemen berhasil ditambahkan ke array, FALSE jika tidak.

Contoh

// Create an array of integers and add some elements
CSimpleArray<int> iMyArray;
for (int i = 0; i < 10; i++)
   iMyArray.Add(i);  

CSimpleArray::CSimpleArray

Konstruktor untuk objek array.

CSimpleArray(const CSimpleArray<T, TEqual>& src);
CSimpleArray();

Parameter

src
Objek yang CSimpleArray sudah ada.

Keterangan

Menginisialisasi anggota data, membuat objek kosong CSimpleArray baru, atau salinan objek yang sudah ada CSimpleArray .

CSimpleArray::~CSimpleArray

Destruktor.

~CSimpleArray();

Keterangan

Membebaskan semua sumber daya yang dialokasikan.

CSimpleArray::Find

Menemukan elemen dalam array.

int Find(const T& t) const;

Parameter

t
Elemen yang akan dicari.

Tampilkan Nilai

Mengembalikan indeks elemen yang ditemukan, atau -1 jika elemen tidak ditemukan.

Contoh

// Create an array of floats and search for a particular element

CSimpleArray<float> fMyArray;

for (int i = 0; i < 10; i++)
   fMyArray.Add((float)i * 100);

int e = fMyArray.Find(200);
if (e == -1)
   _tprintf_s(_T("Could not find element\n"));
else
   _tprintf_s(_T("Found the element at location %d\n"), e);   

CSimpleArray::GetData

Mengembalikan penunjuk ke data yang disimpan dalam array.

T* GetData() const;

Tampilkan Nilai

Mengembalikan penunjuk ke data dalam array.

CSimpleArray::GetSize

Mengembalikan jumlah elemen yang disimpan dalam array.

int GetSize() const;

Tampilkan Nilai

Mengembalikan jumlah elemen yang disimpan dalam array.

CSimpleArray::operator []

Mengambil elemen dari array.

T& operator[](int nindex);

Parameter

nIndex
Indeks elemen.

Tampilkan Nilai

Mengembalikan elemen array yang dirujuk oleh nIndex.

Contoh

// Create an array and display its contents
 CSimpleArray<int> iMySampleArray;

 for (int i = 0; i < 10; i++)
    iMySampleArray.Add(i);

 for (int i = 0; i < iMySampleArray.GetSize(); i++)
    _tprintf_s(_T("Array index %d contains %d\n"), i, iMySampleArray[i]);

CSimpleArray::operator =

Operator penugasan.

CSimpleArray<T, TEqual>
& operator=(
    const CSimpleArray<T, TEqual>& src);

Parameter

src
Array yang akan disalin.

Tampilkan Nilai

Mengembalikan penunjuk ke objek yang diperbarui CSimpleArray .

Keterangan

Menyalin semua elemen dari objek yang direferensikan CSimpleArray oleh src ke dalam objek array saat ini, menggantikan semua data yang ada.

Contoh

// Create an array of chars and copy it to a second array
CSimpleArray<char> cMyArray1;
cMyArray1.Add('a');
CSimpleArray<char> cMyArray2;
cMyArray2 = cMyArray1;
ATLASSERT(cMyArray2[0] == 'a');   

CSimpleArray::Hapus

Menghapus elemen tertentu dari array.

BOOL Remove(const T& t);

Parameter

t
Elemen yang akan dihapus dari array.

Tampilkan Nilai

Mengembalikan TRUE jika elemen ditemukan dan dihapus, FALSE jika tidak.

Keterangan

Ketika elemen dihapus, elemen yang tersisa dalam array dihidung ulang untuk mengisi ruang kosong.

CSimpleArray::RemoveAll

Menghapus semua elemen dari array.

void RemoveAll();

Keterangan

Menghapus semua elemen yang saat ini disimpan dalam array.

CSimpleArray::RemoveAt

Menghapus elemen yang ditentukan dari array.

BOOL RemoveAt(int nIndex);

Parameter

nIndex
Indeks yang menunjuk ke elemen yang akan dihapus.

Tampilkan Nilai

Mengembalikan TRUE jika elemen dihapus, FALSE jika indeks tidak valid.

Keterangan

Ketika elemen dihapus, elemen yang tersisa dalam array dihidung ulang untuk mengisi ruang kosong.

CSimpleArray::SetAtIndex

Atur elemen yang ditentukan dalam array.

BOOL SetAtIndex(
    int nIndex,
    const T& t);

Parameter

nIndex
Indeks elemen yang akan diubah.

t
Nilai yang akan ditetapkan ke elemen yang ditentukan.

Tampilkan Nilai

Mengembalikan TRUE jika berhasil, FALSE jika indeks tidak valid.

Lihat juga

Gambaran Umum Kelas