[ 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

- get_error_handler(+, -, -) is det

### 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