fpで指定したファイルポインタから最大length-1バイト読み出し、 その文字列を返します。読み出しは、length-1バイト読み出したか、 (返り値に含まれる)改行文字を検出したか、 EOFに達したかのいずれかが起こった時点で終了します。
エラーが起こった場合、FALSEを返します。
陥りやすい罠:
C言語のfgetsの動作に慣れている人は、EOFを返す条件の違いについて 注意する必要があります。
ファイルポインタは有効なものでなければならず、また fopen()、popen()、 fsockopen()で正常にオープンされたファイルを 指している必要があります。
簡単な例を以下に示します。
fread(), fopen(), popen(), fgetc(), fsockopen(), socket_set_timeout() も参照下さい。