FREAD

Section: C Library Functions (3)
Index Return to Main Contents

BSD mandoc

NAME

fread fwrite - binary stream input/output

SYNOPSIS

Fd #include <stdio.h> Ft size_t Fn fread void *ptr size_t size size_t nmemb FILE *stream Ft size_t Fn fwrite const void *ptr size_t size size_t nmemb FILE *stream

DESCRIPTION

The function Fn fread reads Fa nmemb objects, each Fa size bytes long, from the stream pointed to by Fa stream , storing them at the location given by Fa ptr .

The function Fn fwrite writes Fa nmemb objects, each Fa size bytes long, to the stream pointed to by Fa stream , obtaining them from the location given by Fa ptr .

RETURN VALUES

The functions Fn fread and Fn fwrite advance the file position indicator for the stream by the number of bytes read or written. They return the number of objects read or written. If an error occurs, or the end-of-file is reached, the return value is a short object count (or zero).

The function Fn fread does not distinguish between end-of-file and error, and callers must use feof(3) and ferror(3) to determine which occurred. The function Fn fwrite returns a value less than Fa nmemb only if a write error has occurred.

STANDARDS

The functions Fn fread and Fn fwrite conform to St -ansiC .

This document was created by man2html, using the manual pages.
Time: 15:52:53 GMT, January 15, 2023