next up previous contents
Next: cifGetItemAliasName Up: CIFLIB Item Access Functions Previous: cifGetItemNames

cifGetItemNamesByIndex

NAME cifGetItemNamesByIndex

PROTOTYPE

#include "ciflib.h"

char **cifGetItemNamesByIndex(const int  dataBlockIndex, 
                              const int  categoryIndex, 
                                    int *numItem);
PURPOSE

cifGetItemNamesByIndex 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 their indices.

RECEIVES

dataBlockIndex zero-based index of the target data block
categoryIndex zero-based index 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: cifGetItemNames



Olivera Tosic
6/17/2002