mcTBnextObjIter

Name

mcTBnextObjIter — Get attributes of next key

Synopsis

#include <memcom.h>

int mcTBnextObjIter(int* iter, char* key, char* type, int* size,
                    mcRTable* rt);

Description

mcTBnextObjIter increments the user iterator to the next key and returns the attributes of this key. If iter is set to 0 the attributes of the first key in the list (if any) is returned. The function returns 0 if the key has been found. If the key does not exist, i.e the end of the list has been encountered, 1 is returned and the attributes remain undefined.

A new function providing key and type sizes will be provided in future releases.

Parameters

iter: Position iterator (input/output). If iter is set to 0 the scan starts at the beginning of the table, and the first key is returned.
key: Name of key (output). The string must be allocated before calling mcTBnextObjIter and it must be large enough. A size of 64 characters is recommended.
type: Data type of key (output). The string must be allocated before calling mcTBnextObjIter and it must be large enough. A size of 4 characters is recommended.
size: Size of key (output).
rt: Pointer to relational table in memory to be scanned (input).