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 2013-04-19 "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.
78 In the absence of additional information passed to the
81 reasonable to expect that
83 will actually write the multibyte
84 sequence corresponding to the wide character \fIwc\fP.
88 .BR unlocked_stdio (3)
90 This page is part of release 3.68 of the Linux
93 A description of the project,
94 information about reporting bugs,
95 and the latest version of this page,
97 \%http://www.kernel.org/doc/man\-pages/.