Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
Opmerking
De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.
Ondersteunt kaarten van CString objecten die worden gesleuteld door CString objecten.
Syntaxis
class CMapStringToString : public CObject
Leden
De lidfuncties zijn CMapStringToString vergelijkbaar met de lidfuncties van klasse CMapStringToOb. Vanwege deze overeenkomst kunt u de CMapStringToOb referentiedocumentatie gebruiken voor specifieke informatie over ledenfuncties. Waar u een CObject aanwijzer ziet als een retourwaarde of 'output'-functieparameter, vervangt u een aanwijzer in char. Waar u een CObject aanwijzer ziet als een 'invoerfunctieparameter', vervangt u een aanwijzer in char.
BOOL CMapStringToString::Lookup(LPCTSTR<key>, CString&<rValue>) const;
bijvoorbeeld wordt omgezet in
BOOL CMapStringToOb::Lookup(const char*<key>, CObject*&<rValue>) const;
Openbare structuren
| Naam | Description |
|---|---|
| CMapStringToString::CPair | Een geneste structuur met een sleutelwaarde en de waarde van het bijbehorende tekenreeksobject. |
Openbare constructors
| Naam | Description |
|---|---|
| CMapStringToString::CMapStringToStringToString | Bouwer. |
Openbare methoden
| Naam | Description |
|---|---|
| CMapStringToString::GetCount | Retourneert het aantal elementen in deze kaart. |
| CMapStringToString::GetHashTableSize | Bepaalt het huidige aantal elementen in de hash-tabel. |
| CMapStringToString::GetNextAssoc | Hiermee haalt u het volgende element op voor het herhalen. |
| CMapStringToString::GetSize | Retourneert het aantal elementen in deze kaart. |
| CMapStringToString::GetStartPosition | Retourneert de positie van het eerste element. |
| CMapStringToString::HashKey | Berekent de hashwaarde van een opgegeven sleutel. |
| CMapStringToString::InitHashTable | Initialiseert de hash-tabel. |
| CMapStringToString::IsEmpty | Hiermee wordt getest op de voorwaarde empty-map (geen elementen). |
| CMapStringToString::Lookup | Hiermee wordt een ongeldige aanwijzer opgezoekd op basis van de sleutel voor de ongeldige aanwijzer. De aanwijzerwaarde, niet de entiteit waarmee deze verwijst, wordt gebruikt voor de sleutelvergelijking. |
| CMapStringToString::LookupKey | Retourneert een verwijzing naar de sleutel die is gekoppeld aan de opgegeven sleutelwaarde. |
| CMapStringToString::P GetFirstAssoc | Hiermee wordt een aanwijzer naar de eerste CString op de kaart weergegeven. |
| CMapStringToString::P GetNextAssoc | Hiermee krijgt u een aanwijzer naar de volgende CString voor het herhalen. |
| CMapStringToString::P Lookup | Retourneert een aanwijzer naar een CString wiens waarde overeenkomt met de opgegeven waarde. |
| CMapStringToString::RemoveAll | Hiermee verwijdert u alle elementen uit deze kaart. |
| CMapStringToString::RemoveKey | Hiermee verwijdert u een element dat is opgegeven door een sleutel. |
| CMapStringToString::SetAt | Hiermee voegt u een element in de kaart in; vervangt een bestaand element als er een overeenkomende sleutel wordt gevonden. |
Openbare operators
| Naam | Description |
|---|---|
| CMapStringToString::operator [ ] | Hiermee voegt u een element in de kaart in: operatorvervanging voor SetAt. |
Opmerkingen
CMapStringToString bevat de IMPLEMENT_SERIAL macro ter ondersteuning van serialisatie en dumping van de elementen. Elk element wordt op zijn beurt geserialiseerd als een kaart wordt opgeslagen in een archief, ofwel met de overbelaste invoegingsoperator ( <<) of met de Serialize lidfunctie.
Als u een dump van afzonderlijke CString- CString elementen nodig hebt, moet u de diepte van de dumpcontext instellen op 1 of hoger.
Wanneer een CMapStringToString object wordt verwijderd of wanneer de elementen ervan worden verwijderd, worden de CString objecten waar nodig verwijderd.
Zie het artikel Verzamelingen voor meer informatieCMapStringToString.
Overnamehiërarchie
CMapStringToString
Requirements
Koptekst: afxcoll.h
CMapStringToString::CPair
Bevat een sleutelwaarde en de waarde van het bijbehorende tekenreeksobject.
Opmerkingen
Dit is een geneste structuur binnen klasse CMapStringToString.
De structuur bestaat uit twee velden:
keyDe werkelijke waarde van het sleuteltype.valueDe waarde van het gekoppelde object.
Deze wordt gebruikt voor het opslaan van de retourwaarden van CMapStringToString::P Lookup, CMapStringToString::P GetFirstAssoc en CMapStringToString::P GetNextAssoc.
Example
Zie het voorbeeld voor CMapStringToString::P Lookup voor een voorbeeld van gebruik.
CMapStringToString::P GetFirstAssoc
Retourneert de eerste vermelding van het kaartobject.
const CPair* PGetFirstAssoc() const;
CPair* PGetFirstAssoc();
Retourwaarde
Een aanwijzer naar de eerste vermelding op de kaart; zie CMapStringToString::CPair. Als de kaart leeg is, is de waarde NULL.
Opmerkingen
Roep deze functie aan om een aanwijzer te retourneren naar het eerste element in het kaartobject.
Example
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
Hiermee wordt het kaartelement opgehaald dat wordt verwezen door pAssocRec.
const CPair *PGetNextAssoc(const CPair* pAssoc) const;
CPair *PGetNextAssoc(const CPair* pAssoc);
Parameterwaarden
pAssoc
Verwijst naar een kaartvermelding die is geretourneerd door een vorige PGetNextAssoc - of PGetFirstAssoc-aanroep .
Retourwaarde
Een aanwijzer naar de volgende vermelding op de kaart; zie CMapStringToString::CPair. Als het element het laatste element in de kaart is, is de waarde NULL.
Opmerkingen
Roep deze methode aan om alle elementen in de kaart te doorlopen. Haal het eerste element op met een aanroep naar PGetFirstAssoc en herhaal vervolgens de kaart met opeenvolgende aanroepen naar PGetNextAssoc.
Example
Zie het voorbeeld voor CMapStringToString::P GetFirstAssoc.
CMapStringToString::P Lookup
Hiermee wordt de waarde opgezoekt die is toegewezen aan een bepaalde sleutel.
const CPair* PLookup(LPCTSTR key) const;
CPair* PLookup(LPCTSTR key);
Parameterwaarden
sleutel
Een aanwijzer naar de sleutel voor het element dat moet worden gezocht.
Retourwaarde
Een aanwijzer naar de opgegeven sleutel.
Opmerkingen
Roep deze methode aan om te zoeken naar een kaartelement met een sleutel die exact overeenkomt met de opgegeven sleutel.
Example
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);
}