cifGetItemNamesInSubcategory

NAME cifGetItemNamesInSubcategory

PROTOTYPE

#include "ciflib.h"

char **cifGetItemNamesInSubcategory(const char *dataBlockName, 
                                    const char *categoryName, 
                                    const char *subcategoryName, 
                                           int *numItemName)

PURPOSE

cifGetItemNamesInSubcategory returns an array of item names and the number of items 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
numItemName	integer pointer to hold the returned number of items

RETURN VALUE

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

REMARKS

See also:	cifGetItemNamesInSubcategoryByIndex