Kelas CMapStringToString

Mendukung peta CString objek yang di-key oleh CString objek.

Sintaks

class CMapStringToString : public CObject

Anggota

Fungsi CMapStringToString anggota mirip dengan fungsi anggota kelas CMapStringToOb. Karena kesamaan ini, Anda dapat menggunakan CMapStringToOb dokumentasi referensi untuk spesifik fungsi anggota. Di mana pun Anda melihat CObject penunjuk sebagai nilai pengembalian atau parameter fungsi "output", ganti penunjuk ke char. Di mana pun Anda melihat CObject penunjuk sebagai parameter fungsi "input", ganti penunjuk ke char.

BOOL CMapStringToString::Lookup(LPCTSTR<key>, CString&<rValue>) const;

misalnya, diterjemahkan ke

BOOL CMapStringToOb::Lookup(const char*<key>, CObject*&<rValue>) const;

Struktur Publik

Nama	Deskripsi
CMapStringToString::CPair	Struktur berlapis yang berisi nilai kunci dan nilai objek string terkait.

Konstruktor Publik

Nama	Deskripsi
CMapStringToString::CMapStringToString	Konstruktor.

Metode Publik

Nama	Deskripsi
CMapStringToString::GetCount	Mengembalikan jumlah elemen dalam peta ini.
CMapStringToString::GetHashTableSize	Menentukan jumlah elemen saat ini dalam tabel hash.
CMapStringToString::GetNextAssoc	Mendapatkan elemen berikutnya untuk iterasi.
CMapStringToString::GetSize	Mengembalikan jumlah elemen dalam peta ini.
CMapStringToString::GetStartPosition	Mengembalikan posisi elemen pertama.
CMapStringToString::HashKey	Menghitung nilai hash kunci tertentu.
CMapStringToString::InitHashTable	Menginisialisasi tabel hash.
CMapStringToString::IsEmpty	Pengujian untuk kondisi peta kosong (tidak ada elemen).
CMapStringToString::Lookup	Mencari penunjuk yang batal berdasarkan kunci penunjuk yang batal. Nilai pointer, bukan entitas yang dituju, digunakan untuk perbandingan kunci.
CMapStringToString::LookupKey	Mengembalikan referensi ke kunci yang terkait dengan nilai kunci yang ditentukan.
CMapStringToString::P GetFirstAssoc	Mendapatkan penunjuk ke yang pertama CString di peta.
CMapStringToString::P GetNextAssoc	Mendapatkan penunjuk ke penunjuk berikutnya CString untuk iterasi.
CMapStringToString::P Lookup	Mengembalikan penunjuk ke nilai CString yang cocok dengan nilai yang ditentukan.
CMapStringToString::RemoveAll	Menghapus semua elemen dari peta ini.
CMapStringToString::RemoveKey	Menghapus elemen yang ditentukan oleh kunci.
CMapStringToString::SetAt	Menyisipkan elemen ke dalam peta; menggantikan elemen yang ada jika kunci yang cocok ditemukan.

Operator Publik

Nama	Deskripsi
CMapStringToString::operator [ ]	Menyisipkan elemen ke dalam peta — penggantian operator untuk SetAt.

Keterangan

CMapStringToString menggabungkan IMPLEMENT_SERIAL makro untuk mendukung serialisasi dan pembuangan elemennya. Setiap elemen diserialisasikan pada gilirannya jika peta disimpan ke arsip, baik dengan operator penyisipan ( <<) yang kelebihan beban atau dengan Serialize fungsi anggota.

Jika Anda memerlukan cadangan elemen individual CString- CString , Anda harus mengatur kedalaman konteks cadangan ke 1 atau lebih besar.

CMapStringToString Saat objek dihapus, atau ketika elemennya dihapus, CString objek dihapus sebagaimana mewajarkannya.

Untuk informasi selengkapnya tentang CMapStringToString, lihat artikel Koleksi.

Hierarki Warisan

CObject

CMapStringToString

Persyaratan

Header: afxcoll.h

CMapStringToString::CPair

Berisi nilai kunci dan nilai objek string terkait.

Keterangan

Ini adalah struktur berlapis dalam kelas CMapStringToString.

Struktur terdiri dari dua bidang:

• key Nilai aktual dari jenis kunci.

• value Nilai objek terkait.

Ini digunakan untuk menyimpan nilai pengembalian dari CMapStringToString::P Lookup, CMapStringToString::P GetFirstAssoc, dan CMapStringToString::P GetNextAssoc.

Contoh

Untuk contoh penggunaan, lihat contoh untuk CMapStringToString::P Lookup.

CMapStringToString::P GetFirstAssoc

Mengembalikan entri pertama objek peta.

const CPair* PGetFirstAssoc() const;

CPair* PGetFirstAssoc();

Tampilkan Nilai

Penunjuk ke entri pertama di peta; lihat CMapStringToString::CPair. Jika peta kosong, nilainya adalah NULL.

Keterangan

Panggil fungsi ini untuk mengembalikan penunjuk elemen pertama dalam objek peta.

Contoh

CMapStringToString myMap;
CString myStr[4] = {_T("One"), _T("Two"), _T("Three"), _T("Four")};
CMapStringToString::CPair *pCurVal;

myMap.InitHashTable(257);

// Add 4 elements to the map.
myMap.SetAt(myStr[0], _T("Odd"));
myMap.SetAt(myStr[1], _T("Even"));
myMap.SetAt(myStr[2], _T("Odd"));
myMap.SetAt(myStr[3], _T("Even"));

pCurVal = myMap.PGetFirstAssoc();
while (pCurVal != NULL)
{
   _tprintf_s(_T("Current key value at %s: %s\n"),
              pCurVal->key, pCurVal->value);
   pCurVal = myMap.PGetNextAssoc(pCurVal);
}

CMapStringToString::P GetNextAssoc

Mengambil elemen peta yang ditunjukkan oleh pAssocRec.

const CPair *PGetNextAssoc(const CPair* pAssoc) const;

CPair *PGetNextAssoc(const CPair* pAssoc);

Parameter

pAssoc
Menunjuk ke entri peta yang dikembalikan oleh panggilan PGetNextAssoc atau PGetFirstAssoc sebelumnya.

Tampilkan Nilai

Penunjuk ke entri berikutnya di peta; lihat CMapStringToString::CPair. Jika elemen adalah yang terakhir dalam peta, nilainya adalah NULL.

Keterangan

Panggil metode ini untuk melakukan iterasi melalui semua elemen di peta. Ambil elemen pertama dengan panggilan ke PGetFirstAssoc lalu iterasi melalui peta dengan panggilan berturut-turut ke PGetNextAssoc.

Contoh

Lihat contoh untuk CMapStringToString::P GetFirstAssoc.

CMapStringToString::P Lookup

Mencari nilai yang dipetakan ke kunci tertentu.

const CPair* PLookup(LPCTSTR key) const;

CPair* PLookup(LPCTSTR key);

Parameter

kunci
Penunjuk ke kunci untuk elemen yang akan dicari.

Tampilkan Nilai

Penunjuk ke kunci yang ditentukan.

Keterangan

Panggil metode ini untuk mencari elemen peta dengan kunci yang sama persis dengan kunci yang diberikan.

Contoh

CMapStringToString myMap;
CString myStr[4] = {_T("One"), _T("Two"), _T("Three"), _T("Four")};

myMap.InitHashTable(257);

// Add 4 elements to the map.
myMap.SetAt(myStr[0], _T("Odd"));
myMap.SetAt(myStr[1], _T("Even"));
myMap.SetAt(myStr[2], _T("Odd"));
myMap.SetAt(myStr[3], _T("Even"));

// Print the element values with odd key values.
CMapStringToString::CPair *pCurVal;

for (int i = 0; i < 4; i += 2)
{
   pCurVal = myMap.PLookup(myStr[i]);
   _tprintf_s(_T("Current key value at %s: %s\n"),
              pCurVal->key, pCurVal->value);
}

Lihat juga

Sampel MFC COLLECT
Kelas CObject
Bagan Hierarki