CMapStringToPtr

CObject

└CMapStringToPtr

CMapStringToPtr类支持CString 对象为关键码的空指针映射。
StringToPtr的成员函数与CMapStringToOb类的成员函数相似。由于这种相似性，因此可以为指定的成员函数使用CMapStringToOb参考。不管是否将CObject指针看作函数参数，还是返回值，它都会将指针替换为空值。另外，不管是否将CString指针看作函数参数，还是返回值，它都会将指针替换为空值。
BOOL CMapStringToOb::Lookup( const char* <key>, CObject*& <rValue> ) const;
例如, 它可以转换为：
BOOL CMapStringToPtr::Lookup( void* <key>, void*& <rValue> ) const;
CMapStringToPtr引入了宏IMPLEMENT_DYNAMIC来支持运行状态类型的访问，并将其转储为CDumpContext对象。如果需要实现个别映射元素的转储，那么必须将转储文本的深度设置为1或更大。
字符串对指针的映射不可串行化。
当CMapStringToPtr对象或其元素被删除，那么CString键对象及对应的字被删除。
#include <afxcoll.h>

CMapStringToPtr类的成员

构造函数

CMapStringToPtr

构造一个将CString对象映射为空指针的收集

操作

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

状态

GetCount	返回映射中元素的个数
IsEmpty	测试是否为空映射（即没有元素）