Manpage of GETW

GETW

Section: NEWLIB (3)
Updated: 2005 Feb 23
Index Return to Main Contents

NAME

3.28 `getw'--read a word (int)

SYNOPSIS

#include <stdio.h>
int getw(FILE *FP);

DESCRIPTION

`getw' is a function, defined in `stdio.h'. You can use `getw' to get the next word from the file or stream identified by FP. As a side effect, `getw' advances the file's current position indicator.

RETURNS The next word (read as an `int'), unless there is no more data, or the host system reports a read error; in either of these situations, `getw' returns `EOF'. Since `EOF' is a valid `int', you must use `ferror' or `feof' to distinguish these situations.

PORTABILITY

`getw' is a remnant of K&R C, it is not part of any ISO C Standard. `fread' should be used instead. In fact, this implementation of `getw' is based upon `fread'.

Supporting OS subroutines required: `fread'.