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對象或其元素被刪除,那么字及指針將被刪除,而指針參考的入口不會被銷毀。
#include <afxcoll.h>
CMapWordToPtr類的成員
構造函式
CMapWordToPtr | 構造一個將字映射為空指針的收集 |
操作
Lookup | 返回一個使用字作為關鍵碼的空指針 |
SetAt | 在映射中插入一個元素,但假如發現了相匹配的關鍵碼,則替換已經存在的元素 |
operator [] | 在映射中插入一個元素,它是代替SetAt的操作 |
RemoveKey | 刪除關鍵碼指定的元素 |
RemoveAll | 刪除映射中所有的元素 |
GetStartPosition | 返回第一個元素的位置 |
GetNextAssoc | 獲取循環中下一個元素 |
狀態
GetCount | 返回映射中元素的個數 |
IsEmpty | 測試是否為空映射(即沒有元素) |