MLtonExn

MLton

signature MLTON_EXN =
   sig
      val addExnMessager: (exn -> string option) -> unit
      val history: exn -> string list

      val defaultTopLevelHandler: exn -> 'a
      val getTopLevelHandler: unit -> (exn -> unit)
      val setTopLevelHandler: (exn -> unit) -> unit
      val topLevelHandler: exn -> 'a
   end

addExnMessager f

adds f as a pretty-printer to be used by General.exnMessage for converting exceptions to strings. Messagers are tried in order from most recently added to least recently added.
history e

returns call stack at the point that e was first raised. Each element of the list is a file position. The elements are in reverse chronological order, i.e. the function called last is at the front of the list.

history e will return [] unless the program is compiled with -const 'Exn.keepHistory true'.
defaultTopLevelHandler e

function that behaves as the default top level handler; that is, print out the unhandled exception message for e and exit.
getTopLevelHandler ()

get the top level handler.
setTopLevelHandler f

set the top level handler to the function f. The function f should not raise an exception or return normally.
topLevelHandler e

behaves as if the top level handler received the exception e.