putwc(3S)                                                  putwc(3S)


       NAME
             putwc, putwchar, fputwc - put wide character on a stream

       SYNOPSIS
             #include <stdio.h>
             #include <widec.h>
             wint_t putwc(wint_t c, FILE *stream);
             wint_t putwchar(wint_t c);
             wint_t fputwc(wint_t c, FILE *stream);

       DESCRIPTION
             putwc transforms the wide character c into a multibyte
             character, and writes it to the output stream (at the position
             where the file pointer, if defined, is pointing).  putwchar(c)
             is equivalent to putwc(c, stdout).

             putwc behaves like fputwc, expect that putwc may be
             implemented as a macro that evaluates stream more than once.

          Errors
             On success, these functions return the value they have
             written.  On failure, they return the constant WEOF.  If an
             I/O error occurs, the error indicator is set for the stream.
             If c does not correspond to a valid multibyte character, errno
             will be set to EILSEQ.

       REFERENCES
             fclose(3S), ferror(3S), fopen(3S), fprintf(3S), fread(3S),
             putws(3W), setbuf(3S), stdio(3S), widec(3S)



















                           Copyright 1994 Novell, Inc.               Page 1