Reads up to the specified number of items of the specified size from the input stream and stores them in a buffer.

#include <stdio.h>

size_t fread (void *buffer, size_t size, size_t count, FILE *stream);

Parameters

buffer

Storage location for data.

size

Item size in bytes.

count

Maximum number of items to be read.

stream

Pointer to FILE structure.

Remarks

The file pointer associated with stream (if there is one) is increased by the number of bytes actually read.

If the stream is opened in text mode, <CR><LF> pairs are replaced with single <LF> characters. The replacement has no effect on the file pointer or the return value.

The file pointer is indeterminate if an error occurs. The value of a partially read item cannot be determined.

Return Values

• The number of full items actually read, which may be less than count if an error occurs, if the end-of-file is encountered before reaching count, or if <CR>s were removed.
• 0 (zero) and the buffer contents are unchanged if size or count is 0.
• 0 (zero). Use feof or ferror to distinguish a read error from an end-of-file condition.

Requirements

See Also

feof, ferror, fwrite, read