next up previous contents
Next: cifGetItemNameByIndex Up: CIFLIB Item Access Functions Previous: cifGetItemKeywordsByIndex

cifGetItemName

NAME cifGetItemName

PROTOTYPE

#include "ciflib.h"

char *cifGetItemName(const char *dataBlockName, 
                     const char *categoryName, 
                     const int   itemIndex);
PURPOSE

cifGetItemName returns the item name identified by its index within the target category within the target data block.

RECEIVES

dataBlockName name of the target data block
categoryName name of the target category
itemIndex zero-based index of the item within the target category

RETURN VALUE

Returns an item keyword or a NULL value for failure.

REMARKS

See also: cifGetItemNameByIndex



Olivera Tosic
6/17/2002