pSOSystem System Calls - Read

pREPC+ System Calls fread
fread Reads from a stream.
#include
#include
size_t fread(
void *ptr, /* buffer */
size_t size, /* element size */
size_t nmemb, /* element count */
FILE *stream /* stream pointer */
)
Description
Arguments
Return Value
Error Codes
This function reads up to nmemb elements whose size is specified by size from the
stream pointed to by stream and puts them into the user buffer pointed to by ptr.
The file position indicator for the stream (if defined) is advanced by the number of
characters successfully read. If an error occurs, the resulting value of stream’s file
position indicator is indeterminate. If a partial item is read, its value is
indeterminate.
ptr Points to the user buffer where items are stored.
size Specifies the size of each item.
nmemb Specifies the number of items to read.
stream Points to an open pREPC+ stream.
This function returns a count of the number of items successfully read. If an error
occurs, stream’s error indicator and errno are set. If size or nmemb is zero,
fread() returns 0 and the contents of the array and the state of the stream remain
unchanged.
Refer to Appendix B.
pSOSystem System Calls 3-51
3