fread

来自cppreference.com
< c‎ | io
 
 
 
定义于头文件 <stdio.h>
size_t fread( void          *buffer, size_t size, size_t count,
              FILE          *stream );
(C99 前)
size_t fread( void *restrict buffer, size_t size, size_t count,
              FILE *restrict stream );
(C99 起)

从给定输入流stream读取至多count个对象到数组buffer,如同按照对每个对象调用sizefgetc然后按顺序存出结果到buffer的递增位置,这里它被转译成unsigned char数组。流的文件位置指示器会前进所读的字符数。

若发生错误,则文件位置指示器的生成值是不确定的。若读入元素只有一部分,则其值不确定。

目录

[编辑] 参数

buffer - 指向被读取对象存储数组的指针
size - 每个对象的字节大小
count - 要读入的对象数
stream - 要读取的流

[编辑] 返回值

成功读入的对象数,它可能小于count,若发生错误或文件尾条件。

sizecount为零,则fread返回零且不进行其他行动。

fread不区别文件尾和错误,而调用者必须用feofferror鉴别何者发生。

[编辑] 示例

#include <stdio.h>
 
enum { SIZE = 5 };
int main(void)
{
    double a[SIZE] = {1.,2.,3.,4.,5.};
    FILE *fp = fopen("test.bin", "wb"); // 必须用二进制模式
    fwrite(a, sizeof *a, SIZE, fp); // 写double的数组
    fclose(fp);
 
    double b[SIZE];
    fp = fopen("test.bin","rb");
    size_t ret_code = fread(b, sizeof *b, SIZE, fp); // 读double的数组
    if(ret_code == SIZE) {
        puts("Array read successfully, contents: ");
        for(int n = 0; n < SIZE; ++n) printf("%f ", b[n]);
        putchar('\n');
    } else { // error handling
       if (feof(fp))
          printf("Error reading test.bin: unexpected end of file\n");
       else if (ferror(fp)) {
           perror("Error reading test.bin");
       }
    }
 
    fclose(fp);
}

输出:

1.000000 2.000000 3.000000 4.000000 5.000000

[编辑] 参考

  • C11 standard (ISO/IEC 9899:2011):
  • 7.21.8.1 The fread function (p: 335)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.19.8.1 The fread function (p: 301)
  • C89/C90 standard (ISO/IEC 9899:1990):
  • 4.9.8.1 The fread function

[编辑] 参阅

stdin、文件流或缓冲区读取格式化输入
(函数) [编辑]
从文件流获取一个字符串
(函数) [编辑]
写入到文件
(函数) [编辑]
freadC++文档