Quick and Dirty Collection Class Notes

Expand the Header Files folder, and open file StdAfx.h.
At the end of the file, type:
#include <afxtempl.h>    // MFC templates

///////////////////////////////////////////////////////////////////////////////
CTypedPtrMap < class BASE_CLASS, class KEY, class VALUE >

    BASE_CLASS      Base class of the typed pointer map class;
                    must be a pointer map class
                    (CMapPtrToPtr, CMapPtrToWord, CMapWordToPtr, or CMapStringToPtr).
    KEY             Class of the object used as the key to the map.
    VALUE           Class of the object stored in the map.

    The CTypedPtrMap class provides a type-safe �wrapper� for objects of the
    pointer-map classes CMapPtrToPtr, CMapPtrToWord, CMapWordToPtr, and
    CMapStringToPtr. When you use CTypedPtrMap, the C++ type-checking facility
    helps eliminate errors caused by mismatched pointer types.

    ==================================================
    Class Members
    ==================================================
    GetNextAssoc
        void GetNextAssoc( POSITION& rPosition, KEY& rKey, VALUE& rValue ) const;
    Lookup
        BOOL Lookup( BASE_CLASS::BASE_ARG_KEY key, VALUE& rValue ) const;
    RemoveKey
        BOOL RemoveKey( KEY key );
    SetAt
        void SetAt( KEY key, VALUE newValue );
    operator[]
        VALUE& operator [ ]( BASE_CLASS::BASE_ARG_KEY key );
            VALUE      Template parameter specifying the type of values stored in this map.
            BASE_CLASS Template parameter specifying the base class of this map�s class.
            key        The key of the element to be looked up or created in the map.

    ==================================================
    Create
    ==================================================
    typedef CTypedPtrMap<CMapStringToOb,CString,CMyObject*> CMapStringToMyObject;
    CMapStringToMyObject m_mapStringToMyObject;

    ==================================================
    Insert
    ==================================================
    CString strKey, strValue;
    strKey.LoadString(IDS_INITIAL_KEY);
    CMyObject* pMyObject2 = new CMyObject();
    pMyObject2->m_int = 1357;
    pMyObject2->m_float = 13.57f;
    pMyObject2->m_str.LoadString(IDS_INITIAL_STRING);
    m_mapStringToMyObject[strKey] = pMyObject2;

    ==================================================
    Iterate
    ==================================================
    CString strKey;
	CMyObject* pMyObject;
    CMapStringToMyObject& map = m_mapStringToMyObject;
	POSITION pos = map.GetStartPosition();
	while (pos != NULL)
	{
		map.GetNextAssoc(pos, strKey, pMyObject);
    }

    ==================================================
    Find
    ==================================================
    CString str;
    CMyObject* pMyObject;
    if (m_mapStringToMyObject.Lookup(strKey, pMyObject) != TRUE)
    {
		AfxMessageBox(IDS_KEY_NOT_FOUND);
		return;
	}

    ==================================================
    Update
    ==================================================
    CMyObject* pTemp = m_mapStringToMyObject[m_strKey];
	delete pTemp; // delete old value
    m_mapStringToMyObject[m_strKey] = pMyObject;

    ==================================================
    Delete
    ==================================================
    pos = m_mapStringToMyObject.GetStartPosition();
	while (pos != NULL)
	{
		CString str;
		CMyObject* pMyObject;
		m_mapStringToMyObject.GetNextAssoc(pos, str, pMyObject);
		delete pMyObject;
	}
	m_mapStringToMyObject.RemoveAll();

    ==================================================
    Serialize
    ==================================================
    m_mapStringToMyObject.Serialize(ar);