next up previous contents
Next: cifGetParentIndexList Up: CIFLIB Parent/Child Access Functions Previous: cifGetParentItemNames

cifGetChildItemNames

NAME cifGetChildItemNames

PROTOTYPE

#include "ciflib.h"

char **cifGetChildItemNames(const char *dataBlockName, 
                            const char *categoryName,
                            const char *itemKeyword,  
                                  int  *numChildren)
PURPOSE

cifGetChildItemNames returns an array of child item names for the target item. The target item is identified by its keyword and the name of the category and data block in which it is defined.

RECEIVES

dataBlockName name of the target data block
categoryName name of the target category
itemKeyword name of the target item within the target category
numChildren address of the integer to hold the number of child items

RETURN VALUE

Returns an array of child item names or a NULL value. The number of child items is returned in numChildren.

REMARKS

See also: cifGetChildIndexList



Olivera Tosic
6/17/2002