next up previous contents
Next: cifGetCategoryNames Up: CIFLIB Category Access Functions Previous: cifCountCategoriesByIndex

cifGetCategoryName

NAME cifGetCategoryName

PROTOTYPE

#include "ciflib.h"

char *cifGetCategoryName(const char *dataBlockName, 
                         const int categoryIndex)
PURPOSE

cifGetCategoryName returns the name of the category identified by its index within the named data block.

RECEIVES

dataBlockName the name of the target data block
categoryIndex the zero-based index of the target category

RETURN VALUE

Returns a category name or a NULL value for failure.

REMARKS

See also: cifGetCategoryNames
  cifGetCategoryNameByIndex
  cifGetCategoryNamesByIndex
  cifGetCategoryIndex



Olivera Tosic
6/17/2002