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

cifGetItemKeywordsByIndex

NAME cifGetItemKeywordsByIndex

PROTOTYPE

#include "ciflib.h"

char **cifGetItemKeywordsByIndex(const int  dataBlockIndex, 
                                 const int  categoryIndex, 
                                       int *numKeyword);
PURPOSE

cifGetItemKeywordsByIndex returns an array of item keywords 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
numKeyword integer pointer to hold returned number of keywords

RETURN VALUE

Returns an array of item keywords or a NULL value for failure. If the operation is successful the number of keywords is returned in numKeyword.

REMARKS

See also: cifGetItemKeywords



Olivera Tosic
6/17/2002