Section (3) fputwc
Name
fputwc, putwc — write a wide character to a FILE stream
Synopsis
#include <stdio.h> #include <wchar.h>
wint_t
fputwc( |
wchar_t wc, |
FILE *stream) ; |
wint_t
putwc( |
wchar_t wc, |
FILE *stream) ; |
DESCRIPTION
The fputwc
() function is the
wide-character equivalent of the fputc(3) function. It
writes the wide character wc
to stream
. If ferror(stream)
becomes true,
it returns WEOF
. If a
wide-character conversion error occurs, it sets errno
to EILSEQ and returns WEOF
. Otherwise, it returns wc
.
The putwc
() function or
macro functions identically to fputwc
(). It may be implemented as a macro,
and may evaluate its argument more than once. There is no
reason ever to use it.
For nonlocking counterparts, see unlocked_stdio(3).
RETURN VALUE
The fputwc
() function
returns wc
if no
error occurred, or WEOF
to
indicate an error. In the event of an error, errno
is set to indicate the cause.
ERRORS
Apart from the usual ones, there is
- EILSEQ
-
Conversion of
wc
to the stream_zsingle_quotesz_s encoding fails.
ATTRIBUTES
For an explanation of the terms used in this section, see attributes(7).
Interface | Attribute | Value |
fputwc (), putwc () |
Thread safety | MT-Safe |
NOTES
The behavior of fputwc
()
depends on the LC_CTYPE
category of the current locale.
In the absence of additional information passed to the
fopen(3) call, it is
reasonable to expect that fputwc
() will actually write the multibyte
sequence corresponding to the wide character wc
.
COLOPHON
This page is part of release 4.16 of the Linux man-pages
project. A
description of the project, information about reporting bugs,
and the latest version of this page, can be found at
https://www.kernel.org/doc/man−pages/.
Copyright (c) Bruno Haible <haibleclisp.cons.org> %%%LICENSE_START(GPLv2+_DOC_ONEPARA) This is free documentation; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. %%%LICENSE_END References consulted: GNU glibc-2 source code and manual Dinkumware C library reference http://www.dinkumware.com/ OpenGroup_zsingle_quotesz_s Single UNIX specification http://www.UNIX-systems.org/online.html ISO/IEC 9899:1999 |