CTypedPtrMap osztály

Típusbiztos "burkolót" biztosít a mutatótérkép-osztályok CMapPtrToPtrobjektumaihoz, CMapPtrToWordCMapWordToPtrés CMapStringToPtr.

Szemantika

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

Paraméterek

BASE_CLASS
A beírt mutatótérkép-osztály alaposztálya; mutatótérkép-osztálynak (CMapPtrToPtr, CMapPtrToWord, CMapWordToPtrvagy CMapStringToPtr) kell lennie.

KULCS
A térkép kulcsaként használt objektum osztálya.

ÉRTÉK
A térképen tárolt objektum osztálya.

Tagok

Nyilvános metódusok

Név	Leírás
CTypedPtrMap::GetNextAssoc	Lekéri az iterálás következő elemét.
CTypedPtrMap::Keresés	KEY VALUEEgy .
CTypedPtrMap::RemoveKey	Eltávolít egy kulcs által megadott elemet.
CTypedPtrMap::SetAt	Elem beszúrása a térképre; lecserél egy meglévő elemet, ha talál egy megfelelő kulcsot.

Nyilvános operátorok

Név	Leírás
CTypedPtrMap::operátor [ ]	Elemet szúr be a térképbe.

Megjegyzések

Használata esetén CTypedPtrMapa C++ típusellenőrző eszköz segít kiküszöbölni az eltérő mutatótípusok által okozott hibákat.

Mivel minden CTypedPtrMap függvény beágyazott, a sablon használata nem befolyásolja jelentősen a kód méretét vagy sebességét.

További információ a használatról CTypedPtrMap: Gyűjtemények és Template-Based osztályok.

Öröklési hierarchia

BASE_CLASS

CTypedPtrMap

Követelmények

Fejléc: afxtempl.h

CTypedPtrMap::GetNextAssoc

Lekéri a térképelemet a következő helyen rNextPosition, majd frissíti rNextPosition a térkép következő elemére való hivatkozáshoz.

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

Paraméterek

rPosition
Egy korábbi GetNextAssoc vagy BASE_CLASS::GetStartPosition hívás által visszaadott POZÍCIÓ értékre mutató hivatkozást ad meg.

KULCS
A térkép kulcsainak típusát meghatározó sablonparaméter.

rKey
A lekért elem visszaadott kulcsát adja meg.

ÉRTÉK
A térkép értékeinek típusát meghatározó sablonparaméter.

rValue
A lekért elem visszaadott értékét adja meg.

Megjegyzések

Ez a függvény leginkább a térkép összes elemének iterálásához hasznos. Vegye figyelembe, hogy a pozícióütemezés nem feltétlenül ugyanaz, mint a kulcsérték-sorozat.

Ha a lekért elem az utolsó a térképen, akkor az új érték rNextPosition NULL értékre van állítva.

Ez a beágyazott függvény meghívja BASE_CLASSa következőt: :GetNextAssoc.

CTypedPtrMap::Keresés

Lookup kivonatoló algoritmussal gyorsan megtalálhatja a térképelemet egy pontosan egyező kulccsal.

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

Paraméterek

BASE_CLASS
A térkép osztályának alaposztályát meghatározó sablonparaméter.

kulcs
A keresendő elem kulcsa.

ÉRTÉK
A térképen tárolt értékek típusát meghatározó sablonparaméter.

rValue
A lekért elem visszaadott értékét adja meg.

Visszaadott érték

Nemzero, ha az elem megtalálható; egyéb esetben 0.

Megjegyzések

Ez a beágyazott függvény meghívja BASE_CLASSa ::Lookup függvényt.

CTypedPtrMap::operátor [ ]

Ez az operátor csak a hozzárendelési utasítás (l-érték) bal oldalán használható.

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

Paraméterek

ÉRTÉK
A térképen tárolt értékek típusát meghatározó sablonparaméter.

BASE_CLASS
A térkép osztályának alaposztályát meghatározó sablonparaméter.

kulcs
A térképen keresendő vagy létrehozandó elem kulcsa.

Megjegyzések

Ha nincs térképelem a megadott kulccsal, akkor létrejön egy új elem. Ennek az operátornak nincs "jobb oldala" (r-érték), mert lehetséges, hogy nem található kulcs a térképen. Elemlekéréshez használja a Lookup tagfüggvényt.

CTypedPtrMap::RemoveKey

Ez a tagfüggvény a következőt hívja BASE_CLASS: :RemoveKey.

BOOL RemoveKey(KEY key);

Paraméterek

KULCS
A térkép kulcsainak típusát meghatározó sablonparaméter.

kulcs
Az eltávolítandó elem kulcsa.

Visszaadott érték

Nemzero, ha a bejegyzés megtalálható és sikeresen el lett távolítva; egyéb esetben 0.

Megjegyzések

Részletesebb megjegyzésekért lásd: CMapStringToOb::RemoveKey.

CTypedPtrMap::SetAt

Ez a tagfüggvény meghívja BASE_CLASSa következőt: :SetAt.

void SetAt(KEY key, VALUE newValue);

Paraméterek

KULCS
A térkép kulcsainak típusát meghatározó sablonparaméter.

kulcs
A newValue kulcsértékét adja meg.

newValue
Megadja az új elem értékét jelző objektummutatót.

Megjegyzések

Részletesebb megjegyzésekért lásd: CMapStringToOb::SetAt.

Lásd még

MFC-minta COLLECT
hierarchiadiagram
CMapPtrToPtr osztály
CMapPtrToWord osztály
CMapWordToPtr osztály
CMapStringToPtr osztály