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-2011, 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_Threshold : 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 threshold 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 Present (Overridden_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       P    : Elmt_Id;
4893
4894    begin
4895       if Is_Controlled (BT) then
4896          if Is_RTU (Scope (BT), Ada_Finalization) then
4897             return False;
4898
4899          elsif Present (Primitive_Operations (BT)) then
4900             P := First_Elmt (Primitive_Operations (BT));
4901             while Present (P) loop
4902                declare
4903                   Init : constant Entity_Id := Node (P);
4904                   Formal : constant Entity_Id := First_Formal (Init);
4905                begin
4906                   if Ekind (Init) = E_Procedure
4907                        and then Chars (Init) = Name_Initialize
4908                        and then Comes_From_Source (Init)
4909                        and then Present (Formal)
4910                        and then Etype (Formal) = BT
4911                        and then No (Next_Formal (Formal))
4912                        and then (Ada_Version < Ada_2012
4913                                    or else not Null_Present (Parent (Init)))
4914                   then
4915                      return True;
4916                   end if;
4917                end;
4918
4919                Next_Elmt (P);
4920             end loop;
4921          end if;
4922
4923          --  Here if type itself does not have a non-null Initialize operation:
4924          --  check immediate ancestor.
4925
4926          if Is_Derived_Type (BT)
4927            and then Has_Overriding_Initialize (Etype (BT))
4928          then
4929             return True;
4930          end if;
4931       end if;
4932
4933       return False;
4934    end Has_Overriding_Initialize;
4935
4936    --------------------------------------
4937    -- Has_Preelaborable_Initialization --
4938    --------------------------------------
4939
4940    function Has_Preelaborable_Initialization (E : Entity_Id) return Boolean is
4941       Has_PE : Boolean;
4942
4943       procedure Check_Components (E : Entity_Id);
4944       --  Check component/discriminant chain, sets Has_PE False if a component
4945       --  or discriminant does not meet the preelaborable initialization rules.
4946
4947       ----------------------
4948       -- Check_Components --
4949       ----------------------
4950
4951       procedure Check_Components (E : Entity_Id) is
4952          Ent : Entity_Id;
4953          Exp : Node_Id;
4954
4955          function Is_Preelaborable_Expression (N : Node_Id) return Boolean;
4956          --  Returns True if and only if the expression denoted by N does not
4957          --  violate restrictions on preelaborable constructs (RM-10.2.1(5-9)).
4958
4959          ---------------------------------
4960          -- Is_Preelaborable_Expression --
4961          ---------------------------------
4962
4963          function Is_Preelaborable_Expression (N : Node_Id) return Boolean is
4964             Exp           : Node_Id;
4965             Assn          : Node_Id;
4966             Choice        : Node_Id;
4967             Comp_Type     : Entity_Id;
4968             Is_Array_Aggr : Boolean;
4969
4970          begin
4971             if Is_Static_Expression (N) then
4972                return True;
4973
4974             elsif Nkind (N) = N_Null then
4975                return True;
4976
4977             --  Attributes are allowed in general, even if their prefix is a
4978             --  formal type. (It seems that certain attributes known not to be
4979             --  static might not be allowed, but there are no rules to prevent
4980             --  them.)
4981
4982             elsif Nkind (N) = N_Attribute_Reference then
4983                return True;
4984
4985             --  The name of a discriminant evaluated within its parent type is
4986             --  defined to be preelaborable (10.2.1(8)). Note that we test for
4987             --  names that denote discriminals as well as discriminants to
4988             --  catch references occurring within init procs.
4989
4990             elsif Is_Entity_Name (N)
4991               and then
4992                 (Ekind (Entity (N)) = E_Discriminant
4993                   or else
4994                     ((Ekind (Entity (N)) = E_Constant
4995                        or else Ekind (Entity (N)) = E_In_Parameter)
4996                      and then Present (Discriminal_Link (Entity (N)))))
4997             then
4998                return True;
4999
5000             elsif Nkind (N) = N_Qualified_Expression then
5001                return Is_Preelaborable_Expression (Expression (N));
5002
5003             --  For aggregates we have to check that each of the associations
5004             --  is preelaborable.
5005
5006             elsif Nkind (N) = N_Aggregate
5007               or else Nkind (N) = N_Extension_Aggregate
5008             then
5009                Is_Array_Aggr := Is_Array_Type (Etype (N));
5010
5011                if Is_Array_Aggr then
5012                   Comp_Type := Component_Type (Etype (N));
5013                end if;
5014
5015                --  Check the ancestor part of extension aggregates, which must
5016                --  be either the name of a type that has preelaborable init or
5017                --  an expression that is preelaborable.
5018
5019                if Nkind (N) = N_Extension_Aggregate then
5020                   declare
5021                      Anc_Part : constant Node_Id := Ancestor_Part (N);
5022
5023                   begin
5024                      if Is_Entity_Name (Anc_Part)
5025                        and then Is_Type (Entity (Anc_Part))
5026                      then
5027                         if not Has_Preelaborable_Initialization
5028                                  (Entity (Anc_Part))
5029                         then
5030                            return False;
5031                         end if;
5032
5033                      elsif not Is_Preelaborable_Expression (Anc_Part) then
5034                         return False;
5035                      end if;
5036                   end;
5037                end if;
5038
5039                --  Check positional associations
5040
5041                Exp := First (Expressions (N));
5042                while Present (Exp) loop
5043                   if not Is_Preelaborable_Expression (Exp) then
5044                      return False;
5045                   end if;
5046
5047                   Next (Exp);
5048                end loop;
5049
5050                --  Check named associations
5051
5052                Assn := First (Component_Associations (N));
5053                while Present (Assn) loop
5054                   Choice := First (Choices (Assn));
5055                   while Present (Choice) loop
5056                      if Is_Array_Aggr then
5057                         if Nkind (Choice) = N_Others_Choice then
5058                            null;
5059
5060                         elsif Nkind (Choice) = N_Range then
5061                            if not Is_Static_Range (Choice) then
5062                               return False;
5063                            end if;
5064
5065                         elsif not Is_Static_Expression (Choice) then
5066                            return False;
5067                         end if;
5068
5069                      else
5070                         Comp_Type := Etype (Choice);
5071                      end if;
5072
5073                      Next (Choice);
5074                   end loop;
5075
5076                   --  If the association has a <> at this point, then we have
5077                   --  to check whether the component's type has preelaborable
5078                   --  initialization. Note that this only occurs when the
5079                   --  association's corresponding component does not have a
5080                   --  default expression, the latter case having already been
5081                   --  expanded as an expression for the association.
5082
5083                   if Box_Present (Assn) then
5084                      if not Has_Preelaborable_Initialization (Comp_Type) then
5085                         return False;
5086                      end if;
5087
5088                   --  In the expression case we check whether the expression
5089                   --  is preelaborable.
5090
5091                   elsif
5092                     not Is_Preelaborable_Expression (Expression (Assn))
5093                   then
5094                      return False;
5095                   end if;
5096
5097                   Next (Assn);
5098                end loop;
5099
5100                --  If we get here then aggregate as a whole is preelaborable
5101
5102                return True;
5103
5104             --  All other cases are not preelaborable
5105
5106             else
5107                return False;
5108             end if;
5109          end Is_Preelaborable_Expression;
5110
5111       --  Start of processing for Check_Components
5112
5113       begin
5114          --  Loop through entities of record or protected type
5115
5116          Ent := E;
5117          while Present (Ent) loop
5118
5119             --  We are interested only in components and discriminants
5120
5121             Exp := Empty;
5122
5123             case Ekind (Ent) is
5124                when E_Component =>
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 such 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                   end if;
5134
5135                when E_Discriminant =>
5136
5137                   --  Note: for a renamed discriminant, the Declaration_Node
5138                   --  may point to the one from the ancestor, and have a
5139                   --  different expression, so use the proper attribute to
5140                   --  retrieve the expression from the derived constraint.
5141
5142                   Exp := Discriminant_Default_Value (Ent);
5143
5144                when others =>
5145                   goto Check_Next_Entity;
5146             end case;
5147
5148             --  A component has PI if it has no default expression and the
5149             --  component type has PI.
5150
5151             if No (Exp) then
5152                if not Has_Preelaborable_Initialization (Etype (Ent)) then
5153                   Has_PE := False;
5154                   exit;
5155                end if;
5156
5157             --  Require the default expression to be preelaborable
5158
5159             elsif not Is_Preelaborable_Expression (Exp) then
5160                Has_PE := False;
5161                exit;
5162             end if;
5163
5164          <<Check_Next_Entity>>
5165             Next_Entity (Ent);
5166          end loop;
5167       end Check_Components;
5168
5169    --  Start of processing for Has_Preelaborable_Initialization
5170
5171    begin
5172       --  Immediate return if already marked as known preelaborable init. This
5173       --  covers types for which this function has already been called once
5174       --  and returned True (in which case the result is cached), and also
5175       --  types to which a pragma Preelaborable_Initialization applies.
5176
5177       if Known_To_Have_Preelab_Init (E) then
5178          return True;
5179       end if;
5180
5181       --  If the type is a subtype representing a generic actual type, then
5182       --  test whether its base type has preelaborable initialization since
5183       --  the subtype representing the actual does not inherit this attribute
5184       --  from the actual or formal. (but maybe it should???)
5185
5186       if Is_Generic_Actual_Type (E) then
5187          return Has_Preelaborable_Initialization (Base_Type (E));
5188       end if;
5189
5190       --  All elementary types have preelaborable initialization
5191
5192       if Is_Elementary_Type (E) then
5193          Has_PE := True;
5194
5195       --  Array types have PI if the component type has PI
5196
5197       elsif Is_Array_Type (E) then
5198          Has_PE := Has_Preelaborable_Initialization (Component_Type (E));
5199
5200       --  A derived type has preelaborable initialization if its parent type
5201       --  has preelaborable initialization and (in the case of a derived record
5202       --  extension) if the non-inherited components all have preelaborable
5203       --  initialization. However, a user-defined controlled type with an
5204       --  overriding Initialize procedure does not have preelaborable
5205       --  initialization.
5206
5207       elsif Is_Derived_Type (E) then
5208
5209          --  If the derived type is a private extension then it doesn't have
5210          --  preelaborable initialization.
5211
5212          if Ekind (Base_Type (E)) = E_Record_Type_With_Private then
5213             return False;
5214          end if;
5215
5216          --  First check whether ancestor type has preelaborable initialization
5217
5218          Has_PE := Has_Preelaborable_Initialization (Etype (Base_Type (E)));
5219
5220          --  If OK, check extension components (if any)
5221
5222          if Has_PE and then Is_Record_Type (E) then
5223             Check_Components (First_Entity (E));
5224          end if;
5225
5226          --  Check specifically for 10.2.1(11.4/2) exception: a controlled type
5227          --  with a user defined Initialize procedure does not have PI.
5228
5229          if Has_PE
5230            and then Is_Controlled (E)
5231            and then Has_Overriding_Initialize (E)
5232          then
5233             Has_PE := False;
5234          end if;
5235
5236       --  Private types not derived from a type having preelaborable init and
5237       --  that are not marked with pragma Preelaborable_Initialization do not
5238       --  have preelaborable initialization.
5239
5240       elsif Is_Private_Type (E) then
5241          return False;
5242
5243       --  Record type has PI if it is non private and all components have PI
5244
5245       elsif Is_Record_Type (E) then
5246          Has_PE := True;
5247          Check_Components (First_Entity (E));
5248
5249       --  Protected types must not have entries, and components must meet
5250       --  same set of rules as for record components.
5251
5252       elsif Is_Protected_Type (E) then
5253          if Has_Entries (E) then
5254             Has_PE := False;
5255          else
5256             Has_PE := True;
5257             Check_Components (First_Entity (E));
5258             Check_Components (First_Private_Entity (E));
5259          end if;
5260
5261       --  Type System.Address always has preelaborable initialization
5262
5263       elsif Is_RTE (E, RE_Address) then
5264          Has_PE := True;
5265
5266       --  In all other cases, type does not have preelaborable initialization
5267
5268       else
5269          return False;
5270       end if;
5271
5272       --  If type has preelaborable initialization, cache result
5273
5274       if Has_PE then
5275          Set_Known_To_Have_Preelab_Init (E);
5276       end if;
5277
5278       return Has_PE;
5279    end Has_Preelaborable_Initialization;
5280
5281    ---------------------------
5282    -- Has_Private_Component --
5283    ---------------------------
5284
5285    function Has_Private_Component (Type_Id : Entity_Id) return Boolean is
5286       Btype     : Entity_Id := Base_Type (Type_Id);
5287       Component : Entity_Id;
5288
5289    begin
5290       if Error_Posted (Type_Id)
5291         or else Error_Posted (Btype)
5292       then
5293          return False;
5294       end if;
5295
5296       if Is_Class_Wide_Type (Btype) then
5297          Btype := Root_Type (Btype);
5298       end if;
5299
5300       if Is_Private_Type (Btype) then
5301          declare
5302             UT : constant Entity_Id := Underlying_Type (Btype);
5303          begin
5304             if No (UT) then
5305                if No (Full_View (Btype)) then
5306                   return not Is_Generic_Type (Btype)
5307                     and then not Is_Generic_Type (Root_Type (Btype));
5308                else
5309                   return not Is_Generic_Type (Root_Type (Full_View (Btype)));
5310                end if;
5311             else
5312                return not Is_Frozen (UT) and then Has_Private_Component (UT);
5313             end if;
5314          end;
5315
5316       elsif Is_Array_Type (Btype) then
5317          return Has_Private_Component (Component_Type (Btype));
5318
5319       elsif Is_Record_Type (Btype) then
5320          Component := First_Component (Btype);
5321          while Present (Component) loop
5322             if Has_Private_Component (Etype (Component)) then
5323                return True;
5324             end if;
5325
5326             Next_Component (Component);
5327          end loop;
5328
5329          return False;
5330
5331       elsif Is_Protected_Type (Btype)
5332         and then Present (Corresponding_Record_Type (Btype))
5333       then
5334          return Has_Private_Component (Corresponding_Record_Type (Btype));
5335
5336       else
5337          return False;
5338       end if;
5339    end Has_Private_Component;
5340
5341    ----------------
5342    -- Has_Stream --
5343    ----------------
5344
5345    function Has_Stream (T : Entity_Id) return Boolean is
5346       E : Entity_Id;
5347
5348    begin
5349       if No (T) then
5350          return False;
5351
5352       elsif Is_RTE (Root_Type (T), RE_Root_Stream_Type) then
5353          return True;
5354
5355       elsif Is_Array_Type (T) then
5356          return Has_Stream (Component_Type (T));
5357
5358       elsif Is_Record_Type (T) then
5359          E := First_Component (T);
5360          while Present (E) loop
5361             if Has_Stream (Etype (E)) then
5362                return True;
5363             else
5364                Next_Component (E);
5365             end if;
5366          end loop;
5367
5368          return False;
5369
5370       elsif Is_Private_Type (T) then
5371          return Has_Stream (Underlying_Type (T));
5372
5373       else
5374          return False;
5375       end if;
5376    end Has_Stream;
5377
5378    ----------------
5379    -- Has_Suffix --
5380    ----------------
5381
5382    function Has_Suffix (E : Entity_Id; Suffix : Character) return Boolean is
5383    begin
5384       Get_Name_String (Chars (E));
5385       return Name_Buffer (Name_Len) = Suffix;
5386    end Has_Suffix;
5387
5388    --------------------------
5389    -- Has_Tagged_Component --
5390    --------------------------
5391
5392    function Has_Tagged_Component (Typ : Entity_Id) return Boolean is
5393       Comp : Entity_Id;
5394
5395    begin
5396       if Is_Private_Type (Typ)
5397         and then Present (Underlying_Type (Typ))
5398       then
5399          return Has_Tagged_Component (Underlying_Type (Typ));
5400
5401       elsif Is_Array_Type (Typ) then
5402          return Has_Tagged_Component (Component_Type (Typ));
5403
5404       elsif Is_Tagged_Type (Typ) then
5405          return True;
5406
5407       elsif Is_Record_Type (Typ) then
5408          Comp := First_Component (Typ);
5409          while Present (Comp) loop
5410             if Has_Tagged_Component (Etype (Comp)) then
5411                return True;
5412             end if;
5413
5414             Next_Component (Comp);
5415          end loop;
5416
5417          return False;
5418
5419       else
5420          return False;
5421       end if;
5422    end Has_Tagged_Component;
5423
5424    -------------------------
5425    -- Implementation_Kind --
5426    -------------------------
5427
5428    function Implementation_Kind (Subp : Entity_Id) return Name_Id is
5429       Impl_Prag : constant Node_Id := Get_Rep_Pragma (Subp, Name_Implemented);
5430    begin
5431       pragma Assert (Present (Impl_Prag));
5432       return
5433         Chars (Expression (Last (Pragma_Argument_Associations (Impl_Prag))));
5434    end Implementation_Kind;
5435
5436    --------------------------
5437    -- Implements_Interface --
5438    --------------------------
5439
5440    function Implements_Interface
5441      (Typ_Ent         : Entity_Id;
5442       Iface_Ent       : Entity_Id;
5443       Exclude_Parents : Boolean := False) return Boolean
5444    is
5445       Ifaces_List : Elist_Id;
5446       Elmt        : Elmt_Id;
5447       Iface       : Entity_Id := Base_Type (Iface_Ent);
5448       Typ         : Entity_Id := Base_Type (Typ_Ent);
5449
5450    begin
5451       if Is_Class_Wide_Type (Typ) then
5452          Typ := Root_Type (Typ);
5453       end if;
5454
5455       if not Has_Interfaces (Typ) then
5456          return False;
5457       end if;
5458
5459       if Is_Class_Wide_Type (Iface) then
5460          Iface := Root_Type (Iface);
5461       end if;
5462
5463       Collect_Interfaces (Typ, Ifaces_List);
5464
5465       Elmt := First_Elmt (Ifaces_List);
5466       while Present (Elmt) loop
5467          if Is_Ancestor (Node (Elmt), Typ)
5468            and then Exclude_Parents
5469          then
5470             null;
5471
5472          elsif Node (Elmt) = Iface then
5473             return True;
5474          end if;
5475
5476          Next_Elmt (Elmt);
5477       end loop;
5478
5479       return False;
5480    end Implements_Interface;
5481
5482    -----------------
5483    -- In_Instance --
5484    -----------------
5485
5486    function In_Instance return Boolean is
5487       Curr_Unit : constant Entity_Id := Cunit_Entity (Current_Sem_Unit);
5488       S         : Entity_Id;
5489
5490    begin
5491       S := Current_Scope;
5492       while Present (S)
5493         and then S /= Standard_Standard
5494       loop
5495          if (Ekind (S) = E_Function
5496               or else Ekind (S) = E_Package
5497               or else Ekind (S) = E_Procedure)
5498            and then Is_Generic_Instance (S)
5499          then
5500             --  A child instance is always compiled in the context of a parent
5501             --  instance. Nevertheless, the actuals are not analyzed in an
5502             --  instance context. We detect this case by examining the current
5503             --  compilation unit, which must be a child instance, and checking
5504             --  that it is not currently on the scope stack.
5505
5506             if Is_Child_Unit (Curr_Unit)
5507               and then
5508                 Nkind (Unit (Cunit (Current_Sem_Unit)))
5509                   = N_Package_Instantiation
5510               and then not In_Open_Scopes (Curr_Unit)
5511             then
5512                return False;
5513             else
5514                return True;
5515             end if;
5516          end if;
5517
5518          S := Scope (S);
5519       end loop;
5520
5521       return False;
5522    end In_Instance;
5523
5524    ----------------------
5525    -- In_Instance_Body --
5526    ----------------------
5527
5528    function In_Instance_Body return Boolean is
5529       S : Entity_Id;
5530
5531    begin
5532       S := Current_Scope;
5533       while Present (S)
5534         and then S /= Standard_Standard
5535       loop
5536          if (Ekind (S) = E_Function
5537               or else Ekind (S) = E_Procedure)
5538            and then Is_Generic_Instance (S)
5539          then
5540             return True;
5541
5542          elsif Ekind (S) = E_Package
5543            and then In_Package_Body (S)
5544            and then Is_Generic_Instance (S)
5545          then
5546             return True;
5547          end if;
5548
5549          S := Scope (S);
5550       end loop;
5551
5552       return False;
5553    end In_Instance_Body;
5554
5555    -----------------------------
5556    -- In_Instance_Not_Visible --
5557    -----------------------------
5558
5559    function In_Instance_Not_Visible return Boolean is
5560       S : Entity_Id;
5561
5562    begin
5563       S := Current_Scope;
5564       while Present (S)
5565         and then S /= Standard_Standard
5566       loop
5567          if (Ekind (S) = E_Function
5568               or else Ekind (S) = E_Procedure)
5569            and then Is_Generic_Instance (S)
5570          then
5571             return True;
5572
5573          elsif Ekind (S) = E_Package
5574            and then (In_Package_Body (S) or else In_Private_Part (S))
5575            and then Is_Generic_Instance (S)
5576          then
5577             return True;
5578          end if;
5579
5580          S := Scope (S);
5581       end loop;
5582
5583       return False;
5584    end In_Instance_Not_Visible;
5585
5586    ------------------------------
5587    -- In_Instance_Visible_Part --
5588    ------------------------------
5589
5590    function In_Instance_Visible_Part return Boolean is
5591       S : Entity_Id;
5592
5593    begin
5594       S := Current_Scope;
5595       while Present (S)
5596         and then S /= Standard_Standard
5597       loop
5598          if Ekind (S) = E_Package
5599            and then Is_Generic_Instance (S)
5600            and then not In_Package_Body (S)
5601            and then not In_Private_Part (S)
5602          then
5603             return True;
5604          end if;
5605
5606          S := Scope (S);
5607       end loop;
5608
5609       return False;
5610    end In_Instance_Visible_Part;
5611
5612    ---------------------
5613    -- In_Package_Body --
5614    ---------------------
5615
5616    function In_Package_Body return Boolean is
5617       S : Entity_Id;
5618
5619    begin
5620       S := Current_Scope;
5621       while Present (S)
5622         and then S /= Standard_Standard
5623       loop
5624          if Ekind (S) = E_Package
5625            and then In_Package_Body (S)
5626          then
5627             return True;
5628          else
5629             S := Scope (S);
5630          end if;
5631       end loop;
5632
5633       return False;
5634    end In_Package_Body;
5635
5636    --------------------------------
5637    -- In_Parameter_Specification --
5638    --------------------------------
5639
5640    function In_Parameter_Specification (N : Node_Id) return Boolean is
5641       PN : Node_Id;
5642
5643    begin
5644       PN := Parent (N);
5645       while Present (PN) loop
5646          if Nkind (PN) = N_Parameter_Specification then
5647             return True;
5648          end if;
5649
5650          PN := Parent (PN);
5651       end loop;
5652
5653       return False;
5654    end In_Parameter_Specification;
5655
5656    --------------------------------------
5657    -- In_Subprogram_Or_Concurrent_Unit --
5658    --------------------------------------
5659
5660    function In_Subprogram_Or_Concurrent_Unit return Boolean is
5661       E : Entity_Id;
5662       K : Entity_Kind;
5663
5664    begin
5665       --  Use scope chain to check successively outer scopes
5666
5667       E := Current_Scope;
5668       loop
5669          K := Ekind (E);
5670
5671          if K in Subprogram_Kind
5672            or else K in Concurrent_Kind
5673            or else K in Generic_Subprogram_Kind
5674          then
5675             return True;
5676
5677          elsif E = Standard_Standard then
5678             return False;
5679          end if;
5680
5681          E := Scope (E);
5682       end loop;
5683    end In_Subprogram_Or_Concurrent_Unit;
5684
5685    ---------------------
5686    -- In_Visible_Part --
5687    ---------------------
5688
5689    function In_Visible_Part (Scope_Id : Entity_Id) return Boolean is
5690    begin
5691       return
5692         Is_Package_Or_Generic_Package (Scope_Id)
5693           and then In_Open_Scopes (Scope_Id)
5694           and then not In_Package_Body (Scope_Id)
5695           and then not In_Private_Part (Scope_Id);
5696    end In_Visible_Part;
5697
5698    ---------------------------------
5699    -- Insert_Explicit_Dereference --
5700    ---------------------------------
5701
5702    procedure Insert_Explicit_Dereference (N : Node_Id) is
5703       New_Prefix : constant Node_Id := Relocate_Node (N);
5704       Ent        : Entity_Id := Empty;
5705       Pref       : Node_Id;
5706       I          : Interp_Index;
5707       It         : Interp;
5708       T          : Entity_Id;
5709
5710    begin
5711       Save_Interps (N, New_Prefix);
5712
5713       Rewrite (N,
5714         Make_Explicit_Dereference (Sloc (Parent (N)),
5715           Prefix => New_Prefix));
5716
5717       Set_Etype (N, Designated_Type (Etype (New_Prefix)));
5718
5719       if Is_Overloaded (New_Prefix) then
5720
5721          --  The dereference is also overloaded, and its interpretations are
5722          --  the designated types of the interpretations of the original node.
5723
5724          Set_Etype (N, Any_Type);
5725
5726          Get_First_Interp (New_Prefix, I, It);
5727          while Present (It.Nam) loop
5728             T := It.Typ;
5729
5730             if Is_Access_Type (T) then
5731                Add_One_Interp (N, Designated_Type (T), Designated_Type (T));
5732             end if;
5733
5734             Get_Next_Interp (I, It);
5735          end loop;
5736
5737          End_Interp_List;
5738
5739       else
5740          --  Prefix is unambiguous: mark the original prefix (which might
5741          --  Come_From_Source) as a reference, since the new (relocated) one
5742          --  won't be taken into account.
5743
5744          if Is_Entity_Name (New_Prefix) then
5745             Ent := Entity (New_Prefix);
5746             Pref := New_Prefix;
5747
5748          --  For a retrieval of a subcomponent of some composite object,
5749          --  retrieve the ultimate entity if there is one.
5750
5751          elsif Nkind (New_Prefix) = N_Selected_Component
5752            or else Nkind (New_Prefix) = N_Indexed_Component
5753          then
5754             Pref := Prefix (New_Prefix);
5755             while Present (Pref)
5756               and then
5757                 (Nkind (Pref) = N_Selected_Component
5758                   or else Nkind (Pref) = N_Indexed_Component)
5759             loop
5760                Pref := Prefix (Pref);
5761             end loop;
5762
5763             if Present (Pref) and then Is_Entity_Name (Pref) then
5764                Ent := Entity (Pref);
5765             end if;
5766          end if;
5767
5768          --  Place the reference on the entity node
5769
5770          if Present (Ent) then
5771             Generate_Reference (Ent, Pref);
5772          end if;
5773       end if;
5774    end Insert_Explicit_Dereference;
5775
5776    ------------------------------------------
5777    -- Inspect_Deferred_Constant_Completion --
5778    ------------------------------------------
5779
5780    procedure Inspect_Deferred_Constant_Completion (Decls : List_Id) is
5781       Decl   : Node_Id;
5782
5783    begin
5784       Decl := First (Decls);
5785       while Present (Decl) loop
5786
5787          --  Deferred constant signature
5788
5789          if Nkind (Decl) = N_Object_Declaration
5790            and then Constant_Present (Decl)
5791            and then No (Expression (Decl))
5792
5793             --  No need to check internally generated constants
5794
5795            and then Comes_From_Source (Decl)
5796
5797             --  The constant is not completed. A full object declaration or a
5798             --  pragma Import complete a deferred constant.
5799
5800            and then not Has_Completion (Defining_Identifier (Decl))
5801          then
5802             Error_Msg_N
5803               ("constant declaration requires initialization expression",
5804               Defining_Identifier (Decl));
5805          end if;
5806
5807          Decl := Next (Decl);
5808       end loop;
5809    end Inspect_Deferred_Constant_Completion;
5810
5811    -----------------------------
5812    -- Is_Actual_Out_Parameter --
5813    -----------------------------
5814
5815    function Is_Actual_Out_Parameter (N : Node_Id) return Boolean is
5816       Formal : Entity_Id;
5817       Call   : Node_Id;
5818    begin
5819       Find_Actual (N, Formal, Call);
5820       return Present (Formal) and then Ekind (Formal) = E_Out_Parameter;
5821    end Is_Actual_Out_Parameter;
5822
5823    -------------------------
5824    -- Is_Actual_Parameter --
5825    -------------------------
5826
5827    function Is_Actual_Parameter (N : Node_Id) return Boolean is
5828       PK : constant Node_Kind := Nkind (Parent (N));
5829
5830    begin
5831       case PK is
5832          when N_Parameter_Association =>
5833             return N = Explicit_Actual_Parameter (Parent (N));
5834
5835          when N_Function_Call | N_Procedure_Call_Statement =>
5836             return Is_List_Member (N)
5837               and then
5838                 List_Containing (N) = Parameter_Associations (Parent (N));
5839
5840          when others =>
5841             return False;
5842       end case;
5843    end Is_Actual_Parameter;
5844
5845    ---------------------
5846    -- Is_Aliased_View --
5847    ---------------------
5848
5849    function Is_Aliased_View (Obj : Node_Id) return Boolean is
5850       E : Entity_Id;
5851
5852    begin
5853       if Is_Entity_Name (Obj) then
5854
5855          E := Entity (Obj);
5856
5857          return
5858            (Is_Object (E)
5859              and then
5860                (Is_Aliased (E)
5861                   or else (Present (Renamed_Object (E))
5862                              and then Is_Aliased_View (Renamed_Object (E)))))
5863
5864            or else ((Is_Formal (E)
5865                       or else Ekind (E) = E_Generic_In_Out_Parameter
5866                       or else Ekind (E) = E_Generic_In_Parameter)
5867                     and then Is_Tagged_Type (Etype (E)))
5868
5869            or else (Is_Concurrent_Type (E)
5870                      and then In_Open_Scopes (E))
5871
5872             --  Current instance of type, either directly or as rewritten
5873             --  reference to the current object.
5874
5875            or else (Is_Entity_Name (Original_Node (Obj))
5876                      and then Present (Entity (Original_Node (Obj)))
5877                      and then Is_Type (Entity (Original_Node (Obj))))
5878
5879            or else (Is_Type (E) and then E = Current_Scope)
5880
5881            or else (Is_Incomplete_Or_Private_Type (E)
5882                      and then Full_View (E) = Current_Scope);
5883
5884       elsif Nkind (Obj) = N_Selected_Component then
5885          return Is_Aliased (Entity (Selector_Name (Obj)));
5886
5887       elsif Nkind (Obj) = N_Indexed_Component then
5888          return Has_Aliased_Components (Etype (Prefix (Obj)))
5889            or else
5890              (Is_Access_Type (Etype (Prefix (Obj)))
5891                and then
5892               Has_Aliased_Components
5893                 (Designated_Type (Etype (Prefix (Obj)))));
5894
5895       elsif Nkind (Obj) = N_Unchecked_Type_Conversion
5896         or else Nkind (Obj) = N_Type_Conversion
5897       then
5898          return Is_Tagged_Type (Etype (Obj))
5899            and then Is_Aliased_View (Expression (Obj));
5900
5901       elsif Nkind (Obj) = N_Explicit_Dereference then
5902          return Nkind (Original_Node (Obj)) /= N_Function_Call;
5903
5904       else
5905          return False;
5906       end if;
5907    end Is_Aliased_View;
5908
5909    -------------------------
5910    -- Is_Ancestor_Package --
5911    -------------------------
5912
5913    function Is_Ancestor_Package
5914      (E1 : Entity_Id;
5915       E2 : Entity_Id) return Boolean
5916    is
5917       Par : Entity_Id;
5918
5919    begin
5920       Par := E2;
5921       while Present (Par)
5922         and then Par /= Standard_Standard
5923       loop
5924          if Par = E1 then
5925             return True;
5926          end if;
5927
5928          Par := Scope (Par);
5929       end loop;
5930
5931       return False;
5932    end Is_Ancestor_Package;
5933
5934    ----------------------
5935    -- Is_Atomic_Object --
5936    ----------------------
5937
5938    function Is_Atomic_Object (N : Node_Id) return Boolean is
5939
5940       function Object_Has_Atomic_Components (N : Node_Id) return Boolean;
5941       --  Determines if given object has atomic components
5942
5943       function Is_Atomic_Prefix (N : Node_Id) return Boolean;
5944       --  If prefix is an implicit dereference, examine designated type
5945
5946       ----------------------
5947       -- Is_Atomic_Prefix --
5948       ----------------------
5949
5950       function Is_Atomic_Prefix (N : Node_Id) return Boolean is
5951       begin
5952          if Is_Access_Type (Etype (N)) then
5953             return
5954               Has_Atomic_Components (Designated_Type (Etype (N)));
5955          else
5956             return Object_Has_Atomic_Components (N);
5957          end if;
5958       end Is_Atomic_Prefix;
5959
5960       ----------------------------------
5961       -- Object_Has_Atomic_Components --
5962       ----------------------------------
5963
5964       function Object_Has_Atomic_Components (N : Node_Id) return Boolean is
5965       begin
5966          if Has_Atomic_Components (Etype (N))
5967            or else Is_Atomic (Etype (N))
5968          then
5969             return True;
5970
5971          elsif Is_Entity_Name (N)
5972            and then (Has_Atomic_Components (Entity (N))
5973                       or else Is_Atomic (Entity (N)))
5974          then
5975             return True;
5976
5977          elsif Nkind (N) = N_Indexed_Component
5978            or else Nkind (N) = N_Selected_Component
5979          then
5980             return Is_Atomic_Prefix (Prefix (N));
5981
5982          else
5983             return False;
5984          end if;
5985       end Object_Has_Atomic_Components;
5986
5987    --  Start of processing for Is_Atomic_Object
5988
5989    begin
5990       --  Predicate is not relevant to subprograms
5991
5992       if Is_Entity_Name (N) and then Is_Overloadable (Entity (N)) then
5993          return False;
5994
5995       elsif Is_Atomic (Etype (N))
5996         or else (Is_Entity_Name (N) and then Is_Atomic (Entity (N)))
5997       then
5998          return True;
5999
6000       elsif Nkind (N) = N_Indexed_Component
6001         or else Nkind (N) = N_Selected_Component
6002       then
6003          return Is_Atomic_Prefix (Prefix (N));
6004
6005       else
6006          return False;
6007       end if;
6008    end Is_Atomic_Object;
6009
6010    -------------------------
6011    -- Is_Coextension_Root --
6012    -------------------------
6013
6014    function Is_Coextension_Root (N : Node_Id) return Boolean is
6015    begin
6016       return
6017         Nkind (N) = N_Allocator
6018           and then Present (Coextensions (N))
6019
6020          --  Anonymous access discriminants carry a list of all nested
6021          --  controlled coextensions.
6022
6023           and then not Is_Dynamic_Coextension (N)
6024           and then not Is_Static_Coextension (N);
6025    end Is_Coextension_Root;
6026
6027    -----------------------------
6028    -- Is_Concurrent_Interface --
6029    -----------------------------
6030
6031    function Is_Concurrent_Interface (T : Entity_Id) return Boolean is
6032    begin
6033       return
6034         Is_Interface (T)
6035           and then
6036             (Is_Protected_Interface (T)
6037                or else Is_Synchronized_Interface (T)
6038                or else Is_Task_Interface (T));
6039    end Is_Concurrent_Interface;
6040
6041    --------------------------------------
6042    -- Is_Controlling_Limited_Procedure --
6043    --------------------------------------
6044
6045    function Is_Controlling_Limited_Procedure
6046      (Proc_Nam : Entity_Id) return Boolean
6047    is
6048       Param_Typ : Entity_Id := Empty;
6049
6050    begin
6051       if Ekind (Proc_Nam) = E_Procedure
6052         and then Present (Parameter_Specifications (Parent (Proc_Nam)))
6053       then
6054          Param_Typ := Etype (Parameter_Type (First (
6055                         Parameter_Specifications (Parent (Proc_Nam)))));
6056
6057       --  In this case where an Itype was created, the procedure call has been
6058       --  rewritten.
6059
6060       elsif Present (Associated_Node_For_Itype (Proc_Nam))
6061         and then Present (Original_Node (Associated_Node_For_Itype (Proc_Nam)))
6062         and then
6063           Present (Parameter_Associations
6064                      (Associated_Node_For_Itype (Proc_Nam)))
6065       then
6066          Param_Typ :=
6067            Etype (First (Parameter_Associations
6068                           (Associated_Node_For_Itype (Proc_Nam))));
6069       end if;
6070
6071       if Present (Param_Typ) then
6072          return
6073            Is_Interface (Param_Typ)
6074              and then Is_Limited_Record (Param_Typ);
6075       end if;
6076
6077       return False;
6078    end Is_Controlling_Limited_Procedure;
6079
6080    -----------------------------
6081    -- Is_CPP_Constructor_Call --
6082    -----------------------------
6083
6084    function Is_CPP_Constructor_Call (N : Node_Id) return Boolean is
6085    begin
6086       return Nkind (N) = N_Function_Call
6087         and then Is_CPP_Class (Etype (Etype (N)))
6088         and then Is_Constructor (Entity (Name (N)))
6089         and then Is_Imported (Entity (Name (N)));
6090    end Is_CPP_Constructor_Call;
6091
6092    -----------------
6093    -- Is_Delegate --
6094    -----------------
6095
6096    function Is_Delegate (T : Entity_Id) return Boolean is
6097       Desig_Type : Entity_Id;
6098
6099    begin
6100       if VM_Target /= CLI_Target then
6101          return False;
6102       end if;
6103
6104       --  Access-to-subprograms are delegates in CIL
6105
6106       if Ekind (T) = E_Access_Subprogram_Type then
6107          return True;
6108       end if;
6109
6110       if Ekind (T) not in Access_Kind then
6111
6112          --  A delegate is a managed pointer. If no designated type is defined
6113          --  it means that it's not a delegate.
6114
6115          return False;
6116       end if;
6117
6118       Desig_Type := Etype (Directly_Designated_Type (T));
6119
6120       if not Is_Tagged_Type (Desig_Type) then
6121          return False;
6122       end if;
6123
6124       --  Test if the type is inherited from [mscorlib]System.Delegate
6125
6126       while Etype (Desig_Type) /= Desig_Type loop
6127          if Chars (Scope (Desig_Type)) /= No_Name
6128            and then Is_Imported (Scope (Desig_Type))
6129            and then Get_Name_String (Chars (Scope (Desig_Type))) = "delegate"
6130          then
6131             return True;
6132          end if;
6133
6134          Desig_Type := Etype (Desig_Type);
6135       end loop;
6136
6137       return False;
6138    end Is_Delegate;
6139
6140    ----------------------------------------------
6141    -- Is_Dependent_Component_Of_Mutable_Object --
6142    ----------------------------------------------
6143
6144    function Is_Dependent_Component_Of_Mutable_Object
6145      (Object : Node_Id) return Boolean
6146    is
6147       P           : Node_Id;
6148       Prefix_Type : Entity_Id;
6149       P_Aliased   : Boolean := False;
6150       Comp        : Entity_Id;
6151
6152       function Is_Declared_Within_Variant (Comp : Entity_Id) return Boolean;
6153       --  Returns True if and only if Comp is declared within a variant part
6154
6155       --------------------------------
6156       -- Is_Declared_Within_Variant --
6157       --------------------------------
6158
6159       function Is_Declared_Within_Variant (Comp : Entity_Id) return Boolean is
6160          Comp_Decl : constant Node_Id   := Parent (Comp);
6161          Comp_List : constant Node_Id   := Parent (Comp_Decl);
6162       begin
6163          return Nkind (Parent (Comp_List)) = N_Variant;
6164       end Is_Declared_Within_Variant;
6165
6166    --  Start of processing for Is_Dependent_Component_Of_Mutable_Object
6167
6168    begin
6169       if Is_Variable (Object) then
6170
6171          if Nkind (Object) = N_Selected_Component then
6172             P := Prefix (Object);
6173             Prefix_Type := Etype (P);
6174
6175             if Is_Entity_Name (P) then
6176
6177                if Ekind (Entity (P)) = E_Generic_In_Out_Parameter then
6178                   Prefix_Type := Base_Type (Prefix_Type);
6179                end if;
6180
6181                if Is_Aliased (Entity (P)) then
6182                   P_Aliased := True;
6183                end if;
6184
6185             --  A discriminant check on a selected component may be expanded
6186             --  into a dereference when removing side-effects. Recover the
6187             --  original node and its type, which may be unconstrained.
6188
6189             elsif Nkind (P) = N_Explicit_Dereference
6190               and then not (Comes_From_Source (P))
6191             then
6192                P := Original_Node (P);
6193                Prefix_Type := Etype (P);
6194
6195             else
6196                --  Check for prefix being an aliased component???
6197
6198                null;
6199
6200             end if;
6201
6202             --  A heap object is constrained by its initial value
6203
6204             --  Ada 2005 (AI-363): Always assume the object could be mutable in
6205             --  the dereferenced case, since the access value might denote an
6206             --  unconstrained aliased object, whereas in Ada 95 the designated
6207             --  object is guaranteed to be constrained. A worst-case assumption
6208             --  has to apply in Ada 2005 because we can't tell at compile time
6209             --  whether the object is "constrained by its initial value"
6210             --  (despite the fact that 3.10.2(26/2) and 8.5.1(5/2) are
6211             --  semantic rules -- these rules are acknowledged to need fixing).
6212
6213             if Ada_Version < Ada_2005 then
6214                if Is_Access_Type (Prefix_Type)
6215                  or else Nkind (P) = N_Explicit_Dereference
6216                then
6217                   return False;
6218                end if;
6219
6220             elsif Ada_Version >= Ada_2005 then
6221                if Is_Access_Type (Prefix_Type) then
6222
6223                   --  If the access type is pool-specific, and there is no
6224                   --  constrained partial view of the designated type, then the
6225                   --  designated object is known to be constrained.
6226
6227                   if Ekind (Prefix_Type) = E_Access_Type
6228                     and then not Has_Constrained_Partial_View
6229                                    (Designated_Type (Prefix_Type))
6230                   then
6231                      return False;
6232
6233                   --  Otherwise (general access type, or there is a constrained
6234                   --  partial view of the designated type), we need to check
6235                   --  based on the designated type.
6236
6237                   else
6238                      Prefix_Type := Designated_Type (Prefix_Type);
6239                   end if;
6240                end if;
6241             end if;
6242
6243             Comp :=
6244               Original_Record_Component (Entity (Selector_Name (Object)));
6245
6246             --  As per AI-0017, the renaming is illegal in a generic body, even
6247             --  if the subtype is indefinite.
6248
6249             --  Ada 2005 (AI-363): In Ada 2005 an aliased object can be mutable
6250
6251             if not Is_Constrained (Prefix_Type)
6252               and then (not Is_Indefinite_Subtype (Prefix_Type)
6253                          or else
6254                           (Is_Generic_Type (Prefix_Type)
6255                             and then Ekind (Current_Scope) = E_Generic_Package
6256                             and then In_Package_Body (Current_Scope)))
6257
6258               and then (Is_Declared_Within_Variant (Comp)
6259                           or else Has_Discriminant_Dependent_Constraint (Comp))
6260               and then (not P_Aliased or else Ada_Version >= Ada_2005)
6261             then
6262                return True;
6263
6264             else
6265                return
6266                  Is_Dependent_Component_Of_Mutable_Object (Prefix (Object));
6267
6268             end if;
6269
6270          elsif Nkind (Object) = N_Indexed_Component
6271            or else Nkind (Object) = N_Slice
6272          then
6273             return Is_Dependent_Component_Of_Mutable_Object (Prefix (Object));
6274
6275          --  A type conversion that Is_Variable is a view conversion:
6276          --  go back to the denoted object.
6277
6278          elsif Nkind (Object) = N_Type_Conversion then
6279             return
6280               Is_Dependent_Component_Of_Mutable_Object (Expression (Object));
6281          end if;
6282       end if;
6283
6284       return False;
6285    end Is_Dependent_Component_Of_Mutable_Object;
6286
6287    ---------------------
6288    -- Is_Dereferenced --
6289    ---------------------
6290
6291    function Is_Dereferenced (N : Node_Id) return Boolean is
6292       P : constant Node_Id := Parent (N);
6293    begin
6294       return
6295          (Nkind (P) = N_Selected_Component
6296             or else
6297           Nkind (P) = N_Explicit_Dereference
6298             or else
6299           Nkind (P) = N_Indexed_Component
6300             or else
6301           Nkind (P) = N_Slice)
6302         and then Prefix (P) = N;
6303    end Is_Dereferenced;
6304
6305    ----------------------
6306    -- Is_Descendent_Of --
6307    ----------------------
6308
6309    function Is_Descendent_Of (T1 : Entity_Id; T2 : Entity_Id) return Boolean is
6310       T    : Entity_Id;
6311       Etyp : Entity_Id;
6312
6313    begin
6314       pragma Assert (Nkind (T1) in N_Entity);
6315       pragma Assert (Nkind (T2) in N_Entity);
6316
6317       T := Base_Type (T1);
6318
6319       --  Immediate return if the types match
6320
6321       if T = T2 then
6322          return True;
6323
6324       --  Comment needed here ???
6325
6326       elsif Ekind (T) = E_Class_Wide_Type then
6327          return Etype (T) = T2;
6328
6329       --  All other cases
6330
6331       else
6332          loop
6333             Etyp := Etype (T);
6334
6335             --  Done if we found the type we are looking for
6336
6337             if Etyp = T2 then
6338                return True;
6339
6340             --  Done if no more derivations to check
6341
6342             elsif T = T1
6343               or else T = Etyp
6344             then
6345                return False;
6346
6347             --  Following test catches error cases resulting from prev errors
6348
6349             elsif No (Etyp) then
6350                return False;
6351
6352             elsif Is_Private_Type (T) and then Etyp = Full_View (T) then
6353                return False;
6354
6355             elsif Is_Private_Type (Etyp) and then Full_View (Etyp) = T then
6356                return False;
6357             end if;
6358
6359             T := Base_Type (Etyp);
6360          end loop;
6361       end if;
6362    end Is_Descendent_Of;
6363
6364    --------------
6365    -- Is_False --
6366    --------------
6367
6368    function Is_False (U : Uint) return Boolean is
6369    begin
6370       return (U = 0);
6371    end Is_False;
6372
6373    ---------------------------
6374    -- Is_Fixed_Model_Number --
6375    ---------------------------
6376
6377    function Is_Fixed_Model_Number (U : Ureal; T : Entity_Id) return Boolean is
6378       S : constant Ureal := Small_Value (T);
6379       M : Urealp.Save_Mark;
6380       R : Boolean;
6381    begin
6382       M := Urealp.Mark;
6383       R := (U = UR_Trunc (U / S) * S);
6384       Urealp.Release (M);
6385       return R;
6386    end Is_Fixed_Model_Number;
6387
6388    -------------------------------
6389    -- Is_Fully_Initialized_Type --
6390    -------------------------------
6391
6392    function Is_Fully_Initialized_Type (Typ : Entity_Id) return Boolean is
6393    begin
6394       if Is_Scalar_Type (Typ) then
6395          return False;
6396
6397       elsif Is_Access_Type (Typ) then
6398          return True;
6399
6400       elsif Is_Array_Type (Typ) then
6401          if Is_Fully_Initialized_Type (Component_Type (Typ)) then
6402             return True;
6403          end if;
6404
6405          --  An interesting case, if we have a constrained type one of whose
6406          --  bounds is known to be null, then there are no elements to be
6407          --  initialized, so all the elements are initialized!
6408
6409          if Is_Constrained (Typ) then
6410             declare
6411                Indx     : Node_Id;
6412                Indx_Typ : Entity_Id;
6413                Lbd, Hbd : Node_Id;
6414
6415             begin
6416                Indx := First_Index (Typ);
6417                while Present (Indx) loop
6418                   if Etype (Indx) = Any_Type then
6419                      return False;
6420
6421                   --  If index is a range, use directly
6422
6423                   elsif Nkind (Indx) = N_Range then
6424                      Lbd := Low_Bound  (Indx);
6425                      Hbd := High_Bound (Indx);
6426
6427                   else
6428                      Indx_Typ := Etype (Indx);
6429
6430                      if Is_Private_Type (Indx_Typ)  then
6431                         Indx_Typ := Full_View (Indx_Typ);
6432                      end if;
6433
6434                      if No (Indx_Typ) or else Etype (Indx_Typ) = Any_Type then
6435                         return False;
6436                      else
6437                         Lbd := Type_Low_Bound  (Indx_Typ);
6438                         Hbd := Type_High_Bound (Indx_Typ);
6439                      end if;
6440                   end if;
6441
6442                   if Compile_Time_Known_Value (Lbd)
6443                     and then Compile_Time_Known_Value (Hbd)
6444                   then
6445                      if Expr_Value (Hbd) < Expr_Value (Lbd) then
6446                         return True;
6447                      end if;
6448                   end if;
6449
6450                   Next_Index (Indx);
6451                end loop;
6452             end;
6453          end if;
6454
6455          --  If no null indexes, then type is not fully initialized
6456
6457          return False;
6458
6459       --  Record types
6460
6461       elsif Is_Record_Type (Typ) then
6462          if Has_Discriminants (Typ)
6463            and then
6464              Present (Discriminant_Default_Value (First_Discriminant (Typ)))
6465            and then Is_Fully_Initialized_Variant (Typ)
6466          then
6467             return True;
6468          end if;
6469
6470          --  Controlled records are considered to be fully initialized if
6471          --  there is a user defined Initialize routine. This may not be
6472          --  entirely correct, but as the spec notes, we are guessing here
6473          --  what is best from the point of view of issuing warnings.
6474
6475          if Is_Controlled (Typ) then
6476             declare
6477                Utyp : constant Entity_Id := Underlying_Type (Typ);
6478
6479             begin
6480                if Present (Utyp) then
6481                   declare
6482                      Init : constant Entity_Id :=
6483                               (Find_Prim_Op
6484                                  (Underlying_Type (Typ), Name_Initialize));
6485
6486                   begin
6487                      if Present (Init)
6488                        and then Comes_From_Source (Init)
6489                        and then not
6490                          Is_Predefined_File_Name
6491                            (File_Name (Get_Source_File_Index (Sloc (Init))))
6492                      then
6493                         return True;
6494
6495                      elsif Has_Null_Extension (Typ)
6496                         and then
6497                           Is_Fully_Initialized_Type
6498                             (Etype (Base_Type (Typ)))
6499                      then
6500                         return True;
6501                      end if;
6502                   end;
6503                end if;
6504             end;
6505          end if;
6506
6507          --  Otherwise see if all record components are initialized
6508
6509          declare
6510             Ent : Entity_Id;
6511
6512          begin
6513             Ent := First_Entity (Typ);
6514             while Present (Ent) loop
6515                if Chars (Ent) = Name_uController then
6516                   null;
6517
6518                elsif Ekind (Ent) = E_Component
6519                  and then (No (Parent (Ent))
6520                              or else No (Expression (Parent (Ent))))
6521                  and then not Is_Fully_Initialized_Type (Etype (Ent))
6522
6523                   --  Special VM case for tag components, which need to be
6524                   --  defined in this case, but are never initialized as VMs
6525                   --  are using other dispatching mechanisms. Ignore this
6526                   --  uninitialized case. Note that this applies both to the
6527                   --  uTag entry and the main vtable pointer (CPP_Class case).
6528
6529                  and then (Tagged_Type_Expansion or else not Is_Tag (Ent))
6530                then
6531                   return False;
6532                end if;
6533
6534                Next_Entity (Ent);
6535             end loop;
6536          end;
6537
6538          --  No uninitialized components, so type is fully initialized.
6539          --  Note that this catches the case of no components as well.
6540
6541          return True;
6542
6543       elsif Is_Concurrent_Type (Typ) then
6544          return True;
6545
6546       elsif Is_Private_Type (Typ) then
6547          declare
6548             U : constant Entity_Id := Underlying_Type (Typ);
6549
6550          begin
6551             if No (U) then
6552                return False;
6553             else
6554                return Is_Fully_Initialized_Type (U);
6555             end if;
6556          end;
6557
6558       else
6559          return False;
6560       end if;
6561    end Is_Fully_Initialized_Type;
6562
6563    ----------------------------------
6564    -- Is_Fully_Initialized_Variant --
6565    ----------------------------------
6566
6567    function Is_Fully_Initialized_Variant (Typ : Entity_Id) return Boolean is
6568       Loc           : constant Source_Ptr := Sloc (Typ);
6569       Constraints   : constant List_Id    := New_List;
6570       Components    : constant Elist_Id   := New_Elmt_List;
6571       Comp_Elmt     : Elmt_Id;
6572       Comp_Id       : Node_Id;
6573       Comp_List     : Node_Id;
6574       Discr         : Entity_Id;
6575       Discr_Val     : Node_Id;
6576
6577       Report_Errors : Boolean;
6578       pragma Warnings (Off, Report_Errors);
6579
6580    begin
6581       if Serious_Errors_Detected > 0 then
6582          return False;
6583       end if;
6584
6585       if Is_Record_Type (Typ)
6586         and then Nkind (Parent (Typ)) = N_Full_Type_Declaration
6587         and then Nkind (Type_Definition (Parent (Typ))) = N_Record_Definition
6588       then
6589          Comp_List := Component_List (Type_Definition (Parent (Typ)));
6590
6591          Discr := First_Discriminant (Typ);
6592          while Present (Discr) loop
6593             if Nkind (Parent (Discr)) = N_Discriminant_Specification then
6594                Discr_Val := Expression (Parent (Discr));
6595
6596                if Present (Discr_Val)
6597                  and then Is_OK_Static_Expression (Discr_Val)
6598                then
6599                   Append_To (Constraints,
6600                     Make_Component_Association (Loc,
6601                       Choices    => New_List (New_Occurrence_Of (Discr, Loc)),
6602                       Expression => New_Copy (Discr_Val)));
6603                else
6604                   return False;
6605                end if;
6606             else
6607                return False;
6608             end if;
6609
6610             Next_Discriminant (Discr);
6611          end loop;
6612
6613          Gather_Components
6614            (Typ           => Typ,
6615             Comp_List     => Comp_List,
6616             Governed_By   => Constraints,
6617             Into          => Components,
6618             Report_Errors => Report_Errors);
6619
6620          --  Check that each component present is fully initialized
6621
6622          Comp_Elmt := First_Elmt (Components);
6623          while Present (Comp_Elmt) loop
6624             Comp_Id := Node (Comp_Elmt);
6625
6626             if Ekind (Comp_Id) = E_Component
6627               and then (No (Parent (Comp_Id))
6628                          or else No (Expression (Parent (Comp_Id))))
6629               and then not Is_Fully_Initialized_Type (Etype (Comp_Id))
6630             then
6631                return False;
6632             end if;
6633
6634             Next_Elmt (Comp_Elmt);
6635          end loop;
6636
6637          return True;
6638
6639       elsif Is_Private_Type (Typ) then
6640          declare
6641             U : constant Entity_Id := Underlying_Type (Typ);
6642
6643          begin
6644             if No (U) then
6645                return False;
6646             else
6647                return Is_Fully_Initialized_Variant (U);
6648             end if;
6649          end;
6650       else
6651          return False;
6652       end if;
6653    end Is_Fully_Initialized_Variant;
6654
6655    ------------
6656    -- Is_LHS --
6657    ------------
6658
6659    --  We seem to have a lot of overlapping functions that do similar things
6660    --  (testing for left hand sides or lvalues???). Anyway, since this one is
6661    --  purely syntactic, it should be in Sem_Aux I would think???
6662
6663    function Is_LHS (N : Node_Id) return Boolean is
6664       P : constant Node_Id := Parent (N);
6665    begin
6666       return Nkind (P) = N_Assignment_Statement
6667         and then Name (P) = N;
6668    end Is_LHS;
6669
6670    ----------------------------
6671    -- Is_Inherited_Operation --
6672    ----------------------------
6673
6674    function Is_Inherited_Operation (E : Entity_Id) return Boolean is
6675       Kind : constant Node_Kind := Nkind (Parent (E));
6676    begin
6677       pragma Assert (Is_Overloadable (E));
6678       return Kind = N_Full_Type_Declaration
6679         or else Kind = N_Private_Extension_Declaration
6680         or else Kind = N_Subtype_Declaration
6681         or else (Ekind (E) = E_Enumeration_Literal
6682                   and then Is_Derived_Type (Etype (E)));
6683    end Is_Inherited_Operation;
6684
6685    -----------------------------
6686    -- Is_Library_Level_Entity --
6687    -----------------------------
6688
6689    function Is_Library_Level_Entity (E : Entity_Id) return Boolean is
6690    begin
6691       --  The following is a small optimization, and it also properly handles
6692       --  discriminals, which in task bodies might appear in expressions before
6693       --  the corresponding procedure has been created, and which therefore do
6694       --  not have an assigned scope.
6695
6696       if Is_Formal (E) then
6697          return False;
6698       end if;
6699
6700       --  Normal test is simply that the enclosing dynamic scope is Standard
6701
6702       return Enclosing_Dynamic_Scope (E) = Standard_Standard;
6703    end Is_Library_Level_Entity;
6704
6705    ---------------------------------
6706    -- Is_Local_Variable_Reference --
6707    ---------------------------------
6708
6709    function Is_Local_Variable_Reference (Expr : Node_Id) return Boolean is
6710    begin
6711       if not Is_Entity_Name (Expr) then
6712          return False;
6713
6714       else
6715          declare
6716             Ent : constant Entity_Id := Entity (Expr);
6717             Sub : constant Entity_Id := Enclosing_Subprogram (Ent);
6718          begin
6719             if not Ekind_In (Ent, E_Variable, E_In_Out_Parameter) then
6720                return False;
6721             else
6722                return Present (Sub) and then Sub = Current_Subprogram;
6723             end if;
6724          end;
6725       end if;
6726    end Is_Local_Variable_Reference;
6727
6728    -------------------------
6729    -- Is_Object_Reference --
6730    -------------------------
6731
6732    function Is_Object_Reference (N : Node_Id) return Boolean is
6733    begin
6734       if Is_Entity_Name (N) then
6735          return Present (Entity (N)) and then Is_Object (Entity (N));
6736
6737       else
6738          case Nkind (N) is
6739             when N_Indexed_Component | N_Slice =>
6740                return
6741                  Is_Object_Reference (Prefix (N))
6742                    or else Is_Access_Type (Etype (Prefix (N)));
6743
6744             --  In Ada95, a function call is a constant object; a procedure
6745             --  call is not.
6746
6747             when N_Function_Call =>
6748                return Etype (N) /= Standard_Void_Type;
6749
6750             --  A reference to the stream attribute Input is a function call
6751
6752             when N_Attribute_Reference =>
6753                return Attribute_Name (N) = Name_Input;
6754
6755             when N_Selected_Component =>
6756                return
6757                  Is_Object_Reference (Selector_Name (N))
6758                    and then
6759                      (Is_Object_Reference (Prefix (N))
6760                         or else Is_Access_Type (Etype (Prefix (N))));
6761
6762             when N_Explicit_Dereference =>
6763                return True;
6764
6765             --  A view conversion of a tagged object is an object reference
6766
6767             when N_Type_Conversion =>
6768                return Is_Tagged_Type (Etype (Subtype_Mark (N)))
6769                  and then Is_Tagged_Type (Etype (Expression (N)))
6770                  and then Is_Object_Reference (Expression (N));
6771
6772             --  An unchecked type conversion is considered to be an object if
6773             --  the operand is an object (this construction arises only as a
6774             --  result of expansion activities).
6775
6776             when N_Unchecked_Type_Conversion =>
6777                return True;
6778
6779             when others =>
6780                return False;
6781          end case;
6782       end if;
6783    end Is_Object_Reference;
6784
6785    -----------------------------------
6786    -- Is_OK_Variable_For_Out_Formal --
6787    -----------------------------------
6788
6789    function Is_OK_Variable_For_Out_Formal (AV : Node_Id) return Boolean is
6790    begin
6791       Note_Possible_Modification (AV, Sure => True);
6792
6793       --  We must reject parenthesized variable names. The check for
6794       --  Comes_From_Source is present because there are currently
6795       --  cases where the compiler violates this rule (e.g. passing
6796       --  a task object to its controlled Initialize routine).
6797
6798       if Paren_Count (AV) > 0 and then Comes_From_Source (AV) then
6799          return False;
6800
6801       --  A variable is always allowed
6802
6803       elsif Is_Variable (AV) then
6804          return True;
6805
6806       --  Unchecked conversions are allowed only if they come from the
6807       --  generated code, which sometimes uses unchecked conversions for out
6808       --  parameters in cases where code generation is unaffected. We tell
6809       --  source unchecked conversions by seeing if they are rewrites of an
6810       --  original Unchecked_Conversion function call, or of an explicit
6811       --  conversion of a function call.
6812
6813       elsif Nkind (AV) = N_Unchecked_Type_Conversion then
6814          if Nkind (Original_Node (AV)) = N_Function_Call then
6815             return False;
6816
6817          elsif Comes_From_Source (AV)
6818            and then Nkind (Original_Node (Expression (AV))) = N_Function_Call
6819          then
6820             return False;
6821
6822          elsif Nkind (Original_Node (AV)) = N_Type_Conversion then
6823             return Is_OK_Variable_For_Out_Formal (Expression (AV));
6824
6825          else
6826             return True;
6827          end if;
6828
6829       --  Normal type conversions are allowed if argument is a variable
6830
6831       elsif Nkind (AV) = N_Type_Conversion then
6832          if Is_Variable (Expression (AV))
6833            and then Paren_Count (Expression (AV)) = 0
6834          then
6835             Note_Possible_Modification (Expression (AV), Sure => True);
6836             return True;
6837
6838          --  We also allow a non-parenthesized expression that raises
6839          --  constraint error if it rewrites what used to be a variable
6840
6841          elsif Raises_Constraint_Error (Expression (AV))
6842             and then Paren_Count (Expression (AV)) = 0
6843             and then Is_Variable (Original_Node (Expression (AV)))
6844          then
6845             return True;
6846
6847          --  Type conversion of something other than a variable
6848
6849          else
6850             return False;
6851          end if;
6852
6853       --  If this node is rewritten, then test the original form, if that is
6854       --  OK, then we consider the rewritten node OK (for example, if the
6855       --  original node is a conversion, then Is_Variable will not be true
6856       --  but we still want to allow the conversion if it converts a variable).
6857
6858       elsif Original_Node (AV) /= AV then
6859          return Is_OK_Variable_For_Out_Formal (Original_Node (AV));
6860
6861       --  All other non-variables are rejected
6862
6863       else
6864          return False;
6865       end if;
6866    end Is_OK_Variable_For_Out_Formal;
6867
6868    -----------------------------------
6869    -- Is_Partially_Initialized_Type --
6870    -----------------------------------
6871
6872    function Is_Partially_Initialized_Type
6873      (Typ              : Entity_Id;
6874       Include_Implicit : Boolean := True) return Boolean
6875    is
6876    begin
6877       if Is_Scalar_Type (Typ) then
6878          return False;
6879
6880       elsif Is_Access_Type (Typ) then
6881          return Include_Implicit;
6882
6883       elsif Is_Array_Type (Typ) then
6884
6885          --  If component type is partially initialized, so is array type
6886
6887          if Is_Partially_Initialized_Type
6888               (Component_Type (Typ), Include_Implicit)
6889          then
6890             return True;
6891
6892          --  Otherwise we are only partially initialized if we are fully
6893          --  initialized (this is the empty array case, no point in us
6894          --  duplicating that code here).
6895
6896          else
6897             return Is_Fully_Initialized_Type (Typ);
6898          end if;
6899
6900       elsif Is_Record_Type (Typ) then
6901
6902          --  A discriminated type is always partially initialized if in
6903          --  all mode
6904
6905          if Has_Discriminants (Typ) and then Include_Implicit then
6906             return True;
6907
6908          --  A tagged type is always partially initialized
6909
6910          elsif Is_Tagged_Type (Typ) then
6911             return True;
6912
6913          --  Case of non-discriminated record
6914
6915          else
6916             declare
6917                Ent : Entity_Id;
6918
6919                Component_Present : Boolean := False;
6920                --  Set True if at least one component is present. If no
6921                --  components are present, then record type is fully
6922                --  initialized (another odd case, like the null array).
6923
6924             begin
6925                --  Loop through components
6926
6927                Ent := First_Entity (Typ);
6928                while Present (Ent) loop
6929                   if Ekind (Ent) = E_Component then
6930                      Component_Present := True;
6931
6932                      --  If a component has an initialization expression then
6933                      --  the enclosing record type is partially initialized
6934
6935                      if Present (Parent (Ent))
6936                        and then Present (Expression (Parent (Ent)))
6937                      then
6938                         return True;
6939
6940                      --  If a component is of a type which is itself partially
6941                      --  initialized, then the enclosing record type is also.
6942
6943                      elsif Is_Partially_Initialized_Type
6944                              (Etype (Ent), Include_Implicit)
6945                      then
6946                         return True;
6947                      end if;
6948                   end if;
6949
6950                   Next_Entity (Ent);
6951                end loop;
6952
6953                --  No initialized components found. If we found any components
6954                --  they were all uninitialized so the result is false.
6955
6956                if Component_Present then
6957                   return False;
6958
6959                --  But if we found no components, then all the components are
6960                --  initialized so we consider the type to be initialized.
6961
6962                else
6963                   return True;
6964                end if;
6965             end;
6966          end if;
6967
6968       --  Concurrent types are always fully initialized
6969
6970       elsif Is_Concurrent_Type (Typ) then
6971          return True;
6972
6973       --  For a private type, go to underlying type. If there is no underlying
6974       --  type then just assume this partially initialized. Not clear if this
6975       --  can happen in a non-error case, but no harm in testing for this.
6976
6977       elsif Is_Private_Type (Typ) then
6978          declare
6979             U : constant Entity_Id := Underlying_Type (Typ);
6980          begin
6981             if No (U) then
6982                return True;
6983             else
6984                return Is_Partially_Initialized_Type (U, Include_Implicit);
6985             end if;
6986          end;
6987
6988       --  For any other type (are there any?) assume partially initialized
6989
6990       else
6991          return True;
6992       end if;
6993    end Is_Partially_Initialized_Type;
6994
6995    ------------------------------------
6996    -- Is_Potentially_Persistent_Type --
6997    ------------------------------------
6998
6999    function Is_Potentially_Persistent_Type (T : Entity_Id) return Boolean is
7000       Comp : Entity_Id;
7001       Indx : Node_Id;
7002
7003    begin
7004       --  For private type, test corresponding full type
7005
7006       if Is_Private_Type (T) then
7007          return Is_Potentially_Persistent_Type (Full_View (T));
7008
7009       --  Scalar types are potentially persistent
7010
7011       elsif Is_Scalar_Type (T) then
7012          return True;
7013
7014       --  Record type is potentially persistent if not tagged and the types of
7015       --  all it components are potentially persistent, and no component has
7016       --  an initialization expression.
7017
7018       elsif Is_Record_Type (T)
7019         and then not Is_Tagged_Type (T)
7020         and then not Is_Partially_Initialized_Type (T)
7021       then
7022          Comp := First_Component (T);
7023          while Present (Comp) loop
7024             if not Is_Potentially_Persistent_Type (Etype (Comp)) then
7025                return False;
7026             else
7027                Next_Entity (Comp);
7028             end if;
7029          end loop;
7030
7031          return True;
7032
7033       --  Array type is potentially persistent if its component type is
7034       --  potentially persistent and if all its constraints are static.
7035
7036       elsif Is_Array_Type (T) then
7037          if not Is_Potentially_Persistent_Type (Component_Type (T)) then
7038             return False;
7039          end if;
7040
7041          Indx := First_Index (T);
7042          while Present (Indx) loop
7043             if not Is_OK_Static_Subtype (Etype (Indx)) then
7044                return False;
7045             else
7046                Next_Index (Indx);
7047             end if;
7048          end loop;
7049
7050          return True;
7051
7052       --  All other types are not potentially persistent
7053
7054       else
7055          return False;
7056       end if;
7057    end Is_Potentially_Persistent_Type;
7058
7059    ---------------------------------
7060    -- Is_Protected_Self_Reference --
7061    ---------------------------------
7062
7063    function Is_Protected_Self_Reference (N : Node_Id) return Boolean is
7064
7065       function In_Access_Definition (N : Node_Id) return Boolean;
7066       --  Returns true if N belongs to an access definition
7067
7068       --------------------------
7069       -- In_Access_Definition --
7070       --------------------------
7071
7072       function In_Access_Definition (N : Node_Id) return Boolean is
7073          P : Node_Id;
7074
7075       begin
7076          P := Parent (N);
7077          while Present (P) loop
7078             if Nkind (P) = N_Access_Definition then
7079                return True;
7080             end if;
7081
7082             P := Parent (P);
7083          end loop;
7084
7085          return False;
7086       end In_Access_Definition;
7087
7088    --  Start of processing for Is_Protected_Self_Reference
7089
7090    begin
7091       --  Verify that prefix is analyzed and has the proper form. Note that
7092       --  the attributes Elab_Spec, Elab_Body, and UET_Address, which also
7093       --  produce the address of an entity, do not analyze their prefix
7094       --  because they denote entities that are not necessarily visible.
7095       --  Neither of them can apply to a protected type.
7096
7097       return Ada_Version >= Ada_2005
7098         and then Is_Entity_Name (N)
7099         and then Present (Entity (N))
7100         and then Is_Protected_Type (Entity (N))
7101         and then In_Open_Scopes (Entity (N))
7102         and then not In_Access_Definition (N);
7103    end Is_Protected_Self_Reference;
7104
7105    -----------------------------
7106    -- Is_RCI_Pkg_Spec_Or_Body --
7107    -----------------------------
7108
7109    function Is_RCI_Pkg_Spec_Or_Body (Cunit : Node_Id) return Boolean is
7110
7111       function Is_RCI_Pkg_Decl_Cunit (Cunit : Node_Id) return Boolean;
7112       --  Return True if the unit of Cunit is an RCI package declaration
7113
7114       ---------------------------
7115       -- Is_RCI_Pkg_Decl_Cunit --
7116       ---------------------------
7117
7118       function Is_RCI_Pkg_Decl_Cunit (Cunit : Node_Id) return Boolean is
7119          The_Unit : constant Node_Id := Unit (Cunit);
7120
7121       begin
7122          if Nkind (The_Unit) /= N_Package_Declaration then
7123             return False;
7124          end if;
7125
7126          return Is_Remote_Call_Interface (Defining_Entity (The_Unit));
7127       end Is_RCI_Pkg_Decl_Cunit;
7128
7129    --  Start of processing for Is_RCI_Pkg_Spec_Or_Body
7130
7131    begin
7132       return Is_RCI_Pkg_Decl_Cunit (Cunit)
7133         or else
7134          (Nkind (Unit (Cunit)) = N_Package_Body
7135            and then Is_RCI_Pkg_Decl_Cunit (Library_Unit (Cunit)));
7136    end Is_RCI_Pkg_Spec_Or_Body;
7137
7138    -----------------------------------------
7139    -- Is_Remote_Access_To_Class_Wide_Type --
7140    -----------------------------------------
7141
7142    function Is_Remote_Access_To_Class_Wide_Type
7143      (E : Entity_Id) return Boolean
7144    is
7145    begin
7146       --  A remote access to class-wide type is a general access to object type
7147       --  declared in the visible part of a Remote_Types or Remote_Call_
7148       --  Interface unit.
7149
7150       return Ekind (E) = E_General_Access_Type
7151         and then (Is_Remote_Call_Interface (E) or else Is_Remote_Types (E));
7152    end Is_Remote_Access_To_Class_Wide_Type;
7153
7154    -----------------------------------------
7155    -- Is_Remote_Access_To_Subprogram_Type --
7156    -----------------------------------------
7157
7158    function Is_Remote_Access_To_Subprogram_Type
7159      (E : Entity_Id) return Boolean
7160    is
7161    begin
7162       return (Ekind (E) = E_Access_Subprogram_Type
7163                 or else (Ekind (E) = E_Record_Type
7164                            and then Present (Corresponding_Remote_Type (E))))
7165         and then (Is_Remote_Call_Interface (E) or else Is_Remote_Types (E));
7166    end Is_Remote_Access_To_Subprogram_Type;
7167
7168    --------------------
7169    -- Is_Remote_Call --
7170    --------------------
7171
7172    function Is_Remote_Call (N : Node_Id) return Boolean is
7173    begin
7174       if Nkind (N) /= N_Procedure_Call_Statement
7175         and then Nkind (N) /= N_Function_Call
7176       then
7177          --  An entry call cannot be remote
7178
7179          return False;
7180
7181       elsif Nkind (Name (N)) in N_Has_Entity
7182         and then Is_Remote_Call_Interface (Entity (Name (N)))
7183       then
7184          --  A subprogram declared in the spec of a RCI package is remote
7185
7186          return True;
7187
7188       elsif Nkind (Name (N)) = N_Explicit_Dereference
7189         and then Is_Remote_Access_To_Subprogram_Type
7190                    (Etype (Prefix (Name (N))))
7191       then
7192          --  The dereference of a RAS is a remote call
7193
7194          return True;
7195
7196       elsif Present (Controlling_Argument (N))
7197         and then Is_Remote_Access_To_Class_Wide_Type
7198           (Etype (Controlling_Argument (N)))
7199       then
7200          --  Any primitive operation call with a controlling argument of
7201          --  a RACW type is a remote call.
7202
7203          return True;
7204       end if;
7205
7206       --  All other calls are local calls
7207
7208       return False;
7209    end Is_Remote_Call;
7210
7211    ----------------------
7212    -- Is_Renamed_Entry --
7213    ----------------------
7214
7215    function Is_Renamed_Entry (Proc_Nam : Entity_Id) return Boolean is
7216       Orig_Node : Node_Id := Empty;
7217       Subp_Decl : Node_Id := Parent (Parent (Proc_Nam));
7218
7219       function Is_Entry (Nam : Node_Id) return Boolean;
7220       --  Determine whether Nam is an entry. Traverse selectors if there are
7221       --  nested selected components.
7222
7223       --------------
7224       -- Is_Entry --
7225       --------------
7226
7227       function Is_Entry (Nam : Node_Id) return Boolean is
7228       begin
7229          if Nkind (Nam) = N_Selected_Component then
7230             return Is_Entry (Selector_Name (Nam));
7231          end if;
7232
7233          return Ekind (Entity (Nam)) = E_Entry;
7234       end Is_Entry;
7235
7236    --  Start of processing for Is_Renamed_Entry
7237
7238    begin
7239       if Present (Alias (Proc_Nam)) then
7240          Subp_Decl := Parent (Parent (Alias (Proc_Nam)));
7241       end if;
7242
7243       --  Look for a rewritten subprogram renaming declaration
7244
7245       if Nkind (Subp_Decl) = N_Subprogram_Declaration
7246         and then Present (Original_Node (Subp_Decl))
7247       then
7248          Orig_Node := Original_Node (Subp_Decl);
7249       end if;
7250
7251       --  The rewritten subprogram is actually an entry
7252
7253       if Present (Orig_Node)
7254         and then Nkind (Orig_Node) = N_Subprogram_Renaming_Declaration
7255         and then Is_Entry (Name (Orig_Node))
7256       then
7257          return True;
7258       end if;
7259
7260       return False;
7261    end Is_Renamed_Entry;
7262
7263    ----------------------
7264    -- Is_Selector_Name --
7265    ----------------------
7266
7267    function Is_Selector_Name (N : Node_Id) return Boolean is
7268    begin
7269       if not Is_List_Member (N) then
7270          declare
7271             P : constant Node_Id   := Parent (N);
7272             K : constant Node_Kind := Nkind (P);
7273          begin
7274             return
7275               (K = N_Expanded_Name          or else
7276                K = N_Generic_Association    or else
7277                K = N_Parameter_Association  or else
7278                K = N_Selected_Component)
7279               and then Selector_Name (P) = N;
7280          end;
7281
7282       else
7283          declare
7284             L : constant List_Id := List_Containing (N);
7285             P : constant Node_Id := Parent (L);
7286          begin
7287             return (Nkind (P) = N_Discriminant_Association
7288                      and then Selector_Names (P) = L)
7289               or else
7290                    (Nkind (P) = N_Component_Association
7291                      and then Choices (P) = L);
7292          end;
7293       end if;
7294    end Is_Selector_Name;
7295
7296    ------------------
7297    -- Is_Statement --
7298    ------------------
7299
7300    function Is_Statement (N : Node_Id) return Boolean is
7301    begin
7302       return
7303         Nkind (N) in N_Statement_Other_Than_Procedure_Call
7304           or else Nkind (N) = N_Procedure_Call_Statement;
7305    end Is_Statement;
7306
7307    ---------------------------------
7308    -- Is_Synchronized_Tagged_Type --
7309    ---------------------------------
7310
7311    function Is_Synchronized_Tagged_Type (E : Entity_Id) return Boolean is
7312       Kind : constant Entity_Kind := Ekind (Base_Type (E));
7313
7314    begin
7315       --  A task or protected type derived from an interface is a tagged type.
7316       --  Such a tagged type is called a synchronized tagged type, as are
7317       --  synchronized interfaces and private extensions whose declaration
7318       --  includes the reserved word synchronized.
7319
7320       return (Is_Tagged_Type (E)
7321                 and then (Kind = E_Task_Type
7322                            or else Kind = E_Protected_Type))
7323             or else
7324              (Is_Interface (E)
7325                 and then Is_Synchronized_Interface (E))
7326             or else
7327              (Ekind (E) = E_Record_Type_With_Private
7328                 and then (Synchronized_Present (Parent (E))
7329                            or else Is_Synchronized_Interface (Etype (E))));
7330    end Is_Synchronized_Tagged_Type;
7331
7332    -----------------
7333    -- Is_Transfer --
7334    -----------------
7335
7336    function Is_Transfer (N : Node_Id) return Boolean is
7337       Kind : constant Node_Kind := Nkind (N);
7338
7339    begin
7340       if Kind = N_Simple_Return_Statement
7341            or else
7342          Kind = N_Extended_Return_Statement
7343            or else
7344          Kind = N_Goto_Statement
7345            or else
7346          Kind = N_Raise_Statement
7347            or else
7348          Kind = N_Requeue_Statement
7349       then
7350          return True;
7351
7352       elsif (Kind = N_Exit_Statement or else Kind in N_Raise_xxx_Error)
7353         and then No (Condition (N))
7354       then
7355          return True;
7356
7357       elsif Kind = N_Procedure_Call_Statement
7358         and then Is_Entity_Name (Name (N))
7359         and then Present (Entity (Name (N)))
7360         and then No_Return (Entity (Name (N)))
7361       then
7362          return True;
7363
7364       elsif Nkind (Original_Node (N)) = N_Raise_Statement then
7365          return True;
7366
7367       else
7368          return False;
7369       end if;
7370    end Is_Transfer;
7371
7372    -------------
7373    -- Is_True --
7374    -------------
7375
7376    function Is_True (U : Uint) return Boolean is
7377    begin
7378       return (U /= 0);
7379    end Is_True;
7380
7381    -------------------------------
7382    -- Is_Universal_Numeric_Type --
7383    -------------------------------
7384
7385    function Is_Universal_Numeric_Type (T : Entity_Id) return Boolean is
7386    begin
7387       return T = Universal_Integer or else T = Universal_Real;
7388    end Is_Universal_Numeric_Type;
7389
7390    -------------------
7391    -- Is_Value_Type --
7392    -------------------
7393
7394    function Is_Value_Type (T : Entity_Id) return Boolean is
7395    begin
7396       return VM_Target = CLI_Target
7397         and then Nkind (T) in N_Has_Chars
7398         and then Chars (T) /= No_Name
7399         and then Get_Name_String (Chars (T)) = "valuetype";
7400    end Is_Value_Type;
7401
7402    ---------------------
7403    -- Is_VMS_Operator --
7404    ---------------------
7405
7406    function Is_VMS_Operator (Op : Entity_Id) return Boolean is
7407    begin
7408       --  The VMS operators are declared in a child of System that is loaded
7409       --  through pragma Extend_System. In some rare cases a program is run
7410       --  with this extension but without indicating that the target is VMS.
7411
7412       return Ekind (Op) = E_Function
7413         and then Is_Intrinsic_Subprogram (Op)
7414         and then
7415           ((Present_System_Aux
7416             and then Scope (Op) = System_Aux_Id)
7417            or else
7418            (True_VMS_Target
7419              and then Scope (Scope (Op)) = RTU_Entity (System)));
7420    end Is_VMS_Operator;
7421
7422    -----------------
7423    -- Is_Variable --
7424    -----------------
7425
7426    function Is_Variable (N : Node_Id) return Boolean is
7427
7428       Orig_Node : constant Node_Id := Original_Node (N);
7429       --  We do the test on the original node, since this is basically a test
7430       --  of syntactic categories, so it must not be disturbed by whatever
7431       --  rewriting might have occurred. For example, an aggregate, which is
7432       --  certainly NOT a variable, could be turned into a variable by
7433       --  expansion.
7434
7435       function In_Protected_Function (E : Entity_Id) return Boolean;
7436       --  Within a protected function, the private components of the enclosing
7437       --  protected type are constants. A function nested within a (protected)
7438       --  procedure is not itself protected.
7439
7440       function Is_Variable_Prefix (P : Node_Id) return Boolean;
7441       --  Prefixes can involve implicit dereferences, in which case we must
7442       --  test for the case of a reference of a constant access type, which can
7443       --  can never be a variable.
7444
7445       ---------------------------
7446       -- In_Protected_Function --
7447       ---------------------------
7448
7449       function In_Protected_Function (E : Entity_Id) return Boolean is
7450          Prot : constant Entity_Id := Scope (E);
7451          S    : Entity_Id;
7452
7453       begin
7454          if not Is_Protected_Type (Prot) then
7455             return False;
7456          else
7457             S := Current_Scope;
7458             while Present (S) and then S /= Prot loop
7459                if Ekind (S) = E_Function and then Scope (S) = Prot then
7460                   return True;
7461                end if;
7462
7463                S := Scope (S);
7464             end loop;
7465
7466             return False;
7467          end if;
7468       end In_Protected_Function;
7469
7470       ------------------------
7471       -- Is_Variable_Prefix --
7472       ------------------------
7473
7474       function Is_Variable_Prefix (P : Node_Id) return Boolean is
7475       begin
7476          if Is_Access_Type (Etype (P)) then
7477             return not Is_Access_Constant (Root_Type (Etype (P)));
7478
7479          --  For the case of an indexed component whose prefix has a packed
7480          --  array type, the prefix has been rewritten into a type conversion.
7481          --  Determine variable-ness from the converted expression.
7482
7483          elsif Nkind (P) = N_Type_Conversion
7484            and then not Comes_From_Source (P)
7485            and then Is_Array_Type (Etype (P))
7486            and then Is_Packed (Etype (P))
7487          then
7488             return Is_Variable (Expression (P));
7489
7490          else
7491             return Is_Variable (P);
7492          end if;
7493       end Is_Variable_Prefix;
7494
7495    --  Start of processing for Is_Variable
7496
7497    begin
7498       --  Definitely OK if Assignment_OK is set. Since this is something that
7499       --  only gets set for expanded nodes, the test is on N, not Orig_Node.
7500
7501       if Nkind (N) in N_Subexpr and then Assignment_OK (N) then
7502          return True;
7503
7504       --  Normally we go to the original node, but there is one exception where
7505       --  we use the rewritten node, namely when it is an explicit dereference.
7506       --  The generated code may rewrite a prefix which is an access type with
7507       --  an explicit dereference. The dereference is a variable, even though
7508       --  the original node may not be (since it could be a constant of the
7509       --  access type).
7510
7511       --  In Ada 2005 we have a further case to consider: the prefix may be a
7512       --  function call given in prefix notation. The original node appears to
7513       --  be a selected component, but we need to examine the call.
7514
7515       elsif Nkind (N) = N_Explicit_Dereference
7516         and then Nkind (Orig_Node) /= N_Explicit_Dereference
7517         and then Present (Etype (Orig_Node))
7518         and then Is_Access_Type (Etype (Orig_Node))
7519       then
7520          --  Note that if the prefix is an explicit dereference that does not
7521          --  come from source, we must check for a rewritten function call in
7522          --  prefixed notation before other forms of rewriting, to prevent a
7523          --  compiler crash.
7524
7525          return
7526            (Nkind (Orig_Node) = N_Function_Call
7527              and then not Is_Access_Constant (Etype (Prefix (N))))
7528            or else
7529              Is_Variable_Prefix (Original_Node (Prefix (N)));
7530
7531       --  A function call is never a variable
7532
7533       elsif Nkind (N) = N_Function_Call then
7534          return False;
7535
7536       --  All remaining checks use the original node
7537
7538       elsif Is_Entity_Name (Orig_Node)
7539         and then Present (Entity (Orig_Node))
7540       then
7541          declare
7542             E : constant Entity_Id := Entity (Orig_Node);
7543             K : constant Entity_Kind := Ekind (E);
7544
7545          begin
7546             return (K = E_Variable
7547                       and then Nkind (Parent (E)) /= N_Exception_Handler)
7548               or else  (K = E_Component
7549                           and then not In_Protected_Function (E))
7550               or else  K = E_Out_Parameter
7551               or else  K = E_In_Out_Parameter
7552               or else  K = E_Generic_In_Out_Parameter
7553
7554                --  Current instance of type:
7555
7556               or else (Is_Type (E) and then In_Open_Scopes (E))
7557               or else (Is_Incomplete_Or_Private_Type (E)
7558                         and then In_Open_Scopes (Full_View (E)));
7559          end;
7560
7561       else
7562          case Nkind (Orig_Node) is
7563             when N_Indexed_Component | N_Slice =>
7564                return Is_Variable_Prefix (Prefix (Orig_Node));
7565
7566             when N_Selected_Component =>
7567                return Is_Variable_Prefix (Prefix (Orig_Node))
7568                  and then Is_Variable (Selector_Name (Orig_Node));
7569
7570             --  For an explicit dereference, the type of the prefix cannot
7571             --  be an access to constant or an access to subprogram.
7572
7573             when N_Explicit_Dereference =>
7574                declare
7575                   Typ : constant Entity_Id := Etype (Prefix (Orig_Node));
7576                begin
7577                   return Is_Access_Type (Typ)
7578                     and then not Is_Access_Constant (Root_Type (Typ))
7579                     and then Ekind (Typ) /= E_Access_Subprogram_Type;
7580                end;
7581
7582             --  The type conversion is the case where we do not deal with the
7583             --  context dependent special case of an actual parameter. Thus
7584             --  the type conversion is only considered a variable for the
7585             --  purposes of this routine if the target type is tagged. However,
7586             --  a type conversion is considered to be a variable if it does not
7587             --  come from source (this deals for example with the conversions
7588             --  of expressions to their actual subtypes).
7589
7590             when N_Type_Conversion =>
7591                return Is_Variable (Expression (Orig_Node))
7592                  and then
7593                    (not Comes_From_Source (Orig_Node)
7594                       or else
7595                         (Is_Tagged_Type (Etype (Subtype_Mark (Orig_Node)))
7596                           and then
7597                          Is_Tagged_Type (Etype (Expression (Orig_Node)))));
7598
7599             --  GNAT allows an unchecked type conversion as a variable. This
7600             --  only affects the generation of internal expanded code, since
7601             --  calls to instantiations of Unchecked_Conversion are never
7602             --  considered variables (since they are function calls).
7603             --  This is also true for expression actions.
7604
7605             when N_Unchecked_Type_Conversion =>
7606                return Is_Variable (Expression (Orig_Node));
7607
7608             when others =>
7609                return False;
7610          end case;
7611       end if;
7612    end Is_Variable;
7613
7614    ---------------------------
7615    -- Is_Visibly_Controlled --
7616    ---------------------------
7617
7618    function Is_Visibly_Controlled (T : Entity_Id) return Boolean is
7619       Root : constant Entity_Id := Root_Type (T);
7620    begin
7621       return Chars (Scope (Root)) = Name_Finalization
7622         and then Chars (Scope (Scope (Root))) = Name_Ada
7623         and then Scope (Scope (Scope (Root))) = Standard_Standard;
7624    end Is_Visibly_Controlled;
7625
7626    ------------------------
7627    -- Is_Volatile_Object --
7628    ------------------------
7629
7630    function Is_Volatile_Object (N : Node_Id) return Boolean is
7631
7632       function Object_Has_Volatile_Components (N : Node_Id) return Boolean;
7633       --  Determines if given object has volatile components
7634
7635       function Is_Volatile_Prefix (N : Node_Id) return Boolean;
7636       --  If prefix is an implicit dereference, examine designated type
7637
7638       ------------------------
7639       -- Is_Volatile_Prefix --
7640       ------------------------
7641
7642       function Is_Volatile_Prefix (N : Node_Id) return Boolean is
7643          Typ  : constant Entity_Id := Etype (N);
7644
7645       begin
7646          if Is_Access_Type (Typ) then
7647             declare
7648                Dtyp : constant Entity_Id := Designated_Type (Typ);
7649
7650             begin
7651                return Is_Volatile (Dtyp)
7652                  or else Has_Volatile_Components (Dtyp);
7653             end;
7654
7655          else
7656             return Object_Has_Volatile_Components (N);
7657          end if;
7658       end Is_Volatile_Prefix;
7659
7660       ------------------------------------
7661       -- Object_Has_Volatile_Components --
7662       ------------------------------------
7663
7664       function Object_Has_Volatile_Components (N : Node_Id) return Boolean is
7665          Typ : constant Entity_Id := Etype (N);
7666
7667       begin
7668          if Is_Volatile (Typ)
7669            or else Has_Volatile_Components (Typ)
7670          then
7671             return True;
7672
7673          elsif Is_Entity_Name (N)
7674            and then (Has_Volatile_Components (Entity (N))
7675                       or else Is_Volatile (Entity (N)))
7676          then
7677             return True;
7678
7679          elsif Nkind (N) = N_Indexed_Component
7680            or else Nkind (N) = N_Selected_Component
7681          then
7682             return Is_Volatile_Prefix (Prefix (N));
7683
7684          else
7685             return False;
7686          end if;
7687       end Object_Has_Volatile_Components;
7688
7689    --  Start of processing for Is_Volatile_Object
7690
7691    begin
7692       if Is_Volatile (Etype (N))
7693         or else (Is_Entity_Name (N) and then Is_Volatile (Entity (N)))
7694       then
7695          return True;
7696
7697       elsif Nkind (N) = N_Indexed_Component
7698         or else Nkind (N) = N_Selected_Component
7699       then
7700          return Is_Volatile_Prefix (Prefix (N));
7701
7702       else
7703          return False;
7704       end if;
7705    end Is_Volatile_Object;
7706
7707    -------------------------
7708    -- Kill_Current_Values --
7709    -------------------------
7710
7711    procedure Kill_Current_Values
7712      (Ent                  : Entity_Id;
7713       Last_Assignment_Only : Boolean := False)
7714    is
7715    begin
7716       --  ??? do we have to worry about clearing cached checks?
7717
7718       if Is_Assignable (Ent) then
7719          Set_Last_Assignment (Ent, Empty);
7720       end if;
7721
7722       if Is_Object (Ent) then
7723          if not Last_Assignment_Only then
7724             Kill_Checks (Ent);
7725             Set_Current_Value (Ent, Empty);
7726
7727             if not Can_Never_Be_Null (Ent) then
7728                Set_Is_Known_Non_Null (Ent, False);
7729             end if;
7730
7731             Set_Is_Known_Null (Ent, False);
7732
7733             --  Reset Is_Known_Valid unless type is always valid, or if we have
7734             --  a loop parameter (loop parameters are always valid, since their
7735             --  bounds are defined by the bounds given in the loop header).
7736
7737             if not Is_Known_Valid (Etype (Ent))
7738               and then Ekind (Ent) /= E_Loop_Parameter
7739             then
7740                Set_Is_Known_Valid (Ent, False);
7741             end if;
7742          end if;
7743       end if;
7744    end Kill_Current_Values;
7745
7746    procedure Kill_Current_Values (Last_Assignment_Only : Boolean := False) is
7747       S : Entity_Id;
7748
7749       procedure Kill_Current_Values_For_Entity_Chain (E : Entity_Id);
7750       --  Clear current value for entity E and all entities chained to E
7751
7752       ------------------------------------------
7753       -- Kill_Current_Values_For_Entity_Chain --
7754       ------------------------------------------
7755
7756       procedure Kill_Current_Values_For_Entity_Chain (E : Entity_Id) is
7757          Ent : Entity_Id;
7758       begin
7759          Ent := E;
7760          while Present (Ent) loop
7761             Kill_Current_Values (Ent, Last_Assignment_Only);
7762             Next_Entity (Ent);
7763          end loop;
7764       end Kill_Current_Values_For_Entity_Chain;
7765
7766    --  Start of processing for Kill_Current_Values
7767
7768    begin
7769       --  Kill all saved checks, a special case of killing saved values
7770
7771       if not Last_Assignment_Only then
7772          Kill_All_Checks;
7773       end if;
7774
7775       --  Loop through relevant scopes, which includes the current scope and
7776       --  any parent scopes if the current scope is a block or a package.
7777
7778       S := Current_Scope;
7779       Scope_Loop : loop
7780
7781          --  Clear current values of all entities in current scope
7782
7783          Kill_Current_Values_For_Entity_Chain (First_Entity (S));
7784
7785          --  If scope is a package, also clear current values of all
7786          --  private entities in the scope.
7787
7788          if Is_Package_Or_Generic_Package (S)
7789            or else Is_Concurrent_Type (S)
7790          then
7791             Kill_Current_Values_For_Entity_Chain (First_Private_Entity (S));
7792          end if;
7793
7794          --  If this is a not a subprogram, deal with parents
7795
7796          if not Is_Subprogram (S) then
7797             S := Scope (S);
7798             exit Scope_Loop when S = Standard_Standard;
7799          else
7800             exit Scope_Loop;
7801          end if;
7802       end loop Scope_Loop;
7803    end Kill_Current_Values;
7804
7805    --------------------------
7806    -- Kill_Size_Check_Code --
7807    --------------------------
7808
7809    procedure Kill_Size_Check_Code (E : Entity_Id) is
7810    begin
7811       if (Ekind (E) = E_Constant or else Ekind (E) = E_Variable)
7812         and then Present (Size_Check_Code (E))
7813       then
7814          Remove (Size_Check_Code (E));
7815          Set_Size_Check_Code (E, Empty);
7816       end if;
7817    end Kill_Size_Check_Code;
7818
7819    --------------------------
7820    -- Known_To_Be_Assigned --
7821    --------------------------
7822
7823    function Known_To_Be_Assigned (N : Node_Id) return Boolean is
7824       P : constant Node_Id := Parent (N);
7825
7826    begin
7827       case Nkind (P) is
7828
7829          --  Test left side of assignment
7830
7831          when N_Assignment_Statement =>
7832             return N = Name (P);
7833
7834             --  Function call arguments are never lvalues
7835
7836          when N_Function_Call =>
7837             return False;
7838
7839          --  Positional parameter for procedure or accept call
7840
7841          when N_Procedure_Call_Statement |
7842               N_Accept_Statement
7843           =>
7844             declare
7845                Proc : Entity_Id;
7846                Form : Entity_Id;
7847                Act  : Node_Id;
7848
7849             begin
7850                Proc := Get_Subprogram_Entity (P);
7851
7852                if No (Proc) then
7853                   return False;
7854                end if;
7855
7856                --  If we are not a list member, something is strange, so
7857                --  be conservative and return False.
7858
7859                if not Is_List_Member (N) then
7860                   return False;
7861                end if;
7862
7863                --  We are going to find the right formal by stepping forward
7864                --  through the formals, as we step backwards in the actuals.
7865
7866                Form := First_Formal (Proc);
7867                Act  := N;
7868                loop
7869                   --  If no formal, something is weird, so be conservative
7870                   --  and return False.
7871
7872                   if No (Form) then
7873                      return False;
7874                   end if;
7875
7876                   Prev (Act);
7877                   exit when No (Act);
7878                   Next_Formal (Form);
7879                end loop;
7880
7881                return Ekind (Form) /= E_In_Parameter;
7882             end;
7883
7884          --  Named parameter for procedure or accept call
7885
7886          when N_Parameter_Association =>
7887             declare
7888                Proc : Entity_Id;
7889                Form : Entity_Id;
7890
7891             begin
7892                Proc := Get_Subprogram_Entity (Parent (P));
7893
7894                if No (Proc) then
7895                   return False;
7896                end if;
7897
7898                --  Loop through formals to find the one that matches
7899
7900                Form := First_Formal (Proc);
7901                loop
7902                   --  If no matching formal, that's peculiar, some kind of
7903                   --  previous error, so return False to be conservative.
7904
7905                   if No (Form) then
7906                      return False;
7907                   end if;
7908
7909                   --  Else test for match
7910
7911                   if Chars (Form) = Chars (Selector_Name (P)) then
7912                      return Ekind (Form) /= E_In_Parameter;
7913                   end if;
7914
7915                   Next_Formal (Form);
7916                end loop;
7917             end;
7918
7919          --  Test for appearing in a conversion that itself appears
7920          --  in an lvalue context, since this should be an lvalue.
7921
7922          when N_Type_Conversion =>
7923             return Known_To_Be_Assigned (P);
7924
7925          --  All other references are definitely not known to be modifications
7926
7927          when others =>
7928             return False;
7929
7930       end case;
7931    end Known_To_Be_Assigned;
7932
7933    -------------------
7934    -- May_Be_Lvalue --
7935    -------------------
7936
7937    function May_Be_Lvalue (N : Node_Id) return Boolean is
7938       P : constant Node_Id := Parent (N);
7939
7940    begin
7941       case Nkind (P) is
7942
7943          --  Test left side of assignment
7944
7945          when N_Assignment_Statement =>
7946             return N = Name (P);
7947
7948          --  Test prefix of component or attribute. Note that the prefix of an
7949          --  explicit or implicit dereference cannot be an l-value.
7950
7951          when N_Attribute_Reference =>
7952             return N = Prefix (P)
7953               and then Name_Implies_Lvalue_Prefix (Attribute_Name (P));
7954
7955          --  For an expanded name, the name is an lvalue if the expanded name
7956          --  is an lvalue, but the prefix is never an lvalue, since it is just
7957          --  the scope where the name is found.
7958
7959          when N_Expanded_Name        =>
7960             if N = Prefix (P) then
7961                return May_Be_Lvalue (P);
7962             else
7963                return False;
7964             end if;
7965
7966          --  For a selected component A.B, A is certainly an lvalue if A.B is.
7967          --  B is a little interesting, if we have A.B := 3, there is some
7968          --  discussion as to whether B is an lvalue or not, we choose to say
7969          --  it is. Note however that A is not an lvalue if it is of an access
7970          --  type since this is an implicit dereference.
7971
7972          when N_Selected_Component   =>
7973             if N = Prefix (P)
7974               and then Present (Etype (N))
7975               and then Is_Access_Type (Etype (N))
7976             then
7977                return False;
7978             else
7979                return May_Be_Lvalue (P);
7980             end if;
7981
7982          --  For an indexed component or slice, the index or slice bounds is
7983          --  never an lvalue. The prefix is an lvalue if the indexed component
7984          --  or slice is an lvalue, except if it is an access type, where we
7985          --  have an implicit dereference.
7986
7987          when N_Indexed_Component    =>
7988             if N /= Prefix (P)
7989               or else (Present (Etype (N)) and then Is_Access_Type (Etype (N)))
7990             then
7991                return False;
7992             else
7993                return May_Be_Lvalue (P);
7994             end if;
7995
7996          --  Prefix of a reference is an lvalue if the reference is an lvalue
7997
7998          when N_Reference            =>
7999             return May_Be_Lvalue (P);
8000
8001          --  Prefix of explicit dereference is never an lvalue
8002
8003          when N_Explicit_Dereference =>
8004             return False;
8005
8006          --  Positional parameter for subprogram, entry, or accept call.
8007          --  In older versions of Ada function call arguments are never
8008          --  lvalues. In Ada 2012 functions can have in-out parameters.
8009
8010          when N_Function_Call            |
8011               N_Procedure_Call_Statement |
8012               N_Entry_Call_Statement     |
8013               N_Accept_Statement
8014          =>
8015             if Nkind (P) = N_Function_Call
8016               and then Ada_Version < Ada_2012
8017             then
8018                return False;
8019             end if;
8020
8021             --  The following mechanism is clumsy and fragile. A single
8022             --  flag set in Resolve_Actuals would be preferable ???
8023
8024             declare
8025                Proc : Entity_Id;
8026                Form : Entity_Id;
8027                Act  : Node_Id;
8028
8029             begin
8030                Proc := Get_Subprogram_Entity (P);
8031
8032                if No (Proc) then
8033                   return True;
8034                end if;
8035
8036                --  If we are not a list member, something is strange, so
8037                --  be conservative and return True.
8038
8039                if not Is_List_Member (N) then
8040                   return True;
8041                end if;
8042
8043                --  We are going to find the right formal by stepping forward
8044                --  through the formals, as we step backwards in the actuals.
8045
8046                Form := First_Formal (Proc);
8047                Act  := N;
8048                loop
8049                   --  If no formal, something is weird, so be conservative
8050                   --  and return True.
8051
8052                   if No (Form) then
8053                      return True;
8054                   end if;
8055
8056                   Prev (Act);
8057                   exit when No (Act);
8058                   Next_Formal (Form);
8059                end loop;
8060
8061                return Ekind (Form) /= E_In_Parameter;
8062             end;
8063
8064          --  Named parameter for procedure or accept call
8065
8066          when N_Parameter_Association =>
8067             declare
8068                Proc : Entity_Id;
8069                Form : Entity_Id;
8070
8071             begin
8072                Proc := Get_Subprogram_Entity (Parent (P));
8073
8074                if No (Proc) then
8075                   return True;
8076                end if;
8077
8078                --  Loop through formals to find the one that matches
8079
8080                Form := First_Formal (Proc);
8081                loop
8082                   --  If no matching formal, that's peculiar, some kind of
8083                   --  previous error, so return True to be conservative.
8084
8085                   if No (Form) then
8086                      return True;
8087                   end if;
8088
8089                   --  Else test for match
8090
8091                   if Chars (Form) = Chars (Selector_Name (P)) then
8092                      return Ekind (Form) /= E_In_Parameter;
8093                   end if;
8094
8095                   Next_Formal (Form);
8096                end loop;
8097             end;
8098
8099          --  Test for appearing in a conversion that itself appears in an
8100          --  lvalue context, since this should be an lvalue.
8101
8102          when N_Type_Conversion =>
8103             return May_Be_Lvalue (P);
8104
8105          --  Test for appearance in object renaming declaration
8106
8107          when N_Object_Renaming_Declaration =>
8108             return True;
8109
8110          --  All other references are definitely not lvalues
8111
8112          when others =>
8113             return False;
8114
8115       end case;
8116    end May_Be_Lvalue;
8117
8118    -----------------------
8119    -- Mark_Coextensions --
8120    -----------------------
8121
8122    procedure Mark_Coextensions (Context_Nod : Node_Id; Root_Nod : Node_Id) is
8123       Is_Dynamic : Boolean;
8124       --  Indicates whether the context causes nested coextensions to be
8125       --  dynamic or static
8126
8127       function Mark_Allocator (N : Node_Id) return Traverse_Result;
8128       --  Recognize an allocator node and label it as a dynamic coextension
8129
8130       --------------------
8131       -- Mark_Allocator --
8132       --------------------
8133
8134       function Mark_Allocator (N : Node_Id) return Traverse_Result is
8135       begin
8136          if Nkind (N) = N_Allocator then
8137             if Is_Dynamic then
8138                Set_Is_Dynamic_Coextension (N);
8139
8140             --  If the allocator expression is potentially dynamic, it may
8141             --  be expanded out of order and require dynamic allocation
8142             --  anyway, so we treat the coextension itself as dynamic.
8143             --  Potential optimization ???
8144
8145             elsif Nkind (Expression (N)) = N_Qualified_Expression
8146               and then Nkind (Expression (Expression (N))) = N_Op_Concat
8147             then
8148                Set_Is_Dynamic_Coextension (N);
8149
8150             else
8151                Set_Is_Static_Coextension (N);
8152             end if;
8153          end if;
8154
8155          return OK;
8156       end Mark_Allocator;
8157
8158       procedure Mark_Allocators is new Traverse_Proc (Mark_Allocator);
8159
8160    --  Start of processing Mark_Coextensions
8161
8162    begin
8163       case Nkind (Context_Nod) is
8164          when N_Assignment_Statement    |
8165               N_Simple_Return_Statement =>
8166             Is_Dynamic := Nkind (Expression (Context_Nod)) = N_Allocator;
8167
8168          when N_Object_Declaration =>
8169             Is_Dynamic := Nkind (Root_Nod) = N_Allocator;
8170
8171          --  This routine should not be called for constructs which may not
8172          --  contain coextensions.
8173
8174          when others =>
8175             raise Program_Error;
8176       end case;
8177
8178       Mark_Allocators (Root_Nod);
8179    end Mark_Coextensions;
8180
8181    ----------------------
8182    -- Needs_One_Actual --
8183    ----------------------
8184
8185    function Needs_One_Actual (E : Entity_Id) return Boolean is
8186       Formal : Entity_Id;
8187
8188    begin
8189       if Ada_Version >= Ada_2005
8190         and then Present (First_Formal (E))
8191       then
8192          Formal := Next_Formal (First_Formal (E));
8193          while Present (Formal) loop
8194             if No (Default_Value (Formal)) then
8195                return False;
8196             end if;
8197
8198             Next_Formal (Formal);
8199          end loop;
8200
8201          return True;
8202
8203       else
8204          return False;
8205       end if;
8206    end Needs_One_Actual;
8207
8208    ------------------------
8209    -- New_Copy_List_Tree --
8210    ------------------------
8211
8212    function New_Copy_List_Tree (List : List_Id) return List_Id is
8213       NL : List_Id;
8214       E  : Node_Id;
8215
8216    begin
8217       if List = No_List then
8218          return No_List;
8219
8220       else
8221          NL := New_List;
8222          E := First (List);
8223
8224          while Present (E) loop
8225             Append (New_Copy_Tree (E), NL);
8226             E := Next (E);
8227          end loop;
8228
8229          return NL;
8230       end if;
8231    end New_Copy_List_Tree;
8232
8233    -------------------
8234    -- New_Copy_Tree --
8235    -------------------
8236
8237    use Atree.Unchecked_Access;
8238    use Atree_Private_Part;
8239
8240    --  Our approach here requires a two pass traversal of the tree. The
8241    --  first pass visits all nodes that eventually will be copied looking
8242    --  for defining Itypes. If any defining Itypes are found, then they are
8243    --  copied, and an entry is added to the replacement map. In the second
8244    --  phase, the tree is copied, using the replacement map to replace any
8245    --  Itype references within the copied tree.
8246
8247    --  The following hash tables are used if the Map supplied has more
8248    --  than hash threshold entries to speed up access to the map. If
8249    --  there are fewer entries, then the map is searched sequentially
8250    --  (because setting up a hash table for only a few entries takes
8251    --  more time than it saves.
8252
8253    function New_Copy_Hash (E : Entity_Id) return NCT_Header_Num;
8254    --  Hash function used for hash operations
8255
8256    -------------------
8257    -- New_Copy_Hash --
8258    -------------------
8259
8260    function New_Copy_Hash (E : Entity_Id) return NCT_Header_Num is
8261    begin
8262       return Nat (E) mod (NCT_Header_Num'Last + 1);
8263    end New_Copy_Hash;
8264
8265    ---------------
8266    -- NCT_Assoc --
8267    ---------------
8268
8269    --  The hash table NCT_Assoc associates old entities in the table
8270    --  with their corresponding new entities (i.e. the pairs of entries
8271    --  presented in the original Map argument are Key-Element pairs).
8272
8273    package NCT_Assoc is new Simple_HTable (
8274      Header_Num => NCT_Header_Num,
8275      Element    => Entity_Id,
8276      No_Element => Empty,
8277      Key        => Entity_Id,
8278      Hash       => New_Copy_Hash,
8279      Equal      => Types."=");
8280
8281    ---------------------
8282    -- NCT_Itype_Assoc --
8283    ---------------------
8284
8285    --  The hash table NCT_Itype_Assoc contains entries only for those
8286    --  old nodes which have a non-empty Associated_Node_For_Itype set.
8287    --  The key is the associated node, and the element is the new node
8288    --  itself (NOT the associated node for the new node).
8289
8290    package NCT_Itype_Assoc is new Simple_HTable (
8291      Header_Num => NCT_Header_Num,
8292      Element    => Entity_Id,
8293      No_Element => Empty,
8294      Key        => Entity_Id,
8295      Hash       => New_Copy_Hash,
8296      Equal      => Types."=");
8297
8298    --  Start of processing for New_Copy_Tree function
8299
8300    function New_Copy_Tree
8301      (Source    : Node_Id;
8302       Map       : Elist_Id := No_Elist;
8303       New_Sloc  : Source_Ptr := No_Location;
8304       New_Scope : Entity_Id := Empty) return Node_Id
8305    is
8306       Actual_Map : Elist_Id := Map;
8307       --  This is the actual map for the copy. It is initialized with the
8308       --  given elements, and then enlarged as required for Itypes that are
8309       --  copied during the first phase of the copy operation. The visit
8310       --  procedures add elements to this map as Itypes are encountered.
8311       --  The reason we cannot use Map directly, is that it may well be
8312       --  (and normally is) initialized to No_Elist, and if we have mapped
8313       --  entities, we have to reset it to point to a real Elist.
8314
8315       function Assoc (N : Node_Or_Entity_Id) return Node_Id;
8316       --  Called during second phase to map entities into their corresponding
8317       --  copies using Actual_Map. If the argument is not an entity, or is not
8318       --  in Actual_Map, then it is returned unchanged.
8319
8320       procedure Build_NCT_Hash_Tables;
8321       --  Builds hash tables (number of elements >= threshold value)
8322
8323       function Copy_Elist_With_Replacement
8324         (Old_Elist : Elist_Id) return Elist_Id;
8325       --  Called during second phase to copy element list doing replacements
8326
8327       procedure Copy_Itype_With_Replacement (New_Itype : Entity_Id);
8328       --  Called during the second phase to process a copied Itype. The actual
8329       --  copy happened during the first phase (so that we could make the entry
8330       --  in the mapping), but we still have to deal with the descendents of
8331       --  the copied Itype and copy them where necessary.
8332
8333       function Copy_List_With_Replacement (Old_List : List_Id) return List_Id;
8334       --  Called during second phase to copy list doing replacements
8335
8336       function Copy_Node_With_Replacement (Old_Node : Node_Id) return Node_Id;
8337       --  Called during second phase to copy node doing replacements
8338
8339       procedure Visit_Elist (E : Elist_Id);
8340       --  Called during first phase to visit all elements of an Elist
8341
8342       procedure Visit_Field (F : Union_Id; N : Node_Id);
8343       --  Visit a single field, recursing to call Visit_Node or Visit_List
8344       --  if the field is a syntactic descendent of the current node (i.e.
8345       --  its parent is Node N).
8346
8347       procedure Visit_Itype (Old_Itype : Entity_Id);
8348       --  Called during first phase to visit subsidiary fields of a defining
8349       --  Itype, and also create a copy and make an entry in the replacement
8350       --  map for the new copy.
8351
8352       procedure Visit_List (L : List_Id);
8353       --  Called during first phase to visit all elements of a List
8354
8355       procedure Visit_Node (N : Node_Or_Entity_Id);
8356       --  Called during first phase to visit a node and all its subtrees
8357
8358       -----------
8359       -- Assoc --
8360       -----------
8361
8362       function Assoc (N : Node_Or_Entity_Id) return Node_Id is
8363          E   : Elmt_Id;
8364          Ent : Entity_Id;
8365
8366       begin
8367          if not Has_Extension (N) or else No (Actual_Map) then
8368             return N;
8369
8370          elsif NCT_Hash_Tables_Used then
8371             Ent := NCT_Assoc.Get (Entity_Id (N));
8372
8373             if Present (Ent) then
8374                return Ent;
8375             else
8376                return N;
8377             end if;
8378
8379          --  No hash table used, do serial search
8380
8381          else
8382             E := First_Elmt (Actual_Map);
8383             while Present (E) loop
8384                if Node (E) = N then
8385                   return Node (Next_Elmt (E));
8386                else
8387                   E := Next_Elmt (Next_Elmt (E));
8388                end if;
8389             end loop;
8390          end if;
8391
8392          return N;
8393       end Assoc;
8394
8395       ---------------------------
8396       -- Build_NCT_Hash_Tables --
8397       ---------------------------
8398
8399       procedure Build_NCT_Hash_Tables is
8400          Elmt : Elmt_Id;
8401          Ent  : Entity_Id;
8402       begin
8403          if NCT_Hash_Table_Setup then
8404             NCT_Assoc.Reset;
8405             NCT_Itype_Assoc.Reset;
8406          end if;
8407
8408          Elmt := First_Elmt (Actual_Map);
8409          while Present (Elmt) loop
8410             Ent := Node (Elmt);
8411
8412             --  Get new entity, and associate old and new
8413
8414             Next_Elmt (Elmt);
8415             NCT_Assoc.Set (Ent, Node (Elmt));
8416
8417             if Is_Type (Ent) then
8418                declare
8419                   Anode : constant Entity_Id :=
8420                             Associated_Node_For_Itype (Ent);
8421
8422                begin
8423                   if Present (Anode) then
8424
8425                      --  Enter a link between the associated node of the
8426                      --  old Itype and the new Itype, for updating later
8427                      --  when node is copied.
8428
8429                      NCT_Itype_Assoc.Set (Anode, Node (Elmt));
8430                   end if;
8431                end;
8432             end if;
8433
8434             Next_Elmt (Elmt);
8435          end loop;
8436
8437          NCT_Hash_Tables_Used := True;
8438          NCT_Hash_Table_Setup := True;
8439       end Build_NCT_Hash_Tables;
8440
8441       ---------------------------------
8442       -- Copy_Elist_With_Replacement --
8443       ---------------------------------
8444
8445       function Copy_Elist_With_Replacement
8446         (Old_Elist : Elist_Id) return Elist_Id
8447       is
8448          M         : Elmt_Id;
8449          New_Elist : Elist_Id;
8450
8451       begin
8452          if No (Old_Elist) then
8453             return No_Elist;
8454
8455          else
8456             New_Elist := New_Elmt_List;
8457
8458             M := First_Elmt (Old_Elist);
8459             while Present (M) loop
8460                Append_Elmt (Copy_Node_With_Replacement (Node (M)), New_Elist);
8461                Next_Elmt (M);
8462             end loop;
8463          end if;
8464
8465          return New_Elist;
8466       end Copy_Elist_With_Replacement;
8467
8468       ---------------------------------
8469       -- Copy_Itype_With_Replacement --
8470       ---------------------------------
8471
8472       --  This routine exactly parallels its phase one analog Visit_Itype,
8473
8474       procedure Copy_Itype_With_Replacement (New_Itype : Entity_Id) is
8475       begin
8476          --  Translate Next_Entity, Scope and Etype fields, in case they
8477          --  reference entities that have been mapped into copies.
8478
8479          Set_Next_Entity (New_Itype, Assoc (Next_Entity (New_Itype)));
8480          Set_Etype       (New_Itype, Assoc (Etype       (New_Itype)));
8481
8482          if Present (New_Scope) then
8483             Set_Scope    (New_Itype, New_Scope);
8484          else
8485             Set_Scope    (New_Itype, Assoc (Scope       (New_Itype)));
8486          end if;
8487
8488          --  Copy referenced fields
8489
8490          if Is_Discrete_Type (New_Itype) then
8491             Set_Scalar_Range (New_Itype,
8492               Copy_Node_With_Replacement (Scalar_Range (New_Itype)));
8493
8494          elsif Has_Discriminants (Base_Type (New_Itype)) then
8495             Set_Discriminant_Constraint (New_Itype,
8496               Copy_Elist_With_Replacement
8497                 (Discriminant_Constraint (New_Itype)));
8498
8499          elsif Is_Array_Type (New_Itype) then
8500             if Present (First_Index (New_Itype)) then
8501                Set_First_Index (New_Itype,
8502                  First (Copy_List_With_Replacement
8503                          (List_Containing (First_Index (New_Itype)))));
8504             end if;
8505
8506             if Is_Packed (New_Itype) then
8507                Set_Packed_Array_Type (New_Itype,
8508                  Copy_Node_With_Replacement
8509                    (Packed_Array_Type (New_Itype)));
8510             end if;
8511          end if;
8512       end Copy_Itype_With_Replacement;
8513
8514       --------------------------------
8515       -- Copy_List_With_Replacement --
8516       --------------------------------
8517
8518       function Copy_List_With_Replacement
8519         (Old_List : List_Id) return List_Id
8520       is
8521          New_List : List_Id;
8522          E        : Node_Id;
8523
8524       begin
8525          if Old_List = No_List then
8526             return No_List;
8527
8528          else
8529             New_List := Empty_List;
8530
8531             E := First (Old_List);
8532             while Present (E) loop
8533                Append (Copy_Node_With_Replacement (E), New_List);
8534                Next (E);
8535             end loop;
8536
8537             return New_List;
8538          end if;
8539       end Copy_List_With_Replacement;
8540
8541       --------------------------------
8542       -- Copy_Node_With_Replacement --
8543       --------------------------------
8544
8545       function Copy_Node_With_Replacement
8546         (Old_Node : Node_Id) return Node_Id
8547       is
8548          New_Node : Node_Id;
8549
8550          procedure Adjust_Named_Associations
8551            (Old_Node : Node_Id;
8552             New_Node : Node_Id);
8553          --  If a call node has named associations, these are chained through
8554          --  the First_Named_Actual, Next_Named_Actual links. These must be
8555          --  propagated separately to the new parameter list, because these
8556          --  are not syntactic fields.
8557
8558          function Copy_Field_With_Replacement
8559            (Field : Union_Id) return Union_Id;
8560          --  Given Field, which is a field of Old_Node, return a copy of it
8561          --  if it is a syntactic field (i.e. its parent is Node), setting
8562          --  the parent of the copy to poit to New_Node. Otherwise returns
8563          --  the field (possibly mapped if it is an entity).
8564
8565          -------------------------------
8566          -- Adjust_Named_Associations --
8567          -------------------------------
8568
8569          procedure Adjust_Named_Associations
8570            (Old_Node : Node_Id;
8571             New_Node : Node_Id)
8572          is
8573             Old_E : Node_Id;
8574             New_E : Node_Id;
8575
8576             Old_Next : Node_Id;
8577             New_Next : Node_Id;
8578
8579          begin
8580             Old_E := First (Parameter_Associations (Old_Node));
8581             New_E := First (Parameter_Associations (New_Node));
8582             while Present (Old_E) loop
8583                if Nkind (Old_E) = N_Parameter_Association
8584                  and then Present (Next_Named_Actual (Old_E))
8585                then
8586                   if First_Named_Actual (Old_Node)
8587                     =  Explicit_Actual_Parameter (Old_E)
8588                   then
8589                      Set_First_Named_Actual
8590                        (New_Node, Explicit_Actual_Parameter (New_E));
8591                   end if;
8592
8593                   --  Now scan parameter list from the beginning,to locate
8594                   --  next named actual, which can be out of order.
8595
8596                   Old_Next := First (Parameter_Associations (Old_Node));
8597                   New_Next := First (Parameter_Associations (New_Node));
8598
8599                   while Nkind (Old_Next) /= N_Parameter_Association
8600                     or else  Explicit_Actual_Parameter (Old_Next)
8601                       /= Next_Named_Actual (Old_E)
8602                   loop
8603                      Next (Old_Next);
8604                      Next (New_Next);
8605                   end loop;
8606
8607                   Set_Next_Named_Actual
8608                     (New_E, Explicit_Actual_Parameter (New_Next));
8609                end if;
8610
8611                Next (Old_E);
8612                Next (New_E);
8613             end loop;
8614          end Adjust_Named_Associations;
8615
8616          ---------------------------------
8617          -- Copy_Field_With_Replacement --
8618          ---------------------------------
8619
8620          function Copy_Field_With_Replacement
8621            (Field : Union_Id) return Union_Id
8622          is
8623          begin
8624             if Field = Union_Id (Empty) then
8625                return Field;
8626
8627             elsif Field in Node_Range then
8628                declare
8629                   Old_N : constant Node_Id := Node_Id (Field);
8630                   New_N : Node_Id;
8631
8632                begin
8633                   --  If syntactic field, as indicated by the parent pointer
8634                   --  being set, then copy the referenced node recursively.
8635
8636                   if Parent (Old_N) = Old_Node then
8637                      New_N := Copy_Node_With_Replacement (Old_N);
8638
8639                      if New_N /= Old_N then
8640                         Set_Parent (New_N, New_Node);
8641                      end if;
8642
8643                   --  For semantic fields, update possible entity reference
8644                   --  from the replacement map.
8645
8646                   else
8647                      New_N := Assoc (Old_N);
8648                   end if;
8649
8650                   return Union_Id (New_N);
8651                end;
8652
8653             elsif Field in List_Range then
8654                declare
8655                   Old_L : constant List_Id := List_Id (Field);
8656                   New_L : List_Id;
8657
8658                begin
8659                   --  If syntactic field, as indicated by the parent pointer,
8660                   --  then recursively copy the entire referenced list.
8661
8662                   if Parent (Old_L) = Old_Node then
8663                      New_L := Copy_List_With_Replacement (Old_L);
8664                      Set_Parent (New_L, New_Node);
8665
8666                   --  For semantic list, just returned unchanged
8667
8668                   else
8669                      New_L := Old_L;
8670                   end if;
8671
8672                   return Union_Id (New_L);
8673                end;
8674
8675             --  Anything other than a list or a node is returned unchanged
8676
8677             else
8678                return Field;
8679             end if;
8680          end Copy_Field_With_Replacement;
8681
8682       --  Start of processing for Copy_Node_With_Replacement
8683
8684       begin
8685          if Old_Node <= Empty_Or_Error then
8686             return Old_Node;
8687
8688          elsif Has_Extension (Old_Node) then
8689             return Assoc (Old_Node);
8690
8691          else
8692             New_Node := New_Copy (Old_Node);
8693
8694             --  If the node we are copying is the associated node of a
8695             --  previously copied Itype, then adjust the associated node
8696             --  of the copy of that Itype accordingly.
8697
8698             if Present (Actual_Map) then
8699                declare
8700                   E   : Elmt_Id;
8701                   Ent : Entity_Id;
8702
8703                begin
8704                   --  Case of hash table used
8705
8706                   if NCT_Hash_Tables_Used then
8707                      Ent := NCT_Itype_Assoc.Get (Old_Node);
8708
8709                      if Present (Ent) then
8710                         Set_Associated_Node_For_Itype (Ent, New_Node);
8711                      end if;
8712
8713                   --  Case of no hash table used
8714
8715                   else
8716                      E := First_Elmt (Actual_Map);
8717                      while Present (E) loop
8718                         if Is_Itype (Node (E))
8719                           and then
8720                             Old_Node = Associated_Node_For_Itype (Node (E))
8721                         then
8722                            Set_Associated_Node_For_Itype
8723                              (Node (Next_Elmt (E)), New_Node);
8724                         end if;
8725
8726                         E := Next_Elmt (Next_Elmt (E));
8727                      end loop;
8728                   end if;
8729                end;
8730             end if;
8731
8732             --  Recursively copy descendents
8733
8734             Set_Field1
8735               (New_Node, Copy_Field_With_Replacement (Field1 (New_Node)));
8736             Set_Field2
8737               (New_Node, Copy_Field_With_Replacement (Field2 (New_Node)));
8738             Set_Field3
8739               (New_Node, Copy_Field_With_Replacement (Field3 (New_Node)));
8740             Set_Field4
8741               (New_Node, Copy_Field_With_Replacement (Field4 (New_Node)));
8742             Set_Field5
8743               (New_Node, Copy_Field_With_Replacement (Field5 (New_Node)));
8744
8745             --  Adjust Sloc of new node if necessary
8746
8747             if New_Sloc /= No_Location then
8748                Set_Sloc (New_Node, New_Sloc);
8749
8750                --  If we adjust the Sloc, then we are essentially making
8751                --  a completely new node, so the Comes_From_Source flag
8752                --  should be reset to the proper default value.
8753
8754                Nodes.Table (New_Node).Comes_From_Source :=
8755                  Default_Node.Comes_From_Source;
8756             end if;
8757
8758             --  If the node is call and has named associations,
8759             --  set the corresponding links in the copy.
8760
8761             if (Nkind (Old_Node) = N_Function_Call
8762                  or else Nkind (Old_Node) = N_Entry_Call_Statement
8763                  or else
8764                    Nkind (Old_Node) = N_Procedure_Call_Statement)
8765               and then Present (First_Named_Actual (Old_Node))
8766             then
8767                Adjust_Named_Associations (Old_Node, New_Node);
8768             end if;
8769
8770             --  Reset First_Real_Statement for Handled_Sequence_Of_Statements.
8771             --  The replacement mechanism applies to entities, and is not used
8772             --  here. Eventually we may need a more general graph-copying
8773             --  routine. For now, do a sequential search to find desired node.
8774
8775             if Nkind (Old_Node) = N_Handled_Sequence_Of_Statements
8776               and then Present (First_Real_Statement (Old_Node))
8777             then
8778                declare
8779                   Old_F  : constant Node_Id := First_Real_Statement (Old_Node);
8780                   N1, N2 : Node_Id;
8781
8782                begin
8783                   N1 := First (Statements (Old_Node));
8784                   N2 := First (Statements (New_Node));
8785
8786                   while N1 /= Old_F loop
8787                      Next (N1);
8788                      Next (N2);
8789                   end loop;
8790
8791                   Set_First_Real_Statement (New_Node, N2);
8792                end;
8793             end if;
8794          end if;
8795
8796          --  All done, return copied node
8797
8798          return New_Node;
8799       end Copy_Node_With_Replacement;
8800
8801       -----------------
8802       -- Visit_Elist --
8803       -----------------
8804
8805       procedure Visit_Elist (E : Elist_Id) is
8806          Elmt : Elmt_Id;
8807       begin
8808          if Present (E) then
8809             Elmt := First_Elmt (E);
8810
8811             while Elmt /= No_Elmt loop
8812                Visit_Node (Node (Elmt));
8813                Next_Elmt (Elmt);
8814             end loop;
8815          end if;
8816       end Visit_Elist;
8817
8818       -----------------
8819       -- Visit_Field --
8820       -----------------
8821
8822       procedure Visit_Field (F : Union_Id; N : Node_Id) is
8823       begin
8824          if F = Union_Id (Empty) then
8825             return;
8826
8827          elsif F in Node_Range then
8828
8829             --  Copy node if it is syntactic, i.e. its parent pointer is
8830             --  set to point to the field that referenced it (certain
8831             --  Itypes will also meet this criterion, which is fine, since
8832             --  these are clearly Itypes that do need to be copied, since
8833             --  we are copying their parent.)
8834
8835             if Parent (Node_Id (F)) = N then
8836                Visit_Node (Node_Id (F));
8837                return;
8838
8839             --  Another case, if we are pointing to an Itype, then we want
8840             --  to copy it if its associated node is somewhere in the tree
8841             --  being copied.
8842
8843             --  Note: the exclusion of self-referential copies is just an
8844             --  optimization, since the search of the already copied list
8845             --  would catch it, but it is a common case (Etype pointing
8846             --  to itself for an Itype that is a base type).
8847
8848             elsif Has_Extension (Node_Id (F))
8849               and then Is_Itype (Entity_Id (F))
8850               and then Node_Id (F) /= N
8851             then
8852                declare
8853                   P : Node_Id;
8854
8855                begin
8856                   P := Associated_Node_For_Itype (Node_Id (F));
8857                   while Present (P) loop
8858                      if P = Source then
8859                         Visit_Node (Node_Id (F));
8860                         return;
8861                      else
8862                         P := Parent (P);
8863                      end if;
8864                   end loop;
8865
8866                   --  An Itype whose parent is not being copied definitely
8867                   --  should NOT be copied, since it does not belong in any
8868                   --  sense to the copied subtree.
8869
8870                   return;
8871                end;
8872             end if;
8873
8874          elsif F in List_Range
8875            and then Parent (List_Id (F)) = N
8876          then
8877             Visit_List (List_Id (F));
8878             return;
8879          end if;
8880       end Visit_Field;
8881
8882       -----------------
8883       -- Visit_Itype --
8884       -----------------
8885
8886       procedure Visit_Itype (Old_Itype : Entity_Id) is
8887          New_Itype : Entity_Id;
8888          E         : Elmt_Id;
8889          Ent       : Entity_Id;
8890
8891       begin
8892          --  Itypes that describe the designated type of access to subprograms
8893          --  have the structure of subprogram declarations, with signatures,
8894          --  etc. Either we duplicate the signatures completely, or choose to
8895          --  share such itypes, which is fine because their elaboration will
8896          --  have no side effects.
8897
8898          if Ekind (Old_Itype) = E_Subprogram_Type then
8899             return;
8900          end if;
8901
8902          New_Itype := New_Copy (Old_Itype);
8903
8904          --  The new Itype has all the attributes of the old one, and
8905          --  we just copy the contents of the entity. However, the back-end
8906          --  needs different names for debugging purposes, so we create a
8907          --  new internal name for it in all cases.
8908
8909          Set_Chars (New_Itype, New_Internal_Name ('T'));
8910
8911          --  If our associated node is an entity that has already been copied,
8912          --  then set the associated node of the copy to point to the right
8913          --  copy. If we have copied an Itype that is itself the associated
8914          --  node of some previously copied Itype, then we set the right
8915          --  pointer in the other direction.
8916
8917          if Present (Actual_Map) then
8918
8919             --  Case of hash tables used
8920
8921             if NCT_Hash_Tables_Used then
8922
8923                Ent := NCT_Assoc.Get (Associated_Node_For_Itype (Old_Itype));
8924
8925                if Present (Ent) then
8926                   Set_Associated_Node_For_Itype (New_Itype, Ent);
8927                end if;
8928
8929                Ent := NCT_Itype_Assoc.Get (Old_Itype);
8930                if Present (Ent) then
8931                   Set_Associated_Node_For_Itype (Ent, New_Itype);
8932
8933                --  If the hash table has no association for this Itype and
8934                --  its associated node, enter one now.
8935
8936                else
8937                   NCT_Itype_Assoc.Set
8938                     (Associated_Node_For_Itype (Old_Itype), New_Itype);
8939                end if;
8940
8941             --  Case of hash tables not used
8942
8943             else
8944                E := First_Elmt (Actual_Map);
8945                while Present (E) loop
8946                   if Associated_Node_For_Itype (Old_Itype) = Node (E) then
8947                      Set_Associated_Node_For_Itype
8948                        (New_Itype, Node (Next_Elmt (E)));
8949                   end if;
8950
8951                   if Is_Type (Node (E))
8952                     and then
8953                       Old_Itype = Associated_Node_For_Itype (Node (E))
8954                   then
8955                      Set_Associated_Node_For_Itype
8956                        (Node (Next_Elmt (E)), New_Itype);
8957                   end if;
8958
8959                   E := Next_Elmt (Next_Elmt (E));
8960                end loop;
8961             end if;
8962          end if;
8963
8964          if Present (Freeze_Node (New_Itype)) then
8965             Set_Is_Frozen (New_Itype, False);
8966             Set_Freeze_Node (New_Itype, Empty);
8967          end if;
8968
8969          --  Add new association to map
8970
8971          if No (Actual_Map) then
8972             Actual_Map := New_Elmt_List;
8973          end if;
8974
8975          Append_Elmt (Old_Itype, Actual_Map);
8976          Append_Elmt (New_Itype, Actual_Map);
8977
8978          if NCT_Hash_Tables_Used then
8979             NCT_Assoc.Set (Old_Itype, New_Itype);
8980
8981          else
8982             NCT_Table_Entries := NCT_Table_Entries + 1;
8983
8984             if NCT_Table_Entries > NCT_Hash_Threshold then
8985                Build_NCT_Hash_Tables;
8986             end if;
8987          end if;
8988
8989          --  If a record subtype is simply copied, the entity list will be
8990          --  shared. Thus cloned_Subtype must be set to indicate the sharing.
8991
8992          if Ekind_In (Old_Itype, E_Record_Subtype, E_Class_Wide_Subtype) then
8993             Set_Cloned_Subtype (New_Itype, Old_Itype);
8994          end if;
8995
8996          --  Visit descendents that eventually get copied
8997
8998          Visit_Field (Union_Id (Etype (Old_Itype)), Old_Itype);
8999
9000          if Is_Discrete_Type (Old_Itype) then
9001             Visit_Field (Union_Id (Scalar_Range (Old_Itype)), Old_Itype);
9002
9003          elsif Has_Discriminants (Base_Type (Old_Itype)) then
9004             --  ??? This should involve call to Visit_Field
9005             Visit_Elist (Discriminant_Constraint (Old_Itype));
9006
9007          elsif Is_Array_Type (Old_Itype) then
9008             if Present (First_Index (Old_Itype)) then
9009                Visit_Field (Union_Id (List_Containing
9010                                 (First_Index (Old_Itype))),
9011                             Old_Itype);
9012             end if;
9013
9014             if Is_Packed (Old_Itype) then
9015                Visit_Field (Union_Id (Packed_Array_Type (Old_Itype)),
9016                             Old_Itype);
9017             end if;
9018          end if;
9019       end Visit_Itype;
9020
9021       ----------------
9022       -- Visit_List --
9023       ----------------
9024
9025       procedure Visit_List (L : List_Id) is
9026          N : Node_Id;
9027       begin
9028          if L /= No_List then
9029             N := First (L);
9030
9031             while Present (N) loop
9032                Visit_Node (N);
9033                Next (N);
9034             end loop;
9035          end if;
9036       end Visit_List;
9037
9038       ----------------
9039       -- Visit_Node --
9040       ----------------
9041
9042       procedure Visit_Node (N : Node_Or_Entity_Id) is
9043
9044       --  Start of processing for Visit_Node
9045
9046       begin
9047          --  Handle case of an Itype, which must be copied
9048
9049          if Has_Extension (N)
9050            and then Is_Itype (N)
9051          then
9052             --  Nothing to do if already in the list. This can happen with an
9053             --  Itype entity that appears more than once in the tree.
9054             --  Note that we do not want to visit descendents in this case.
9055
9056             --  Test for already in list when hash table is used
9057
9058             if NCT_Hash_Tables_Used then
9059                if Present (NCT_Assoc.Get (Entity_Id (N))) then
9060                   return;
9061                end if;
9062
9063             --  Test for already in list when hash table not used
9064
9065             else
9066                declare
9067                   E : Elmt_Id;
9068                begin
9069                   if Present (Actual_Map) then
9070                      E := First_Elmt (Actual_Map);
9071                      while Present (E) loop
9072                         if Node (E) = N then
9073                            return;
9074                         else
9075                            E := Next_Elmt (Next_Elmt (E));
9076                         end if;
9077                      end loop;
9078                   end if;
9079                end;
9080             end if;
9081
9082             Visit_Itype (N);
9083          end if;
9084
9085          --  Visit descendents
9086
9087          Visit_Field (Field1 (N), N);
9088          Visit_Field (Field2 (N), N);
9089          Visit_Field (Field3 (N), N);
9090          Visit_Field (Field4 (N), N);
9091          Visit_Field (Field5 (N), N);
9092       end Visit_Node;
9093
9094    --  Start of processing for New_Copy_Tree
9095
9096    begin
9097       Actual_Map := Map;
9098
9099       --  See if we should use hash table
9100
9101       if No (Actual_Map) then
9102          NCT_Hash_Tables_Used := False;
9103
9104       else
9105          declare
9106             Elmt : Elmt_Id;
9107
9108          begin
9109             NCT_Table_Entries := 0;
9110
9111             Elmt := First_Elmt (Actual_Map);
9112             while Present (Elmt) loop
9113                NCT_Table_Entries := NCT_Table_Entries + 1;
9114                Next_Elmt (Elmt);
9115                Next_Elmt (Elmt);
9116             end loop;
9117
9118             if NCT_Table_Entries > NCT_Hash_Threshold then
9119                Build_NCT_Hash_Tables;
9120             else
9121                NCT_Hash_Tables_Used := False;
9122             end if;
9123          end;
9124       end if;
9125
9126       --  Hash table set up if required, now start phase one by visiting
9127       --  top node (we will recursively visit the descendents).
9128
9129       Visit_Node (Source);
9130
9131       --  Now the second phase of the copy can start. First we process
9132       --  all the mapped entities, copying their descendents.
9133
9134       if Present (Actual_Map) then
9135          declare
9136             Elmt      : Elmt_Id;
9137             New_Itype : Entity_Id;
9138          begin
9139             Elmt := First_Elmt (Actual_Map);
9140             while Present (Elmt) loop
9141                Next_Elmt (Elmt);
9142                New_Itype := Node (Elmt);
9143                Copy_Itype_With_Replacement (New_Itype);
9144                Next_Elmt (Elmt);
9145             end loop;
9146          end;
9147       end if;
9148
9149       --  Now we can copy the actual tree
9150
9151       return Copy_Node_With_Replacement (Source);
9152    end New_Copy_Tree;
9153
9154    -------------------------
9155    -- New_External_Entity --
9156    -------------------------
9157
9158    function New_External_Entity
9159      (Kind         : Entity_Kind;
9160       Scope_Id     : Entity_Id;
9161       Sloc_Value   : Source_Ptr;
9162       Related_Id   : Entity_Id;
9163       Suffix       : Character;
9164       Suffix_Index : Nat := 0;
9165       Prefix       : Character := ' ') return Entity_Id
9166    is
9167       N : constant Entity_Id :=
9168             Make_Defining_Identifier (Sloc_Value,
9169               New_External_Name
9170                 (Chars (Related_Id), Suffix, Suffix_Index, Prefix));
9171
9172    begin
9173       Set_Ekind          (N, Kind);
9174       Set_Is_Internal    (N, True);
9175       Append_Entity      (N, Scope_Id);
9176       Set_Public_Status  (N);
9177
9178       if Kind in Type_Kind then
9179          Init_Size_Align (N);
9180       end if;
9181
9182       return N;
9183    end New_External_Entity;
9184
9185    -------------------------
9186    -- New_Internal_Entity --
9187    -------------------------
9188
9189    function New_Internal_Entity
9190      (Kind       : Entity_Kind;
9191       Scope_Id   : Entity_Id;
9192       Sloc_Value : Source_Ptr;
9193       Id_Char    : Character) return Entity_Id
9194    is
9195       N : constant Entity_Id := Make_Temporary (Sloc_Value, Id_Char);
9196
9197    begin
9198       Set_Ekind          (N, Kind);
9199       Set_Is_Internal    (N, True);
9200       Append_Entity      (N, Scope_Id);
9201
9202       if Kind in Type_Kind then
9203          Init_Size_Align (N);
9204       end if;
9205
9206       return N;
9207    end New_Internal_Entity;
9208
9209    -----------------
9210    -- Next_Actual --
9211    -----------------
9212
9213    function Next_Actual (Actual_Id : Node_Id) return Node_Id is
9214       N  : Node_Id;
9215
9216    begin
9217       --  If we are pointing at a positional parameter, it is a member of a
9218       --  node list (the list of parameters), and the next parameter is the
9219       --  next node on the list, unless we hit a parameter association, then
9220       --  we shift to using the chain whose head is the First_Named_Actual in
9221       --  the parent, and then is threaded using the Next_Named_Actual of the
9222       --  Parameter_Association. All this fiddling is because the original node
9223       --  list is in the textual call order, and what we need is the
9224       --  declaration order.
9225
9226       if Is_List_Member (Actual_Id) then
9227          N := Next (Actual_Id);
9228
9229          if Nkind (N) = N_Parameter_Association then
9230             return First_Named_Actual (Parent (Actual_Id));
9231          else
9232             return N;
9233          end if;
9234
9235       else
9236          return Next_Named_Actual (Parent (Actual_Id));
9237       end if;
9238    end Next_Actual;
9239
9240    procedure Next_Actual (Actual_Id : in out Node_Id) is
9241    begin
9242       Actual_Id := Next_Actual (Actual_Id);
9243    end Next_Actual;
9244
9245    -----------------------
9246    -- Normalize_Actuals --
9247    -----------------------
9248
9249    --  Chain actuals according to formals of subprogram. If there are no named
9250    --  associations, the chain is simply the list of Parameter Associations,
9251    --  since the order is the same as the declaration order. If there are named
9252    --  associations, then the First_Named_Actual field in the N_Function_Call
9253    --  or N_Procedure_Call_Statement node points to the Parameter_Association
9254    --  node for the parameter that comes first in declaration order. The
9255    --  remaining named parameters are then chained in declaration order using
9256    --  Next_Named_Actual.
9257
9258    --  This routine also verifies that the number of actuals is compatible with
9259    --  the number and default values of formals, but performs no type checking
9260    --  (type checking is done by the caller).
9261
9262    --  If the matching succeeds, Success is set to True and the caller proceeds
9263    --  with type-checking. If the match is unsuccessful, then Success is set to
9264    --  False, and the caller attempts a different interpretation, if there is
9265    --  one.
9266
9267    --  If the flag Report is on, the call is not overloaded, and a failure to
9268    --  match can be reported here, rather than in the caller.
9269
9270    procedure Normalize_Actuals
9271      (N       : Node_Id;
9272       S       : Entity_Id;
9273       Report  : Boolean;
9274       Success : out Boolean)
9275    is
9276       Actuals     : constant List_Id := Parameter_Associations (N);
9277       Actual      : Node_Id := Empty;
9278       Formal      : Entity_Id;
9279       Last        : Node_Id := Empty;
9280       First_Named : Node_Id := Empty;
9281       Found       : Boolean;
9282
9283       Formals_To_Match : Integer := 0;
9284       Actuals_To_Match : Integer := 0;
9285
9286       procedure Chain (A : Node_Id);
9287       --  Add named actual at the proper place in the list, using the
9288       --  Next_Named_Actual link.
9289
9290       function Reporting return Boolean;
9291       --  Determines if an error is to be reported. To report an error, we
9292       --  need Report to be True, and also we do not report errors caused
9293       --  by calls to init procs that occur within other init procs. Such
9294       --  errors must always be cascaded errors, since if all the types are
9295       --  declared correctly, the compiler will certainly build decent calls!
9296
9297       -----------
9298       -- Chain --
9299       -----------
9300
9301       procedure Chain (A : Node_Id) is
9302       begin
9303          if No (Last) then
9304
9305             --  Call node points to first actual in list
9306
9307             Set_First_Named_Actual (N, Explicit_Actual_Parameter (A));
9308
9309          else
9310             Set_Next_Named_Actual (Last, Explicit_Actual_Parameter (A));
9311          end if;
9312
9313          Last := A;
9314          Set_Next_Named_Actual (Last, Empty);
9315       end Chain;
9316
9317       ---------------
9318       -- Reporting --
9319       ---------------
9320
9321       function Reporting return Boolean is
9322       begin
9323          if not Report then
9324             return False;
9325
9326          elsif not Within_Init_Proc then
9327             return True;
9328
9329          elsif Is_Init_Proc (Entity (Name (N))) then
9330             return False;
9331
9332          else
9333             return True;
9334          end if;
9335       end Reporting;
9336
9337    --  Start of processing for Normalize_Actuals
9338
9339    begin
9340       if Is_Access_Type (S) then
9341
9342          --  The name in the call is a function call that returns an access
9343          --  to subprogram. The designated type has the list of formals.
9344
9345          Formal := First_Formal (Designated_Type (S));
9346       else
9347          Formal := First_Formal (S);
9348       end if;
9349
9350       while Present (Formal) loop
9351          Formals_To_Match := Formals_To_Match + 1;
9352          Next_Formal (Formal);
9353       end loop;
9354
9355       --  Find if there is a named association, and verify that no positional
9356       --  associations appear after named ones.
9357
9358       if Present (Actuals) then
9359          Actual := First (Actuals);
9360       end if;
9361
9362       while Present (Actual)
9363         and then Nkind (Actual) /= N_Parameter_Association
9364       loop
9365          Actuals_To_Match := Actuals_To_Match + 1;
9366          Next (Actual);
9367       end loop;
9368
9369       if No (Actual) and Actuals_To_Match = Formals_To_Match then
9370
9371          --  Most common case: positional notation, no defaults
9372
9373          Success := True;
9374          return;
9375
9376       elsif Actuals_To_Match > Formals_To_Match then
9377
9378          --  Too many actuals: will not work
9379
9380          if Reporting then
9381             if Is_Entity_Name (Name (N)) then
9382                Error_Msg_N ("too many arguments in call to&", Name (N));
9383             else
9384                Error_Msg_N ("too many arguments in call", N);
9385             end if;
9386          end if;
9387
9388          Success := False;
9389          return;
9390       end if;
9391
9392       First_Named := Actual;
9393
9394       while Present (Actual) loop
9395          if Nkind (Actual) /= N_Parameter_Association then
9396             Error_Msg_N
9397               ("positional parameters not allowed after named ones", Actual);
9398             Success := False;
9399             return;
9400
9401          else
9402             Actuals_To_Match := Actuals_To_Match + 1;
9403          end if;
9404
9405          Next (Actual);
9406       end loop;
9407
9408       if Present (Actuals) then
9409          Actual := First (Actuals);
9410       end if;
9411
9412       Formal := First_Formal (S);
9413       while Present (Formal) loop
9414
9415          --  Match the formals in order. If the corresponding actual is
9416          --  positional, nothing to do. Else scan the list of named actuals
9417          --  to find the one with the right name.
9418
9419          if Present (Actual)
9420            and then Nkind (Actual) /= N_Parameter_Association
9421          then
9422             Next (Actual);
9423             Actuals_To_Match := Actuals_To_Match - 1;
9424             Formals_To_Match := Formals_To_Match - 1;
9425
9426          else
9427             --  For named parameters, search the list of actuals to find
9428             --  one that matches the next formal name.
9429
9430             Actual := First_Named;
9431             Found  := False;
9432             while Present (Actual) loop
9433                if Chars (Selector_Name (Actual)) = Chars (Formal) then
9434                   Found := True;
9435                   Chain (Actual);
9436                   Actuals_To_Match := Actuals_To_Match - 1;
9437                   Formals_To_Match := Formals_To_Match - 1;
9438                   exit;
9439                end if;
9440
9441                Next (Actual);
9442             end loop;
9443
9444             if not Found then
9445                if Ekind (Formal) /= E_In_Parameter
9446                  or else No (Default_Value (Formal))
9447                then
9448                   if Reporting then
9449                      if (Comes_From_Source (S)
9450                           or else Sloc (S) = Standard_Location)
9451                        and then Is_Overloadable (S)
9452                      then
9453                         if No (Actuals)
9454                           and then
9455                            (Nkind (Parent (N)) = N_Procedure_Call_Statement
9456                              or else
9457                            (Nkind (Parent (N)) = N_Function_Call
9458                              or else
9459                             Nkind (Parent (N)) = N_Parameter_Association))
9460                           and then Ekind (S) /= E_Function
9461                         then
9462                            Set_Etype (N, Etype (S));
9463                         else
9464                            Error_Msg_Name_1 := Chars (S);
9465                            Error_Msg_Sloc := Sloc (S);
9466                            Error_Msg_NE
9467                              ("missing argument for parameter & " &
9468                                 "in call to % declared #", N, Formal);
9469                         end if;
9470
9471                      elsif Is_Overloadable (S) then
9472                         Error_Msg_Name_1 := Chars (S);
9473
9474                         --  Point to type derivation that generated the
9475                         --  operation.
9476
9477                         Error_Msg_Sloc := Sloc (Parent (S));
9478
9479                         Error_Msg_NE
9480                           ("missing argument for parameter & " &
9481                              "in call to % (inherited) #", N, Formal);
9482
9483                      else
9484                         Error_Msg_NE
9485                           ("missing argument for parameter &", N, Formal);
9486                      end if;
9487                   end if;
9488
9489                   Success := False;
9490                   return;
9491
9492                else
9493                   Formals_To_Match := Formals_To_Match - 1;
9494                end if;
9495             end if;
9496          end if;
9497
9498          Next_Formal (Formal);
9499       end loop;
9500
9501       if Formals_To_Match = 0 and then Actuals_To_Match = 0 then
9502          Success := True;
9503          return;
9504
9505       else
9506          if Reporting then
9507
9508             --  Find some superfluous named actual that did not get
9509             --  attached to the list of associations.
9510
9511             Actual := First (Actuals);
9512             while Present (Actual) loop
9513                if Nkind (Actual) = N_Parameter_Association
9514                  and then Actual /= Last
9515                  and then No (Next_Named_Actual (Actual))
9516                then
9517                   Error_Msg_N ("unmatched actual & in call",
9518                     Selector_Name (Actual));
9519                   exit;
9520                end if;
9521
9522                Next (Actual);
9523             end loop;
9524          end if;
9525
9526          Success := False;
9527          return;
9528       end if;
9529    end Normalize_Actuals;
9530
9531    --------------------------------
9532    -- Note_Possible_Modification --
9533    --------------------------------
9534
9535    procedure Note_Possible_Modification (N : Node_Id; Sure : Boolean) is
9536       Modification_Comes_From_Source : constant Boolean :=
9537                                          Comes_From_Source (Parent (N));
9538
9539       Ent : Entity_Id;
9540       Exp : Node_Id;
9541
9542    begin
9543       --  Loop to find referenced entity, if there is one
9544
9545       Exp := N;
9546       loop
9547          <<Continue>>
9548          Ent := Empty;
9549
9550          if Is_Entity_Name (Exp) then
9551             Ent := Entity (Exp);
9552
9553             --  If the entity is missing, it is an undeclared identifier,
9554             --  and there is nothing to annotate.
9555
9556             if No (Ent) then
9557                return;
9558             end if;
9559
9560          elsif Nkind (Exp) = N_Explicit_Dereference then
9561             declare
9562                P : constant Node_Id := Prefix (Exp);
9563
9564             begin
9565                if Nkind (P) = N_Selected_Component
9566                  and then Present (
9567                    Entry_Formal (Entity (Selector_Name (P))))
9568                then
9569                   --  Case of a reference to an entry formal
9570
9571                   Ent := Entry_Formal (Entity (Selector_Name (P)));
9572
9573                elsif Nkind (P) = N_Identifier
9574                  and then Nkind (Parent (Entity (P))) = N_Object_Declaration
9575                  and then Present (Expression (Parent (Entity (P))))
9576                  and then Nkind (Expression (Parent (Entity (P))))
9577                    = N_Reference
9578                then
9579                   --  Case of a reference to a value on which side effects have
9580                   --  been removed.
9581
9582                   Exp := Prefix (Expression (Parent (Entity (P))));
9583                   goto Continue;
9584
9585                else
9586                   return;
9587
9588                end if;
9589             end;
9590
9591          elsif     Nkind (Exp) = N_Type_Conversion
9592            or else Nkind (Exp) = N_Unchecked_Type_Conversion
9593          then
9594             Exp := Expression (Exp);
9595             goto Continue;
9596
9597          elsif     Nkind (Exp) = N_Slice
9598            or else Nkind (Exp) = N_Indexed_Component
9599            or else Nkind (Exp) = N_Selected_Component
9600          then
9601             Exp := Prefix (Exp);
9602             goto Continue;
9603
9604          else
9605             return;
9606          end if;
9607
9608          --  Now look for entity being referenced
9609
9610          if Present (Ent) then
9611             if Is_Object (Ent) then
9612                if Comes_From_Source (Exp)
9613                  or else Modification_Comes_From_Source
9614                then
9615                   --  Give warning if pragma unmodified given and we are
9616                   --  sure this is a modification.
9617
9618                   if Has_Pragma_Unmodified (Ent) and then Sure then
9619                      Error_Msg_NE ("?pragma Unmodified given for &!", N, Ent);
9620                   end if;
9621
9622                   Set_Never_Set_In_Source (Ent, False);
9623                end if;
9624
9625                Set_Is_True_Constant (Ent, False);
9626                Set_Current_Value    (Ent, Empty);
9627                Set_Is_Known_Null    (Ent, False);
9628
9629                if not Can_Never_Be_Null (Ent) then
9630                   Set_Is_Known_Non_Null (Ent, False);
9631                end if;
9632
9633                --  Follow renaming chain
9634
9635                if (Ekind (Ent) = E_Variable or else Ekind (Ent) = E_Constant)
9636                  and then Present (Renamed_Object (Ent))
9637                then
9638                   Exp := Renamed_Object (Ent);
9639                   goto Continue;
9640                end if;
9641
9642                --  Generate a reference only if the assignment comes from
9643                --  source. This excludes, for example, calls to a dispatching
9644                --  assignment operation when the left-hand side is tagged.
9645
9646                if Modification_Comes_From_Source then
9647                   Generate_Reference (Ent, Exp, 'm');
9648
9649                   --  If the target of the assignment is the bound variable
9650                   --  in an iterator, indicate that the corresponding array
9651                   --  or container is also modified.
9652
9653                   if Ada_Version >= Ada_2012
9654                     and then
9655                       Nkind (Parent (Ent)) = N_Iterator_Specification
9656                   then
9657                      declare
9658                         Domain : constant Node_Id := Name (Parent (Ent));
9659
9660                      begin
9661                         --  TBD : in the full version of the construct, the
9662                         --  domain of iteration can be given by an expression.
9663
9664                         if Is_Entity_Name (Domain) then
9665                            Generate_Reference      (Entity (Domain), Exp, 'm');
9666                            Set_Is_True_Constant    (Entity (Domain), False);
9667                            Set_Never_Set_In_Source (Entity (Domain), False);
9668                         end if;
9669                      end;
9670                   end if;
9671                end if;
9672
9673                Check_Nested_Access (Ent);
9674             end if;
9675
9676             Kill_Checks (Ent);
9677
9678             --  If we are sure this is a modification from source, and we know
9679             --  this modifies a constant, then give an appropriate warning.
9680
9681             if Overlays_Constant (Ent)
9682               and then Modification_Comes_From_Source
9683               and then Sure
9684             then
9685                declare
9686                   A : constant Node_Id := Address_Clause (Ent);
9687                begin
9688                   if Present (A) then
9689                      declare
9690                         Exp : constant Node_Id := Expression (A);
9691                      begin
9692                         if Nkind (Exp) = N_Attribute_Reference
9693                           and then Attribute_Name (Exp) = Name_Address
9694                           and then Is_Entity_Name (Prefix (Exp))
9695                         then
9696                            Error_Msg_Sloc := Sloc (A);
9697                            Error_Msg_NE
9698                              ("constant& may be modified via address clause#?",
9699                               N, Entity (Prefix (Exp)));
9700                         end if;
9701                      end;
9702                   end if;
9703                end;
9704             end if;
9705
9706             return;
9707          end if;
9708       end loop;
9709    end Note_Possible_Modification;
9710
9711    -------------------------
9712    -- Object_Access_Level --
9713    -------------------------
9714
9715    function Object_Access_Level (Obj : Node_Id) return Uint is
9716       E : Entity_Id;
9717
9718    --  Returns the static accessibility level of the view denoted by Obj. Note
9719    --  that the value returned is the result of a call to Scope_Depth. Only
9720    --  scope depths associated with dynamic scopes can actually be returned.
9721    --  Since only relative levels matter for accessibility checking, the fact
9722    --  that the distance between successive levels of accessibility is not
9723    --  always one is immaterial (invariant: if level(E2) is deeper than
9724    --  level(E1), then Scope_Depth(E1) < Scope_Depth(E2)).
9725
9726       function Reference_To (Obj : Node_Id) return Node_Id;
9727       --  An explicit dereference is created when removing side-effects from
9728       --  expressions for constraint checking purposes. In this case a local
9729       --  access type is created for it. The correct access level is that of
9730       --  the original source node. We detect this case by noting that the
9731       --  prefix of the dereference is created by an object declaration whose
9732       --  initial expression is a reference.
9733
9734       ------------------
9735       -- Reference_To --
9736       ------------------
9737
9738       function Reference_To (Obj : Node_Id) return Node_Id is
9739          Pref : constant Node_Id := Prefix (Obj);
9740       begin
9741          if Is_Entity_Name (Pref)
9742            and then Nkind (Parent (Entity (Pref))) = N_Object_Declaration
9743            and then Present (Expression (Parent (Entity (Pref))))
9744            and then Nkind (Expression (Parent (Entity (Pref)))) = N_Reference
9745          then
9746             return (Prefix (Expression (Parent (Entity (Pref)))));
9747          else
9748             return Empty;
9749          end if;
9750       end Reference_To;
9751
9752    --  Start of processing for Object_Access_Level
9753
9754    begin
9755       if Is_Entity_Name (Obj) then
9756          E := Entity (Obj);
9757
9758          if Is_Prival (E) then
9759             E := Prival_Link (E);
9760          end if;
9761
9762          --  If E is a type then it denotes a current instance. For this case
9763          --  we add one to the normal accessibility level of the type to ensure
9764          --  that current instances are treated as always being deeper than
9765          --  than the level of any visible named access type (see 3.10.2(21)).
9766
9767          if Is_Type (E) then
9768             return Type_Access_Level (E) +  1;
9769
9770          elsif Present (Renamed_Object (E)) then
9771             return Object_Access_Level (Renamed_Object (E));
9772
9773          --  Similarly, if E is a component of the current instance of a
9774          --  protected type, any instance of it is assumed to be at a deeper
9775          --  level than the type. For a protected object (whose type is an
9776          --  anonymous protected type) its components are at the same level
9777          --  as the type itself.
9778
9779          elsif not Is_Overloadable (E)
9780            and then Ekind (Scope (E)) = E_Protected_Type
9781            and then Comes_From_Source (Scope (E))
9782          then
9783             return Type_Access_Level (Scope (E)) + 1;
9784
9785          else
9786             return Scope_Depth (Enclosing_Dynamic_Scope (E));
9787          end if;
9788
9789       elsif Nkind (Obj) = N_Selected_Component then
9790          if Is_Access_Type (Etype (Prefix (Obj))) then
9791             return Type_Access_Level (Etype (Prefix (Obj)));
9792          else
9793             return Object_Access_Level (Prefix (Obj));
9794          end if;
9795
9796       elsif Nkind (Obj) = N_Indexed_Component then
9797          if Is_Access_Type (Etype (Prefix (Obj))) then
9798             return Type_Access_Level (Etype (Prefix (Obj)));
9799          else
9800             return Object_Access_Level (Prefix (Obj));
9801          end if;
9802
9803       elsif Nkind (Obj) = N_Explicit_Dereference then
9804
9805          --  If the prefix is a selected access discriminant then we make a
9806          --  recursive call on the prefix, which will in turn check the level
9807          --  of the prefix object of the selected discriminant.
9808
9809          if Nkind (Prefix (Obj)) = N_Selected_Component
9810            and then Ekind (Etype (Prefix (Obj))) = E_Anonymous_Access_Type
9811            and then
9812              Ekind (Entity (Selector_Name (Prefix (Obj)))) = E_Discriminant
9813          then
9814             return Object_Access_Level (Prefix (Obj));
9815
9816          elsif not (Comes_From_Source (Obj)) then
9817             declare
9818                Ref : constant Node_Id := Reference_To (Obj);
9819             begin
9820                if Present (Ref) then
9821                   return Object_Access_Level (Ref);
9822                else
9823                   return Type_Access_Level (Etype (Prefix (Obj)));
9824                end if;
9825             end;
9826
9827          else
9828             return Type_Access_Level (Etype (Prefix (Obj)));
9829          end if;
9830
9831       elsif Nkind (Obj) = N_Type_Conversion
9832         or else Nkind (Obj) = N_Unchecked_Type_Conversion
9833       then
9834          return Object_Access_Level (Expression (Obj));
9835
9836       elsif Nkind (Obj) = N_Function_Call then
9837
9838          --  Function results are objects, so we get either the access level of
9839          --  the function or, in the case of an indirect call, the level of the
9840          --  access-to-subprogram type. (This code is used for Ada 95, but it
9841          --  looks wrong, because it seems that we should be checking the level
9842          --  of the call itself, even for Ada 95. However, using the Ada 2005
9843          --  version of the code causes regressions in several tests that are
9844          --  compiled with -gnat95. ???)
9845
9846          if Ada_Version < Ada_2005 then
9847             if Is_Entity_Name (Name (Obj)) then
9848                return Subprogram_Access_Level (Entity (Name (Obj)));
9849             else
9850                return Type_Access_Level (Etype (Prefix (Name (Obj))));
9851             end if;
9852
9853          --  For Ada 2005, the level of the result object of a function call is
9854          --  defined to be the level of the call's innermost enclosing master.
9855          --  We determine that by querying the depth of the innermost enclosing
9856          --  dynamic scope.
9857
9858          else
9859             Return_Master_Scope_Depth_Of_Call : declare
9860
9861                function Innermost_Master_Scope_Depth
9862                  (N : Node_Id) return Uint;
9863                --  Returns the scope depth of the given node's innermost
9864                --  enclosing dynamic scope (effectively the accessibility
9865                --  level of the innermost enclosing master).
9866
9867                ----------------------------------
9868                -- Innermost_Master_Scope_Depth --
9869                ----------------------------------
9870
9871                function Innermost_Master_Scope_Depth
9872                  (N : Node_Id) return Uint
9873                is
9874                   Node_Par : Node_Id := Parent (N);
9875
9876                begin
9877                   --  Locate the nearest enclosing node (by traversing Parents)
9878                   --  that Defining_Entity can be applied to, and return the
9879                   --  depth of that entity's nearest enclosing dynamic scope.
9880
9881                   while Present (Node_Par) loop
9882                      case Nkind (Node_Par) is
9883                         when N_Component_Declaration           |
9884                              N_Entry_Declaration               |
9885                              N_Formal_Object_Declaration       |
9886                              N_Formal_Type_Declaration         |
9887                              N_Full_Type_Declaration           |
9888                              N_Incomplete_Type_Declaration     |
9889                              N_Loop_Parameter_Specification    |
9890                              N_Object_Declaration              |
9891                              N_Protected_Type_Declaration      |
9892                              N_Private_Extension_Declaration   |
9893                              N_Private_Type_Declaration        |
9894                              N_Subtype_Declaration             |
9895                              N_Function_Specification          |
9896                              N_Procedure_Specification         |
9897                              N_Task_Type_Declaration           |
9898                              N_Body_Stub                       |
9899                              N_Generic_Instantiation           |
9900                              N_Proper_Body                     |
9901                              N_Implicit_Label_Declaration      |
9902                              N_Package_Declaration             |
9903                              N_Single_Task_Declaration         |
9904                              N_Subprogram_Declaration          |
9905                              N_Generic_Declaration             |
9906                              N_Renaming_Declaration            |
9907                              N_Block_Statement                 |
9908                              N_Formal_Subprogram_Declaration   |
9909                              N_Abstract_Subprogram_Declaration |
9910                              N_Entry_Body                      |
9911                              N_Exception_Declaration           |
9912                              N_Formal_Package_Declaration      |
9913                              N_Number_Declaration              |
9914                              N_Package_Specification           |
9915                              N_Parameter_Specification         |
9916                              N_Single_Protected_Declaration    |
9917                              N_Subunit                         =>
9918
9919                            return Scope_Depth
9920                                     (Nearest_Dynamic_Scope
9921                                        (Defining_Entity (Node_Par)));
9922
9923                         when others =>
9924                            null;
9925                      end case;
9926
9927                      Node_Par := Parent (Node_Par);
9928                   end loop;
9929
9930                   pragma Assert (False);
9931
9932                   --  Should never reach the following return
9933
9934                   return Scope_Depth (Current_Scope) + 1;
9935                end Innermost_Master_Scope_Depth;
9936
9937             --  Start of processing for Return_Master_Scope_Depth_Of_Call
9938
9939             begin
9940                return Innermost_Master_Scope_Depth (Obj);
9941             end Return_Master_Scope_Depth_Of_Call;
9942          end if;
9943
9944       --  For convenience we handle qualified expressions, even though
9945       --  they aren't technically object names.
9946
9947       elsif Nkind (Obj) = N_Qualified_Expression then
9948          return Object_Access_Level (Expression (Obj));
9949
9950       --  Otherwise return the scope level of Standard.
9951       --  (If there are cases that fall through
9952       --  to this point they will be treated as
9953       --  having global accessibility for now. ???)
9954
9955       else
9956          return Scope_Depth (Standard_Standard);
9957       end if;
9958    end Object_Access_Level;
9959
9960    --------------------------------------
9961    -- Original_Corresponding_Operation --
9962    --------------------------------------
9963
9964    function Original_Corresponding_Operation (S : Entity_Id) return Entity_Id
9965    is
9966       Typ : constant Entity_Id := Find_Dispatching_Type (S);
9967
9968    begin
9969       --  If S is an inherited primitive S2 the original corresponding
9970       --  operation of S is the original corresponding operation of S2
9971
9972       if Present (Alias (S))
9973         and then Find_Dispatching_Type (Alias (S)) /= Typ
9974       then
9975          return Original_Corresponding_Operation (Alias (S));
9976
9977       --  If S overrides an inherited subprogram S2 the original corresponding
9978       --  operation of S is the original corresponding operation of S2
9979
9980       elsif Present (Overridden_Operation (S)) then
9981          return Original_Corresponding_Operation (Overridden_Operation (S));
9982
9983       --  otherwise it is S itself
9984
9985       else
9986          return S;
9987       end if;
9988    end Original_Corresponding_Operation;
9989
9990    -----------------------
9991    -- Private_Component --
9992    -----------------------
9993
9994    function Private_Component (Type_Id : Entity_Id) return Entity_Id is
9995       Ancestor  : constant Entity_Id := Base_Type (Type_Id);
9996
9997       function Trace_Components
9998         (T     : Entity_Id;
9999          Check : Boolean) return Entity_Id;
10000       --  Recursive function that does the work, and checks against circular
10001       --  definition for each subcomponent type.
10002
10003       ----------------------
10004       -- Trace_Components --
10005       ----------------------
10006
10007       function Trace_Components
10008          (T     : Entity_Id;
10009           Check : Boolean) return Entity_Id
10010        is
10011          Btype     : constant Entity_Id := Base_Type (T);
10012          Component : Entity_Id;
10013          P         : Entity_Id;
10014          Candidate : Entity_Id := Empty;
10015
10016       begin
10017          if Check and then Btype = Ancestor then
10018             Error_Msg_N ("circular type definition", Type_Id);
10019             return Any_Type;
10020          end if;
10021
10022          if Is_Private_Type (Btype)
10023            and then not Is_Generic_Type (Btype)
10024          then
10025             if Present (Full_View (Btype))
10026               and then Is_Record_Type (Full_View (Btype))
10027               and then not Is_Frozen (Btype)
10028             then
10029                --  To indicate that the ancestor depends on a private type, the
10030                --  current Btype is sufficient. However, to check for circular
10031                --  definition we must recurse on the full view.
10032
10033                Candidate := Trace_Components (Full_View (Btype), True);
10034
10035                if Candidate = Any_Type then
10036                   return Any_Type;
10037                else
10038                   return Btype;
10039                end if;
10040
10041             else
10042                return Btype;
10043             end if;
10044
10045          elsif Is_Array_Type (Btype) then
10046             return Trace_Components (Component_Type (Btype), True);
10047
10048          elsif Is_Record_Type (Btype) then
10049             Component := First_Entity (Btype);
10050             while Present (Component) loop
10051
10052                --  Skip anonymous types generated by constrained components
10053
10054                if not Is_Type (Component) then
10055                   P := Trace_Components (Etype (Component), True);
10056
10057                   if Present (P) then
10058                      if P = Any_Type then
10059                         return P;
10060                      else
10061                         Candidate := P;
10062                      end if;
10063                   end if;
10064                end if;
10065
10066                Next_Entity (Component);
10067             end loop;
10068
10069             return Candidate;
10070
10071          else
10072             return Empty;
10073          end if;
10074       end Trace_Components;
10075
10076    --  Start of processing for Private_Component
10077
10078    begin
10079       return Trace_Components (Type_Id, False);
10080    end Private_Component;
10081
10082    ---------------------------
10083    -- Primitive_Names_Match --
10084    ---------------------------
10085
10086    function Primitive_Names_Match (E1, E2 : Entity_Id) return Boolean is
10087
10088       function Non_Internal_Name (E : Entity_Id) return Name_Id;
10089       --  Given an internal name, returns the corresponding non-internal name
10090
10091       ------------------------
10092       --  Non_Internal_Name --
10093       ------------------------
10094
10095       function Non_Internal_Name (E : Entity_Id) return Name_Id is
10096       begin
10097          Get_Name_String (Chars (E));
10098          Name_Len := Name_Len - 1;
10099          return Name_Find;
10100       end Non_Internal_Name;
10101
10102    --  Start of processing for Primitive_Names_Match
10103
10104    begin
10105       pragma Assert (Present (E1) and then Present (E2));
10106
10107       return Chars (E1) = Chars (E2)
10108         or else
10109            (not Is_Internal_Name (Chars (E1))
10110               and then Is_Internal_Name (Chars (E2))
10111               and then Non_Internal_Name (E2) = Chars (E1))
10112         or else
10113            (not Is_Internal_Name (Chars (E2))
10114               and then Is_Internal_Name (Chars (E1))
10115               and then Non_Internal_Name (E1) = Chars (E2))
10116         or else
10117            (Is_Predefined_Dispatching_Operation (E1)
10118               and then Is_Predefined_Dispatching_Operation (E2)
10119               and then Same_TSS (E1, E2))
10120         or else
10121            (Is_Init_Proc (E1) and then Is_Init_Proc (E2));
10122    end Primitive_Names_Match;
10123
10124    -----------------------
10125    -- Process_End_Label --
10126    -----------------------
10127
10128    procedure Process_End_Label
10129      (N   : Node_Id;
10130       Typ : Character;
10131       Ent  : Entity_Id)
10132    is
10133       Loc  : Source_Ptr;
10134       Nam  : Node_Id;
10135       Scop : Entity_Id;
10136
10137       Label_Ref : Boolean;
10138       --  Set True if reference to end label itself is required
10139
10140       Endl : Node_Id;
10141       --  Gets set to the operator symbol or identifier that references the
10142       --  entity Ent. For the child unit case, this is the identifier from the
10143       --  designator. For other cases, this is simply Endl.
10144
10145       procedure Generate_Parent_Ref (N : Node_Id; E : Entity_Id);
10146       --  N is an identifier node that appears as a parent unit reference in
10147       --  the case where Ent is a child unit. This procedure generates an
10148       --  appropriate cross-reference entry. E is the corresponding entity.
10149
10150       -------------------------
10151       -- Generate_Parent_Ref --
10152       -------------------------
10153
10154       procedure Generate_Parent_Ref (N : Node_Id; E : Entity_Id) is
10155       begin
10156          --  If names do not match, something weird, skip reference
10157
10158          if Chars (E) = Chars (N) then
10159
10160             --  Generate the reference. We do NOT consider this as a reference
10161             --  for unreferenced symbol purposes.
10162
10163             Generate_Reference (E, N, 'r', Set_Ref => False, Force => True);
10164
10165             if Style_Check then
10166                Style.Check_Identifier (N, E);
10167             end if;
10168          end if;
10169       end Generate_Parent_Ref;
10170
10171    --  Start of processing for Process_End_Label
10172
10173    begin
10174       --  If no node, ignore. This happens in some error situations, and
10175       --  also for some internally generated structures where no end label
10176       --  references are required in any case.
10177
10178       if No (N) then
10179          return;
10180       end if;
10181
10182       --  Nothing to do if no End_Label, happens for internally generated
10183       --  constructs where we don't want an end label reference anyway. Also
10184       --  nothing to do if Endl is a string literal, which means there was
10185       --  some prior error (bad operator symbol)
10186
10187       Endl := End_Label (N);
10188
10189       if No (Endl) or else Nkind (Endl) = N_String_Literal then
10190          return;
10191       end if;
10192
10193       --  Reference node is not in extended main source unit
10194
10195       if not In_Extended_Main_Source_Unit (N) then
10196
10197          --  Generally we do not collect references except for the extended
10198          --  main source unit. The one exception is the 'e' entry for a
10199          --  package spec, where it is useful for a client to have the
10200          --  ending information to define scopes.
10201
10202          if Typ /= 'e' then
10203             return;
10204
10205          else
10206             Label_Ref := False;
10207
10208             --  For this case, we can ignore any parent references, but we
10209             --  need the package name itself for the 'e' entry.
10210
10211             if Nkind (Endl) = N_Designator then
10212                Endl := Identifier (Endl);
10213             end if;
10214          end if;
10215
10216       --  Reference is in extended main source unit
10217
10218       else
10219          Label_Ref := True;
10220
10221          --  For designator, generate references for the parent entries
10222
10223          if Nkind (Endl) = N_Designator then
10224
10225             --  Generate references for the prefix if the END line comes from
10226             --  source (otherwise we do not need these references) We climb the
10227             --  scope stack to find the expected entities.
10228
10229             if Comes_From_Source (Endl) then
10230                Nam  := Name (Endl);
10231                Scop := Current_Scope;
10232                while Nkind (Nam) = N_Selected_Component loop
10233                   Scop := Scope (Scop);
10234                   exit when No (Scop);
10235                   Generate_Parent_Ref (Selector_Name (Nam), Scop);
10236                   Nam := Prefix (Nam);
10237                end loop;
10238
10239                if Present (Scop) then
10240                   Generate_Parent_Ref (Nam, Scope (Scop));
10241                end if;
10242             end if;
10243
10244             Endl := Identifier (Endl);
10245          end if;
10246       end if;
10247
10248       --  If the end label is not for the given entity, then either we have
10249       --  some previous error, or this is a generic instantiation for which
10250       --  we do not need to make a cross-reference in this case anyway. In
10251       --  either case we simply ignore the call.
10252
10253       if Chars (Ent) /= Chars (Endl) then
10254          return;
10255       end if;
10256
10257       --  If label was really there, then generate a normal reference and then
10258       --  adjust the location in the end label to point past the name (which
10259       --  should almost always be the semicolon).
10260
10261       Loc := Sloc (Endl);
10262
10263       if Comes_From_Source (Endl) then
10264
10265          --  If a label reference is required, then do the style check and
10266          --  generate an l-type cross-reference entry for the label
10267
10268          if Label_Ref then
10269             if Style_Check then
10270                Style.Check_Identifier (Endl, Ent);
10271             end if;
10272
10273             Generate_Reference (Ent, Endl, 'l', Set_Ref => False);
10274          end if;
10275
10276          --  Set the location to point past the label (normally this will
10277          --  mean the semicolon immediately following the label). This is
10278          --  done for the sake of the 'e' or 't' entry generated below.
10279
10280          Get_Decoded_Name_String (Chars (Endl));
10281          Set_Sloc (Endl, Sloc (Endl) + Source_Ptr (Name_Len));
10282       end if;
10283
10284       --  Now generate the e/t reference
10285
10286       Generate_Reference (Ent, Endl, Typ, Set_Ref => False, Force => True);
10287
10288       --  Restore Sloc, in case modified above, since we have an identifier
10289       --  and the normal Sloc should be left set in the tree.
10290
10291       Set_Sloc (Endl, Loc);
10292    end Process_End_Label;
10293
10294    ------------------------------------
10295    -- References_Generic_Formal_Type --
10296    ------------------------------------
10297
10298    function References_Generic_Formal_Type (N : Node_Id) return Boolean is
10299
10300       function Process (N : Node_Id) return Traverse_Result;
10301       --  Process one node in search for generic formal type
10302
10303       -------------
10304       -- Process --
10305       -------------
10306
10307       function Process (N : Node_Id) return Traverse_Result is
10308       begin
10309          if Nkind (N) in N_Has_Entity then
10310             declare
10311                E : constant Entity_Id := Entity (N);
10312             begin
10313                if Present (E) then
10314                   if Is_Generic_Type (E) then
10315                      return Abandon;
10316                   elsif Present (Etype (E))
10317                     and then Is_Generic_Type (Etype (E))
10318                   then
10319                      return Abandon;
10320                   end if;
10321                end if;
10322             end;
10323          end if;
10324
10325          return Atree.OK;
10326       end Process;
10327
10328       function Traverse is new Traverse_Func (Process);
10329       --  Traverse tree to look for generic type
10330
10331    begin
10332       if Inside_A_Generic then
10333          return Traverse (N) = Abandon;
10334       else
10335          return False;
10336       end if;
10337    end References_Generic_Formal_Type;
10338
10339    --------------------
10340    -- Remove_Homonym --
10341    --------------------
10342
10343    procedure Remove_Homonym (E : Entity_Id) is
10344       Prev  : Entity_Id := Empty;
10345       H     : Entity_Id;
10346
10347    begin
10348       if E = Current_Entity (E) then
10349          if Present (Homonym (E)) then
10350             Set_Current_Entity (Homonym (E));
10351          else
10352             Set_Name_Entity_Id (Chars (E), Empty);
10353          end if;
10354       else
10355          H := Current_Entity (E);
10356          while Present (H) and then H /= E loop
10357             Prev := H;
10358             H    := Homonym (H);
10359          end loop;
10360
10361          Set_Homonym (Prev, Homonym (E));
10362       end if;
10363    end Remove_Homonym;
10364
10365    ---------------------
10366    -- Rep_To_Pos_Flag --
10367    ---------------------
10368
10369    function Rep_To_Pos_Flag (E : Entity_Id; Loc : Source_Ptr) return Node_Id is
10370    begin
10371       return New_Occurrence_Of
10372                (Boolean_Literals (not Range_Checks_Suppressed (E)), Loc);
10373    end Rep_To_Pos_Flag;
10374
10375    --------------------
10376    -- Require_Entity --
10377    --------------------
10378
10379    procedure Require_Entity (N : Node_Id) is
10380    begin
10381       if Is_Entity_Name (N) and then No (Entity (N)) then
10382          if Total_Errors_Detected /= 0 then
10383             Set_Entity (N, Any_Id);
10384          else
10385             raise Program_Error;
10386          end if;
10387       end if;
10388    end Require_Entity;
10389
10390    ------------------------------
10391    -- Requires_Transient_Scope --
10392    ------------------------------
10393
10394    --  A transient scope is required when variable-sized temporaries are
10395    --  allocated in the primary or secondary stack, or when finalization
10396    --  actions must be generated before the next instruction.
10397
10398    function Requires_Transient_Scope (Id : Entity_Id) return Boolean is
10399       Typ : constant Entity_Id := Underlying_Type (Id);
10400
10401    --  Start of processing for Requires_Transient_Scope
10402
10403    begin
10404       --  This is a private type which is not completed yet. This can only
10405       --  happen in a default expression (of a formal parameter or of a
10406       --  record component). Do not expand transient scope in this case
10407
10408       if No (Typ) then
10409          return False;
10410
10411       --  Do not expand transient scope for non-existent procedure return
10412
10413       elsif Typ = Standard_Void_Type then
10414          return False;
10415
10416       --  Elementary types do not require a transient scope
10417
10418       elsif Is_Elementary_Type (Typ) then
10419          return False;
10420
10421       --  Generally, indefinite subtypes require a transient scope, since the
10422       --  back end cannot generate temporaries, since this is not a valid type
10423       --  for declaring an object. It might be possible to relax this in the
10424       --  future, e.g. by declaring the maximum possible space for the type.
10425
10426       elsif Is_Indefinite_Subtype (Typ) then
10427          return True;
10428
10429       --  Functions returning tagged types may dispatch on result so their
10430       --  returned value is allocated on the secondary stack. Controlled
10431       --  type temporaries need finalization.
10432
10433       elsif Is_Tagged_Type (Typ)
10434         or else Has_Controlled_Component (Typ)
10435       then
10436          return not Is_Value_Type (Typ);
10437
10438       --  Record type
10439
10440       elsif Is_Record_Type (Typ) then
10441          declare
10442             Comp : Entity_Id;
10443          begin
10444             Comp := First_Entity (Typ);
10445             while Present (Comp) loop
10446                if Ekind (Comp) = E_Component
10447                   and then Requires_Transient_Scope (Etype (Comp))
10448                then
10449                   return True;
10450                else
10451                   Next_Entity (Comp);
10452                end if;
10453             end loop;
10454          end;
10455
10456          return False;
10457
10458       --  String literal types never require transient scope
10459
10460       elsif Ekind (Typ) = E_String_Literal_Subtype then
10461          return False;
10462
10463       --  Array type. Note that we already know that this is a constrained
10464       --  array, since unconstrained arrays will fail the indefinite test.
10465
10466       elsif Is_Array_Type (Typ) then
10467
10468          --  If component type requires a transient scope, the array does too
10469
10470          if Requires_Transient_Scope (Component_Type (Typ)) then
10471             return True;
10472
10473          --  Otherwise, we only need a transient scope if the size depends on
10474          --  the value of one or more discriminants.
10475
10476          else
10477             return Size_Depends_On_Discriminant (Typ);
10478          end if;
10479
10480       --  All other cases do not require a transient scope
10481
10482       else
10483          return False;
10484       end if;
10485    end Requires_Transient_Scope;
10486
10487    --------------------------
10488    -- Reset_Analyzed_Flags --
10489    --------------------------
10490
10491    procedure Reset_Analyzed_Flags (N : Node_Id) is
10492
10493       function Clear_Analyzed (N : Node_Id) return Traverse_Result;
10494       --  Function used to reset Analyzed flags in tree. Note that we do
10495       --  not reset Analyzed flags in entities, since there is no need to
10496       --  reanalyze entities, and indeed, it is wrong to do so, since it
10497       --  can result in generating auxiliary stuff more than once.
10498
10499       --------------------
10500       -- Clear_Analyzed --
10501       --------------------
10502
10503       function Clear_Analyzed (N : Node_Id) return Traverse_Result is
10504       begin
10505          if not Has_Extension (N) then
10506             Set_Analyzed (N, False);
10507          end if;
10508
10509          return OK;
10510       end Clear_Analyzed;
10511
10512       procedure Reset_Analyzed is new Traverse_Proc (Clear_Analyzed);
10513
10514    --  Start of processing for Reset_Analyzed_Flags
10515
10516    begin
10517       Reset_Analyzed (N);
10518    end Reset_Analyzed_Flags;
10519
10520    ---------------------------
10521    -- Safe_To_Capture_Value --
10522    ---------------------------
10523
10524    function Safe_To_Capture_Value
10525      (N    : Node_Id;
10526       Ent  : Entity_Id;
10527       Cond : Boolean := False) return Boolean
10528    is
10529    begin
10530       --  The only entities for which we track constant values are variables
10531       --  which are not renamings, constants, out parameters, and in out
10532       --  parameters, so check if we have this case.
10533
10534       --  Note: it may seem odd to track constant values for constants, but in
10535       --  fact this routine is used for other purposes than simply capturing
10536       --  the value. In particular, the setting of Known[_Non]_Null.
10537
10538       if (Ekind (Ent) = E_Variable and then No (Renamed_Object (Ent)))
10539             or else
10540           Ekind (Ent) = E_Constant
10541             or else
10542           Ekind (Ent) = E_Out_Parameter
10543             or else
10544           Ekind (Ent) = E_In_Out_Parameter
10545       then
10546          null;
10547
10548       --  For conditionals, we also allow loop parameters and all formals,
10549       --  including in parameters.
10550
10551       elsif Cond
10552         and then
10553           (Ekind (Ent) = E_Loop_Parameter
10554              or else
10555            Ekind (Ent) = E_In_Parameter)
10556       then
10557          null;
10558
10559       --  For all other cases, not just unsafe, but impossible to capture
10560       --  Current_Value, since the above are the only entities which have
10561       --  Current_Value fields.
10562
10563       else
10564          return False;
10565       end if;
10566
10567       --  Skip if volatile or aliased, since funny things might be going on in
10568       --  these cases which we cannot necessarily track. Also skip any variable
10569       --  for which an address clause is given, or whose address is taken. Also
10570       --  never capture value of library level variables (an attempt to do so
10571       --  can occur in the case of package elaboration code).
10572
10573       if Treat_As_Volatile (Ent)
10574         or else Is_Aliased (Ent)
10575         or else Present (Address_Clause (Ent))
10576         or else Address_Taken (Ent)
10577         or else (Is_Library_Level_Entity (Ent)
10578                    and then Ekind (Ent) = E_Variable)
10579       then
10580          return False;
10581       end if;
10582
10583       --  OK, all above conditions are met. We also require that the scope of
10584       --  the reference be the same as the scope of the entity, not counting
10585       --  packages and blocks and loops.
10586
10587       declare
10588          E_Scope : constant Entity_Id := Scope (Ent);
10589          R_Scope : Entity_Id;
10590
10591       begin
10592          R_Scope := Current_Scope;
10593          while R_Scope /= Standard_Standard loop
10594             exit when R_Scope = E_Scope;
10595
10596             if not Ekind_In (R_Scope, E_Package, E_Block, E_Loop) then
10597                return False;
10598             else
10599                R_Scope := Scope (R_Scope);
10600             end if;
10601          end loop;
10602       end;
10603
10604       --  We also require that the reference does not appear in a context
10605       --  where it is not sure to be executed (i.e. a conditional context
10606       --  or an exception handler). We skip this if Cond is True, since the
10607       --  capturing of values from conditional tests handles this ok.
10608
10609       if Cond then
10610          return True;
10611       end if;
10612
10613       declare
10614          Desc : Node_Id;
10615          P    : Node_Id;
10616
10617       begin
10618          Desc := N;
10619
10620          P := Parent (N);
10621          while Present (P) loop
10622             if         Nkind (P) = N_If_Statement
10623               or else  Nkind (P) = N_Case_Statement
10624               or else (Nkind (P) in N_Short_Circuit
10625                          and then Desc = Right_Opnd (P))
10626               or else (Nkind (P) = N_Conditional_Expression
10627                          and then Desc /= First (Expressions (P)))
10628               or else  Nkind (P) = N_Exception_Handler
10629               or else  Nkind (P) = N_Selective_Accept
10630               or else  Nkind (P) = N_Conditional_Entry_Call
10631               or else  Nkind (P) = N_Timed_Entry_Call
10632               or else  Nkind (P) = N_Asynchronous_Select
10633             then
10634                return False;
10635             else
10636                Desc := P;
10637                P    := Parent (P);
10638             end if;
10639          end loop;
10640       end;
10641
10642       --  OK, looks safe to set value
10643
10644       return True;
10645    end Safe_To_Capture_Value;
10646
10647    ---------------
10648    -- Same_Name --
10649    ---------------
10650
10651    function Same_Name (N1, N2 : Node_Id) return Boolean is
10652       K1 : constant Node_Kind := Nkind (N1);
10653       K2 : constant Node_Kind := Nkind (N2);
10654
10655    begin
10656       if (K1 = N_Identifier or else K1 = N_Defining_Identifier)
10657         and then (K2 = N_Identifier or else K2 = N_Defining_Identifier)
10658       then
10659          return Chars (N1) = Chars (N2);
10660
10661       elsif (K1 = N_Selected_Component or else K1 = N_Expanded_Name)
10662         and then (K2 = N_Selected_Component or else K2 = N_Expanded_Name)
10663       then
10664          return Same_Name (Selector_Name (N1), Selector_Name (N2))
10665            and then Same_Name (Prefix (N1), Prefix (N2));
10666
10667       else
10668          return False;
10669       end if;
10670    end Same_Name;
10671
10672    -----------------
10673    -- Same_Object --
10674    -----------------
10675
10676    function Same_Object (Node1, Node2 : Node_Id) return Boolean is
10677       N1 : constant Node_Id := Original_Node (Node1);
10678       N2 : constant Node_Id := Original_Node (Node2);
10679       --  We do the tests on original nodes, since we are most interested
10680       --  in the original source, not any expansion that got in the way.
10681
10682       K1 : constant Node_Kind := Nkind (N1);
10683       K2 : constant Node_Kind := Nkind (N2);
10684
10685    begin
10686       --  First case, both are entities with same entity
10687
10688       if K1 in N_Has_Entity and then K2 in N_Has_Entity then
10689          declare
10690             EN1 : constant Entity_Id := Entity (N1);
10691             EN2 : constant Entity_Id := Entity (N2);
10692          begin
10693             if Present (EN1) and then Present (EN2)
10694               and then (Ekind_In (EN1, E_Variable, E_Constant)
10695                          or else Is_Formal (EN1))
10696               and then EN1 = EN2
10697             then
10698                return True;
10699             end if;
10700          end;
10701       end if;
10702
10703       --  Second case, selected component with same selector, same record
10704
10705       if K1 = N_Selected_Component
10706         and then K2 = N_Selected_Component
10707         and then Chars (Selector_Name (N1)) = Chars (Selector_Name (N2))
10708       then
10709          return Same_Object (Prefix (N1), Prefix (N2));
10710
10711       --  Third case, indexed component with same subscripts, same array
10712
10713       elsif K1 = N_Indexed_Component
10714         and then K2 = N_Indexed_Component
10715         and then Same_Object (Prefix (N1), Prefix (N2))
10716       then
10717          declare
10718             E1, E2 : Node_Id;
10719          begin
10720             E1 := First (Expressions (N1));
10721             E2 := First (Expressions (N2));
10722             while Present (E1) loop
10723                if not Same_Value (E1, E2) then
10724                   return False;
10725                else
10726                   Next (E1);
10727                   Next (E2);
10728                end if;
10729             end loop;
10730
10731             return True;
10732          end;
10733
10734       --  Fourth case, slice of same array with same bounds
10735
10736       elsif K1 = N_Slice
10737         and then K2 = N_Slice
10738         and then Nkind (Discrete_Range (N1)) = N_Range
10739         and then Nkind (Discrete_Range (N2)) = N_Range
10740         and then Same_Value (Low_Bound (Discrete_Range (N1)),
10741                              Low_Bound (Discrete_Range (N2)))
10742         and then Same_Value (High_Bound (Discrete_Range (N1)),
10743                              High_Bound (Discrete_Range (N2)))
10744       then
10745          return Same_Name (Prefix (N1), Prefix (N2));
10746
10747       --  All other cases, not clearly the same object
10748
10749       else
10750          return False;
10751       end if;
10752    end Same_Object;
10753
10754    ---------------
10755    -- Same_Type --
10756    ---------------
10757
10758    function Same_Type (T1, T2 : Entity_Id) return Boolean is
10759    begin
10760       if T1 = T2 then
10761          return True;
10762
10763       elsif not Is_Constrained (T1)
10764         and then not Is_Constrained (T2)
10765         and then Base_Type (T1) = Base_Type (T2)
10766       then
10767          return True;
10768
10769       --  For now don't bother with case of identical constraints, to be
10770       --  fiddled with later on perhaps (this is only used for optimization
10771       --  purposes, so it is not critical to do a best possible job)
10772
10773       else
10774          return False;
10775       end if;
10776    end Same_Type;
10777
10778    ----------------
10779    -- Same_Value --
10780    ----------------
10781
10782    function Same_Value (Node1, Node2 : Node_Id) return Boolean is
10783    begin
10784       if Compile_Time_Known_Value (Node1)
10785         and then Compile_Time_Known_Value (Node2)
10786         and then Expr_Value (Node1) = Expr_Value (Node2)
10787       then
10788          return True;
10789       elsif Same_Object (Node1, Node2) then
10790          return True;
10791       else
10792          return False;
10793       end if;
10794    end Same_Value;
10795
10796    -----------------
10797    -- Save_Actual --
10798    -----------------
10799
10800    procedure Save_Actual (N : Node_Id;  Writable : Boolean := False) is
10801    begin
10802       if Ada_Version < Ada_2012 then
10803          return;
10804
10805       elsif Is_Entity_Name (N)
10806         or else
10807           Nkind_In (N, N_Indexed_Component, N_Selected_Component, N_Slice)
10808         or else
10809           (Nkind (N) = N_Attribute_Reference
10810             and then Attribute_Name (N) = Name_Access)
10811
10812       then
10813          --  We are only interested in IN OUT parameters of inner calls
10814
10815          if not Writable
10816            or else Nkind (Parent (N)) = N_Function_Call
10817            or else Nkind (Parent (N)) in N_Op
10818          then
10819             Actuals_In_Call.Increment_Last;
10820             Actuals_In_Call.Table (Actuals_In_Call.Last) := (N, Writable);
10821          end if;
10822       end if;
10823    end Save_Actual;
10824
10825    ------------------------
10826    -- Scope_Is_Transient --
10827    ------------------------
10828
10829    function Scope_Is_Transient return Boolean is
10830    begin
10831       return Scope_Stack.Table (Scope_Stack.Last).Is_Transient;
10832    end Scope_Is_Transient;
10833
10834    ------------------
10835    -- Scope_Within --
10836    ------------------
10837
10838    function Scope_Within (Scope1, Scope2 : Entity_Id) return Boolean is
10839       Scop : Entity_Id;
10840
10841    begin
10842       Scop := Scope1;
10843       while Scop /= Standard_Standard loop
10844          Scop := Scope (Scop);
10845
10846          if Scop = Scope2 then
10847             return True;
10848          end if;
10849       end loop;
10850
10851       return False;
10852    end Scope_Within;
10853
10854    --------------------------
10855    -- Scope_Within_Or_Same --
10856    --------------------------
10857
10858    function Scope_Within_Or_Same (Scope1, Scope2 : Entity_Id) return Boolean is
10859       Scop : Entity_Id;
10860
10861    begin
10862       Scop := Scope1;
10863       while Scop /= Standard_Standard loop
10864          if Scop = Scope2 then
10865             return True;
10866          else
10867             Scop := Scope (Scop);
10868          end if;
10869       end loop;
10870
10871       return False;
10872    end Scope_Within_Or_Same;
10873
10874    --------------------
10875    -- Set_Convention --
10876    --------------------
10877
10878    procedure Set_Convention (E : Entity_Id; Val : Snames.Convention_Id) is
10879    begin
10880       Basic_Set_Convention (E, Val);
10881
10882       if Is_Type (E)
10883         and then Is_Access_Subprogram_Type (Base_Type (E))
10884         and then Has_Foreign_Convention (E)
10885       then
10886          Set_Can_Use_Internal_Rep (E, False);
10887       end if;
10888    end Set_Convention;
10889
10890    ------------------------
10891    -- Set_Current_Entity --
10892    ------------------------
10893
10894    --  The given entity is to be set as the currently visible definition
10895    --  of its associated name (i.e. the Node_Id associated with its name).
10896    --  All we have to do is to get the name from the identifier, and
10897    --  then set the associated Node_Id to point to the given entity.
10898
10899    procedure Set_Current_Entity (E : Entity_Id) is
10900    begin
10901       Set_Name_Entity_Id (Chars (E), E);
10902    end Set_Current_Entity;
10903
10904    ---------------------------
10905    -- Set_Debug_Info_Needed --
10906    ---------------------------
10907
10908    procedure Set_Debug_Info_Needed (T : Entity_Id) is
10909
10910       procedure Set_Debug_Info_Needed_If_Not_Set (E : Entity_Id);
10911       pragma Inline (Set_Debug_Info_Needed_If_Not_Set);
10912       --  Used to set debug info in a related node if not set already
10913
10914       --------------------------------------
10915       -- Set_Debug_Info_Needed_If_Not_Set --
10916       --------------------------------------
10917
10918       procedure Set_Debug_Info_Needed_If_Not_Set (E : Entity_Id) is
10919       begin
10920          if Present (E)
10921            and then not Needs_Debug_Info (E)
10922          then
10923             Set_Debug_Info_Needed (E);
10924
10925             --  For a private type, indicate that the full view also needs
10926             --  debug information.
10927
10928             if Is_Type (E)
10929               and then Is_Private_Type (E)
10930               and then Present (Full_View (E))
10931             then
10932                Set_Debug_Info_Needed (Full_View (E));
10933             end if;
10934          end if;
10935       end Set_Debug_Info_Needed_If_Not_Set;
10936
10937    --  Start of processing for Set_Debug_Info_Needed
10938
10939    begin
10940       --  Nothing to do if argument is Empty or has Debug_Info_Off set, which
10941       --  indicates that Debug_Info_Needed is never required for the entity.
10942
10943       if No (T)
10944         or else Debug_Info_Off (T)
10945       then
10946          return;
10947       end if;
10948
10949       --  Set flag in entity itself. Note that we will go through the following
10950       --  circuitry even if the flag is already set on T. That's intentional,
10951       --  it makes sure that the flag will be set in subsidiary entities.
10952
10953       Set_Needs_Debug_Info (T);
10954
10955       --  Set flag on subsidiary entities if not set already
10956
10957       if Is_Object (T) then
10958          Set_Debug_Info_Needed_If_Not_Set (Etype (T));
10959
10960       elsif Is_Type (T) then
10961          Set_Debug_Info_Needed_If_Not_Set (Etype (T));
10962
10963          if Is_Record_Type (T) then
10964             declare
10965                Ent : Entity_Id := First_Entity (T);
10966             begin
10967                while Present (Ent) loop
10968                   Set_Debug_Info_Needed_If_Not_Set (Ent);
10969                   Next_Entity (Ent);
10970                end loop;
10971             end;
10972
10973             --  For a class wide subtype, we also need debug information
10974             --  for the equivalent type.
10975
10976             if Ekind (T) = E_Class_Wide_Subtype then
10977                Set_Debug_Info_Needed_If_Not_Set (Equivalent_Type (T));
10978             end if;
10979
10980          elsif Is_Array_Type (T) then
10981             Set_Debug_Info_Needed_If_Not_Set (Component_Type (T));
10982
10983             declare
10984                Indx : Node_Id := First_Index (T);
10985             begin
10986                while Present (Indx) loop
10987                   Set_Debug_Info_Needed_If_Not_Set (Etype (Indx));
10988                   Indx := Next_Index (Indx);
10989                end loop;
10990             end;
10991
10992             if Is_Packed (T) then
10993                Set_Debug_Info_Needed_If_Not_Set (Packed_Array_Type (T));
10994             end if;
10995
10996          elsif Is_Access_Type (T) then
10997             Set_Debug_Info_Needed_If_Not_Set (Directly_Designated_Type (T));
10998
10999          elsif Is_Private_Type (T) then
11000             Set_Debug_Info_Needed_If_Not_Set (Full_View (T));
11001
11002          elsif Is_Protected_Type (T) then
11003             Set_Debug_Info_Needed_If_Not_Set (Corresponding_Record_Type (T));
11004          end if;
11005       end if;
11006    end Set_Debug_Info_Needed;
11007
11008    ---------------------------------
11009    -- Set_Entity_With_Style_Check --
11010    ---------------------------------
11011
11012    procedure Set_Entity_With_Style_Check (N : Node_Id; Val : Entity_Id) is
11013       Val_Actual : Entity_Id;
11014       Nod        : Node_Id;
11015
11016    begin
11017       Set_Entity (N, Val);
11018
11019       if Style_Check
11020         and then not Suppress_Style_Checks (Val)
11021         and then not In_Instance
11022       then
11023          if Nkind (N) = N_Identifier then
11024             Nod := N;
11025          elsif Nkind (N) = N_Expanded_Name then
11026             Nod := Selector_Name (N);
11027          else
11028             return;
11029          end if;
11030
11031          --  A special situation arises for derived operations, where we want
11032          --  to do the check against the parent (since the Sloc of the derived
11033          --  operation points to the derived type declaration itself).
11034
11035          Val_Actual := Val;
11036          while not Comes_From_Source (Val_Actual)
11037            and then Nkind (Val_Actual) in N_Entity
11038            and then (Ekind (Val_Actual) = E_Enumeration_Literal
11039                       or else Is_Subprogram (Val_Actual)
11040                       or else Is_Generic_Subprogram (Val_Actual))
11041            and then Present (Alias (Val_Actual))
11042          loop
11043             Val_Actual := Alias (Val_Actual);
11044          end loop;
11045
11046          --  Renaming declarations for generic actuals do not come from source,
11047          --  and have a different name from that of the entity they rename, so
11048          --  there is no style check to perform here.
11049
11050          if Chars (Nod) = Chars (Val_Actual) then
11051             Style.Check_Identifier (Nod, Val_Actual);
11052          end if;
11053       end if;
11054
11055       Set_Entity (N, Val);
11056    end Set_Entity_With_Style_Check;
11057
11058    ------------------------
11059    -- Set_Name_Entity_Id --
11060    ------------------------
11061
11062    procedure Set_Name_Entity_Id (Id : Name_Id; Val : Entity_Id) is
11063    begin
11064       Set_Name_Table_Info (Id, Int (Val));
11065    end Set_Name_Entity_Id;
11066
11067    ---------------------
11068    -- Set_Next_Actual --
11069    ---------------------
11070
11071    procedure Set_Next_Actual (Ass1_Id : Node_Id; Ass2_Id : Node_Id) is
11072    begin
11073       if Nkind (Parent (Ass1_Id)) = N_Parameter_Association then
11074          Set_First_Named_Actual (Parent (Ass1_Id), Ass2_Id);
11075       end if;
11076    end Set_Next_Actual;
11077
11078    ----------------------------------
11079    -- Set_Optimize_Alignment_Flags --
11080    ----------------------------------
11081
11082    procedure Set_Optimize_Alignment_Flags (E : Entity_Id) is
11083    begin
11084       if Optimize_Alignment = 'S' then
11085          Set_Optimize_Alignment_Space (E);
11086       elsif Optimize_Alignment = 'T' then
11087          Set_Optimize_Alignment_Time (E);
11088       end if;
11089    end Set_Optimize_Alignment_Flags;
11090
11091    -----------------------
11092    -- Set_Public_Status --
11093    -----------------------
11094
11095    procedure Set_Public_Status (Id : Entity_Id) is
11096       S : constant Entity_Id := Current_Scope;
11097
11098       function Within_HSS_Or_If (E : Entity_Id) return Boolean;
11099       --  Determines if E is defined within handled statement sequence or
11100       --  an if statement, returns True if so, False otherwise.
11101
11102       ----------------------
11103       -- Within_HSS_Or_If --
11104       ----------------------
11105
11106       function Within_HSS_Or_If (E : Entity_Id) return Boolean is
11107          N : Node_Id;
11108       begin
11109          N := Declaration_Node (E);
11110          loop
11111             N := Parent (N);
11112
11113             if No (N) then
11114                return False;
11115
11116             elsif Nkind_In (N, N_Handled_Sequence_Of_Statements,
11117                                N_If_Statement)
11118             then
11119                return True;
11120             end if;
11121          end loop;
11122       end Within_HSS_Or_If;
11123
11124    --  Start of processing for Set_Public_Status
11125
11126    begin
11127       --  Everything in the scope of Standard is public
11128
11129       if S = Standard_Standard then
11130          Set_Is_Public (Id);
11131
11132       --  Entity is definitely not public if enclosing scope is not public
11133
11134       elsif not Is_Public (S) then
11135          return;
11136
11137       --  An object or function declaration that occurs in a handled sequence
11138       --  of statements or within an if statement is the declaration for a
11139       --  temporary object or local subprogram generated by the expander. It
11140       --  never needs to be made public and furthermore, making it public can
11141       --  cause back end problems.
11142
11143       elsif Nkind_In (Parent (Id), N_Object_Declaration,
11144                                    N_Function_Specification)
11145         and then Within_HSS_Or_If (Id)
11146       then
11147          return;
11148
11149       --  Entities in public packages or records are public
11150
11151       elsif Ekind (S) = E_Package or Is_Record_Type (S) then
11152          Set_Is_Public (Id);
11153
11154       --  The bounds of an entry family declaration can generate object
11155       --  declarations that are visible to the back-end, e.g. in the
11156       --  the declaration of a composite type that contains tasks.
11157
11158       elsif Is_Concurrent_Type (S)
11159         and then not Has_Completion (S)
11160         and then Nkind (Parent (Id)) = N_Object_Declaration
11161       then
11162          Set_Is_Public (Id);
11163       end if;
11164    end Set_Public_Status;
11165
11166    -----------------------------
11167    -- Set_Referenced_Modified --
11168    -----------------------------
11169
11170    procedure Set_Referenced_Modified (N : Node_Id; Out_Param : Boolean) is
11171       Pref : Node_Id;
11172
11173    begin
11174       --  Deal with indexed or selected component where prefix is modified
11175
11176       if Nkind_In (N, N_Indexed_Component, N_Selected_Component) then
11177          Pref := Prefix (N);
11178
11179          --  If prefix is access type, then it is the designated object that is
11180          --  being modified, which means we have no entity to set the flag on.
11181
11182          if No (Etype (Pref)) or else Is_Access_Type (Etype (Pref)) then
11183             return;
11184
11185             --  Otherwise chase the prefix
11186
11187          else
11188             Set_Referenced_Modified (Pref, Out_Param);
11189          end if;
11190
11191       --  Otherwise see if we have an entity name (only other case to process)
11192
11193       elsif Is_Entity_Name (N) and then Present (Entity (N)) then
11194          Set_Referenced_As_LHS           (Entity (N), not Out_Param);
11195          Set_Referenced_As_Out_Parameter (Entity (N), Out_Param);
11196       end if;
11197    end Set_Referenced_Modified;
11198
11199    ----------------------------
11200    -- Set_Scope_Is_Transient --
11201    ----------------------------
11202
11203    procedure Set_Scope_Is_Transient (V : Boolean := True) is
11204    begin
11205       Scope_Stack.Table (Scope_Stack.Last).Is_Transient := V;
11206    end Set_Scope_Is_Transient;
11207
11208    -------------------
11209    -- Set_Size_Info --
11210    -------------------
11211
11212    procedure Set_Size_Info (T1, T2 : Entity_Id) is
11213    begin
11214       --  We copy Esize, but not RM_Size, since in general RM_Size is
11215       --  subtype specific and does not get inherited by all subtypes.
11216
11217       Set_Esize                     (T1, Esize                     (T2));
11218       Set_Has_Biased_Representation (T1, Has_Biased_Representation (T2));
11219
11220       if Is_Discrete_Or_Fixed_Point_Type (T1)
11221            and then
11222          Is_Discrete_Or_Fixed_Point_Type (T2)
11223       then
11224          Set_Is_Unsigned_Type       (T1, Is_Unsigned_Type          (T2));
11225       end if;
11226
11227       Set_Alignment                 (T1, Alignment                 (T2));
11228    end Set_Size_Info;
11229
11230    --------------------
11231    -- Static_Boolean --
11232    --------------------
11233
11234    function Static_Boolean (N : Node_Id) return Uint is
11235    begin
11236       Analyze_And_Resolve (N, Standard_Boolean);
11237
11238       if N = Error
11239         or else Error_Posted (N)
11240         or else Etype (N) = Any_Type
11241       then
11242          return No_Uint;
11243       end if;
11244
11245       if Is_Static_Expression (N) then
11246          if not Raises_Constraint_Error (N) then
11247             return Expr_Value (N);
11248          else
11249             return No_Uint;
11250          end if;
11251
11252       elsif Etype (N) = Any_Type then
11253          return No_Uint;
11254
11255       else
11256          Flag_Non_Static_Expr
11257            ("static boolean expression required here", N);
11258          return No_Uint;
11259       end if;
11260    end Static_Boolean;
11261
11262    --------------------
11263    -- Static_Integer --
11264    --------------------
11265
11266    function Static_Integer (N : Node_Id) return Uint is
11267    begin
11268       Analyze_And_Resolve (N, Any_Integer);
11269
11270       if N = Error
11271         or else Error_Posted (N)
11272         or else Etype (N) = Any_Type
11273       then
11274          return No_Uint;
11275       end if;
11276
11277       if Is_Static_Expression (N) then
11278          if not Raises_Constraint_Error (N) then
11279             return Expr_Value (N);
11280          else
11281             return No_Uint;
11282          end if;
11283
11284       elsif Etype (N) = Any_Type then
11285          return No_Uint;
11286
11287       else
11288          Flag_Non_Static_Expr
11289            ("static integer expression required here", N);
11290          return No_Uint;
11291       end if;
11292    end Static_Integer;
11293
11294    --------------------------
11295    -- Statically_Different --
11296    --------------------------
11297
11298    function Statically_Different (E1, E2 : Node_Id) return Boolean is
11299       R1 : constant Node_Id := Get_Referenced_Object (E1);
11300       R2 : constant Node_Id := Get_Referenced_Object (E2);
11301    begin
11302       return     Is_Entity_Name (R1)
11303         and then Is_Entity_Name (R2)
11304         and then Entity (R1) /= Entity (R2)
11305         and then not Is_Formal (Entity (R1))
11306         and then not Is_Formal (Entity (R2));
11307    end Statically_Different;
11308
11309    -----------------------------
11310    -- Subprogram_Access_Level --
11311    -----------------------------
11312
11313    function Subprogram_Access_Level (Subp : Entity_Id) return Uint is
11314    begin
11315       if Present (Alias (Subp)) then
11316          return Subprogram_Access_Level (Alias (Subp));
11317       else
11318          return Scope_Depth (Enclosing_Dynamic_Scope (Subp));
11319       end if;
11320    end Subprogram_Access_Level;
11321
11322    -----------------
11323    -- Trace_Scope --
11324    -----------------
11325
11326    procedure Trace_Scope (N : Node_Id; E : Entity_Id; Msg : String) is
11327    begin
11328       if Debug_Flag_W then
11329          for J in 0 .. Scope_Stack.Last loop
11330             Write_Str ("  ");
11331          end loop;
11332
11333          Write_Str (Msg);
11334          Write_Name (Chars (E));
11335          Write_Str (" from ");
11336          Write_Location (Sloc (N));
11337          Write_Eol;
11338       end if;
11339    end Trace_Scope;
11340
11341    -----------------------
11342    -- Transfer_Entities --
11343    -----------------------
11344
11345    procedure Transfer_Entities (From : Entity_Id; To : Entity_Id) is
11346       Ent : Entity_Id := First_Entity (From);
11347
11348    begin
11349       if No (Ent) then
11350          return;
11351       end if;
11352
11353       if (Last_Entity (To)) = Empty then
11354          Set_First_Entity (To, Ent);
11355       else
11356          Set_Next_Entity (Last_Entity (To), Ent);
11357       end if;
11358
11359       Set_Last_Entity (To, Last_Entity (From));
11360
11361       while Present (Ent) loop
11362          Set_Scope (Ent, To);
11363
11364          if not Is_Public (Ent) then
11365             Set_Public_Status (Ent);
11366
11367             if Is_Public (Ent)
11368               and then Ekind (Ent) = E_Record_Subtype
11369
11370             then
11371                --  The components of the propagated Itype must be public
11372                --  as well.
11373
11374                declare
11375                   Comp : Entity_Id;
11376                begin
11377                   Comp := First_Entity (Ent);
11378                   while Present (Comp) loop
11379                      Set_Is_Public (Comp);
11380                      Next_Entity (Comp);
11381                   end loop;
11382                end;
11383             end if;
11384          end if;
11385
11386          Next_Entity (Ent);
11387       end loop;
11388
11389       Set_First_Entity (From, Empty);
11390       Set_Last_Entity (From, Empty);
11391    end Transfer_Entities;
11392
11393    -----------------------
11394    -- Type_Access_Level --
11395    -----------------------
11396
11397    function Type_Access_Level (Typ : Entity_Id) return Uint is
11398       Btyp : Entity_Id;
11399
11400    begin
11401       Btyp := Base_Type (Typ);
11402
11403       --  Ada 2005 (AI-230): For most cases of anonymous access types, we
11404       --  simply use the level where the type is declared. This is true for
11405       --  stand-alone object declarations, and for anonymous access types
11406       --  associated with components the level is the same as that of the
11407       --  enclosing composite type. However, special treatment is needed for
11408       --  the cases of access parameters, return objects of an anonymous access
11409       --  type, and, in Ada 95, access discriminants of limited types.
11410
11411       if Ekind (Btyp) in Access_Kind then
11412          if Ekind (Btyp) = E_Anonymous_Access_Type then
11413
11414             --  If the type is a nonlocal anonymous access type (such as for
11415             --  an access parameter) we treat it as being declared at the
11416             --  library level to ensure that names such as X.all'access don't
11417             --  fail static accessibility checks.
11418
11419             if not Is_Local_Anonymous_Access (Typ) then
11420                return Scope_Depth (Standard_Standard);
11421
11422             --  If this is a return object, the accessibility level is that of
11423             --  the result subtype of the enclosing function. The test here is
11424             --  little complicated, because we have to account for extended
11425             --  return statements that have been rewritten as blocks, in which
11426             --  case we have to find and the Is_Return_Object attribute of the
11427             --  itype's associated object. It would be nice to find a way to
11428             --  simplify this test, but it doesn't seem worthwhile to add a new
11429             --  flag just for purposes of this test. ???
11430
11431             elsif Ekind (Scope (Btyp)) = E_Return_Statement
11432               or else
11433                 (Is_Itype (Btyp)
11434                   and then Nkind (Associated_Node_For_Itype (Btyp)) =
11435                              N_Object_Declaration
11436                   and then Is_Return_Object
11437                              (Defining_Identifier
11438                                 (Associated_Node_For_Itype (Btyp))))
11439             then
11440                declare
11441                   Scop : Entity_Id;
11442
11443                begin
11444                   Scop := Scope (Scope (Btyp));
11445                   while Present (Scop) loop
11446                      exit when Ekind (Scop) = E_Function;
11447                      Scop := Scope (Scop);
11448                   end loop;
11449
11450                   --  Treat the return object's type as having the level of the
11451                   --  function's result subtype (as per RM05-6.5(5.3/2)).
11452
11453                   return Type_Access_Level (Etype (Scop));
11454                end;
11455             end if;
11456          end if;
11457
11458          Btyp := Root_Type (Btyp);
11459
11460          --  The accessibility level of anonymous access types associated with
11461          --  discriminants is that of the current instance of the type, and
11462          --  that's deeper than the type itself (AARM 3.10.2 (12.3.21)).
11463
11464          --  AI-402: access discriminants have accessibility based on the
11465          --  object rather than the type in Ada 2005, so the above paragraph
11466          --  doesn't apply.
11467
11468          --  ??? Needs completion with rules from AI-416
11469
11470          if Ada_Version <= Ada_95
11471            and then Ekind (Typ) = E_Anonymous_Access_Type
11472            and then Present (Associated_Node_For_Itype (Typ))
11473            and then Nkind (Associated_Node_For_Itype (Typ)) =
11474                                                  N_Discriminant_Specification
11475          then
11476             return Scope_Depth (Enclosing_Dynamic_Scope (Btyp)) + 1;
11477          end if;
11478       end if;
11479
11480       return Scope_Depth (Enclosing_Dynamic_Scope (Btyp));
11481    end Type_Access_Level;
11482
11483    --------------------------
11484    -- Unit_Declaration_Node --
11485    --------------------------
11486
11487    function Unit_Declaration_Node (Unit_Id : Entity_Id) return Node_Id is
11488       N : Node_Id := Parent (Unit_Id);
11489
11490    begin
11491       --  Predefined operators do not have a full function declaration
11492
11493       if Ekind (Unit_Id) = E_Operator then
11494          return N;
11495       end if;
11496
11497       --  Isn't there some better way to express the following ???
11498
11499       while Nkind (N) /= N_Abstract_Subprogram_Declaration
11500         and then Nkind (N) /= N_Formal_Package_Declaration
11501         and then Nkind (N) /= N_Function_Instantiation
11502         and then Nkind (N) /= N_Generic_Package_Declaration
11503         and then Nkind (N) /= N_Generic_Subprogram_Declaration
11504         and then Nkind (N) /= N_Package_Declaration
11505         and then Nkind (N) /= N_Package_Body
11506         and then Nkind (N) /= N_Package_Instantiation
11507         and then Nkind (N) /= N_Package_Renaming_Declaration
11508         and then Nkind (N) /= N_Procedure_Instantiation
11509         and then Nkind (N) /= N_Protected_Body
11510         and then Nkind (N) /= N_Subprogram_Declaration
11511         and then Nkind (N) /= N_Subprogram_Body
11512         and then Nkind (N) /= N_Subprogram_Body_Stub
11513         and then Nkind (N) /= N_Subprogram_Renaming_Declaration
11514         and then Nkind (N) /= N_Task_Body
11515         and then Nkind (N) /= N_Task_Type_Declaration
11516         and then Nkind (N) not in N_Formal_Subprogram_Declaration
11517         and then Nkind (N) not in N_Generic_Renaming_Declaration
11518       loop
11519          N := Parent (N);
11520          pragma Assert (Present (N));
11521       end loop;
11522
11523       return N;
11524    end Unit_Declaration_Node;
11525
11526    ------------------------------
11527    -- Universal_Interpretation --
11528    ------------------------------
11529
11530    function Universal_Interpretation (Opnd : Node_Id) return Entity_Id is
11531       Index : Interp_Index;
11532       It    : Interp;
11533
11534    begin
11535       --  The argument may be a formal parameter of an operator or subprogram
11536       --  with multiple interpretations, or else an expression for an actual.
11537
11538       if Nkind (Opnd) = N_Defining_Identifier
11539         or else not Is_Overloaded (Opnd)
11540       then
11541          if Etype (Opnd) = Universal_Integer
11542            or else Etype (Opnd) = Universal_Real
11543          then
11544             return Etype (Opnd);
11545          else
11546             return Empty;
11547          end if;
11548
11549       else
11550          Get_First_Interp (Opnd, Index, It);
11551          while Present (It.Typ) loop
11552             if It.Typ = Universal_Integer
11553               or else It.Typ = Universal_Real
11554             then
11555                return It.Typ;
11556             end if;
11557
11558             Get_Next_Interp (Index, It);
11559          end loop;
11560
11561          return Empty;
11562       end if;
11563    end Universal_Interpretation;
11564
11565    ---------------
11566    -- Unqualify --
11567    ---------------
11568
11569    function Unqualify (Expr : Node_Id) return Node_Id is
11570    begin
11571       --  Recurse to handle unlikely case of multiple levels of qualification
11572
11573       if Nkind (Expr) = N_Qualified_Expression then
11574          return Unqualify (Expression (Expr));
11575
11576       --  Normal case, not a qualified expression
11577
11578       else
11579          return Expr;
11580       end if;
11581    end Unqualify;
11582
11583    -----------------------
11584    -- Visible_Ancestors --
11585    -----------------------
11586
11587    function Visible_Ancestors (Typ : Entity_Id) return Elist_Id is
11588       List_1 : Elist_Id;
11589       List_2 : Elist_Id;
11590       Elmt   : Elmt_Id;
11591
11592    begin
11593       pragma Assert (Is_Record_Type (Typ)
11594         and then Is_Tagged_Type (Typ));
11595
11596       --  Collect all the parents and progenitors of Typ. If the full-view of
11597       --  private parents and progenitors is available then it is used to
11598       --  generate the list of visible ancestors; otherwise their partial
11599       --  view is added to the resulting list.
11600
11601       Collect_Parents
11602         (T               => Typ,
11603          List            => List_1,
11604          Use_Full_View   => True);
11605
11606       Collect_Interfaces
11607         (T               => Typ,
11608          Ifaces_List     => List_2,
11609          Exclude_Parents => True,
11610          Use_Full_View   => True);
11611
11612       --  Join the two lists. Avoid duplications because an interface may
11613       --  simultaneously be parent and progenitor of a type.
11614
11615       Elmt := First_Elmt (List_2);
11616       while Present (Elmt) loop
11617          Append_Unique_Elmt (Node (Elmt), List_1);
11618          Next_Elmt (Elmt);
11619       end loop;
11620
11621       return List_1;
11622    end Visible_Ancestors;
11623
11624    ----------------------
11625    -- Within_Init_Proc --
11626    ----------------------
11627
11628    function Within_Init_Proc return Boolean is
11629       S : Entity_Id;
11630
11631    begin
11632       S := Current_Scope;
11633       while not Is_Overloadable (S) loop
11634          if S = Standard_Standard then
11635             return False;
11636          else
11637             S := Scope (S);
11638          end if;
11639       end loop;
11640
11641       return Is_Init_Proc (S);
11642    end Within_Init_Proc;
11643
11644    ----------------
11645    -- Wrong_Type --
11646    ----------------
11647
11648    procedure Wrong_Type (Expr : Node_Id; Expected_Type : Entity_Id) is
11649       Found_Type : constant Entity_Id := First_Subtype (Etype (Expr));
11650       Expec_Type : constant Entity_Id := First_Subtype (Expected_Type);
11651
11652       function Has_One_Matching_Field return Boolean;
11653       --  Determines if Expec_Type is a record type with a single component or
11654       --  discriminant whose type matches the found type or is one dimensional
11655       --  array whose component type matches the found type.
11656
11657       ----------------------------
11658       -- Has_One_Matching_Field --
11659       ----------------------------
11660
11661       function Has_One_Matching_Field return Boolean is
11662          E : Entity_Id;
11663
11664       begin
11665          if Is_Array_Type (Expec_Type)
11666            and then Number_Dimensions (Expec_Type) = 1
11667            and then
11668              Covers (Etype (Component_Type (Expec_Type)), Found_Type)
11669          then
11670             return True;
11671
11672          elsif not Is_Record_Type (Expec_Type) then
11673             return False;
11674
11675          else
11676             E := First_Entity (Expec_Type);
11677             loop
11678                if No (E) then
11679                   return False;
11680
11681                elsif (Ekind (E) /= E_Discriminant
11682                        and then Ekind (E) /= E_Component)
11683                  or else (Chars (E) = Name_uTag
11684                            or else Chars (E) = Name_uParent)
11685                then
11686                   Next_Entity (E);
11687
11688                else
11689                   exit;
11690                end if;
11691             end loop;
11692
11693             if not Covers (Etype (E), Found_Type) then
11694                return False;
11695
11696             elsif Present (Next_Entity (E)) then
11697                return False;
11698
11699             else
11700                return True;
11701             end if;
11702          end if;
11703       end Has_One_Matching_Field;
11704
11705    --  Start of processing for Wrong_Type
11706
11707    begin
11708       --  Don't output message if either type is Any_Type, or if a message
11709       --  has already been posted for this node. We need to do the latter
11710       --  check explicitly (it is ordinarily done in Errout), because we
11711       --  are using ! to force the output of the error messages.
11712
11713       if Expec_Type = Any_Type
11714         or else Found_Type = Any_Type
11715         or else Error_Posted (Expr)
11716       then
11717          return;
11718
11719       --  In  an instance, there is an ongoing problem with completion of
11720       --  type derived from private types. Their structure is what Gigi
11721       --  expects, but the  Etype is the parent type rather than the
11722       --  derived private type itself. Do not flag error in this case. The
11723       --  private completion is an entity without a parent, like an Itype.
11724       --  Similarly, full and partial views may be incorrect in the instance.
11725       --  There is no simple way to insure that it is consistent ???
11726
11727       elsif In_Instance then
11728          if Etype (Etype (Expr)) = Etype (Expected_Type)
11729            and then
11730              (Has_Private_Declaration (Expected_Type)
11731                or else Has_Private_Declaration (Etype (Expr)))
11732            and then No (Parent (Expected_Type))
11733          then
11734             return;
11735          end if;
11736       end if;
11737
11738       --  An interesting special check. If the expression is parenthesized
11739       --  and its type corresponds to the type of the sole component of the
11740       --  expected record type, or to the component type of the expected one
11741       --  dimensional array type, then assume we have a bad aggregate attempt.
11742
11743       if Nkind (Expr) in N_Subexpr
11744         and then Paren_Count (Expr) /= 0
11745         and then Has_One_Matching_Field
11746       then
11747          Error_Msg_N ("positional aggregate cannot have one component", Expr);
11748
11749       --  Another special check, if we are looking for a pool-specific access
11750       --  type and we found an E_Access_Attribute_Type, then we have the case
11751       --  of an Access attribute being used in a context which needs a pool-
11752       --  specific type, which is never allowed. The one extra check we make
11753       --  is that the expected designated type covers the Found_Type.
11754
11755       elsif Is_Access_Type (Expec_Type)
11756         and then Ekind (Found_Type) = E_Access_Attribute_Type
11757         and then Ekind (Base_Type (Expec_Type)) /= E_General_Access_Type
11758         and then Ekind (Base_Type (Expec_Type)) /= E_Anonymous_Access_Type
11759         and then Covers
11760           (Designated_Type (Expec_Type), Designated_Type (Found_Type))
11761       then
11762          Error_Msg_N -- CODEFIX
11763            ("result must be general access type!", Expr);
11764          Error_Msg_NE -- CODEFIX
11765            ("add ALL to }!", Expr, Expec_Type);
11766
11767       --  Another special check, if the expected type is an integer type,
11768       --  but the expression is of type System.Address, and the parent is
11769       --  an addition or subtraction operation whose left operand is the
11770       --  expression in question and whose right operand is of an integral
11771       --  type, then this is an attempt at address arithmetic, so give
11772       --  appropriate message.
11773
11774       elsif Is_Integer_Type (Expec_Type)
11775         and then Is_RTE (Found_Type, RE_Address)
11776         and then (Nkind (Parent (Expr)) = N_Op_Add
11777                     or else
11778                   Nkind (Parent (Expr)) = N_Op_Subtract)
11779         and then Expr = Left_Opnd (Parent (Expr))
11780         and then Is_Integer_Type (Etype (Right_Opnd (Parent (Expr))))
11781       then
11782          Error_Msg_N
11783            ("address arithmetic not predefined in package System",
11784             Parent (Expr));
11785          Error_Msg_N
11786            ("\possible missing with/use of System.Storage_Elements",
11787             Parent (Expr));
11788          return;
11789
11790       --  If the expected type is an anonymous access type, as for access
11791       --  parameters and discriminants, the error is on the designated types.
11792
11793       elsif Ekind (Expec_Type) = E_Anonymous_Access_Type then
11794          if Comes_From_Source (Expec_Type) then
11795             Error_Msg_NE ("expected}!", Expr, Expec_Type);
11796          else
11797             Error_Msg_NE
11798               ("expected an access type with designated}",
11799                  Expr, Designated_Type (Expec_Type));
11800          end if;
11801
11802          if Is_Access_Type (Found_Type)
11803            and then not Comes_From_Source (Found_Type)
11804          then
11805             Error_Msg_NE
11806               ("\\found an access type with designated}!",
11807                 Expr, Designated_Type (Found_Type));
11808          else
11809             if From_With_Type (Found_Type) then
11810                Error_Msg_NE ("\\found incomplete}!", Expr, Found_Type);
11811                Error_Msg_Qual_Level := 99;
11812                Error_Msg_NE -- CODEFIX
11813                  ("\\missing `WITH &;", Expr, Scope (Found_Type));
11814                Error_Msg_Qual_Level := 0;
11815             else
11816                Error_Msg_NE ("found}!", Expr, Found_Type);
11817             end if;
11818          end if;
11819
11820       --  Normal case of one type found, some other type expected
11821
11822       else
11823          --  If the names of the two types are the same, see if some number
11824          --  of levels of qualification will help. Don't try more than three
11825          --  levels, and if we get to standard, it's no use (and probably
11826          --  represents an error in the compiler) Also do not bother with
11827          --  internal scope names.
11828
11829          declare
11830             Expec_Scope : Entity_Id;
11831             Found_Scope : Entity_Id;
11832
11833          begin
11834             Expec_Scope := Expec_Type;
11835             Found_Scope := Found_Type;
11836
11837             for Levels in Int range 0 .. 3 loop
11838                if Chars (Expec_Scope) /= Chars (Found_Scope) then
11839                   Error_Msg_Qual_Level := Levels;
11840                   exit;
11841                end if;
11842
11843                Expec_Scope := Scope (Expec_Scope);
11844                Found_Scope := Scope (Found_Scope);
11845
11846                exit when Expec_Scope = Standard_Standard
11847                  or else Found_Scope = Standard_Standard
11848                  or else not Comes_From_Source (Expec_Scope)
11849                  or else not Comes_From_Source (Found_Scope);
11850             end loop;
11851          end;
11852
11853          if Is_Record_Type (Expec_Type)
11854            and then Present (Corresponding_Remote_Type (Expec_Type))
11855          then
11856             Error_Msg_NE ("expected}!", Expr,
11857                           Corresponding_Remote_Type (Expec_Type));
11858          else
11859             Error_Msg_NE ("expected}!", Expr, Expec_Type);
11860          end if;
11861
11862          if Is_Entity_Name (Expr)
11863            and then Is_Package_Or_Generic_Package (Entity (Expr))
11864          then
11865             Error_Msg_N ("\\found package name!", Expr);
11866
11867          elsif Is_Entity_Name (Expr)
11868            and then
11869              (Ekind (Entity (Expr)) = E_Procedure
11870                 or else
11871               Ekind (Entity (Expr)) = E_Generic_Procedure)
11872          then
11873             if Ekind (Expec_Type) = E_Access_Subprogram_Type then
11874                Error_Msg_N
11875                  ("found procedure name, possibly missing Access attribute!",
11876                    Expr);
11877             else
11878                Error_Msg_N
11879                  ("\\found procedure name instead of function!", Expr);
11880             end if;
11881
11882          elsif Nkind (Expr) = N_Function_Call
11883            and then Ekind (Expec_Type) = E_Access_Subprogram_Type
11884            and then Etype (Designated_Type (Expec_Type)) = Etype (Expr)
11885            and then No (Parameter_Associations (Expr))
11886          then
11887             Error_Msg_N
11888               ("found function name, possibly missing Access attribute!",
11889                Expr);
11890
11891          --  Catch common error: a prefix or infix operator which is not
11892          --  directly visible because the type isn't.
11893
11894          elsif Nkind (Expr) in N_Op
11895             and then Is_Overloaded (Expr)
11896             and then not Is_Immediately_Visible (Expec_Type)
11897             and then not Is_Potentially_Use_Visible (Expec_Type)
11898             and then not In_Use (Expec_Type)
11899             and then Has_Compatible_Type (Right_Opnd (Expr), Expec_Type)
11900          then
11901             Error_Msg_N
11902               ("operator of the type is not directly visible!", Expr);
11903
11904          elsif Ekind (Found_Type) = E_Void
11905            and then Present (Parent (Found_Type))
11906            and then Nkind (Parent (Found_Type)) = N_Full_Type_Declaration
11907          then
11908             Error_Msg_NE ("\\found premature usage of}!", Expr, Found_Type);
11909
11910          else
11911             Error_Msg_NE ("\\found}!", Expr, Found_Type);
11912          end if;
11913
11914          --  A special check for cases like M1 and M2 = 0 where M1 and M2 are
11915          --  of the same modular type, and (M1 and M2) = 0 was intended.
11916
11917          if Expec_Type = Standard_Boolean
11918            and then Is_Modular_Integer_Type (Found_Type)
11919            and then Nkind_In (Parent (Expr), N_Op_And, N_Op_Or, N_Op_Xor)
11920            and then Nkind (Right_Opnd (Parent (Expr))) in N_Op_Compare
11921          then
11922             declare
11923                Op : constant Node_Id := Right_Opnd (Parent (Expr));
11924                L  : constant Node_Id := Left_Opnd (Op);
11925                R  : constant Node_Id := Right_Opnd (Op);
11926             begin
11927                --  The case for the message is when the left operand of the
11928                --  comparison is the same modular type, or when it is an
11929                --  integer literal (or other universal integer expression),
11930                --  which would have been typed as the modular type if the
11931                --  parens had been there.
11932
11933                if (Etype (L) = Found_Type
11934                      or else
11935                    Etype (L) = Universal_Integer)
11936                  and then Is_Integer_Type (Etype (R))
11937                then
11938                   Error_Msg_N
11939                     ("\\possible missing parens for modular operation", Expr);
11940                end if;
11941             end;
11942          end if;
11943
11944          --  Reset error message qualification indication
11945
11946          Error_Msg_Qual_Level := 0;
11947       end if;
11948    end Wrong_Type;
11949
11950 end Sem_Util;