Aracılığıyla paylaş

CMapStringToString Sınıfı

  • Makale

Nesneler tarafından CString anahtarlanan nesnelerin haritalarını CString destekler.

Sözdizimi

class CMapStringToString : public CObject

Üyeler

öğesinin CMapStringToString üye işlevleri, CMapStringToOb sınıfının üye işlevlerine benzer. Bu benzerlik nedeniyle, üye işlevi özellikleri için başvuru belgelerini kullanabilirsiniz CMapStringToOb . bir işaretçiyi dönüş değeri veya "output" işlev parametresi olarak gördüğünüz CObject her yerde, işaretçiyi ile chardeğiştirin. bir CObject işaretçiyi "input" işlev parametresi olarak gördüğünüz her yerde, işaretçiyi olarak chardeğiştirin.

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

örneğin,

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

Genel Yapılar

Ad Tanım
CMapStringToString::CPair Bir anahtar değeri ve ilişkili dize nesnesinin değerini içeren iç içe yerleştirilmiş bir yapı.

Ortak Oluşturucular

Ad Tanım
CMapStringToString::CMapStringToString Oluşturucu.

Genel Yöntemler

Ad Tanım
CMapStringToString::GetCount Bu haritadaki öğe sayısını döndürür.
CMapStringToString::GetHashTableSize Karma tablodaki geçerli öğe sayısını belirler.
CMapStringToString::GetNextAssoc Yineleme için sonraki öğeyi alır.
CMapStringToString::GetSize Bu haritadaki öğe sayısını döndürür.
CMapStringToString::GetStartPosition İlk öğenin konumunu döndürür.
CMapStringToString::HashKey Belirtilen anahtarın karma değerini hesaplar.
CMapStringToString::InitHashTable Karma tabloyu başlatır.
CMapStringToString::IsEmpty Boş eşleme koşulu (öğe yok) için testler.
CMapStringToString::Lookup Void işaretçisi tuşuna göre bir void işaretçisi arar. İşaretçi değeri, işaret edilen varlık değil, anahtar karşılaştırması için kullanılır.
CMapStringToString::LookupKey Belirtilen anahtar değeriyle ilişkili anahtara başvuru döndürür.
CMapStringToString::P GetFirstAssoc Haritadaki ilk CString işaretçiyi alır.
CMapStringToString::P GetNextAssoc Yineleme için bir sonraki CString işaretçiyi alır.
CMapStringToString::P Lookup Değeri belirtilen değerle eşleşen bir CString işaretçi döndürür.
CMapStringToString::RemoveAll Bu haritadan tüm öğeleri kaldırır.
CMapStringToString::RemoveKey Bir anahtar tarafından belirtilen bir öğeyi kaldırır.
CMapStringToString::SetAt Eşlem içine bir öğe ekler; eşleşen bir anahtar bulunursa mevcut bir öğeyi değiştirir.

Ortak İşleçler

Ad Tanım
CMapStringToString::operator [ ] Eşlemeye bir öğe ekler— için SetAtişleç değişimi.

Açıklamalar

CMapStringToString öğelerinin seri hale getirilmesini IMPLEMENT_SERIAL ve dökümünün atılması için makroyu birleştirir. Eşlem bir arşive depolandığında, aşırı yüklenmiş ekleme ( <<) işleciyle veya üye işleviyle Serialize her öğe sırayla seri hale getirilir.

Tek tek CString- CString öğelerin dökümünü almanız gerekiyorsa döküm bağlamının derinliğini 1 veya daha büyük olarak ayarlamanız gerekir.

Bir CMapStringToString nesne silindiğinde veya öğeleri kaldırıldığında, CString nesneler uygun şekilde kaldırılır.

hakkında CMapStringToStringdaha fazla bilgi için Koleksiyonlar makalesine bakın.

Devralma Hiyerarşisi

Cobject

CMapStringToString

Gereksinimler

Üst bilgi: afxcoll.h

CMapStringToString::CPair

Bir anahtar değeri ve ilişkili dize nesnesinin değerini içerir.

Açıklamalar

Bu, CMapStringToString sınıfı içinde iç içe geçmiş bir yapıdır.

Yapı iki alandan oluşur:

  • key Anahtar türünün gerçek değeri.

  • value İlişkili nesnenin değeri.

CMapStringToString::P Lookup, CMapStringToString::P GetFirstAssoc ve CMapStringToString::P GetNextAssoc'tan döndürülen değerleri depolamak için kullanılır.

Örnek

Kullanım örneği için CMapStringToString::P Lookup örneğine bakın.

CMapStringToString::P GetFirstAssoc

Eşleme nesnesinin ilk girişini döndürür.

const CPair* PGetFirstAssoc() const;

CPair* PGetFirstAssoc();

İade Değeri

Haritadaki ilk girişin işaretçisi; bkz . CMapStringToString::CPair. Eşleme boşsa, değer NULL olur.

Açıklamalar

Eşleme nesnesindeki ilk öğeyi bir işaretçi döndürmek için bu işlevi çağırın.

Örnek

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

pAssocRec tarafından işaret edilen eşleme öğesini alır.

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

CPair *PGetNextAssoc(const CPair* pAssoc);

Parametreler

pAssoc
Önceki bir PGetNextAssoc veya PGetFirstAssoc çağrısı tarafından döndürülen bir eşleme girdisine işaret eder.

İade Değeri

Haritadaki bir sonraki girdinin işaretçisi; bkz . CMapStringToString::CPair. öğesi eşlemedeki son öğeyse, değer NULL olur.

Açıklamalar

Eşlemedeki tüm öğeleri yinelemek için bu yöntemi çağırın. çağrısı PGetFirstAssoc olan ilk öğeyi alın ve ardından öğesine yapılan ardışık çağrılarla PGetNextAssoceşlemede yineleyin.

Örnek

CMapStringToString::P GetFirstAssoc örneğine bakın.

CMapStringToString::P Lookup

Belirli bir anahtara eşlenen değeri arar.

const CPair* PLookup(LPCTSTR key) const;

CPair* PLookup(LPCTSTR key);

Parametreler

key
Aranacak öğenin anahtarına yönelik bir işaretçi.

İade Değeri

Belirtilen anahtarın işaretçisi.

Açıklamalar

Verilen anahtarla tam olarak eşleşen bir anahtara sahip bir eşleme öğesi aramak için bu yöntemi çağırın.

Örnek

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);
}

Ayrıca bkz.

MFC Örneği COLLECT
CObject Sınıfı
Hiyerarşi Grafiği