CMapStringToString

CObject
 └CMapStringToString

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


CMapStringToString类的成员

构造函数
CMapStringToString构造一个将CString对象映射为CString对象的收集

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

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