fgets

ストリーム (stream) から 1 行単位で文字列を読み取ります．

#include <stdio.h>

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

fgets 関数は stream が指すストリームから 1 行分※文字列を読み取り s が指す配列に格納します．このとき n-1 が 1 行の最大文字数となります．配列に格納した文字の後にナル文字 ('\0') を書き込みます．

※ 正確には改行文字または，ファイルの終りまで文字列を読み取ります．(読み取った改行文字も配列に格納します．)

引数

戻り値

  • 読み取り成功時: s
  • ファイルの終りかつ，1 文字も読み取れなかった場合: 空ポインタ (NULL)
  • 読み取り失敗時: 空ポインタ (配列の内容は不定)

C言語サンプルプログラム

以下に fgets 関数を使用したサンプルプログラムを示します．以下のサンプルプログラムでは fgets を使用してファイルから文字を読み取り，その文字を puts で標準出力に表示させています．

/* header files */
#include <stdio.h>
#include <stdlib.h>

/* macros */
#define N 256

/* main */
int main(void) {
    FILE *fp;
    char *filename = "sample.txt";
    char readline[N] = {'\0'};

    /* ファイルのオープン */
    if ((fp = fopen(filename, "r")) == NULL) {
        fprintf(stderr, "%sのオープンに失敗しました.\n", filename);
        exit(EXIT_FAILURE);
    }

    /* ファイルの終端まで文字を読み取り表示する */
    while ( fgets(readline, N, fp) != NULL ) {
        puts(readline);
    }

    /* ファイルのクローズ */
    fclose(fp);

    return EXIT_SUCCESS;
}

実行例

サンプルプログラム内で使用する sample.txt の内容は以下のように用意したとします．

You play with the cards you're dealt..Whatever that means.

サンプルプログラムの実行結果は以下のようになります．

You play with the cards you're dealt..Whatever that means.

cプログラマの必読書

たくさんあるc言語関連の書籍の中でも特に役に立った本です．よかったら参考にしてみてください．

c実践プログラミング 第3版

c言語の実践的参考書．少々値段は張りますが初心者を脱しようとしている人は絶対に読むべきです．
文法だけでなく，コーディングスタイルやデバッグなど文字通り「実践的」なことが書かれているので非常にためになります． オライリーの本は，読みにくい本が多いのですが本書はとても読みやすくオススメです．


c言語ポインタ完全制覇 (標準プログラマーズライブラリ)

ポインタの解説書としては最高の書籍です．
この1冊でポインタを完全に理解することができます．全くの初学者が読むには敷居が高いですが，入門書を読み終えた後に読むと非常に有益です．