1. 程式人生 > >C語言檔案操作函式大全

C語言檔案操作函式大全

clearerr(清除檔案流的錯誤旗標)
相關函式 feof
表頭檔案 #include<stdio.h>
定義函式 void clearerr(FILE * stream);
函式說明 clearerr()清除引數stream指定的檔案流所使用的錯誤旗標。
返回值

fclose(關閉檔案)
相關函式 closefflushfopensetbuf
表頭檔案 #include<stdio.h>
定義函式 int fclose(FILE * stream);
函式說明 fclose()用來關閉先前fopen()開啟的檔案。此動作會讓緩衝區內的資料寫入檔案中,並釋放系統所提供的檔案資源。

返回值 若關檔案動作成功則返回0,有錯誤發生時則返回EOF並把錯誤程式碼存到errno
錯誤程式碼 EBADF表示引數stream非已開啟的檔案。
範例 請參考fopen()。

fdopen(將檔案描述詞轉為檔案指標)
相關函式 fopenopenfclose
表頭檔案 #include<stdio.h>
定義函式 FILE * fdopen(int fildes,const char * mode);
函式說明 fdopen()會將引數fildes的檔案描述詞,轉換為對應的檔案指標後返回。引數mode字串則代表著檔案指標的流形態,此形態必須和原先檔案描述詞讀寫模式相同。關於mode字串格式請參考
fopen()
返回值 轉換成功時返回指向該流的檔案指標。失敗則返回NULL,並把錯誤程式碼存在errno中。
範例
#include<stdio.h>
main()
{
FILE * fp =fdopen(0,”w+”);
fprintf(fp,”%s\n”,”hello!”);
fclose(fp);
}

執行 hello!

feof(檢查檔案流是否讀到了檔案尾)
相關函式 fopenfgetcfgetsfread
表頭檔案 #include<stdio.h>
定義函式 int feof(FILE * stream);
函式說明 feof()用來偵測是否讀取到了檔案尾,尾數
streamfopen()所返回之檔案指標。如果已到檔案尾則返回非零值,其他情況返回0
返回值 返回非零值代表已到達檔案尾。

fflush(更新緩衝區)
相關函式 writefopenfclosesetbuf
表頭檔案 #include<stdio.h>
定義函式 int fflush(FILE* stream);
函式說明 fflush()會強迫將緩衝區內的資料寫回引數stream指定的檔案中。如果引數streamNULLfflush()會將所有開啟的檔案資料更新。
返回值 成功返回0,失敗返回EOF,錯誤程式碼存於errno中。
錯誤程式碼 EBADF 引數stream指定的檔案未被開啟,或開啟狀態為只讀。其它錯誤程式碼參考write()。

fgetc(由檔案中讀取一個字元)
相關函式 openfreadfscanfgetc
表頭檔案 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);
}

fgets(由檔案中讀取一字串)
相關函式 openfreadfscanfgetc
表頭檔案 include<stdio.h>
定義函式 har * fgets(char * s,int size,FILE * stream);
函式說明 fgets()用來從引數stream所指的檔案內讀入字元並存到引數s所指的記憶體空間,直到出現換行字元、讀到檔案尾或是已讀了size-1個字元為止,最後會加上NULL作為字串結束。
返回值 gets()若成功則返回s指標,返回NULL則表示有錯誤發生。
範例
#include<stdio.h>
main()
{
char s[80];
fputs(fgets(s,80,stdin),stdout);
}

執行 this is a test /*輸入*/
this is a test /*輸出*/


fileno(返回檔案流所使用的檔案描述詞)
相關函式 openfopen
表頭檔案 #include<stdio.h>
定義函式 int fileno(FILE * stream);
函式說明 fileno()用來取得引數stream指定的檔案流所使用的檔案描述詞。
返回值 返回檔案描述詞。
範例
#include<stdio.h>
main()
{
FILE * fp;
int fd;
fp=fopen(“/etc/passwd”,”r”);
fd=fileno(fp);
printf(“fd=%d\n”,fd);
fclose(fp);
}

執行 fd=3


fopen(開啟檔案)
相關函式 openfclose
表頭檔案 #include<stdio.h>
定義函式 FILE * fopen(const char * path,const char * mode);
函式說明 引數path字串包含欲開啟的檔案路徑及檔名,引數mode字串則代表著流形態。
mode有下列幾種形態字串:
r 開啟只讀檔案,該檔案必須存在。
r+ 開啟可讀寫的檔案,該檔案必須存在。
w 開啟只寫檔案,若檔案存在則檔案長度清為0,即該檔案內容會消失。若檔案不存在則建立該檔案。
w+ 開啟可讀寫檔案,若檔案存在則檔案長度清為零,即該檔案內容會消失。若檔案不存在則建立該檔案。
a 以附加的方式開啟只寫檔案。若檔案不存在,則會建立該檔案,如果檔案存在,寫入的資料會被加到檔案尾,即檔案原先的內容會被保留。
a+ 以附加方式開啟可讀寫的檔案。若檔案不存在,則會建立該檔案,如果檔案存在,寫入的資料會被加到檔案尾後,即檔案原先的內容會被保留。
上述的形態字串都可以再加一個b字元,如rbw+bab+等組合,加入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);
}

fputc(將一指定字元寫入檔案流中)
相關函式 fopenfwritefscanfputc
表頭檔案 #include<stdio.h>
定義函式 int fputc(int c,FILE * stream);
函式說明 fputc 會將引數c轉為unsigned char後寫入引數stream指定的檔案中。
返回值 fputc()會返回寫入成功的字元,即引數c。若返回EOF則代表寫入失敗。
範例
#include<stdio.h>
main()
{
FILE * fp;
char a[26]=”abcdefghijklmnopqrstuvwxyz”;
int i;
fp= fopen(“noexist”,”w”);
for(i=0;i<26;i++)
fputc(a,fp);
fclose(fp);
}

fputs(將一指定的字串寫入檔案內)
相關函式 fopenfwritefscanffputcputc
表頭檔案 #include<stdio.h>
定義函式 int fputs(const char * s,FILE * stream);
函式說明 fputs()用來將引數s所指的字串寫入到引數stream所指的檔案內。
返回值 若成功則返回寫出的字元個數,返回EOF則表示有錯誤發生。
範例 請參考fgets()。
fread(從檔案流讀取資料)
相關函式 fopenfwritefseekfscanf
表頭檔案 #include<stdio.h>
定義函式 size_t fread(void * ptr,size_t size,size_t nmemb,FILE * stream);
函式說明 fread()用來從檔案流中讀取資料。引數stream為已開啟的檔案指標,引數ptr指向欲存放讀取進來的資料空間,讀取的字元數以引數size*nmemb來決定。Fread()會返回實際讀取到的nmemb數目,如果此值比引數nmemb來得小,則代表可能讀到了檔案尾或有錯誤發生,這時必須用feof()ferror()來決定發生什麼情況。
返回值 返回實際讀取到的nmemb數目。
附加說明
範例
#include<stdio.h>
#define nmemb 3
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.name,i,s.size);
}

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


freopen(開啟檔案)
相關函式 fopenfclose
表頭檔案 #include<stdio.h>
定義函式 FILE * freopen(const char * path,const char * mode,FILE * stream);
函式說明 引數path字串包含欲開啟的檔案路徑及檔名,引數mode請參考fopen()說明。引數stream為已開啟的檔案指標。Freopen()會將原stream所開啟的檔案流關閉,然後開啟引數path的檔案。
返回值 檔案順利開啟後,指向該流的檔案指標就會被返回。如果檔案開啟失敗則返回NULL,並把錯誤程式碼存在errno中。
範例
#include<stdio.h>
main()
{
FILE * fp;
fp=fopen(“/etc/passwd”,”r”);
fp=freopen(“/etc/group”,”r”,fp);
fclose(fp);
}

fseek(移動檔案流的讀寫位置)
相關函式 rewindftellfgetposfsetposlseek
表頭檔案 #include<stdio.h>
定義函式 int fseek(FILE * stream,long offset,int whence);
函式說明 fseek()用來移動檔案流的讀寫位置。引數stream為已開啟的檔案指標,引數offset為根據引數whence來移動讀寫位置的位移數。
引數 whence為下列其中一種:
SEEK_SET從距檔案開頭offset位移量為新的讀寫位置。SEEK_CUR以目前的讀寫位置往後增加offset個位移量。
SEEK_END將讀寫位置指向檔案尾後再增加offset個位移量。
whence值為SEEK_CURSEEK_END時,引數offset允許負值的出現。
下列是較特別的使用方式:
1) 欲將讀寫位置移動到檔案開頭時:fseek(FILE *stream,0,SEEK_SET);
2) 欲將讀寫位置移動到檔案尾時:fseek(FILE *stream,0,0SEEK_END);
返回值 當呼叫成功時則返回0,若有錯誤則返回-1errno會存放錯誤程式碼。
附加說明 fseek()不像lseek()會返回讀寫位置,因此必須使用ftell()來取得目前讀寫的位置。
範例
#include<stdio.h>
main()
{
FILE * stream;
long offset;
fpos_t pos;
stream=fopen(“/etc/passwd”,”r”);
fseek(stream,5,SEEK_SET);
printf(“offset=%d\n”,ftell(stream));
rewind(stream);
fgetpos(stream,&pos);
printf(“offset=%d\n”,pos);
pos=10;
fsetpos(stream,&pos);
printf(“offset = %d\n”,ftell(stream));
fclose(stream);
}

執行 offset = 5
offset =0
offset=10


ftell(取得檔案流的讀取位置)
相關函式 fseekrewindfgetposfsetpos
表頭檔案 #include<stdio.h>
定義函式 long ftell(FILE * stream);
函式說明 ftell()用來取得檔案流目前的讀寫位置。引數stream為已開啟的檔案指標。
返回值 當呼叫成功時則返回目前的讀寫位置,若有錯誤則返回-1errno會存放錯誤程式碼。
錯誤程式碼 EBADF 引數stream無效或可移動讀寫位置的檔案流。
範例 參考fseek()

fwrite(將資料寫至檔案流)
相關函式 fopenfreadfseekfscanf
表頭檔案 #include<stdio.h>
定義函式 size_t fwrite(const void * ptr,size_t size,size_t nmemb,FILE * stream);
函式說明 fwrite()用來將資料寫入檔案流中。引數stream為已開啟的檔案指標,引數ptr指向欲寫入的資料地址,總共寫入的字元數以引數size*nmemb來決定。Fwrite()會返回實際寫入的nmemb數目。
返回值 返回實際寫入的nmemb數目。
範例
#include<stdio.h>
#define set_s (x,y) {strcoy(s[x].name,y);s[x].size=strlen(y);}
#define nmemb 3
struct test
{
char name[20];
int size;
}s[nmemb];
main()
{
FILE * stream;
set_s(0,”Linux!”);
set_s(1,”FreeBSD!”);
set_s(2,”Windows2000.”);
stream=fopen(“/tmp/fwrite”,”w”);
fwrite(s,sizeof(struct test),nmemb,stream);
fclose(stream);
}

執行 參考fread()。

getc(由檔案中讀取一個字元)
相關函式 readfopenfreadfgetc
表頭檔案 #include<stdio.h>
定義函式 int getc(FILE * stream);
函式說明 getc()用來從引數stream所指的檔案中讀取一個字元。若讀到檔案尾而無資料時便返回EOF。雖然getc()fgetc()作用相同,但getc()為巨集定義,非真正的函式呼叫。
返回值 getc()會返回讀取到的字元,若返回EOF則表示到了檔案尾。
範例 參考fgetc()

getchar(由標準輸入裝置內讀進一字元)
相關函式 fopenfreadfscanfgetc
表頭檔案 #include<stdio.h>
定義函式 int getchar(void);
函式說明 getchar()用來從標準輸入裝置中讀取一個字元。然後將該字元從unsigned char轉換成int後返回。
返回值 getchar()會返回讀取到的字元,若返回EOF則表示有錯誤發生。
附加說明 getchar()非真正函式,而是getc(stdin)巨集定義。
範例
#include<stdio.h>
main()
{
FILE * fp;
int c,i;
for(i=0li<5;i++)
{
c=getchar();
putchar(c);
}
}

執行 1234 /*輸入*/
1234 /*輸出*/

gets(由標準輸入裝置內讀進一字串)
相關函式 fopenfreadfscanffgets
表頭檔案 #include<stdio.h>
定義函式 char * gets(char *s);
函式說明 gets()用來從標準裝置讀入字元並存到引數s所指的記憶體空間,直到出現換行字元或讀到檔案尾為止,最後加上NULL作為字串結束。
返回值 gets()若成功則返回s指標,返回NULL則表示有錯誤發生。
附加說明 由於gets()無法知道字串s的大小,必須遇到換行字元或檔案尾才會結束輸入,因此容易造成緩衝溢位的安全性問題。建議使用fgets()取代。
範例 參考fgets()

mktemp(產生唯一的臨時檔名)
相關函式 tmpfile
表頭檔案 #include<stdlib.h>
定義函式 char * mktemp(char * template);
函式說明 mktemp()用來產生唯一的臨時檔名。引數template所指的檔名稱字串中最後六個字元必須是XXXXXX。產生後的檔名會借字符串指標返回。
返回值 檔案順利開啟後,指向該流的檔案指標就會被返回。如果檔案開啟失敗則返回NULL,並把錯誤程式碼存在errno中。
附加說明 引數template所指的檔名稱字串必須宣告為陣列,如:
char template[ ]=”template-XXXXXX”
不可用char * template=”template-XXXXXX”
範例
#include<stdlib.h>
main()
{
char template[ ]=”template-XXXXXX”;
mktemp(template);
printf(“template=%s\n”,template);
}


putc(將一指定字元寫入檔案中)
相關函式 fopenfwritefscanffputc
表頭檔案 #include<stdio.h>
定義函式 int putc(int c,FILE * stream);
函式說明 putc()會將引數c轉為unsigned char後寫入引數stream指定的檔案中。雖然putc()fputc()作用相同,但putc()為巨集定義,非真正的函式呼叫。
返回值 putc()會返回寫入成功的字元,即引數c。若返回EOF則代表寫入失敗。
範例 參考fputc()。

putchar(將指定的字元寫到標準輸出裝置)
相關函式 fopenfwritefscanffputc
表頭檔案 #include<stdio.h>
定義函式 int putchar (int c);
函式說明 putchar()用來將引數c字元寫到標準輸出裝置。
返回值 putchar()會返回輸出成功的字元,即引數c。若返回EOF則代表輸出失敗。
附加說明 putchar()非真正函式,而是putc(cstdout)巨集定義。
範例 參考getchar()

rewind(重設檔案流的讀寫位置為檔案開頭)
相關函式 fseekftellfgetposfsetpos
表頭檔案 #include<stdio.h>
定義函式 void rewind(FILE * stream);
函式說明 rewind()用來把檔案流的讀寫位置移至檔案開頭。引數stream為已開啟的檔案指標。此函式相當於呼叫fseek(stream,0,SEEK_SET)
返回值
範例 參考fseek()

setbuf(設定檔案流的緩衝區)
相關函式 setbuffersetlinebufsetvbuf
表頭檔案 #include<stdio.h>
定義函式 void setbuf(FILE * stream,char * buf);
函式說明 在開啟檔案流後,讀取內容之前,呼叫setbuf()可以用來設定檔案流的緩衝區。引數stream為指定的檔案流,引數buf指向自定的緩衝區起始地址。如果引數bufNULL指標,則為無緩衝IOSetbuf()相當於呼叫:setvbuf(stream,buf,buf?_IOFBF:_IONBF,BUFSIZ)
返回值

setbuffer(設定檔案流的緩衝區)
相關函式 setlinebufsetbufsetvbuf
表頭檔案 #include<stdio.h>
定義函式 void setbuffer(FILE * stream,char * buf,size_t size);
函式說明 在開啟檔案流後,讀取內容之前,呼叫setbuffer()可用來設定檔案流的緩衝區。引數stream為指定的檔案流,引數buf指向自定的緩衝區起始地址,引數size為緩衝區大小。
返回值

setlinebuf(設定檔案流為線性緩衝區)
相關函式 setbuffersetbufsetvbuf
表頭檔案 #include<stdio.h>
定義函式 void setlinebuf(FILE * stream);
函式說明 setlinebuf()用來設定檔案流以換行為依據的無緩衝IO。相當於呼叫:setvbuf(stream,(char * )NULL,_IOLBF,0);請參考setvbuf()
返回值

setvbuf(設定檔案流的緩衝區)
相關函式 setbuffersetlinebufsetbuf
表頭檔案 #include<stdio.h>
定義函式 int setvbuf(FILE * stream,char * buf,int mode,size_t size);
函式說明 在開啟檔案流後,讀取內容之前,呼叫setvbuf()可以用來設定檔案流的緩衝區。引數stream為指定的檔案流,引數buf指向自定的緩衝區起始地址,引數size為緩衝區大小,引數mode有下列幾種
_IONBF 無緩衝IO
_IOLBF 以換行為依據的無緩衝IO
_IOFBF 完全無緩衝IO。如果引數bufNULL指標,則為無緩衝IO
返回值

ungetc(將指定字元寫回檔案流中)
相關函式 fputcgetchargetc
表頭檔案 #include<stdio.h>
定義函式 int ungetc(int c,FILE * stream);
函式說明 ungetc()將引數c字元寫回引數stream所指定的檔案流。這個寫回的字元會由下一個讀取檔案流的函式取得。
返回值 成功則返回c字元,若有錯誤則返回EOF