# std::fputwc

> C++ Atlas: `cppatlas.com/w/cpp/io/c/fputwc` | Source: https://en.cppreference.com/w/cpp/io/c/fputwc | Domain: Input/output

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

## Official Specification Summary (cppreference)

```cpp
// Defined in header <cwchar>
std::wint_t fputwc( wchar_t ch, std::FILE* stream ); // (1)
std::wint_t putwc( wchar_t ch, std::FILE* stream ); // (2)
```

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.

### Parameters

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

### Return value

`ch` on success, `WEOF` on failure. If an encoding error occurs, `errno` is set to `EILSEQ`.

### Example

```cpp
#include <cerrno>
#include <clocale>
#include <cstdio>
#include <cstdlib>
#include <cwchar>
#include <initializer_list>

int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");

    for (const wchar_t ch :
    {
        L'\u2200', // Unicode name: "FOR ALL"
        L'\n',
        L'∀',
    })
    {
        if (errno = 0; std::fputwc(ch, stdout) == WEOF)
        {
            std::puts(errno == EILSEQ
                ? "Encoding error in fputwc"
                : "I/O error in fputwc"
            );
            return EXIT_FAILURE;
        }
    }
    return EXIT_SUCCESS;
}
```

Possible output:

```text
∀
∀
```

### See also

- [`fputc`](https://en.cppreference.com/w/cpp/io/c/fputc), [`putc`](https://en.cppreference.com/w/cpp/io/c/fputc): writes a character to a file stream (function)
- [`fputws`](https://en.cppreference.com/w/cpp/io/c/fputws): writes a wide string to a file stream (function)
- [`fgetwc`](https://en.cppreference.com/w/cpp/io/c/fgetwc), [`getwc`](https://en.cppreference.com/w/cpp/io/c/fgetwc): gets a wide character from a file stream (function)
- [C documentation for `fputwc`](https://en.cppreference.com/w/c/io/fputwc)

---
Attribution: content from https://en.cppreference.com/w/cpp/io/c/fputwc (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.