# std::fputc, std::putc

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

Writes a character ch to the given output stream stream.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <cstdio>

int fputc( int ch, std::FILE* stream );
int putc( int ch, std::FILE* stream );
```

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

Internally, the character is converted to `unsigned char` just before being written.

In C, `putc()` may be implemented as a macro, which is disallowed in C++. Therefore, calls to `std::fputc()` and `std::putc()` always have the same effect.

### Parameters

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

### Return value

On success, returns the written character.

On failure, returns `EOF` and sets the *error* indicator (see `std::ferror()`) on `stream`.

### Example

```cpp
#include <cstdio>

int main()
{
    for (char c = 'a'; c != 'z'; c++)
        std::putc(c, stdout);

    // putchar's return value is not equal to the argument
    int r = 0x102A;
    std::printf("\nr = 0x%x\n", r);

    r = std::putchar(r);
    std::printf("\nr = 0x%x\n", r);
}
```

Possible output:

```text
abcdefghijklmnopqrstuvwxy
r = 0x102A
*
r = 0x2A
```

### See also

- [`putchar`](https://en.cppreference.com/w/cpp/io/c/putchar): writes a character to `stdout` (function)
- [C documentation for `fputc, putc`](https://en.cppreference.com/w/c/io/fputc)

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