| 
5719
 | 
     1  | 
(*  Title:      HOL/Tools/primrec_package.ML
  | 
| 
5178
 | 
     2  | 
    ID:         $Id$
  | 
| 
5719
 | 
     3  | 
    Author:     Stefan Berghofer and Norbert Voelker
  | 
| 
5178
 | 
     4  | 
    Copyright   1998  TU Muenchen
  | 
| 
 | 
     5  | 
  | 
| 
6359
 | 
     6  | 
Package for defining functions on datatypes by primitive recursion.
  | 
| 
5178
 | 
     7  | 
*)
  | 
| 
 | 
     8  | 
  | 
| 
 | 
     9  | 
signature PRIMREC_PACKAGE =
  | 
| 
 | 
    10  | 
sig
  | 
| 
6427
 | 
    11  | 
  val quiet_mode: bool ref
  | 
| 
6425
 | 
    12  | 
  val add_primrec: string -> ((bstring * string) * Args.src list) list
  | 
| 
6359
 | 
    13  | 
    -> theory -> theory * thm list
  | 
| 
6425
 | 
    14  | 
  val add_primrec_i: string -> ((bstring * term) * theory attribute list) list
  | 
| 
6359
 | 
    15  | 
    -> theory -> theory * thm list
  | 
| 
5178
 | 
    16  | 
end;
  | 
| 
 | 
    17  | 
  | 
| 
 | 
    18  | 
structure PrimrecPackage : PRIMREC_PACKAGE =
  | 
| 
 | 
    19  | 
struct
  | 
| 
 | 
    20  | 
  | 
| 
 | 
    21  | 
open DatatypeAux;
  | 
| 
 | 
    22  | 
  | 
| 
 | 
    23  | 
exception RecError of string;
  | 
| 
 | 
    24  | 
  | 
| 
 | 
    25  | 
fun primrec_err s = error ("Primrec definition error:\n" ^ s);
 | 
| 
 | 
    26  | 
fun primrec_eq_err sign s eq =
  | 
| 
6427
 | 
    27  | 
  primrec_err (s ^ "\nin equation\n" ^ quote (Sign.string_of_term sign eq));
  | 
| 
 | 
    28  | 
  | 
| 
 | 
    29  | 
  | 
| 
 | 
    30  | 
(* messages *)
  | 
| 
 | 
    31  | 
  | 
| 
 | 
    32  | 
val quiet_mode = ref false;
  | 
| 
 | 
    33  | 
fun message s = if ! quiet_mode then () else writeln s;
  | 
| 
5178
 | 
    34  | 
  | 
| 
6359
 | 
    35  | 
  | 
| 
5178
 | 
    36  | 
(* preprocessing of equations *)
  | 
| 
 | 
    37  | 
  | 
| 
 | 
    38  | 
fun process_eqn sign (eq, rec_fns) = 
  | 
| 
 | 
    39  | 
  let
  | 
| 
6032
 | 
    40  | 
    val (lhs, rhs) = 
  | 
| 
 | 
    41  | 
	if null (term_vars eq) then
  | 
| 
 | 
    42  | 
	    HOLogic.dest_eq (HOLogic.dest_Trueprop eq)
  | 
| 
 | 
    43  | 
	      handle _ => raise RecError "not a proper equation"
  | 
| 
 | 
    44  | 
	else raise RecError "illegal schematic variable(s)";
  | 
| 
5178
 | 
    45  | 
  | 
| 
 | 
    46  | 
    val (recfun, args) = strip_comb lhs;
  | 
| 
 | 
    47  | 
    val (fname, _) = dest_Const recfun handle _ => 
  | 
| 
 | 
    48  | 
      raise RecError "function is not declared as constant in theory";
  | 
| 
 | 
    49  | 
  | 
| 
 | 
    50  | 
    val (ls', rest)  = take_prefix is_Free args;
  | 
| 
 | 
    51  | 
    val (middle, rs') = take_suffix is_Free rest;
  | 
| 
 | 
    52  | 
    val rpos = length ls';
  | 
| 
 | 
    53  | 
  | 
| 
 | 
    54  | 
    val (constr, cargs') = if null middle then raise RecError "constructor missing"
  | 
| 
 | 
    55  | 
      else strip_comb (hd middle);
  | 
| 
 | 
    56  | 
    val (cname, T) = dest_Const constr
  | 
| 
 | 
    57  | 
      handle _ => raise RecError "ill-formed constructor";
  | 
| 
 | 
    58  | 
    val (tname, _) = dest_Type (body_type T) handle _ =>
  | 
| 
 | 
    59  | 
      raise RecError "cannot determine datatype associated with function"
  | 
| 
 | 
    60  | 
  | 
| 
6037
 | 
    61  | 
    val (ls, cargs, rs) = (map dest_Free ls', 
  | 
| 
 | 
    62  | 
			   map dest_Free cargs', 
  | 
| 
 | 
    63  | 
			   map dest_Free rs')
  | 
| 
5178
 | 
    64  | 
      handle _ => raise RecError "illegal argument in pattern";
  | 
| 
 | 
    65  | 
    val lfrees = ls @ rs @ cargs;
  | 
| 
 | 
    66  | 
  | 
| 
 | 
    67  | 
  in
  | 
| 
 | 
    68  | 
    if not (null (duplicates lfrees)) then 
  | 
| 
 | 
    69  | 
      raise RecError "repeated variable name in pattern" 
  | 
| 
 | 
    70  | 
    else if not ((map dest_Free (term_frees rhs)) subset lfrees) then
  | 
| 
 | 
    71  | 
      raise RecError "extra variables on rhs"
  | 
| 
 | 
    72  | 
    else if length middle > 1 then 
  | 
| 
 | 
    73  | 
      raise RecError "more than one non-variable in pattern"
  | 
| 
 | 
    74  | 
    else (case assoc (rec_fns, fname) of
  | 
| 
 | 
    75  | 
        None =>
  | 
| 
 | 
    76  | 
          (fname, (tname, rpos, [(cname, (ls, cargs, rs, rhs, eq))]))::rec_fns
  | 
| 
 | 
    77  | 
      | Some (_, rpos', eqns) =>
  | 
| 
 | 
    78  | 
          if is_some (assoc (eqns, cname)) then
  | 
| 
6037
 | 
    79  | 
            raise RecError "constructor already occurred as pattern"
  | 
| 
5178
 | 
    80  | 
          else if rpos <> rpos' then
  | 
| 
 | 
    81  | 
            raise RecError "position of recursive argument inconsistent"
  | 
| 
 | 
    82  | 
          else
  | 
| 
6037
 | 
    83  | 
            overwrite (rec_fns, 
  | 
| 
 | 
    84  | 
		       (fname, 
  | 
| 
 | 
    85  | 
			(tname, rpos,
  | 
| 
 | 
    86  | 
			 (cname, (ls, cargs, rs, rhs, eq))::eqns))))
  | 
| 
5178
 | 
    87  | 
  end
  | 
| 
 | 
    88  | 
  handle RecError s => primrec_eq_err sign s eq;
  | 
| 
 | 
    89  | 
  | 
| 
 | 
    90  | 
fun process_fun sign descr rec_eqns ((i, fname), (fnames, fnss)) =
  | 
| 
 | 
    91  | 
  let
  | 
| 
 | 
    92  | 
    val (_, (tname, _, constrs)) = nth_elem (i, descr);
  | 
| 
 | 
    93  | 
  | 
| 
 | 
    94  | 
    (* substitute "fname ls x rs" by "y ls rs" for (x, (_, y)) in subs *)
  | 
| 
 | 
    95  | 
  | 
| 
 | 
    96  | 
    fun subst [] x = x
  | 
| 
 | 
    97  | 
      | subst subs (fs, Abs (a, T, t)) =
  | 
| 
 | 
    98  | 
          let val (fs', t') = subst subs (fs, t)
  | 
| 
 | 
    99  | 
          in (fs', Abs (a, T, t')) end
  | 
| 
 | 
   100  | 
      | subst subs (fs, t as (_ $ _)) =
  | 
| 
 | 
   101  | 
          let val (f, ts) = strip_comb t;
  | 
| 
 | 
   102  | 
          in
  | 
| 
 | 
   103  | 
            if is_Const f andalso (fst (dest_Const f)) mem (map fst rec_eqns) then
  | 
| 
 | 
   104  | 
              let
  | 
| 
 | 
   105  | 
                val (fname', _) = dest_Const f;
  | 
| 
 | 
   106  | 
                val (_, rpos, _) = the (assoc (rec_eqns, fname'));
  | 
| 
 | 
   107  | 
                val ls = take (rpos, ts);
  | 
| 
 | 
   108  | 
                val rest = drop (rpos, ts);
  | 
| 
 | 
   109  | 
                val (x, rs) = (hd rest, tl rest)
  | 
| 
 | 
   110  | 
                  handle _ => raise RecError ("not enough arguments\
 | 
| 
6427
 | 
   111  | 
                   \ in recursive application\nof function " ^ quote fname' ^ " on rhs")
  | 
| 
5178
 | 
   112  | 
              in 
  | 
| 
 | 
   113  | 
                (case assoc (subs, x) of
  | 
| 
 | 
   114  | 
                    None =>
  | 
| 
 | 
   115  | 
                      let
  | 
| 
 | 
   116  | 
                        val (fs', ts') = foldl_map (subst subs) (fs, ts)
  | 
| 
 | 
   117  | 
                      in (fs', list_comb (f, ts')) end
  | 
| 
 | 
   118  | 
                  | Some (i', y) =>
  | 
| 
 | 
   119  | 
                      let
  | 
| 
 | 
   120  | 
                        val (fs', ts') = foldl_map (subst subs) (fs, ls @ rs);
  | 
| 
 | 
   121  | 
                        val fs'' = process_fun sign descr rec_eqns ((i', fname'), fs')
  | 
| 
 | 
   122  | 
                      in (fs'', list_comb (y, ts'))
  | 
| 
 | 
   123  | 
                      end)
  | 
| 
 | 
   124  | 
              end
  | 
| 
 | 
   125  | 
            else
  | 
| 
 | 
   126  | 
              let
  | 
| 
 | 
   127  | 
                val (fs', f'::ts') = foldl_map (subst subs) (fs, f::ts)
  | 
| 
 | 
   128  | 
              in (fs', list_comb (f', ts')) end
  | 
| 
 | 
   129  | 
          end
  | 
| 
 | 
   130  | 
      | subst _ x = x;
  | 
| 
 | 
   131  | 
  | 
| 
 | 
   132  | 
    (* translate rec equations into function arguments suitable for rec comb *)
  | 
| 
 | 
   133  | 
  | 
| 
 | 
   134  | 
    fun trans eqns ((cname, cargs), (fnames', fnss', fns)) =
  | 
| 
 | 
   135  | 
      (case assoc (eqns, cname) of
  | 
| 
6427
 | 
   136  | 
          None => (warning ("no equation for constructor " ^ quote cname ^
 | 
| 
 | 
   137  | 
            "\nin definition of function " ^ quote fname);
  | 
| 
5178
 | 
   138  | 
              (fnames', fnss', (Const ("arbitrary", dummyT))::fns))
 | 
| 
 | 
   139  | 
        | Some (ls, cargs', rs, rhs, eq) =>
  | 
| 
 | 
   140  | 
            let
  | 
| 
 | 
   141  | 
              val recs = filter (is_rec_type o snd) (cargs' ~~ cargs);
  | 
| 
 | 
   142  | 
              val rargs = map fst recs;
  | 
| 
6037
 | 
   143  | 
              val subs = map (rpair dummyT o fst) 
  | 
| 
 | 
   144  | 
		             (rev (rename_wrt_term rhs rargs));
  | 
| 
 | 
   145  | 
              val ((fnames'', fnss''), rhs') = 
  | 
| 
 | 
   146  | 
		  (subst (map (fn ((x, y), z) =>
  | 
| 
 | 
   147  | 
			       (Free x, (dest_DtRec y, Free z)))
  | 
| 
 | 
   148  | 
			  (recs ~~ subs))
  | 
| 
 | 
   149  | 
		   ((fnames', fnss'), rhs))
  | 
| 
5178
 | 
   150  | 
                  handle RecError s => primrec_eq_err sign s eq
  | 
| 
6037
 | 
   151  | 
            in (fnames'', fnss'', 
  | 
| 
 | 
   152  | 
		(list_abs_free (cargs' @ subs @ ls @ rs, rhs'))::fns)
  | 
| 
5178
 | 
   153  | 
            end)
  | 
| 
 | 
   154  | 
  | 
| 
 | 
   155  | 
  in (case assoc (fnames, i) of
  | 
| 
 | 
   156  | 
      None =>
  | 
| 
 | 
   157  | 
        if exists (equal fname o snd) fnames then
  | 
| 
6427
 | 
   158  | 
          raise RecError ("inconsistent functions for datatype " ^ quote tname)
 | 
| 
5178
 | 
   159  | 
        else
  | 
| 
 | 
   160  | 
          let
  | 
| 
 | 
   161  | 
            val (_, _, eqns) = the (assoc (rec_eqns, fname));
  | 
| 
 | 
   162  | 
            val (fnames', fnss', fns) = foldr (trans eqns)
  | 
| 
 | 
   163  | 
              (constrs, ((i, fname)::fnames, fnss, []))
  | 
| 
 | 
   164  | 
          in
  | 
| 
 | 
   165  | 
            (fnames', (i, (fname, #1 (snd (hd eqns)), fns))::fnss')
  | 
| 
 | 
   166  | 
          end
  | 
| 
 | 
   167  | 
    | Some fname' =>
  | 
| 
 | 
   168  | 
        if fname = fname' then (fnames, fnss)
  | 
| 
6427
 | 
   169  | 
        else raise RecError ("inconsistent functions for datatype " ^ quote tname))
 | 
| 
5178
 | 
   170  | 
  end;
  | 
| 
 | 
   171  | 
  | 
| 
6359
 | 
   172  | 
  | 
| 
5178
 | 
   173  | 
(* prepare functions needed for definitions *)
  | 
| 
 | 
   174  | 
  | 
| 
 | 
   175  | 
fun get_fns fns (((i, (tname, _, constrs)), rec_name), (fs, defs)) =
  | 
| 
 | 
   176  | 
  case assoc (fns, i) of
  | 
| 
 | 
   177  | 
     None =>
  | 
| 
 | 
   178  | 
       let
  | 
| 
 | 
   179  | 
         val dummy_fns = map (fn (_, cargs) => Const ("arbitrary",
 | 
| 
 | 
   180  | 
           replicate ((length cargs) + (length (filter is_rec_type cargs)))
  | 
| 
 | 
   181  | 
             dummyT ---> HOLogic.unitT)) constrs;
  | 
| 
6427
 | 
   182  | 
         val _ = warning ("No function definition for datatype " ^ quote tname)
 | 
| 
5178
 | 
   183  | 
       in
  | 
| 
 | 
   184  | 
         (dummy_fns @ fs, defs)
  | 
| 
 | 
   185  | 
       end
  | 
| 
 | 
   186  | 
   | Some (fname, ls, fs') => (fs' @ fs, (fname, ls, rec_name, tname)::defs);
  | 
| 
 | 
   187  | 
  | 
| 
6359
 | 
   188  | 
  | 
| 
5178
 | 
   189  | 
(* make definition *)
  | 
| 
 | 
   190  | 
  | 
| 
 | 
   191  | 
fun make_def sign fs (fname, ls, rec_name, tname) =
  | 
| 
 | 
   192  | 
  let
  | 
| 
6037
 | 
   193  | 
    val rhs = foldr (fn (T, t) => Abs ("", T, t)) 
 | 
| 
 | 
   194  | 
	            ((map snd ls) @ [dummyT],
  | 
| 
 | 
   195  | 
		     list_comb (Const (rec_name, dummyT),
  | 
| 
 | 
   196  | 
				fs @ map Bound (0 ::(length ls downto 1))));
  | 
| 
5178
 | 
   197  | 
    val defpair = (Sign.base_name fname ^ "_" ^ Sign.base_name tname ^ "_def",
  | 
| 
6037
 | 
   198  | 
		   Logic.mk_equals (Const (fname, dummyT), rhs))
  | 
| 
6394
 | 
   199  | 
  in Theory.inferT_axm sign defpair end;
  | 
| 
5178
 | 
   200  | 
  | 
| 
6359
 | 
   201  | 
  | 
| 
5178
 | 
   202  | 
(* find datatypes which contain all datatypes in tnames' *)
  | 
| 
 | 
   203  | 
  | 
| 
 | 
   204  | 
fun find_dts (dt_info : datatype_info Symtab.table) _ [] = []
  | 
| 
 | 
   205  | 
  | find_dts dt_info tnames' (tname::tnames) =
  | 
| 
 | 
   206  | 
      (case Symtab.lookup (dt_info, tname) of
  | 
| 
6427
 | 
   207  | 
          None => primrec_err (quote tname ^ " is not a datatype")
  | 
| 
5178
 | 
   208  | 
        | Some dt =>
  | 
| 
 | 
   209  | 
            if tnames' subset (map (#1 o snd) (#descr dt)) then
  | 
| 
 | 
   210  | 
              (tname, dt)::(find_dts dt_info tnames' tnames)
  | 
| 
 | 
   211  | 
            else find_dts dt_info tnames' tnames);
  | 
| 
 | 
   212  | 
  | 
| 
6359
 | 
   213  | 
fun add_primrec_i alt_name eqns_atts thy =
  | 
| 
5178
 | 
   214  | 
  let
  | 
| 
6359
 | 
   215  | 
    val (eqns, atts) = split_list eqns_atts;
  | 
| 
6394
 | 
   216  | 
    val sg = Theory.sign_of thy;
  | 
| 
5178
 | 
   217  | 
    val dt_info = DatatypePackage.get_datatypes thy;
  | 
| 
5719
 | 
   218  | 
    val rec_eqns = foldr (process_eqn sg) (map snd eqns, []);
  | 
| 
5178
 | 
   219  | 
    val tnames = distinct (map (#1 o snd) rec_eqns);
  | 
| 
 | 
   220  | 
    val dts = find_dts dt_info tnames tnames;
  | 
| 
6037
 | 
   221  | 
    val main_fns = 
  | 
| 
 | 
   222  | 
	map (fn (tname, {index, ...}) =>
 | 
| 
 | 
   223  | 
	     (index, 
  | 
| 
 | 
   224  | 
	      fst (the (find_first (fn f => #1 (snd f) = tname) rec_eqns))))
  | 
| 
 | 
   225  | 
	dts;
  | 
| 
 | 
   226  | 
    val {descr, rec_names, rec_rewrites, ...} = 
 | 
| 
 | 
   227  | 
	if null dts then
  | 
| 
6359
 | 
   228  | 
	    primrec_err ("datatypes " ^ commas_quote tnames ^ 
 | 
| 
6037
 | 
   229  | 
			 "\nare not mutually recursive")
  | 
| 
 | 
   230  | 
	else snd (hd dts);
  | 
| 
 | 
   231  | 
    val (fnames, fnss) = foldr (process_fun sg descr rec_eqns)
  | 
| 
 | 
   232  | 
	                       (main_fns, ([], []));
  | 
| 
5178
 | 
   233  | 
    val (fs, defs) = foldr (get_fns fnss) (descr ~~ rec_names, ([], []));
  | 
| 
 | 
   234  | 
    val defs' = map (make_def sg fs) defs;
  | 
| 
 | 
   235  | 
    val names1 = map snd fnames;
  | 
| 
 | 
   236  | 
    val names2 = map fst rec_eqns;
  | 
| 
5216
 | 
   237  | 
    val thy' = thy |>
  | 
| 
5719
 | 
   238  | 
      Theory.add_path (if alt_name = "" then (space_implode "_"
  | 
| 
 | 
   239  | 
        (map (Sign.base_name o #1) defs)) else alt_name) |>
  | 
| 
5216
 | 
   240  | 
      (if eq_set (names1, names2) then Theory.add_defs_i defs'
  | 
| 
6359
 | 
   241  | 
       else primrec_err ("functions " ^ commas_quote names2 ^
 | 
| 
5216
 | 
   242  | 
         "\nare not mutually recursive"));
  | 
| 
5553
 | 
   243  | 
    val rewrites = (map mk_meta_eq rec_rewrites) @ (map (get_axiom thy' o fst) defs');
  | 
| 
6427
 | 
   244  | 
    val _ = message ("Proving equations for primrec function(s) " ^ commas_quote names1 ^ " ...");
 | 
| 
6394
 | 
   245  | 
    val char_thms = map (fn (_, t) => prove_goalw_cterm rewrites (cterm_of (Theory.sign_of thy') t)
  | 
| 
5178
 | 
   246  | 
        (fn _ => [rtac refl 1])) eqns;
  | 
| 
6092
 | 
   247  | 
    val simps = char_thms;
  | 
| 
6359
 | 
   248  | 
    val thy'' =
  | 
| 
 | 
   249  | 
      thy'
  | 
| 
 | 
   250  | 
      |> PureThy.add_thmss [(("simps", simps), [Simplifier.simp_add_global])]
 | 
| 
 | 
   251  | 
      |> PureThy.add_thms ((map fst eqns ~~ simps) ~~ atts)
  | 
| 
 | 
   252  | 
      |> Theory.parent_path;
  | 
| 
 | 
   253  | 
  in (thy'', char_thms) end;
  | 
| 
 | 
   254  | 
  | 
| 
 | 
   255  | 
  | 
| 
 | 
   256  | 
fun read_eqn thy ((name, s), srcs) =
  | 
| 
6394
 | 
   257  | 
  ((name, readtm (Theory.sign_of thy) propT s), map (Attrib.global_attribute thy) srcs);
  | 
| 
6359
 | 
   258  | 
  | 
| 
 | 
   259  | 
fun add_primrec alt_name eqns thy = add_primrec_i alt_name (map (read_eqn thy) eqns) thy;
  | 
| 
 | 
   260  | 
  | 
| 
5178
 | 
   261  | 
  | 
| 
6359
 | 
   262  | 
(* outer syntax *)
  | 
| 
 | 
   263  | 
  | 
| 
6384
 | 
   264  | 
local open OuterParse in
  | 
| 
6359
 | 
   265  | 
  | 
| 
 | 
   266  | 
val primrec_decl =
  | 
| 
 | 
   267  | 
  Scan.optional ($$$ "(" |-- name --| $$$ ")") "" --
 | 
| 
 | 
   268  | 
    Scan.repeat1 (opt_thm_name ":" -- term);
  | 
| 
 | 
   269  | 
  | 
| 
 | 
   270  | 
val primrecP =
  | 
| 
6384
 | 
   271  | 
  OuterSyntax.command "primrec" "define primitive recursive functions on datatypes"
  | 
| 
6359
 | 
   272  | 
    (primrec_decl >> (fn (alt_name, eqns) =>
  | 
| 
6430
 | 
   273  | 
      Toplevel.theory (#1 o add_primrec alt_name (map triple_swap eqns))));
  | 
| 
6359
 | 
   274  | 
  | 
| 
 | 
   275  | 
val _ = OuterSyntax.add_parsers [primrecP];
  | 
| 
5178
 | 
   276  | 
  | 
| 
 | 
   277  | 
end;
  | 
| 
6384
 | 
   278  | 
  | 
| 
 | 
   279  | 
  | 
| 
 | 
   280  | 
end;
  |