Linux Man на русском

  User    Syst    Libr    Device    Files    Other    Admin  



   clearerr - проверка и сброс состояния потока

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

Other Alias

feof, ferror, 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.