cifUpdateItemValue

NAME cifUpdateItemValue

PROTOTYPE

#include "ciflib.h"

int  cifUpdateItemValue(      char *itemValue, 
                        const char *dataBlockName, 
                        const char *categoryName,
                        const char *itemKeyword, 
                        const int   rowIndex)

PURPOSE

cifUpdateItemValue updates an item value using the source string representing the value of the item. The target item is identified by the name 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
dataBlockName	name of the target data block
categoryName	name of the target category
itemKeyword	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 source string representing the item value is compliant with the dictionary definition.

REMARKS

See also:	cifUpdateItemValueByIndex
	cifUpdateItemValueByAlias
	cifAddRow
	cifAddRowByIndex