next up previous contents
Next: cifUpdateItemValueByAlias Up: CIFLIB Item Value Update Previous: cifUpdateItemValue

cifUpdateItemValueByIndex

NAME cifUpdateItemValueByIndex

PROTOTYPE
#include "ciflib.h"

int  cifUpdateItemValueByIndex(      char *itemValue, 
                               const int   dataBlockIndex, 
                               const int   categoryIndex,
                               const int   itemIndex, 
                               const int   rowIndex)
PURPOSE

cifUpdateItemValueByIndex updates an item value using the source string representing the value of the item. The target item is identified by the index of the keyword, category, and 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
categoryIndex zero-based index of the target category
itemIndex zero-based index 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 source string representing the item value is compliant with the dictionary definition.

REMARKS

See also: cifUpdateItemValue
  cifUpdateItemValueByAlias
  cifAddRow
  cifAddRowByIndex


next up previous contents
Next: cifUpdateItemValueByAlias Up: CIFLIB Item Value Update Previous: cifUpdateItemValue
Olivera Tosic
6/17/2002