next up previous contents
Next: cifGetRow Up: CIFLIB Item Value Access Previous: cifGetItemValueByIndex

cifGetItemValueByAlias

NAME cifGetItemValueByAlias

PROTOTYPE

#include "ciflib.h"

int  cifGetItemValue(      char **value, 
                     const int    dataBlockIndex, 
                     const char  *aliasName,
                     const int    rowIndex)
PURPOSE

cifGetItemValueByAlias gets the address of the string representing the value of an item. The target item is identified by an item alias name and the index of the data block in which it is defined. The row index is provided to select a particular item value when multiple values exist within the category. This function checks the integrity of the target item value with respect to the item's dictionary definition.

RECEIVES

value address of the string representing the value of the item
dataBlockIndex zero-based index of the target data block
aliasName name of the target item within the target category
rowIndex zero-based index of the target row

RETURN VALUE

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

REMARKS

See also: cifGetItemValue
  cifGetItemValueByIndex



Olivera Tosic
6/17/2002