helm/ocaml/cic_unification/cicMetaSubst.mli

   1 (* Copyright (C) 2004, HELM Team.
   2  *
   3  * This file is part of HELM, an Hypertextual, Electronic
   4  * Library of Mathematics, developed at the Computer Science
   5  * Department, University of Bologna, Italy.
   6  *
   7  * HELM is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU General Public License
   9  * as published by the Free Software Foundation; either version 2
  10  * of the License, or (at your option) any later version.
  11  *
  12  * HELM is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License
  18  * along with HELM; if not, write to the Free Software
  19  * Foundation, Inc., 59 Temple Place - Suite 330, Boston,
  20  * MA  02111-1307, USA.
  21  *
  22  * For details, see the HELM World-Wide-Web page,
  23  * http://helm.cs.unibo.it/
  24  *)
  25
  26 exception MetaSubstFailure of string
  27 exception Uncertain of string
  28 exception AssertFailure of string
  29
  30 (* The entry (i,t) in a substitution means that *)
  31 (* (META i) have been instantiated with t.      *)
  32 type substitution = (int * Cic.term) list
  33
  34 (* apply_subst subst t                     *)
  35 (* applies the substitution [subst] to [t] *)
  36 (* [subst] must be already unwinded        *)
  37 val apply_subst : substitution -> Cic.term -> Cic.term
  38
  39 (* apply_subst_reducing subst (Some (mtr,reductions_no)) t              *)
  40 (* performs as (apply_subst subst t) until it finds an application of   *)
  41 (* (META [mtr]) that, once unwinding is performed, creates a new        *)
  42 (* beta-redex; in this case up to [reductions_no] consecutive           *)
  43 (* beta-reductions are performed.                                       *)
  44 (* Hint: this function is usually called when [reductions_no]           *)
  45 (*  eta-expansions have been performed and the head of the new          *)
  46 (*  application has been unified with (META [meta_to_reduce]):          *)
  47 (*  during the unwinding the eta-expansions are undone.                 *)
  48 (* [subst] must be already unwinded                                     *)
  49 val apply_subst_reducing :
  50  (int * int) option -> substitution -> Cic.term -> Cic.term
  51
  52 val apply_subst_context : substitution -> Cic.context -> Cic.context
  53 val apply_subst_metasenv: substitution -> Cic.metasenv -> Cic.metasenv
  54
  55 (* {2 Kernel wrappers}
  56  * From now on we recreate a kernel abstraction where substitutions are part of
  57  * the calculus *)
  58
  59 val lift : substitution -> int -> Cic.term -> Cic.term
  60 val subst: substitution -> Cic.term -> Cic.term -> Cic.term
  61 val whd: substitution -> Cic.context -> Cic.term -> Cic.term
  62 val are_convertible: substitution -> Cic.context -> Cic.term -> Cic.term -> bool
  63
  64 val type_of_aux':
  65   Cic.metasenv -> substitution -> Cic.context -> Cic.term -> Cic.term
  66
  67 val tempi_type_of_aux : float ref
  68 val tempi_type_of_aux_subst : float ref
  69
  70 (*** delifting ***)
  71
  72 val delift :
  73   int -> substitution -> Cic.context -> Cic.metasenv ->
  74   (Cic.term option) list -> Cic.term ->
  75     Cic.term * Cic.metasenv * substitution
  76
  77 (** {2 Pretty printers} *)
  78
  79 val ppsubst: substitution -> string
  80 val ppterm: substitution -> Cic.term -> string
  81 val ppcontext: ?sep: string -> substitution -> Cic.context -> string
  82 val ppterm_in_context:
  83  substitution -> Cic.term -> (Cic.name option) list -> string
  84 val ppmetasenv: ?sep: string -> Cic.metasenv -> substitution -> string
  85
  86 (** {2 Format-like pretty printers}
  87  * As above with prototypes suitable for toplevel/ocamldebug printers. No
  88  * subsitutions are applied here since such printers are required to be invoked
  89  * with only one argument.
  90  *)
  91
  92 val fppsubst: Format.formatter -> substitution -> unit
  93 val fppterm: Format.formatter -> Cic.term -> unit
  94 val fppmetasenv: Format.formatter -> Cic.metasenv -> unit
  95