(* Copyright (C) 2004, HELM Team.
 * 
 * This file is part of HELM, an Hypertextual, Electronic
 * Library of Mathematics, developed at the Computer Science
 * Department, University of Bologna, Italy.
 * 
 * HELM is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 * 
 * HELM is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with HELM; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston,
 * MA  02111-1307, USA.
 * 
 * For details, see the HELM World-Wide-Web page,
 * http://helm.cs.unibo.it/
 *)

exception Meta_not_found of int
exception Subst_not_found of int

val lookup_meta: int -> Cic.metasenv -> Cic.conjecture
val lookup_subst: int -> Cic.substitution -> Cic.context * Cic.term * Cic.term
val exists_meta: int -> Cic.metasenv -> bool
val clean_up_local_context :
  Cic.substitution -> Cic.metasenv -> int -> (Cic.term option) list 
  -> (Cic.term option) list

val is_closed : Cic.term -> bool
val is_meta_closed : Cic.term -> bool

  (** @raise Failure "not enough prods" *)
val strip_prods: int -> Cic.term -> Cic.term

(** conversions between terms which are fully representable as uris (Var, Const,
 * Mutind, and MutConstruct) and corresponding tree representations *)
val term_of_uri: string -> Cic.term (** @raise UriManager.IllFormedUri *)
val uri_of_term: Cic.term -> string (** @raise Invalid_argument "uri_of_term" *)

  (** packing/unpacking of several terms into a single one *)
val pack: Cic.term list -> Cic.term
val unpack: Cic.term -> Cic.term list

(** {2 Cic selectors} *)

val params_of_obj: Cic.obj -> UriManager.uri list
val attributes_of_obj: Cic.obj -> Cic.attribute list

(** {2 Contexts}
 * A context is a Cic term in which Cic.Implicit terms annotated with `Hole
 * appears *)

(** create a context from a term and a list of subterm.
* @param equality equality function used while walking the term. Defaults to
* physical equality (==) *)
val context_of:
  ?equality:(Cic.term -> Cic.term -> bool) -> term:Cic.term -> Cic.term list ->
    Cic.term

(** select all subterms of a given term matching a given context (i.e. subtrees
* rooted at context's holes *)
val select: term:Cic.term -> context:Cic.term -> Cic.term list