C getc() function

C library function - getc()

This getc() function is used to read one unsigned character from the input stream at the current position and increases the file pointer, if any, so that it points to the next character in the input stream.

Syntax:

int getc(FILE *stream)

Parameters:

Return value

• Upon successful completion, getc() shall return the next byte from the input stream pointed to by stream.
• If the end-of-file indicator for the stream is set, or if the stream is at end-of-file, the end-of-file indicator for the stream shall be set and getc() shall return EOF.
• If a read error occurs, the error indicator for the stream shall be set, getc() shall return EOF, and shall set errno to indicate the error.

Example: getc() function

In this example, a line of input is gathered from a stream.

#include <stdio.h>
 
#define  MAX_LEN  80
 
int main(void)
{
   FILE *fp;
   char buffer[MAX_LEN + 1];
   int i, ch;
   
    // Write some text in test.txt
    char str[] = "C Programming Tutorial and Exercises.";
    fp = fopen( "test.txt" , "w" );
    fwrite(str , 1 , sizeof(str) , fp );
    fclose(fp); 
    
   fp = fopen("test.txt","r");
 
   for (i = 0; (i < (sizeof(buffer)-1) &&
         ((ch = fgetc(fp)) != EOF) && (ch != '\n')); i++)
      buffer[i] = ch;
 
   buffer[i] = '\0';
 
   if (fclose(fp))
      perror("fclose error");
 
   printf("Text in the said file:\n%s\n", buffer);
}

Output:

Text in the said file:
C Programming Tutorial and Exercises.

C Programming Code Editor:

Previous C Programming: C fputs()
Next C Programming: C putc()