FPUTWC

NAME

fputwc - 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 fBfputwcfP function is the wide-character equivalent of the fBfputcfP function. It writes the wide character fIwcfP to fIstreamfP. If fIferror(stream)fP becomes true, it returns WEOF. If a wide character conversion error occurs, it sets fBerrnofP to fBEILSEQfP and returns WEOF. Otherwise it returns fIwcfP.

The fBputwcfP function or macro functions identically to fBfputwcfP. 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).

RETURN VALUE

The fBfputwcfP function returns fIwcfP if no error occurred, or WEOF to indicate an error.

ERRORS

Apart from the usual ones, there is

EILSEQ: Conversion of fIwcfP to the stream's encoding fails.

CONFORMING TO

ISO/ANSI C, UNIX98

NOTES

The behaviour of fBfputwcfP 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 fBfputwcfP will actually write the multibyte sequence corresponding to the wide character fIwcfP.