CMapWordToPtr

CObject
 └CMapWordToPtr

CMapWordToPtr类支持16位字为关键码的空指针的映射。
CMapWordToPtr的成员函数与CMapStringToOb类的成员函数相似。由于这种相似性,因此可以为指定的成员函数使用CMapStringToOb参考。不管是否将CObject指针看作函数参数,还是返回值,它都会将其替换为空指针。另外,不管是否将一个指向字符的CString指针或常数指针看作函数参数,还是返回值,它都会将指针替换为WORD字。
BOOL CMapStringToOb::Lookup( const char* <key>, CObject*& <rValue> ) const;
例如,它可以转换为:
BOOL CMapWordToPtr::Lookup( const void* <key>, WORD& <rValue> ) const;
CMapWordToPtr引入了宏IMPLEMENT_DYNAMIC来支持运行状态类型的访问,并将其转储为CDumpContext对象。如果需要实现个别映射元素的转储,那么必须将转储文本的深度设置为1或更大。
字符串对指针的映射不可串行化。
当CMapWordToPtr对象或其元素被删除,那么字及指针将被删除,而指针参考的入口不会被销毁。
如果要了解有关CMapWordToPtr的更多信息,请参阅联机文档“Visual C++程序员指南”中的“收集”。
#include <afxcoll.h>


CMapWordToPtr类的成员

构造函数
CMapWordToPtr构造一个将字映射为空指针的收集

操作
Lookup返回一个使用字作为关键码的空指针
SetAt在映射中插入一个元素,但假如发现了相匹配的关键码,则替换已经存在的元素
operator []在映射中插入一个元素,它是代替SetAt的操作
RemoveKey删除关键码指定的元素
RemoveAll删除映射中所有的元素
GetStartPosition返回第一个元素的位置
GetNextAssoc获取循环中下一个元素

状态
GetCount返回映射中元素的个数
IsEmpty测试是否为空映射(即没有元素)