Get

The procedure get retrieves a datum from a file of … and advances the reading cursor. Although get is a standardized Pascal routine, in the FPC get is only available in an ISO-compliant mode, such as {$mode ISO}.

behavior

edit

requirements

edit

Before get is executed, two requirements must be met:

  1. The file must be in inspection mode.
  2. The file’s “cursor” may not be past EOF.

A run-time error occurs if either condition is not satisfied.

effect

edit

Get

  1. advances the cursor by one record
  2. makes the new current record accessible via the file’s buffer variable.

To put this into relation:

  • read(f, x) is equivalent to x := f^; get(f).
  • readLn(f) is equivalent to while not EOLn(f) do get(f); get(f). The latter get(f) actually consumes the newline marker.
  • reset(f) is semantically equivalent to seekRead(f, pred(firstRecord)); get(f) where firstRecord is the index of the first record.

application

edit

Get is especially used to

  • read the file buffer variable multiple times at various locations (e. g. subroutines),
  • eliminate the need for an extra buffer variable.
program echo(input, output);
begin
    while not EOF(input) do
    begin
        output^ := input^;
        get(input);
        put(output);
    end;
end.

see also

edit