Class Hierarchy
AcRxObject AcRxDictionary
C++
class AcRxDictionary : public AcRxObject;
File
rxdict.h
Description
This class maintains a collection of pointers to an AcRxObject, with keyed search via either a char* text string, or a 32-bit ID. Neither the key nor the stored pointer value may be NULL.
An instance of this class can only be created via the class AcRxKernel, which provides three overloaded versions of the function newAcRxDictionary().
The AcRxDictionary may be instantiated so that it sorts based on the key or does not sort the entries at all. In either case the dictionary may be set up to delete the contained AcRxObject pointers when they are removed, replaced, or the dictionary is deleted. If the dictionary is not set up to delete its entries (the service registry dictionary is set up this way), then it is up to the user to delete them.
If the dictionary is set up not to delete the AcRxObject entries, then it returns their pointer values from atPut() and remove() calls, making it easier to delete them if desired. Otherwise NULL is returned, and delete is called on the pointers.
Links
See Also
AcRxKernel, AcRxDictionaryIterator