cifGetRowByIndex

NAME cifGetRowByIndex

PROTOTYPE

#include "ciflib.h"

int  *cifGetRowByIndex(      char ***value, 
                       const int     dataBlockIndex, 
                       const int     categoryIndex,
                       const int     rowIndex
                             int    *numItem)

PURPOSE

cifGetRowByIndex gets the address of an array of strings representing the values of each item in the target row of the target table. The table is identified by the index of the category, and by the data block in which it is defined. This function checks the integrity of each item value with respect to the item's dictionary definition.

RECEIVES

value	address of an array of strings representing the values of each item
dataBlockIndex	zero-based index of the target data block
categoryIndex	zero-based index of the target category
rowIndex	zero-based index of the target row
numItem	address of the integer to hold the number of items in the row

RETURN VALUE

Returns an array of integer CIFLIB error codes. If a code CIF_DATA_IS_VALID is returned, then the associated value returned as a string is compliant with its dictionary definition.

REMARKS

See also:	cifGetRowByIndex