Bagikan melalui

Kelas CTypedPtrArray

  • Artikel

Menyediakan "pembungkus" jenis aman untuk objek kelas CPtrArray atau CObArray.

Sintaks

template<class BASE_CLASS, class TYPE>
class CTypedPtrArray : public BASE_CLASS

Parameter

BASE_CLASS
Kelas dasar kelas array pointer yang ditik; harus berupa kelas array ( CObArray atau CPtrArray).

KETIK
Jenis elemen yang disimpan dalam array kelas dasar.

Anggota

Metode Publik

Nama Deskripsi
CTypedPtrArray::Add Menambahkan elemen baru ke akhir array. Menumbuhkan array jika perlu
CTypedPtrArray::Tambahkan Menambahkan konten dari satu array ke akhir array lainnya. Menumbuhkan array jika perlu
CTypedPtrArray::Copy Menyalin array lain ke array; menumbuhkan array jika perlu.
CTypedPtrArray::ElementAt Mengembalikan referensi sementara ke penunjuk elemen dalam array.
CTypedPtrArray::GetAt Mengembalikan nilai pada indeks tertentu.
CTypedPtrArray::InsertAt Menyisipkan elemen (atau semua elemen dalam array lain) pada indeks tertentu.
CTypedPtrArray::SetAt Mengatur nilai untuk indeks tertentu; array tidak diizinkan untuk tumbuh.
CTypedPtrArray::SetAtGrow Mengatur nilai untuk indeks tertentu; menumbuhkan array jika perlu.

Operator Publik

Nama Deskripsi
CTypedPtrArray::operator [ ] Mengatur atau mendapatkan elemen pada indeks yang ditentukan.

Keterangan

Ketika Anda menggunakan CTypedPtrArray daripada CPtrArray atau CObArray, fasilitas pemeriksaan jenis C++ membantu menghilangkan kesalahan yang disebabkan oleh jenis penunjuk yang tidak cocok.

Selain itu, pembungkus CTypedPtrArray melakukan banyak transmisi yang akan diperlukan jika Anda menggunakan CObArray atau CPtrArray.

Karena semua CTypedPtrArray fungsi sebaris, penggunaan templat ini tidak secara signifikan memengaruhi ukuran atau kecepatan kode Anda.

Untuk informasi selengkapnya tentang menggunakan CTypedPtrArray, lihat artikel Koleksi dan Kelas Berbasis Templat.

Hierarki Warisan

BASE_CLASS

CTypedPtrArray

Persyaratan

Header: afxtempl.h

CTypedPtrArray::Add

Fungsi anggota ini memanggil BASE_CLASS::Add.

INT_PTR Add(TYPE newElement);

Parameter

KETIK
Parameter templat yang menentukan jenis elemen yang akan ditambahkan ke array.

newElement
Elemen yang akan ditambahkan ke array ini.

Tampilkan Nilai

Indeks elemen yang ditambahkan.

Keterangan

Untuk keterangan lebih rinci, lihat CObArray::Add.

CTypedPtrArray::Tambahkan

Fungsi anggota ini memanggil BASE_CLASS::Tambahkan**.

INT_PTR Append(const CTypedPtrArray<BASE_CLASS, TYPE>& src);

Parameter

BASE_CLASS
Kelas dasar kelas array pointer yang ditik; harus berupa kelas array ( CObArray atau CPtrArray).

KETIK
Jenis elemen yang disimpan dalam array kelas dasar.

src
Sumber elemen yang akan ditambahkan ke array.

Tampilkan Nilai

Indeks elemen pertama yang ditambahkan.

Keterangan

Untuk keterangan lebih rinci, lihat CObArray::Tambahkan.

CTypedPtrArray::Copy

Fungsi anggota ini memanggil BASE_CLASS::Copy.

void Copy(const CTypedPtrArray<BASE_CLASS, TYPE>& src);

Parameter

BASE_CLASS
Kelas dasar kelas array pointer yang ditik; harus berupa kelas array ( CObArray atau CPtrArray).

KETIK
Jenis elemen yang disimpan dalam array kelas dasar.

src
Sumber elemen yang akan disalin ke array.

Keterangan

Untuk keterangan lebih rinci, lihat CObArray::Copy.

CTypedPtrArray::ElementAt

Fungsi sebaris ini memanggil BASE_CLASS::ElementAt.

TYPE& ElementAt(INT_PTR nIndex);

Parameter

KETIK
Parameter templat yang menentukan jenis elemen yang disimpan dalam array ini.

nIndex
Indeks bilangan bulat yang lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan nilai yang dikembalikan oleh BASE_CLASS::GetUpperBound.

Tampilkan Nilai

Referensi sementara ke elemen di lokasi yang ditentukan oleh nIndex. Elemen ini adalah jenis yang ditentukan oleh jenis parameter templat.

Keterangan

Untuk keterangan lebih rinci, lihat CObArray::ElementAt.

CTypedPtrArray::GetAt

Fungsi sebaris ini memanggil BASE_CLASS::GetAt.

TYPE GetAt(INT_PTR nIndex) const;

Parameter

KETIK
Parameter templat yang menentukan jenis elemen yang disimpan dalam array.

nIndex
Indeks bilangan bulat yang lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan nilai yang dikembalikan oleh BASE_CLASS::GetUpperBound.

Tampilkan Nilai

Salinan elemen di lokasi yang ditentukan oleh nIndex. Elemen ini adalah jenis yang ditentukan oleh jenis parameter templat.

Keterangan

Untuk keterangan lebih rinci, lihat CObArray::GetAt

CTypedPtrArray::InsertAt

Fungsi anggota ini memanggil BASE_CLASS::InsertAt.

void InsertAt(
    INT_PTR nIndex,
    TYPE newElement,
    INT_PTR nCount = 1);

void InsertAt(
    INT_PTR nStartIndex,
    CTypedPtrArray<BASE_CLASS, TYPE>* pNewArray);

Parameter

nIndex
Indeks bilangan bulat yang mungkin lebih besar dari nilai yang dikembalikan oleh CObArray::GetUpperBound.

KETIK
Jenis elemen yang disimpan dalam array kelas dasar.

newElement
Penunjuk objek yang akan ditempatkan dalam array ini. NewElement nilai NULL diizinkan.

nCount
Frekuensi elemen ini harus disisipkan (default ke 1).

nStartIndex
Indeks bilangan bulat yang mungkin lebih besar dari nilai yang dikembalikan oleh CObArray::GetUpperBound.

BASE_CLASS
Kelas dasar kelas array pointer yang ditik; harus berupa kelas array ( CObArray atau CPtrArray).

pNewArray
Array lain yang berisi elemen yang akan ditambahkan ke array ini.

Keterangan

Untuk keterangan lebih rinci, lihat CObArray::InsertAt.

CTypedPtrArray::operator [ ]

Operator sebaris ini memanggil BASE_CLASS::operator [ ].

TYPE& operator[ ](int_ptr nindex);
TYPE operator[ ](int_ptr nindex) const;

Parameter

KETIK
Parameter templat yang menentukan jenis elemen yang disimpan dalam array.

nIndex
Indeks bilangan bulat yang lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan nilai yang dikembalikan oleh BASE_CLASS::GetUpperBound.

Keterangan

Operator pertama, yang dipanggil untuk array yang bukan const, dapat digunakan di kanan (r-value) atau kiri (nilai l) dari pernyataan penugasan. Yang kedua, yang dipanggil untuk const array, hanya dapat digunakan di sebelah kanan.

Versi Debug pustaka menegaskan jika subskrip (baik di sisi kiri atau kanan pernyataan penugasan) berada di luar batas.

CTypedPtrArray::SetAt

Fungsi anggota ini memanggil BASE_CLASS::SetAt.

void SetAt(
    INT_PTR nIndex,
    TYPE ptr);

Parameter

nIndex
Indeks bilangan bulat yang lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan nilai yang dikembalikan oleh CObArray::GetUpperBound.

KETIK
Jenis elemen yang disimpan dalam array kelas dasar.

ptr
Penunjuk ke elemen yang akan disisipkan dalam array di nIndex. Nilai NULL diperbolehkan.

Keterangan

Untuk keterangan lebih rinci, lihat CObArray::SetAt.

CTypedPtrArray::SetAtGrow

Fungsi anggota ini memanggil BASE_CLASS::SetAtGrow.

void SetAtGrow(
    INT_PTR nIndex,
    TYPE newElement);

Parameter

nIndex
Indeks bilangan bulat yang lebih besar dari atau sama dengan 0.

KETIK
Jenis elemen yang disimpan dalam array kelas dasar.

newElement
Penunjuk objek yang akan ditambahkan ke array ini. Nilai NULL diperbolehkan.

Keterangan

Untuk keterangan lebih rinci, lihat CObArray::SetAtGrow.

Lihat juga

Sampel MFC COLLECT
Bagan Hierarki
Kelas CPtrArray
Kelas CObArray