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