Penguin
Recent Changes
Annotated edit history of putwc(3) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 FPUTWC
2 !!!FPUTWC
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 RETURN VALUE
7 ERRORS
8 CONFORMING TO
9 SEE ALSO
10 NOTES
11 ----
12 !!NAME
13
14
15 fputwc - write a wide character to a FILE stream
16 !!SYNOPSIS
17
18
19 __#include
20 __ ''wc''__, FILE*__ ''stream''__);
21 wint_t putwc (wchar_t__ ''wc''__, FILE*__ ''stream''__);
22 __
23 !!DESCRIPTION
24
25
26 The __fputwc__ function is the wide-character equivalent
27 of the __fputc__ function. It writes the wide character
28 ''wc'' to ''stream''. If ''ferror(stream)'' becomes
29 true, it returns WEOF. If a wide character conversion error
30 occurs, it sets __errno__ to __EILSEQ__ and returns
31 WEOF. Otherwise it returns ''wc''.
32
33
34 The __putwc__ function or macro functions identically to
35 __fputwc__. It may be implemented as a macro, and may
36 evaluate its argument more than once. There is no reason
37 ever to use it.
38 !!RETURN VALUE
39
40
41 The __fputwc__ function returns ''wc'' if no error
42 occurred, or WEOF to indicate an error.
43 !!ERRORS
44
45
46 Apart from the usual ones, there is
47
48
49 __EILSEQ__
50
51
52 Conversion of ''wc'' to the stream's encoding
53 fails.
54 !!CONFORMING TO
55
56
57 ISO/ANSI C, UNIX98
58 !!SEE ALSO
59
60
61 fgetwc(3), fputws(3)
62 !!NOTES
63
64
65 The behaviour of __fputwc__ depends on the LC_CTYPE
66 category of the current locale.
67
68
69 In the absence of additional information passed to the fopen
70 call, it is reasonable to expect that __fputwc__ will
71 actually write the multibyte sequence corresponding to the
72 wide character ''wc''.
73 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.