fputwc, putwc

< c‎ | io
File input/output
Types and objects
File access
Direct input/output
Unformatted input/output
Formatted input
Defined in header <wchar.h>
wint_t fputwc( wchar_t ch, FILE* stream );
(1) (since C95)
wint_t putwc( wchar_t ch, FILE* stream );
(2) (since C95)

Writes a wide character ch to the given output stream stream.

2) May be implemented as a macro and may evaluate stream more than once.


[edit] Parameters

ch - wide character to be written
stream - the output stream

[edit] Return value

Returns a copy of ch on success.

On failure, returns WEOF and sets the error indicator (see ferror()) on stream.

If an encoding error occurred, additionally sets errno to EILSEQ.

[edit] Example

#include <errno.h>
#include <locale.h>
#include <stdio.h>
#include <stdlib.h>
#include <wchar.h>
int main(void)
    setlocale(LC_ALL, "en_US.utf8");
    errno = 0;
    if (fputwc(L'🍌', stdout) == WEOF)
        if (errno == EILSEQ)
            puts("Encoding error in fputwc.");
            puts("I/O error in fputwc.");
        return EXIT_FAILURE;

Possible output:


[edit] References

  • C23 standard (ISO/IEC 9899:2024):
  • The fputwc function (p: 430)
  • The putwc function (p: 431-432)
  • C17 standard (ISO/IEC 9899:2018):
  • The fputwc function (p: 308)
  • The putwc function (p: 310)
  • C11 standard (ISO/IEC 9899:2011):
  • The fputwc function (p: 422-423)
  • The putwc function (p: 424)
  • C99 standard (ISO/IEC 9899:1999):
  • The fputwc function (p: 368)
  • The putwc function (p: 370)

[edit] See also

writes a character to a file stream
(function) [edit]
writes a wide string to a file stream
(function) [edit]
gets a wide character from a file stream
(function) [edit]