fwide(3) [osf1 man page]

fwide(3)						     Library Functions Manual							  fwide(3)

NAME

       fwide - Sets stream orientation to byte or wide-character

LIBRARY

       Standard C Library (libc)

SYNOPSIS

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

       int fwide(
	       FILE *stream,
	       int mode);

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       fwide(): XSH5.0

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

       Points to a FILE structure specifying an open stream Specifies an integer that determines the orientation of the stream.  If the integer is
       greater than zero, the function attempts to make the stream wide-character oriented.  If the  integer  is  less	than  zero,  the  function
       attempts to make the stream byte oriented. If the integer is zero, the function does not attempt to alter the stream orientation.

DESCRIPTION

       The fwide() function, depending on the value of the mode parameter, sets or queries the orientation of a stream of data specified by a FILE
       structure.

       If the stream has no orientation, a positive or negative mode value causes the function to change the stream orientation to wide  character
       or byte, respectively. The function does not change stream orientation when it is already set.  When the stream orientation is already set,
       the application must first call freopen() to reinitialize the stream and then call fwide() to reset the stream orientation.

       A mode value of zero causes the function to return the current stream orientation without attempting to change it.

RETURN VALUES

       The fwide() function returns an integer value to indicate the stream orientation after the call.  The function returns a value greater than
       zero  if the stream orientation is wide-character, a value less than zero if the stream orientation is byte, and 0 (zero) if the stream has
       no orientation.	On error, the function returns 0 (zero) and sets errno to indicate the condition.

ERRORS

       The file descriptor associated with stream is invalid.

RELATED INFORMATION

       Functions:  fopen(3) delim off

																	  fwide(3)

FWIDE(3)						     Linux Programmer's Manual							  FWIDE(3)

NAME

       fwide - set and determine the orientation of a FILE stream

SYNOPSIS

       #include <wchar.h>

       int fwide(FILE *stream, int mode);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       fwide():
	   _XOPEN_SOURCE >= 500 || _ISOC99_SOURCE ||
	   _ISOC95_SOURCE /* Since glibc 2.12 */ ||
	   _POSIX_C_SOURCE >= 200112L;
	   or cc -std=c99

DESCRIPTION

       When  mode is zero, the fwide() function determines the current orientation of stream.  It returns a positive value if stream is wide-char-
       acter oriented, that is, if wide-character I/O is permitted but char I/O is disallowed.	It returns a negative value if stream is byte ori-
       ented, i.e., if char I/O is permitted but wide-character I/O is disallowed.  It returns zero if stream has no orientation yet; in this case
       the next I/O operation might change the orientation (to byte oriented if it is a char I/O operation, or to wide-character oriented if it is
       a wide-character I/O operation).

       Once a stream has an orientation, it cannot be changed and persists until the stream is closed.

       When  mode  is nonzero, the fwide() function first attempts to set stream's orientation (to wide-character oriented if mode is greater than
       0, or to byte oriented if mode is less than 0).	It then returns a value denoting the current orientation, as above.

RETURN VALUE

       The fwide() function returns the stream's orientation, after possibly changing it.  A positive return value means wide-character  oriented.
       A negative return value means byte oriented.  A return value of zero means undecided.

CONFORMING TO

       C99, POSIX.1-2001.

NOTES

       Wide-character output to a byte oriented stream can be performed through the fprintf(3) function with the %lc and %ls directives.

       Char oriented output to a wide-character oriented stream can be performed through the fwprintf(3) function with the %c and %s directives.

SEE ALSO

       fprintf(3), fwprintf(3)

COLOPHON

       This  page is part of release 3.53 of the Linux man-pages project.  A description of the project, and information about reporting bugs, can
       be found at http://www.kernel.org/doc/man-pages/.

GNU
								    2011-09-17								  FWIDE(3)