fread 和 fwrite 翻译

FREAD(3)                                      Linux Programmer's Manual                                      FREAD(3)

NAME
       fread, fwrite - binary stream input/output	/*二进制流输入/输出*/

SYNOPSIS
       #include <stdio.h>

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

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

DESCRIPTION
       The  function  fread()  reads nmemb items of data, each size bytes long, from the stream pointed to by stream, storing them at the location given by ptr.
	   /*fread 函数用于从 stream 指向的文件流中读取 nmemb 个数据项，每个数据项有 size 个长整型字节大小，然后将这些
	   数据项存储到 ptr 所指向的地址空间*/

       The function fwrite() writes nmemb items of data, each size bytes long, to the stream pointed  to  by  stream, obtaining them from the location given by ptr.
	   /*fwrite 函数用于向 stream 指向的文件流中写入 nmemb 个数据项，每个数据项有 size 个长整型字节大小，这些数据项是从 ptr 所指向的地址空间中获取的*/

       For nonlocking counterparts, see unlocked_stdio(3).
	   /*对于非锁定的同行函数，请参阅 unlocked_stdio(3)*/

RETURN VALUE
       On success, fread() and fwrite() return the number of items read or written.  This number equals the number of bytes transferred only when size is 1.  If an error occurs, or the end of the  file  is  reached,  the  return value is a short item count (or zero).
	   /*成功 fread 和 fwrite 返回读取/写入的数据项个数，只有当 size = 1 时，返回值和传输的数据字节数相等。出错或者到达 文件末尾，返回值小于 nmemb 或者返回 0 */

       fread()  does  not  distinguish  between  end-of-file and error, and callers must use feof(3) and ferror(3) to determine which occurred.
	   /*fread 区分不了文件结束还是出错，因此使用者必须借助 feof 和 ferror 函数来帮忙判断。*/

ATTRIBUTES
       For an explanation of the terms used in this section, see attributes(7).

       ┌──────────────────┬───────────────┬─────────┐
       │Interface         │ Attribute     │ Value   │
       ├──────────────────┼───────────────┼─────────┤
       │fread(), fwrite() │ Thread safety │ MT-Safe │
       └──────────────────┴───────────────┴─────────┘
CONFORMING TO
       POSIX.1-2001, POSIX.1-2008, C89.

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

COLOPHON
       This page is part of release 4.04 of the Linux man-pages project.  A description of the  project,  information about    reporting    bugs,    and    the    latest    version    of    this    page,    can   be   found   at http://www.kernel.org/doc/man-pages/.


GNU                                                   2015-07-23                                             FREAD(3)