putwc(3S)

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, except 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 EILSEN.

These functions will fail if the file is a regular file and an attempt is made to write at or beyond the offset maximum associated with the corresponding stream.

References

fclose(3S), ferror(3S), fopen(3S), fprintf(3S), fread(3S), intro(3), Intro(3S), putws(3wide), setbuf(3S), widec(3S)