NAME

putwc - put a wide-character on a stream

 SYNOPSIS

#include <stdio.h>
#include <wchar.h>

wint_t putwc(wchar_t wc, FILE *stream);

 DESCRIPTION

The putwc() function is equivalent to fputwc(), except that if it is implemented as a macro it may evaluate stream more than once, so the argument should never be an expression with side-effects.

 RETURN VALUE

Refer to fputwc().

 ERRORS

Refer to fputwc().

 EXAMPLES

None.

 APPLICATION USAGE

Because it may be implemented as a macro, putwc() may treat a stream argument with side-effects incorrectly. In particular, putwc(wc, *f++) need not work correctly. Therefore, use of this interface is not recommended; fputwc() should be used instead.

 FUTURE DIRECTIONS

None.

 SEE ALSO

fputwc(), <stdio.h>, <wchar.h>.