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

ОПИСАНИЕ

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

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

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

Функция fileno() исследует параметр stream и возвращает целочисленный файловый дескриптор, который используется для реализации этого потока. Файловый дескриптор продолжает принадлежать stream и будет закрыт при вызове fclose(3). Сделайте копию файлового дескриптора с помощью dup(2) перед передачей его коду, который может его закрыть.

Неблокирующие аналоги смотрите в 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.

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

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

2019-03-06