UMBC CMSC 201 Fall '05
CSEE | 201 | 201 F'05 | lectures | news | help
NAMEgets, fgets - get a string from a stream
SYNOPSIS#include <stdio.h> char *gets (char *s); char *fgets (char *s, int n, FILE *stream);
DESCRIPTIONgets reads characters from the standard input stream, stdin, into the array pointed to by s, until a new-line character is read or an end-of- file condition is encountered. The new-line character is discarded and the string is terminated with a null character. fgets reads characters from the stream into the array pointed to by s, until n-1 characters are read, or a new-line character is read and transferred to s, or an end-of-file condition is encountered. The string is then terminated with a null character.
SEE ALSOlseek(2), read(2), ferror(3S), fopen(3S), fread(3S), getc(3S), scanf(3S), stdio(3S), ungetc(3S).
NOTESWhen using gets, if the length of an input line exceeds the size of s, indeterminate behavior may result.
DIAGNOSTICSIf end-of-file is encountered and no characters have been read, no characters are transferred to s and a NULL pointer is returned. If a read error occurs, such as trying to use these functions on a file that has not been opened for reading, a NULL pointer is returned. Otherwise s is returned.