EnumeratorDefinition :: subEnumeratorEntry - Get subenumerator definition entry
In case of hierarchical enumerations, subordinated enumerators can be searched via sub enumerator lists. The function returns the enumerator definition at position passed in iPosition in the enumerator sub list. The position has to be less than the sub enumerator count (subEnumeratorCount()).
When the enumerator definition is not valid or when the requested enumerator could not be found in the sub enumerator list, the function also throws an exception.
In order to locate enumerators in a sub list by code or name, subEnumeratorDefinition() might be called.
// fragment
... function ( EnumeratorDefinition &edef ) {
EnumeratorDefinition subDef;
int i = 0;
while ( (subDef = edef.getSubEnumerator(i++)).isValid() ) {
// ... do something
}
}
Enumerator definitions provide code, name and definition for an enumerator value.
Implementation details
- iPosition
- Position in collection
The position of an element in a collection is beginning with 0 for the first element.