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 2021-03-22 "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).
62 is set to indicate the error.
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
77 Interface Attribute Value
81 T} Thread safety MT-Safe
87 POSIX.1-2001, POSIX.1-2008, C99.
96 In the absence of additional information passed to the
99 reasonable to expect that
101 will actually write the multibyte
102 sequence corresponding to the wide character \fIwc\fP.
106 .BR unlocked_stdio (3)