next up previous contents
Next: CIFLIB Item Access Functions Up: CIFLIB Subcategory Access Functions Previous: cifGetItemNamesInSubcategory

cifGetItemKeywordsInSubcategory

NAME cifGetItemKeywordsInSubcategory

PROTOTYPE

#include "ciflib.h"

char **cifGetItemKeywordsInSubcategory(const char *dataBlockName, 
                                       const char *categoryName, 
                                       const char *subcategoryName, 
                                              int *numKeyword)
PURPOSE

cifGetItemKeywordsInSubcategory returns an array of item keywords and the number of item keywords contained within the target subcategory, category and data block. The subcategory, category, and data block are identified by name.

RECEIVES

dataBlockName name of target data block
categoryName name of target category
subcategoryName name of target subcategory
numKeyword integer pointer to hold returned number of item keywords

RETURN VALUE

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

REMARKS

None



Olivera Tosic
6/17/2002