Стандартные ошибки

Здесь приведен список наиболее важных символов ошибок в стандартном Emacs, сгруппированных по темам. Для каждого символа указано сообщение и ссылка на описание возможных причин возникновения ошибки.

У каждого символа ошибки есть набор родительских условий ошибки — список символов. Обычно в этот список входят сам символ ошибки и символ error. Иногда в него входят дополнительные символы, представляющие промежуточные классификации, более узкие, чем error, но более широкие, чем отдельный символ ошибки. Например, все ошибки при обращении к файлам имеют условие file-error. Если здесь не указано, что у некоторого символа ошибки есть дополнительные условия ошибки, значит, их нет.

Особое исключение составляют символы ошибок quit и minibuffer-quit: у них нет условия error, поскольку выход из текущего вычисления не считается ошибкой.

Большинство этих символов ошибок определены на C (главным образом в data.c), но некоторые определены на Lisp. Например, файл userlock.el определяет ошибки file-locked и file-supersession. Несколько специализированных библиотек Lisp, распространяемых вместе с Emacs, определяют собственные символы ошибок. Мы не пытаемся перечислить их все здесь.

Объяснение того, как возникают ошибки и как они обрабатываются, см. в разделе Ошибки.

error

Сообщение: «ошибка». См. Ошибки.

quit

Сообщение: «Выход». См. Выход из текущего вычисления.

minibuffer-quit

Сообщение: «Выход». Это подкатегория quit. См. Выход из текущего вычисления.

args-out-of-range

Сообщение: «Аргумент вне диапазона». Эта ошибка возникает при попытке обратиться к элементу за пределами диапазона последовательности, буфера или другого объекта-контейнера. См. Последовательности, массивы и векторы, а также Текст.

arith-error

Сообщение: «Арифметическая ошибка». Эта ошибка возникает при попытке выполнить целочисленное деление на ноль. См. Преобразования чисел, а также Арифметические операции.

beginning-of-buffer

Сообщение: «Начало буфера». См. Перемещение по символам.

buffer-read-only

Сообщение: «Буфер доступен только для чтения». См. Буферы, доступные только для чтения.

circular-list

Сообщение: «Список содержит цикл». Эта ошибка возникает при обнаружении циклической структуры. См. Синтаксис чтения циклических объектов.

cl-assertion-failed

Сообщение: «Проверка утверждения не пройдена». Эта ошибка возникает, когда макрос cl-assert не проходит проверку. См. раздел Утверждения в Расширениях Common Lisp.

coding-system-error

Сообщение: «Недопустимая система кодирования». См. Системы кодирования в Lisp.

cyclic-function-indirection

Сообщение: «Цепочка перенаправлений функции символа содержит цикл». См. Перенаправление функции символа.

cyclic-variable-indirection

Сообщение: «Цепочка перенаправлений переменной символа содержит цикл». См. Псевдонимы переменных.

dbus-error

Сообщение: «Ошибка D-Bus». См. раздел Ошибки и события в Интеграции D-Bus в Emacs.

end-of-buffer

Сообщение: «Конец буфера». См. Перемещение по символам.

end-of-file

Сообщение: «Конец файла во время разбора». Обратите внимание: это не подкатегория file-error, поскольку ошибка относится к программе чтения Lisp, а не к вводу-выводу файлов. См. Функции ввода.

file-already-exists

Это подкатегория file-error. См. Запись в файлы.

permission-denied

Это подкатегория file-error. Она возникает, когда операционная система по какой-либо причине не разрешает Emacs обращаться к файлу или каталогу.

file-date-error

Это подкатегория file-error. Она возникает, когда copy-file не удается установить время последнего изменения выходного файла. См. Изменение имен и атрибутов файлов.

file-error

Мы не перечисляем строки ошибок этой ошибки и ее подкатегорий, поскольку сообщение об ошибке обычно формируется только из элементов данных, если присутствует условие ошибки file-error. Поэтому строки ошибок не очень важны. Однако у этих символов ошибок есть свойства error-message, и если данные не предоставлены, используется свойство error-message. См. Файлы.

file-missing

Это подкатегория file-error. Она возникает, когда операция пытается выполнить действие с отсутствующим файлом. См. Изменение имен и атрибутов файлов.

compression-error

Это подкатегория file-error, возникающая из-за проблем при обработке сжатого файла. См. Как программы выполняют загрузку.

file-locked

Это подкатегория file-error. См. Блокировки файлов.

file-supersession

Это подкатегория file-error. См. Время изменения буфера.

file-notify-error

Это подкатегория file-error. Она возникает, когда изменения файла не удается отслеживать. См. Уведомления об изменениях файлов.

remote-file-error

Это подкатегория file-error, возникающая из-за проблем при обращении к удаленному файлу. См. раздел Удаленные файлы в Руководстве GNU Emacs. Часто эта ошибка появляется, когда таймеры, фильтры процессов, маркеры завершения процессов или другие специальные события пытаются обратиться к удаленному файлу и сталкиваются с другой операцией над удаленным файлом. В целом рекомендуется отправить отчет об ошибке. См. раздел Ошибки в Руководстве GNU Emacs.

ftp-error

Это подкатегория remote-file-error, возникающая из-за проблем при обращении к удаленному файлу по FTP. См. раздел Удаленные файлы в Руководстве GNU Emacs.

invalid-function

Сообщение: «Недопустимая функция». См. Перенаправление функции символа.

invalid-read-syntax

Обычно сообщение: «Недопустимый синтаксис чтения». См. Печатное представление и синтаксис чтения. Эта ошибка также может возникать при выполнении таких команд, как eval-expression, если после выражения есть текст. В этом случае сообщение будет таким: «Лишние символы после выражения».

invalid-regexp

Сообщение: «Недопустимое регулярное выражение». См. Регулярные выражения.

mark-inactive

Сообщение: «Метка сейчас не активна». См. Метка.

no-catch

Сообщение: «Нет обработчика для метки». См. Явные нелокальные выходы: catch и throw.

range-error

Сообщение: Arithmetic range error.

overflow-error

Сообщение: «Ошибка арифметического переполнения». Это подкатегория range-error. Такая ошибка может возникнуть, если целые числа превышают предел integer-width. См. Основы целых чисел.

scan-error

Сообщение: «Ошибка сканирования». Эта ошибка возникает, когда некоторые функции разбора синтаксиса обнаруживают недопустимый синтаксис или несогласованные скобки. По соглашению, при возникновении ошибки передаются три аргумента: понятное пользователю сообщение об ошибке, начало препятствия, через которое нельзя переместиться, и его конец. См. Перемещение через сбалансированные выражения, а также Разбор выражений.

search-failed

Сообщение: «Поиск не удался». См. Поиск и сопоставление.

setting-constant

Сообщение: «Попытка задать значение константному символу». Эта ошибка возникает при попытке присвоить значения nil, t, most-positive-fixnum, most-negative-fixnum и символам ключевых слов. Она также возникает при попытке присвоить значения enable-multibyte-characters и некоторым другим символам, прямое присваивание которым по какой-либо причине запрещено. См. Переменные, которые никогда не меняются.

text-read-only

Сообщение: «Текст доступен только для чтения». Это подкатегория buffer-read-only. См. Свойства с особым значением.

undefined-color

Сообщение: «Неопределенный цвет». См. Названия цветов.

user-error

Сообщение — пустая строка. См. Как сигнализировать об ошибке.

user-search-failed

Эта ошибка похожа на ‘search-failed’, но, как и ‘user-error’, не вызывает отладчик. См. Как сигнализировать об ошибке, а также Поиск и сопоставление. Эта ошибка используется при поиске в файлах Info; см. раздел Поиск текста в Info.

void-function

Сообщение: «Определение функции символа не задано». См. Доступ к содержимому ячейки функции.

void-variable

Сообщение: «Значение символа как переменной не задано». См. Доступ к значениям переменных.

wrong-number-of-arguments

Сообщение: «Неверное число аргументов». См. Особенности списков аргументов.

wrong-type-argument

Сообщение: «Аргумент имеет неверный тип». См. Предикаты типов.

unknown-image-type

Сообщение: «Не удается определить тип изображения». См. Изображения.

inhibited-interaction

Сообщение: «Взаимодействие с пользователем при запрете на него». Эта ошибка сигнализируется, если inhibit-interaction не равно nil и вызывается функция взаимодействия с пользователем (например, read-from-minibuffer).