up | Inhaltsverzeichniss | Kommentar
Manual page for GETS(3S)

gets, fgets - get a string from a stream

SYNOPSIS

#include <stdio.h>


char *gets(s)
char *s;


char *fgets(s, n, stream)
char *s;
FILE *stream;

DESCRIPTION

gets() reads characters from the standard input stream, stdin, into the array pointed to by s, until a NEWLINE character is read or an EOF condition is encountered. The NEWLINE character is discarded and the string is terminated with a null character. gets() returns its argument.

fgets() reads characters from the stream into the array pointed to by s, until n-1 characters are read, a NEWLINE character is read and transferred to s, or an EOF condition is encountered. The string is then terminated with a null character. fgets() returns its first argument.

SEE ALSO

puts.3s getc.3v scanf.3v fread.3s ferror.3v

BUGS

If the input to gets () or fgets () contains a null character, the null terminates the input, and all subsequent data will be lost.

DIAGNOSTICS

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

index | Inhaltsverzeichniss | Kommentar

Created by unroff & hp-tools. © somebody (See intro for details). All Rights Reserved. Last modified 11/5/97