Originální popis anglicky:
fputwc - write a wide character to a FILE stream
Návod, kniha: Linux Programmer's Manual
#include <stdio.h>
#include <wchar.h>
wint_t fputwc(wchar_t wc, FILE *stream);
wint_t putwc(wchar_t wc, FILE *stream);
The
fputwc function is the wide-character equivalent of the
fputc
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 non-locking counterparts, see
unlocked_stdio(3).
The
fputwc function returns
wc if no error occurred, or WEOF to
indicate an error.
Apart from the usual ones, there is
- EILSEQ
- Conversion of wc to the stream's encoding
fails.
ISO/ANSI C, UNIX98
The behaviour of
fputwc depends on the LC_CTYPE category of the current
locale.
In the absence of additional information passed to the fopen call, it is
reasonable to expect that
fputwc will actually write the multibyte
sequence corresponding to the wide character
wc.
fgetwc(3),
fputws(3),
unlocked_stdio(3)
