next up previous contents
Next: cifAddRow Up: CIFLIB Item Value Update Previous: cifUpdateItemValueByIndex

cifUpdateItemValueByAlias

NAME cifUpdateItemValueByAlias

PROTOTYPE
#include "ciflib.h"

int  cifUpdateItemValueByAlias(      char *itemValue, 
                               const int   dataBlockIndex, 
                               const char *aliasName, 
                               const int   rowIndex)
PURPOSE

cifUpdateItemValueByAlias updates an item value using the source string representing the value of the item. The target item is identified by the item alias name and the data block in which the item is defined. The row index selects an existing row in the table. This function checks the integrity of the source item value with respect to the item's dictionary definition.

RECEIVES

value string representing the value of the item
dataBlockIndex zero-based index of the target data block
aliasName alias name of the target item
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 source string representing the item value is compliant with the dictionary definition.

REMARKS

See also: cifUpdateItemValue
  cifUpdateItemValueByIndex
  cifAddRow
  cifAddRowByIndex



Olivera Tosic
6/17/2002