6.23.9 fputwc Function

Writes a wide character to a stream.

Include

<wchar.h>

Prototype

wint_t fputwc(wchar_t c, FILE * stream);

Arguments

c

the wide character to write

stream

the stream to write to

Return Value

The function returns a copy of the wide character written. If a write or encoding error occurs, WEOF is returned.

Remarks

The function writes the wide character, c, to the output stream pointed to by stream and at the position indicated by the file position indicator for the stream (if defined), advancing the indicator appropriately. If positioning within the file is not supported or if the stream was opened with append mode, the character is appended to the output stream.

The error indicator for the stream will be set on a write error. If an encoding error occurs, errno is set to the value of the EILSEQ macro.

Example

#include <wchar.h>
#include <stdio.h>

int main(void)
{
  FILE * myfile;
  wint_t wc;

  if ((myfile = fopen("afile", "w")) == NULL)
    wprintf(L"Cannot open afile\n");
  else
  {
    for(wc = L'0'; iswdigit(wc); wc++)
      fputwc(wc, myfile);
    fputwc(L'\n', myfile);
    fclose(myfile);
  }
}

Example Output

Content of afile.

0123456789