gcc/ada/sem_ch8.ads

   1 ------------------------------------------------------------------------------
   2 --                                                                          --
   3 --                         GNAT COMPILER COMPONENTS                         --
   4 --                                                                          --
   5 --                              S E M _ C H 8                               --
   6 --                                                                          --
   7 --                                 S p e c                                  --
   8 --                                                                          --
   9 --                            $Revision: 1.33 $                             --
  10 --                                                                          --
  11 --          Copyright (C) 1992-2001 Free Software Foundation, Inc.          --
  12 --                                                                          --
  13 -- GNAT is free software;  you can  redistribute it  and/or modify it under --
  14 -- terms of the  GNU General Public License as published  by the Free Soft- --
  15 -- ware  Foundation;  either version 2,  or (at your option) any later ver- --
  16 -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
  17 -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
  18 -- or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License --
  19 -- for  more details.  You should have  received  a copy of the GNU General --
  20 -- Public License  distributed with GNAT;  see file COPYING.  If not, write --
  21 -- to  the Free Software Foundation,  59 Temple Place - Suite 330,  Boston, --
  22 -- MA 02111-1307, USA.                                                      --
  23 --                                                                          --
  24 -- GNAT was originally developed  by the GNAT team at  New York University. --
  25 -- It is now maintained by Ada Core Technologies Inc (http://www.gnat.com). --
  26 --                                                                          --
  27 ------------------------------------------------------------------------------
  28
  29 with Types; use Types;
  30 package Sem_Ch8 is
  31
  32    -----------------------------------
  33    -- Handling extensions of System --
  34    -----------------------------------
  35
  36    --  For targets that define a much larger System package than given in
  37    --  the RM, we use a child package containing additional declarations,
  38    --  which is loaded when needed, and whose entities are conceptually
  39    --  within System itself. The presence of this auxiliary package is
  40    --  controlled with the pragma Extend_System. The following variable
  41    --  holds the entity of the auxiliary package, to simplify the special
  42    --  visibility rules that apply to it.
  43
  44    System_Aux_Id : Entity_Id := Empty;
  45
  46    -----------------
  47    -- Subprograms --
  48    -----------------
  49
  50    procedure Analyze_Exception_Renaming                 (N : Node_Id);
  51    procedure Analyze_Expanded_Name                      (N : Node_Id);
  52    procedure Analyze_Generic_Function_Renaming          (N : Node_Id);
  53    procedure Analyze_Generic_Package_Renaming           (N : Node_Id);
  54    procedure Analyze_Generic_Procedure_Renaming         (N : Node_Id);
  55    procedure Analyze_Object_Renaming                    (N : Node_Id);
  56    procedure Analyze_Package_Renaming                   (N : Node_Id);
  57    procedure Analyze_Subprogram_Renaming                (N : Node_Id);
  58    procedure Analyze_Use_Package                        (N : Node_Id);
  59    procedure Analyze_Use_Type                           (N : Node_Id);
  60
  61    function Applicable_Use (Pack_Name : Node_Id) return Boolean;
  62    --  Common code to Use_One_Package and Set_Use, to determine whether
  63    --  use clause must be processed. Pack_Name is an entity name that
  64    --  references the package in question.
  65
  66    procedure End_Scope;
  67    --  Called at end of scope. On exit from blocks and bodies (subprogram,
  68    --  package, task, and protected bodies), the name of the current scope
  69    --  must be removed from the scope stack, and the local entities must be
  70    --  removed from their homonym chains. On exit from record declarations,
  71    --  from package specifications, and from tasks and protected type
  72    --  specifications, more specialized procedures are invoked.
  73
  74    procedure End_Use_Clauses (Clause : Node_Id);
  75    --  Invoked on scope exit, to undo the effect of local use clauses. U is
  76    --  the first Use clause of a scope being exited. This can be the current
  77    --  scope, or some enclosing scopes when building a clean environment to
  78    --  compile an instance body for inlining.
  79
  80    procedure End_Use_Package (N : Node_Id);
  81    procedure End_Use_Type    (N : Node_Id);
  82    --  Subsidiaries of End_Use_Clauses.  Also called directly for use clauses
  83    --  appearing in context clauses.
  84
  85    procedure Find_Direct_Name (N : Node_Id);
  86    --  Given a direct name (Identifier or Operator_Symbol), this routine
  87    --  scans the homonym chain for the name searching for corresponding
  88    --  visible entities to find the referenced entity (or in the case of
  89    --  overloading), entities. On return, the Entity, and Etype fields
  90    --  are set. In the non-overloaded case, these are the correct final
  91    --  entries. In the overloaded case, Is_Overloaded is set, Etype and
  92    --  Entity refer to an arbitrary element of the overloads set, and
  93    --  an appropriate list of entries has been made in the overload
  94    --  interpretation table (to be disambiguated in the resolve phase).
  95
  96    procedure Find_Expanded_Name (N : Node_Id);
  97    --  Selected component is known to be expanded name. Verify legality
  98    --  of selector given the scope denoted by prefix.
  99
 100    procedure Find_Selected_Component (N : Node_Id);
 101    --  Resolve various cases of selected components, recognize expanded names
 102
 103    procedure Find_Type (N : Node_Id);
 104    --  Perform name resolution, and verify that the name found is that of a
 105    --  type. On return the Entity and Etype fields of the node N are set
 106    --  appropriately. If it is an incomplete type whose full declaration has
 107    --  been seen, return the entity in the full declaration. Similarly, if
 108    --  the type is private, it has receivd a full declaration, and we are
 109    --  in the private part or body of the package, return the full
 110    --  declaration as well. Special processing for Class types as well.
 111
 112    function Get_Full_View (T_Name : Entity_Id) return Entity_Id;
 113    --  If T_Name is an incomplete type and the full declaration has been
 114    --  seen, or is the name of a class_wide type whose root is incomplete.
 115    --  return the corresponding full declaration.
 116
 117    function Has_Implicit_Operator (N : Node_Id) return Boolean;
 118    --  N is an expanded name whose selector is an operator name (eg P."+").
 119    --  A declarative part contains an implicit declaration of an operator
 120    --  if it has a declaration of a type to which one of the predefined
 121    --  operators apply. The existence of this routine is an artifact of
 122    --  our implementation: a more straightforward but more space-consuming
 123    --  choice would be to make all inherited operators explicit in the
 124    --  symbol table.
 125
 126    procedure Initialize;
 127    --  Initializes data structures used for visibility analysis. Must be
 128    --  called before analyzing each new main source program.
 129
 130    procedure Install_Use_Clauses (Clause : Node_Id);
 131    --  applies the use clauses appearing in a given declarative part,
 132    --  when the corresponding scope has been placed back on the scope
 133    --  stack after unstacking to compile a different context (subunit or
 134    --  parent of generic body).
 135
 136    function In_Open_Scopes (S : Entity_Id) return Boolean;
 137    --  S is the entity of a scope. This function determines if this scope
 138    --  is currently open (i.e. it appears somewhere in the scope stack).
 139
 140    function Is_Appropriate_For_Record (T : Entity_Id) return Boolean;
 141    --  Prefix is appropriate for record if it is of a record type, or
 142    --  an access to such.
 143
 144    function Is_Appropriate_For_Entry_Prefix (T : Entity_Id) return Boolean;
 145    --  True if it is of a task type, a protected type, or else an access
 146    --  to one of these types.
 147
 148    procedure New_Scope (S : Entity_Id);
 149    --  Make new scope stack entry, pushing S, the entity for a scope
 150    --  onto the top of the scope table. The current setting of the scope
 151    --  suppress flags is saved for restoration on exit.
 152
 153    procedure Pop_Scope;
 154    --  Remove top entry from scope stack, restoring the saved setting
 155    --  of the scope suppress flags.
 156
 157    function Present_System_Aux (N : Node_Id := Empty) return Boolean;
 158    --  Return True if the auxiliary system file has been sucessfully loaded.
 159    --  Otherwise attempt to load it, using the name supplied by a previous
 160    --  Extend_System pragma, and report on the success of the load.
 161    --  If N is present, it is a selected component whose prefix is System,
 162    --  or else a with-clause on system. N is absent when the function is
 163    --  called to find the visibility of implicit operators.
 164
 165    procedure Restore_Scope_Stack;
 166    procedure Save_Scope_Stack;
 167    --  These two procedures are called from Semantics, when a unit U1 is
 168    --  to be compiled in the course of the compilation of another unit U2.
 169    --  This happens whenever Rtsfind is called. U1, the unit retrieved by
 170    --  Rtsfind, must be compiled in its own context, and the current scope
 171    --  stack containing U2 and local scopes must be made unreachable. On
 172    --  return, the contents of the scope stack must be made accessible again.
 173
 174    procedure Use_One_Package (P : Entity_Id; N : Node_Id);
 175    --  Make visible entities declarated in package P potentially use-visible
 176    --  in the current context. Also used in the analysis of subunits, when
 177    --  re-installing use clauses of parent units. N is the use_clause that
 178    --  names P (and possibly other packages).
 179
 180    procedure Use_One_Type (Id : Node_Id; N : Node_Id);
 181    --  Id is the subtype mark from a use type clause. This procedure makes
 182    --  the primitive operators of the type potentially use-visible.
 183    --  N is the Use_Type_Clause that names Id.
 184
 185    procedure Set_Use (L : List_Id);
 186    --  Find use clauses that are declarative items in a package declaration
 187    --  and  set the potentially use-visible flags of imported entities before
 188    --  analyzing the corresponding package body.
 189
 190 end Sem_Ch8;