Description

mcDBgetSetNextIter increment the user iterator to the next dataset and returns the attributes of the dataset in a database. The attributes are returned in a structure of type mcSetAttributes. The structure must be declared by the calling function. If the next set exists, the function returns 1 (true). If not, it returns 0 (false), meaning that the last set has been encountered. The user iterator can become invalid (and must by considered invalid) after a call to a MemCom function that insert, remove or rename a set on the database, and after a mcDBpack on the database.

Parameters

Example

mcDBgetSetNextIter is usually called to get a view of all dataset in the current file. The example below loops over all datasets:

struct mcSetAttributes att;
int iter;

int iter = 0;        /* gets first set */
while ( mcDBgetSetNextIter( handle, &iter, &att ) ) {
    /* do someting with att... */
}