Writes end-of-file record to file.
Syntax
The syntax of the ENDFILE
statement can take one of the following forms:
Short form:
ENDFILE integer-expression |
Long form:
ENDFILE (io-specifier-list) |
- integer-expression
is the number of the unit connected to a sequential
file.
- io-specifier-list
is a list of the following comma-separated I/O
specifiers:
- [UNIT=]unit
specifies the unit connected to a device or external
file opened for sequential access. unit
must be an integer expression that evaluates to a nonnegative number.
If the optional keyword UNIT=
is omitted, unit must be the first item
in io-specifier-list.
- ERR=stmt-label
specifies the label of the executable statement
to which control passes if an error occurs during statement execution.
- IOSTAT=integer-variable
returns the I/O status after the statement
executes. If the statement executes successfully, integer-variable
is set to zero. If an error occurs, it is set to a positive integer
that indicates which error occurred.
Description
The ENDFILE
statement writes an end-of-file record to the file or device connected
to the specified unit at the current position and positions the
file after the end-of-file record.
An end-of-file record can occur only as the last record of
a disk file. After execution of an ENDFILE
statement, the file is positioned beyond the end-of-file record;
any records beyond the current position are lost—that is,
the file is truncated.
Some devices (for example, magnetic tape units) can have multiple
end-of-file records, with or without intervening data records.
An end-of-file record can be written to a sequential file
only.
Examples
The following statement writes an end-of-file record to the
file connected to unit 10:
The following statement writes an end-of-file record to the
file connected to unit 17. If an error occurs during the execution
of the statement, control passes to the statement at label 99, and
the error code is returned in ios:
INTEGER :: ios
...
ENDFILE (17, ERR=99, IOSTAT=ios) |
Related statements
BACKSPACE,
OPEN, and REWIND
Related concepts
For information about I/O concepts, see Chapter 8 “I/O and file handling”, which also lists
example programs that use I/O. For information about I/O
formatting, see Chapter 9 “I/O formatting”.
Printable version
