Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

puts(3S)

getc(3S)

scanf(3S)

fread(3S)

ferror(3S)

GETS(3S)  —  UNIX Programmer’s Manual

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(3S), getc(3S), scanf(3S), fread(3S), ferror(3S)

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. 

7th Edition  —  Revision 1.2 of 19/10/88

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026