src/formula.mli

   1 (***********************************************************************)
   2 (*                                                                     *)
   3 (*                               TAToo                                 *)
   4 (*                                                                     *)
   5 (*                     Kim Nguyen, LRI UMR8623                         *)
   6 (*                   Université Paris-Sud & CNRS                       *)
   7 (*                                                                     *)
   8 (*  Copyright 2010-2012 Université Paris-Sud and Centre National de la *)
   9 (*  Recherche Scientifique. All rights reserved.  This file is         *)
  10 (*  distributed under the terms of the GNU Lesser General Public       *)
  11 (*  License, with the special exception on linking described in file   *)
  12 (*  ../LICENSE.                                                        *)
  13 (*                                                                     *)
  14 (***********************************************************************)
  15
  16 (** Implementation of hashconsed Boolean formulae *)
  17
  18 type move = [ `Left |`Right ]
  19 (** Direction for automata predicates *)
  20
  21 type 'hcons expr =
  22     False
  23     | True
  24     | Or of 'hcons * 'hcons
  25     | And of 'hcons * 'hcons
  26     | Atom of (move * bool * State.t)
  27
  28 (** Partial internal representation of a formula,
  29     used for pattern matching *)
  30
  31 type t
  32 (** Abstract type representing hashconsed formulae *)
  33
  34 val hash : t -> int
  35 (** Hash function for formulae *)
  36
  37 val uid : t -> Uid.t
  38 (** Returns a unique ID for formulae *)
  39
  40 val equal : t -> t -> bool
  41 (** Equality over formulae *)
  42
  43 val expr : t -> t expr
  44 (** Equality over formulae *)
  45
  46 val st : t -> StateSet.t * StateSet.t
  47 (** states occuring left and right, positively or negatively *)
  48
  49 val compare : t -> t -> int
  50 (** Comparison of formulae *)
  51
  52 val size : t -> int
  53 (** Syntactic size of the formula *)
  54
  55 val eval_form : (StateSet.t * StateSet.t) -> t -> bool
  56 (** [eval_form (sf,sn) F] evaluates the formula [F] on [(sf,sn)] *)
  57
  58 val infer_form : (StateSet.t * StateSet.t) -> (StateSet.t * StateSet.t) -> t -> bool
  59 (** [eval_form S1 S2 F] infers S1; S2 |- F *)
  60
  61 val print : Format.formatter -> t -> unit
  62 (** Pretty printer *)
  63
  64 val is_true : t -> bool
  65 (** [is_true f] tests whether the formula is the atom True *)
  66
  67 val is_false : t -> bool
  68 (** [is_false f] tests whether the formula is the atom False *)
  69
  70 val true_ : t
  71 (** Atom True *)
  72
  73 val false_ : t
  74 (** Atom False *)
  75
  76 val atom_ : move -> bool -> StateSet.elt -> t
  77 (** [atom_ dir b q] creates a down_left or down_right atom for state
  78     [q]. The atom is positive if [b == true].
  79 *)
  80
  81 val not_ : t -> t
  82 val or_ : t -> t -> t
  83 val and_ : t -> t -> t
  84 (** Boolean connective *)
  85
  86 val of_bool : bool -> t
  87 (** Convert an ocaml Boolean value to a formula *)
  88
  89 module Infix : sig
  90   val ( +| ) : t -> t -> t
  91   val ( *& ) : t -> t -> t
  92   val ( *+ ) : move -> StateSet.elt -> t
  93   val ( *- ) : move -> StateSet.elt -> t
  94 end
  95 (** Module to facilitate infix notations of formulae.
  96     Just [open Formla.Infix] and write:
  97     [let f = `Left *+ q1 +| `Right *+ q2 in ...]
  98 *)