fwide(3) [freebsd man page]

FWIDE(3)						   BSD Library Functions Manual 						  FWIDE(3)

NAME

     fwide -- get/set orientation of a stream

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <stdio.h>
     #include <wchar.h>

     int
     fwide(FILE *stream, int mode);

DESCRIPTION

     The fwide() function determines the orientation of the stream pointed at by stream.

     If the orientation of stream has already been determined, fwide() leaves it unchanged.  Otherwise, fwide() sets the orientation of stream
     according to mode.

     If mode is less than zero, stream is set to byte-oriented.  If it is greater than zero, stream is set to wide-oriented.  Otherwise, mode is
     zero, and stream is unchanged.

RETURN VALUES

     The fwide() function returns a value according to orientation after the call of fwide(); a value less than zero if byte-oriented, a value
     greater than zero if wide-oriented, and zero if the stream has no orientation.

SEE ALSO

     ferror(3), fgetc(3), fgetwc(3), fopen(3), fputc(3), fputwc(3), freopen(3), stdio(3)

STANDARDS

     The fwide() function conforms to ISO/IEC 9899:1999 (``ISO C99'').

BSD
								 October 24, 2001							       BSD

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.10							    24 Jul 2002 							 fwide(3C)