1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364
|
<HTML>
<HEAD>
<!-- This HTML file has been created by texi2html 1.29
from ../tnf/typetutorial.tnf on 12 Febuary 2003 -->
<TITLE>Tutorial on Type Analysis - Pointer Types</TITLE>
</HEAD>
<BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000EE" VLINK="#551A8B" ALINK="#FF0000" BACKGROUND="gifs/bg.gif">
<TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0" VALIGN=BOTTOM>
<TR VALIGN=BOTTOM>
<TD WIDTH="160" VALIGN=BOTTOM><IMG SRC="gifs/elilogo.gif" BORDER=0> </TD>
<TD WIDTH="25" VALIGN=BOTTOM><img src="gifs/empty.gif" WIDTH=25 HEIGHT=25></TD>
<TD ALIGN=LEFT WIDTH="600" VALIGN=BOTTOM><IMG SRC="gifs/title.gif"></TD>
</TR>
</TABLE>
<HR size=1 noshade width=785 align=left>
<TABLE BORDER=0 CELLSPACING=2 CELLPADDING=0>
<TR>
<TD VALIGN=TOP WIDTH="160">
<h4>General Information</h4>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="index.html">Eli: Translator Construction Made Easy</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="gindex_toc.html">Global Index</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="faq_toc.html" >Frequently Asked Questions</a> </td></tr>
</table>
<h4>Tutorials</h4>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="EliRefCard_toc.html">Quick Reference Card</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="novice_toc.html">Guide For new Eli Users</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="news_toc.html">Release Notes of Eli</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="nametutorial_toc.html">Tutorial on Name Analysis</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="typetutorial_toc.html">Tutorial on Type Analysis</a></td></tr>
</table>
<h4>Reference Manuals</h4>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="ui_toc.html">User Interface</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="pp_toc.html">Eli products and parameters</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="lidoref_toc.html">LIDO Reference Manual</a></td></tr>
</table>
<h4>Libraries</h4>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="lib_toc.html">Eli library routines</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="modlib_toc.html">Specification Module Library</a></td></tr>
</table>
<h4>Translation Tasks</h4>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="lex_toc.html">Lexical analysis specification</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="syntax_toc.html">Syntactic Analysis Manual</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="comptrees_toc.html">Computation in Trees</a></td></tr>
</table>
<h4>Tools</h4>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="lcl_toc.html">LIGA Control Language</a> </td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="show_toc.html">Debugging Information for LIDO</a> </td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="gorto_toc.html">Graphical ORder TOol</a> </td></tr>
</table>
<p>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="fw_toc.html">FunnelWeb User's Manual</a> </td></tr>
</table>
<p>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="ptg_toc.html">Pattern-based Text Generator</a> </td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="deftbl_toc.html">Property Definition Language</a> </td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="oil_toc.html">Operator Identification Language</a> </td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="tp_toc.html">Tree Grammar Specification Language</a> </td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="clp_toc.html">Command Line Processing</a> </td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="cola_toc.html">COLA Options Reference Manual</a> </td></tr>
</table>
<p>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="idem_toc.html">Generating Unparsing Code</a> </td></tr>
</table>
<p>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="mon_toc.html">Monitoring a Processor's Execution</a> </td></tr>
</table>
<h4>Administration</h4>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="sysadmin_toc.html">System Administration Guide</a> </td></tr>
</table>
<HR WIDTH="100%">
<CENTER> <A HREF="mailto:elibugs@cs.colorado.edu"><IMG SRC="gifs/button_mail.gif" NOSAVE BORDER=0 HEIGHT=32 WIDTH=32></A><A HREF="mailto:elibugs@cs.colorado.edu">Questions, Comments, ....</A></CENTER>
</TD>
<TD VALIGN=TOP WIDTH="25"><img src="gifs/empty.gif" WIDTH=25 HEIGHT=25></TD>
<TD VALIGN=TOP WIDTH="600">
<H1>Tutorial on Type Analysis</H1>
<P>
<IMG SRC="gifs/empty.gif" WIDTH=25 HEIGHT=25 ALT=""><A HREF="typetutorial_11.html"><IMG SRC="gifs/prev.gif" ALT="Previous Chapter" BORDER="0"></A>
<IMG SRC="gifs/empty.gif" WIDTH=25 HEIGHT=25 ALT=""><A HREF="typetutorial_13.html"><IMG SRC="gifs/next.gif" ALT="Next Chapter" BORDER="0"></A>
<IMG SRC="gifs/empty.gif" WIDTH=25 HEIGHT=25 ALT=""><A HREF="typetutorial_toc.html"><IMG SRC="gifs/up.gif" ALT="Table of Contents" BORDER="0"></A>
<IMG SRC="gifs/empty.gif" WIDTH=25 HEIGHT=25 ALT="">
<HR size=1 noshade width=600 align=left>
<H1><A NAME="SEC12" HREF="typetutorial_toc.html#SEC12">Pointer Types</A></H1>
<P>
In this section we introduce pointer types to our language.
A type denoted <CODE>t !</CODE> shall
be the type of objects that points to objects of type <CODE>t</CODE>.
<P>
Two new <CODE>Variable</CODE> notations are introduced:
<CODE>v !</CODE> denotes the object which the value of the pointer variable
<CODE>v</CODE> points to. <CODE>v &</CODE> yields the address of the variable
<CODE>v</CODE>, it has the type pointer to <CODE>t</CODE> if <CODE>v</CODE> is a variable
of type <CODE>t</CODE>.
<P>
The following concrete productions are added:
<P>
<B>Pointer.con</B>[48]==
<PRE>
<TT>
TypeDenoter: PointerType.
PointerType: TypeDenoter '!'.
Variable: Variable '!'.
Variable: Variable '&'.
</TT>
</PRE>
<FONT SIZE=1>
<PRE>
This macro is attached to a product file.
</PRE>
</FONT>
<P>
Here is an example program that uses these pointer constructs
in different contexts:
<B>PointerExamp</B>[49]==
<PRE>
<TT>begin
var int k;
var int! pi, int! pj;
var record int i, bool b, real! r end! rv;
type record int x, t! next end t;
var t l;
pi = k&;
pi! = 1;
pi = pj;
pi! = pj!;
rv!.b = true;
rv!.r! = 3.2;
l.next!.x = 1;
end
</TT>
</PRE>
<FONT SIZE=1>
<PRE>
This macro is attached to a product file.
</PRE>
</FONT>
<P>
The property <CODE>PointsTo</CODE> is introduced to describe pointer types.
<P>
<B>Pointer.pdl</B>[50]==
<PRE>
<TT>
PointsTo: DefTableKey [KReset];
</TT>
</PRE>
<FONT SIZE=1>
<PRE>
This macro is attached to a product file.
</PRE>
</FONT>
<P>
Types <CODE>t !</CODE> and <CODE>s !</CODE> shall be equivalent if <CODE>s</CODE>
and <CODE>t</CODE> are equivalent, due to type definitions that simply
rename a type. (This rule is similar to that of C, but different
from that of Pascal where any occurrence of a pointer type denoter
introduces a new type.)
<P>
As discussed in the section where we introduced record types,
we specify a <CODE>TypeDenoter</CODE> such that a new type representation
is created. The <CODE>EqualTypes</CODE> function is augmented below
by rules that implement the desired equivalence of two types
that stem from different occurrences of <CODE>TypeDenoter</CODE>s.
<P>
<B>PointerType.lido</B>[51]==
<PRE>
<TT>
SYMBOL PointerType INHERITS TypeDenotation END;
RULE: TypeDenoter ::= PointerType COMPUTE
TypeDenoter.Type = PointerType.Type;
END;
RULE: PointerType ::= TypeDenoter '!' COMPUTE
PointerType.GotType =
ResetTypeName
(KResetPointsTo (PointerType.Type, TypeDenoter.Type),
"pointer...");
IF (RecursivePtrType (PointerType.Type, PointerType.Type),
message (ERROR, "recursive pointer type", 0, COORDREF))
<- INCLUDING Program.GotType;
END;
</TT>
</PRE>
<FONT SIZE=1>
<PRE>
This macro is attached to a product file.
</PRE>
</FONT>
<P>
The last computation checks that the pointer type denoted here
does not refer to itself via pointer relations only.
Note: Although a message is given in such erroneous cases,
functions that operate on types must be coded such that
they can deal with such types.
<P>
We now state how pointer types are checked for equivalence.
Our language requires that two pointer type notations shall
be considered to be equal types if the types they point to
are equal. Such cases where different type keys may represent
equal types are not yet captured by the initial frame of the
<CODE>EqualTypes</CODE> function. Instead, it has an insertion point
<CODE>EqualTypes.h</CODE> where code fragments can be inserted, each
fragment checking an equivalence rule for a certain kind of types.
<P>
Here, the following <CODE>.phi</CODE> fragment is applicable if
the type <CODE>t1</CODE> is a pointer type. Equivalence holds
only if <CODE>t2</CODE> is a pointer type, too, and the types
they point to are equal.
Furthermore, we have to make sure that the recursion
terminates even in erroneous cases where one of the types
is defined to point to itself.
<P>
<B>Pointer.EqualTypes.phi</B>[52]==
<PRE>
<TT>
{ /* pointer types: */
DefTableKey tr1, tr2;
tr1 = TransDefer (GetPointsTo (t1, NoKey));
if (tr1 != NoKey)
{ /* tr1 is a pointer type: */
tr2 = TransDefer (GetPointsTo (t2, NoKey));
if (tr2 == NoKey)
return 0; /* tr2 is not a pointer type */
if (RecursivePtrType (tr1, tr1) ||
RecursivePtrType (tr2, tr2))
return 0; /* recursive pointer type */
return EqualTypes (tr1, tr2);
}
}/* end pointer types */
</TT>
</PRE>
<FONT SIZE=1>
<PRE>
This macro is attached to a product file.
</PRE>
</FONT>
<P>
The <CODE>.phi</CODE> technique is also used to insert the definition
of the function <CODE>RecursivePtrType</CODE> and its interface
declaration:
<P>
<B>Pointer.TypeFct.phi</B>[53]==
<PRE>
<TT>
#ifdef PROTO_OK
int RecursivePtrType (DefTableKey orig, DefTableKey chk)
#else
int RecursivePtrType (orig, chk) DefTableKey orig, chk;
#endif
/* 1 is returned if the type chk directly or indirectly
points to orig; 0 is returned otherwise.
*/
{ chk = TransDefer (GetPointsTo (chk, NoKey));
if (chk == NoKey) return 0;
if (chk == orig) return 1;
return RecursivePtrType (orig, chk);
}
</TT>
</PRE>
<FONT SIZE=1>
<PRE>
This macro is attached to a product file.
</PRE>
</FONT>
<P>
<B>Pointer.TypeFctHdr.phi</B>[54]==
<PRE>
<TT>
extern int RecursivePtrType ELI_ARG((DefTableKey orig, DefTableKey chk));
</TT>
</PRE>
<FONT SIZE=1>
<PRE>
This macro is attached to a product file.
</PRE>
</FONT>
<P>
For the contents operation applied to a <CODE>Variable</CODE> we access
the <CODE>PointsTo</CODE> relation that holds if the <CODE>Variable</CODE> really
has a pointer type:
<P>
<B>PointerVar.lido</B>[55]==
<PRE>
<TT>
RULE: Variable ::= Variable '!' COMPUTE
Variable[1].Type =
TransDefer (GetPointsTo (Variable[2].Type, NoKey));
IF (EQ (Variable[1].Type, NoKey),
message (ERROR, "is not a pointer variable", 0, COORDREF));
END;
</TT>
</PRE>
<FONT SIZE=1>
<PRE>
This macro is attached to a product file.
</PRE>
</FONT>
<P>
The address operator implicitly creates a pointer type
that <CODE>PointsTo</CODE> the type of the variable.
Both properties <CODE>PointsTo</CODE> and <CODE>IsType</CODE> are set
for that new type key.
<P>
<B>AddressVar.lido</B>[56]==
<PRE>
<TT>
RULE: Variable ::= Variable '&' COMPUTE
Variable[1].Type =
KResetPointsTo
(KResetTypeName
(KResetIsType (NewKey (), 1),
"addr of ..."),
Variable[2].Type);
END;
</TT>
</PRE>
<FONT SIZE=1>
<PRE>
This macro is attached to a product file.
</PRE>
</FONT>
<P>
<HR size=1 noshade width=600 align=left>
<P>
<IMG SRC="gifs/empty.gif" WIDTH=25 HEIGHT=25 ALT=""><A HREF="typetutorial_11.html"><IMG SRC="gifs/prev.gif" ALT="Previous Chapter" BORDER="0"></A>
<IMG SRC="gifs/empty.gif" WIDTH=25 HEIGHT=25 ALT=""><A HREF="typetutorial_13.html"><IMG SRC="gifs/next.gif" ALT="Next Chapter" BORDER="0"></A>
<IMG SRC="gifs/empty.gif" WIDTH=25 HEIGHT=25 ALT=""><A HREF="typetutorial_toc.html"><IMG SRC="gifs/up.gif" ALT="Table of Contents" BORDER="0"></A>
<IMG SRC="gifs/empty.gif" WIDTH=25 HEIGHT=25 ALT="">
<HR size=1 noshade width=600 align=left>
</TD>
</TR>
</TABLE>
</BODY></HTML>
|