12.1.2 Обработка ошибок

При возникновении ошибки она может быть обнаружена и обработана с помощью оператора try, как описано в Операторе try. В качестве примера, следующий фрагмент кода подсчитывает количество ошибок, возникающих во время цикла for.

number_of_errors = 0;
for n = 1:100
  try
    …
  catch
    number_of_errors++;
  end_try_catch
endfor

В приведенном выше примере все ошибки обрабатываются одинаково. Однако во многих ситуациях необходимо различать ошибки и принимать разные действия в зависимости от ошибки. Функция lasterror возвращает структуру, содержащую информацию о последней произошедшей ошибке. В качестве примера, код выше можно изменить, чтобы подсчитывать количество ошибок, связанных с оператором ‘*’.

number_of_errors = 0;
for n = 1:100
  try
    …
  catch
    msg = lasterror.message;
    if (strfind (msg, "operator *"))
      number_of_errors++;
    endif
  end_try_catch
endfor

В качестве альтернативы, результат работы функции lasterror может быть получен в переменной, указанной непосредственно после ключевого слова catch, как показано в примере ниже, демонстрирующем перенаправление ошибки в предупреждение:

try
  …
catch err
  warning(err.identifier, err.message);
  …
end_try_catch

lasterr = lasterror ()

lasterror (err)

lasterror ("reset")

Запрос или установка структуры последнего сообщения об ошибке.

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

message

Текст последнего сообщения об ошибке

identifier

Идентификатор сообщения об ошибке

stack

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

file

Имя файла, в котором произошла ошибка

name

Имя функции, в которой произошла ошибка

line

Номер строки, в которой произошла ошибка

column

Необязательное поле с номером столбца, в котором произошла ошибка

Структура последней ошибки может быть установлена, передав скалярную структуру, err, в качестве входных данных. Любые поля err, совпадающие с вышеперечисленными, устанавливаются, а любые не указанные поля инициализируются значениями по умолчанию.

Если lasterror вызывается с аргументом "reset", все поля устанавливаются в значения по умолчанию.

См. также: lasterr, error, lastwarn.

[msg, msgid] = lasterr ()

lasterr (msg)

lasterr (msg, msgid)

Запрос или установка последнего сообщения об ошибке.

При вызове без входных аргументов возвращает последнее сообщение об ошибке и идентификатор сообщения.

С одним аргументом устанавливает последнее сообщение об ошибке в msg.

С двумя аргументами также устанавливает идентификатор последнего сообщения.

См. также: lasterror, error, lastwarn.

Следующий пример подсчитывает ошибки индексирования. Ошибки ловятся с использованием идентификатора поля структуры, возвращаемой функцией lasterror.

number_of_errors = 0;
for n = 1:100
  try
    …
  catch
    id = lasterror.identifier;
    if (strcmp (id, "Octave:invalid-indexing"))
      number_of_errors++;
    endif
  end_try_catch
endfor

Функции, поставляемые с Octave, могут выдавать следующие ошибки.

Octave:invalid-context

Указывает, что ошибка была сгенерирована операцией, которая не может быть выполнена в области видимости, из которой она была вызвана. Например, функция print_usage () при вызове из командной строки Octave генерирует эту ошибку.

Octave:invalid-input-arg

Указывает, что функция была вызвана с недопустимыми входными аргументами.

Octave:invalid-fun-call

Указывает, что функция была вызвана неправильным способом, например, неправильное количество входных аргументов.

Octave:invalid-indexing

Указывает, что тип данных был индексирован неправильно, например, целое значение индекса для массивов, несуществующее поле структуры.

Octave:bad-alloc

Указывает, что память не могла быть выделена.

Octave:undefined-function

Указывает вызов функции, которая не определена. Функция может существовать, но Octave не может найти ее в пути поиска.

После обработки ошибки её можно снова сгенерировать. Это может быть полезно, когда нужно обнаружить ошибку, но программа должна всё равно прерваться. Это возможно с помощью функции rethrow. Предыдущий пример можно изменить, чтобы подсчитывать количество ошибок, связанных с оператором ‘*’, но всё равно прерывать выполнение при возникновении другого типа ошибки.

number_of_errors = 0;
for n = 1:100
  try
    …
  catch
    msg = lasterror.message;
    if (strfind (msg, "operator *"))
      number_of_errors++;
    else
      rethrow (lasterror);
    endif
  end_try_catch
endfor

rethrow (err)

Повторно выдать предыдущую ошибку, определённую err.

err - это структура, которая должна содержать по крайней мере поля "message" и "identifier". err также может содержать поле "stack", которое даёт информацию о предполагаемом месте возникновения ошибки. Как правило, err возвращается из lasterror.

См. также: lasterror, lasterr, error.

err = errno ()

err = errno (val)

err = errno (name)

Запрос или установка системной переменной errno.

При вызове без входных аргументов возвращает текущее значение errno.

При вызове с числовым аргументом val, устанавливает текущее значение errno на указанное значение. Предыдущее значение errno возвращается как err.

При вызове со строковым аргументом name, возвращает числовое значение errno, соответствующее указанному коду ошибки. Если name не является распознанным кодом ошибки, возвращается -1.

См. также: errno_list.

errno_list ()

Возвращает структуру, содержащую системные значения errno.

См. также: errno.