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

cifGetCategoryNamesByIndex

NAME cifGetCategoryNamesByIndex

PROTOTYPE

#include "ciflib.h"

char **cifGetCategoryNamesByIndex(const int  dataBlockIndex, 
                                        int *numCategory)
PURPOSE

cifGetCategoryNamesByIndex returns an array of category names and the number categories within the data block identified by its index.

RECEIVES

dataBlockIndex zero-based index 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
  cifGetCategoryNames
  cifGetCategoryNameByIndex
  cifGetCategoryIndex



Olivera Tosic
6/17/2002