src/Pure/facts.ML
author wenzelm
Tue Apr 15 18:49:18 2008 +0200 (2008-04-15)
changeset 26664 167d879a89b0
parent 26654 1f711934f221
child 26692 3f48d4f4229f
permissions -rw-r--r--
renamed dest to dest_table, and extern to extern table;
added name space intern/extern;
wenzelm@26281
     1
(*  Title:      Pure/facts.ML
wenzelm@26281
     2
    ID:         $Id$
wenzelm@26281
     3
    Author:     Makarius
wenzelm@26281
     4
wenzelm@26307
     5
Environment of named facts, optionally indexed by proposition.
wenzelm@26281
     6
*)
wenzelm@26281
     7
wenzelm@26281
     8
signature FACTS =
wenzelm@26281
     9
sig
wenzelm@26336
    10
  val the_single: string -> thm list -> thm
wenzelm@26336
    11
  datatype interval = FromTo of int * int | From of int | Single of int
wenzelm@26336
    12
  datatype ref =
wenzelm@26361
    13
    Named of (string * Position.T) * interval list option |
wenzelm@26336
    14
    Fact of string
wenzelm@26361
    15
  val named: string -> ref
wenzelm@26336
    16
  val string_of_ref: ref -> string
wenzelm@26336
    17
  val name_of_ref: ref -> string
wenzelm@26366
    18
  val pos_of_ref: ref -> Position.T
wenzelm@26336
    19
  val map_name_of_ref: (string -> string) -> ref -> ref
wenzelm@26336
    20
  val select: ref -> thm list -> thm list
wenzelm@26336
    21
  val selections: string * thm list -> (ref * thm) list
wenzelm@26281
    22
  type T
wenzelm@26393
    23
  val empty: T
wenzelm@26281
    24
  val space_of: T -> NameSpace.T
wenzelm@26664
    25
  val intern: T -> xstring -> string
wenzelm@26664
    26
  val extern: T -> string -> xstring
wenzelm@26393
    27
  val lookup: Context.generic -> T -> string -> thm list option
wenzelm@26664
    28
  val dest_table: T -> (string * thm list) list
wenzelm@26664
    29
  val extern_table: T -> (xstring * thm list) list
wenzelm@26281
    30
  val props: T -> thm list
wenzelm@26281
    31
  val could_unify: T -> term -> thm list
wenzelm@26281
    32
  val merge: T * T -> T
wenzelm@26307
    33
  val add_global: NameSpace.naming -> string * thm list -> T -> T
wenzelm@26307
    34
  val add_local: bool -> NameSpace.naming -> string * thm list -> T -> T
wenzelm@26393
    35
  val add_dynamic: NameSpace.naming -> string * (Context.generic -> thm list) -> T -> T
wenzelm@26654
    36
  val del: string -> T -> T
wenzelm@26654
    37
  val hide: bool -> string -> T -> T
wenzelm@26281
    38
end;
wenzelm@26281
    39
wenzelm@26281
    40
structure Facts: FACTS =
wenzelm@26281
    41
struct
wenzelm@26281
    42
wenzelm@26336
    43
(** fact references **)
wenzelm@26336
    44
wenzelm@26336
    45
fun the_single _ [th] : thm = th
wenzelm@26336
    46
  | the_single name _ = error ("Single theorem expected " ^ quote name);
wenzelm@26336
    47
wenzelm@26336
    48
wenzelm@26336
    49
(* datatype interval *)
wenzelm@26336
    50
wenzelm@26336
    51
datatype interval =
wenzelm@26336
    52
  FromTo of int * int |
wenzelm@26336
    53
  From of int |
wenzelm@26336
    54
  Single of int;
wenzelm@26336
    55
wenzelm@26336
    56
fun string_of_interval (FromTo (i, j)) = string_of_int i ^ "-" ^ string_of_int j
wenzelm@26336
    57
  | string_of_interval (From i) = string_of_int i ^ "-"
wenzelm@26336
    58
  | string_of_interval (Single i) = string_of_int i;
wenzelm@26336
    59
wenzelm@26336
    60
fun interval n iv =
wenzelm@26336
    61
  let fun err () = raise Fail ("Bad interval specification " ^ string_of_interval iv) in
wenzelm@26336
    62
    (case iv of
wenzelm@26336
    63
      FromTo (i, j) => if i <= j then i upto j else err ()
wenzelm@26336
    64
    | From i => if i <= n then i upto n else err ()
wenzelm@26336
    65
    | Single i => [i])
wenzelm@26336
    66
  end;
wenzelm@26336
    67
wenzelm@26336
    68
wenzelm@26336
    69
(* datatype ref *)
wenzelm@26336
    70
wenzelm@26336
    71
datatype ref =
wenzelm@26361
    72
  Named of (string * Position.T) * interval list option |
wenzelm@26336
    73
  Fact of string;
wenzelm@26336
    74
wenzelm@26361
    75
fun named name = Named ((name, Position.none), NONE);
wenzelm@26361
    76
wenzelm@26366
    77
fun name_pos_of_ref (Named (name_pos, _)) = name_pos
wenzelm@26366
    78
  | name_pos_of_ref (Fact _) = error "Illegal literal fact";
wenzelm@26366
    79
wenzelm@26366
    80
val name_of_ref = #1 o name_pos_of_ref;
wenzelm@26366
    81
val pos_of_ref = #2 o name_pos_of_ref;
wenzelm@26336
    82
wenzelm@26361
    83
fun map_name_of_ref f (Named ((name, pos), is)) = Named ((f name, pos), is)
wenzelm@26336
    84
  | map_name_of_ref _ r = r;
wenzelm@26336
    85
wenzelm@26361
    86
fun string_of_ref (Named ((name, _), NONE)) = name
wenzelm@26361
    87
  | string_of_ref (Named ((name, _), SOME is)) =
wenzelm@26336
    88
      name ^ enclose "(" ")" (commas (map string_of_interval is))
wenzelm@26336
    89
  | string_of_ref (Fact _) = error "Illegal literal fact";
wenzelm@26336
    90
wenzelm@26336
    91
wenzelm@26336
    92
(* select *)
wenzelm@26336
    93
wenzelm@26336
    94
fun select (Fact _) ths = ths
wenzelm@26336
    95
  | select (Named (_, NONE)) ths = ths
wenzelm@26361
    96
  | select (Named ((name, pos), SOME ivs)) ths =
wenzelm@26336
    97
      let
wenzelm@26336
    98
        val n = length ths;
wenzelm@26361
    99
        fun err msg =
wenzelm@26361
   100
          error (msg ^ " for " ^ quote name ^ " (length " ^ string_of_int n ^ ")" ^
wenzelm@26361
   101
            Position.str_of pos);
wenzelm@26336
   102
        fun sel i =
wenzelm@26336
   103
          if i < 1 orelse i > n then err ("Bad subscript " ^ string_of_int i)
wenzelm@26336
   104
          else nth ths (i - 1);
wenzelm@26336
   105
        val is = maps (interval n) ivs handle Fail msg => err msg;
wenzelm@26336
   106
      in map sel is end;
wenzelm@26336
   107
wenzelm@26336
   108
wenzelm@26336
   109
(* selections *)
wenzelm@26336
   110
wenzelm@26361
   111
fun selections (name, [th]) = [(Named ((name, Position.none), NONE), th)]
wenzelm@26361
   112
  | selections (name, ths) = map2 (fn i => fn th =>
wenzelm@26361
   113
      (Named ((name, Position.none), SOME [Single i]), th)) (1 upto length ths) ths;
wenzelm@26336
   114
wenzelm@26336
   115
wenzelm@26336
   116
wenzelm@26336
   117
(** fact environment **)
wenzelm@26336
   118
wenzelm@26393
   119
(* datatypes *)
wenzelm@26393
   120
wenzelm@26393
   121
datatype fact = Static of thm list | Dynamic of Context.generic -> thm list;
wenzelm@26281
   122
wenzelm@26281
   123
datatype T = Facts of
wenzelm@26393
   124
 {facts: (fact * serial) NameSpace.table,
wenzelm@26281
   125
  props: thm Net.net};
wenzelm@26281
   126
wenzelm@26281
   127
fun make_facts facts props = Facts {facts = facts, props = props};
wenzelm@26393
   128
val empty = make_facts NameSpace.empty_table Net.empty;
wenzelm@26281
   129
wenzelm@26281
   130
wenzelm@26281
   131
(* named facts *)
wenzelm@26281
   132
wenzelm@26281
   133
fun facts_of (Facts {facts, ...}) = facts;
wenzelm@26281
   134
wenzelm@26281
   135
val space_of = #1 o facts_of;
wenzelm@26393
   136
val table_of = #2 o facts_of;
wenzelm@26393
   137
wenzelm@26664
   138
val intern = NameSpace.intern o space_of;
wenzelm@26664
   139
val extern = NameSpace.extern o space_of;
wenzelm@26664
   140
wenzelm@26393
   141
fun lookup context facts name =
wenzelm@26393
   142
  (case Symtab.lookup (table_of facts) name of
wenzelm@26393
   143
    NONE => NONE
wenzelm@26393
   144
  | SOME (Static ths, _) => SOME ths
wenzelm@26393
   145
  | SOME (Dynamic f, _) => SOME (f context));
wenzelm@26393
   146
wenzelm@26664
   147
fun dest_table facts =
wenzelm@26393
   148
  Symtab.fold (fn (name, (Static ths, _)) => cons (name, ths) | _ => I) (table_of facts) [];
wenzelm@26393
   149
wenzelm@26664
   150
fun extern_table facts =
wenzelm@26664
   151
  dest_table facts
wenzelm@26664
   152
  |> map (apfst (extern facts))
wenzelm@26393
   153
  |> sort_wrt #1;
wenzelm@26281
   154
wenzelm@26281
   155
wenzelm@26281
   156
(* indexed props *)
wenzelm@26281
   157
wenzelm@26281
   158
val prop_ord = Term.term_ord o pairself Thm.full_prop_of;
wenzelm@26281
   159
wenzelm@26281
   160
fun props (Facts {props, ...}) = sort_distinct prop_ord (Net.content props);
wenzelm@26281
   161
fun could_unify (Facts {props, ...}) = Net.unify_term props;
wenzelm@26281
   162
wenzelm@26281
   163
wenzelm@26393
   164
(* merge facts *)
wenzelm@26281
   165
wenzelm@26393
   166
fun err_dup_fact name = error ("Duplicate fact " ^ quote name);
wenzelm@26281
   167
wenzelm@26654
   168
fun eq_entry ((Static ths1, _), (Static ths2, _)) = is_equal (list_ord Thm.thm_ord (ths1, ths2))
wenzelm@26654
   169
  | eq_entry ((_, id1: serial), (_, id2)) = id1 = id2;
wenzelm@26654
   170
wenzelm@26281
   171
fun merge (Facts {facts = facts1, props = props1}, Facts {facts = facts2, props = props2}) =
wenzelm@26281
   172
  let
wenzelm@26654
   173
    val facts' = NameSpace.merge_tables eq_entry (facts1, facts2)
wenzelm@26654
   174
      handle Symtab.DUP dup => err_dup_fact dup;
wenzelm@26281
   175
    val props' = Net.merge (is_equal o prop_ord) (props1, props2);
wenzelm@26281
   176
  in make_facts facts' props' end;
wenzelm@26281
   177
wenzelm@26393
   178
wenzelm@26654
   179
(* add static entries *)
wenzelm@26393
   180
wenzelm@26307
   181
fun add permissive do_props naming (name, ths) (Facts {facts, props}) =
wenzelm@26281
   182
  let
wenzelm@26281
   183
    val facts' =
wenzelm@26281
   184
      if name = "" then facts
wenzelm@26281
   185
      else
wenzelm@26281
   186
        let
wenzelm@26281
   187
          val (space, tab) = facts;
wenzelm@26281
   188
          val space' = NameSpace.declare naming name space;
wenzelm@26393
   189
          val entry = (name, (Static ths, serial ()));
wenzelm@26393
   190
          val tab' = (if permissive then Symtab.update else Symtab.update_new) entry tab
wenzelm@26654
   191
            handle Symtab.DUP dup => err_dup_fact dup;
wenzelm@26281
   192
        in (space', tab') end;
wenzelm@26281
   193
    val props' =
wenzelm@26281
   194
      if do_props then fold (fn th => Net.insert_term (K false) (Thm.full_prop_of th, th)) ths props
wenzelm@26281
   195
      else props;
wenzelm@26281
   196
  in make_facts facts' props' end;
wenzelm@26281
   197
wenzelm@26307
   198
val add_global = add false false;
wenzelm@26307
   199
val add_local = add true;
wenzelm@26307
   200
wenzelm@26393
   201
wenzelm@26654
   202
(* add dynamic entries *)
wenzelm@26393
   203
wenzelm@26393
   204
fun add_dynamic naming (name, f) (Facts {facts = (space, tab), props}) =
wenzelm@26290
   205
  let
wenzelm@26393
   206
    val space' = NameSpace.declare naming name space;
wenzelm@26393
   207
    val entry = (name, (Dynamic f, serial ()));
wenzelm@26393
   208
    val tab' = Symtab.update_new entry tab
wenzelm@26393
   209
      handle Symtab.DUP dup => err_dup_fact dup;
wenzelm@26290
   210
  in make_facts (space', tab') props end;
wenzelm@26281
   211
wenzelm@26654
   212
wenzelm@26654
   213
(* remove entries *)
wenzelm@26654
   214
wenzelm@26654
   215
fun del name (Facts {facts = (space, tab), props}) =
wenzelm@26654
   216
  let
wenzelm@26654
   217
    val space' = NameSpace.hide true name space handle ERROR _ => space;
wenzelm@26654
   218
    val tab' = Symtab.delete_safe name tab;
wenzelm@26654
   219
  in make_facts (space', tab') props end;
wenzelm@26654
   220
wenzelm@26654
   221
fun hide fully name (Facts {facts = (space, tab), props}) =
wenzelm@26654
   222
  make_facts (NameSpace.hide fully name space, tab) props;
wenzelm@26654
   223
wenzelm@26281
   224
end;