C语言对文件的操作函数用法详解1

在ANSI C中，对文件的操作分为两种方式，即流式文件操作和I/O文件操作，下面就分别介绍之。

一、流式文件操作

　　这种方式的文件操作有一个重要的结构FILE，FILE在stdio.h中定义如下：

typedef struct {

int level; /* fill/empty level of buffer */

unsigned flags; /* File status flags */

char fd; /* File descriptor */

unsigned char hold; /* Ungetc char if no buffer */

int bsize; /* Buffer size */

unsigned char _FAR *buffer; /* Data transfer buffer */

unsigned char _FAR *curp; /* Current active pointer */

unsigned istemp; /* Temporary file indicator */

short token; /* Used for validity checking */

} FILE; /* This is the FILE object */

　　FILE这个结构包含了文件操作的基本属性，对文件的操作都要通过这个结构的指针来进行，此种文件操作常用的函数见下表 函数 功能

fopen() 打开流

fclose() 关闭流

fputc() 写一个字符到流中

fgetc() 从流中读一个字符

fseek() 在流中定位到指定的字符

fputs() 写字符串到流

fgets() 从流中读一行或指定个字符

fprintf() 按格式输出到流

fscanf() 从流中按格式读取

feof() 到达文件尾时返回真值

ferror() 发生错误时返回其值

rewind() 复位文件定位器到文件开始处

remove() 删除文件

fread() 从流中读指定个数的字符

fwrite() 向流中写指定个数的字符

tmpfile() 生成一个临时文件流

tmpnam() 生成一个唯一的文件名

　　下面就介绍一下这些函数

1.fopen()

　　fopen的原型是：FILE *fopen(const char *filename,const char *mode)，fopen实现三个功能

为使用而打开一个流 ;把一个文件和此流相连接;给此流返回一个FILR指针

参数filename指向要打开的文件名，mode表示打开状态的字符串，其取值如下表

"r" 以只读方式打开文件                   "w" 以只写方式打开文件               "a" 以追加方式打开文件

"r+" 以读/写方式打开文件，如无文件出错             "w+" 以读/写方式打开文件，如无文件生成新文件

一个文件可以以文本模式或二进制模式打开，这两种的区别是：在文本模式中回车被当成一个字符'n'，而二进制模式认为它是两个字符0x0D,0x0A；如果在文件中读到0x1B，文本模式会认为这是文件结束符，也就是二进制模型不会对文件进行处理，而文本方式会按一定的方式对数据作相应的转换。

系统默认的是以文本模式打开，可以修改全部变量_fmode的值来修改这个设置，例如_fmode=O_TEXT；就设置默认打开方式为文本模式；而_fmode=O_BINARY；则设置默认打开方式是二进制模式。

我们也可以在模式字符串中指定打开的模式，如"rb"表示以二进制模式打开只读文件，"w+t"或"wt+"表示以文本模式打开读/写文件。

此函数返回一个FILE指针，所以申明一个FILE指针后不用初始化，而是用fopen()来返回一个指针并与一个特定的文件相连，如果成败，返回NULL。

例:　　FILE *fp;

　　if(fp=fopen("123.456","wb"))

　　　　puts("打开文件成功");

　　else

　　　　puts("打开文件成败");

2.fclose() 的功能就是关闭用fopen()打开的文件，其原型是：int fclose(FILE *fp);如果成功，返回0,失败返回EOF。在程序结束时一定要记得关闭打开的文件，不然可能会造成数据丢失的情况，我以前就经常犯这样的毛病。

3.fputc()向流写一个字符，原型是int fputc(int c, FILE *stream); 成功返回这个字符,失败返回EOF。例：fputc('X',fp);

4.fgetc()从流中读一个字符，原型是int fputc(FILE *stream); 成功返回这个字符,失败返回EOF。

例：char ch1=fgetc(fp);

5. fseek()此函数一般用于二进制模式打开的文件中，功能是定位到流中指定的位置，原型是int fseek(FILE *stream, long offset, int whence);如果成功返回0，参数offset是移动的字符数，whence是移动的基准，取值是

符号常量 值 基准位置

SEEK_SET 0 文件开头

SEEK_CUR 1 当前读写的位置

SEEK_END 2 文件尾部

例：fseek(fp,1234L,SEEK_CUR);//把读写位置从当前位置向后移动1234字节(L后缀表示长整数)

　　fseek(fp,0L,2);//把读写位置移动到文件尾

6.fputs()　写一个字符串到流中，原型int fputs(const char *s, FILE *stream);

例：fputs("I Love You",fp);

7.fgets()从流中读一行或指定个字符，原型是char *fgets(char *s, int n, FILE *stream); 从流中读取n-1个字符，除非读完一行，参数s是来接收字符串，如果成功则返回s的指针，否则返回NULL。

例：如果一个文件的当前位置的文本如下

Love ,I Have

But ........

如果用 fgets(str1,4,file1);  则执行后str1="Lov"，读取了4-1=3个字符，而如果用 fgets(str1,23,file1);

则执行str="Love ,I Have"，读取了一行(不包括行尾的'n')。

8.fprintf()按格式输入到流，其原型是int fprintf(FILE *stream, const char *format[, argument, ...]);其用法和printf()相同，不过不是写到控制台，而是写到流罢了.例：fprintf(fp,"%2d%s",4,"Hahaha");

9.fscanf()　从流中按格式读取，其原型是int fscanf(FILE *stream, const char *format[, address, ...]);其用法和scanf()相同，不过不是从控制台读取，而是从流读取罢了。例：fscanf(fp,"%d%d" ,&x,&y);

10.feof() 检测是否已到文件尾，是返回真，否则返回0，其原型是int feof(FILE *stream);

例：if(feof(fp))printf("已到文件尾");

11.ferror() 原型是int ferror(FILE *stream);返回流最近的错误代码，可用clearerr()来清除它，clearerr()的原型是void clearerr(FILE *stream); 例：printf("%d",ferror(fp));

12.rewind()把当前的读写位置回到文件开始，原型是void rewind(FILE *stream);其实本函数相当于fseek(fp,0L,SEEK_SET);例：rewind(fp);

12.remove()　删除文件，原型是int remove(const char *filename); 参数就是要删除的文件名，成功返回0。

例：remove("c:io.sys");

13.fread()　　从流中读指定个数的字符，原型是size_t fread(void *ptr, size_t size, size_t n, FILE *stream);参数ptr是保存读取的数据，void*的指针可用任何类型的指针来替换，如char*、int *等等来替换；size是每块的字节数；n是读取的块数，如果成功，返回实际读取的块数(不是字节数)，本函数一般用于二进制模式打开的文件中。

例：char x[4230];

　　FILE *file1=fopen("c:msdos.sys","r");

　　fread(x,200,12 ,file1);//共读取200*12=2400个字节

14.fwrite()　与fread对应，向流中写指定的数据，原型是size_t fwrite(const void *ptr, size_t size, size_t n, FILE *stream);参数ptr是要写入的数据指针，void*的指针可用任何类型的指针来替换，如char*、int *等等来替换；size是每块的字节数；n是要写的块数，如果成功，返回实际写入的块数(不是字节数)，本函数一般用于二进制模式打开的文件中。

例：char x[]="I Love You";

　　fwire(x, 6,12,fp);//写入6*12=72字节

　　将把"I Love"写到流fp中12次，共72字节

15.tmpfile() 其原型是FILE *tmpfile(void); 生成一个临时文件，以"w+b"的模式打开，并返回这个临时流的指针，如果失败返回NULL。在程序结束时，这个文件会被自动删除。例：FILE *fp=tmpfile();

16.tmpnam();其原型为char *tmpnam(char *s); 生成一个唯一的文件名，其实tmpfile()就调用了此函数，参数s用来保存得到的文件名，并返回这个指针，如果失败，返回NULL。例：tmpnam(str1);

二、直接I/O文件操作

　　这是C提供的另一种文件操作，它是通过直接存/取文件来完成对文件的处理，而上篇所说流式文件操作是通过缓冲区来进行；流式文件操作是围绕一个FILE 指针来进行，而此类文件操作是围绕一个文件的“句柄”来进行，什么是句柄呢？它是一个整数，是系统用来标识一个文件(在WINDOWS中，句柄的概念扩展到所有设备资源的标识)的唯一的记号。此类文件操作常用的函数如下表，这些函数及其所用的一些符号在io.h和fcntl.h中定义，在使用时要加入相应的头文件。

函数 说明

open() 打开一个文件并返回它的句柄

close() 关闭一个句柄

lseek() 定位到文件的指定位置

read() 块读文件

write() 块写文件

eof() 测试文件是否结束

filelength() 取得文件长度

rename() 重命名文件

chsize() 改变文件长度

下面就对这些函数一一说明：

1.open()打开一个文件并返回它的句柄，如果失败，将返回一个小于0的值，原型是int open(const char *path, int access [, unsigned mode]); 参数path是要打开的文件名，access是打开的模式，mode是可选项。表示文件的属性，主要用于UNIX系统中，在DOS/WINDOWS这个参数没有意义。其中文件的打开模式如下表。

符号 含义 符号 含义 符号 含义

O_RDONLY 只读方式 O_WRONLY 只写方式 O_RDWR 读/写方式

O_NDELAY 用于UNIX系统 O_APPEND 追加方式 O_CREAT 如果文件不存在就创建

O_TRUNC 把文件长度截为0 O_EXCL 和O_CREAT连用，如果文件存在返回错误 O_BINARY 二进制方式

O_TEXT 文本方式

对于多个要求，可以用"|"运算符来连接，如O_APPEND|O_TEXT表示以文本模式和追加方式打开文件。

例：int handle=open("c:msdos.sys",O_BINARY|O_CREAT|O_WRITE)

2.close()关闭一个句柄，原型是int close(int handle);如果成功返回0 .例：close(handle)

3.lseek()　定位到指定的位置，原型是：long lseek(int handle, long offset, int fromwhere);参数offset是移动的量，fromwhere是移动的基准位置，取值和前面讲的fseek()一样，SEEK_SET：文件首部；SEEK_CUR：文件当前位置；SEEK_END：文件尾。此函数返回执行后文件新的存取位置。

例：lseek(handle,-1234L,SEEK_CUR);//把存取位置从当前位置向前移动1234个字节。

　　x=lseek(hnd1,0L,SEEK_END);//把存取位置移动到文件尾，x=文件尾的位置即文件长度

4.read() 从文件读取一块，原型是int read(int handle, void *buf, unsigned len);参数buf保存读出的数据，len是读取的字节。函数返回实际读出的字节。例：char x[200];read(hnd1,x,200);

5.write()写一块数据到文件中，原型是int write(int handle, void *buf, unsigned len);参数的含义同read()，返回实际写入的字节。例：char x[]="I Love You";write(handle,x,strlen(x));

7.eof()类似feof()，测试文件是否结束，是返回1，否则返回0;原型是：int eof(int handle);

例：while(!eof(handle1)){……};

8.filelength() 返回文件长度，原型是long filelength(int handle);相当于lseek(handle,0L,SEEK_END)

例：long x=filelength(handle);

9.rename() 重命名文件，原型是int rename(const char *oldname, const char *newname); 参数oldname是旧文件名，newname是新文件名。成功返回0 。例：rename("c:config.sys","c:config.w40");

10.chsize(); 改变文件长度，原型是int chsize(int handle, long size);参数size表示文件新的长度，成功返回0，否则返回-1，如果指定的长度小于文件长度，则文件被截短；如果指定的长度大于文件长度，则在文件后面补''。

例：chsize(handle,0x12345);

如果熟悉汇编可能会发现这种方式和汇编语言的DOS功能调用句柄式文件操作很像，比如open()就像DOS服务的3CH号功能调用，其实这种操作还有两种类型的函数就是直接用DOS功能来完成的，如_open()，_dos_open()等等。有兴趣可自已查询BCB的帮助。

　　同流式文件操作相同，这种也提供了Unicode字符操作的函数，如_wopen()等等，用于9X/NT下的宽字符编程，有兴趣可自已查询BCB的帮助。

　　另外，此种操作还有lock(),unlock(),locking()等用于多用户操作的函数，但在BCB中用得并不多，我就不介绍了，但如果要用C来写CGI，这些就必要的常识了，如果你有这方面的要求，那就得自已好好看帮助了。

 

       方式                      含义
               "r"             打开，只读
               "w"             打开，文件指针指到头，只写
               "a"             打开，指向文件尾，在已存在文件中追加
               "rb"            打开一个二进制文件，只读
               "wb"            打开一个二进制文件，只写
               "ab"            打开一个二进制文件，进行追加
               "r+"            以读/写方式打开一个已存在的文件
               "w+"            以读/写方式建立一个新的文本文件
               "a+"            以读/写方式打开一个文件文件进行追加
               "rb+"           以读/写方式打开一个二进制文件
               "wb+"           以读/写方式建立一个新的二进制文件
               "ab+"           以读/写方式打开一个二进制文件进行追加

clearerr（清除文件流的错误旗标） 
相关函数 feof
表头文件 #include 
定义函数 void clearerr(FILE * stream); 
函数说明 clearerr（）清除参数stream指定的文件流所使用的错误旗标。 
返回值 
　 
fclose（关闭文件） 
相关函数 close，fflush，fopen，setbuf 
表头文件 #include 
定义函数 int fclose(FILE * stream); 
函数说明 fclose()用来关闭先前fopen()打开的文件。此动作会让缓冲区内的数据写入文件中，并释放系统所提供的文件资源。 
返回值 若关文件动作成功则返回0，有错误发生时则返回EOF并把错误代码存到errno。 
错误代码 EBADF表示参数stream非已打开的文件。 
范例 请参考fopen（）。
　 
fdopen（将文件描述词转为文件指针） 
相关函数 fopen，open，fclose 
表头文件 #include 
定义函数 FILE * fdopen(int fildes,const char * mode); 
函数说明 fdopen()会将参数fildes 的文件描述词，转换为对应的文件指针后返回。参数mode 字符串则代表着文件指针的流形态，此形态必须和原先文件描述词读写模式相同。关于mode 字符串格式请参考fopen()。 
返回值 转换成功时返回指向该流的文件指针。失败则返回NULL，并把错误代码存在errno中。
范例 
#include
main()
{
FILE * fp =fdopen(0,”w+”);
fprintf(fp,”%s\n”,”hello!”);
fclose(fp);
}

执行 hello!

feof（检查文件流是否读到了文件尾） 
相关函数 fopen，fgetc，fgets，fread 
表头文件 #include 
定义函数 int feof(FILE * stream); 
函数说明 feof()用来侦测是否读取到了文件尾，尾数stream为fopen（）所返回之文件指针。如果已到文件尾则返回非零值，其他情况返回0。 
返回值 返回非零值代表已到达文件尾。
　 
fflush（更新缓冲区） 
相关函数 write，fopen，fclose，setbuf 
表头文件 #include 
定义函数 int fflush(FILE* stream); 
函数说明 fflush()会强迫将缓冲区内的数据写回参数stream指定的文件中。如果参数stream为NULL，fflush()会将所有打开的文件数据更新。 
返回值 成功返回0，失败返回EOF，错误代码存于errno中。 
错误代码 EBADF 参数stream 指定的文件未被打开，或打开状态为只读。其它错误代码参考write（）。
　 
fgetc（由文件中读取一个字符） 
相关函数 open，fread，fscanf，getc 
表头文件 include 
定义函数 nt fgetc(FILE * stream); 
函数说明 fgetc()从参数stream所指的文件中读取一个字符。若读到文件尾而无数据时便返回EOF。 
返回值 getc()会返回读取到的字符，若返回EOF则表示到了文件尾。 
范例
#include
main()
{
FILE *fp;
int c;
fp=fopen(“exist”,”r”);
while((c=fgetc(fp))!=EOF)
printf(“%c”,c);
fclose(fp);
}

fgets（由文件中读取一字符串） 
相关函数 open，fread，fscanf，getc 
表头文件 include 
定义函数 har * fgets(char * s,int size,FILE * stream); 
函数说明 fgets()用来从参数stream所指的文件内读入字符并存到参数s所指的内存空间，直到出现换行字符、读到文件尾或是已读了size-1个字符为止，最后会加上NULL作为字符串结束。 
返回值 gets()若成功则返回s指针，返回NULL则表示有错误发生。 
范例 
#include
main()
{
char s[80];
fputs(fgets(s,80,stdin),stdout);
}

执行 this is a test /*输入*/
this is a test /*输出*/

　 
fileno（返回文件流所使用的文件描述词） 
相关函数 open，fopen 
表头文件 #include 
定义函数 int fileno(FILE * stream); 
函数说明 fileno()用来取得参数stream指定的文件流所使用的文件描述词。 
返回值 返回文件描述词。
范例 
#include
main()
{
FILE * fp;
int fd;
fp=fopen(“/etc/passwd”,”r”);
fd=fileno(fp);
printf(“fd=%d\n”,fd);
fclose(fp);
}

执行 fd=3