Reads a record from a file.

    Format

      #include  <stdio.h>

      int decc$record_read  (FILE *fp, void *buffer, int nbytes);

1 - Arguments

 fp

    A file pointer. The specified file pointer must refer to a file
    currently opened for reading.

 buffer

    The address of contiguous storage in which the input data is
    placed.

 nbytes

    The maximum number of bytes involved in the read operation.

2 - Description

    The decc$record_read function is specific to OpenVMS systems and
    should not be used when writing portable applications.

    This function is equivalent to the read function, except that the
    first argument is a file pointer, not a file descriptor.

3 - Return Values

    x                  The number of characters read.
    -1                 Indicates a read error, including physical
                       input errors, illegal buffer addresses,
                       protection violations, undefined file
                       descriptors, and so forth.