1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
/////////////////////////////////////////////////////////////////////////////
// class CMap - a mapping from fixed length 'KEY's to fixed size 'VALUE's.
//
// NOTE: ARG_KEY must be either an lvalue or a reference type; no pointers;
// that is, the type of &ARG_KEY must be the same as &KEY.
// Same for ARG_VALUE/VALUE.
//
// This template class uses the MapKeyToValue implementation in compobj.dll.
/////////////////////////////////////////////////////////////////////////////
//$DECLARE_TEMPLATE
////////////////////////////////////////////////////////////////////////////
template<class KEY, class ARG_KEY, class VALUE, class ARG_VALUE>
class FAR CMap<KEY, ARG_KEY, VALUE, ARG_VALUE>
{
public:
// Construction
CMap(DWORD memctx = MEMCTX_SAME, UINT nBlockSize=10)
: m_mkv(memctx, sizeof(VALUE), sizeof(KEY), nBlockSize) { }
// Attributes
// number of elements
int GetCount() const
{ return m_mkv.GetCount(); }
BOOL IsEmpty() const
{ return GetCount() == 0; }
// Lookup
BOOL Lookup(ARG_KEY key, VALUE FAR& value) const
{ return m_mkv.Lookup((LPVOID)&key, sizeof(KEY), (LPVOID)&value); }
BOOL LookupHKey(HMAPKEY hKey, VALUE FAR& value) const
{ return m_mkv.LookupHKey(hKey, (LPVOID)&value); }
BOOL LookupAdd(ARG_KEY key, VALUE FAR& value) const
{ return m_mkv.LookupAdd((LPVOID)&key, sizeof(KEY), (LPVOID)&value); }
// Add/Delete
// add a new (key, value) pair
BOOL SetAt(ARG_KEY key, ARG_VALUE value)
{ return m_mkv.SetAt((LPVOID)&key, sizeof(KEY), (LPVOID)&value); }
BOOL SetAtHKey(HMAPKEY hKey, ARG_VALUE value)
{ return m_mkv.SetAtHKey(hKey, (LPVOID)&value); }
// removing existing (key, ?) pair
BOOL RemoveKey(ARG_KEY key)
{ return m_mkv.RemoveKey((LPVOID)&key, sizeof(KEY)); }
BOOL RemoveHKey(HMAPKEY hKey)
{ return m_mkv.RemoveHKey(hKey); }
void RemoveAll()
{ m_mkv.RemoveAll(); }
// iterating all (key, value) pairs
POSITION GetStartPosition() const
{ return m_mkv.GetStartPosition(); }
void GetNextAssoc(POSITION FAR& rNextPosition, KEY FAR& rKey, VALUE FAR& rValue) const
{ m_mkv.GetNextAssoc(&rNextPosition, (LPVOID)&rKey, NULL, (LPVOID)&rValue); }
HMAPKEY GetHKey(ARG_KEY key) const
{ return m_mkv.GetHKey((LPVOID)&key, sizeof(KEY)); }
#ifdef _DEBUG
void AssertValid() const
{ m_mkv.AssertValid(); }
#endif
private:
CMapKeyToValue m_mkv;
};
|