37.4.4 Отсутствующие компоненты

Если пакет зависит от компонента, например другого пакета Octave, который может отсутствовать, может быть полезно установить функцию, которая сообщает пользователям, что делать в случае отсутствия определённого компонента. Функцию должен написать сопровождающий пакета и зарегистрировать её в Octave с помощью missing_component_hook.

: val = missing_component_hook ()

: old_val = missing_component_hook (new_val)

: old_val = missing_component_hook (new_val, "local")

Запросить или задать внутреннюю переменную, указывающую функцию, которую следует вызвать при отсутствии компонента Octave.

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

При вызове из функции с параметром "local" переменная изменяется локально для этой функции и всех вызываемых ею подпрограмм. Исходное значение переменной восстанавливается при выходе из функции.

Ожидается, что функция-перехватчик будет иметь следующий вид:

fcn (component)

Octave вызовет fcn, передав ей имя функции, которой требуется компонент, и строку с описанием отсутствующего компонента. Функция-перехватчик должна возвращать сообщение об ошибке для отображения.

См. также: missing_function_hook.