next up previous contents
Next: cifCountRows Up: CIFLIB Category Access Functions Previous: cifGetCategoryKeys

cifGetCategoryKeysByIndex

NAME cifGetCategoryKeysByIndex

PROTOTYPE

#include "ciflib.h"

char **cifGetCategoryKeysByInex(const int  dataBlockIndex, 
                                const int  categoryIndex,
                                      int *numKey)
PURPOSE

cifGetCategoryKeys returns an array of key item names and the number of keys for the target category within the target data block. Both category and data block are identified by their indices.

RECEIVES

dataBlockIndex zero-based index of the target data block
categoryIndex zero-based index of the target category
numKey an integer pointer to hold the number of keys

RETURN VALUE

Returns an array of key item names or a NULL value for failure. If the operation is successful the number of keys is returned in numKey.

REMARKS

See also: cifGetCategoryKeys



Olivera Tosic
6/17/2002