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

NAME
     ffwwiiddee - get/set orientation of a stream

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>
     ##iinncclluuddee <>

     int
     ffwwiiddee(FILE *stream, int mode);

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

     If the orientation of stream has already been determined, ffwwiiddee() leaves
     it unchanged.  Otherwise, ffwwiiddee() sets the orientation of stream accord-
     ing 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 ffwwiiddee() function returns a value according to orientation after the
     call of ffwwiiddee(); 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 ffwwiiddee() function conforms to ISO/IEC 9899:1999 (``ISO C99'').

BSD                            October 24, 2001                            BSD