Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

ferror(3s)

fread(3s)

getc(3s)

puts(3s)

scanf(3s)

gets(3s)

Name

gets, fgets − get a string from a stream

Syntax

#include <stdio.h>

char *gets(s)
char *s;

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

Description

The gets routine 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.  The gets routine returns its argument.

The fgets routine reads n−1 characters, or up to 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.  The fgets routine returns its first argument.

Restrictions

The gets routine deletes a newline, while fgets keeps it.

Diagnostics

The gets and fgets routines return the constant pointer NULL upon end of file or error.

See Also

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

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