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 1999-07-25 "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
61 Apart from the usual ones, there is
64 Conversion of \fIwc\fP to the stream's encoding fails.
75 In the absence of additional information passed to the
78 reasonable to expect that
80 will actually write the multibyte
81 sequence corresponding to the wide character \fIwc\fP.
85 .BR unlocked_stdio (3)