next up previous contents
Next: CIFLIB Subcategory Access Functions Up: CIFLIB Category Group Access Previous: cifGetCategoryGroupsByIndex

cifGetCategoriesInCategoryGroup

NAME cifGetCategoriesInCategoryGroup

PROTOTYPE

#include "ciflib.h"

char **cifGetCategoriesInCategoryGroup(const char *dataBlockName, 
                                       const char *groupName, 
                                              int *numCategory)
PURPOSE

cifGetCategoriesInCategoryGroup returns an array of category names and the number of categories contained in the target category group within the target data block. Both the data block and category group are identified by name.

RECEIVES

dataBlockName name of the target data block
groupName name of the target category group
numCategory integer pointer to hold the returned number of categories

RETURN VALUE

Returns an array of category names or NULL for failure. If the operation is successful then the number of categories is returned in numCategory.

REMARKS

None



Olivera Tosic
6/17/2002