cifGetSubcategories

NAME cifGetSubcategories

PROTOTYPE

#include "ciflib.h"

char **cifGetSubcategories(const char *dataBlockName, 
                           const char *categoryName, 
                                 int  *numSubcategory)

PURPOSE

cifGetSubcategories returns an array of subcategory names and the number of subcategories in the target category within the target data block. The category and data block are identified by name. This function will always return at least one subcategory which is named after the category and contains all of the category items.

RECEIVES

dataBlockName	name of the target data block
categoryName	name of the target category
numSubcategory	integer pointer to hold the returned number of subcategories

RETURN VALUE

Returns an array of subcategory names or a NULL value for failure. If the operation is successful then the number of subcategories is returned in numSubcategory

REMARKS

None