Kelas CAtlMap
Kelas ini menyediakan metode untuk membuat dan mengelola objek peta.
Sintaks
template <typename K,
typename V,
class KTraits = CElementTraits<K>,
class VTraits = CElementTraits<V>>
class CAtlMap
Parameter
K
Jenis elemen kunci.
V
Jenis elemen nilai.
KTraits
Kode yang digunakan untuk menyalin atau memindahkan elemen kunci. Lihat Kelas CElementTraits untuk detail selengkapnya.
VTraits
Kode yang digunakan untuk menyalin atau memindahkan elemen nilai.
Anggota
Typedef Publik
Nama | Deskripsi |
---|---|
CAtlMap::KINARGTYPE | Jenis yang digunakan saat kunci diteruskan sebagai argumen input |
CAtlMap::KOUTARGTYPE | Jenis yang digunakan saat kunci dikembalikan sebagai argumen output. |
CAtlMap::VINARGTYPE | Jenis yang digunakan saat nilai diteruskan sebagai argumen input. |
CAtlMap::VOUTARGTYPE | Jenis yang digunakan saat nilai diteruskan sebagai argumen output. |
Kelas Publik
Nama | Deskripsi |
---|---|
CAtlMap::CPair Class | Kelas yang berisi elemen kunci dan nilai. |
Anggota Data CPair
Nama | Deskripsi |
---|---|
CPair::m_key | Anggota data yang menyimpan elemen kunci. |
CPair::m_value | Anggota data yang menyimpan elemen nilai. |
Konstruktor Publik
Nama | Deskripsi |
---|---|
CAtlMap::CAtlMap | Konstruktor. |
CAtlMap::~CAtlMap | Destruktor. |
Metode Publik
Nama | Deskripsi |
---|---|
CAtlMap::AssertValid | Panggil metode ini untuk menyebabkan ASSERT jika CAtlMap tidak valid. |
CAtlMap::D isableAutoRehash | Panggil metode ini untuk menonaktifkan pengulangan CAtlMap otomatis objek. |
CAtlMap::EnableAutoRehash | Panggil metode ini untuk mengaktifkan pengulangan CAtlMap otomatis objek. |
CAtlMap::GetAt | Panggil metode ini untuk mengembalikan elemen pada posisi tertentu di peta. |
CAtlMap::GetCount | Panggil metode ini untuk mengambil jumlah elemen dalam peta. |
CAtlMap::GetHashTableSize | Panggil metode ini untuk menentukan jumlah bin dalam tabel hash peta. |
CAtlMap::GetKeyAt | Panggil metode ini untuk mengambil kunci yang disimpan pada posisi yang diberikan dalam CAtlMap objek. |
CAtlMap::GetNext | Panggil metode ini untuk mendapatkan penunjuk ke pasangan elemen berikutnya yang disimpan dalam CAtlMap objek. |
CAtlMap::GetNextAssoc | Mendapatkan elemen berikutnya untuk iterasi. |
CAtlMap::GetNextKey | Panggil metode ini untuk mengambil kunci berikutnya dari CAtlMap objek. |
CAtlMap::GetNextValue | Panggil metode ini untuk mendapatkan nilai berikutnya dari CAtlMap objek. |
CAtlMap::GetStartPosition | Panggil metode ini untuk memulai iterasi peta. |
CAtlMap::GetValueAt | Panggil metode ini untuk mengambil nilai yang disimpan pada posisi tertentu dalam CAtlMap objek. |
CAtlMap::InitHashTable | Panggil metode ini untuk menginisialisasi tabel hash. |
CAtlMap::IsEmpty | Panggil metode ini untuk menguji objek peta kosong. |
CAtlMap::Lookup | Panggil metode ini untuk mencari kunci atau nilai dalam CAtlMap objek. |
CAtlMap::Rehash | Panggil metode ini untuk merehash CAtlMap objek. |
CAtlMap::RemoveAll | Panggil metode ini untuk menghapus semua elemen dari CAtlMap objek. |
CAtlMap::RemoveAtPos | Panggil metode ini untuk menghapus elemen pada posisi yang diberikan dalam CAtlMap objek. |
CAtlMap::RemoveKey | Panggil metode ini untuk menghapus elemen dari CAtlMap objek, mengingat kuncinya. |
CAtlMap::SetAt | Panggil metode ini untuk menyisipkan pasangan elemen ke dalam peta. |
CAtlMap::SetOptimalLoad | Panggil metode ini untuk mengatur beban CAtlMap optimal objek. |
CAtlMap::SetValueAt | Panggil metode ini untuk mengubah nilai yang disimpan pada posisi tertentu dalam CAtlMap objek. |
Operator Publik
Nama | Deskripsi |
---|---|
CAtlMap::operator[] | Mengganti atau menambahkan elemen baru ke CAtlMap . |
Keterangan
CAtlMap
menyediakan dukungan untuk array pemetaan dari jenis tertentu, mengelola array elemen kunci yang tidak diurutkan dan nilai terkaitnya. Elemen (terdiri dari kunci dan nilai) disimpan menggunakan algoritma hashing, memungkinkan sejumlah besar data disimpan dan diambil secara efisien.
Parameter KTraits dan VTraits adalah kelas sifat yang berisi kode tambahan apa pun yang diperlukan untuk menyalin atau memindahkan elemen.
Alternatif untuk CAtlMap
ditawarkan oleh kelas CRBMap . CRBMap
juga menyimpan pasangan kunci/nilai, tetapi menunjukkan karakteristik performa yang berbeda. Waktu yang diperlukan untuk menyisipkan item, mencari kunci, atau menghapus kunci dari CRBMap
objek adalah log pesanan (n), di mana n adalah jumlah elemen. Untuk CAtlMap
, semua operasi ini biasanya memakan waktu konstan, meskipun skenario terburuk mungkin berurutan n. Oleh karena itu, dalam kasus umum, CAtlMap
lebih cepat.
Perbedaan lain antara CRBMap
dan CAtlMap
menjadi jelas ketika melakukan iterasi melalui elemen yang disimpan. CRBMap
Dalam , elemen dikunjungi dalam urutan yang diurutkan. CAtlMap
Dalam , elemen tidak diurutkan, dan tidak ada urutan yang dapat disimpulkan.
Ketika sejumlah kecil elemen perlu disimpan, pertimbangkan untuk menggunakan kelas CSimpleMap sebagai gantinya.
Untuk informasi selengkapnya, lihat Kelas Koleksi ATL.
Persyaratan
Header: atlcoll.h
CAtlMap::AssertValid
Panggil metode ini untuk menyebabkan ASSERT jika CAtlMap
objek tidak valid.
void AssertValid() const;
Keterangan
Dalam build debug, metode ini akan menyebabkan ASSERT jika CAtlMap
objek tidak valid.
Contoh
Lihat contoh untuk CAtlMap::CAtlMap.
CAtlMap::CAtlMap
Konstruktor.
CAtlMap(
UINT nBins = 17,
float fOptimalLoad = 0.75f,
float fLoThreshold = 0.25f,
float fHiThreshold = 2.25f,
UINT nBlockSize = 10) throw ();
Parameter
nBins
Jumlah bin yang menyediakan pointer ke elemen yang disimpan. Lihat Komentar nanti dalam topik ini untuk penjelasan tentang bin.
fOptimalLoad
Rasio beban optimal.
fLoThreshold
Ambang batas bawah untuk rasio beban.
fHiThreshold
Ambang atas untuk rasio beban.
nBlockSize
Ukuran blok.
Keterangan
CAtlMap
mereferensikan semua elemen tersimpannya dengan terlebih dahulu membuat indeks menggunakan algoritma hashing pada kunci. Indeks ini mereferensikan "bin" yang berisi penunjuk ke elemen yang disimpan. Jika bin sudah digunakan, daftar tertaut dibuat untuk mengakses elemen berikutnya. Melintasi daftar lebih lambat daripada mengakses elemen yang benar secara langsung, sehingga struktur peta perlu menyeimbangkan persyaratan penyimpanan terhadap performa. Parameter default telah dipilih untuk memberikan hasil yang baik dalam banyak kasus.
Rasio beban adalah rasio jumlah bin dengan jumlah elemen yang disimpan dalam objek peta. Ketika struktur peta dihitung ulang, nilai parameter fOptimalLoad akan digunakan untuk menghitung jumlah bin yang diperlukan. Nilai ini dapat diubah menggunakan metode CAtlMap::SetOptimalLoad .
Parameter fLoThreshold adalah nilai yang lebih rendah yang dapat dicapai rasio beban sebelum CAtlMap
akan menghitung ulang ukuran peta yang optimal.
Parameter fHiThreshold adalah nilai atas yang dapat dicapai rasio beban sebelum CAtlMap
objek akan menghitung ulang ukuran peta yang optimal.
Proses pengkalaan ulang ini (dikenal sebagai pengulangan ulang) diaktifkan secara default. Jika Anda ingin menonaktifkan proses ini, mungkin saat memasukkan banyak data pada satu waktu, panggil metode CAtlMap::D isableAutoRehash . Aktifkan kembali dengan metode CAtlMap::EnableAutoRehash .
Parameter nBlockSize adalah ukuran jumlah memori yang dialokasikan saat elemen baru diperlukan. Ukuran blok yang lebih besar mengurangi panggilan ke rutinitas alokasi memori, tetapi menggunakan lebih banyak sumber daya.
Sebelum data apa pun dapat disimpan, perlu untuk menginisialisasi tabel hash dengan panggilan ke CAtlMap::InitHashTable.
Contoh
// Create a map which stores a double
// value using an integer key
CAtlMap<int, double> mySinTable;
int i;
// Initialize the Hash Table
mySinTable.InitHashTable(257);
// Add items to the map
for (i = 0; i < 90; i++)
mySinTable[i] = sin((double)i);
// Confirm the map is valid
mySinTable.AssertValid();
// Confirm the number of elements in the map
ATLASSERT(mySinTable.GetCount() == 90);
// Remove elements with even key values
for (i = 0; i < 90; i += 2)
mySinTable.RemoveKey(i);
// Confirm the number of elements in the map
ATLASSERT(mySinTable.GetCount() == 45);
// Walk through all the elements in the map.
// First, get start position.
POSITION pos;
int key;
double value;
pos = mySinTable.GetStartPosition();
// Now iterate the map, element by element
while (pos != NULL)
{
key = mySinTable.GetKeyAt(pos);
value = mySinTable.GetNextValue(pos);
}
CAtlMap::~CAtlMap
Destruktor.
~CAtlMap() throw();
Keterangan
Membebaskan sumber daya yang dialokasikan.
CAtlMap::CPair Class
Kelas yang berisi elemen kunci dan nilai.
class CPair : public __POSITION
Keterangan
Kelas ini digunakan oleh metode CAtlMap::GetNext dan CAtlMap::Lookup untuk mengakses elemen kunci dan nilai yang disimpan dalam struktur pemetaan.
CAtlMap::D isableAutoRehash
Panggil metode ini untuk menonaktifkan pengulangan CAtlMap
otomatis objek.
void DisableAutoRehash() throw();
Keterangan
Ketika pengulangan ulang otomatis diaktifkan (yang secara default), jumlah bin dalam tabel hash akan secara otomatis dihitung ulang jika nilai beban (rasio jumlah bin ke jumlah elemen yang disimpan dalam array) melebihi nilai maksimum atau minimum yang ditentukan pada saat peta dibuat.
DisableAutoRehash
paling berguna ketika sejumlah besar elemen akan ditambahkan ke peta sekaligus. Alih-alih memicu proses pengulangan setiap kali batas terlampaui, lebih efisien untuk memanggil DisableAutoRehash
, menambahkan elemen, dan akhirnya memanggil CAtlMap::EnableAutoRehash.
CAtlMap::EnableAutoRehash
Panggil metode ini untuk mengaktifkan pengulangan CAtlMap
otomatis objek.
void EnableAutoRehash() throw();
Keterangan
Ketika pengulangan ulang otomatis diaktifkan (yang secara default), jumlah bin dalam tabel hash akan secara otomatis dihitung ulang jika nilai beban (rasio jumlah bin ke jumlah elemen yang disimpan dalam array) melebihi nilai maksimum atau minimum yang ditentukan pada saat peta dibuat.
EnableAutoRefresh
paling sering digunakan setelah panggilan ke CAtlMap::D isableAutoRehash.
CAtlMap::GetAt
Panggil metode ini untuk mengembalikan elemen pada posisi tertentu di peta.
void GetAt(
POSITION pos,
KOUTARGTYPE key,
VOUTARGTYPE value) const;
CPair* GetAt(POSITION& pos) throw();
Parameter
pos
Penghitung posisi, dikembalikan oleh panggilan sebelumnya ke CAtlMap::GetNextAssoc atau CAtlMap::GetStartPosition.
kunci
Parameter templat yang menentukan jenis kunci peta.
value
Parameter templat yang menentukan jenis nilai peta.
Tampilkan Nilai
Mengembalikan penunjuk ke pasangan elemen kunci/nilai saat ini yang disimpan di peta.
Keterangan
Dalam build debug, kesalahan pernyataan akan terjadi jika pos sama dengan NULL.
CAtlMap::GetCount
Panggil metode ini untuk mengambil jumlah elemen dalam peta.
size_t GetCount() const throw();
Tampilkan Nilai
Mengembalikan jumlah elemen dalam objek peta. Elemen tunggal adalah pasangan kunci/nilai.
Contoh
Lihat contoh untuk CAtlMap::CAtlMap.
CAtlMap::GetHashTableSize
Panggil metode ini untuk menentukan jumlah bin dalam tabel hash peta.
UINT GetHashTableSize() const throw();
Tampilkan Nilai
Mengembalikan jumlah bin dalam tabel hash. Lihat CAtlMap::CAtlMap untuk penjelasan.
CAtlMap::GetKeyAt
Panggil metode ini untuk mengambil kunci yang disimpan pada posisi yang diberikan dalam CAtlMap
objek.
const K& GetKeyAt(POSITION pos) const throw();
Parameter
pos
Penghitung posisi, dikembalikan oleh panggilan sebelumnya ke CAtlMap::GetNextAssoc atau CAtlMap::GetStartPosition.
Tampilkan Nilai
Mengembalikan referensi ke kunci yang disimpan pada posisi yang diberikan dalam CAtlMap
objek.
Contoh
Lihat contoh untuk CAtlMap::CAtlMap.
CAtlMap::GetNext
Panggil metode ini untuk mendapatkan penunjuk ke pasangan elemen berikutnya yang disimpan dalam CAtlMap
objek.
CPair* GetNext(POSITION& pos) throw();
const CPair* GetNext(POSITION& pos) const throw();
Parameter
pos
Penghitung posisi, dikembalikan oleh panggilan sebelumnya ke CAtlMap::GetNextAssoc atau CAtlMap::GetStartPosition.
Tampilkan Nilai
Mengembalikan penunjuk ke pasangan elemen kunci/nilai berikutnya yang disimpan di peta. Penghitung posisi pos diperbarui setelah setiap panggilan. Jika elemen yang diambil adalah yang terakhir dalam peta, pos diatur ke NULL.
CAtlMap::GetNextAssoc
Mendapatkan elemen berikutnya untuk iterasi.
void GetNextAssoc(
POSITION& pos,
KOUTARGTYPE key,
VOUTARGTYPE value) const;
Parameter
pos
Penghitung posisi, dikembalikan oleh panggilan sebelumnya ke CAtlMap::GetNextAssoc atau CAtlMap::GetStartPosition.
kunci
Parameter templat yang menentukan jenis kunci peta.
value
Parameter templat yang menentukan jenis nilai peta.
Keterangan
Penghitung posisi pos diperbarui setelah setiap panggilan. Jika elemen yang diambil adalah yang terakhir dalam peta, pos diatur ke NULL.
CAtlMap::GetNextKey
Panggil metode ini untuk mengambil kunci berikutnya dari CAtlMap
objek.
const K& GetNextKey(POSITION& pos) const throw();
Parameter
pos
Penghitung posisi, dikembalikan oleh panggilan sebelumnya ke CAtlMap::GetNextAssoc atau CAtlMap::GetStartPosition.
Tampilkan Nilai
Mengembalikan referensi ke kunci berikutnya di peta.
Keterangan
Memperbarui penghitung posisi saat ini, pos. Jika tidak ada entri lagi di peta, penghitung posisi diatur ke NULL.
CAtlMap::GetNextValue
Panggil metode ini untuk mendapatkan nilai berikutnya dari CAtlMap
objek.
V& GetNextValue(POSITION& pos) throw();
const V& GetNextValue(POSITION& pos) const throw();
Parameter
pos
Penghitung posisi, dikembalikan oleh panggilan sebelumnya ke CAtlMap::GetNextAssoc atau CAtlMap::GetStartPosition.
Tampilkan Nilai
Mengembalikan referensi ke nilai berikutnya dalam peta.
Keterangan
Memperbarui penghitung posisi saat ini, pos. Jika tidak ada entri lagi di peta, penghitung posisi diatur ke NULL.
Contoh
Lihat contoh untuk CAtlMap::CAtlMap.
CAtlMap::GetStartPosition
Panggil metode ini untuk memulai iterasi peta.
POSITION GetStartPosition() const throw();
Tampilkan Nilai
Mengembalikan posisi mulai, atau NULL dikembalikan jika peta kosong.
Keterangan
Panggil metode ini untuk memulai iterasi peta dengan mengembalikan nilai POSITION yang dapat diteruskan ke GetNextAssoc
metode .
Catatan
Urutan perulangan tidak dapat diprediksi
Contoh
Lihat contoh untuk CAtlMap::CAtlMap.
CAtlMap::GetValueAt
Panggil metode ini untuk mengambil nilai yang disimpan pada posisi tertentu dalam CAtlMap
objek.
V& GetValueAt(POSITION pos) throw();
const V& GetValueAt(POSITION pos) const throw();
Parameter
pos
Penghitung posisi, dikembalikan oleh panggilan sebelumnya ke CAtlMap::GetNextAssoc atau CAtlMap::GetStartPosition.
Tampilkan Nilai
Mengembalikan referensi ke nilai yang disimpan pada posisi yang CAtlMap
diberikan dalam objek.
CAtlMap::InitHashTable
Panggil metode ini untuk menginisialisasi tabel hash.
bool InitHashTable(
UINT nBins,
bool bAllocNow = true);
Parameter
nBins
Jumlah bin yang digunakan oleh tabel hash. Lihat CAtlMap::CAtlMap untuk penjelasan.
bAllocNow
Indikasi bendera ketika memori harus dialokasikan.
Tampilkan Nilai
Mengembalikan TRUE pada inisialisasi yang berhasil, FALSE pada kegagalan.
Keterangan
InitHashTable
harus dipanggil sebelum elemen apa pun disimpan dalam tabel hash. Jika metode ini tidak dipanggil secara eksplisit, metode ini akan dipanggil secara otomatis saat pertama kali elemen ditambahkan menggunakan jumlah bin yang ditentukan oleh CAtlMap
konstruktor. Jika tidak, peta akan diinisialisasi menggunakan jumlah bin baru yang ditentukan oleh parameter nBins .
Jika parameter bAllocNow salah, memori yang diperlukan oleh tabel hash tidak akan dialokasikan sampai pertama kali diperlukan. Ini dapat berguna jika tidak pasti apakah peta akan digunakan.
Contoh
Lihat contoh untuk CAtlMap::CAtlMap.
CAtlMap::IsEmpty
Panggil metode ini untuk menguji objek peta kosong.
bool IsEmpty() const throw();
Tampilkan Nilai
Mengembalikan TRUE jika peta kosong, FALSE jika tidak.
CAtlMap::KINARGTYPE
Jenis yang digunakan saat kunci diteruskan sebagai argumen input.
typedef KTraits::INARGTYPE KINARGTYPE;
CAtlMap::KOUTARGTYPE
Jenis yang digunakan saat kunci dikembalikan sebagai argumen output.
typedef KTraits::OUTARGTYPE KOUTARGTYPE;
CAtlMap::Lookup
Panggil metode ini untuk mencari kunci atau nilai dalam CAtlMap
objek.
bool Lookup(KINARGTYPE key, VOUTARGTYPE value) const;
const CPair* Lookup(KINARGTYPE key) const throw();
CPair* Lookup(KINARGTYPE key) throw();
Parameter
kunci
Menentukan kunci yang mengidentifikasi elemen yang akan dicari.
value
Variabel yang menerima nilai pencarian.
Tampilkan Nilai
Bentuk pertama metode mengembalikan true jika kunci ditemukan, jika tidak salah. Formulir kedua dan ketiga mengembalikan pointer ke CPair yang dapat digunakan sebagai posisi untuk panggilan ke CAtlMap::GetNext dan sebagainya.
Keterangan
Lookup
menggunakan algoritma hashing untuk menemukan elemen peta dengan cepat yang berisi kunci yang sama persis dengan parameter kunci yang diberikan.
CAtlMap::operator []
Mengganti atau menambahkan elemen baru ke CAtlMap
.
V& operator[](kinargtype key) throw();
Parameter
kunci
Kunci elemen yang akan ditambahkan atau diganti.
Tampilkan Nilai
Mengembalikan referensi ke nilai yang terkait dengan kunci yang diberikan.
Contoh
Jika kunci sudah ada, elemen diganti. Jika kunci tidak ada, elemen baru ditambahkan. Lihat contoh untuk CAtlMap::CAtlMap.
CAtlMap::Rehash
Panggil metode ini untuk merehash CAtlMap
objek.
void Rehash(UINT nBins = 0);
Parameter
nBins
Jumlah bin baru yang akan digunakan dalam tabel hash. Lihat CAtlMap::CAtlMap untuk penjelasan.
Keterangan
Jika nBins adalah 0, CAtlMap
menghitung angka yang wajar berdasarkan jumlah elemen dalam peta dan pengaturan beban optimal. Biasanya proses pengulangan otomatis, tetapi jika CAtlMap::D isableAutoRehash telah dipanggil, metode ini akan melakukan pengubahan ukuran yang diperlukan.
CAtlMap::RemoveAll
Panggil metode ini untuk menghapus semua elemen dari CAtlMap
objek.
void RemoveAll() throw();
Keterangan
CAtlMap
Menghapus objek, membebaskan memori yang digunakan untuk menyimpan elemen.
CAtlMap::RemoveAtPos
Panggil metode ini untuk menghapus elemen pada posisi yang diberikan dalam CAtlMap
objek.
void RemoveAtPos(POSITION pos) throw();
Parameter
pos
Penghitung posisi, dikembalikan oleh panggilan sebelumnya ke CAtlMap::GetNextAssoc atau CAtlMap::GetStartPosition.
Keterangan
Menghapus pasangan kunci/nilai yang disimpan pada posisi yang ditentukan. Memori yang digunakan untuk menyimpan elemen dibebesarkan. POSISI yang direferensikan oleh pos menjadi tidak valid, dan sementara POSISI elemen lain dalam peta tetap valid, mereka tidak selalu mempertahankan urutan yang sama.
CAtlMap::RemoveKey
Panggil metode ini untuk menghapus elemen dari CAtlMap
objek, mengingat kuncinya.
bool RemoveKey(KINARGTYPE key) throw();
Parameter
kunci
Kunci yang sesuai dengan pasangan elemen yang ingin Anda hapus.
Tampilkan Nilai
Mengembalikan TRUE jika kunci ditemukan dan dihapus, FALSE pada kegagalan.
Contoh
Lihat contoh untuk CAtlMap::CAtlMap.
CAtlMap::SetAt
Panggil metode ini untuk menyisipkan pasangan elemen ke dalam peta.
POSITION SetAt(
KINARGTYPE key,
VINARGTYPE value);
Parameter
kunci
Nilai kunci untuk ditambahkan ke CAtlMap
objek.
value
Nilai yang akan ditambahkan ke CAtlMap
objek.
Tampilkan Nilai
Mengembalikan posisi pasangan elemen kunci/nilai dalam CAtlMap
objek.
Keterangan
SetAt
menggantikan elemen yang ada jika kunci yang cocok ditemukan. Jika kunci tidak ditemukan, pasangan kunci/nilai baru akan dibuat.
CAtlMap::SetOptimalLoad
Panggil metode ini untuk mengatur beban CAtlMap
optimal objek.
void SetOptimalLoad(
float fOptimalLoad,
float fLoThreshold,
float fHiThreshold,
bool bRehashNow = false);
Parameter
fOptimalLoad
Rasio beban optimal.
fLoThreshold
Ambang batas bawah untuk rasio beban.
fHiThreshold
Ambang atas untuk rasio beban.
bRehashNow
Bendera yang menunjukkan apakah tabel hash harus dihitung ulang.
Keterangan
Metode ini mendefinisikan ulang nilai beban optimal untuk CAtlMap
objek. Lihat CAtlMap::CAtlMap untuk diskusi tentang berbagai parameter. Jika bRehashNow benar, dan jumlah elemen berada di luar nilai minimum dan maksimum, tabel hash dihitung ulang.
CAtlMap::SetValueAt
Panggil metode ini untuk mengubah nilai yang disimpan pada posisi tertentu dalam CAtlMap
objek.
void SetValueAt(
POSITION pos,
VINARGTYPE value);
Parameter
pos
Penghitung posisi, dikembalikan oleh panggilan sebelumnya ke CAtlMap::GetNextAssoc atau CAtlMap::GetStartPosition.
value
Nilai yang akan ditambahkan ke CAtlMap
objek.
Keterangan
Mengubah elemen nilai yang disimpan pada posisi yang CAtlMap
diberikan dalam objek.
CAtlMap::VINARGTYPE
Jenis yang digunakan saat nilai diteruskan sebagai argumen input.
typedef VTraits::INARGTYPE VINARGTYPE;
CAtlMap::VOUTARGTYPE
Jenis yang digunakan saat nilai diteruskan sebagai argumen output.
typedef VTraits::OUTARGTYPE VOUTARGTYPE;
CAtlMap::CPair::m_key
Anggota data yang menyimpan elemen kunci.
const K m_key;
Parameter
K
Jenis elemen kunci.
CAtlMap::CPair::m_value
Anggota data yang menyimpan elemen nilai.
V m_value;
Parameter
V
Jenis elemen nilai.