GLProgramming.com

home :: about :: development guides :: irc :: forums :: search :: paste :: links :: contribute :: code dump

-> Click here to learn how to get live help <-


Manpage of FPUTWC

FPUTWC

Index
 

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.  

SEE ALSO

fgetwc(3), fputws(3), unlocked_stdio(3)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
CONFORMING TO
NOTES
SEE ALSO