opensolaris man page for fwide

fwide(3C)						   Standard C Library Functions 						 fwide(3C)

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 0, the function first attempts
       to make the stream wide-orientated.  If mode is less than 0, the function first attempts to make the  stream  byte-orientated.	Otherwise,
       mode is 0 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.

RETURN VALUES
       The fwide() function returns a value greater than 0 if, after the call, the stream has wide-orientation, a value less than 0 if the  stream
       has byte-orientation, or 0 if the stream has no orientation.

ERRORS
       The fwide() function may fail if:

       EBADF	The stream argument is not a valid stream.

USAGE
       A call to fwide() with  mode set to 0 can be used to determine the current orientation of a stream.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       attributes(5), standards(5)

SunOS 5.11							    24 Jul 2002 							 fwide(3C)