Error Handler for Chartlib

Author(s): Isabel Martín García.

This module is an error handler. If the format of the arguments is not correct in a call to a chartlib predicate an exception will be thrown . You can wrap the chartlib predicates with the predicates exported by this module to handle automatically the errors if any.


Usage and interface

Documentation on exports

PREDICATE
chartlib_text_error_protect(G)

This predicate catches the thrown exception and sends it to the appropiate handler. The handler will show the error message in the standard output.

Usage:

  • The following properties should hold at call time:
    (basic_props:callable/1)G is a term which represents a goal, i.e., an atom or a structure.
Meta-predicate with arguments: chartlib_text_error_protect(goal).

PREDICATE
chartlib_visual_error_protect(G)

This predicate catches the thrown exception and sends it to the appropiate handler. The handler will pop up a message box.

Usage:

  • The following properties should hold at call time:
    (basic_props:callable/1)G is a term which represents a goal, i.e., an atom or a structure.
Meta-predicate with arguments: chartlib_visual_error_protect(goal).

Documentation on internals

REGTYPE
handler_type(X)

The library chartlib includes two error handlers already programmed.

handler_type(text).
handler_type(visual).

PREDICATE
error_message(ErrorCode,ErrorMessage)

Binds the error code with its corresponding text message.

Usage:

  • The following properties should hold at call time:
    (basic_props:atm/1)ErrorCode is an atom.
    (basic_props:atm/1)ErrorMessage is an atom.

PREDICATE
error_file(ErrorCode,ErrorFile)

Binds the error code with its corresponding script error file.

Usage:

  • The following properties should hold at call time:
    (basic_props:atm/1)ErrorCode is an atom.
    (basic_props:atm/1)ErrorFile is an atom.