putwchar(3W) — DG/UX R4.11



putwc(3W)                         SDK R4.11                        putwc(3W)


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

SYNOPSIS
       #include <stdio.h>
       #include <wchar.h>
       wintt putwc(wintt c, FILE *stream);
       wintt putwchar(wintt c);
       wintt fputwc(wintt 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.

   Considerations for Threads Programming
                     +---------+-----------------------------+
                     |         |                      async- |
                     |function | reentrant   cancel   cancel |
                     |         |             point     safe  |
                     +---------+-----------------------------+
                     |fputwc   |     Y         N        N    |
                     |putwc    |     Y         N        N    |
                     |putwchar |     Y         N        N    |
                     +---------+-----------------------------+
REFERENCES
       reentrant(3), fclose(3S), ferror(3S), fopen(3S), fread(3S),
       printf(3S), setbuf(3S), stdio(3S), putws(3W)


Licensed material--property of copyright holder(s)
Museum
