Стандартная библиотека C —<errno.h>
Введение
из стандартной библиотеки Cerrno.hЭтот заголовочный файл определяет целочисленную переменнуюerrnoОна устанавливается через системные вызовы; при возникновении ошибок некоторые библиотечные функции указывают, какая ошибка произошла. Этот макрос раскрывается в изменяемое lvalue типа int, поэтому программа может его читать и изменять.
<errno.h>является заголовочным файлом в стандартной библиотеке C, который предоставляет механизм для сообщения об ошибках и их обработки в программах. Этот заголовочный файл определяет макросы и переменные для указания и описания типов ошибок времени выполнения.
errno.hЗаголовочный файл определяет ряд макросов, представляющих различные коды ошибок; эти макросы должны раскрываться в выражения типаint, которые являются целочисленными константными выражениями.
errnoЭто глобальная переменная, используемая для хранения последнего кода ошибки. Тип этой переменной —intКогда библиотечная функция сталкивается с ошибкой, она обычно устанавливаетerrnoдля указания типа ошибки.
Например, в файловых операциях, еслиfopenКогда функция завершается с ошибкой из-за отсутствия файла, она установитerrnoУстановить вENOENT。
Распространённые коды ошибок
Ниже приведены некоторые распространённые коды ошибок; они<errno.h>определены как макросы в:
EPERM: Операция не разрешенаENOENT: Нет такого файла или каталогаESRCH: Нет такого процессаEINTR: Прерванный системный вызовEIO: Ошибка ввода/выводаENXIO: Нет такого устройства или адресаE2BIG: Слишком длинный список аргументовENOMEM: Недостаточно памятиEACCES: Доступ запрещёнEFAULT: Неверный адресEBUSY: Ресурс занятEEXIST: Файл существуетEXDEV: Ссылка между устройствамиENODEV: Нет такого устройстваENOTDIR: Не является каталогомEISDIR: Является каталогомEINVAL: Недопустимый аргументENFILE: Переполнение системной таблицы файловEMFILE: Слишком много открытых файловENOTTY: Не является терминальным устройствомETXTBSY: Текстовый файл занятEFBIG: Файл слишком большойENOSPC: На устройстве не осталось местаESPIPE: Недопустимая адресацияEROFS: Файловая система только для чтенияEMLINK: Слишком много ссылокEPIPE: Обрыв канала
Примеры использования
Ниже приведён простой пример использования errno, демонстрирующий, как обрабатывать ошибки открытия файла:
Пример
#include <errno.h>
#include <string.h>
int main() {
FILE *file = fopen("nonexistent_file.txt", "r");
if (file == NULL) {
printf("Ошибка открытия файла: %s\n", strerror(errno));
return 1;
}
// Код обработки файлов
fclose(file);
return 0;
}
В этом примере, еслиfopenФункция завершается с ошибкой,errnoбудет установлен соответствующий код ошибки.strerrorФункция используется дляerrnoпреобразования в удобочитаемое сообщение об ошибке.
Примечания
- Потокобезопасность: В многопоточных программах,
errnoОбычно он реализуется как локальное хранилище потока (Thread-Local Storage, TLS), чтобы гарантировать, что каждый поток имеет независимый код ошибки. - Начальное значениеВ случае успешного вызова библиотечные функции обычно не изменяют
errnoзначение. Поэтому перед проверкой ошибки следует убедитьсяerrnoустанавливается в 0. - Диапазон кодов ошибокРазличные операционные системы и реализации стандартной библиотеки C могут определять дополнительные коды ошибок. Программы должны избегать зависимости от числовых значений конкретных кодов ошибок.
Рекомендации по обработке ошибок
- Проверяйте возвращаемое значениеПри вызове функции, которая может завершиться неудачно, всегда проверяйте её возвращаемое значение.
- Настройка
errnoравно 0: Перед вызовом функции можно установитьerrnoустановить в 0, чтобы его можно было проверить после вызова.errno, изменился ли он. - Использование
strerror: черезstrerrorбудетerrnoПреобразуйте его в удобочитаемую строку, чтобы облегчить отладку и ведение журнала.
Короче говоря,<errno.h>Он предоставляет стандартизированный способ сообщать об ошибках и обрабатывать их в программе, делая код обработки ошибок более единообразным и удобным в сопровождении.
Библиотечные макросы
Ниже перечислены макросы, определённые в заголовочном файле errno.h:
| Порядковый номер | Макрос & Описание |
|---|---|
| 1 | extern int errno Это макрос, устанавливаемый через системные вызовы; при ошибках некоторые библиотечные функции указывают, какая ошибка произошла. |
| 2 | EDOM — ошибка области определения Этот макрос представляет ошибку области определения, которая возникает, когда входной аргумент находится вне области определения, заданной математической функцией; errno устанавливается в EDOM. |
| 3 | ERANGE — ошибка диапазона Этот макрос представляет ошибку диапазона, которая возникает, когда входной аргумент превышает диапазон, заданный математической функцией; errno устанавливается в ERANGE. |