Writes a record to a file.

    Format

      #include  <stdio.h>

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

1  –  Arguments

 fp

    A file pointer. The specified file pointer must refer to a file
    currently opened for writing or updating.

 buffer

    The address of contiguous storage from which the output data is
    taken.

 nbytes

    The maximum number of bytes involved in the write operation.

2  –  Description

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

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

3  –  Return Values

    x                  The number of bytes written.
    -1                 Indicates errors, including undefined file
                       descriptors, illegal buffer addresses, and
                       physical I/O errors.