FileSystem.EOF(Int32) Method

Definition

Returns a Boolean value True when the end of a file opened for Random or sequential Input has been reached.

public:
 static bool EOF(int FileNumber);
public static bool EOF (int FileNumber);
static member EOF : int -> bool
Public Function EOF (FileNumber As Integer) As Boolean

Parameters

FileNumber
Int32

Required. An Integer that contains any valid file number.

Returns

A Boolean value True when the end of a file opened for Random or sequential Input has been reached.

Exceptions

File mode is invalid.

Examples

This example uses the EOF function to detect the end of a file. This example assumes that Testfile is a text file that contains several lines of text.

Dim TextLine As String
' Open file.
FileOpen(1, "TESTFILE", OpenMode.Input)
' Loop until end of file.
Do Until EOF(1)
    ' Read the line into a variable.
    TextLine = LineInput(1)
    ' Display the line in a message box.
    MsgBox(TextLine)
Loop
FileClose(1)

Remarks

Use EOF to avoid the error generated by attempting to get input past the end of a file.

The EOF function returns False until the end of the file has been reached. With files opened for Random or Binary access, EOF returns False until the last executed FileGet function is unable to read a whole record.

With files opened for Binary access, an attempt to read through the file using the Input function until EOF returns True generates an error. Use the LOF and Loc functions instead of EOF when reading binary files with Input, or use Get when using the EOF function. With files opened for Output, EOF always returns True.

Applies to

See also