doc-src/IsarRef/Thy/document/HOL_Specific.tex
author wenzelm
Wed, 25 May 2011 22:12:46 +0200
changeset 44111 dfd4ef8e73f6
parent 43576 528a2ba8fa74
child 44112 eb94cfaaf5d4
permissions -rw-r--r--
updated and re-unified HOL typedef, with some live examples;
wenzelm@26840
     1
%
wenzelm@26840
     2
\begin{isabellebody}%
wenzelm@40685
     3
\def\isabellecontext{HOL{\isaliteral{5F}{\isacharunderscore}}Specific}%
wenzelm@26840
     4
%
wenzelm@26840
     5
\isadelimtheory
wenzelm@26840
     6
%
wenzelm@26840
     7
\endisadelimtheory
wenzelm@26840
     8
%
wenzelm@26840
     9
\isatagtheory
wenzelm@26840
    10
\isacommand{theory}\isamarkupfalse%
wenzelm@40685
    11
\ HOL{\isaliteral{5F}{\isacharunderscore}}Specific\isanewline
wenzelm@43522
    12
\isakeyword{imports}\ Base\ Main\isanewline
wenzelm@26849
    13
\isakeyword{begin}%
wenzelm@26849
    14
\endisatagtheory
wenzelm@26849
    15
{\isafoldtheory}%
wenzelm@26849
    16
%
wenzelm@26849
    17
\isadelimtheory
wenzelm@26849
    18
%
wenzelm@26849
    19
\endisadelimtheory
wenzelm@26849
    20
%
wenzelm@26852
    21
\isamarkupchapter{Isabelle/HOL \label{ch:hol}%
wenzelm@26849
    22
}
wenzelm@26849
    23
\isamarkuptrue%
wenzelm@26849
    24
%
wenzelm@35757
    25
\isamarkupsection{Typedef axiomatization \label{sec:hol-typedef}%
wenzelm@26849
    26
}
wenzelm@26849
    27
\isamarkuptrue%
wenzelm@26849
    28
%
wenzelm@26849
    29
\begin{isamarkuptext}%
wenzelm@44111
    30
A Gordon/HOL-style type definition is a certain axiom scheme
wenzelm@44111
    31
  that identifies a new type with a subset of an existing type.  More
wenzelm@44111
    32
  precisely, the new type is defined by exhibiting an existing type
wenzelm@44111
    33
  \isa{{\isaliteral{5C3C7461753E}{\isasymtau}}}, a set \isa{{\isaliteral{22}{\isachardoublequote}}A\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7461753E}{\isasymtau}}\ set{\isaliteral{22}{\isachardoublequote}}}, and a theorem that proves
wenzelm@44111
    34
  \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6578697374733E}{\isasymexists}}x{\isaliteral{2E}{\isachardot}}\ x\ {\isaliteral{5C3C696E3E}{\isasymin}}\ A{\isaliteral{22}{\isachardoublequote}}}.  Thus \isa{A} is a non-empty subset of \isa{{\isaliteral{5C3C7461753E}{\isasymtau}}}, and the new type denotes this subset.  New functions are
wenzelm@44111
    35
  postulated that establish an isomorphism between the new type and
wenzelm@44111
    36
  the subset.  In general, the type \isa{{\isaliteral{5C3C7461753E}{\isasymtau}}} may involve type
wenzelm@44111
    37
  variables \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{22}{\isachardoublequote}}} which means that the type definition
wenzelm@44111
    38
  produces a type constructor \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}{\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{29}{\isacharparenright}}\ t{\isaliteral{22}{\isachardoublequote}}} depending on
wenzelm@44111
    39
  those type arguments.
wenzelm@44111
    40
wenzelm@44111
    41
  The axiomatization can be considered a ``definition'' in the sense
wenzelm@44111
    42
  of the particular set-theoretic interpretation of HOL
wenzelm@44111
    43
  \cite{pitts93}, where the universe of types is required to be
wenzelm@44111
    44
  downwards-closed wrt.\ arbitrary non-empty subsets.  Thus genuinely
wenzelm@44111
    45
  new types introduced by \hyperlink{command.typedef}{\mbox{\isa{\isacommand{typedef}}}} stay within the range
wenzelm@44111
    46
  of HOL models by construction.  Note that \indexref{}{command}{type\_synonym}\hyperlink{command.type-synonym}{\mbox{\isa{\isacommand{type{\isaliteral{5F}{\isacharunderscore}}synonym}}}} from Isabelle/Pure merely introduces syntactic
wenzelm@44111
    47
  abbreviations, without any logical significance.
wenzelm@44111
    48
  
wenzelm@44111
    49
  \begin{matharray}{rcl}
wenzelm@40685
    50
    \indexdef{HOL}{command}{typedef}\hypertarget{command.HOL.typedef}{\hyperlink{command.HOL.typedef}{\mbox{\isa{\isacommand{typedef}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ proof{\isaliteral{28}{\isacharparenleft}}prove{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@26849
    51
  \end{matharray}
wenzelm@26849
    52
wenzelm@43467
    53
  \begin{railoutput}
wenzelm@43535
    54
\rail@begin{2}{}
wenzelm@43467
    55
\rail@term{\hyperlink{command.HOL.typedef}{\mbox{\isa{\isacommand{typedef}}}}}[]
wenzelm@43467
    56
\rail@bar
wenzelm@43467
    57
\rail@nextbar{1}
wenzelm@44111
    58
\rail@nont{\isa{alt{\isaliteral{5F}{\isacharunderscore}}name}}[]
wenzelm@43467
    59
\rail@endbar
wenzelm@44111
    60
\rail@nont{\isa{abs{\isaliteral{5F}{\isacharunderscore}}type}}[]
wenzelm@43467
    61
\rail@term{\isa{{\isaliteral{3D}{\isacharequal}}}}[]
wenzelm@44111
    62
\rail@nont{\isa{rep{\isaliteral{5F}{\isacharunderscore}}set}}[]
wenzelm@43467
    63
\rail@end
wenzelm@44111
    64
\rail@begin{3}{\isa{alt{\isaliteral{5F}{\isacharunderscore}}name}}
wenzelm@43467
    65
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
    66
\rail@bar
wenzelm@43467
    67
\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
    68
\rail@nextbar{1}
wenzelm@43467
    69
\rail@term{\isa{\isakeyword{open}}}[]
wenzelm@43467
    70
\rail@nextbar{2}
wenzelm@43467
    71
\rail@term{\isa{\isakeyword{open}}}[]
wenzelm@43467
    72
\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
    73
\rail@endbar
wenzelm@43467
    74
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
    75
\rail@end
wenzelm@44111
    76
\rail@begin{2}{\isa{abs{\isaliteral{5F}{\isacharunderscore}}type}}
wenzelm@43576
    77
\rail@nont{\hyperlink{syntax.typespec-sorts}{\mbox{\isa{typespec{\isaliteral{5F}{\isacharunderscore}}sorts}}}}[]
wenzelm@43467
    78
\rail@bar
wenzelm@43467
    79
\rail@nextbar{1}
wenzelm@43467
    80
\rail@nont{\hyperlink{syntax.mixfix}{\mbox{\isa{mixfix}}}}[]
wenzelm@43467
    81
\rail@endbar
wenzelm@43467
    82
\rail@end
wenzelm@44111
    83
\rail@begin{2}{\isa{rep{\isaliteral{5F}{\isacharunderscore}}set}}
wenzelm@43467
    84
\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]
wenzelm@43467
    85
\rail@bar
wenzelm@43467
    86
\rail@nextbar{1}
wenzelm@43467
    87
\rail@term{\isa{\isakeyword{morphisms}}}[]
wenzelm@43467
    88
\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
    89
\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
    90
\rail@endbar
wenzelm@43467
    91
\rail@end
wenzelm@43467
    92
\end{railoutput}
wenzelm@26849
    93
wenzelm@26849
    94
wenzelm@28788
    95
  \begin{description}
wenzelm@42994
    96
wenzelm@40685
    97
  \item \hyperlink{command.HOL.typedef}{\mbox{\isa{\isacommand{typedef}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}{\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{29}{\isacharparenright}}\ t\ {\isaliteral{3D}{\isacharequal}}\ A{\isaliteral{22}{\isachardoublequote}}}
wenzelm@44111
    98
  axiomatizes a type definition in the background theory of the
wenzelm@44111
    99
  current context, depending on a non-emptiness result of the set
wenzelm@44111
   100
  \isa{A} that needs to be proven here.  The set \isa{A} may
wenzelm@44111
   101
  contain type variables \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{22}{\isachardoublequote}}} as specified on the LHS,
wenzelm@44111
   102
  but no term variables.
wenzelm@35757
   103
wenzelm@44111
   104
  Even though a local theory specification, the newly introduced type
wenzelm@44111
   105
  constructor cannot depend on parameters or assumptions of the
wenzelm@44111
   106
  context: this is structurally impossible in HOL.  In contrast, the
wenzelm@44111
   107
  non-emptiness proof may use local assumptions in unusual situations,
wenzelm@44111
   108
  which could result in different interpretations in target contexts:
wenzelm@44111
   109
  the meaning of the bijection between the representing set \isa{A}
wenzelm@44111
   110
  and the new type \isa{t} may then change in different application
wenzelm@44111
   111
  contexts.
wenzelm@42994
   112
wenzelm@44111
   113
  By default, \hyperlink{command.HOL.typedef}{\mbox{\isa{\isacommand{typedef}}}} defines both a type
wenzelm@44111
   114
  constructor \isa{t} for the new type, and a term constant \isa{t} for the representing set within the old type.  Use the ``\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}open{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequote}}}'' option to suppress a separate constant definition
wenzelm@40685
   115
  altogether.  The injection from type to set is called \isa{Rep{\isaliteral{5F}{\isacharunderscore}}t},
wenzelm@44111
   116
  its inverse \isa{Abs{\isaliteral{5F}{\isacharunderscore}}t}, unless explicit \hyperlink{keyword.HOL.morphisms}{\mbox{\isa{\isakeyword{morphisms}}}} specification provides alternative names.
wenzelm@42994
   117
wenzelm@44111
   118
  The core axiomatization uses the locale predicate \isa{type{\isaliteral{5F}{\isacharunderscore}}definition} as defined in Isabelle/HOL.  Various basic
wenzelm@44111
   119
  consequences of that are instantiated accordingly, re-using the
wenzelm@44111
   120
  locale facts with names derived from the new type constructor.  Thus
wenzelm@44111
   121
  the generic \isa{type{\isaliteral{5F}{\isacharunderscore}}definition{\isaliteral{2E}{\isachardot}}Rep} is turned into the specific
wenzelm@44111
   122
  \isa{{\isaliteral{22}{\isachardoublequote}}Rep{\isaliteral{5F}{\isacharunderscore}}t{\isaliteral{22}{\isachardoublequote}}}, for example.
wenzelm@44111
   123
wenzelm@44111
   124
  Theorems \isa{type{\isaliteral{5F}{\isacharunderscore}}definition{\isaliteral{2E}{\isachardot}}Rep}, \isa{type{\isaliteral{5F}{\isacharunderscore}}definition{\isaliteral{2E}{\isachardot}}Rep{\isaliteral{5F}{\isacharunderscore}}inverse}, and \isa{type{\isaliteral{5F}{\isacharunderscore}}definition{\isaliteral{2E}{\isachardot}}Abs{\isaliteral{5F}{\isacharunderscore}}inverse}
wenzelm@44111
   125
  provide the most basic characterization as a corresponding
wenzelm@44111
   126
  injection/surjection pair (in both directions).  The derived rules
wenzelm@44111
   127
  \isa{type{\isaliteral{5F}{\isacharunderscore}}definition{\isaliteral{2E}{\isachardot}}Rep{\isaliteral{5F}{\isacharunderscore}}inject} and \isa{type{\isaliteral{5F}{\isacharunderscore}}definition{\isaliteral{2E}{\isachardot}}Abs{\isaliteral{5F}{\isacharunderscore}}inject} provide a more convenient version of
wenzelm@44111
   128
  injectivity, suitable for automated proof tools (e.g.\ in
wenzelm@44111
   129
  declarations involving \hyperlink{attribute.simp}{\mbox{\isa{simp}}} or \hyperlink{attribute.iff}{\mbox{\isa{iff}}}).
wenzelm@44111
   130
  Furthermore, the rules \isa{type{\isaliteral{5F}{\isacharunderscore}}definition{\isaliteral{2E}{\isachardot}}Rep{\isaliteral{5F}{\isacharunderscore}}cases}~/ \isa{type{\isaliteral{5F}{\isacharunderscore}}definition{\isaliteral{2E}{\isachardot}}Rep{\isaliteral{5F}{\isacharunderscore}}induct}, and \isa{type{\isaliteral{5F}{\isacharunderscore}}definition{\isaliteral{2E}{\isachardot}}Abs{\isaliteral{5F}{\isacharunderscore}}cases}~/
wenzelm@44111
   131
  \isa{type{\isaliteral{5F}{\isacharunderscore}}definition{\isaliteral{2E}{\isachardot}}Abs{\isaliteral{5F}{\isacharunderscore}}induct} provide alternative views on
wenzelm@44111
   132
  surjectivity.  These rules are already declared as set or type rules
wenzelm@44111
   133
  for the generic \hyperlink{method.cases}{\mbox{\isa{cases}}} and \hyperlink{method.induct}{\mbox{\isa{induct}}} methods,
wenzelm@44111
   134
  respectively.
wenzelm@42994
   135
wenzelm@35757
   136
  An alternative name for the set definition (and other derived
wenzelm@35757
   137
  entities) may be specified in parentheses; the default is to use
wenzelm@44111
   138
  \isa{t} directly.
wenzelm@26849
   139
wenzelm@44111
   140
  \end{description}
wenzelm@44111
   141
wenzelm@44111
   142
  \begin{warn}
wenzelm@44111
   143
  If you introduce a new type axiomatically, i.e.\ via \indexref{}{command}{typedecl}\hyperlink{command.typedecl}{\mbox{\isa{\isacommand{typedecl}}}} and \indexref{}{command}{axiomatization}\hyperlink{command.axiomatization}{\mbox{\isa{\isacommand{axiomatization}}}}, the minimum requirement
wenzelm@44111
   144
  is that it has a non-empty model, to avoid immediate collapse of the
wenzelm@44111
   145
  HOL logic.  Moreover, one needs to demonstrate that the
wenzelm@44111
   146
  interpretation of such free-form axiomatizations can coexist with
wenzelm@44111
   147
  that of the regular \indexdef{}{command}{typedef}\hypertarget{command.typedef}{\hyperlink{command.typedef}{\mbox{\isa{\isacommand{typedef}}}}} scheme, and any extension
wenzelm@44111
   148
  that other people might have introduced elsewhere (e.g.\ in HOLCF
wenzelm@44111
   149
  \cite{MuellerNvOS99}).
wenzelm@44111
   150
  \end{warn}%
wenzelm@44111
   151
\end{isamarkuptext}%
wenzelm@44111
   152
\isamarkuptrue%
wenzelm@44111
   153
%
wenzelm@44111
   154
\isamarkupsubsubsection{Examples%
wenzelm@44111
   155
}
wenzelm@44111
   156
\isamarkuptrue%
wenzelm@44111
   157
%
wenzelm@44111
   158
\begin{isamarkuptext}%
wenzelm@44111
   159
Type definitions permit the introduction of abstract data
wenzelm@44111
   160
  types in a safe way, namely by providing models based on already
wenzelm@44111
   161
  existing types.  Given some abstract axiomatic description \isa{P}
wenzelm@44111
   162
  of a type, this involves two steps:
wenzelm@44111
   163
wenzelm@44111
   164
  \begin{enumerate}
wenzelm@44111
   165
wenzelm@44111
   166
  \item Find an appropriate type \isa{{\isaliteral{5C3C7461753E}{\isasymtau}}} and subset \isa{A} which
wenzelm@44111
   167
  has the desired properties \isa{P}, and make a type definition
wenzelm@44111
   168
  based on this representation.
wenzelm@44111
   169
wenzelm@44111
   170
  \item Prove that \isa{P} holds for \isa{{\isaliteral{5C3C7461753E}{\isasymtau}}} by lifting \isa{P}
wenzelm@44111
   171
  from the representation.
wenzelm@44111
   172
wenzelm@44111
   173
  \end{enumerate}
wenzelm@44111
   174
wenzelm@44111
   175
  You can later forget about the representation and work solely in
wenzelm@44111
   176
  terms of the abstract properties \isa{P}.
wenzelm@44111
   177
wenzelm@44111
   178
  \medskip The following trivial example pulls a three-element type
wenzelm@44111
   179
  into existence within the formal logical environment of HOL.%
wenzelm@44111
   180
\end{isamarkuptext}%
wenzelm@44111
   181
\isamarkuptrue%
wenzelm@44111
   182
\isacommand{typedef}\isamarkupfalse%
wenzelm@44111
   183
\ three\ {\isaliteral{3D}{\isacharequal}}\ {\isaliteral{22}{\isachardoublequoteopen}}{\isaliteral{7B}{\isacharbraceleft}}{\isaliteral{28}{\isacharparenleft}}True{\isaliteral{2C}{\isacharcomma}}\ True{\isaliteral{29}{\isacharparenright}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{28}{\isacharparenleft}}True{\isaliteral{2C}{\isacharcomma}}\ False{\isaliteral{29}{\isacharparenright}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{28}{\isacharparenleft}}False{\isaliteral{2C}{\isacharcomma}}\ True{\isaliteral{29}{\isacharparenright}}{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@44111
   184
%
wenzelm@44111
   185
\isadelimproof
wenzelm@44111
   186
\ \ %
wenzelm@44111
   187
\endisadelimproof
wenzelm@44111
   188
%
wenzelm@44111
   189
\isatagproof
wenzelm@44111
   190
\isacommand{by}\isamarkupfalse%
wenzelm@44111
   191
\ blast%
wenzelm@44111
   192
\endisatagproof
wenzelm@44111
   193
{\isafoldproof}%
wenzelm@44111
   194
%
wenzelm@44111
   195
\isadelimproof
wenzelm@44111
   196
\isanewline
wenzelm@44111
   197
%
wenzelm@44111
   198
\endisadelimproof
wenzelm@44111
   199
\isanewline
wenzelm@44111
   200
\isacommand{definition}\isamarkupfalse%
wenzelm@44111
   201
\ {\isaliteral{22}{\isachardoublequoteopen}}One\ {\isaliteral{3D}{\isacharequal}}\ Abs{\isaliteral{5F}{\isacharunderscore}}three\ {\isaliteral{28}{\isacharparenleft}}True{\isaliteral{2C}{\isacharcomma}}\ True{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@44111
   202
\isacommand{definition}\isamarkupfalse%
wenzelm@44111
   203
\ {\isaliteral{22}{\isachardoublequoteopen}}Two\ {\isaliteral{3D}{\isacharequal}}\ Abs{\isaliteral{5F}{\isacharunderscore}}three\ {\isaliteral{28}{\isacharparenleft}}True{\isaliteral{2C}{\isacharcomma}}\ False{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@44111
   204
\isacommand{definition}\isamarkupfalse%
wenzelm@44111
   205
\ {\isaliteral{22}{\isachardoublequoteopen}}Three\ {\isaliteral{3D}{\isacharequal}}\ Abs{\isaliteral{5F}{\isacharunderscore}}three\ {\isaliteral{28}{\isacharparenleft}}False{\isaliteral{2C}{\isacharcomma}}\ True{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@44111
   206
\isanewline
wenzelm@44111
   207
\isacommand{lemma}\isamarkupfalse%
wenzelm@44111
   208
\ three{\isaliteral{5F}{\isacharunderscore}}distinct{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{22}{\isachardoublequoteopen}}One\ {\isaliteral{5C3C6E6F7465713E}{\isasymnoteq}}\ Two{\isaliteral{22}{\isachardoublequoteclose}}\ \ {\isaliteral{22}{\isachardoublequoteopen}}One\ {\isaliteral{5C3C6E6F7465713E}{\isasymnoteq}}\ Three{\isaliteral{22}{\isachardoublequoteclose}}\ \ {\isaliteral{22}{\isachardoublequoteopen}}Two\ {\isaliteral{5C3C6E6F7465713E}{\isasymnoteq}}\ Three{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@44111
   209
%
wenzelm@44111
   210
\isadelimproof
wenzelm@44111
   211
\ \ %
wenzelm@44111
   212
\endisadelimproof
wenzelm@44111
   213
%
wenzelm@44111
   214
\isatagproof
wenzelm@44111
   215
\isacommand{by}\isamarkupfalse%
wenzelm@44111
   216
\ {\isaliteral{28}{\isacharparenleft}}simp{\isaliteral{5F}{\isacharunderscore}}all\ add{\isaliteral{3A}{\isacharcolon}}\ One{\isaliteral{5F}{\isacharunderscore}}def\ Two{\isaliteral{5F}{\isacharunderscore}}def\ Three{\isaliteral{5F}{\isacharunderscore}}def\ Abs{\isaliteral{5F}{\isacharunderscore}}three{\isaliteral{5F}{\isacharunderscore}}inject\ three{\isaliteral{5F}{\isacharunderscore}}def{\isaliteral{29}{\isacharparenright}}%
wenzelm@44111
   217
\endisatagproof
wenzelm@44111
   218
{\isafoldproof}%
wenzelm@44111
   219
%
wenzelm@44111
   220
\isadelimproof
wenzelm@44111
   221
\isanewline
wenzelm@44111
   222
%
wenzelm@44111
   223
\endisadelimproof
wenzelm@44111
   224
\isanewline
wenzelm@44111
   225
\isacommand{lemma}\isamarkupfalse%
wenzelm@44111
   226
\ three{\isaliteral{5F}{\isacharunderscore}}cases{\isaliteral{3A}{\isacharcolon}}\isanewline
wenzelm@44111
   227
\ \ \isakeyword{fixes}\ x\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ three\ \isakeyword{obtains}\ {\isaliteral{22}{\isachardoublequoteopen}}x\ {\isaliteral{3D}{\isacharequal}}\ One{\isaliteral{22}{\isachardoublequoteclose}}\ {\isaliteral{7C}{\isacharbar}}\ {\isaliteral{22}{\isachardoublequoteopen}}x\ {\isaliteral{3D}{\isacharequal}}\ Two{\isaliteral{22}{\isachardoublequoteclose}}\ {\isaliteral{7C}{\isacharbar}}\ {\isaliteral{22}{\isachardoublequoteopen}}x\ {\isaliteral{3D}{\isacharequal}}\ Three{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@44111
   228
%
wenzelm@44111
   229
\isadelimproof
wenzelm@44111
   230
\ \ %
wenzelm@44111
   231
\endisadelimproof
wenzelm@44111
   232
%
wenzelm@44111
   233
\isatagproof
wenzelm@44111
   234
\isacommand{by}\isamarkupfalse%
wenzelm@44111
   235
\ {\isaliteral{28}{\isacharparenleft}}cases\ x{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{28}{\isacharparenleft}}auto\ simp{\isaliteral{3A}{\isacharcolon}}\ One{\isaliteral{5F}{\isacharunderscore}}def\ Two{\isaliteral{5F}{\isacharunderscore}}def\ Three{\isaliteral{5F}{\isacharunderscore}}def\ Abs{\isaliteral{5F}{\isacharunderscore}}three{\isaliteral{5F}{\isacharunderscore}}inject\ three{\isaliteral{5F}{\isacharunderscore}}def{\isaliteral{29}{\isacharparenright}}%
wenzelm@44111
   236
\endisatagproof
wenzelm@44111
   237
{\isafoldproof}%
wenzelm@44111
   238
%
wenzelm@44111
   239
\isadelimproof
wenzelm@44111
   240
%
wenzelm@44111
   241
\endisadelimproof
wenzelm@44111
   242
%
wenzelm@44111
   243
\begin{isamarkuptext}%
wenzelm@44111
   244
Note that such trivial constructions are better done with
wenzelm@44111
   245
  derived specification mechanisms such as \hyperlink{command.datatype}{\mbox{\isa{\isacommand{datatype}}}}:%
wenzelm@44111
   246
\end{isamarkuptext}%
wenzelm@44111
   247
\isamarkuptrue%
wenzelm@44111
   248
\isacommand{datatype}\isamarkupfalse%
wenzelm@44111
   249
\ three{\isaliteral{27}{\isacharprime}}\ {\isaliteral{3D}{\isacharequal}}\ One{\isaliteral{27}{\isacharprime}}\ {\isaliteral{7C}{\isacharbar}}\ Two{\isaliteral{27}{\isacharprime}}\ {\isaliteral{7C}{\isacharbar}}\ Three{\isaliteral{27}{\isacharprime}}%
wenzelm@44111
   250
\begin{isamarkuptext}%
wenzelm@44111
   251
This avoids re-doing basic definitions and proofs from the
wenzelm@44111
   252
  primitive \hyperlink{command.typedef}{\mbox{\isa{\isacommand{typedef}}}} above.%
wenzelm@26849
   253
\end{isamarkuptext}%
wenzelm@26849
   254
\isamarkuptrue%
wenzelm@26849
   255
%
wenzelm@26849
   256
\isamarkupsection{Adhoc tuples%
wenzelm@26849
   257
}
wenzelm@26849
   258
\isamarkuptrue%
wenzelm@26849
   259
%
wenzelm@26849
   260
\begin{isamarkuptext}%
wenzelm@26849
   261
\begin{matharray}{rcl}
wenzelm@43467
   262
    \indexdef{HOL}{attribute}{split\_format}\hypertarget{attribute.HOL.split-format}{\hyperlink{attribute.HOL.split-format}{\mbox{\isa{split{\isaliteral{5F}{\isacharunderscore}}format}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{attribute} \\
wenzelm@26849
   263
  \end{matharray}
wenzelm@26849
   264
wenzelm@43467
   265
  \begin{railoutput}
wenzelm@43535
   266
\rail@begin{2}{}
wenzelm@43467
   267
\rail@term{\hyperlink{attribute.HOL.split-format}{\mbox{\isa{split{\isaliteral{5F}{\isacharunderscore}}format}}}}[]
wenzelm@43467
   268
\rail@bar
wenzelm@43467
   269
\rail@nextbar{1}
wenzelm@43467
   270
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
   271
\rail@term{\isa{complete}}[]
wenzelm@43467
   272
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
   273
\rail@endbar
wenzelm@43467
   274
\rail@end
wenzelm@43467
   275
\end{railoutput}
wenzelm@43467
   276
wenzelm@26849
   277
wenzelm@28788
   278
  \begin{description}
wenzelm@42994
   279
wenzelm@40685
   280
  \item \hyperlink{attribute.HOL.split-format}{\mbox{\isa{split{\isaliteral{5F}{\isacharunderscore}}format}}}\ \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}complete{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequote}}} causes
wenzelm@28788
   281
  arguments in function applications to be represented canonically
wenzelm@28788
   282
  according to their tuple type structure.
wenzelm@26849
   283
krauss@40634
   284
  Note that this operation tends to invent funny names for new local
krauss@40634
   285
  parameters introduced.
wenzelm@26849
   286
wenzelm@28788
   287
  \end{description}%
wenzelm@26849
   288
\end{isamarkuptext}%
wenzelm@26849
   289
\isamarkuptrue%
wenzelm@26849
   290
%
wenzelm@26849
   291
\isamarkupsection{Records \label{sec:hol-record}%
wenzelm@26849
   292
}
wenzelm@26849
   293
\isamarkuptrue%
wenzelm@26849
   294
%
wenzelm@26849
   295
\begin{isamarkuptext}%
wenzelm@26849
   296
In principle, records merely generalize the concept of tuples, where
wenzelm@26849
   297
  components may be addressed by labels instead of just position.  The
wenzelm@26849
   298
  logical infrastructure of records in Isabelle/HOL is slightly more
wenzelm@26849
   299
  advanced, though, supporting truly extensible record schemes.  This
wenzelm@26849
   300
  admits operations that are polymorphic with respect to record
wenzelm@26849
   301
  extension, yielding ``object-oriented'' effects like (single)
wenzelm@26849
   302
  inheritance.  See also \cite{NaraschewskiW-TPHOLs98} for more
wenzelm@26849
   303
  details on object-oriented verification and record subtyping in HOL.%
wenzelm@26849
   304
\end{isamarkuptext}%
wenzelm@26849
   305
\isamarkuptrue%
wenzelm@26849
   306
%
wenzelm@26849
   307
\isamarkupsubsection{Basic concepts%
wenzelm@26849
   308
}
wenzelm@26849
   309
\isamarkuptrue%
wenzelm@26849
   310
%
wenzelm@26849
   311
\begin{isamarkuptext}%
wenzelm@26849
   312
Isabelle/HOL supports both \emph{fixed} and \emph{schematic} records
wenzelm@26849
   313
  at the level of terms and types.  The notation is as follows:
wenzelm@26849
   314
wenzelm@26849
   315
  \begin{center}
wenzelm@26849
   316
  \begin{tabular}{l|l|l}
wenzelm@26849
   317
    & record terms & record types \\ \hline
wenzelm@40685
   318
    fixed & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}x\ {\isaliteral{3D}{\isacharequal}}\ a{\isaliteral{2C}{\isacharcomma}}\ y\ {\isaliteral{3D}{\isacharequal}}\ b{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}x\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ A{\isaliteral{2C}{\isacharcomma}}\ y\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ B{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
   319
    schematic & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}x\ {\isaliteral{3D}{\isacharequal}}\ a{\isaliteral{2C}{\isacharcomma}}\ y\ {\isaliteral{3D}{\isacharequal}}\ b{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{3D}{\isacharequal}}\ m{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}} &
wenzelm@40685
   320
      \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}x\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ A{\isaliteral{2C}{\isacharcomma}}\ y\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ B{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ M{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@26849
   321
  \end{tabular}
wenzelm@26849
   322
  \end{center}
wenzelm@26849
   323
wenzelm@40685
   324
  \noindent The ASCII representation of \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}x\ {\isaliteral{3D}{\isacharequal}}\ a{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}} is \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}{\isaliteral{7C}{\isacharbar}}\ x\ {\isaliteral{3D}{\isacharequal}}\ a\ {\isaliteral{7C}{\isacharbar}}{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequote}}}.
wenzelm@26849
   325
wenzelm@40685
   326
  A fixed record \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}x\ {\isaliteral{3D}{\isacharequal}}\ a{\isaliteral{2C}{\isacharcomma}}\ y\ {\isaliteral{3D}{\isacharequal}}\ b{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}} has field \isa{x} of value
wenzelm@26849
   327
  \isa{a} and field \isa{y} of value \isa{b}.  The corresponding
wenzelm@40685
   328
  type is \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}x\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ A{\isaliteral{2C}{\isacharcomma}}\ y\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ B{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}}, assuming that \isa{{\isaliteral{22}{\isachardoublequote}}a\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ A{\isaliteral{22}{\isachardoublequote}}}
wenzelm@40685
   329
  and \isa{{\isaliteral{22}{\isachardoublequote}}b\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ B{\isaliteral{22}{\isachardoublequote}}}.
wenzelm@26849
   330
wenzelm@40685
   331
  A record scheme like \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}x\ {\isaliteral{3D}{\isacharequal}}\ a{\isaliteral{2C}{\isacharcomma}}\ y\ {\isaliteral{3D}{\isacharequal}}\ b{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{3D}{\isacharequal}}\ m{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}} contains fields
wenzelm@26849
   332
  \isa{x} and \isa{y} as before, but also possibly further fields
wenzelm@40685
   333
  as indicated by the ``\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{22}{\isachardoublequote}}}'' notation (which is actually part
wenzelm@40685
   334
  of the syntax).  The improper field ``\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{22}{\isachardoublequote}}}'' of a record
wenzelm@26849
   335
  scheme is called the \emph{more part}.  Logically it is just a free
wenzelm@26849
   336
  variable, which is occasionally referred to as ``row variable'' in
wenzelm@26849
   337
  the literature.  The more part of a record scheme may be
wenzelm@26849
   338
  instantiated by zero or more further components.  For example, the
wenzelm@40685
   339
  previous scheme may get instantiated to \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}x\ {\isaliteral{3D}{\isacharequal}}\ a{\isaliteral{2C}{\isacharcomma}}\ y\ {\isaliteral{3D}{\isacharequal}}\ b{\isaliteral{2C}{\isacharcomma}}\ z\ {\isaliteral{3D}{\isacharequal}}\ c{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{3D}{\isacharequal}}\ m{\isaliteral{27}{\isacharprime}}{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}}, where \isa{m{\isaliteral{27}{\isacharprime}}} refers to a different more part.
wenzelm@26849
   340
  Fixed records are special instances of record schemes, where
wenzelm@40685
   341
  ``\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{22}{\isachardoublequote}}}'' is properly terminated by the \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ unit{\isaliteral{22}{\isachardoublequote}}}
wenzelm@40685
   342
  element.  In fact, \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}x\ {\isaliteral{3D}{\isacharequal}}\ a{\isaliteral{2C}{\isacharcomma}}\ y\ {\isaliteral{3D}{\isacharequal}}\ b{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}} is just an abbreviation
wenzelm@40685
   343
  for \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}x\ {\isaliteral{3D}{\isacharequal}}\ a{\isaliteral{2C}{\isacharcomma}}\ y\ {\isaliteral{3D}{\isacharequal}}\ b{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{3D}{\isacharequal}}\ {\isaliteral{28}{\isacharparenleft}}{\isaliteral{29}{\isacharparenright}}{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}}.
wenzelm@42994
   344
wenzelm@26849
   345
  \medskip Two key observations make extensible records in a simply
wenzelm@26849
   346
  typed language like HOL work out:
wenzelm@26849
   347
wenzelm@26849
   348
  \begin{enumerate}
wenzelm@26849
   349
wenzelm@26849
   350
  \item the more part is internalized, as a free term or type
wenzelm@26849
   351
  variable,
wenzelm@26849
   352
wenzelm@26852
   353
  \item field names are externalized, they cannot be accessed within
wenzelm@26852
   354
  the logic as first-class values.
wenzelm@26849
   355
wenzelm@26849
   356
  \end{enumerate}
wenzelm@26849
   357
wenzelm@26849
   358
  \medskip In Isabelle/HOL record types have to be defined explicitly,
wenzelm@26849
   359
  fixing their field names and types, and their (optional) parent
wenzelm@26849
   360
  record.  Afterwards, records may be formed using above syntax, while
wenzelm@26849
   361
  obeying the canonical order of fields as given by their declaration.
wenzelm@26849
   362
  The record package provides several standard operations like
wenzelm@26849
   363
  selectors and updates.  The common setup for various generic proof
wenzelm@26849
   364
  tools enable succinct reasoning patterns.  See also the Isabelle/HOL
wenzelm@26849
   365
  tutorial \cite{isabelle-hol-book} for further instructions on using
wenzelm@26849
   366
  records in practice.%
wenzelm@26849
   367
\end{isamarkuptext}%
wenzelm@26849
   368
\isamarkuptrue%
wenzelm@26849
   369
%
wenzelm@26849
   370
\isamarkupsubsection{Record specifications%
wenzelm@26849
   371
}
wenzelm@26849
   372
\isamarkuptrue%
wenzelm@26849
   373
%
wenzelm@26849
   374
\begin{isamarkuptext}%
wenzelm@26849
   375
\begin{matharray}{rcl}
wenzelm@40685
   376
    \indexdef{HOL}{command}{record}\hypertarget{command.HOL.record}{\hyperlink{command.HOL.record}{\mbox{\isa{\isacommand{record}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@26849
   377
  \end{matharray}
wenzelm@26849
   378
wenzelm@43467
   379
  \begin{railoutput}
wenzelm@43575
   380
\rail@begin{4}{}
wenzelm@43467
   381
\rail@term{\hyperlink{command.HOL.record}{\mbox{\isa{\isacommand{record}}}}}[]
wenzelm@43576
   382
\rail@nont{\hyperlink{syntax.typespec-sorts}{\mbox{\isa{typespec{\isaliteral{5F}{\isacharunderscore}}sorts}}}}[]
wenzelm@43467
   383
\rail@term{\isa{{\isaliteral{3D}{\isacharequal}}}}[]
wenzelm@43575
   384
\rail@cr{2}
wenzelm@43467
   385
\rail@bar
wenzelm@43575
   386
\rail@nextbar{3}
wenzelm@43467
   387
\rail@nont{\hyperlink{syntax.type}{\mbox{\isa{type}}}}[]
wenzelm@43467
   388
\rail@term{\isa{{\isaliteral{2B}{\isacharplus}}}}[]
wenzelm@43467
   389
\rail@endbar
wenzelm@43467
   390
\rail@plus
wenzelm@43467
   391
\rail@nont{\hyperlink{syntax.constdecl}{\mbox{\isa{constdecl}}}}[]
wenzelm@43575
   392
\rail@nextplus{3}
wenzelm@43467
   393
\rail@endplus
wenzelm@43467
   394
\rail@end
wenzelm@43467
   395
\end{railoutput}
wenzelm@43467
   396
wenzelm@26849
   397
wenzelm@28788
   398
  \begin{description}
wenzelm@26849
   399
wenzelm@40685
   400
  \item \hyperlink{command.HOL.record}{\mbox{\isa{\isacommand{record}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}{\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub m{\isaliteral{29}{\isacharparenright}}\ t\ {\isaliteral{3D}{\isacharequal}}\ {\isaliteral{5C3C7461753E}{\isasymtau}}\ {\isaliteral{2B}{\isacharplus}}\ c\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ c\isaliteral{5C3C5E7375623E}{}\isactrlsub n\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{22}{\isachardoublequote}}} defines extensible record type \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}{\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub m{\isaliteral{29}{\isacharparenright}}\ t{\isaliteral{22}{\isachardoublequote}}},
wenzelm@40685
   401
  derived from the optional parent record \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C7461753E}{\isasymtau}}{\isaliteral{22}{\isachardoublequote}}} by adding new
wenzelm@40685
   402
  field components \isa{{\isaliteral{22}{\isachardoublequote}}c\isaliteral{5C3C5E7375623E}{}\isactrlsub i\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub i{\isaliteral{22}{\isachardoublequote}}} etc.
wenzelm@26849
   403
wenzelm@40685
   404
  The type variables of \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C7461753E}{\isasymtau}}{\isaliteral{22}{\isachardoublequote}}} and \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub i{\isaliteral{22}{\isachardoublequote}}} need to be
wenzelm@40685
   405
  covered by the (distinct) parameters \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub m{\isaliteral{22}{\isachardoublequote}}}.  Type constructor \isa{t} has to be new, while \isa{{\isaliteral{5C3C7461753E}{\isasymtau}}} needs to specify an instance of an existing record type.  At
wenzelm@40685
   406
  least one new field \isa{{\isaliteral{22}{\isachardoublequote}}c\isaliteral{5C3C5E7375623E}{}\isactrlsub i{\isaliteral{22}{\isachardoublequote}}} has to be specified.
wenzelm@26849
   407
  Basically, field names need to belong to a unique record.  This is
wenzelm@26849
   408
  not a real restriction in practice, since fields are qualified by
wenzelm@26849
   409
  the record name internally.
wenzelm@26849
   410
wenzelm@40685
   411
  The parent record specification \isa{{\isaliteral{5C3C7461753E}{\isasymtau}}} is optional; if omitted
wenzelm@26849
   412
  \isa{t} becomes a root record.  The hierarchy of all records
wenzelm@26849
   413
  declared within a theory context forms a forest structure, i.e.\ a
wenzelm@26849
   414
  set of trees starting with a root record each.  There is no way to
wenzelm@26849
   415
  merge multiple parent records!
wenzelm@26849
   416
wenzelm@40685
   417
  For convenience, \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}{\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub m{\isaliteral{29}{\isacharparenright}}\ t{\isaliteral{22}{\isachardoublequote}}} is made a
wenzelm@40685
   418
  type abbreviation for the fixed record type \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}c\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ c\isaliteral{5C3C5E7375623E}{}\isactrlsub n\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}}, likewise is \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}{\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub m{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C7A6574613E}{\isasymzeta}}{\isaliteral{29}{\isacharparenright}}\ t{\isaliteral{5F}{\isacharunderscore}}scheme{\isaliteral{22}{\isachardoublequote}}} made an abbreviation for
wenzelm@40685
   419
  \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}c\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ c\isaliteral{5C3C5E7375623E}{}\isactrlsub n\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7A6574613E}{\isasymzeta}}{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}}.
wenzelm@26849
   420
wenzelm@28788
   421
  \end{description}%
wenzelm@26849
   422
\end{isamarkuptext}%
wenzelm@26849
   423
\isamarkuptrue%
wenzelm@26849
   424
%
wenzelm@26849
   425
\isamarkupsubsection{Record operations%
wenzelm@26849
   426
}
wenzelm@26849
   427
\isamarkuptrue%
wenzelm@26849
   428
%
wenzelm@26849
   429
\begin{isamarkuptext}%
wenzelm@26849
   430
Any record definition of the form presented above produces certain
wenzelm@26849
   431
  standard operations.  Selectors and updates are provided for any
wenzelm@26849
   432
  field, including the improper one ``\isa{more}''.  There are also
wenzelm@26849
   433
  cumulative record constructor functions.  To simplify the
wenzelm@40685
   434
  presentation below, we assume for now that \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}{\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub m{\isaliteral{29}{\isacharparenright}}\ t{\isaliteral{22}{\isachardoublequote}}} is a root record with fields \isa{{\isaliteral{22}{\isachardoublequote}}c\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ c\isaliteral{5C3C5E7375623E}{}\isactrlsub n\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{22}{\isachardoublequote}}}.
wenzelm@26849
   435
wenzelm@26849
   436
  \medskip \textbf{Selectors} and \textbf{updates} are available for
wenzelm@26849
   437
  any field (including ``\isa{more}''):
wenzelm@26849
   438
wenzelm@26849
   439
  \begin{matharray}{lll}
wenzelm@40685
   440
    \isa{{\isaliteral{22}{\isachardoublequote}}c\isaliteral{5C3C5E7375623E}{}\isactrlsub i{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}\isaliteral{5C3C5E7665633E}{}\isactrlvec c\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C7369676D613E}{\isasymsigma}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7A6574613E}{\isasymzeta}}{\isaliteral{5C3C72706172723E}{\isasymrparr}}\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub i{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
   441
    \isa{{\isaliteral{22}{\isachardoublequote}}c\isaliteral{5C3C5E7375623E}{}\isactrlsub i{\isaliteral{5F}{\isacharunderscore}}update{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub i\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C6C706172723E}{\isasymlparr}}\isaliteral{5C3C5E7665633E}{}\isactrlvec c\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C7369676D613E}{\isasymsigma}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7A6574613E}{\isasymzeta}}{\isaliteral{5C3C72706172723E}{\isasymrparr}}\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C6C706172723E}{\isasymlparr}}\isaliteral{5C3C5E7665633E}{}\isactrlvec c\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C7369676D613E}{\isasymsigma}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7A6574613E}{\isasymzeta}}{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@26849
   442
  \end{matharray}
wenzelm@26849
   443
wenzelm@40685
   444
  There is special syntax for application of updates: \isa{{\isaliteral{22}{\isachardoublequote}}r{\isaliteral{5C3C6C706172723E}{\isasymlparr}}x\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3D}{\isacharequal}}\ a{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}} abbreviates term \isa{{\isaliteral{22}{\isachardoublequote}}x{\isaliteral{5F}{\isacharunderscore}}update\ a\ r{\isaliteral{22}{\isachardoublequote}}}.  Further notation for
wenzelm@40685
   445
  repeated updates is also available: \isa{{\isaliteral{22}{\isachardoublequote}}r{\isaliteral{5C3C6C706172723E}{\isasymlparr}}x\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3D}{\isacharequal}}\ a{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}y\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3D}{\isacharequal}}\ b{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}z\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3D}{\isacharequal}}\ c{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}} may be written \isa{{\isaliteral{22}{\isachardoublequote}}r{\isaliteral{5C3C6C706172723E}{\isasymlparr}}x\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3D}{\isacharequal}}\ a{\isaliteral{2C}{\isacharcomma}}\ y\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3D}{\isacharequal}}\ b{\isaliteral{2C}{\isacharcomma}}\ z\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3D}{\isacharequal}}\ c{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}}.  Note that
wenzelm@26849
   446
  because of postfix notation the order of fields shown here is
wenzelm@26849
   447
  reverse than in the actual term.  Since repeated updates are just
wenzelm@40685
   448
  function applications, fields may be freely permuted in \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}x\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3D}{\isacharequal}}\ a{\isaliteral{2C}{\isacharcomma}}\ y\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3D}{\isacharequal}}\ b{\isaliteral{2C}{\isacharcomma}}\ z\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3D}{\isacharequal}}\ c{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}}, as far as logical equality is concerned.
wenzelm@26849
   449
  Thus commutativity of independent updates can be proven within the
wenzelm@26849
   450
  logic for any two fields, but not as a general theorem.
wenzelm@26849
   451
wenzelm@26849
   452
  \medskip The \textbf{make} operation provides a cumulative record
wenzelm@26849
   453
  constructor function:
wenzelm@26849
   454
wenzelm@26849
   455
  \begin{matharray}{lll}
wenzelm@40685
   456
    \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}make{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub n\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C6C706172723E}{\isasymlparr}}\isaliteral{5C3C5E7665633E}{}\isactrlvec c\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C7369676D613E}{\isasymsigma}}{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@26849
   457
  \end{matharray}
wenzelm@26849
   458
wenzelm@26849
   459
  \medskip We now reconsider the case of non-root records, which are
wenzelm@26849
   460
  derived of some parent.  In general, the latter may depend on
wenzelm@26849
   461
  another parent as well, resulting in a list of \emph{ancestor
wenzelm@26849
   462
  records}.  Appending the lists of fields of all ancestors results in
wenzelm@26849
   463
  a certain field prefix.  The record package automatically takes care
wenzelm@26849
   464
  of this by lifting operations over this context of ancestor fields.
wenzelm@40685
   465
  Assuming that \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}{\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E7375623E}{}\isactrlsub m{\isaliteral{29}{\isacharparenright}}\ t{\isaliteral{22}{\isachardoublequote}}} has ancestor
wenzelm@40685
   466
  fields \isa{{\isaliteral{22}{\isachardoublequote}}b\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C72686F3E}{\isasymrho}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ b\isaliteral{5C3C5E7375623E}{}\isactrlsub k\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C72686F3E}{\isasymrho}}\isaliteral{5C3C5E7375623E}{}\isactrlsub k{\isaliteral{22}{\isachardoublequote}}},
wenzelm@26849
   467
  the above record operations will get the following types:
wenzelm@26849
   468
wenzelm@26852
   469
  \medskip
wenzelm@26852
   470
  \begin{tabular}{lll}
wenzelm@40685
   471
    \isa{{\isaliteral{22}{\isachardoublequote}}c\isaliteral{5C3C5E7375623E}{}\isactrlsub i{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}\isaliteral{5C3C5E7665633E}{}\isactrlvec b\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C72686F3E}{\isasymrho}}{\isaliteral{2C}{\isacharcomma}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec c\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C7369676D613E}{\isasymsigma}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7A6574613E}{\isasymzeta}}{\isaliteral{5C3C72706172723E}{\isasymrparr}}\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub i{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
   472
    \isa{{\isaliteral{22}{\isachardoublequote}}c\isaliteral{5C3C5E7375623E}{}\isactrlsub i{\isaliteral{5F}{\isacharunderscore}}update{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub i\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C6C706172723E}{\isasymlparr}}\isaliteral{5C3C5E7665633E}{}\isactrlvec b\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C72686F3E}{\isasymrho}}{\isaliteral{2C}{\isacharcomma}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec c\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C7369676D613E}{\isasymsigma}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7A6574613E}{\isasymzeta}}{\isaliteral{5C3C72706172723E}{\isasymrparr}}\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C6C706172723E}{\isasymlparr}}\isaliteral{5C3C5E7665633E}{}\isactrlvec b\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C72686F3E}{\isasymrho}}{\isaliteral{2C}{\isacharcomma}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec c\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C7369676D613E}{\isasymsigma}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7A6574613E}{\isasymzeta}}{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
   473
    \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}make{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C72686F3E}{\isasymrho}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{5C3C72686F3E}{\isasymrho}}\isaliteral{5C3C5E7375623E}{}\isactrlsub k\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub n\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C6C706172723E}{\isasymlparr}}\isaliteral{5C3C5E7665633E}{}\isactrlvec b\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C72686F3E}{\isasymrho}}{\isaliteral{2C}{\isacharcomma}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec c\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C7369676D613E}{\isasymsigma}}{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@26852
   474
  \end{tabular}
wenzelm@26852
   475
  \medskip
wenzelm@26849
   476
wenzelm@26852
   477
  \noindent Some further operations address the extension aspect of a
wenzelm@40685
   478
  derived record scheme specifically: \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}fields{\isaliteral{22}{\isachardoublequote}}} produces a
wenzelm@26849
   479
  record fragment consisting of exactly the new fields introduced here
wenzelm@40685
   480
  (the result may serve as a more part elsewhere); \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}extend{\isaliteral{22}{\isachardoublequote}}}
wenzelm@40685
   481
  takes a fixed record and adds a given more part; \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}truncate{\isaliteral{22}{\isachardoublequote}}} restricts a record scheme to a fixed record.
wenzelm@26849
   482
wenzelm@26852
   483
  \medskip
wenzelm@26852
   484
  \begin{tabular}{lll}
wenzelm@40685
   485
    \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}fields{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E7375623E}{}\isactrlsub n\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C6C706172723E}{\isasymlparr}}\isaliteral{5C3C5E7665633E}{}\isactrlvec c\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C7369676D613E}{\isasymsigma}}{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
   486
    \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}extend{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}\isaliteral{5C3C5E7665633E}{}\isactrlvec b\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C72686F3E}{\isasymrho}}{\isaliteral{2C}{\isacharcomma}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec c\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C7369676D613E}{\isasymsigma}}{\isaliteral{5C3C72706172723E}{\isasymrparr}}\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C7A6574613E}{\isasymzeta}}\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C6C706172723E}{\isasymlparr}}\isaliteral{5C3C5E7665633E}{}\isactrlvec b\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C72686F3E}{\isasymrho}}{\isaliteral{2C}{\isacharcomma}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec c\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C7369676D613E}{\isasymsigma}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7A6574613E}{\isasymzeta}}{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
   487
    \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}truncate{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6C706172723E}{\isasymlparr}}\isaliteral{5C3C5E7665633E}{}\isactrlvec b\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C72686F3E}{\isasymrho}}{\isaliteral{2C}{\isacharcomma}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec c\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C7369676D613E}{\isasymsigma}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{5C3C7A6574613E}{\isasymzeta}}{\isaliteral{5C3C72706172723E}{\isasymrparr}}\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C6C706172723E}{\isasymlparr}}\isaliteral{5C3C5E7665633E}{}\isactrlvec b\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C72686F3E}{\isasymrho}}{\isaliteral{2C}{\isacharcomma}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec c\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ \isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C7369676D613E}{\isasymsigma}}{\isaliteral{5C3C72706172723E}{\isasymrparr}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@26852
   488
  \end{tabular}
wenzelm@26852
   489
  \medskip
wenzelm@26849
   490
wenzelm@40685
   491
  \noindent Note that \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}make{\isaliteral{22}{\isachardoublequote}}} and \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}fields{\isaliteral{22}{\isachardoublequote}}} coincide
wenzelm@26849
   492
  for root records.%
wenzelm@26849
   493
\end{isamarkuptext}%
wenzelm@26849
   494
\isamarkuptrue%
wenzelm@26849
   495
%
wenzelm@26849
   496
\isamarkupsubsection{Derived rules and proof tools%
wenzelm@26849
   497
}
wenzelm@26849
   498
\isamarkuptrue%
wenzelm@26849
   499
%
wenzelm@26849
   500
\begin{isamarkuptext}%
wenzelm@26849
   501
The record package proves several results internally, declaring
wenzelm@26849
   502
  these facts to appropriate proof tools.  This enables users to
wenzelm@26849
   503
  reason about record structures quite conveniently.  Assume that
wenzelm@26849
   504
  \isa{t} is a record type as specified above.
wenzelm@26849
   505
wenzelm@26849
   506
  \begin{enumerate}
wenzelm@42994
   507
wenzelm@26849
   508
  \item Standard conversions for selectors or updates applied to
wenzelm@26849
   509
  record constructor terms are made part of the default Simplifier
wenzelm@26849
   510
  context; thus proofs by reduction of basic operations merely require
wenzelm@26902
   511
  the \hyperlink{method.simp}{\mbox{\isa{simp}}} method without further arguments.  These rules
wenzelm@40685
   512
  are available as \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}simps{\isaliteral{22}{\isachardoublequote}}}, too.
wenzelm@42994
   513
wenzelm@26849
   514
  \item Selectors applied to updated records are automatically reduced
wenzelm@26849
   515
  by an internal simplification procedure, which is also part of the
wenzelm@26849
   516
  standard Simplifier setup.
wenzelm@26849
   517
wenzelm@40685
   518
  \item Inject equations of a form analogous to \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}x{\isaliteral{2C}{\isacharcomma}}\ y{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{3D}{\isacharequal}}\ {\isaliteral{28}{\isacharparenleft}}x{\isaliteral{27}{\isacharprime}}{\isaliteral{2C}{\isacharcomma}}\ y{\isaliteral{27}{\isacharprime}}{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{5C3C65717569763E}{\isasymequiv}}\ x\ {\isaliteral{3D}{\isacharequal}}\ x{\isaliteral{27}{\isacharprime}}\ {\isaliteral{5C3C616E643E}{\isasymand}}\ y\ {\isaliteral{3D}{\isacharequal}}\ y{\isaliteral{27}{\isacharprime}}{\isaliteral{22}{\isachardoublequote}}} are declared to the Simplifier and Classical
wenzelm@26902
   519
  Reasoner as \hyperlink{attribute.iff}{\mbox{\isa{iff}}} rules.  These rules are available as
wenzelm@40685
   520
  \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}iffs{\isaliteral{22}{\isachardoublequote}}}.
wenzelm@26849
   521
wenzelm@40685
   522
  \item The introduction rule for record equality analogous to \isa{{\isaliteral{22}{\isachardoublequote}}x\ r\ {\isaliteral{3D}{\isacharequal}}\ x\ r{\isaliteral{27}{\isacharprime}}\ {\isaliteral{5C3C4C6F6E6772696768746172726F773E}{\isasymLongrightarrow}}\ y\ r\ {\isaliteral{3D}{\isacharequal}}\ y\ r{\isaliteral{27}{\isacharprime}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{5C3C4C6F6E6772696768746172726F773E}{\isasymLongrightarrow}}\ r\ {\isaliteral{3D}{\isacharequal}}\ r{\isaliteral{27}{\isacharprime}}{\isaliteral{22}{\isachardoublequote}}} is declared to the Simplifier,
wenzelm@40685
   523
  and as the basic rule context as ``\hyperlink{attribute.intro}{\mbox{\isa{intro}}}\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3F}{\isacharquery}}{\isaliteral{22}{\isachardoublequote}}}''.
wenzelm@40685
   524
  The rule is called \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}equality{\isaliteral{22}{\isachardoublequote}}}.
wenzelm@26849
   525
wenzelm@26849
   526
  \item Representations of arbitrary record expressions as canonical
wenzelm@26902
   527
  constructor terms are provided both in \hyperlink{method.cases}{\mbox{\isa{cases}}} and \hyperlink{method.induct}{\mbox{\isa{induct}}} format (cf.\ the generic proof methods of the same name,
wenzelm@26849
   528
  \secref{sec:cases-induct}).  Several variations are available, for
wenzelm@26849
   529
  fixed records, record schemes, more parts etc.
wenzelm@42994
   530
wenzelm@26849
   531
  The generic proof methods are sufficiently smart to pick the most
wenzelm@26849
   532
  sensible rule according to the type of the indicated record
wenzelm@40685
   533
  expression: users just need to apply something like ``\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}cases\ r{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequote}}}'' to a certain proof problem.
wenzelm@26849
   534
wenzelm@40685
   535
  \item The derived record operations \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}make{\isaliteral{22}{\isachardoublequote}}}, \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}fields{\isaliteral{22}{\isachardoublequote}}}, \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}extend{\isaliteral{22}{\isachardoublequote}}}, \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}truncate{\isaliteral{22}{\isachardoublequote}}} are \emph{not}
wenzelm@26849
   536
  treated automatically, but usually need to be expanded by hand,
wenzelm@40685
   537
  using the collective fact \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{2E}{\isachardot}}defs{\isaliteral{22}{\isachardoublequote}}}.
wenzelm@26849
   538
wenzelm@26849
   539
  \end{enumerate}%
wenzelm@26849
   540
\end{isamarkuptext}%
wenzelm@26849
   541
\isamarkuptrue%
wenzelm@26849
   542
%
wenzelm@26849
   543
\isamarkupsection{Datatypes \label{sec:hol-datatype}%
wenzelm@26849
   544
}
wenzelm@26849
   545
\isamarkuptrue%
wenzelm@26849
   546
%
wenzelm@26849
   547
\begin{isamarkuptext}%
wenzelm@26849
   548
\begin{matharray}{rcl}
wenzelm@40685
   549
    \indexdef{HOL}{command}{datatype}\hypertarget{command.HOL.datatype}{\hyperlink{command.HOL.datatype}{\mbox{\isa{\isacommand{datatype}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
haftmann@41644
   550
    \indexdef{HOL}{command}{rep\_datatype}\hypertarget{command.HOL.rep-datatype}{\hyperlink{command.HOL.rep-datatype}{\mbox{\isa{\isacommand{rep{\isaliteral{5F}{\isacharunderscore}}datatype}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ proof{\isaliteral{28}{\isacharparenleft}}prove{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@26849
   551
  \end{matharray}
wenzelm@26849
   552
wenzelm@43467
   553
  \begin{railoutput}
wenzelm@43535
   554
\rail@begin{2}{}
wenzelm@43467
   555
\rail@term{\hyperlink{command.HOL.datatype}{\mbox{\isa{\isacommand{datatype}}}}}[]
wenzelm@43467
   556
\rail@plus
wenzelm@43575
   557
\rail@nont{\isa{spec}}[]
wenzelm@43467
   558
\rail@nextplus{1}
wenzelm@43467
   559
\rail@cterm{\isa{\isakeyword{and}}}[]
wenzelm@43467
   560
\rail@endplus
wenzelm@43467
   561
\rail@end
wenzelm@43535
   562
\rail@begin{3}{}
wenzelm@43467
   563
\rail@term{\hyperlink{command.HOL.rep-datatype}{\mbox{\isa{\isacommand{rep{\isaliteral{5F}{\isacharunderscore}}datatype}}}}}[]
wenzelm@43467
   564
\rail@bar
wenzelm@43467
   565
\rail@nextbar{1}
wenzelm@43467
   566
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
   567
\rail@plus
wenzelm@43467
   568
\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
   569
\rail@nextplus{2}
wenzelm@43467
   570
\rail@endplus
wenzelm@43467
   571
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
   572
\rail@endbar
wenzelm@43467
   573
\rail@plus
wenzelm@43467
   574
\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]
wenzelm@43467
   575
\rail@nextplus{1}
wenzelm@43467
   576
\rail@endplus
wenzelm@43467
   577
\rail@end
wenzelm@43575
   578
\rail@begin{2}{\isa{spec}}
wenzelm@43467
   579
\rail@bar
wenzelm@43467
   580
\rail@nextbar{1}
wenzelm@43467
   581
\rail@nont{\hyperlink{syntax.parname}{\mbox{\isa{parname}}}}[]
wenzelm@43467
   582
\rail@endbar
wenzelm@43467
   583
\rail@nont{\hyperlink{syntax.typespec}{\mbox{\isa{typespec}}}}[]
wenzelm@43467
   584
\rail@bar
wenzelm@43467
   585
\rail@nextbar{1}
wenzelm@43467
   586
\rail@nont{\hyperlink{syntax.mixfix}{\mbox{\isa{mixfix}}}}[]
wenzelm@43467
   587
\rail@endbar
wenzelm@43467
   588
\rail@term{\isa{{\isaliteral{3D}{\isacharequal}}}}[]
wenzelm@43467
   589
\rail@plus
wenzelm@43467
   590
\rail@nont{\isa{cons}}[]
wenzelm@43467
   591
\rail@nextplus{1}
wenzelm@43467
   592
\rail@cterm{\isa{{\isaliteral{7C}{\isacharbar}}}}[]
wenzelm@43467
   593
\rail@endplus
wenzelm@43467
   594
\rail@end
wenzelm@43467
   595
\rail@begin{2}{\isa{cons}}
wenzelm@43467
   596
\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
   597
\rail@plus
wenzelm@43467
   598
\rail@nextplus{1}
wenzelm@43467
   599
\rail@cnont{\hyperlink{syntax.type}{\mbox{\isa{type}}}}[]
wenzelm@43467
   600
\rail@endplus
wenzelm@43467
   601
\rail@bar
wenzelm@43467
   602
\rail@nextbar{1}
wenzelm@43467
   603
\rail@nont{\hyperlink{syntax.mixfix}{\mbox{\isa{mixfix}}}}[]
wenzelm@43467
   604
\rail@endbar
wenzelm@43467
   605
\rail@end
wenzelm@43467
   606
\end{railoutput}
wenzelm@26849
   607
wenzelm@26849
   608
wenzelm@28788
   609
  \begin{description}
wenzelm@26849
   610
wenzelm@28788
   611
  \item \hyperlink{command.HOL.datatype}{\mbox{\isa{\isacommand{datatype}}}} defines inductive datatypes in
wenzelm@26849
   612
  HOL.
wenzelm@26849
   613
wenzelm@40685
   614
  \item \hyperlink{command.HOL.rep-datatype}{\mbox{\isa{\isacommand{rep{\isaliteral{5F}{\isacharunderscore}}datatype}}}} represents existing types as
wenzelm@26849
   615
  inductive ones, generating the standard infrastructure of derived
wenzelm@26849
   616
  concepts (primitive recursion etc.).
wenzelm@26849
   617
wenzelm@28788
   618
  \end{description}
wenzelm@26849
   619
wenzelm@26849
   620
  The induction and exhaustion theorems generated provide case names
wenzelm@26849
   621
  according to the constructors involved, while parameters are named
wenzelm@26849
   622
  after the types (see also \secref{sec:cases-induct}).
wenzelm@26849
   623
wenzelm@26849
   624
  See \cite{isabelle-HOL} for more details on datatypes, but beware of
wenzelm@26849
   625
  the old-style theory syntax being used there!  Apart from proper
wenzelm@26849
   626
  proof methods for case-analysis and induction, there are also
wenzelm@40685
   627
  emulations of ML tactics \hyperlink{method.HOL.case-tac}{\mbox{\isa{case{\isaliteral{5F}{\isacharunderscore}}tac}}} and \hyperlink{method.HOL.induct-tac}{\mbox{\isa{induct{\isaliteral{5F}{\isacharunderscore}}tac}}} available, see \secref{sec:hol-induct-tac}; these admit
wenzelm@26849
   628
  to refer directly to the internal structure of subgoals (including
wenzelm@26849
   629
  internally bound parameters).%
wenzelm@26849
   630
\end{isamarkuptext}%
wenzelm@26849
   631
\isamarkuptrue%
wenzelm@26849
   632
%
haftmann@41644
   633
\isamarkupsection{Functorial structure of types%
haftmann@41644
   634
}
haftmann@41644
   635
\isamarkuptrue%
haftmann@41644
   636
%
haftmann@41644
   637
\begin{isamarkuptext}%
haftmann@41644
   638
\begin{matharray}{rcl}
haftmann@41753
   639
    \indexdef{HOL}{command}{enriched\_type}\hypertarget{command.HOL.enriched-type}{\hyperlink{command.HOL.enriched-type}{\mbox{\isa{\isacommand{enriched{\isaliteral{5F}{\isacharunderscore}}type}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ proof{\isaliteral{28}{\isacharparenleft}}prove{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequote}}}
haftmann@41644
   640
  \end{matharray}
haftmann@41644
   641
wenzelm@43467
   642
  \begin{railoutput}
wenzelm@43535
   643
\rail@begin{2}{}
wenzelm@43467
   644
\rail@term{\hyperlink{command.HOL.enriched-type}{\mbox{\isa{\isacommand{enriched{\isaliteral{5F}{\isacharunderscore}}type}}}}}[]
wenzelm@43467
   645
\rail@bar
wenzelm@43467
   646
\rail@nextbar{1}
wenzelm@43488
   647
\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
   648
\rail@term{\isa{{\isaliteral{3A}{\isacharcolon}}}}[]
wenzelm@43467
   649
\rail@endbar
wenzelm@43467
   650
\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]
wenzelm@43467
   651
\rail@end
wenzelm@43467
   652
\end{railoutput}
wenzelm@43488
   653
haftmann@41644
   654
haftmann@41644
   655
  \begin{description}
haftmann@41644
   656
wenzelm@43488
   657
  \item \hyperlink{command.HOL.enriched-type}{\mbox{\isa{\isacommand{enriched{\isaliteral{5F}{\isacharunderscore}}type}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}prefix{\isaliteral{3A}{\isacharcolon}}\ m{\isaliteral{22}{\isachardoublequote}}} allows to
wenzelm@43488
   658
  prove and register properties about the functorial structure of type
wenzelm@43488
   659
  constructors.  These properties then can be used by other packages
wenzelm@43488
   660
  to deal with those type constructors in certain type constructions.
wenzelm@43488
   661
  Characteristic theorems are noted in the current local theory.  By
wenzelm@43488
   662
  default, they are prefixed with the base name of the type
wenzelm@43488
   663
  constructor, an explicit prefix can be given alternatively.
haftmann@41644
   664
haftmann@41644
   665
  The given term \isa{{\isaliteral{22}{\isachardoublequote}}m{\isaliteral{22}{\isachardoublequote}}} is considered as \emph{mapper} for the
haftmann@41644
   666
  corresponding type constructor and must conform to the following
haftmann@41644
   667
  type pattern:
haftmann@41644
   668
haftmann@41644
   669
  \begin{matharray}{lll}
haftmann@41644
   670
    \isa{{\isaliteral{22}{\isachardoublequote}}m{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}{\isaliteral{22}{\isachardoublequote}}} &
haftmann@41644
   671
      \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E697375623E}{}\isactrlisub {\isadigit{1}}\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E697375623E}{}\isactrlisub k\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{28}{\isacharparenleft}}\isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E697375623E}{}\isactrlisub n{\isaliteral{29}{\isacharparenright}}\ t\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{28}{\isacharparenleft}}\isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C626574613E}{\isasymbeta}}\isaliteral{5C3C5E697375623E}{}\isactrlisub n{\isaliteral{29}{\isacharparenright}}\ t{\isaliteral{22}{\isachardoublequote}}} \\
haftmann@41644
   672
  \end{matharray}
haftmann@41644
   673
haftmann@41644
   674
  \noindent where \isa{t} is the type constructor, \isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E697375623E}{}\isactrlisub n{\isaliteral{22}{\isachardoublequote}}} and \isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7665633E}{}\isactrlvec {\isaliteral{5C3C626574613E}{\isasymbeta}}\isaliteral{5C3C5E697375623E}{}\isactrlisub n{\isaliteral{22}{\isachardoublequote}}} are distinct
haftmann@41644
   675
  type variables free in the local theory and \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E697375623E}{}\isactrlisub {\isadigit{1}}{\isaliteral{22}{\isachardoublequote}}},
haftmann@41644
   676
  \ldots, \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C7369676D613E}{\isasymsigma}}\isaliteral{5C3C5E697375623E}{}\isactrlisub k{\isaliteral{22}{\isachardoublequote}}} is a subsequence of \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E697375623E}{}\isactrlisub {\isadigit{1}}\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C626574613E}{\isasymbeta}}\isaliteral{5C3C5E697375623E}{}\isactrlisub {\isadigit{1}}{\isaliteral{22}{\isachardoublequote}}}, \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C626574613E}{\isasymbeta}}\isaliteral{5C3C5E697375623E}{}\isactrlisub {\isadigit{1}}\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E697375623E}{}\isactrlisub {\isadigit{1}}{\isaliteral{22}{\isachardoublequote}}}, \ldots,
haftmann@41644
   677
  \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E697375623E}{}\isactrlisub n\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C626574613E}{\isasymbeta}}\isaliteral{5C3C5E697375623E}{}\isactrlisub n{\isaliteral{22}{\isachardoublequote}}}, \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C626574613E}{\isasymbeta}}\isaliteral{5C3C5E697375623E}{}\isactrlisub n\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{5C3C616C7068613E}{\isasymalpha}}\isaliteral{5C3C5E697375623E}{}\isactrlisub n{\isaliteral{22}{\isachardoublequote}}}.
haftmann@41644
   678
haftmann@41644
   679
  \end{description}%
haftmann@41644
   680
\end{isamarkuptext}%
haftmann@41644
   681
\isamarkuptrue%
haftmann@41644
   682
%
wenzelm@26849
   683
\isamarkupsection{Recursive functions \label{sec:recursion}%
wenzelm@26849
   684
}
wenzelm@26849
   685
\isamarkuptrue%
wenzelm@26849
   686
%
wenzelm@26849
   687
\begin{isamarkuptext}%
wenzelm@26849
   688
\begin{matharray}{rcl}
wenzelm@40685
   689
    \indexdef{HOL}{command}{primrec}\hypertarget{command.HOL.primrec}{\hyperlink{command.HOL.primrec}{\mbox{\isa{\isacommand{primrec}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ local{\isaliteral{5F}{\isacharunderscore}}theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
   690
    \indexdef{HOL}{command}{fun}\hypertarget{command.HOL.fun}{\hyperlink{command.HOL.fun}{\mbox{\isa{\isacommand{fun}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ local{\isaliteral{5F}{\isacharunderscore}}theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
   691
    \indexdef{HOL}{command}{function}\hypertarget{command.HOL.function}{\hyperlink{command.HOL.function}{\mbox{\isa{\isacommand{function}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ proof{\isaliteral{28}{\isacharparenleft}}prove{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
   692
    \indexdef{HOL}{command}{termination}\hypertarget{command.HOL.termination}{\hyperlink{command.HOL.termination}{\mbox{\isa{\isacommand{termination}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ proof{\isaliteral{28}{\isacharparenleft}}prove{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@26849
   693
  \end{matharray}
wenzelm@26849
   694
wenzelm@43467
   695
  \begin{railoutput}
wenzelm@43535
   696
\rail@begin{2}{}
wenzelm@43467
   697
\rail@term{\hyperlink{command.HOL.primrec}{\mbox{\isa{\isacommand{primrec}}}}}[]
wenzelm@43467
   698
\rail@bar
wenzelm@43467
   699
\rail@nextbar{1}
wenzelm@43467
   700
\rail@nont{\hyperlink{syntax.target}{\mbox{\isa{target}}}}[]
wenzelm@43467
   701
\rail@endbar
wenzelm@43467
   702
\rail@nont{\hyperlink{syntax.fixes}{\mbox{\isa{fixes}}}}[]
wenzelm@43467
   703
\rail@term{\isa{\isakeyword{where}}}[]
wenzelm@43467
   704
\rail@nont{\isa{equations}}[]
wenzelm@43467
   705
\rail@end
wenzelm@43535
   706
\rail@begin{4}{}
wenzelm@43467
   707
\rail@bar
wenzelm@43467
   708
\rail@term{\hyperlink{command.HOL.fun}{\mbox{\isa{\isacommand{fun}}}}}[]
wenzelm@43467
   709
\rail@nextbar{1}
wenzelm@43467
   710
\rail@term{\hyperlink{command.HOL.function}{\mbox{\isa{\isacommand{function}}}}}[]
wenzelm@43467
   711
\rail@endbar
wenzelm@43467
   712
\rail@bar
wenzelm@43467
   713
\rail@nextbar{1}
wenzelm@43467
   714
\rail@nont{\hyperlink{syntax.target}{\mbox{\isa{target}}}}[]
wenzelm@43467
   715
\rail@endbar
wenzelm@43467
   716
\rail@bar
wenzelm@43467
   717
\rail@nextbar{1}
wenzelm@43467
   718
\rail@nont{\isa{functionopts}}[]
wenzelm@43467
   719
\rail@endbar
wenzelm@43467
   720
\rail@nont{\hyperlink{syntax.fixes}{\mbox{\isa{fixes}}}}[]
wenzelm@43467
   721
\rail@cr{3}
wenzelm@43467
   722
\rail@term{\isa{\isakeyword{where}}}[]
wenzelm@43467
   723
\rail@nont{\isa{equations}}[]
wenzelm@43467
   724
\rail@end
wenzelm@43467
   725
\rail@begin{3}{\isa{equations}}
wenzelm@43467
   726
\rail@plus
wenzelm@43467
   727
\rail@bar
wenzelm@43467
   728
\rail@nextbar{1}
wenzelm@43467
   729
\rail@nont{\hyperlink{syntax.thmdecl}{\mbox{\isa{thmdecl}}}}[]
wenzelm@43467
   730
\rail@endbar
wenzelm@43467
   731
\rail@nont{\hyperlink{syntax.prop}{\mbox{\isa{prop}}}}[]
wenzelm@43467
   732
\rail@nextplus{2}
wenzelm@43467
   733
\rail@cterm{\isa{{\isaliteral{7C}{\isacharbar}}}}[]
wenzelm@43467
   734
\rail@endplus
wenzelm@43467
   735
\rail@end
wenzelm@43467
   736
\rail@begin{3}{\isa{functionopts}}
wenzelm@43467
   737
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
   738
\rail@plus
wenzelm@43467
   739
\rail@bar
wenzelm@43467
   740
\rail@term{\isa{sequential}}[]
wenzelm@43467
   741
\rail@nextbar{1}
wenzelm@43467
   742
\rail@term{\isa{domintros}}[]
wenzelm@43467
   743
\rail@endbar
wenzelm@43467
   744
\rail@nextplus{2}
wenzelm@43467
   745
\rail@cterm{\isa{{\isaliteral{2C}{\isacharcomma}}}}[]
wenzelm@43467
   746
\rail@endplus
wenzelm@43467
   747
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
   748
\rail@end
wenzelm@43535
   749
\rail@begin{2}{}
wenzelm@43467
   750
\rail@term{\hyperlink{command.HOL.termination}{\mbox{\isa{\isacommand{termination}}}}}[]
wenzelm@43467
   751
\rail@bar
wenzelm@43467
   752
\rail@nextbar{1}
wenzelm@43467
   753
\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]
wenzelm@43467
   754
\rail@endbar
wenzelm@43467
   755
\rail@end
wenzelm@43467
   756
\end{railoutput}
wenzelm@43467
   757
wenzelm@26849
   758
wenzelm@28788
   759
  \begin{description}
wenzelm@26849
   760
wenzelm@28788
   761
  \item \hyperlink{command.HOL.primrec}{\mbox{\isa{\isacommand{primrec}}}} defines primitive recursive
wenzelm@26849
   762
  functions over datatypes, see also \cite{isabelle-HOL}.
wenzelm@26849
   763
wenzelm@28788
   764
  \item \hyperlink{command.HOL.function}{\mbox{\isa{\isacommand{function}}}} defines functions by general
wenzelm@26849
   765
  wellfounded recursion. A detailed description with examples can be
wenzelm@26849
   766
  found in \cite{isabelle-function}. The function is specified by a
wenzelm@26849
   767
  set of (possibly conditional) recursive equations with arbitrary
wenzelm@26849
   768
  pattern matching. The command generates proof obligations for the
wenzelm@26849
   769
  completeness and the compatibility of patterns.
wenzelm@26849
   770
wenzelm@26849
   771
  The defined function is considered partial, and the resulting
wenzelm@40685
   772
  simplification rules (named \isa{{\isaliteral{22}{\isachardoublequote}}f{\isaliteral{2E}{\isachardot}}psimps{\isaliteral{22}{\isachardoublequote}}}) and induction rule
wenzelm@40685
   773
  (named \isa{{\isaliteral{22}{\isachardoublequote}}f{\isaliteral{2E}{\isachardot}}pinduct{\isaliteral{22}{\isachardoublequote}}}) are guarded by a generated domain
wenzelm@40685
   774
  predicate \isa{{\isaliteral{22}{\isachardoublequote}}f{\isaliteral{5F}{\isacharunderscore}}dom{\isaliteral{22}{\isachardoublequote}}}. The \hyperlink{command.HOL.termination}{\mbox{\isa{\isacommand{termination}}}}
wenzelm@26849
   775
  command can then be used to establish that the function is total.
wenzelm@26849
   776
wenzelm@40685
   777
  \item \hyperlink{command.HOL.fun}{\mbox{\isa{\isacommand{fun}}}} is a shorthand notation for ``\hyperlink{command.HOL.function}{\mbox{\isa{\isacommand{function}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}sequential{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequote}}}, followed by automated
wenzelm@28788
   778
  proof attempts regarding pattern matching and termination.  See
wenzelm@28788
   779
  \cite{isabelle-function} for further details.
wenzelm@26849
   780
wenzelm@28788
   781
  \item \hyperlink{command.HOL.termination}{\mbox{\isa{\isacommand{termination}}}}~\isa{f} commences a
wenzelm@26849
   782
  termination proof for the previously defined function \isa{f}.  If
wenzelm@26849
   783
  this is omitted, the command refers to the most recent function
wenzelm@26849
   784
  definition.  After the proof is closed, the recursive equations and
wenzelm@26849
   785
  the induction principle is established.
wenzelm@26849
   786
wenzelm@28788
   787
  \end{description}
wenzelm@26849
   788
haftmann@27452
   789
  Recursive definitions introduced by the \hyperlink{command.HOL.function}{\mbox{\isa{\isacommand{function}}}}
haftmann@27452
   790
  command accommodate
wenzelm@40685
   791
  reasoning by induction (cf.\ \secref{sec:cases-induct}): rule \isa{{\isaliteral{22}{\isachardoublequote}}c{\isaliteral{2E}{\isachardot}}induct{\isaliteral{22}{\isachardoublequote}}} (where \isa{c} is the name of the function definition)
wenzelm@26849
   792
  refers to a specific induction rule, with parameters named according
krauss@33857
   793
  to the user-specified equations. Cases are numbered (starting from 1).
krauss@33857
   794
krauss@33857
   795
  For \hyperlink{command.HOL.primrec}{\mbox{\isa{\isacommand{primrec}}}}, the induction principle coincides
haftmann@27452
   796
  with structural recursion on the datatype the recursion is carried
haftmann@27452
   797
  out.
wenzelm@26849
   798
wenzelm@26849
   799
  The equations provided by these packages may be referred later as
wenzelm@40685
   800
  theorem list \isa{{\isaliteral{22}{\isachardoublequote}}f{\isaliteral{2E}{\isachardot}}simps{\isaliteral{22}{\isachardoublequote}}}, where \isa{f} is the (collective)
wenzelm@26849
   801
  name of the functions defined.  Individual equations may be named
wenzelm@26849
   802
  explicitly as well.
wenzelm@26849
   803
wenzelm@26902
   804
  The \hyperlink{command.HOL.function}{\mbox{\isa{\isacommand{function}}}} command accepts the following
wenzelm@26849
   805
  options.
wenzelm@26849
   806
wenzelm@28788
   807
  \begin{description}
wenzelm@26849
   808
wenzelm@28788
   809
  \item \isa{sequential} enables a preprocessor which disambiguates
wenzelm@28788
   810
  overlapping patterns by making them mutually disjoint.  Earlier
wenzelm@28788
   811
  equations take precedence over later ones.  This allows to give the
wenzelm@28788
   812
  specification in a format very similar to functional programming.
wenzelm@28788
   813
  Note that the resulting simplification and induction rules
wenzelm@28788
   814
  correspond to the transformed specification, not the one given
wenzelm@26849
   815
  originally. This usually means that each equation given by the user
hoelzl@36137
   816
  may result in several theorems.  Also note that this automatic
wenzelm@26849
   817
  transformation only works for ML-style datatype patterns.
wenzelm@26849
   818
wenzelm@28788
   819
  \item \isa{domintros} enables the automated generation of
wenzelm@26849
   820
  introduction rules for the domain predicate. While mostly not
wenzelm@26849
   821
  needed, they can be helpful in some proofs about partial functions.
wenzelm@26849
   822
wenzelm@28788
   823
  \end{description}%
wenzelm@26849
   824
\end{isamarkuptext}%
wenzelm@26849
   825
\isamarkuptrue%
wenzelm@26849
   826
%
wenzelm@26849
   827
\isamarkupsubsection{Proof methods related to recursive definitions%
wenzelm@26849
   828
}
wenzelm@26849
   829
\isamarkuptrue%
wenzelm@26849
   830
%
wenzelm@26849
   831
\begin{isamarkuptext}%
wenzelm@26849
   832
\begin{matharray}{rcl}
wenzelm@40685
   833
    \indexdef{HOL}{method}{pat\_completeness}\hypertarget{method.HOL.pat-completeness}{\hyperlink{method.HOL.pat-completeness}{\mbox{\isa{pat{\isaliteral{5F}{\isacharunderscore}}completeness}}}} & : & \isa{method} \\
wenzelm@28788
   834
    \indexdef{HOL}{method}{relation}\hypertarget{method.HOL.relation}{\hyperlink{method.HOL.relation}{\mbox{\isa{relation}}}} & : & \isa{method} \\
wenzelm@40685
   835
    \indexdef{HOL}{method}{lexicographic\_order}\hypertarget{method.HOL.lexicographic-order}{\hyperlink{method.HOL.lexicographic-order}{\mbox{\isa{lexicographic{\isaliteral{5F}{\isacharunderscore}}order}}}} & : & \isa{method} \\
wenzelm@40685
   836
    \indexdef{HOL}{method}{size\_change}\hypertarget{method.HOL.size-change}{\hyperlink{method.HOL.size-change}{\mbox{\isa{size{\isaliteral{5F}{\isacharunderscore}}change}}}} & : & \isa{method} \\
wenzelm@26849
   837
  \end{matharray}
wenzelm@26849
   838
wenzelm@43467
   839
  \begin{railoutput}
wenzelm@43535
   840
\rail@begin{1}{}
wenzelm@43467
   841
\rail@term{\hyperlink{method.HOL.relation}{\mbox{\isa{relation}}}}[]
wenzelm@43467
   842
\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]
wenzelm@43467
   843
\rail@end
wenzelm@43535
   844
\rail@begin{2}{}
wenzelm@43467
   845
\rail@term{\hyperlink{method.HOL.lexicographic-order}{\mbox{\isa{lexicographic{\isaliteral{5F}{\isacharunderscore}}order}}}}[]
wenzelm@43467
   846
\rail@plus
wenzelm@43467
   847
\rail@nextplus{1}
wenzelm@43467
   848
\rail@cnont{\hyperlink{syntax.clasimpmod}{\mbox{\isa{clasimpmod}}}}[]
wenzelm@43467
   849
\rail@endplus
wenzelm@43467
   850
\rail@end
wenzelm@43535
   851
\rail@begin{2}{}
wenzelm@43467
   852
\rail@term{\hyperlink{method.HOL.size-change}{\mbox{\isa{size{\isaliteral{5F}{\isacharunderscore}}change}}}}[]
wenzelm@43467
   853
\rail@nont{\isa{orders}}[]
wenzelm@43467
   854
\rail@plus
wenzelm@43467
   855
\rail@nextplus{1}
wenzelm@43467
   856
\rail@cnont{\hyperlink{syntax.clasimpmod}{\mbox{\isa{clasimpmod}}}}[]
wenzelm@43467
   857
\rail@endplus
wenzelm@43467
   858
\rail@end
wenzelm@43467
   859
\rail@begin{4}{\isa{orders}}
wenzelm@43467
   860
\rail@plus
wenzelm@43467
   861
\rail@nextplus{1}
wenzelm@43467
   862
\rail@bar
wenzelm@43467
   863
\rail@term{\isa{max}}[]
wenzelm@43467
   864
\rail@nextbar{2}
wenzelm@43467
   865
\rail@term{\isa{min}}[]
wenzelm@43467
   866
\rail@nextbar{3}
wenzelm@43467
   867
\rail@term{\isa{ms}}[]
wenzelm@43467
   868
\rail@endbar
wenzelm@43467
   869
\rail@endplus
wenzelm@43467
   870
\rail@end
wenzelm@43467
   871
\end{railoutput}
wenzelm@43467
   872
wenzelm@26849
   873
wenzelm@28788
   874
  \begin{description}
wenzelm@26849
   875
wenzelm@40685
   876
  \item \hyperlink{method.HOL.pat-completeness}{\mbox{\isa{pat{\isaliteral{5F}{\isacharunderscore}}completeness}}} is a specialized method to
wenzelm@26849
   877
  solve goals regarding the completeness of pattern matching, as
wenzelm@26902
   878
  required by the \hyperlink{command.HOL.function}{\mbox{\isa{\isacommand{function}}}} package (cf.\
wenzelm@26849
   879
  \cite{isabelle-function}).
wenzelm@26849
   880
wenzelm@28788
   881
  \item \hyperlink{method.HOL.relation}{\mbox{\isa{relation}}}~\isa{R} introduces a termination
wenzelm@26849
   882
  proof using the relation \isa{R}.  The resulting proof state will
wenzelm@26849
   883
  contain goals expressing that \isa{R} is wellfounded, and that the
wenzelm@26849
   884
  arguments of recursive calls decrease with respect to \isa{R}.
wenzelm@26849
   885
  Usually, this method is used as the initial proof step of manual
wenzelm@26849
   886
  termination proofs.
wenzelm@26849
   887
wenzelm@40685
   888
  \item \hyperlink{method.HOL.lexicographic-order}{\mbox{\isa{lexicographic{\isaliteral{5F}{\isacharunderscore}}order}}} attempts a fully
wenzelm@26849
   889
  automated termination proof by searching for a lexicographic
wenzelm@26849
   890
  combination of size measures on the arguments of the function. The
wenzelm@26902
   891
  method accepts the same arguments as the \hyperlink{method.auto}{\mbox{\isa{auto}}} method,
wenzelm@26849
   892
  which it uses internally to prove local descents.  The same context
wenzelm@26902
   893
  modifiers as for \hyperlink{method.auto}{\mbox{\isa{auto}}} are accepted, see
wenzelm@26849
   894
  \secref{sec:clasimp}.
wenzelm@26849
   895
wenzelm@26849
   896
  In case of failure, extensive information is printed, which can help
wenzelm@26849
   897
  to analyse the situation (cf.\ \cite{isabelle-function}).
wenzelm@26849
   898
wenzelm@40685
   899
  \item \hyperlink{method.HOL.size-change}{\mbox{\isa{size{\isaliteral{5F}{\isacharunderscore}}change}}} also works on termination goals,
krauss@33858
   900
  using a variation of the size-change principle, together with a
krauss@33858
   901
  graph decomposition technique (see \cite{krauss_phd} for details).
krauss@33858
   902
  Three kinds of orders are used internally: \isa{max}, \isa{min},
krauss@33858
   903
  and \isa{ms} (multiset), which is only available when the theory
krauss@33858
   904
  \isa{Multiset} is loaded. When no order kinds are given, they are
krauss@33858
   905
  tried in order. The search for a termination proof uses SAT solving
krauss@33858
   906
  internally.
krauss@33858
   907
krauss@33858
   908
 For local descent proofs, the same context modifiers as for \hyperlink{method.auto}{\mbox{\isa{auto}}} are accepted, see \secref{sec:clasimp}.
krauss@33858
   909
wenzelm@28788
   910
  \end{description}%
wenzelm@26849
   911
\end{isamarkuptext}%
wenzelm@26849
   912
\isamarkuptrue%
wenzelm@26849
   913
%
krauss@40412
   914
\isamarkupsubsection{Functions with explicit partiality%
krauss@40412
   915
}
krauss@40412
   916
\isamarkuptrue%
krauss@40412
   917
%
krauss@40412
   918
\begin{isamarkuptext}%
krauss@40412
   919
\begin{matharray}{rcl}
wenzelm@40685
   920
    \indexdef{HOL}{command}{partial\_function}\hypertarget{command.HOL.partial-function}{\hyperlink{command.HOL.partial-function}{\mbox{\isa{\isacommand{partial{\isaliteral{5F}{\isacharunderscore}}function}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ local{\isaliteral{5F}{\isacharunderscore}}theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
   921
    \indexdef{HOL}{attribute}{partial\_function\_mono}\hypertarget{attribute.HOL.partial-function-mono}{\hyperlink{attribute.HOL.partial-function-mono}{\mbox{\isa{partial{\isaliteral{5F}{\isacharunderscore}}function{\isaliteral{5F}{\isacharunderscore}}mono}}}} & : & \isa{attribute} \\
krauss@40412
   922
  \end{matharray}
krauss@40412
   923
wenzelm@43467
   924
  \begin{railoutput}
wenzelm@43535
   925
\rail@begin{5}{}
wenzelm@43467
   926
\rail@term{\hyperlink{command.HOL.partial-function}{\mbox{\isa{\isacommand{partial{\isaliteral{5F}{\isacharunderscore}}function}}}}}[]
wenzelm@43467
   927
\rail@bar
wenzelm@43467
   928
\rail@nextbar{1}
wenzelm@43467
   929
\rail@nont{\hyperlink{syntax.target}{\mbox{\isa{target}}}}[]
wenzelm@43467
   930
\rail@endbar
wenzelm@43467
   931
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43488
   932
\rail@nont{\hyperlink{syntax.nameref}{\mbox{\isa{nameref}}}}[]
wenzelm@43467
   933
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
   934
\rail@nont{\hyperlink{syntax.fixes}{\mbox{\isa{fixes}}}}[]
wenzelm@43467
   935
\rail@cr{3}
wenzelm@43467
   936
\rail@term{\isa{\isakeyword{where}}}[]
wenzelm@43467
   937
\rail@bar
wenzelm@43467
   938
\rail@nextbar{4}
wenzelm@43467
   939
\rail@nont{\hyperlink{syntax.thmdecl}{\mbox{\isa{thmdecl}}}}[]
wenzelm@43467
   940
\rail@endbar
wenzelm@43467
   941
\rail@nont{\hyperlink{syntax.prop}{\mbox{\isa{prop}}}}[]
wenzelm@43467
   942
\rail@end
wenzelm@43467
   943
\end{railoutput}
wenzelm@43488
   944
krauss@40412
   945
krauss@40412
   946
  \begin{description}
krauss@40412
   947
wenzelm@43488
   948
  \item \hyperlink{command.HOL.partial-function}{\mbox{\isa{\isacommand{partial{\isaliteral{5F}{\isacharunderscore}}function}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}mode{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequote}}} defines
wenzelm@43488
   949
  recursive functions based on fixpoints in complete partial
wenzelm@43488
   950
  orders. No termination proof is required from the user or
wenzelm@43488
   951
  constructed internally. Instead, the possibility of non-termination
wenzelm@43488
   952
  is modelled explicitly in the result type, which contains an
wenzelm@43488
   953
  explicit bottom element.
krauss@40412
   954
krauss@40412
   955
  Pattern matching and mutual recursion are currently not supported.
krauss@40412
   956
  Thus, the specification consists of a single function described by a
krauss@40412
   957
  single recursive equation.
krauss@40412
   958
krauss@40412
   959
  There are no fixed syntactic restrictions on the body of the
krauss@40412
   960
  function, but the induced functional must be provably monotonic
krauss@40412
   961
  wrt.\ the underlying order.  The monotonicitity proof is performed
krauss@40412
   962
  internally, and the definition is rejected when it fails. The proof
krauss@40412
   963
  can be influenced by declaring hints using the
wenzelm@40685
   964
  \hyperlink{attribute.HOL.partial-function-mono}{\mbox{\isa{partial{\isaliteral{5F}{\isacharunderscore}}function{\isaliteral{5F}{\isacharunderscore}}mono}}} attribute.
krauss@40412
   965
krauss@40412
   966
  The mandatory \isa{mode} argument specifies the mode of operation
krauss@40412
   967
  of the command, which directly corresponds to a complete partial
krauss@40412
   968
  order on the result type. By default, the following modes are
wenzelm@42994
   969
  defined:
krauss@40412
   970
krauss@40412
   971
  \begin{description}
krauss@40412
   972
  \item \isa{option} defines functions that map into the \isa{option} type. Here, the value \isa{None} is used to model a
krauss@40412
   973
  non-terminating computation. Monotonicity requires that if \isa{None} is returned by a recursive call, then the overall result
krauss@40412
   974
  must also be \isa{None}. This is best achieved through the use of
wenzelm@40685
   975
  the monadic operator \isa{{\isaliteral{22}{\isachardoublequote}}Option{\isaliteral{2E}{\isachardot}}bind{\isaliteral{22}{\isachardoublequote}}}.
wenzelm@42994
   976
krauss@40412
   977
  \item \isa{tailrec} defines functions with an arbitrary result
wenzelm@40685
   978
  type and uses the slightly degenerated partial order where \isa{{\isaliteral{22}{\isachardoublequote}}undefined{\isaliteral{22}{\isachardoublequote}}} is the bottom element.  Now, monotonicity requires that
krauss@40412
   979
  if \isa{undefined} is returned by a recursive call, then the
krauss@40412
   980
  overall result must also be \isa{undefined}. In practice, this is
krauss@40412
   981
  only satisfied when each recursive call is a tail call, whose result
krauss@40412
   982
  is directly returned. Thus, this mode of operation allows the
krauss@40412
   983
  definition of arbitrary tail-recursive functions.
krauss@40412
   984
  \end{description}
krauss@40412
   985
krauss@40412
   986
  Experienced users may define new modes by instantiating the locale
wenzelm@40685
   987
  \isa{{\isaliteral{22}{\isachardoublequote}}partial{\isaliteral{5F}{\isacharunderscore}}function{\isaliteral{5F}{\isacharunderscore}}definitions{\isaliteral{22}{\isachardoublequote}}} appropriately.
krauss@40412
   988
wenzelm@40685
   989
  \item \hyperlink{attribute.HOL.partial-function-mono}{\mbox{\isa{partial{\isaliteral{5F}{\isacharunderscore}}function{\isaliteral{5F}{\isacharunderscore}}mono}}} declares rules for
krauss@40412
   990
  use in the internal monononicity proofs of partial function
krauss@40412
   991
  definitions.
krauss@40412
   992
krauss@40412
   993
  \end{description}%
krauss@40412
   994
\end{isamarkuptext}%
krauss@40412
   995
\isamarkuptrue%
krauss@40412
   996
%
wenzelm@26849
   997
\isamarkupsubsection{Old-style recursive function definitions (TFL)%
wenzelm@26849
   998
}
wenzelm@26849
   999
\isamarkuptrue%
wenzelm@26849
  1000
%
wenzelm@26849
  1001
\begin{isamarkuptext}%
wenzelm@40685
  1002
The old TFL commands \hyperlink{command.HOL.recdef}{\mbox{\isa{\isacommand{recdef}}}} and \hyperlink{command.HOL.recdef-tc}{\mbox{\isa{\isacommand{recdef{\isaliteral{5F}{\isacharunderscore}}tc}}}} for defining recursive are mostly obsolete; \hyperlink{command.HOL.function}{\mbox{\isa{\isacommand{function}}}} or \hyperlink{command.HOL.fun}{\mbox{\isa{\isacommand{fun}}}} should be used instead.
wenzelm@26849
  1003
wenzelm@26849
  1004
  \begin{matharray}{rcl}
wenzelm@40685
  1005
    \indexdef{HOL}{command}{recdef}\hypertarget{command.HOL.recdef}{\hyperlink{command.HOL.recdef}{\mbox{\isa{\isacommand{recdef}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1006
    \indexdef{HOL}{command}{recdef\_tc}\hypertarget{command.HOL.recdef-tc}{\hyperlink{command.HOL.recdef-tc}{\mbox{\isa{\isacommand{recdef{\isaliteral{5F}{\isacharunderscore}}tc}}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ proof{\isaliteral{28}{\isacharparenleft}}prove{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@26849
  1007
  \end{matharray}
wenzelm@26849
  1008
wenzelm@43467
  1009
  \begin{railoutput}
wenzelm@43535
  1010
\rail@begin{5}{}
wenzelm@43467
  1011
\rail@term{\hyperlink{command.HOL.recdef}{\mbox{\isa{\isacommand{recdef}}}}}[]
wenzelm@43467
  1012
\rail@bar
wenzelm@43467
  1013
\rail@nextbar{1}
wenzelm@43467
  1014
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
  1015
\rail@term{\isa{\isakeyword{permissive}}}[]
wenzelm@43467
  1016
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
  1017
\rail@endbar
wenzelm@43467
  1018
\rail@cr{3}
wenzelm@43467
  1019
\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
  1020
\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]
wenzelm@43467
  1021
\rail@plus
wenzelm@43467
  1022
\rail@nont{\hyperlink{syntax.prop}{\mbox{\isa{prop}}}}[]
wenzelm@43467
  1023
\rail@nextplus{4}
wenzelm@43467
  1024
\rail@endplus
wenzelm@43467
  1025
\rail@bar
wenzelm@43467
  1026
\rail@nextbar{4}
wenzelm@43467
  1027
\rail@nont{\isa{hints}}[]
wenzelm@43467
  1028
\rail@endbar
wenzelm@43467
  1029
\rail@end
wenzelm@43535
  1030
\rail@begin{2}{}
wenzelm@43467
  1031
\rail@nont{\isa{recdeftc}}[]
wenzelm@43467
  1032
\rail@bar
wenzelm@43467
  1033
\rail@nextbar{1}
wenzelm@43467
  1034
\rail@nont{\hyperlink{syntax.thmdecl}{\mbox{\isa{thmdecl}}}}[]
wenzelm@43467
  1035
\rail@endbar
wenzelm@43467
  1036
\rail@nont{\isa{tc}}[]
wenzelm@43467
  1037
\rail@end
wenzelm@43467
  1038
\rail@begin{2}{\isa{hints}}
wenzelm@43467
  1039
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
  1040
\rail@term{\isa{\isakeyword{hints}}}[]
wenzelm@43467
  1041
\rail@plus
wenzelm@43467
  1042
\rail@nextplus{1}
wenzelm@43467
  1043
\rail@cnont{\isa{recdefmod}}[]
wenzelm@43467
  1044
\rail@endplus
wenzelm@43467
  1045
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
  1046
\rail@end
wenzelm@43467
  1047
\rail@begin{4}{\isa{recdefmod}}
wenzelm@43467
  1048
\rail@bar
wenzelm@43467
  1049
\rail@bar
wenzelm@43467
  1050
\rail@term{\isa{recdef{\isaliteral{5F}{\isacharunderscore}}simp}}[]
wenzelm@43467
  1051
\rail@nextbar{1}
wenzelm@43467
  1052
\rail@term{\isa{recdef{\isaliteral{5F}{\isacharunderscore}}cong}}[]
wenzelm@43467
  1053
\rail@nextbar{2}
wenzelm@43467
  1054
\rail@term{\isa{recdef{\isaliteral{5F}{\isacharunderscore}}wf}}[]
wenzelm@43467
  1055
\rail@endbar
wenzelm@43467
  1056
\rail@bar
wenzelm@43467
  1057
\rail@nextbar{1}
wenzelm@43467
  1058
\rail@term{\isa{add}}[]
wenzelm@43467
  1059
\rail@nextbar{2}
wenzelm@43467
  1060
\rail@term{\isa{del}}[]
wenzelm@43467
  1061
\rail@endbar
wenzelm@43467
  1062
\rail@term{\isa{{\isaliteral{3A}{\isacharcolon}}}}[]
wenzelm@43467
  1063
\rail@nont{\hyperlink{syntax.thmrefs}{\mbox{\isa{thmrefs}}}}[]
wenzelm@43467
  1064
\rail@nextbar{3}
wenzelm@43467
  1065
\rail@nont{\hyperlink{syntax.clasimpmod}{\mbox{\isa{clasimpmod}}}}[]
wenzelm@43467
  1066
\rail@endbar
wenzelm@43467
  1067
\rail@end
wenzelm@43467
  1068
\rail@begin{2}{\isa{tc}}
wenzelm@43467
  1069
\rail@nont{\hyperlink{syntax.nameref}{\mbox{\isa{nameref}}}}[]
wenzelm@43467
  1070
\rail@bar
wenzelm@43467
  1071
\rail@nextbar{1}
wenzelm@43467
  1072
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
  1073
\rail@nont{\hyperlink{syntax.nat}{\mbox{\isa{nat}}}}[]
wenzelm@43467
  1074
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
  1075
\rail@endbar
wenzelm@43467
  1076
\rail@end
wenzelm@43467
  1077
\end{railoutput}
wenzelm@43467
  1078
wenzelm@26849
  1079
wenzelm@28788
  1080
  \begin{description}
wenzelm@42994
  1081
wenzelm@28788
  1082
  \item \hyperlink{command.HOL.recdef}{\mbox{\isa{\isacommand{recdef}}}} defines general well-founded
wenzelm@26849
  1083
  recursive functions (using the TFL package), see also
wenzelm@40685
  1084
  \cite{isabelle-HOL}.  The ``\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}permissive{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequote}}}'' option tells
wenzelm@26849
  1085
  TFL to recover from failed proof attempts, returning unfinished
wenzelm@40685
  1086
  results.  The \isa{recdef{\isaliteral{5F}{\isacharunderscore}}simp}, \isa{recdef{\isaliteral{5F}{\isacharunderscore}}cong}, and \isa{recdef{\isaliteral{5F}{\isacharunderscore}}wf} hints refer to auxiliary rules to be used in the internal
wenzelm@26902
  1087
  automated proof process of TFL.  Additional \hyperlink{syntax.clasimpmod}{\mbox{\isa{clasimpmod}}}
wenzelm@26849
  1088
  declarations (cf.\ \secref{sec:clasimp}) may be given to tune the
wenzelm@26849
  1089
  context of the Simplifier (cf.\ \secref{sec:simplifier}) and
wenzelm@26849
  1090
  Classical reasoner (cf.\ \secref{sec:classical}).
wenzelm@42994
  1091
wenzelm@40685
  1092
  \item \hyperlink{command.HOL.recdef-tc}{\mbox{\isa{\isacommand{recdef{\isaliteral{5F}{\isacharunderscore}}tc}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}c\ {\isaliteral{28}{\isacharparenleft}}i{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequote}}} recommences the
wenzelm@26849
  1093
  proof for leftover termination condition number \isa{i} (default
wenzelm@26902
  1094
  1) as generated by a \hyperlink{command.HOL.recdef}{\mbox{\isa{\isacommand{recdef}}}} definition of
wenzelm@26849
  1095
  constant \isa{c}.
wenzelm@42994
  1096
wenzelm@26902
  1097
  Note that in most cases, \hyperlink{command.HOL.recdef}{\mbox{\isa{\isacommand{recdef}}}} is able to finish
wenzelm@26849
  1098
  its internal proofs without manual intervention.
wenzelm@26849
  1099
wenzelm@28788
  1100
  \end{description}
wenzelm@26849
  1101
wenzelm@26902
  1102
  \medskip Hints for \hyperlink{command.HOL.recdef}{\mbox{\isa{\isacommand{recdef}}}} may be also declared
wenzelm@26849
  1103
  globally, using the following attributes.
wenzelm@26849
  1104
wenzelm@26849
  1105
  \begin{matharray}{rcl}
wenzelm@40685
  1106
    \indexdef{HOL}{attribute}{recdef\_simp}\hypertarget{attribute.HOL.recdef-simp}{\hyperlink{attribute.HOL.recdef-simp}{\mbox{\isa{recdef{\isaliteral{5F}{\isacharunderscore}}simp}}}} & : & \isa{attribute} \\
wenzelm@40685
  1107
    \indexdef{HOL}{attribute}{recdef\_cong}\hypertarget{attribute.HOL.recdef-cong}{\hyperlink{attribute.HOL.recdef-cong}{\mbox{\isa{recdef{\isaliteral{5F}{\isacharunderscore}}cong}}}} & : & \isa{attribute} \\
wenzelm@40685
  1108
    \indexdef{HOL}{attribute}{recdef\_wf}\hypertarget{attribute.HOL.recdef-wf}{\hyperlink{attribute.HOL.recdef-wf}{\mbox{\isa{recdef{\isaliteral{5F}{\isacharunderscore}}wf}}}} & : & \isa{attribute} \\
wenzelm@26849
  1109
  \end{matharray}
wenzelm@26849
  1110
wenzelm@43467
  1111
  \begin{railoutput}
wenzelm@43535
  1112
\rail@begin{3}{}
wenzelm@43467
  1113
\rail@bar
wenzelm@43467
  1114
\rail@term{\hyperlink{attribute.HOL.recdef-simp}{\mbox{\isa{recdef{\isaliteral{5F}{\isacharunderscore}}simp}}}}[]
wenzelm@43467
  1115
\rail@nextbar{1}
wenzelm@43467
  1116
\rail@term{\hyperlink{attribute.HOL.recdef-cong}{\mbox{\isa{recdef{\isaliteral{5F}{\isacharunderscore}}cong}}}}[]
wenzelm@43467
  1117
\rail@nextbar{2}
wenzelm@43467
  1118
\rail@term{\hyperlink{attribute.HOL.recdef-wf}{\mbox{\isa{recdef{\isaliteral{5F}{\isacharunderscore}}wf}}}}[]
wenzelm@43467
  1119
\rail@endbar
wenzelm@43467
  1120
\rail@bar
wenzelm@43467
  1121
\rail@nextbar{1}
wenzelm@43467
  1122
\rail@term{\isa{add}}[]
wenzelm@43467
  1123
\rail@nextbar{2}
wenzelm@43467
  1124
\rail@term{\isa{del}}[]
wenzelm@43467
  1125
\rail@endbar
wenzelm@43467
  1126
\rail@end
wenzelm@43467
  1127
\end{railoutput}%
wenzelm@26849
  1128
\end{isamarkuptext}%
wenzelm@26849
  1129
\isamarkuptrue%
wenzelm@26849
  1130
%
wenzelm@26849
  1131
\isamarkupsection{Inductive and coinductive definitions \label{sec:hol-inductive}%
wenzelm@26849
  1132
}
wenzelm@26849
  1133
\isamarkuptrue%
wenzelm@26849
  1134
%
wenzelm@26849
  1135
\begin{isamarkuptext}%
wenzelm@26849
  1136
An \textbf{inductive definition} specifies the least predicate (or
wenzelm@26849
  1137
  set) \isa{R} closed under given rules: applying a rule to elements
wenzelm@26849
  1138
  of \isa{R} yields a result within \isa{R}.  For example, a
wenzelm@26849
  1139
  structural operational semantics is an inductive definition of an
wenzelm@26849
  1140
  evaluation relation.
wenzelm@26849
  1141
wenzelm@26849
  1142
  Dually, a \textbf{coinductive definition} specifies the greatest
wenzelm@26849
  1143
  predicate~/ set \isa{R} that is consistent with given rules: every
wenzelm@26849
  1144
  element of \isa{R} can be seen as arising by applying a rule to
wenzelm@26849
  1145
  elements of \isa{R}.  An important example is using bisimulation
wenzelm@26849
  1146
  relations to formalise equivalence of processes and infinite data
wenzelm@26849
  1147
  structures.
wenzelm@26849
  1148
wenzelm@26849
  1149
  \medskip The HOL package is related to the ZF one, which is
wenzelm@26849
  1150
  described in a separate paper,\footnote{It appeared in CADE
wenzelm@26849
  1151
  \cite{paulson-CADE}; a longer version is distributed with Isabelle.}
wenzelm@26849
  1152
  which you should refer to in case of difficulties.  The package is
wenzelm@26849
  1153
  simpler than that of ZF thanks to implicit type-checking in HOL.
wenzelm@26849
  1154
  The types of the (co)inductive predicates (or sets) determine the
wenzelm@26849
  1155
  domain of the fixedpoint definition, and the package does not have
wenzelm@26849
  1156
  to use inference rules for type-checking.
wenzelm@26849
  1157
wenzelm@26849
  1158
  \begin{matharray}{rcl}
wenzelm@40685
  1159
    \indexdef{HOL}{command}{inductive}\hypertarget{command.HOL.inductive}{\hyperlink{command.HOL.inductive}{\mbox{\isa{\isacommand{inductive}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ local{\isaliteral{5F}{\isacharunderscore}}theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1160
    \indexdef{HOL}{command}{inductive\_set}\hypertarget{command.HOL.inductive-set}{\hyperlink{command.HOL.inductive-set}{\mbox{\isa{\isacommand{inductive{\isaliteral{5F}{\isacharunderscore}}set}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ local{\isaliteral{5F}{\isacharunderscore}}theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1161
    \indexdef{HOL}{command}{coinductive}\hypertarget{command.HOL.coinductive}{\hyperlink{command.HOL.coinductive}{\mbox{\isa{\isacommand{coinductive}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ local{\isaliteral{5F}{\isacharunderscore}}theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1162
    \indexdef{HOL}{command}{coinductive\_set}\hypertarget{command.HOL.coinductive-set}{\hyperlink{command.HOL.coinductive-set}{\mbox{\isa{\isacommand{coinductive{\isaliteral{5F}{\isacharunderscore}}set}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ local{\isaliteral{5F}{\isacharunderscore}}theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@28788
  1163
    \indexdef{HOL}{attribute}{mono}\hypertarget{attribute.HOL.mono}{\hyperlink{attribute.HOL.mono}{\mbox{\isa{mono}}}} & : & \isa{attribute} \\
wenzelm@26849
  1164
  \end{matharray}
wenzelm@26849
  1165
wenzelm@43467
  1166
  \begin{railoutput}
wenzelm@43535
  1167
\rail@begin{7}{}
wenzelm@43467
  1168
\rail@bar
wenzelm@43467
  1169
\rail@term{\hyperlink{command.HOL.inductive}{\mbox{\isa{\isacommand{inductive}}}}}[]
wenzelm@43467
  1170
\rail@nextbar{1}
wenzelm@43467
  1171
\rail@term{\hyperlink{command.HOL.inductive-set}{\mbox{\isa{\isacommand{inductive{\isaliteral{5F}{\isacharunderscore}}set}}}}}[]
wenzelm@43467
  1172
\rail@nextbar{2}
wenzelm@43467
  1173
\rail@term{\hyperlink{command.HOL.coinductive}{\mbox{\isa{\isacommand{coinductive}}}}}[]
wenzelm@43467
  1174
\rail@nextbar{3}
wenzelm@43467
  1175
\rail@term{\hyperlink{command.HOL.coinductive-set}{\mbox{\isa{\isacommand{coinductive{\isaliteral{5F}{\isacharunderscore}}set}}}}}[]
wenzelm@43467
  1176
\rail@endbar
wenzelm@43467
  1177
\rail@bar
wenzelm@43467
  1178
\rail@nextbar{1}
wenzelm@43467
  1179
\rail@nont{\hyperlink{syntax.target}{\mbox{\isa{target}}}}[]
wenzelm@43467
  1180
\rail@endbar
wenzelm@43467
  1181
\rail@nont{\hyperlink{syntax.fixes}{\mbox{\isa{fixes}}}}[]
wenzelm@43467
  1182
\rail@bar
wenzelm@43467
  1183
\rail@nextbar{1}
wenzelm@43467
  1184
\rail@term{\isa{\isakeyword{for}}}[]
wenzelm@43467
  1185
\rail@nont{\hyperlink{syntax.fixes}{\mbox{\isa{fixes}}}}[]
wenzelm@43467
  1186
\rail@endbar
wenzelm@43467
  1187
\rail@cr{5}
wenzelm@43467
  1188
\rail@bar
wenzelm@43467
  1189
\rail@nextbar{6}
wenzelm@43467
  1190
\rail@term{\isa{\isakeyword{where}}}[]
wenzelm@43467
  1191
\rail@nont{\isa{clauses}}[]
wenzelm@43467
  1192
\rail@endbar
wenzelm@43467
  1193
\rail@bar
wenzelm@43467
  1194
\rail@nextbar{6}
wenzelm@43467
  1195
\rail@term{\isa{\isakeyword{monos}}}[]
wenzelm@43467
  1196
\rail@nont{\hyperlink{syntax.thmrefs}{\mbox{\isa{thmrefs}}}}[]
wenzelm@43467
  1197
\rail@endbar
wenzelm@43467
  1198
\rail@end
wenzelm@43467
  1199
\rail@begin{3}{\isa{clauses}}
wenzelm@43467
  1200
\rail@plus
wenzelm@43467
  1201
\rail@bar
wenzelm@43467
  1202
\rail@nextbar{1}
wenzelm@43467
  1203
\rail@nont{\hyperlink{syntax.thmdecl}{\mbox{\isa{thmdecl}}}}[]
wenzelm@43467
  1204
\rail@endbar
wenzelm@43467
  1205
\rail@nont{\hyperlink{syntax.prop}{\mbox{\isa{prop}}}}[]
wenzelm@43467
  1206
\rail@nextplus{2}
wenzelm@43467
  1207
\rail@cterm{\isa{{\isaliteral{7C}{\isacharbar}}}}[]
wenzelm@43467
  1208
\rail@endplus
wenzelm@43467
  1209
\rail@end
wenzelm@43535
  1210
\rail@begin{3}{}
wenzelm@43467
  1211
\rail@term{\hyperlink{attribute.HOL.mono}{\mbox{\isa{mono}}}}[]
wenzelm@43467
  1212
\rail@bar
wenzelm@43467
  1213
\rail@nextbar{1}
wenzelm@43467
  1214
\rail@term{\isa{add}}[]
wenzelm@43467
  1215
\rail@nextbar{2}
wenzelm@43467
  1216
\rail@term{\isa{del}}[]
wenzelm@43467
  1217
\rail@endbar
wenzelm@43467
  1218
\rail@end
wenzelm@43467
  1219
\end{railoutput}
wenzelm@43467
  1220
wenzelm@26849
  1221
wenzelm@28788
  1222
  \begin{description}
wenzelm@26849
  1223
wenzelm@28788
  1224
  \item \hyperlink{command.HOL.inductive}{\mbox{\isa{\isacommand{inductive}}}} and \hyperlink{command.HOL.coinductive}{\mbox{\isa{\isacommand{coinductive}}}} define (co)inductive predicates from the
wenzelm@26902
  1225
  introduction rules given in the \hyperlink{keyword.where}{\mbox{\isa{\isakeyword{where}}}} part.  The
wenzelm@26902
  1226
  optional \hyperlink{keyword.for}{\mbox{\isa{\isakeyword{for}}}} part contains a list of parameters of the
wenzelm@26849
  1227
  (co)inductive predicates that remain fixed throughout the
wenzelm@26902
  1228
  definition.  The optional \hyperlink{keyword.monos}{\mbox{\isa{\isakeyword{monos}}}} section contains
wenzelm@26849
  1229
  \emph{monotonicity theorems}, which are required for each operator
wenzelm@26849
  1230
  applied to a recursive set in the introduction rules.  There
wenzelm@40685
  1231
  \emph{must} be a theorem of the form \isa{{\isaliteral{22}{\isachardoublequote}}A\ {\isaliteral{5C3C6C653E}{\isasymle}}\ B\ {\isaliteral{5C3C4C6F6E6772696768746172726F773E}{\isasymLongrightarrow}}\ M\ A\ {\isaliteral{5C3C6C653E}{\isasymle}}\ M\ B{\isaliteral{22}{\isachardoublequote}}},
wenzelm@40685
  1232
  for each premise \isa{{\isaliteral{22}{\isachardoublequote}}M\ R\isaliteral{5C3C5E7375623E}{}\isactrlsub i\ t{\isaliteral{22}{\isachardoublequote}}} in an introduction rule!
wenzelm@26849
  1233
wenzelm@40685
  1234
  \item \hyperlink{command.HOL.inductive-set}{\mbox{\isa{\isacommand{inductive{\isaliteral{5F}{\isacharunderscore}}set}}}} and \hyperlink{command.HOL.coinductive-set}{\mbox{\isa{\isacommand{coinductive{\isaliteral{5F}{\isacharunderscore}}set}}}} are wrappers for to the previous commands,
wenzelm@26849
  1235
  allowing the definition of (co)inductive sets.
wenzelm@26849
  1236
wenzelm@28788
  1237
  \item \hyperlink{attribute.HOL.mono}{\mbox{\isa{mono}}} declares monotonicity rules.  These
wenzelm@26902
  1238
  rule are involved in the automated monotonicity proof of \hyperlink{command.HOL.inductive}{\mbox{\isa{\isacommand{inductive}}}}.
wenzelm@26849
  1239
wenzelm@28788
  1240
  \end{description}%
wenzelm@26849
  1241
\end{isamarkuptext}%
wenzelm@26849
  1242
\isamarkuptrue%
wenzelm@26849
  1243
%
wenzelm@26849
  1244
\isamarkupsubsection{Derived rules%
wenzelm@26849
  1245
}
wenzelm@26849
  1246
\isamarkuptrue%
wenzelm@26849
  1247
%
wenzelm@26849
  1248
\begin{isamarkuptext}%
wenzelm@26849
  1249
Each (co)inductive definition \isa{R} adds definitions to the
wenzelm@26849
  1250
  theory and also proves some theorems:
wenzelm@26849
  1251
wenzelm@26849
  1252
  \begin{description}
wenzelm@26849
  1253
wenzelm@40685
  1254
  \item \isa{R{\isaliteral{2E}{\isachardot}}intros} is the list of introduction rules as proven
wenzelm@26849
  1255
  theorems, for the recursive predicates (or sets).  The rules are
wenzelm@26849
  1256
  also available individually, using the names given them in the
wenzelm@26849
  1257
  theory file;
wenzelm@26849
  1258
wenzelm@40685
  1259
  \item \isa{R{\isaliteral{2E}{\isachardot}}cases} is the case analysis (or elimination) rule;
wenzelm@26849
  1260
wenzelm@40685
  1261
  \item \isa{R{\isaliteral{2E}{\isachardot}}induct} or \isa{R{\isaliteral{2E}{\isachardot}}coinduct} is the (co)induction
wenzelm@26849
  1262
  rule.
wenzelm@26849
  1263
wenzelm@26849
  1264
  \end{description}
wenzelm@26849
  1265
wenzelm@40685
  1266
  When several predicates \isa{{\isaliteral{22}{\isachardoublequote}}R\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ R\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{22}{\isachardoublequote}}} are
wenzelm@26849
  1267
  defined simultaneously, the list of introduction rules is called
wenzelm@40685
  1268
  \isa{{\isaliteral{22}{\isachardoublequote}}R\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{5F}{\isacharunderscore}}{\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{5F}{\isacharunderscore}}R\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{2E}{\isachardot}}intros{\isaliteral{22}{\isachardoublequote}}}, the case analysis rules are
wenzelm@40685
  1269
  called \isa{{\isaliteral{22}{\isachardoublequote}}R\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2E}{\isachardot}}cases{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ R\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{2E}{\isachardot}}cases{\isaliteral{22}{\isachardoublequote}}}, and the list
wenzelm@40685
  1270
  of mutual induction rules is called \isa{{\isaliteral{22}{\isachardoublequote}}R\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{5F}{\isacharunderscore}}{\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{5F}{\isacharunderscore}}R\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{2E}{\isachardot}}inducts{\isaliteral{22}{\isachardoublequote}}}.%
wenzelm@26849
  1271
\end{isamarkuptext}%
wenzelm@26849
  1272
\isamarkuptrue%
wenzelm@26849
  1273
%
wenzelm@26849
  1274
\isamarkupsubsection{Monotonicity theorems%
wenzelm@26849
  1275
}
wenzelm@26849
  1276
\isamarkuptrue%
wenzelm@26849
  1277
%
wenzelm@26849
  1278
\begin{isamarkuptext}%
wenzelm@26849
  1279
Each theory contains a default set of theorems that are used in
wenzelm@26849
  1280
  monotonicity proofs.  New rules can be added to this set via the
wenzelm@26902
  1281
  \hyperlink{attribute.HOL.mono}{\mbox{\isa{mono}}} attribute.  The HOL theory \isa{Inductive}
wenzelm@26849
  1282
  shows how this is done.  In general, the following monotonicity
wenzelm@26849
  1283
  theorems may be added:
wenzelm@26849
  1284
wenzelm@26849
  1285
  \begin{itemize}
wenzelm@26849
  1286
wenzelm@40685
  1287
  \item Theorems of the form \isa{{\isaliteral{22}{\isachardoublequote}}A\ {\isaliteral{5C3C6C653E}{\isasymle}}\ B\ {\isaliteral{5C3C4C6F6E6772696768746172726F773E}{\isasymLongrightarrow}}\ M\ A\ {\isaliteral{5C3C6C653E}{\isasymle}}\ M\ B{\isaliteral{22}{\isachardoublequote}}}, for proving
wenzelm@26849
  1288
  monotonicity of inductive definitions whose introduction rules have
wenzelm@40685
  1289
  premises involving terms such as \isa{{\isaliteral{22}{\isachardoublequote}}M\ R\isaliteral{5C3C5E7375623E}{}\isactrlsub i\ t{\isaliteral{22}{\isachardoublequote}}}.
wenzelm@26849
  1290
wenzelm@26849
  1291
  \item Monotonicity theorems for logical operators, which are of the
wenzelm@40685
  1292
  general form \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}{\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{5C3C6C6F6E6772696768746172726F773E}{\isasymlongrightarrow}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{5C3C4C6F6E6772696768746172726F773E}{\isasymLongrightarrow}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{28}{\isacharparenleft}}{\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{5C3C6C6F6E6772696768746172726F773E}{\isasymlongrightarrow}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{5C3C4C6F6E6772696768746172726F773E}{\isasymLongrightarrow}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ {\isaliteral{5C3C6C6F6E6772696768746172726F773E}{\isasymlongrightarrow}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{22}{\isachardoublequote}}}.  For example, in
wenzelm@40685
  1293
  the case of the operator \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6F723E}{\isasymor}}{\isaliteral{22}{\isachardoublequote}}}, the corresponding theorem is
wenzelm@26849
  1294
  \[
wenzelm@40685
  1295
  \infer{\isa{{\isaliteral{22}{\isachardoublequote}}P\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C6F723E}{\isasymor}}\ P\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{2}}\ {\isaliteral{5C3C6C6F6E6772696768746172726F773E}{\isasymlongrightarrow}}\ Q\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C6F723E}{\isasymor}}\ Q\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{2}}{\isaliteral{22}{\isachardoublequote}}}}{\isa{{\isaliteral{22}{\isachardoublequote}}P\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C6C6F6E6772696768746172726F773E}{\isasymlongrightarrow}}\ Q\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{22}{\isachardoublequote}}} & \isa{{\isaliteral{22}{\isachardoublequote}}P\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{2}}\ {\isaliteral{5C3C6C6F6E6772696768746172726F773E}{\isasymlongrightarrow}}\ Q\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{2}}{\isaliteral{22}{\isachardoublequote}}}}
wenzelm@26849
  1296
  \]
wenzelm@26849
  1297
wenzelm@26849
  1298
  \item De Morgan style equations for reasoning about the ``polarity''
wenzelm@26849
  1299
  of expressions, e.g.
wenzelm@26849
  1300
  \[
wenzelm@40685
  1301
  \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6E6F743E}{\isasymnot}}\ {\isaliteral{5C3C6E6F743E}{\isasymnot}}\ P\ {\isaliteral{5C3C6C6F6E676C65667472696768746172726F773E}{\isasymlongleftrightarrow}}\ P{\isaliteral{22}{\isachardoublequote}}} \qquad\qquad
wenzelm@40685
  1302
  \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6E6F743E}{\isasymnot}}\ {\isaliteral{28}{\isacharparenleft}}P\ {\isaliteral{5C3C616E643E}{\isasymand}}\ Q{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{5C3C6C6F6E676C65667472696768746172726F773E}{\isasymlongleftrightarrow}}\ {\isaliteral{5C3C6E6F743E}{\isasymnot}}\ P\ {\isaliteral{5C3C6F723E}{\isasymor}}\ {\isaliteral{5C3C6E6F743E}{\isasymnot}}\ Q{\isaliteral{22}{\isachardoublequote}}}
wenzelm@26849
  1303
  \]
wenzelm@26849
  1304
wenzelm@26849
  1305
  \item Equations for reducing complex operators to more primitive
wenzelm@26849
  1306
  ones whose monotonicity can easily be proved, e.g.
wenzelm@26849
  1307
  \[
wenzelm@40685
  1308
  \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}P\ {\isaliteral{5C3C6C6F6E6772696768746172726F773E}{\isasymlongrightarrow}}\ Q{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{5C3C6C6F6E676C65667472696768746172726F773E}{\isasymlongleftrightarrow}}\ {\isaliteral{5C3C6E6F743E}{\isasymnot}}\ P\ {\isaliteral{5C3C6F723E}{\isasymor}}\ Q{\isaliteral{22}{\isachardoublequote}}} \qquad\qquad
wenzelm@40685
  1309
  \isa{{\isaliteral{22}{\isachardoublequote}}Ball\ A\ P\ {\isaliteral{5C3C65717569763E}{\isasymequiv}}\ {\isaliteral{5C3C666F72616C6C3E}{\isasymforall}}x{\isaliteral{2E}{\isachardot}}\ x\ {\isaliteral{5C3C696E3E}{\isasymin}}\ A\ {\isaliteral{5C3C6C6F6E6772696768746172726F773E}{\isasymlongrightarrow}}\ P\ x{\isaliteral{22}{\isachardoublequote}}}
wenzelm@26849
  1310
  \]
wenzelm@26849
  1311
wenzelm@26849
  1312
  \end{itemize}
wenzelm@26849
  1313
wenzelm@26849
  1314
  %FIXME: Example of an inductive definition%
wenzelm@26849
  1315
\end{isamarkuptext}%
wenzelm@26849
  1316
\isamarkuptrue%
wenzelm@26849
  1317
%
wenzelm@26849
  1318
\isamarkupsection{Arithmetic proof support%
wenzelm@26849
  1319
}
wenzelm@26849
  1320
\isamarkuptrue%
wenzelm@26849
  1321
%
wenzelm@26849
  1322
\begin{isamarkuptext}%
wenzelm@26849
  1323
\begin{matharray}{rcl}
wenzelm@28788
  1324
    \indexdef{HOL}{method}{arith}\hypertarget{method.HOL.arith}{\hyperlink{method.HOL.arith}{\mbox{\isa{arith}}}} & : & \isa{method} \\
nipkow@30863
  1325
    \indexdef{HOL}{attribute}{arith}\hypertarget{attribute.HOL.arith}{\hyperlink{attribute.HOL.arith}{\mbox{\isa{arith}}}} & : & \isa{attribute} \\
wenzelm@40685
  1326
    \indexdef{HOL}{attribute}{arith\_split}\hypertarget{attribute.HOL.arith-split}{\hyperlink{attribute.HOL.arith-split}{\mbox{\isa{arith{\isaliteral{5F}{\isacharunderscore}}split}}}} & : & \isa{attribute} \\
wenzelm@26849
  1327
  \end{matharray}
wenzelm@26849
  1328
wenzelm@26902
  1329
  The \hyperlink{method.HOL.arith}{\mbox{\isa{arith}}} method decides linear arithmetic problems
wenzelm@26849
  1330
  (on types \isa{nat}, \isa{int}, \isa{real}).  Any current
wenzelm@26849
  1331
  facts are inserted into the goal before running the procedure.
wenzelm@26849
  1332
nipkow@30863
  1333
  The \hyperlink{attribute.HOL.arith}{\mbox{\isa{arith}}} attribute declares facts that are
nipkow@30863
  1334
  always supplied to the arithmetic provers implicitly.
nipkow@30863
  1335
wenzelm@40685
  1336
  The \hyperlink{attribute.HOL.arith-split}{\mbox{\isa{arith{\isaliteral{5F}{\isacharunderscore}}split}}} attribute declares case split
wenzelm@30865
  1337
  rules to be expanded before \hyperlink{method.HOL.arith}{\mbox{\isa{arith}}} is invoked.
wenzelm@26849
  1338
nipkow@30863
  1339
  Note that a simpler (but faster) arithmetic prover is
nipkow@30863
  1340
  already invoked by the Simplifier.%
wenzelm@26849
  1341
\end{isamarkuptext}%
wenzelm@26849
  1342
\isamarkuptrue%
wenzelm@26849
  1343
%
wenzelm@30172
  1344
\isamarkupsection{Intuitionistic proof search%
wenzelm@30172
  1345
}
wenzelm@30172
  1346
\isamarkuptrue%
wenzelm@30172
  1347
%
wenzelm@30172
  1348
\begin{isamarkuptext}%
wenzelm@30172
  1349
\begin{matharray}{rcl}
wenzelm@30172
  1350
    \indexdef{HOL}{method}{iprover}\hypertarget{method.HOL.iprover}{\hyperlink{method.HOL.iprover}{\mbox{\isa{iprover}}}} & : & \isa{method} \\
wenzelm@30172
  1351
  \end{matharray}
wenzelm@30172
  1352
wenzelm@43467
  1353
  \begin{railoutput}
wenzelm@43535
  1354
\rail@begin{2}{}
wenzelm@43467
  1355
\rail@term{\hyperlink{method.HOL.iprover}{\mbox{\isa{iprover}}}}[]
wenzelm@43467
  1356
\rail@plus
wenzelm@43467
  1357
\rail@nextplus{1}
wenzelm@43467
  1358
\rail@cnont{\hyperlink{syntax.rulemod}{\mbox{\isa{rulemod}}}}[]
wenzelm@43467
  1359
\rail@endplus
wenzelm@43467
  1360
\rail@end
wenzelm@43467
  1361
\end{railoutput}
wenzelm@43467
  1362
wenzelm@30172
  1363
wenzelm@30172
  1364
  The \hyperlink{method.HOL.iprover}{\mbox{\isa{iprover}}} method performs intuitionistic proof
wenzelm@30172
  1365
  search, depending on specifically declared rules from the context,
wenzelm@30172
  1366
  or given as explicit arguments.  Chained facts are inserted into the
wenzelm@35613
  1367
  goal before commencing proof search.
wenzelm@35613
  1368
wenzelm@30172
  1369
  Rules need to be classified as \hyperlink{attribute.Pure.intro}{\mbox{\isa{intro}}},
wenzelm@30172
  1370
  \hyperlink{attribute.Pure.elim}{\mbox{\isa{elim}}}, or \hyperlink{attribute.Pure.dest}{\mbox{\isa{dest}}}; here the
wenzelm@40685
  1371
  ``\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{21}{\isacharbang}}{\isaliteral{22}{\isachardoublequote}}}'' indicator refers to ``safe'' rules, which may be
wenzelm@30172
  1372
  applied aggressively (without considering back-tracking later).
wenzelm@40685
  1373
  Rules declared with ``\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3F}{\isacharquery}}{\isaliteral{22}{\isachardoublequote}}}'' are ignored in proof search (the
wenzelm@43497
  1374
  single-step \hyperlink{method.Pure.rule}{\mbox{\isa{rule}}} method still observes these).  An
wenzelm@30172
  1375
  explicit weight annotation may be given as well; otherwise the
wenzelm@30172
  1376
  number of rule premises will be taken into account here.%
wenzelm@30172
  1377
\end{isamarkuptext}%
wenzelm@30172
  1378
\isamarkuptrue%
wenzelm@30172
  1379
%
wenzelm@30172
  1380
\isamarkupsection{Coherent Logic%
wenzelm@30172
  1381
}
wenzelm@30172
  1382
\isamarkuptrue%
wenzelm@30172
  1383
%
wenzelm@30172
  1384
\begin{isamarkuptext}%
wenzelm@30172
  1385
\begin{matharray}{rcl}
wenzelm@30172
  1386
    \indexdef{HOL}{method}{coherent}\hypertarget{method.HOL.coherent}{\hyperlink{method.HOL.coherent}{\mbox{\isa{coherent}}}} & : & \isa{method} \\
wenzelm@30172
  1387
  \end{matharray}
wenzelm@30172
  1388
wenzelm@43467
  1389
  \begin{railoutput}
wenzelm@43535
  1390
\rail@begin{2}{}
wenzelm@43467
  1391
\rail@term{\hyperlink{method.HOL.coherent}{\mbox{\isa{coherent}}}}[]
wenzelm@43467
  1392
\rail@bar
wenzelm@43467
  1393
\rail@nextbar{1}
wenzelm@43467
  1394
\rail@nont{\hyperlink{syntax.thmrefs}{\mbox{\isa{thmrefs}}}}[]
wenzelm@43467
  1395
\rail@endbar
wenzelm@43467
  1396
\rail@end
wenzelm@43467
  1397
\end{railoutput}
wenzelm@43467
  1398
wenzelm@30172
  1399
wenzelm@30172
  1400
  The \hyperlink{method.HOL.coherent}{\mbox{\isa{coherent}}} method solves problems of
wenzelm@30172
  1401
  \emph{Coherent Logic} \cite{Bezem-Coquand:2005}, which covers
wenzelm@30172
  1402
  applications in confluence theory, lattice theory and projective
wenzelm@41052
  1403
  geometry.  See \verb|~~/src/HOL/ex/Coherent.thy| for some
wenzelm@30172
  1404
  examples.%
wenzelm@30172
  1405
\end{isamarkuptext}%
wenzelm@30172
  1406
\isamarkuptrue%
wenzelm@30172
  1407
%
blanchet@43082
  1408
\isamarkupsection{Proving propositions%
blanchet@43082
  1409
}
blanchet@43082
  1410
\isamarkuptrue%
blanchet@43082
  1411
%
blanchet@43082
  1412
\begin{isamarkuptext}%
blanchet@43082
  1413
In addition to the standard proof methods, a number of diagnosis
blanchet@43082
  1414
  tools search for proofs and provide an Isar proof snippet on success.
blanchet@43082
  1415
  These tools are available via the following commands.
blanchet@43082
  1416
blanchet@43082
  1417
  \begin{matharray}{rcl}
blanchet@43082
  1418
    \indexdef{HOL}{command}{solve\_direct}\hypertarget{command.HOL.solve-direct}{\hyperlink{command.HOL.solve-direct}{\mbox{\isa{\isacommand{solve{\isaliteral{5F}{\isacharunderscore}}direct}}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}proof\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}{\isaliteral{22}{\isachardoublequote}}} \\
blanchet@43082
  1419
    \indexdef{HOL}{command}{try}\hypertarget{command.HOL.try}{\hyperlink{command.HOL.try}{\mbox{\isa{\isacommand{try}}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}proof\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}{\isaliteral{22}{\isachardoublequote}}} \\
blanchet@43082
  1420
    \indexdef{HOL}{command}{sledgehammer}\hypertarget{command.HOL.sledgehammer}{\hyperlink{command.HOL.sledgehammer}{\mbox{\isa{\isacommand{sledgehammer}}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}proof\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}{\isaliteral{22}{\isachardoublequote}}} \\
blanchet@43082
  1421
    \indexdef{HOL}{command}{sledgehammer\_params}\hypertarget{command.HOL.sledgehammer-params}{\hyperlink{command.HOL.sledgehammer-params}{\mbox{\isa{\isacommand{sledgehammer{\isaliteral{5F}{\isacharunderscore}}params}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}}
blanchet@43082
  1422
  \end{matharray}
blanchet@43082
  1423
wenzelm@43467
  1424
  \begin{railoutput}
wenzelm@43535
  1425
\rail@begin{6}{}
wenzelm@43467
  1426
\rail@term{\hyperlink{command.HOL.try}{\mbox{\isa{\isacommand{try}}}}}[]
wenzelm@43467
  1427
\rail@bar
wenzelm@43467
  1428
\rail@nextbar{1}
wenzelm@43467
  1429
\rail@plus
wenzelm@43467
  1430
\rail@bar
wenzelm@43467
  1431
\rail@term{\isa{simp}}[]
wenzelm@43467
  1432
\rail@nextbar{2}
wenzelm@43467
  1433
\rail@term{\isa{intro}}[]
wenzelm@43467
  1434
\rail@nextbar{3}
wenzelm@43467
  1435
\rail@term{\isa{elim}}[]
wenzelm@43467
  1436
\rail@nextbar{4}
wenzelm@43467
  1437
\rail@term{\isa{dest}}[]
wenzelm@43467
  1438
\rail@endbar
wenzelm@43467
  1439
\rail@term{\isa{{\isaliteral{3A}{\isacharcolon}}}}[]
wenzelm@43467
  1440
\rail@nont{\hyperlink{syntax.thmrefs}{\mbox{\isa{thmrefs}}}}[]
wenzelm@43467
  1441
\rail@nextplus{5}
wenzelm@43467
  1442
\rail@endplus
wenzelm@43467
  1443
\rail@endbar
wenzelm@43467
  1444
\rail@bar
wenzelm@43467
  1445
\rail@nextbar{1}
wenzelm@43467
  1446
\rail@nont{\hyperlink{syntax.nat}{\mbox{\isa{nat}}}}[]
wenzelm@43467
  1447
\rail@endbar
wenzelm@43467
  1448
\rail@end
wenzelm@43535
  1449
\rail@begin{2}{}
wenzelm@43467
  1450
\rail@term{\hyperlink{command.HOL.sledgehammer}{\mbox{\isa{\isacommand{sledgehammer}}}}}[]
wenzelm@43467
  1451
\rail@bar
wenzelm@43467
  1452
\rail@nextbar{1}
wenzelm@43467
  1453
\rail@term{\isa{{\isaliteral{5B}{\isacharbrackleft}}}}[]
wenzelm@43467
  1454
\rail@nont{\isa{args}}[]
wenzelm@43467
  1455
\rail@term{\isa{{\isaliteral{5D}{\isacharbrackright}}}}[]
wenzelm@43467
  1456
\rail@endbar
wenzelm@43467
  1457
\rail@bar
wenzelm@43467
  1458
\rail@nextbar{1}
wenzelm@43467
  1459
\rail@nont{\isa{facts}}[]
wenzelm@43467
  1460
\rail@endbar
wenzelm@43467
  1461
\rail@bar
wenzelm@43467
  1462
\rail@nextbar{1}
wenzelm@43467
  1463
\rail@nont{\hyperlink{syntax.nat}{\mbox{\isa{nat}}}}[]
wenzelm@43467
  1464
\rail@endbar
wenzelm@43467
  1465
\rail@end
wenzelm@43535
  1466
\rail@begin{2}{}
wenzelm@43467
  1467
\rail@term{\hyperlink{command.HOL.sledgehammer-params}{\mbox{\isa{\isacommand{sledgehammer{\isaliteral{5F}{\isacharunderscore}}params}}}}}[]
wenzelm@43467
  1468
\rail@bar
wenzelm@43467
  1469
\rail@nextbar{1}
wenzelm@43467
  1470
\rail@term{\isa{{\isaliteral{5B}{\isacharbrackleft}}}}[]
wenzelm@43467
  1471
\rail@nont{\isa{args}}[]
wenzelm@43467
  1472
\rail@term{\isa{{\isaliteral{5D}{\isacharbrackright}}}}[]
wenzelm@43467
  1473
\rail@endbar
wenzelm@43467
  1474
\rail@end
wenzelm@43467
  1475
\rail@begin{2}{\isa{args}}
wenzelm@43467
  1476
\rail@plus
wenzelm@43467
  1477
\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
  1478
\rail@term{\isa{{\isaliteral{3D}{\isacharequal}}}}[]
wenzelm@43467
  1479
\rail@nont{\isa{value}}[]
wenzelm@43467
  1480
\rail@nextplus{1}
wenzelm@43467
  1481
\rail@cterm{\isa{{\isaliteral{2C}{\isacharcomma}}}}[]
wenzelm@43467
  1482
\rail@endplus
wenzelm@43467
  1483
\rail@end
wenzelm@43467
  1484
\rail@begin{5}{\isa{facts}}
wenzelm@43467
  1485
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
  1486
\rail@bar
wenzelm@43467
  1487
\rail@nextbar{1}
wenzelm@43467
  1488
\rail@plus
wenzelm@43467
  1489
\rail@bar
wenzelm@43467
  1490
\rail@nextbar{2}
wenzelm@43467
  1491
\rail@bar
wenzelm@43467
  1492
\rail@term{\isa{add}}[]
wenzelm@43467
  1493
\rail@nextbar{3}
wenzelm@43467
  1494
\rail@term{\isa{del}}[]
wenzelm@43467
  1495
\rail@endbar
wenzelm@43467
  1496
\rail@term{\isa{{\isaliteral{3A}{\isacharcolon}}}}[]
wenzelm@43467
  1497
\rail@endbar
wenzelm@43467
  1498
\rail@nont{\hyperlink{syntax.thmrefs}{\mbox{\isa{thmrefs}}}}[]
wenzelm@43467
  1499
\rail@nextplus{4}
wenzelm@43467
  1500
\rail@endplus
wenzelm@43467
  1501
\rail@endbar
wenzelm@43467
  1502
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
  1503
\rail@end
wenzelm@43467
  1504
\end{railoutput}
wenzelm@43467
  1505
 % FIXME try: proper clasimpmod!?
wenzelm@43467
  1506
  % FIXME check args "value"
blanchet@43082
  1507
blanchet@43082
  1508
  \begin{description}
blanchet@43082
  1509
blanchet@43082
  1510
  \item \hyperlink{command.HOL.solve-direct}{\mbox{\isa{\isacommand{solve{\isaliteral{5F}{\isacharunderscore}}direct}}}} checks whether the current subgoals can
blanchet@43082
  1511
    be solved directly by an existing theorem. Duplicate lemmas can be detected
blanchet@43082
  1512
    in this way.
blanchet@43082
  1513
blanchet@43082
  1514
  \item \hyperlink{command.HOL.try}{\mbox{\isa{\isacommand{try}}}} attempts to prove a subgoal using a combination
blanchet@43082
  1515
    of standard proof methods (\isa{auto}, \isa{simp}, \isa{blast}, etc.).
blanchet@43082
  1516
    Additional facts supplied via \isa{{\isaliteral{22}{\isachardoublequote}}simp{\isaliteral{3A}{\isacharcolon}}{\isaliteral{22}{\isachardoublequote}}}, \isa{{\isaliteral{22}{\isachardoublequote}}intro{\isaliteral{3A}{\isacharcolon}}{\isaliteral{22}{\isachardoublequote}}},
blanchet@43082
  1517
    \isa{{\isaliteral{22}{\isachardoublequote}}elim{\isaliteral{3A}{\isacharcolon}}{\isaliteral{22}{\isachardoublequote}}}, and \isa{{\isaliteral{22}{\isachardoublequote}}dest{\isaliteral{3A}{\isacharcolon}}{\isaliteral{22}{\isachardoublequote}}} are passed to the appropriate proof
blanchet@43082
  1518
    methods.
blanchet@43082
  1519
blanchet@43082
  1520
  \item \hyperlink{command.HOL.sledgehammer}{\mbox{\isa{\isacommand{sledgehammer}}}} attempts to prove a subgoal using external
blanchet@43082
  1521
    automatic provers (resolution provers and SMT solvers). See the Sledgehammer
blanchet@43082
  1522
    manual \cite{isabelle-sledgehammer} for details.
blanchet@43082
  1523
blanchet@43082
  1524
  \item \hyperlink{command.HOL.sledgehammer-params}{\mbox{\isa{\isacommand{sledgehammer{\isaliteral{5F}{\isacharunderscore}}params}}}} changes
blanchet@43082
  1525
    \hyperlink{command.HOL.sledgehammer}{\mbox{\isa{\isacommand{sledgehammer}}}} configuration options persistently.
blanchet@43082
  1526
blanchet@43082
  1527
  \end{description}%
blanchet@43082
  1528
\end{isamarkuptext}%
blanchet@43082
  1529
\isamarkuptrue%
blanchet@43082
  1530
%
haftmann@31907
  1531
\isamarkupsection{Checking and refuting propositions%
haftmann@31907
  1532
}
haftmann@31907
  1533
\isamarkuptrue%
haftmann@31907
  1534
%
haftmann@31907
  1535
\begin{isamarkuptext}%
haftmann@31907
  1536
Identifying incorrect propositions usually involves evaluation of
blanchet@43082
  1537
  particular assignments and systematic counterexample search.  This
haftmann@31907
  1538
  is supported by the following commands.
haftmann@31907
  1539
haftmann@31907
  1540
  \begin{matharray}{rcl}
wenzelm@40685
  1541
    \indexdef{HOL}{command}{value}\hypertarget{command.HOL.value}{\hyperlink{command.HOL.value}{\mbox{\isa{\isacommand{value}}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}context\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1542
    \indexdef{HOL}{command}{quickcheck}\hypertarget{command.HOL.quickcheck}{\hyperlink{command.HOL.quickcheck}{\mbox{\isa{\isacommand{quickcheck}}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}proof\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}{\isaliteral{22}{\isachardoublequote}}} \\
blanchet@43082
  1543
    \indexdef{HOL}{command}{refute}\hypertarget{command.HOL.refute}{\hyperlink{command.HOL.refute}{\mbox{\isa{\isacommand{refute}}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}proof\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}{\isaliteral{22}{\isachardoublequote}}} \\
blanchet@43082
  1544
    \indexdef{HOL}{command}{nitpick}\hypertarget{command.HOL.nitpick}{\hyperlink{command.HOL.nitpick}{\mbox{\isa{\isacommand{nitpick}}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}proof\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}{\isaliteral{22}{\isachardoublequote}}} \\
blanchet@43082
  1545
    \indexdef{HOL}{command}{quickcheck\_params}\hypertarget{command.HOL.quickcheck-params}{\hyperlink{command.HOL.quickcheck-params}{\mbox{\isa{\isacommand{quickcheck{\isaliteral{5F}{\isacharunderscore}}params}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
blanchet@43082
  1546
    \indexdef{HOL}{command}{refute\_params}\hypertarget{command.HOL.refute-params}{\hyperlink{command.HOL.refute-params}{\mbox{\isa{\isacommand{refute{\isaliteral{5F}{\isacharunderscore}}params}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
blanchet@43082
  1547
    \indexdef{HOL}{command}{nitpick\_params}\hypertarget{command.HOL.nitpick-params}{\hyperlink{command.HOL.nitpick-params}{\mbox{\isa{\isacommand{nitpick{\isaliteral{5F}{\isacharunderscore}}params}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}}
haftmann@31907
  1548
  \end{matharray}
haftmann@31907
  1549
wenzelm@43467
  1550
  \begin{railoutput}
wenzelm@43535
  1551
\rail@begin{2}{}
wenzelm@43467
  1552
\rail@term{\hyperlink{command.HOL.value}{\mbox{\isa{\isacommand{value}}}}}[]
wenzelm@43467
  1553
\rail@bar
wenzelm@43467
  1554
\rail@nextbar{1}
wenzelm@43467
  1555
\rail@term{\isa{{\isaliteral{5B}{\isacharbrackleft}}}}[]
wenzelm@43467
  1556
\rail@nont{\isa{name}}[]
wenzelm@43467
  1557
\rail@term{\isa{{\isaliteral{5D}{\isacharbrackright}}}}[]
wenzelm@43467
  1558
\rail@endbar
wenzelm@43467
  1559
\rail@bar
wenzelm@43467
  1560
\rail@nextbar{1}
wenzelm@43467
  1561
\rail@nont{\isa{modes}}[]
wenzelm@43467
  1562
\rail@endbar
wenzelm@43467
  1563
\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]
wenzelm@43467
  1564
\rail@end
wenzelm@43535
  1565
\rail@begin{3}{}
wenzelm@43467
  1566
\rail@bar
wenzelm@43467
  1567
\rail@term{\hyperlink{command.HOL.quickcheck}{\mbox{\isa{\isacommand{quickcheck}}}}}[]
wenzelm@43467
  1568
\rail@nextbar{1}
wenzelm@43467
  1569
\rail@term{\hyperlink{command.HOL.refute}{\mbox{\isa{\isacommand{refute}}}}}[]
wenzelm@43467
  1570
\rail@nextbar{2}
wenzelm@43467
  1571
\rail@term{\hyperlink{command.HOL.nitpick}{\mbox{\isa{\isacommand{nitpick}}}}}[]
wenzelm@43467
  1572
\rail@endbar
wenzelm@43467
  1573
\rail@bar
wenzelm@43467
  1574
\rail@nextbar{1}
wenzelm@43467
  1575
\rail@term{\isa{{\isaliteral{5B}{\isacharbrackleft}}}}[]
wenzelm@43467
  1576
\rail@nont{\isa{args}}[]
wenzelm@43467
  1577
\rail@term{\isa{{\isaliteral{5D}{\isacharbrackright}}}}[]
wenzelm@43467
  1578
\rail@endbar
wenzelm@43467
  1579
\rail@bar
wenzelm@43467
  1580
\rail@nextbar{1}
wenzelm@43467
  1581
\rail@nont{\hyperlink{syntax.nat}{\mbox{\isa{nat}}}}[]
wenzelm@43467
  1582
\rail@endbar
wenzelm@43467
  1583
\rail@end
wenzelm@43535
  1584
\rail@begin{3}{}
wenzelm@43467
  1585
\rail@bar
wenzelm@43467
  1586
\rail@term{\hyperlink{command.HOL.quickcheck-params}{\mbox{\isa{\isacommand{quickcheck{\isaliteral{5F}{\isacharunderscore}}params}}}}}[]
wenzelm@43467
  1587
\rail@nextbar{1}
wenzelm@43467
  1588
\rail@term{\hyperlink{command.HOL.refute-params}{\mbox{\isa{\isacommand{refute{\isaliteral{5F}{\isacharunderscore}}params}}}}}[]
wenzelm@43467
  1589
\rail@nextbar{2}
wenzelm@43467
  1590
\rail@term{\hyperlink{command.HOL.nitpick-params}{\mbox{\isa{\isacommand{nitpick{\isaliteral{5F}{\isacharunderscore}}params}}}}}[]
wenzelm@43467
  1591
\rail@endbar
wenzelm@43467
  1592
\rail@bar
wenzelm@43467
  1593
\rail@nextbar{1}
wenzelm@43467
  1594
\rail@term{\isa{{\isaliteral{5B}{\isacharbrackleft}}}}[]
wenzelm@43467
  1595
\rail@nont{\isa{args}}[]
wenzelm@43467
  1596
\rail@term{\isa{{\isaliteral{5D}{\isacharbrackright}}}}[]
wenzelm@43467
  1597
\rail@endbar
wenzelm@43467
  1598
\rail@end
wenzelm@43467
  1599
\rail@begin{2}{\isa{modes}}
wenzelm@43467
  1600
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
  1601
\rail@plus
wenzelm@43467
  1602
\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
  1603
\rail@nextplus{1}
wenzelm@43467
  1604
\rail@endplus
wenzelm@43467
  1605
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
  1606
\rail@end
wenzelm@43467
  1607
\rail@begin{2}{\isa{args}}
wenzelm@43467
  1608
\rail@plus
wenzelm@43467
  1609
\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
  1610
\rail@term{\isa{{\isaliteral{3D}{\isacharequal}}}}[]
wenzelm@43467
  1611
\rail@nont{\isa{value}}[]
wenzelm@43467
  1612
\rail@nextplus{1}
wenzelm@43467
  1613
\rail@cterm{\isa{{\isaliteral{2C}{\isacharcomma}}}}[]
wenzelm@43467
  1614
\rail@endplus
wenzelm@43467
  1615
\rail@end
wenzelm@43467
  1616
\end{railoutput}
wenzelm@43467
  1617
 % FIXME check "value"
haftmann@31907
  1618
haftmann@31907
  1619
  \begin{description}
haftmann@31907
  1620
haftmann@31907
  1621
  \item \hyperlink{command.HOL.value}{\mbox{\isa{\isacommand{value}}}}~\isa{t} evaluates and prints a
haftmann@31907
  1622
    term; optionally \isa{modes} can be specified, which are
haftmann@31907
  1623
    appended to the current print mode (see also \cite{isabelle-ref}).
haftmann@31907
  1624
    Internally, the evaluation is performed by registered evaluators,
haftmann@31907
  1625
    which are invoked sequentially until a result is returned.
haftmann@31907
  1626
    Alternatively a specific evaluator can be selected using square
haftmann@37419
  1627
    brackets; typical evaluators use the current set of code equations
haftmann@37419
  1628
    to normalize and include \isa{simp} for fully symbolic evaluation
haftmann@37419
  1629
    using the simplifier, \isa{nbe} for \emph{normalization by evaluation}
haftmann@37419
  1630
    and \emph{code} for code generation in SML.
haftmann@31907
  1631
haftmann@31907
  1632
  \item \hyperlink{command.HOL.quickcheck}{\mbox{\isa{\isacommand{quickcheck}}}} tests the current goal for
blanchet@43082
  1633
    counterexamples using a series of assignments for its
haftmann@31907
  1634
    free variables; by default the first subgoal is tested, an other
haftmann@31907
  1635
    can be selected explicitly using an optional goal index.
wenzelm@41185
  1636
    Assignments can be chosen exhausting the search space upto a given
wenzelm@41185
  1637
    size or using a fixed number of random assignments in the search space.
wenzelm@41185
  1638
    By default, quickcheck uses exhaustive testing.
haftmann@31907
  1639
    A number of configuration options are supported for
haftmann@31907
  1640
    \hyperlink{command.HOL.quickcheck}{\mbox{\isa{\isacommand{quickcheck}}}}, notably:
haftmann@31907
  1641
haftmann@31907
  1642
    \begin{description}
haftmann@31907
  1643
wenzelm@41185
  1644
    \item[\isa{tester}] specifies how to explore the search space
wenzelm@41185
  1645
      (e.g. exhaustive or random).
wenzelm@41185
  1646
      An unknown configuration option is treated as an argument to tester,
wenzelm@41185
  1647
      making \isa{{\isaliteral{22}{\isachardoublequote}}tester\ {\isaliteral{3D}{\isacharequal}}{\isaliteral{22}{\isachardoublequote}}} optional.
wenzelm@40515
  1648
    \item[\isa{size}] specifies the maximum size of the search space
wenzelm@40515
  1649
    for assignment values.
haftmann@31907
  1650
wenzelm@42994
  1651
    \item[\isa{eval}] takes a term or a list of terms and evaluates
wenzelm@42994
  1652
      these terms under the variable assignment found by quickcheck.
wenzelm@42994
  1653
wenzelm@40515
  1654
    \item[\isa{iterations}] sets how many sets of assignments are
wenzelm@40515
  1655
    generated for each particular size.
haftmann@31907
  1656
wenzelm@40685
  1657
    \item[\isa{no{\isaliteral{5F}{\isacharunderscore}}assms}] specifies whether assumptions in
wenzelm@40515
  1658
    structured proofs should be ignored.
wenzelm@40515
  1659
wenzelm@40515
  1660
    \item[\isa{timeout}] sets the time limit in seconds.
wenzelm@40515
  1661
wenzelm@40685
  1662
    \item[\isa{default{\isaliteral{5F}{\isacharunderscore}}type}] sets the type(s) generally used to
wenzelm@40515
  1663
    instantiate type variables.
wenzelm@40515
  1664
wenzelm@40515
  1665
    \item[\isa{report}] if set quickcheck reports how many tests
wenzelm@40515
  1666
    fulfilled the preconditions.
wenzelm@40515
  1667
wenzelm@40515
  1668
    \item[\isa{quiet}] if not set quickcheck informs about the
wenzelm@40515
  1669
    current size for assignment values.
wenzelm@40515
  1670
wenzelm@40515
  1671
    \item[\isa{expect}] can be used to check if the user's
wenzelm@40685
  1672
    expectation was met (\isa{no{\isaliteral{5F}{\isacharunderscore}}expectation}, \isa{no{\isaliteral{5F}{\isacharunderscore}}counterexample}, or \isa{counterexample}).
wenzelm@35352
  1673
haftmann@31907
  1674
    \end{description}
haftmann@31907
  1675
haftmann@31907
  1676
    These option can be given within square brackets.
haftmann@31907
  1677
blanchet@43082
  1678
  \item \hyperlink{command.HOL.quickcheck-params}{\mbox{\isa{\isacommand{quickcheck{\isaliteral{5F}{\isacharunderscore}}params}}}} changes
blanchet@43082
  1679
    \hyperlink{command.HOL.quickcheck}{\mbox{\isa{\isacommand{quickcheck}}}} configuration options persistently.
blanchet@43082
  1680
blanchet@43082
  1681
  \item \hyperlink{command.HOL.refute}{\mbox{\isa{\isacommand{refute}}}} tests the current goal for
blanchet@43082
  1682
    counterexamples using a reduction to SAT. The following configuration
blanchet@43082
  1683
    options are supported:
blanchet@43082
  1684
blanchet@43082
  1685
    \begin{description}
blanchet@43082
  1686
blanchet@43082
  1687
    \item[\isa{minsize}] specifies the minimum size (cardinality) of the
blanchet@43082
  1688
      models to search for.
blanchet@43082
  1689
blanchet@43082
  1690
    \item[\isa{maxsize}] specifies the maximum size (cardinality) of the
blanchet@43082
  1691
      models to search for. Nonpositive values mean $\infty$.
blanchet@43082
  1692
blanchet@43082
  1693
    \item[\isa{maxvars}] specifies the maximum number of Boolean variables
blanchet@43082
  1694
    to use when transforming the term into a propositional formula.
blanchet@43082
  1695
    Nonpositive values mean $\infty$.
blanchet@43082
  1696
blanchet@43082
  1697
    \item[\isa{satsolver}] specifies the SAT solver to use.
blanchet@43082
  1698
blanchet@43082
  1699
    \item[\isa{no{\isaliteral{5F}{\isacharunderscore}}assms}] specifies whether assumptions in
blanchet@43082
  1700
    structured proofs should be ignored.
blanchet@43082
  1701
blanchet@43082
  1702
    \item[\isa{maxtime}] sets the time limit in seconds.
blanchet@43082
  1703
blanchet@43082
  1704
    \item[\isa{expect}] can be used to check if the user's
blanchet@43082
  1705
    expectation was met (\isa{genuine}, \isa{potential},
blanchet@43082
  1706
    \isa{none}, or \isa{unknown}).
blanchet@43082
  1707
blanchet@43082
  1708
    \end{description}
blanchet@43082
  1709
blanchet@43082
  1710
    These option can be given within square brackets.
blanchet@43082
  1711
blanchet@43082
  1712
  \item \hyperlink{command.HOL.refute-params}{\mbox{\isa{\isacommand{refute{\isaliteral{5F}{\isacharunderscore}}params}}}} changes
blanchet@43082
  1713
    \hyperlink{command.HOL.refute}{\mbox{\isa{\isacommand{refute}}}} configuration options persistently.
blanchet@43082
  1714
blanchet@43082
  1715
  \item \hyperlink{command.HOL.nitpick}{\mbox{\isa{\isacommand{nitpick}}}} tests the current goal for counterexamples
blanchet@43082
  1716
    using a reduction to first-order relational logic. See the Nitpick manual
blanchet@43082
  1717
    \cite{isabelle-nitpick} for details.
blanchet@43082
  1718
blanchet@43082
  1719
  \item \hyperlink{command.HOL.nitpick-params}{\mbox{\isa{\isacommand{nitpick{\isaliteral{5F}{\isacharunderscore}}params}}}} changes
blanchet@43082
  1720
    \hyperlink{command.HOL.nitpick}{\mbox{\isa{\isacommand{nitpick}}}} configuration options persistently.
haftmann@31907
  1721
haftmann@31907
  1722
  \end{description}%
haftmann@31907
  1723
\end{isamarkuptext}%
haftmann@31907
  1724
\isamarkuptrue%
haftmann@31907
  1725
%
wenzelm@28788
  1726
\isamarkupsection{Unstructured case analysis and induction \label{sec:hol-induct-tac}%
wenzelm@26849
  1727
}
wenzelm@26849
  1728
\isamarkuptrue%
wenzelm@26849
  1729
%
wenzelm@26849
  1730
\begin{isamarkuptext}%
wenzelm@27124
  1731
The following tools of Isabelle/HOL support cases analysis and
wenzelm@27124
  1732
  induction in unstructured tactic scripts; see also
wenzelm@27124
  1733
  \secref{sec:cases-induct} for proper Isar versions of similar ideas.
wenzelm@26849
  1734
wenzelm@26849
  1735
  \begin{matharray}{rcl}
wenzelm@40685
  1736
    \indexdef{HOL}{method}{case\_tac}\hypertarget{method.HOL.case-tac}{\hyperlink{method.HOL.case-tac}{\mbox{\isa{case{\isaliteral{5F}{\isacharunderscore}}tac}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{method} \\
wenzelm@40685
  1737
    \indexdef{HOL}{method}{induct\_tac}\hypertarget{method.HOL.induct-tac}{\hyperlink{method.HOL.induct-tac}{\mbox{\isa{induct{\isaliteral{5F}{\isacharunderscore}}tac}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{method} \\
wenzelm@40685
  1738
    \indexdef{HOL}{method}{ind\_cases}\hypertarget{method.HOL.ind-cases}{\hyperlink{method.HOL.ind-cases}{\mbox{\isa{ind{\isaliteral{5F}{\isacharunderscore}}cases}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{method} \\
wenzelm@40685
  1739
    \indexdef{HOL}{command}{inductive\_cases}\hypertarget{command.HOL.inductive-cases}{\hyperlink{command.HOL.inductive-cases}{\mbox{\isa{\isacommand{inductive{\isaliteral{5F}{\isacharunderscore}}cases}}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ local{\isaliteral{5F}{\isacharunderscore}}theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@26849
  1740
  \end{matharray}
wenzelm@26849
  1741
wenzelm@43467
  1742
  \begin{railoutput}
wenzelm@43535
  1743
\rail@begin{2}{}
wenzelm@43467
  1744
\rail@term{\hyperlink{method.HOL.case-tac}{\mbox{\isa{case{\isaliteral{5F}{\isacharunderscore}}tac}}}}[]
wenzelm@43467
  1745
\rail@bar
wenzelm@43467
  1746
\rail@nextbar{1}
wenzelm@43576
  1747
\rail@nont{\hyperlink{syntax.goal-spec}{\mbox{\isa{goal{\isaliteral{5F}{\isacharunderscore}}spec}}}}[]
wenzelm@43467
  1748
\rail@endbar
wenzelm@43467
  1749
\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]
wenzelm@43467
  1750
\rail@bar
wenzelm@43467
  1751
\rail@nextbar{1}
wenzelm@43467
  1752
\rail@nont{\isa{rule}}[]
wenzelm@43467
  1753
\rail@endbar
wenzelm@43467
  1754
\rail@end
wenzelm@43535
  1755
\rail@begin{3}{}
wenzelm@43467
  1756
\rail@term{\hyperlink{method.HOL.induct-tac}{\mbox{\isa{induct{\isaliteral{5F}{\isacharunderscore}}tac}}}}[]
wenzelm@43467
  1757
\rail@bar
wenzelm@43467
  1758
\rail@nextbar{1}
wenzelm@43576
  1759
\rail@nont{\hyperlink{syntax.goal-spec}{\mbox{\isa{goal{\isaliteral{5F}{\isacharunderscore}}spec}}}}[]
wenzelm@43467
  1760
\rail@endbar
wenzelm@43467
  1761
\rail@bar
wenzelm@43467
  1762
\rail@nextbar{1}
wenzelm@43467
  1763
\rail@plus
wenzelm@43467
  1764
\rail@nont{\hyperlink{syntax.insts}{\mbox{\isa{insts}}}}[]
wenzelm@43467
  1765
\rail@nextplus{2}
wenzelm@43467
  1766
\rail@cterm{\isa{\isakeyword{and}}}[]
wenzelm@43467
  1767
\rail@endplus
wenzelm@43467
  1768
\rail@endbar
wenzelm@43467
  1769
\rail@bar
wenzelm@43467
  1770
\rail@nextbar{1}
wenzelm@43467
  1771
\rail@nont{\isa{rule}}[]
wenzelm@43467
  1772
\rail@endbar
wenzelm@43467
  1773
\rail@end
wenzelm@43535
  1774
\rail@begin{3}{}
wenzelm@43467
  1775
\rail@term{\hyperlink{method.HOL.ind-cases}{\mbox{\isa{ind{\isaliteral{5F}{\isacharunderscore}}cases}}}}[]
wenzelm@43467
  1776
\rail@plus
wenzelm@43467
  1777
\rail@nont{\hyperlink{syntax.prop}{\mbox{\isa{prop}}}}[]
wenzelm@43467
  1778
\rail@nextplus{1}
wenzelm@43467
  1779
\rail@endplus
wenzelm@43467
  1780
\rail@bar
wenzelm@43467
  1781
\rail@nextbar{1}
wenzelm@43467
  1782
\rail@term{\isa{\isakeyword{for}}}[]
wenzelm@43467
  1783
\rail@plus
wenzelm@43467
  1784
\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
  1785
\rail@nextplus{2}
wenzelm@43467
  1786
\rail@endplus
wenzelm@43467
  1787
\rail@endbar
wenzelm@43467
  1788
\rail@end
wenzelm@43535
  1789
\rail@begin{3}{}
wenzelm@43467
  1790
\rail@term{\hyperlink{command.HOL.inductive-cases}{\mbox{\isa{\isacommand{inductive{\isaliteral{5F}{\isacharunderscore}}cases}}}}}[]
wenzelm@43467
  1791
\rail@plus
wenzelm@43467
  1792
\rail@bar
wenzelm@43467
  1793
\rail@nextbar{1}
wenzelm@43467
  1794
\rail@nont{\hyperlink{syntax.thmdecl}{\mbox{\isa{thmdecl}}}}[]
wenzelm@43467
  1795
\rail@endbar
wenzelm@43467
  1796
\rail@plus
wenzelm@43467
  1797
\rail@nont{\hyperlink{syntax.prop}{\mbox{\isa{prop}}}}[]
wenzelm@43467
  1798
\rail@nextplus{1}
wenzelm@43467
  1799
\rail@endplus
wenzelm@43467
  1800
\rail@nextplus{2}
wenzelm@43467
  1801
\rail@cterm{\isa{\isakeyword{and}}}[]
wenzelm@43467
  1802
\rail@endplus
wenzelm@43467
  1803
\rail@end
wenzelm@43467
  1804
\rail@begin{1}{\isa{rule}}
wenzelm@43467
  1805
\rail@term{\isa{rule}}[]
wenzelm@43467
  1806
\rail@term{\isa{{\isaliteral{3A}{\isacharcolon}}}}[]
wenzelm@43467
  1807
\rail@nont{\hyperlink{syntax.thmref}{\mbox{\isa{thmref}}}}[]
wenzelm@43467
  1808
\rail@end
wenzelm@43467
  1809
\end{railoutput}
wenzelm@26849
  1810
wenzelm@26849
  1811
wenzelm@28788
  1812
  \begin{description}
wenzelm@26849
  1813
wenzelm@40685
  1814
  \item \hyperlink{method.HOL.case-tac}{\mbox{\isa{case{\isaliteral{5F}{\isacharunderscore}}tac}}} and \hyperlink{method.HOL.induct-tac}{\mbox{\isa{induct{\isaliteral{5F}{\isacharunderscore}}tac}}} admit
wenzelm@28788
  1815
  to reason about inductive types.  Rules are selected according to
wenzelm@28788
  1816
  the declarations by the \hyperlink{attribute.cases}{\mbox{\isa{cases}}} and \hyperlink{attribute.induct}{\mbox{\isa{induct}}}
wenzelm@28788
  1817
  attributes, cf.\ \secref{sec:cases-induct}.  The \hyperlink{command.HOL.datatype}{\mbox{\isa{\isacommand{datatype}}}} package already takes care of this.
wenzelm@27124
  1818
wenzelm@27124
  1819
  These unstructured tactics feature both goal addressing and dynamic
wenzelm@26849
  1820
  instantiation.  Note that named rule cases are \emph{not} provided
wenzelm@27124
  1821
  as would be by the proper \hyperlink{method.cases}{\mbox{\isa{cases}}} and \hyperlink{method.induct}{\mbox{\isa{induct}}} proof
wenzelm@40685
  1822
  methods (see \secref{sec:cases-induct}).  Unlike the \hyperlink{method.induct}{\mbox{\isa{induct}}} method, \hyperlink{method.induct-tac}{\mbox{\isa{induct{\isaliteral{5F}{\isacharunderscore}}tac}}} does not handle structured rule
wenzelm@27124
  1823
  statements, only the compact object-logic conclusion of the subgoal
wenzelm@27124
  1824
  being addressed.
wenzelm@42994
  1825
wenzelm@40685
  1826
  \item \hyperlink{method.HOL.ind-cases}{\mbox{\isa{ind{\isaliteral{5F}{\isacharunderscore}}cases}}} and \hyperlink{command.HOL.inductive-cases}{\mbox{\isa{\isacommand{inductive{\isaliteral{5F}{\isacharunderscore}}cases}}}} provide an interface to the internal \verb|mk_cases| operation.  Rules are simplified in an unrestricted
wenzelm@26861
  1827
  forward manner.
wenzelm@26849
  1828
wenzelm@40685
  1829
  While \hyperlink{method.HOL.ind-cases}{\mbox{\isa{ind{\isaliteral{5F}{\isacharunderscore}}cases}}} is a proof method to apply the
wenzelm@40685
  1830
  result immediately as elimination rules, \hyperlink{command.HOL.inductive-cases}{\mbox{\isa{\isacommand{inductive{\isaliteral{5F}{\isacharunderscore}}cases}}}} provides case split theorems at the theory level
wenzelm@40685
  1831
  for later use.  The \hyperlink{keyword.for}{\mbox{\isa{\isakeyword{for}}}} argument of the \hyperlink{method.HOL.ind-cases}{\mbox{\isa{ind{\isaliteral{5F}{\isacharunderscore}}cases}}} method allows to specify a list of variables that should
wenzelm@26849
  1832
  be generalized before applying the resulting rule.
wenzelm@26849
  1833
wenzelm@28788
  1834
  \end{description}%
wenzelm@26849
  1835
\end{isamarkuptext}%
wenzelm@26849
  1836
\isamarkuptrue%
wenzelm@26849
  1837
%
wenzelm@26849
  1838
\isamarkupsection{Executable code%
wenzelm@26849
  1839
}
wenzelm@26849
  1840
\isamarkuptrue%
wenzelm@26849
  1841
%
wenzelm@26849
  1842
\begin{isamarkuptext}%
wenzelm@43498
  1843
For validation purposes, it is often useful to \emph{execute}
wenzelm@43498
  1844
  specifications.  In principle, execution could be simulated by
wenzelm@43498
  1845
  Isabelle's inference kernel, i.e. by a combination of resolution and
wenzelm@43498
  1846
  simplification.  Unfortunately, this approach is rather inefficient.
wenzelm@43498
  1847
  A more efficient way of executing specifications is to translate
wenzelm@43498
  1848
  them into a functional programming language such as ML.
wenzelm@26849
  1849
wenzelm@43498
  1850
  Isabelle provides two generic frameworks to support code generation
wenzelm@43498
  1851
  from executable specifications.  Isabelle/HOL instantiates these
wenzelm@43498
  1852
  mechanisms in a way that is amenable to end-user applications.%
wenzelm@43498
  1853
\end{isamarkuptext}%
wenzelm@43498
  1854
\isamarkuptrue%
wenzelm@43498
  1855
%
wenzelm@43498
  1856
\isamarkupsubsection{The new code generator (F. Haftmann)%
wenzelm@43498
  1857
}
wenzelm@43498
  1858
\isamarkuptrue%
wenzelm@43498
  1859
%
wenzelm@43498
  1860
\begin{isamarkuptext}%
wenzelm@43498
  1861
This framework generates code from functional programs
haftmann@37397
  1862
  (including overloading using type classes) to SML \cite{SML}, OCaml
haftmann@39048
  1863
  \cite{OCaml}, Haskell \cite{haskell-revised-report} and Scala
wenzelm@43498
  1864
  \cite{scala-overview-tech-report}.  Conceptually, code generation is
wenzelm@43498
  1865
  split up in three steps: \emph{selection} of code theorems,
wenzelm@43498
  1866
  \emph{translation} into an abstract executable view and
wenzelm@43498
  1867
  \emph{serialization} to a specific \emph{target language}.
wenzelm@43498
  1868
  Inductive specifications can be executed using the predicate
wenzelm@43498
  1869
  compiler which operates within HOL.  See \cite{isabelle-codegen} for
wenzelm@43498
  1870
  an introduction.
haftmann@37397
  1871
haftmann@37397
  1872
  \begin{matharray}{rcl}
wenzelm@40685
  1873
    \indexdef{HOL}{command}{export\_code}\hypertarget{command.HOL.export-code}{\hyperlink{command.HOL.export-code}{\mbox{\isa{\isacommand{export{\isaliteral{5F}{\isacharunderscore}}code}}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}context\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}{\isaliteral{22}{\isachardoublequote}}} \\
haftmann@37397
  1874
    \indexdef{HOL}{attribute}{code}\hypertarget{attribute.HOL.code}{\hyperlink{attribute.HOL.code}{\mbox{\isa{code}}}} & : & \isa{attribute} \\
wenzelm@40685
  1875
    \indexdef{HOL}{command}{code\_abort}\hypertarget{command.HOL.code-abort}{\hyperlink{command.HOL.code-abort}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}abort}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1876
    \indexdef{HOL}{command}{code\_datatype}\hypertarget{command.HOL.code-datatype}{\hyperlink{command.HOL.code-datatype}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}datatype}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1877
    \indexdef{HOL}{command}{print\_codesetup}\hypertarget{command.HOL.print-codesetup}{\hyperlink{command.HOL.print-codesetup}{\mbox{\isa{\isacommand{print{\isaliteral{5F}{\isacharunderscore}}codesetup}}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}context\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1878
    \indexdef{HOL}{attribute}{code\_inline}\hypertarget{attribute.HOL.code-inline}{\hyperlink{attribute.HOL.code-inline}{\mbox{\isa{code{\isaliteral{5F}{\isacharunderscore}}inline}}}} & : & \isa{attribute} \\
wenzelm@40685
  1879
    \indexdef{HOL}{attribute}{code\_post}\hypertarget{attribute.HOL.code-post}{\hyperlink{attribute.HOL.code-post}{\mbox{\isa{code{\isaliteral{5F}{\isacharunderscore}}post}}}} & : & \isa{attribute} \\
wenzelm@40685
  1880
    \indexdef{HOL}{command}{print\_codeproc}\hypertarget{command.HOL.print-codeproc}{\hyperlink{command.HOL.print-codeproc}{\mbox{\isa{\isacommand{print{\isaliteral{5F}{\isacharunderscore}}codeproc}}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}context\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1881
    \indexdef{HOL}{command}{code\_thms}\hypertarget{command.HOL.code-thms}{\hyperlink{command.HOL.code-thms}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}thms}}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}context\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1882
    \indexdef{HOL}{command}{code\_deps}\hypertarget{command.HOL.code-deps}{\hyperlink{command.HOL.code-deps}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}deps}}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}context\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1883
    \indexdef{HOL}{command}{code\_const}\hypertarget{command.HOL.code-const}{\hyperlink{command.HOL.code-const}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}const}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1884
    \indexdef{HOL}{command}{code\_type}\hypertarget{command.HOL.code-type}{\hyperlink{command.HOL.code-type}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}type}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1885
    \indexdef{HOL}{command}{code\_class}\hypertarget{command.HOL.code-class}{\hyperlink{command.HOL.code-class}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}class}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1886
    \indexdef{HOL}{command}{code\_instance}\hypertarget{command.HOL.code-instance}{\hyperlink{command.HOL.code-instance}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}instance}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1887
    \indexdef{HOL}{command}{code\_reserved}\hypertarget{command.HOL.code-reserved}{\hyperlink{command.HOL.code-reserved}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}reserved}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1888
    \indexdef{HOL}{command}{code\_monad}\hypertarget{command.HOL.code-monad}{\hyperlink{command.HOL.code-monad}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}monad}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1889
    \indexdef{HOL}{command}{code\_include}\hypertarget{command.HOL.code-include}{\hyperlink{command.HOL.code-include}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}include}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1890
    \indexdef{HOL}{command}{code\_modulename}\hypertarget{command.HOL.code-modulename}{\hyperlink{command.HOL.code-modulename}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}modulename}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  1891
    \indexdef{HOL}{command}{code\_reflect}\hypertarget{command.HOL.code-reflect}{\hyperlink{command.HOL.code-reflect}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}reflect}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}}
haftmann@37397
  1892
  \end{matharray}
haftmann@37397
  1893
wenzelm@43467
  1894
  \begin{railoutput}
wenzelm@43535
  1895
\rail@begin{11}{}
wenzelm@43467
  1896
\rail@term{\hyperlink{command.HOL.export-code}{\mbox{\isa{\isacommand{export{\isaliteral{5F}{\isacharunderscore}}code}}}}}[]
wenzelm@43467
  1897
\rail@plus
wenzelm@43467
  1898
\rail@nont{\isa{constexpr}}[]
wenzelm@43467
  1899
\rail@nextplus{1}
wenzelm@43467
  1900
\rail@endplus
wenzelm@43467
  1901
\rail@cr{3}
wenzelm@43467
  1902
\rail@bar
wenzelm@43467
  1903
\rail@nextbar{4}
wenzelm@43467
  1904
\rail@plus
wenzelm@43467
  1905
\rail@term{\isa{\isakeyword{in}}}[]
wenzelm@43467
  1906
\rail@nont{\isa{target}}[]
wenzelm@43467
  1907
\rail@bar
wenzelm@43467
  1908
\rail@nextbar{5}
wenzelm@43467
  1909
\rail@term{\isa{\isakeyword{module{\isaliteral{5F}{\isacharunderscore}}name}}}[]
wenzelm@43467
  1910
\rail@nont{\hyperlink{syntax.string}{\mbox{\isa{string}}}}[]
wenzelm@43467
  1911
\rail@endbar
wenzelm@43467
  1912
\rail@cr{7}
wenzelm@43467
  1913
\rail@bar
wenzelm@43467
  1914
\rail@nextbar{8}
wenzelm@43467
  1915
\rail@term{\isa{\isakeyword{file}}}[]
wenzelm@43467
  1916
\rail@bar
wenzelm@43467
  1917
\rail@nont{\hyperlink{syntax.string}{\mbox{\isa{string}}}}[]
wenzelm@43467
  1918
\rail@nextbar{9}
wenzelm@43467
  1919
\rail@term{\isa{{\isaliteral{2D}{\isacharminus}}}}[]
wenzelm@43467
  1920
\rail@endbar
wenzelm@43467
  1921
\rail@endbar
wenzelm@43467
  1922
\rail@bar
wenzelm@43467
  1923
\rail@nextbar{8}
wenzelm@43467
  1924
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
  1925
\rail@nont{\isa{args}}[]
wenzelm@43467
  1926
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
  1927
\rail@endbar
wenzelm@43467
  1928
\rail@nextplus{10}
wenzelm@43467
  1929
\rail@endplus
wenzelm@43467
  1930
\rail@endbar
wenzelm@43467
  1931
\rail@end
wenzelm@43467
  1932
\rail@begin{1}{\isa{const}}
wenzelm@43467
  1933
\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]
wenzelm@43467
  1934
\rail@end
wenzelm@43467
  1935
\rail@begin{3}{\isa{constexpr}}
wenzelm@43467
  1936
\rail@bar
wenzelm@43467
  1937
\rail@nont{\isa{const}}[]
wenzelm@43467
  1938
\rail@nextbar{1}
wenzelm@43467
  1939
\rail@term{\isa{name{\isaliteral{2E}{\isachardot}}{\isaliteral{5F}{\isacharunderscore}}}}[]
wenzelm@43467
  1940
\rail@nextbar{2}
wenzelm@43467
  1941
\rail@term{\isa{{\isaliteral{5F}{\isacharunderscore}}}}[]
wenzelm@43467
  1942
\rail@endbar
wenzelm@43467
  1943
\rail@end
wenzelm@43467
  1944
\rail@begin{1}{\isa{typeconstructor}}
wenzelm@43467
  1945
\rail@nont{\hyperlink{syntax.nameref}{\mbox{\isa{nameref}}}}[]
wenzelm@43467
  1946
\rail@end
wenzelm@43467
  1947
\rail@begin{1}{\isa{class}}
wenzelm@43467
  1948
\rail@nont{\hyperlink{syntax.nameref}{\mbox{\isa{nameref}}}}[]
wenzelm@43467
  1949
\rail@end
wenzelm@43467
  1950
\rail@begin{4}{\isa{target}}
wenzelm@43467
  1951
\rail@bar
wenzelm@43467
  1952
\rail@term{\isa{SML}}[]
wenzelm@43467
  1953
\rail@nextbar{1}
wenzelm@43467
  1954
\rail@term{\isa{OCaml}}[]
wenzelm@43467
  1955
\rail@nextbar{2}
wenzelm@43467
  1956
\rail@term{\isa{Haskell}}[]
wenzelm@43467
  1957
\rail@nextbar{3}
wenzelm@43467
  1958
\rail@term{\isa{Scala}}[]
wenzelm@43467
  1959
\rail@endbar
wenzelm@43467
  1960
\rail@end
wenzelm@43535
  1961
\rail@begin{4}{}
wenzelm@43467
  1962
\rail@term{\hyperlink{attribute.HOL.code}{\mbox{\isa{code}}}}[]
wenzelm@43467
  1963
\rail@bar
wenzelm@43467
  1964
\rail@nextbar{1}
wenzelm@43467
  1965
\rail@bar
wenzelm@43467
  1966
\rail@term{\isa{del}}[]
wenzelm@43467
  1967
\rail@nextbar{2}
wenzelm@43467
  1968
\rail@term{\isa{abstype}}[]
wenzelm@43467
  1969
\rail@nextbar{3}
wenzelm@43467
  1970
\rail@term{\isa{abstract}}[]
wenzelm@43467
  1971
\rail@endbar
wenzelm@43467
  1972
\rail@endbar
wenzelm@43467
  1973
\rail@end
wenzelm@43535
  1974
\rail@begin{2}{}
wenzelm@43467
  1975
\rail@term{\hyperlink{command.HOL.code-abort}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}abort}}}}}[]
wenzelm@43467
  1976
\rail@plus
wenzelm@43467
  1977
\rail@nont{\isa{const}}[]
wenzelm@43467
  1978
\rail@nextplus{1}
wenzelm@43467
  1979
\rail@endplus
wenzelm@43467
  1980
\rail@end
wenzelm@43535
  1981
\rail@begin{2}{}
wenzelm@43467
  1982
\rail@term{\hyperlink{command.HOL.code-datatype}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}datatype}}}}}[]
wenzelm@43467
  1983
\rail@plus
wenzelm@43467
  1984
\rail@nont{\isa{const}}[]
wenzelm@43467
  1985
\rail@nextplus{1}
wenzelm@43467
  1986
\rail@endplus
wenzelm@43467
  1987
\rail@end
wenzelm@43535
  1988
\rail@begin{2}{}
wenzelm@43467
  1989
\rail@term{\hyperlink{attribute.HOL.code-inline}{\mbox{\isa{code{\isaliteral{5F}{\isacharunderscore}}inline}}}}[]
wenzelm@43467
  1990
\rail@bar
wenzelm@43467
  1991
\rail@nextbar{1}
wenzelm@43467
  1992
\rail@term{\isa{del}}[]
wenzelm@43467
  1993
\rail@endbar
wenzelm@43467
  1994
\rail@end
wenzelm@43535
  1995
\rail@begin{2}{}
wenzelm@43467
  1996
\rail@term{\hyperlink{attribute.HOL.code-post}{\mbox{\isa{code{\isaliteral{5F}{\isacharunderscore}}post}}}}[]
wenzelm@43467
  1997
\rail@bar
wenzelm@43467
  1998
\rail@nextbar{1}
wenzelm@43467
  1999
\rail@term{\isa{del}}[]
wenzelm@43467
  2000
\rail@endbar
wenzelm@43467
  2001
\rail@end
wenzelm@43535
  2002
\rail@begin{3}{}
wenzelm@43467
  2003
\rail@term{\hyperlink{command.HOL.code-thms}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}thms}}}}}[]
wenzelm@43467
  2004
\rail@bar
wenzelm@43467
  2005
\rail@nextbar{1}
wenzelm@43467
  2006
\rail@plus
wenzelm@43467
  2007
\rail@nont{\isa{constexpr}}[]
wenzelm@43467
  2008
\rail@nextplus{2}
wenzelm@43467
  2009
\rail@endplus
wenzelm@43467
  2010
\rail@endbar
wenzelm@43467
  2011
\rail@end
wenzelm@43535
  2012
\rail@begin{3}{}
wenzelm@43467
  2013
\rail@term{\hyperlink{command.HOL.code-deps}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}deps}}}}}[]
wenzelm@43467
  2014
\rail@bar
wenzelm@43467
  2015
\rail@nextbar{1}
wenzelm@43467
  2016
\rail@plus
wenzelm@43467
  2017
\rail@nont{\isa{constexpr}}[]
wenzelm@43467
  2018
\rail@nextplus{2}
wenzelm@43467
  2019
\rail@endplus
wenzelm@43467
  2020
\rail@endbar
wenzelm@43467
  2021
\rail@end
wenzelm@43535
  2022
\rail@begin{7}{}
wenzelm@43467
  2023
\rail@term{\hyperlink{command.HOL.code-const}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}const}}}}}[]
wenzelm@43467
  2024
\rail@plus
wenzelm@43467
  2025
\rail@nont{\isa{const}}[]
wenzelm@43467
  2026
\rail@nextplus{1}
wenzelm@43467
  2027
\rail@cterm{\isa{\isakeyword{and}}}[]
wenzelm@43467
  2028
\rail@endplus
wenzelm@43467
  2029
\rail@cr{3}
wenzelm@43467
  2030
\rail@plus
wenzelm@43467
  2031
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
  2032
\rail@nont{\isa{target}}[]
wenzelm@43467
  2033
\rail@plus
wenzelm@43467
  2034
\rail@bar
wenzelm@43467
  2035
\rail@nextbar{4}
wenzelm@43467
  2036
\rail@nont{\isa{syntax}}[]
wenzelm@43467
  2037
\rail@endbar
wenzelm@43467
  2038
\rail@nextplus{5}
wenzelm@43467
  2039
\rail@cterm{\isa{\isakeyword{and}}}[]
wenzelm@43467
  2040
\rail@endplus
wenzelm@43467
  2041
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
  2042
\rail@nextplus{6}
wenzelm@43467
  2043
\rail@endplus
wenzelm@43467
  2044
\rail@end
wenzelm@43535
  2045
\rail@begin{7}{}
wenzelm@43467
  2046
\rail@term{\hyperlink{command.HOL.code-type}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}type}}}}}[]
wenzelm@43467
  2047
\rail@plus
wenzelm@43467
  2048
\rail@nont{\isa{typeconstructor}}[]
wenzelm@43467
  2049
\rail@nextplus{1}
wenzelm@43467
  2050
\rail@cterm{\isa{\isakeyword{and}}}[]
wenzelm@43467
  2051
\rail@endplus
wenzelm@43467
  2052
\rail@cr{3}
wenzelm@43467
  2053
\rail@plus
wenzelm@43467
  2054
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
  2055
\rail@nont{\isa{target}}[]
wenzelm@43467
  2056
\rail@plus
wenzelm@43467
  2057
\rail@bar
wenzelm@43467
  2058
\rail@nextbar{4}
wenzelm@43467
  2059
\rail@nont{\isa{syntax}}[]
wenzelm@43467
  2060
\rail@endbar
wenzelm@43467
  2061
\rail@nextplus{5}
wenzelm@43467
  2062
\rail@cterm{\isa{\isakeyword{and}}}[]
wenzelm@43467
  2063
\rail@endplus
wenzelm@43467
  2064
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
  2065
\rail@nextplus{6}
wenzelm@43467
  2066
\rail@endplus
wenzelm@43467
  2067
\rail@end
wenzelm@43535
  2068
\rail@begin{9}{}
wenzelm@43467
  2069
\rail@term{\hyperlink{command.HOL.code-class}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}class}}}}}[]
wenzelm@43467
  2070
\rail@plus
wenzelm@43467
  2071
\rail@nont{\isa{class}}[]
wenzelm@43467
  2072
\rail@nextplus{1}
wenzelm@43467
  2073
\rail@cterm{\isa{\isakeyword{and}}}[]
wenzelm@43467
  2074
\rail@endplus
wenzelm@43467
  2075
\rail@cr{3}
wenzelm@43467
  2076
\rail@plus
wenzelm@43467
  2077
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
  2078
\rail@nont{\isa{target}}[]
wenzelm@43467
  2079
\rail@cr{5}
wenzelm@43467
  2080
\rail@plus
wenzelm@43467
  2081
\rail@bar
wenzelm@43467
  2082
\rail@nextbar{6}
wenzelm@43467
  2083
\rail@nont{\hyperlink{syntax.string}{\mbox{\isa{string}}}}[]
wenzelm@43467
  2084
\rail@endbar
wenzelm@43467
  2085
\rail@nextplus{7}
wenzelm@43467
  2086
\rail@cterm{\isa{\isakeyword{and}}}[]
wenzelm@43467
  2087
\rail@endplus
wenzelm@43467
  2088
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
  2089
\rail@nextplus{8}
wenzelm@43467
  2090
\rail@endplus
wenzelm@43467
  2091
\rail@end
wenzelm@43535
  2092
\rail@begin{7}{}
wenzelm@43467
  2093
\rail@term{\hyperlink{command.HOL.code-instance}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}instance}}}}}[]
wenzelm@43467
  2094
\rail@plus
wenzelm@43467
  2095
\rail@nont{\isa{typeconstructor}}[]
wenzelm@43467
  2096
\rail@term{\isa{{\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}}}[]
wenzelm@43467
  2097
\rail@nont{\isa{class}}[]
wenzelm@43467
  2098
\rail@nextplus{1}
wenzelm@43467
  2099
\rail@cterm{\isa{\isakeyword{and}}}[]
wenzelm@43467
  2100
\rail@endplus
wenzelm@43467
  2101
\rail@cr{3}
wenzelm@43467
  2102
\rail@plus
wenzelm@43467
  2103
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
  2104
\rail@nont{\isa{target}}[]
wenzelm@43467
  2105
\rail@plus
wenzelm@43467
  2106
\rail@bar
wenzelm@43467
  2107
\rail@nextbar{4}
wenzelm@43467
  2108
\rail@term{\isa{{\isaliteral{2D}{\isacharminus}}}}[]
wenzelm@43467
  2109
\rail@endbar
wenzelm@43467
  2110
\rail@nextplus{5}
wenzelm@43467
  2111
\rail@cterm{\isa{\isakeyword{and}}}[]
wenzelm@43467
  2112
\rail@endplus
wenzelm@43467
  2113
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
  2114
\rail@nextplus{6}
wenzelm@43467
  2115
\rail@endplus
wenzelm@43467
  2116
\rail@end
wenzelm@43535
  2117
\rail@begin{2}{}
wenzelm@43467
  2118
\rail@term{\hyperlink{command.HOL.code-reserved}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}reserved}}}}}[]
wenzelm@43467
  2119
\rail@nont{\isa{target}}[]
wenzelm@43467
  2120
\rail@plus
wenzelm@43467
  2121
\rail@nont{\hyperlink{syntax.string}{\mbox{\isa{string}}}}[]
wenzelm@43467
  2122
\rail@nextplus{1}
wenzelm@43467
  2123
\rail@endplus
wenzelm@43467
  2124
\rail@end
wenzelm@43535
  2125
\rail@begin{1}{}
wenzelm@43467
  2126
\rail@term{\hyperlink{command.HOL.code-monad}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}monad}}}}}[]
wenzelm@43467
  2127
\rail@nont{\isa{const}}[]
wenzelm@43467
  2128
\rail@nont{\isa{const}}[]
wenzelm@43467
  2129
\rail@nont{\isa{target}}[]
wenzelm@43467
  2130
\rail@end
wenzelm@43535
  2131
\rail@begin{2}{}
wenzelm@43467
  2132
\rail@term{\hyperlink{command.HOL.code-include}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}include}}}}}[]
wenzelm@43467
  2133
\rail@nont{\isa{target}}[]
wenzelm@43467
  2134
\rail@nont{\hyperlink{syntax.string}{\mbox{\isa{string}}}}[]
wenzelm@43467
  2135
\rail@bar
wenzelm@43467
  2136
\rail@nont{\hyperlink{syntax.string}{\mbox{\isa{string}}}}[]
wenzelm@43467
  2137
\rail@nextbar{1}
wenzelm@43467
  2138
\rail@term{\isa{{\isaliteral{2D}{\isacharminus}}}}[]
wenzelm@43467
  2139
\rail@endbar
wenzelm@43467
  2140
\rail@end
wenzelm@43535
  2141
\rail@begin{2}{}
wenzelm@43467
  2142
\rail@term{\hyperlink{command.HOL.code-modulename}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}modulename}}}}}[]
wenzelm@43467
  2143
\rail@nont{\isa{target}}[]
wenzelm@43467
  2144
\rail@plus
wenzelm@43467
  2145
\rail@nont{\hyperlink{syntax.string}{\mbox{\isa{string}}}}[]
wenzelm@43467
  2146
\rail@nont{\hyperlink{syntax.string}{\mbox{\isa{string}}}}[]
wenzelm@43467
  2147
\rail@nextplus{1}
wenzelm@43467
  2148
\rail@endplus
wenzelm@43467
  2149
\rail@end
wenzelm@43535
  2150
\rail@begin{11}{}
wenzelm@43467
  2151
\rail@term{\hyperlink{command.HOL.code-reflect}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}reflect}}}}}[]
wenzelm@43467
  2152
\rail@nont{\hyperlink{syntax.string}{\mbox{\isa{string}}}}[]
wenzelm@43467
  2153
\rail@cr{2}
wenzelm@43467
  2154
\rail@bar
wenzelm@43467
  2155
\rail@nextbar{3}
wenzelm@43467
  2156
\rail@term{\isa{\isakeyword{datatypes}}}[]
wenzelm@43467
  2157
\rail@nont{\hyperlink{syntax.string}{\mbox{\isa{string}}}}[]
wenzelm@43467
  2158
\rail@term{\isa{{\isaliteral{3D}{\isacharequal}}}}[]
wenzelm@43467
  2159
\rail@bar
wenzelm@43467
  2160
\rail@term{\isa{{\isaliteral{5F}{\isacharunderscore}}}}[]
wenzelm@43467
  2161
\rail@nextbar{4}
wenzelm@43467
  2162
\rail@plus
wenzelm@43467
  2163
\rail@plus
wenzelm@43467
  2164
\rail@nont{\hyperlink{syntax.string}{\mbox{\isa{string}}}}[]
wenzelm@43467
  2165
\rail@nextplus{5}
wenzelm@43467
  2166
\rail@cterm{\isa{{\isaliteral{7C}{\isacharbar}}}}[]
wenzelm@43467
  2167
\rail@endplus
wenzelm@43467
  2168
\rail@nextplus{6}
wenzelm@43467
  2169
\rail@cterm{\isa{\isakeyword{and}}}[]
wenzelm@43467
  2170
\rail@endplus
wenzelm@43467
  2171
\rail@endbar
wenzelm@43467
  2172
\rail@endbar
wenzelm@43467
  2173
\rail@cr{8}
wenzelm@43467
  2174
\rail@bar
wenzelm@43467
  2175
\rail@nextbar{9}
wenzelm@43467
  2176
\rail@term{\isa{\isakeyword{functions}}}[]
wenzelm@43467
  2177
\rail@plus
wenzelm@43467
  2178
\rail@nont{\hyperlink{syntax.string}{\mbox{\isa{string}}}}[]
wenzelm@43467
  2179
\rail@nextplus{10}
wenzelm@43467
  2180
\rail@endplus
wenzelm@43467
  2181
\rail@endbar
wenzelm@43467
  2182
\rail@bar
wenzelm@43467
  2183
\rail@nextbar{9}
wenzelm@43467
  2184
\rail@term{\isa{\isakeyword{file}}}[]
wenzelm@43467
  2185
\rail@nont{\hyperlink{syntax.string}{\mbox{\isa{string}}}}[]
wenzelm@43467
  2186
\rail@endbar
wenzelm@43467
  2187
\rail@end
wenzelm@43467
  2188
\rail@begin{4}{\isa{syntax}}
wenzelm@43467
  2189
\rail@bar
wenzelm@43467
  2190
\rail@nont{\hyperlink{syntax.string}{\mbox{\isa{string}}}}[]
wenzelm@43467
  2191
\rail@nextbar{1}
wenzelm@43467
  2192
\rail@bar
wenzelm@43467
  2193
\rail@term{\isa{\isakeyword{infix}}}[]
wenzelm@43467
  2194
\rail@nextbar{2}
wenzelm@43467
  2195
\rail@term{\isa{\isakeyword{infixl}}}[]
wenzelm@43467
  2196
\rail@nextbar{3}
wenzelm@43467
  2197
\rail@term{\isa{\isakeyword{infixr}}}[]
wenzelm@43467
  2198
\rail@endbar
wenzelm@43467
  2199
\rail@nont{\hyperlink{syntax.nat}{\mbox{\isa{nat}}}}[]
wenzelm@43467
  2200
\rail@nont{\hyperlink{syntax.string}{\mbox{\isa{string}}}}[]
wenzelm@43467
  2201
\rail@endbar
wenzelm@43467
  2202
\rail@end
wenzelm@43467
  2203
\end{railoutput}
haftmann@37397
  2204
haftmann@37397
  2205
haftmann@37397
  2206
  \begin{description}
haftmann@37397
  2207
wenzelm@40685
  2208
  \item \hyperlink{command.HOL.export-code}{\mbox{\isa{\isacommand{export{\isaliteral{5F}{\isacharunderscore}}code}}}} generates code for a given list
haftmann@39832
  2209
  of constants in the specified target language(s).  If no
haftmann@39832
  2210
  serialization instruction is given, only abstract code is generated
haftmann@39832
  2211
  internally.
haftmann@37397
  2212
haftmann@37397
  2213
  Constants may be specified by giving them literally, referring to
wenzelm@40685
  2214
  all executable contants within a certain theory by giving \isa{{\isaliteral{22}{\isachardoublequote}}name{\isaliteral{2E}{\isachardot}}{\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}}, or referring to \emph{all} executable constants currently
wenzelm@40685
  2215
  available by giving \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}}.
haftmann@37397
  2216
haftmann@37397
  2217
  By default, for each involved theory one corresponding name space
haftmann@37397
  2218
  module is generated.  Alternativly, a module name may be specified
wenzelm@40685
  2219
  after the \hyperlink{keyword.module-name}{\mbox{\isa{\isakeyword{module{\isaliteral{5F}{\isacharunderscore}}name}}}} keyword; then \emph{all} code is
haftmann@37397
  2220
  placed in this module.
haftmann@37397
  2221
haftmann@39832
  2222
  For \emph{SML}, \emph{OCaml} and \emph{Scala} the file specification
haftmann@39832
  2223
  refers to a single file; for \emph{Haskell}, it refers to a whole
haftmann@39832
  2224
  directory, where code is generated in multiple files reflecting the
haftmann@39832
  2225
  module hierarchy.  Omitting the file specification denotes standard
haftmann@37748
  2226
  output.
haftmann@37397
  2227
haftmann@37397
  2228
  Serializers take an optional list of arguments in parentheses.  For
wenzelm@40685
  2229
  \emph{SML} and \emph{OCaml}, ``\isa{no{\isaliteral{5F}{\isacharunderscore}}signatures}`` omits
haftmann@37397
  2230
  explicit module signatures.
wenzelm@42994
  2231
haftmann@39832
  2232
  For \emph{Haskell} a module name prefix may be given using the
wenzelm@40685
  2233
  ``\isa{{\isaliteral{22}{\isachardoublequote}}root{\isaliteral{3A}{\isacharcolon}}{\isaliteral{22}{\isachardoublequote}}}'' argument; ``\isa{string{\isaliteral{5F}{\isacharunderscore}}classes}'' adds a
haftmann@39832
  2234
  ``\verb|deriving (Read, Show)|'' clause to each appropriate
haftmann@39832
  2235
  datatype declaration.
haftmann@37397
  2236
haftmann@37397
  2237
  \item \hyperlink{attribute.HOL.code}{\mbox{\isa{code}}} explicitly selects (or with option
wenzelm@40685
  2238
  ``\isa{{\isaliteral{22}{\isachardoublequote}}del{\isaliteral{22}{\isachardoublequote}}}'' deselects) a code equation for code generation.
haftmann@38706
  2239
  Usually packages introducing code equations provide a reasonable
wenzelm@40685
  2240
  default setup for selection.  Variants \isa{{\isaliteral{22}{\isachardoublequote}}code\ abstype{\isaliteral{22}{\isachardoublequote}}} and
wenzelm@40685
  2241
  \isa{{\isaliteral{22}{\isachardoublequote}}code\ abstract{\isaliteral{22}{\isachardoublequote}}} declare abstract datatype certificates or
haftmann@38706
  2242
  code equations on abstract datatype representations respectively.
haftmann@37397
  2243
wenzelm@40685
  2244
  \item \hyperlink{command.HOL.code-abort}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}abort}}}} declares constants which are not
haftmann@39832
  2245
  required to have a definition by means of code equations; if needed
haftmann@39832
  2246
  these are implemented by program abort instead.
haftmann@37397
  2247
wenzelm@40685
  2248
  \item \hyperlink{command.HOL.code-datatype}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}datatype}}}} specifies a constructor set
haftmann@37397
  2249
  for a logical type.
haftmann@37397
  2250
wenzelm@40685
  2251
  \item \hyperlink{command.HOL.print-codesetup}{\mbox{\isa{\isacommand{print{\isaliteral{5F}{\isacharunderscore}}codesetup}}}} gives an overview on
haftmann@37397
  2252
  selected code equations and code generator datatypes.
haftmann@37397
  2253
wenzelm@40685
  2254
  \item \hyperlink{attribute.HOL.code-inline}{\mbox{\isa{code{\isaliteral{5F}{\isacharunderscore}}inline}}} declares (or with option
wenzelm@40685
  2255
  ``\isa{{\isaliteral{22}{\isachardoublequote}}del{\isaliteral{22}{\isachardoublequote}}}'' removes) inlining theorems which are applied as
haftmann@39832
  2256
  rewrite rules to any code equation during preprocessing.
haftmann@37397
  2257
wenzelm@40685
  2258
  \item \hyperlink{attribute.HOL.code-post}{\mbox{\isa{code{\isaliteral{5F}{\isacharunderscore}}post}}} declares (or with option ``\isa{{\isaliteral{22}{\isachardoublequote}}del{\isaliteral{22}{\isachardoublequote}}}'' removes) theorems which are applied as rewrite rules to any
haftmann@39832
  2259
  result of an evaluation.
haftmann@37397
  2260
wenzelm@40685
  2261
  \item \hyperlink{command.HOL.print-codeproc}{\mbox{\isa{\isacommand{print{\isaliteral{5F}{\isacharunderscore}}codeproc}}}} prints the setup of the code
haftmann@39832
  2262
  generator preprocessor.
haftmann@37397
  2263
wenzelm@40685
  2264
  \item \hyperlink{command.HOL.code-thms}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}thms}}}} prints a list of theorems
haftmann@37397
  2265
  representing the corresponding program containing all given
haftmann@37397
  2266
  constants after preprocessing.
haftmann@37397
  2267
wenzelm@40685
  2268
  \item \hyperlink{command.HOL.code-deps}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}deps}}}} visualizes dependencies of
haftmann@37397
  2269
  theorems representing the corresponding program containing all given
haftmann@37397
  2270
  constants after preprocessing.
haftmann@37397
  2271
wenzelm@40685
  2272
  \item \hyperlink{command.HOL.code-const}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}const}}}} associates a list of constants
haftmann@37397
  2273
  with target-specific serializations; omitting a serialization
haftmann@37397
  2274
  deletes an existing serialization.
haftmann@37397
  2275
wenzelm@40685
  2276
  \item \hyperlink{command.HOL.code-type}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}type}}}} associates a list of type
haftmann@37397
  2277
  constructors with target-specific serializations; omitting a
haftmann@37397
  2278
  serialization deletes an existing serialization.
haftmann@37397
  2279
wenzelm@40685
  2280
  \item \hyperlink{command.HOL.code-class}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}class}}}} associates a list of classes
haftmann@37397
  2281
  with target-specific class names; omitting a serialization deletes
haftmann@37397
  2282
  an existing serialization.  This applies only to \emph{Haskell}.
haftmann@37397
  2283
wenzelm@40685
  2284
  \item \hyperlink{command.HOL.code-instance}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}instance}}}} declares a list of type
haftmann@37397
  2285
  constructor / class instance relations as ``already present'' for a
wenzelm@40685
  2286
  given target.  Omitting a ``\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{2D}{\isacharminus}}{\isaliteral{22}{\isachardoublequote}}}'' deletes an existing
haftmann@37397
  2287
  ``already present'' declaration.  This applies only to
haftmann@37397
  2288
  \emph{Haskell}.
haftmann@37397
  2289
wenzelm@40685
  2290
  \item \hyperlink{command.HOL.code-reserved}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}reserved}}}} declares a list of names as
haftmann@37397
  2291
  reserved for a given target, preventing it to be shadowed by any
haftmann@37397
  2292
  generated code.
haftmann@37397
  2293
wenzelm@40685
  2294
  \item \hyperlink{command.HOL.code-monad}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}monad}}}} provides an auxiliary mechanism
haftmann@37397
  2295
  to generate monadic code for Haskell.
haftmann@37397
  2296
wenzelm@40685
  2297
  \item \hyperlink{command.HOL.code-include}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}include}}}} adds arbitrary named content
wenzelm@40685
  2298
  (``include'') to generated code.  A ``\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{2D}{\isacharminus}}{\isaliteral{22}{\isachardoublequote}}}'' as last argument
haftmann@37397
  2299
  will remove an already added ``include''.
haftmann@37397
  2300
wenzelm@40685
  2301
  \item \hyperlink{command.HOL.code-modulename}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}modulename}}}} declares aliasings from one
haftmann@37397
  2302
  module name onto another.
haftmann@37397
  2303
wenzelm@40685
  2304
  \item \hyperlink{command.HOL.code-reflect}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}reflect}}}} without a ``\isa{{\isaliteral{22}{\isachardoublequote}}file{\isaliteral{22}{\isachardoublequote}}}''
haftmann@39832
  2305
  argument compiles code into the system runtime environment and
haftmann@39832
  2306
  modifies the code generator setup that future invocations of system
wenzelm@40685
  2307
  runtime code generation referring to one of the ``\isa{{\isaliteral{22}{\isachardoublequote}}datatypes{\isaliteral{22}{\isachardoublequote}}}'' or ``\isa{{\isaliteral{22}{\isachardoublequote}}functions{\isaliteral{22}{\isachardoublequote}}}'' entities use these precompiled
wenzelm@40685
  2308
  entities.  With a ``\isa{{\isaliteral{22}{\isachardoublequote}}file{\isaliteral{22}{\isachardoublequote}}}'' argument, the corresponding code
haftmann@39832
  2309
  is generated into that specified file without modifying the code
haftmann@39832
  2310
  generator setup.
haftmann@39832
  2311
wenzelm@43498
  2312
  \end{description}%
wenzelm@43498
  2313
\end{isamarkuptext}%
wenzelm@43498
  2314
\isamarkuptrue%
wenzelm@43498
  2315
%
wenzelm@43498
  2316
\isamarkupsubsection{The old code generator (S. Berghofer)%
wenzelm@43498
  2317
}
wenzelm@43498
  2318
\isamarkuptrue%
wenzelm@43498
  2319
%
wenzelm@43498
  2320
\begin{isamarkuptext}%
wenzelm@43498
  2321
This framework generates code from both functional and
wenzelm@43498
  2322
  relational programs to SML, as explained below.
wenzelm@26849
  2323
wenzelm@26849
  2324
  \begin{matharray}{rcl}
wenzelm@43498
  2325
    \indexdef{}{command}{code\_module}\hypertarget{command.code-module}{\hyperlink{command.code-module}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}module}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@43498
  2326
    \indexdef{}{command}{code\_library}\hypertarget{command.code-library}{\hyperlink{command.code-library}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}library}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@43498
  2327
    \indexdef{}{command}{consts\_code}\hypertarget{command.consts-code}{\hyperlink{command.consts-code}{\mbox{\isa{\isacommand{consts{\isaliteral{5F}{\isacharunderscore}}code}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@43498
  2328
    \indexdef{}{command}{types\_code}\hypertarget{command.types-code}{\hyperlink{command.types-code}{\mbox{\isa{\isacommand{types{\isaliteral{5F}{\isacharunderscore}}code}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ theory{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@43497
  2329
    \indexdef{}{attribute}{code}\hypertarget{attribute.code}{\hyperlink{attribute.code}{\mbox{\isa{code}}}} & : & \isa{attribute} \\
wenzelm@26849
  2330
  \end{matharray}
wenzelm@26849
  2331
wenzelm@43467
  2332
  \begin{railoutput}
wenzelm@43535
  2333
\rail@begin{11}{}
wenzelm@43467
  2334
\rail@bar
wenzelm@43498
  2335
\rail@term{\hyperlink{command.code-module}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}module}}}}}[]
wenzelm@43467
  2336
\rail@nextbar{1}
wenzelm@43498
  2337
\rail@term{\hyperlink{command.code-library}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}library}}}}}[]
wenzelm@43467
  2338
\rail@endbar
wenzelm@43467
  2339
\rail@bar
wenzelm@43467
  2340
\rail@nextbar{1}
wenzelm@43467
  2341
\rail@nont{\isa{modespec}}[]
wenzelm@43467
  2342
\rail@endbar
wenzelm@43467
  2343
\rail@bar
wenzelm@43467
  2344
\rail@nextbar{1}
wenzelm@43467
  2345
\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
  2346
\rail@endbar
wenzelm@43467
  2347
\rail@cr{3}
wenzelm@43467
  2348
\rail@bar
wenzelm@43467
  2349
\rail@nextbar{4}
wenzelm@43467
  2350
\rail@term{\isa{\isakeyword{file}}}[]
wenzelm@43467
  2351
\rail@nont{\isa{name}}[]
wenzelm@43467
  2352
\rail@endbar
wenzelm@43467
  2353
\rail@bar
wenzelm@43467
  2354
\rail@nextbar{4}
wenzelm@43467
  2355
\rail@term{\isa{\isakeyword{imports}}}[]
wenzelm@43467
  2356
\rail@plus
wenzelm@43467
  2357
\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
  2358
\rail@nextplus{5}
wenzelm@43467
  2359
\rail@endplus
wenzelm@43467
  2360
\rail@endbar
wenzelm@43467
  2361
\rail@cr{7}
wenzelm@43467
  2362
\rail@term{\isa{\isakeyword{contains}}}[]
wenzelm@43467
  2363
\rail@bar
wenzelm@43467
  2364
\rail@plus
wenzelm@43467
  2365
\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
  2366
\rail@term{\isa{{\isaliteral{3D}{\isacharequal}}}}[]
wenzelm@43467
  2367
\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]
wenzelm@43467
  2368
\rail@nextplus{8}
wenzelm@43467
  2369
\rail@endplus
wenzelm@43467
  2370
\rail@nextbar{9}
wenzelm@43467
  2371
\rail@plus
wenzelm@43467
  2372
\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]
wenzelm@43467
  2373
\rail@nextplus{10}
wenzelm@43467
  2374
\rail@endplus
wenzelm@43467
  2375
\rail@endbar
wenzelm@43467
  2376
\rail@end
wenzelm@43467
  2377
\rail@begin{2}{\isa{modespec}}
wenzelm@43467
  2378
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
  2379
\rail@plus
wenzelm@43467
  2380
\rail@nextplus{1}
wenzelm@43467
  2381
\rail@cnont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
  2382
\rail@endplus
wenzelm@43467
  2383
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
  2384
\rail@end
wenzelm@43535
  2385
\rail@begin{2}{}
wenzelm@43467
  2386
\rail@term{\hyperlink{command.HOL.consts-code}{\mbox{\isa{\isacommand{consts{\isaliteral{5F}{\isacharunderscore}}code}}}}}[]
wenzelm@43467
  2387
\rail@plus
wenzelm@43467
  2388
\rail@nont{\isa{codespec}}[]
wenzelm@43467
  2389
\rail@nextplus{1}
wenzelm@43467
  2390
\rail@endplus
wenzelm@43467
  2391
\rail@end
wenzelm@43467
  2392
\rail@begin{2}{\isa{codespec}}
wenzelm@43467
  2393
\rail@nont{\isa{const}}[]
wenzelm@43467
  2394
\rail@nont{\isa{template}}[]
wenzelm@43467
  2395
\rail@bar
wenzelm@43467
  2396
\rail@nextbar{1}
wenzelm@43467
  2397
\rail@nont{\isa{attachment}}[]
wenzelm@43467
  2398
\rail@endbar
wenzelm@43467
  2399
\rail@end
wenzelm@43535
  2400
\rail@begin{2}{}
wenzelm@43467
  2401
\rail@term{\hyperlink{command.HOL.types-code}{\mbox{\isa{\isacommand{types{\isaliteral{5F}{\isacharunderscore}}code}}}}}[]
wenzelm@43467
  2402
\rail@plus
wenzelm@43467
  2403
\rail@nont{\isa{tycodespec}}[]
wenzelm@43467
  2404
\rail@nextplus{1}
wenzelm@43467
  2405
\rail@endplus
wenzelm@43467
  2406
\rail@end
wenzelm@43467
  2407
\rail@begin{2}{\isa{tycodespec}}
wenzelm@43467
  2408
\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
  2409
\rail@nont{\isa{template}}[]
wenzelm@43467
  2410
\rail@bar
wenzelm@43467
  2411
\rail@nextbar{1}
wenzelm@43467
  2412
\rail@nont{\isa{attachment}}[]
wenzelm@43467
  2413
\rail@endbar
wenzelm@43467
  2414
\rail@end
wenzelm@43467
  2415
\rail@begin{1}{\isa{const}}
wenzelm@43467
  2416
\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]
wenzelm@43467
  2417
\rail@end
wenzelm@43467
  2418
\rail@begin{1}{\isa{template}}
wenzelm@43467
  2419
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
  2420
\rail@nont{\hyperlink{syntax.string}{\mbox{\isa{string}}}}[]
wenzelm@43467
  2421
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
  2422
\rail@end
wenzelm@43467
  2423
\rail@begin{2}{\isa{attachment}}
wenzelm@43467
  2424
\rail@term{\isa{attach}}[]
wenzelm@43467
  2425
\rail@bar
wenzelm@43467
  2426
\rail@nextbar{1}
wenzelm@43467
  2427
\rail@nont{\isa{modespec}}[]
wenzelm@43467
  2428
\rail@endbar
wenzelm@43467
  2429
\rail@term{\isa{{\isaliteral{7B}{\isacharbraceleft}}}}[]
wenzelm@43467
  2430
\rail@nont{\hyperlink{syntax.text}{\mbox{\isa{text}}}}[]
wenzelm@43467
  2431
\rail@term{\isa{{\isaliteral{7D}{\isacharbraceright}}}}[]
wenzelm@43467
  2432
\rail@end
wenzelm@43535
  2433
\rail@begin{2}{}
wenzelm@43497
  2434
\rail@term{\hyperlink{attribute.code}{\mbox{\isa{code}}}}[]
wenzelm@43467
  2435
\rail@bar
wenzelm@43467
  2436
\rail@nextbar{1}
wenzelm@43467
  2437
\rail@nont{\isa{name}}[]
wenzelm@43467
  2438
\rail@endbar
wenzelm@43467
  2439
\rail@end
wenzelm@43467
  2440
\end{railoutput}%
wenzelm@26849
  2441
\end{isamarkuptext}%
wenzelm@26849
  2442
\isamarkuptrue%
wenzelm@26849
  2443
%
wenzelm@43498
  2444
\isamarkupsubsubsection{Invoking the code generator%
wenzelm@43498
  2445
}
wenzelm@43498
  2446
\isamarkuptrue%
wenzelm@43498
  2447
%
wenzelm@43498
  2448
\begin{isamarkuptext}%
wenzelm@43498
  2449
The code generator is invoked via the \hyperlink{command.code-module}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}module}}}}
wenzelm@43498
  2450
  and \hyperlink{command.code-library}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}library}}}} commands, which correspond to
wenzelm@43498
  2451
  \emph{incremental} and \emph{modular} code generation, respectively.
wenzelm@43498
  2452
wenzelm@43498
  2453
  \begin{description}
wenzelm@43498
  2454
wenzelm@43498
  2455
  \item [Modular] For each theory, an ML structure is generated,
wenzelm@43498
  2456
  containing the code generated from the constants defined in this
wenzelm@43498
  2457
  theory.
wenzelm@43498
  2458
wenzelm@43498
  2459
  \item [Incremental] All the generated code is emitted into the same
wenzelm@43498
  2460
  structure.  This structure may import code from previously generated
wenzelm@43498
  2461
  structures, which can be specified via \hyperlink{keyword.imports}{\mbox{\isa{\isakeyword{imports}}}}.
wenzelm@43498
  2462
  Moreover, the generated structure may also be referred to in later
wenzelm@43498
  2463
  invocations of the code generator.
wenzelm@43498
  2464
wenzelm@43498
  2465
  \end{description}
wenzelm@43498
  2466
wenzelm@43498
  2467
  After the \hyperlink{command.code-module}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}module}}}} and \hyperlink{command.code-library}{\mbox{\isa{\isacommand{code{\isaliteral{5F}{\isacharunderscore}}library}}}}
wenzelm@43498
  2468
  keywords, the user may specify an optional list of ``modes'' in
wenzelm@43498
  2469
  parentheses. These can be used to instruct the code generator to
wenzelm@43498
  2470
  emit additional code for special purposes, e.g.\ functions for
wenzelm@43498
  2471
  converting elements of generated datatypes to Isabelle terms, or
wenzelm@43498
  2472
  test data generators. The list of modes is followed by a module
wenzelm@43498
  2473
  name.  The module name is optional for modular code generation, but
wenzelm@43498
  2474
  must be specified for incremental code generation.
wenzelm@43498
  2475
wenzelm@43498
  2476
  The code can either be written to a file, in which case a file name
wenzelm@43498
  2477
  has to be specified after the \hyperlink{keyword.file}{\mbox{\isa{\isakeyword{file}}}} keyword, or be loaded
wenzelm@43498
  2478
  directly into Isabelle's ML environment. In the latter case, the
wenzelm@43498
  2479
  \hyperlink{command.ML}{\mbox{\isa{\isacommand{ML}}}} theory command can be used to inspect the results
wenzelm@43498
  2480
  interactively, for example.
wenzelm@43498
  2481
wenzelm@43498
  2482
  The terms from which to generate code can be specified after the
wenzelm@43498
  2483
  \hyperlink{keyword.contains}{\mbox{\isa{\isakeyword{contains}}}} keyword, either as a list of bindings, or just
wenzelm@43498
  2484
  as a list of terms. In the latter case, the code generator just
wenzelm@43498
  2485
  produces code for all constants and types occuring in the term, but
wenzelm@43498
  2486
  does not bind the compiled terms to ML identifiers.
wenzelm@43498
  2487
wenzelm@43498
  2488
  Here is an example:%
wenzelm@43498
  2489
\end{isamarkuptext}%
wenzelm@43498
  2490
\isamarkuptrue%
wenzelm@43498
  2491
\isacommand{code{\isaliteral{5F}{\isacharunderscore}}module}\isamarkupfalse%
wenzelm@43498
  2492
\ Test\isanewline
wenzelm@43523
  2493
\isakeyword{contains}\ test\ {\isaliteral{3D}{\isacharequal}}\ {\isaliteral{22}{\isachardoublequoteopen}}foldl\ op\ {\isaliteral{2B}{\isacharplus}}\ {\isaliteral{28}{\isacharparenleft}}{\isadigit{0}}\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ int{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{5B}{\isacharbrackleft}}{\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isadigit{2}}{\isaliteral{2C}{\isacharcomma}}\ {\isadigit{3}}{\isaliteral{2C}{\isacharcomma}}\ {\isadigit{4}}{\isaliteral{2C}{\isacharcomma}}\ {\isadigit{5}}{\isaliteral{5D}{\isacharbrackright}}{\isaliteral{22}{\isachardoublequoteclose}}%
wenzelm@43498
  2494
\begin{isamarkuptext}%
wenzelm@43498
  2495
\noindent This binds the result of compiling the given term to
wenzelm@43498
  2496
  the ML identifier \verb|Test.test|.%
wenzelm@43498
  2497
\end{isamarkuptext}%
wenzelm@43498
  2498
\isamarkuptrue%
wenzelm@43498
  2499
%
wenzelm@43498
  2500
\isadelimML
wenzelm@43498
  2501
%
wenzelm@43498
  2502
\endisadelimML
wenzelm@43498
  2503
%
wenzelm@43498
  2504
\isatagML
wenzelm@43498
  2505
\isacommand{ML}\isamarkupfalse%
wenzelm@43498
  2506
\ {\isaliteral{7B2A}{\isacharverbatimopen}}\ %
wenzelm@43498
  2507
\isaantiq
wenzelm@43498
  2508
assert{}%
wenzelm@43498
  2509
\endisaantiq
wenzelm@43498
  2510
\ {\isaliteral{28}{\isacharparenleft}}Test{\isaliteral{2E}{\isachardot}}test\ {\isaliteral{3D}{\isacharequal}}\ {\isadigit{1}}{\isadigit{5}}{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{2A7D}{\isacharverbatimclose}}%
wenzelm@43498
  2511
\endisatagML
wenzelm@43498
  2512
{\isafoldML}%
wenzelm@43498
  2513
%
wenzelm@43498
  2514
\isadelimML
wenzelm@43498
  2515
%
wenzelm@43498
  2516
\endisadelimML
wenzelm@43498
  2517
%
wenzelm@43498
  2518
\isamarkupsubsubsection{Configuring the code generator%
wenzelm@43498
  2519
}
wenzelm@43498
  2520
\isamarkuptrue%
wenzelm@43498
  2521
%
wenzelm@43498
  2522
\begin{isamarkuptext}%
wenzelm@43498
  2523
When generating code for a complex term, the code generator
wenzelm@43498
  2524
  recursively calls itself for all subterms.  When it arrives at a
wenzelm@43498
  2525
  constant, the default strategy of the code generator is to look up
wenzelm@43498
  2526
  its definition and try to generate code for it.  Constants which
wenzelm@43498
  2527
  have no definitions that are immediately executable, may be
wenzelm@43498
  2528
  associated with a piece of ML code manually using the \indexref{}{command}{consts\_code}\hyperlink{command.consts-code}{\mbox{\isa{\isacommand{consts{\isaliteral{5F}{\isacharunderscore}}code}}}} command.  It takes a list whose elements consist of a
wenzelm@43498
  2529
  constant (given in usual term syntax -- an explicit type constraint
wenzelm@43498
  2530
  accounts for overloading), and a mixfix template describing the ML
wenzelm@43498
  2531
  code. The latter is very much the same as the mixfix templates used
wenzelm@43498
  2532
  when declaring new constants.  The most notable difference is that
wenzelm@43498
  2533
  terms may be included in the ML template using antiquotation
wenzelm@43498
  2534
  brackets \verb|{|\verb|*|~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{2E}{\isachardot}}{\isaliteral{2E}{\isachardot}}{\isaliteral{2E}{\isachardot}}{\isaliteral{22}{\isachardoublequote}}}~\verb|*|\verb|}|.
wenzelm@43498
  2535
wenzelm@43498
  2536
  A similar mechanism is available for types: \indexref{}{command}{types\_code}\hyperlink{command.types-code}{\mbox{\isa{\isacommand{types{\isaliteral{5F}{\isacharunderscore}}code}}}} associates type constructors with specific ML code.
wenzelm@43498
  2537
wenzelm@43498
  2538
  For example, the following declarations copied from \verb|~~/src/HOL/Product_Type.thy| describe how the product type of
wenzelm@43498
  2539
  Isabelle/HOL should be compiled to ML.%
wenzelm@43498
  2540
\end{isamarkuptext}%
wenzelm@43498
  2541
\isamarkuptrue%
wenzelm@43498
  2542
\isacommand{typedecl}\isamarkupfalse%
wenzelm@43498
  2543
\ {\isaliteral{28}{\isacharparenleft}}{\isaliteral{27}{\isacharprime}}a{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{27}{\isacharprime}}b{\isaliteral{29}{\isacharparenright}}\ prod\isanewline
wenzelm@43498
  2544
\isacommand{consts}\isamarkupfalse%
wenzelm@43498
  2545
\ Pair\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{22}{\isachardoublequoteopen}}{\isaliteral{27}{\isacharprime}}a\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{27}{\isacharprime}}b\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ {\isaliteral{28}{\isacharparenleft}}{\isaliteral{27}{\isacharprime}}a{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{27}{\isacharprime}}b{\isaliteral{29}{\isacharparenright}}\ prod{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@43498
  2546
\isanewline
wenzelm@43498
  2547
\isacommand{types{\isaliteral{5F}{\isacharunderscore}}code}\isamarkupfalse%
wenzelm@43498
  2548
\ prod\ \ {\isaliteral{28}{\isacharparenleft}}{\isaliteral{22}{\isachardoublequoteopen}}{\isaliteral{28}{\isacharparenleft}}{\isaliteral{5F}{\isacharunderscore}}\ {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{2F}{\isacharslash}}\ {\isaliteral{5F}{\isacharunderscore}}{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequoteclose}}{\isaliteral{29}{\isacharparenright}}\isanewline
wenzelm@43498
  2549
\isacommand{consts{\isaliteral{5F}{\isacharunderscore}}code}\isamarkupfalse%
wenzelm@43498
  2550
\ Pair\ \ {\isaliteral{28}{\isacharparenleft}}{\isaliteral{22}{\isachardoublequoteopen}}{\isaliteral{28}{\isacharparenleft}}{\isaliteral{5F}{\isacharunderscore}}{\isaliteral{2C}{\isacharcomma}}{\isaliteral{2F}{\isacharslash}}\ {\isaliteral{5F}{\isacharunderscore}}{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequoteclose}}{\isaliteral{29}{\isacharparenright}}%
wenzelm@43498
  2551
\begin{isamarkuptext}%
wenzelm@43498
  2552
Sometimes, the code associated with a constant or type may
wenzelm@43498
  2553
  need to refer to auxiliary functions, which have to be emitted when
wenzelm@43498
  2554
  the constant is used. Code for such auxiliary functions can be
wenzelm@43498
  2555
  declared using \hyperlink{keyword.attach}{\mbox{\isa{\isakeyword{attach}}}}. For example, the \isa{wfrec}
wenzelm@43498
  2556
  function can be implemented as follows:%
wenzelm@43498
  2557
\end{isamarkuptext}%
wenzelm@43498
  2558
\isamarkuptrue%
wenzelm@43498
  2559
\isacommand{consts{\isaliteral{5F}{\isacharunderscore}}code}\isamarkupfalse%
wenzelm@43498
  2560
\ wfrec\ \ {\isaliteral{28}{\isacharparenleft}}{\isaliteral{22}{\isachardoublequoteopen}}{\isaliteral{5C3C6D6F64756C653E}{\isasymmodule}}wfrec{\isaliteral{3F}{\isacharquery}}{\isaliteral{22}{\isachardoublequoteclose}}{\isaliteral{29}{\isacharparenright}}\ \ \isanewline
wenzelm@43523
  2561
\isakeyword{attach}\ {\isaliteral{7B2A}{\isacharverbatimopen}}\ fun\ wfrec\ f\ x\ {\isaliteral{3D}{\isacharequal}}\ f\ {\isaliteral{28}{\isacharparenleft}}wfrec\ f{\isaliteral{29}{\isacharparenright}}\ x\ {\isaliteral{2A7D}{\isacharverbatimclose}}%
wenzelm@43498
  2562
\begin{isamarkuptext}%
wenzelm@43498
  2563
If the code containing a call to \isa{wfrec} resides in an
wenzelm@43498
  2564
  ML structure different from the one containing the function
wenzelm@43498
  2565
  definition attached to \isa{wfrec}, the name of the ML structure
wenzelm@43498
  2566
  (followed by a ``\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{2E}{\isachardot}}{\isaliteral{22}{\isachardoublequote}}}'')  is inserted in place of ``\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6D6F64756C653E}{\isasymmodule}}{\isaliteral{22}{\isachardoublequote}}}'' in the above template.  The ``\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3F}{\isacharquery}}{\isaliteral{22}{\isachardoublequote}}}''  means that
wenzelm@43498
  2567
  the code generator should ignore the first argument of \isa{wfrec}, i.e.\ the termination relation, which is usually not
wenzelm@43498
  2568
  executable.
wenzelm@43498
  2569
wenzelm@43498
  2570
  \medskip Another possibility of configuring the code generator is to
wenzelm@43498
  2571
  register theorems to be used for code generation. Theorems can be
wenzelm@43498
  2572
  registered via the \hyperlink{attribute.code}{\mbox{\isa{code}}} attribute. It takes an optional
wenzelm@43498
  2573
  name as an argument, which indicates the format of the
wenzelm@43498
  2574
  theorem. Currently supported formats are equations (this is the
wenzelm@43498
  2575
  default when no name is specified) and horn clauses (this is
wenzelm@43498
  2576
  indicated by the name \texttt{ind}). The left-hand sides of
wenzelm@43498
  2577
  equations may only contain constructors and distinct variables,
wenzelm@43498
  2578
  whereas horn clauses must have the same format as introduction rules
wenzelm@43498
  2579
  of inductive definitions.
wenzelm@43498
  2580
wenzelm@43498
  2581
  The following example specifies three equations from which to
wenzelm@43498
  2582
  generate code for \isa{{\isaliteral{22}{\isachardoublequote}}op\ {\isaliteral{3C}{\isacharless}}{\isaliteral{22}{\isachardoublequote}}} on natural numbers (see also
wenzelm@43498
  2583
  \verb|~~/src/HOL/Nat.thy|).%
wenzelm@43498
  2584
\end{isamarkuptext}%
wenzelm@43498
  2585
\isamarkuptrue%
wenzelm@43498
  2586
\isacommand{lemma}\isamarkupfalse%
wenzelm@43498
  2587
\ {\isaliteral{5B}{\isacharbrackleft}}code{\isaliteral{5D}{\isacharbrackright}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{22}{\isachardoublequoteopen}}{\isaliteral{28}{\isacharparenleft}}Suc\ m\ {\isaliteral{3C}{\isacharless}}\ Suc\ n{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{3D}{\isacharequal}}\ {\isaliteral{28}{\isacharparenleft}}m\ {\isaliteral{3C}{\isacharless}}\ n{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@43498
  2588
\ \ \isakeyword{and}\ {\isaliteral{5B}{\isacharbrackleft}}code{\isaliteral{5D}{\isacharbrackright}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{22}{\isachardoublequoteopen}}{\isaliteral{28}{\isacharparenleft}}{\isaliteral{28}{\isacharparenleft}}n{\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}nat{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{3C}{\isacharless}}\ {\isadigit{0}}{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{3D}{\isacharequal}}\ False{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@43498
  2589
\ \ \isakeyword{and}\ {\isaliteral{5B}{\isacharbrackleft}}code{\isaliteral{5D}{\isacharbrackright}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{22}{\isachardoublequoteopen}}{\isaliteral{28}{\isacharparenleft}}{\isadigit{0}}\ {\isaliteral{3C}{\isacharless}}\ Suc\ n{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{3D}{\isacharequal}}\ True{\isaliteral{22}{\isachardoublequoteclose}}%
wenzelm@43498
  2590
\isadelimproof
wenzelm@43498
  2591
\ %
wenzelm@43498
  2592
\endisadelimproof
wenzelm@43498
  2593
%
wenzelm@43498
  2594
\isatagproof
wenzelm@43498
  2595
\isacommand{by}\isamarkupfalse%
wenzelm@43498
  2596
\ simp{\isaliteral{5F}{\isacharunderscore}}all%
wenzelm@43498
  2597
\endisatagproof
wenzelm@43498
  2598
{\isafoldproof}%
wenzelm@43498
  2599
%
wenzelm@43498
  2600
\isadelimproof
wenzelm@43498
  2601
%
wenzelm@43498
  2602
\endisadelimproof
wenzelm@43498
  2603
%
wenzelm@43498
  2604
\isamarkupsubsubsection{Specific HOL code generators%
wenzelm@43498
  2605
}
wenzelm@43498
  2606
\isamarkuptrue%
wenzelm@43498
  2607
%
wenzelm@43498
  2608
\begin{isamarkuptext}%
wenzelm@43498
  2609
The basic code generator framework offered by Isabelle/Pure
wenzelm@43498
  2610
  has already been extended with additional code generators for
wenzelm@43498
  2611
  specific HOL constructs. These include datatypes, recursive
wenzelm@43498
  2612
  functions and inductive relations. The code generator for inductive
wenzelm@43498
  2613
  relations can handle expressions of the form \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{28}{\isacharparenleft}}t\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}{\isaliteral{2C}{\isacharcomma}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{2C}{\isacharcomma}}\ t\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{5C3C696E3E}{\isasymin}}\ r{\isaliteral{22}{\isachardoublequote}}}, where \isa{{\isaliteral{22}{\isachardoublequote}}r{\isaliteral{22}{\isachardoublequote}}} is an inductively defined relation. If at
wenzelm@43498
  2614
  least one of the \isa{{\isaliteral{22}{\isachardoublequote}}t\isaliteral{5C3C5E7375623E}{}\isactrlsub i{\isaliteral{22}{\isachardoublequote}}} is a dummy pattern ``\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5F}{\isacharunderscore}}{\isaliteral{22}{\isachardoublequote}}}'',
wenzelm@43498
  2615
  the above expression evaluates to a sequence of possible answers. If
wenzelm@43498
  2616
  all of the \isa{{\isaliteral{22}{\isachardoublequote}}t\isaliteral{5C3C5E7375623E}{}\isactrlsub i{\isaliteral{22}{\isachardoublequote}}} are proper terms, the expression evaluates
wenzelm@43498
  2617
  to a boolean value.
wenzelm@43498
  2618
wenzelm@43523
  2619
  The following example demonstrates this for beta-reduction on lambda
wenzelm@43523
  2620
  terms (see also \verb|~~/src/HOL/Proofs/Lambda/Lambda.thy|).%
wenzelm@43523
  2621
\end{isamarkuptext}%
wenzelm@43523
  2622
\isamarkuptrue%
wenzelm@43523
  2623
\isacommand{datatype}\isamarkupfalse%
wenzelm@43523
  2624
\ dB\ {\isaliteral{3D}{\isacharequal}}\isanewline
wenzelm@43523
  2625
\ \ \ \ Var\ nat\isanewline
wenzelm@43523
  2626
\ \ {\isaliteral{7C}{\isacharbar}}\ App\ dB\ dB\ \ {\isaliteral{28}{\isacharparenleft}}\isakeyword{infixl}\ {\isaliteral{22}{\isachardoublequoteopen}}{\isaliteral{5C3C6465677265653E}{\isasymdegree}}{\isaliteral{22}{\isachardoublequoteclose}}\ {\isadigit{2}}{\isadigit{0}}{\isadigit{0}}{\isaliteral{29}{\isacharparenright}}\isanewline
wenzelm@43523
  2627
\ \ {\isaliteral{7C}{\isacharbar}}\ Abs\ dB\isanewline
wenzelm@43523
  2628
\isanewline
wenzelm@43523
  2629
\isacommand{primrec}\isamarkupfalse%
wenzelm@43523
  2630
\ lift\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{22}{\isachardoublequoteopen}}dB\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ nat\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ dB{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@43523
  2631
\isakeyword{where}\isanewline
wenzelm@43523
  2632
\ \ \ \ {\isaliteral{22}{\isachardoublequoteopen}}lift\ {\isaliteral{28}{\isacharparenleft}}Var\ i{\isaliteral{29}{\isacharparenright}}\ k\ {\isaliteral{3D}{\isacharequal}}\ {\isaliteral{28}{\isacharparenleft}}if\ i\ {\isaliteral{3C}{\isacharless}}\ k\ then\ Var\ i\ else\ Var\ {\isaliteral{28}{\isacharparenleft}}i\ {\isaliteral{2B}{\isacharplus}}\ {\isadigit{1}}{\isaliteral{29}{\isacharparenright}}{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@43523
  2633
\ \ {\isaliteral{7C}{\isacharbar}}\ {\isaliteral{22}{\isachardoublequoteopen}}lift\ {\isaliteral{28}{\isacharparenleft}}s\ {\isaliteral{5C3C6465677265653E}{\isasymdegree}}\ t{\isaliteral{29}{\isacharparenright}}\ k\ {\isaliteral{3D}{\isacharequal}}\ lift\ s\ k\ {\isaliteral{5C3C6465677265653E}{\isasymdegree}}\ lift\ t\ k{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@43523
  2634
\ \ {\isaliteral{7C}{\isacharbar}}\ {\isaliteral{22}{\isachardoublequoteopen}}lift\ {\isaliteral{28}{\isacharparenleft}}Abs\ s{\isaliteral{29}{\isacharparenright}}\ k\ {\isaliteral{3D}{\isacharequal}}\ Abs\ {\isaliteral{28}{\isacharparenleft}}lift\ s\ {\isaliteral{28}{\isacharparenleft}}k\ {\isaliteral{2B}{\isacharplus}}\ {\isadigit{1}}{\isaliteral{29}{\isacharparenright}}{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@43523
  2635
\isanewline
wenzelm@43523
  2636
\isacommand{primrec}\isamarkupfalse%
wenzelm@43523
  2637
\ subst\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{22}{\isachardoublequoteopen}}dB\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ dB\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ nat\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ dB{\isaliteral{22}{\isachardoublequoteclose}}\ \ {\isaliteral{28}{\isacharparenleft}}{\isaliteral{22}{\isachardoublequoteopen}}{\isaliteral{5F}{\isacharunderscore}}{\isaliteral{5B}{\isacharbrackleft}}{\isaliteral{5F}{\isacharunderscore}}{\isaliteral{27}{\isacharprime}}{\isaliteral{2F}{\isacharslash}}{\isaliteral{5F}{\isacharunderscore}}{\isaliteral{5D}{\isacharbrackright}}{\isaliteral{22}{\isachardoublequoteclose}}\ {\isaliteral{5B}{\isacharbrackleft}}{\isadigit{3}}{\isadigit{0}}{\isadigit{0}}{\isaliteral{2C}{\isacharcomma}}\ {\isadigit{0}}{\isaliteral{2C}{\isacharcomma}}\ {\isadigit{0}}{\isaliteral{5D}{\isacharbrackright}}\ {\isadigit{3}}{\isadigit{0}}{\isadigit{0}}{\isaliteral{29}{\isacharparenright}}\isanewline
wenzelm@43523
  2638
\isakeyword{where}\isanewline
wenzelm@43523
  2639
\ \ \ \ {\isaliteral{22}{\isachardoublequoteopen}}{\isaliteral{28}{\isacharparenleft}}Var\ i{\isaliteral{29}{\isacharparenright}}{\isaliteral{5B}{\isacharbrackleft}}s{\isaliteral{2F}{\isacharslash}}k{\isaliteral{5D}{\isacharbrackright}}\ {\isaliteral{3D}{\isacharequal}}\isanewline
wenzelm@43523
  2640
\ \ \ \ \ \ {\isaliteral{28}{\isacharparenleft}}if\ k\ {\isaliteral{3C}{\isacharless}}\ i\ then\ Var\ {\isaliteral{28}{\isacharparenleft}}i\ {\isaliteral{2D}{\isacharminus}}\ {\isadigit{1}}{\isaliteral{29}{\isacharparenright}}\ else\ if\ i\ {\isaliteral{3D}{\isacharequal}}\ k\ then\ s\ else\ Var\ i{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@43523
  2641
\ \ {\isaliteral{7C}{\isacharbar}}\ {\isaliteral{22}{\isachardoublequoteopen}}{\isaliteral{28}{\isacharparenleft}}t\ {\isaliteral{5C3C6465677265653E}{\isasymdegree}}\ u{\isaliteral{29}{\isacharparenright}}{\isaliteral{5B}{\isacharbrackleft}}s{\isaliteral{2F}{\isacharslash}}k{\isaliteral{5D}{\isacharbrackright}}\ {\isaliteral{3D}{\isacharequal}}\ t{\isaliteral{5B}{\isacharbrackleft}}s{\isaliteral{2F}{\isacharslash}}k{\isaliteral{5D}{\isacharbrackright}}\ {\isaliteral{5C3C6465677265653E}{\isasymdegree}}\ u{\isaliteral{5B}{\isacharbrackleft}}s{\isaliteral{2F}{\isacharslash}}k{\isaliteral{5D}{\isacharbrackright}}{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@43523
  2642
\ \ {\isaliteral{7C}{\isacharbar}}\ {\isaliteral{22}{\isachardoublequoteopen}}{\isaliteral{28}{\isacharparenleft}}Abs\ t{\isaliteral{29}{\isacharparenright}}{\isaliteral{5B}{\isacharbrackleft}}s{\isaliteral{2F}{\isacharslash}}k{\isaliteral{5D}{\isacharbrackright}}\ {\isaliteral{3D}{\isacharequal}}\ Abs\ {\isaliteral{28}{\isacharparenleft}}t{\isaliteral{5B}{\isacharbrackleft}}lift\ s\ {\isadigit{0}}\ {\isaliteral{2F}{\isacharslash}}\ k{\isaliteral{2B}{\isacharplus}}{\isadigit{1}}{\isaliteral{5D}{\isacharbrackright}}{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@43523
  2643
\isanewline
wenzelm@43523
  2644
\isacommand{inductive}\isamarkupfalse%
wenzelm@43523
  2645
\ beta\ {\isaliteral{3A}{\isacharcolon}}{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{22}{\isachardoublequoteopen}}dB\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ dB\ {\isaliteral{5C3C52696768746172726F773E}{\isasymRightarrow}}\ bool{\isaliteral{22}{\isachardoublequoteclose}}\ \ {\isaliteral{28}{\isacharparenleft}}\isakeyword{infixl}\ {\isaliteral{22}{\isachardoublequoteopen}}{\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isaliteral{5C3C626574613E}{\isasymbeta}}{\isaliteral{22}{\isachardoublequoteclose}}\ {\isadigit{5}}{\isadigit{0}}{\isaliteral{29}{\isacharparenright}}\isanewline
wenzelm@43523
  2646
\isakeyword{where}\isanewline
wenzelm@43523
  2647
\ \ \ \ beta{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{22}{\isachardoublequoteopen}}Abs\ s\ {\isaliteral{5C3C6465677265653E}{\isasymdegree}}\ t\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isaliteral{5C3C626574613E}{\isasymbeta}}\ s{\isaliteral{5B}{\isacharbrackleft}}t{\isaliteral{2F}{\isacharslash}}{\isadigit{0}}{\isaliteral{5D}{\isacharbrackright}}{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@43523
  2648
\ \ {\isaliteral{7C}{\isacharbar}}\ appL{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{22}{\isachardoublequoteopen}}s\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isaliteral{5C3C626574613E}{\isasymbeta}}\ t\ {\isaliteral{5C3C4C6F6E6772696768746172726F773E}{\isasymLongrightarrow}}\ s\ {\isaliteral{5C3C6465677265653E}{\isasymdegree}}\ u\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isaliteral{5C3C626574613E}{\isasymbeta}}\ t\ {\isaliteral{5C3C6465677265653E}{\isasymdegree}}\ u{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@43523
  2649
\ \ {\isaliteral{7C}{\isacharbar}}\ appR{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{22}{\isachardoublequoteopen}}s\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isaliteral{5C3C626574613E}{\isasymbeta}}\ t\ {\isaliteral{5C3C4C6F6E6772696768746172726F773E}{\isasymLongrightarrow}}\ u\ {\isaliteral{5C3C6465677265653E}{\isasymdegree}}\ s\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isaliteral{5C3C626574613E}{\isasymbeta}}\ u\ {\isaliteral{5C3C6465677265653E}{\isasymdegree}}\ t{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@43523
  2650
\ \ {\isaliteral{7C}{\isacharbar}}\ abs{\isaliteral{3A}{\isacharcolon}}\ {\isaliteral{22}{\isachardoublequoteopen}}s\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isaliteral{5C3C626574613E}{\isasymbeta}}\ t\ {\isaliteral{5C3C4C6F6E6772696768746172726F773E}{\isasymLongrightarrow}}\ Abs\ s\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isaliteral{5C3C626574613E}{\isasymbeta}}\ Abs\ t{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@43523
  2651
\isanewline
wenzelm@43523
  2652
\isacommand{code{\isaliteral{5F}{\isacharunderscore}}module}\isamarkupfalse%
wenzelm@43523
  2653
\ Test\isanewline
wenzelm@43523
  2654
\isakeyword{contains}\isanewline
wenzelm@43523
  2655
\ \ test{\isadigit{1}}\ {\isaliteral{3D}{\isacharequal}}\ {\isaliteral{22}{\isachardoublequoteopen}}Abs\ {\isaliteral{28}{\isacharparenleft}}Var\ {\isadigit{0}}{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{5C3C6465677265653E}{\isasymdegree}}\ Var\ {\isadigit{0}}\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isaliteral{5C3C626574613E}{\isasymbeta}}\ Var\ {\isadigit{0}}{\isaliteral{22}{\isachardoublequoteclose}}\isanewline
wenzelm@43523
  2656
\ \ test{\isadigit{2}}\ {\isaliteral{3D}{\isacharequal}}\ {\isaliteral{22}{\isachardoublequoteopen}}Abs\ {\isaliteral{28}{\isacharparenleft}}Abs\ {\isaliteral{28}{\isacharparenleft}}Var\ {\isadigit{0}}\ {\isaliteral{5C3C6465677265653E}{\isasymdegree}}\ Var\ {\isadigit{0}}{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{5C3C6465677265653E}{\isasymdegree}}\ {\isaliteral{28}{\isacharparenleft}}Abs\ {\isaliteral{28}{\isacharparenleft}}Var\ {\isadigit{0}}{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{5C3C6465677265653E}{\isasymdegree}}\ Var\ {\isadigit{0}}{\isaliteral{29}{\isacharparenright}}{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isaliteral{5C3C626574613E}{\isasymbeta}}\ {\isaliteral{5F}{\isacharunderscore}}{\isaliteral{22}{\isachardoublequoteclose}}%
wenzelm@43523
  2657
\begin{isamarkuptext}%
wenzelm@43523
  2658
In the above example, \verb|Test.test1| evaluates to a boolean,
wenzelm@43523
  2659
  whereas \verb|Test.test2| is a lazy sequence whose elements can be
wenzelm@43523
  2660
  inspected separately.%
wenzelm@43523
  2661
\end{isamarkuptext}%
wenzelm@43523
  2662
\isamarkuptrue%
wenzelm@43523
  2663
%
wenzelm@43523
  2664
\isadelimML
wenzelm@43523
  2665
%
wenzelm@43523
  2666
\endisadelimML
wenzelm@43523
  2667
%
wenzelm@43523
  2668
\isatagML
wenzelm@43523
  2669
\isacommand{ML}\isamarkupfalse%
wenzelm@43523
  2670
\ {\isaliteral{7B2A}{\isacharverbatimopen}}\ %
wenzelm@43523
  2671
\isaantiq
wenzelm@43523
  2672
assert{}%
wenzelm@43523
  2673
\endisaantiq
wenzelm@43523
  2674
\ Test{\isaliteral{2E}{\isachardot}}test{\isadigit{1}}\ {\isaliteral{2A7D}{\isacharverbatimclose}}\isanewline
wenzelm@43523
  2675
\isacommand{ML}\isamarkupfalse%
wenzelm@43523
  2676
\ {\isaliteral{7B2A}{\isacharverbatimopen}}\ val\ results\ {\isaliteral{3D}{\isacharequal}}\ DSeq{\isaliteral{2E}{\isachardot}}list{\isaliteral{5F}{\isacharunderscore}}of\ Test{\isaliteral{2E}{\isachardot}}test{\isadigit{2}}\ {\isaliteral{2A7D}{\isacharverbatimclose}}\isanewline
wenzelm@43523
  2677
\isacommand{ML}\isamarkupfalse%
wenzelm@43523
  2678
\ {\isaliteral{7B2A}{\isacharverbatimopen}}\ %
wenzelm@43523
  2679
\isaantiq
wenzelm@43523
  2680
assert{}%
wenzelm@43523
  2681
\endisaantiq
wenzelm@43523
  2682
\ {\isaliteral{28}{\isacharparenleft}}length\ results\ {\isaliteral{3D}{\isacharequal}}\ {\isadigit{2}}{\isaliteral{29}{\isacharparenright}}\ {\isaliteral{2A7D}{\isacharverbatimclose}}%
wenzelm@43523
  2683
\endisatagML
wenzelm@43523
  2684
{\isafoldML}%
wenzelm@43523
  2685
%
wenzelm@43523
  2686
\isadelimML
wenzelm@43523
  2687
%
wenzelm@43523
  2688
\endisadelimML
wenzelm@43523
  2689
%
wenzelm@43523
  2690
\begin{isamarkuptext}%
wenzelm@43523
  2691
\medskip The theory underlying the HOL code generator is described
wenzelm@43498
  2692
  more detailed in \cite{Berghofer-Nipkow:2002}. More examples that
wenzelm@43498
  2693
  illustrate the usage of the code generator can be found e.g.\ in
wenzelm@43498
  2694
  \verb|~~/src/HOL/MicroJava/J/JListExample.thy| and \verb|~~/src/HOL/MicroJava/JVM/JVMListExample.thy|.%
wenzelm@43498
  2695
\end{isamarkuptext}%
wenzelm@43498
  2696
\isamarkuptrue%
wenzelm@43498
  2697
%
wenzelm@27047
  2698
\isamarkupsection{Definition by specification \label{sec:hol-specification}%
wenzelm@27047
  2699
}
wenzelm@27047
  2700
\isamarkuptrue%
wenzelm@27047
  2701
%
wenzelm@27047
  2702
\begin{isamarkuptext}%
wenzelm@27047
  2703
\begin{matharray}{rcl}
wenzelm@40685
  2704
    \indexdef{HOL}{command}{specification}\hypertarget{command.HOL.specification}{\hyperlink{command.HOL.specification}{\mbox{\isa{\isacommand{specification}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ proof{\isaliteral{28}{\isacharparenleft}}prove{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@40685
  2705
    \indexdef{HOL}{command}{ax\_specification}\hypertarget{command.HOL.ax-specification}{\hyperlink{command.HOL.ax-specification}{\mbox{\isa{\isacommand{ax{\isaliteral{5F}{\isacharunderscore}}specification}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ proof{\isaliteral{28}{\isacharparenleft}}prove{\isaliteral{29}{\isacharparenright}}{\isaliteral{22}{\isachardoublequote}}} \\
wenzelm@27047
  2706
  \end{matharray}
wenzelm@27047
  2707
wenzelm@43467
  2708
  \begin{railoutput}
wenzelm@43535
  2709
\rail@begin{6}{}
wenzelm@43467
  2710
\rail@bar
wenzelm@43467
  2711
\rail@term{\hyperlink{command.HOL.specification}{\mbox{\isa{\isacommand{specification}}}}}[]
wenzelm@43467
  2712
\rail@nextbar{1}
wenzelm@43467
  2713
\rail@term{\hyperlink{command.HOL.ax-specification}{\mbox{\isa{\isacommand{ax{\isaliteral{5F}{\isacharunderscore}}specification}}}}}[]
wenzelm@43467
  2714
\rail@endbar
wenzelm@43467
  2715
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
  2716
\rail@plus
wenzelm@43467
  2717
\rail@nont{\isa{decl}}[]
wenzelm@43467
  2718
\rail@nextplus{1}
wenzelm@43467
  2719
\rail@endplus
wenzelm@43467
  2720
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
  2721
\rail@cr{3}
wenzelm@43467
  2722
\rail@plus
wenzelm@43467
  2723
\rail@bar
wenzelm@43467
  2724
\rail@nextbar{4}
wenzelm@43467
  2725
\rail@nont{\hyperlink{syntax.thmdecl}{\mbox{\isa{thmdecl}}}}[]
wenzelm@43467
  2726
\rail@endbar
wenzelm@43467
  2727
\rail@nont{\hyperlink{syntax.prop}{\mbox{\isa{prop}}}}[]
wenzelm@43467
  2728
\rail@nextplus{5}
wenzelm@43467
  2729
\rail@endplus
wenzelm@43467
  2730
\rail@end
wenzelm@43467
  2731
\rail@begin{2}{\isa{decl}}
wenzelm@43467
  2732
\rail@bar
wenzelm@43467
  2733
\rail@nextbar{1}
wenzelm@43467
  2734
\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]
wenzelm@43467
  2735
\rail@term{\isa{{\isaliteral{3A}{\isacharcolon}}}}[]
wenzelm@43467
  2736
\rail@endbar
wenzelm@43467
  2737
\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]
wenzelm@43467
  2738
\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]
wenzelm@43467
  2739
\rail@term{\isa{\isakeyword{overloaded}}}[]
wenzelm@43467
  2740
\rail@bar
wenzelm@43467
  2741
\rail@nextbar{1}
wenzelm@43467
  2742
\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]
wenzelm@43467
  2743
\rail@endbar
wenzelm@43467
  2744
\rail@end
wenzelm@43467
  2745
\end{railoutput}
wenzelm@43467
  2746
wenzelm@27047
  2747
wenzelm@28788
  2748
  \begin{description}
wenzelm@27047
  2749
wenzelm@40685
  2750
  \item \hyperlink{command.HOL.specification}{\mbox{\isa{\isacommand{specification}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}decls\ {\isaliteral{5C3C7068693E}{\isasymphi}}{\isaliteral{22}{\isachardoublequote}}} sets up a
wenzelm@27047
  2751
  goal stating the existence of terms with the properties specified to
wenzelm@27047
  2752
  hold for the constants given in \isa{decls}.  After finishing the
wenzelm@27047
  2753
  proof, the theory will be augmented with definitions for the given
wenzelm@27047
  2754
  constants, as well as with theorems stating the properties for these
wenzelm@27047
  2755
  constants.
wenzelm@27047
  2756
wenzelm@40685
  2757
  \item \hyperlink{command.HOL.ax-specification}{\mbox{\isa{\isacommand{ax{\isaliteral{5F}{\isacharunderscore}}specification}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}decls\ {\isaliteral{5C3C7068693E}{\isasymphi}}{\isaliteral{22}{\isachardoublequote}}} sets up
wenzelm@28788
  2758
  a goal stating the existence of terms with the properties specified
wenzelm@28788
  2759
  to hold for the constants given in \isa{decls}.  After finishing
wenzelm@28788
  2760
  the proof, the theory will be augmented with axioms expressing the
wenzelm@28788
  2761
  properties given in the first place.
wenzelm@27047
  2762
wenzelm@28788
  2763
  \item \isa{decl} declares a constant to be defined by the
wenzelm@27047
  2764
  specification given.  The definition for the constant \isa{c} is
wenzelm@40685
  2765
  bound to the name \isa{c{\isaliteral{5F}{\isacharunderscore}}def} unless a theorem name is given in
wenzelm@27047
  2766
  the declaration.  Overloaded constants should be declared as such.
wenzelm@27047
  2767
wenzelm@28788
  2768
  \end{description}
wenzelm@27047
  2769
wenzelm@40685
  2770
  Whether to use \hyperlink{command.HOL.specification}{\mbox{\isa{\isacommand{specification}}}} or \hyperlink{command.HOL.ax-specification}{\mbox{\isa{\isacommand{ax{\isaliteral{5F}{\isacharunderscore}}specification}}}} is to some extent a matter of style.  \hyperlink{command.HOL.specification}{\mbox{\isa{\isacommand{specification}}}} introduces no new axioms, and so by
wenzelm@40685
  2771
  construction cannot introduce inconsistencies, whereas \hyperlink{command.HOL.ax-specification}{\mbox{\isa{\isacommand{ax{\isaliteral{5F}{\isacharunderscore}}specification}}}} does introduce axioms, but only after the
wenzelm@27047
  2772
  user has explicitly proven it to be safe.  A practical issue must be
wenzelm@27047
  2773
  considered, though: After introducing two constants with the same
wenzelm@27047
  2774
  properties using \hyperlink{command.HOL.specification}{\mbox{\isa{\isacommand{specification}}}}, one can prove
wenzelm@27047
  2775
  that the two constants are, in fact, equal.  If this might be a
wenzelm@40685
  2776
  problem, one should use \hyperlink{command.HOL.ax-specification}{\mbox{\isa{\isacommand{ax{\isaliteral{5F}{\isacharunderscore}}specification}}}}.%
wenzelm@27047
  2777
\end{isamarkuptext}%
wenzelm@27047
  2778
\isamarkuptrue%
wenzelm@27047
  2779
%
wenzelm@26849
  2780
\isadelimtheory
wenzelm@26849
  2781
%
wenzelm@26849
  2782
\endisadelimtheory
wenzelm@26849
  2783
%
wenzelm@26849
  2784
\isatagtheory
wenzelm@26840
  2785
\isacommand{end}\isamarkupfalse%
wenzelm@26840
  2786
%
wenzelm@26840
  2787
\endisatagtheory
wenzelm@26840
  2788
{\isafoldtheory}%
wenzelm@26840
  2789
%
wenzelm@26840
  2790
\isadelimtheory
wenzelm@26840
  2791
%
wenzelm@26840
  2792
\endisadelimtheory
wenzelm@26849
  2793
\isanewline
wenzelm@26840
  2794
\end{isabellebody}%
wenzelm@26840
  2795
%%% Local Variables:
wenzelm@26840
  2796
%%% mode: latex
wenzelm@26840
  2797
%%% TeX-master: "root"
wenzelm@26840
  2798
%%% End: