Sign in Join
FPDoc Onlineexperiment

SeekEOF function

In unit System

Set file position to end of file.

Declaration

pascal
function SeekEOF(var t: Text): Boolean

Description

SeekEof returns True is the file-pointer is at the end of the file. It ignores all whitespace. Calling this function has the effect that the file-position is advanced until the first non-whitespace character or the end-of-file marker is reached.

If the end-of-file marker is reached, True is returned. Otherwise, False is returned.

If the parameter F is omitted, standard Input is assumed.

The SeekEOF function can only be used on real textfiles: when assigning the file to other kinds of (virtual) text files, the function may fail, although it will perform a number of tests to guard against wrong usage.

Errors

A run-time error is generated if the file F isn't opened.

See also

Example: ex57

pascal
Program Example57;

{ Program to demonstrate the SeekEof function. }
Var C : Char;

begin
  { this will print all characters from standard input except
    Whitespace characters. }
  While Not SeekEof do
    begin
    Read (C);
    Write (C);
    end;
end.

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.