src/Pure/ML-Systems/ml_debugger.ML
author wenzelm
Thu, 06 Aug 2015 11:46:47 +0200
changeset 60852 1c51a2ca8204
parent 60745 d86b4cd0f1ec
child 60853 b0627cb2e08d
permissions -rw-r--r--
clarified signature, to make debugger.ML compile with current official ML versions;
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
60745
d86b4cd0f1ec clarified ML compiler parameters: always provide PolyML.Compiler.CPDebug, ignore global default;
wenzelm
parents: 60744
diff changeset
     1
(*  Title:      Pure/ML/ml_debugger.ML
60729
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
     2
    Author:     Makarius
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
     3
60745
d86b4cd0f1ec clarified ML compiler parameters: always provide PolyML.Compiler.CPDebug, ignore global default;
wenzelm
parents: 60744
diff changeset
     4
ML debugger interface.
60729
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
     5
*)
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
     6
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
     7
signature ML_DEBUGGER =
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
     8
sig
60852
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
     9
  val on_entry: (string * 'a -> unit) option -> unit
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    10
  val on_exit: (string * 'a -> unit) option -> unit
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    11
  val on_exit_exception: (string * 'a -> exn -> unit) option -> unit
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    12
  val on_breakpoint: ('a * bool Unsynchronized.ref -> unit) option -> unit
60729
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    13
  type state
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    14
  val state: Thread.thread -> state list
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    15
  val debug_function: state -> string
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    16
  val debug_function_arg: state -> ML_Name_Space.valueVal
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    17
  val debug_function_result: state -> ML_Name_Space.valueVal
60852
1c51a2ca8204 clarified signature, to make debugger.ML compile with current official ML versions;
wenzelm
parents: 60745
diff changeset
    18
  val debug_location: state -> 'a
60729
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    19
  val debug_name_space: state -> ML_Name_Space.T
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    20
end;
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    21
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    22
structure ML_Debugger: ML_DEBUGGER =
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    23
struct
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    24
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    25
(* hooks *)
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    26
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    27
type location = unit;
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    28
fun on_entry _ = ();
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    29
fun on_exit _ = ();
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    30
fun on_exit_exception _ = ();
60744
4eba53a0ac3d report possible breakpoint positions;
wenzelm
parents: 60730
diff changeset
    31
fun on_breakpoint _ = ();
60729
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    32
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    33
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    34
(* debugger *)
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    35
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    36
fun fail () = raise Fail "No debugger support on this ML platform";
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    37
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    38
type state = unit;
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    39
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    40
fun state _ = [];
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    41
fun debug_function () = fail ();
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    42
fun debug_function_arg () = fail ();
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    43
fun debug_function_result () = fail ();
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    44
fun debug_location () = fail ();
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    45
fun debug_name_space () = fail ();
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    46
f5989a2c1f67 ML debugger interface;
wenzelm
parents:
diff changeset
    47
end;