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