cifGetColumn

NAME cifGetColumn

PROTOTYPE

#include "ciflib.h"

int  *cifGetColumn(      char  ***value, 
                   const char    *dataBlockName, 
                   const char    *categoryName,
                   const char    *itemKeyword,
                         int     *numValues)

PURPOSE

cifGetColumn 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 name 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
dataBlockName	name of the target data block
categoryName	name of the target category
itemKeyword	name 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