next up previous contents
Next: cifGetCategoryKeysByIndex Up: CIFLIB Category Access Functions Previous: cifGetCategoryIndex

cifGetCategoryKeys

NAME cifGetCategoryKeys

PROTOTYPE

#include "ciflib.h"

char **cifGetCategoryKeys(const char *dataBlockName, 
                          const char *categoryName,
                                int  *numKey)
PURPOSE

cifGetCategoryKeys returns an array of key item names and the number of keys for the named category within the named data block.

RECEIVES

dataBlockName name of the target data block
categoryName name 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: cifGetCategoryKeysByIndex



Olivera Tosic
6/17/2002