fgetc()/fputc()/fgets()/fputs()/fread()/fwrite()/fopen()/fclose()

fgets（由檔案中讀取一字元串）

相關函數 open，fread，fscanf，getc

表頭檔案 include<stdio.h>

定義函數 char * fgets(char * s,int size,FILE * stream);

函數說明 fgets()用來從參數stream所指的檔案内讀入字元并存到參數s所指的記憶體空間，直到出現換行字元、讀到檔案尾或是已讀了size-1個字元為止，最後會加上NULL作為字元串結束。

傳回值 gets()若成功則傳回s指針，傳回NULL則表示有錯誤發生。

範例 #include<stdio.h>

int main(int argc,char *argv[])

{

char s[80];

fputs(fgets(s,80,stdin),stdout);

}

執行:

this is a test

this is a test

fputs（将一指定的字元串寫入檔案内）

相關函數 fopen，fwrite，fscanf，fputc，putc

表頭檔案 #include<stdio.h>

定義函數 int fputs(const char * s,FILE * stream);

函數說明 fputs()用來将參數s所指的字元串寫入到參數stream所指的檔案内。

傳回值 若成功則傳回寫出的字元個數，傳回EOF則表示有錯誤發生。

範例 見上

fgetc（由檔案中讀取一個字元）

相關函數 open，fread，fscanf，getc

表頭檔案 include<stdio.h>

定義函數 int fgetc(FILE * stream);

函數說明 fgetc()從參數stream所指的檔案中讀取一個字元。若讀到檔案尾而無資料時便傳回EOF。

傳回值 getc()會傳回讀取到的字元，若傳回EOF則表示到了檔案尾。

範例

#include<stdio.h>

int main(int argc,char *argv[])

{

FILE *fp;

int c;

fp=fopen(“exist”,”r”);

while((c=fgetc(fp))!=EOF)

printf(“%c”,c);

fclose(fp);

}

fputc（将一指定字元寫入檔案流中）

相關函數 fopen，fwrite，fscanf，putc

表頭檔案 #include<stdio.h>

定義函數 int fputc(int c,FILE * stream);

函數說明 fputc 會将參數c 轉為unsigned char 後寫入參數stream 指定的檔案中。

傳回值 fputc()會傳回寫入成功的字元，即參數c。若傳回EOF則代表寫入失敗。

範例 #include<stdio.h>

int main(int argc,char *argv[])

{

FILE * fp;

char a[26]=”abcdefghijklmnopqrstuvwxyz”;

int i;

fp= fopen(“noexist”,”w”);

for(i=0;i<26;i++)

fputc(a[i],fp);

fclose(fp);

}

fread（從檔案流讀取資料）

相關函數 fopen，fwrite，fseek，fscanf

表頭檔案 #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(int argc,char *argv[])

{

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[i].name,i,s[i].size);

}

執行

name[0]=Linux! size[0]=6

name[1]=FreeBSD! size[1]=8

name[2]=Windows2000 size[2]=11

fwrite（将資料寫至檔案流）

相關函數 fopen，fread，fseek，fscanf

表頭檔案 #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);

}

執行

name[0]=Linux! size[0]=6

name[1]=FreeBSD! size[1]=8

name[2]=Windows2000 size[2]=11

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>

int main(int argc,char *argv[])

{

FILE * fp;

fp=fopen(“noexist”,”a+”);

if(fp= =NULL) return;

fclose(fp);

}

fclose（關閉檔案）

相關函數 close，fflush，fopen，setbuf

表頭檔案 #include<stdio.h>

定義函數 int fclose(FILE * stream);

函數說明 fclose()用來關閉先前fopen()打開的檔案。此動作會讓緩沖區内的資料寫入檔案中，并釋放系統所提供的檔案資源。

傳回值 若關檔案動作成功則傳回0，有錯誤發生時則傳回EOF并把錯誤代碼存到errno。

錯誤代碼 EBADF表示參數stream非已打開的檔案。