sdaiEnd
Position the specified iterator at the end of the connected aggregate, i.e. after the last element in, the connected aggregate instance so that there is no current element of the iterator. The first following sdaiPrevious operation on the actual iterator will make the last element in the connected aggregate the current element of the iterator.
For unordered aggregates the first, last, and next, element determination is left to the implementation.
The model that holds the aggregate connected to the actual iterator must be open before this function can be successfully performed.
See related functions: sdaiCreateIterator , sdaiDeleteIterator , sdaiNext , sdaiPrevious , sdaiBeginning
Header:
#include "sdai.h"
Prototype:
void sdaiEnd(SdaiIterator iterator);
Arguments:
Iterator |
A numeric iteratorID that uniquely identifies an iterator in the actual EDMserver. |
Returns:
Void – use sdaiErrorQuery function to check for error in operation.
Example:
SdaiIterator iterator;
SdaiErrorCode errCode;
SdaiAggr aggrId;
...
iterator = sdaiCreateIterator (aggrId);
. . .
sdaiEnd(iterator);
errCode = sdaiErrorQuery();
if (errCode) {
/* Error in operation */
printf("\nError: %s in sdaiEnd \n",
edmiGetErrorText(errCode));
goto error;
}
. . .