Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

  ◄Summary► ◄Details► ◄Example►                                   ◄Back►
 
  Argument
 
    file_variable    Optional; an open text file (default is the
                     standard file Input)
 
  Returns
 
    Boolean          True if current position is at an end-of-line
                     marker (ignoring blanks and tabs) or if Eof
                     returns True; otherwise False
 
  Description
 
    The SeekEoln function returns a Boolean value indicating whether
    the current file position is at an end-of-line marker in an open
    text file. It checks forward from the current position to the next
    element in the file and ignores any blanks or tabs (or any
    character with an ASCII value less than 33).
 
    If SeekEoln finds an end-of-line, end-of-file, the actual end of
    the file, or an empty file, it returns True. If SeekEoln finds any
    character other than the ones it ignores, it returns False.
 
    SeekEoln does not change the current file position.
 
    The end-of-file marker is the character CTRL+Z (ASCII 26). The
    end-of-line marker is a carriage return (ASCII 13).
 
    SeekEoln differs from the Eoln function by ignoring blanks and tabs
    in determining whether the end of a line has been reached. Thus,
    SeekEoln may be more useful than Eoln for reading text files of
    numeric data.
 
    If file_variable is not associated with a file or if the file is
    not open when SeekEoln is called, an I/O error occurs.
 
    To prevent a program from halting with a run-time error when an
    I/O error occurs, turn off I/O checking with {$I-} and check the
    return value of the IOResult function.