C 中文件 I/O 函数

int fputc(int c, FILE *fp)

功能:将字符ch写到文件指针fp所指向的文件的当前写指针的位置。

参数:c为输出的字符量。

返回值：在正常调用情况下，函数返回写入文件的字符的ASCII码值，出错时，返回EOF（-1）。当正确写入一个字符或一个字节的数据后，文件内部写指针会自动后移一个字节的位置。EOF是在头文件 stdio.h中定义的宏。

int fgetc(FILE *fp)

功能:fgetc()从参数stream所指的文件中读取一个字符，并把它作为一个字符返回。若读到文件尾或出现错误时，它就返回EOF。

int fputs(const str, FILE *fp)

参数:str是字符型指针，可以是字符串常量，或者存放字符串的数组首地址。

功能 :向指定的文件写入一个字符串（不自动写入字符串结束标记符‘\0’）。成功写入一个字符串后，文件的位置指针会自动后移，函数返回值为非负整数；否则返回EOF(符号常量，其值为-1)。

char fgets(char *buf, int bufsize, FILE *stream);

参数

**buf: *字符型指针，指向用来存储所得数据的地址。

bufsize:整型数据，指明存储数据的大小。

*stream:文件结构体指针，将要读取的文件流。

返回值

成功: 返回第一个参数buf；

在读字符时遇到end-of-file，则eof指示器被设置，

还没读入任何字符就遇到这种情况，则buf保持原来的内容，返回NULL；

如果发生读入错误，error指示器被设置，返回NULL，buf的值可能被改变。

int fprintf (FILE* stream, const char*format, [argument])

参数

const char* format：输出格式

[argument]：附加参数列表

功能

fprintf()函数根据指定的format(格式)发送信息(参数)到由stream(流)指定的文件. fprintf()只能和printf()一样工作. fprintf()的返回值是输出的字符数,发生错误时返回一个负值.

int fscanf(FILEstream, const char* format, [argument...])

与fgets的差别在于：fscanf遇到空格和换行时结束，注意空格时也结束，fgets遇到空格不结束。

int fread ( void *buffer, int size, int count, FILE *stream)

参数

buffer: 用于接收数据的内存地址

size: 要读的每个数据项的字节数，单位是字节

count: 要读count个数据项，每个数据项size个字节.

返回值: 返回真实读取的项数，若大于count则意味着产生了错误。另外，产生错误后，文件位置指示器是无法确定的。若其他stream或buffer为空指针，或在unicode模式中写入的字节数为奇数，此函数设置errno为EINVAL以及返回0.

int fwrite(const void* buffer, int size, int count, FILE* stream)

返回: 返回实际写入的数据块数目

buffer：是一个指针，对fwrite来说，是要获取数据的地址；

size：要写入内容的单字节数；

count:要进行写入size字节的数据项的个数；

stream:目标文件指针；

返回实际写入的数据项个数count