Next: getwchar, Previous: gets, Up: Stdio [Contents][Index]

### 4.40 `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`.