Aracılığıyla paylaş

CTypedPtrMap Sınıfı

  • Makale

, CMapPtrToWord, CMapWordToPtrve CMapStringToPtrişaretçi eşleme sınıflarının CMapPtrToPtrnesneleri için tür açısından güvenli bir "sarmalayıcı" sağlar.

Sözdizimi

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

Parametreler

BASE_CLASS
Yazılan işaretçi eşleme sınıfının temel sınıfı; bir işaretçi eşleme sınıfı ( CMapPtrToPtr, CMapPtrToWord, CMapWordToPtrveya CMapStringToPtr) olmalıdır.

KEY
Eşlemenin anahtarı olarak kullanılan nesnenin sınıfı.

DEĞER
Eşlemede depolanan nesnenin sınıfı.

Üyeler

Genel Yöntemler

Veri Akışı Adı Açıklama
CTypedPtrMap::GetNextAssoc Yineleme için sonraki öğeyi alır.
CTypedPtrMap::Lookup KEY bir tabanlı döndürürVALUE.
CTypedPtrMap::RemoveKey Bir anahtar tarafından belirtilen bir öğeyi kaldırır.
CTypedPtrMap::SetAt Eşlem içine bir öğe ekler; eşleşen bir anahtar bulunursa mevcut bir öğeyi değiştirir.

Ortak İşleçler

Veri Akışı Adı Açıklama
CTypedPtrMap::operator [ ] Eşlem içine bir öğe ekler.

Açıklamalar

kullandığınızda CTypedPtrMap, C++ tür denetimi özelliği eşleşmeyen işaretçi türlerinin neden olduğu hataları ortadan kaldırmaya yardımcı olur.

Tüm CTypedPtrMap işlevler satır içi olduğundan, bu şablonun kullanılması kodunuzun boyutunu veya hızını önemli ölçüde etkilemez.

kullanma CTypedPtrMaphakkında daha fazla bilgi için Koleksiyonlar ve Şablon Tabanlı Sınıflar makalelerine bakın.

Devralma Hiyerarşisi

BASE_CLASS

CTypedPtrMap

Gereksinimler

Üst bilgi: afxtempl.h

CTypedPtrMap::GetNextAssoc

konumundaki eşleme öğesini rNextPositionalır, ardından eşlemedeki bir sonraki öğeye başvurmak için güncelleştirilir rNextPosition .

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

Parametreler

rPosition
Önceki GetNextAssoc veya BASE_CLASS::GetStartPosition çağrısı tarafından döndürülen POSITION değerine başvuru belirtir.

KEY
Harita anahtarlarının türünü belirten şablon parametresi.

rKey
Alınan öğenin döndürülen anahtarını belirtir.

DEĞER
Harita değerlerinin türünü belirten şablon parametresi.

rValue
Alınan öğenin döndürülen değerini belirtir.

Açıklamalar

Bu işlev en çok haritadaki tüm öğeler arasında yineleme yapmak için kullanışlıdır. Konum sırasının anahtar değer dizisiyle aynı olması gerekmediğini unutmayın.

Alınan öğe eşlemenin son öğesiyse, öğesinin yeni değeri rNextPosition NULL olarak ayarlanır.

Bu satır içi işlev ::GetNextAssoc öğesini çağırır.BASE_CLASS

CTypedPtrMap::Lookup

Lookup , tam olarak eşleşen bir anahtara sahip harita öğesini hızla bulmak için bir karma algoritması kullanır.

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

Parametreler

BASE_CLASS
Bu eşleme sınıfının temel sınıfını belirten şablon parametresi.

key
Aranacak öğenin anahtarı.

DEĞER
Bu eşlemede depolanan değerlerin türünü belirten şablon parametresi.

rValue
Alınan öğenin döndürülen değerini belirtir.

Dönüş Değeri

Öğe bulunduysa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Bu satır içi işlev ::Lookup öğesini çağırır.BASE_CLASS

CTypedPtrMap::operator [ ]

Bu işleç yalnızca atama deyiminin sol tarafında (l değeri) kullanılabilir.

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

Parametreler

DEĞER
Bu eşlemede depolanan değerlerin türünü belirten şablon parametresi.

BASE_CLASS
Bu eşleme sınıfının temel sınıfını belirten şablon parametresi.

key
Haritada aranacak veya oluşturulacak öğenin anahtarı.

Açıklamalar

Belirtilen anahtara sahip bir eşleme öğesi yoksa yeni bir öğe oluşturulur. Bu işleçle eşdeğer bir "sağ taraf" (r-değeri) yoktur çünkü haritada bir anahtar bulunmama olasılığı vardır. Lookup Öğe alma için üye işlevini kullanın.

CTypedPtrMap::RemoveKey

Bu üye işlevi ::RemoveKey öğesini çağırır.BASE_CLASS

BOOL RemoveKey(KEY key);

Parametreler

KEY
Harita anahtarlarının türünü belirten şablon parametresi.

key
Kaldırılacak öğenin anahtarı.

Dönüş Değeri

Girdi bulunduysa ve başarıyla kaldırıldıysa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Daha ayrıntılı açıklamalar için bkz . CMapStringToOb::RemoveKey.

CTypedPtrMap::SetAt

Bu üye işlevi ::SetAt öğesini çağırır.BASE_CLASS

void SetAt(KEY key, VALUE newValue);

Parametreler

KEY
Harita anahtarlarının türünü belirten şablon parametresi.

key
newValue değerini belirtir.

newValue
Yeni öğenin değeri olan nesne işaretçisini belirtir.

Açıklamalar

Daha ayrıntılı açıklamalar için bkz . CMapStringToOb::SetAt.

Ayrıca bkz.

MFC Örneği COLLECT
Hiyerarşi Grafiği
CMapPtrToPtr Sınıfı
CMapPtrToWord Sınıfı
CMapWordToPtr Sınıfı
CMapStringToPtr Sınıfı