Delete the current record after a sequentially read (sequential delete).
long cobfa_delcurr ( long fd /* file descriptor */ );
Description
The current record is deleted from the file indicated by the file descriptor <fd>.
Execution Conditions
File Organization | Sequential file | - |
Record sequential file | - | |
Relative file | Executable (*) | |
Indexed file | Executable (*) | |
Open Mode | INPUT mode | - |
OUTPUT mode | - | |
I-O mode | Executable (*) | |
EXTEND mode | - | |
Access Mode | Sequential | Executable (*) |
Random | - | |
Dynamic | - |
* : The record must have been positioned by a sequential read.
Return Values
0: Successful | Function executed successfully |
-1: Failed | Function failed. To get extended error information, call the cobfa_errno or cobfa_stat functions |
Generated Status
Return value of cobfa_errno () | Return value of cobfa_stat () | ||
---|---|---|---|
Successful | FA_ENOERR | 0 | Function executed successfully |
Failure (not all) (*) | FA_ENOTOPEN | 49 | The specified file is opened in a mode other than I-O mode. Alternatively, an invalid file descriptor is specified. |
FA_EBADACC | 90 | The file is opened with a file organization or access mode that does not allow this function to be executed. | |
FA_ELOCKED | 99 | The record positioned by sequential read is locked | |
FA_ENOCURR | 43 | Sequential read in the specified file had failed |
* : Typical status values are described above. For other values, see "Chapter 5 Error Number and I-O Status".