NAME
fwide() — set stream orientation
SYNOPSIS
#include <stdio.h>
#include <wchar.h>
int fwide(FILE *stream, int mode);
DESCRIPTION
The
fwide()
function determines the orientation of the stream pointed to by
stream.
If
mode
is greater than zero,
the function first attempts to make the
stream wide-oriented.
If
mode
is less than zero, the function first attempts to make the
stream byte-oriented.
Otherwise,
mode
is zero and the function does not alter the orientation of the stream.
If the orientation of the stream has already been determined,
fwide()
does not change it.
Because no return value is reserved to indicate an error,
an application wishing to check for error situations should set
errno
to 0, then call
fwide(),
then check
errno,
and if it is non-zero, assume an error has occurred.
APPLICATION USAGE
A call to
fwide()
with
mode
set to 0 can be used to determine the current orientation of a stream.
The prototype of this function is available to applications
if they are:
- a.
c99
conformant.
- b.
Compiled with
-D_XOPEN_SOURCE
macro with a value >=500.
- c.
Compiled with
-D_POSIX_C_SOURCE
macro with a value >= 200112.
RETURN VALUE
The
fwide()
function returns a value greater than zero if, after the call,
the stream has wide-orientation,
a value less than zero if the stream has byte-orientation,
or zero if the stream has no orientation.
ERRORS
The
fwide()
function may fail if:
- EBADF
The
stream
argument is not a valid stream.
AUTHOR
fwide()
was developed by HP and Mitsubishi Electric Corporation.