move link
[lambda.git] / code / untyped_evaluator.ml
index d820cce..92efa6e 100644 (file)
@@ -2,7 +2,7 @@
    This is a simplified version of the code at ...
    You can use this code as follows:
 
-   1. First, use a text editor to fill in the uncompleted portions.
+   1. First, use a text editor to fill in the (* COMPLETE THIS *) portions.
    2. Then see if OCaml will compile it, by typing `ocamlc -c untyped_evaluator.ml` in a Terminal.
    3. If it doesn't work, go back to step 1.
    4. If it does work, then you can start up the OCaml toplevel using `ocaml -I DIRECTORY`,
       `reduce (App(Lambda("x",Var "x"),Lambda("y",Var "y")))`
       `evaluate (App(Lambda("x",Var "x"),Lambda("y",Var "y")))`
 
-   The environments play absolutely no role in this simplified V1 interpreter. In the
-   fuller code, they have a limited role in the V1 interpreter. In the V2 interpreter,
-   the environments are essential.
+   The two interpreters presented below are (V1) a substitute-and-replace
+   interpreter, and (V2) an environment-based interpreter. We discuss the
+   differences between these in the notes.
+
+   The implementeations we provide make both of these call-by-value. When given
+   a term `App(head, arg)`, the steps are: first, reduce or evaluate
+   `head`---it might involve further `App`s itself. Second, reduce or evaluate
+   `arg`.  Third, only _when_ `arg` reduces or evaluates to a result value, then
+   "perform" the application. What this last step amounts to is different in
+   the two interpreters. Call-by-name interpreters would "perform" the
+   application regardless, and without even trying to reduce or evaluate arg to
+   a result value beforehand.
+
+   Additionally, these implementations assume that free variables are "stuck"
+   terms rather than result values. That is a bit inconvenient with this
+   simplified program: it means that Lambdas (or Closures, in V2) are the only
+   result values. But in the fuller code from which this is simplified, it
+   makes more sense, because there we also have literal number and boolean
+   values as results, too.
+
+   The environments play absolutely no role in the simplified V1 interpreter
+   presented here. In the fuller code, they have a limited role in the V1
+   interpreter. In the V2 interpreter, the environments are essential.
 *)
 
 type identifier = string
@@ -36,16 +56,16 @@ and result = term
 
 (* This simplified code just provides a single implementation of environments;
    but the fuller code provides more. *)
-and env = identifier -> term option
+and env = (identifier * term) list
 
 (* Operations for environments *)
-let empty = fun _ -> None
-let push (ident : identifier) binding env =
-  fun (sought_ident : identifier) ->
-    if ident = sought_ident
-    then Some binding
-    else env sought_ident
-let lookup sought_ident env = env sought_ident
+let empty = []
+let shift (ident : identifier) binding env = (ident,binding) :: env
+let rec lookup (sought_ident : ident) (env : env) : term option =
+  match env with
+  | [] -> None
+  | (ident, binding) :: _ when ident = sought_ident -> Some binding
+  | _ :: env' -> lookup sought_ident env'
 
   
 (*
@@ -113,11 +133,11 @@ module V1 = struct
     | Var(var_ident) ->
         var_ident = ident
     | App(head, arg) ->
-        free_in ident head || free_in ident arg
+        (* COMPLETE THIS *)
     | Lambda(bound_ident, body) ->
-        bound_ident <> ident && free_in ident body
+        (* COMPLETE THIS *)
     | Let(bound_ident, arg, body) ->
-        free_in ident arg || (bound_ident <> ident && free_in ident body)
+        free_in ident arg || (* COMPLETE THIS *)
     | If(test, yes, no) ->
         free_in ident test || free_in ident yes || free_in ident no
     | Closure _ -> assert false 
@@ -205,7 +225,7 @@ module V1 = struct
         (match reduce_head_once arg env with
         | AlreadyResult _ ->
             (* if arg was not reducible, we can substitute *)
-            ReducedTo (substitute bound_var arg body)
+            (* COMPLETE THIS *)
         | StuckAt _ as outcome -> outcome (* propagate Stuck subterm *)
         | ReducedTo arg' -> ReducedTo (App(head, arg')))
   
@@ -214,12 +234,12 @@ module V1 = struct
         (match reduce_head_once head env with
         | AlreadyResult _ -> (* head was not reducible, was arg? *)
             (match reduce_head_once arg env with
-            | ReducedTo arg' -> ReducedTo (App(head, arg'))
+            | ReducedTo arg' -> (* COMPLETE THIS *)
             (* reducible cases of App(result, result) were caught above; so here we're stuck *)
             | AlreadyResult _ -> StuckAt term
             | StuckAt _ as outcome -> outcome) (* propagate Stuck subterm *)
         | StuckAt _ as outcome -> outcome (* propagate Stuck subterm *)
-        | ReducedTo head' -> ReducedTo (App(head', arg)))
+        | ReducedTo head' -> (* COMPLETE THIS *))
   
 
 
@@ -247,8 +267,9 @@ module V2 = struct
 
     | Var var ->
         (match lookup var env with
-        (* Free variables will never be pushed to the env, so we can be
-          sure this is a result. *) CHECK
+       (* In this call-by-value design, only results get
+          saved in the environment, so we can be sure this
+          is a result. *)
         | Some res -> res
         | None -> failwith ("Unbound variable `" ^ var ^ "`"))
 
@@ -265,8 +286,7 @@ module V2 = struct
           bound to the result of evaluating arg under the
            current env *)
         let arg' = eval arg env in
-        let env' = push bound_var arg' env in
-        eval body env'
+        let env' = (* COMPLETE THIS *)
 
     | App(head, arg) ->
         (match eval head env with
@@ -276,8 +296,7 @@ module V2 = struct
            (* evaluate body under saved_env to govern its free
               variables, except that we add a binding of
                bound_var to arg' *)
-            let saved_env' = push bound_var arg' saved_env in
-            eval body saved_env'
+            let saved_env' = (* COMPLETE THIS *)
         | head' -> raise (Stuck(App(head',arg))))