src/Pure/tactical.ML
author wenzelm
Thu Sep 02 00:48:07 2010 +0200 (2010-09-02)
changeset 38980 af73cf0dc31f
parent 34885 6587c24ef6d8
child 39125 f45d332a90e3
permissions -rw-r--r--
turned show_question_marks into proper configuration option;
show_question_marks only affects regular type/term pretty printing, not raw Term.string_of_vname;
tuned;
wenzelm@32169
     1
(*  Title:      Pure/tactical.ML
paulson@2244
     2
    Author:     Lawrence C Paulson, Cambridge University Computer Laboratory
clasohm@0
     3
wenzelm@16179
     4
Tacticals.
clasohm@0
     5
*)
clasohm@0
     6
wenzelm@4602
     7
infix 1 THEN THEN' THEN_ALL_NEW;
clasohm@0
     8
infix 0 ORELSE APPEND INTLEAVE ORELSE' APPEND' INTLEAVE';
lcp@671
     9
infix 0 THEN_ELSE;
lcp@671
    10
clasohm@0
    11
signature TACTICAL =
wenzelm@11916
    12
sig
wenzelm@23538
    13
  type tactic = thm -> thm Seq.seq
wenzelm@23538
    14
  val THEN: tactic * tactic -> tactic
wenzelm@23538
    15
  val ORELSE: tactic * tactic -> tactic
wenzelm@23538
    16
  val APPEND: tactic * tactic -> tactic
wenzelm@23538
    17
  val INTLEAVE: tactic * tactic -> tactic
wenzelm@23538
    18
  val THEN_ELSE: tactic * (tactic*tactic) -> tactic
wenzelm@23538
    19
  val THEN': ('a -> tactic) * ('a -> tactic) -> 'a -> tactic
wenzelm@23538
    20
  val ORELSE': ('a -> tactic) * ('a -> tactic) -> 'a -> tactic
wenzelm@23538
    21
  val APPEND': ('a -> tactic) * ('a -> tactic) -> 'a -> tactic
wenzelm@23538
    22
  val INTLEAVE': ('a -> tactic) * ('a -> tactic) -> 'a -> tactic
wenzelm@23538
    23
  val all_tac: tactic
wenzelm@23538
    24
  val no_tac: tactic
wenzelm@23538
    25
  val DETERM: tactic -> tactic
wenzelm@23538
    26
  val COND: (thm -> bool) -> tactic -> tactic -> tactic
wenzelm@23538
    27
  val TRY: tactic -> tactic
wenzelm@23538
    28
  val EVERY: tactic list -> tactic
wenzelm@23538
    29
  val EVERY': ('a -> tactic) list -> 'a -> tactic
wenzelm@23538
    30
  val EVERY1: (int -> tactic) list -> tactic
wenzelm@23538
    31
  val FIRST: tactic list -> tactic
wenzelm@23538
    32
  val FIRST': ('a -> tactic) list -> 'a -> tactic
wenzelm@23538
    33
  val FIRST1: (int -> tactic) list -> tactic
wenzelm@23538
    34
  val RANGE: (int -> tactic) list -> int -> tactic
wenzelm@23538
    35
  val print_tac: string -> tactic
wenzelm@23538
    36
  val pause_tac: tactic
wenzelm@32738
    37
  val trace_REPEAT: bool Unsynchronized.ref
wenzelm@32738
    38
  val suppress_tracing: bool Unsynchronized.ref
wenzelm@32738
    39
  val tracify: bool Unsynchronized.ref -> tactic -> tactic
wenzelm@23538
    40
  val traced_tac: (thm -> (thm * thm Seq.seq) option) -> tactic
wenzelm@23538
    41
  val DETERM_UNTIL: (thm -> bool) -> tactic -> tactic
wenzelm@23538
    42
  val REPEAT_DETERM_N: int -> tactic -> tactic
wenzelm@23538
    43
  val REPEAT_DETERM: tactic -> tactic
wenzelm@23538
    44
  val REPEAT: tactic -> tactic
wenzelm@23538
    45
  val REPEAT_DETERM1: tactic -> tactic
wenzelm@23538
    46
  val REPEAT1: tactic -> tactic
wenzelm@23538
    47
  val FILTER: (thm -> bool) -> tactic -> tactic
wenzelm@23538
    48
  val CHANGED: tactic -> tactic
wenzelm@23538
    49
  val CHANGED_PROP: tactic -> tactic
wenzelm@23538
    50
  val ALLGOALS: (int -> tactic) -> tactic
wenzelm@23538
    51
  val SOMEGOAL: (int -> tactic) -> tactic
wenzelm@23538
    52
  val FIRSTGOAL: (int -> tactic) -> tactic
wenzelm@23538
    53
  val REPEAT_SOME: (int -> tactic) -> tactic
wenzelm@23538
    54
  val REPEAT_DETERM_SOME: (int -> tactic) -> tactic
wenzelm@23538
    55
  val REPEAT_FIRST: (int -> tactic) -> tactic
lcp@703
    56
  val REPEAT_DETERM_FIRST: (int -> tactic) -> tactic
wenzelm@23538
    57
  val TRYALL: (int -> tactic) -> tactic
wenzelm@23538
    58
  val CSUBGOAL: ((cterm * int) -> tactic) -> int -> tactic
wenzelm@23538
    59
  val SUBGOAL: ((term * int) -> tactic) -> int -> tactic
wenzelm@23538
    60
  val CHANGED_GOAL: (int -> tactic) -> int -> tactic
wenzelm@34885
    61
  val SOLVED': (int -> tactic) -> int -> tactic
wenzelm@23538
    62
  val THEN_ALL_NEW: (int -> tactic) * (int -> tactic) -> int -> tactic
wenzelm@23538
    63
  val REPEAT_ALL_NEW: (int -> tactic) -> int -> tactic
wenzelm@23538
    64
  val PRIMSEQ: (thm -> thm Seq.seq) -> tactic
wenzelm@23538
    65
  val PRIMITIVE: (thm -> thm) -> tactic
wenzelm@23538
    66
  val SINGLE: tactic -> thm -> thm option
wenzelm@23538
    67
  val CONVERSION: conv -> int -> tactic
wenzelm@11916
    68
end;
clasohm@0
    69
wenzelm@13108
    70
structure Tactical : TACTICAL =
clasohm@0
    71
struct
clasohm@0
    72
clasohm@0
    73
(**** Tactics ****)
clasohm@0
    74
clasohm@0
    75
(*A tactic maps a proof tree to a sequence of proof trees:
clasohm@0
    76
    if length of sequence = 0 then the tactic does not apply;
clasohm@0
    77
    if length > 1 then backtracking on the alternatives can occur.*)
clasohm@0
    78
wenzelm@4270
    79
type tactic = thm -> thm Seq.seq;
clasohm@0
    80
clasohm@0
    81
clasohm@0
    82
(*** LCF-style tacticals ***)
clasohm@0
    83
clasohm@0
    84
(*the tactical THEN performs one tactic followed by another*)
wenzelm@17344
    85
fun (tac1 THEN tac2) st = Seq.maps tac2 (tac1 st);
clasohm@0
    86
clasohm@0
    87
clasohm@0
    88
(*The tactical ORELSE uses the first tactic that returns a nonempty sequence.
clasohm@0
    89
  Like in LCF, ORELSE commits to either tac1 or tac2 immediately.
clasohm@0
    90
  Does not backtrack to tac2 if tac1 was initially chosen. *)
paulson@1502
    91
fun (tac1 ORELSE tac2) st =
wenzelm@4270
    92
    case Seq.pull(tac1 st) of
skalberg@15531
    93
        NONE       => tac2 st
wenzelm@4270
    94
      | sequencecell => Seq.make(fn()=> sequencecell);
clasohm@0
    95
clasohm@0
    96
clasohm@0
    97
(*The tactical APPEND combines the results of two tactics.
clasohm@0
    98
  Like ORELSE, but allows backtracking on both tac1 and tac2.
clasohm@0
    99
  The tactic tac2 is not applied until needed.*)
wenzelm@13108
   100
fun (tac1 APPEND tac2) st =
wenzelm@19861
   101
  Seq.append (tac1 st) (Seq.make(fn()=> Seq.pull (tac2 st)));
clasohm@0
   102
clasohm@0
   103
(*Like APPEND, but interleaves results of tac1 and tac2.*)
wenzelm@13108
   104
fun (tac1 INTLEAVE tac2) st =
wenzelm@4270
   105
    Seq.interleave(tac1 st,
wenzelm@4270
   106
                        Seq.make(fn()=> Seq.pull (tac2 st)));
clasohm@0
   107
lcp@671
   108
(*Conditional tactic.
paulson@2244
   109
        tac1 ORELSE tac2 = tac1 THEN_ELSE (all_tac, tac2)
paulson@2244
   110
        tac1 THEN tac2   = tac1 THEN_ELSE (tac2, no_tac)
lcp@671
   111
*)
wenzelm@13108
   112
fun (tac THEN_ELSE (tac1, tac2)) st =
wenzelm@4270
   113
    case Seq.pull(tac st) of
wenzelm@17344
   114
        NONE    => tac2 st                                   (*failed; try tactic 2*)
wenzelm@17344
   115
      | seqcell => Seq.maps tac1 (Seq.make(fn()=> seqcell)); (*succeeded; use tactic 1*)
lcp@671
   116
lcp@671
   117
clasohm@0
   118
(*Versions for combining tactic-valued functions, as in
clasohm@0
   119
     SOMEGOAL (resolve_tac rls THEN' assume_tac) *)
paulson@1502
   120
fun (tac1 THEN' tac2) x = tac1 x THEN tac2 x;
paulson@1502
   121
fun (tac1 ORELSE' tac2) x = tac1 x ORELSE tac2 x;
paulson@1502
   122
fun (tac1 APPEND' tac2) x = tac1 x APPEND tac2 x;
paulson@1502
   123
fun (tac1 INTLEAVE' tac2) x = tac1 x INTLEAVE tac2 x;
clasohm@0
   124
clasohm@0
   125
(*passes all proofs through unchanged;  identity of THEN*)
wenzelm@4270
   126
fun all_tac st = Seq.single st;
clasohm@0
   127
clasohm@0
   128
(*passes no proofs through;  identity of ORELSE and APPEND*)
wenzelm@4270
   129
fun no_tac st  = Seq.empty;
clasohm@0
   130
clasohm@0
   131
clasohm@0
   132
(*Make a tactic deterministic by chopping the tail of the proof sequence*)
wenzelm@12851
   133
fun DETERM tac = Seq.DETERM tac;
clasohm@0
   134
clasohm@0
   135
(*Conditional tactical: testfun controls which tactic to use next.
clasohm@0
   136
  Beware: due to eager evaluation, both thentac and elsetac are evaluated.*)
paulson@1502
   137
fun COND testfun thenf elsef = (fn prf =>
clasohm@0
   138
    if testfun prf then  thenf prf   else  elsef prf);
clasohm@0
   139
clasohm@0
   140
(*Do the tactic or else do nothing*)
clasohm@0
   141
fun TRY tac = tac ORELSE all_tac;
clasohm@0
   142
paulson@2672
   143
(*** List-oriented tactics ***)
paulson@2672
   144
paulson@2672
   145
local
paulson@2672
   146
  (*This version of EVERY avoids backtracking over repeated states*)
paulson@2672
   147
wenzelm@13108
   148
  fun EVY (trail, []) st =
skalberg@15531
   149
        Seq.make (fn()=> SOME(st,
wenzelm@13108
   150
                        Seq.make (fn()=> Seq.pull (evyBack trail))))
wenzelm@13108
   151
    | EVY (trail, tac::tacs) st =
wenzelm@13108
   152
          case Seq.pull(tac st) of
skalberg@15531
   153
              NONE    => evyBack trail              (*failed: backtrack*)
skalberg@15531
   154
            | SOME(st',q) => EVY ((st',q,tacs)::trail, tacs) st'
wenzelm@4270
   155
  and evyBack [] = Seq.empty (*no alternatives*)
paulson@2672
   156
    | evyBack ((st',q,tacs)::trail) =
wenzelm@13108
   157
          case Seq.pull q of
skalberg@15531
   158
              NONE        => evyBack trail
wenzelm@22360
   159
            | SOME(st,q') => if Thm.eq_thm (st',st)
wenzelm@13108
   160
                             then evyBack ((st',q',tacs)::trail)
wenzelm@13108
   161
                             else EVY ((st,q',tacs)::trail, tacs) st
paulson@2672
   162
in
paulson@2672
   163
paulson@2672
   164
(* EVERY [tac1,...,tacn]   equals    tac1 THEN ... THEN tacn   *)
paulson@2672
   165
fun EVERY tacs = EVY ([], tacs);
paulson@2672
   166
end;
oheimb@2627
   167
clasohm@0
   168
paulson@1502
   169
(* EVERY' [tac1,...,tacn] i  equals    tac1 i THEN ... THEN tacn i   *)
paulson@2672
   170
fun EVERY' tacs i = EVERY (map (fn f => f i) tacs);
clasohm@0
   171
clasohm@0
   172
(*Apply every tactic to 1*)
paulson@1502
   173
fun EVERY1 tacs = EVERY' tacs 1;
clasohm@0
   174
clasohm@0
   175
(* FIRST [tac1,...,tacn]   equals    tac1 ORELSE ... ORELSE tacn   *)
wenzelm@23178
   176
fun FIRST tacs = fold_rev (curry op ORELSE) tacs no_tac;
clasohm@0
   177
paulson@1502
   178
(* FIRST' [tac1,...,tacn] i  equals    tac1 i ORELSE ... ORELSE tacn i   *)
wenzelm@23178
   179
fun FIRST' tacs = fold_rev (curry op ORELSE') tacs (K no_tac);
clasohm@0
   180
clasohm@0
   181
(*Apply first tactic to 1*)
paulson@1502
   182
fun FIRST1 tacs = FIRST' tacs 1;
clasohm@0
   183
wenzelm@11916
   184
(*Apply tactics on consecutive subgoals*)
wenzelm@11916
   185
fun RANGE [] _ = all_tac
wenzelm@11916
   186
  | RANGE (tac :: tacs) i = RANGE tacs (i + 1) THEN tac i;
wenzelm@11916
   187
clasohm@0
   188
clasohm@0
   189
(*** Tracing tactics ***)
clasohm@0
   190
clasohm@0
   191
(*Print the current proof state and pass it on.*)
wenzelm@32145
   192
fun print_tac msg st =
wenzelm@32145
   193
 (tracing (msg ^ "\n" ^
wenzelm@32145
   194
    Pretty.string_of (Pretty.chunks
wenzelm@32187
   195
      (Goal_Display.pretty_goals_without_context (! Goal_Display.goals_limit) st)));
wenzelm@32145
   196
  Seq.single st);
clasohm@0
   197
clasohm@0
   198
(*Pause until a line is typed -- if non-empty then fail. *)
wenzelm@13108
   199
fun pause_tac st =
wenzelm@12262
   200
  (tracing "** Press RETURN to continue:";
wenzelm@24359
   201
   if TextIO.inputLine TextIO.stdIn = SOME "\n" then Seq.single st
wenzelm@12262
   202
   else (tracing "Goodbye";  Seq.empty));
clasohm@0
   203
clasohm@0
   204
exception TRACE_EXIT of thm
clasohm@0
   205
and TRACE_QUIT;
clasohm@0
   206
lcp@631
   207
(*Tracing flags*)
wenzelm@32738
   208
val trace_REPEAT= Unsynchronized.ref false
wenzelm@32738
   209
and suppress_tracing = Unsynchronized.ref false;
lcp@631
   210
clasohm@0
   211
(*Handle all tracing commands for current state and tactic *)
wenzelm@13108
   212
fun exec_trace_command flag (tac, st) =
wenzelm@24359
   213
   case TextIO.inputLine TextIO.stdIn of
wenzelm@23139
   214
       SOME "\n" => tac st
wenzelm@23139
   215
     | SOME "f\n" => Seq.empty
wenzelm@32738
   216
     | SOME "o\n" => (flag := false;  tac st)
wenzelm@32738
   217
     | SOME "s\n" => (suppress_tracing := true;  tac st)
wenzelm@23139
   218
     | SOME "x\n" => (tracing "Exiting now";  raise (TRACE_EXIT st))
wenzelm@23139
   219
     | SOME "quit\n" => raise TRACE_QUIT
wenzelm@12262
   220
     | _     => (tracing
clasohm@0
   221
"Type RETURN to continue or...\n\
clasohm@0
   222
\     f    - to fail here\n\
clasohm@0
   223
\     o    - to switch tracing off\n\
lcp@631
   224
\     s    - to suppress tracing until next entry to a tactical\n\
clasohm@0
   225
\     x    - to exit at this point\n\
clasohm@0
   226
\     quit - to abort this tracing run\n\
paulson@1502
   227
\** Well? "     ;  exec_trace_command flag (tac, st));
clasohm@0
   228
clasohm@0
   229
clasohm@0
   230
(*Extract from a tactic, a thm->thm seq function that handles tracing*)
paulson@1502
   231
fun tracify flag tac st =
wenzelm@32145
   232
  if !flag andalso not (!suppress_tracing) then
wenzelm@32168
   233
    (tracing (Pretty.string_of (Pretty.chunks
wenzelm@32187
   234
        (Goal_Display.pretty_goals_without_context (! Goal_Display.goals_limit) st @
wenzelm@32168
   235
          [Pretty.str "** Press RETURN to continue:"])));
wenzelm@32168
   236
     exec_trace_command flag (tac, st))
paulson@1502
   237
  else tac st;
clasohm@0
   238
clasohm@0
   239
(*Create a tactic whose outcome is given by seqf, handling TRACE_EXIT*)
wenzelm@13108
   240
fun traced_tac seqf st =
lcp@631
   241
    (suppress_tracing := false;
wenzelm@4270
   242
     Seq.make (fn()=> seqf st
skalberg@15531
   243
                         handle TRACE_EXIT st' => SOME(st', Seq.empty)));
clasohm@0
   244
clasohm@0
   245
oheimb@8149
   246
(*Deterministic DO..UNTIL: only retains the first outcome; tail recursive.
oheimb@8149
   247
  Forces repitition until predicate on state is fulfilled.*)
wenzelm@13108
   248
fun DETERM_UNTIL p tac =
oheimb@8149
   249
let val tac = tracify trace_REPEAT tac
skalberg@15531
   250
    fun drep st = if p st then SOME (st, Seq.empty)
oheimb@8149
   251
                          else (case Seq.pull(tac st) of
skalberg@15531
   252
                                  NONE        => NONE
skalberg@15531
   253
                                | SOME(st',_) => drep st')
oheimb@8149
   254
in  traced_tac drep  end;
oheimb@8149
   255
wenzelm@13108
   256
(*Deterministic REPEAT: only retains the first outcome;
lcp@703
   257
  uses less space than REPEAT; tail recursive.
lcp@703
   258
  If non-negative, n bounds the number of repetitions.*)
wenzelm@13108
   259
fun REPEAT_DETERM_N n tac =
paulson@1502
   260
  let val tac = tracify trace_REPEAT tac
skalberg@15531
   261
      fun drep 0 st = SOME(st, Seq.empty)
paulson@2244
   262
        | drep n st =
wenzelm@4270
   263
           (case Seq.pull(tac st) of
skalberg@15531
   264
                NONE       => SOME(st, Seq.empty)
skalberg@15531
   265
              | SOME(st',_) => drep (n-1) st')
lcp@703
   266
  in  traced_tac (drep n)  end;
lcp@703
   267
lcp@703
   268
(*Allows any number of repetitions*)
lcp@703
   269
val REPEAT_DETERM = REPEAT_DETERM_N ~1;
clasohm@0
   270
clasohm@0
   271
(*General REPEAT: maintains a stack of alternatives; tail recursive*)
wenzelm@13108
   272
fun REPEAT tac =
paulson@1502
   273
  let val tac = tracify trace_REPEAT tac
wenzelm@13108
   274
      fun rep qs st =
wenzelm@4270
   275
        case Seq.pull(tac st) of
skalberg@15531
   276
            NONE       => SOME(st, Seq.make(fn()=> repq qs))
skalberg@15531
   277
          | SOME(st',q) => rep (q::qs) st'
skalberg@15531
   278
      and repq [] = NONE
wenzelm@4270
   279
        | repq(q::qs) = case Seq.pull q of
skalberg@15531
   280
            NONE       => repq qs
skalberg@15531
   281
          | SOME(st,q) => rep (q::qs) st
clasohm@0
   282
  in  traced_tac (rep [])  end;
clasohm@0
   283
clasohm@0
   284
(*Repeat 1 or more times*)
lcp@703
   285
fun REPEAT_DETERM1 tac = DETERM tac THEN REPEAT_DETERM tac;
clasohm@0
   286
fun REPEAT1 tac = tac THEN REPEAT tac;
clasohm@0
   287
clasohm@0
   288
clasohm@0
   289
(** Filtering tacticals **)
clasohm@0
   290
wenzelm@4270
   291
fun FILTER pred tac st = Seq.filter pred (tac st);
clasohm@0
   292
paulson@13650
   293
(*Accept only next states that change the theorem somehow*)
wenzelm@13108
   294
fun CHANGED tac st =
wenzelm@13108
   295
  let fun diff st' = not (Thm.eq_thm (st, st'));
wenzelm@13108
   296
  in Seq.filter diff (tac st) end;
clasohm@0
   297
paulson@13650
   298
(*Accept only next states that change the theorem's prop field
paulson@13650
   299
  (changes to signature, hyps, etc. don't count)*)
wenzelm@13108
   300
fun CHANGED_PROP tac st =
wenzelm@22360
   301
  let fun diff st' = not (Thm.eq_thm_prop (st, st'));
wenzelm@13108
   302
  in Seq.filter diff (tac st) end;
wenzelm@10821
   303
clasohm@0
   304
clasohm@0
   305
(*** Tacticals based on subgoal numbering ***)
clasohm@0
   306
wenzelm@13108
   307
(*For n subgoals, performs tac(n) THEN ... THEN tac(1)
paulson@1502
   308
  Essential to work backwards since tac(i) may add/delete subgoals at i. *)
wenzelm@13108
   309
fun ALLGOALS tac st =
paulson@1502
   310
  let fun doall 0 = all_tac
paulson@2244
   311
        | doall n = tac(n) THEN doall(n-1)
paulson@1502
   312
  in  doall(nprems_of st)st  end;
clasohm@0
   313
paulson@1502
   314
(*For n subgoals, performs tac(n) ORELSE ... ORELSE tac(1)  *)
wenzelm@13108
   315
fun SOMEGOAL tac st =
paulson@1502
   316
  let fun find 0 = no_tac
paulson@2244
   317
        | find n = tac(n) ORELSE find(n-1)
paulson@1502
   318
  in  find(nprems_of st)st  end;
clasohm@0
   319
paulson@1502
   320
(*For n subgoals, performs tac(1) ORELSE ... ORELSE tac(n).
clasohm@0
   321
  More appropriate than SOMEGOAL in some cases.*)
wenzelm@13108
   322
fun FIRSTGOAL tac st =
paulson@1502
   323
  let fun find (i,n) = if i>n then no_tac else  tac(i) ORELSE find (i+1,n)
paulson@1502
   324
  in  find(1, nprems_of st)st  end;
clasohm@0
   325
paulson@1502
   326
(*Repeatedly solve some using tac. *)
paulson@1502
   327
fun REPEAT_SOME tac = REPEAT1 (SOMEGOAL (REPEAT1 o tac));
paulson@1502
   328
fun REPEAT_DETERM_SOME tac = REPEAT_DETERM1 (SOMEGOAL (REPEAT_DETERM1 o tac));
clasohm@0
   329
paulson@1502
   330
(*Repeatedly solve the first possible subgoal using tac. *)
paulson@1502
   331
fun REPEAT_FIRST tac = REPEAT1 (FIRSTGOAL (REPEAT1 o tac));
paulson@1502
   332
fun REPEAT_DETERM_FIRST tac = REPEAT_DETERM1 (FIRSTGOAL (REPEAT_DETERM1 o tac));
clasohm@0
   333
paulson@1502
   334
(*For n subgoals, tries to apply tac to n,...1  *)
paulson@1502
   335
fun TRYALL tac = ALLGOALS (TRY o tac);
clasohm@0
   336
clasohm@0
   337
clasohm@0
   338
(*Make a tactic for subgoal i, if there is one.  *)
wenzelm@23224
   339
fun CSUBGOAL goalfun i st =
wenzelm@23224
   340
  (case SOME (Thm.cprem_of st i) handle THM _ => NONE of
wenzelm@16510
   341
    SOME goal => goalfun (goal, i) st
wenzelm@16510
   342
  | NONE => Seq.empty);
clasohm@0
   343
wenzelm@23224
   344
fun SUBGOAL goalfun =
wenzelm@23224
   345
  CSUBGOAL (fn (goal, i) => goalfun (Thm.term_of goal, i));
wenzelm@23224
   346
paulson@5141
   347
(*Returns all states that have changed in subgoal i, counted from the LAST
paulson@5141
   348
  subgoal.  For stac, for example.*)
wenzelm@13108
   349
fun CHANGED_GOAL tac i st =
wenzelm@30145
   350
    let val np = Thm.nprems_of st
paulson@7686
   351
        val d = np-i                 (*distance from END*)
wenzelm@30145
   352
        val t = Thm.term_of (Thm.cprem_of st i)
wenzelm@13108
   353
        fun diff st' =
wenzelm@30145
   354
            Thm.nprems_of st' - d <= 0   (*the subgoal no longer exists*)
wenzelm@13108
   355
            orelse
wenzelm@30145
   356
             not (Pattern.aeconv (t, Thm.term_of (Thm.cprem_of st' (Thm.nprems_of st' - d))))
paulson@5141
   357
    in  Seq.filter diff (tac i st)  end
paulson@5141
   358
    handle Subscript => Seq.empty  (*no subgoal i*);
paulson@5141
   359
wenzelm@34885
   360
(*Returns all states where some subgoals have been solved.  For
wenzelm@34885
   361
  subgoal-based tactics this means subgoal i has been solved
wenzelm@34885
   362
  altogether -- no new subgoals have emerged.*)
wenzelm@34885
   363
fun SOLVED' tac i st =
wenzelm@34885
   364
  tac i st |> Seq.filter (fn st' => nprems_of st' < nprems_of st);
wenzelm@34885
   365
wenzelm@34885
   366
(*Apply second tactic to all subgoals emerging from the first --
wenzelm@34885
   367
  following usual convention for subgoal-based tactics.*)
wenzelm@4602
   368
fun (tac1 THEN_ALL_NEW tac2) i st =
wenzelm@8535
   369
  st |> (tac1 i THEN (fn st' => Seq.INTERVAL tac2 i (i + nprems_of st' - nprems_of st) st'));
wenzelm@4602
   370
wenzelm@34885
   371
(*Repeatedly dig into any emerging subgoals.*)
wenzelm@8341
   372
fun REPEAT_ALL_NEW tac =
wenzelm@8341
   373
  tac THEN_ALL_NEW (TRY o (fn i => REPEAT_ALL_NEW tac i));
wenzelm@8341
   374
skalberg@15006
   375
(*Makes a tactic whose effect on a state is given by thmfun: thm->thm seq.*)
skalberg@15006
   376
fun PRIMSEQ thmfun st =  thmfun st handle THM _ => Seq.empty;
skalberg@15006
   377
skalberg@15006
   378
(*Makes a tactic whose effect on a state is given by thmfun: thm->thm.*)
skalberg@15006
   379
fun PRIMITIVE thmfun = PRIMSEQ (Seq.single o thmfun);
skalberg@15006
   380
wenzelm@23538
   381
(*Inverse (more or less) of PRIMITIVE*)
skalberg@15570
   382
fun SINGLE tacf = Option.map fst o Seq.pull o tacf
haftmann@19455
   383
wenzelm@23538
   384
(*Conversions as tactics*)
wenzelm@23584
   385
fun CONVERSION cv i st = Seq.single (Conv.gconv_rule cv i st)
wenzelm@23561
   386
  handle THM _ => Seq.empty
wenzelm@23561
   387
    | CTERM _ => Seq.empty
wenzelm@23561
   388
    | TERM _ => Seq.empty
wenzelm@23561
   389
    | TYPE _ => Seq.empty;
wenzelm@23538
   390
clasohm@0
   391
end;
paulson@1502
   392
paulson@1502
   393
open Tactical;