gcc/ada/sem_util.adb

   1 ------------------------------------------------------------------------------
   2 --                                                                          --
   3 --                         GNAT COMPILER COMPONENTS                         --
   4 --                                                                          --
   5 --                             S E M _ U T I L                              --
   6 --                                                                          --
   7 --                                 B o d y                                  --
   8 --                                                                          --
   9 --          Copyright (C) 1992-2010, Free Software Foundation, Inc.         --
  10 --                                                                          --
  11 -- GNAT is free software;  you can  redistribute it  and/or modify it under --
  12 -- terms of the  GNU General Public License as published  by the Free Soft- --
  13 -- ware  Foundation;  either version 3,  or (at your option) any later ver- --
  14 -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
  15 -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
  16 -- or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License --
  17 -- for  more details.  You should have  received  a copy of the GNU General --
  18 -- Public License  distributed with GNAT; see file COPYING3.  If not, go to --
  19 -- http://www.gnu.org/licenses for a complete copy of the license.          --
  20 --                                                                          --
  21 -- GNAT was originally developed  by the GNAT team at  New York University. --
  22 -- Extensive contributions were provided by Ada Core Technologies Inc.      --
  23 --                                                                          --
  24 ------------------------------------------------------------------------------
  25
  26 with Atree;    use Atree;
  27 with Casing;   use Casing;
  28 with Checks;   use Checks;
  29 with Debug;    use Debug;
  30 with Errout;   use Errout;
  31 with Elists;   use Elists;
  32 with Exp_Ch11; use Exp_Ch11;
  33 with Exp_Disp; use Exp_Disp;
  34 with Exp_Tss;  use Exp_Tss;
  35 with Exp_Util; use Exp_Util;
  36 with Fname;    use Fname;
  37 with Freeze;   use Freeze;
  38 with Lib;      use Lib;
  39 with Lib.Xref; use Lib.Xref;
  40 with Nlists;   use Nlists;
  41 with Output;   use Output;
  42 with Opt;      use Opt;
  43 with Rtsfind;  use Rtsfind;
  44 with Sem;      use Sem;
  45 with Sem_Aux;  use Sem_Aux;
  46 with Sem_Attr; use Sem_Attr;
  47 with Sem_Ch8;  use Sem_Ch8;
  48 with Sem_Disp; use Sem_Disp;
  49 with Sem_Eval; use Sem_Eval;
  50 with Sem_Res;  use Sem_Res;
  51 with Sem_Type; use Sem_Type;
  52 with Sinfo;    use Sinfo;
  53 with Sinput;   use Sinput;
  54 with Stand;    use Stand;
  55 with Style;
  56 with Stringt;  use Stringt;
  57 with Table;
  58 with Targparm; use Targparm;
  59 with Tbuild;   use Tbuild;
  60 with Ttypes;   use Ttypes;
  61 with Uname;    use Uname;
  62
  63 with GNAT.HTable; use GNAT.HTable;
  64
  65 package body Sem_Util is
  66
  67    ----------------------------------------
  68    -- Global_Variables for New_Copy_Tree --
  69    ----------------------------------------
  70
  71    --  These global variables are used by New_Copy_Tree. See description
  72    --  of the body of this subprogram for details. Global variables can be
  73    --  safely used by New_Copy_Tree, since there is no case of a recursive
  74    --  call from the processing inside New_Copy_Tree.
  75
  76    NCT_Hash_Threshhold : constant := 20;
  77    --  If there are more than this number of pairs of entries in the
  78    --  map, then Hash_Tables_Used will be set, and the hash tables will
  79    --  be initialized and used for the searches.
  80
  81    NCT_Hash_Tables_Used : Boolean := False;
  82    --  Set to True if hash tables are in use
  83
  84    NCT_Table_Entries : Nat;
  85    --  Count entries in table to see if threshhold is reached
  86
  87    NCT_Hash_Table_Setup : Boolean := False;
  88    --  Set to True if hash table contains data. We set this True if we
  89    --  setup the hash table with data, and leave it set permanently
  90    --  from then on, this is a signal that second and subsequent users
  91    --  of the hash table must clear the old entries before reuse.
  92
  93    subtype NCT_Header_Num is Int range 0 .. 511;
  94    --  Defines range of headers in hash tables (512 headers)
  95
  96    ----------------------------------
  97    -- Order Dependence (AI05-0144) --
  98    ----------------------------------
  99
 100    --  Each actual in a call is entered into the table below. A flag indicates
 101    --  whether the corresponding formal is OUT or IN OUT. Each top-level call
 102    --  (procedure call, condition, assignment) examines all the actuals for a
 103    --  possible order dependence. The table is reset after each such check.
 104    --  The actuals to be checked in a call to Check_Order_Dependence are at
 105    --  positions 1 .. Last.
 106
 107    type Actual_Name is record
 108       Act         : Node_Id;
 109       Is_Writable : Boolean;
 110    end record;
 111
 112    package Actuals_In_Call is new Table.Table (
 113       Table_Component_Type => Actual_Name,
 114       Table_Index_Type     => Int,
 115       Table_Low_Bound      => 0,
 116       Table_Initial        => 10,
 117       Table_Increment      => 100,
 118       Table_Name           => "Actuals");
 119
 120    -----------------------
 121    -- Local Subprograms --
 122    -----------------------
 123
 124    function Build_Component_Subtype
 125      (C   : List_Id;
 126       Loc : Source_Ptr;
 127       T   : Entity_Id) return Node_Id;
 128    --  This function builds the subtype for Build_Actual_Subtype_Of_Component
 129    --  and Build_Discriminal_Subtype_Of_Component. C is a list of constraints,
 130    --  Loc is the source location, T is the original subtype.
 131
 132    function Is_Fully_Initialized_Variant (Typ : Entity_Id) return Boolean;
 133    --  Subsidiary to Is_Fully_Initialized_Type. For an unconstrained type
 134    --  with discriminants whose default values are static, examine only the
 135    --  components in the selected variant to determine whether all of them
 136    --  have a default.
 137
 138    function Has_Null_Extension (T : Entity_Id) return Boolean;
 139    --  T is a derived tagged type. Check whether the type extension is null.
 140    --  If the parent type is fully initialized, T can be treated as such.
 141
 142    ------------------------------
 143    --  Abstract_Interface_List --
 144    ------------------------------
 145
 146    function Abstract_Interface_List (Typ : Entity_Id) return List_Id is
 147       Nod : Node_Id;
 148
 149    begin
 150       if Is_Concurrent_Type (Typ) then
 151
 152          --  If we are dealing with a synchronized subtype, go to the base
 153          --  type, whose declaration has the interface list.
 154
 155          --  Shouldn't this be Declaration_Node???
 156
 157          Nod := Parent (Base_Type (Typ));
 158
 159          if Nkind (Nod) = N_Full_Type_Declaration then
 160             return Empty_List;
 161          end if;
 162
 163       elsif Ekind (Typ) = E_Record_Type_With_Private then
 164          if Nkind (Parent (Typ)) = N_Full_Type_Declaration then
 165             Nod := Type_Definition (Parent (Typ));
 166
 167          elsif Nkind (Parent (Typ)) = N_Private_Type_Declaration then
 168             if Present (Full_View (Typ)) then
 169                Nod := Type_Definition (Parent (Full_View (Typ)));
 170
 171             --  If the full-view is not available we cannot do anything else
 172             --  here (the source has errors).
 173
 174             else
 175                return Empty_List;
 176             end if;
 177
 178          --  Support for generic formals with interfaces is still missing ???
 179
 180          elsif Nkind (Parent (Typ)) = N_Formal_Type_Declaration then
 181             return Empty_List;
 182
 183          else
 184             pragma Assert
 185               (Nkind (Parent (Typ)) = N_Private_Extension_Declaration);
 186             Nod := Parent (Typ);
 187          end if;
 188
 189       elsif Ekind (Typ) = E_Record_Subtype then
 190          Nod := Type_Definition (Parent (Etype (Typ)));
 191
 192       elsif Ekind (Typ) = E_Record_Subtype_With_Private then
 193
 194          --  Recurse, because parent may still be a private extension. Also
 195          --  note that the full view of the subtype or the full view of its
 196          --  base type may (both) be unavailable.
 197
 198          return Abstract_Interface_List (Etype (Typ));
 199
 200       else pragma Assert ((Ekind (Typ)) = E_Record_Type);
 201          if Nkind (Parent (Typ)) = N_Formal_Type_Declaration then
 202             Nod := Formal_Type_Definition (Parent (Typ));
 203          else
 204             Nod := Type_Definition (Parent (Typ));
 205          end if;
 206       end if;
 207
 208       return Interface_List (Nod);
 209    end Abstract_Interface_List;
 210
 211    --------------------------------
 212    -- Add_Access_Type_To_Process --
 213    --------------------------------
 214
 215    procedure Add_Access_Type_To_Process (E : Entity_Id; A : Entity_Id) is
 216       L : Elist_Id;
 217
 218    begin
 219       Ensure_Freeze_Node (E);
 220       L := Access_Types_To_Process (Freeze_Node (E));
 221
 222       if No (L) then
 223          L := New_Elmt_List;
 224          Set_Access_Types_To_Process (Freeze_Node (E), L);
 225       end if;
 226
 227       Append_Elmt (A, L);
 228    end Add_Access_Type_To_Process;
 229
 230    ----------------------------
 231    -- Add_Global_Declaration --
 232    ----------------------------
 233
 234    procedure Add_Global_Declaration (N : Node_Id) is
 235       Aux_Node : constant Node_Id := Aux_Decls_Node (Cunit (Current_Sem_Unit));
 236
 237    begin
 238       if No (Declarations (Aux_Node)) then
 239          Set_Declarations (Aux_Node, New_List);
 240       end if;
 241
 242       Append_To (Declarations (Aux_Node), N);
 243       Analyze (N);
 244    end Add_Global_Declaration;
 245
 246    -----------------
 247    -- Addressable --
 248    -----------------
 249
 250    --  For now, just 8/16/32/64. but analyze later if AAMP is special???
 251
 252    function Addressable (V : Uint) return Boolean is
 253    begin
 254       return V = Uint_8  or else
 255              V = Uint_16 or else
 256              V = Uint_32 or else
 257              V = Uint_64;
 258    end Addressable;
 259
 260    function Addressable (V : Int) return Boolean is
 261    begin
 262       return V = 8  or else
 263              V = 16 or else
 264              V = 32 or else
 265              V = 64;
 266    end Addressable;
 267
 268    -----------------------
 269    -- Alignment_In_Bits --
 270    -----------------------
 271
 272    function Alignment_In_Bits (E : Entity_Id) return Uint is
 273    begin
 274       return Alignment (E) * System_Storage_Unit;
 275    end Alignment_In_Bits;
 276
 277    -----------------------------------------
 278    -- Apply_Compile_Time_Constraint_Error --
 279    -----------------------------------------
 280
 281    procedure Apply_Compile_Time_Constraint_Error
 282      (N      : Node_Id;
 283       Msg    : String;
 284       Reason : RT_Exception_Code;
 285       Ent    : Entity_Id  := Empty;
 286       Typ    : Entity_Id  := Empty;
 287       Loc    : Source_Ptr := No_Location;
 288       Rep    : Boolean    := True;
 289       Warn   : Boolean    := False)
 290    is
 291       Stat   : constant Boolean := Is_Static_Expression (N);
 292       R_Stat : constant Node_Id :=
 293                  Make_Raise_Constraint_Error (Sloc (N), Reason => Reason);
 294       Rtyp   : Entity_Id;
 295
 296    begin
 297       if No (Typ) then
 298          Rtyp := Etype (N);
 299       else
 300          Rtyp := Typ;
 301       end if;
 302
 303       Discard_Node
 304         (Compile_Time_Constraint_Error (N, Msg, Ent, Loc, Warn => Warn));
 305
 306       if not Rep then
 307          return;
 308       end if;
 309
 310       --  Now we replace the node by an N_Raise_Constraint_Error node
 311       --  This does not need reanalyzing, so set it as analyzed now.
 312
 313       Rewrite (N, R_Stat);
 314       Set_Analyzed (N, True);
 315
 316       Set_Etype (N, Rtyp);
 317       Set_Raises_Constraint_Error (N);
 318
 319       --  Now deal with possible local raise handling
 320
 321       Possible_Local_Raise (N, Standard_Constraint_Error);
 322
 323       --  If the original expression was marked as static, the result is
 324       --  still marked as static, but the Raises_Constraint_Error flag is
 325       --  always set so that further static evaluation is not attempted.
 326
 327       if Stat then
 328          Set_Is_Static_Expression (N);
 329       end if;
 330    end Apply_Compile_Time_Constraint_Error;
 331
 332    --------------------------------
 333    -- Bad_Predicated_Subtype_Use --
 334    --------------------------------
 335
 336    procedure Bad_Predicated_Subtype_Use
 337      (Msg : String;
 338       N   : Node_Id;
 339       Typ : Entity_Id)
 340    is
 341    begin
 342       if Has_Predicates (Typ) then
 343          if Is_Generic_Actual_Type (Typ) then
 344             Error_Msg_FE (Msg & '?', N, Typ);
 345             Error_Msg_F ("\Program_Error will be raised at run time?", N);
 346             Insert_Action (N,
 347               Make_Raise_Program_Error (Sloc (N),
 348                 Reason => PE_Bad_Predicated_Generic_Type));
 349
 350          else
 351             Error_Msg_FE (Msg, N, Typ);
 352          end if;
 353       end if;
 354    end Bad_Predicated_Subtype_Use;
 355
 356    --------------------------
 357    -- Build_Actual_Subtype --
 358    --------------------------
 359
 360    function Build_Actual_Subtype
 361      (T : Entity_Id;
 362       N : Node_Or_Entity_Id) return Node_Id
 363    is
 364       Loc : Source_Ptr;
 365       --  Normally Sloc (N), but may point to corresponding body in some cases
 366
 367       Constraints : List_Id;
 368       Decl        : Node_Id;
 369       Discr       : Entity_Id;
 370       Hi          : Node_Id;
 371       Lo          : Node_Id;
 372       Subt        : Entity_Id;
 373       Disc_Type   : Entity_Id;
 374       Obj         : Node_Id;
 375
 376    begin
 377       Loc := Sloc (N);
 378
 379       if Nkind (N) = N_Defining_Identifier then
 380          Obj := New_Reference_To (N, Loc);
 381
 382          --  If this is a formal parameter of a subprogram declaration, and
 383          --  we are compiling the body, we want the declaration for the
 384          --  actual subtype to carry the source position of the body, to
 385          --  prevent anomalies in gdb when stepping through the code.
 386
 387          if Is_Formal (N) then
 388             declare
 389                Decl : constant Node_Id := Unit_Declaration_Node (Scope (N));
 390             begin
 391                if Nkind (Decl) = N_Subprogram_Declaration
 392                  and then Present (Corresponding_Body (Decl))
 393                then
 394                   Loc := Sloc (Corresponding_Body (Decl));
 395                end if;
 396             end;
 397          end if;
 398
 399       else
 400          Obj := N;
 401       end if;
 402
 403       if Is_Array_Type (T) then
 404          Constraints := New_List;
 405          for J in 1 .. Number_Dimensions (T) loop
 406
 407             --  Build an array subtype declaration with the nominal subtype and
 408             --  the bounds of the actual. Add the declaration in front of the
 409             --  local declarations for the subprogram, for analysis before any
 410             --  reference to the formal in the body.
 411
 412             Lo :=
 413               Make_Attribute_Reference (Loc,
 414                 Prefix         =>
 415                   Duplicate_Subexpr_No_Checks (Obj, Name_Req => True),
 416                 Attribute_Name => Name_First,
 417                 Expressions    => New_List (
 418                   Make_Integer_Literal (Loc, J)));
 419
 420             Hi :=
 421               Make_Attribute_Reference (Loc,
 422                 Prefix         =>
 423                   Duplicate_Subexpr_No_Checks (Obj, Name_Req => True),
 424                 Attribute_Name => Name_Last,
 425                 Expressions    => New_List (
 426                   Make_Integer_Literal (Loc, J)));
 427
 428             Append (Make_Range (Loc, Lo, Hi), Constraints);
 429          end loop;
 430
 431       --  If the type has unknown discriminants there is no constrained
 432       --  subtype to build. This is never called for a formal or for a
 433       --  lhs, so returning the type is ok ???
 434
 435       elsif Has_Unknown_Discriminants (T) then
 436          return T;
 437
 438       else
 439          Constraints := New_List;
 440
 441          --  Type T is a generic derived type, inherit the discriminants from
 442          --  the parent type.
 443
 444          if Is_Private_Type (T)
 445            and then No (Full_View (T))
 446
 447             --  T was flagged as an error if it was declared as a formal
 448             --  derived type with known discriminants. In this case there
 449             --  is no need to look at the parent type since T already carries
 450             --  its own discriminants.
 451
 452            and then not Error_Posted (T)
 453          then
 454             Disc_Type := Etype (Base_Type (T));
 455          else
 456             Disc_Type := T;
 457          end if;
 458
 459          Discr := First_Discriminant (Disc_Type);
 460          while Present (Discr) loop
 461             Append_To (Constraints,
 462               Make_Selected_Component (Loc,
 463                 Prefix =>
 464                   Duplicate_Subexpr_No_Checks (Obj),
 465                 Selector_Name => New_Occurrence_Of (Discr, Loc)));
 466             Next_Discriminant (Discr);
 467          end loop;
 468       end if;
 469
 470       Subt := Make_Temporary (Loc, 'S', Related_Node => N);
 471       Set_Is_Internal (Subt);
 472
 473       Decl :=
 474         Make_Subtype_Declaration (Loc,
 475           Defining_Identifier => Subt,
 476           Subtype_Indication =>
 477             Make_Subtype_Indication (Loc,
 478               Subtype_Mark => New_Reference_To (T,  Loc),
 479               Constraint  =>
 480                 Make_Index_Or_Discriminant_Constraint (Loc,
 481                   Constraints => Constraints)));
 482
 483       Mark_Rewrite_Insertion (Decl);
 484       return Decl;
 485    end Build_Actual_Subtype;
 486
 487    ---------------------------------------
 488    -- Build_Actual_Subtype_Of_Component --
 489    ---------------------------------------
 490
 491    function Build_Actual_Subtype_Of_Component
 492      (T : Entity_Id;
 493       N : Node_Id) return Node_Id
 494    is
 495       Loc       : constant Source_Ptr := Sloc (N);
 496       P         : constant Node_Id    := Prefix (N);
 497       D         : Elmt_Id;
 498       Id        : Node_Id;
 499       Indx_Type : Entity_Id;
 500
 501       Deaccessed_T : Entity_Id;
 502       --  This is either a copy of T, or if T is an access type, then it is
 503       --  the directly designated type of this access type.
 504
 505       function Build_Actual_Array_Constraint return List_Id;
 506       --  If one or more of the bounds of the component depends on
 507       --  discriminants, build  actual constraint using the discriminants
 508       --  of the prefix.
 509
 510       function Build_Actual_Record_Constraint return List_Id;
 511       --  Similar to previous one, for discriminated components constrained
 512       --  by the discriminant of the enclosing object.
 513
 514       -----------------------------------
 515       -- Build_Actual_Array_Constraint --
 516       -----------------------------------
 517
 518       function Build_Actual_Array_Constraint return List_Id is
 519          Constraints : constant List_Id := New_List;
 520          Indx        : Node_Id;
 521          Hi          : Node_Id;
 522          Lo          : Node_Id;
 523          Old_Hi      : Node_Id;
 524          Old_Lo      : Node_Id;
 525
 526       begin
 527          Indx := First_Index (Deaccessed_T);
 528          while Present (Indx) loop
 529             Old_Lo := Type_Low_Bound  (Etype (Indx));
 530             Old_Hi := Type_High_Bound (Etype (Indx));
 531
 532             if Denotes_Discriminant (Old_Lo) then
 533                Lo :=
 534                  Make_Selected_Component (Loc,
 535                    Prefix => New_Copy_Tree (P),
 536                    Selector_Name => New_Occurrence_Of (Entity (Old_Lo), Loc));
 537
 538             else
 539                Lo := New_Copy_Tree (Old_Lo);
 540
 541                --  The new bound will be reanalyzed in the enclosing
 542                --  declaration. For literal bounds that come from a type
 543                --  declaration, the type of the context must be imposed, so
 544                --  insure that analysis will take place. For non-universal
 545                --  types this is not strictly necessary.
 546
 547                Set_Analyzed (Lo, False);
 548             end if;
 549
 550             if Denotes_Discriminant (Old_Hi) then
 551                Hi :=
 552                  Make_Selected_Component (Loc,
 553                    Prefix => New_Copy_Tree (P),
 554                    Selector_Name => New_Occurrence_Of (Entity (Old_Hi), Loc));
 555
 556             else
 557                Hi := New_Copy_Tree (Old_Hi);
 558                Set_Analyzed (Hi, False);
 559             end if;
 560
 561             Append (Make_Range (Loc, Lo, Hi), Constraints);
 562             Next_Index (Indx);
 563          end loop;
 564
 565          return Constraints;
 566       end Build_Actual_Array_Constraint;
 567
 568       ------------------------------------
 569       -- Build_Actual_Record_Constraint --
 570       ------------------------------------
 571
 572       function Build_Actual_Record_Constraint return List_Id is
 573          Constraints : constant List_Id := New_List;
 574          D           : Elmt_Id;
 575          D_Val       : Node_Id;
 576
 577       begin
 578          D := First_Elmt (Discriminant_Constraint (Deaccessed_T));
 579          while Present (D) loop
 580             if Denotes_Discriminant (Node (D)) then
 581                D_Val :=  Make_Selected_Component (Loc,
 582                  Prefix => New_Copy_Tree (P),
 583                 Selector_Name => New_Occurrence_Of (Entity (Node (D)), Loc));
 584
 585             else
 586                D_Val := New_Copy_Tree (Node (D));
 587             end if;
 588
 589             Append (D_Val, Constraints);
 590             Next_Elmt (D);
 591          end loop;
 592
 593          return Constraints;
 594       end Build_Actual_Record_Constraint;
 595
 596    --  Start of processing for Build_Actual_Subtype_Of_Component
 597
 598    begin
 599       --  Why the test for Spec_Expression mode here???
 600
 601       if In_Spec_Expression then
 602          return Empty;
 603
 604       --  More comments for the rest of this body would be good ???
 605
 606       elsif Nkind (N) = N_Explicit_Dereference then
 607          if Is_Composite_Type (T)
 608            and then not Is_Constrained (T)
 609            and then not (Is_Class_Wide_Type (T)
 610                           and then Is_Constrained (Root_Type (T)))
 611            and then not Has_Unknown_Discriminants (T)
 612          then
 613             --  If the type of the dereference is already constrained, it is an
 614             --  actual subtype.
 615
 616             if Is_Array_Type (Etype (N))
 617               and then Is_Constrained (Etype (N))
 618             then
 619                return Empty;
 620             else
 621                Remove_Side_Effects (P);
 622                return Build_Actual_Subtype (T, N);
 623             end if;
 624          else
 625             return Empty;
 626          end if;
 627       end if;
 628
 629       if Ekind (T) = E_Access_Subtype then
 630          Deaccessed_T := Designated_Type (T);
 631       else
 632          Deaccessed_T := T;
 633       end if;
 634
 635       if Ekind (Deaccessed_T) = E_Array_Subtype then
 636          Id := First_Index (Deaccessed_T);
 637          while Present (Id) loop
 638             Indx_Type := Underlying_Type (Etype (Id));
 639
 640             if Denotes_Discriminant (Type_Low_Bound  (Indx_Type))
 641                  or else
 642                Denotes_Discriminant (Type_High_Bound (Indx_Type))
 643             then
 644                Remove_Side_Effects (P);
 645                return
 646                  Build_Component_Subtype
 647                    (Build_Actual_Array_Constraint, Loc, Base_Type (T));
 648             end if;
 649
 650             Next_Index (Id);
 651          end loop;
 652
 653       elsif Is_Composite_Type (Deaccessed_T)
 654         and then Has_Discriminants (Deaccessed_T)
 655         and then not Has_Unknown_Discriminants (Deaccessed_T)
 656       then
 657          D := First_Elmt (Discriminant_Constraint (Deaccessed_T));
 658          while Present (D) loop
 659             if Denotes_Discriminant (Node (D)) then
 660                Remove_Side_Effects (P);
 661                return
 662                  Build_Component_Subtype (
 663                    Build_Actual_Record_Constraint, Loc, Base_Type (T));
 664             end if;
 665
 666             Next_Elmt (D);
 667          end loop;
 668       end if;
 669
 670       --  If none of the above, the actual and nominal subtypes are the same
 671
 672       return Empty;
 673    end Build_Actual_Subtype_Of_Component;
 674
 675    -----------------------------
 676    -- Build_Component_Subtype --
 677    -----------------------------
 678
 679    function Build_Component_Subtype
 680      (C   : List_Id;
 681       Loc : Source_Ptr;
 682       T   : Entity_Id) return Node_Id
 683    is
 684       Subt : Entity_Id;
 685       Decl : Node_Id;
 686
 687    begin
 688       --  Unchecked_Union components do not require component subtypes
 689
 690       if Is_Unchecked_Union (T) then
 691          return Empty;
 692       end if;
 693
 694       Subt := Make_Temporary (Loc, 'S');
 695       Set_Is_Internal (Subt);
 696
 697       Decl :=
 698         Make_Subtype_Declaration (Loc,
 699           Defining_Identifier => Subt,
 700           Subtype_Indication =>
 701             Make_Subtype_Indication (Loc,
 702               Subtype_Mark => New_Reference_To (Base_Type (T),  Loc),
 703               Constraint  =>
 704                 Make_Index_Or_Discriminant_Constraint (Loc,
 705                   Constraints => C)));
 706
 707       Mark_Rewrite_Insertion (Decl);
 708       return Decl;
 709    end Build_Component_Subtype;
 710
 711    ---------------------------
 712    -- Build_Default_Subtype --
 713    ---------------------------
 714
 715    function Build_Default_Subtype
 716      (T : Entity_Id;
 717       N : Node_Id) return Entity_Id
 718    is
 719       Loc  : constant Source_Ptr := Sloc (N);
 720       Disc : Entity_Id;
 721
 722    begin
 723       if not Has_Discriminants (T) or else Is_Constrained (T) then
 724          return T;
 725       end if;
 726
 727       Disc := First_Discriminant (T);
 728
 729       if No (Discriminant_Default_Value (Disc)) then
 730          return T;
 731       end if;
 732
 733       declare
 734          Act         : constant Entity_Id := Make_Temporary (Loc, 'S');
 735          Constraints : constant List_Id := New_List;
 736          Decl        : Node_Id;
 737
 738       begin
 739          while Present (Disc) loop
 740             Append_To (Constraints,
 741               New_Copy_Tree (Discriminant_Default_Value (Disc)));
 742             Next_Discriminant (Disc);
 743          end loop;
 744
 745          Decl :=
 746            Make_Subtype_Declaration (Loc,
 747              Defining_Identifier => Act,
 748              Subtype_Indication =>
 749                Make_Subtype_Indication (Loc,
 750                  Subtype_Mark => New_Occurrence_Of (T, Loc),
 751                  Constraint =>
 752                    Make_Index_Or_Discriminant_Constraint (Loc,
 753                      Constraints => Constraints)));
 754
 755          Insert_Action (N, Decl);
 756          Analyze (Decl);
 757          return Act;
 758       end;
 759    end Build_Default_Subtype;
 760
 761    --------------------------------------------
 762    -- Build_Discriminal_Subtype_Of_Component --
 763    --------------------------------------------
 764
 765    function Build_Discriminal_Subtype_Of_Component
 766      (T : Entity_Id) return Node_Id
 767    is
 768       Loc : constant Source_Ptr := Sloc (T);
 769       D   : Elmt_Id;
 770       Id  : Node_Id;
 771
 772       function Build_Discriminal_Array_Constraint return List_Id;
 773       --  If one or more of the bounds of the component depends on
 774       --  discriminants, build  actual constraint using the discriminants
 775       --  of the prefix.
 776
 777       function Build_Discriminal_Record_Constraint return List_Id;
 778       --  Similar to previous one, for discriminated components constrained
 779       --  by the discriminant of the enclosing object.
 780
 781       ----------------------------------------
 782       -- Build_Discriminal_Array_Constraint --
 783       ----------------------------------------
 784
 785       function Build_Discriminal_Array_Constraint return List_Id is
 786          Constraints : constant List_Id := New_List;
 787          Indx        : Node_Id;
 788          Hi          : Node_Id;
 789          Lo          : Node_Id;
 790          Old_Hi      : Node_Id;
 791          Old_Lo      : Node_Id;
 792
 793       begin
 794          Indx := First_Index (T);
 795          while Present (Indx) loop
 796             Old_Lo := Type_Low_Bound  (Etype (Indx));
 797             Old_Hi := Type_High_Bound (Etype (Indx));
 798
 799             if Denotes_Discriminant (Old_Lo) then
 800                Lo := New_Occurrence_Of (Discriminal (Entity (Old_Lo)), Loc);
 801
 802             else
 803                Lo := New_Copy_Tree (Old_Lo);
 804             end if;
 805
 806             if Denotes_Discriminant (Old_Hi) then
 807                Hi := New_Occurrence_Of (Discriminal (Entity (Old_Hi)), Loc);
 808
 809             else
 810                Hi := New_Copy_Tree (Old_Hi);
 811             end if;
 812
 813             Append (Make_Range (Loc, Lo, Hi), Constraints);
 814             Next_Index (Indx);
 815          end loop;
 816
 817          return Constraints;
 818       end Build_Discriminal_Array_Constraint;
 819
 820       -----------------------------------------
 821       -- Build_Discriminal_Record_Constraint --
 822       -----------------------------------------
 823
 824       function Build_Discriminal_Record_Constraint return List_Id is
 825          Constraints : constant List_Id := New_List;
 826          D           : Elmt_Id;
 827          D_Val       : Node_Id;
 828
 829       begin
 830          D := First_Elmt (Discriminant_Constraint (T));
 831          while Present (D) loop
 832             if Denotes_Discriminant (Node (D)) then
 833                D_Val :=
 834                  New_Occurrence_Of (Discriminal (Entity (Node (D))), Loc);
 835
 836             else
 837                D_Val := New_Copy_Tree (Node (D));
 838             end if;
 839
 840             Append (D_Val, Constraints);
 841             Next_Elmt (D);
 842          end loop;
 843
 844          return Constraints;
 845       end Build_Discriminal_Record_Constraint;
 846
 847    --  Start of processing for Build_Discriminal_Subtype_Of_Component
 848
 849    begin
 850       if Ekind (T) = E_Array_Subtype then
 851          Id := First_Index (T);
 852          while Present (Id) loop
 853             if Denotes_Discriminant (Type_Low_Bound  (Etype (Id))) or else
 854                Denotes_Discriminant (Type_High_Bound (Etype (Id)))
 855             then
 856                return Build_Component_Subtype
 857                  (Build_Discriminal_Array_Constraint, Loc, T);
 858             end if;
 859
 860             Next_Index (Id);
 861          end loop;
 862
 863       elsif Ekind (T) = E_Record_Subtype
 864         and then Has_Discriminants (T)
 865         and then not Has_Unknown_Discriminants (T)
 866       then
 867          D := First_Elmt (Discriminant_Constraint (T));
 868          while Present (D) loop
 869             if Denotes_Discriminant (Node (D)) then
 870                return Build_Component_Subtype
 871                  (Build_Discriminal_Record_Constraint, Loc, T);
 872             end if;
 873
 874             Next_Elmt (D);
 875          end loop;
 876       end if;
 877
 878       --  If none of the above, the actual and nominal subtypes are the same
 879
 880       return Empty;
 881    end Build_Discriminal_Subtype_Of_Component;
 882
 883    ------------------------------
 884    -- Build_Elaboration_Entity --
 885    ------------------------------
 886
 887    procedure Build_Elaboration_Entity (N : Node_Id; Spec_Id : Entity_Id) is
 888       Loc      : constant Source_Ptr := Sloc (N);
 889       Decl     : Node_Id;
 890       Elab_Ent : Entity_Id;
 891
 892       procedure Set_Package_Name (Ent : Entity_Id);
 893       --  Given an entity, sets the fully qualified name of the entity in
 894       --  Name_Buffer, with components separated by double underscores. This
 895       --  is a recursive routine that climbs the scope chain to Standard.
 896
 897       ----------------------
 898       -- Set_Package_Name --
 899       ----------------------
 900
 901       procedure Set_Package_Name (Ent : Entity_Id) is
 902       begin
 903          if Scope (Ent) /= Standard_Standard then
 904             Set_Package_Name (Scope (Ent));
 905
 906             declare
 907                Nam : constant String := Get_Name_String (Chars (Ent));
 908             begin
 909                Name_Buffer (Name_Len + 1) := '_';
 910                Name_Buffer (Name_Len + 2) := '_';
 911                Name_Buffer (Name_Len + 3 .. Name_Len + Nam'Length + 2) := Nam;
 912                Name_Len := Name_Len + Nam'Length + 2;
 913             end;
 914
 915          else
 916             Get_Name_String (Chars (Ent));
 917          end if;
 918       end Set_Package_Name;
 919
 920    --  Start of processing for Build_Elaboration_Entity
 921
 922    begin
 923       --  Ignore if already constructed
 924
 925       if Present (Elaboration_Entity (Spec_Id)) then
 926          return;
 927       end if;
 928
 929       --  Construct name of elaboration entity as xxx_E, where xxx is the unit
 930       --  name with dots replaced by double underscore. We have to manually
 931       --  construct this name, since it will be elaborated in the outer scope,
 932       --  and thus will not have the unit name automatically prepended.
 933
 934       Set_Package_Name (Spec_Id);
 935
 936       --  Append _E
 937
 938       Name_Buffer (Name_Len + 1) := '_';
 939       Name_Buffer (Name_Len + 2) := 'E';
 940       Name_Len := Name_Len + 2;
 941
 942       --  Create elaboration flag
 943
 944       Elab_Ent :=
 945         Make_Defining_Identifier (Loc, Chars => Name_Find);
 946       Set_Elaboration_Entity (Spec_Id, Elab_Ent);
 947
 948       Decl :=
 949          Make_Object_Declaration (Loc,
 950            Defining_Identifier => Elab_Ent,
 951            Object_Definition   =>
 952              New_Occurrence_Of (Standard_Boolean, Loc),
 953            Expression          =>
 954              New_Occurrence_Of (Standard_False, Loc));
 955
 956       Push_Scope (Standard_Standard);
 957       Add_Global_Declaration (Decl);
 958       Pop_Scope;
 959
 960       --  Reset True_Constant indication, since we will indeed assign a value
 961       --  to the variable in the binder main. We also kill the Current_Value
 962       --  and Last_Assignment fields for the same reason.
 963
 964       Set_Is_True_Constant (Elab_Ent, False);
 965       Set_Current_Value    (Elab_Ent, Empty);
 966       Set_Last_Assignment  (Elab_Ent, Empty);
 967
 968       --  We do not want any further qualification of the name (if we did
 969       --  not do this, we would pick up the name of the generic package
 970       --  in the case of a library level generic instantiation).
 971
 972       Set_Has_Qualified_Name       (Elab_Ent);
 973       Set_Has_Fully_Qualified_Name (Elab_Ent);
 974    end Build_Elaboration_Entity;
 975
 976    -----------------------------------
 977    -- Cannot_Raise_Constraint_Error --
 978    -----------------------------------
 979
 980    function Cannot_Raise_Constraint_Error (Expr : Node_Id) return Boolean is
 981    begin
 982       if Compile_Time_Known_Value (Expr) then
 983          return True;
 984
 985       elsif Do_Range_Check (Expr) then
 986          return False;
 987
 988       elsif Raises_Constraint_Error (Expr) then
 989          return False;
 990
 991       else
 992          case Nkind (Expr) is
 993             when N_Identifier =>
 994                return True;
 995
 996             when N_Expanded_Name =>
 997                return True;
 998
 999             when N_Selected_Component =>
1000                return not Do_Discriminant_Check (Expr);
1001
1002             when N_Attribute_Reference =>
1003                if Do_Overflow_Check (Expr) then
1004                   return False;
1005
1006                elsif No (Expressions (Expr)) then
1007                   return True;
1008
1009                else
1010                   declare
1011                      N : Node_Id;
1012
1013                   begin
1014                      N := First (Expressions (Expr));
1015                      while Present (N) loop
1016                         if Cannot_Raise_Constraint_Error (N) then
1017                            Next (N);
1018                         else
1019                            return False;
1020                         end if;
1021                      end loop;
1022
1023                      return True;
1024                   end;
1025                end if;
1026
1027             when N_Type_Conversion =>
1028                if Do_Overflow_Check (Expr)
1029                  or else Do_Length_Check (Expr)
1030                  or else Do_Tag_Check (Expr)
1031                then
1032                   return False;
1033                else
1034                   return
1035                     Cannot_Raise_Constraint_Error (Expression (Expr));
1036                end if;
1037
1038             when N_Unchecked_Type_Conversion =>
1039                return Cannot_Raise_Constraint_Error (Expression (Expr));
1040
1041             when N_Unary_Op =>
1042                if Do_Overflow_Check (Expr) then
1043                   return False;
1044                else
1045                   return
1046                     Cannot_Raise_Constraint_Error (Right_Opnd (Expr));
1047                end if;
1048
1049             when N_Op_Divide |
1050                  N_Op_Mod    |
1051                  N_Op_Rem
1052             =>
1053                if Do_Division_Check (Expr)
1054                  or else Do_Overflow_Check (Expr)
1055                then
1056                   return False;
1057                else
1058                   return
1059                     Cannot_Raise_Constraint_Error (Left_Opnd (Expr))
1060                       and then
1061                     Cannot_Raise_Constraint_Error (Right_Opnd (Expr));
1062                end if;
1063
1064             when N_Op_Add                    |
1065                  N_Op_And                    |
1066                  N_Op_Concat                 |
1067                  N_Op_Eq                     |
1068                  N_Op_Expon                  |
1069                  N_Op_Ge                     |
1070                  N_Op_Gt                     |
1071                  N_Op_Le                     |
1072                  N_Op_Lt                     |
1073                  N_Op_Multiply               |
1074                  N_Op_Ne                     |
1075                  N_Op_Or                     |
1076                  N_Op_Rotate_Left            |
1077                  N_Op_Rotate_Right           |
1078                  N_Op_Shift_Left             |
1079                  N_Op_Shift_Right            |
1080                  N_Op_Shift_Right_Arithmetic |
1081                  N_Op_Subtract               |
1082                  N_Op_Xor
1083             =>
1084                if Do_Overflow_Check (Expr) then
1085                   return False;
1086                else
1087                   return
1088                     Cannot_Raise_Constraint_Error (Left_Opnd (Expr))
1089                       and then
1090                     Cannot_Raise_Constraint_Error (Right_Opnd (Expr));
1091                end if;
1092
1093             when others =>
1094                return False;
1095          end case;
1096       end if;
1097    end Cannot_Raise_Constraint_Error;
1098
1099    -----------------------------------------
1100    -- Check_Dynamically_Tagged_Expression --
1101    -----------------------------------------
1102
1103    procedure Check_Dynamically_Tagged_Expression
1104      (Expr        : Node_Id;
1105       Typ         : Entity_Id;
1106       Related_Nod : Node_Id)
1107    is
1108    begin
1109       pragma Assert (Is_Tagged_Type (Typ));
1110
1111       --  In order to avoid spurious errors when analyzing the expanded code,
1112       --  this check is done only for nodes that come from source and for
1113       --  actuals of generic instantiations.
1114
1115       if (Comes_From_Source (Related_Nod)
1116            or else In_Generic_Actual (Expr))
1117         and then (Is_Class_Wide_Type (Etype (Expr))
1118                    or else Is_Dynamically_Tagged (Expr))
1119         and then Is_Tagged_Type (Typ)
1120         and then not Is_Class_Wide_Type (Typ)
1121       then
1122          Error_Msg_N ("dynamically tagged expression not allowed!", Expr);
1123       end if;
1124    end Check_Dynamically_Tagged_Expression;
1125
1126    --------------------------
1127    -- Check_Fully_Declared --
1128    --------------------------
1129
1130    procedure Check_Fully_Declared (T : Entity_Id; N : Node_Id) is
1131    begin
1132       if Ekind (T) = E_Incomplete_Type then
1133
1134          --  Ada 2005 (AI-50217): If the type is available through a limited
1135          --  with_clause, verify that its full view has been analyzed.
1136
1137          if From_With_Type (T)
1138            and then Present (Non_Limited_View (T))
1139            and then Ekind (Non_Limited_View (T)) /= E_Incomplete_Type
1140          then
1141             --  The non-limited view is fully declared
1142             null;
1143
1144          else
1145             Error_Msg_NE
1146               ("premature usage of incomplete}", N, First_Subtype (T));
1147          end if;
1148
1149       --  Need comments for these tests ???
1150
1151       elsif Has_Private_Component (T)
1152         and then not Is_Generic_Type (Root_Type (T))
1153         and then not In_Spec_Expression
1154       then
1155          --  Special case: if T is the anonymous type created for a single
1156          --  task or protected object, use the name of the source object.
1157
1158          if Is_Concurrent_Type (T)
1159            and then not Comes_From_Source (T)
1160            and then Nkind (N) = N_Object_Declaration
1161          then
1162             Error_Msg_NE ("type of& has incomplete component", N,
1163               Defining_Identifier (N));
1164
1165          else
1166             Error_Msg_NE
1167               ("premature usage of incomplete}", N, First_Subtype (T));
1168          end if;
1169       end if;
1170    end Check_Fully_Declared;
1171
1172    -------------------------
1173    -- Check_Nested_Access --
1174    -------------------------
1175
1176    procedure Check_Nested_Access (Ent : Entity_Id) is
1177       Scop         : constant Entity_Id := Current_Scope;
1178       Current_Subp : Entity_Id;
1179       Enclosing    : Entity_Id;
1180
1181    begin
1182       --  Currently only enabled for VM back-ends for efficiency, should we
1183       --  enable it more systematically ???
1184
1185       --  Check for Is_Imported needs commenting below ???
1186
1187       if VM_Target /= No_VM
1188         and then (Ekind (Ent) = E_Variable
1189                     or else
1190                   Ekind (Ent) = E_Constant
1191                     or else
1192                   Ekind (Ent) = E_Loop_Parameter)
1193         and then Scope (Ent) /= Empty
1194         and then not Is_Library_Level_Entity (Ent)
1195         and then not Is_Imported (Ent)
1196       then
1197          if Is_Subprogram (Scop)
1198            or else Is_Generic_Subprogram (Scop)
1199            or else Is_Entry (Scop)
1200          then
1201             Current_Subp := Scop;
1202          else
1203             Current_Subp := Current_Subprogram;
1204          end if;
1205
1206          Enclosing := Enclosing_Subprogram (Ent);
1207
1208          if Enclosing /= Empty
1209            and then Enclosing /= Current_Subp
1210          then
1211             Set_Has_Up_Level_Access (Ent, True);
1212          end if;
1213       end if;
1214    end Check_Nested_Access;
1215
1216    ----------------------------
1217    -- Check_Order_Dependence --
1218    ----------------------------
1219
1220    procedure Check_Order_Dependence is
1221       Act1 : Node_Id;
1222       Act2 : Node_Id;
1223
1224    begin
1225       if Ada_Version < Ada_2012 then
1226          return;
1227       end if;
1228
1229       --  Ada 2012 AI04-0144-2: Dangerous order dependence. Actuals in nested
1230       --  calls within a construct have been collected. If one of them is
1231       --  writable and overlaps with another one, evaluation of the enclosing
1232       --  construct is nondeterministic. This is illegal in Ada 2012, but is
1233       --  treated as a warning for now.
1234
1235       for J in 1 .. Actuals_In_Call.Last loop
1236          if Actuals_In_Call.Table (J).Is_Writable then
1237             Act1 := Actuals_In_Call.Table (J).Act;
1238
1239             if Nkind (Act1) = N_Attribute_Reference then
1240                Act1 := Prefix (Act1);
1241             end if;
1242
1243             for K in 1 .. Actuals_In_Call.Last loop
1244                if K /= J then
1245                   Act2 := Actuals_In_Call.Table (K).Act;
1246
1247                   if Nkind (Act2) = N_Attribute_Reference then
1248                      Act2 := Prefix (Act2);
1249                   end if;
1250
1251                   if Actuals_In_Call.Table (K).Is_Writable
1252                     and then K < J
1253                   then
1254                      --  Already checked
1255
1256                      null;
1257
1258                   elsif Denotes_Same_Object (Act1, Act2)
1259                     and then Parent (Act1) /= Parent (Act2)
1260                   then
1261                      Error_Msg_N
1262                        ("result may differ if evaluated "
1263                         & "after other actual in expression?", Act1);
1264                   end if;
1265                end if;
1266             end loop;
1267          end if;
1268       end loop;
1269
1270       --  Remove checked actuals from table
1271
1272       Actuals_In_Call.Set_Last (0);
1273    end Check_Order_Dependence;
1274
1275    ------------------------------------------
1276    -- Check_Potentially_Blocking_Operation --
1277    ------------------------------------------
1278
1279    procedure Check_Potentially_Blocking_Operation (N : Node_Id) is
1280       S : Entity_Id;
1281
1282    begin
1283       --  N is one of the potentially blocking operations listed in 9.5.1(8).
1284       --  When pragma Detect_Blocking is active, the run time will raise
1285       --  Program_Error. Here we only issue a warning, since we generally
1286       --  support the use of potentially blocking operations in the absence
1287       --  of the pragma.
1288
1289       --  Indirect blocking through a subprogram call cannot be diagnosed
1290       --  statically without interprocedural analysis, so we do not attempt
1291       --  to do it here.
1292
1293       S := Scope (Current_Scope);
1294       while Present (S) and then S /= Standard_Standard loop
1295          if Is_Protected_Type (S) then
1296             Error_Msg_N
1297               ("potentially blocking operation in protected operation?", N);
1298             return;
1299          end if;
1300
1301          S := Scope (S);
1302       end loop;
1303    end Check_Potentially_Blocking_Operation;
1304
1305    ------------------------------
1306    -- Check_Unprotected_Access --
1307    ------------------------------
1308
1309    procedure Check_Unprotected_Access
1310      (Context : Node_Id;
1311       Expr    : Node_Id)
1312    is
1313       Cont_Encl_Typ : Entity_Id;
1314       Pref_Encl_Typ : Entity_Id;
1315
1316       function Enclosing_Protected_Type (Obj : Node_Id) return Entity_Id;
1317       --  Check whether Obj is a private component of a protected object.
1318       --  Return the protected type where the component resides, Empty
1319       --  otherwise.
1320
1321       function Is_Public_Operation return Boolean;
1322       --  Verify that the enclosing operation is callable from outside the
1323       --  protected object, to minimize false positives.
1324
1325       ------------------------------
1326       -- Enclosing_Protected_Type --
1327       ------------------------------
1328
1329       function Enclosing_Protected_Type (Obj : Node_Id) return Entity_Id is
1330       begin
1331          if Is_Entity_Name (Obj) then
1332             declare
1333                Ent : Entity_Id := Entity (Obj);
1334
1335             begin
1336                --  The object can be a renaming of a private component, use
1337                --  the original record component.
1338
1339                if Is_Prival (Ent) then
1340                   Ent := Prival_Link (Ent);
1341                end if;
1342
1343                if Is_Protected_Type (Scope (Ent)) then
1344                   return Scope (Ent);
1345                end if;
1346             end;
1347          end if;
1348
1349          --  For indexed and selected components, recursively check the prefix
1350
1351          if Nkind_In (Obj, N_Indexed_Component, N_Selected_Component) then
1352             return Enclosing_Protected_Type (Prefix (Obj));
1353
1354          --  The object does not denote a protected component
1355
1356          else
1357             return Empty;
1358          end if;
1359       end Enclosing_Protected_Type;
1360
1361       -------------------------
1362       -- Is_Public_Operation --
1363       -------------------------
1364
1365       function Is_Public_Operation return Boolean is
1366          S : Entity_Id;
1367          E : Entity_Id;
1368
1369       begin
1370          S := Current_Scope;
1371          while Present (S)
1372            and then S /= Pref_Encl_Typ
1373          loop
1374             if Scope (S) = Pref_Encl_Typ then
1375                E := First_Entity (Pref_Encl_Typ);
1376                while Present (E)
1377                  and then E /= First_Private_Entity (Pref_Encl_Typ)
1378                loop
1379                   if E = S then
1380                      return True;
1381                   end if;
1382                   Next_Entity (E);
1383                end loop;
1384             end if;
1385
1386             S := Scope (S);
1387          end loop;
1388
1389          return False;
1390       end Is_Public_Operation;
1391
1392    --  Start of processing for Check_Unprotected_Access
1393
1394    begin
1395       if Nkind (Expr) = N_Attribute_Reference
1396         and then Attribute_Name (Expr) = Name_Unchecked_Access
1397       then
1398          Cont_Encl_Typ := Enclosing_Protected_Type (Context);
1399          Pref_Encl_Typ := Enclosing_Protected_Type (Prefix (Expr));
1400
1401          --  Check whether we are trying to export a protected component to a
1402          --  context with an equal or lower access level.
1403
1404          if Present (Pref_Encl_Typ)
1405            and then No (Cont_Encl_Typ)
1406            and then Is_Public_Operation
1407            and then Scope_Depth (Pref_Encl_Typ) >=
1408                       Object_Access_Level (Context)
1409          then
1410             Error_Msg_N
1411               ("?possible unprotected access to protected data", Expr);
1412          end if;
1413       end if;
1414    end Check_Unprotected_Access;
1415
1416    ---------------
1417    -- Check_VMS --
1418    ---------------
1419
1420    procedure Check_VMS (Construct : Node_Id) is
1421    begin
1422       if not OpenVMS_On_Target then
1423          Error_Msg_N
1424            ("this construct is allowed only in Open'V'M'S", Construct);
1425       end if;
1426    end Check_VMS;
1427
1428    ------------------------
1429    -- Collect_Interfaces --
1430    ------------------------
1431
1432    procedure Collect_Interfaces
1433      (T               : Entity_Id;
1434       Ifaces_List     : out Elist_Id;
1435       Exclude_Parents : Boolean := False;
1436       Use_Full_View   : Boolean := True)
1437    is
1438       procedure Collect (Typ : Entity_Id);
1439       --  Subsidiary subprogram used to traverse the whole list
1440       --  of directly and indirectly implemented interfaces
1441
1442       -------------
1443       -- Collect --
1444       -------------
1445
1446       procedure Collect (Typ : Entity_Id) is
1447          Ancestor   : Entity_Id;
1448          Full_T     : Entity_Id;
1449          Id         : Node_Id;
1450          Iface      : Entity_Id;
1451
1452       begin
1453          Full_T := Typ;
1454
1455          --  Handle private types
1456
1457          if Use_Full_View
1458            and then Is_Private_Type (Typ)
1459            and then Present (Full_View (Typ))
1460          then
1461             Full_T := Full_View (Typ);
1462          end if;
1463
1464          --  Include the ancestor if we are generating the whole list of
1465          --  abstract interfaces.
1466
1467          if Etype (Full_T) /= Typ
1468
1469             --  Protect the frontend against wrong sources. For example:
1470
1471             --    package P is
1472             --      type A is tagged null record;
1473             --      type B is new A with private;
1474             --      type C is new A with private;
1475             --    private
1476             --      type B is new C with null record;
1477             --      type C is new B with null record;
1478             --    end P;
1479
1480            and then Etype (Full_T) /= T
1481          then
1482             Ancestor := Etype (Full_T);
1483             Collect (Ancestor);
1484
1485             if Is_Interface (Ancestor)
1486               and then not Exclude_Parents
1487             then
1488                Append_Unique_Elmt (Ancestor, Ifaces_List);
1489             end if;
1490          end if;
1491
1492          --  Traverse the graph of ancestor interfaces
1493
1494          if Is_Non_Empty_List (Abstract_Interface_List (Full_T)) then
1495             Id := First (Abstract_Interface_List (Full_T));
1496             while Present (Id) loop
1497                Iface := Etype (Id);
1498
1499                --  Protect against wrong uses. For example:
1500                --    type I is interface;
1501                --    type O is tagged null record;
1502                --    type Wrong is new I and O with null record; -- ERROR
1503
1504                if Is_Interface (Iface) then
1505                   if Exclude_Parents
1506                     and then Etype (T) /= T
1507                     and then Interface_Present_In_Ancestor (Etype (T), Iface)
1508                   then
1509                      null;
1510                   else
1511                      Collect (Iface);
1512                      Append_Unique_Elmt (Iface, Ifaces_List);
1513                   end if;
1514                end if;
1515
1516                Next (Id);
1517             end loop;
1518          end if;
1519       end Collect;
1520
1521    --  Start of processing for Collect_Interfaces
1522
1523    begin
1524       pragma Assert (Is_Tagged_Type (T) or else Is_Concurrent_Type (T));
1525       Ifaces_List := New_Elmt_List;
1526       Collect (T);
1527    end Collect_Interfaces;
1528
1529    ----------------------------------
1530    -- Collect_Interface_Components --
1531    ----------------------------------
1532
1533    procedure Collect_Interface_Components
1534      (Tagged_Type     : Entity_Id;
1535       Components_List : out Elist_Id)
1536    is
1537       procedure Collect (Typ : Entity_Id);
1538       --  Subsidiary subprogram used to climb to the parents
1539
1540       -------------
1541       -- Collect --
1542       -------------
1543
1544       procedure Collect (Typ : Entity_Id) is
1545          Tag_Comp   : Entity_Id;
1546          Parent_Typ : Entity_Id;
1547
1548       begin
1549          --  Handle private types
1550
1551          if Present (Full_View (Etype (Typ))) then
1552             Parent_Typ := Full_View (Etype (Typ));
1553          else
1554             Parent_Typ := Etype (Typ);
1555          end if;
1556
1557          if Parent_Typ /= Typ
1558
1559             --  Protect the frontend against wrong sources. For example:
1560
1561             --    package P is
1562             --      type A is tagged null record;
1563             --      type B is new A with private;
1564             --      type C is new A with private;
1565             --    private
1566             --      type B is new C with null record;
1567             --      type C is new B with null record;
1568             --    end P;
1569
1570            and then Parent_Typ /= Tagged_Type
1571          then
1572             Collect (Parent_Typ);
1573          end if;
1574
1575          --  Collect the components containing tags of secondary dispatch
1576          --  tables.
1577
1578          Tag_Comp := Next_Tag_Component (First_Tag_Component (Typ));
1579          while Present (Tag_Comp) loop
1580             pragma Assert (Present (Related_Type (Tag_Comp)));
1581             Append_Elmt (Tag_Comp, Components_List);
1582
1583             Tag_Comp := Next_Tag_Component (Tag_Comp);
1584          end loop;
1585       end Collect;
1586
1587    --  Start of processing for Collect_Interface_Components
1588
1589    begin
1590       pragma Assert (Ekind (Tagged_Type) = E_Record_Type
1591         and then Is_Tagged_Type (Tagged_Type));
1592
1593       Components_List := New_Elmt_List;
1594       Collect (Tagged_Type);
1595    end Collect_Interface_Components;
1596
1597    -----------------------------
1598    -- Collect_Interfaces_Info --
1599    -----------------------------
1600
1601    procedure Collect_Interfaces_Info
1602      (T               : Entity_Id;
1603       Ifaces_List     : out Elist_Id;
1604       Components_List : out Elist_Id;
1605       Tags_List       : out Elist_Id)
1606    is
1607       Comps_List : Elist_Id;
1608       Comp_Elmt  : Elmt_Id;
1609       Comp_Iface : Entity_Id;
1610       Iface_Elmt : Elmt_Id;
1611       Iface      : Entity_Id;
1612
1613       function Search_Tag (Iface : Entity_Id) return Entity_Id;
1614       --  Search for the secondary tag associated with the interface type
1615       --  Iface that is implemented by T.
1616
1617       ----------------
1618       -- Search_Tag --
1619       ----------------
1620
1621       function Search_Tag (Iface : Entity_Id) return Entity_Id is
1622          ADT : Elmt_Id;
1623       begin
1624          if not Is_CPP_Class (T) then
1625             ADT := Next_Elmt (Next_Elmt (First_Elmt (Access_Disp_Table (T))));
1626          else
1627             ADT := Next_Elmt (First_Elmt (Access_Disp_Table (T)));
1628          end if;
1629
1630          while Present (ADT)
1631             and then Is_Tag (Node (ADT))
1632             and then Related_Type (Node (ADT)) /= Iface
1633          loop
1634             --  Skip secondary dispatch table referencing thunks to user
1635             --  defined primitives covered by this interface.
1636
1637             pragma Assert (Has_Suffix (Node (ADT), 'P'));
1638             Next_Elmt (ADT);
1639
1640             --  Skip secondary dispatch tables of Ada types
1641
1642             if not Is_CPP_Class (T) then
1643
1644                --  Skip secondary dispatch table referencing thunks to
1645                --  predefined primitives.
1646
1647                pragma Assert (Has_Suffix (Node (ADT), 'Y'));
1648                Next_Elmt (ADT);
1649
1650                --  Skip secondary dispatch table referencing user-defined
1651                --  primitives covered by this interface.
1652
1653                pragma Assert (Has_Suffix (Node (ADT), 'D'));
1654                Next_Elmt (ADT);
1655
1656                --  Skip secondary dispatch table referencing predefined
1657                --  primitives.
1658
1659                pragma Assert (Has_Suffix (Node (ADT), 'Z'));
1660                Next_Elmt (ADT);
1661             end if;
1662          end loop;
1663
1664          pragma Assert (Is_Tag (Node (ADT)));
1665          return Node (ADT);
1666       end Search_Tag;
1667
1668    --  Start of processing for Collect_Interfaces_Info
1669
1670    begin
1671       Collect_Interfaces (T, Ifaces_List);
1672       Collect_Interface_Components (T, Comps_List);
1673
1674       --  Search for the record component and tag associated with each
1675       --  interface type of T.
1676
1677       Components_List := New_Elmt_List;
1678       Tags_List       := New_Elmt_List;
1679
1680       Iface_Elmt := First_Elmt (Ifaces_List);
1681       while Present (Iface_Elmt) loop
1682          Iface := Node (Iface_Elmt);
1683
1684          --  Associate the primary tag component and the primary dispatch table
1685          --  with all the interfaces that are parents of T
1686
1687          if Is_Ancestor (Iface, T) then
1688             Append_Elmt (First_Tag_Component (T), Components_List);
1689             Append_Elmt (Node (First_Elmt (Access_Disp_Table (T))), Tags_List);
1690
1691          --  Otherwise search for the tag component and secondary dispatch
1692          --  table of Iface
1693
1694          else
1695             Comp_Elmt := First_Elmt (Comps_List);
1696             while Present (Comp_Elmt) loop
1697                Comp_Iface := Related_Type (Node (Comp_Elmt));
1698
1699                if Comp_Iface = Iface
1700                  or else Is_Ancestor (Iface, Comp_Iface)
1701                then
1702                   Append_Elmt (Node (Comp_Elmt), Components_List);
1703                   Append_Elmt (Search_Tag (Comp_Iface), Tags_List);
1704                   exit;
1705                end if;
1706
1707                Next_Elmt (Comp_Elmt);
1708             end loop;
1709             pragma Assert (Present (Comp_Elmt));
1710          end if;
1711
1712          Next_Elmt (Iface_Elmt);
1713       end loop;
1714    end Collect_Interfaces_Info;
1715
1716    ---------------------
1717    -- Collect_Parents --
1718    ---------------------
1719
1720    procedure Collect_Parents
1721      (T             : Entity_Id;
1722       List          : out Elist_Id;
1723       Use_Full_View : Boolean := True)
1724    is
1725       Current_Typ : Entity_Id := T;
1726       Parent_Typ  : Entity_Id;
1727
1728    begin
1729       List := New_Elmt_List;
1730
1731       --  No action if the if the type has no parents
1732
1733       if T = Etype (T) then
1734          return;
1735       end if;
1736
1737       loop
1738          Parent_Typ := Etype (Current_Typ);
1739
1740          if Is_Private_Type (Parent_Typ)
1741            and then Present (Full_View (Parent_Typ))
1742            and then Use_Full_View
1743          then
1744             Parent_Typ := Full_View (Base_Type (Parent_Typ));
1745          end if;
1746
1747          Append_Elmt (Parent_Typ, List);
1748
1749          exit when Parent_Typ = Current_Typ;
1750          Current_Typ := Parent_Typ;
1751       end loop;
1752    end Collect_Parents;
1753
1754    ----------------------------------
1755    -- Collect_Primitive_Operations --
1756    ----------------------------------
1757
1758    function Collect_Primitive_Operations (T : Entity_Id) return Elist_Id is
1759       B_Type         : constant Entity_Id := Base_Type (T);
1760       B_Decl         : constant Node_Id   := Original_Node (Parent (B_Type));
1761       B_Scope        : Entity_Id          := Scope (B_Type);
1762       Op_List        : Elist_Id;
1763       Formal         : Entity_Id;
1764       Is_Prim        : Boolean;
1765       Formal_Derived : Boolean := False;
1766       Id             : Entity_Id;
1767
1768       function Match (E : Entity_Id) return Boolean;
1769       --  True if E's base type is B_Type, or E is of an anonymous access type
1770       --  and the base type of its designated type is B_Type.
1771
1772       -----------
1773       -- Match --
1774       -----------
1775
1776       function Match (E : Entity_Id) return Boolean is
1777          Etyp : Entity_Id := Etype (E);
1778
1779       begin
1780          if Ekind (Etyp) = E_Anonymous_Access_Type then
1781             Etyp := Designated_Type (Etyp);
1782          end if;
1783
1784          return Base_Type (Etyp) = B_Type;
1785       end Match;
1786
1787    --  Start of processing for Collect_Primitive_Operations
1788
1789    begin
1790       --  For tagged types, the primitive operations are collected as they
1791       --  are declared, and held in an explicit list which is simply returned.
1792
1793       if Is_Tagged_Type (B_Type) then
1794          return Primitive_Operations (B_Type);
1795
1796       --  An untagged generic type that is a derived type inherits the
1797       --  primitive operations of its parent type. Other formal types only
1798       --  have predefined operators, which are not explicitly represented.
1799
1800       elsif Is_Generic_Type (B_Type) then
1801          if Nkind (B_Decl) = N_Formal_Type_Declaration
1802            and then Nkind (Formal_Type_Definition (B_Decl))
1803              = N_Formal_Derived_Type_Definition
1804          then
1805             Formal_Derived := True;
1806          else
1807             return New_Elmt_List;
1808          end if;
1809       end if;
1810
1811       Op_List := New_Elmt_List;
1812
1813       if B_Scope = Standard_Standard then
1814          if B_Type = Standard_String then
1815             Append_Elmt (Standard_Op_Concat, Op_List);
1816
1817          elsif B_Type = Standard_Wide_String then
1818             Append_Elmt (Standard_Op_Concatw, Op_List);
1819
1820          else
1821             null;
1822          end if;
1823
1824       elsif (Is_Package_Or_Generic_Package (B_Scope)
1825               and then
1826                 Nkind (Parent (Declaration_Node (First_Subtype (T)))) /=
1827                                                             N_Package_Body)
1828         or else Is_Derived_Type (B_Type)
1829       then
1830          --  The primitive operations appear after the base type, except
1831          --  if the derivation happens within the private part of B_Scope
1832          --  and the type is a private type, in which case both the type
1833          --  and some primitive operations may appear before the base
1834          --  type, and the list of candidates starts after the type.
1835
1836          if In_Open_Scopes (B_Scope)
1837            and then Scope (T) = B_Scope
1838            and then In_Private_Part (B_Scope)
1839          then
1840             Id := Next_Entity (T);
1841          else
1842             Id := Next_Entity (B_Type);
1843          end if;
1844
1845          while Present (Id) loop
1846
1847             --  Note that generic formal subprograms are not
1848             --  considered to be primitive operations and thus
1849             --  are never inherited.
1850
1851             if Is_Overloadable (Id)
1852               and then Nkind (Parent (Parent (Id)))
1853                          not in N_Formal_Subprogram_Declaration
1854             then
1855                Is_Prim := False;
1856
1857                if Match (Id) then
1858                   Is_Prim := True;
1859
1860                else
1861                   Formal := First_Formal (Id);
1862                   while Present (Formal) loop
1863                      if Match (Formal) then
1864                         Is_Prim := True;
1865                         exit;
1866                      end if;
1867
1868                      Next_Formal (Formal);
1869                   end loop;
1870                end if;
1871
1872                --  For a formal derived type, the only primitives are the
1873                --  ones inherited from the parent type. Operations appearing
1874                --  in the package declaration are not primitive for it.
1875
1876                if Is_Prim
1877                  and then (not Formal_Derived
1878                             or else Present (Alias (Id)))
1879                then
1880                   --  In the special case of an equality operator aliased to
1881                   --  an overriding dispatching equality belonging to the same
1882                   --  type, we don't include it in the list of primitives.
1883                   --  This avoids inheriting multiple equality operators when
1884                   --  deriving from untagged private types whose full type is
1885                   --  tagged, which can otherwise cause ambiguities. Note that
1886                   --  this should only happen for this kind of untagged parent
1887                   --  type, since normally dispatching operations are inherited
1888                   --  using the type's Primitive_Operations list.
1889
1890                   if Chars (Id) = Name_Op_Eq
1891                     and then Is_Dispatching_Operation (Id)
1892                     and then Present (Alias (Id))
1893                     and then Is_Overriding_Operation (Alias (Id))
1894                     and then Base_Type (Etype (First_Entity (Id))) =
1895                                Base_Type (Etype (First_Entity (Alias (Id))))
1896                   then
1897                      null;
1898
1899                   --  Include the subprogram in the list of primitives
1900
1901                   else
1902                      Append_Elmt (Id, Op_List);
1903                   end if;
1904                end if;
1905             end if;
1906
1907             Next_Entity (Id);
1908
1909             --  For a type declared in System, some of its operations may
1910             --  appear in the target-specific extension to System.
1911
1912             if No (Id)
1913               and then B_Scope = RTU_Entity (System)
1914               and then Present_System_Aux
1915             then
1916                B_Scope := System_Aux_Id;
1917                Id := First_Entity (System_Aux_Id);
1918             end if;
1919          end loop;
1920       end if;
1921
1922       return Op_List;
1923    end Collect_Primitive_Operations;
1924
1925    -----------------------------------
1926    -- Compile_Time_Constraint_Error --
1927    -----------------------------------
1928
1929    function Compile_Time_Constraint_Error
1930      (N    : Node_Id;
1931       Msg  : String;
1932       Ent  : Entity_Id  := Empty;
1933       Loc  : Source_Ptr := No_Location;
1934       Warn : Boolean    := False) return Node_Id
1935    is
1936       Msgc : String (1 .. Msg'Length + 2);
1937       --  Copy of message, with room for possible ? and ! at end
1938
1939       Msgl : Natural;
1940       Wmsg : Boolean;
1941       P    : Node_Id;
1942       OldP : Node_Id;
1943       Msgs : Boolean;
1944       Eloc : Source_Ptr;
1945
1946    begin
1947       --  A static constraint error in an instance body is not a fatal error.
1948       --  we choose to inhibit the message altogether, because there is no
1949       --  obvious node (for now) on which to post it. On the other hand the
1950       --  offending node must be replaced with a constraint_error in any case.
1951
1952       --  No messages are generated if we already posted an error on this node
1953
1954       if not Error_Posted (N) then
1955          if Loc /= No_Location then
1956             Eloc := Loc;
1957          else
1958             Eloc := Sloc (N);
1959          end if;
1960
1961          Msgc (1 .. Msg'Length) := Msg;
1962          Msgl := Msg'Length;
1963
1964          --  Message is a warning, even in Ada 95 case
1965
1966          if Msg (Msg'Last) = '?' then
1967             Wmsg := True;
1968
1969          --  In Ada 83, all messages are warnings. In the private part and
1970          --  the body of an instance, constraint_checks are only warnings.
1971          --  We also make this a warning if the Warn parameter is set.
1972
1973          elsif Warn
1974            or else (Ada_Version = Ada_83 and then Comes_From_Source (N))
1975          then
1976             Msgl := Msgl + 1;
1977             Msgc (Msgl) := '?';
1978             Wmsg := True;
1979
1980          elsif In_Instance_Not_Visible then
1981             Msgl := Msgl + 1;
1982             Msgc (Msgl) := '?';
1983             Wmsg := True;
1984
1985          --  Otherwise we have a real error message (Ada 95 static case)
1986          --  and we make this an unconditional message. Note that in the
1987          --  warning case we do not make the message unconditional, it seems
1988          --  quite reasonable to delete messages like this (about exceptions
1989          --  that will be raised) in dead code.
1990
1991          else
1992             Wmsg := False;
1993             Msgl := Msgl + 1;
1994             Msgc (Msgl) := '!';
1995          end if;
1996
1997          --  Should we generate a warning? The answer is not quite yes. The
1998          --  very annoying exception occurs in the case of a short circuit
1999          --  operator where the left operand is static and decisive. Climb
2000          --  parents to see if that is the case we have here. Conditional
2001          --  expressions with decisive conditions are a similar situation.
2002
2003          Msgs := True;
2004          P := N;
2005          loop
2006             OldP := P;
2007             P := Parent (P);
2008
2009             --  And then with False as left operand
2010
2011             if Nkind (P) = N_And_Then
2012               and then Compile_Time_Known_Value (Left_Opnd (P))
2013               and then Is_False (Expr_Value (Left_Opnd (P)))
2014             then
2015                Msgs := False;
2016                exit;
2017
2018             --  OR ELSE with True as left operand
2019
2020             elsif Nkind (P) = N_Or_Else
2021               and then Compile_Time_Known_Value (Left_Opnd (P))
2022               and then Is_True (Expr_Value (Left_Opnd (P)))
2023             then
2024                Msgs := False;
2025                exit;
2026
2027             --  Conditional expression
2028
2029             elsif Nkind (P) = N_Conditional_Expression then
2030                declare
2031                   Cond : constant Node_Id := First (Expressions (P));
2032                   Texp : constant Node_Id := Next (Cond);
2033                   Fexp : constant Node_Id := Next (Texp);
2034
2035                begin
2036                   if Compile_Time_Known_Value (Cond) then
2037
2038                      --  Condition is True and we are in the right operand
2039
2040                      if Is_True (Expr_Value (Cond))
2041                        and then OldP = Fexp
2042                      then
2043                         Msgs := False;
2044                         exit;
2045
2046                      --  Condition is False and we are in the left operand
2047
2048                      elsif Is_False (Expr_Value (Cond))
2049                        and then OldP = Texp
2050                      then
2051                         Msgs := False;
2052                         exit;
2053                      end if;
2054                   end if;
2055                end;
2056
2057             --  Special case for component association in aggregates, where
2058             --  we want to keep climbing up to the parent aggregate.
2059
2060             elsif Nkind (P) = N_Component_Association
2061               and then Nkind (Parent (P)) = N_Aggregate
2062             then
2063                null;
2064
2065             --  Keep going if within subexpression
2066
2067             else
2068                exit when Nkind (P) not in N_Subexpr;
2069             end if;
2070          end loop;
2071
2072          if Msgs then
2073             if Present (Ent) then
2074                Error_Msg_NEL (Msgc (1 .. Msgl), N, Ent, Eloc);
2075             else
2076                Error_Msg_NEL (Msgc (1 .. Msgl), N, Etype (N), Eloc);
2077             end if;
2078
2079             if Wmsg then
2080                if Inside_Init_Proc then
2081                   Error_Msg_NEL
2082                     ("\?& will be raised for objects of this type",
2083                      N, Standard_Constraint_Error, Eloc);
2084                else
2085                   Error_Msg_NEL
2086                     ("\?& will be raised at run time",
2087                      N, Standard_Constraint_Error, Eloc);
2088                end if;
2089
2090             else
2091                Error_Msg
2092                  ("\static expression fails Constraint_Check", Eloc);
2093                Set_Error_Posted (N);
2094             end if;
2095          end if;
2096       end if;
2097
2098       return N;
2099    end Compile_Time_Constraint_Error;
2100
2101    -----------------------
2102    -- Conditional_Delay --
2103    -----------------------
2104
2105    procedure Conditional_Delay (New_Ent, Old_Ent : Entity_Id) is
2106    begin
2107       if Has_Delayed_Freeze (Old_Ent) and then not Is_Frozen (Old_Ent) then
2108          Set_Has_Delayed_Freeze (New_Ent);
2109       end if;
2110    end Conditional_Delay;
2111
2112    -------------------------
2113    -- Copy_Parameter_List --
2114    -------------------------
2115
2116    function Copy_Parameter_List (Subp_Id : Entity_Id) return List_Id is
2117       Loc    : constant Source_Ptr := Sloc (Subp_Id);
2118       Plist  : List_Id;
2119       Formal : Entity_Id;
2120
2121    begin
2122       if No (First_Formal (Subp_Id)) then
2123          return No_List;
2124       else
2125          Plist := New_List;
2126          Formal := First_Formal (Subp_Id);
2127          while Present (Formal) loop
2128             Append
2129               (Make_Parameter_Specification (Loc,
2130                 Defining_Identifier =>
2131                   Make_Defining_Identifier (Sloc (Formal),
2132                     Chars => Chars (Formal)),
2133                 In_Present  => In_Present (Parent (Formal)),
2134                 Out_Present => Out_Present (Parent (Formal)),
2135              Parameter_Type =>
2136                   New_Reference_To (Etype (Formal), Loc),
2137                 Expression =>
2138                   New_Copy_Tree (Expression (Parent (Formal)))),
2139               Plist);
2140
2141             Next_Formal (Formal);
2142          end loop;
2143       end if;
2144
2145       return Plist;
2146    end Copy_Parameter_List;
2147
2148    --------------------
2149    -- Current_Entity --
2150    --------------------
2151
2152    --  The currently visible definition for a given identifier is the
2153    --  one most chained at the start of the visibility chain, i.e. the
2154    --  one that is referenced by the Node_Id value of the name of the
2155    --  given identifier.
2156
2157    function Current_Entity (N : Node_Id) return Entity_Id is
2158    begin
2159       return Get_Name_Entity_Id (Chars (N));
2160    end Current_Entity;
2161
2162    -----------------------------
2163    -- Current_Entity_In_Scope --
2164    -----------------------------
2165
2166    function Current_Entity_In_Scope (N : Node_Id) return Entity_Id is
2167       E  : Entity_Id;
2168       CS : constant Entity_Id := Current_Scope;
2169
2170       Transient_Case : constant Boolean := Scope_Is_Transient;
2171
2172    begin
2173       E := Get_Name_Entity_Id (Chars (N));
2174       while Present (E)
2175         and then Scope (E) /= CS
2176         and then (not Transient_Case or else Scope (E) /= Scope (CS))
2177       loop
2178          E := Homonym (E);
2179       end loop;
2180
2181       return E;
2182    end Current_Entity_In_Scope;
2183
2184    -------------------
2185    -- Current_Scope --
2186    -------------------
2187
2188    function Current_Scope return Entity_Id is
2189    begin
2190       if Scope_Stack.Last = -1 then
2191          return Standard_Standard;
2192       else
2193          declare
2194             C : constant Entity_Id :=
2195                   Scope_Stack.Table (Scope_Stack.Last).Entity;
2196          begin
2197             if Present (C) then
2198                return C;
2199             else
2200                return Standard_Standard;
2201             end if;
2202          end;
2203       end if;
2204    end Current_Scope;
2205
2206    ------------------------
2207    -- Current_Subprogram --
2208    ------------------------
2209
2210    function Current_Subprogram return Entity_Id is
2211       Scop : constant Entity_Id := Current_Scope;
2212    begin
2213       if Is_Subprogram (Scop) or else Is_Generic_Subprogram (Scop) then
2214          return Scop;
2215       else
2216          return Enclosing_Subprogram (Scop);
2217       end if;
2218    end Current_Subprogram;
2219
2220    ---------------------
2221    -- Defining_Entity --
2222    ---------------------
2223
2224    function Defining_Entity (N : Node_Id) return Entity_Id is
2225       K   : constant Node_Kind := Nkind (N);
2226       Err : Entity_Id := Empty;
2227
2228    begin
2229       case K is
2230          when
2231            N_Subprogram_Declaration                 |
2232            N_Abstract_Subprogram_Declaration        |
2233            N_Subprogram_Body                        |
2234            N_Package_Declaration                    |
2235            N_Subprogram_Renaming_Declaration        |
2236            N_Subprogram_Body_Stub                   |
2237            N_Generic_Subprogram_Declaration         |
2238            N_Generic_Package_Declaration            |
2239            N_Formal_Subprogram_Declaration
2240          =>
2241             return Defining_Entity (Specification (N));
2242
2243          when
2244            N_Component_Declaration                  |
2245            N_Defining_Program_Unit_Name             |
2246            N_Discriminant_Specification             |
2247            N_Entry_Body                             |
2248            N_Entry_Declaration                      |
2249            N_Entry_Index_Specification              |
2250            N_Exception_Declaration                  |
2251            N_Exception_Renaming_Declaration         |
2252            N_Formal_Object_Declaration              |
2253            N_Formal_Package_Declaration             |
2254            N_Formal_Type_Declaration                |
2255            N_Full_Type_Declaration                  |
2256            N_Implicit_Label_Declaration             |
2257            N_Incomplete_Type_Declaration            |
2258            N_Loop_Parameter_Specification           |
2259            N_Number_Declaration                     |
2260            N_Object_Declaration                     |
2261            N_Object_Renaming_Declaration            |
2262            N_Package_Body_Stub                      |
2263            N_Parameter_Specification                |
2264            N_Private_Extension_Declaration          |
2265            N_Private_Type_Declaration               |
2266            N_Protected_Body                         |
2267            N_Protected_Body_Stub                    |
2268            N_Protected_Type_Declaration             |
2269            N_Single_Protected_Declaration           |
2270            N_Single_Task_Declaration                |
2271            N_Subtype_Declaration                    |
2272            N_Task_Body                              |
2273            N_Task_Body_Stub                         |
2274            N_Task_Type_Declaration
2275          =>
2276             return Defining_Identifier (N);
2277
2278          when N_Subunit =>
2279             return Defining_Entity (Proper_Body (N));
2280
2281          when
2282            N_Function_Instantiation                 |
2283            N_Function_Specification                 |
2284            N_Generic_Function_Renaming_Declaration  |
2285            N_Generic_Package_Renaming_Declaration   |
2286            N_Generic_Procedure_Renaming_Declaration |
2287            N_Package_Body                           |
2288            N_Package_Instantiation                  |
2289            N_Package_Renaming_Declaration           |
2290            N_Package_Specification                  |
2291            N_Procedure_Instantiation                |
2292            N_Procedure_Specification
2293          =>
2294             declare
2295                Nam : constant Node_Id := Defining_Unit_Name (N);
2296
2297             begin
2298                if Nkind (Nam) in N_Entity then
2299                   return Nam;
2300
2301                --  For Error, make up a name and attach to declaration
2302                --  so we can continue semantic analysis
2303
2304                elsif Nam = Error then
2305                   Err := Make_Temporary (Sloc (N), 'T');
2306                   Set_Defining_Unit_Name (N, Err);
2307
2308                   return Err;
2309                --  If not an entity, get defining identifier
2310
2311                else
2312                   return Defining_Identifier (Nam);
2313                end if;
2314             end;
2315
2316          when N_Block_Statement =>
2317             return Entity (Identifier (N));
2318
2319          when others =>
2320             raise Program_Error;
2321
2322       end case;
2323    end Defining_Entity;
2324
2325    --------------------------
2326    -- Denotes_Discriminant --
2327    --------------------------
2328
2329    function Denotes_Discriminant
2330      (N                : Node_Id;
2331       Check_Concurrent : Boolean := False) return Boolean
2332    is
2333       E : Entity_Id;
2334    begin
2335       if not Is_Entity_Name (N)
2336         or else No (Entity (N))
2337       then
2338          return False;
2339       else
2340          E := Entity (N);
2341       end if;
2342
2343       --  If we are checking for a protected type, the discriminant may have
2344       --  been rewritten as the corresponding discriminal of the original type
2345       --  or of the corresponding concurrent record, depending on whether we
2346       --  are in the spec or body of the protected type.
2347
2348       return Ekind (E) = E_Discriminant
2349         or else
2350           (Check_Concurrent
2351             and then Ekind (E) = E_In_Parameter
2352             and then Present (Discriminal_Link (E))
2353             and then
2354               (Is_Concurrent_Type (Scope (Discriminal_Link (E)))
2355                 or else
2356                   Is_Concurrent_Record_Type (Scope (Discriminal_Link (E)))));
2357
2358    end Denotes_Discriminant;
2359
2360    -------------------------
2361    -- Denotes_Same_Object --
2362    -------------------------
2363
2364    function Denotes_Same_Object (A1, A2 : Node_Id) return Boolean is
2365       Obj1 : Node_Id := A1;
2366       Obj2 : Node_Id := A2;
2367
2368       procedure Check_Renaming (Obj : in out Node_Id);
2369       --  If an object is a renaming, examine renamed object. If it is a
2370       --  dereference of a variable, or an indexed expression with non-constant
2371       --  indexes, no overlap check can be reported.
2372
2373       --------------------
2374       -- Check_Renaming --
2375       --------------------
2376
2377       procedure Check_Renaming (Obj : in out Node_Id) is
2378       begin
2379          if Is_Entity_Name (Obj)
2380            and then Present (Renamed_Entity (Entity (Obj)))
2381          then
2382             Obj := Renamed_Entity (Entity (Obj));
2383             if Nkind (Obj) = N_Explicit_Dereference
2384               and then Is_Variable (Prefix (Obj))
2385             then
2386                Obj := Empty;
2387
2388             elsif Nkind (Obj) = N_Indexed_Component then
2389                declare
2390                   Indx : Node_Id;
2391
2392                begin
2393                   Indx := First (Expressions (Obj));
2394                   while Present (Indx) loop
2395                      if not Is_OK_Static_Expression (Indx) then
2396                         Obj := Empty;
2397                         exit;
2398                      end if;
2399
2400                      Next_Index (Indx);
2401                   end loop;
2402                end;
2403             end if;
2404          end if;
2405       end Check_Renaming;
2406
2407    --  Start of processing for Denotes_Same_Object
2408
2409    begin
2410       Check_Renaming (Obj1);
2411       Check_Renaming (Obj2);
2412
2413       if No (Obj1)
2414         or else No (Obj2)
2415       then
2416          return False;
2417       end if;
2418
2419       --  If we have entity names, then must be same entity
2420
2421       if Is_Entity_Name (Obj1) then
2422          if Is_Entity_Name (Obj2) then
2423             return Entity (Obj1) = Entity (Obj2);
2424          else
2425             return False;
2426          end if;
2427
2428       --  No match if not same node kind
2429
2430       elsif Nkind (Obj1) /= Nkind (Obj2) then
2431          return False;
2432
2433       --  For selected components, must have same prefix and selector
2434
2435       elsif Nkind (Obj1) = N_Selected_Component then
2436          return Denotes_Same_Object (Prefix (Obj1), Prefix (Obj2))
2437            and then
2438          Entity (Selector_Name (Obj1)) = Entity (Selector_Name (Obj2));
2439
2440       --  For explicit dereferences, prefixes must be same
2441
2442       elsif Nkind (Obj1) = N_Explicit_Dereference then
2443          return Denotes_Same_Object (Prefix (Obj1), Prefix (Obj2));
2444
2445       --  For indexed components, prefixes and all subscripts must be the same
2446
2447       elsif Nkind (Obj1) = N_Indexed_Component then
2448          if Denotes_Same_Object (Prefix (Obj1), Prefix (Obj2)) then
2449             declare
2450                Indx1 : Node_Id;
2451                Indx2 : Node_Id;
2452
2453             begin
2454                Indx1 := First (Expressions (Obj1));
2455                Indx2 := First (Expressions (Obj2));
2456                while Present (Indx1) loop
2457
2458                   --  Indexes must denote the same static value or same object
2459
2460                   if Is_OK_Static_Expression (Indx1) then
2461                      if not Is_OK_Static_Expression (Indx2) then
2462                         return False;
2463
2464                      elsif Expr_Value (Indx1) /= Expr_Value (Indx2) then
2465                         return False;
2466                      end if;
2467
2468                   elsif not Denotes_Same_Object (Indx1, Indx2) then
2469                      return False;
2470                   end if;
2471
2472                   Next (Indx1);
2473                   Next (Indx2);
2474                end loop;
2475
2476                return True;
2477             end;
2478          else
2479             return False;
2480          end if;
2481
2482       --  For slices, prefixes must match and bounds must match
2483
2484       elsif Nkind (Obj1) = N_Slice
2485         and then Denotes_Same_Object (Prefix (Obj1), Prefix (Obj2))
2486       then
2487          declare
2488             Lo1, Lo2, Hi1, Hi2 : Node_Id;
2489
2490          begin
2491             Get_Index_Bounds (Etype (Obj1), Lo1, Hi1);
2492             Get_Index_Bounds (Etype (Obj2), Lo2, Hi2);
2493
2494             --  Check whether bounds are statically identical. There is no
2495             --  attempt to detect partial overlap of slices.
2496
2497             return Denotes_Same_Object (Lo1, Lo2)
2498               and then Denotes_Same_Object (Hi1, Hi2);
2499          end;
2500
2501          --  Literals will appear as indexes. Isn't this where we should check
2502          --  Known_At_Compile_Time at least if we are generating warnings ???
2503
2504       elsif Nkind (Obj1) = N_Integer_Literal then
2505          return Intval (Obj1) = Intval (Obj2);
2506
2507       else
2508          return False;
2509       end if;
2510    end Denotes_Same_Object;
2511
2512    -------------------------
2513    -- Denotes_Same_Prefix --
2514    -------------------------
2515
2516    function Denotes_Same_Prefix (A1, A2 : Node_Id) return Boolean is
2517
2518    begin
2519       if Is_Entity_Name (A1) then
2520          if Nkind_In (A2, N_Selected_Component, N_Indexed_Component)
2521            and then not Is_Access_Type (Etype (A1))
2522          then
2523             return Denotes_Same_Object (A1, Prefix (A2))
2524               or else Denotes_Same_Prefix (A1, Prefix (A2));
2525          else
2526             return False;
2527          end if;
2528
2529       elsif Is_Entity_Name (A2) then
2530          return Denotes_Same_Prefix (A2, A1);
2531
2532       elsif Nkind_In (A1, N_Selected_Component, N_Indexed_Component, N_Slice)
2533               and then
2534             Nkind_In (A2, N_Selected_Component, N_Indexed_Component, N_Slice)
2535       then
2536          declare
2537             Root1, Root2 : Node_Id;
2538             Depth1, Depth2 : Int := 0;
2539
2540          begin
2541             Root1 := Prefix (A1);
2542             while not Is_Entity_Name (Root1) loop
2543                if not Nkind_In
2544                  (Root1, N_Selected_Component, N_Indexed_Component)
2545                then
2546                   return False;
2547                else
2548                   Root1 := Prefix (Root1);
2549                end if;
2550
2551                Depth1 := Depth1 + 1;
2552             end loop;
2553
2554             Root2 := Prefix (A2);
2555             while not Is_Entity_Name (Root2) loop
2556                if not Nkind_In
2557                  (Root2, N_Selected_Component, N_Indexed_Component)
2558                then
2559                   return False;
2560                else
2561                   Root2 := Prefix (Root2);
2562                end if;
2563
2564                Depth2 := Depth2 + 1;
2565             end loop;
2566
2567             --  If both have the same depth and they do not denote the same
2568             --  object, they are disjoint and not warning is needed.
2569
2570             if Depth1 = Depth2 then
2571                return False;
2572
2573             elsif Depth1 > Depth2 then
2574                Root1 := Prefix (A1);
2575                for I in 1 .. Depth1 - Depth2 - 1 loop
2576                   Root1 := Prefix (Root1);
2577                end loop;
2578
2579                return Denotes_Same_Object (Root1, A2);
2580
2581             else
2582                Root2 := Prefix (A2);
2583                for I in 1 .. Depth2 - Depth1 - 1 loop
2584                   Root2 := Prefix (Root2);
2585                end loop;
2586
2587                return Denotes_Same_Object (A1, Root2);
2588             end if;
2589          end;
2590
2591       else
2592          return False;
2593       end if;
2594    end Denotes_Same_Prefix;
2595
2596    ----------------------
2597    -- Denotes_Variable --
2598    ----------------------
2599
2600    function Denotes_Variable (N : Node_Id) return Boolean is
2601    begin
2602       return Is_Variable (N) and then Paren_Count (N) = 0;
2603    end Denotes_Variable;
2604
2605    -----------------------------
2606    -- Depends_On_Discriminant --
2607    -----------------------------
2608
2609    function Depends_On_Discriminant (N : Node_Id) return Boolean is
2610       L : Node_Id;
2611       H : Node_Id;
2612
2613    begin
2614       Get_Index_Bounds (N, L, H);
2615       return Denotes_Discriminant (L) or else Denotes_Discriminant (H);
2616    end Depends_On_Discriminant;
2617
2618    -------------------------
2619    -- Designate_Same_Unit --
2620    -------------------------
2621
2622    function Designate_Same_Unit
2623      (Name1 : Node_Id;
2624       Name2 : Node_Id) return Boolean
2625    is
2626       K1 : constant Node_Kind := Nkind (Name1);
2627       K2 : constant Node_Kind := Nkind (Name2);
2628
2629       function Prefix_Node (N : Node_Id) return Node_Id;
2630       --  Returns the parent unit name node of a defining program unit name
2631       --  or the prefix if N is a selected component or an expanded name.
2632
2633       function Select_Node (N : Node_Id) return Node_Id;
2634       --  Returns the defining identifier node of a defining program unit
2635       --  name or  the selector node if N is a selected component or an
2636       --  expanded name.
2637
2638       -----------------
2639       -- Prefix_Node --
2640       -----------------
2641
2642       function Prefix_Node (N : Node_Id) return Node_Id is
2643       begin
2644          if Nkind (N) = N_Defining_Program_Unit_Name then
2645             return Name (N);
2646
2647          else
2648             return Prefix (N);
2649          end if;
2650       end Prefix_Node;
2651
2652       -----------------
2653       -- Select_Node --
2654       -----------------
2655
2656       function Select_Node (N : Node_Id) return Node_Id is
2657       begin
2658          if Nkind (N) = N_Defining_Program_Unit_Name then
2659             return Defining_Identifier (N);
2660
2661          else
2662             return Selector_Name (N);
2663          end if;
2664       end Select_Node;
2665
2666    --  Start of processing for Designate_Next_Unit
2667
2668    begin
2669       if (K1 = N_Identifier or else
2670           K1 = N_Defining_Identifier)
2671         and then
2672          (K2 = N_Identifier or else
2673           K2 = N_Defining_Identifier)
2674       then
2675          return Chars (Name1) = Chars (Name2);
2676
2677       elsif
2678          (K1 = N_Expanded_Name      or else
2679           K1 = N_Selected_Component or else
2680           K1 = N_Defining_Program_Unit_Name)
2681         and then
2682          (K2 = N_Expanded_Name      or else
2683           K2 = N_Selected_Component or else
2684           K2 = N_Defining_Program_Unit_Name)
2685       then
2686          return
2687            (Chars (Select_Node (Name1)) = Chars (Select_Node (Name2)))
2688              and then
2689                Designate_Same_Unit (Prefix_Node (Name1), Prefix_Node (Name2));
2690
2691       else
2692          return False;
2693       end if;
2694    end Designate_Same_Unit;
2695
2696    --------------------------
2697    -- Enclosing_CPP_Parent --
2698    --------------------------
2699
2700    function Enclosing_CPP_Parent (Typ : Entity_Id) return Entity_Id is
2701       Parent_Typ : Entity_Id := Typ;
2702
2703    begin
2704       while not Is_CPP_Class (Parent_Typ)
2705          and then Etype (Parent_Typ) /= Parent_Typ
2706       loop
2707          Parent_Typ := Etype (Parent_Typ);
2708
2709          if Is_Private_Type (Parent_Typ) then
2710             Parent_Typ := Full_View (Base_Type (Parent_Typ));
2711          end if;
2712       end loop;
2713
2714       pragma Assert (Is_CPP_Class (Parent_Typ));
2715       return Parent_Typ;
2716    end Enclosing_CPP_Parent;
2717
2718    ----------------------------
2719    -- Enclosing_Generic_Body --
2720    ----------------------------
2721
2722    function Enclosing_Generic_Body
2723      (N : Node_Id) return Node_Id
2724    is
2725       P    : Node_Id;
2726       Decl : Node_Id;
2727       Spec : Node_Id;
2728
2729    begin
2730       P := Parent (N);
2731       while Present (P) loop
2732          if Nkind (P) = N_Package_Body
2733            or else Nkind (P) = N_Subprogram_Body
2734          then
2735             Spec := Corresponding_Spec (P);
2736
2737             if Present (Spec) then
2738                Decl := Unit_Declaration_Node (Spec);
2739
2740                if Nkind (Decl) = N_Generic_Package_Declaration
2741                  or else Nkind (Decl) = N_Generic_Subprogram_Declaration
2742                then
2743                   return P;
2744                end if;
2745             end if;
2746          end if;
2747
2748          P := Parent (P);
2749       end loop;
2750
2751       return Empty;
2752    end Enclosing_Generic_Body;
2753
2754    ----------------------------
2755    -- Enclosing_Generic_Unit --
2756    ----------------------------
2757
2758    function Enclosing_Generic_Unit
2759      (N : Node_Id) return Node_Id
2760    is
2761       P    : Node_Id;
2762       Decl : Node_Id;
2763       Spec : Node_Id;
2764
2765    begin
2766       P := Parent (N);
2767       while Present (P) loop
2768          if Nkind (P) = N_Generic_Package_Declaration
2769            or else Nkind (P) = N_Generic_Subprogram_Declaration
2770          then
2771             return P;
2772
2773          elsif Nkind (P) = N_Package_Body
2774            or else Nkind (P) = N_Subprogram_Body
2775          then
2776             Spec := Corresponding_Spec (P);
2777
2778             if Present (Spec) then
2779                Decl := Unit_Declaration_Node (Spec);
2780
2781                if Nkind (Decl) = N_Generic_Package_Declaration
2782                  or else Nkind (Decl) = N_Generic_Subprogram_Declaration
2783                then
2784                   return Decl;
2785                end if;
2786             end if;
2787          end if;
2788
2789          P := Parent (P);
2790       end loop;
2791
2792       return Empty;
2793    end Enclosing_Generic_Unit;
2794
2795    -------------------------------
2796    -- Enclosing_Lib_Unit_Entity --
2797    -------------------------------
2798
2799    function Enclosing_Lib_Unit_Entity return Entity_Id is
2800       Unit_Entity : Entity_Id;
2801
2802    begin
2803       --  Look for enclosing library unit entity by following scope links.
2804       --  Equivalent to, but faster than indexing through the scope stack.
2805
2806       Unit_Entity := Current_Scope;
2807       while (Present (Scope (Unit_Entity))
2808         and then Scope (Unit_Entity) /= Standard_Standard)
2809         and not Is_Child_Unit (Unit_Entity)
2810       loop
2811          Unit_Entity := Scope (Unit_Entity);
2812       end loop;
2813
2814       return Unit_Entity;
2815    end Enclosing_Lib_Unit_Entity;
2816
2817    -----------------------------
2818    -- Enclosing_Lib_Unit_Node --
2819    -----------------------------
2820
2821    function Enclosing_Lib_Unit_Node (N : Node_Id) return Node_Id is
2822       Current_Node : Node_Id;
2823
2824    begin
2825       Current_Node := N;
2826       while Present (Current_Node)
2827         and then Nkind (Current_Node) /= N_Compilation_Unit
2828       loop
2829          Current_Node := Parent (Current_Node);
2830       end loop;
2831
2832       if Nkind (Current_Node) /= N_Compilation_Unit then
2833          return Empty;
2834       end if;
2835
2836       return Current_Node;
2837    end Enclosing_Lib_Unit_Node;
2838
2839    --------------------------
2840    -- Enclosing_Subprogram --
2841    --------------------------
2842
2843    function Enclosing_Subprogram (E : Entity_Id) return Entity_Id is
2844       Dynamic_Scope : constant Entity_Id := Enclosing_Dynamic_Scope (E);
2845
2846    begin
2847       if Dynamic_Scope = Standard_Standard then
2848          return Empty;
2849
2850       elsif Dynamic_Scope = Empty then
2851          return Empty;
2852
2853       elsif Ekind (Dynamic_Scope) = E_Subprogram_Body then
2854          return Corresponding_Spec (Parent (Parent (Dynamic_Scope)));
2855
2856       elsif Ekind (Dynamic_Scope) = E_Block
2857         or else Ekind (Dynamic_Scope) = E_Return_Statement
2858       then
2859          return Enclosing_Subprogram (Dynamic_Scope);
2860
2861       elsif Ekind (Dynamic_Scope) = E_Task_Type then
2862          return Get_Task_Body_Procedure (Dynamic_Scope);
2863
2864       elsif Ekind (Dynamic_Scope) = E_Limited_Private_Type
2865         and then Present (Full_View (Dynamic_Scope))
2866         and then Ekind (Full_View (Dynamic_Scope)) = E_Task_Type
2867       then
2868          return Get_Task_Body_Procedure (Full_View (Dynamic_Scope));
2869
2870       --  No body is generated if the protected operation is eliminated
2871
2872       elsif Convention (Dynamic_Scope) = Convention_Protected
2873         and then not Is_Eliminated (Dynamic_Scope)
2874         and then Present (Protected_Body_Subprogram (Dynamic_Scope))
2875       then
2876          return Protected_Body_Subprogram (Dynamic_Scope);
2877
2878       else
2879          return Dynamic_Scope;
2880       end if;
2881    end Enclosing_Subprogram;
2882
2883    ------------------------
2884    -- Ensure_Freeze_Node --
2885    ------------------------
2886
2887    procedure Ensure_Freeze_Node (E : Entity_Id) is
2888       FN : Node_Id;
2889
2890    begin
2891       if No (Freeze_Node (E)) then
2892          FN := Make_Freeze_Entity (Sloc (E));
2893          Set_Has_Delayed_Freeze (E);
2894          Set_Freeze_Node (E, FN);
2895          Set_Access_Types_To_Process (FN, No_Elist);
2896          Set_TSS_Elist (FN, No_Elist);
2897          Set_Entity (FN, E);
2898       end if;
2899    end Ensure_Freeze_Node;
2900
2901    ----------------
2902    -- Enter_Name --
2903    ----------------
2904
2905    procedure Enter_Name (Def_Id : Entity_Id) is
2906       C : constant Entity_Id := Current_Entity (Def_Id);
2907       E : constant Entity_Id := Current_Entity_In_Scope (Def_Id);
2908       S : constant Entity_Id := Current_Scope;
2909
2910    begin
2911       Generate_Definition (Def_Id);
2912
2913       --  Add new name to current scope declarations. Check for duplicate
2914       --  declaration, which may or may not be a genuine error.
2915
2916       if Present (E) then
2917
2918          --  Case of previous entity entered because of a missing declaration
2919          --  or else a bad subtype indication. Best is to use the new entity,
2920          --  and make the previous one invisible.
2921
2922          if Etype (E) = Any_Type then
2923             Set_Is_Immediately_Visible (E, False);
2924
2925          --  Case of renaming declaration constructed for package instances.
2926          --  if there is an explicit declaration with the same identifier,
2927          --  the renaming is not immediately visible any longer, but remains
2928          --  visible through selected component notation.
2929
2930          elsif Nkind (Parent (E)) = N_Package_Renaming_Declaration
2931            and then not Comes_From_Source (E)
2932          then
2933             Set_Is_Immediately_Visible (E, False);
2934
2935          --  The new entity may be the package renaming, which has the same
2936          --  same name as a generic formal which has been seen already.
2937
2938          elsif Nkind (Parent (Def_Id)) = N_Package_Renaming_Declaration
2939             and then not Comes_From_Source (Def_Id)
2940          then
2941             Set_Is_Immediately_Visible (E, False);
2942
2943          --  For a fat pointer corresponding to a remote access to subprogram,
2944          --  we use the same identifier as the RAS type, so that the proper
2945          --  name appears in the stub. This type is only retrieved through
2946          --  the RAS type and never by visibility, and is not added to the
2947          --  visibility list (see below).
2948
2949          elsif Nkind (Parent (Def_Id)) = N_Full_Type_Declaration
2950            and then Present (Corresponding_Remote_Type (Def_Id))
2951          then
2952             null;
2953
2954          --  A controller component for a type extension overrides the
2955          --  inherited component.
2956
2957          elsif Chars (E) = Name_uController then
2958             null;
2959
2960          --  Case of an implicit operation or derived literal. The new entity
2961          --  hides the implicit one,  which is removed from all visibility,
2962          --  i.e. the entity list of its scope, and homonym chain of its name.
2963
2964          elsif (Is_Overloadable (E) and then Is_Inherited_Operation (E))
2965            or else Is_Internal (E)
2966          then
2967             declare
2968                Prev     : Entity_Id;
2969                Prev_Vis : Entity_Id;
2970                Decl     : constant Node_Id := Parent (E);
2971
2972             begin
2973                --  If E is an implicit declaration, it cannot be the first
2974                --  entity in the scope.
2975
2976                Prev := First_Entity (Current_Scope);
2977                while Present (Prev)
2978                  and then Next_Entity (Prev) /= E
2979                loop
2980                   Next_Entity (Prev);
2981                end loop;
2982
2983                if No (Prev) then
2984
2985                   --  If E is not on the entity chain of the current scope,
2986                   --  it is an implicit declaration in the generic formal
2987                   --  part of a generic subprogram. When analyzing the body,
2988                   --  the generic formals are visible but not on the entity
2989                   --  chain of the subprogram. The new entity will become
2990                   --  the visible one in the body.
2991
2992                   pragma Assert
2993                     (Nkind (Parent (Decl)) = N_Generic_Subprogram_Declaration);
2994                   null;
2995
2996                else
2997                   Set_Next_Entity (Prev, Next_Entity (E));
2998
2999                   if No (Next_Entity (Prev)) then
3000                      Set_Last_Entity (Current_Scope, Prev);
3001                   end if;
3002
3003                   if E = Current_Entity (E) then
3004                      Prev_Vis := Empty;
3005
3006                   else
3007                      Prev_Vis := Current_Entity (E);
3008                      while Homonym (Prev_Vis) /= E loop
3009                         Prev_Vis := Homonym (Prev_Vis);
3010                      end loop;
3011                   end if;
3012
3013                   if Present (Prev_Vis)  then
3014
3015                      --  Skip E in the visibility chain
3016
3017                      Set_Homonym (Prev_Vis, Homonym (E));
3018
3019                   else
3020                      Set_Name_Entity_Id (Chars (E), Homonym (E));
3021                   end if;
3022                end if;
3023             end;
3024
3025          --  This section of code could use a comment ???
3026
3027          elsif Present (Etype (E))
3028            and then Is_Concurrent_Type (Etype (E))
3029            and then E = Def_Id
3030          then
3031             return;
3032
3033          --  If the homograph is a protected component renaming, it should not
3034          --  be hiding the current entity. Such renamings are treated as weak
3035          --  declarations.
3036
3037          elsif Is_Prival (E) then
3038             Set_Is_Immediately_Visible (E, False);
3039
3040          --  In this case the current entity is a protected component renaming.
3041          --  Perform minimal decoration by setting the scope and return since
3042          --  the prival should not be hiding other visible entities.
3043
3044          elsif Is_Prival (Def_Id) then
3045             Set_Scope (Def_Id, Current_Scope);
3046             return;
3047
3048          --  Analogous to privals, the discriminal generated for an entry index
3049          --  parameter acts as a weak declaration. Perform minimal decoration
3050          --  to avoid bogus errors.
3051
3052          elsif Is_Discriminal (Def_Id)
3053            and then Ekind (Discriminal_Link (Def_Id)) = E_Entry_Index_Parameter
3054          then
3055             Set_Scope (Def_Id, Current_Scope);
3056             return;
3057
3058          --  In the body or private part of an instance, a type extension may
3059          --  introduce a component with the same name as that of an actual. The
3060          --  legality rule is not enforced, but the semantics of the full type
3061          --  with two components of same name are not clear at this point???
3062
3063          elsif In_Instance_Not_Visible then
3064             null;
3065
3066          --  When compiling a package body, some child units may have become
3067          --  visible. They cannot conflict with local entities that hide them.
3068
3069          elsif Is_Child_Unit (E)
3070            and then In_Open_Scopes (Scope (E))
3071            and then not Is_Immediately_Visible (E)
3072          then
3073             null;
3074
3075          --  Conversely, with front-end inlining we may compile the parent body
3076          --  first, and a child unit subsequently. The context is now the
3077          --  parent spec, and body entities are not visible.
3078
3079          elsif Is_Child_Unit (Def_Id)
3080            and then Is_Package_Body_Entity (E)
3081            and then not In_Package_Body (Current_Scope)
3082          then
3083             null;
3084
3085          --  Case of genuine duplicate declaration
3086
3087          else
3088             Error_Msg_Sloc := Sloc (E);
3089
3090             --  If the previous declaration is an incomplete type declaration
3091             --  this may be an attempt to complete it with a private type. The
3092             --  following avoids confusing cascaded errors.
3093
3094             if Nkind (Parent (E)) = N_Incomplete_Type_Declaration
3095               and then Nkind (Parent (Def_Id)) = N_Private_Type_Declaration
3096             then
3097                Error_Msg_N
3098                  ("incomplete type cannot be completed with a private " &
3099                   "declaration", Parent (Def_Id));
3100                Set_Is_Immediately_Visible (E, False);
3101                Set_Full_View (E, Def_Id);
3102
3103             --  An inherited component of a record conflicts with a new
3104             --  discriminant. The discriminant is inserted first in the scope,
3105             --  but the error should be posted on it, not on the component.
3106
3107             elsif Ekind (E) = E_Discriminant
3108               and then Present (Scope (Def_Id))
3109               and then Scope (Def_Id) /= Current_Scope
3110             then
3111                Error_Msg_Sloc := Sloc (Def_Id);
3112                Error_Msg_N ("& conflicts with declaration#", E);
3113                return;
3114
3115             --  If the name of the unit appears in its own context clause, a
3116             --  dummy package with the name has already been created, and the
3117             --  error emitted. Try to continue quietly.
3118
3119             elsif Error_Posted (E)
3120               and then Sloc (E) = No_Location
3121               and then Nkind (Parent (E)) = N_Package_Specification
3122               and then Current_Scope = Standard_Standard
3123             then
3124                Set_Scope (Def_Id, Current_Scope);
3125                return;
3126
3127             else
3128                Error_Msg_N ("& conflicts with declaration#", Def_Id);
3129
3130                --  Avoid cascaded messages with duplicate components in
3131                --  derived types.
3132
3133                if Ekind_In (E, E_Component, E_Discriminant) then
3134                   return;
3135                end if;
3136             end if;
3137
3138             if Nkind (Parent (Parent (Def_Id))) =
3139                 N_Generic_Subprogram_Declaration
3140               and then Def_Id =
3141                 Defining_Entity (Specification (Parent (Parent (Def_Id))))
3142             then
3143                Error_Msg_N ("\generic units cannot be overloaded", Def_Id);
3144             end if;
3145
3146             --  If entity is in standard, then we are in trouble, because it
3147             --  means that we have a library package with a duplicated name.
3148             --  That's hard to recover from, so abort!
3149
3150             if S = Standard_Standard then
3151                raise Unrecoverable_Error;
3152
3153             --  Otherwise we continue with the declaration. Having two
3154             --  identical declarations should not cause us too much trouble!
3155
3156             else
3157                null;
3158             end if;
3159          end if;
3160       end if;
3161
3162       --  If we fall through, declaration is OK, at least OK enough to continue
3163
3164       --  If Def_Id is a discriminant or a record component we are in the midst
3165       --  of inheriting components in a derived record definition. Preserve
3166       --  their Ekind and Etype.
3167
3168       if Ekind_In (Def_Id, E_Discriminant, E_Component) then
3169          null;
3170
3171       --  If a type is already set, leave it alone (happens when a type
3172       --  declaration is reanalyzed following a call to the optimizer).
3173
3174       elsif Present (Etype (Def_Id)) then
3175          null;
3176
3177       --  Otherwise, the kind E_Void insures that premature uses of the entity
3178       --  will be detected. Any_Type insures that no cascaded errors will occur
3179
3180       else
3181          Set_Ekind (Def_Id, E_Void);
3182          Set_Etype (Def_Id, Any_Type);
3183       end if;
3184
3185       --  Inherited discriminants and components in derived record types are
3186       --  immediately visible. Itypes are not.
3187
3188       if Ekind_In (Def_Id, E_Discriminant, E_Component)
3189         or else (No (Corresponding_Remote_Type (Def_Id))
3190                  and then not Is_Itype (Def_Id))
3191       then
3192          Set_Is_Immediately_Visible (Def_Id);
3193          Set_Current_Entity         (Def_Id);
3194       end if;
3195
3196       Set_Homonym       (Def_Id, C);
3197       Append_Entity     (Def_Id, S);
3198       Set_Public_Status (Def_Id);
3199
3200       --  Warn if new entity hides an old one
3201
3202       if Warn_On_Hiding and then Present (C)
3203
3204          --  Don't warn for record components since they always have a well
3205          --  defined scope which does not confuse other uses. Note that in
3206          --  some cases, Ekind has not been set yet.
3207
3208          and then Ekind (C) /= E_Component
3209          and then Ekind (C) /= E_Discriminant
3210          and then Nkind (Parent (C)) /= N_Component_Declaration
3211          and then Ekind (Def_Id) /= E_Component
3212          and then Ekind (Def_Id) /= E_Discriminant
3213          and then Nkind (Parent (Def_Id)) /= N_Component_Declaration
3214
3215          --  Don't warn for one character variables. It is too common to use
3216          --  such variables as locals and will just cause too many false hits.
3217
3218          and then Length_Of_Name (Chars (C)) /= 1
3219
3220          --  Don't warn for non-source entities
3221
3222          and then Comes_From_Source (C)
3223          and then Comes_From_Source (Def_Id)
3224
3225          --  Don't warn unless entity in question is in extended main source
3226
3227          and then In_Extended_Main_Source_Unit (Def_Id)
3228
3229          --  Finally, the hidden entity must be either immediately visible or
3230          --  use visible (i.e. from a used package).
3231
3232          and then
3233            (Is_Immediately_Visible (C)
3234               or else
3235             Is_Potentially_Use_Visible (C))
3236       then
3237          Error_Msg_Sloc := Sloc (C);
3238          Error_Msg_N ("declaration hides &#?", Def_Id);
3239       end if;
3240    end Enter_Name;
3241
3242    --------------------------
3243    -- Explain_Limited_Type --
3244    --------------------------
3245
3246    procedure Explain_Limited_Type (T : Entity_Id; N : Node_Id) is
3247       C : Entity_Id;
3248
3249    begin
3250       --  For array, component type must be limited
3251
3252       if Is_Array_Type (T) then
3253          Error_Msg_Node_2 := T;
3254          Error_Msg_NE
3255            ("\component type& of type& is limited", N, Component_Type (T));
3256          Explain_Limited_Type (Component_Type (T), N);
3257
3258       elsif Is_Record_Type (T) then
3259
3260          --  No need for extra messages if explicit limited record
3261
3262          if Is_Limited_Record (Base_Type (T)) then
3263             return;
3264          end if;
3265
3266          --  Otherwise find a limited component. Check only components that
3267          --  come from source, or inherited components that appear in the
3268          --  source of the ancestor.
3269
3270          C := First_Component (T);
3271          while Present (C) loop
3272             if Is_Limited_Type (Etype (C))
3273               and then
3274                 (Comes_From_Source (C)
3275                    or else
3276                      (Present (Original_Record_Component (C))
3277                        and then
3278                          Comes_From_Source (Original_Record_Component (C))))
3279             then
3280                Error_Msg_Node_2 := T;
3281                Error_Msg_NE ("\component& of type& has limited type", N, C);
3282                Explain_Limited_Type (Etype (C), N);
3283                return;
3284             end if;
3285
3286             Next_Component (C);
3287          end loop;
3288
3289          --  The type may be declared explicitly limited, even if no component
3290          --  of it is limited, in which case we fall out of the loop.
3291          return;
3292       end if;
3293    end Explain_Limited_Type;
3294
3295    -----------------
3296    -- Find_Actual --
3297    -----------------
3298
3299    procedure Find_Actual
3300      (N        : Node_Id;
3301       Formal   : out Entity_Id;
3302       Call     : out Node_Id)
3303    is
3304       Parnt  : constant Node_Id := Parent (N);
3305       Actual : Node_Id;
3306
3307    begin
3308       if (Nkind (Parnt) = N_Indexed_Component
3309             or else
3310           Nkind (Parnt) = N_Selected_Component)
3311         and then N = Prefix (Parnt)
3312       then
3313          Find_Actual (Parnt, Formal, Call);
3314          return;
3315
3316       elsif Nkind (Parnt) = N_Parameter_Association
3317         and then N = Explicit_Actual_Parameter (Parnt)
3318       then
3319          Call := Parent (Parnt);
3320
3321       elsif Nkind (Parnt) = N_Procedure_Call_Statement then
3322          Call := Parnt;
3323
3324       else
3325          Formal := Empty;
3326          Call   := Empty;
3327          return;
3328       end if;
3329
3330       --  If we have a call to a subprogram look for the parameter. Note that
3331       --  we exclude overloaded calls, since we don't know enough to be sure
3332       --  of giving the right answer in this case.
3333
3334       if Is_Entity_Name (Name (Call))
3335         and then Present (Entity (Name (Call)))
3336         and then Is_Overloadable (Entity (Name (Call)))
3337         and then not Is_Overloaded (Name (Call))
3338       then
3339          --  Fall here if we are definitely a parameter
3340
3341          Actual := First_Actual (Call);
3342          Formal := First_Formal (Entity (Name (Call)));
3343          while Present (Formal) and then Present (Actual) loop
3344             if Actual = N then
3345                return;
3346             else
3347                Actual := Next_Actual (Actual);
3348                Formal := Next_Formal (Formal);
3349             end if;
3350          end loop;
3351       end if;
3352
3353       --  Fall through here if we did not find matching actual
3354
3355       Formal := Empty;
3356       Call   := Empty;
3357    end Find_Actual;
3358
3359    ---------------------------
3360    -- Find_Body_Discriminal --
3361    ---------------------------
3362
3363    function Find_Body_Discriminal
3364      (Spec_Discriminant : Entity_Id) return Entity_Id
3365    is
3366       pragma Assert (Is_Concurrent_Record_Type (Scope (Spec_Discriminant)));
3367
3368       Tsk  : constant Entity_Id :=
3369                Corresponding_Concurrent_Type (Scope (Spec_Discriminant));
3370       Disc : Entity_Id;
3371
3372    begin
3373       --  Find discriminant of original concurrent type, and use its current
3374       --  discriminal, which is the renaming within the task/protected body.
3375
3376       Disc := First_Discriminant (Tsk);
3377       while Present (Disc) loop
3378          if Chars (Disc) = Chars (Spec_Discriminant) then
3379             return Discriminal (Disc);
3380          end if;
3381
3382          Next_Discriminant (Disc);
3383       end loop;
3384
3385       --  That loop should always succeed in finding a matching entry and
3386       --  returning. Fatal error if not.
3387
3388       raise Program_Error;
3389    end Find_Body_Discriminal;
3390
3391    -------------------------------------
3392    -- Find_Corresponding_Discriminant --
3393    -------------------------------------
3394
3395    function Find_Corresponding_Discriminant
3396      (Id  : Node_Id;
3397       Typ : Entity_Id) return Entity_Id
3398    is
3399       Par_Disc : Entity_Id;
3400       Old_Disc : Entity_Id;
3401       New_Disc : Entity_Id;
3402
3403    begin
3404       Par_Disc := Original_Record_Component (Original_Discriminant (Id));
3405
3406       --  The original type may currently be private, and the discriminant
3407       --  only appear on its full view.
3408
3409       if Is_Private_Type (Scope (Par_Disc))
3410         and then not Has_Discriminants (Scope (Par_Disc))
3411         and then Present (Full_View (Scope (Par_Disc)))
3412       then
3413          Old_Disc := First_Discriminant (Full_View (Scope (Par_Disc)));
3414       else
3415          Old_Disc := First_Discriminant (Scope (Par_Disc));
3416       end if;
3417
3418       if Is_Class_Wide_Type (Typ) then
3419          New_Disc := First_Discriminant (Root_Type (Typ));
3420       else
3421          New_Disc := First_Discriminant (Typ);
3422       end if;
3423
3424       while Present (Old_Disc) and then Present (New_Disc) loop
3425          if Old_Disc = Par_Disc  then
3426             return New_Disc;
3427          else
3428             Next_Discriminant (Old_Disc);
3429             Next_Discriminant (New_Disc);
3430          end if;
3431       end loop;
3432
3433       --  Should always find it
3434
3435       raise Program_Error;
3436    end Find_Corresponding_Discriminant;
3437
3438    --------------------------
3439    -- Find_Overlaid_Entity --
3440    --------------------------
3441
3442    procedure Find_Overlaid_Entity
3443      (N   : Node_Id;
3444       Ent : out Entity_Id;
3445       Off : out Boolean)
3446    is
3447       Expr : Node_Id;
3448
3449    begin
3450       --  We are looking for one of the two following forms:
3451
3452       --    for X'Address use Y'Address
3453
3454       --  or
3455
3456       --    Const : constant Address := expr;
3457       --    ...
3458       --    for X'Address use Const;
3459
3460       --  In the second case, the expr is either Y'Address, or recursively a
3461       --  constant that eventually references Y'Address.
3462
3463       Ent := Empty;
3464       Off := False;
3465
3466       if Nkind (N) = N_Attribute_Definition_Clause
3467         and then Chars (N) = Name_Address
3468       then
3469          Expr := Expression (N);
3470
3471          --  This loop checks the form of the expression for Y'Address,
3472          --  using recursion to deal with intermediate constants.
3473
3474          loop
3475             --  Check for Y'Address
3476
3477             if Nkind (Expr) = N_Attribute_Reference
3478               and then Attribute_Name (Expr) = Name_Address
3479             then
3480                Expr := Prefix (Expr);
3481                exit;
3482
3483                --  Check for Const where Const is a constant entity
3484
3485             elsif Is_Entity_Name (Expr)
3486               and then Ekind (Entity (Expr)) = E_Constant
3487             then
3488                Expr := Constant_Value (Entity (Expr));
3489
3490             --  Anything else does not need checking
3491
3492             else
3493                return;
3494             end if;
3495          end loop;
3496
3497          --  This loop checks the form of the prefix for an entity,
3498          --  using recursion to deal with intermediate components.
3499
3500          loop
3501             --  Check for Y where Y is an entity
3502
3503             if Is_Entity_Name (Expr) then
3504                Ent := Entity (Expr);
3505                return;
3506
3507             --  Check for components
3508
3509             elsif
3510                Nkind_In (Expr, N_Selected_Component, N_Indexed_Component) then
3511
3512                Expr := Prefix (Expr);
3513                Off := True;
3514
3515             --  Anything else does not need checking
3516
3517             else
3518                return;
3519             end if;
3520          end loop;
3521       end if;
3522    end Find_Overlaid_Entity;
3523
3524    -------------------------
3525    -- Find_Parameter_Type --
3526    -------------------------
3527
3528    function Find_Parameter_Type (Param : Node_Id) return Entity_Id is
3529    begin
3530       if Nkind (Param) /= N_Parameter_Specification then
3531          return Empty;
3532
3533       --  For an access parameter, obtain the type from the formal entity
3534       --  itself, because access to subprogram nodes do not carry a type.
3535       --  Shouldn't we always use the formal entity ???
3536
3537       elsif Nkind (Parameter_Type (Param)) = N_Access_Definition then
3538          return Etype (Defining_Identifier (Param));
3539
3540       else
3541          return Etype (Parameter_Type (Param));
3542       end if;
3543    end Find_Parameter_Type;
3544
3545    -----------------------------
3546    -- Find_Static_Alternative --
3547    -----------------------------
3548
3549    function Find_Static_Alternative (N : Node_Id) return Node_Id is
3550       Expr   : constant Node_Id := Expression (N);
3551       Val    : constant Uint    := Expr_Value (Expr);
3552       Alt    : Node_Id;
3553       Choice : Node_Id;
3554
3555    begin
3556       Alt := First (Alternatives (N));
3557
3558       Search : loop
3559          if Nkind (Alt) /= N_Pragma then
3560             Choice := First (Discrete_Choices (Alt));
3561             while Present (Choice) loop
3562
3563                --  Others choice, always matches
3564
3565                if Nkind (Choice) = N_Others_Choice then
3566                   exit Search;
3567
3568                --  Range, check if value is in the range
3569
3570                elsif Nkind (Choice) = N_Range then
3571                   exit Search when
3572                     Val >= Expr_Value (Low_Bound (Choice))
3573                       and then
3574                     Val <= Expr_Value (High_Bound (Choice));
3575
3576                --  Choice is a subtype name. Note that we know it must
3577                --  be a static subtype, since otherwise it would have
3578                --  been diagnosed as illegal.
3579
3580                elsif Is_Entity_Name (Choice)
3581                  and then Is_Type (Entity (Choice))
3582                then
3583                   exit Search when Is_In_Range (Expr, Etype (Choice),
3584                                                 Assume_Valid => False);
3585
3586                --  Choice is a subtype indication
3587
3588                elsif Nkind (Choice) = N_Subtype_Indication then
3589                   declare
3590                      C : constant Node_Id := Constraint (Choice);
3591                      R : constant Node_Id := Range_Expression (C);
3592
3593                   begin
3594                      exit Search when
3595                        Val >= Expr_Value (Low_Bound (R))
3596                          and then
3597                        Val <= Expr_Value (High_Bound (R));
3598                   end;
3599
3600                --  Choice is a simple expression
3601
3602                else
3603                   exit Search when Val = Expr_Value (Choice);
3604                end if;
3605
3606                Next (Choice);
3607             end loop;
3608          end if;
3609
3610          Next (Alt);
3611          pragma Assert (Present (Alt));
3612       end loop Search;
3613
3614       --  The above loop *must* terminate by finding a match, since
3615       --  we know the case statement is valid, and the value of the
3616       --  expression is known at compile time. When we fall out of
3617       --  the loop, Alt points to the alternative that we know will
3618       --  be selected at run time.
3619
3620       return Alt;
3621    end Find_Static_Alternative;
3622
3623    ------------------
3624    -- First_Actual --
3625    ------------------
3626
3627    function First_Actual (Node : Node_Id) return Node_Id is
3628       N : Node_Id;
3629
3630    begin
3631       if No (Parameter_Associations (Node)) then
3632          return Empty;
3633       end if;
3634
3635       N := First (Parameter_Associations (Node));
3636
3637       if Nkind (N) = N_Parameter_Association then
3638          return First_Named_Actual (Node);
3639       else
3640          return N;
3641       end if;
3642    end First_Actual;
3643
3644    -----------------------
3645    -- Gather_Components --
3646    -----------------------
3647
3648    procedure Gather_Components
3649      (Typ           : Entity_Id;
3650       Comp_List     : Node_Id;
3651       Governed_By   : List_Id;
3652       Into          : Elist_Id;
3653       Report_Errors : out Boolean)
3654    is
3655       Assoc           : Node_Id;
3656       Variant         : Node_Id;
3657       Discrete_Choice : Node_Id;
3658       Comp_Item       : Node_Id;
3659
3660       Discrim       : Entity_Id;
3661       Discrim_Name  : Node_Id;
3662       Discrim_Value : Node_Id;
3663
3664    begin
3665       Report_Errors := False;
3666
3667       if No (Comp_List) or else Null_Present (Comp_List) then
3668          return;
3669
3670       elsif Present (Component_Items (Comp_List)) then
3671          Comp_Item := First (Component_Items (Comp_List));
3672
3673       else
3674          Comp_Item := Empty;
3675       end if;
3676
3677       while Present (Comp_Item) loop
3678
3679          --  Skip the tag of a tagged record, the interface tags, as well
3680          --  as all items that are not user components (anonymous types,
3681          --  rep clauses, Parent field, controller field).
3682
3683          if Nkind (Comp_Item) = N_Component_Declaration then
3684             declare
3685                Comp : constant Entity_Id := Defining_Identifier (Comp_Item);
3686             begin
3687                if not Is_Tag (Comp)
3688                  and then Chars (Comp) /= Name_uParent
3689                  and then Chars (Comp) /= Name_uController
3690                then
3691                   Append_Elmt (Comp, Into);
3692                end if;
3693             end;
3694          end if;
3695
3696          Next (Comp_Item);
3697       end loop;
3698
3699       if No (Variant_Part (Comp_List)) then
3700          return;
3701       else
3702          Discrim_Name := Name (Variant_Part (Comp_List));
3703          Variant := First_Non_Pragma (Variants (Variant_Part (Comp_List)));
3704       end if;
3705
3706       --  Look for the discriminant that governs this variant part.
3707       --  The discriminant *must* be in the Governed_By List
3708
3709       Assoc := First (Governed_By);
3710       Find_Constraint : loop
3711          Discrim := First (Choices (Assoc));
3712          exit Find_Constraint when Chars (Discrim_Name) = Chars (Discrim)
3713            or else (Present (Corresponding_Discriminant (Entity (Discrim)))
3714                       and then
3715                     Chars (Corresponding_Discriminant (Entity (Discrim)))
3716                          = Chars  (Discrim_Name))
3717            or else Chars (Original_Record_Component (Entity (Discrim)))
3718                          = Chars (Discrim_Name);
3719
3720          if No (Next (Assoc)) then
3721             if not Is_Constrained (Typ)
3722               and then Is_Derived_Type (Typ)
3723               and then Present (Stored_Constraint (Typ))
3724             then
3725                --  If the type is a tagged type with inherited discriminants,
3726                --  use the stored constraint on the parent in order to find
3727                --  the values of discriminants that are otherwise hidden by an
3728                --  explicit constraint. Renamed discriminants are handled in
3729                --  the code above.
3730
3731                --  If several parent discriminants are renamed by a single
3732                --  discriminant of the derived type, the call to obtain the
3733                --  Corresponding_Discriminant field only retrieves the last
3734                --  of them. We recover the constraint on the others from the
3735                --  Stored_Constraint as well.
3736
3737                declare
3738                   D : Entity_Id;
3739                   C : Elmt_Id;
3740
3741                begin
3742                   D := First_Discriminant (Etype (Typ));
3743                   C := First_Elmt (Stored_Constraint (Typ));
3744                   while Present (D) and then Present (C) loop
3745                      if Chars (Discrim_Name) = Chars (D) then
3746                         if Is_Entity_Name (Node (C))
3747                           and then Entity (Node (C)) = Entity (Discrim)
3748                         then
3749                            --  D is renamed by Discrim, whose value is given in
3750                            --  Assoc.
3751
3752                            null;
3753
3754                         else
3755                            Assoc :=
3756                              Make_Component_Association (Sloc (Typ),
3757                                New_List
3758                                  (New_Occurrence_Of (D, Sloc (Typ))),
3759                                   Duplicate_Subexpr_No_Checks (Node (C)));
3760                         end if;
3761                         exit Find_Constraint;
3762                      end if;
3763
3764                      Next_Discriminant (D);
3765                      Next_Elmt (C);
3766                   end loop;
3767                end;
3768             end if;
3769          end if;
3770
3771          if No (Next (Assoc)) then
3772             Error_Msg_NE (" missing value for discriminant&",
3773               First (Governed_By), Discrim_Name);
3774             Report_Errors := True;
3775             return;
3776          end if;
3777
3778          Next (Assoc);
3779       end loop Find_Constraint;
3780
3781       Discrim_Value := Expression (Assoc);
3782
3783       if not Is_OK_Static_Expression (Discrim_Value) then
3784          Error_Msg_FE
3785            ("value for discriminant & must be static!",
3786             Discrim_Value, Discrim);
3787          Why_Not_Static (Discrim_Value);
3788          Report_Errors := True;
3789          return;
3790       end if;
3791
3792       Search_For_Discriminant_Value : declare
3793          Low  : Node_Id;
3794          High : Node_Id;
3795
3796          UI_High          : Uint;
3797          UI_Low           : Uint;
3798          UI_Discrim_Value : constant Uint := Expr_Value (Discrim_Value);
3799
3800       begin
3801          Find_Discrete_Value : while Present (Variant) loop
3802             Discrete_Choice := First (Discrete_Choices (Variant));
3803             while Present (Discrete_Choice) loop
3804
3805                exit Find_Discrete_Value when
3806                  Nkind (Discrete_Choice) = N_Others_Choice;
3807
3808                Get_Index_Bounds (Discrete_Choice, Low, High);
3809
3810                UI_Low  := Expr_Value (Low);
3811                UI_High := Expr_Value (High);
3812
3813                exit Find_Discrete_Value when
3814                  UI_Low <= UI_Discrim_Value
3815                    and then
3816                  UI_High >= UI_Discrim_Value;
3817
3818                Next (Discrete_Choice);
3819             end loop;
3820
3821             Next_Non_Pragma (Variant);
3822          end loop Find_Discrete_Value;
3823       end Search_For_Discriminant_Value;
3824
3825       if No (Variant) then
3826          Error_Msg_NE
3827            ("value of discriminant & is out of range", Discrim_Value, Discrim);
3828          Report_Errors := True;
3829          return;
3830       end  if;
3831
3832       --  If we have found the corresponding choice, recursively add its
3833       --  components to the Into list.
3834
3835       Gather_Components (Empty,
3836         Component_List (Variant), Governed_By, Into, Report_Errors);
3837    end Gather_Components;
3838
3839    ------------------------
3840    -- Get_Actual_Subtype --
3841    ------------------------
3842
3843    function Get_Actual_Subtype (N : Node_Id) return Entity_Id is
3844       Typ  : constant Entity_Id := Etype (N);
3845       Utyp : Entity_Id := Underlying_Type (Typ);
3846       Decl : Node_Id;
3847       Atyp : Entity_Id;
3848
3849    begin
3850       if No (Utyp) then
3851          Utyp := Typ;
3852       end if;
3853
3854       --  If what we have is an identifier that references a subprogram
3855       --  formal, or a variable or constant object, then we get the actual
3856       --  subtype from the referenced entity if one has been built.
3857
3858       if Nkind (N) = N_Identifier
3859         and then
3860           (Is_Formal (Entity (N))
3861             or else Ekind (Entity (N)) = E_Constant
3862             or else Ekind (Entity (N)) = E_Variable)
3863         and then Present (Actual_Subtype (Entity (N)))
3864       then
3865          return Actual_Subtype (Entity (N));
3866
3867       --  Actual subtype of unchecked union is always itself. We never need
3868       --  the "real" actual subtype. If we did, we couldn't get it anyway
3869       --  because the discriminant is not available. The restrictions on
3870       --  Unchecked_Union are designed to make sure that this is OK.
3871
3872       elsif Is_Unchecked_Union (Base_Type (Utyp)) then
3873          return Typ;
3874
3875       --  Here for the unconstrained case, we must find actual subtype
3876       --  No actual subtype is available, so we must build it on the fly.
3877
3878       --  Checking the type, not the underlying type, for constrainedness
3879       --  seems to be necessary. Maybe all the tests should be on the type???
3880
3881       elsif (not Is_Constrained (Typ))
3882            and then (Is_Array_Type (Utyp)
3883                       or else (Is_Record_Type (Utyp)
3884                                 and then Has_Discriminants (Utyp)))
3885            and then not Has_Unknown_Discriminants (Utyp)
3886            and then not (Ekind (Utyp) = E_String_Literal_Subtype)
3887       then
3888          --  Nothing to do if in spec expression (why not???)
3889
3890          if In_Spec_Expression then
3891             return Typ;
3892
3893          elsif Is_Private_Type (Typ)
3894            and then not Has_Discriminants (Typ)
3895          then
3896             --  If the type has no discriminants, there is no subtype to
3897             --  build, even if the underlying type is discriminated.
3898
3899             return Typ;
3900
3901          --  Else build the actual subtype
3902
3903          else
3904             Decl := Build_Actual_Subtype (Typ, N);
3905             Atyp := Defining_Identifier (Decl);
3906
3907             --  If Build_Actual_Subtype generated a new declaration then use it
3908
3909             if Atyp /= Typ then
3910
3911                --  The actual subtype is an Itype, so analyze the declaration,
3912                --  but do not attach it to the tree, to get the type defined.
3913
3914                Set_Parent (Decl, N);
3915                Set_Is_Itype (Atyp);
3916                Analyze (Decl, Suppress => All_Checks);
3917                Set_Associated_Node_For_Itype (Atyp, N);
3918                Set_Has_Delayed_Freeze (Atyp, False);
3919
3920                --  We need to freeze the actual subtype immediately. This is
3921                --  needed, because otherwise this Itype will not get frozen
3922                --  at all, and it is always safe to freeze on creation because
3923                --  any associated types must be frozen at this point.
3924
3925                Freeze_Itype (Atyp, N);
3926                return Atyp;
3927
3928             --  Otherwise we did not build a declaration, so return original
3929
3930             else
3931                return Typ;
3932             end if;
3933          end if;
3934
3935       --  For all remaining cases, the actual subtype is the same as
3936       --  the nominal type.
3937
3938       else
3939          return Typ;
3940       end if;
3941    end Get_Actual_Subtype;
3942
3943    -------------------------------------
3944    -- Get_Actual_Subtype_If_Available --
3945    -------------------------------------
3946
3947    function Get_Actual_Subtype_If_Available (N : Node_Id) return Entity_Id is
3948       Typ  : constant Entity_Id := Etype (N);
3949
3950    begin
3951       --  If what we have is an identifier that references a subprogram
3952       --  formal, or a variable or constant object, then we get the actual
3953       --  subtype from the referenced entity if one has been built.
3954
3955       if Nkind (N) = N_Identifier
3956         and then
3957           (Is_Formal (Entity (N))
3958             or else Ekind (Entity (N)) = E_Constant
3959             or else Ekind (Entity (N)) = E_Variable)
3960         and then Present (Actual_Subtype (Entity (N)))
3961       then
3962          return Actual_Subtype (Entity (N));
3963
3964       --  Otherwise the Etype of N is returned unchanged
3965
3966       else
3967          return Typ;
3968       end if;
3969    end Get_Actual_Subtype_If_Available;
3970
3971    -------------------------------
3972    -- Get_Default_External_Name --
3973    -------------------------------
3974
3975    function Get_Default_External_Name (E : Node_Or_Entity_Id) return Node_Id is
3976    begin
3977       Get_Decoded_Name_String (Chars (E));
3978
3979       if Opt.External_Name_Imp_Casing = Uppercase then
3980          Set_Casing (All_Upper_Case);
3981       else
3982          Set_Casing (All_Lower_Case);
3983       end if;
3984
3985       return
3986         Make_String_Literal (Sloc (E),
3987           Strval => String_From_Name_Buffer);
3988    end Get_Default_External_Name;
3989
3990    ---------------------------
3991    -- Get_Enum_Lit_From_Pos --
3992    ---------------------------
3993
3994    function Get_Enum_Lit_From_Pos
3995      (T   : Entity_Id;
3996       Pos : Uint;
3997       Loc : Source_Ptr) return Node_Id
3998    is
3999       Lit : Node_Id;
4000
4001    begin
4002       --  In the case where the literal is of type Character, Wide_Character
4003       --  or Wide_Wide_Character or of a type derived from them, there needs
4004       --  to be some special handling since there is no explicit chain of
4005       --  literals to search. Instead, an N_Character_Literal node is created
4006       --  with the appropriate Char_Code and Chars fields.
4007
4008       if Is_Standard_Character_Type (T) then
4009          Set_Character_Literal_Name (UI_To_CC (Pos));
4010          return
4011            Make_Character_Literal (Loc,
4012              Chars              => Name_Find,
4013              Char_Literal_Value => Pos);
4014
4015       --  For all other cases, we have a complete table of literals, and
4016       --  we simply iterate through the chain of literal until the one
4017       --  with the desired position value is found.
4018       --
4019
4020       else
4021          Lit := First_Literal (Base_Type (T));
4022          for J in 1 .. UI_To_Int (Pos) loop
4023             Next_Literal (Lit);
4024          end loop;
4025
4026          return New_Occurrence_Of (Lit, Loc);
4027       end if;
4028    end Get_Enum_Lit_From_Pos;
4029
4030    ------------------------
4031    -- Get_Generic_Entity --
4032    ------------------------
4033
4034    function Get_Generic_Entity (N : Node_Id) return Entity_Id is
4035       Ent : constant Entity_Id := Entity (Name (N));
4036    begin
4037       if Present (Renamed_Object (Ent)) then
4038          return Renamed_Object (Ent);
4039       else
4040          return Ent;
4041       end if;
4042    end Get_Generic_Entity;
4043
4044    ----------------------
4045    -- Get_Index_Bounds --
4046    ----------------------
4047
4048    procedure Get_Index_Bounds (N : Node_Id; L, H : out Node_Id) is
4049       Kind : constant Node_Kind := Nkind (N);
4050       R    : Node_Id;
4051
4052    begin
4053       if Kind = N_Range then
4054          L := Low_Bound (N);
4055          H := High_Bound (N);
4056
4057       elsif Kind = N_Subtype_Indication then
4058          R := Range_Expression (Constraint (N));
4059
4060          if R = Error then
4061             L := Error;
4062             H := Error;
4063             return;
4064
4065          else
4066             L := Low_Bound  (Range_Expression (Constraint (N)));
4067             H := High_Bound (Range_Expression (Constraint (N)));
4068          end if;
4069
4070       elsif Is_Entity_Name (N) and then Is_Type (Entity (N)) then
4071          if Error_Posted (Scalar_Range (Entity (N))) then
4072             L := Error;
4073             H := Error;
4074
4075          elsif Nkind (Scalar_Range (Entity (N))) = N_Subtype_Indication then
4076             Get_Index_Bounds (Scalar_Range (Entity (N)), L, H);
4077
4078          else
4079             L := Low_Bound  (Scalar_Range (Entity (N)));
4080             H := High_Bound (Scalar_Range (Entity (N)));
4081          end if;
4082
4083       else
4084          --  N is an expression, indicating a range with one value
4085
4086          L := N;
4087          H := N;
4088       end if;
4089    end Get_Index_Bounds;
4090
4091    ----------------------------------
4092    -- Get_Library_Unit_Name_string --
4093    ----------------------------------
4094
4095    procedure Get_Library_Unit_Name_String (Decl_Node : Node_Id) is
4096       Unit_Name_Id : constant Unit_Name_Type := Get_Unit_Name (Decl_Node);
4097
4098    begin
4099       Get_Unit_Name_String (Unit_Name_Id);
4100
4101       --  Remove seven last character (" (spec)" or " (body)")
4102
4103       Name_Len := Name_Len - 7;
4104       pragma Assert (Name_Buffer (Name_Len + 1) = ' ');
4105    end Get_Library_Unit_Name_String;
4106
4107    ------------------------
4108    -- Get_Name_Entity_Id --
4109    ------------------------
4110
4111    function Get_Name_Entity_Id (Id : Name_Id) return Entity_Id is
4112    begin
4113       return Entity_Id (Get_Name_Table_Info (Id));
4114    end Get_Name_Entity_Id;
4115
4116    -------------------
4117    -- Get_Pragma_Id --
4118    -------------------
4119
4120    function Get_Pragma_Id (N : Node_Id) return Pragma_Id is
4121    begin
4122       return Get_Pragma_Id (Pragma_Name (N));
4123    end Get_Pragma_Id;
4124
4125    ---------------------------
4126    -- Get_Referenced_Object --
4127    ---------------------------
4128
4129    function Get_Referenced_Object (N : Node_Id) return Node_Id is
4130       R : Node_Id;
4131
4132    begin
4133       R := N;
4134       while Is_Entity_Name (R)
4135         and then Present (Renamed_Object (Entity (R)))
4136       loop
4137          R := Renamed_Object (Entity (R));
4138       end loop;
4139
4140       return R;
4141    end Get_Referenced_Object;
4142
4143    ------------------------
4144    -- Get_Renamed_Entity --
4145    ------------------------
4146
4147    function Get_Renamed_Entity (E : Entity_Id) return Entity_Id is
4148       R : Entity_Id;
4149
4150    begin
4151       R := E;
4152       while Present (Renamed_Entity (R)) loop
4153          R := Renamed_Entity (R);
4154       end loop;
4155
4156       return R;
4157    end Get_Renamed_Entity;
4158
4159    -------------------------
4160    -- Get_Subprogram_Body --
4161    -------------------------
4162
4163    function Get_Subprogram_Body (E : Entity_Id) return Node_Id is
4164       Decl : Node_Id;
4165
4166    begin
4167       Decl := Unit_Declaration_Node (E);
4168
4169       if Nkind (Decl) = N_Subprogram_Body then
4170          return Decl;
4171
4172       --  The below comment is bad, because it is possible for
4173       --  Nkind (Decl) to be an N_Subprogram_Body_Stub ???
4174
4175       else           --  Nkind (Decl) = N_Subprogram_Declaration
4176
4177          if Present (Corresponding_Body (Decl)) then
4178             return Unit_Declaration_Node (Corresponding_Body (Decl));
4179
4180          --  Imported subprogram case
4181
4182          else
4183             return Empty;
4184          end if;
4185       end if;
4186    end Get_Subprogram_Body;
4187
4188    ---------------------------
4189    -- Get_Subprogram_Entity --
4190    ---------------------------
4191
4192    function Get_Subprogram_Entity (Nod : Node_Id) return Entity_Id is
4193       Nam  : Node_Id;
4194       Proc : Entity_Id;
4195
4196    begin
4197       if Nkind (Nod) = N_Accept_Statement then
4198          Nam := Entry_Direct_Name (Nod);
4199
4200       --  For an entry call, the prefix of the call is a selected component.
4201       --  Need additional code for internal calls ???
4202
4203       elsif Nkind (Nod) = N_Entry_Call_Statement then
4204          if Nkind (Name (Nod)) = N_Selected_Component then
4205             Nam := Entity (Selector_Name (Name (Nod)));
4206          else
4207             Nam := Empty;
4208          end if;
4209
4210       else
4211          Nam := Name (Nod);
4212       end if;
4213
4214       if Nkind (Nam) = N_Explicit_Dereference then
4215          Proc := Etype (Prefix (Nam));
4216       elsif Is_Entity_Name (Nam) then
4217          Proc := Entity (Nam);
4218       else
4219          return Empty;
4220       end if;
4221
4222       if Is_Object (Proc) then
4223          Proc := Etype (Proc);
4224       end if;
4225
4226       if Ekind (Proc) = E_Access_Subprogram_Type then
4227          Proc := Directly_Designated_Type (Proc);
4228       end if;
4229
4230       if not Is_Subprogram (Proc)
4231         and then Ekind (Proc) /= E_Subprogram_Type
4232       then
4233          return Empty;
4234       else
4235          return Proc;
4236       end if;
4237    end Get_Subprogram_Entity;
4238
4239    -----------------------------
4240    -- Get_Task_Body_Procedure --
4241    -----------------------------
4242
4243    function Get_Task_Body_Procedure (E : Entity_Id) return Node_Id is
4244    begin
4245       --  Note: A task type may be the completion of a private type with
4246       --  discriminants. When performing elaboration checks on a task
4247       --  declaration, the current view of the type may be the private one,
4248       --  and the procedure that holds the body of the task is held in its
4249       --  underlying type.
4250
4251       --  This is an odd function, why not have Task_Body_Procedure do
4252       --  the following digging???
4253
4254       return Task_Body_Procedure (Underlying_Type (Root_Type (E)));
4255    end Get_Task_Body_Procedure;
4256
4257    -----------------------
4258    -- Has_Access_Values --
4259    -----------------------
4260
4261    function Has_Access_Values (T : Entity_Id) return Boolean is
4262       Typ : constant Entity_Id := Underlying_Type (T);
4263
4264    begin
4265       --  Case of a private type which is not completed yet. This can only
4266       --  happen in the case of a generic format type appearing directly, or
4267       --  as a component of the type to which this function is being applied
4268       --  at the top level. Return False in this case, since we certainly do
4269       --  not know that the type contains access types.
4270
4271       if No (Typ) then
4272          return False;
4273
4274       elsif Is_Access_Type (Typ) then
4275          return True;
4276
4277       elsif Is_Array_Type (Typ) then
4278          return Has_Access_Values (Component_Type (Typ));
4279
4280       elsif Is_Record_Type (Typ) then
4281          declare
4282             Comp : Entity_Id;
4283
4284          begin
4285             --  Loop to Check components
4286
4287             Comp := First_Component_Or_Discriminant (Typ);
4288             while Present (Comp) loop
4289
4290                --  Check for access component, tag field does not count, even
4291                --  though it is implemented internally using an access type.
4292
4293                if Has_Access_Values (Etype (Comp))
4294                  and then Chars (Comp) /= Name_uTag
4295                then
4296                   return True;
4297                end if;
4298
4299                Next_Component_Or_Discriminant (Comp);
4300             end loop;
4301          end;
4302
4303          return False;
4304
4305       else
4306          return False;
4307       end if;
4308    end Has_Access_Values;
4309
4310    ------------------------------
4311    -- Has_Compatible_Alignment --
4312    ------------------------------
4313
4314    function Has_Compatible_Alignment
4315      (Obj  : Entity_Id;
4316       Expr : Node_Id) return Alignment_Result
4317    is
4318       function Has_Compatible_Alignment_Internal
4319         (Obj     : Entity_Id;
4320          Expr    : Node_Id;
4321          Default : Alignment_Result) return Alignment_Result;
4322       --  This is the internal recursive function that actually does the work.
4323       --  There is one additional parameter, which says what the result should
4324       --  be if no alignment information is found, and there is no definite
4325       --  indication of compatible alignments. At the outer level, this is set
4326       --  to Unknown, but for internal recursive calls in the case where types
4327       --  are known to be correct, it is set to Known_Compatible.
4328
4329       ---------------------------------------
4330       -- Has_Compatible_Alignment_Internal --
4331       ---------------------------------------
4332
4333       function Has_Compatible_Alignment_Internal
4334         (Obj     : Entity_Id;
4335          Expr    : Node_Id;
4336          Default : Alignment_Result) return Alignment_Result
4337       is
4338          Result : Alignment_Result := Known_Compatible;
4339          --  Holds the current status of the result. Note that once a value of
4340          --  Known_Incompatible is set, it is sticky and does not get changed
4341          --  to Unknown (the value in Result only gets worse as we go along,
4342          --  never better).
4343
4344          Offs : Uint := No_Uint;
4345          --  Set to a factor of the offset from the base object when Expr is a
4346          --  selected or indexed component, based on Component_Bit_Offset and
4347          --  Component_Size respectively. A negative value is used to represent
4348          --  a value which is not known at compile time.
4349
4350          procedure Check_Prefix;
4351          --  Checks the prefix recursively in the case where the expression
4352          --  is an indexed or selected component.
4353
4354          procedure Set_Result (R : Alignment_Result);
4355          --  If R represents a worse outcome (unknown instead of known
4356          --  compatible, or known incompatible), then set Result to R.
4357
4358          ------------------
4359          -- Check_Prefix --
4360          ------------------
4361
4362          procedure Check_Prefix is
4363          begin
4364             --  The subtlety here is that in doing a recursive call to check
4365             --  the prefix, we have to decide what to do in the case where we
4366             --  don't find any specific indication of an alignment problem.
4367
4368             --  At the outer level, we normally set Unknown as the result in
4369             --  this case, since we can only set Known_Compatible if we really
4370             --  know that the alignment value is OK, but for the recursive
4371             --  call, in the case where the types match, and we have not
4372             --  specified a peculiar alignment for the object, we are only
4373             --  concerned about suspicious rep clauses, the default case does
4374             --  not affect us, since the compiler will, in the absence of such
4375             --  rep clauses, ensure that the alignment is correct.
4376
4377             if Default = Known_Compatible
4378               or else
4379                 (Etype (Obj) = Etype (Expr)
4380                   and then (Unknown_Alignment (Obj)
4381                              or else
4382                                Alignment (Obj) = Alignment (Etype (Obj))))
4383             then
4384                Set_Result
4385                  (Has_Compatible_Alignment_Internal
4386                     (Obj, Prefix (Expr), Known_Compatible));
4387
4388             --  In all other cases, we need a full check on the prefix
4389
4390             else
4391                Set_Result
4392                  (Has_Compatible_Alignment_Internal
4393                     (Obj, Prefix (Expr), Unknown));
4394             end if;
4395          end Check_Prefix;
4396
4397          ----------------
4398          -- Set_Result --
4399          ----------------
4400
4401          procedure Set_Result (R : Alignment_Result) is
4402          begin
4403             if R > Result then
4404                Result := R;
4405             end if;
4406          end Set_Result;
4407
4408       --  Start of processing for Has_Compatible_Alignment_Internal
4409
4410       begin
4411          --  If Expr is a selected component, we must make sure there is no
4412          --  potentially troublesome component clause, and that the record is
4413          --  not packed.
4414
4415          if Nkind (Expr) = N_Selected_Component then
4416
4417             --  Packed record always generate unknown alignment
4418
4419             if Is_Packed (Etype (Prefix (Expr))) then
4420                Set_Result (Unknown);
4421             end if;
4422
4423             --  Check prefix and component offset
4424
4425             Check_Prefix;
4426             Offs := Component_Bit_Offset (Entity (Selector_Name (Expr)));
4427
4428          --  If Expr is an indexed component, we must make sure there is no
4429          --  potentially troublesome Component_Size clause and that the array
4430          --  is not bit-packed.
4431
4432          elsif Nkind (Expr) = N_Indexed_Component then
4433             declare
4434                Typ : constant Entity_Id := Etype (Prefix (Expr));
4435                Ind : constant Node_Id   := First_Index (Typ);
4436
4437             begin
4438                --  Bit packed array always generates unknown alignment
4439
4440                if Is_Bit_Packed_Array (Typ) then
4441                   Set_Result (Unknown);
4442                end if;
4443
4444                --  Check prefix and component offset
4445
4446                Check_Prefix;
4447                Offs := Component_Size (Typ);
4448
4449                --  Small optimization: compute the full offset when possible
4450
4451                if Offs /= No_Uint
4452                  and then Offs > Uint_0
4453                  and then Present (Ind)
4454                  and then Nkind (Ind) = N_Range
4455                  and then Compile_Time_Known_Value (Low_Bound (Ind))
4456                  and then Compile_Time_Known_Value (First (Expressions (Expr)))
4457                then
4458                   Offs := Offs * (Expr_Value (First (Expressions (Expr)))
4459                                     - Expr_Value (Low_Bound ((Ind))));
4460                end if;
4461             end;
4462          end if;
4463
4464          --  If we have a null offset, the result is entirely determined by
4465          --  the base object and has already been computed recursively.
4466
4467          if Offs = Uint_0 then
4468             null;
4469
4470          --  Case where we know the alignment of the object
4471
4472          elsif Known_Alignment (Obj) then
4473             declare
4474                ObjA : constant Uint := Alignment (Obj);
4475                ExpA : Uint          := No_Uint;
4476                SizA : Uint          := No_Uint;
4477
4478             begin
4479                --  If alignment of Obj is 1, then we are always OK
4480
4481                if ObjA = 1 then
4482                   Set_Result (Known_Compatible);
4483
4484                --  Alignment of Obj is greater than 1, so we need to check
4485
4486                else
4487                   --  If we have an offset, see if it is compatible
4488
4489                   if Offs /= No_Uint and Offs > Uint_0 then
4490                      if Offs mod (System_Storage_Unit * ObjA) /= 0 then
4491                         Set_Result (Known_Incompatible);
4492                      end if;
4493
4494                      --  See if Expr is an object with known alignment
4495
4496                   elsif Is_Entity_Name (Expr)
4497                     and then Known_Alignment (Entity (Expr))
4498                   then
4499                      ExpA := Alignment (Entity (Expr));
4500
4501                      --  Otherwise, we can use the alignment of the type of
4502                      --  Expr given that we already checked for
4503                      --  discombobulating rep clauses for the cases of indexed
4504                      --  and selected components above.
4505
4506                   elsif Known_Alignment (Etype (Expr)) then
4507                      ExpA := Alignment (Etype (Expr));
4508
4509                      --  Otherwise the alignment is unknown
4510
4511                   else
4512                      Set_Result (Default);
4513                   end if;
4514
4515                   --  If we got an alignment, see if it is acceptable
4516
4517                   if ExpA /= No_Uint and then ExpA < ObjA then
4518                      Set_Result (Known_Incompatible);
4519                   end if;
4520
4521                   --  If Expr is not a piece of a larger object, see if size
4522                   --  is given. If so, check that it is not too small for the
4523                   --  required alignment.
4524
4525                   if Offs /= No_Uint then
4526                      null;
4527
4528                      --  See if Expr is an object with known size
4529
4530                   elsif Is_Entity_Name (Expr)
4531                     and then Known_Static_Esize (Entity (Expr))
4532                   then
4533                      SizA := Esize (Entity (Expr));
4534
4535                      --  Otherwise, we check the object size of the Expr type
4536
4537                   elsif Known_Static_Esize (Etype (Expr)) then
4538                      SizA := Esize (Etype (Expr));
4539                   end if;
4540
4541                   --  If we got a size, see if it is a multiple of the Obj
4542                   --  alignment, if not, then the alignment cannot be
4543                   --  acceptable, since the size is always a multiple of the
4544                   --  alignment.
4545
4546                   if SizA /= No_Uint then
4547                      if SizA mod (ObjA * Ttypes.System_Storage_Unit) /= 0 then
4548                         Set_Result (Known_Incompatible);
4549                      end if;
4550                   end if;
4551                end if;
4552             end;
4553
4554          --  If we do not know required alignment, any non-zero offset is a
4555          --  potential problem (but certainly may be OK, so result is unknown).
4556
4557          elsif Offs /= No_Uint then
4558             Set_Result (Unknown);
4559
4560          --  If we can't find the result by direct comparison of alignment
4561          --  values, then there is still one case that we can determine known
4562          --  result, and that is when we can determine that the types are the
4563          --  same, and no alignments are specified. Then we known that the
4564          --  alignments are compatible, even if we don't know the alignment
4565          --  value in the front end.
4566
4567          elsif Etype (Obj) = Etype (Expr) then
4568
4569             --  Types are the same, but we have to check for possible size
4570             --  and alignments on the Expr object that may make the alignment
4571             --  different, even though the types are the same.
4572
4573             if Is_Entity_Name (Expr) then
4574
4575                --  First check alignment of the Expr object. Any alignment less
4576                --  than Maximum_Alignment is worrisome since this is the case
4577                --  where we do not know the alignment of Obj.
4578
4579                if Known_Alignment (Entity (Expr))
4580                  and then
4581                    UI_To_Int (Alignment (Entity (Expr))) <
4582                                                     Ttypes.Maximum_Alignment
4583                then
4584                   Set_Result (Unknown);
4585
4586                   --  Now check size of Expr object. Any size that is not an
4587                   --  even multiple of Maximum_Alignment is also worrisome
4588                   --  since it may cause the alignment of the object to be less
4589                   --  than the alignment of the type.
4590
4591                elsif Known_Static_Esize (Entity (Expr))
4592                  and then
4593                    (UI_To_Int (Esize (Entity (Expr))) mod
4594                      (Ttypes.Maximum_Alignment * Ttypes.System_Storage_Unit))
4595                                                                         /= 0
4596                then
4597                   Set_Result (Unknown);
4598
4599                   --  Otherwise same type is decisive
4600
4601                else
4602                   Set_Result (Known_Compatible);
4603                end if;
4604             end if;
4605
4606          --  Another case to deal with is when there is an explicit size or
4607          --  alignment clause when the types are not the same. If so, then the
4608          --  result is Unknown. We don't need to do this test if the Default is
4609          --  Unknown, since that result will be set in any case.
4610
4611          elsif Default /= Unknown
4612            and then (Has_Size_Clause      (Etype (Expr))
4613                       or else
4614                      Has_Alignment_Clause (Etype (Expr)))
4615          then
4616             Set_Result (Unknown);
4617
4618          --  If no indication found, set default
4619
4620          else
4621             Set_Result (Default);
4622          end if;
4623
4624          --  Return worst result found
4625
4626          return Result;
4627       end Has_Compatible_Alignment_Internal;
4628
4629    --  Start of processing for Has_Compatible_Alignment
4630
4631    begin
4632       --  If Obj has no specified alignment, then set alignment from the type
4633       --  alignment. Perhaps we should always do this, but for sure we should
4634       --  do it when there is an address clause since we can do more if the
4635       --  alignment is known.
4636
4637       if Unknown_Alignment (Obj) then
4638          Set_Alignment (Obj, Alignment (Etype (Obj)));
4639       end if;
4640
4641       --  Now do the internal call that does all the work
4642
4643       return Has_Compatible_Alignment_Internal (Obj, Expr, Unknown);
4644    end Has_Compatible_Alignment;
4645
4646    ----------------------
4647    -- Has_Declarations --
4648    ----------------------
4649
4650    function Has_Declarations (N : Node_Id) return Boolean is
4651    begin
4652       return Nkind_In (Nkind (N), N_Accept_Statement,
4653                                   N_Block_Statement,
4654                                   N_Compilation_Unit_Aux,
4655                                   N_Entry_Body,
4656                                   N_Package_Body,
4657                                   N_Protected_Body,
4658                                   N_Subprogram_Body,
4659                                   N_Task_Body,
4660                                   N_Package_Specification);
4661    end Has_Declarations;
4662
4663    -------------------------------------------
4664    -- Has_Discriminant_Dependent_Constraint --
4665    -------------------------------------------
4666
4667    function Has_Discriminant_Dependent_Constraint
4668      (Comp : Entity_Id) return Boolean
4669    is
4670       Comp_Decl  : constant Node_Id := Parent (Comp);
4671       Subt_Indic : constant Node_Id :=
4672                      Subtype_Indication (Component_Definition (Comp_Decl));
4673       Constr     : Node_Id;
4674       Assn       : Node_Id;
4675
4676    begin
4677       if Nkind (Subt_Indic) = N_Subtype_Indication then
4678          Constr := Constraint (Subt_Indic);
4679
4680          if Nkind (Constr) = N_Index_Or_Discriminant_Constraint then
4681             Assn := First (Constraints (Constr));
4682             while Present (Assn) loop
4683                case Nkind (Assn) is
4684                   when N_Subtype_Indication |
4685                        N_Range              |
4686                        N_Identifier
4687                   =>
4688                      if Depends_On_Discriminant (Assn) then
4689                         return True;
4690                      end if;
4691
4692                   when N_Discriminant_Association =>
4693                      if Depends_On_Discriminant (Expression (Assn)) then
4694                         return True;
4695                      end if;
4696
4697                   when others =>
4698                      null;
4699
4700                end case;
4701
4702                Next (Assn);
4703             end loop;
4704          end if;
4705       end if;
4706
4707       return False;
4708    end Has_Discriminant_Dependent_Constraint;
4709
4710    --------------------
4711    -- Has_Infinities --
4712    --------------------
4713
4714    function Has_Infinities (E : Entity_Id) return Boolean is
4715    begin
4716       return
4717         Is_Floating_Point_Type (E)
4718           and then Nkind (Scalar_Range (E)) = N_Range
4719           and then Includes_Infinities (Scalar_Range (E));
4720    end Has_Infinities;
4721
4722    --------------------
4723    -- Has_Interfaces --
4724    --------------------
4725
4726    function Has_Interfaces
4727      (T             : Entity_Id;
4728       Use_Full_View : Boolean := True) return Boolean
4729    is
4730       Typ : Entity_Id := Base_Type (T);
4731
4732    begin
4733       --  Handle concurrent types
4734
4735       if Is_Concurrent_Type (Typ) then
4736          Typ := Corresponding_Record_Type (Typ);
4737       end if;
4738
4739       if not Present (Typ)
4740         or else not Is_Record_Type (Typ)
4741         or else not Is_Tagged_Type (Typ)
4742       then
4743          return False;
4744       end if;
4745
4746       --  Handle private types
4747
4748       if Use_Full_View
4749         and then Present (Full_View (Typ))
4750       then
4751          Typ := Full_View (Typ);
4752       end if;
4753
4754       --  Handle concurrent record types
4755
4756       if Is_Concurrent_Record_Type (Typ)
4757         and then Is_Non_Empty_List (Abstract_Interface_List (Typ))
4758       then
4759          return True;
4760       end if;
4761
4762       loop
4763          if Is_Interface (Typ)
4764            or else
4765              (Is_Record_Type (Typ)
4766                and then Present (Interfaces (Typ))
4767                and then not Is_Empty_Elmt_List (Interfaces (Typ)))
4768          then
4769             return True;
4770          end if;
4771
4772          exit when Etype (Typ) = Typ
4773
4774             --  Handle private types
4775
4776             or else (Present (Full_View (Etype (Typ)))
4777                        and then Full_View (Etype (Typ)) = Typ)
4778
4779             --  Protect the frontend against wrong source with cyclic
4780             --  derivations
4781
4782             or else Etype (Typ) = T;
4783
4784          --  Climb to the ancestor type handling private types
4785
4786          if Present (Full_View (Etype (Typ))) then
4787             Typ := Full_View (Etype (Typ));
4788          else
4789             Typ := Etype (Typ);
4790          end if;
4791       end loop;
4792
4793       return False;
4794    end Has_Interfaces;
4795
4796    ------------------------
4797    -- Has_Null_Exclusion --
4798    ------------------------
4799
4800    function Has_Null_Exclusion (N : Node_Id) return Boolean is
4801    begin
4802       case Nkind (N) is
4803          when N_Access_Definition               |
4804               N_Access_Function_Definition      |
4805               N_Access_Procedure_Definition     |
4806               N_Access_To_Object_Definition     |
4807               N_Allocator                       |
4808               N_Derived_Type_Definition         |
4809               N_Function_Specification          |
4810               N_Subtype_Declaration             =>
4811             return Null_Exclusion_Present (N);
4812
4813          when N_Component_Definition            |
4814               N_Formal_Object_Declaration       |
4815               N_Object_Renaming_Declaration     =>
4816             if Present (Subtype_Mark (N)) then
4817                return Null_Exclusion_Present (N);
4818             else pragma Assert (Present (Access_Definition (N)));
4819                return Null_Exclusion_Present (Access_Definition (N));
4820             end if;
4821
4822          when N_Discriminant_Specification =>
4823             if Nkind (Discriminant_Type (N)) = N_Access_Definition then
4824                return Null_Exclusion_Present (Discriminant_Type (N));
4825             else
4826                return Null_Exclusion_Present (N);
4827             end if;
4828
4829          when N_Object_Declaration =>
4830             if Nkind (Object_Definition (N)) = N_Access_Definition then
4831                return Null_Exclusion_Present (Object_Definition (N));
4832             else
4833                return Null_Exclusion_Present (N);
4834             end if;
4835
4836          when N_Parameter_Specification =>
4837             if Nkind (Parameter_Type (N)) = N_Access_Definition then
4838                return Null_Exclusion_Present (Parameter_Type (N));
4839             else
4840                return Null_Exclusion_Present (N);
4841             end if;
4842
4843          when others =>
4844             return False;
4845
4846       end case;
4847    end Has_Null_Exclusion;
4848
4849    ------------------------
4850    -- Has_Null_Extension --
4851    ------------------------
4852
4853    function Has_Null_Extension (T : Entity_Id) return Boolean is
4854       B     : constant Entity_Id := Base_Type (T);
4855       Comps : Node_Id;
4856       Ext   : Node_Id;
4857
4858    begin
4859       if Nkind (Parent (B)) = N_Full_Type_Declaration
4860         and then Present (Record_Extension_Part (Type_Definition (Parent (B))))
4861       then
4862          Ext := Record_Extension_Part (Type_Definition (Parent (B)));
4863
4864          if Present (Ext) then
4865             if Null_Present (Ext) then
4866                return True;
4867             else
4868                Comps := Component_List (Ext);
4869
4870                --  The null component list is rewritten during analysis to
4871                --  include the parent component. Any other component indicates
4872                --  that the extension was not originally null.
4873
4874                return Null_Present (Comps)
4875                  or else No (Next (First (Component_Items (Comps))));
4876             end if;
4877          else
4878             return False;
4879          end if;
4880
4881       else
4882          return False;
4883       end if;
4884    end Has_Null_Extension;
4885
4886    -------------------------------
4887    -- Has_Overriding_Initialize --
4888    -------------------------------
4889
4890    function Has_Overriding_Initialize (T : Entity_Id) return Boolean is
4891       BT   : constant Entity_Id := Base_Type (T);
4892       Comp : Entity_Id;
4893       P    : Elmt_Id;
4894
4895    begin
4896       if Is_Controlled (BT) then
4897
4898          --  For derived types, check immediate ancestor, excluding
4899          --  Controlled itself.
4900
4901          if Is_Derived_Type (BT)
4902            and then not In_Predefined_Unit (Etype (BT))
4903            and then Has_Overriding_Initialize (Etype (BT))
4904          then
4905             return True;
4906
4907          elsif Present (Primitive_Operations (BT)) then
4908             P := First_Elmt (Primitive_Operations (BT));
4909             while Present (P) loop
4910                if Chars (Node (P)) = Name_Initialize
4911                  and then Comes_From_Source (Node (P))
4912                then
4913                   return True;
4914                end if;
4915
4916                Next_Elmt (P);
4917             end loop;
4918          end if;
4919
4920          return False;
4921
4922       elsif Has_Controlled_Component (BT) then
4923          Comp := First_Component (BT);
4924          while Present (Comp) loop
4925             if Has_Overriding_Initialize (Etype (Comp)) then
4926                return True;
4927             end if;
4928
4929             Next_Component (Comp);
4930          end loop;
4931
4932          return False;
4933
4934       else
4935          return False;
4936       end if;
4937    end Has_Overriding_Initialize;
4938
4939    --------------------------------------
4940    -- Has_Preelaborable_Initialization --
4941    --------------------------------------
4942
4943    function Has_Preelaborable_Initialization (E : Entity_Id) return Boolean is
4944       Has_PE : Boolean;
4945
4946       procedure Check_Components (E : Entity_Id);
4947       --  Check component/discriminant chain, sets Has_PE False if a component
4948       --  or discriminant does not meet the preelaborable initialization rules.
4949
4950       ----------------------
4951       -- Check_Components --
4952       ----------------------
4953
4954       procedure Check_Components (E : Entity_Id) is
4955          Ent : Entity_Id;
4956          Exp : Node_Id;
4957
4958          function Is_Preelaborable_Expression (N : Node_Id) return Boolean;
4959          --  Returns True if and only if the expression denoted by N does not
4960          --  violate restrictions on preelaborable constructs (RM-10.2.1(5-9)).
4961
4962          ---------------------------------
4963          -- Is_Preelaborable_Expression --
4964          ---------------------------------
4965
4966          function Is_Preelaborable_Expression (N : Node_Id) return Boolean is
4967             Exp           : Node_Id;
4968             Assn          : Node_Id;
4969             Choice        : Node_Id;
4970             Comp_Type     : Entity_Id;
4971             Is_Array_Aggr : Boolean;
4972
4973          begin
4974             if Is_Static_Expression (N) then
4975                return True;
4976
4977             elsif Nkind (N) = N_Null then
4978                return True;
4979
4980             --  Attributes are allowed in general, even if their prefix is a
4981             --  formal type. (It seems that certain attributes known not to be
4982             --  static might not be allowed, but there are no rules to prevent
4983             --  them.)
4984
4985             elsif Nkind (N) = N_Attribute_Reference then
4986                return True;
4987
4988             --  The name of a discriminant evaluated within its parent type is
4989             --  defined to be preelaborable (10.2.1(8)). Note that we test for
4990             --  names that denote discriminals as well as discriminants to
4991             --  catch references occurring within init procs.
4992
4993             elsif Is_Entity_Name (N)
4994               and then
4995                 (Ekind (Entity (N)) = E_Discriminant
4996                   or else
4997                     ((Ekind (Entity (N)) = E_Constant
4998                        or else Ekind (Entity (N)) = E_In_Parameter)
4999                      and then Present (Discriminal_Link (Entity (N)))))
5000             then
5001                return True;
5002
5003             elsif Nkind (N) = N_Qualified_Expression then
5004                return Is_Preelaborable_Expression (Expression (N));
5005
5006             --  For aggregates we have to check that each of the associations
5007             --  is preelaborable.
5008
5009             elsif Nkind (N) = N_Aggregate
5010               or else Nkind (N) = N_Extension_Aggregate
5011             then
5012                Is_Array_Aggr := Is_Array_Type (Etype (N));
5013
5014                if Is_Array_Aggr then
5015                   Comp_Type := Component_Type (Etype (N));
5016                end if;
5017
5018                --  Check the ancestor part of extension aggregates, which must
5019                --  be either the name of a type that has preelaborable init or
5020                --  an expression that is preelaborable.
5021
5022                if Nkind (N) = N_Extension_Aggregate then
5023                   declare
5024                      Anc_Part : constant Node_Id := Ancestor_Part (N);
5025
5026                   begin
5027                      if Is_Entity_Name (Anc_Part)
5028                        and then Is_Type (Entity (Anc_Part))
5029                      then
5030                         if not Has_Preelaborable_Initialization
5031                                  (Entity (Anc_Part))
5032                         then
5033                            return False;
5034                         end if;
5035
5036                      elsif not Is_Preelaborable_Expression (Anc_Part) then
5037                         return False;
5038                      end if;
5039                   end;
5040                end if;
5041
5042                --  Check positional associations
5043
5044                Exp := First (Expressions (N));
5045                while Present (Exp) loop
5046                   if not Is_Preelaborable_Expression (Exp) then
5047                      return False;
5048                   end if;
5049
5050                   Next (Exp);
5051                end loop;
5052
5053                --  Check named associations
5054
5055                Assn := First (Component_Associations (N));
5056                while Present (Assn) loop
5057                   Choice := First (Choices (Assn));
5058                   while Present (Choice) loop
5059                      if Is_Array_Aggr then
5060                         if Nkind (Choice) = N_Others_Choice then
5061                            null;
5062
5063                         elsif Nkind (Choice) = N_Range then
5064                            if not Is_Static_Range (Choice) then
5065                               return False;
5066                            end if;
5067
5068                         elsif not Is_Static_Expression (Choice) then
5069                            return False;
5070                         end if;
5071
5072                      else
5073                         Comp_Type := Etype (Choice);
5074                      end if;
5075
5076                      Next (Choice);
5077                   end loop;
5078
5079                   --  If the association has a <> at this point, then we have
5080                   --  to check whether the component's type has preelaborable
5081                   --  initialization. Note that this only occurs when the
5082                   --  association's corresponding component does not have a
5083                   --  default expression, the latter case having already been
5084                   --  expanded as an expression for the association.
5085
5086                   if Box_Present (Assn) then
5087                      if not Has_Preelaborable_Initialization (Comp_Type) then
5088                         return False;
5089                      end if;
5090
5091                   --  In the expression case we check whether the expression
5092                   --  is preelaborable.
5093
5094                   elsif
5095                     not Is_Preelaborable_Expression (Expression (Assn))
5096                   then
5097                      return False;
5098                   end if;
5099
5100                   Next (Assn);
5101                end loop;
5102
5103                --  If we get here then aggregate as a whole is preelaborable
5104
5105                return True;
5106
5107             --  All other cases are not preelaborable
5108
5109             else
5110                return False;
5111             end if;
5112          end Is_Preelaborable_Expression;
5113
5114       --  Start of processing for Check_Components
5115
5116       begin
5117          --  Loop through entities of record or protected type
5118
5119          Ent := E;
5120          while Present (Ent) loop
5121
5122             --  We are interested only in components and discriminants
5123
5124             if Ekind_In (Ent, E_Component, E_Discriminant) then
5125
5126                --  Get default expression if any. If there is no declaration
5127                --  node, it means we have an internal entity. The parent and
5128                --  tag fields are examples of such entities. For these cases,
5129                --  we just test the type of the entity.
5130
5131                if Present (Declaration_Node (Ent)) then
5132                   Exp := Expression (Declaration_Node (Ent));
5133                else
5134                   Exp := Empty;
5135                end if;
5136
5137                --  A component has PI if it has no default expression and the
5138                --  component type has PI.
5139
5140                if No (Exp) then
5141                   if not Has_Preelaborable_Initialization (Etype (Ent)) then
5142                      Has_PE := False;
5143                      exit;
5144                   end if;
5145
5146                --  Require the default expression to be preelaborable
5147
5148                elsif not Is_Preelaborable_Expression (Exp) then
5149                   Has_PE := False;
5150                   exit;
5151                end if;
5152             end if;
5153
5154             Next_Entity (Ent);
5155          end loop;
5156       end Check_Components;
5157
5158    --  Start of processing for Has_Preelaborable_Initialization
5159
5160    begin
5161       --  Immediate return if already marked as known preelaborable init. This
5162       --  covers types for which this function has already been called once
5163       --  and returned True (in which case the result is cached), and also
5164       --  types to which a pragma Preelaborable_Initialization applies.
5165
5166       if Known_To_Have_Preelab_Init (E) then
5167          return True;
5168       end if;
5169
5170       --  If the type is a subtype representing a generic actual type, then
5171       --  test whether its base type has preelaborable initialization since
5172       --  the subtype representing the actual does not inherit this attribute
5173       --  from the actual or formal. (but maybe it should???)
5174
5175       if Is_Generic_Actual_Type (E) then
5176          return Has_Preelaborable_Initialization (Base_Type (E));
5177       end if;
5178
5179       --  All elementary types have preelaborable initialization
5180
5181       if Is_Elementary_Type (E) then
5182          Has_PE := True;
5183
5184       --  Array types have PI if the component type has PI
5185
5186       elsif Is_Array_Type (E) then
5187          Has_PE := Has_Preelaborable_Initialization (Component_Type (E));
5188
5189       --  A derived type has preelaborable initialization if its parent type
5190       --  has preelaborable initialization and (in the case of a derived record
5191       --  extension) if the non-inherited components all have preelaborable
5192       --  initialization. However, a user-defined controlled type with an
5193       --  overriding Initialize procedure does not have preelaborable
5194       --  initialization.
5195
5196       elsif Is_Derived_Type (E) then
5197
5198          --  If the derived type is a private extension then it doesn't have
5199          --  preelaborable initialization.
5200
5201          if Ekind (Base_Type (E)) = E_Record_Type_With_Private then
5202             return False;
5203          end if;
5204
5205          --  First check whether ancestor type has preelaborable initialization
5206
5207          Has_PE := Has_Preelaborable_Initialization (Etype (Base_Type (E)));
5208
5209          --  If OK, check extension components (if any)
5210
5211          if Has_PE and then Is_Record_Type (E) then
5212             Check_Components (First_Entity (E));
5213          end if;
5214
5215          --  Check specifically for 10.2.1(11.4/2) exception: a controlled type
5216          --  with a user defined Initialize procedure does not have PI.
5217
5218          if Has_PE
5219            and then Is_Controlled (E)
5220            and then Has_Overriding_Initialize (E)
5221          then
5222             Has_PE := False;
5223          end if;
5224
5225       --  Private types not derived from a type having preelaborable init and
5226       --  that are not marked with pragma Preelaborable_Initialization do not
5227       --  have preelaborable initialization.
5228
5229       elsif Is_Private_Type (E) then
5230          return False;
5231
5232       --  Record type has PI if it is non private and all components have PI
5233
5234       elsif Is_Record_Type (E) then
5235          Has_PE := True;
5236          Check_Components (First_Entity (E));
5237
5238       --  Protected types must not have entries, and components must meet
5239       --  same set of rules as for record components.
5240
5241       elsif Is_Protected_Type (E) then
5242          if Has_Entries (E) then
5243             Has_PE := False;
5244          else
5245             Has_PE := True;
5246             Check_Components (First_Entity (E));
5247             Check_Components (First_Private_Entity (E));
5248          end if;
5249
5250       --  Type System.Address always has preelaborable initialization
5251
5252       elsif Is_RTE (E, RE_Address) then
5253          Has_PE := True;
5254
5255       --  In all other cases, type does not have preelaborable initialization
5256
5257       else
5258          return False;
5259       end if;
5260
5261       --  If type has preelaborable initialization, cache result
5262
5263       if Has_PE then
5264          Set_Known_To_Have_Preelab_Init (E);
5265       end if;
5266
5267       return Has_PE;
5268    end Has_Preelaborable_Initialization;
5269
5270    ---------------------------
5271    -- Has_Private_Component --
5272    ---------------------------
5273
5274    function Has_Private_Component (Type_Id : Entity_Id) return Boolean is
5275       Btype     : Entity_Id := Base_Type (Type_Id);
5276       Component : Entity_Id;
5277
5278    begin
5279       if Error_Posted (Type_Id)
5280         or else Error_Posted (Btype)
5281       then
5282          return False;
5283       end if;
5284
5285       if Is_Class_Wide_Type (Btype) then
5286          Btype := Root_Type (Btype);
5287       end if;
5288
5289       if Is_Private_Type (Btype) then
5290          declare
5291             UT : constant Entity_Id := Underlying_Type (Btype);
5292          begin
5293             if No (UT) then
5294                if No (Full_View (Btype)) then
5295                   return not Is_Generic_Type (Btype)
5296                     and then not Is_Generic_Type (Root_Type (Btype));
5297                else
5298                   return not Is_Generic_Type (Root_Type (Full_View (Btype)));
5299                end if;
5300             else
5301                return not Is_Frozen (UT) and then Has_Private_Component (UT);
5302             end if;
5303          end;
5304
5305       elsif Is_Array_Type (Btype) then
5306          return Has_Private_Component (Component_Type (Btype));
5307
5308       elsif Is_Record_Type (Btype) then
5309          Component := First_Component (Btype);
5310          while Present (Component) loop
5311             if Has_Private_Component (Etype (Component)) then
5312                return True;
5313             end if;
5314
5315             Next_Component (Component);
5316          end loop;
5317
5318          return False;
5319
5320       elsif Is_Protected_Type (Btype)
5321         and then Present (Corresponding_Record_Type (Btype))
5322       then
5323          return Has_Private_Component (Corresponding_Record_Type (Btype));
5324
5325       else
5326          return False;
5327       end if;
5328    end Has_Private_Component;
5329
5330    ----------------
5331    -- Has_Stream --
5332    ----------------
5333
5334    function Has_Stream (T : Entity_Id) return Boolean is
5335       E : Entity_Id;
5336
5337    begin
5338       if No (T) then
5339          return False;
5340
5341       elsif Is_RTE (Root_Type (T), RE_Root_Stream_Type) then
5342          return True;
5343
5344       elsif Is_Array_Type (T) then
5345          return Has_Stream (Component_Type (T));
5346
5347       elsif Is_Record_Type (T) then
5348          E := First_Component (T);
5349          while Present (E) loop
5350             if Has_Stream (Etype (E)) then
5351                return True;
5352             else
5353                Next_Component (E);
5354             end if;
5355          end loop;
5356
5357          return False;
5358
5359       elsif Is_Private_Type (T) then
5360          return Has_Stream (Underlying_Type (T));
5361
5362       else
5363          return False;
5364       end if;
5365    end Has_Stream;
5366
5367    ----------------
5368    -- Has_Suffix --
5369    ----------------
5370
5371    function Has_Suffix (E : Entity_Id; Suffix : Character) return Boolean is
5372    begin
5373       Get_Name_String (Chars (E));
5374       return Name_Buffer (Name_Len) = Suffix;
5375    end Has_Suffix;
5376
5377    --------------------------
5378    -- Has_Tagged_Component --
5379    --------------------------
5380
5381    function Has_Tagged_Component (Typ : Entity_Id) return Boolean is
5382       Comp : Entity_Id;
5383
5384    begin
5385       if Is_Private_Type (Typ)
5386         and then Present (Underlying_Type (Typ))
5387       then
5388          return Has_Tagged_Component (Underlying_Type (Typ));
5389
5390       elsif Is_Array_Type (Typ) then
5391          return Has_Tagged_Component (Component_Type (Typ));
5392
5393       elsif Is_Tagged_Type (Typ) then
5394          return True;
5395
5396       elsif Is_Record_Type (Typ) then
5397          Comp := First_Component (Typ);
5398          while Present (Comp) loop
5399             if Has_Tagged_Component (Etype (Comp)) then
5400                return True;
5401             end if;
5402
5403             Next_Component (Comp);
5404          end loop;
5405
5406          return False;
5407
5408       else
5409          return False;
5410       end if;
5411    end Has_Tagged_Component;
5412
5413    -------------------------
5414    -- Implementation_Kind --
5415    -------------------------
5416
5417    function Implementation_Kind (Subp : Entity_Id) return Name_Id is
5418       Impl_Prag : constant Node_Id := Get_Rep_Pragma (Subp, Name_Implemented);
5419    begin
5420       pragma Assert (Present (Impl_Prag));
5421       return
5422         Chars (Expression (Last (Pragma_Argument_Associations (Impl_Prag))));
5423    end Implementation_Kind;
5424
5425    --------------------------
5426    -- Implements_Interface --
5427    --------------------------
5428
5429    function Implements_Interface
5430      (Typ_Ent         : Entity_Id;
5431       Iface_Ent       : Entity_Id;
5432       Exclude_Parents : Boolean := False) return Boolean
5433    is
5434       Ifaces_List : Elist_Id;
5435       Elmt        : Elmt_Id;
5436       Iface       : Entity_Id := Base_Type (Iface_Ent);
5437       Typ         : Entity_Id := Base_Type (Typ_Ent);
5438
5439    begin
5440       if Is_Class_Wide_Type (Typ) then
5441          Typ := Root_Type (Typ);
5442       end if;
5443
5444       if not Has_Interfaces (Typ) then
5445          return False;
5446       end if;
5447
5448       if Is_Class_Wide_Type (Iface) then
5449          Iface := Root_Type (Iface);
5450       end if;
5451
5452       Collect_Interfaces (Typ, Ifaces_List);
5453
5454       Elmt := First_Elmt (Ifaces_List);
5455       while Present (Elmt) loop
5456          if Is_Ancestor (Node (Elmt), Typ)
5457            and then Exclude_Parents
5458          then
5459             null;
5460
5461          elsif Node (Elmt) = Iface then
5462             return True;
5463          end if;
5464
5465          Next_Elmt (Elmt);
5466       end loop;
5467
5468       return False;
5469    end Implements_Interface;
5470
5471    -----------------
5472    -- In_Instance --
5473    -----------------
5474
5475    function In_Instance return Boolean is
5476       Curr_Unit : constant Entity_Id := Cunit_Entity (Current_Sem_Unit);
5477       S         : Entity_Id;
5478
5479    begin
5480       S := Current_Scope;
5481       while Present (S)
5482         and then S /= Standard_Standard
5483       loop
5484          if (Ekind (S) = E_Function
5485               or else Ekind (S) = E_Package
5486               or else Ekind (S) = E_Procedure)
5487            and then Is_Generic_Instance (S)
5488          then
5489             --  A child instance is always compiled in the context of a parent
5490             --  instance. Nevertheless, the actuals are not analyzed in an
5491             --  instance context. We detect this case by examining the current
5492             --  compilation unit, which must be a child instance, and checking
5493             --  that it is not currently on the scope stack.
5494
5495             if Is_Child_Unit (Curr_Unit)
5496               and then
5497                 Nkind (Unit (Cunit (Current_Sem_Unit)))
5498                   = N_Package_Instantiation
5499               and then not In_Open_Scopes (Curr_Unit)
5500             then
5501                return False;
5502             else
5503                return True;
5504             end if;
5505          end if;
5506
5507          S := Scope (S);
5508       end loop;
5509
5510       return False;
5511    end In_Instance;
5512
5513    ----------------------
5514    -- In_Instance_Body --
5515    ----------------------
5516
5517    function In_Instance_Body return Boolean is
5518       S : Entity_Id;
5519
5520    begin
5521       S := Current_Scope;
5522       while Present (S)
5523         and then S /= Standard_Standard
5524       loop
5525          if (Ekind (S) = E_Function
5526               or else Ekind (S) = E_Procedure)
5527            and then Is_Generic_Instance (S)
5528          then
5529             return True;
5530
5531          elsif Ekind (S) = E_Package
5532            and then In_Package_Body (S)
5533            and then Is_Generic_Instance (S)
5534          then
5535             return True;
5536          end if;
5537
5538          S := Scope (S);
5539       end loop;
5540
5541       return False;
5542    end In_Instance_Body;
5543
5544    -----------------------------
5545    -- In_Instance_Not_Visible --
5546    -----------------------------
5547
5548    function In_Instance_Not_Visible return Boolean is
5549       S : Entity_Id;
5550
5551    begin
5552       S := Current_Scope;
5553       while Present (S)
5554         and then S /= Standard_Standard
5555       loop
5556          if (Ekind (S) = E_Function
5557               or else Ekind (S) = E_Procedure)
5558            and then Is_Generic_Instance (S)
5559          then
5560             return True;
5561
5562          elsif Ekind (S) = E_Package
5563            and then (In_Package_Body (S) or else In_Private_Part (S))
5564            and then Is_Generic_Instance (S)
5565          then
5566             return True;
5567          end if;
5568
5569          S := Scope (S);
5570       end loop;
5571
5572       return False;
5573    end In_Instance_Not_Visible;
5574
5575    ------------------------------
5576    -- In_Instance_Visible_Part --
5577    ------------------------------
5578
5579    function In_Instance_Visible_Part return Boolean is
5580       S : Entity_Id;
5581
5582    begin
5583       S := Current_Scope;
5584       while Present (S)
5585         and then S /= Standard_Standard
5586       loop
5587          if Ekind (S) = E_Package
5588            and then Is_Generic_Instance (S)
5589            and then not In_Package_Body (S)
5590            and then not In_Private_Part (S)
5591          then
5592             return True;
5593          end if;
5594
5595          S := Scope (S);
5596       end loop;
5597
5598       return False;
5599    end In_Instance_Visible_Part;
5600
5601    ---------------------
5602    -- In_Package_Body --
5603    ---------------------
5604
5605    function In_Package_Body return Boolean is
5606       S : Entity_Id;
5607
5608    begin
5609       S := Current_Scope;
5610       while Present (S)
5611         and then S /= Standard_Standard
5612       loop
5613          if Ekind (S) = E_Package
5614            and then In_Package_Body (S)
5615          then
5616             return True;
5617          else
5618             S := Scope (S);
5619          end if;
5620       end loop;
5621
5622       return False;
5623    end In_Package_Body;
5624
5625    --------------------------------
5626    -- In_Parameter_Specification --
5627    --------------------------------
5628
5629    function In_Parameter_Specification (N : Node_Id) return Boolean is
5630       PN : Node_Id;
5631
5632    begin
5633       PN := Parent (N);
5634       while Present (PN) loop
5635          if Nkind (PN) = N_Parameter_Specification then
5636             return True;
5637          end if;
5638
5639          PN := Parent (PN);
5640       end loop;
5641
5642       return False;
5643    end In_Parameter_Specification;
5644
5645    --------------------------------------
5646    -- In_Subprogram_Or_Concurrent_Unit --
5647    --------------------------------------
5648
5649    function In_Subprogram_Or_Concurrent_Unit return Boolean is
5650       E : Entity_Id;
5651       K : Entity_Kind;
5652
5653    begin
5654       --  Use scope chain to check successively outer scopes
5655
5656       E := Current_Scope;
5657       loop
5658          K := Ekind (E);
5659
5660          if K in Subprogram_Kind
5661            or else K in Concurrent_Kind
5662            or else K in Generic_Subprogram_Kind
5663          then
5664             return True;
5665
5666          elsif E = Standard_Standard then
5667             return False;
5668          end if;
5669
5670          E := Scope (E);
5671       end loop;
5672    end In_Subprogram_Or_Concurrent_Unit;
5673
5674    ---------------------
5675    -- In_Visible_Part --
5676    ---------------------
5677
5678    function In_Visible_Part (Scope_Id : Entity_Id) return Boolean is
5679    begin
5680       return
5681         Is_Package_Or_Generic_Package (Scope_Id)
5682           and then In_Open_Scopes (Scope_Id)
5683           and then not In_Package_Body (Scope_Id)
5684           and then not In_Private_Part (Scope_Id);
5685    end In_Visible_Part;
5686
5687    ---------------------------------
5688    -- Insert_Explicit_Dereference --
5689    ---------------------------------
5690
5691    procedure Insert_Explicit_Dereference (N : Node_Id) is
5692       New_Prefix : constant Node_Id := Relocate_Node (N);
5693       Ent        : Entity_Id := Empty;
5694       Pref       : Node_Id;
5695       I          : Interp_Index;
5696       It         : Interp;
5697       T          : Entity_Id;
5698
5699    begin
5700       Save_Interps (N, New_Prefix);
5701
5702       Rewrite (N,
5703         Make_Explicit_Dereference (Sloc (Parent (N)),
5704           Prefix => New_Prefix));
5705
5706       Set_Etype (N, Designated_Type (Etype (New_Prefix)));
5707
5708       if Is_Overloaded (New_Prefix) then
5709
5710          --  The dereference is also overloaded, and its interpretations are
5711          --  the designated types of the interpretations of the original node.
5712
5713          Set_Etype (N, Any_Type);
5714
5715          Get_First_Interp (New_Prefix, I, It);
5716          while Present (It.Nam) loop
5717             T := It.Typ;
5718
5719             if Is_Access_Type (T) then
5720                Add_One_Interp (N, Designated_Type (T), Designated_Type (T));
5721             end if;
5722
5723             Get_Next_Interp (I, It);
5724          end loop;
5725
5726          End_Interp_List;
5727
5728       else
5729          --  Prefix is unambiguous: mark the original prefix (which might
5730          --  Come_From_Source) as a reference, since the new (relocated) one
5731          --  won't be taken into account.
5732
5733          if Is_Entity_Name (New_Prefix) then
5734             Ent := Entity (New_Prefix);
5735             Pref := New_Prefix;
5736
5737          --  For a retrieval of a subcomponent of some composite object,
5738          --  retrieve the ultimate entity if there is one.
5739
5740          elsif Nkind (New_Prefix) = N_Selected_Component
5741            or else Nkind (New_Prefix) = N_Indexed_Component
5742          then
5743             Pref := Prefix (New_Prefix);
5744             while Present (Pref)
5745               and then
5746                 (Nkind (Pref) = N_Selected_Component
5747                   or else Nkind (Pref) = N_Indexed_Component)
5748             loop
5749                Pref := Prefix (Pref);
5750             end loop;
5751
5752             if Present (Pref) and then Is_Entity_Name (Pref) then
5753                Ent := Entity (Pref);
5754             end if;
5755          end if;
5756
5757          --  Place the reference on the entity node
5758
5759          if Present (Ent) then
5760             Generate_Reference (Ent, Pref);
5761          end if;
5762       end if;
5763    end Insert_Explicit_Dereference;
5764
5765    ------------------------------------------
5766    -- Inspect_Deferred_Constant_Completion --
5767    ------------------------------------------
5768
5769    procedure Inspect_Deferred_Constant_Completion (Decls : List_Id) is
5770       Decl   : Node_Id;
5771
5772    begin
5773       Decl := First (Decls);
5774       while Present (Decl) loop
5775
5776          --  Deferred constant signature
5777
5778          if Nkind (Decl) = N_Object_Declaration
5779            and then Constant_Present (Decl)
5780            and then No (Expression (Decl))
5781
5782             --  No need to check internally generated constants
5783
5784            and then Comes_From_Source (Decl)
5785
5786             --  The constant is not completed. A full object declaration or a
5787             --  pragma Import complete a deferred constant.
5788
5789            and then not Has_Completion (Defining_Identifier (Decl))
5790          then
5791             Error_Msg_N
5792               ("constant declaration requires initialization expression",
5793               Defining_Identifier (Decl));
5794          end if;
5795
5796          Decl := Next (Decl);
5797       end loop;
5798    end Inspect_Deferred_Constant_Completion;
5799
5800    -----------------------------
5801    -- Is_Actual_Out_Parameter --
5802    -----------------------------
5803
5804    function Is_Actual_Out_Parameter (N : Node_Id) return Boolean is
5805       Formal : Entity_Id;
5806       Call   : Node_Id;
5807    begin
5808       Find_Actual (N, Formal, Call);
5809       return Present (Formal) and then Ekind (Formal) = E_Out_Parameter;
5810    end Is_Actual_Out_Parameter;
5811
5812    -------------------------
5813    -- Is_Actual_Parameter --
5814    -------------------------
5815
5816    function Is_Actual_Parameter (N : Node_Id) return Boolean is
5817       PK : constant Node_Kind := Nkind (Parent (N));
5818
5819    begin
5820       case PK is
5821          when N_Parameter_Association =>
5822             return N = Explicit_Actual_Parameter (Parent (N));
5823
5824          when N_Function_Call | N_Procedure_Call_Statement =>
5825             return Is_List_Member (N)
5826               and then
5827                 List_Containing (N) = Parameter_Associations (Parent (N));
5828
5829          when others =>
5830             return False;
5831       end case;
5832    end Is_Actual_Parameter;
5833
5834    ---------------------
5835    -- Is_Aliased_View --
5836    ---------------------
5837
5838    function Is_Aliased_View (Obj : Node_Id) return Boolean is
5839       E : Entity_Id;
5840
5841    begin
5842       if Is_Entity_Name (Obj) then
5843
5844          E := Entity (Obj);
5845
5846          return
5847            (Is_Object (E)
5848              and then
5849                (Is_Aliased (E)
5850                   or else (Present (Renamed_Object (E))
5851                              and then Is_Aliased_View (Renamed_Object (E)))))
5852
5853            or else ((Is_Formal (E)
5854                       or else Ekind (E) = E_Generic_In_Out_Parameter
5855                       or else Ekind (E) = E_Generic_In_Parameter)
5856                     and then Is_Tagged_Type (Etype (E)))
5857
5858            or else (Is_Concurrent_Type (E)
5859                      and then In_Open_Scopes (E))
5860
5861             --  Current instance of type, either directly or as rewritten
5862             --  reference to the current object.
5863
5864            or else (Is_Entity_Name (Original_Node (Obj))
5865                      and then Present (Entity (Original_Node (Obj)))
5866                      and then Is_Type (Entity (Original_Node (Obj))))
5867
5868            or else (Is_Type (E) and then E = Current_Scope)
5869
5870            or else (Is_Incomplete_Or_Private_Type (E)
5871                      and then Full_View (E) = Current_Scope);
5872
5873       elsif Nkind (Obj) = N_Selected_Component then
5874          return Is_Aliased (Entity (Selector_Name (Obj)));
5875
5876       elsif Nkind (Obj) = N_Indexed_Component then
5877          return Has_Aliased_Components (Etype (Prefix (Obj)))
5878            or else
5879              (Is_Access_Type (Etype (Prefix (Obj)))
5880                and then
5881               Has_Aliased_Components
5882                 (Designated_Type (Etype (Prefix (Obj)))));
5883
5884       elsif Nkind (Obj) = N_Unchecked_Type_Conversion
5885         or else Nkind (Obj) = N_Type_Conversion
5886       then
5887          return Is_Tagged_Type (Etype (Obj))
5888            and then Is_Aliased_View (Expression (Obj));
5889
5890       elsif Nkind (Obj) = N_Explicit_Dereference then
5891          return Nkind (Original_Node (Obj)) /= N_Function_Call;
5892
5893       else
5894          return False;
5895       end if;
5896    end Is_Aliased_View;
5897
5898    -------------------------
5899    -- Is_Ancestor_Package --
5900    -------------------------
5901
5902    function Is_Ancestor_Package
5903      (E1 : Entity_Id;
5904       E2 : Entity_Id) return Boolean
5905    is
5906       Par : Entity_Id;
5907
5908    begin
5909       Par := E2;
5910       while Present (Par)
5911         and then Par /= Standard_Standard
5912       loop
5913          if Par = E1 then
5914             return True;
5915          end if;
5916
5917          Par := Scope (Par);
5918       end loop;
5919
5920       return False;
5921    end Is_Ancestor_Package;
5922
5923    ----------------------
5924    -- Is_Atomic_Object --
5925    ----------------------
5926
5927    function Is_Atomic_Object (N : Node_Id) return Boolean is
5928
5929       function Object_Has_Atomic_Components (N : Node_Id) return Boolean;
5930       --  Determines if given object has atomic components
5931
5932       function Is_Atomic_Prefix (N : Node_Id) return Boolean;
5933       --  If prefix is an implicit dereference, examine designated type
5934
5935       ----------------------
5936       -- Is_Atomic_Prefix --
5937       ----------------------
5938
5939       function Is_Atomic_Prefix (N : Node_Id) return Boolean is
5940       begin
5941          if Is_Access_Type (Etype (N)) then
5942             return
5943               Has_Atomic_Components (Designated_Type (Etype (N)));
5944          else
5945             return Object_Has_Atomic_Components (N);
5946          end if;
5947       end Is_Atomic_Prefix;
5948
5949       ----------------------------------
5950       -- Object_Has_Atomic_Components --
5951       ----------------------------------
5952
5953       function Object_Has_Atomic_Components (N : Node_Id) return Boolean is
5954       begin
5955          if Has_Atomic_Components (Etype (N))
5956            or else Is_Atomic (Etype (N))
5957          then
5958             return True;
5959
5960          elsif Is_Entity_Name (N)
5961            and then (Has_Atomic_Components (Entity (N))
5962                       or else Is_Atomic (Entity (N)))
5963          then
5964             return True;
5965
5966          elsif Nkind (N) = N_Indexed_Component
5967            or else Nkind (N) = N_Selected_Component
5968          then
5969             return Is_Atomic_Prefix (Prefix (N));
5970
5971          else
5972             return False;
5973          end if;
5974       end Object_Has_Atomic_Components;
5975
5976    --  Start of processing for Is_Atomic_Object
5977
5978    begin
5979       --  Predicate is not relevant to subprograms
5980
5981       if Is_Entity_Name (N) and then Is_Overloadable (Entity (N)) then
5982          return False;
5983
5984       elsif Is_Atomic (Etype (N))
5985         or else (Is_Entity_Name (N) and then Is_Atomic (Entity (N)))
5986       then
5987          return True;
5988
5989       elsif Nkind (N) = N_Indexed_Component
5990         or else Nkind (N) = N_Selected_Component
5991       then
5992          return Is_Atomic_Prefix (Prefix (N));
5993
5994       else
5995          return False;
5996       end if;
5997    end Is_Atomic_Object;
5998
5999    -------------------------
6000    -- Is_Coextension_Root --
6001    -------------------------
6002
6003    function Is_Coextension_Root (N : Node_Id) return Boolean is
6004    begin
6005       return
6006         Nkind (N) = N_Allocator
6007           and then Present (Coextensions (N))
6008
6009          --  Anonymous access discriminants carry a list of all nested
6010          --  controlled coextensions.
6011
6012           and then not Is_Dynamic_Coextension (N)
6013           and then not Is_Static_Coextension (N);
6014    end Is_Coextension_Root;
6015
6016    -----------------------------
6017    -- Is_Concurrent_Interface --
6018    -----------------------------
6019
6020    function Is_Concurrent_Interface (T : Entity_Id) return Boolean is
6021    begin
6022       return
6023         Is_Interface (T)
6024           and then
6025             (Is_Protected_Interface (T)
6026                or else Is_Synchronized_Interface (T)
6027                or else Is_Task_Interface (T));
6028    end Is_Concurrent_Interface;
6029
6030    --------------------------------------
6031    -- Is_Controlling_Limited_Procedure --
6032    --------------------------------------
6033
6034    function Is_Controlling_Limited_Procedure
6035      (Proc_Nam : Entity_Id) return Boolean
6036    is
6037       Param_Typ : Entity_Id := Empty;
6038
6039    begin
6040       if Ekind (Proc_Nam) = E_Procedure
6041         and then Present (Parameter_Specifications (Parent (Proc_Nam)))
6042       then
6043          Param_Typ := Etype (Parameter_Type (First (
6044                         Parameter_Specifications (Parent (Proc_Nam)))));
6045
6046       --  In this case where an Itype was created, the procedure call has been
6047       --  rewritten.
6048
6049       elsif Present (Associated_Node_For_Itype (Proc_Nam))
6050         and then Present (Original_Node (Associated_Node_For_Itype (Proc_Nam)))
6051         and then
6052           Present (Parameter_Associations
6053                      (Associated_Node_For_Itype (Proc_Nam)))
6054       then
6055          Param_Typ :=
6056            Etype (First (Parameter_Associations
6057                           (Associated_Node_For_Itype (Proc_Nam))));
6058       end if;
6059
6060       if Present (Param_Typ) then
6061          return
6062            Is_Interface (Param_Typ)
6063              and then Is_Limited_Record (Param_Typ);
6064       end if;
6065
6066       return False;
6067    end Is_Controlling_Limited_Procedure;
6068
6069    -----------------------------
6070    -- Is_CPP_Constructor_Call --
6071    -----------------------------
6072
6073    function Is_CPP_Constructor_Call (N : Node_Id) return Boolean is
6074    begin
6075       return Nkind (N) = N_Function_Call
6076         and then Is_CPP_Class (Etype (Etype (N)))
6077         and then Is_Constructor (Entity (Name (N)))
6078         and then Is_Imported (Entity (Name (N)));
6079    end Is_CPP_Constructor_Call;
6080
6081    -----------------
6082    -- Is_Delegate --
6083    -----------------
6084
6085    function Is_Delegate (T : Entity_Id) return Boolean is
6086       Desig_Type : Entity_Id;
6087
6088    begin
6089       if VM_Target /= CLI_Target then
6090          return False;
6091       end if;
6092
6093       --  Access-to-subprograms are delegates in CIL
6094
6095       if Ekind (T) = E_Access_Subprogram_Type then
6096          return True;
6097       end if;
6098
6099       if Ekind (T) not in Access_Kind then
6100
6101          --  A delegate is a managed pointer. If no designated type is defined
6102          --  it means that it's not a delegate.
6103
6104          return False;
6105       end if;
6106
6107       Desig_Type := Etype (Directly_Designated_Type (T));
6108
6109       if not Is_Tagged_Type (Desig_Type) then
6110          return False;
6111       end if;
6112
6113       --  Test if the type is inherited from [mscorlib]System.Delegate
6114
6115       while Etype (Desig_Type) /= Desig_Type loop
6116          if Chars (Scope (Desig_Type)) /= No_Name
6117            and then Is_Imported (Scope (Desig_Type))
6118            and then Get_Name_String (Chars (Scope (Desig_Type))) = "delegate"
6119          then
6120             return True;
6121          end if;
6122
6123          Desig_Type := Etype (Desig_Type);
6124       end loop;
6125
6126       return False;
6127    end Is_Delegate;
6128
6129    ----------------------------------------------
6130    -- Is_Dependent_Component_Of_Mutable_Object --
6131    ----------------------------------------------
6132
6133    function Is_Dependent_Component_Of_Mutable_Object
6134      (Object : Node_Id) return Boolean
6135    is
6136       P           : Node_Id;
6137       Prefix_Type : Entity_Id;
6138       P_Aliased   : Boolean := False;
6139       Comp        : Entity_Id;
6140
6141       function Is_Declared_Within_Variant (Comp : Entity_Id) return Boolean;
6142       --  Returns True if and only if Comp is declared within a variant part
6143
6144       --------------------------------
6145       -- Is_Declared_Within_Variant --
6146       --------------------------------
6147
6148       function Is_Declared_Within_Variant (Comp : Entity_Id) return Boolean is
6149          Comp_Decl : constant Node_Id   := Parent (Comp);
6150          Comp_List : constant Node_Id   := Parent (Comp_Decl);
6151       begin
6152          return Nkind (Parent (Comp_List)) = N_Variant;
6153       end Is_Declared_Within_Variant;
6154
6155    --  Start of processing for Is_Dependent_Component_Of_Mutable_Object
6156
6157    begin
6158       if Is_Variable (Object) then
6159
6160          if Nkind (Object) = N_Selected_Component then
6161             P := Prefix (Object);
6162             Prefix_Type := Etype (P);
6163
6164             if Is_Entity_Name (P) then
6165
6166                if Ekind (Entity (P)) = E_Generic_In_Out_Parameter then
6167                   Prefix_Type := Base_Type (Prefix_Type);
6168                end if;
6169
6170                if Is_Aliased (Entity (P)) then
6171                   P_Aliased := True;
6172                end if;
6173
6174             --  A discriminant check on a selected component may be expanded
6175             --  into a dereference when removing side-effects. Recover the
6176             --  original node and its type, which may be unconstrained.
6177
6178             elsif Nkind (P) = N_Explicit_Dereference
6179               and then not (Comes_From_Source (P))
6180             then
6181                P := Original_Node (P);
6182                Prefix_Type := Etype (P);
6183
6184             else
6185                --  Check for prefix being an aliased component???
6186
6187                null;
6188
6189             end if;
6190
6191             --  A heap object is constrained by its initial value
6192
6193             --  Ada 2005 (AI-363): Always assume the object could be mutable in
6194             --  the dereferenced case, since the access value might denote an
6195             --  unconstrained aliased object, whereas in Ada 95 the designated
6196             --  object is guaranteed to be constrained. A worst-case assumption
6197             --  has to apply in Ada 2005 because we can't tell at compile time
6198             --  whether the object is "constrained by its initial value"
6199             --  (despite the fact that 3.10.2(26/2) and 8.5.1(5/2) are
6200             --  semantic rules -- these rules are acknowledged to need fixing).
6201
6202             if Ada_Version < Ada_2005 then
6203                if Is_Access_Type (Prefix_Type)
6204                  or else Nkind (P) = N_Explicit_Dereference
6205                then
6206                   return False;
6207                end if;
6208
6209             elsif Ada_Version >= Ada_2005 then
6210                if Is_Access_Type (Prefix_Type) then
6211
6212                   --  If the access type is pool-specific, and there is no
6213                   --  constrained partial view of the designated type, then the
6214                   --  designated object is known to be constrained.
6215
6216                   if Ekind (Prefix_Type) = E_Access_Type
6217                     and then not Has_Constrained_Partial_View
6218                                    (Designated_Type (Prefix_Type))
6219                   then
6220                      return False;
6221
6222                   --  Otherwise (general access type, or there is a constrained
6223                   --  partial view of the designated type), we need to check
6224                   --  based on the designated type.
6225
6226                   else
6227                      Prefix_Type := Designated_Type (Prefix_Type);
6228                   end if;
6229                end if;
6230             end if;
6231
6232             Comp :=
6233               Original_Record_Component (Entity (Selector_Name (Object)));
6234
6235             --  As per AI-0017, the renaming is illegal in a generic body, even
6236             --  if the subtype is indefinite.
6237
6238             --  Ada 2005 (AI-363): In Ada 2005 an aliased object can be mutable
6239
6240             if not Is_Constrained (Prefix_Type)
6241               and then (not Is_Indefinite_Subtype (Prefix_Type)
6242                          or else
6243                           (Is_Generic_Type (Prefix_Type)
6244                             and then Ekind (Current_Scope) = E_Generic_Package
6245                             and then In_Package_Body (Current_Scope)))
6246
6247               and then (Is_Declared_Within_Variant (Comp)
6248                           or else Has_Discriminant_Dependent_Constraint (Comp))
6249               and then (not P_Aliased or else Ada_Version >= Ada_2005)
6250             then
6251                return True;
6252
6253             else
6254                return
6255                  Is_Dependent_Component_Of_Mutable_Object (Prefix (Object));
6256
6257             end if;
6258
6259          elsif Nkind (Object) = N_Indexed_Component
6260            or else Nkind (Object) = N_Slice
6261          then
6262             return Is_Dependent_Component_Of_Mutable_Object (Prefix (Object));
6263
6264          --  A type conversion that Is_Variable is a view conversion:
6265          --  go back to the denoted object.
6266
6267          elsif Nkind (Object) = N_Type_Conversion then
6268             return
6269               Is_Dependent_Component_Of_Mutable_Object (Expression (Object));
6270          end if;
6271       end if;
6272
6273       return False;
6274    end Is_Dependent_Component_Of_Mutable_Object;
6275
6276    ---------------------
6277    -- Is_Dereferenced --
6278    ---------------------
6279
6280    function Is_Dereferenced (N : Node_Id) return Boolean is
6281       P : constant Node_Id := Parent (N);
6282    begin
6283       return
6284          (Nkind (P) = N_Selected_Component
6285             or else
6286           Nkind (P) = N_Explicit_Dereference
6287             or else
6288           Nkind (P) = N_Indexed_Component
6289             or else
6290           Nkind (P) = N_Slice)
6291         and then Prefix (P) = N;
6292    end Is_Dereferenced;
6293
6294    ----------------------
6295    -- Is_Descendent_Of --
6296    ----------------------
6297
6298    function Is_Descendent_Of (T1 : Entity_Id; T2 : Entity_Id) return Boolean is
6299       T    : Entity_Id;
6300       Etyp : Entity_Id;
6301
6302    begin
6303       pragma Assert (Nkind (T1) in N_Entity);
6304       pragma Assert (Nkind (T2) in N_Entity);
6305
6306       T := Base_Type (T1);
6307
6308       --  Immediate return if the types match
6309
6310       if T = T2 then
6311          return True;
6312
6313       --  Comment needed here ???
6314
6315       elsif Ekind (T) = E_Class_Wide_Type then
6316          return Etype (T) = T2;
6317
6318       --  All other cases
6319
6320       else
6321          loop
6322             Etyp := Etype (T);
6323
6324             --  Done if we found the type we are looking for
6325
6326             if Etyp = T2 then
6327                return True;
6328
6329             --  Done if no more derivations to check
6330
6331             elsif T = T1
6332               or else T = Etyp
6333             then
6334                return False;
6335
6336             --  Following test catches error cases resulting from prev errors
6337
6338             elsif No (Etyp) then
6339                return False;
6340
6341             elsif Is_Private_Type (T) and then Etyp = Full_View (T) then
6342                return False;
6343
6344             elsif Is_Private_Type (Etyp) and then Full_View (Etyp) = T then
6345                return False;
6346             end if;
6347
6348             T := Base_Type (Etyp);
6349          end loop;
6350       end if;
6351    end Is_Descendent_Of;
6352
6353    --------------
6354    -- Is_False --
6355    --------------
6356
6357    function Is_False (U : Uint) return Boolean is
6358    begin
6359       return (U = 0);
6360    end Is_False;
6361
6362    ---------------------------
6363    -- Is_Fixed_Model_Number --
6364    ---------------------------
6365
6366    function Is_Fixed_Model_Number (U : Ureal; T : Entity_Id) return Boolean is
6367       S : constant Ureal := Small_Value (T);
6368       M : Urealp.Save_Mark;
6369       R : Boolean;
6370    begin
6371       M := Urealp.Mark;
6372       R := (U = UR_Trunc (U / S) * S);
6373       Urealp.Release (M);
6374       return R;
6375    end Is_Fixed_Model_Number;
6376
6377    -------------------------------
6378    -- Is_Fully_Initialized_Type --
6379    -------------------------------
6380
6381    function Is_Fully_Initialized_Type (Typ : Entity_Id) return Boolean is
6382    begin
6383       if Is_Scalar_Type (Typ) then
6384          return False;
6385
6386       elsif Is_Access_Type (Typ) then
6387          return True;
6388
6389       elsif Is_Array_Type (Typ) then
6390          if Is_Fully_Initialized_Type (Component_Type (Typ)) then
6391             return True;
6392          end if;
6393
6394          --  An interesting case, if we have a constrained type one of whose
6395          --  bounds is known to be null, then there are no elements to be
6396          --  initialized, so all the elements are initialized!
6397
6398          if Is_Constrained (Typ) then
6399             declare
6400                Indx     : Node_Id;
6401                Indx_Typ : Entity_Id;
6402                Lbd, Hbd : Node_Id;
6403
6404             begin
6405                Indx := First_Index (Typ);
6406                while Present (Indx) loop
6407                   if Etype (Indx) = Any_Type then
6408                      return False;
6409
6410                   --  If index is a range, use directly
6411
6412                   elsif Nkind (Indx) = N_Range then
6413                      Lbd := Low_Bound  (Indx);
6414                      Hbd := High_Bound (Indx);
6415
6416                   else
6417                      Indx_Typ := Etype (Indx);
6418
6419                      if Is_Private_Type (Indx_Typ)  then
6420                         Indx_Typ := Full_View (Indx_Typ);
6421                      end if;
6422
6423                      if No (Indx_Typ) or else Etype (Indx_Typ) = Any_Type then
6424                         return False;
6425                      else
6426                         Lbd := Type_Low_Bound  (Indx_Typ);
6427                         Hbd := Type_High_Bound (Indx_Typ);
6428                      end if;
6429                   end if;
6430
6431                   if Compile_Time_Known_Value (Lbd)
6432                     and then Compile_Time_Known_Value (Hbd)
6433                   then
6434                      if Expr_Value (Hbd) < Expr_Value (Lbd) then
6435                         return True;
6436                      end if;
6437                   end if;
6438
6439                   Next_Index (Indx);
6440                end loop;
6441             end;
6442          end if;
6443
6444          --  If no null indexes, then type is not fully initialized
6445
6446          return False;
6447
6448       --  Record types
6449
6450       elsif Is_Record_Type (Typ) then
6451          if Has_Discriminants (Typ)
6452            and then
6453              Present (Discriminant_Default_Value (First_Discriminant (Typ)))
6454            and then Is_Fully_Initialized_Variant (Typ)
6455          then
6456             return True;
6457          end if;
6458
6459          --  Controlled records are considered to be fully initialized if
6460          --  there is a user defined Initialize routine. This may not be
6461          --  entirely correct, but as the spec notes, we are guessing here
6462          --  what is best from the point of view of issuing warnings.
6463
6464          if Is_Controlled (Typ) then
6465             declare
6466                Utyp : constant Entity_Id := Underlying_Type (Typ);
6467
6468             begin
6469                if Present (Utyp) then
6470                   declare
6471                      Init : constant Entity_Id :=
6472                               (Find_Prim_Op
6473                                  (Underlying_Type (Typ), Name_Initialize));
6474
6475                   begin
6476                      if Present (Init)
6477                        and then Comes_From_Source (Init)
6478                        and then not
6479                          Is_Predefined_File_Name
6480                            (File_Name (Get_Source_File_Index (Sloc (Init))))
6481                      then
6482                         return True;
6483
6484                      elsif Has_Null_Extension (Typ)
6485                         and then
6486                           Is_Fully_Initialized_Type
6487                             (Etype (Base_Type (Typ)))
6488                      then
6489                         return True;
6490                      end if;
6491                   end;
6492                end if;
6493             end;
6494          end if;
6495
6496          --  Otherwise see if all record components are initialized
6497
6498          declare
6499             Ent : Entity_Id;
6500
6501          begin
6502             Ent := First_Entity (Typ);
6503             while Present (Ent) loop
6504                if Chars (Ent) = Name_uController then
6505                   null;
6506
6507                elsif Ekind (Ent) = E_Component
6508                  and then (No (Parent (Ent))
6509                              or else No (Expression (Parent (Ent))))
6510                  and then not Is_Fully_Initialized_Type (Etype (Ent))
6511
6512                   --  Special VM case for tag components, which need to be
6513                   --  defined in this case, but are never initialized as VMs
6514                   --  are using other dispatching mechanisms. Ignore this
6515                   --  uninitialized case. Note that this applies both to the
6516                   --  uTag entry and the main vtable pointer (CPP_Class case).
6517
6518                  and then (Tagged_Type_Expansion or else not Is_Tag (Ent))
6519                then
6520                   return False;
6521                end if;
6522
6523                Next_Entity (Ent);
6524             end loop;
6525          end;
6526
6527          --  No uninitialized components, so type is fully initialized.
6528          --  Note that this catches the case of no components as well.
6529
6530          return True;
6531
6532       elsif Is_Concurrent_Type (Typ) then
6533          return True;
6534
6535       elsif Is_Private_Type (Typ) then
6536          declare
6537             U : constant Entity_Id := Underlying_Type (Typ);
6538
6539          begin
6540             if No (U) then
6541                return False;
6542             else
6543                return Is_Fully_Initialized_Type (U);
6544             end if;
6545          end;
6546
6547       else
6548          return False;
6549       end if;
6550    end Is_Fully_Initialized_Type;
6551
6552    ----------------------------------
6553    -- Is_Fully_Initialized_Variant --
6554    ----------------------------------
6555
6556    function Is_Fully_Initialized_Variant (Typ : Entity_Id) return Boolean is
6557       Loc           : constant Source_Ptr := Sloc (Typ);
6558       Constraints   : constant List_Id    := New_List;
6559       Components    : constant Elist_Id   := New_Elmt_List;
6560       Comp_Elmt     : Elmt_Id;
6561       Comp_Id       : Node_Id;
6562       Comp_List     : Node_Id;
6563       Discr         : Entity_Id;
6564       Discr_Val     : Node_Id;
6565
6566       Report_Errors : Boolean;
6567       pragma Warnings (Off, Report_Errors);
6568
6569    begin
6570       if Serious_Errors_Detected > 0 then
6571          return False;
6572       end if;
6573
6574       if Is_Record_Type (Typ)
6575         and then Nkind (Parent (Typ)) = N_Full_Type_Declaration
6576         and then Nkind (Type_Definition (Parent (Typ))) = N_Record_Definition
6577       then
6578          Comp_List := Component_List (Type_Definition (Parent (Typ)));
6579
6580          Discr := First_Discriminant (Typ);
6581          while Present (Discr) loop
6582             if Nkind (Parent (Discr)) = N_Discriminant_Specification then
6583                Discr_Val := Expression (Parent (Discr));
6584
6585                if Present (Discr_Val)
6586                  and then Is_OK_Static_Expression (Discr_Val)
6587                then
6588                   Append_To (Constraints,
6589                     Make_Component_Association (Loc,
6590                       Choices    => New_List (New_Occurrence_Of (Discr, Loc)),
6591                       Expression => New_Copy (Discr_Val)));
6592                else
6593                   return False;
6594                end if;
6595             else
6596                return False;
6597             end if;
6598
6599             Next_Discriminant (Discr);
6600          end loop;
6601
6602          Gather_Components
6603            (Typ           => Typ,
6604             Comp_List     => Comp_List,
6605             Governed_By   => Constraints,
6606             Into          => Components,
6607             Report_Errors => Report_Errors);
6608
6609          --  Check that each component present is fully initialized
6610
6611          Comp_Elmt := First_Elmt (Components);
6612          while Present (Comp_Elmt) loop
6613             Comp_Id := Node (Comp_Elmt);
6614
6615             if Ekind (Comp_Id) = E_Component
6616               and then (No (Parent (Comp_Id))
6617                          or else No (Expression (Parent (Comp_Id))))
6618               and then not Is_Fully_Initialized_Type (Etype (Comp_Id))
6619             then
6620                return False;
6621             end if;
6622
6623             Next_Elmt (Comp_Elmt);
6624          end loop;
6625
6626          return True;
6627
6628       elsif Is_Private_Type (Typ) then
6629          declare
6630             U : constant Entity_Id := Underlying_Type (Typ);
6631
6632          begin
6633             if No (U) then
6634                return False;
6635             else
6636                return Is_Fully_Initialized_Variant (U);
6637             end if;
6638          end;
6639       else
6640          return False;
6641       end if;
6642    end Is_Fully_Initialized_Variant;
6643
6644    ------------
6645    -- Is_LHS --
6646    ------------
6647
6648    --  We seem to have a lot of overlapping functions that do similar things
6649    --  (testing for left hand sides or lvalues???). Anyway, since this one is
6650    --  purely syntactic, it should be in Sem_Aux I would think???
6651
6652    function Is_LHS (N : Node_Id) return Boolean is
6653       P : constant Node_Id := Parent (N);
6654    begin
6655       return Nkind (P) = N_Assignment_Statement
6656         and then Name (P) = N;
6657    end Is_LHS;
6658
6659    ----------------------------
6660    -- Is_Inherited_Operation --
6661    ----------------------------
6662
6663    function Is_Inherited_Operation (E : Entity_Id) return Boolean is
6664       Kind : constant Node_Kind := Nkind (Parent (E));
6665    begin
6666       pragma Assert (Is_Overloadable (E));
6667       return Kind = N_Full_Type_Declaration
6668         or else Kind = N_Private_Extension_Declaration
6669         or else Kind = N_Subtype_Declaration
6670         or else (Ekind (E) = E_Enumeration_Literal
6671                   and then Is_Derived_Type (Etype (E)));
6672    end Is_Inherited_Operation;
6673
6674    -----------------------------
6675    -- Is_Library_Level_Entity --
6676    -----------------------------
6677
6678    function Is_Library_Level_Entity (E : Entity_Id) return Boolean is
6679    begin
6680       --  The following is a small optimization, and it also properly handles
6681       --  discriminals, which in task bodies might appear in expressions before
6682       --  the corresponding procedure has been created, and which therefore do
6683       --  not have an assigned scope.
6684
6685       if Is_Formal (E) then
6686          return False;
6687       end if;
6688
6689       --  Normal test is simply that the enclosing dynamic scope is Standard
6690
6691       return Enclosing_Dynamic_Scope (E) = Standard_Standard;
6692    end Is_Library_Level_Entity;
6693
6694    ---------------------------------
6695    -- Is_Local_Variable_Reference --
6696    ---------------------------------
6697
6698    function Is_Local_Variable_Reference (Expr : Node_Id) return Boolean is
6699    begin
6700       if not Is_Entity_Name (Expr) then
6701          return False;
6702
6703       else
6704          declare
6705             Ent : constant Entity_Id := Entity (Expr);
6706             Sub : constant Entity_Id := Enclosing_Subprogram (Ent);
6707          begin
6708             if not Ekind_In (Ent, E_Variable, E_In_Out_Parameter) then
6709                return False;
6710             else
6711                return Present (Sub) and then Sub = Current_Subprogram;
6712             end if;
6713          end;
6714       end if;
6715    end Is_Local_Variable_Reference;
6716
6717    -------------------------
6718    -- Is_Object_Reference --
6719    -------------------------
6720
6721    function Is_Object_Reference (N : Node_Id) return Boolean is
6722    begin
6723       if Is_Entity_Name (N) then
6724          return Present (Entity (N)) and then Is_Object (Entity (N));
6725
6726       else
6727          case Nkind (N) is
6728             when N_Indexed_Component | N_Slice =>
6729                return
6730                  Is_Object_Reference (Prefix (N))
6731                    or else Is_Access_Type (Etype (Prefix (N)));
6732
6733             --  In Ada95, a function call is a constant object; a procedure
6734             --  call is not.
6735
6736             when N_Function_Call =>
6737                return Etype (N) /= Standard_Void_Type;
6738
6739             --  A reference to the stream attribute Input is a function call
6740
6741             when N_Attribute_Reference =>
6742                return Attribute_Name (N) = Name_Input;
6743
6744             when N_Selected_Component =>
6745                return
6746                  Is_Object_Reference (Selector_Name (N))
6747                    and then
6748                      (Is_Object_Reference (Prefix (N))
6749                         or else Is_Access_Type (Etype (Prefix (N))));
6750
6751             when N_Explicit_Dereference =>
6752                return True;
6753
6754             --  A view conversion of a tagged object is an object reference
6755
6756             when N_Type_Conversion =>
6757                return Is_Tagged_Type (Etype (Subtype_Mark (N)))
6758                  and then Is_Tagged_Type (Etype (Expression (N)))
6759                  and then Is_Object_Reference (Expression (N));
6760
6761             --  An unchecked type conversion is considered to be an object if
6762             --  the operand is an object (this construction arises only as a
6763             --  result of expansion activities).
6764
6765             when N_Unchecked_Type_Conversion =>
6766                return True;
6767
6768             when others =>
6769                return False;
6770          end case;
6771       end if;
6772    end Is_Object_Reference;
6773
6774    -----------------------------------
6775    -- Is_OK_Variable_For_Out_Formal --
6776    -----------------------------------
6777
6778    function Is_OK_Variable_For_Out_Formal (AV : Node_Id) return Boolean is
6779    begin
6780       Note_Possible_Modification (AV, Sure => True);
6781
6782       --  We must reject parenthesized variable names. The check for
6783       --  Comes_From_Source is present because there are currently
6784       --  cases where the compiler violates this rule (e.g. passing
6785       --  a task object to its controlled Initialize routine).
6786
6787       if Paren_Count (AV) > 0 and then Comes_From_Source (AV) then
6788          return False;
6789
6790       --  A variable is always allowed
6791
6792       elsif Is_Variable (AV) then
6793          return True;
6794
6795       --  Unchecked conversions are allowed only if they come from the
6796       --  generated code, which sometimes uses unchecked conversions for out
6797       --  parameters in cases where code generation is unaffected. We tell
6798       --  source unchecked conversions by seeing if they are rewrites of an
6799       --  original Unchecked_Conversion function call, or of an explicit
6800       --  conversion of a function call.
6801
6802       elsif Nkind (AV) = N_Unchecked_Type_Conversion then
6803          if Nkind (Original_Node (AV)) = N_Function_Call then
6804             return False;
6805
6806          elsif Comes_From_Source (AV)
6807            and then Nkind (Original_Node (Expression (AV))) = N_Function_Call
6808          then
6809             return False;
6810
6811          elsif Nkind (Original_Node (AV)) = N_Type_Conversion then
6812             return Is_OK_Variable_For_Out_Formal (Expression (AV));
6813
6814          else
6815             return True;
6816          end if;
6817
6818       --  Normal type conversions are allowed if argument is a variable
6819
6820       elsif Nkind (AV) = N_Type_Conversion then
6821          if Is_Variable (Expression (AV))
6822            and then Paren_Count (Expression (AV)) = 0
6823          then
6824             Note_Possible_Modification (Expression (AV), Sure => True);
6825             return True;
6826
6827          --  We also allow a non-parenthesized expression that raises
6828          --  constraint error if it rewrites what used to be a variable
6829
6830          elsif Raises_Constraint_Error (Expression (AV))
6831             and then Paren_Count (Expression (AV)) = 0
6832             and then Is_Variable (Original_Node (Expression (AV)))
6833          then
6834             return True;
6835
6836          --  Type conversion of something other than a variable
6837
6838          else
6839             return False;
6840          end if;
6841
6842       --  If this node is rewritten, then test the original form, if that is
6843       --  OK, then we consider the rewritten node OK (for example, if the
6844       --  original node is a conversion, then Is_Variable will not be true
6845       --  but we still want to allow the conversion if it converts a variable).
6846
6847       elsif Original_Node (AV) /= AV then
6848          return Is_OK_Variable_For_Out_Formal (Original_Node (AV));
6849
6850       --  All other non-variables are rejected
6851
6852       else
6853          return False;
6854       end if;
6855    end Is_OK_Variable_For_Out_Formal;
6856
6857    -----------------------------------
6858    -- Is_Partially_Initialized_Type --
6859    -----------------------------------
6860
6861    function Is_Partially_Initialized_Type
6862      (Typ          : Entity_Id;
6863       Include_Null : Boolean := True) return Boolean
6864    is
6865    begin
6866       if Is_Scalar_Type (Typ) then
6867          return False;
6868
6869       elsif Is_Access_Type (Typ) then
6870          return Include_Null;
6871
6872       elsif Is_Array_Type (Typ) then
6873
6874          --  If component type is partially initialized, so is array type
6875
6876          if Is_Partially_Initialized_Type
6877               (Component_Type (Typ), Include_Null)
6878          then
6879             return True;
6880
6881          --  Otherwise we are only partially initialized if we are fully
6882          --  initialized (this is the empty array case, no point in us
6883          --  duplicating that code here).
6884
6885          else
6886             return Is_Fully_Initialized_Type (Typ);
6887          end if;
6888
6889       elsif Is_Record_Type (Typ) then
6890
6891          --  A discriminated type is always partially initialized
6892
6893          if Has_Discriminants (Typ) then
6894             return True;
6895
6896          --  A tagged type is always partially initialized
6897
6898          elsif Is_Tagged_Type (Typ) then
6899             return True;
6900
6901          --  Case of non-discriminated record
6902
6903          else
6904             declare
6905                Ent : Entity_Id;
6906
6907                Component_Present : Boolean := False;
6908                --  Set True if at least one component is present. If no
6909                --  components are present, then record type is fully
6910                --  initialized (another odd case, like the null array).
6911
6912             begin
6913                --  Loop through components
6914
6915                Ent := First_Entity (Typ);
6916                while Present (Ent) loop
6917                   if Ekind (Ent) = E_Component then
6918                      Component_Present := True;
6919
6920                      --  If a component has an initialization expression then
6921                      --  the enclosing record type is partially initialized
6922
6923                      if Present (Parent (Ent))
6924                        and then Present (Expression (Parent (Ent)))
6925                      then
6926                         return True;
6927
6928                      --  If a component is of a type which is itself partially
6929                      --  initialized, then the enclosing record type is also.
6930
6931                      elsif Is_Partially_Initialized_Type
6932                              (Etype (Ent), Include_Null)
6933                      then
6934                         return True;
6935                      end if;
6936                   end if;
6937
6938                   Next_Entity (Ent);
6939                end loop;
6940
6941                --  No initialized components found. If we found any components
6942                --  they were all uninitialized so the result is false.
6943
6944                if Component_Present then
6945                   return False;
6946
6947                --  But if we found no components, then all the components are
6948                --  initialized so we consider the type to be initialized.
6949
6950                else
6951                   return True;
6952                end if;
6953             end;
6954          end if;
6955
6956       --  Concurrent types are always fully initialized
6957
6958       elsif Is_Concurrent_Type (Typ) then
6959          return True;
6960
6961       --  For a private type, go to underlying type. If there is no underlying
6962       --  type then just assume this partially initialized. Not clear if this
6963       --  can happen in a non-error case, but no harm in testing for this.
6964
6965       elsif Is_Private_Type (Typ) then
6966          declare
6967             U : constant Entity_Id := Underlying_Type (Typ);
6968          begin
6969             if No (U) then
6970                return True;
6971             else
6972                return Is_Partially_Initialized_Type (U, Include_Null);
6973             end if;
6974          end;
6975
6976       --  For any other type (are there any?) assume partially initialized
6977
6978       else
6979          return True;
6980       end if;
6981    end Is_Partially_Initialized_Type;
6982
6983    ------------------------------------
6984    -- Is_Potentially_Persistent_Type --
6985    ------------------------------------
6986
6987    function Is_Potentially_Persistent_Type (T : Entity_Id) return Boolean is
6988       Comp : Entity_Id;
6989       Indx : Node_Id;
6990
6991    begin
6992       --  For private type, test corresponding full type
6993
6994       if Is_Private_Type (T) then
6995          return Is_Potentially_Persistent_Type (Full_View (T));
6996
6997       --  Scalar types are potentially persistent
6998
6999       elsif Is_Scalar_Type (T) then
7000          return True;
7001
7002       --  Record type is potentially persistent if not tagged and the types of
7003       --  all it components are potentially persistent, and no component has
7004       --  an initialization expression.
7005
7006       elsif Is_Record_Type (T)
7007         and then not Is_Tagged_Type (T)
7008         and then not Is_Partially_Initialized_Type (T)
7009       then
7010          Comp := First_Component (T);
7011          while Present (Comp) loop
7012             if not Is_Potentially_Persistent_Type (Etype (Comp)) then
7013                return False;
7014             else
7015                Next_Entity (Comp);
7016             end if;
7017          end loop;
7018
7019          return True;
7020
7021       --  Array type is potentially persistent if its component type is
7022       --  potentially persistent and if all its constraints are static.
7023
7024       elsif Is_Array_Type (T) then
7025          if not Is_Potentially_Persistent_Type (Component_Type (T)) then
7026             return False;
7027          end if;
7028
7029          Indx := First_Index (T);
7030          while Present (Indx) loop
7031             if not Is_OK_Static_Subtype (Etype (Indx)) then
7032                return False;
7033             else
7034                Next_Index (Indx);
7035             end if;
7036          end loop;
7037
7038          return True;
7039
7040       --  All other types are not potentially persistent
7041
7042       else
7043          return False;
7044       end if;
7045    end Is_Potentially_Persistent_Type;
7046
7047    ---------------------------------
7048    -- Is_Protected_Self_Reference --
7049    ---------------------------------
7050
7051    function Is_Protected_Self_Reference (N : Node_Id) return Boolean is
7052
7053       function In_Access_Definition (N : Node_Id) return Boolean;
7054       --  Returns true if N belongs to an access definition
7055
7056       --------------------------
7057       -- In_Access_Definition --
7058       --------------------------
7059
7060       function In_Access_Definition (N : Node_Id) return Boolean is
7061          P : Node_Id;
7062
7063       begin
7064          P := Parent (N);
7065          while Present (P) loop
7066             if Nkind (P) = N_Access_Definition then
7067                return True;
7068             end if;
7069
7070             P := Parent (P);
7071          end loop;
7072
7073          return False;
7074       end In_Access_Definition;
7075
7076    --  Start of processing for Is_Protected_Self_Reference
7077
7078    begin
7079       --  Verify that prefix is analyzed and has the proper form. Note that
7080       --  the attributes Elab_Spec, Elab_Body, and UET_Address, which also
7081       --  produce the address of an entity, do not analyze their prefix
7082       --  because they denote entities that are not necessarily visible.
7083       --  Neither of them can apply to a protected type.
7084
7085       return Ada_Version >= Ada_2005
7086         and then Is_Entity_Name (N)
7087         and then Present (Entity (N))
7088         and then Is_Protected_Type (Entity (N))
7089         and then In_Open_Scopes (Entity (N))
7090         and then not In_Access_Definition (N);
7091    end Is_Protected_Self_Reference;
7092
7093    -----------------------------
7094    -- Is_RCI_Pkg_Spec_Or_Body --
7095    -----------------------------
7096
7097    function Is_RCI_Pkg_Spec_Or_Body (Cunit : Node_Id) return Boolean is
7098
7099       function Is_RCI_Pkg_Decl_Cunit (Cunit : Node_Id) return Boolean;
7100       --  Return True if the unit of Cunit is an RCI package declaration
7101
7102       ---------------------------
7103       -- Is_RCI_Pkg_Decl_Cunit --
7104       ---------------------------
7105
7106       function Is_RCI_Pkg_Decl_Cunit (Cunit : Node_Id) return Boolean is
7107          The_Unit : constant Node_Id := Unit (Cunit);
7108
7109       begin
7110          if Nkind (The_Unit) /= N_Package_Declaration then
7111             return False;
7112          end if;
7113
7114          return Is_Remote_Call_Interface (Defining_Entity (The_Unit));
7115       end Is_RCI_Pkg_Decl_Cunit;
7116
7117    --  Start of processing for Is_RCI_Pkg_Spec_Or_Body
7118
7119    begin
7120       return Is_RCI_Pkg_Decl_Cunit (Cunit)
7121         or else
7122          (Nkind (Unit (Cunit)) = N_Package_Body
7123            and then Is_RCI_Pkg_Decl_Cunit (Library_Unit (Cunit)));
7124    end Is_RCI_Pkg_Spec_Or_Body;
7125
7126    -----------------------------------------
7127    -- Is_Remote_Access_To_Class_Wide_Type --
7128    -----------------------------------------
7129
7130    function Is_Remote_Access_To_Class_Wide_Type
7131      (E : Entity_Id) return Boolean
7132    is
7133    begin
7134       --  A remote access to class-wide type is a general access to object type
7135       --  declared in the visible part of a Remote_Types or Remote_Call_
7136       --  Interface unit.
7137
7138       return Ekind (E) = E_General_Access_Type
7139         and then (Is_Remote_Call_Interface (E) or else Is_Remote_Types (E));
7140    end Is_Remote_Access_To_Class_Wide_Type;
7141
7142    -----------------------------------------
7143    -- Is_Remote_Access_To_Subprogram_Type --
7144    -----------------------------------------
7145
7146    function Is_Remote_Access_To_Subprogram_Type
7147      (E : Entity_Id) return Boolean
7148    is
7149    begin
7150       return (Ekind (E) = E_Access_Subprogram_Type
7151                 or else (Ekind (E) = E_Record_Type
7152                            and then Present (Corresponding_Remote_Type (E))))
7153         and then (Is_Remote_Call_Interface (E) or else Is_Remote_Types (E));
7154    end Is_Remote_Access_To_Subprogram_Type;
7155
7156    --------------------
7157    -- Is_Remote_Call --
7158    --------------------
7159
7160    function Is_Remote_Call (N : Node_Id) return Boolean is
7161    begin
7162       if Nkind (N) /= N_Procedure_Call_Statement
7163         and then Nkind (N) /= N_Function_Call
7164       then
7165          --  An entry call cannot be remote
7166
7167          return False;
7168
7169       elsif Nkind (Name (N)) in N_Has_Entity
7170         and then Is_Remote_Call_Interface (Entity (Name (N)))
7171       then
7172          --  A subprogram declared in the spec of a RCI package is remote
7173
7174          return True;
7175
7176       elsif Nkind (Name (N)) = N_Explicit_Dereference
7177         and then Is_Remote_Access_To_Subprogram_Type
7178                    (Etype (Prefix (Name (N))))
7179       then
7180          --  The dereference of a RAS is a remote call
7181
7182          return True;
7183
7184       elsif Present (Controlling_Argument (N))
7185         and then Is_Remote_Access_To_Class_Wide_Type
7186           (Etype (Controlling_Argument (N)))
7187       then
7188          --  Any primitive operation call with a controlling argument of
7189          --  a RACW type is a remote call.
7190
7191          return True;
7192       end if;
7193
7194       --  All other calls are local calls
7195
7196       return False;
7197    end Is_Remote_Call;
7198
7199    ----------------------
7200    -- Is_Renamed_Entry --
7201    ----------------------
7202
7203    function Is_Renamed_Entry (Proc_Nam : Entity_Id) return Boolean is
7204       Orig_Node : Node_Id := Empty;
7205       Subp_Decl : Node_Id := Parent (Parent (Proc_Nam));
7206
7207       function Is_Entry (Nam : Node_Id) return Boolean;
7208       --  Determine whether Nam is an entry. Traverse selectors if there are
7209       --  nested selected components.
7210
7211       --------------
7212       -- Is_Entry --
7213       --------------
7214
7215       function Is_Entry (Nam : Node_Id) return Boolean is
7216       begin
7217          if Nkind (Nam) = N_Selected_Component then
7218             return Is_Entry (Selector_Name (Nam));
7219          end if;
7220
7221          return Ekind (Entity (Nam)) = E_Entry;
7222       end Is_Entry;
7223
7224    --  Start of processing for Is_Renamed_Entry
7225
7226    begin
7227       if Present (Alias (Proc_Nam)) then
7228          Subp_Decl := Parent (Parent (Alias (Proc_Nam)));
7229       end if;
7230
7231       --  Look for a rewritten subprogram renaming declaration
7232
7233       if Nkind (Subp_Decl) = N_Subprogram_Declaration
7234         and then Present (Original_Node (Subp_Decl))
7235       then
7236          Orig_Node := Original_Node (Subp_Decl);
7237       end if;
7238
7239       --  The rewritten subprogram is actually an entry
7240
7241       if Present (Orig_Node)
7242         and then Nkind (Orig_Node) = N_Subprogram_Renaming_Declaration
7243         and then Is_Entry (Name (Orig_Node))
7244       then
7245          return True;
7246       end if;
7247
7248       return False;
7249    end Is_Renamed_Entry;
7250
7251    ----------------------
7252    -- Is_Selector_Name --
7253    ----------------------
7254
7255    function Is_Selector_Name (N : Node_Id) return Boolean is
7256    begin
7257       if not Is_List_Member (N) then
7258          declare
7259             P : constant Node_Id   := Parent (N);
7260             K : constant Node_Kind := Nkind (P);
7261          begin
7262             return
7263               (K = N_Expanded_Name          or else
7264                K = N_Generic_Association    or else
7265                K = N_Parameter_Association  or else
7266                K = N_Selected_Component)
7267               and then Selector_Name (P) = N;
7268          end;
7269
7270       else
7271          declare
7272             L : constant List_Id := List_Containing (N);
7273             P : constant Node_Id := Parent (L);
7274          begin
7275             return (Nkind (P) = N_Discriminant_Association
7276                      and then Selector_Names (P) = L)
7277               or else
7278                    (Nkind (P) = N_Component_Association
7279                      and then Choices (P) = L);
7280          end;
7281       end if;
7282    end Is_Selector_Name;
7283
7284    ------------------
7285    -- Is_Statement --
7286    ------------------
7287
7288    function Is_Statement (N : Node_Id) return Boolean is
7289    begin
7290       return
7291         Nkind (N) in N_Statement_Other_Than_Procedure_Call
7292           or else Nkind (N) = N_Procedure_Call_Statement;
7293    end Is_Statement;
7294
7295    ---------------------------------
7296    -- Is_Synchronized_Tagged_Type --
7297    ---------------------------------
7298
7299    function Is_Synchronized_Tagged_Type (E : Entity_Id) return Boolean is
7300       Kind : constant Entity_Kind := Ekind (Base_Type (E));
7301
7302    begin
7303       --  A task or protected type derived from an interface is a tagged type.
7304       --  Such a tagged type is called a synchronized tagged type, as are
7305       --  synchronized interfaces and private extensions whose declaration
7306       --  includes the reserved word synchronized.
7307
7308       return (Is_Tagged_Type (E)
7309                 and then (Kind = E_Task_Type
7310                            or else Kind = E_Protected_Type))
7311             or else
7312              (Is_Interface (E)
7313                 and then Is_Synchronized_Interface (E))
7314             or else
7315              (Ekind (E) = E_Record_Type_With_Private
7316                 and then (Synchronized_Present (Parent (E))
7317                            or else Is_Synchronized_Interface (Etype (E))));
7318    end Is_Synchronized_Tagged_Type;
7319
7320    -----------------
7321    -- Is_Transfer --
7322    -----------------
7323
7324    function Is_Transfer (N : Node_Id) return Boolean is
7325       Kind : constant Node_Kind := Nkind (N);
7326
7327    begin
7328       if Kind = N_Simple_Return_Statement
7329            or else
7330          Kind = N_Extended_Return_Statement
7331            or else
7332          Kind = N_Goto_Statement
7333            or else
7334          Kind = N_Raise_Statement
7335            or else
7336          Kind = N_Requeue_Statement
7337       then
7338          return True;
7339
7340       elsif (Kind = N_Exit_Statement or else Kind in N_Raise_xxx_Error)
7341         and then No (Condition (N))
7342       then
7343          return True;
7344
7345       elsif Kind = N_Procedure_Call_Statement
7346         and then Is_Entity_Name (Name (N))
7347         and then Present (Entity (Name (N)))
7348         and then No_Return (Entity (Name (N)))
7349       then
7350          return True;
7351
7352       elsif Nkind (Original_Node (N)) = N_Raise_Statement then
7353          return True;
7354
7355       else
7356          return False;
7357       end if;
7358    end Is_Transfer;
7359
7360    -------------
7361    -- Is_True --
7362    -------------
7363
7364    function Is_True (U : Uint) return Boolean is
7365    begin
7366       return (U /= 0);
7367    end Is_True;
7368
7369    -------------------------------
7370    -- Is_Universal_Numeric_Type --
7371    -------------------------------
7372
7373    function Is_Universal_Numeric_Type (T : Entity_Id) return Boolean is
7374    begin
7375       return T = Universal_Integer or else T = Universal_Real;
7376    end Is_Universal_Numeric_Type;
7377
7378    -------------------
7379    -- Is_Value_Type --
7380    -------------------
7381
7382    function Is_Value_Type (T : Entity_Id) return Boolean is
7383    begin
7384       return VM_Target = CLI_Target
7385         and then Nkind (T) in N_Has_Chars
7386         and then Chars (T) /= No_Name
7387         and then Get_Name_String (Chars (T)) = "valuetype";
7388    end Is_Value_Type;
7389
7390    ---------------------
7391    -- Is_VMS_Operator --
7392    ---------------------
7393
7394    function Is_VMS_Operator (Op : Entity_Id) return Boolean is
7395    begin
7396       --  The VMS operators are declared in a child of System that is loaded
7397       --  through pragma Extend_System. In some rare cases a program is run
7398       --  with this extension but without indicating that the target is VMS.
7399
7400       return Ekind (Op) = E_Function
7401         and then Is_Intrinsic_Subprogram (Op)
7402         and then
7403           ((Present_System_Aux
7404             and then Scope (Op) = System_Aux_Id)
7405            or else
7406            (True_VMS_Target
7407              and then Scope (Scope (Op)) = RTU_Entity (System)));
7408    end Is_VMS_Operator;
7409
7410    -----------------
7411    -- Is_Variable --
7412    -----------------
7413
7414    function Is_Variable (N : Node_Id) return Boolean is
7415
7416       Orig_Node : constant Node_Id := Original_Node (N);
7417       --  We do the test on the original node, since this is basically a test
7418       --  of syntactic categories, so it must not be disturbed by whatever
7419       --  rewriting might have occurred. For example, an aggregate, which is
7420       --  certainly NOT a variable, could be turned into a variable by
7421       --  expansion.
7422
7423       function In_Protected_Function (E : Entity_Id) return Boolean;
7424       --  Within a protected function, the private components of the enclosing
7425       --  protected type are constants. A function nested within a (protected)
7426       --  procedure is not itself protected.
7427
7428       function Is_Variable_Prefix (P : Node_Id) return Boolean;
7429       --  Prefixes can involve implicit dereferences, in which case we must
7430       --  test for the case of a reference of a constant access type, which can
7431       --  can never be a variable.
7432
7433       ---------------------------
7434       -- In_Protected_Function --
7435       ---------------------------
7436
7437       function In_Protected_Function (E : Entity_Id) return Boolean is
7438          Prot : constant Entity_Id := Scope (E);
7439          S    : Entity_Id;
7440
7441       begin
7442          if not Is_Protected_Type (Prot) then
7443             return False;
7444          else
7445             S := Current_Scope;
7446             while Present (S) and then S /= Prot loop
7447                if Ekind (S) = E_Function and then Scope (S) = Prot then
7448                   return True;
7449                end if;
7450
7451                S := Scope (S);
7452             end loop;
7453
7454             return False;
7455          end if;
7456       end In_Protected_Function;
7457
7458       ------------------------
7459       -- Is_Variable_Prefix --
7460       ------------------------
7461
7462       function Is_Variable_Prefix (P : Node_Id) return Boolean is
7463       begin
7464          if Is_Access_Type (Etype (P)) then
7465             return not Is_Access_Constant (Root_Type (Etype (P)));
7466
7467          --  For the case of an indexed component whose prefix has a packed
7468          --  array type, the prefix has been rewritten into a type conversion.
7469          --  Determine variable-ness from the converted expression.
7470
7471          elsif Nkind (P) = N_Type_Conversion
7472            and then not Comes_From_Source (P)
7473            and then Is_Array_Type (Etype (P))
7474            and then Is_Packed (Etype (P))
7475          then
7476             return Is_Variable (Expression (P));
7477
7478          else
7479             return Is_Variable (P);
7480          end if;
7481       end Is_Variable_Prefix;
7482
7483    --  Start of processing for Is_Variable
7484
7485    begin
7486       --  Definitely OK if Assignment_OK is set. Since this is something that
7487       --  only gets set for expanded nodes, the test is on N, not Orig_Node.
7488
7489       if Nkind (N) in N_Subexpr and then Assignment_OK (N) then
7490          return True;
7491
7492       --  Normally we go to the original node, but there is one exception where
7493       --  we use the rewritten node, namely when it is an explicit dereference.
7494       --  The generated code may rewrite a prefix which is an access type with
7495       --  an explicit dereference. The dereference is a variable, even though
7496       --  the original node may not be (since it could be a constant of the
7497       --  access type).
7498
7499       --  In Ada 2005 we have a further case to consider: the prefix may be a
7500       --  function call given in prefix notation. The original node appears to
7501       --  be a selected component, but we need to examine the call.
7502
7503       elsif Nkind (N) = N_Explicit_Dereference
7504         and then Nkind (Orig_Node) /= N_Explicit_Dereference
7505         and then Present (Etype (Orig_Node))
7506         and then Is_Access_Type (Etype (Orig_Node))
7507       then
7508          --  Note that if the prefix is an explicit dereference that does not
7509          --  come from source, we must check for a rewritten function call in
7510          --  prefixed notation before other forms of rewriting, to prevent a
7511          --  compiler crash.
7512
7513          return
7514            (Nkind (Orig_Node) = N_Function_Call
7515              and then not Is_Access_Constant (Etype (Prefix (N))))
7516            or else
7517              Is_Variable_Prefix (Original_Node (Prefix (N)));
7518
7519       --  A function call is never a variable
7520
7521       elsif Nkind (N) = N_Function_Call then
7522          return False;
7523
7524       --  All remaining checks use the original node
7525
7526       elsif Is_Entity_Name (Orig_Node)
7527         and then Present (Entity (Orig_Node))
7528       then
7529          declare
7530             E : constant Entity_Id := Entity (Orig_Node);
7531             K : constant Entity_Kind := Ekind (E);
7532
7533          begin
7534             return (K = E_Variable
7535                       and then Nkind (Parent (E)) /= N_Exception_Handler)
7536               or else  (K = E_Component
7537                           and then not In_Protected_Function (E))
7538               or else  K = E_Out_Parameter
7539               or else  K = E_In_Out_Parameter
7540               or else  K = E_Generic_In_Out_Parameter
7541
7542                --  Current instance of type:
7543
7544               or else (Is_Type (E) and then In_Open_Scopes (E))
7545               or else (Is_Incomplete_Or_Private_Type (E)
7546                         and then In_Open_Scopes (Full_View (E)));
7547          end;
7548
7549       else
7550          case Nkind (Orig_Node) is
7551             when N_Indexed_Component | N_Slice =>
7552                return Is_Variable_Prefix (Prefix (Orig_Node));
7553
7554             when N_Selected_Component =>
7555                return Is_Variable_Prefix (Prefix (Orig_Node))
7556                  and then Is_Variable (Selector_Name (Orig_Node));
7557
7558             --  For an explicit dereference, the type of the prefix cannot
7559             --  be an access to constant or an access to subprogram.
7560
7561             when N_Explicit_Dereference =>
7562                declare
7563                   Typ : constant Entity_Id := Etype (Prefix (Orig_Node));
7564                begin
7565                   return Is_Access_Type (Typ)
7566                     and then not Is_Access_Constant (Root_Type (Typ))
7567                     and then Ekind (Typ) /= E_Access_Subprogram_Type;
7568                end;
7569
7570             --  The type conversion is the case where we do not deal with the
7571             --  context dependent special case of an actual parameter. Thus
7572             --  the type conversion is only considered a variable for the
7573             --  purposes of this routine if the target type is tagged. However,
7574             --  a type conversion is considered to be a variable if it does not
7575             --  come from source (this deals for example with the conversions
7576             --  of expressions to their actual subtypes).
7577
7578             when N_Type_Conversion =>
7579                return Is_Variable (Expression (Orig_Node))
7580                  and then
7581                    (not Comes_From_Source (Orig_Node)
7582                       or else
7583                         (Is_Tagged_Type (Etype (Subtype_Mark (Orig_Node)))
7584                           and then
7585                          Is_Tagged_Type (Etype (Expression (Orig_Node)))));
7586
7587             --  GNAT allows an unchecked type conversion as a variable. This
7588             --  only affects the generation of internal expanded code, since
7589             --  calls to instantiations of Unchecked_Conversion are never
7590             --  considered variables (since they are function calls).
7591             --  This is also true for expression actions.
7592
7593             when N_Unchecked_Type_Conversion =>
7594                return Is_Variable (Expression (Orig_Node));
7595
7596             when others =>
7597                return False;
7598          end case;
7599       end if;
7600    end Is_Variable;
7601
7602    ---------------------------
7603    -- Is_Visibly_Controlled --
7604    ---------------------------
7605
7606    function Is_Visibly_Controlled (T : Entity_Id) return Boolean is
7607       Root : constant Entity_Id := Root_Type (T);
7608    begin
7609       return Chars (Scope (Root)) = Name_Finalization
7610         and then Chars (Scope (Scope (Root))) = Name_Ada
7611         and then Scope (Scope (Scope (Root))) = Standard_Standard;
7612    end Is_Visibly_Controlled;
7613
7614    ------------------------
7615    -- Is_Volatile_Object --
7616    ------------------------
7617
7618    function Is_Volatile_Object (N : Node_Id) return Boolean is
7619
7620       function Object_Has_Volatile_Components (N : Node_Id) return Boolean;
7621       --  Determines if given object has volatile components
7622
7623       function Is_Volatile_Prefix (N : Node_Id) return Boolean;
7624       --  If prefix is an implicit dereference, examine designated type
7625
7626       ------------------------
7627       -- Is_Volatile_Prefix --
7628       ------------------------
7629
7630       function Is_Volatile_Prefix (N : Node_Id) return Boolean is
7631          Typ  : constant Entity_Id := Etype (N);
7632
7633       begin
7634          if Is_Access_Type (Typ) then
7635             declare
7636                Dtyp : constant Entity_Id := Designated_Type (Typ);
7637
7638             begin
7639                return Is_Volatile (Dtyp)
7640                  or else Has_Volatile_Components (Dtyp);
7641             end;
7642
7643          else
7644             return Object_Has_Volatile_Components (N);
7645          end if;
7646       end Is_Volatile_Prefix;
7647
7648       ------------------------------------
7649       -- Object_Has_Volatile_Components --
7650       ------------------------------------
7651
7652       function Object_Has_Volatile_Components (N : Node_Id) return Boolean is
7653          Typ : constant Entity_Id := Etype (N);
7654
7655       begin
7656          if Is_Volatile (Typ)
7657            or else Has_Volatile_Components (Typ)
7658          then
7659             return True;
7660
7661          elsif Is_Entity_Name (N)
7662            and then (Has_Volatile_Components (Entity (N))
7663                       or else Is_Volatile (Entity (N)))
7664          then
7665             return True;
7666
7667          elsif Nkind (N) = N_Indexed_Component
7668            or else Nkind (N) = N_Selected_Component
7669          then
7670             return Is_Volatile_Prefix (Prefix (N));
7671
7672          else
7673             return False;
7674          end if;
7675       end Object_Has_Volatile_Components;
7676
7677    --  Start of processing for Is_Volatile_Object
7678
7679    begin
7680       if Is_Volatile (Etype (N))
7681         or else (Is_Entity_Name (N) and then Is_Volatile (Entity (N)))
7682       then
7683          return True;
7684
7685       elsif Nkind (N) = N_Indexed_Component
7686         or else Nkind (N) = N_Selected_Component
7687       then
7688          return Is_Volatile_Prefix (Prefix (N));
7689
7690       else
7691          return False;
7692       end if;
7693    end Is_Volatile_Object;
7694
7695    -------------------------
7696    -- Kill_Current_Values --
7697    -------------------------
7698
7699    procedure Kill_Current_Values
7700      (Ent                  : Entity_Id;
7701       Last_Assignment_Only : Boolean := False)
7702    is
7703    begin
7704       --  ??? do we have to worry about clearing cached checks?
7705
7706       if Is_Assignable (Ent) then
7707          Set_Last_Assignment (Ent, Empty);
7708       end if;
7709
7710       if Is_Object (Ent) then
7711          if not Last_Assignment_Only then
7712             Kill_Checks (Ent);
7713             Set_Current_Value (Ent, Empty);
7714
7715             if not Can_Never_Be_Null (Ent) then
7716                Set_Is_Known_Non_Null (Ent, False);
7717             end if;
7718
7719             Set_Is_Known_Null (Ent, False);
7720
7721             --  Reset Is_Known_Valid unless type is always valid, or if we have
7722             --  a loop parameter (loop parameters are always valid, since their
7723             --  bounds are defined by the bounds given in the loop header).
7724
7725             if not Is_Known_Valid (Etype (Ent))
7726               and then Ekind (Ent) /= E_Loop_Parameter
7727             then
7728                Set_Is_Known_Valid (Ent, False);
7729             end if;
7730          end if;
7731       end if;
7732    end Kill_Current_Values;
7733
7734    procedure Kill_Current_Values (Last_Assignment_Only : Boolean := False) is
7735       S : Entity_Id;
7736
7737       procedure Kill_Current_Values_For_Entity_Chain (E : Entity_Id);
7738       --  Clear current value for entity E and all entities chained to E
7739
7740       ------------------------------------------
7741       -- Kill_Current_Values_For_Entity_Chain --
7742       ------------------------------------------
7743
7744       procedure Kill_Current_Values_For_Entity_Chain (E : Entity_Id) is
7745          Ent : Entity_Id;
7746       begin
7747          Ent := E;
7748          while Present (Ent) loop
7749             Kill_Current_Values (Ent, Last_Assignment_Only);
7750             Next_Entity (Ent);
7751          end loop;
7752       end Kill_Current_Values_For_Entity_Chain;
7753
7754    --  Start of processing for Kill_Current_Values
7755
7756    begin
7757       --  Kill all saved checks, a special case of killing saved values
7758
7759       if not Last_Assignment_Only then
7760          Kill_All_Checks;
7761       end if;
7762
7763       --  Loop through relevant scopes, which includes the current scope and
7764       --  any parent scopes if the current scope is a block or a package.
7765
7766       S := Current_Scope;
7767       Scope_Loop : loop
7768
7769          --  Clear current values of all entities in current scope
7770
7771          Kill_Current_Values_For_Entity_Chain (First_Entity (S));
7772
7773          --  If scope is a package, also clear current values of all
7774          --  private entities in the scope.
7775
7776          if Is_Package_Or_Generic_Package (S)
7777            or else Is_Concurrent_Type (S)
7778          then
7779             Kill_Current_Values_For_Entity_Chain (First_Private_Entity (S));
7780          end if;
7781
7782          --  If this is a not a subprogram, deal with parents
7783
7784          if not Is_Subprogram (S) then
7785             S := Scope (S);
7786             exit Scope_Loop when S = Standard_Standard;
7787          else
7788             exit Scope_Loop;
7789          end if;
7790       end loop Scope_Loop;
7791    end Kill_Current_Values;
7792
7793    --------------------------
7794    -- Kill_Size_Check_Code --
7795    --------------------------
7796
7797    procedure Kill_Size_Check_Code (E : Entity_Id) is
7798    begin
7799       if (Ekind (E) = E_Constant or else Ekind (E) = E_Variable)
7800         and then Present (Size_Check_Code (E))
7801       then
7802          Remove (Size_Check_Code (E));
7803          Set_Size_Check_Code (E, Empty);
7804       end if;
7805    end Kill_Size_Check_Code;
7806
7807    --------------------------
7808    -- Known_To_Be_Assigned --
7809    --------------------------
7810
7811    function Known_To_Be_Assigned (N : Node_Id) return Boolean is
7812       P : constant Node_Id := Parent (N);
7813
7814    begin
7815       case Nkind (P) is
7816
7817          --  Test left side of assignment
7818
7819          when N_Assignment_Statement =>
7820             return N = Name (P);
7821
7822             --  Function call arguments are never lvalues
7823
7824          when N_Function_Call =>
7825             return False;
7826
7827          --  Positional parameter for procedure or accept call
7828
7829          when N_Procedure_Call_Statement |
7830               N_Accept_Statement
7831           =>
7832             declare
7833                Proc : Entity_Id;
7834                Form : Entity_Id;
7835                Act  : Node_Id;
7836
7837             begin
7838                Proc := Get_Subprogram_Entity (P);
7839
7840                if No (Proc) then
7841                   return False;
7842                end if;
7843
7844                --  If we are not a list member, something is strange, so
7845                --  be conservative and return False.
7846
7847                if not Is_List_Member (N) then
7848                   return False;
7849                end if;
7850
7851                --  We are going to find the right formal by stepping forward
7852                --  through the formals, as we step backwards in the actuals.
7853
7854                Form := First_Formal (Proc);
7855                Act  := N;
7856                loop
7857                   --  If no formal, something is weird, so be conservative
7858                   --  and return False.
7859
7860                   if No (Form) then
7861                      return False;
7862                   end if;
7863
7864                   Prev (Act);
7865                   exit when No (Act);
7866                   Next_Formal (Form);
7867                end loop;
7868
7869                return Ekind (Form) /= E_In_Parameter;
7870             end;
7871
7872          --  Named parameter for procedure or accept call
7873
7874          when N_Parameter_Association =>
7875             declare
7876                Proc : Entity_Id;
7877                Form : Entity_Id;
7878
7879             begin
7880                Proc := Get_Subprogram_Entity (Parent (P));
7881
7882                if No (Proc) then
7883                   return False;
7884                end if;
7885
7886                --  Loop through formals to find the one that matches
7887
7888                Form := First_Formal (Proc);
7889                loop
7890                   --  If no matching formal, that's peculiar, some kind of
7891                   --  previous error, so return False to be conservative.
7892
7893                   if No (Form) then
7894                      return False;
7895                   end if;
7896
7897                   --  Else test for match
7898
7899                   if Chars (Form) = Chars (Selector_Name (P)) then
7900                      return Ekind (Form) /= E_In_Parameter;
7901                   end if;
7902
7903                   Next_Formal (Form);
7904                end loop;
7905             end;
7906
7907          --  Test for appearing in a conversion that itself appears
7908          --  in an lvalue context, since this should be an lvalue.
7909
7910          when N_Type_Conversion =>
7911             return Known_To_Be_Assigned (P);
7912
7913          --  All other references are definitely not known to be modifications
7914
7915          when others =>
7916             return False;
7917
7918       end case;
7919    end Known_To_Be_Assigned;
7920
7921    -------------------
7922    -- May_Be_Lvalue --
7923    -------------------
7924
7925    function May_Be_Lvalue (N : Node_Id) return Boolean is
7926       P : constant Node_Id := Parent (N);
7927
7928    begin
7929       case Nkind (P) is
7930
7931          --  Test left side of assignment
7932
7933          when N_Assignment_Statement =>
7934             return N = Name (P);
7935
7936          --  Test prefix of component or attribute. Note that the prefix of an
7937          --  explicit or implicit dereference cannot be an l-value.
7938
7939          when N_Attribute_Reference =>
7940             return N = Prefix (P)
7941               and then Name_Implies_Lvalue_Prefix (Attribute_Name (P));
7942
7943          --  For an expanded name, the name is an lvalue if the expanded name
7944          --  is an lvalue, but the prefix is never an lvalue, since it is just
7945          --  the scope where the name is found.
7946
7947          when N_Expanded_Name        =>
7948             if N = Prefix (P) then
7949                return May_Be_Lvalue (P);
7950             else
7951                return False;
7952             end if;
7953
7954          --  For a selected component A.B, A is certainly an lvalue if A.B is.
7955          --  B is a little interesting, if we have A.B := 3, there is some
7956          --  discussion as to whether B is an lvalue or not, we choose to say
7957          --  it is. Note however that A is not an lvalue if it is of an access
7958          --  type since this is an implicit dereference.
7959
7960          when N_Selected_Component   =>
7961             if N = Prefix (P)
7962               and then Present (Etype (N))
7963               and then Is_Access_Type (Etype (N))
7964             then
7965                return False;
7966             else
7967                return May_Be_Lvalue (P);
7968             end if;
7969
7970          --  For an indexed component or slice, the index or slice bounds is
7971          --  never an lvalue. The prefix is an lvalue if the indexed component
7972          --  or slice is an lvalue, except if it is an access type, where we
7973          --  have an implicit dereference.
7974
7975          when N_Indexed_Component    =>
7976             if N /= Prefix (P)
7977               or else (Present (Etype (N)) and then Is_Access_Type (Etype (N)))
7978             then
7979                return False;
7980             else
7981                return May_Be_Lvalue (P);
7982             end if;
7983
7984          --  Prefix of a reference is an lvalue if the reference is an lvalue
7985
7986          when N_Reference            =>
7987             return May_Be_Lvalue (P);
7988
7989          --  Prefix of explicit dereference is never an lvalue
7990
7991          when N_Explicit_Dereference =>
7992             return False;
7993
7994          --  Positional parameter for subprogram, entry, or accept call.
7995          --  In older versions of Ada function call arguments are never
7996          --  lvalues. In Ada 2012 functions can have in-out parameters.
7997
7998          when N_Function_Call            |
7999               N_Procedure_Call_Statement |
8000               N_Entry_Call_Statement     |
8001               N_Accept_Statement
8002          =>
8003             if Nkind (P) = N_Function_Call
8004               and then Ada_Version < Ada_2012
8005             then
8006                return False;
8007             end if;
8008
8009             --  The following mechanism is clumsy and fragile. A single
8010             --  flag set in Resolve_Actuals would be preferable ???
8011
8012             declare
8013                Proc : Entity_Id;
8014                Form : Entity_Id;
8015                Act  : Node_Id;
8016
8017             begin
8018                Proc := Get_Subprogram_Entity (P);
8019
8020                if No (Proc) then
8021                   return True;
8022                end if;
8023
8024                --  If we are not a list member, something is strange, so
8025                --  be conservative and return True.
8026
8027                if not Is_List_Member (N) then
8028                   return True;
8029                end if;
8030
8031                --  We are going to find the right formal by stepping forward
8032                --  through the formals, as we step backwards in the actuals.
8033
8034                Form := First_Formal (Proc);
8035                Act  := N;
8036                loop
8037                   --  If no formal, something is weird, so be conservative
8038                   --  and return True.
8039
8040                   if No (Form) then
8041                      return True;
8042                   end if;
8043
8044                   Prev (Act);
8045                   exit when No (Act);
8046                   Next_Formal (Form);
8047                end loop;
8048
8049                return Ekind (Form) /= E_In_Parameter;
8050             end;
8051
8052          --  Named parameter for procedure or accept call
8053
8054          when N_Parameter_Association =>
8055             declare
8056                Proc : Entity_Id;
8057                Form : Entity_Id;
8058
8059             begin
8060                Proc := Get_Subprogram_Entity (Parent (P));
8061
8062                if No (Proc) then
8063                   return True;
8064                end if;
8065
8066                --  Loop through formals to find the one that matches
8067
8068                Form := First_Formal (Proc);
8069                loop
8070                   --  If no matching formal, that's peculiar, some kind of
8071                   --  previous error, so return True to be conservative.
8072
8073                   if No (Form) then
8074                      return True;
8075                   end if;
8076
8077                   --  Else test for match
8078
8079                   if Chars (Form) = Chars (Selector_Name (P)) then
8080                      return Ekind (Form) /= E_In_Parameter;
8081                   end if;
8082
8083                   Next_Formal (Form);
8084                end loop;
8085             end;
8086
8087          --  Test for appearing in a conversion that itself appears in an
8088          --  lvalue context, since this should be an lvalue.
8089
8090          when N_Type_Conversion =>
8091             return May_Be_Lvalue (P);
8092
8093          --  Test for appearance in object renaming declaration
8094
8095          when N_Object_Renaming_Declaration =>
8096             return True;
8097
8098          --  All other references are definitely not lvalues
8099
8100          when others =>
8101             return False;
8102
8103       end case;
8104    end May_Be_Lvalue;
8105
8106    -----------------------
8107    -- Mark_Coextensions --
8108    -----------------------
8109
8110    procedure Mark_Coextensions (Context_Nod : Node_Id; Root_Nod : Node_Id) is
8111       Is_Dynamic : Boolean;
8112       --  Indicates whether the context causes nested coextensions to be
8113       --  dynamic or static
8114
8115       function Mark_Allocator (N : Node_Id) return Traverse_Result;
8116       --  Recognize an allocator node and label it as a dynamic coextension
8117
8118       --------------------
8119       -- Mark_Allocator --
8120       --------------------
8121
8122       function Mark_Allocator (N : Node_Id) return Traverse_Result is
8123       begin
8124          if Nkind (N) = N_Allocator then
8125             if Is_Dynamic then
8126                Set_Is_Dynamic_Coextension (N);
8127
8128             --  If the allocator expression is potentially dynamic, it may
8129             --  be expanded out of order and require dynamic allocation
8130             --  anyway, so we treat the coextension itself as dynamic.
8131             --  Potential optimization ???
8132
8133             elsif Nkind (Expression (N)) = N_Qualified_Expression
8134               and then Nkind (Expression (Expression (N))) = N_Op_Concat
8135             then
8136                Set_Is_Dynamic_Coextension (N);
8137
8138             else
8139                Set_Is_Static_Coextension (N);
8140             end if;
8141          end if;
8142
8143          return OK;
8144       end Mark_Allocator;
8145
8146       procedure Mark_Allocators is new Traverse_Proc (Mark_Allocator);
8147
8148    --  Start of processing Mark_Coextensions
8149
8150    begin
8151       case Nkind (Context_Nod) is
8152          when N_Assignment_Statement    |
8153               N_Simple_Return_Statement =>
8154             Is_Dynamic := Nkind (Expression (Context_Nod)) = N_Allocator;
8155
8156          when N_Object_Declaration =>
8157             Is_Dynamic := Nkind (Root_Nod) = N_Allocator;
8158
8159          --  This routine should not be called for constructs which may not
8160          --  contain coextensions.
8161
8162          when others =>
8163             raise Program_Error;
8164       end case;
8165
8166       Mark_Allocators (Root_Nod);
8167    end Mark_Coextensions;
8168
8169    ----------------------
8170    -- Needs_One_Actual --
8171    ----------------------
8172
8173    function Needs_One_Actual (E : Entity_Id) return Boolean is
8174       Formal : Entity_Id;
8175
8176    begin
8177       if Ada_Version >= Ada_2005
8178         and then Present (First_Formal (E))
8179       then
8180          Formal := Next_Formal (First_Formal (E));
8181          while Present (Formal) loop
8182             if No (Default_Value (Formal)) then
8183                return False;
8184             end if;
8185
8186             Next_Formal (Formal);
8187          end loop;
8188
8189          return True;
8190
8191       else
8192          return False;
8193       end if;
8194    end Needs_One_Actual;
8195
8196    ------------------------
8197    -- New_Copy_List_Tree --
8198    ------------------------
8199
8200    function New_Copy_List_Tree (List : List_Id) return List_Id is
8201       NL : List_Id;
8202       E  : Node_Id;
8203
8204    begin
8205       if List = No_List then
8206          return No_List;
8207
8208       else
8209          NL := New_List;
8210          E := First (List);
8211
8212          while Present (E) loop
8213             Append (New_Copy_Tree (E), NL);
8214             E := Next (E);
8215          end loop;
8216
8217          return NL;
8218       end if;
8219    end New_Copy_List_Tree;
8220
8221    -------------------
8222    -- New_Copy_Tree --
8223    -------------------
8224
8225    use Atree.Unchecked_Access;
8226    use Atree_Private_Part;
8227
8228    --  Our approach here requires a two pass traversal of the tree. The
8229    --  first pass visits all nodes that eventually will be copied looking
8230    --  for defining Itypes. If any defining Itypes are found, then they are
8231    --  copied, and an entry is added to the replacement map. In the second
8232    --  phase, the tree is copied, using the replacement map to replace any
8233    --  Itype references within the copied tree.
8234
8235    --  The following hash tables are used if the Map supplied has more
8236    --  than hash threshhold entries to speed up access to the map. If
8237    --  there are fewer entries, then the map is searched sequentially
8238    --  (because setting up a hash table for only a few entries takes
8239    --  more time than it saves.
8240
8241    function New_Copy_Hash (E : Entity_Id) return NCT_Header_Num;
8242    --  Hash function used for hash operations
8243
8244    -------------------
8245    -- New_Copy_Hash --
8246    -------------------
8247
8248    function New_Copy_Hash (E : Entity_Id) return NCT_Header_Num is
8249    begin
8250       return Nat (E) mod (NCT_Header_Num'Last + 1);
8251    end New_Copy_Hash;
8252
8253    ---------------
8254    -- NCT_Assoc --
8255    ---------------
8256
8257    --  The hash table NCT_Assoc associates old entities in the table
8258    --  with their corresponding new entities (i.e. the pairs of entries
8259    --  presented in the original Map argument are Key-Element pairs).
8260
8261    package NCT_Assoc is new Simple_HTable (
8262      Header_Num => NCT_Header_Num,
8263      Element    => Entity_Id,
8264      No_Element => Empty,
8265      Key        => Entity_Id,
8266      Hash       => New_Copy_Hash,
8267      Equal      => Types."=");
8268
8269    ---------------------
8270    -- NCT_Itype_Assoc --
8271    ---------------------
8272
8273    --  The hash table NCT_Itype_Assoc contains entries only for those
8274    --  old nodes which have a non-empty Associated_Node_For_Itype set.
8275    --  The key is the associated node, and the element is the new node
8276    --  itself (NOT the associated node for the new node).
8277
8278    package NCT_Itype_Assoc is new Simple_HTable (
8279      Header_Num => NCT_Header_Num,
8280      Element    => Entity_Id,
8281      No_Element => Empty,
8282      Key        => Entity_Id,
8283      Hash       => New_Copy_Hash,
8284      Equal      => Types."=");
8285
8286    --  Start of processing for New_Copy_Tree function
8287
8288    function New_Copy_Tree
8289      (Source    : Node_Id;
8290       Map       : Elist_Id := No_Elist;
8291       New_Sloc  : Source_Ptr := No_Location;
8292       New_Scope : Entity_Id := Empty) return Node_Id
8293    is
8294       Actual_Map : Elist_Id := Map;
8295       --  This is the actual map for the copy. It is initialized with the
8296       --  given elements, and then enlarged as required for Itypes that are
8297       --  copied during the first phase of the copy operation. The visit
8298       --  procedures add elements to this map as Itypes are encountered.
8299       --  The reason we cannot use Map directly, is that it may well be
8300       --  (and normally is) initialized to No_Elist, and if we have mapped
8301       --  entities, we have to reset it to point to a real Elist.
8302
8303       function Assoc (N : Node_Or_Entity_Id) return Node_Id;
8304       --  Called during second phase to map entities into their corresponding
8305       --  copies using Actual_Map. If the argument is not an entity, or is not
8306       --  in Actual_Map, then it is returned unchanged.
8307
8308       procedure Build_NCT_Hash_Tables;
8309       --  Builds hash tables (number of elements >= threshold value)
8310
8311       function Copy_Elist_With_Replacement
8312         (Old_Elist : Elist_Id) return Elist_Id;
8313       --  Called during second phase to copy element list doing replacements
8314
8315       procedure Copy_Itype_With_Replacement (New_Itype : Entity_Id);
8316       --  Called during the second phase to process a copied Itype. The actual
8317       --  copy happened during the first phase (so that we could make the entry
8318       --  in the mapping), but we still have to deal with the descendents of
8319       --  the copied Itype and copy them where necessary.
8320
8321       function Copy_List_With_Replacement (Old_List : List_Id) return List_Id;
8322       --  Called during second phase to copy list doing replacements
8323
8324       function Copy_Node_With_Replacement (Old_Node : Node_Id) return Node_Id;
8325       --  Called during second phase to copy node doing replacements
8326
8327       procedure Visit_Elist (E : Elist_Id);
8328       --  Called during first phase to visit all elements of an Elist
8329
8330       procedure Visit_Field (F : Union_Id; N : Node_Id);
8331       --  Visit a single field, recursing to call Visit_Node or Visit_List
8332       --  if the field is a syntactic descendent of the current node (i.e.
8333       --  its parent is Node N).
8334
8335       procedure Visit_Itype (Old_Itype : Entity_Id);
8336       --  Called during first phase to visit subsidiary fields of a defining
8337       --  Itype, and also create a copy and make an entry in the replacement
8338       --  map for the new copy.
8339
8340       procedure Visit_List (L : List_Id);
8341       --  Called during first phase to visit all elements of a List
8342
8343       procedure Visit_Node (N : Node_Or_Entity_Id);
8344       --  Called during first phase to visit a node and all its subtrees
8345
8346       -----------
8347       -- Assoc --
8348       -----------
8349
8350       function Assoc (N : Node_Or_Entity_Id) return Node_Id is
8351          E   : Elmt_Id;
8352          Ent : Entity_Id;
8353
8354       begin
8355          if not Has_Extension (N) or else No (Actual_Map) then
8356             return N;
8357
8358          elsif NCT_Hash_Tables_Used then
8359             Ent := NCT_Assoc.Get (Entity_Id (N));
8360
8361             if Present (Ent) then
8362                return Ent;
8363             else
8364                return N;
8365             end if;
8366
8367          --  No hash table used, do serial search
8368
8369          else
8370             E := First_Elmt (Actual_Map);
8371             while Present (E) loop
8372                if Node (E) = N then
8373                   return Node (Next_Elmt (E));
8374                else
8375                   E := Next_Elmt (Next_Elmt (E));
8376                end if;
8377             end loop;
8378          end if;
8379
8380          return N;
8381       end Assoc;
8382
8383       ---------------------------
8384       -- Build_NCT_Hash_Tables --
8385       ---------------------------
8386
8387       procedure Build_NCT_Hash_Tables is
8388          Elmt : Elmt_Id;
8389          Ent  : Entity_Id;
8390       begin
8391          if NCT_Hash_Table_Setup then
8392             NCT_Assoc.Reset;
8393             NCT_Itype_Assoc.Reset;
8394          end if;
8395
8396          Elmt := First_Elmt (Actual_Map);
8397          while Present (Elmt) loop
8398             Ent := Node (Elmt);
8399
8400             --  Get new entity, and associate old and new
8401
8402             Next_Elmt (Elmt);
8403             NCT_Assoc.Set (Ent, Node (Elmt));
8404
8405             if Is_Type (Ent) then
8406                declare
8407                   Anode : constant Entity_Id :=
8408                             Associated_Node_For_Itype (Ent);
8409
8410                begin
8411                   if Present (Anode) then
8412
8413                      --  Enter a link between the associated node of the
8414                      --  old Itype and the new Itype, for updating later
8415                      --  when node is copied.
8416
8417                      NCT_Itype_Assoc.Set (Anode, Node (Elmt));
8418                   end if;
8419                end;
8420             end if;
8421
8422             Next_Elmt (Elmt);
8423          end loop;
8424
8425          NCT_Hash_Tables_Used := True;
8426          NCT_Hash_Table_Setup := True;
8427       end Build_NCT_Hash_Tables;
8428
8429       ---------------------------------
8430       -- Copy_Elist_With_Replacement --
8431       ---------------------------------
8432
8433       function Copy_Elist_With_Replacement
8434         (Old_Elist : Elist_Id) return Elist_Id
8435       is
8436          M         : Elmt_Id;
8437          New_Elist : Elist_Id;
8438
8439       begin
8440          if No (Old_Elist) then
8441             return No_Elist;
8442
8443          else
8444             New_Elist := New_Elmt_List;
8445
8446             M := First_Elmt (Old_Elist);
8447             while Present (M) loop
8448                Append_Elmt (Copy_Node_With_Replacement (Node (M)), New_Elist);
8449                Next_Elmt (M);
8450             end loop;
8451          end if;
8452
8453          return New_Elist;
8454       end Copy_Elist_With_Replacement;
8455
8456       ---------------------------------
8457       -- Copy_Itype_With_Replacement --
8458       ---------------------------------
8459
8460       --  This routine exactly parallels its phase one analog Visit_Itype,
8461
8462       procedure Copy_Itype_With_Replacement (New_Itype : Entity_Id) is
8463       begin
8464          --  Translate Next_Entity, Scope and Etype fields, in case they
8465          --  reference entities that have been mapped into copies.
8466
8467          Set_Next_Entity (New_Itype, Assoc (Next_Entity (New_Itype)));
8468          Set_Etype       (New_Itype, Assoc (Etype       (New_Itype)));
8469
8470          if Present (New_Scope) then
8471             Set_Scope    (New_Itype, New_Scope);
8472          else
8473             Set_Scope    (New_Itype, Assoc (Scope       (New_Itype)));
8474          end if;
8475
8476          --  Copy referenced fields
8477
8478          if Is_Discrete_Type (New_Itype) then
8479             Set_Scalar_Range (New_Itype,
8480               Copy_Node_With_Replacement (Scalar_Range (New_Itype)));
8481
8482          elsif Has_Discriminants (Base_Type (New_Itype)) then
8483             Set_Discriminant_Constraint (New_Itype,
8484               Copy_Elist_With_Replacement
8485                 (Discriminant_Constraint (New_Itype)));
8486
8487          elsif Is_Array_Type (New_Itype) then
8488             if Present (First_Index (New_Itype)) then
8489                Set_First_Index (New_Itype,
8490                  First (Copy_List_With_Replacement
8491                          (List_Containing (First_Index (New_Itype)))));
8492             end if;
8493
8494             if Is_Packed (New_Itype) then
8495                Set_Packed_Array_Type (New_Itype,
8496                  Copy_Node_With_Replacement
8497                    (Packed_Array_Type (New_Itype)));
8498             end if;
8499          end if;
8500       end Copy_Itype_With_Replacement;
8501
8502       --------------------------------
8503       -- Copy_List_With_Replacement --
8504       --------------------------------
8505
8506       function Copy_List_With_Replacement
8507         (Old_List : List_Id) return List_Id
8508       is
8509          New_List : List_Id;
8510          E        : Node_Id;
8511
8512       begin
8513          if Old_List = No_List then
8514             return No_List;
8515
8516          else
8517             New_List := Empty_List;
8518
8519             E := First (Old_List);
8520             while Present (E) loop
8521                Append (Copy_Node_With_Replacement (E), New_List);
8522                Next (E);
8523             end loop;
8524
8525             return New_List;
8526          end if;
8527       end Copy_List_With_Replacement;
8528
8529       --------------------------------
8530       -- Copy_Node_With_Replacement --
8531       --------------------------------
8532
8533       function Copy_Node_With_Replacement
8534         (Old_Node : Node_Id) return Node_Id
8535       is
8536          New_Node : Node_Id;
8537
8538          procedure Adjust_Named_Associations
8539            (Old_Node : Node_Id;
8540             New_Node : Node_Id);
8541          --  If a call node has named associations, these are chained through
8542          --  the First_Named_Actual, Next_Named_Actual links. These must be
8543          --  propagated separately to the new parameter list, because these
8544          --  are not syntactic fields.
8545
8546          function Copy_Field_With_Replacement
8547            (Field : Union_Id) return Union_Id;
8548          --  Given Field, which is a field of Old_Node, return a copy of it
8549          --  if it is a syntactic field (i.e. its parent is Node), setting
8550          --  the parent of the copy to poit to New_Node. Otherwise returns
8551          --  the field (possibly mapped if it is an entity).
8552
8553          -------------------------------
8554          -- Adjust_Named_Associations --
8555          -------------------------------
8556
8557          procedure Adjust_Named_Associations
8558            (Old_Node : Node_Id;
8559             New_Node : Node_Id)
8560          is
8561             Old_E : Node_Id;
8562             New_E : Node_Id;
8563
8564             Old_Next : Node_Id;
8565             New_Next : Node_Id;
8566
8567          begin
8568             Old_E := First (Parameter_Associations (Old_Node));
8569             New_E := First (Parameter_Associations (New_Node));
8570             while Present (Old_E) loop
8571                if Nkind (Old_E) = N_Parameter_Association
8572                  and then Present (Next_Named_Actual (Old_E))
8573                then
8574                   if First_Named_Actual (Old_Node)
8575                     =  Explicit_Actual_Parameter (Old_E)
8576                   then
8577                      Set_First_Named_Actual
8578                        (New_Node, Explicit_Actual_Parameter (New_E));
8579                   end if;
8580
8581                   --  Now scan parameter list from the beginning,to locate
8582                   --  next named actual, which can be out of order.
8583
8584                   Old_Next := First (Parameter_Associations (Old_Node));
8585                   New_Next := First (Parameter_Associations (New_Node));
8586
8587                   while Nkind (Old_Next) /= N_Parameter_Association
8588                     or else  Explicit_Actual_Parameter (Old_Next)
8589                       /= Next_Named_Actual (Old_E)
8590                   loop
8591                      Next (Old_Next);
8592                      Next (New_Next);
8593                   end loop;
8594
8595                   Set_Next_Named_Actual
8596                     (New_E, Explicit_Actual_Parameter (New_Next));
8597                end if;
8598
8599                Next (Old_E);
8600                Next (New_E);
8601             end loop;
8602          end Adjust_Named_Associations;
8603
8604          ---------------------------------
8605          -- Copy_Field_With_Replacement --
8606          ---------------------------------
8607
8608          function Copy_Field_With_Replacement
8609            (Field : Union_Id) return Union_Id
8610          is
8611          begin
8612             if Field = Union_Id (Empty) then
8613                return Field;
8614
8615             elsif Field in Node_Range then
8616                declare
8617                   Old_N : constant Node_Id := Node_Id (Field);
8618                   New_N : Node_Id;
8619
8620                begin
8621                   --  If syntactic field, as indicated by the parent pointer
8622                   --  being set, then copy the referenced node recursively.
8623
8624                   if Parent (Old_N) = Old_Node then
8625                      New_N := Copy_Node_With_Replacement (Old_N);
8626
8627                      if New_N /= Old_N then
8628                         Set_Parent (New_N, New_Node);
8629                      end if;
8630
8631                   --  For semantic fields, update possible entity reference
8632                   --  from the replacement map.
8633
8634                   else
8635                      New_N := Assoc (Old_N);
8636                   end if;
8637
8638                   return Union_Id (New_N);
8639                end;
8640
8641             elsif Field in List_Range then
8642                declare
8643                   Old_L : constant List_Id := List_Id (Field);
8644                   New_L : List_Id;
8645
8646                begin
8647                   --  If syntactic field, as indicated by the parent pointer,
8648                   --  then recursively copy the entire referenced list.
8649
8650                   if Parent (Old_L) = Old_Node then
8651                      New_L := Copy_List_With_Replacement (Old_L);
8652                      Set_Parent (New_L, New_Node);
8653
8654                   --  For semantic list, just returned unchanged
8655
8656                   else
8657                      New_L := Old_L;
8658                   end if;
8659
8660                   return Union_Id (New_L);
8661                end;
8662
8663             --  Anything other than a list or a node is returned unchanged
8664
8665             else
8666                return Field;
8667             end if;
8668          end Copy_Field_With_Replacement;
8669
8670       --  Start of processing for Copy_Node_With_Replacement
8671
8672       begin
8673          if Old_Node <= Empty_Or_Error then
8674             return Old_Node;
8675
8676          elsif Has_Extension (Old_Node) then
8677             return Assoc (Old_Node);
8678
8679          else
8680             New_Node := New_Copy (Old_Node);
8681
8682             --  If the node we are copying is the associated node of a
8683             --  previously copied Itype, then adjust the associated node
8684             --  of the copy of that Itype accordingly.
8685
8686             if Present (Actual_Map) then
8687                declare
8688                   E   : Elmt_Id;
8689                   Ent : Entity_Id;
8690
8691                begin
8692                   --  Case of hash table used
8693
8694                   if NCT_Hash_Tables_Used then
8695                      Ent := NCT_Itype_Assoc.Get (Old_Node);
8696
8697                      if Present (Ent) then
8698                         Set_Associated_Node_For_Itype (Ent, New_Node);
8699                      end if;
8700
8701                   --  Case of no hash table used
8702
8703                   else
8704                      E := First_Elmt (Actual_Map);
8705                      while Present (E) loop
8706                         if Is_Itype (Node (E))
8707                           and then
8708                             Old_Node = Associated_Node_For_Itype (Node (E))
8709                         then
8710                            Set_Associated_Node_For_Itype
8711                              (Node (Next_Elmt (E)), New_Node);
8712                         end if;
8713
8714                         E := Next_Elmt (Next_Elmt (E));
8715                      end loop;
8716                   end if;
8717                end;
8718             end if;
8719
8720             --  Recursively copy descendents
8721
8722             Set_Field1
8723               (New_Node, Copy_Field_With_Replacement (Field1 (New_Node)));
8724             Set_Field2
8725               (New_Node, Copy_Field_With_Replacement (Field2 (New_Node)));
8726             Set_Field3
8727               (New_Node, Copy_Field_With_Replacement (Field3 (New_Node)));
8728             Set_Field4
8729               (New_Node, Copy_Field_With_Replacement (Field4 (New_Node)));
8730             Set_Field5
8731               (New_Node, Copy_Field_With_Replacement (Field5 (New_Node)));
8732
8733             --  Adjust Sloc of new node if necessary
8734
8735             if New_Sloc /= No_Location then
8736                Set_Sloc (New_Node, New_Sloc);
8737
8738                --  If we adjust the Sloc, then we are essentially making
8739                --  a completely new node, so the Comes_From_Source flag
8740                --  should be reset to the proper default value.
8741
8742                Nodes.Table (New_Node).Comes_From_Source :=
8743                  Default_Node.Comes_From_Source;
8744             end if;
8745
8746             --  If the node is call and has named associations,
8747             --  set the corresponding links in the copy.
8748
8749             if (Nkind (Old_Node) = N_Function_Call
8750                  or else Nkind (Old_Node) = N_Entry_Call_Statement
8751                  or else
8752                    Nkind (Old_Node) = N_Procedure_Call_Statement)
8753               and then Present (First_Named_Actual (Old_Node))
8754             then
8755                Adjust_Named_Associations (Old_Node, New_Node);
8756             end if;
8757
8758             --  Reset First_Real_Statement for Handled_Sequence_Of_Statements.
8759             --  The replacement mechanism applies to entities, and is not used
8760             --  here. Eventually we may need a more general graph-copying
8761             --  routine. For now, do a sequential search to find desired node.
8762
8763             if Nkind (Old_Node) = N_Handled_Sequence_Of_Statements
8764               and then Present (First_Real_Statement (Old_Node))
8765             then
8766                declare
8767                   Old_F  : constant Node_Id := First_Real_Statement (Old_Node);
8768                   N1, N2 : Node_Id;
8769
8770                begin
8771                   N1 := First (Statements (Old_Node));
8772                   N2 := First (Statements (New_Node));
8773
8774                   while N1 /= Old_F loop
8775                      Next (N1);
8776                      Next (N2);
8777                   end loop;
8778
8779                   Set_First_Real_Statement (New_Node, N2);
8780                end;
8781             end if;
8782          end if;
8783
8784          --  All done, return copied node
8785
8786          return New_Node;
8787       end Copy_Node_With_Replacement;
8788
8789       -----------------
8790       -- Visit_Elist --
8791       -----------------
8792
8793       procedure Visit_Elist (E : Elist_Id) is
8794          Elmt : Elmt_Id;
8795       begin
8796          if Present (E) then
8797             Elmt := First_Elmt (E);
8798
8799             while Elmt /= No_Elmt loop
8800                Visit_Node (Node (Elmt));
8801                Next_Elmt (Elmt);
8802             end loop;
8803          end if;
8804       end Visit_Elist;
8805
8806       -----------------
8807       -- Visit_Field --
8808       -----------------
8809
8810       procedure Visit_Field (F : Union_Id; N : Node_Id) is
8811       begin
8812          if F = Union_Id (Empty) then
8813             return;
8814
8815          elsif F in Node_Range then
8816
8817             --  Copy node if it is syntactic, i.e. its parent pointer is
8818             --  set to point to the field that referenced it (certain
8819             --  Itypes will also meet this criterion, which is fine, since
8820             --  these are clearly Itypes that do need to be copied, since
8821             --  we are copying their parent.)
8822
8823             if Parent (Node_Id (F)) = N then
8824                Visit_Node (Node_Id (F));
8825                return;
8826
8827             --  Another case, if we are pointing to an Itype, then we want
8828             --  to copy it if its associated node is somewhere in the tree
8829             --  being copied.
8830
8831             --  Note: the exclusion of self-referential copies is just an
8832             --  optimization, since the search of the already copied list
8833             --  would catch it, but it is a common case (Etype pointing
8834             --  to itself for an Itype that is a base type).
8835
8836             elsif Has_Extension (Node_Id (F))
8837               and then Is_Itype (Entity_Id (F))
8838               and then Node_Id (F) /= N
8839             then
8840                declare
8841                   P : Node_Id;
8842
8843                begin
8844                   P := Associated_Node_For_Itype (Node_Id (F));
8845                   while Present (P) loop
8846                      if P = Source then
8847                         Visit_Node (Node_Id (F));
8848                         return;
8849                      else
8850                         P := Parent (P);
8851                      end if;
8852                   end loop;
8853
8854                   --  An Itype whose parent is not being copied definitely
8855                   --  should NOT be copied, since it does not belong in any
8856                   --  sense to the copied subtree.
8857
8858                   return;
8859                end;
8860             end if;
8861
8862          elsif F in List_Range
8863            and then Parent (List_Id (F)) = N
8864          then
8865             Visit_List (List_Id (F));
8866             return;
8867          end if;
8868       end Visit_Field;
8869
8870       -----------------
8871       -- Visit_Itype --
8872       -----------------
8873
8874       procedure Visit_Itype (Old_Itype : Entity_Id) is
8875          New_Itype : Entity_Id;
8876          E         : Elmt_Id;
8877          Ent       : Entity_Id;
8878
8879       begin
8880          --  Itypes that describe the designated type of access to subprograms
8881          --  have the structure of subprogram declarations, with signatures,
8882          --  etc. Either we duplicate the signatures completely, or choose to
8883          --  share such itypes, which is fine because their elaboration will
8884          --  have no side effects.
8885
8886          if Ekind (Old_Itype) = E_Subprogram_Type then
8887             return;
8888          end if;
8889
8890          New_Itype := New_Copy (Old_Itype);
8891
8892          --  The new Itype has all the attributes of the old one, and
8893          --  we just copy the contents of the entity. However, the back-end
8894          --  needs different names for debugging purposes, so we create a
8895          --  new internal name for it in all cases.
8896
8897          Set_Chars (New_Itype, New_Internal_Name ('T'));
8898
8899          --  If our associated node is an entity that has already been copied,
8900          --  then set the associated node of the copy to point to the right
8901          --  copy. If we have copied an Itype that is itself the associated
8902          --  node of some previously copied Itype, then we set the right
8903          --  pointer in the other direction.
8904
8905          if Present (Actual_Map) then
8906
8907             --  Case of hash tables used
8908
8909             if NCT_Hash_Tables_Used then
8910
8911                Ent := NCT_Assoc.Get (Associated_Node_For_Itype (Old_Itype));
8912
8913                if Present (Ent) then
8914                   Set_Associated_Node_For_Itype (New_Itype, Ent);
8915                end if;
8916
8917                Ent := NCT_Itype_Assoc.Get (Old_Itype);
8918                if Present (Ent) then
8919                   Set_Associated_Node_For_Itype (Ent, New_Itype);
8920
8921                --  If the hash table has no association for this Itype and
8922                --  its associated node, enter one now.
8923
8924                else
8925                   NCT_Itype_Assoc.Set
8926                     (Associated_Node_For_Itype (Old_Itype), New_Itype);
8927                end if;
8928
8929             --  Case of hash tables not used
8930
8931             else
8932                E := First_Elmt (Actual_Map);
8933                while Present (E) loop
8934                   if Associated_Node_For_Itype (Old_Itype) = Node (E) then
8935                      Set_Associated_Node_For_Itype
8936                        (New_Itype, Node (Next_Elmt (E)));
8937                   end if;
8938
8939                   if Is_Type (Node (E))
8940                     and then
8941                       Old_Itype = Associated_Node_For_Itype (Node (E))
8942                   then
8943                      Set_Associated_Node_For_Itype
8944                        (Node (Next_Elmt (E)), New_Itype);
8945                   end if;
8946
8947                   E := Next_Elmt (Next_Elmt (E));
8948                end loop;
8949             end if;
8950          end if;
8951
8952          if Present (Freeze_Node (New_Itype)) then
8953             Set_Is_Frozen (New_Itype, False);
8954             Set_Freeze_Node (New_Itype, Empty);
8955          end if;
8956
8957          --  Add new association to map
8958
8959          if No (Actual_Map) then
8960             Actual_Map := New_Elmt_List;
8961          end if;
8962
8963          Append_Elmt (Old_Itype, Actual_Map);
8964          Append_Elmt (New_Itype, Actual_Map);
8965
8966          if NCT_Hash_Tables_Used then
8967             NCT_Assoc.Set (Old_Itype, New_Itype);
8968
8969          else
8970             NCT_Table_Entries := NCT_Table_Entries + 1;
8971
8972             if NCT_Table_Entries > NCT_Hash_Threshhold then
8973                Build_NCT_Hash_Tables;
8974             end if;
8975          end if;
8976
8977          --  If a record subtype is simply copied, the entity list will be
8978          --  shared. Thus cloned_Subtype must be set to indicate the sharing.
8979
8980          if Ekind_In (Old_Itype, E_Record_Subtype, E_Class_Wide_Subtype) then
8981             Set_Cloned_Subtype (New_Itype, Old_Itype);
8982          end if;
8983
8984          --  Visit descendents that eventually get copied
8985
8986          Visit_Field (Union_Id (Etype (Old_Itype)), Old_Itype);
8987
8988          if Is_Discrete_Type (Old_Itype) then
8989             Visit_Field (Union_Id (Scalar_Range (Old_Itype)), Old_Itype);
8990
8991          elsif Has_Discriminants (Base_Type (Old_Itype)) then
8992             --  ??? This should involve call to Visit_Field
8993             Visit_Elist (Discriminant_Constraint (Old_Itype));
8994
8995          elsif Is_Array_Type (Old_Itype) then
8996             if Present (First_Index (Old_Itype)) then
8997                Visit_Field (Union_Id (List_Containing
8998                                 (First_Index (Old_Itype))),
8999                             Old_Itype);
9000             end if;
9001
9002             if Is_Packed (Old_Itype) then
9003                Visit_Field (Union_Id (Packed_Array_Type (Old_Itype)),
9004                             Old_Itype);
9005             end if;
9006          end if;
9007       end Visit_Itype;
9008
9009       ----------------
9010       -- Visit_List --
9011       ----------------
9012
9013       procedure Visit_List (L : List_Id) is
9014          N : Node_Id;
9015       begin
9016          if L /= No_List then
9017             N := First (L);
9018
9019             while Present (N) loop
9020                Visit_Node (N);
9021                Next (N);
9022             end loop;
9023          end if;
9024       end Visit_List;
9025
9026       ----------------
9027       -- Visit_Node --
9028       ----------------
9029
9030       procedure Visit_Node (N : Node_Or_Entity_Id) is
9031
9032       --  Start of processing for Visit_Node
9033
9034       begin
9035          --  Handle case of an Itype, which must be copied
9036
9037          if Has_Extension (N)
9038            and then Is_Itype (N)
9039          then
9040             --  Nothing to do if already in the list. This can happen with an
9041             --  Itype entity that appears more than once in the tree.
9042             --  Note that we do not want to visit descendents in this case.
9043
9044             --  Test for already in list when hash table is used
9045
9046             if NCT_Hash_Tables_Used then
9047                if Present (NCT_Assoc.Get (Entity_Id (N))) then
9048                   return;
9049                end if;
9050
9051             --  Test for already in list when hash table not used
9052
9053             else
9054                declare
9055                   E : Elmt_Id;
9056                begin
9057                   if Present (Actual_Map) then
9058                      E := First_Elmt (Actual_Map);
9059                      while Present (E) loop
9060                         if Node (E) = N then
9061                            return;
9062                         else
9063                            E := Next_Elmt (Next_Elmt (E));
9064                         end if;
9065                      end loop;
9066                   end if;
9067                end;
9068             end if;
9069
9070             Visit_Itype (N);
9071          end if;
9072
9073          --  Visit descendents
9074
9075          Visit_Field (Field1 (N), N);
9076          Visit_Field (Field2 (N), N);
9077          Visit_Field (Field3 (N), N);
9078          Visit_Field (Field4 (N), N);
9079          Visit_Field (Field5 (N), N);
9080       end Visit_Node;
9081
9082    --  Start of processing for New_Copy_Tree
9083
9084    begin
9085       Actual_Map := Map;
9086
9087       --  See if we should use hash table
9088
9089       if No (Actual_Map) then
9090          NCT_Hash_Tables_Used := False;
9091
9092       else
9093          declare
9094             Elmt : Elmt_Id;
9095
9096          begin
9097             NCT_Table_Entries := 0;
9098
9099             Elmt := First_Elmt (Actual_Map);
9100             while Present (Elmt) loop
9101                NCT_Table_Entries := NCT_Table_Entries + 1;
9102                Next_Elmt (Elmt);
9103                Next_Elmt (Elmt);
9104             end loop;
9105
9106             if NCT_Table_Entries > NCT_Hash_Threshhold then
9107                Build_NCT_Hash_Tables;
9108             else
9109                NCT_Hash_Tables_Used := False;
9110             end if;
9111          end;
9112       end if;
9113
9114       --  Hash table set up if required, now start phase one by visiting
9115       --  top node (we will recursively visit the descendents).
9116
9117       Visit_Node (Source);
9118
9119       --  Now the second phase of the copy can start. First we process
9120       --  all the mapped entities, copying their descendents.
9121
9122       if Present (Actual_Map) then
9123          declare
9124             Elmt      : Elmt_Id;
9125             New_Itype : Entity_Id;
9126          begin
9127             Elmt := First_Elmt (Actual_Map);
9128             while Present (Elmt) loop
9129                Next_Elmt (Elmt);
9130                New_Itype := Node (Elmt);
9131                Copy_Itype_With_Replacement (New_Itype);
9132                Next_Elmt (Elmt);
9133             end loop;
9134          end;
9135       end if;
9136
9137       --  Now we can copy the actual tree
9138
9139       return Copy_Node_With_Replacement (Source);
9140    end New_Copy_Tree;
9141
9142    -------------------------
9143    -- New_External_Entity --
9144    -------------------------
9145
9146    function New_External_Entity
9147      (Kind         : Entity_Kind;
9148       Scope_Id     : Entity_Id;
9149       Sloc_Value   : Source_Ptr;
9150       Related_Id   : Entity_Id;
9151       Suffix       : Character;
9152       Suffix_Index : Nat := 0;
9153       Prefix       : Character := ' ') return Entity_Id
9154    is
9155       N : constant Entity_Id :=
9156             Make_Defining_Identifier (Sloc_Value,
9157               New_External_Name
9158                 (Chars (Related_Id), Suffix, Suffix_Index, Prefix));
9159
9160    begin
9161       Set_Ekind          (N, Kind);
9162       Set_Is_Internal    (N, True);
9163       Append_Entity      (N, Scope_Id);
9164       Set_Public_Status  (N);
9165
9166       if Kind in Type_Kind then
9167          Init_Size_Align (N);
9168       end if;
9169
9170       return N;
9171    end New_External_Entity;
9172
9173    -------------------------
9174    -- New_Internal_Entity --
9175    -------------------------
9176
9177    function New_Internal_Entity
9178      (Kind       : Entity_Kind;
9179       Scope_Id   : Entity_Id;
9180       Sloc_Value : Source_Ptr;
9181       Id_Char    : Character) return Entity_Id
9182    is
9183       N : constant Entity_Id := Make_Temporary (Sloc_Value, Id_Char);
9184
9185    begin
9186       Set_Ekind          (N, Kind);
9187       Set_Is_Internal    (N, True);
9188       Append_Entity      (N, Scope_Id);
9189
9190       if Kind in Type_Kind then
9191          Init_Size_Align (N);
9192       end if;
9193
9194       return N;
9195    end New_Internal_Entity;
9196
9197    -----------------
9198    -- Next_Actual --
9199    -----------------
9200
9201    function Next_Actual (Actual_Id : Node_Id) return Node_Id is
9202       N  : Node_Id;
9203
9204    begin
9205       --  If we are pointing at a positional parameter, it is a member of a
9206       --  node list (the list of parameters), and the next parameter is the
9207       --  next node on the list, unless we hit a parameter association, then
9208       --  we shift to using the chain whose head is the First_Named_Actual in
9209       --  the parent, and then is threaded using the Next_Named_Actual of the
9210       --  Parameter_Association. All this fiddling is because the original node
9211       --  list is in the textual call order, and what we need is the
9212       --  declaration order.
9213
9214       if Is_List_Member (Actual_Id) then
9215          N := Next (Actual_Id);
9216
9217          if Nkind (N) = N_Parameter_Association then
9218             return First_Named_Actual (Parent (Actual_Id));
9219          else
9220             return N;
9221          end if;
9222
9223       else
9224          return Next_Named_Actual (Parent (Actual_Id));
9225       end if;
9226    end Next_Actual;
9227
9228    procedure Next_Actual (Actual_Id : in out Node_Id) is
9229    begin
9230       Actual_Id := Next_Actual (Actual_Id);
9231    end Next_Actual;
9232
9233    -----------------------
9234    -- Normalize_Actuals --
9235    -----------------------
9236
9237    --  Chain actuals according to formals of subprogram. If there are no named
9238    --  associations, the chain is simply the list of Parameter Associations,
9239    --  since the order is the same as the declaration order. If there are named
9240    --  associations, then the First_Named_Actual field in the N_Function_Call
9241    --  or N_Procedure_Call_Statement node points to the Parameter_Association
9242    --  node for the parameter that comes first in declaration order. The
9243    --  remaining named parameters are then chained in declaration order using
9244    --  Next_Named_Actual.
9245
9246    --  This routine also verifies that the number of actuals is compatible with
9247    --  the number and default values of formals, but performs no type checking
9248    --  (type checking is done by the caller).
9249
9250    --  If the matching succeeds, Success is set to True and the caller proceeds
9251    --  with type-checking. If the match is unsuccessful, then Success is set to
9252    --  False, and the caller attempts a different interpretation, if there is
9253    --  one.
9254
9255    --  If the flag Report is on, the call is not overloaded, and a failure to
9256    --  match can be reported here, rather than in the caller.
9257
9258    procedure Normalize_Actuals
9259      (N       : Node_Id;
9260       S       : Entity_Id;
9261       Report  : Boolean;
9262       Success : out Boolean)
9263    is
9264       Actuals     : constant List_Id := Parameter_Associations (N);
9265       Actual      : Node_Id := Empty;
9266       Formal      : Entity_Id;
9267       Last        : Node_Id := Empty;
9268       First_Named : Node_Id := Empty;
9269       Found       : Boolean;
9270
9271       Formals_To_Match : Integer := 0;
9272       Actuals_To_Match : Integer := 0;
9273
9274       procedure Chain (A : Node_Id);
9275       --  Add named actual at the proper place in the list, using the
9276       --  Next_Named_Actual link.
9277
9278       function Reporting return Boolean;
9279       --  Determines if an error is to be reported. To report an error, we
9280       --  need Report to be True, and also we do not report errors caused
9281       --  by calls to init procs that occur within other init procs. Such
9282       --  errors must always be cascaded errors, since if all the types are
9283       --  declared correctly, the compiler will certainly build decent calls!
9284
9285       -----------
9286       -- Chain --
9287       -----------
9288
9289       procedure Chain (A : Node_Id) is
9290       begin
9291          if No (Last) then
9292
9293             --  Call node points to first actual in list
9294
9295             Set_First_Named_Actual (N, Explicit_Actual_Parameter (A));
9296
9297          else
9298             Set_Next_Named_Actual (Last, Explicit_Actual_Parameter (A));
9299          end if;
9300
9301          Last := A;
9302          Set_Next_Named_Actual (Last, Empty);
9303       end Chain;
9304
9305       ---------------
9306       -- Reporting --
9307       ---------------
9308
9309       function Reporting return Boolean is
9310       begin
9311          if not Report then
9312             return False;
9313
9314          elsif not Within_Init_Proc then
9315             return True;
9316
9317          elsif Is_Init_Proc (Entity (Name (N))) then
9318             return False;
9319
9320          else
9321             return True;
9322          end if;
9323       end Reporting;
9324
9325    --  Start of processing for Normalize_Actuals
9326
9327    begin
9328       if Is_Access_Type (S) then
9329
9330          --  The name in the call is a function call that returns an access
9331          --  to subprogram. The designated type has the list of formals.
9332
9333          Formal := First_Formal (Designated_Type (S));
9334       else
9335          Formal := First_Formal (S);
9336       end if;
9337
9338       while Present (Formal) loop
9339          Formals_To_Match := Formals_To_Match + 1;
9340          Next_Formal (Formal);
9341       end loop;
9342
9343       --  Find if there is a named association, and verify that no positional
9344       --  associations appear after named ones.
9345
9346       if Present (Actuals) then
9347          Actual := First (Actuals);
9348       end if;
9349
9350       while Present (Actual)
9351         and then Nkind (Actual) /= N_Parameter_Association
9352       loop
9353          Actuals_To_Match := Actuals_To_Match + 1;
9354          Next (Actual);
9355       end loop;
9356
9357       if No (Actual) and Actuals_To_Match = Formals_To_Match then
9358
9359          --  Most common case: positional notation, no defaults
9360
9361          Success := True;
9362          return;
9363
9364       elsif Actuals_To_Match > Formals_To_Match then
9365
9366          --  Too many actuals: will not work
9367
9368          if Reporting then
9369             if Is_Entity_Name (Name (N)) then
9370                Error_Msg_N ("too many arguments in call to&", Name (N));
9371             else
9372                Error_Msg_N ("too many arguments in call", N);
9373             end if;
9374          end if;
9375
9376          Success := False;
9377          return;
9378       end if;
9379
9380       First_Named := Actual;
9381
9382       while Present (Actual) loop
9383          if Nkind (Actual) /= N_Parameter_Association then
9384             Error_Msg_N
9385               ("positional parameters not allowed after named ones", Actual);
9386             Success := False;
9387             return;
9388
9389          else
9390             Actuals_To_Match := Actuals_To_Match + 1;
9391          end if;
9392
9393          Next (Actual);
9394       end loop;
9395
9396       if Present (Actuals) then
9397          Actual := First (Actuals);
9398       end if;
9399
9400       Formal := First_Formal (S);
9401       while Present (Formal) loop
9402
9403          --  Match the formals in order. If the corresponding actual is
9404          --  positional, nothing to do. Else scan the list of named actuals
9405          --  to find the one with the right name.
9406
9407          if Present (Actual)
9408            and then Nkind (Actual) /= N_Parameter_Association
9409          then
9410             Next (Actual);
9411             Actuals_To_Match := Actuals_To_Match - 1;
9412             Formals_To_Match := Formals_To_Match - 1;
9413
9414          else
9415             --  For named parameters, search the list of actuals to find
9416             --  one that matches the next formal name.
9417
9418             Actual := First_Named;
9419             Found  := False;
9420             while Present (Actual) loop
9421                if Chars (Selector_Name (Actual)) = Chars (Formal) then
9422                   Found := True;
9423                   Chain (Actual);
9424                   Actuals_To_Match := Actuals_To_Match - 1;
9425                   Formals_To_Match := Formals_To_Match - 1;
9426                   exit;
9427                end if;
9428
9429                Next (Actual);
9430             end loop;
9431
9432             if not Found then
9433                if Ekind (Formal) /= E_In_Parameter
9434                  or else No (Default_Value (Formal))
9435                then
9436                   if Reporting then
9437                      if (Comes_From_Source (S)
9438                           or else Sloc (S) = Standard_Location)
9439                        and then Is_Overloadable (S)
9440                      then
9441                         if No (Actuals)
9442                           and then
9443                            (Nkind (Parent (N)) = N_Procedure_Call_Statement
9444                              or else
9445                            (Nkind (Parent (N)) = N_Function_Call
9446                              or else
9447                             Nkind (Parent (N)) = N_Parameter_Association))
9448                           and then Ekind (S) /= E_Function
9449                         then
9450                            Set_Etype (N, Etype (S));
9451                         else
9452                            Error_Msg_Name_1 := Chars (S);
9453                            Error_Msg_Sloc := Sloc (S);
9454                            Error_Msg_NE
9455                              ("missing argument for parameter & " &
9456                                 "in call to % declared #", N, Formal);
9457                         end if;
9458
9459                      elsif Is_Overloadable (S) then
9460                         Error_Msg_Name_1 := Chars (S);
9461
9462                         --  Point to type derivation that generated the
9463                         --  operation.
9464
9465                         Error_Msg_Sloc := Sloc (Parent (S));
9466
9467                         Error_Msg_NE
9468                           ("missing argument for parameter & " &
9469                              "in call to % (inherited) #", N, Formal);
9470
9471                      else
9472                         Error_Msg_NE
9473                           ("missing argument for parameter &", N, Formal);
9474                      end if;
9475                   end if;
9476
9477                   Success := False;
9478                   return;
9479
9480                else
9481                   Formals_To_Match := Formals_To_Match - 1;
9482                end if;
9483             end if;
9484          end if;
9485
9486          Next_Formal (Formal);
9487       end loop;
9488
9489       if Formals_To_Match = 0 and then Actuals_To_Match = 0 then
9490          Success := True;
9491          return;
9492
9493       else
9494          if Reporting then
9495
9496             --  Find some superfluous named actual that did not get
9497             --  attached to the list of associations.
9498
9499             Actual := First (Actuals);
9500             while Present (Actual) loop
9501                if Nkind (Actual) = N_Parameter_Association
9502                  and then Actual /= Last
9503                  and then No (Next_Named_Actual (Actual))
9504                then
9505                   Error_Msg_N ("unmatched actual & in call",
9506                     Selector_Name (Actual));
9507                   exit;
9508                end if;
9509
9510                Next (Actual);
9511             end loop;
9512          end if;
9513
9514          Success := False;
9515          return;
9516       end if;
9517    end Normalize_Actuals;
9518
9519    --------------------------------
9520    -- Note_Possible_Modification --
9521    --------------------------------
9522
9523    procedure Note_Possible_Modification (N : Node_Id; Sure : Boolean) is
9524       Modification_Comes_From_Source : constant Boolean :=
9525                                          Comes_From_Source (Parent (N));
9526
9527       Ent : Entity_Id;
9528       Exp : Node_Id;
9529
9530    begin
9531       --  Loop to find referenced entity, if there is one
9532
9533       Exp := N;
9534       loop
9535          <<Continue>>
9536          Ent := Empty;
9537
9538          if Is_Entity_Name (Exp) then
9539             Ent := Entity (Exp);
9540
9541             --  If the entity is missing, it is an undeclared identifier,
9542             --  and there is nothing to annotate.
9543
9544             if No (Ent) then
9545                return;
9546             end if;
9547
9548          elsif Nkind (Exp) = N_Explicit_Dereference then
9549             declare
9550                P : constant Node_Id := Prefix (Exp);
9551
9552             begin
9553                if Nkind (P) = N_Selected_Component
9554                  and then Present (
9555                    Entry_Formal (Entity (Selector_Name (P))))
9556                then
9557                   --  Case of a reference to an entry formal
9558
9559                   Ent := Entry_Formal (Entity (Selector_Name (P)));
9560
9561                elsif Nkind (P) = N_Identifier
9562                  and then Nkind (Parent (Entity (P))) = N_Object_Declaration
9563                  and then Present (Expression (Parent (Entity (P))))
9564                  and then Nkind (Expression (Parent (Entity (P))))
9565                    = N_Reference
9566                then
9567                   --  Case of a reference to a value on which side effects have
9568                   --  been removed.
9569
9570                   Exp := Prefix (Expression (Parent (Entity (P))));
9571                   goto Continue;
9572
9573                else
9574                   return;
9575
9576                end if;
9577             end;
9578
9579          elsif     Nkind (Exp) = N_Type_Conversion
9580            or else Nkind (Exp) = N_Unchecked_Type_Conversion
9581          then
9582             Exp := Expression (Exp);
9583             goto Continue;
9584
9585          elsif     Nkind (Exp) = N_Slice
9586            or else Nkind (Exp) = N_Indexed_Component
9587            or else Nkind (Exp) = N_Selected_Component
9588          then
9589             Exp := Prefix (Exp);
9590             goto Continue;
9591
9592          else
9593             return;
9594          end if;
9595
9596          --  Now look for entity being referenced
9597
9598          if Present (Ent) then
9599             if Is_Object (Ent) then
9600                if Comes_From_Source (Exp)
9601                  or else Modification_Comes_From_Source
9602                then
9603                   --  Give warning if pragma unmodified given and we are
9604                   --  sure this is a modification.
9605
9606                   if Has_Pragma_Unmodified (Ent) and then Sure then
9607                      Error_Msg_NE ("?pragma Unmodified given for &!", N, Ent);
9608                   end if;
9609
9610                   Set_Never_Set_In_Source (Ent, False);
9611                end if;
9612
9613                Set_Is_True_Constant (Ent, False);
9614                Set_Current_Value    (Ent, Empty);
9615                Set_Is_Known_Null    (Ent, False);
9616
9617                if not Can_Never_Be_Null (Ent) then
9618                   Set_Is_Known_Non_Null (Ent, False);
9619                end if;
9620
9621                --  Follow renaming chain
9622
9623                if (Ekind (Ent) = E_Variable or else Ekind (Ent) = E_Constant)
9624                  and then Present (Renamed_Object (Ent))
9625                then
9626                   Exp := Renamed_Object (Ent);
9627                   goto Continue;
9628                end if;
9629
9630                --  Generate a reference only if the assignment comes from
9631                --  source. This excludes, for example, calls to a dispatching
9632                --  assignment operation when the left-hand side is tagged.
9633
9634                if Modification_Comes_From_Source then
9635                   Generate_Reference (Ent, Exp, 'm');
9636                end if;
9637
9638                Check_Nested_Access (Ent);
9639             end if;
9640
9641             Kill_Checks (Ent);
9642
9643             --  If we are sure this is a modification from source, and we know
9644             --  this modifies a constant, then give an appropriate warning.
9645
9646             if Overlays_Constant (Ent)
9647               and then Modification_Comes_From_Source
9648               and then Sure
9649             then
9650                declare
9651                   A : constant Node_Id := Address_Clause (Ent);
9652                begin
9653                   if Present (A) then
9654                      declare
9655                         Exp : constant Node_Id := Expression (A);
9656                      begin
9657                         if Nkind (Exp) = N_Attribute_Reference
9658                           and then Attribute_Name (Exp) = Name_Address
9659                           and then Is_Entity_Name (Prefix (Exp))
9660                         then
9661                            Error_Msg_Sloc := Sloc (A);
9662                            Error_Msg_NE
9663                              ("constant& may be modified via address clause#?",
9664                               N, Entity (Prefix (Exp)));
9665                         end if;
9666                      end;
9667                   end if;
9668                end;
9669             end if;
9670
9671             return;
9672          end if;
9673       end loop;
9674    end Note_Possible_Modification;
9675
9676    -------------------------
9677    -- Object_Access_Level --
9678    -------------------------
9679
9680    function Object_Access_Level (Obj : Node_Id) return Uint is
9681       E : Entity_Id;
9682
9683    --  Returns the static accessibility level of the view denoted by Obj. Note
9684    --  that the value returned is the result of a call to Scope_Depth. Only
9685    --  scope depths associated with dynamic scopes can actually be returned.
9686    --  Since only relative levels matter for accessibility checking, the fact
9687    --  that the distance between successive levels of accessibility is not
9688    --  always one is immaterial (invariant: if level(E2) is deeper than
9689    --  level(E1), then Scope_Depth(E1) < Scope_Depth(E2)).
9690
9691       function Reference_To (Obj : Node_Id) return Node_Id;
9692       --  An explicit dereference is created when removing side-effects from
9693       --  expressions for constraint checking purposes. In this case a local
9694       --  access type is created for it. The correct access level is that of
9695       --  the original source node. We detect this case by noting that the
9696       --  prefix of the dereference is created by an object declaration whose
9697       --  initial expression is a reference.
9698
9699       ------------------
9700       -- Reference_To --
9701       ------------------
9702
9703       function Reference_To (Obj : Node_Id) return Node_Id is
9704          Pref : constant Node_Id := Prefix (Obj);
9705       begin
9706          if Is_Entity_Name (Pref)
9707            and then Nkind (Parent (Entity (Pref))) = N_Object_Declaration
9708            and then Present (Expression (Parent (Entity (Pref))))
9709            and then Nkind (Expression (Parent (Entity (Pref)))) = N_Reference
9710          then
9711             return (Prefix (Expression (Parent (Entity (Pref)))));
9712          else
9713             return Empty;
9714          end if;
9715       end Reference_To;
9716
9717    --  Start of processing for Object_Access_Level
9718
9719    begin
9720       if Is_Entity_Name (Obj) then
9721          E := Entity (Obj);
9722
9723          if Is_Prival (E) then
9724             E := Prival_Link (E);
9725          end if;
9726
9727          --  If E is a type then it denotes a current instance. For this case
9728          --  we add one to the normal accessibility level of the type to ensure
9729          --  that current instances are treated as always being deeper than
9730          --  than the level of any visible named access type (see 3.10.2(21)).
9731
9732          if Is_Type (E) then
9733             return Type_Access_Level (E) +  1;
9734
9735          elsif Present (Renamed_Object (E)) then
9736             return Object_Access_Level (Renamed_Object (E));
9737
9738          --  Similarly, if E is a component of the current instance of a
9739          --  protected type, any instance of it is assumed to be at a deeper
9740          --  level than the type. For a protected object (whose type is an
9741          --  anonymous protected type) its components are at the same level
9742          --  as the type itself.
9743
9744          elsif not Is_Overloadable (E)
9745            and then Ekind (Scope (E)) = E_Protected_Type
9746            and then Comes_From_Source (Scope (E))
9747          then
9748             return Type_Access_Level (Scope (E)) + 1;
9749
9750          else
9751             return Scope_Depth (Enclosing_Dynamic_Scope (E));
9752          end if;
9753
9754       elsif Nkind (Obj) = N_Selected_Component then
9755          if Is_Access_Type (Etype (Prefix (Obj))) then
9756             return Type_Access_Level (Etype (Prefix (Obj)));
9757          else
9758             return Object_Access_Level (Prefix (Obj));
9759          end if;
9760
9761       elsif Nkind (Obj) = N_Indexed_Component then
9762          if Is_Access_Type (Etype (Prefix (Obj))) then
9763             return Type_Access_Level (Etype (Prefix (Obj)));
9764          else
9765             return Object_Access_Level (Prefix (Obj));
9766          end if;
9767
9768       elsif Nkind (Obj) = N_Explicit_Dereference then
9769
9770          --  If the prefix is a selected access discriminant then we make a
9771          --  recursive call on the prefix, which will in turn check the level
9772          --  of the prefix object of the selected discriminant.
9773
9774          if Nkind (Prefix (Obj)) = N_Selected_Component
9775            and then Ekind (Etype (Prefix (Obj))) = E_Anonymous_Access_Type
9776            and then
9777              Ekind (Entity (Selector_Name (Prefix (Obj)))) = E_Discriminant
9778          then
9779             return Object_Access_Level (Prefix (Obj));
9780
9781          elsif not (Comes_From_Source (Obj)) then
9782             declare
9783                Ref : constant Node_Id := Reference_To (Obj);
9784             begin
9785                if Present (Ref) then
9786                   return Object_Access_Level (Ref);
9787                else
9788                   return Type_Access_Level (Etype (Prefix (Obj)));
9789                end if;
9790             end;
9791
9792          else
9793             return Type_Access_Level (Etype (Prefix (Obj)));
9794          end if;
9795
9796       elsif Nkind (Obj) = N_Type_Conversion
9797         or else Nkind (Obj) = N_Unchecked_Type_Conversion
9798       then
9799          return Object_Access_Level (Expression (Obj));
9800
9801       elsif Nkind (Obj) = N_Function_Call then
9802
9803          --  Function results are objects, so we get either the access level of
9804          --  the function or, in the case of an indirect call, the level of the
9805          --  access-to-subprogram type. (This code is used for Ada 95, but it
9806          --  looks wrong, because it seems that we should be checking the level
9807          --  of the call itself, even for Ada 95. However, using the Ada 2005
9808          --  version of the code causes regressions in several tests that are
9809          --  compiled with -gnat95. ???)
9810
9811          if Ada_Version < Ada_2005 then
9812             if Is_Entity_Name (Name (Obj)) then
9813                return Subprogram_Access_Level (Entity (Name (Obj)));
9814             else
9815                return Type_Access_Level (Etype (Prefix (Name (Obj))));
9816             end if;
9817
9818          --  For Ada 2005, the level of the result object of a function call is
9819          --  defined to be the level of the call's innermost enclosing master.
9820          --  We determine that by querying the depth of the innermost enclosing
9821          --  dynamic scope.
9822
9823          else
9824             Return_Master_Scope_Depth_Of_Call : declare
9825
9826                function Innermost_Master_Scope_Depth
9827                  (N : Node_Id) return Uint;
9828                --  Returns the scope depth of the given node's innermost
9829                --  enclosing dynamic scope (effectively the accessibility
9830                --  level of the innermost enclosing master).
9831
9832                ----------------------------------
9833                -- Innermost_Master_Scope_Depth --
9834                ----------------------------------
9835
9836                function Innermost_Master_Scope_Depth
9837                  (N : Node_Id) return Uint
9838                is
9839                   Node_Par : Node_Id := Parent (N);
9840
9841                begin
9842                   --  Locate the nearest enclosing node (by traversing Parents)
9843                   --  that Defining_Entity can be applied to, and return the
9844                   --  depth of that entity's nearest enclosing dynamic scope.
9845
9846                   while Present (Node_Par) loop
9847                      case Nkind (Node_Par) is
9848                         when N_Component_Declaration           |
9849                              N_Entry_Declaration               |
9850                              N_Formal_Object_Declaration       |
9851                              N_Formal_Type_Declaration         |
9852                              N_Full_Type_Declaration           |
9853                              N_Incomplete_Type_Declaration     |
9854                              N_Loop_Parameter_Specification    |
9855                              N_Object_Declaration              |
9856                              N_Protected_Type_Declaration      |
9857                              N_Private_Extension_Declaration   |
9858                              N_Private_Type_Declaration        |
9859                              N_Subtype_Declaration             |
9860                              N_Function_Specification          |
9861                              N_Procedure_Specification         |
9862                              N_Task_Type_Declaration           |
9863                              N_Body_Stub                       |
9864                              N_Generic_Instantiation           |
9865                              N_Proper_Body                     |
9866                              N_Implicit_Label_Declaration      |
9867                              N_Package_Declaration             |
9868                              N_Single_Task_Declaration         |
9869                              N_Subprogram_Declaration          |
9870                              N_Generic_Declaration             |
9871                              N_Renaming_Declaration            |
9872                              N_Block_Statement                 |
9873                              N_Formal_Subprogram_Declaration   |
9874                              N_Abstract_Subprogram_Declaration |
9875                              N_Entry_Body                      |
9876                              N_Exception_Declaration           |
9877                              N_Formal_Package_Declaration      |
9878                              N_Number_Declaration              |
9879                              N_Package_Specification           |
9880                              N_Parameter_Specification         |
9881                              N_Single_Protected_Declaration    |
9882                              N_Subunit                         =>
9883
9884                            return Scope_Depth
9885                                     (Nearest_Dynamic_Scope
9886                                        (Defining_Entity (Node_Par)));
9887
9888                         when others =>
9889                            null;
9890                      end case;
9891
9892                      Node_Par := Parent (Node_Par);
9893                   end loop;
9894
9895                   pragma Assert (False);
9896
9897                   --  Should never reach the following return
9898
9899                   return Scope_Depth (Current_Scope) + 1;
9900                end Innermost_Master_Scope_Depth;
9901
9902             --  Start of processing for Return_Master_Scope_Depth_Of_Call
9903
9904             begin
9905                return Innermost_Master_Scope_Depth (Obj);
9906             end Return_Master_Scope_Depth_Of_Call;
9907          end if;
9908
9909       --  For convenience we handle qualified expressions, even though
9910       --  they aren't technically object names.
9911
9912       elsif Nkind (Obj) = N_Qualified_Expression then
9913          return Object_Access_Level (Expression (Obj));
9914
9915       --  Otherwise return the scope level of Standard.
9916       --  (If there are cases that fall through
9917       --  to this point they will be treated as
9918       --  having global accessibility for now. ???)
9919
9920       else
9921          return Scope_Depth (Standard_Standard);
9922       end if;
9923    end Object_Access_Level;
9924
9925    --------------------------------------
9926    -- Original_Corresponding_Operation --
9927    --------------------------------------
9928
9929    function Original_Corresponding_Operation (S : Entity_Id) return Entity_Id
9930    is
9931       Typ : constant Entity_Id := Find_Dispatching_Type (S);
9932
9933    begin
9934       --  If S is an inherited primitive S2 the original corresponding
9935       --  operation of S is the original corresponding operation of S2
9936
9937       if Present (Alias (S))
9938         and then Find_Dispatching_Type (Alias (S)) /= Typ
9939       then
9940          return Original_Corresponding_Operation (Alias (S));
9941
9942       --  If S overrides an inherted subprogram S2 the original corresponding
9943       --  operation of S is the original corresponding operation of S2
9944
9945       elsif Is_Overriding_Operation (S)
9946         and then Present (Overridden_Operation (S))
9947       then
9948          return Original_Corresponding_Operation (Overridden_Operation (S));
9949
9950       --  otherwise it is S itself
9951
9952       else
9953          return S;
9954       end if;
9955    end Original_Corresponding_Operation;
9956
9957    -----------------------
9958    -- Private_Component --
9959    -----------------------
9960
9961    function Private_Component (Type_Id : Entity_Id) return Entity_Id is
9962       Ancestor  : constant Entity_Id := Base_Type (Type_Id);
9963
9964       function Trace_Components
9965         (T     : Entity_Id;
9966          Check : Boolean) return Entity_Id;
9967       --  Recursive function that does the work, and checks against circular
9968       --  definition for each subcomponent type.
9969
9970       ----------------------
9971       -- Trace_Components --
9972       ----------------------
9973
9974       function Trace_Components
9975          (T     : Entity_Id;
9976           Check : Boolean) return Entity_Id
9977        is
9978          Btype     : constant Entity_Id := Base_Type (T);
9979          Component : Entity_Id;
9980          P         : Entity_Id;
9981          Candidate : Entity_Id := Empty;
9982
9983       begin
9984          if Check and then Btype = Ancestor then
9985             Error_Msg_N ("circular type definition", Type_Id);
9986             return Any_Type;
9987          end if;
9988
9989          if Is_Private_Type (Btype)
9990            and then not Is_Generic_Type (Btype)
9991          then
9992             if Present (Full_View (Btype))
9993               and then Is_Record_Type (Full_View (Btype))
9994               and then not Is_Frozen (Btype)
9995             then
9996                --  To indicate that the ancestor depends on a private type, the
9997                --  current Btype is sufficient. However, to check for circular
9998                --  definition we must recurse on the full view.
9999
10000                Candidate := Trace_Components (Full_View (Btype), True);
10001
10002                if Candidate = Any_Type then
10003                   return Any_Type;
10004                else
10005                   return Btype;
10006                end if;
10007
10008             else
10009                return Btype;
10010             end if;
10011
10012          elsif Is_Array_Type (Btype) then
10013             return Trace_Components (Component_Type (Btype), True);
10014
10015          elsif Is_Record_Type (Btype) then
10016             Component := First_Entity (Btype);
10017             while Present (Component) loop
10018
10019                --  Skip anonymous types generated by constrained components
10020
10021                if not Is_Type (Component) then
10022                   P := Trace_Components (Etype (Component), True);
10023
10024                   if Present (P) then
10025                      if P = Any_Type then
10026                         return P;
10027                      else
10028                         Candidate := P;
10029                      end if;
10030                   end if;
10031                end if;
10032
10033                Next_Entity (Component);
10034             end loop;
10035
10036             return Candidate;
10037
10038          else
10039             return Empty;
10040          end if;
10041       end Trace_Components;
10042
10043    --  Start of processing for Private_Component
10044
10045    begin
10046       return Trace_Components (Type_Id, False);
10047    end Private_Component;
10048
10049    ---------------------------
10050    -- Primitive_Names_Match --
10051    ---------------------------
10052
10053    function Primitive_Names_Match (E1, E2 : Entity_Id) return Boolean is
10054
10055       function Non_Internal_Name (E : Entity_Id) return Name_Id;
10056       --  Given an internal name, returns the corresponding non-internal name
10057
10058       ------------------------
10059       --  Non_Internal_Name --
10060       ------------------------
10061
10062       function Non_Internal_Name (E : Entity_Id) return Name_Id is
10063       begin
10064          Get_Name_String (Chars (E));
10065          Name_Len := Name_Len - 1;
10066          return Name_Find;
10067       end Non_Internal_Name;
10068
10069    --  Start of processing for Primitive_Names_Match
10070
10071    begin
10072       pragma Assert (Present (E1) and then Present (E2));
10073
10074       return Chars (E1) = Chars (E2)
10075         or else
10076            (not Is_Internal_Name (Chars (E1))
10077               and then Is_Internal_Name (Chars (E2))
10078               and then Non_Internal_Name (E2) = Chars (E1))
10079         or else
10080            (not Is_Internal_Name (Chars (E2))
10081               and then Is_Internal_Name (Chars (E1))
10082               and then Non_Internal_Name (E1) = Chars (E2))
10083         or else
10084            (Is_Predefined_Dispatching_Operation (E1)
10085               and then Is_Predefined_Dispatching_Operation (E2)
10086               and then Same_TSS (E1, E2))
10087         or else
10088            (Is_Init_Proc (E1) and then Is_Init_Proc (E2));
10089    end Primitive_Names_Match;
10090
10091    -----------------------
10092    -- Process_End_Label --
10093    -----------------------
10094
10095    procedure Process_End_Label
10096      (N   : Node_Id;
10097       Typ : Character;
10098       Ent  : Entity_Id)
10099    is
10100       Loc  : Source_Ptr;
10101       Nam  : Node_Id;
10102       Scop : Entity_Id;
10103
10104       Label_Ref : Boolean;
10105       --  Set True if reference to end label itself is required
10106
10107       Endl : Node_Id;
10108       --  Gets set to the operator symbol or identifier that references the
10109       --  entity Ent. For the child unit case, this is the identifier from the
10110       --  designator. For other cases, this is simply Endl.
10111
10112       procedure Generate_Parent_Ref (N : Node_Id; E : Entity_Id);
10113       --  N is an identifier node that appears as a parent unit reference in
10114       --  the case where Ent is a child unit. This procedure generates an
10115       --  appropriate cross-reference entry. E is the corresponding entity.
10116
10117       -------------------------
10118       -- Generate_Parent_Ref --
10119       -------------------------
10120
10121       procedure Generate_Parent_Ref (N : Node_Id; E : Entity_Id) is
10122       begin
10123          --  If names do not match, something weird, skip reference
10124
10125          if Chars (E) = Chars (N) then
10126
10127             --  Generate the reference. We do NOT consider this as a reference
10128             --  for unreferenced symbol purposes.
10129
10130             Generate_Reference (E, N, 'r', Set_Ref => False, Force => True);
10131
10132             if Style_Check then
10133                Style.Check_Identifier (N, E);
10134             end if;
10135          end if;
10136       end Generate_Parent_Ref;
10137
10138    --  Start of processing for Process_End_Label
10139
10140    begin
10141       --  If no node, ignore. This happens in some error situations, and
10142       --  also for some internally generated structures where no end label
10143       --  references are required in any case.
10144
10145       if No (N) then
10146          return;
10147       end if;
10148
10149       --  Nothing to do if no End_Label, happens for internally generated
10150       --  constructs where we don't want an end label reference anyway. Also
10151       --  nothing to do if Endl is a string literal, which means there was
10152       --  some prior error (bad operator symbol)
10153
10154       Endl := End_Label (N);
10155
10156       if No (Endl) or else Nkind (Endl) = N_String_Literal then
10157          return;
10158       end if;
10159
10160       --  Reference node is not in extended main source unit
10161
10162       if not In_Extended_Main_Source_Unit (N) then
10163
10164          --  Generally we do not collect references except for the extended
10165          --  main source unit. The one exception is the 'e' entry for a
10166          --  package spec, where it is useful for a client to have the
10167          --  ending information to define scopes.
10168
10169          if Typ /= 'e' then
10170             return;
10171
10172          else
10173             Label_Ref := False;
10174
10175             --  For this case, we can ignore any parent references, but we
10176             --  need the package name itself for the 'e' entry.
10177
10178             if Nkind (Endl) = N_Designator then
10179                Endl := Identifier (Endl);
10180             end if;
10181          end if;
10182
10183       --  Reference is in extended main source unit
10184
10185       else
10186          Label_Ref := True;
10187
10188          --  For designator, generate references for the parent entries
10189
10190          if Nkind (Endl) = N_Designator then
10191
10192             --  Generate references for the prefix if the END line comes from
10193             --  source (otherwise we do not need these references) We climb the
10194             --  scope stack to find the expected entities.
10195
10196             if Comes_From_Source (Endl) then
10197                Nam  := Name (Endl);
10198                Scop := Current_Scope;
10199                while Nkind (Nam) = N_Selected_Component loop
10200                   Scop := Scope (Scop);
10201                   exit when No (Scop);
10202                   Generate_Parent_Ref (Selector_Name (Nam), Scop);
10203                   Nam := Prefix (Nam);
10204                end loop;
10205
10206                if Present (Scop) then
10207                   Generate_Parent_Ref (Nam, Scope (Scop));
10208                end if;
10209             end if;
10210
10211             Endl := Identifier (Endl);
10212          end if;
10213       end if;
10214
10215       --  If the end label is not for the given entity, then either we have
10216       --  some previous error, or this is a generic instantiation for which
10217       --  we do not need to make a cross-reference in this case anyway. In
10218       --  either case we simply ignore the call.
10219
10220       if Chars (Ent) /= Chars (Endl) then
10221          return;
10222       end if;
10223
10224       --  If label was really there, then generate a normal reference and then
10225       --  adjust the location in the end label to point past the name (which
10226       --  should almost always be the semicolon).
10227
10228       Loc := Sloc (Endl);
10229
10230       if Comes_From_Source (Endl) then
10231
10232          --  If a label reference is required, then do the style check and
10233          --  generate an l-type cross-reference entry for the label
10234
10235          if Label_Ref then
10236             if Style_Check then
10237                Style.Check_Identifier (Endl, Ent);
10238             end if;
10239
10240             Generate_Reference (Ent, Endl, 'l', Set_Ref => False);
10241          end if;
10242
10243          --  Set the location to point past the label (normally this will
10244          --  mean the semicolon immediately following the label). This is
10245          --  done for the sake of the 'e' or 't' entry generated below.
10246
10247          Get_Decoded_Name_String (Chars (Endl));
10248          Set_Sloc (Endl, Sloc (Endl) + Source_Ptr (Name_Len));
10249       end if;
10250
10251       --  Now generate the e/t reference
10252
10253       Generate_Reference (Ent, Endl, Typ, Set_Ref => False, Force => True);
10254
10255       --  Restore Sloc, in case modified above, since we have an identifier
10256       --  and the normal Sloc should be left set in the tree.
10257
10258       Set_Sloc (Endl, Loc);
10259    end Process_End_Label;
10260
10261    ------------------------------------
10262    -- References_Generic_Formal_Type --
10263    ------------------------------------
10264
10265    function References_Generic_Formal_Type (N : Node_Id) return Boolean is
10266
10267       function Process (N : Node_Id) return Traverse_Result;
10268       --  Process one node in search for generic formal type
10269
10270       -------------
10271       -- Process --
10272       -------------
10273
10274       function Process (N : Node_Id) return Traverse_Result is
10275       begin
10276          if Nkind (N) in N_Has_Entity then
10277             declare
10278                E : constant Entity_Id := Entity (N);
10279             begin
10280                if Present (E) then
10281                   if Is_Generic_Type (E) then
10282                      return Abandon;
10283                   elsif Present (Etype (E))
10284                     and then Is_Generic_Type (Etype (E))
10285                   then
10286                      return Abandon;
10287                   end if;
10288                end if;
10289             end;
10290          end if;
10291
10292          return Atree.OK;
10293       end Process;
10294
10295       function Traverse is new Traverse_Func (Process);
10296       --  Traverse tree to look for generic type
10297
10298    begin
10299       if Inside_A_Generic then
10300          return Traverse (N) = Abandon;
10301       else
10302          return False;
10303       end if;
10304    end References_Generic_Formal_Type;
10305
10306    --------------------
10307    -- Remove_Homonym --
10308    --------------------
10309
10310    procedure Remove_Homonym (E : Entity_Id) is
10311       Prev  : Entity_Id := Empty;
10312       H     : Entity_Id;
10313
10314    begin
10315       if E = Current_Entity (E) then
10316          if Present (Homonym (E)) then
10317             Set_Current_Entity (Homonym (E));
10318          else
10319             Set_Name_Entity_Id (Chars (E), Empty);
10320          end if;
10321       else
10322          H := Current_Entity (E);
10323          while Present (H) and then H /= E loop
10324             Prev := H;
10325             H    := Homonym (H);
10326          end loop;
10327
10328          Set_Homonym (Prev, Homonym (E));
10329       end if;
10330    end Remove_Homonym;
10331
10332    ---------------------
10333    -- Rep_To_Pos_Flag --
10334    ---------------------
10335
10336    function Rep_To_Pos_Flag (E : Entity_Id; Loc : Source_Ptr) return Node_Id is
10337    begin
10338       return New_Occurrence_Of
10339                (Boolean_Literals (not Range_Checks_Suppressed (E)), Loc);
10340    end Rep_To_Pos_Flag;
10341
10342    --------------------
10343    -- Require_Entity --
10344    --------------------
10345
10346    procedure Require_Entity (N : Node_Id) is
10347    begin
10348       if Is_Entity_Name (N) and then No (Entity (N)) then
10349          if Total_Errors_Detected /= 0 then
10350             Set_Entity (N, Any_Id);
10351          else
10352             raise Program_Error;
10353          end if;
10354       end if;
10355    end Require_Entity;
10356
10357    ------------------------------
10358    -- Requires_Transient_Scope --
10359    ------------------------------
10360
10361    --  A transient scope is required when variable-sized temporaries are
10362    --  allocated in the primary or secondary stack, or when finalization
10363    --  actions must be generated before the next instruction.
10364
10365    function Requires_Transient_Scope (Id : Entity_Id) return Boolean is
10366       Typ : constant Entity_Id := Underlying_Type (Id);
10367
10368    --  Start of processing for Requires_Transient_Scope
10369
10370    begin
10371       --  This is a private type which is not completed yet. This can only
10372       --  happen in a default expression (of a formal parameter or of a
10373       --  record component). Do not expand transient scope in this case
10374
10375       if No (Typ) then
10376          return False;
10377
10378       --  Do not expand transient scope for non-existent procedure return
10379
10380       elsif Typ = Standard_Void_Type then
10381          return False;
10382
10383       --  Elementary types do not require a transient scope
10384
10385       elsif Is_Elementary_Type (Typ) then
10386          return False;
10387
10388       --  Generally, indefinite subtypes require a transient scope, since the
10389       --  back end cannot generate temporaries, since this is not a valid type
10390       --  for declaring an object. It might be possible to relax this in the
10391       --  future, e.g. by declaring the maximum possible space for the type.
10392
10393       elsif Is_Indefinite_Subtype (Typ) then
10394          return True;
10395
10396       --  Functions returning tagged types may dispatch on result so their
10397       --  returned value is allocated on the secondary stack. Controlled
10398       --  type temporaries need finalization.
10399
10400       elsif Is_Tagged_Type (Typ)
10401         or else Has_Controlled_Component (Typ)
10402       then
10403          return not Is_Value_Type (Typ);
10404
10405       --  Record type
10406
10407       elsif Is_Record_Type (Typ) then
10408          declare
10409             Comp : Entity_Id;
10410          begin
10411             Comp := First_Entity (Typ);
10412             while Present (Comp) loop
10413                if Ekind (Comp) = E_Component
10414                   and then Requires_Transient_Scope (Etype (Comp))
10415                then
10416                   return True;
10417                else
10418                   Next_Entity (Comp);
10419                end if;
10420             end loop;
10421          end;
10422
10423          return False;
10424
10425       --  String literal types never require transient scope
10426
10427       elsif Ekind (Typ) = E_String_Literal_Subtype then
10428          return False;
10429
10430       --  Array type. Note that we already know that this is a constrained
10431       --  array, since unconstrained arrays will fail the indefinite test.
10432
10433       elsif Is_Array_Type (Typ) then
10434
10435          --  If component type requires a transient scope, the array does too
10436
10437          if Requires_Transient_Scope (Component_Type (Typ)) then
10438             return True;
10439
10440          --  Otherwise, we only need a transient scope if the size is not
10441          --  known at compile time.
10442
10443          else
10444             return not Size_Known_At_Compile_Time (Typ);
10445          end if;
10446
10447       --  All other cases do not require a transient scope
10448
10449       else
10450          return False;
10451       end if;
10452    end Requires_Transient_Scope;
10453
10454    --------------------------
10455    -- Reset_Analyzed_Flags --
10456    --------------------------
10457
10458    procedure Reset_Analyzed_Flags (N : Node_Id) is
10459
10460       function Clear_Analyzed (N : Node_Id) return Traverse_Result;
10461       --  Function used to reset Analyzed flags in tree. Note that we do
10462       --  not reset Analyzed flags in entities, since there is no need to
10463       --  reanalyze entities, and indeed, it is wrong to do so, since it
10464       --  can result in generating auxiliary stuff more than once.
10465
10466       --------------------
10467       -- Clear_Analyzed --
10468       --------------------
10469
10470       function Clear_Analyzed (N : Node_Id) return Traverse_Result is
10471       begin
10472          if not Has_Extension (N) then
10473             Set_Analyzed (N, False);
10474          end if;
10475
10476          return OK;
10477       end Clear_Analyzed;
10478
10479       procedure Reset_Analyzed is new Traverse_Proc (Clear_Analyzed);
10480
10481    --  Start of processing for Reset_Analyzed_Flags
10482
10483    begin
10484       Reset_Analyzed (N);
10485    end Reset_Analyzed_Flags;
10486
10487    ---------------------------
10488    -- Safe_To_Capture_Value --
10489    ---------------------------
10490
10491    function Safe_To_Capture_Value
10492      (N    : Node_Id;
10493       Ent  : Entity_Id;
10494       Cond : Boolean := False) return Boolean
10495    is
10496    begin
10497       --  The only entities for which we track constant values are variables
10498       --  which are not renamings, constants, out parameters, and in out
10499       --  parameters, so check if we have this case.
10500
10501       --  Note: it may seem odd to track constant values for constants, but in
10502       --  fact this routine is used for other purposes than simply capturing
10503       --  the value. In particular, the setting of Known[_Non]_Null.
10504
10505       if (Ekind (Ent) = E_Variable and then No (Renamed_Object (Ent)))
10506             or else
10507           Ekind (Ent) = E_Constant
10508             or else
10509           Ekind (Ent) = E_Out_Parameter
10510             or else
10511           Ekind (Ent) = E_In_Out_Parameter
10512       then
10513          null;
10514
10515       --  For conditionals, we also allow loop parameters and all formals,
10516       --  including in parameters.
10517
10518       elsif Cond
10519         and then
10520           (Ekind (Ent) = E_Loop_Parameter
10521              or else
10522            Ekind (Ent) = E_In_Parameter)
10523       then
10524          null;
10525
10526       --  For all other cases, not just unsafe, but impossible to capture
10527       --  Current_Value, since the above are the only entities which have
10528       --  Current_Value fields.
10529
10530       else
10531          return False;
10532       end if;
10533
10534       --  Skip if volatile or aliased, since funny things might be going on in
10535       --  these cases which we cannot necessarily track. Also skip any variable
10536       --  for which an address clause is given, or whose address is taken. Also
10537       --  never capture value of library level variables (an attempt to do so
10538       --  can occur in the case of package elaboration code).
10539
10540       if Treat_As_Volatile (Ent)
10541         or else Is_Aliased (Ent)
10542         or else Present (Address_Clause (Ent))
10543         or else Address_Taken (Ent)
10544         or else (Is_Library_Level_Entity (Ent)
10545                    and then Ekind (Ent) = E_Variable)
10546       then
10547          return False;
10548       end if;
10549
10550       --  OK, all above conditions are met. We also require that the scope of
10551       --  the reference be the same as the scope of the entity, not counting
10552       --  packages and blocks and loops.
10553
10554       declare
10555          E_Scope : constant Entity_Id := Scope (Ent);
10556          R_Scope : Entity_Id;
10557
10558       begin
10559          R_Scope := Current_Scope;
10560          while R_Scope /= Standard_Standard loop
10561             exit when R_Scope = E_Scope;
10562
10563             if not Ekind_In (R_Scope, E_Package, E_Block, E_Loop) then
10564                return False;
10565             else
10566                R_Scope := Scope (R_Scope);
10567             end if;
10568          end loop;
10569       end;
10570
10571       --  We also require that the reference does not appear in a context
10572       --  where it is not sure to be executed (i.e. a conditional context
10573       --  or an exception handler). We skip this if Cond is True, since the
10574       --  capturing of values from conditional tests handles this ok.
10575
10576       if Cond then
10577          return True;
10578       end if;
10579
10580       declare
10581          Desc : Node_Id;
10582          P    : Node_Id;
10583
10584       begin
10585          Desc := N;
10586
10587          P := Parent (N);
10588          while Present (P) loop
10589             if         Nkind (P) = N_If_Statement
10590               or else  Nkind (P) = N_Case_Statement
10591               or else (Nkind (P) in N_Short_Circuit
10592                          and then Desc = Right_Opnd (P))
10593               or else (Nkind (P) = N_Conditional_Expression
10594                          and then Desc /= First (Expressions (P)))
10595               or else  Nkind (P) = N_Exception_Handler
10596               or else  Nkind (P) = N_Selective_Accept
10597               or else  Nkind (P) = N_Conditional_Entry_Call
10598               or else  Nkind (P) = N_Timed_Entry_Call
10599               or else  Nkind (P) = N_Asynchronous_Select
10600             then
10601                return False;
10602             else
10603                Desc := P;
10604                P    := Parent (P);
10605             end if;
10606          end loop;
10607       end;
10608
10609       --  OK, looks safe to set value
10610
10611       return True;
10612    end Safe_To_Capture_Value;
10613
10614    ---------------
10615    -- Same_Name --
10616    ---------------
10617
10618    function Same_Name (N1, N2 : Node_Id) return Boolean is
10619       K1 : constant Node_Kind := Nkind (N1);
10620       K2 : constant Node_Kind := Nkind (N2);
10621
10622    begin
10623       if (K1 = N_Identifier or else K1 = N_Defining_Identifier)
10624         and then (K2 = N_Identifier or else K2 = N_Defining_Identifier)
10625       then
10626          return Chars (N1) = Chars (N2);
10627
10628       elsif (K1 = N_Selected_Component or else K1 = N_Expanded_Name)
10629         and then (K2 = N_Selected_Component or else K2 = N_Expanded_Name)
10630       then
10631          return Same_Name (Selector_Name (N1), Selector_Name (N2))
10632            and then Same_Name (Prefix (N1), Prefix (N2));
10633
10634       else
10635          return False;
10636       end if;
10637    end Same_Name;
10638
10639    -----------------
10640    -- Same_Object --
10641    -----------------
10642
10643    function Same_Object (Node1, Node2 : Node_Id) return Boolean is
10644       N1 : constant Node_Id := Original_Node (Node1);
10645       N2 : constant Node_Id := Original_Node (Node2);
10646       --  We do the tests on original nodes, since we are most interested
10647       --  in the original source, not any expansion that got in the way.
10648
10649       K1 : constant Node_Kind := Nkind (N1);
10650       K2 : constant Node_Kind := Nkind (N2);
10651
10652    begin
10653       --  First case, both are entities with same entity
10654
10655       if K1 in N_Has_Entity and then K2 in N_Has_Entity then
10656          declare
10657             EN1 : constant Entity_Id := Entity (N1);
10658             EN2 : constant Entity_Id := Entity (N2);
10659          begin
10660             if Present (EN1) and then Present (EN2)
10661               and then (Ekind_In (EN1, E_Variable, E_Constant)
10662                          or else Is_Formal (EN1))
10663               and then EN1 = EN2
10664             then
10665                return True;
10666             end if;
10667          end;
10668       end if;
10669
10670       --  Second case, selected component with same selector, same record
10671
10672       if K1 = N_Selected_Component
10673         and then K2 = N_Selected_Component
10674         and then Chars (Selector_Name (N1)) = Chars (Selector_Name (N2))
10675       then
10676          return Same_Object (Prefix (N1), Prefix (N2));
10677
10678       --  Third case, indexed component with same subscripts, same array
10679
10680       elsif K1 = N_Indexed_Component
10681         and then K2 = N_Indexed_Component
10682         and then Same_Object (Prefix (N1), Prefix (N2))
10683       then
10684          declare
10685             E1, E2 : Node_Id;
10686          begin
10687             E1 := First (Expressions (N1));
10688             E2 := First (Expressions (N2));
10689             while Present (E1) loop
10690                if not Same_Value (E1, E2) then
10691                   return False;
10692                else
10693                   Next (E1);
10694                   Next (E2);
10695                end if;
10696             end loop;
10697
10698             return True;
10699          end;
10700
10701       --  Fourth case, slice of same array with same bounds
10702
10703       elsif K1 = N_Slice
10704         and then K2 = N_Slice
10705         and then Nkind (Discrete_Range (N1)) = N_Range
10706         and then Nkind (Discrete_Range (N2)) = N_Range
10707         and then Same_Value (Low_Bound (Discrete_Range (N1)),
10708                              Low_Bound (Discrete_Range (N2)))
10709         and then Same_Value (High_Bound (Discrete_Range (N1)),
10710                              High_Bound (Discrete_Range (N2)))
10711       then
10712          return Same_Name (Prefix (N1), Prefix (N2));
10713
10714       --  All other cases, not clearly the same object
10715
10716       else
10717          return False;
10718       end if;
10719    end Same_Object;
10720
10721    ---------------
10722    -- Same_Type --
10723    ---------------
10724
10725    function Same_Type (T1, T2 : Entity_Id) return Boolean is
10726    begin
10727       if T1 = T2 then
10728          return True;
10729
10730       elsif not Is_Constrained (T1)
10731         and then not Is_Constrained (T2)
10732         and then Base_Type (T1) = Base_Type (T2)
10733       then
10734          return True;
10735
10736       --  For now don't bother with case of identical constraints, to be
10737       --  fiddled with later on perhaps (this is only used for optimization
10738       --  purposes, so it is not critical to do a best possible job)
10739
10740       else
10741          return False;
10742       end if;
10743    end Same_Type;
10744
10745    ----------------
10746    -- Same_Value --
10747    ----------------
10748
10749    function Same_Value (Node1, Node2 : Node_Id) return Boolean is
10750    begin
10751       if Compile_Time_Known_Value (Node1)
10752         and then Compile_Time_Known_Value (Node2)
10753         and then Expr_Value (Node1) = Expr_Value (Node2)
10754       then
10755          return True;
10756       elsif Same_Object (Node1, Node2) then
10757          return True;
10758       else
10759          return False;
10760       end if;
10761    end Same_Value;
10762
10763    -----------------
10764    -- Save_Actual --
10765    -----------------
10766
10767    procedure Save_Actual (N : Node_Id;  Writable : Boolean := False) is
10768    begin
10769       if Ada_Version < Ada_2012 then
10770          return;
10771
10772       elsif Is_Entity_Name (N)
10773         or else
10774           Nkind_In (N, N_Indexed_Component, N_Selected_Component, N_Slice)
10775         or else
10776           (Nkind (N) = N_Attribute_Reference
10777             and then Attribute_Name (N) = Name_Access)
10778
10779       then
10780          --  We are only interested in IN OUT parameters of inner calls
10781
10782          if not Writable
10783            or else Nkind (Parent (N)) = N_Function_Call
10784            or else Nkind (Parent (N)) in N_Op
10785          then
10786             Actuals_In_Call.Increment_Last;
10787             Actuals_In_Call.Table (Actuals_In_Call.Last) := (N, Writable);
10788          end if;
10789       end if;
10790    end Save_Actual;
10791
10792    ------------------------
10793    -- Scope_Is_Transient --
10794    ------------------------
10795
10796    function Scope_Is_Transient return Boolean is
10797    begin
10798       return Scope_Stack.Table (Scope_Stack.Last).Is_Transient;
10799    end Scope_Is_Transient;
10800
10801    ------------------
10802    -- Scope_Within --
10803    ------------------
10804
10805    function Scope_Within (Scope1, Scope2 : Entity_Id) return Boolean is
10806       Scop : Entity_Id;
10807
10808    begin
10809       Scop := Scope1;
10810       while Scop /= Standard_Standard loop
10811          Scop := Scope (Scop);
10812
10813          if Scop = Scope2 then
10814             return True;
10815          end if;
10816       end loop;
10817
10818       return False;
10819    end Scope_Within;
10820
10821    --------------------------
10822    -- Scope_Within_Or_Same --
10823    --------------------------
10824
10825    function Scope_Within_Or_Same (Scope1, Scope2 : Entity_Id) return Boolean is
10826       Scop : Entity_Id;
10827
10828    begin
10829       Scop := Scope1;
10830       while Scop /= Standard_Standard loop
10831          if Scop = Scope2 then
10832             return True;
10833          else
10834             Scop := Scope (Scop);
10835          end if;
10836       end loop;
10837
10838       return False;
10839    end Scope_Within_Or_Same;
10840
10841    --------------------
10842    -- Set_Convention --
10843    --------------------
10844
10845    procedure Set_Convention (E : Entity_Id; Val : Snames.Convention_Id) is
10846    begin
10847       Basic_Set_Convention (E, Val);
10848
10849       if Is_Type (E)
10850         and then Is_Access_Subprogram_Type (Base_Type (E))
10851         and then Has_Foreign_Convention (E)
10852       then
10853          Set_Can_Use_Internal_Rep (E, False);
10854       end if;
10855    end Set_Convention;
10856
10857    ------------------------
10858    -- Set_Current_Entity --
10859    ------------------------
10860
10861    --  The given entity is to be set as the currently visible definition
10862    --  of its associated name (i.e. the Node_Id associated with its name).
10863    --  All we have to do is to get the name from the identifier, and
10864    --  then set the associated Node_Id to point to the given entity.
10865
10866    procedure Set_Current_Entity (E : Entity_Id) is
10867    begin
10868       Set_Name_Entity_Id (Chars (E), E);
10869    end Set_Current_Entity;
10870
10871    ---------------------------
10872    -- Set_Debug_Info_Needed --
10873    ---------------------------
10874
10875    procedure Set_Debug_Info_Needed (T : Entity_Id) is
10876
10877       procedure Set_Debug_Info_Needed_If_Not_Set (E : Entity_Id);
10878       pragma Inline (Set_Debug_Info_Needed_If_Not_Set);
10879       --  Used to set debug info in a related node if not set already
10880
10881       --------------------------------------
10882       -- Set_Debug_Info_Needed_If_Not_Set --
10883       --------------------------------------
10884
10885       procedure Set_Debug_Info_Needed_If_Not_Set (E : Entity_Id) is
10886       begin
10887          if Present (E)
10888            and then not Needs_Debug_Info (E)
10889          then
10890             Set_Debug_Info_Needed (E);
10891
10892             --  For a private type, indicate that the full view also needs
10893             --  debug information.
10894
10895             if Is_Type (E)
10896               and then Is_Private_Type (E)
10897               and then Present (Full_View (E))
10898             then
10899                Set_Debug_Info_Needed (Full_View (E));
10900             end if;
10901          end if;
10902       end Set_Debug_Info_Needed_If_Not_Set;
10903
10904    --  Start of processing for Set_Debug_Info_Needed
10905
10906    begin
10907       --  Nothing to do if argument is Empty or has Debug_Info_Off set, which
10908       --  indicates that Debug_Info_Needed is never required for the entity.
10909
10910       if No (T)
10911         or else Debug_Info_Off (T)
10912       then
10913          return;
10914       end if;
10915
10916       --  Set flag in entity itself. Note that we will go through the following
10917       --  circuitry even if the flag is already set on T. That's intentional,
10918       --  it makes sure that the flag will be set in subsidiary entities.
10919
10920       Set_Needs_Debug_Info (T);
10921
10922       --  Set flag on subsidiary entities if not set already
10923
10924       if Is_Object (T) then
10925          Set_Debug_Info_Needed_If_Not_Set (Etype (T));
10926
10927       elsif Is_Type (T) then
10928          Set_Debug_Info_Needed_If_Not_Set (Etype (T));
10929
10930          if Is_Record_Type (T) then
10931             declare
10932                Ent : Entity_Id := First_Entity (T);
10933             begin
10934                while Present (Ent) loop
10935                   Set_Debug_Info_Needed_If_Not_Set (Ent);
10936                   Next_Entity (Ent);
10937                end loop;
10938             end;
10939
10940             --  For a class wide subtype, we also need debug information
10941             --  for the equivalent type.
10942
10943             if Ekind (T) = E_Class_Wide_Subtype then
10944                Set_Debug_Info_Needed_If_Not_Set (Equivalent_Type (T));
10945             end if;
10946
10947          elsif Is_Array_Type (T) then
10948             Set_Debug_Info_Needed_If_Not_Set (Component_Type (T));
10949
10950             declare
10951                Indx : Node_Id := First_Index (T);
10952             begin
10953                while Present (Indx) loop
10954                   Set_Debug_Info_Needed_If_Not_Set (Etype (Indx));
10955                   Indx := Next_Index (Indx);
10956                end loop;
10957             end;
10958
10959             if Is_Packed (T) then
10960                Set_Debug_Info_Needed_If_Not_Set (Packed_Array_Type (T));
10961             end if;
10962
10963          elsif Is_Access_Type (T) then
10964             Set_Debug_Info_Needed_If_Not_Set (Directly_Designated_Type (T));
10965
10966          elsif Is_Private_Type (T) then
10967             Set_Debug_Info_Needed_If_Not_Set (Full_View (T));
10968
10969          elsif Is_Protected_Type (T) then
10970             Set_Debug_Info_Needed_If_Not_Set (Corresponding_Record_Type (T));
10971          end if;
10972       end if;
10973    end Set_Debug_Info_Needed;
10974
10975    ---------------------------------
10976    -- Set_Entity_With_Style_Check --
10977    ---------------------------------
10978
10979    procedure Set_Entity_With_Style_Check (N : Node_Id; Val : Entity_Id) is
10980       Val_Actual : Entity_Id;
10981       Nod        : Node_Id;
10982
10983    begin
10984       Set_Entity (N, Val);
10985
10986       if Style_Check
10987         and then not Suppress_Style_Checks (Val)
10988         and then not In_Instance
10989       then
10990          if Nkind (N) = N_Identifier then
10991             Nod := N;
10992          elsif Nkind (N) = N_Expanded_Name then
10993             Nod := Selector_Name (N);
10994          else
10995             return;
10996          end if;
10997
10998          --  A special situation arises for derived operations, where we want
10999          --  to do the check against the parent (since the Sloc of the derived
11000          --  operation points to the derived type declaration itself).
11001
11002          Val_Actual := Val;
11003          while not Comes_From_Source (Val_Actual)
11004            and then Nkind (Val_Actual) in N_Entity
11005            and then (Ekind (Val_Actual) = E_Enumeration_Literal
11006                       or else Is_Subprogram (Val_Actual)
11007                       or else Is_Generic_Subprogram (Val_Actual))
11008            and then Present (Alias (Val_Actual))
11009          loop
11010             Val_Actual := Alias (Val_Actual);
11011          end loop;
11012
11013          --  Renaming declarations for generic actuals do not come from source,
11014          --  and have a different name from that of the entity they rename, so
11015          --  there is no style check to perform here.
11016
11017          if Chars (Nod) = Chars (Val_Actual) then
11018             Style.Check_Identifier (Nod, Val_Actual);
11019          end if;
11020       end if;
11021
11022       Set_Entity (N, Val);
11023    end Set_Entity_With_Style_Check;
11024
11025    ------------------------
11026    -- Set_Name_Entity_Id --
11027    ------------------------
11028
11029    procedure Set_Name_Entity_Id (Id : Name_Id; Val : Entity_Id) is
11030    begin
11031       Set_Name_Table_Info (Id, Int (Val));
11032    end Set_Name_Entity_Id;
11033
11034    ---------------------
11035    -- Set_Next_Actual --
11036    ---------------------
11037
11038    procedure Set_Next_Actual (Ass1_Id : Node_Id; Ass2_Id : Node_Id) is
11039    begin
11040       if Nkind (Parent (Ass1_Id)) = N_Parameter_Association then
11041          Set_First_Named_Actual (Parent (Ass1_Id), Ass2_Id);
11042       end if;
11043    end Set_Next_Actual;
11044
11045    ----------------------------------
11046    -- Set_Optimize_Alignment_Flags --
11047    ----------------------------------
11048
11049    procedure Set_Optimize_Alignment_Flags (E : Entity_Id) is
11050    begin
11051       if Optimize_Alignment = 'S' then
11052          Set_Optimize_Alignment_Space (E);
11053       elsif Optimize_Alignment = 'T' then
11054          Set_Optimize_Alignment_Time (E);
11055       end if;
11056    end Set_Optimize_Alignment_Flags;
11057
11058    -----------------------
11059    -- Set_Public_Status --
11060    -----------------------
11061
11062    procedure Set_Public_Status (Id : Entity_Id) is
11063       S : constant Entity_Id := Current_Scope;
11064
11065       function Within_HSS_Or_If (E : Entity_Id) return Boolean;
11066       --  Determines if E is defined within handled statement sequence or
11067       --  an if statement, returns True if so, False otherwise.
11068
11069       ----------------------
11070       -- Within_HSS_Or_If --
11071       ----------------------
11072
11073       function Within_HSS_Or_If (E : Entity_Id) return Boolean is
11074          N : Node_Id;
11075       begin
11076          N := Declaration_Node (E);
11077          loop
11078             N := Parent (N);
11079
11080             if No (N) then
11081                return False;
11082
11083             elsif Nkind_In (N, N_Handled_Sequence_Of_Statements,
11084                                N_If_Statement)
11085             then
11086                return True;
11087             end if;
11088          end loop;
11089       end Within_HSS_Or_If;
11090
11091    --  Start of processing for Set_Public_Status
11092
11093    begin
11094       --  Everything in the scope of Standard is public
11095
11096       if S = Standard_Standard then
11097          Set_Is_Public (Id);
11098
11099       --  Entity is definitely not public if enclosing scope is not public
11100
11101       elsif not Is_Public (S) then
11102          return;
11103
11104       --  An object or function declaration that occurs in a handled sequence
11105       --  of statements or within an if statement is the declaration for a
11106       --  temporary object or local subprogram generated by the expander. It
11107       --  never needs to be made public and furthermore, making it public can
11108       --  cause back end problems.
11109
11110       elsif Nkind_In (Parent (Id), N_Object_Declaration,
11111                                    N_Function_Specification)
11112         and then Within_HSS_Or_If (Id)
11113       then
11114          return;
11115
11116       --  Entities in public packages or records are public
11117
11118       elsif Ekind (S) = E_Package or Is_Record_Type (S) then
11119          Set_Is_Public (Id);
11120
11121       --  The bounds of an entry family declaration can generate object
11122       --  declarations that are visible to the back-end, e.g. in the
11123       --  the declaration of a composite type that contains tasks.
11124
11125       elsif Is_Concurrent_Type (S)
11126         and then not Has_Completion (S)
11127         and then Nkind (Parent (Id)) = N_Object_Declaration
11128       then
11129          Set_Is_Public (Id);
11130       end if;
11131    end Set_Public_Status;
11132
11133    -----------------------------
11134    -- Set_Referenced_Modified --
11135    -----------------------------
11136
11137    procedure Set_Referenced_Modified (N : Node_Id; Out_Param : Boolean) is
11138       Pref : Node_Id;
11139
11140    begin
11141       --  Deal with indexed or selected component where prefix is modified
11142
11143       if Nkind_In (N, N_Indexed_Component, N_Selected_Component) then
11144          Pref := Prefix (N);
11145
11146          --  If prefix is access type, then it is the designated object that is
11147          --  being modified, which means we have no entity to set the flag on.
11148
11149          if No (Etype (Pref)) or else Is_Access_Type (Etype (Pref)) then
11150             return;
11151
11152             --  Otherwise chase the prefix
11153
11154          else
11155             Set_Referenced_Modified (Pref, Out_Param);
11156          end if;
11157
11158       --  Otherwise see if we have an entity name (only other case to process)
11159
11160       elsif Is_Entity_Name (N) and then Present (Entity (N)) then
11161          Set_Referenced_As_LHS           (Entity (N), not Out_Param);
11162          Set_Referenced_As_Out_Parameter (Entity (N), Out_Param);
11163       end if;
11164    end Set_Referenced_Modified;
11165
11166    ----------------------------
11167    -- Set_Scope_Is_Transient --
11168    ----------------------------
11169
11170    procedure Set_Scope_Is_Transient (V : Boolean := True) is
11171    begin
11172       Scope_Stack.Table (Scope_Stack.Last).Is_Transient := V;
11173    end Set_Scope_Is_Transient;
11174
11175    -------------------
11176    -- Set_Size_Info --
11177    -------------------
11178
11179    procedure Set_Size_Info (T1, T2 : Entity_Id) is
11180    begin
11181       --  We copy Esize, but not RM_Size, since in general RM_Size is
11182       --  subtype specific and does not get inherited by all subtypes.
11183
11184       Set_Esize                     (T1, Esize                     (T2));
11185       Set_Has_Biased_Representation (T1, Has_Biased_Representation (T2));
11186
11187       if Is_Discrete_Or_Fixed_Point_Type (T1)
11188            and then
11189          Is_Discrete_Or_Fixed_Point_Type (T2)
11190       then
11191          Set_Is_Unsigned_Type       (T1, Is_Unsigned_Type          (T2));
11192       end if;
11193
11194       Set_Alignment                 (T1, Alignment                 (T2));
11195    end Set_Size_Info;
11196
11197    --------------------
11198    -- Static_Integer --
11199    --------------------
11200
11201    function Static_Integer (N : Node_Id) return Uint is
11202    begin
11203       Analyze_And_Resolve (N, Any_Integer);
11204
11205       if N = Error
11206         or else Error_Posted (N)
11207         or else Etype (N) = Any_Type
11208       then
11209          return No_Uint;
11210       end if;
11211
11212       if Is_Static_Expression (N) then
11213          if not Raises_Constraint_Error (N) then
11214             return Expr_Value (N);
11215          else
11216             return No_Uint;
11217          end if;
11218
11219       elsif Etype (N) = Any_Type then
11220          return No_Uint;
11221
11222       else
11223          Flag_Non_Static_Expr
11224            ("static integer expression required here", N);
11225          return No_Uint;
11226       end if;
11227    end Static_Integer;
11228
11229    --------------------------
11230    -- Statically_Different --
11231    --------------------------
11232
11233    function Statically_Different (E1, E2 : Node_Id) return Boolean is
11234       R1 : constant Node_Id := Get_Referenced_Object (E1);
11235       R2 : constant Node_Id := Get_Referenced_Object (E2);
11236    begin
11237       return     Is_Entity_Name (R1)
11238         and then Is_Entity_Name (R2)
11239         and then Entity (R1) /= Entity (R2)
11240         and then not Is_Formal (Entity (R1))
11241         and then not Is_Formal (Entity (R2));
11242    end Statically_Different;
11243
11244    -----------------------------
11245    -- Subprogram_Access_Level --
11246    -----------------------------
11247
11248    function Subprogram_Access_Level (Subp : Entity_Id) return Uint is
11249    begin
11250       if Present (Alias (Subp)) then
11251          return Subprogram_Access_Level (Alias (Subp));
11252       else
11253          return Scope_Depth (Enclosing_Dynamic_Scope (Subp));
11254       end if;
11255    end Subprogram_Access_Level;
11256
11257    -----------------
11258    -- Trace_Scope --
11259    -----------------
11260
11261    procedure Trace_Scope (N : Node_Id; E : Entity_Id; Msg : String) is
11262    begin
11263       if Debug_Flag_W then
11264          for J in 0 .. Scope_Stack.Last loop
11265             Write_Str ("  ");
11266          end loop;
11267
11268          Write_Str (Msg);
11269          Write_Name (Chars (E));
11270          Write_Str (" from ");
11271          Write_Location (Sloc (N));
11272          Write_Eol;
11273       end if;
11274    end Trace_Scope;
11275
11276    -----------------------
11277    -- Transfer_Entities --
11278    -----------------------
11279
11280    procedure Transfer_Entities (From : Entity_Id; To : Entity_Id) is
11281       Ent : Entity_Id := First_Entity (From);
11282
11283    begin
11284       if No (Ent) then
11285          return;
11286       end if;
11287
11288       if (Last_Entity (To)) = Empty then
11289          Set_First_Entity (To, Ent);
11290       else
11291          Set_Next_Entity (Last_Entity (To), Ent);
11292       end if;
11293
11294       Set_Last_Entity (To, Last_Entity (From));
11295
11296       while Present (Ent) loop
11297          Set_Scope (Ent, To);
11298
11299          if not Is_Public (Ent) then
11300             Set_Public_Status (Ent);
11301
11302             if Is_Public (Ent)
11303               and then Ekind (Ent) = E_Record_Subtype
11304
11305             then
11306                --  The components of the propagated Itype must be public
11307                --  as well.
11308
11309                declare
11310                   Comp : Entity_Id;
11311                begin
11312                   Comp := First_Entity (Ent);
11313                   while Present (Comp) loop
11314                      Set_Is_Public (Comp);
11315                      Next_Entity (Comp);
11316                   end loop;
11317                end;
11318             end if;
11319          end if;
11320
11321          Next_Entity (Ent);
11322       end loop;
11323
11324       Set_First_Entity (From, Empty);
11325       Set_Last_Entity (From, Empty);
11326    end Transfer_Entities;
11327
11328    -----------------------
11329    -- Type_Access_Level --
11330    -----------------------
11331
11332    function Type_Access_Level (Typ : Entity_Id) return Uint is
11333       Btyp : Entity_Id;
11334
11335    begin
11336       Btyp := Base_Type (Typ);
11337
11338       --  Ada 2005 (AI-230): For most cases of anonymous access types, we
11339       --  simply use the level where the type is declared. This is true for
11340       --  stand-alone object declarations, and for anonymous access types
11341       --  associated with components the level is the same as that of the
11342       --  enclosing composite type. However, special treatment is needed for
11343       --  the cases of access parameters, return objects of an anonymous access
11344       --  type, and, in Ada 95, access discriminants of limited types.
11345
11346       if Ekind (Btyp) in Access_Kind then
11347          if Ekind (Btyp) = E_Anonymous_Access_Type then
11348
11349             --  If the type is a nonlocal anonymous access type (such as for
11350             --  an access parameter) we treat it as being declared at the
11351             --  library level to ensure that names such as X.all'access don't
11352             --  fail static accessibility checks.
11353
11354             if not Is_Local_Anonymous_Access (Typ) then
11355                return Scope_Depth (Standard_Standard);
11356
11357             --  If this is a return object, the accessibility level is that of
11358             --  the result subtype of the enclosing function. The test here is
11359             --  little complicated, because we have to account for extended
11360             --  return statements that have been rewritten as blocks, in which
11361             --  case we have to find and the Is_Return_Object attribute of the
11362             --  itype's associated object. It would be nice to find a way to
11363             --  simplify this test, but it doesn't seem worthwhile to add a new
11364             --  flag just for purposes of this test. ???
11365
11366             elsif Ekind (Scope (Btyp)) = E_Return_Statement
11367               or else
11368                 (Is_Itype (Btyp)
11369                   and then Nkind (Associated_Node_For_Itype (Btyp)) =
11370                              N_Object_Declaration
11371                   and then Is_Return_Object
11372                              (Defining_Identifier
11373                                 (Associated_Node_For_Itype (Btyp))))
11374             then
11375                declare
11376                   Scop : Entity_Id;
11377
11378                begin
11379                   Scop := Scope (Scope (Btyp));
11380                   while Present (Scop) loop
11381                      exit when Ekind (Scop) = E_Function;
11382                      Scop := Scope (Scop);
11383                   end loop;
11384
11385                   --  Treat the return object's type as having the level of the
11386                   --  function's result subtype (as per RM05-6.5(5.3/2)).
11387
11388                   return Type_Access_Level (Etype (Scop));
11389                end;
11390             end if;
11391          end if;
11392
11393          Btyp := Root_Type (Btyp);
11394
11395          --  The accessibility level of anonymous access types associated with
11396          --  discriminants is that of the current instance of the type, and
11397          --  that's deeper than the type itself (AARM 3.10.2 (12.3.21)).
11398
11399          --  AI-402: access discriminants have accessibility based on the
11400          --  object rather than the type in Ada 2005, so the above paragraph
11401          --  doesn't apply.
11402
11403          --  ??? Needs completion with rules from AI-416
11404
11405          if Ada_Version <= Ada_95
11406            and then Ekind (Typ) = E_Anonymous_Access_Type
11407            and then Present (Associated_Node_For_Itype (Typ))
11408            and then Nkind (Associated_Node_For_Itype (Typ)) =
11409                                                  N_Discriminant_Specification
11410          then
11411             return Scope_Depth (Enclosing_Dynamic_Scope (Btyp)) + 1;
11412          end if;
11413       end if;
11414
11415       return Scope_Depth (Enclosing_Dynamic_Scope (Btyp));
11416    end Type_Access_Level;
11417
11418    --------------------------
11419    -- Unit_Declaration_Node --
11420    --------------------------
11421
11422    function Unit_Declaration_Node (Unit_Id : Entity_Id) return Node_Id is
11423       N : Node_Id := Parent (Unit_Id);
11424
11425    begin
11426       --  Predefined operators do not have a full function declaration
11427
11428       if Ekind (Unit_Id) = E_Operator then
11429          return N;
11430       end if;
11431
11432       --  Isn't there some better way to express the following ???
11433
11434       while Nkind (N) /= N_Abstract_Subprogram_Declaration
11435         and then Nkind (N) /= N_Formal_Package_Declaration
11436         and then Nkind (N) /= N_Function_Instantiation
11437         and then Nkind (N) /= N_Generic_Package_Declaration
11438         and then Nkind (N) /= N_Generic_Subprogram_Declaration
11439         and then Nkind (N) /= N_Package_Declaration
11440         and then Nkind (N) /= N_Package_Body
11441         and then Nkind (N) /= N_Package_Instantiation
11442         and then Nkind (N) /= N_Package_Renaming_Declaration
11443         and then Nkind (N) /= N_Procedure_Instantiation
11444         and then Nkind (N) /= N_Protected_Body
11445         and then Nkind (N) /= N_Subprogram_Declaration
11446         and then Nkind (N) /= N_Subprogram_Body
11447         and then Nkind (N) /= N_Subprogram_Body_Stub
11448         and then Nkind (N) /= N_Subprogram_Renaming_Declaration
11449         and then Nkind (N) /= N_Task_Body
11450         and then Nkind (N) /= N_Task_Type_Declaration
11451         and then Nkind (N) not in N_Formal_Subprogram_Declaration
11452         and then Nkind (N) not in N_Generic_Renaming_Declaration
11453       loop
11454          N := Parent (N);
11455          pragma Assert (Present (N));
11456       end loop;
11457
11458       return N;
11459    end Unit_Declaration_Node;
11460
11461    ------------------------------
11462    -- Universal_Interpretation --
11463    ------------------------------
11464
11465    function Universal_Interpretation (Opnd : Node_Id) return Entity_Id is
11466       Index : Interp_Index;
11467       It    : Interp;
11468
11469    begin
11470       --  The argument may be a formal parameter of an operator or subprogram
11471       --  with multiple interpretations, or else an expression for an actual.
11472
11473       if Nkind (Opnd) = N_Defining_Identifier
11474         or else not Is_Overloaded (Opnd)
11475       then
11476          if Etype (Opnd) = Universal_Integer
11477            or else Etype (Opnd) = Universal_Real
11478          then
11479             return Etype (Opnd);
11480          else
11481             return Empty;
11482          end if;
11483
11484       else
11485          Get_First_Interp (Opnd, Index, It);
11486          while Present (It.Typ) loop
11487             if It.Typ = Universal_Integer
11488               or else It.Typ = Universal_Real
11489             then
11490                return It.Typ;
11491             end if;
11492
11493             Get_Next_Interp (Index, It);
11494          end loop;
11495
11496          return Empty;
11497       end if;
11498    end Universal_Interpretation;
11499
11500    ---------------
11501    -- Unqualify --
11502    ---------------
11503
11504    function Unqualify (Expr : Node_Id) return Node_Id is
11505    begin
11506       --  Recurse to handle unlikely case of multiple levels of qualification
11507
11508       if Nkind (Expr) = N_Qualified_Expression then
11509          return Unqualify (Expression (Expr));
11510
11511       --  Normal case, not a qualified expression
11512
11513       else
11514          return Expr;
11515       end if;
11516    end Unqualify;
11517
11518    -----------------------
11519    -- Visible_Ancestors --
11520    -----------------------
11521
11522    function Visible_Ancestors (Typ : Entity_Id) return Elist_Id is
11523       List_1 : Elist_Id;
11524       List_2 : Elist_Id;
11525       Elmt   : Elmt_Id;
11526
11527    begin
11528       pragma Assert (Is_Record_Type (Typ)
11529         and then Is_Tagged_Type (Typ));
11530
11531       --  Collect all the parents and progenitors of Typ. If the full-view of
11532       --  private parents and progenitors is available then it is used to
11533       --  generate the list of visible ancestors; otherwise their partial
11534       --  view is added to the resulting list.
11535
11536       Collect_Parents
11537         (T               => Typ,
11538          List            => List_1,
11539          Use_Full_View   => True);
11540
11541       Collect_Interfaces
11542         (T               => Typ,
11543          Ifaces_List     => List_2,
11544          Exclude_Parents => True,
11545          Use_Full_View   => True);
11546
11547       --  Join the two lists. Avoid duplications because an interface may
11548       --  simultaneously be parent and progenitor of a type.
11549
11550       Elmt := First_Elmt (List_2);
11551       while Present (Elmt) loop
11552          Append_Unique_Elmt (Node (Elmt), List_1);
11553          Next_Elmt (Elmt);
11554       end loop;
11555
11556       return List_1;
11557    end Visible_Ancestors;
11558
11559    ----------------------
11560    -- Within_Init_Proc --
11561    ----------------------
11562
11563    function Within_Init_Proc return Boolean is
11564       S : Entity_Id;
11565
11566    begin
11567       S := Current_Scope;
11568       while not Is_Overloadable (S) loop
11569          if S = Standard_Standard then
11570             return False;
11571          else
11572             S := Scope (S);
11573          end if;
11574       end loop;
11575
11576       return Is_Init_Proc (S);
11577    end Within_Init_Proc;
11578
11579    ----------------
11580    -- Wrong_Type --
11581    ----------------
11582
11583    procedure Wrong_Type (Expr : Node_Id; Expected_Type : Entity_Id) is
11584       Found_Type : constant Entity_Id := First_Subtype (Etype (Expr));
11585       Expec_Type : constant Entity_Id := First_Subtype (Expected_Type);
11586
11587       function Has_One_Matching_Field return Boolean;
11588       --  Determines if Expec_Type is a record type with a single component or
11589       --  discriminant whose type matches the found type or is one dimensional
11590       --  array whose component type matches the found type.
11591
11592       ----------------------------
11593       -- Has_One_Matching_Field --
11594       ----------------------------
11595
11596       function Has_One_Matching_Field return Boolean is
11597          E : Entity_Id;
11598
11599       begin
11600          if Is_Array_Type (Expec_Type)
11601            and then Number_Dimensions (Expec_Type) = 1
11602            and then
11603              Covers (Etype (Component_Type (Expec_Type)), Found_Type)
11604          then
11605             return True;
11606
11607          elsif not Is_Record_Type (Expec_Type) then
11608             return False;
11609
11610          else
11611             E := First_Entity (Expec_Type);
11612             loop
11613                if No (E) then
11614                   return False;
11615
11616                elsif (Ekind (E) /= E_Discriminant
11617                        and then Ekind (E) /= E_Component)
11618                  or else (Chars (E) = Name_uTag
11619                            or else Chars (E) = Name_uParent)
11620                then
11621                   Next_Entity (E);
11622
11623                else
11624                   exit;
11625                end if;
11626             end loop;
11627
11628             if not Covers (Etype (E), Found_Type) then
11629                return False;
11630
11631             elsif Present (Next_Entity (E)) then
11632                return False;
11633
11634             else
11635                return True;
11636             end if;
11637          end if;
11638       end Has_One_Matching_Field;
11639
11640    --  Start of processing for Wrong_Type
11641
11642    begin
11643       --  Don't output message if either type is Any_Type, or if a message
11644       --  has already been posted for this node. We need to do the latter
11645       --  check explicitly (it is ordinarily done in Errout), because we
11646       --  are using ! to force the output of the error messages.
11647
11648       if Expec_Type = Any_Type
11649         or else Found_Type = Any_Type
11650         or else Error_Posted (Expr)
11651       then
11652          return;
11653
11654       --  In  an instance, there is an ongoing problem with completion of
11655       --  type derived from private types. Their structure is what Gigi
11656       --  expects, but the  Etype is the parent type rather than the
11657       --  derived private type itself. Do not flag error in this case. The
11658       --  private completion is an entity without a parent, like an Itype.
11659       --  Similarly, full and partial views may be incorrect in the instance.
11660       --  There is no simple way to insure that it is consistent ???
11661
11662       elsif In_Instance then
11663          if Etype (Etype (Expr)) = Etype (Expected_Type)
11664            and then
11665              (Has_Private_Declaration (Expected_Type)
11666                or else Has_Private_Declaration (Etype (Expr)))
11667            and then No (Parent (Expected_Type))
11668          then
11669             return;
11670          end if;
11671       end if;
11672
11673       --  An interesting special check. If the expression is parenthesized
11674       --  and its type corresponds to the type of the sole component of the
11675       --  expected record type, or to the component type of the expected one
11676       --  dimensional array type, then assume we have a bad aggregate attempt.
11677
11678       if Nkind (Expr) in N_Subexpr
11679         and then Paren_Count (Expr) /= 0
11680         and then Has_One_Matching_Field
11681       then
11682          Error_Msg_N ("positional aggregate cannot have one component", Expr);
11683
11684       --  Another special check, if we are looking for a pool-specific access
11685       --  type and we found an E_Access_Attribute_Type, then we have the case
11686       --  of an Access attribute being used in a context which needs a pool-
11687       --  specific type, which is never allowed. The one extra check we make
11688       --  is that the expected designated type covers the Found_Type.
11689
11690       elsif Is_Access_Type (Expec_Type)
11691         and then Ekind (Found_Type) = E_Access_Attribute_Type
11692         and then Ekind (Base_Type (Expec_Type)) /= E_General_Access_Type
11693         and then Ekind (Base_Type (Expec_Type)) /= E_Anonymous_Access_Type
11694         and then Covers
11695           (Designated_Type (Expec_Type), Designated_Type (Found_Type))
11696       then
11697          Error_Msg_N -- CODEFIX
11698            ("result must be general access type!", Expr);
11699          Error_Msg_NE -- CODEFIX
11700            ("add ALL to }!", Expr, Expec_Type);
11701
11702       --  Another special check, if the expected type is an integer type,
11703       --  but the expression is of type System.Address, and the parent is
11704       --  an addition or subtraction operation whose left operand is the
11705       --  expression in question and whose right operand is of an integral
11706       --  type, then this is an attempt at address arithmetic, so give
11707       --  appropriate message.
11708
11709       elsif Is_Integer_Type (Expec_Type)
11710         and then Is_RTE (Found_Type, RE_Address)
11711         and then (Nkind (Parent (Expr)) = N_Op_Add
11712                     or else
11713                   Nkind (Parent (Expr)) = N_Op_Subtract)
11714         and then Expr = Left_Opnd (Parent (Expr))
11715         and then Is_Integer_Type (Etype (Right_Opnd (Parent (Expr))))
11716       then
11717          Error_Msg_N
11718            ("address arithmetic not predefined in package System",
11719             Parent (Expr));
11720          Error_Msg_N
11721            ("\possible missing with/use of System.Storage_Elements",
11722             Parent (Expr));
11723          return;
11724
11725       --  If the expected type is an anonymous access type, as for access
11726       --  parameters and discriminants, the error is on the designated types.
11727
11728       elsif Ekind (Expec_Type) = E_Anonymous_Access_Type then
11729          if Comes_From_Source (Expec_Type) then
11730             Error_Msg_NE ("expected}!", Expr, Expec_Type);
11731          else
11732             Error_Msg_NE
11733               ("expected an access type with designated}",
11734                  Expr, Designated_Type (Expec_Type));
11735          end if;
11736
11737          if Is_Access_Type (Found_Type)
11738            and then not Comes_From_Source (Found_Type)
11739          then
11740             Error_Msg_NE
11741               ("\\found an access type with designated}!",
11742                 Expr, Designated_Type (Found_Type));
11743          else
11744             if From_With_Type (Found_Type) then
11745                Error_Msg_NE ("\\found incomplete}!", Expr, Found_Type);
11746                Error_Msg_Qual_Level := 99;
11747                Error_Msg_NE -- CODEFIX
11748                  ("\\missing `WITH &;", Expr, Scope (Found_Type));
11749                Error_Msg_Qual_Level := 0;
11750             else
11751                Error_Msg_NE ("found}!", Expr, Found_Type);
11752             end if;
11753          end if;
11754
11755       --  Normal case of one type found, some other type expected
11756
11757       else
11758          --  If the names of the two types are the same, see if some number
11759          --  of levels of qualification will help. Don't try more than three
11760          --  levels, and if we get to standard, it's no use (and probably
11761          --  represents an error in the compiler) Also do not bother with
11762          --  internal scope names.
11763
11764          declare
11765             Expec_Scope : Entity_Id;
11766             Found_Scope : Entity_Id;
11767
11768          begin
11769             Expec_Scope := Expec_Type;
11770             Found_Scope := Found_Type;
11771
11772             for Levels in Int range 0 .. 3 loop
11773                if Chars (Expec_Scope) /= Chars (Found_Scope) then
11774                   Error_Msg_Qual_Level := Levels;
11775                   exit;
11776                end if;
11777
11778                Expec_Scope := Scope (Expec_Scope);
11779                Found_Scope := Scope (Found_Scope);
11780
11781                exit when Expec_Scope = Standard_Standard
11782                  or else Found_Scope = Standard_Standard
11783                  or else not Comes_From_Source (Expec_Scope)
11784                  or else not Comes_From_Source (Found_Scope);
11785             end loop;
11786          end;
11787
11788          if Is_Record_Type (Expec_Type)
11789            and then Present (Corresponding_Remote_Type (Expec_Type))
11790          then
11791             Error_Msg_NE ("expected}!", Expr,
11792                           Corresponding_Remote_Type (Expec_Type));
11793          else
11794             Error_Msg_NE ("expected}!", Expr, Expec_Type);
11795          end if;
11796
11797          if Is_Entity_Name (Expr)
11798            and then Is_Package_Or_Generic_Package (Entity (Expr))
11799          then
11800             Error_Msg_N ("\\found package name!", Expr);
11801
11802          elsif Is_Entity_Name (Expr)
11803            and then
11804              (Ekind (Entity (Expr)) = E_Procedure
11805                 or else
11806               Ekind (Entity (Expr)) = E_Generic_Procedure)
11807          then
11808             if Ekind (Expec_Type) = E_Access_Subprogram_Type then
11809                Error_Msg_N
11810                  ("found procedure name, possibly missing Access attribute!",
11811                    Expr);
11812             else
11813                Error_Msg_N
11814                  ("\\found procedure name instead of function!", Expr);
11815             end if;
11816
11817          elsif Nkind (Expr) = N_Function_Call
11818            and then Ekind (Expec_Type) = E_Access_Subprogram_Type
11819            and then Etype (Designated_Type (Expec_Type)) = Etype (Expr)
11820            and then No (Parameter_Associations (Expr))
11821          then
11822             Error_Msg_N
11823               ("found function name, possibly missing Access attribute!",
11824                Expr);
11825
11826          --  Catch common error: a prefix or infix operator which is not
11827          --  directly visible because the type isn't.
11828
11829          elsif Nkind (Expr) in N_Op
11830             and then Is_Overloaded (Expr)
11831             and then not Is_Immediately_Visible (Expec_Type)
11832             and then not Is_Potentially_Use_Visible (Expec_Type)
11833             and then not In_Use (Expec_Type)
11834             and then Has_Compatible_Type (Right_Opnd (Expr), Expec_Type)
11835          then
11836             Error_Msg_N
11837               ("operator of the type is not directly visible!", Expr);
11838
11839          elsif Ekind (Found_Type) = E_Void
11840            and then Present (Parent (Found_Type))
11841            and then Nkind (Parent (Found_Type)) = N_Full_Type_Declaration
11842          then
11843             Error_Msg_NE ("\\found premature usage of}!", Expr, Found_Type);
11844
11845          else
11846             Error_Msg_NE ("\\found}!", Expr, Found_Type);
11847          end if;
11848
11849          --  A special check for cases like M1 and M2 = 0 where M1 and M2 are
11850          --  of the same modular type, and (M1 and M2) = 0 was intended.
11851
11852          if Expec_Type = Standard_Boolean
11853            and then Is_Modular_Integer_Type (Found_Type)
11854            and then Nkind_In (Parent (Expr), N_Op_And, N_Op_Or, N_Op_Xor)
11855            and then Nkind (Right_Opnd (Parent (Expr))) in N_Op_Compare
11856          then
11857             declare
11858                Op : constant Node_Id := Right_Opnd (Parent (Expr));
11859                L  : constant Node_Id := Left_Opnd (Op);
11860                R  : constant Node_Id := Right_Opnd (Op);
11861             begin
11862                --  The case for the message is when the left operand of the
11863                --  comparison is the same modular type, or when it is an
11864                --  integer literal (or other universal integer expression),
11865                --  which would have been typed as the modular type if the
11866                --  parens had been there.
11867
11868                if (Etype (L) = Found_Type
11869                      or else
11870                    Etype (L) = Universal_Integer)
11871                  and then Is_Integer_Type (Etype (R))
11872                then
11873                   Error_Msg_N
11874                     ("\\possible missing parens for modular operation", Expr);
11875                end if;
11876             end;
11877          end if;
11878
11879          --  Reset error message qualification indication
11880
11881          Error_Msg_Qual_Level := 0;
11882       end if;
11883    end Wrong_Type;
11884
11885 end Sem_Util;