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

cifGetParentItemNames

NAME cifGetParentItemNames

PROTOTYPE

#include "ciflib.h"

char **cifGetParentItemNames(const char *dataBlockName, 
                             const char *categoryName,
                             const char *itemKeyword,  
                                   int  *numParents)
PURPOSE

cifGetParentItemNames returns an array of parent item names for the 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
numParents address of the integer to hold the number of parent items

RETURN VALUE

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

REMARKS

See also: cifGetParentIndexList



Olivera Tosic
6/17/2002