fgets

char *fgets(char *str, int n, FILE *stream);

● str-- 這是指向一個字元數組的指針，該數組存儲了要讀取的字元串。

● n-- 這是要讀取的最大字元數（包括最後的空字元）。通常是使用以 str 傳遞的數組長度。

● stream-- 這是指向 FILE 對象的指針，該 FILE 對象標識了要從中讀取字元的流。

從指定的流 stream 讀取一行，並把它存儲在str所指向的字元串內。當讀取(n-1)個字元時，或者讀取到換行符時，或者到達文件末尾時，它會停止，具體視情況而定。

如果文件中的該行，不足n-1個字元，則讀完該行就結束。如若該行（包括最後一個換行符）的字元數超過n-1，則fgets只返回一個不完整的行，但是，緩衝區總是以NULL字元結尾，對fgets的下一次調用會繼續讀該行。函數成功將返回stream，失敗或讀到文件結尾返回NULL。因此不能直接通過fgets的返回值來判斷函數是否是出錯而終止的，應該藉助feof函數或者ferror函數來判斷。

如果成功，該函數返回相同的 str 參數。如果到達文件末尾或者沒有讀取到任何字元，str 的內容保持不變，並返回一個空指針。如果發生錯誤，返回一個空指針。

● ● 在讀字元時遇到end-of-file，則eof指示器被設置，如果還沒讀入任何字元就遇到這種情況，則stream保持原來的內容，返回NULL；

● ● 如果發生讀入錯誤，error指示器被設置，返回NULL，stream的值可能被改變。

注意1：《UNIX 環境高級編程》中指出，每次調用fgets函數會造成標準輸出設備自動刷清！案例詳見《UNIX環境高級編程（第二版）》中程序清單1-5和課後習題5.7，習題5.7的答案中給出了相關的論述。

注意2：初入門者，大多數是在WINDOWS下，使用VS進行練習的。此環境下，對注意1中的情況進行測試，並不能看到案例中所描述的情景，因為具體的實現不同。

stream文件流指針體指向文件內容地址的偏移原則

如果使用fgets()讀取某個文件，第一次讀取的bufsize為5，而文件的第一行有10個字元（算上'\n'），那麼讀取文件的指針會偏移至當前讀取完的這個字元之後的位置。也就是第二次再用fgets()讀取文件的時候，則會繼續讀取其後的字元。而，如果使用fgets() 讀取文件的時候bufsize大於該行的字元總數加2（多出來的兩個，一個保存文件本身的'\n'換行，一個保存字元串本身的結束標識'\0'），文件並不會繼續讀下去，僅僅只是這一行讀取完，隨後指向文件的指針會自動偏移至下一行。

例：

如果一個文件的當前位置的文本如下

Love, I Have

Since you can do it.

如果用fgets(str1,6,file1);去讀取

則執行后str1 = "Love," ，讀取了6-1=5個字元

這個時候再執行fgets(str1,20,file1)則執行后str1 = " I Have\n"

而如果

fgets(str1,23,file1);

則執行str1="Love ,I Have"，讀取了一行(包括行尾的'\n',並自動加上字元串結束符'\0')，當前文件位置移至下一行，雖然23大於當前行上字元總和，可是不會繼續到下一行。而下一次調用fgets()繼續讀取的時候是從下一行開始讀。

#include#includeint main ( void ){ FILE*stream; char string[]="Thisisatest"; char msg[20]; stream=fopen("DUMMY.FIL","w+"); fwrite(string,strlen(string),1,stream); fseek(stream,0,SEEK_SET); fgets(msg,strlen(string)+1,stream); printf("%s",msg); fclose(stream); return 0;}

fgets函數用來從文件中讀入字元串。fgets函數的調用形式如下：fgets（str，n，fp）；此處，fp是文件指針；str是存放在字元串的起始地址；n是一個int類型變數。函數的功能是從fp所指文件中讀入n-1個字元放入str為起始地址的空間內；如果在未讀滿n-1個字元之時，已讀到一個換行符或一個EOF（文件結束標誌），則結束本次讀操作，讀入的字元串中最後包含讀到的換行符。因此，確切地說，調用fgets函數時，最多只能讀入n-1個字元。讀入結束后，系統將自動在最後加'\0'，並以str作為函數值返回。

同時可以用作鍵盤輸入：fgets（key，n，stdin）且還必須：key[strlen(key)]='\0'或者key[n-1]='\0'

還有種程序經常使用的方法：key[strlen(key-1)]=0x00；

與gets相比使用這個好處是：讀取指定大小的數據，避免gets函數從stdin接收字元串而不檢查它所複製的緩存的容積導致的緩存溢出問題。