Iterators
Iterators are the mechanism by which SEDRIS objects are retrieved.
Provide sequential access to the set of object with satisfy search filter and search boundary criteria.
There are three classes of iterators matching the three types of relationships between objects:
- Aggregate Iterators
- Associate Iterators
- Component Iterators
Associate and Aggregate Iterators are limited to object that are one “hop” from the “start object”.
Component Iterators search the entire sub-hierarchy rooted at the start object, unless limited by the search filter.
Iterators are “traversed” using the function SE_GetNextObject
Iterators may be combined to provide multiple strategies for accessing SEDRIS objects
extern SE_STATUS_CODE_ENUM SE_GetNextObject
SE_OBJECT *next_object_out_ptr,
SE_OBJECT *association_class_object_out_ptr