CMap sınıfı

Benzersiz anahtarlar değerlere eşler sözlük koleksiyonu sınıf.

template< class KEY, class ARG_KEY, class VALUE, class ARG_VALUE >class CMap : public CObject

Parametreler

• KEY
  Eşleme anahtar olarak kullanılan nesne sınıfı.

• ARG*_*KEY
  Veri türü için kullanılan KEY bağımsız değişkenleri; genellikle bir başvuru KEY.

• VALUE
  Haritası'nda saklanan nesne sınıfı.

• ARG*_*VALUE
  Veri türü için kullanılan VALUE bağımsız değişkenleri; genellikle bir başvuru VALUE.

Üyeler

Ortak yapıları

Ad	Description
CMap::CPair	Bir anahtar ve ilişkili bir nesne değerlerini içeren iç içe geçmiş yapısı.

Ortak Oluşturucusu

Ad	Description
CMap::CMap	Anahtarların değerlerini eşleyen bir koleksiyon oluşturur.

Public yöntemler

Ad	Description
CMap::GetCount	Bu harita öğe sayısını döndürür.
CMap::GetHashTableSize	Karma Tablo öğe sayısını döndürür.
CMap::GetNextAssoc	Sonraki öğe dolaşmak için alır.
CMap::GetSize	Bu harita öğe sayısını döndürür.
CMap::GetStartPosition	İlk öğenin konumunu döndürür.
CMap::InitHashTable	Karma Tablo başlatır ve boyutunu belirtir.
CMap::IsEmpty	(Öğe yok) boş haritası koşul sınamaları.
CMap::Lookup	Verilen bir anahtar eşlenen değeri arar.
CMap::PGetFirstAssoc	İlk öğe için bir işaretçi döndürür.
CMap::PGetNextAssoc	Bir işaretçi dolaşmak için sonraki öğeyi alır.
CMap::PLookup	Bir işaretçi değeri belirtilen değerle eşleşen bir anahtarı döndürür.
CMap::RemoveAll	Bu eşlemesinden tüm öğeleri kaldırır.
CMap::RemoveKey	Anahtarı ile belirtilen bir öğeyi kaldırır.
CMap::SetAt	Bir öğe eşlemenin içine ekler; eşleşen anahtar bulunursa, varolan bir öğenin yerini alır.

Ortak İşleçler

Ad	Description
[CMap::operator]	Eşlemenin içine bir öğe ekler — işlecini değiştirme için SetAt.

Notlar

Eşlemenin içine anahtar-değer çifti (element) ekledikten sonra verimli bir şekilde almak veya erişim için anahtar kullanılarak çifti silin.Üzerinden Haritası içindeki tüm öğeleri yineleyebilirsiniz.

Türünde bir değişken konumu diğer erişim girişleri için kullanılır.Kullanabileceğiniz bir konumu "girişi unutmayın" ve harita dolaşmak için.Bu yineleme anahtar değerine göre sıralı olduğunu düşünebilirsiniz; Bu değildir.Alınan öğelerin sırası belirsiz olur.

Birçok kullanım için bazı genel Yardımcısı işlevleri Bu sınıf çağrı üye işlevlerini özelleştirilmelidir CMap sınıfı.Bkz: Koleksiyon sınıfı Yardımcıları makrolar ve Globals bölümünde MFCReference.

CMapgeçersiz kılar CObject::Serialize seri hale getirme ve kendi öğelerini dökülüyor desteklemek için.Bir arşiv kullanarak harita depolanıyorsa, Serialize, her bir eşlem öğesi sırayla sıralanmış.Varsayılan uygulama olarak SerializeElements Yardımcısı iþleviyle Bitsel yazma.Türetilen işaretçi koleksiyon öğeleri seri hale getirme hakkında bilgi için CObject veya diğer kullanıcı tanımlı türler bkz: Nasıl yapılır: bir tür-güvenli tahsilat yapmak.

Tek tek öğelerin (anahtarlar ve değerler) eşlemesindeki bir tanı döküm gerekiyorsa, 1 veya daha büyük döküm bağlam derinliğini ayarlamanız gerekir.

Zaman bir CMap nesne silinir veya öğelerini kaldırıldığında, anahtarlar ve değerler kaldırıldı.

Sınıf türetme eşleme listesi türetme benzer.Makaleye bakın koleksiyonları için bir özel amaç listesi Sınıf türetme çizimi.

Devralma hiyerarşisi

CObject

CMap

Gereksinimler

Başlık: afxtempl.h

Ayrıca bkz.

Başvuru

CObject sınıfı

Hiyerarşi grafik

Kavramlar

mfc örnek toplama