components/ng_kernel/nCicSubstitution.mli

   1 (* Copyright (C) 2000, 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://cs.unibo.it/helm/.
  24  *)
  25
  26 (* lift n t                                                              *)
  27 (*  lifts [t] of [n]                                                     *)
  28 (*  [from] default 1, lifts only indexes >= [from]                       *)
  29 (*  NOTE: the opposite function (delift_rels) is defined in CicMetaSubst *)
  30 (*  since it needs to restrict the metavariables in case of failure      *)
  31 val lift : ?from:int -> int -> NCic.term -> NCic.term
  32
  33 (* subst t1 t2                                                          *)
  34 (*  substitutes [t1] for [Rel 1] in [t2]                                *)
  35 (*  if avoid_beta_redexes is true (default: false) no new beta redexes  *)
  36 (*  are generated. WARNING: the substitution can diverge when t2 is not *)
  37 (*  well typed and avoid_beta_redexes is true.                          *)
  38 val subst : ?avoid_beta_redexes:bool -> NCic.term -> NCic.term -> NCic.term
  39
  40 (* psubst [avoid] [delift] [lift_args] [t] [map_arg] [args]
  41  *  [avoid] : do not leave newly created beta-redexes, default false
  42  *  [delift] : perform delifting
  43  *  [t] : term to fill in
  44  *  [lift_args] : lift argument after map_arg is applied
  45  *  [args] : stuff to substitute
  46  *  [map_arg] : map the argument to obtain a term
  47  *    the function is ReductionStrategy.from_env_for_unwind when psubst is
  48  *    used to implement nCicReduction.unwind'                              *)
  49 val psubst :
  50   ?avoid_beta_redexes:bool -> bool -> int ->
  51   ('a -> NCic.term) -> 'a list -> NCic.term ->
  52     NCic.term
  53
  54 (* subst_meta (n, Ctx [t_1 ; ... ; t_n]) t                                  *)
  55 (*  returns the term [t] where [Rel i] is substituted with [t_i] lifted by n *)
  56 (*  [t_i] is lifted as usual when it crosses an abstraction                  *)
  57 (* subst_meta (n, Irl _) t -> lift n t                                        *)
  58 val subst_meta : NCic.local_context -> NCic.term -> NCic.term
  59