FILE* fopen (const char*, const char*);
FILE是個struct自訂型態:
typedef struct _iobuf
{
char* _ptr;
int _cnt;
char* _base;
int _flag;
int _file;
int _charbuf;
int _bufsiz;
char* _tmpfname;
} FILE;
fopen()會傳回一個FILE實例的位址值,實際上您不太需要了解FILE的每個成員作用,您只要將FILE的位址值傳給像是fgetc()、fputc()、fgets()、fputs()的函式進檔案I/O處理即可,fopen
()的第一個參數用來指定要開啟的檔案名稱,第二個參數用來指定檔案I/O模式,模式基本上就是讀、寫、附加,分別可使用r、w與a來設定,如果加上+, 表示檔案可讀可寫,如果加上b,表示以區塊(block)方式,即二進位方式進行讀寫,例如以下是可設定的模式:{
char* _ptr;
int _cnt;
char* _base;
int _flag;
int _file;
int _charbuf;
int _bufsiz;
char* _tmpfname;
} FILE;
r | 開啟檔案進行唯讀,若檔案不存在,則傳回NULL |
w | 開啟檔案進行唯寫,若檔案不存在,則建立新檔,則檔案存在則將之刪除,再建立新檔 |
a | 開啟檔案進行附加,若檔案存在,則資料從檔案尾端寫入,則檔案不存在則建立新檔 |
rb | 以二進位模式開啟檔案進行唯讀,Windows 下需要加 b,Linux 下則會予以忽略 |
wb | 以二進位模式開啟檔案進行唯寫,Windows 下需要加 b,Linux 下則會予以忽略 |
ab | 以二進位模式開啟檔案進行附加,Windows 下需要加 b,Linux 下則會予以忽略 |
r+ | 開啟檔案進行讀寫,若檔案不存在,則建立新檔,若檔案存在,資料將從檔案開頭進行覆寫 |
w+ | 開啟檔案進行讀寫,若檔案不存在,則建立新檔,若檔案存在則覆寫原有的資料 |
a+ | 開啟檔案進行附加、讀取,若檔案不存在則建立新檔,若檔案存在,則資料從檔案尾端寫入 |
r+b | 以二進位方式開啟檔案進行讀寫,Windows 下需要加 b,Linux 下則會予以忽略 |
w+b | 以二進位方式開啟檔案進行讀寫,Windows 下需要加 b,Linux 下則會予以忽略 |
a+b | 以二進位方式開啟檔案進行附加、讀取,Windows 下需要加 b,Linux 下則會予以忽略 |
Windows作業系統將文字檔和二進位檔案當作兩種不同的檔案,而Linux則不區別,在Windows下讀寫非文字檔案,必須加上b模式,在Linux下則會忽略b。
例如以下的程式片段可開啟一個檔案進行讀取:
FILE *file = fopen("test.txt", "w");
若開啟檔案成功,則file將儲存位址值,您可以使用以下的程式片段來測試檔案是否開啟成功:
if(file == NULL) {
puts("檔案開啟失敗");
}
puts("檔案開啟失敗");
}
NULL為使用#define定義的展開字,其值為0:
#define NULL 0
fopen()會使用緩衝區來減少對磁碟的實際I/O,以加快檔案存取效率,當您在程式中進行讀寫動作時,實際上會先對緩衝區作存取,而非實際的磁碟,檔案開啟一個重要的觀念與習慣是,不使用檔案時,一定要記得關閉檔案,閉關檔案會將緩衝區中的資料真正寫入磁碟,若忘了關閉檔案,可能會造成資料的遺失。
您可以使用fclose()來關閉檔案:
int fclose(FILE *fp);
若檔案正常關閉,則傳回0,否則將傳回非0值。
開啟檔案之後,您可以使用fgetc()來讀取檔案中的字元,使用fputc()來將字元寫入檔案:
int fgetc(FILE* fp);
int fputc(int ch, FILE *fp);
int fputc(int ch, FILE *fp);
fgetc()傳入FILE實例的位址值,每執行一次就會從檔案中讀取一個字元,直到讀到檔尾(End of File, EOF)為止,文字模式時判斷檔案結尾,可以如下撰寫:
while((ch = fgetc(file)) != EOF) {
...
}
...
}
使用fgetc(),只要指定FILE位址值給它就可以了,而fputc()則指定要寫入的字元及FILE位址值。
下面這個程式直接示範如何讀取並寫入純文字檔案,會將指定的檔案讀取並複製至另一個檔案:
#include <stdio.h> int main(int argc, char* argv[]) { if(argc != 3) { puts("指令: copy <來源檔案名稱> <目的檔案名稱>"); return 1; } FILE *file1 = fopen(argv[1], "r"); if(!file1) { puts("來源檔案開啟失敗"); return 1; } FILE *file2 = fopen(argv[2], "w"); if(!file2) { puts("目的檔案開啟失敗"); return 1; } char ch; while((ch = fgetc(file1)) != EOF) { fputc(ch, file2); } fclose(file1); fclose(file2); return 0; }
您也可以使用fgets()來讀取整個字串,使用fputs()來寫入整個字串:
char* fgets(char *str,
int length, FILE *fp);
int fputs(char *str, FILE *fp);
int fputs(char *str, FILE *fp);
fgets()第一個參數為要讀入的字串儲存的陣列位址,第二個參數為要讀入的字元長度,由於字串必須包留字元陣列最後一個元素為空白字元,才視之為字 串,所以實際讀入的長度為length - 1,第三個參數為FILE位址值,而fputs()第一個參數為寫入的字串,第二個參數為FILE位址值。
以下的程式使用fgets()、fputs()改寫上面這個程式:
#include <stdio.h> int main(int argc, char* argv[]) { if(argc != 3) { puts("指令: copy <來源檔案名稱> <目的檔案名稱>"); return 1; } FILE *file1 = fopen(argv[1], "r"); if(!file1) { puts("來源檔案開啟失敗"); return 1; } FILE *file2 = fopen(argv[2], "w"); if(!file2) { puts("目的檔案開啟失敗"); return 1; } char str[50]; while(fgets(str, 50, file1) != NULL) { fputs(str, file2); } fclose(file1); fclose(file2); return 0; }
在程式執行過程開啟的標準輸出stdout、標準輸入stdin、標準錯誤stderr,事實上也是檔案串流的特例,在C程式中,也常見到以下的方式,以便直接控制這三個標準輸入、輸出、錯誤:
#include <stdio.h> int main(int argc, char* argv[]) { if(argc != 3) { fputs("指令: copy <來源檔案名稱> <目的檔案名稱>", stderr); return 1; } FILE *file1 = fopen(argv[1], "r"); if(!file1) { fputs("來源檔案開啟失敗", stderr); return 1; } FILE *file2 = fopen(argv[2], "w"); if(!file2) { fputs("目的檔案開啟失敗", stderr); return 1; } char str[50]; while(fgets(str, 50, file1) != NULL) { fputs(str, file2); } fclose(file1); fclose(file2); return 0; }
程式的執行結果與上一個範例是相同的。