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
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
/**************************************************************************/
/* */
/* OCaml */
/* */
/* Xavier Leroy, projet Cristal, INRIA Rocquencourt */
/* */
/* Copyright 1996 Institut National de Recherche en Informatique et */
/* en Automatique. */
/* */
/* All rights reserved. This file is distributed under the terms of */
/* the GNU Lesser General Public License version 2.1, with the */
/* special exception on linking described in the file LICENSE. */
/* */
/**************************************************************************/
/* Callbacks from C to OCaml */
#ifndef CAML_CALLBACK_H
#define CAML_CALLBACK_H
#include "mlvalues.h"
#include "memory.h"
#ifdef __cplusplus
extern "C" {
#endif
void caml_init_callbacks (void);
/* If the callback raises an exception, the functions caml_callback{,2,3,N}
propagate it to their caller. */
CAMLextern value caml_callback (value closure, value arg);
CAMLextern value caml_callback2 (value closure, value arg1, value arg2);
CAMLextern value caml_callback3 (value closure, value arg1, value arg2,
value arg3);
CAMLextern value caml_callbackN (value closure, int narg, value args[]);
/* The functions caml_callback{,2,3,N}_res return
a caml_result structure containing either the value or an exception,
they do not propagate exceptions directly to their caller. */
CAMLextern caml_result caml_callback_res (value closure, value arg);
CAMLextern caml_result caml_callback2_res (
value closure, value arg1, value arg2);
CAMLextern caml_result caml_callback3_res (
value closure, value arg1, value arg2, value arg3);
CAMLextern caml_result caml_callbackN_res (
value closure, int narg, value args[]);
/* These functions are similar to the caml_callback*_res variants
above, but they return an 'encoded exceptional value' (see mlvalues.h)
which represents either a value or an exception. This interface is unsafe
and it is easy to make mistakes due to the lack of type information,
we strongly recommend the *_res variants instead. */
CAMLextern value caml_callback_exn (value closure, value arg);
CAMLextern value caml_callback2_exn (value closure, value arg1, value arg2);
CAMLextern value caml_callback3_exn (value closure,
value arg1, value arg2, value arg3);
CAMLextern value caml_callbackN_exn (value closure, int narg, value args[]);
CAMLextern const value * caml_named_value (char const * name);
typedef void (*caml_named_action) (const value*, char *);
CAMLextern void caml_iterate_named_values(caml_named_action f);
CAMLextern void caml_main (char_os ** argv);
CAMLextern void caml_startup (char_os ** argv);
CAMLextern value caml_startup_exn (char_os ** argv);
CAMLextern void caml_startup_pooled (char_os ** argv);
CAMLextern value caml_startup_pooled_exn (char_os ** argv);
CAMLextern void caml_shutdown (void);
#ifdef __cplusplus
}
#endif
#endif
|
