fgets

Syntax

#include <stdio.h> char *fgets(char *buffer, int maxlength, FILE *file);

Description

This function reads as much of a line from a file as possible, stopping when the buffer is full (maxlength-1 characters), an end-of-line is detected, or EOF or an error is detected. It then stores a NULL to terminate the string.

Return Value

The address of the buffer is returned on success, if EOF is encountered before any characters are stored, or if an error is detected, NULL is returned instead.

Portability

ANSI/ISO C	C89; C99
POSIX	1003.2-1992; 1003.1-2001

Example

char buf[100]; while (fgets(buf, 100, stdin)) fputs(buf, stdout);