putwchar(3)                                                 putwchar(3)

  putwc()

  NAME

    fputwc(), putwc(), putwchar() - output a wide-character code to a stream

  SYNOPSIS

    #include 
    #include 

    wint_t fputwc (wchar_t wc, FILE *stream)
    wint_t putwc (wchar_t wc, FILE *stream)
    wint_t putwchar (int wc)

  DESCRIPTION

    The fputwc(3) function writes the wide-character wccode to the output
    stream pointed to by stream.

    The putwc(3) function acts essentially identically to fputwc(3), but is a
    macro that expands in-line. It may evaluate stream more than once, so
    arguments given to putwc(3) should not be expressions with potential side
    effects.

    The putwchar(3) function is identical to putwc(3) with an output stream of
    stdout.

  RETURN VALUES

    The functions, fputwc(3), putwc(3) and putwchar(3) return the wide-
    character code written. If an error occurs, the value WEOF is returned.

  ERRORS

    These functions can set errno to the following values:

    [EAGAIN]
        The O_NONBLOCK flag is set for the file descriptor underlying stream
        and the process would be delayed in the write operation.

    [EBADF]
        The file descriptor underlying stream is not a valid file descriptor
        open for writing.

    [EFBIG]
        An attempt was made to write to a file that exceeds the maximum file
        size or the process' file size limit.

    [EFBIG]
        The file is a regular file and an attempt was made to write at or
        beyond the offset maximum associated with the corresponding stream.

    [EINTR]
        The write operation was terminated due to the receipt of a signal, and
        no data was transferred.

    [EIO]
        A physical I/O error has occurred, or the process is a member of a
        background process group attempting to write to its controlling
        terminal, TOSTOP is set, the process is neither ignoring nor blocking
        SIGTTOU and the process group of the process is orphaned. This error
        may also be returned under implementation-dependent conditions.

    [ENOSPC]
        There was no free space remaining on the device containing the file.

    [EPIPE]
        An attempt is made to write to a pipe or FIFO that is not open for
        reading by any process. A SIGPIPE signal will also be sent to the
        thread.

    These functions may fail if:

    [ENOMEM]
        Insufficient storage space is available.

    [ENXIO]
        A request was made of a non-existent device, or the request was
        outside the capabilities of the device.

    [EILSEQ]
        The wide-character code wc does not correspond to a valid character.

  SEE ALSO

    feof(3)

    ferror(3)

    fopen(3)

    getwc(3)

  USAGE NOTES

    All of these functions are thread safe.

    None of these functions are async-signal safe.