std::fputc,std::putc(3)

NAME
std::fputc,std::putc - std::fputc,std::putc

Synopsis
   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
// Run this code
 #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:
 abcdefghijklmnopqrstuvwxy
 r = 0x102A
 *
 r = 0x2A

See also
   putchar writes a character to stdout
           (function)
   C documentation for
   fputc,
   putc