Ｃ言語辞典 fgets()

機能

入力ストリームから文字列を取得することを表す。
取得する文字列は改行文字またはファイル終端までを取得する。

定義

#include <stdio.h>

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

※C99規格では以下の定義となる
char * fgets ( char * restrict s, int n, FILE * restrict stream );

引数

s	取得した文字列の格納先
n	読み取る文字数の最大値
stream	取得するストリーム（FILE）へのポインタ

戻り値

成功した場合は、引数sを返す。
ストリームがファイルの終わりに達しているまたはエラーが発生した場合は、NULLを返す。

実装例

#include <stdio.h>

int main(void)
{
    FILE *fp;
    char s[100];
    char *ret;
    
    fp = fopen("test.txt", "r");
    
    if (NULL != fp) {
        
        ret = fgets(s, 100, fp);  /* ファイルから文字列読み込み */
        
        if (NULL != ret) {
            printf("%s", s);      /* 読み込んだ文字列を表示    */
        } else {
            printf("EOF\n");      /* ファイル終端ならEOFを表示 */
        }
        
        fclose(fp);
    }
    
    return 0;
}

(test.txtの内容)
Hello World.
Hello World.

実行結果

Hello World.