next up previous contents
Next: cifGetRowByIndex Up: CIFLIB Item Value Access Previous: cifGetItemValueByAlias

cifGetRow

NAME cifGetRow

PROTOTYPE

#include "ciflib.h"

int  *cifGetRow(      char ***value, 
                const char   *dataBlockName, 
                const char   *categoryName,
                const int     rowIndex
                      int    *numItem)
PURPOSE

cifGetRow 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 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
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



Olivera Tosic
6/17/2002