158 lines
8.7 KiB
Ada
158 lines
8.7 KiB
Ada
------------------------------------------------------------------------------
|
|
-- --
|
|
-- GNAT COMPILER COMPONENTS --
|
|
-- --
|
|
-- S E M _ C H 8 --
|
|
-- --
|
|
-- S p e c --
|
|
-- --
|
|
-- Copyright (C) 1992-2008, Free Software Foundation, Inc. --
|
|
-- --
|
|
-- GNAT is free software; you can redistribute it and/or modify it under --
|
|
-- terms of the GNU General Public License as published by the Free Soft- --
|
|
-- ware Foundation; either version 3, or (at your option) any later ver- --
|
|
-- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
|
|
-- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
|
|
-- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
|
|
-- for more details. You should have received a copy of the GNU General --
|
|
-- Public License distributed with GNAT; see file COPYING3. If not, go to --
|
|
-- http://www.gnu.org/licenses for a complete copy of the license. --
|
|
-- --
|
|
-- GNAT was originally developed by the GNAT team at New York University. --
|
|
-- Extensive contributions were provided by Ada Core Technologies Inc. --
|
|
-- --
|
|
------------------------------------------------------------------------------
|
|
|
|
with Types; use Types;
|
|
package Sem_Ch8 is
|
|
|
|
-----------------------------------
|
|
-- Handling extensions of System --
|
|
-----------------------------------
|
|
|
|
-- For targets that define a much larger System package than given in
|
|
-- the RM, we use a child package containing additional declarations,
|
|
-- which is loaded when needed, and whose entities are conceptually
|
|
-- within System itself. The presence of this auxiliary package is
|
|
-- controlled with the pragma Extend_System. The following variable
|
|
-- holds the entity of the auxiliary package, to simplify the special
|
|
-- visibility rules that apply to it.
|
|
|
|
System_Aux_Id : Entity_Id := Empty;
|
|
|
|
-----------------
|
|
-- Subprograms --
|
|
-----------------
|
|
|
|
procedure Analyze_Exception_Renaming (N : Node_Id);
|
|
procedure Analyze_Expanded_Name (N : Node_Id);
|
|
procedure Analyze_Generic_Function_Renaming (N : Node_Id);
|
|
procedure Analyze_Generic_Package_Renaming (N : Node_Id);
|
|
procedure Analyze_Generic_Procedure_Renaming (N : Node_Id);
|
|
procedure Analyze_Object_Renaming (N : Node_Id);
|
|
procedure Analyze_Package_Renaming (N : Node_Id);
|
|
procedure Analyze_Subprogram_Renaming (N : Node_Id);
|
|
procedure Analyze_Use_Package (N : Node_Id);
|
|
procedure Analyze_Use_Type (N : Node_Id);
|
|
|
|
procedure End_Scope;
|
|
-- Called at end of scope. On exit from blocks and bodies (subprogram,
|
|
-- package, task, and protected bodies), the name of the current scope
|
|
-- must be removed from the scope stack, and the local entities must be
|
|
-- removed from their homonym chains. On exit from record declarations,
|
|
-- from package specifications, and from tasks and protected type
|
|
-- specifications, more specialized procedures are invoked.
|
|
|
|
procedure End_Use_Clauses (Clause : Node_Id);
|
|
-- Invoked on scope exit, to undo the effect of local use clauses. Clause
|
|
-- is the first use-clause of a scope being exited. This can be the current
|
|
-- scope, or some enclosing scopes when building a clean environment to
|
|
-- compile an instance body for inlining.
|
|
|
|
procedure End_Use_Package (N : Node_Id);
|
|
procedure End_Use_Type (N : Node_Id);
|
|
-- Subsidiaries of End_Use_Clauses. Also called directly for use clauses
|
|
-- appearing in context clauses.
|
|
|
|
procedure Find_Direct_Name (N : Node_Id);
|
|
-- Given a direct name (Identifier or Operator_Symbol), this routine scans
|
|
-- the homonym chain for the name searching for corresponding visible
|
|
-- entities to find the referenced entity (or in the case of overloading,
|
|
-- entities). On return, the Entity and Etype fields are set. In the
|
|
-- non-overloaded case, these are the correct final entries. In the
|
|
-- overloaded case, Is_Overloaded is set, Etype and Entity refer to an
|
|
-- arbitrary element of the overloads set, and an appropriate list of
|
|
-- entries has been made in the overload interpretation table (to be
|
|
-- disambiguated in the resolve phase).
|
|
|
|
procedure Find_Selected_Component (N : Node_Id);
|
|
-- Resolve various cases of selected components, recognize expanded names
|
|
|
|
procedure Find_Type (N : Node_Id);
|
|
-- Perform name resolution, and verify that the name found is that of a
|
|
-- type. On return the Entity and Etype fields of the node N are set
|
|
-- appropriately. If it is an incomplete type whose full declaration has
|
|
-- been seen, they are set to the entity in the full declaration. If it
|
|
-- is an incomplete type associated with an interface visible through a
|
|
-- limited-with clause, whose full declaration has been seen, they are
|
|
-- set to the entity in the full declaration. Similarly, if the type is
|
|
-- private, it has received a full declaration, and we are in the private
|
|
-- part or body of the package, then the two fields are set to the entity
|
|
-- of the full declaration as well. This procedure also has special
|
|
-- processing for 'Class attribute references.
|
|
|
|
procedure Initialize;
|
|
-- Initializes data structures used for visibility analysis. Must be
|
|
-- called before analyzing each new main source program.
|
|
|
|
procedure Install_Use_Clauses
|
|
(Clause : Node_Id;
|
|
Force_Installation : Boolean := False);
|
|
-- Applies the use clauses appearing in a given declarative part,
|
|
-- when the corresponding scope has been placed back on the scope
|
|
-- stack after unstacking to compile a different context (subunit or
|
|
-- parent of generic body). Force_Installation is used when called from
|
|
-- Analyze_Subunit.Re_Install_Use_Clauses to insure that, after the
|
|
-- analysis of the subunit, the parent's environment is again identical.
|
|
|
|
function In_Open_Scopes (S : Entity_Id) return Boolean;
|
|
-- S is the entity of a scope. This function determines if this scope
|
|
-- is currently open (i.e. it appears somewhere in the scope stack).
|
|
|
|
procedure Push_Scope (S : Entity_Id);
|
|
-- Make new scope stack entry, pushing S, the entity for a scope
|
|
-- onto the top of the scope table. The current setting of the scope
|
|
-- suppress flags is saved for restoration on exit.
|
|
|
|
procedure Pop_Scope;
|
|
-- Remove top entry from scope stack, restoring the saved setting
|
|
-- of the scope suppress flags.
|
|
|
|
function Present_System_Aux (N : Node_Id := Empty) return Boolean;
|
|
-- Return True if the auxiliary system file has been successfully loaded.
|
|
-- Otherwise attempt to load it, using the name supplied by a previous
|
|
-- Extend_System pragma, and report on the success of the load.
|
|
-- If N is present, it is a selected component whose prefix is System,
|
|
-- or else a with-clause on system. N is absent when the function is
|
|
-- called to find the visibility of implicit operators.
|
|
|
|
procedure Restore_Scope_Stack (Handle_Use : Boolean := True);
|
|
procedure Save_Scope_Stack (Handle_Use : Boolean := True);
|
|
-- These two procedures are called from Semantics, when a unit U1 is
|
|
-- to be compiled in the course of the compilation of another unit U2.
|
|
-- This happens whenever Rtsfind is called. U1, the unit retrieved by
|
|
-- Rtsfind, must be compiled in its own context, and the current scope
|
|
-- stack containing U2 and local scopes must be made unreachable. On
|
|
-- return, the contents of the scope stack must be made accessible again.
|
|
-- The flag Handle_Use indicates whether local use clauses must be
|
|
-- removed/installed. In the case of inlining of instance bodies, the
|
|
-- visibility handling is done fully in Inline_Instance_Body, and use
|
|
-- clauses are handled there.
|
|
|
|
procedure Set_Use (L : List_Id);
|
|
-- Find use clauses that are declarative items in a package declaration
|
|
-- and set the potentially use-visible flags of imported entities before
|
|
-- analyzing the corresponding package body.
|
|
|
|
end Sem_Ch8;
|