C 编程/stdio.h/fread
外观
fread 是一个从文件读取缓冲的二进制输入的函数。[1] 它包含在标准 C 库中的 stdio.h 头文件中。
size_t fread (void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream)
fread
函数从名为 stream
的输入流中复制 nmemb
个大小为 size
的数据项到 ptr
指向的数组中。数据项是一个字节序列(不一定是空字节结尾),长度为 size
。当读完 nmemb
个数据项、遇到文件结尾或发生错误时,fread
停止追加字节。返回时,fread
将流中的文件指针设置为指向已读最后一个字节的下一个字节。stream
的内容保持不变。fread
函数返回实际读取的数据项数量。如果 nmemb
为零,则不执行任何操作,函数将返回 0。
- ↑ ISO/IEC 9899:1999 规范 (PDF). p. 301, § 7.19.8.1.