std::fputc,std::putc (3) - Linux Man Pages

std::fputc,std::putc: std::fputc,std::putc

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);
      std::putc('\n', stdout);


      // 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 stdout
putchar (function)