summaryrefslogtreecommitdiff
path: root/stdlib/callback.mli
blob: 17c3f33faebe12d9865a19a4ed57c7ef2c7a7e6b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
(***********************************************************************)
(*                                                                     *)
(*                           Objective Caml                            *)
(*                                                                     *)
(*            Xavier Leroy, projet Cristal, INRIA Rocquencourt         *)
(*                                                                     *)
(*  Copyright 1996 Institut National de Recherche en Informatique et   *)
(*  Automatique.  Distributed only by permission.                      *)
(*                                                                     *)
(***********************************************************************)

(* $Id$ *)

(* Module [Callback]: registering Caml values with the C runtime *)

(* This module allows Caml values to be registered with the C runtime
   under a symbolic name, so that C code can later call back registered
   Caml functions, or raise registered Caml exceptions. *)

val register: string -> 'a -> unit
        (* [Callback.register n v] registers the value [v] under
           the name [n]. C code can later retrieve a handle to [v]
           by calling [caml_named_value(n)]. *)

val register_exception: string -> exn -> unit
        (* [Callback.register_exception n exn] registers the
           exception contained in the exception value [exn]
           under the name [n]. C code can later retrieve a handle to
           the exception by calling [caml_named_value(n)]. The exception
           value thus obtained is suitable for passign as first argument
           to [raise_constant] or [raise_with_arg]. *)