manページ  — FGETS

fgets, gets – ストリームから行を取得

ライブラリ 書式 解説 戻り値 エラー 関連項目 規格 バグ

Standard C Library (libc, -lc)

#include <stdio.h>

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

char *
gets(char *str);

fgets() 関数は、最大で size で指定された文字数より 1 だけ少ない数の文字を stream から読み込み、文字列 str に保存します。 読込みは、改行文字が見つかったり、ファイルの終了 あるいはエラーが見つかったりした場合に停止します。 改行文字は、存在していれば保持されます。 任意の文字を読み込んでエラーが発生しなかった場合、 文字列の最後には ‘\0’ 文字が追加されます。

gets() 関数は fgets() 関数で size を無限にし、 stdin を stream にしたものと等価ですが、 文字列中で改行文字が保存されない (改行文字が存在した場合) 点が 異なります。 入力行が存在する場合、それが十分短く文字列に収まりきる ことを保証するのは呼び出し側の責任です。

fgets() 関数と gets() 関数は、 ISO/IEC 9899:1990 ("ISO C90") に適合しています。

通常、次の入力行がある任意の長さより短いことを保証するのは 不可能であり、また入力バッファをオーバフローすると ほぼ必ずセキュリティ違反となるため、 プログラムでは gets() を 絶対に 使用しないでください。 gets() は、 ISO/IEC 9899:1990 ("ISO C90") に適合するためだけに存在しています。