fgetc()

Считать символ из потока

Прототип:

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

Аргументы:

fp

Поток, из которого необходимо считать символ.

Библиотека:

libc

Описание:

Функция fgetc() считывает следующий символ из потока, определяемого fp.

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

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

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

---

Необходимо использовать feof() или ferror() для определения, достигнут ли конец файла или произошла ошибка.

---

Коды ошибок:

EAGAIN

Флаг O_NONBLOCK установлен для потока fp и будет заблокирован данной операцией.

EBADF

Поток, определенный fp, недоступен для чтения.

EINTR

Сигнал прервал операцию чтения; данные не будут переданы.

EIO

Одна из следующих причин:

• Возникла физическая ошибка ввода/вывода.
• Процесс, являющийся членом группы фоновых процессов, пытается читать из управляющего терминала, TOSTOP установлен, процесс ни игнорирует, ни блокирует SIGTTOU, группа процеса является осиротевшей.
• (расширение ЗОСРВ «Нейтрино») Файловая система находится на съемном устройстве, и это устройство было принудительно извлечено.

ENOMEM

Недостаточно свободного места.

ENXIO

Запрос был сделан от лица несуществующего устройства, либо запрос лежит вне возможностей устройства.

EOVERFLOW

Файл является обычным файлом, и произошла попытка выполнить чтение с максимальным смещением или за пределы потока.

Примеры:

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

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

ANSI, POSIX 1003.1

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

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

Да

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

Нет

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

Нет

В потоке

Да

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

errno, feof(), ferror(), fgetchar(), fgets(), fopen(), fputc(), getc(), gets(), ungetc()

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