std::putchar

< cpp‎ | io‎ | c
 
 
Input/output library
I/O manipulators
C-style I/O
Buffers
(deprecated in C++98)
Streams
Abstractions
File I/O
String I/O
Array I/O
(deprecated in C++98)
(deprecated in C++98)
(deprecated in C++98)
Synchronized Output
Types
Error category interface
(C++11)
 
 
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 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 ferror()) on stdout.

Example

#include <cstdio>
 
int main()
{
    for (char c = 'a'; c != 'z'; c++)
        std::putchar(c);
    std::putchar('\n');
 
    // putchar return value is not equal to the argument
    int r = 0x1070;
    std::printf("\n0x%x\n", r);
    r = std::putchar(r);
    std::printf("\n0x%x\n", r);
}

Output:

abcdefghijklmnopqrstuvwxy
0x1070
p
0x70

See also

writes a character to a file stream
(function)