mcTBnextObj

Name

mcTBnextObj — Get attributes of next key

Synopsis

#include <memcom.h>

int mcTBnextObj(int poscode, char* key, char* type, int* size,
                mcRTable* rt);

Description

mcTBnextObj returns the attributes of the next key in a relational table if the position code poscode is set to 1. If poscode 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

poscod: Position code (input). If poscode is set to 0 the scan starts at the beginning of the table, and the first key is returned. If poscode is set to 1 the scan continues at the current position.
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).