fpkey_add()

Function fpkey_add adds an index value to a file from within an application program. This function must have the record address from a previous call to fpdata_add, fpdata_get or fpkey_get.

The syntax for fpkey_add is as follows:

fpkey_add(int file_id, char *keyval, int *recno)

   int file_id       - File unit of open file from previous 
                       fpfile_open function.

   char *keyval      - Value of key to add.

   int *recno        - Record address from a previous 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
     FERDSK - Code  8: Disk is full
     FERFHE - Code  9: System file error
     FERIND - Code 10: Illegal index number
     FERDUP - Code 11: Duplicate key value
     FEREXT - Code 12: Record not found