decc$record_read

Reads a record from a file.

Format 

#include  <stdio.h>

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

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.

Description

This function is specific to OpenVMS systems and should not be used when writing portable applications.

The decc$record_read function is functionally equivalent to the read function, except that the first argument is a file pointer, not a file descriptor.

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. 

Previous Page | Next Page | Table of Contents | Index