next up previous contents
Next: cifGetItemNamesByIndex Up: CIFLIB Item Access Functions Previous: cifGetItemNameByIndex

cifGetItemNames

NAME cifGetItemNames

PROTOTYPE

#include "ciflib.h"

char **cifGetItemNames(const char *dataBlockName, 
                       const char *categoryName, 
                             int  *numItem);
PURPOSE

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

RECEIVES

dataBlockName name of the target data block
categoryName name of the target category
numItem integer pointer to hold returned number of items

RETURN VALUE

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

REMARKS

See also: cifGetItemNamesByIndex



Olivera Tosic
6/17/2002