cifGetColumnByIndex

NAME cifGetColumnByIndex

PROTOTYPE

#include "ciflib.h"

int  *cifGetColumnByIndex(      char ***value, 
                          const int     dataBlockIndex, 
                          const int     categoryIndex,
                          const int     itemIndex
                                int     *numValues)

PURPOSE

cifGetColumnByIndex gets the address of an array of strings representing the values of each item in the target column 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
itemIndex	zero-based index of the target item within the target category
numValues	address of the integer to hold the number of values in the column

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:	cifGetColumnByIndex