Synopsis:

       ret_val=db_fput(rec_handle,fieldnr/name,data)

Arguments:

       rec_handle - The record handle returned from db_get() or db_append()

       fieldnr/name - The field number or field name

       data - the value to write to the field

       

Description:  This function writes the specified data to the internal copy of the record represented by rec_handle.    Note that only the internal copy of the record is changed and that the actual DBF file is not updated until a db_rls() call is made.   However if the field being written is an index field with an associated open NTX file (opened by db_ixopen()),  then this index will be locked, updated and unlocked.          Therefore it is possible that for index fields this call can fail due to a locking conflict and the return value should be checked for this possiblility by the programmer (and the db_fput() call should be retried if this happens or a graceful recovery should be made).

Returns:   Returns 0 upon success or a negative error code.