xref: /original-bsd/lib/libc/stdio/gets.3 (revision 549425d7)
@(#)gets.3 6.2 (Berkeley) 04/01/89

GETS 3 ""
.AT 3
NAME
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 a string into s from the standard input stream stdin . The string is terminated by a newline character, which is replaced in s by a null character. Gets returns its argument.

Fgets reads n -1 characters, or up through a newline character, whichever comes first, from the stream into the string s . The last character read into s is followed by a null character. Fgets returns its first argument.

"SEE ALSO"
puts(3), getc(3), scanf(3), fread(3), ferror(3)
DIAGNOSTICS
Gets and fgets return the constant pointer NULL upon end of file or error.
BUGS
Gets deletes a newline, fgets keeps it, all in the name of backward compatibility.