doc-src/TutorialI/Types/document/Records.tex
author wenzelm
Mon, 07 Jan 2002 18:58:45 +0100
changeset 12656 efcf26bb1361
parent 12634 3baa6143a9c4
child 12658 3939e7dea202
permissions -rw-r--r--
updated;
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
     1
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
     2
\begin{isabellebody}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
     3
\def\isabellecontext{Records}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
     4
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
     5
\isamarkupheader{Records \label{sec:records}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
     6
}
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
     7
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
     8
\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
     9
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    10
\begin{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    11
\index{records|(}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    12
  Records are familiar from programming languages.  A record of $n$
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    13
  fields is essentially an $n$-tuple, but the record's components have
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    14
  names, which can make expressions easier to read and reduces the
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    15
  risk of confusing one field for another.
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    16
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
    17
  A record of Isabelle/HOL covers a collection of fields, with select
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    18
  and update operations.  Each field has a specified type, which may
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    19
  be polymorphic.  The field names are part of the record type, and
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    20
  the order of the fields is significant --- as it is in Pascal but
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    21
  not in Standard ML.  If two different record types have field names
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    22
  in common, then the ambiguity is resolved in the usual way, by
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    23
  qualified names.
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    24
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    25
  Record types can also be defined by extending other record types.
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    26
  Extensible records make use of the reserved pseudo-field \cdx{more},
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    27
  which is present in every record type.  Generic record operations
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
    28
  work on all possible extensions of a given type scheme; polymorphism
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
    29
  takes care of structural sub-typing behind the scenes.  There are
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
    30
  also explicit coercion functions between fixed record types.%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    31
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    32
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    33
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    34
\isamarkupsubsection{Record Basics%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    35
}
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    36
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    37
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    38
\begin{isamarkuptext}%
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
    39
Record types are not primitive in Isabelle and have a delicate
12656
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
    40
  internal representation \cite{NaraschewskiW-TPHOLs98}, based on
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
    41
  nested copies of the primitive product type.  A \commdx{record}
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
    42
  declaration introduces a new record type scheme by specifying its
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
    43
  fields, which are packaged internally to hold up the perception of
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
    44
  the record as a distinguished entity.  Here is a simply example.%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    45
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    46
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    47
\isacommand{record}\ point\ {\isacharequal}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    48
\ \ Xcoord\ {\isacharcolon}{\isacharcolon}\ int\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    49
\ \ Ycoord\ {\isacharcolon}{\isacharcolon}\ int\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    50
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    51
\begin{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    52
Records of type \isa{point} have two fields named \isa{Xcoord}
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    53
  and \isa{Ycoord}, both of type~\isa{int}.  We now define a
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    54
  constant of type \isa{point}:%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    55
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    56
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    57
\isacommand{constdefs}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    58
\ \ pt{\isadigit{1}}\ {\isacharcolon}{\isacharcolon}\ point\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    59
\ \ {\isachardoublequote}pt{\isadigit{1}}\ {\isasymequiv}\ {\isacharparenleft}{\isacharbar}\ Xcoord\ {\isacharequal}\ {\isadigit{9}}{\isadigit{9}}{\isadigit{9}}{\isacharcomma}\ Ycoord\ {\isacharequal}\ {\isadigit{2}}{\isadigit{3}}\ {\isacharbar}{\isacharparenright}{\isachardoublequote}\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    60
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    61
\begin{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    62
We see above the ASCII notation for record brackets.  You can also
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    63
  use the symbolic brackets \isa{{\isasymlparr}} and \isa{{\isasymrparr}}.  Record type
12656
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
    64
  expressions can be also written directly with individual fields.
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
    65
  The type name above is merely an abbreviations.%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    66
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    67
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    68
\isacommand{constdefs}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    69
\ \ pt{\isadigit{2}}\ {\isacharcolon}{\isacharcolon}\ {\isachardoublequote}{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharcolon}\ int{\isacharcomma}\ Ycoord\ {\isacharcolon}{\isacharcolon}\ int{\isasymrparr}{\isachardoublequote}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    70
\ \ {\isachardoublequote}pt{\isadigit{2}}\ {\isasymequiv}\ {\isasymlparr}Xcoord\ {\isacharequal}\ {\isacharminus}{\isadigit{4}}{\isadigit{5}}{\isacharcomma}\ Ycoord\ {\isacharequal}\ {\isadigit{9}}{\isadigit{7}}{\isasymrparr}{\isachardoublequote}\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    71
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    72
\begin{isamarkuptext}%
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
    73
For each field, there is a \emph{selector}\index{selector!record}
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
    74
  function of the same name.  For example, if \isa{p} has type \isa{point} then \isa{Xcoord\ p} denotes the value of the \isa{Xcoord} field of~\isa{p}.  Expressions involving field selection
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
    75
  of explicit records are simplified automatically:%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    76
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    77
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    78
\isacommand{lemma}\ {\isachardoublequote}Xcoord\ {\isasymlparr}Xcoord\ {\isacharequal}\ a{\isacharcomma}\ Ycoord\ {\isacharequal}\ b{\isasymrparr}\ {\isacharequal}\ a{\isachardoublequote}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    79
\ \ \isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    80
\isacommand{by}\ simp\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    81
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    82
\begin{isamarkuptext}%
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
    83
The \emph{update}\index{update!record} operation is functional.  For
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
    84
  example, \isa{p{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharequal}\ {\isadigit{0}}{\isasymrparr}} is a record whose \isa{Xcoord}
12656
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
    85
  value is zero and whose \isa{Ycoord} value is copied from~\isa{p}.  Updates of explicit records are also simplified automatically:%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    86
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    87
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    88
\isacommand{lemma}\ {\isachardoublequote}{\isasymlparr}Xcoord\ {\isacharequal}\ a{\isacharcomma}\ Ycoord\ {\isacharequal}\ b{\isasymrparr}{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharequal}\ {\isadigit{0}}{\isasymrparr}\ {\isacharequal}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    89
\ \ \ \ {\isasymlparr}Xcoord\ {\isacharequal}\ {\isadigit{0}}{\isacharcomma}\ Ycoord\ {\isacharequal}\ b{\isasymrparr}{\isachardoublequote}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    90
\ \ \isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    91
\isacommand{by}\ simp\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    92
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    93
\begin{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    94
\begin{warn}
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    95
  Field names are declared as constants and can no longer be used as
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    96
  variables.  It would be unwise, for example, to call the fields of
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
    97
  type \isa{point} simply \isa{x} and~\isa{y}.
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    98
  \end{warn}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
    99
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   100
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   101
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   102
\isamarkupsubsection{Extensible Records and Generic Operations%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   103
}
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   104
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   105
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   106
\begin{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   107
\index{records!extensible|(}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   108
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   109
  Now, let us define coloured points (type \isa{cpoint}) to be
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   110
  points extended with a field \isa{col} of type \isa{colour}:%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   111
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   112
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   113
\isacommand{datatype}\ colour\ {\isacharequal}\ Red\ {\isacharbar}\ Green\ {\isacharbar}\ Blue\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   114
\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   115
\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   116
\isacommand{record}\ cpoint\ {\isacharequal}\ point\ {\isacharplus}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   117
\ \ col\ {\isacharcolon}{\isacharcolon}\ colour\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   118
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   119
\begin{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   120
The fields of this new type are \isa{Xcoord}, \isa{Ycoord} and
12656
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
   121
  \isa{col}, in that order.%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   122
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   123
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   124
\isacommand{constdefs}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   125
\ \ cpt{\isadigit{1}}\ {\isacharcolon}{\isacharcolon}\ cpoint\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   126
\ \ {\isachardoublequote}cpt{\isadigit{1}}\ {\isasymequiv}\ {\isasymlparr}Xcoord\ {\isacharequal}\ {\isadigit{9}}{\isadigit{9}}{\isadigit{9}}{\isacharcomma}\ Ycoord\ {\isacharequal}\ {\isadigit{2}}{\isadigit{3}}{\isacharcomma}\ col\ {\isacharequal}\ Green{\isasymrparr}{\isachardoublequote}\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   127
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   128
\begin{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   129
We can define generic operations that work on arbitrary instances of
12656
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
   130
  a record scheme, e.g.\ covering \isa{point}, \isa{cpoint}, and any
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   131
  further extensions.  Every record structure has an implicit
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   132
  pseudo-field, \cdx{more}, that keeps the extension as an explicit
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   133
  value.  Its type is declared as completely polymorphic:~\isa{{\isacharprime}a}.
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   134
  When a fixed record value is expressed using just its standard
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   135
  fields, the value of \isa{more} is implicitly set to \isa{{\isacharparenleft}{\isacharparenright}},
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   136
  the empty tuple, which has type \isa{unit}.  Within the record
12656
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
   137
  brackets, you can refer to the \isa{more} field by writing
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
   138
  ``\isa{{\isasymdots}}'' (three dots):%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   139
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   140
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   141
\isacommand{lemma}\ {\isachardoublequote}Xcoord\ {\isasymlparr}Xcoord\ {\isacharequal}\ a{\isacharcomma}\ Ycoord\ {\isacharequal}\ b{\isacharcomma}\ {\isasymdots}\ {\isacharequal}\ p{\isasymrparr}\ {\isacharequal}\ a{\isachardoublequote}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   142
\ \ \isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   143
\isacommand{by}\ simp\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   144
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   145
\begin{isamarkuptext}%
12656
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
   146
This lemma applies to any record whose first two fields are \isa{Xcoord} and~\isa{Ycoord}.  Note that \isa{{\isasymlparr}Xcoord\ {\isacharequal}\ a{\isacharcomma}\ Ycoord\ {\isacharequal}\ b{\isacharcomma}\ {\isasymdots}\ {\isacharequal}\ {\isacharparenleft}{\isacharparenright}{\isasymrparr}} is exactly the same as \isa{{\isasymlparr}Xcoord\ {\isacharequal}\ a{\isacharcomma}\ Ycoord\ {\isacharequal}\ b{\isasymrparr}}.  Selectors and updates are always polymorphic wrt.\ the
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
   147
  \isa{more} part of a record scheme, its value is just ignored (for
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   148
  select) or copied (for update).
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   149
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   150
  The \isa{more} pseudo-field may be manipulated directly as well,
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   151
  but the identifier needs to be qualified:%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   152
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   153
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   154
\isacommand{lemma}\ {\isachardoublequote}point{\isachardot}more\ cpt{\isadigit{1}}\ {\isacharequal}\ {\isasymlparr}col\ {\isacharequal}\ Green{\isasymrparr}{\isachardoublequote}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   155
\ \ \isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   156
\isacommand{by}\ {\isacharparenleft}simp\ add{\isacharcolon}\ cpt{\isadigit{1}}{\isacharunderscore}def{\isacharparenright}\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   157
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   158
\begin{isamarkuptext}%
12656
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
   159
We see that the colour part attached to this \isa{point} is a
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   160
  (rudimentary) record in its own right, namely \isa{{\isasymlparr}col\ {\isacharequal}\ Green{\isasymrparr}}.  In order to select or update \isa{col}, this fragment
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   161
  needs to be put back into the context of the parent type scheme, say
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   162
  as \isa{more} part of another \isa{point}.
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   163
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   164
  To define generic operations, we need to know a bit more about
12656
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
   165
  records.  Our definition of \isa{point} above has generated two
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
   166
  type abbreviations:
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   167
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   168
  \medskip
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   169
  \begin{tabular}{l}
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   170
  \isa{point}~\isa{{\isacharequal}}~\isa{{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharcolon}\ int{\isacharcomma}\ Ycoord\ {\isacharcolon}{\isacharcolon}\ int{\isasymrparr}} \\
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   171
  \isa{{\isacharprime}a\ point{\isacharunderscore}scheme}~\isa{{\isacharequal}}~\isa{{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharcolon}\ int{\isacharcomma}\ Ycoord\ {\isacharcolon}{\isacharcolon}\ int{\isacharcomma}\ {\isasymdots}\ {\isacharcolon}{\isacharcolon}\ {\isacharprime}a{\isasymrparr}} \\
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   172
  \end{tabular}
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   173
  \medskip
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   174
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   175
  Type \isa{point} is for fixed records having exactly the two fields
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   176
  \isa{Xcoord} and~\isa{Ycoord}, while the polymorphic type \isa{{\isacharprime}a\ point{\isacharunderscore}scheme} comprises all possible extensions to those two
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   177
  fields.  Note that \isa{unit\ point{\isacharunderscore}scheme} coincides with \isa{point}, and \isa{{\isasymlparr}col\ {\isacharcolon}{\isacharcolon}\ colour{\isasymrparr}\ point{\isacharunderscore}scheme} with \isa{cpoint}.
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   178
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   179
  In the following example we define two operations --- methods, if we
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   180
  regard records as objects --- to get and set any point's \isa{Xcoord} field.%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   181
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   182
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   183
\isacommand{constdefs}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   184
\ \ getX\ {\isacharcolon}{\isacharcolon}\ {\isachardoublequote}{\isacharprime}a\ point{\isacharunderscore}scheme\ {\isasymRightarrow}\ int{\isachardoublequote}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   185
\ \ {\isachardoublequote}getX\ r\ {\isasymequiv}\ Xcoord\ r{\isachardoublequote}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   186
\ \ setX\ {\isacharcolon}{\isacharcolon}\ {\isachardoublequote}{\isacharprime}a\ point{\isacharunderscore}scheme\ {\isasymRightarrow}\ int\ {\isasymRightarrow}\ {\isacharprime}a\ point{\isacharunderscore}scheme{\isachardoublequote}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   187
\ \ {\isachardoublequote}setX\ r\ a\ {\isasymequiv}\ r{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharequal}\ a{\isasymrparr}{\isachardoublequote}\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   188
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   189
\begin{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   190
Here is a generic method that modifies a point, incrementing its
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   191
  \isa{Xcoord} field.  The \isa{Ycoord} and \isa{more} fields
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   192
  are copied across.  It works for any record type scheme derived from
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   193
  \isa{point} (including \isa{cpoint} etc.):%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   194
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   195
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   196
\isacommand{constdefs}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   197
\ \ incX\ {\isacharcolon}{\isacharcolon}\ {\isachardoublequote}{\isacharprime}a\ point{\isacharunderscore}scheme\ {\isasymRightarrow}\ {\isacharprime}a\ point{\isacharunderscore}scheme{\isachardoublequote}\isanewline
12656
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
   198
\ \ {\isachardoublequote}incX\ r\ {\isasymequiv}\isanewline
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
   199
\ \ \ \ {\isasymlparr}Xcoord\ {\isacharequal}\ Xcoord\ r\ {\isacharplus}\ {\isadigit{1}}{\isacharcomma}\ Ycoord\ {\isacharequal}\ Ycoord\ r{\isacharcomma}\ {\isasymdots}\ {\isacharequal}\ point{\isachardot}more\ r{\isasymrparr}{\isachardoublequote}\isamarkupfalse%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   200
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   201
\begin{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   202
Generic theorems can be proved about generic methods.  This trivial
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   203
  lemma relates \isa{incX} to \isa{getX} and \isa{setX}:%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   204
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   205
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   206
\isacommand{lemma}\ {\isachardoublequote}incX\ r\ {\isacharequal}\ setX\ r\ {\isacharparenleft}getX\ r\ {\isacharplus}\ {\isadigit{1}}{\isacharparenright}{\isachardoublequote}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   207
\ \ \isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   208
\isacommand{by}\ {\isacharparenleft}simp\ add{\isacharcolon}\ getX{\isacharunderscore}def\ setX{\isacharunderscore}def\ incX{\isacharunderscore}def{\isacharparenright}\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   209
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   210
\begin{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   211
\begin{warn}
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   212
  If you use the symbolic record brackets \isa{{\isasymlparr}} and \isa{{\isasymrparr}},
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   213
  then you must also use the symbolic ellipsis, ``\isa{{\isasymdots}}'', rather
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   214
  than three consecutive periods, ``\isa{{\isachardot}{\isachardot}{\isachardot}}''.  Mixing the ASCII
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   215
  and symbolic versions causes a syntax error.  (The two versions are
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   216
  more distinct on screen than they are on paper.)
12634
3baa6143a9c4 fixed \index;
wenzelm
parents: 12585
diff changeset
   217
  \end{warn}%
3baa6143a9c4 fixed \index;
wenzelm
parents: 12585
diff changeset
   218
  \index{records!extensible|)}%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   219
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   220
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   221
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   222
\isamarkupsubsection{Record Equality%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   223
}
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   224
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   225
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   226
\begin{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   227
Two records are equal\index{equality!of records} if all pairs of
12656
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
   228
  corresponding fields are equal.  Concrete record equalities are
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
   229
  simplified automatically:%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   230
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   231
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   232
\isacommand{lemma}\ {\isachardoublequote}{\isacharparenleft}{\isasymlparr}Xcoord\ {\isacharequal}\ a{\isacharcomma}\ Ycoord\ {\isacharequal}\ b{\isasymrparr}\ {\isacharequal}\ {\isasymlparr}Xcoord\ {\isacharequal}\ a{\isacharprime}{\isacharcomma}\ Ycoord\ {\isacharequal}\ b{\isacharprime}{\isasymrparr}{\isacharparenright}\ {\isacharequal}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   233
\ \ \ \ {\isacharparenleft}a\ {\isacharequal}\ a{\isacharprime}\ {\isasymand}\ b\ {\isacharequal}\ b{\isacharprime}{\isacharparenright}{\isachardoublequote}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   234
\ \ \isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   235
\isacommand{by}\ simp\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   236
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   237
\begin{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   238
The following equality is similar, but generic, in that \isa{r}
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   239
  can be any instance of \isa{{\isacharprime}a\ point{\isacharunderscore}scheme}:%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   240
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   241
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   242
\isacommand{lemma}\ {\isachardoublequote}r{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharequal}\ a{\isacharcomma}\ Ycoord\ {\isacharcolon}{\isacharequal}\ b{\isasymrparr}\ {\isacharequal}\ r{\isasymlparr}Ycoord\ {\isacharcolon}{\isacharequal}\ b{\isacharcomma}\ Xcoord\ {\isacharcolon}{\isacharequal}\ a{\isasymrparr}{\isachardoublequote}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   243
\ \ \isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   244
\isacommand{by}\ simp\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   245
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   246
\begin{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   247
We see above the syntax for iterated updates.  We could equivalently
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   248
  have written the left-hand side as \isa{r{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharequal}\ a{\isasymrparr}{\isasymlparr}Ycoord\ {\isacharcolon}{\isacharequal}\ b{\isasymrparr}}.
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   249
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   250
  \medskip Record equality is \emph{extensional}:
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   251
  \index{extensionality!for records} a record is determined entirely
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   252
  by the values of its fields.%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   253
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   254
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   255
\isacommand{lemma}\ {\isachardoublequote}r\ {\isacharequal}\ {\isasymlparr}Xcoord\ {\isacharequal}\ Xcoord\ r{\isacharcomma}\ Ycoord\ {\isacharequal}\ Ycoord\ r{\isasymrparr}{\isachardoublequote}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   256
\ \ \isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   257
\isacommand{by}\ simp\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   258
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   259
\begin{isamarkuptext}%
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   260
The generic version of this equality includes the pseudo-field
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   261
  \isa{more}:%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   262
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   263
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   264
\isacommand{lemma}\ {\isachardoublequote}r\ {\isacharequal}\ {\isasymlparr}Xcoord\ {\isacharequal}\ Xcoord\ r{\isacharcomma}\ Ycoord\ {\isacharequal}\ Ycoord\ r{\isacharcomma}\ {\isasymdots}\ {\isacharequal}\ point{\isachardot}more\ r{\isasymrparr}{\isachardoublequote}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   265
\ \ \isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   266
\isacommand{by}\ simp\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   267
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   268
\begin{isamarkuptext}%
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   269
\medskip The simplifier can prove many record equalities
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   270
  automatically, but general equality reasoning can be tricky.
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   271
  Consider proving this obvious fact:%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   272
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   273
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   274
\isacommand{lemma}\ {\isachardoublequote}r{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharequal}\ a{\isasymrparr}\ {\isacharequal}\ r{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharequal}\ a{\isacharprime}{\isasymrparr}\ {\isasymLongrightarrow}\ a\ {\isacharequal}\ a{\isacharprime}{\isachardoublequote}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   275
\ \ \isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   276
\isacommand{apply}\ simp{\isacharquery}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   277
\ \ \isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   278
\isacommand{oops}\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   279
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   280
\begin{isamarkuptext}%
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   281
Here the simplifier can do nothing, since general record equality is
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   282
  not eliminated automatically.  One way to proceed is by an explicit
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   283
  forward step that applies the selector \isa{Xcoord} to both sides
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   284
  of the assumed record equality:%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   285
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   286
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   287
\isacommand{lemma}\ {\isachardoublequote}r{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharequal}\ a{\isasymrparr}\ {\isacharequal}\ r{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharequal}\ a{\isacharprime}{\isasymrparr}\ {\isasymLongrightarrow}\ a\ {\isacharequal}\ a{\isacharprime}{\isachardoublequote}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   288
\ \ \isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   289
\isacommand{apply}\ {\isacharparenleft}drule{\isacharunderscore}tac\ f\ {\isacharequal}\ Xcoord\ \isakeyword{in}\ arg{\isacharunderscore}cong{\isacharparenright}\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   290
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   291
\begin{isamarkuptxt}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   292
\begin{isabelle}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   293
\ {\isadigit{1}}{\isachardot}\ Xcoord\ {\isacharparenleft}r{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharequal}\ a{\isasymrparr}{\isacharparenright}\ {\isacharequal}\ Xcoord\ {\isacharparenleft}r{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharequal}\ a{\isacharprime}{\isasymrparr}{\isacharparenright}\ {\isasymLongrightarrow}\ a\ {\isacharequal}\ a{\isacharprime}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   294
\end{isabelle}
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   295
    Now, \isa{simp} will reduce the assumption to the desired
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   296
    conclusion.%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   297
\end{isamarkuptxt}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   298
\ \ \isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   299
\isacommand{apply}\ simp\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   300
\ \ \isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   301
\isacommand{done}\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   302
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   303
\begin{isamarkuptext}%
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   304
The \isa{cases} method is preferable to such a forward proof.  We
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   305
  state the desired lemma again:%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   306
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   307
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   308
\isacommand{lemma}\ {\isachardoublequote}r{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharequal}\ a{\isasymrparr}\ {\isacharequal}\ r{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharequal}\ a{\isacharprime}{\isasymrparr}\ {\isasymLongrightarrow}\ a\ {\isacharequal}\ a{\isacharprime}{\isachardoublequote}\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   309
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   310
\begin{isamarkuptxt}%
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   311
The \methdx{cases} method adds an equality to replace the
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   312
  named record term by an explicit record expression, listing all
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   313
  fields.  It even includes the pseudo-field \isa{more}, since the
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   314
  record equality stated here is generic for all extensions.%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   315
\end{isamarkuptxt}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   316
\ \ \isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   317
\isacommand{apply}\ {\isacharparenleft}cases\ r{\isacharparenright}\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   318
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   319
\begin{isamarkuptxt}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   320
\begin{isabelle}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   321
\ {\isadigit{1}}{\isachardot}\ {\isasymAnd}Xcoord\ Ycoord\ more{\isachardot}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   322
\isaindent{\ {\isadigit{1}}{\isachardot}\ \ \ \ }{\isasymlbrakk}r{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharequal}\ a{\isasymrparr}\ {\isacharequal}\ r{\isasymlparr}Xcoord\ {\isacharcolon}{\isacharequal}\ a{\isacharprime}{\isasymrparr}{\isacharsemicolon}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   323
\isaindent{\ {\isadigit{1}}{\isachardot}\ \ \ \ \ \ \ }r\ {\isacharequal}\ {\isasymlparr}Xcoord\ {\isacharequal}\ Xcoord{\isacharcomma}\ Ycoord\ {\isacharequal}\ Ycoord{\isacharcomma}\ {\isasymdots}\ {\isacharequal}\ more{\isasymrparr}{\isasymrbrakk}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   324
\isaindent{\ {\isadigit{1}}{\isachardot}\ \ \ \ }{\isasymLongrightarrow}\ a\ {\isacharequal}\ a{\isacharprime}%
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   325
\end{isabelle} Again, \isa{simp} finishes the proof.  Because \isa{r} is now represented as
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   326
  an explicit record construction, the updates can be applied and the
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   327
  record equality can be replaced by equality of the corresponding
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   328
  fields (due to injectivity).%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   329
\end{isamarkuptxt}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   330
\ \ \isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   331
\isacommand{apply}\ simp\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   332
\ \ \isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   333
\isacommand{done}\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   334
%
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   335
\begin{isamarkuptext}%
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   336
The generic cases method does not admit references to locally bound
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   337
  parameters of a goal.  In longer proof scripts one might have to
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   338
  fall back on the primitive \isa{rule{\isacharunderscore}tac} used together with the
12656
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
   339
  internal field representation rules of records.  E.g.\ the above use
efcf26bb1361 updated;
wenzelm
parents: 12634
diff changeset
   340
  of \isa{{\isacharparenleft}cases\ r{\isacharparenright}} would become \isa{{\isacharparenleft}rule{\isacharunderscore}tac\ r\ {\isacharequal}\ r\ in\ point{\isachardot}cases{\isacharunderscore}scheme{\isacharparenright}}.%
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   341
\end{isamarkuptext}%
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   342
\isamarkuptrue%
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   343
%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   344
\isamarkupsubsection{Extending and Truncating Records%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   345
}
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   346
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   347
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   348
\begin{isamarkuptext}%
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   349
Each record declaration introduces a number of derived operations to
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   350
  refer collectively to a record's fields and to convert between fixed
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   351
  record types.  They can, for instance, convert between types \isa{point} and \isa{cpoint}.  We can add a colour to a point or convert
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   352
  a \isa{cpoint} to a \isa{point} by forgetting its colour.
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   353
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   354
  \begin{itemize}
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   355
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   356
  \item Function \cdx{make} takes as arguments all of the record's
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   357
  fields (including those inherited from ancestors).  It returns the
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   358
  corresponding record.
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   359
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   360
  \item Function \cdx{fields} takes the record's very own fields and
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   361
  returns a record fragment consisting of just those fields.  This may
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   362
  be filled into the \isa{more} part of the parent record scheme.
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   363
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   364
  \item Function \cdx{extend} takes two arguments: a record to be
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   365
  extended and a record containing the new fields.
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   366
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   367
  \item Function \cdx{truncate} takes a record (possibly an extension
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   368
  of the original record type) and returns a fixed record, removing
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   369
  any additional fields.
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   370
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   371
  \end{itemize}
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   372
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   373
  These functions merely provide handsome abbreviations for standard
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   374
  record expressions involving constructors and selectors.  The
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   375
  definitions, which are \emph{not} unfolded by default, are made
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   376
  available by the collective name of \isa{defs} (\isa{point{\isachardot}defs}, \isa{cpoint{\isachardot}defs}, etc.).
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   377
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   378
  For example, here are the versions of those functions generated for
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   379
  record \isa{point}.  We omit \isa{point{\isachardot}fields}, which happens to
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   380
  be the same as \isa{point{\isachardot}make}.
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   381
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   382
  \begin{isabelle}%
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   383
point{\isachardot}make\ Xcoord\ Ycoord\ {\isasymequiv}\ {\isasymlparr}Xcoord\ {\isacharequal}\ Xcoord{\isacharcomma}\ Ycoord\ {\isacharequal}\ Ycoord{\isasymrparr}\isanewline
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   384
point{\isachardot}extend\ r\ more\ {\isasymequiv}\isanewline
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   385
{\isasymlparr}Xcoord\ {\isacharequal}\ Xcoord\ r{\isacharcomma}\ Ycoord\ {\isacharequal}\ Ycoord\ r{\isacharcomma}\ {\isasymdots}\ {\isacharequal}\ more{\isasymrparr}\isanewline
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   386
point{\isachardot}truncate\ r\ {\isasymequiv}\ {\isasymlparr}Xcoord\ {\isacharequal}\ Xcoord\ r{\isacharcomma}\ Ycoord\ {\isacharequal}\ Ycoord\ r{\isasymrparr}%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   387
\end{isabelle}
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   388
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   389
  Contrast those with the corresponding functions for record \isa{cpoint}.  Observe \isa{cpoint{\isachardot}fields} in particular.
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   390
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   391
  \begin{isabelle}%
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   392
cpoint{\isachardot}make\ Xcoord\ Ycoord\ col\ {\isasymequiv}\isanewline
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   393
{\isasymlparr}Xcoord\ {\isacharequal}\ Xcoord{\isacharcomma}\ Ycoord\ {\isacharequal}\ Ycoord{\isacharcomma}\ col\ {\isacharequal}\ col{\isasymrparr}\isanewline
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   394
cpoint{\isachardot}fields\ col\ {\isasymequiv}\ {\isasymlparr}col\ {\isacharequal}\ col{\isasymrparr}\isanewline
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   395
cpoint{\isachardot}extend\ r\ more\ {\isasymequiv}\isanewline
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   396
{\isasymlparr}Xcoord\ {\isacharequal}\ Xcoord\ r{\isacharcomma}\ Ycoord\ {\isacharequal}\ Ycoord\ r{\isacharcomma}\ col\ {\isacharequal}\ col\ r{\isacharcomma}\ {\isasymdots}\ {\isacharequal}\ more{\isasymrparr}\isanewline
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   397
cpoint{\isachardot}truncate\ r\ {\isasymequiv}\isanewline
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   398
{\isasymlparr}Xcoord\ {\isacharequal}\ Xcoord\ r{\isacharcomma}\ Ycoord\ {\isacharequal}\ Ycoord\ r{\isacharcomma}\ col\ {\isacharequal}\ col\ r{\isasymrparr}%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   399
\end{isabelle}
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   400
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   401
  To demonstrate these functions, we declare a new coloured point by
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   402
  extending an ordinary point.  Function \isa{point{\isachardot}extend} augments
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   403
  \isa{pt{\isadigit{1}}} with a colour value, which is converted into an
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   404
  appropriate record fragment by \isa{cpoint{\isachardot}fields}.%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   405
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   406
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   407
\isacommand{constdefs}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   408
\ \ cpt{\isadigit{2}}\ {\isacharcolon}{\isacharcolon}\ cpoint\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   409
\ \ {\isachardoublequote}cpt{\isadigit{2}}\ {\isasymequiv}\ point{\isachardot}extend\ pt{\isadigit{1}}\ {\isacharparenleft}cpoint{\isachardot}fields\ Green{\isacharparenright}{\isachardoublequote}\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   410
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   411
\begin{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   412
The coloured points \isa{cpt{\isadigit{1}}} and \isa{cpt{\isadigit{2}}} are equal.  The
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   413
  proof is trivial, by unfolding all the definitions.  We deliberately
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   414
  omit the definition of~\isa{pt{\isadigit{1}}} in order to reveal the underlying
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   415
  comparison on type \isa{point}.%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   416
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   417
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   418
\isacommand{lemma}\ {\isachardoublequote}cpt{\isadigit{1}}\ {\isacharequal}\ cpt{\isadigit{2}}{\isachardoublequote}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   419
\ \ \isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   420
\isacommand{apply}\ {\isacharparenleft}simp\ add{\isacharcolon}\ cpt{\isadigit{1}}{\isacharunderscore}def\ cpt{\isadigit{2}}{\isacharunderscore}def\ point{\isachardot}defs\ cpoint{\isachardot}defs{\isacharparenright}\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   421
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   422
\begin{isamarkuptxt}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   423
\begin{isabelle}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   424
\ {\isadigit{1}}{\isachardot}\ Xcoord\ pt{\isadigit{1}}\ {\isacharequal}\ {\isadigit{9}}{\isadigit{9}}{\isadigit{9}}\ {\isasymand}\ Ycoord\ pt{\isadigit{1}}\ {\isacharequal}\ {\isadigit{2}}{\isadigit{3}}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   425
\end{isabelle}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   426
\end{isamarkuptxt}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   427
\ \ \isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   428
\isacommand{apply}\ {\isacharparenleft}simp\ add{\isacharcolon}\ pt{\isadigit{1}}{\isacharunderscore}def{\isacharparenright}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   429
\ \ \isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   430
\isacommand{done}\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   431
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   432
\begin{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   433
In the example below, a coloured point is truncated to leave a
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   434
  point.  We use the \isa{truncate} function of the target record.%
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   435
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   436
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   437
\isacommand{lemma}\ {\isachardoublequote}point{\isachardot}truncate\ cpt{\isadigit{2}}\ {\isacharequal}\ pt{\isadigit{1}}{\isachardoublequote}\isanewline
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   438
\ \ \isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   439
\isacommand{by}\ {\isacharparenleft}simp\ add{\isacharcolon}\ pt{\isadigit{1}}{\isacharunderscore}def\ cpt{\isadigit{2}}{\isacharunderscore}def\ point{\isachardot}defs{\isacharparenright}\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   440
%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   441
\begin{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   442
\begin{exercise}
12585
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   443
  Extend record \isa{cpoint} to have a further field, \isa{intensity}, of type~\isa{nat}.  Experiment with generic operations
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   444
  (using polymorphic selectors and updates) and explicit coercions
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   445
  (using \isa{extend}, \isa{truncate} etc.) among the three record
e3cb192aa6ee updated;
wenzelm
parents: 12572
diff changeset
   446
  types.
12572
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   447
  \end{exercise}
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   448
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   449
  \begin{exercise}
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   450
  (For Java programmers.)
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   451
  Model a small class hierarchy using records.
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   452
  \end{exercise}
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   453
  \index{records|)}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   454
\end{isamarkuptext}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   455
\isamarkuptrue%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   456
\isamarkupfalse%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   457
\end{isabellebody}%
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   458
%%% Local Variables:
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   459
%%% mode: latex
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   460
%%% TeX-master: "root"
f8ad8cfb8309 generated text;
wenzelm
parents:
diff changeset
   461
%%% End: