cifGetChildIndexList

NAME cifGetChildIndexList

PROTOTYPE

#include "ciflib.h"

int cifGetChildIndexList(const char  *dataBlockName, 
                         const char  *categoryName,
                         const char  *itemKeyword,  
                               int  **childCategoryIndex,
                               int  **childItemIndex,
                               int   *numChildren)

PURPOSE

cifGetChildIndexList retrieves arrays of category and item indices for the the children 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
childCategoryIndex	address of the integer array to hold child category indices
childItemIndex	address of the integer array to hold child item indices
numChildren	address of the integer to hold the number of child 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 children are also returned.

REMARKS

See also:	cifGetChildItemNames