Penguin
Recent Changes
Annotated edit history of fwide(3) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 FWIDE
2 !!!FWIDE
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 RETURN VALUE
7 CONFORMING TO
8 SEE ALSO
9 NOTES
10 ----
11 !!NAME
12
13
14 fwide - set and determine the orientation of a FILE stream
15 !!SYNOPSIS
16
17
18 __#include
19 __ ''stream''__, int__ ''mode''__);
20 __
21 !!DESCRIPTION
22
23
24 When ''mode'' is zero, the __fwide__ function
25 determines the current orientation of ''stream''. It
26 returns a value ''stream'' is wide-character
27 oriented, i.e. if wide character I/O is permitted but char
28 I/O is disallowed. It returns a value
29 ''stream'' is byte oriented, i.e. if char I/O is
30 permitted but wide character I/O is disallowed. It returns
31 zero if ''stream'' has no orientation yet; in this case
32 the next I/O operation might change the orientation (to byte
33 oriented if it is a char I/O operation, or to wide-character
34 oriented if it is a wide character I/O
35 operation).
36
37
38 Once a stream has an orientation, it cannot be changed and
39 persists until the stream is closed.
40
41
42 When ''mode'' is non-zero, the __fwide__ function
43 first attempts to set ''stream'''s orientation (to
44 wide-character oriented if ''mode''
45 ''mode''
46 ''
47 !!RETURN VALUE
48
49
50 The __fwide__ function returns the stream's orientation,
51 after possibly changing it. A return value
52 __
53 !!CONFORMING TO
54
55
56 ISO/ANSI C, UNIX98
57 !!SEE ALSO
58
59
60 fprintf(3), fwprintf(3)
61 !!NOTES
62
63
64 Wide-character output to a byte oriented stream can be
65 performed through the __fprintf__ function with the %lc
66 and %ls directives.
67
68
69 Char oriented output to a wide-character oriented stream can
70 be performed through the __fwprintf__ function with the
71 %c and %s directives.
72 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.