fpkey_change()

Function fpkey_change is used to change an index key. The old key is deleted and the new key value gets added.

The syntax for fpkey_change is as follows:

fpkey_change(int file_id, int index, char *old_keyval, char *new_keyval, int *recno)

    int file_id       - File unit of open file from previous 
                        fpfile_open function.
    
    int index         - Index number to search on.

    int *old_keyval   - Value of original "old" key to be changed.

    int *new_keyval   - Value of new key to be added.   
 
    int *recno        - Record address from a previous get/lock operation.

The possible values for fperrno and an explanation of each value follow.

     Value            Explanation
     --------------------------------------------------
     FEROK  - Code  0: Successful FASTPLUS Operation 
     FERACC - Code  2: Illegal access rights
     FEROPN - Code  5: FAST file does not exist
     FERUNT - Code  6: Illegal FAST file id
     FERLEN - Code  7: Illegal record length
     FERDSK - Code  8: Disk is full
     FERFHE - Code  9: System file error
     FEREXT - Code 12: Record not found
     FERNLK - Code 16: Record not locked
     FERFCT - Code 19: Illegal function