-- --
-- S p e c --
-- --
--- Copyright (C) 1992-2005 Free Software Foundation, Inc. --
+-- Copyright (C) 1992-2010, 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 2, or (at your option) any later ver- --
+-- 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 COPYING. If not, write --
--- to the Free Software Foundation, 51 Franklin Street, Fifth Floor, --
--- Boston, MA 02110-1301, USA. --
+-- 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. --
-- Type Support Subprogram (TSS) handling
+with Namet; use Namet;
with Types; use Types;
package Exp_Tss is
-------------------------
-- In the current version of this package, only the case of generating a
- -- TSS at the point of declaration of the type is accomodated. A clear
+ -- TSS at the point of declaration of the type is accommodated. A clear
-- improvement would be to follow through with the full implementation
- -- as described above, and also accomodate the requirement of generating
+ -- as described above, and also accommodate the requirement of generating
-- only one copy in a given object file.
-- For now, we deal with the local case by generating duplicate versions
-- The following codes are used to denote TSSs:
- -- Note: When making additions to this list, update the list in snames.adb
+ -- Note: When making additions to this list, make the corresponding change
+ -- to the list in snames.adb-tmpl.
type TSS_Name_Type is new String (1 .. 2);
subtype TNT is TSS_Name_Type;
TSS_Composite_Equality : constant TNT := "EQ"; -- Composite Equality
TSS_From_Any : constant TNT := "FA"; -- PolyORB/DSA From_Any
TSS_Init_Proc : constant TNT := "IP"; -- Initialization Procedure
+ TSS_CPP_Init_Proc : constant TNT := "IC"; -- Init C++ dispatch tables
TSS_RAS_Access : constant TNT := "RA"; -- RAS type access
- TSS_RAS_Dereference : constant TNT := "RD"; -- RAS type deference
+ TSS_RAS_Dereference : constant TNT := "RD"; -- RAS type dereference
TSS_Rep_To_Pos : constant TNT := "RP"; -- Rep to Pos conversion
TSS_Slice_Assign : constant TNT := "SA"; -- Slice assignment
TSS_Stream_Input : constant TNT := "SI"; -- Stream Input attribute
TSS_Composite_Equality,
TSS_From_Any,
TSS_Init_Proc,
+ TSS_CPP_Init_Proc,
TSS_RAS_Access,
TSS_RAS_Dereference,
TSS_Rep_To_Pos,
function Make_Init_Proc_Name (Typ : Entity_Id) return Name_Id;
-- Version for init procs, same as Make_TSS_Name (Typ, TSS_Init_Proc)
+ function Is_CPP_Init_Proc (E : Entity_Id) return Boolean;
+ -- Version for CPP init procs, same as Is_TSS (E, TSS_CPP_Init_Proc);
+
+ function Is_Init_Proc (E : Entity_Id) return Boolean;
+ -- Version for init procs, same as Is_TSS (E, TSS_Init_Proc);
+
function Is_TSS (E : Entity_Id; Nam : TSS_Name_Type) return Boolean;
-- Determines if given entity (E) is the name of a TSS identified by Nam
function Is_TSS (N : Name_Id; Nam : TSS_Name_Type) return Boolean;
-- Same test applied directly to a Name_Id value
- function Is_Init_Proc (E : Entity_Id) return Boolean;
- -- Version for init procs, same as Is_TSS (E, TSS_Init_Proc);
-
-----------------------------------------
-- TSS Data structures and Subprograms --
-----------------------------------------
procedure Set_TSS (Typ : Entity_Id; TSS : Entity_Id);
-- This procedure is used to install a newly created TSS. The second
- -- argument is the entity for such a new TSS. This entity is placed in
- -- the TSS list for the type given as the first argument, replacing an
- -- old entry of the same name if one was present. The tree for the body
- -- of this TSS, which is not analyzed yet, is placed in the actions field
- -- of the freeze node for the type. All such bodies are inserted into the
- -- main tree and analyzed at the point at which the freeze node itself is
- -- is expanded.
+ -- argument is the entity for such a new TSS. This entity is placed in the
+ -- TSS list for the type given as the first argument, replacing an old
+ -- entry of the same name if one was present. The tree for the body of this
+ -- TSS, which is not analyzed yet, is placed in the actions field of the
+ -- freeze node for the type. All such bodies are inserted into the main
+ -- tree and analyzed at the point at which the freeze node itself is
+ -- expanded.
procedure Copy_TSS (TSS : Entity_Id; Typ : Entity_Id);
-- Given an existing TSS for another type (which is already installed,
-- analyzed and expanded), install it as the corresponding TSS for Typ.
- -- Note that this just copies a reference, not the tree. This can also
- -- be used to initially install a TSS in the case where the subprogram
- -- for the TSS has already been created and its declaration processed.
+ -- Note that this just copies a reference, not the tree. This can also be
+ -- used to initially install a TSS in the case where the subprogram for the
+ -- TSS has already been created and its declaration processed.
+
+ function CPP_Init_Proc (Typ : Entity_Id) return Entity_Id;
+ -- Obtains the CPP_Init TSS entity the given type. The CPP_Init TSS is a
+ -- procedure used to initialize the C++ part of the primary and secondary
+ -- dispatch tables of a tagged type derived from CPP types.
- function Init_Proc (Typ : Entity_Id) return Entity_Id;
- pragma Inline (Init_Proc);
+ function Init_Proc
+ (Typ : Entity_Id;
+ Ref : Entity_Id := Empty) return Entity_Id;
-- Obtains the _init TSS entry for the given type. This function call is
-- equivalent to TSS (Typ, Name_uInit). The _init TSS is the procedure
-- used to initialize otherwise uninitialized instances of a type. If
-- the corresponding base type (see Base_Init_Proc function). A special
-- case arises for concurrent types. Such types do not themselves have an
-- init proc TSS, but initialization is required. The init proc used is
- -- the one fot the corresponding record type (see Base_Init_Proc).
+ -- the one for the corresponding record type (see Base_Init_Proc). If
+ -- Ref is present it is call to a subprogram whose profile matches the
+ -- profile of the required constructor (this argument is used to handle
+ -- non-default CPP constructors).
- function Base_Init_Proc (Typ : Entity_Id) return Entity_Id;
+ function Base_Init_Proc
+ (Typ : Entity_Id;
+ Ref : Entity_Id := Empty) return Entity_Id;
-- Obtains the _Init TSS entry from the base type of the entity, and also
-- deals with going indirect through the Corresponding_Record_Type field
-- for concurrent objects (which are initialized with the initialization
- -- routine for the corresponding record type). Returns Empty if there is
- -- no _Init TSS entry for the base type.
+ -- routine for the corresponding record type). Returns Empty if there is no
+ -- _Init TSS entry for the base type. If Ref is present it is a call to a
+ -- subprogram whose profile matches the profile of the required constructor
+ -- (this argument is used to handle non-default CPP constructors).
procedure Set_Init_Proc (Typ : Entity_Id; Init : Entity_Id);
pragma Inline (Set_Init_Proc);
function Has_Non_Null_Base_Init_Proc (Typ : Entity_Id) return Boolean;
-- Returns true if the given type has a defined Base_Init_Proc and
-- this init proc is not a null init proc (null init procs occur as
- -- a result of the processing for Initialize_Scalars. This function
+ -- a result of the processing for Initialize_Scalars). This function
-- is used to test for the presence of an init proc in cases where
-- a null init proc is considered equivalent to no init proc.