next up previous contents
Next: cifGetItemKeywords Up: CIFLIB Item Access Functions Previous: cifGetItemKeyword

cifGetItemKeywordByIndex

NAME cifGetItemKeywordByIndex

PROTOTYPE

#include "ciflib.h"

char *cifGetItemKeywordByIndex(const int   dataBlockIndex, 
                               const int   categoryIndex, 
                               const int   itemKeywordIndex);
PURPOSE

cifGetItemKeywordByIndex returns the item keyword identified by its index within the target category within the target data block. The category and data block are identified by their indices.

RECEIVES

dataBlockIndex zero-based index of the target data block
categoryIndex zero-based index of the target category
itemKeywordIndex index of the keyword within the target category

RETURN VALUE

Returns an item keyword or a NULL value for failure.

REMARKS

See also: cifGetItemKeyword



Olivera Tosic
6/17/2002