Kelas CTypedPtrMap

Menyediakan "pembungkus" yang aman untuk objek kelas CMapPtrToPtrpeta penunjuk , , CMapPtrToWord, CMapWordToPtrdan CMapStringToPtr.

Sintaks

template<class BASE_CLASS, class KEY, class VALUE>
class CTypedPtrMap : public BASE_CLASS

Parameter

BASE_CLASS
Kelas dasar kelas peta pointer yang ditik; harus merupakan kelas peta pointer ( CMapPtrToPtr, , CMapPtrToWord, CMapWordToPtratau CMapStringToPtr).

KEY
Kelas objek yang digunakan sebagai kunci ke peta.

NILAI
Kelas objek yang disimpan di peta.

Anggota

Metode Publik

Nama	Deskripsi
CTypedPtrMap::GetNextAssoc	Mendapatkan elemen berikutnya untuk iterasi.
CTypedPtrMap::Lookup	Mengembalikan KEY berdasarkan VALUE.
CTypedPtrMap::RemoveKey	Menghapus elemen yang ditentukan oleh kunci.
CTypedPtrMap::SetAt	Menyisipkan elemen ke dalam peta; menggantikan elemen yang ada jika kunci yang cocok ditemukan.

Operator Publik

Nama	Deskripsi
CTypedPtrMap::operator [ ]	Menyisipkan elemen ke dalam peta.

Keterangan

Saat Anda menggunakan CTypedPtrMap, fasilitas pemeriksaan jenis C++ membantu menghilangkan kesalahan yang disebabkan oleh jenis penunjuk yang tidak cocok.

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

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

Hierarki Warisan

BASE_CLASS

CTypedPtrMap

Persyaratan

Header: afxtempl.h

CTypedPtrMap::GetNextAssoc

Mengambil elemen peta di rNextPosition, lalu memperbarui rNextPosition untuk merujuk ke elemen berikutnya di peta.

void GetNextAssoc(
    POSITION& rPosition,
    KEY& rKey,
    VALUE& rValue) const;

Parameter

rPosisi
Menentukan referensi ke nilai POSITION yang dikembalikan oleh panggilan sebelumnya GetNextAssoc atau BASE_CLASS::GetStartPosition .

KEY
Parameter templat yang menentukan jenis kunci peta.

rKey
Menentukan kunci yang dikembalikan dari elemen yang diambil.

NILAI
Parameter templat yang menentukan jenis nilai peta.

rValue
Menentukan nilai yang dikembalikan dari elemen yang diambil.

Keterangan

Fungsi ini paling berguna untuk iterasi melalui semua elemen di peta. Perhatikan bahwa urutan posisi belum tentu sama dengan urutan nilai kunci.

Jika elemen yang diambil adalah yang terakhir dalam peta, maka nilai rNextPosition baru diatur ke NULL.

Fungsi sebaris ini memanggil BASE_CLASS::GetNextAssoc.

CTypedPtrMap::Lookup

Lookup menggunakan algoritma hashing untuk menemukan elemen peta dengan cepat dengan kunci yang cocok persis.

BOOL Lookup(BASE_CLASS ::BASE_ARG_KEY key, VALUE& rValue) const;

Parameter

BASE_CLASS
Parameter templat yang menentukan kelas dasar kelas peta ini.

kunci
Kunci elemen yang akan dicari.

NILAI
Parameter templat yang menentukan jenis nilai yang disimpan dalam peta ini.

rValue
Menentukan nilai yang dikembalikan dari elemen yang diambil.

Tampilkan Nilai

Bukan nol jika elemen ditemukan; jika tidak, 0.

Keterangan

Fungsi sebaris ini memanggil BASE_CLASS::Lookup.

CTypedPtrMap::operator [ ]

Operator ini hanya dapat digunakan di sisi kiri pernyataan penugasan (nilai l).

VALUE& operator[ ](base_class ::base_arg_key key);

Parameter

NILAI
Parameter templat yang menentukan jenis nilai yang disimpan dalam peta ini.

BASE_CLASS
Parameter templat yang menentukan kelas dasar kelas peta ini.

kunci
Kunci elemen yang akan dicari atau dibuat di peta.

Keterangan

Jika tidak ada elemen peta dengan kunci yang ditentukan, maka elemen baru dibuat. Tidak ada "sisi kanan" (r-value) yang setara dengan operator ini karena ada kemungkinan bahwa kunci mungkin tidak ditemukan di peta. Lookup Gunakan fungsi anggota untuk pengambilan elemen.

CTypedPtrMap::RemoveKey

Fungsi anggota ini memanggil BASE_CLASS::RemoveKey.

BOOL RemoveKey(KEY key);

Parameter

KEY
Parameter templat yang menentukan jenis kunci peta.

kunci
Kunci untuk elemen yang akan dihapus.

Tampilkan Nilai

Bukan nol jika entri ditemukan dan berhasil dihapus; jika tidak, 0.

Keterangan

Untuk keterangan lebih rinci, lihat CMapStringToOb::RemoveKey.

CTypedPtrMap::SetAt

Fungsi anggota ini memanggil BASE_CLASS::SetAt.

void SetAt(KEY key, VALUE newValue);

Parameter

KEY
Parameter templat yang menentukan jenis kunci peta.

kunci
Menentukan nilai kunci dari newValue.

nilainilai baru
Menentukan penunjuk objek yang merupakan nilai elemen baru.

Keterangan

Untuk keterangan lebih rinci, lihat CMapStringToOb::SetAt.

Lihat juga

Sampel MFC COLLECT
Bagan Hierarki
Kelas CMapPtrToPtr
Kelas CMapPtrToWord
Kelas CMapWordToPtr
Kelas CMapStringToPtr