Reads the next integer from a stream and increments the associated file pointer (if there is one) to point to the next unread value.

#include <stdio.h>

int getw (FILE *stream);

Parameters

stream

Pointer to FILE structure.

Remarks

getw does not assume any special alignment of items in the stream.

getw is provided primarily for compatibility with previous libraries. Portability problems may occur with getw, since the integer size and byte ordering can differ across systems.

Return Values

The integer value read.

Success.

EOF or end-of-file. Since the EOF value is also a legitimate integer value, use feof or ferror to verify an end-of-file or error condition.

Failure.

Requirements

See Also

feof, ferror, putw