fgets，fgetws

stdio.h：インデックス への移動

ヘッダーファイル

stdio.h

カテゴリ

入出力ルーチン

プロトタイプ

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

wchar_t *fgetws(wchar_t *s, int n, FILE *stream); // Unicode バージョン

説明

ストリームから文字列を取得します。

fgets は，stream から文字列 s に文字を読み取ります。この関数は，n - 1 文字を読み取るか，改行文字を読み取ると，読み取りを終了します。fgets は，s の終わりの改行文字を維持します。文字列の終わりを示すために NULL バイトが s に追加されます。

戻り値

成功した場合，fgets は，s が指す文字列を返します。ファイルの終わり（EOF）またはエラーの場合は，NULL を返します。

例

 #include <string.h>
 #include <stdio.h>
 int main(void)
 {
    FILE *stream;
    char string[] = "This is a test";
    char msg[20];
    /* 更新用にファイルを開きます */
    stream = fopen("DUMMY.FIL", "w+");
    /* 文字列をファイルに書き込みます */
    fwrite(string, strlen(string), 1, stream);
    /* ファイルの先頭を探します */
    fseek(stream, 0, SEEK_SET);
    /* ファイルから 1 文字列を読み取ります */
    fgets(msg, strlen(string)+1, stream);
    /* 文字列を表示する */
    printf("%s", msg);
    fclose(stream);
    return 0;
 }

移植性

	POSIX	Win32	ANSI C	ANSI C++
fgets	+	+	+	+
fgetws		+	+	+