getc : read a character (macro)

Synopsis

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

getc is a macro, defined in stdio.h. You can use getc to get the next single character from the file or stream identified by fp. As a side effect, getc advances the file's current position indicator.

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

The next character (read as an unsigned char, and cast to int), unless there is no more data, or the host system reports a read error; in either of these situations, getc returns EOF.

You can distinguish the two situations that cause an EOF result by using the ferror and feof functions.

---

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