ferrorferror

Проверяет наличие ошибок в потоке.Tests for an error on a stream.

СинтаксисSyntax

int ferror(
   FILE *stream
);

ПараметрыParameters

вышестоящийstream
Указатель на структуру FILE.Pointer to FILE structure.

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

Если в потоке не возникла ошибка, ferror возвращает 0.If no error has occurred on stream, ferror returns 0. В противном случае возвращается ненулевое значение.Otherwise, it returns a nonzero value. Если Stream имеет значение NULL, ferror вызывает обработчик недопустимого параметра, как описано в разделе Проверка параметров.If stream is NULL, ferror invokes the invalid parameter handler, as described in Parameter Validation. Если выполнение может быть продолжено, эта функция устанавливает еинвал и возвращает 0.If execution is allowed to continue, this function sets errno to EINVAL and returns 0.

Дополнительные сведения об этих и других кодах ошибок см. в разделе _doserrno, errno, _sys_errlist и _sys_nerr.See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these, and other, error codes.

КомментарииRemarks

Подпрограммы ferror (реализованные как функция и как макрос) выполняют тесты для чтения или записи ошибок в файле, связанном с потоком.The ferror routine (implemented both as a function and as a macro) tests for a reading or writing error on the file associated with stream. Если произошла ошибка, индикатор ошибки для потока остается установленным до тех пор, пока поток не будет закрыт или перевернут, или пока не будет вызван клеарерр .If an error has occurred, the error indicator for the stream remains set until the stream is closed or rewound, or until clearerr is called against it.

По умолчанию глобальное состояние этой функции ограничивается приложением.By default, this function's global state is scoped to the application. Чтобы изменить это, см. раздел глобальное состояние в CRT.To change this, see Global state in the CRT.

ТребованияRequirements

ФункцияFunction Обязательный заголовокRequired header
ferrorferror <stdio.h>

Дополнительные сведения о совместимости см. в статье Compatibility.For additional compatibility information, see Compatibility.

ПримерExample

См. пример для feof.See the example for feof.

См. также разделSee also

Обработка ошибокError Handling
Потоковый ввод-выводStream I/O
clearerrclearerr
_eof_eof
feoffeof
fopen, _wfopenfopen, _wfopen
perror, _wperrorperror, _wperror