]> matita.cs.unibo.it Git - helm.git/blob - helm/software/components/tactics/proofEngineHelpers.mli
new dependences
[helm.git] / helm / software / components / tactics / proofEngineHelpers.mli
1 (* Copyright (C) 2000-2002, 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 exception Bad_pattern of string Lazy.t
27
28 (* Returns the first meta whose number is above the *)
29 (* number of the higher meta.                       *)
30 val new_meta_of_proof : proof:ProofEngineTypes.proof -> int
31
32 val subst_meta_in_proof :
33   ProofEngineTypes.proof ->
34   int -> Cic.term -> Cic.metasenv ->
35   ProofEngineTypes.proof * Cic.metasenv
36 val subst_meta_and_metasenv_in_proof :
37   ProofEngineTypes.proof ->
38   int -> Cic.substitution -> Cic.metasenv ->
39   ProofEngineTypes.proof * Cic.metasenv
40
41 (* returns the list of goals that are in newmetasenv and were not in
42    oldmetasenv *)
43 val compare_metasenvs :
44   oldmetasenv:Cic.metasenv -> newmetasenv:Cic.metasenv -> int list
45
46
47 (** { Patterns }
48  * A pattern is a Cic term in which Cic.Implicit terms annotated with `Hole
49  * appears *)
50
51 (** create a pattern from a term and a list of subterms.
52 * the pattern is granted to have a ? for every subterm that has no selected
53 * subterms
54 * @param equality equality function used while walking the term. Defaults to
55 * physical equality (==) *)
56 val pattern_of:
57  ?equality:(Cic.term -> Cic.term -> bool) -> term:Cic.term -> Cic.term list ->
58    Cic.term
59
60
61 (** select metasenv conjecture pattern
62 * select all subterms of [conjecture] matching [pattern].
63 * It returns the set of matched terms (that can be compared using physical
64 * equality to the subterms of [conjecture]) together with their contexts.
65 * The representation of the set mimics the conjecture type (but for the id):
66 * a list of (possibly removed) hypothesis (without their names) together with
67 * the list of its matched subterms (and their contexts) + the list of matched
68 * subterms of the conclusion with their context. Note: in the result the list
69 * of hypotheses * has an entry for each entry in the context and in the same
70 * order. Of course the list of terms (with their context) associated to one
71 * hypothesis may be empty. 
72 *
73 * @raise Bad_pattern
74 * *)
75 val select:
76  metasenv:Cic.metasenv ->
77  ugraph:CicUniv.universe_graph ->
78  conjecture:Cic.conjecture ->
79  pattern:ProofEngineTypes.lazy_pattern ->
80   Cic.substitution * Cic.metasenv * CicUniv.universe_graph *
81   [ `Decl of (Cic.context * Cic.term) list
82   | `Def of (Cic.context * Cic.term) list * (Cic.context * Cic.term) list
83   ] option list *
84   (Cic.context * Cic.term) list
85
86 (** locate_in_term equality what where context
87 * [what] must match a subterm of [where] according to [equality]
88 * It returns the matched terms together with their contexts in [where]
89 * [equality] defaults to physical equality
90 * [context] must be the context of [where]
91 *)
92 val locate_in_term:
93  ?equality:(Cic.context -> Cic.term -> Cic.term -> bool) ->
94   Cic.term -> where:Cic.term -> Cic.context -> (Cic.context * Cic.term) list
95
96 (** locate_in_conjecture equality what where context
97 * [what] must match a subterm of [where] according to [equality]
98 * It returns the matched terms together with their contexts in [where]
99 * [equality] defaults to physical equality
100 * [context] must be the context of [where]
101 *)
102 val locate_in_conjecture:
103  ?equality:(Cic.context -> Cic.term -> Cic.term -> bool) ->
104   Cic.term -> Cic.conjecture -> (Cic.context * Cic.term) list
105
106 (* returns the index and the type of a premise in a context *)
107 val lookup_type: Cic.metasenv -> Cic.context -> string -> int * Cic.term
108
109 (* orders a metasenv w.r.t. dependency among metas *)
110 val sort_metasenv: Cic.metasenv -> Cic.metasenv
111
112 (* finds an hypothesis by name in the context *)
113 val find_hyp: string -> Cic.context -> Cic.term * Cic.term
114
115 (* sort pattern hypotheses from the smallest to the highest Rel *)
116 val sort_pattern_hyps:
117  Cic.context -> ProofEngineTypes.lazy_pattern -> ProofEngineTypes.lazy_pattern
118
119
120 (* FG: some helper functions ************************************************)
121
122 val get_name: Cic.context -> int -> string option
123
124 val get_rel: Cic.context -> string -> Cic.term option
125
126 (* split_with_whd (c, t) takes a type t typed in the context c and returns
127    [(c_0, t_0); (c_1, t_1); ...; (c_n, t_n)], n where t_0 is the conclusion of
128    t and t_i is the premise of t accessed by Rel i in t_0. 
129    Performes a whd on the conclusion before giving up.
130    Each t_i is returned with a context c_i in wich it is typed
131    split_with_normalize (c, t) normalizes t before operating the split
132    whd is useless here
133 *)
134 val split_with_whd: Cic.context * Cic.term -> 
135                     (Cic.context * Cic.term) list * int
136 val split_with_normalize: Cic.context * Cic.term -> 
137                           (Cic.context * Cic.term) list * int