getc()

Считать следующий символ из файла

Прототип:

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

Аргументы:

fp

Поток, из которого требуется считать символ.

Библиотека:

libc

Описание:

Макрос getc() считывает следующий символ из потока fp. Символ возвращается как целочисленное значение value.

Возвращаемое значение:

Следующий символ из потока fp, приведенный к типу (int)(unsigned char).

Если возникла ошибка или достигнут конец файла, функция возвращает EOF, код ошибки записывается в errno.

---

Используйте feof() или ferror() для того, чтобы отличать достижение конца файла от ошибки.

---

Примеры:

#include <stdio.h>
#include <stdlib.h>
                                       
int main( void )
{
    FILE *fp;
    int  c;
                                       
    fp = fopen( "file", "r" );
    if ( fp != NULL )
    {
        while ( (c = getc( fp )) != EOF )
        {
            putchar( c );
        }
                                       
        fclose( fp );
            
        return (EXIT_SUCCESS);
    }
        
    return (EXIT_FAILURE);
}

Классификация:

ANSI, POSIX 1003.1

Безопасность использования

Точка остановки потока

Да

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Да

Предостережения:

getc() является макросом.

Тематические ссылки:

errno, feof(), ferror(), fgetc(), fgetchar(), fgets(), fopen(), getchar(), gets(), putc(), putc_unlocked(), putchar(), putchar_unlocked(), ungetc()

Предыдущий раздел: Описание API системной библиотеки