Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

std::putchar

Writes a character ch to stdout. Internally, the character is converted to unsigned char just before being written.

NotebookLM
Defined in header <cstdio>
int putchar( int ch );

Writes a character ch to stdout. Internally, the character is converted to unsigned char just before being written.

Equivalent to std::putc(ch, stdout).

Parameters

ch - character to be written

Return value

On success, returns the written character.

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

Example

example.cpp
#include <cstdio>
 
int main()
{
    for (char c = 'a'; c != 'z'; ++c)
        std::putchar(c);
 
    // putchar return value is not equal to the argument
    int r = 0x1024;
    std::printf("\nr = 0x%x\n", r);
    r = std::putchar(r);
    std::printf("\nr = 0x%x\n", r);
}
Possible output
abcdefghijklmnopqrstuvwxy
r = 0x1024
$
r = 0x24

See also

writes a character to a file stream
(function)
C documentation for putchar

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.