html/suif1_71.html

   1 <HTML>
   2 <HEAD>
   3 <!-- This HTML file has been created by texi2html 1.54
   4      from suif1.texi on 28 April 1999 -->
   5
   6 <TITLE>The SUIF Version 1 Library - Flat Annotes</TITLE>
   7 <link href="suif1_72.html" rel=Next>
   8 <link href="suif1_70.html" rel=Previous>
   9 <link href="suif1_toc.html" rel=ToC>
  10
  11 </HEAD>
  12 <BODY>
  13 <p>Go to the <A HREF="suif1_1.html">first</A>, <A HREF="suif1_70.html">previous</A>, <A HREF="suif1_72.html">next</A>, <A HREF="suif1_113.html">last</A> section, <A HREF="suif1_toc.html">table of contents</A>.
  14 <P><HR><P>
  15
  16
  17 <H2><A NAME="SEC71" HREF="suif1_toc.html#TOC71">Flat Annotations</A></H2>
  18 <P>
  19 <A NAME="IDX552"></A>
  20 <A NAME="IDX553"></A>
  21
  22 </P>
  23 <P>
  24 The simplest type of annotation is a <STRONG>flat annotation</STRONG>.  The data in
  25 a flat annotation is a pointer to a list of <CODE>immed</CODE> values.
  26 See section <A HREF="suif1_100.html#SEC100">Immediate Values</A>.  By default, annotations read from an input file are flat
  27 annotations.  That is, if a SUIF input file contains an annotation with
  28 a name that has not yet been registered, the SUIF library will
  29 automatically register it as a flat annotation.
  30
  31 </P>
  32 <P>
  33 When creating new flat annotations, you may specify both the annotation
  34 name and a pointer to an <CODE>immed</CODE> list.  In many cases, however, it
  35 is more convenient to only provide the annotation name and let the
  36 annotation constructor automatically fill the data field with a pointer
  37 to a new list.
  38
  39 </P>
  40 <P>
  41 For flat annotations, the <CODE>immeds</CODE> method merely provides a
  42 shortcut for accessing the data by casting it to an <CODE>immed_list</CODE>
  43 pointer.  Similarly, the <CODE>set_immeds</CODE> method is functionally
  44 equivalent to <CODE>set_data</CODE> in this case.
  45
  46 </P>
  47
  48 <P><HR><P>
  49 <p>Go to the <A HREF="suif1_1.html">first</A>, <A HREF="suif1_70.html">previous</A>, <A HREF="suif1_72.html">next</A>, <A HREF="suif1_113.html">last</A> section, <A HREF="suif1_toc.html">table of contents</A>.
  50 </BODY>
  51 </HTML>