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

cifGetParentIndexList

NAME cifGetParentIndexList

PROTOTYPE
#include "ciflib.h"

int cifGetParentIndexList(const char  *dataBlockName, 
                          const char  *categoryName,
                          const char  *itemKeyword,  
                                int  **parentCategoryIndex,
                                int  **parentItemIndex,
                                int   *numParents)
PURPOSE

cifGetParentIndexList retrieves arrays of category and item indices for the the parents of 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
parentCategoryIndex address of the integer array to hold parent category indices
parentItemIndex address of the integer array to hold parent item indices
numParents address of the integer to hold the number of parent items

RETURN VALUE

Returns a value of 1 if the operation was successful or a value of 0 for failure. If the operation is successful then the index arrays and number of parents are also returned.

REMARKS

See also: cifGetParentItemNames



Olivera Tosic
6/17/2002