1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
4 .\" This is free documentation; you can redistribute it and/or
5 .\" modify it under the terms of the GNU General Public License as
6 .\" published by the Free Software Foundation; either version 2 of
7 .\" the License, or (at your option) any later version.
10 .\" References consulted:
11 .\" GNU glibc-2 source code and manual
12 .\" Dinkumware C library reference http://www.dinkumware.com/
13 .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
16 .TH FPUTWC 3 2017-09-15 "GNU" "Linux Programmer's Manual"
18 fputwc, putwc \- write a wide character to a FILE stream
24 .BI "wint_t fputwc(wchar_t " wc ", FILE *" stream );
25 .BI "wint_t putwc(wchar_t " wc ", FILE *" stream );
30 function is the wide-character
34 It writes the wide character \fIwc\fP to \fIstream\fP.
36 \fIferror(stream)\fP becomes true, it returns
38 If a wide-character conversion error occurs,
39 it sets \fIerrno\fP to \fBEILSEQ\fP and returns
41 Otherwise, it returns \fIwc\fP.
45 function or macro functions identically to
47 It may be implemented as a macro, and may evaluate its argument
49 There is no reason ever to use it.
51 For nonlocking counterparts, see
52 .BR unlocked_stdio (3).
56 function returns \fIwc\fP if no error occurred, or
59 In the event of an error,
61 is set to indicate the cause.
63 Apart from the usual ones, there is
66 Conversion of \fIwc\fP to the stream's encoding fails.
68 For an explanation of the terms used in this section, see
74 Interface Attribute Value
78 T} Thread safety MT-Safe
82 POSIX.1-2001, POSIX.1-2008, C99.
91 In the absence of additional information passed to the
94 reasonable to expect that
96 will actually write the multibyte
97 sequence corresponding to the wide character \fIwc\fP.
101 .BR unlocked_stdio (3)