fwide()

Set or get the stream orientation

Synopsis:

#include <wchar.h>

int fwide( FILE * fp,
           int mode  );

Arguments:

fp

The stream whose orientation you want to set.

mode

The orientation mode:

• If mode is greater than zero and the stream orientation hasn't been set, fwide() flags the stream as wide-oriented.
• If mode is less than zero, fwide() behaves similarly, but flags the stream as byte-oriented.
• If mode is zero, fwide() returns the stream type without altering the stream.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The fwide() function sets or determines the orientation of the stream fp.

Returns:

> 0

The stream is (now) wide-oriented.

0

The stream is unbound.

< 0

The stream is (now) byte-oriented.

Errors:

EBADF

The fp argument isn't valid.

Classification:

ANSI, POSIX 1003.1

See also:

fgets(), fgetws(), fputs(), fputwc()