fopen（打開文件）

相關函數

open，fclose

表頭文件

#include<stdio.h>

定義函數

FILE * fopen(const char * path,const char * mode);

函數說明

參數path字符串包含欲打開的文件路徑及文件名，參數mode字符串則代表著流形態。
mode有下列幾種形態字符串:
r 打開只讀文件，該文件必須存在。
r+ 打開可讀寫的文件，該文件必須存在。
w 打開只寫文件，若文件存在則文件長度清為0，即該文件內容會消失。若文件不存在則建立該文件。
w+ 打開可讀寫文件，若文件存在則文件長度清為零，即該文件內容會消失。若文件不存在則建立該文件。
a 以附加的方式打開只寫文件。若文件不存在，則會建立該文件，如果文件存在，寫入的數據會被加到文件尾，即文件原先的內容會被保留。
a+ 以附加方式打開可讀寫的文件。若文件不存在，則會建立該文件，如果文件存在，寫入的數據會被加到文件尾后，即文件原先的內容會被保留。
上述的形態字符串都可以再加一個b字符，如rb、w+b或ab＋等組合，加入b 字符用來告訴函數庫打開的文件為二進制文件，而非純文字文件。不過在POSIX系統，包含Linux都會忽略該字符。由fopen()所建立的新文件會具有S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP|S_IROTH|S_IWOTH(0666)權限，此文件權限也會參考umask值。

返回值

文件順利打開后，指向該流的文件指針就會被返回。若果文件打開失敗則返回NULL，并把錯誤代碼存在errno 中。

附加說明

一般而言，開文件后會作一些文件讀取或寫入的動作，若開文件失敗，接下來的讀寫動作也無法順利進行，所以在fopen()后請作錯誤判斷及處理。

范例

#include<stdio.h>
main()
{
FILE * fp;
fp=fopen(“noexist”,”a+”);
if(fp= =NULL) return;
fclose(fp);
}

fgetc（由文件中讀取一個字符）

相關函數

open，fread，fscanf，getc

表頭文件

include<stdio.h>

定義函數

nt fgetc(FILE * stream);

函數說明

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);
}

fflush（更新緩沖區）

相關函數

write，fopen，fclose，setbuf

表頭文件

#include<stdio.h>

定義函數

int fflush(FILE* stream);

函數說明

fflush()會強迫將緩沖區內的數據寫回參數stream指定的文件中。如果參數stream為NULL，fflush()會將所有打開的文件數據更新。

返回值

成功返回0，失敗返回EOF，錯誤代碼存于errno中。

錯誤代碼

EBADF 參數stream 指定的文件未被打開，或打開狀態為只讀。其它錯誤代碼參考write（）。

feof（檢查文件流是否讀到了文件尾）

相關函數

fopen，fgetc，fgets，fread

表頭文件

#include<stdio.h>

定義函數

int feof(FILE * stream);

函數說明

feof()用來偵測是否讀取到了文件尾，尾數stream為fopen（）所返回之文件指針。如果已到文件尾則返回非零值，其他情況返回0。

返回值

返回非零值代表已到達文件尾。

fclose（關閉文件）

相關函數

close，fflush，fopen，setbuf

表頭文件

#include<stdio.h>

定義函數

int fclose(FILE * stream);

函數說明

fclose()用來關閉先前fopen()打開的文件。此動作會讓緩沖區內的數據寫入文件中，并釋放系統所提供的文件資源。

返回值

若關文件動作成功則返回0，有錯誤發生時則返回EOF并把錯誤代碼存到errno。

錯誤代碼

EBADF表示參數stream非已打開的文件。

范例

請參考fopen（）。