EOF
The EOF function tests the specified file unit for the end-of-file condition.
Note: The EOF function cannot be used with files opened with the RAWIO keyword to the OPEN routines. Many of the devices commonly used with RAWIO signal their end-of-file by returning a zero transfer count to the I/O operation that encounters the end-of-file.
Examples
If file unit number 1 is open, the end-of-file condition can be checked by examining the value of the expression EOF(1). For example, the following IDL code reads and prints a text file:
; Open the file readme.txt:
OPENR, 1, 'readme.txt'
; Define a string variable:
A = ''
; Loop until EOF is found:
WHILE ~ EOF(1) DO BEGIN
; Read a line of text:
READF, 1, A
; Print the line:
PRINT, A
ENDWHILE
; Close the file:
CLOSE, 1
Syntax
Result = EOF(Unit)
Return Value
If the file pointer is positioned at the end of the file, EOF returns true (1), otherwise false (0) is returned.
Arguments
Unit
The file unit to test for end-of-file.
Keywords
None.
Version History
Original |
Introduced |