gets.3s

来自「<B>Digital的Unix操作系统VAX 4.2源码</B>」· 3S 代码 · 共 71 行

.\" SCCSID: @(#)gets.3s	8.2	1/28/91
.TH gets 3s 
.SH Name
gets, fgets \- get a string from a stream
.SH Syntax
.B #include <stdio.h>
.PP
.B char *gets(s)
.br
.B char *s;
.PP
.B char *fgets(s, n, stream)
.br
.B char *s;
.br
.B int n;
.br
.SM
.B FILE
.B *stream;
.SH Description
.NXR "gets subroutine"
.NXR "fgets subroutine"
.NXR "stream" "getting string from"
The
.PN gets
routine reads a string into
.I s
from the standard input stream
.BR stdin .
The string is terminated by a newline
character, which is replaced in
.I s
by a null character.
The
.PN gets
routine returns its argument.
.PP
The
.PN fgets
routine reads 
.IR n \-1
characters, or up to a newline
character, whichever comes first,
from the
.I stream
into the string
.IR s .
The last character read into
.I s
is followed by a null character.
The
.PN fgets
routine returns its first argument.
.SH Restrictions
The
.PN gets
routine deletes a newline,
while
.PN fgets
keeps it.
.SH Diagnostics
The
.PN gets
and
.PN fgets
routines return the constant pointer NULL
upon end of file or error.
.SH See Also
ferror(3s), fread(3s), getc(3s), puts(3s), scanf(3s)