[ Obsolete | The ECLiPSe Built-In Predicates | Reference Manual | Alphabetic Index ]

get_error_handler(+Number, -PredSpec, -Module)

Returns the error_handler for error number Number and its home module Module.
Number
Integer.
PredSpec
Term which unifies with atom/integer.
Module
Atom or variable.

This built-in predicate is obsolete!

Description

Given the error number Number, PredSpec is unified with the specification (i.e. a term of the form name/arity) of the current handler for error with number Number; Module is unified with its home module.

The errors which exist are implementation defined.

Modes and Determinism

Exceptions

(4) instantiation fault
Number is not instantiated.
(5) type error
Number is not an integer.
(5) type error
PredSpec is neither a variable nor of the form Atom/Integer.
(6) out of range
Number is not a valid error number.

Examples

Success:
   [eclipse]: string_list(S,L).
   instantiation fault in string_list(_g50, _g52)
   [eclipse]: get_error_handler(4,M,N).
   M = error_handler/2
   N = sepia_kernel
   yes.
   [eclipse]: set_event_handler(4,true/0), string_list(S,L).
   > get_error_handler(4,true/0,sepia_kernel).
   S = _g56
   L = _g58
   yes.
Fail:
   get_error_handler(4, error/2, sepia_kernel).

   [eclipse]: set_event_handler(4,true/0),
   > get_error_handler(4,error_handler/2,M).
   no.
Error:
   get_error_handler(N,true/0,sepia_kernel).   (Error 4).
   get_error_handler(5,1.2,sepia_kernel).      (Error 5).
   get_error_handler(5.0,true/0,sepia_kernel). (Error 5).
   get_error_handler(1000,X, sepia_kernel).    (Error 6).
   get_error_handler(-1,X,sepia_kernel).       (Error 6).
   get_error_handler(6,t/0,"sepia_kernel").    (Error 6).



See Also

set_event_handler / 2, error / 2, error / 3, error_id / 2