Scroll to navigation

FERROR(3) Руководство программиста Linux FERROR(3)

ИМЯ

clearerr, 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).

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

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

СМОТРИТЕ ТАКЖЕ

open(2), fdopen(3), stdio(3), unlocked_stdio(3)

2008-08-29