fwide(3c) [sunos man page]
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)
Check Out this Related 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)