October 20, 2001 PUTWC 3

### NAME

fputwc, putwc, putwchar, - output a wide-character to a stream

### LIBRARY

Standard C Library (libc, -lc)

### SYNOPSIS

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

### DESCRIPTION

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

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

putwchar(``) is identical to putwc(``) with an output stream of stdout.

### RETURN VALUES

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

### SEE ALSO

ferror(3), fopen(3), getwc(3), stdio(3)

### STANDARDS

The functions fputwc(``), putwc(``), and putwchar(``), conform to ISO/IEC 9899:1999 (``ISO C99'') .