View Source: fputwc(3) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages

FPUTWC
!!!FPUTWC
NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
CONFORMING TO
SEE ALSO
NOTES
----
!!NAME


fputwc - write a wide character to a FILE stream
!!SYNOPSIS


__#include
__ ''wc''__, FILE*__ ''stream''__);
wint_t putwc (wchar_t__ ''wc''__, FILE*__ ''stream''__);
__
!!DESCRIPTION


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.
!!RETURN VALUE


The __fputwc__ function returns ''wc'' if no error
occurred, or WEOF to indicate an error.
!!ERRORS


Apart from the usual ones, there is


__EILSEQ__


Conversion of ''wc'' to the stream's encoding
fails.
!!CONFORMING TO


ISO/ANSI C, UNIX98
!!SEE ALSO


fgetwc(3), fputws(3)
!!NOTES


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''.
----

11 pages link to fputwc(3):

This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

Last edited on Tuesday, June 4, 2002 12:24:20 am by "perry"

Edit PageHistory Diff Info LikePages