fgets

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

char* fgets( char* restrict str, int count, FILE* restrict stream );

最大 count - 1 文字を与えられたファイルストリームから読み込み、str が指す文字配列に格納する。改行文字が見つかった場合（その場合、str にその改行文字が含まれる）またはファイルの終わりに達した場合、解析は停止する。バイトが読み込まれ、エラーが発生しなかった場合は、str に書き込まれた最後の文字の直後にナル文字を書き込む。

パラメータ

戻り値

str 成功時、失敗時はnullポインタ。

ファイル終端条件が発生した場合、 eof インジケータを stream に設定する（ feof() 参照）。これはバイトが読み取られなかった場合にのみ失敗と見なされ、その場合はヌルポインタが返され、 str が指す配列の内容は変更されない（すなわち、先頭バイトがナル文字で上書きされない）。

失敗が他の何らかのエラーによって引き起こされた場合、 エラー インジケータを設定します（ ferror() を参照）。 stream に対して設定されます。 str が指す配列の内容は不定です（null終端されていない可能性もあります）。

注記

POSIXはさらに要求する、fgetsがerrnoを設定することを、読み取りエラーが発生した場合に。

標準仕様は不明瞭であるがの場合にはcount <= 1、一般的な実装は

• もしcount < 1なら、何もせずエラーを報告し、
• もしcount == 1なら、

• 一部の実装は何もせずエラーを報告し、
• 他の実装は何も読み取らず、str[0]にゼロを格納して成功を報告する。

例

#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    FILE* tmpf = tmpfile();
    fputs("Alan Turing\n", tmpf);
    fputs("John von Neumann\n", tmpf);
    fputs("Alonzo Church\n", tmpf);
    rewind(tmpf);
    char buf[8];
    while (fgets(buf, sizeof buf, tmpf) != NULL)
          printf("\"%s\"\n", buf);
    if (feof(tmpf))
       puts("End of file reached");
}

"Alan Tu"
"ring
"
"John vo"
"n Neuma"
"nn
"
"Alonzo "
"Church
"
End of file reached

参考文献

関連項目