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 2015-08-08 "GNU" "Linux Programmer's Manual"
18 fputwc, putwc \- write a wide character to a FILE stream
25 .BI "wint_t fputwc(wchar_t " wc ", FILE *" stream );
26 .BI "wint_t putwc(wchar_t " wc ", FILE *" stream );
31 function is the wide-character
35 It writes the wide character \fIwc\fP to \fIstream\fP.
37 \fIferror(stream)\fP becomes true, it returns
39 If a wide-character conversion error occurs,
40 it sets \fIerrno\fP to \fBEILSEQ\fP and returns
42 Otherwise, it returns \fIwc\fP.
46 function or macro functions identically to
48 It may be implemented as a macro, and may evaluate its argument
50 There is no reason ever to use it.
52 For nonlocking counterparts, see
53 .BR unlocked_stdio (3).
57 function returns \fIwc\fP if no error occurred, or
60 In the event of an error,
62 is set to indicate the cause.
64 Apart from the usual ones, there is
67 Conversion of \fIwc\fP to the stream's encoding fails.
69 For an explanation of the terms used in this section, see
75 Interface Attribute Value
79 T} Thread safety MT-Safe
83 POSIX.1-2001, POSIX.1-2008, C99.
92 In the absence of additional information passed to the
95 reasonable to expect that
97 will actually write the multibyte
98 sequence corresponding to the wide character \fIwc\fP.
102 .BR unlocked_stdio (3)