Troubleshooting Problems while Using the Collection Class Library

The following table provides a short summary of problems you may encounter when you use the Collection Class Library, and directs you to a section containing hints for a solution.

Problem Effect Problem Area
Compilation Errors Indicating a Problem with Constructors Default constructor is missing
Compilation Errors Indicating that an Element Type or Function Is Not Declared Declaration of template arguments and element functions not recognized
Compilation Errors about Multiple Definitions Header files may be included more than once
Compiler Warning of an Error in istdops.h Global key function return value incorrect
Link or Bind Errors about Multiple Definitions Header files may be included more than once
Link or Bind Error Indicating istdops.h No declaration of global key function
Unexpected Exception Tracing Output Trace function write is called whether or not the related exception is caught
Unexpected Results when Adding an Element to a Unique Key Collection Global key function return value incorrect
Unexpected Results when Using Cursors Undefined cursor used


Introduction to the Collection Classes
Collection Class Hierarchy
Overall Implementation Structure
Adding Elements
Removing Elements
Replacing Elements
Overview of Iteration
Iteration with Cursors
Iteration with allElementsDo
Backward-Compatible Items
Incompatibilities


Defining Equality Relation
Defining Key or Element Equality
Defining an Operations Class
Implementing Element- and Key-Type Functionality
Defining Member Functions of the Element Object Type

Defining Separate Global Functions

Using or Defining an Element Operation Class

Class Template Naming Conventions
Possible Implementation Paths
Choosing One of the Provided Implementation Variants
Adding an Element to a Collection
Removing an Element from a Collection
Using Cursors to Locate and Access Elements
Using Cursors to Iterate Over a Collection
Using allElementsDo and Applicators to Iterate Over a Collection
Adding and Overloading Member Functions
Compilation Errors Indicating a Problem with Constructors
Compilation Errors Indicating that an Element Type or Function Is Not Declared
Compilation Errors about Multiple Definitions
Compiler Warning of an Error in istdops.h
Link or Bind Errors about Multiple Definitions
Link or Bind Error Indicating istdops.h
Unexpected Exception Tracing Output
Unexpected Results when Adding an Element to a Unique Key Collection
Unexpected Results when Using Cursors