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:bad-alloc

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

Octave:invalid-context

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

Octave:invalid-fun-call

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

Octave:invalid-indexing

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

Octave:invalid-input-arg

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

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.