Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ getw(3S) — RISC iX 1.2

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

clearerr(3S)

fopen(3S)

putc(3S)

gets(3S)

scanf(3S)

fread(3S)

ungetc(3S)

GETC(3S)  —  UNIX Programmer’s Manual

NAME

getc, getchar, fgetc, getw − get character or word from stream

SYNOPSIS

#include <stdio.h>

int getc(stream)
FILE ∗stream;

int getchar()

int fgetc(stream)
FILE ∗stream;

int getw(stream)
FILE ∗stream;

DESCRIPTION

Getc returns the next character from the named input stream.

Getchar() is identical to getc(stdin). 

Fgetc is identical to getc,

Getw returns the next int (a 32-bit integer on an ARM) from the named input stream. It returns the constant EOF upon end of file or error, but since that is a good integer value, feof and ferror(3S) should be used to check the success of getw. Getw assumes no special alignment in the file. 

SEE ALSO

clearerr(3S), fopen(3S), putc(3S), gets(3S), scanf(3S), fread(3S), ungetc(3S)

DIAGNOSTICS

These functions return the integer constant EOF at end of file, upon read error, or if an attempt is made to read a file not opened by fopen. The end-of-file condition is remembered, even on a terminal, and all subsequent attempts to read will return EOF until the condition is cleared with clearerr(3S).

BUGS

Because it is implemented as a macro, getc treats a stream argument with side effects incorrectly.  In particular, ‘getc(∗f++);’ doesn’t work sensibly. 

7th Edition  —  Revision 1.4 of 29/11/88

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