next up previous contents
Next: cifGetCategoryNameByIndex Up: CIFLIB Category Access Functions Previous: cifGetCategoryName

cifGetCategoryNames

NAME cifGetCategoryNames

PROTOTYPE

#include "ciflib.h"

char **cifGetCategoryNames(const char *dataBlockName, 
                                 int  *numCategory)
PURPOSE

cifGetCategoryNames returns an array of category names within the named data block and the number categories.

RECEIVES

dataBlockName the name of the target data block
numCategory integer pointer to hold the number of categories

RETURN VALUE

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

REMARKS

See also: cifGetCategoryName
  cifGetCategoryNameByIndex
  cifGetCategoryNamesByIndex
  cifGetCategoryIndex



Olivera Tosic
6/17/2002