UMBC CMSC 201 Spring '02 CSEE | 201 | 201 S'02 | lectures | news | help

GETS(3S) GETS(3S)


NAME

gets, fgets - get a string from a stream

SYNOPSIS

#include <stdio.h> char *gets (char *s); char *fgets (char *s, int n, FILE *stream);

DESCRIPTION

gets 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 ALSO

lseek(2), read(2), ferror(3S), fopen(3S), fread(3S), getc(3S), scanf(3S), stdio(3S), ungetc(3S).

NOTES

When using gets, if the length of an input line exceeds the size of s, indeterminate behavior may result.

DIAGNOSTICS

If 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.


CSEE | 201 | 201 S'02 | lectures | news | help