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

cifGetItemKeywords

NAME cifGetItemKeywords

PROTOTYPE

#include "ciflib.h"

char **cifGetItemKeywords(const char *dataBlockName, 
                          const char *categoryName, 
                                int  *numKeyword);
PURPOSE

cifGetItemKeywords returns an array of item keywords within the target category within the target data block. The category and data block are identified by name.

RECEIVES

dataBlockName name of the target data block
categoryName name 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: cifGetItemKeywordsByIndex



Olivera Tosic
6/17/2002