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)

NAME

gets, fgets − get a string from a stream

USAGE

#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 ends with a newline character, which is replaced in s by a null character.  Gets returns its argument. 

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

NOTES

Gets deletes a newline from the string it reads; fgets keeps it. 

DIAGNOSTICS

Gets and fgets return the constant pointer NULL upon end of file or error. 

RELATED INFORMATION

puts(3S), getc(3S), scanf(3S), fread(3S), ferror(3S)

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