fopen相关文件操作函数

typedef struct
{
int _fd;        // 文件号
int _cleft;     // 缓冲区中剩下的字节数
int _mode;      // 文件操作模式
char * _nextc;  // 下一个字节的位置
char * _buff;   // 文件缓冲区位置
}FILE;

1.fopen

函数原型：FILE * fopen(const char * path,const char * mode);
头文件：#include <stdio.h>
返回值：文件顺利打开后，指向该流的文件指针就会被返回。如果文件打开失败则返回NULL，并把错误代码存在errno中。
参数说明：
参数path字符串包含欲打开的文件路径及文件名;
mode有下列几种形态字符串:
mode字符串
含义
r
以只读方式打开文件，该文件必须存在
r+
以可读写方式打开文件，该文件必须存在
rb+
读写打开一个二进制文件，允许读写数据，文件必须存在
w
打开只写文件并清空文件内容。若文件不存在则建立该文件
w+
打开可读写文件并清空文件内容。若文件不存在则建立该文件
a
以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。（EOF符保留）
a+
以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 （原来的EOF符不保留）
wb
只写打开或新建一个二进制文件；只允许写数据。
wb+
读写打开或建立一个二进制文件，允许读和写。
ab+
读写打开一个二进制文件，允许读或在文件末追加数据
wx
创建文本文件,只允许写入数据
wbx
创建一个二进制文件,只允许写入数据
w+x
创建一个文本文件,允许读写
wb+x
创建一个二进制文件,允许读写
w+bx
和”wb+x”相同
示例：

     FILE *pF  = fopen(pathName, "r"); //打开文件
     fseek(pF, 0, SEEK_END); //文件指针移到文件尾
     nLen = ftell(pF);  //得到当前指针位置, 即是文件的长度
     rewind(pF);    //文件指针恢复到文件头位置

     //读取文件内容//读取的长度和源文件长度有可能有出入，这里自动调整 nLen
     nLen = fread(msg, sizeof(char), nLen, pF);

     msg[nLen] = '\0'; //添加字符串结尾标志
     fclose(pF);  //关闭文件

2.fclose

函数原型：int fclose(FILE * stream);
头文件：#include <stdio.h>
函数说明：fclose()用来关闭先前fopen()打开的文件. 此动作会让缓冲区内的数据写入文件中, 并释放系统所提供的文件资源.
返回值：若关文件动作成功则返回0, 有错误发生时则返回EOF 并把错误代码存到errno.

3.fseek

函数原型：int fseek(FILE * stream, long offset, int whence);
头文件：#include <stdio.h>
函数说明：
fseek()用来移动文件流的读写位置.
参数说明：
stream 为已打开的文件指针,
参数offset 为根据参数whence 来移动读写位置的位移数。
参数 whence 为下列其中一种:
SEEK_SET 从距文件开头offset 位移量为新的读写位置.
SEEK_CUR 以目前的读写位置往后增加offset 个位移量.
SEEK_END 将读写位置指向文件尾后再增加offset 个位移量.
当whence 值为SEEK_CUR 或SEEK_END 时, 参数offset 允许负值的出现.
下列是较特别的使用方式：
1) 欲将读写位置移动到文件开头时:fseek(FILE *stream, 0, SEEK_SET);
2) 欲将读写位置移动到文件尾时:fseek(FILE *stream, 0, SEEK_END);
返回值：当调用成功时则返回0, 若有错误则返回-1, errno 会存放错误代码.
附加说明：fseek()不像lseek()会返回读写位置, 因此必须使用ftell()来取得目前读写的位置.

off_t   lseek(int fildes, off_t offset, int whence);

4.ftell

函数原型：long ftell(FILE * stream);
头文件：#include <stdio.h>
函数说明：
ftell()用来取得文件流目前的读写位置.
参数说明：
stream 为已打开的文件指针.
返回值：
当调用成功时则返回目前的读写位置, 若有错误则返回-1, errno 会存放错误代码.可用ftell获得文件中数据的长度.
错误代码：EBADF 参数stream 无效或可移动读写位置的文件流.

5.fread

函数原型：size_t fread(void * ptr, size_t size, size_t nmemb, FILE * stream);
头文件：#include <stdio.h>
函数说明：
fread()用来从文件流中读取数据.
参数说明：
stream 为已打开的文件指针；
ptr 指向欲存放读取进来的数据空间；
nmemb 指定读取的字符数.
stream 为已打开的文件指针.
返回值：返回实际读取到的nmemb 数目,如果此值比参数nmemb 来得小, 则代表可能读到了文件的尾或有错误发生, 这时必须用feof()或ferror()来决定发生什么情况。
范例

#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#define nmemb 4
struct test{
    char name[20];
    int size;
} s[nmemb];

int main()
{
    FILE * stream;
    int i;
    stream = fopen("/tmp/fwrite", "r");
    fread(s, sizeof(struct test), nmemb, stream);
    fclose(stream);
    for(i = 0; i < nmemb; i++)
        printf("name[%d]=%-20s:size[%d]=%d\n", i, s[i].name, i, s[i].size);
    return 0;
}

执行结果：

name[0]=Linux! size[0]=6
name[1]=FreeBSD! size[1]=8
name[2]=Windows2000 size[2]=11

6.fwrite

函数原型：size_t fwrite(const void * ptr, size_t size, size_t nmemb, FILE * stream);
头文件：#include <stdio.h>
函数说明：
fwrite()用来将数据写入文件流中.
参数说明：
stream 为已打开的文件指针,
ptr 指向欲写入的数据地址, 总共写入的字符数以参数size*nmemb 来决定.
stream 为已打开的文件指针.
返回值：返回实际写入的nmemb 数目.

7.rewind

函数原型：void rewind(FILE * stream);
头文件：#include <stdio.h>
函数说明：
rewind()函数用于将文件指针重新指向文件的开头，同时清除和文件流相关的错误和eof标记，相当于调用fseek(stream, 0, SEEK_SET)
参数说明：
stream 为已打开的文件指针.

8.fgets

函数原型：char* fgets(char * s, int size, FILE * stream);
头文件：#include <stdio.h>
函数说明：
fgets()用来从参数stream 所指的文件内读入字符并存到参数s 所指的内存空间, 直到出现换行字符、读到文件尾或是已读了size-1 个字符为止, 最后会加上NULL 作为字符串结束.
参数说明：
s 存放读到的数据
size s最大能存放多少数据
stream 已打开的文件指针
返回值：
gets()若成功则返回s 指针, 返回NULL 则表示有错误发生.

9.fputs

函数原型：int fputs(const char * s, FILE * stream);
头文件：#include <stdio.h>
函数说明：fputs()用来将参数s 所指的字符串写入到参数stream 所指的文件内.
返回值：若成功则返回写入的字符个数, 返回EOF 则表示有错误发生.

10.fgetc

函数原型：int fgetc(FILE * stream);
头文件：#include <stdio.h>
函数说明：
fgetc()从参数stream 所指的文件中读取一个字符. 若读到文件尾而无数据时便返回EOF.
返回值：getc()会返回读取到的字符, 若返回EOF 则表示到了文件尾.
范例：

#include <stdio.h>
main()
{
    FILE *fp;
    int c;
    fp = fopen("exist", "r");
    while((c = fgetc(fp)) != EOF)
    printf("%c", c);
    fclose(fp);
}

11.fputc

函数原型：int fputc(int c, FILE * stream);
头文件：#include <stdio.h>
函数说明：fputc 会将参数c 转为unsigned char 后写入参数stream 指定的文件中.
返回值：fputc()会返回写入成功的字符, 即参数c. 若返回EOF 则代表写入失败.

12.feof

函数原型：int feof(FILE * stream);
头文件：#include <stdio.h>
函数说明：feof()用来侦测是否读取到了文件尾, 尾数stream 为fopen()所返回之文件指针. 如果已到文件尾则返回非零值, 其他情况返回0.
返回值：返回非零值代表已到达文件尾.

13.fflush

函数原型：int fflush(FILE* stream);
头文件：#include <stdio.h>
函数说明：
fflush()会强迫将缓冲区内的数据写入参数stream 指定的文件中.
如果参数stream 为NULL,fflush()会将所有打开的文件数据更新.
返回值：成功返回0, 失败返回EOF, 错误代码存于errno 中.
错误代码：EBADF 参数stream 指定的文件未被打开, 或打开状态为只读. 其它错误代码参考write().

14.fscanf

函数原型：int fscanf(FILE*stream,constchar*format,[argument...]);
头文件：#include <stdio.h>
函数说明：
从一个流中执行格式化输入,fscanf遇到空格和换行时结束，注意空格时也结束。这与fgets有区别，fgets遇到空格不结束。
参数说明：
FILE *stream：文件指针
char *format：格式字符串
[argument…]：输入列表
返回值：整型，成功返回读入的参数的个数，失败返回EOF(-1)。
格式类型
说明
%d
读入一个十进制整数
%i
读入十进制，八进制，十六进制整数，与%d类似，但是在编译时通过数据前置或后置来区分进制，如加入“0x”则是十六进制，加入“0”则为八进制。例如串“031”使用%d时会被算作31，但是使用%i时会算作25
%u
读入一个无符号十进制整数
%f %F %g %G
用来输入实数，可以用小数形式或指数形式输入
%x %X
读入十六进制整数
%o
读入八进制整数
%s
读入一个字符串，遇空字符‘\0’结束
%c
读入一个字符。无法读入空值。空格可以被读入

15.fprintf

函数原型：int fprintf (FILE* stream, const char*format, [argument]);
头文件：#include <stdio.h>

函数说明：
传送格式化输出到一个文件中与打印机输出
参数说明：
FILE*stream：文件指针
const char* format：输出格式
[argument]：附加参数列表
返回值：
输出的字符数,发生错误时返回一个负值

16.fdopen

函数原型：FILE * fdopen(int fildes, const char * mode);
头文件：#include <stdio.h>
函数说明：
fdopen()会将参数fildes 的文件描述词, 转换为对应的文件指针后返回.
参数mode 字符串则代表着文件指针的流形态,
注意此形态必须和原先文件描述词读写模式相同. 关于mode 字符串格式请参考fopen().
返回值：转换成功时返回指向该流的文件指针. 失败则返回NULL, 并把错误代码存在errno 中.
范例：

#include <stdio.h>
int main()
{
    FILE * fp = fdopen(0, "w+");
    fprintf(fp, "%s\n", "hello!");
   ; fclose(fp);
    return 0;
}

17.fileno

函数原型：int fileno(FILE * stream);
头文件：#include <stdio.h>
函数说明：fileno()用来取得参数stream 指定的文件流所使用的文件描述词.
返回值：返回文件描述词.
范例:

#include <stdio.h>
int main()
{
    FILE * fp;
    int fd;
    fp = fopen("/etc/passwd", "r");
    fd = fileno(fp);
    printf("fd=%d\n", fd);
    fclose(fp);
    return 0;
}

18. freopen

函数原型：FILE * freopen(const char * path, const char * mode, FILE * stream);
头文件：#include <stdio.h>
函数说明：
参数 path 字符串包含欲打开的文件路径及文件名。
参数mode 请参考fopen()说明.。
参数stream 为已打开的文件指针. Freopen()会将原stream 所打开的文件流关闭, 然后打开参数path 的文件。
返回值：文件顺利打开后, 指向该流的文件指针就会被返回. 如果文件打开失败则返回NULL, 并把错误代码存在errno 中。
范例:

#include <stdio.h>
int main()
{
    FILE * fp;
    fp = fopen("/etc/passwd", "r");
    fp = freopen("/etc/group", "r", fp);
    fclose(fp);
    return 0;
}