fread(3) - Linux man page

名称

fread, fwrite - 二进制流输入/输出

概要

#include <stdio.h>
size_t fread(void *ptr, size_t size, size_t nmembFILE *" stream );

size_t fwrite(const void *ptr, size_t size, size_t nmemb,
FILE *stream);

描述

函数 fread() 从 stream 指向的流中读取 nmemb 个元素,每个元素 size 字节长,并将它们存储到 ptr 给定的位置。

函数 fwrite() 将 nmemb 个元素,每个元素 size 字节长,写入到 stream 指向的流中,从 ptr 给定的位置获取数据。

对于非锁定的对应函数,请参阅 unlocked_stdio(3)

返回值

成功时,fread() 和 fwrite() 返回读取或写入的 items 的数量。当 size 为 1 时,此数量等于传输的字节数。如果发生错误,或者到达文件末尾,则返回值是短项目计数(或零)。

fread() 不区分文件末尾和错误,调用者必须使用 feof(3)ferror(3) 来确定发生了哪种情况。

符合

C89, POSIX.1-2001。

参见

read(2), write(2), feof(3), ferror(3), unlocked_stdio(3)

引用自

cgi_register_parse_cb(3), explain(1), explain(3), explain_fread(3), explain_fread_or_die(3), fgets(3), getline(3), putw(3), setbuf(3), stdin(3)