ferror(3) проверка и сброс состояния потока

Other Alias

clearerr, feof, fileno

ОБЗОР

#include <stdio.h>

void clearerr(FILE *stream);

int feof(FILE *stream);

int ferror(FILE *stream);

int fileno(FILE *stream);

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

fileno(): _POSIX_C_SOURCE >= 1 || _XOPEN_SOURCE || _POSIX_SOURCE

ОПИСАНИЕ

Функция clearerr() очищает индикаторы конца файла и ошибки потока, указанного в stream.

Функция feof() проверяет индикатор конца файла для потока, указанного в stream, возвращая при этом ненулевое значение, если индикатор установлен. Индикатор конца файла может быть очищен только функцией clearerr().

Функция ferror() проверяет индикатор ошибки для потока, указанного в stream, возвращая при этом ненулевое значение, если индикатор установлен. Индикатор ошибки может быть очищен только функцией clearerr().

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

Неблокирующие аналоги смотрите в unlocked_stdio(3).

ОШИБКИ

Данные функции не должны завершаться с ошибкой и поэтому не устанавливают значение внешней переменной errno (тем не менее, в случае с fileno(), если аргумент не является корректным потоком, возвращается -1 и errno приравнивается значение EBADF).

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).
ИнтерфейсАтрибутЗначение
clearerr(), feof(),
ferror(), fileno()
безвредность в нитяхбезвредно (MT-Safe)

СООТВЕТСТВИЕ СТАНДАРТАМ

Функции clearerr(), feof() и ferror() соответствует стандартам C89, C99, POSIX.1-2001 и POSIX.1-2008.

Функция fileno() соответствует POSIX.1-2001 и POSIX.1-2008.