文件操作函數 C語言 (FILE fputc fgetc fputs fgets fscanf fprintf)
2007年05月18日 星期五 上午 08:48
在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()
fclose()的功能就是關閉用fopen()打開的文件，其原型是：int fclose(FILE *fp);如果成功，返回0,失敗返回EOF。
在程序結束時一定要記得關閉打開的文件，不然可能會造成數據丟失的情況，我以前就經常犯這樣的毛病。
例：fclose(fp);
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);