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

Safety:  
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes