putc : write a character (macro)

Synopsis

#include <stdio.h>
int putc(int ch, FILE *fp);
```### Description

putc is a macro, defined in stdio.h. putc writes the argument ch to the file or stream identified by fp, after converting it from an int to an unsigned char.

If the file was opened with append mode (or if the stream cannot support positioning), then the new character goes at the end of the file or stream. Otherwise, the new character is written at the current value of the position indicator, and the position indicator advances by one.

For a subroutine version of this macro, see fputc.### Returns

If successful, putc returns its argument ch. If an error intervenes, the result is EOF. You can use `ferror(fp)' to query for errors.

---

**Authoritative source**: BUSMASTER DITA help source `putc.dita`, compiled into `BUSMASTER.CHM` with the application.