Стандартная библиотека 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 <stdio.h>
#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преобразования в удобочитаемое сообщение об ошибке.

Примечания

  1. Потокобезопасность: В многопоточных программах,errnoОбычно он реализуется как локальное хранилище потока (Thread-Local Storage, TLS), чтобы гарантировать, что каждый поток имеет независимый код ошибки.
  2. Начальное значениеВ случае успешного вызова библиотечные функции обычно не изменяютerrnoзначение. Поэтому перед проверкой ошибки следует убедитьсяerrnoустанавливается в 0.
  3. Диапазон кодов ошибокРазличные операционные системы и реализации стандартной библиотеки C могут определять дополнительные коды ошибок. Программы должны избегать зависимости от числовых значений конкретных кодов ошибок.

Рекомендации по обработке ошибок

  1. Проверяйте возвращаемое значениеПри вызове функции, которая может завершиться неудачно, всегда проверяйте её возвращаемое значение.
  2. Настройкаerrnoравно 0: Перед вызовом функции можно установитьerrnoустановить в 0, чтобы его можно было проверить после вызова.errno, изменился ли он.
  3. Использованиеstrerror: черезstrerrorбудетerrnoПреобразуйте его в удобочитаемую строку, чтобы облегчить отладку и ведение журнала.

Короче говоря,<errno.h>Он предоставляет стандартизированный способ сообщать об ошибках и обрабатывать их в программе, делая код обработки ошибок более единообразным и удобным в сопровождении.

Библиотечные макросы

Ниже перечислены макросы, определённые в заголовочном файле errno.h:

Порядковый номерМакрос & Описание
1extern int errno
Это макрос, устанавливаемый через системные вызовы; при ошибках некоторые библиотечные функции указывают, какая ошибка произошла.
2EDOM — ошибка области определения
Этот макрос представляет ошибку области определения, которая возникает, когда входной аргумент находится вне области определения, заданной математической функцией; errno устанавливается в EDOM.
3ERANGE — ошибка диапазона
Этот макрос представляет ошибку диапазона, которая возникает, когда входной аргумент превышает диапазон, заданный математической функцией; errno устанавливается в ERANGE.
Другие расширения