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  deter-
     mined, 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  deter-
     mine the current orientation of a stream.


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO

     attributes(5)


Man(1) output converted with man2html