HP-UX Reference (11i v2 04/09) - 3 Library Functions A-M (vol 6)

fwide(3C) 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.Ifmode is greater

than zero, the function ﬁrst attempts to make the stream wide-oriented. If mode is less than zero, the

function ﬁrst attempts to make the stream byte-oriented. Otherwise, mode is zero 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.

APPLICATION USAGE

A call to

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

RETURN VALUE

The

fwide() function returns a value greater than zero if, after the call, the stream has wide-

orientation, a value less than zero if the stream has byte-orientation, or zero if the stream has no orienta-

tion.

ERRORS

The

fwide() function may fail if:

[EBADF] The stream argument is not a valid stream.

AUTHOR

fwide() was developed by HP and Mitsubishi Electric Corporation.