1 (* Title: ZF/Tools/datatype_package.ML
2 Author: Lawrence C Paulson, Cambridge University Computer Laboratory
3 Copyright 1994 University of Cambridge
5 Datatype/Codatatype Definitions.
7 The functor will be instantiated for normal sums/products (datatype defs)
8 and non-standard sums/products (codatatype defs)
10 Sums are used only for mutual recursion;
11 Products are used only to derive "streamlined" induction rules for relations
14 type datatype_result =
15 {con_defs : thm list, (*definitions made in thy*)
16 case_eqns : thm list, (*equations for case operator*)
17 recursor_eqns : thm list, (*equations for the recursor*)
18 free_iffs : thm list, (*freeness rewrite rules*)
19 free_SEs : thm list, (*freeness destruct rules*)
20 mk_free : string -> thm}; (*function to make freeness theorems*)
22 signature DATATYPE_ARG =
28 signature DATATYPE_PACKAGE =
30 (*Insert definitions for the recursive sets, which
31 must *already* be declared as constants in parent theory!*)
32 val add_datatype_i: term * term list -> Ind_Syntax.constructor_spec list list ->
33 thm list * thm list * thm list -> theory -> theory * inductive_result * datatype_result
34 val add_datatype: string * string list -> (string * string list * mixfix) list list ->
35 (Facts.ref * Attrib.src list) list * (Facts.ref * Attrib.src list) list *
36 (Facts.ref * Attrib.src list) list -> theory -> theory * inductive_result * datatype_result
39 functor Add_datatype_def_Fun
40 (structure Fp: FP and Pr : PR and CP: CARTPROD and Su : SU
41 and Ind_Package : INDUCTIVE_PACKAGE
42 and Datatype_Arg : DATATYPE_ARG
43 val coind : bool): DATATYPE_PACKAGE =
46 (*con_ty_lists specifies the constructors in the form (name, prems, mixfix) *)
48 (*univ or quniv constitutes the sum domain for mutual recursion;
49 it is applied to the datatype parameters and to Consts occurring in the
50 definition other than Nat.nat and the datatype sets themselves.
51 FIXME: could insert all constant set expressions, e.g. nat->nat.*)
52 fun data_domain co (rec_tms, con_ty_lists) =
53 let val rec_hds = map head_of rec_tms
54 val dummy = assert_all is_Const rec_hds
55 (fn t => "Datatype set not previously declared as constant: " ^
56 Syntax.string_of_term_global @{theory IFOL} t);
57 val rec_names = (*nat doesn't have to be added*)
58 @{const_name nat} :: map (#1 o dest_Const) rec_hds
59 val u = if co then @{const QUniv.quniv} else @{const Univ.univ}
60 val cs = (fold o fold) (fn (_, _, _, prems) => prems |> (fold o fold_aterms)
61 (fn t as Const (a, _) => if member (op =) rec_names a then I else insert (op =) t
62 | _ => I)) con_ty_lists [];
63 in u $ Ind_Syntax.union_params (hd rec_tms, cs) end;
65 fun add_datatype_i (dom_sum, rec_tms) con_ty_lists (monos, type_intrs, type_elims) thy =
67 val dummy = (*has essential ancestors?*)
68 Theory.requires thy "Datatype_ZF" "(co)datatype definitions";
70 val rec_hds = map head_of rec_tms;
72 val dummy = assert_all is_Const rec_hds
73 (fn t => "Datatype set not previously declared as constant: " ^
74 Syntax.string_of_term_global thy t);
76 val rec_names = map (#1 o dest_Const) rec_hds
77 val rec_base_names = map Long_Name.base_name rec_names
78 val big_rec_base_name = space_implode "_" rec_base_names
80 val thy_path = thy |> Sign.add_path big_rec_base_name
82 val big_rec_name = Sign.intern_const thy_path big_rec_base_name;
84 val intr_tms = Ind_Syntax.mk_all_intr_tms thy_path (rec_tms, con_ty_lists);
87 writeln ((if coind then "Codatatype" else "Datatype") ^ " definition " ^ quote big_rec_name);
89 val case_varname = "f"; (*name for case variables*)
91 (** Define the constructors **)
93 (*The empty tuple is 0*)
94 fun mk_tuple [] = @{const zero}
95 | mk_tuple args = foldr1 (fn (t1, t2) => Pr.pair $ t1 $ t2) args;
97 fun mk_inject n k u = Balanced_Tree.access
98 {left = fn t => Su.inl $ t, right = fn t => Su.inr $ t, init = u} n k;
100 val npart = length rec_names; (*number of mutually recursive parts*)
103 val full_name = Sign.full_bname thy_path;
105 (*Make constructor definition;
106 kpart is the number of this mutually recursive part*)
107 fun mk_con_defs (kpart, con_ty_list) =
108 let val ncon = length con_ty_list (*number of constructors*)
109 fun mk_def (((id,T,syn), name, args, prems), kcon) =
110 (*kcon is index of constructor*)
111 Misc_Legacy.mk_defpair (list_comb (Const (full_name name, T), args),
112 mk_inject npart kpart
113 (mk_inject ncon kcon (mk_tuple args)))
114 in ListPair.map mk_def (con_ty_list, 1 upto ncon) end;
117 (*** Define the case operator ***)
119 (*Combine split terms using case; yields the case operator for one part*)
120 fun call_case case_list =
121 let fun call_f (free,[]) = Abs("null", @{typ i}, free)
122 | call_f (free,args) =
123 CP.ap_split (foldr1 CP.mk_prod (map (#2 o dest_Free) args))
126 in Balanced_Tree.make (fn (t1, t2) => Su.elim $ t1 $ t2) (map call_f case_list) end;
128 (** Generating function variables for the case definition
129 Non-identifiers (e.g. infixes) get a name of the form f_op_nnn. **)
131 (*The function variable for a single constructor*)
132 fun add_case ((_, T, _), name, args, _) (opno, cases) =
133 if Lexicon.is_identifier name then
134 (opno, (Free (case_varname ^ "_" ^ name, T), args) :: cases)
136 (opno + 1, (Free (case_varname ^ "_op_" ^ string_of_int opno, T), args)
139 (*Treatment of a list of constructors, for one part
140 Result adds a list of terms, each a function variable with arguments*)
141 fun add_case_list con_ty_list (opno, case_lists) =
142 let val (opno', case_list) = fold_rev add_case con_ty_list (opno, [])
143 in (opno', case_list :: case_lists) end;
145 (*Treatment of all parts*)
146 val (_, case_lists) = fold_rev add_case_list con_ty_lists (1, []);
148 (*extract the types of all the variables*)
149 val case_typ = maps (map (#2 o #1)) con_ty_lists ---> @{typ "i => i"};
151 val case_base_name = big_rec_base_name ^ "_case";
152 val case_name = full_name case_base_name;
154 (*The list of all the function variables*)
155 val case_args = maps (map #1) case_lists;
157 val case_const = Const (case_name, case_typ);
158 val case_tm = list_comb (case_const, case_args);
160 val case_def = Misc_Legacy.mk_defpair
161 (case_tm, Balanced_Tree.make (fn (t1, t2) => Su.elim $ t1 $ t2) (map call_case case_lists));
164 (** Generating function variables for the recursor definition
165 Non-identifiers (e.g. infixes) get a name of the form f_op_nnn. **)
167 (*a recursive call for x is the application rec`x *)
168 val rec_call = @{const apply} $ Free ("rec", @{typ i});
170 (*look back down the "case args" (which have been reversed) to
171 determine the de Bruijn index*)
172 fun make_rec_call ([], _) arg = error
173 "Internal error in datatype (variable name mismatch)"
174 | make_rec_call (a::args, i) arg =
175 if a = arg then rec_call $ Bound i
176 else make_rec_call (args, i+1) arg;
178 (*creates one case of the "X_case" definition of the recursor*)
179 fun call_recursor ((case_var, case_args), (recursor_var, recursor_args)) =
180 let fun add_abs (Free(a,T), u) = Abs(a,T,u)
181 val ncase_args = length case_args
182 val bound_args = map Bound ((ncase_args - 1) downto 0)
183 val rec_args = map (make_rec_call (rev case_args,0))
184 (List.drop(recursor_args, ncase_args))
187 (list_comb (recursor_var,
188 bound_args @ rec_args)) case_args
191 (*Find each recursive argument and add a recursive call for it*)
193 | rec_args ((Const(@{const_name mem},_)$arg$X)::prems) =
195 Const(a,_) => (*recursive occurrence?*)
196 if member (op =) rec_names a
197 then arg :: rec_args prems
199 | _ => rec_args prems)
200 | rec_args (_::prems) = rec_args prems;
202 (*Add an argument position for each occurrence of a recursive set.
203 Strictly speaking, the recursive arguments are the LAST of the function
204 variable, but they all have type "i" anyway*)
205 fun add_rec_args args' T = (map (fn _ => @{typ i}) args') ---> T
207 (*Plug in the function variable type needed for the recursor
208 as well as the new arguments (recursive calls)*)
209 fun rec_ty_elem ((id, T, syn), name, args, prems) =
210 let val args' = rec_args prems
211 in ((id, add_rec_args args' T, syn),
212 name, args @ args', prems)
215 val rec_ty_lists = (map (map rec_ty_elem) con_ty_lists);
217 (*Treatment of all parts*)
218 val (_, recursor_lists) = fold_rev add_case_list rec_ty_lists (1, []);
220 (*extract the types of all the variables*)
221 val recursor_typ = maps (map (#2 o #1)) rec_ty_lists ---> @{typ "i => i"};
223 val recursor_base_name = big_rec_base_name ^ "_rec";
224 val recursor_name = full_name recursor_base_name;
226 (*The list of all the function variables*)
227 val recursor_args = maps (map #1) recursor_lists;
230 list_comb (Const (recursor_name, recursor_typ), recursor_args);
232 val recursor_cases = map call_recursor (flat case_lists ~~ flat recursor_lists);
235 Misc_Legacy.mk_defpair
237 @{const Univ.Vrecursor} $
238 absfree ("rec", @{typ i}) (list_comb (case_const, recursor_cases)));
240 (* Build the new theory *)
242 val need_recursor = (not coind andalso recursor_typ <> case_typ);
244 fun add_recursor thy =
245 if need_recursor then
248 [(Binding.name recursor_base_name, recursor_typ, NoSyn)]
249 |> (snd o Global_Theory.add_defs false [(Thm.no_attributes o apfst Binding.name) recursor_def])
252 val (con_defs, thy0) = thy_path
254 (map (fn (c, T, mx) => (Binding.name c, T, mx))
255 ((case_base_name, case_typ, NoSyn) :: map #1 (flat con_ty_lists)))
256 |> Global_Theory.add_defs false
257 (map (Thm.no_attributes o apfst Binding.name)
259 flat (ListPair.map mk_con_defs (1 upto npart, con_ty_lists))))
263 val intr_names = map (Binding.name o #2) (flat con_ty_lists);
264 val (thy1, ind_result) =
265 thy0 |> Ind_Package.add_inductive_i
266 false (rec_tms, dom_sum) (map Thm.no_attributes (intr_names ~~ intr_tms))
267 (monos, con_defs, type_intrs @ Datatype_Arg.intrs, type_elims @ Datatype_Arg.elims);
269 (**** Now prove the datatype theorems in this theory ****)
272 (*** Prove the case theorems ***)
274 (*Each equation has the form
275 case(f_con1,...,f_conn)(coni(args)) = f_coni(args) *)
276 fun mk_case_eqn (((_,T,_), name, args, _), case_free) =
280 (list_comb (Const (Sign.intern_const thy1 name,T),
282 list_comb (case_free, args)));
284 val case_trans = hd con_defs RS @{thm def_trans}
285 and split_trans = Pr.split_eq RS @{thm meta_eq_to_obj_eq} RS @{thm trans};
287 fun prove_case_eqn (arg, con_def) =
288 Goal.prove_global thy1 [] []
289 (Ind_Syntax.traceIt "next case equation = " thy1 (mk_case_eqn arg))
290 (*Proves a single case equation. Could use simp_tac, but it's slower!*)
292 [rewrite_goals_tac [con_def],
295 (resolve_tac [@{thm refl}, split_trans,
296 Su.case_inl RS @{thm trans}, Su.case_inr RS @{thm trans}] 1)]);
298 val free_iffs = map Drule.export_without_context (con_defs RL [@{thm def_swap_iff}]);
300 val case_eqns = map prove_case_eqn (flat con_ty_lists ~~ case_args ~~ tl con_defs);
302 (*** Prove the recursor theorems ***)
304 val recursor_eqns = case try (Misc_Legacy.get_def thy1) recursor_base_name of
305 NONE => (writeln " [ No recursion operator ]";
307 | SOME recursor_def =>
309 (*Replace subterms rec`x (where rec is a Free var) by recursor_tm(x) *)
310 fun subst_rec (Const(@{const_name apply},_) $ Free _ $ arg) = recursor_tm $ arg
312 let val (head, args) = strip_comb tm
313 in list_comb (head, map subst_rec args) end;
315 (*Each equation has the form
316 REC(coni(args)) = f_coni(args, REC(rec_arg), ...)
317 where REC = recursor(f_con1,...,f_conn) and rec_arg is a recursive
318 constructor argument.*)
319 fun mk_recursor_eqn (((_,T,_), name, args, _), recursor_case) =
323 (list_comb (Const (Sign.intern_const thy1 name,T),
325 subst_rec (Term.betapplys (recursor_case, args))));
327 val recursor_trans = recursor_def RS @{thm def_Vrecursor} RS @{thm trans};
329 fun prove_recursor_eqn arg =
330 Goal.prove_global thy1 [] []
331 (Ind_Syntax.traceIt "next recursor equation = " thy1 (mk_recursor_eqn arg))
332 (*Proves a single recursor equation.*)
334 [rtac recursor_trans 1,
335 simp_tac (rank_ss addsimps case_eqns) 1,
336 IF_UNSOLVED (simp_tac (rank_ss addsimps tl con_defs) 1)]);
338 map prove_recursor_eqn (flat con_ty_lists ~~ recursor_cases)
342 map (head_of o #1 o Logic.dest_equals o Thm.prop_of) (tl con_defs);
344 val free_SEs = map Drule.export_without_context (Ind_Syntax.mk_free_SEs free_iffs);
346 val {intrs, elim, induct, mutual_induct, ...} = ind_result
348 (*Typical theorems have the form ~con1=con2, con1=con2==>False,
349 con1(x)=con1(y) ==> x=y, con1(x)=con1(y) <-> x=y, etc. *)
352 val thy = theory_of_thm elim;
353 val ctxt = Proof_Context.init_global thy;
355 Goal.prove_global thy [] [] (Syntax.read_prop ctxt s)
357 [rewrite_goals_tac con_defs,
358 fast_tac (put_claset ZF_cs ctxt addSEs free_SEs @ Su.free_SEs) 1])
361 val simps = case_eqns @ recursor_eqns;
365 constructors = constructors,
366 rec_rewrites = recursor_eqns,
367 case_rewrites = case_eqns,
369 mutual_induct = mutual_induct,
373 {big_rec_name = big_rec_name,
374 constructors = constructors,
375 (*let primrec handle definition by cases*)
376 free_iffs = free_iffs,
377 rec_rewrites = (case recursor_eqns of
378 [] => case_eqns | _ => recursor_eqns)};
380 (*associate with each constructor the datatype name and rewrites*)
381 val con_pairs = map (fn c => (#1 (dest_Const c), con_info)) constructors
384 (*Updating theory components: simprules and datatype info*)
385 (thy1 |> Sign.add_path big_rec_base_name
386 |> Global_Theory.add_thmss
387 [((Binding.name "simps", simps), [Simplifier.simp_add]),
388 ((Binding.empty, intrs), [Cla.safe_intro NONE]),
389 ((Binding.name "con_defs", con_defs), []),
390 ((Binding.name "case_eqns", case_eqns), []),
391 ((Binding.name "recursor_eqns", recursor_eqns), []),
392 ((Binding.name "free_iffs", free_iffs), []),
393 ((Binding.name "free_elims", free_SEs), [])] |> snd
394 |> DatatypesData.map (Symtab.update (big_rec_name, dt_info))
395 |> ConstructorsData.map (fold Symtab.update con_pairs)
398 {con_defs = con_defs,
399 case_eqns = case_eqns,
400 recursor_eqns = recursor_eqns,
401 free_iffs = free_iffs,
406 fun add_datatype (sdom, srec_tms) scon_ty_lists (raw_monos, raw_type_intrs, raw_type_elims) thy =
408 val ctxt = Proof_Context.init_global thy;
410 map (Syntax.parse_term ctxt #> Type.constraint @{typ i}) strs
411 |> Syntax.check_terms ctxt;
413 val rec_tms = read_is srec_tms;
414 val con_ty_lists = Ind_Syntax.read_constructs ctxt scon_ty_lists;
416 if sdom = "" then data_domain coind (rec_tms, con_ty_lists)
417 else singleton read_is sdom;
418 val monos = Attrib.eval_thms ctxt raw_monos;
419 val type_intrs = Attrib.eval_thms ctxt raw_type_intrs;
420 val type_elims = Attrib.eval_thms ctxt raw_type_elims;
421 in add_datatype_i (dom_sum, rec_tms) con_ty_lists (monos, type_intrs, type_elims) thy end;
426 fun mk_datatype ((((dom, dts), monos), type_intrs), type_elims) =
427 #1 o add_datatype (dom, map fst dts) (map snd dts) (monos, type_intrs, type_elims);
430 Parse.name -- Scan.optional (@{keyword "("} |-- Parse.list1 Parse.term --| @{keyword ")"}) [] --
431 Parse.opt_mixfix >> Parse.triple1;
434 (Scan.optional ((@{keyword "\<subseteq>"} || @{keyword "<="}) |-- Parse.!!! Parse.term) "") --
435 Parse.and_list1 (Parse.term -- (@{keyword "="} |-- Parse.enum1 "|" con_decl)) --
436 Scan.optional (@{keyword "monos"} |-- Parse.!!! Parse_Spec.xthms1) [] --
437 Scan.optional (@{keyword "type_intros"} |-- Parse.!!! Parse_Spec.xthms1) [] --
438 Scan.optional (@{keyword "type_elims"} |-- Parse.!!! Parse_Spec.xthms1) []
439 >> (Toplevel.theory o mk_datatype);
441 val coind_prefix = if coind then "co" else "";
444 Outer_Syntax.command (coind_prefix ^ "datatype")
445 ("define " ^ coind_prefix ^ "datatype") Keyword.thy_decl datatype_decl;