(* Interface to Perl from OCaml.
* Copyright (C) 2003 Merjis Ltd.
- * $Id: perl.ml,v 1.4 2003-10-12 17:33:14 rich Exp $
+ * $Id: perl.ml,v 1.6 2003-10-15 16:51:12 rich Exp $
*)
type t
type sv
+type av
exception Perl_failure of string
+external create : ?args:string array -> unit -> t
+ = "perl4caml_create"
+
+(* Initialization. This must happen first, otherwise other parts of the
+ * program will segfault because of a missing interpreter.
+ *)
external c_init : unit -> unit = "perl4caml_init"
-let init () =
+let () =
+ (* Leave this debugging message in for now until init support in OCaml
+ * is debugged.
+ *)
+ prerr_endline "perl_init: Initialising Perl support ...";
Callback.register_exception "perl4caml_perl_failure" (Perl_failure "");
- c_init () (* Initialise C code. *)
+ c_init (); (* Initialise C code. *)
+ (* Create the default interpreter. *)
+ create ~args:[| ""; "-w"; "-e"; "0" |] ();
+ ()
-external destroy : unit -> unit
- = "perl4caml_destroy"
+external current_interpreter : unit -> t
+ = "perl4caml_current_interpreter"
-external create : ?args:string array -> unit -> t
- = "perl4caml_create"
+external destroy : t -> unit
+ = "perl4caml_destroy"
external set_context : t -> unit
= "perl4caml_set_context"
external sv_type : sv -> sv_t = "perl4caml_sv_type"
+let string_of_sv_t = function
+ SVt_NULL -> "SVt_NULL"
+ | SVt_IV -> "SVt_IV"
+ | SVt_NV -> "SVt_NV"
+ | SVt_PV -> "SVt_PV"
+ | SVt_RV -> "SVt_RV"
+ | SVt_PVAV -> "SVt_PVAV"
+ | SVt_PVHV -> "SVt_PVHV"
+ | SVt_PVCV -> "SVt_PVCV"
+ | SVt_PVGV -> "SVt_PVGV"
+ | SVt_PVMG -> "SVt_PVMG"
+
external deref : sv -> sv = "perl4caml_deref"
+external deref_array : sv -> av = "perl4caml_deref_array"
+
+external av_empty : unit -> av = "perl4caml_av_empty"
+external av_of_sv_list : sv list -> av = "perl4caml_av_of_sv_list"
+external av_push : av -> sv -> unit = "perl4caml_av_push"
+external av_pop : av -> sv = "perl4caml_av_pop"
+external av_shift : av -> sv = "perl4caml_av_shift"
+external av_unshift : av -> sv -> unit = "perl4caml_av_unshift"
+external av_length : av -> int = "perl4caml_av_length"
+external av_set : av -> int -> sv -> unit = "perl4caml_av_set"
+external av_get : av -> int -> sv = "perl4caml_av_get"
+external av_clear : av -> unit = "perl4caml_av_clear"
+external av_undef : av -> unit = "perl4caml_av_undef"
+external av_extend : av -> int -> unit = "perl4caml_av_extend"
+
+let av_map f av =
+ let list = ref [] in
+ for i = 0 to av_length av - 1 do
+ list := f (av_get av i) :: !list
+ done;
+ List.rev !list
external get_sv : ?create:bool -> string -> sv = "perl4caml_get_sv"
+external get_av : ?create:bool -> string -> av = "perl4caml_get_av"
external call : ?sv:sv -> ?fn:string -> sv list -> sv
= "perl4caml_call"