Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄CObject►                                     ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  Description
 
  The CMapPtrToPtr class supports maps of void pointers keyed by void
  pointers.
 
  The member functions of CMapPtrToPtr are similar to the member functions
  of class ◄CMapStringToOb►. Because of this similarity, you can use the
  CMapStringToOb reference documentation for member function specifics.
  Wherever you see a CObject pointer as a function parameter or return
  value, substitute a pointer to void. Wherever you see a CString or a
  const pointer to char as a function parameter or return value,
  substitute a pointer to void.
 
  BOOL CMapStringToOb::Lookup( const char* <key>,
                               CObject*& <rValue> ) const;
 
 
  for example, translates to
 
  BOOL CMapPtrToPtr::Lookup( void* <key>, void*& <rValue> ) const;
 
  CMapPtrToPtr incorporates the IMPLEMENT_DYNAMIC macro to support
  run-time type access and dumping to a CDumpContext object. If you need a
  dump of individual map elements (pointer values), you must set the depth
  of the dump context to 1 or greater.
 
  Pointer-to-pointer maps may <not> be serialized.
 
  When a CMapPtrToPtr object is deleted, or when its elements are removed,
  only the pointers are removed, not the entities they reference.
 
  #include <afxcoll.h>
 
  Public Members
 
  Construction/Destruction
 
  ◄CMapPtrToPtr►   Constructs a collection that maps void pointers to void
                   pointers.
 
  ◄~CMapPtrToPtr►   Destroys a CMapPtrToPtr object.
 
  Operations
 
  ◄Lookup►             Looks up a void pointer, based on the void pointer
                       key. The pointer value is used for the key
                       comparison, not the entity it points to.
 
  ◄SetAt►              Inserts an element into the map; replaces an
                       existing element if a matching key is found.
 
  ◄operator []►        Inserts an element into the map──operator
                       substitution for SetAt.
 
  ◄RemoveKey►          Removes an element specified by a key.
 
  ◄RemoveAll►          Removes all the elements from this map.
 
  ◄GetStartPosition►   Returns the position of the first element.
 
  ◄GetNextAssoc►       Gets the next element for iterating.
 
  Status
 
  ◄GetCount►   Returns the number of elements in this map.
 
  ◄IsEmpty►    Tests for the empty-map condition (no elements).
 
 
                                     -♦-
 
  Specifies the memory-allocation granularity for extending the map.