OSDN Git Service

2011-12-20 Ed Schonberg <schonberg@adacore.com>
[pf3gnuchains/gcc-fork.git] / gcc / ada / sem_ch13.adb
1 ------------------------------------------------------------------------------
2 --                                                                          --
3 --                         GNAT COMPILER COMPONENTS                         --
4 --                                                                          --
5 --                             S E M _ C H 1 3                              --
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 Aspects;  use Aspects;
27 with Atree;    use Atree;
28 with Checks;   use Checks;
29 with Einfo;    use Einfo;
30 with Elists;   use Elists;
31 with Errout;   use Errout;
32 with Exp_Disp; use Exp_Disp;
33 with Exp_Tss;  use Exp_Tss;
34 with Exp_Util; use Exp_Util;
35 with Lib;      use Lib;
36 with Lib.Xref; use Lib.Xref;
37 with Namet;    use Namet;
38 with Nlists;   use Nlists;
39 with Nmake;    use Nmake;
40 with Opt;      use Opt;
41 with Restrict; use Restrict;
42 with Rident;   use Rident;
43 with Rtsfind;  use Rtsfind;
44 with Sem;      use Sem;
45 with Sem_Aux;  use Sem_Aux;
46 with Sem_Ch3;  use Sem_Ch3;
47 with Sem_Ch6;  use Sem_Ch6;
48 with Sem_Ch8;  use Sem_Ch8;
49 with Sem_Dim;  use Sem_Dim;
50 with Sem_Eval; use Sem_Eval;
51 with Sem_Res;  use Sem_Res;
52 with Sem_Type; use Sem_Type;
53 with Sem_Util; use Sem_Util;
54 with Sem_Warn; use Sem_Warn;
55 with Sinput;   use Sinput;
56 with Snames;   use Snames;
57 with Stand;    use Stand;
58 with Sinfo;    use Sinfo;
59 with Stringt;  use Stringt;
60 with Targparm; use Targparm;
61 with Ttypes;   use Ttypes;
62 with Tbuild;   use Tbuild;
63 with Urealp;   use Urealp;
64 with Warnsw;   use Warnsw;
65
66 with GNAT.Heap_Sort_G;
67
68 package body Sem_Ch13 is
69
70    SSU : constant Pos := System_Storage_Unit;
71    --  Convenient short hand for commonly used constant
72
73    -----------------------
74    -- Local Subprograms --
75    -----------------------
76
77    procedure Alignment_Check_For_Size_Change (Typ : Entity_Id; Size : Uint);
78    --  This routine is called after setting one of the sizes of type entity
79    --  Typ to Size. The purpose is to deal with the situation of a derived
80    --  type whose inherited alignment is no longer appropriate for the new
81    --  size value. In this case, we reset the Alignment to unknown.
82
83    procedure Build_Predicate_Function (Typ : Entity_Id; N : Node_Id);
84    --  If Typ has predicates (indicated by Has_Predicates being set for Typ,
85    --  then either there are pragma Invariant entries on the rep chain for the
86    --  type (note that Predicate aspects are converted to pragma Predicate), or
87    --  there are inherited aspects from a parent type, or ancestor subtypes.
88    --  This procedure builds the spec and body for the Predicate function that
89    --  tests these predicates. N is the freeze node for the type. The spec of
90    --  the function is inserted before the freeze node, and the body of the
91    --  function is inserted after the freeze node.
92
93    procedure Build_Static_Predicate
94      (Typ  : Entity_Id;
95       Expr : Node_Id;
96       Nam  : Name_Id);
97    --  Given a predicated type Typ, where Typ is a discrete static subtype,
98    --  whose predicate expression is Expr, tests if Expr is a static predicate,
99    --  and if so, builds the predicate range list. Nam is the name of the one
100    --  argument to the predicate function. Occurrences of the type name in the
101    --  predicate expression have been replaced by identifier references to this
102    --  name, which is unique, so any identifier with Chars matching Nam must be
103    --  a reference to the type. If the predicate is non-static, this procedure
104    --  returns doing nothing. If the predicate is static, then the predicate
105    --  list is stored in Static_Predicate (Typ), and the Expr is rewritten as
106    --  a canonicalized membership operation.
107
108    function Get_Alignment_Value (Expr : Node_Id) return Uint;
109    --  Given the expression for an alignment value, returns the corresponding
110    --  Uint value. If the value is inappropriate, then error messages are
111    --  posted as required, and a value of No_Uint is returned.
112
113    function Is_Operational_Item (N : Node_Id) return Boolean;
114    --  A specification for a stream attribute is allowed before the full type
115    --  is declared, as explained in AI-00137 and the corrigendum. Attributes
116    --  that do not specify a representation characteristic are operational
117    --  attributes.
118
119    procedure New_Stream_Subprogram
120      (N    : Node_Id;
121       Ent  : Entity_Id;
122       Subp : Entity_Id;
123       Nam  : TSS_Name_Type);
124    --  Create a subprogram renaming of a given stream attribute to the
125    --  designated subprogram and then in the tagged case, provide this as a
126    --  primitive operation, or in the non-tagged case make an appropriate TSS
127    --  entry. This is more properly an expansion activity than just semantics,
128    --  but the presence of user-defined stream functions for limited types is a
129    --  legality check, which is why this takes place here rather than in
130    --  exp_ch13, where it was previously. Nam indicates the name of the TSS
131    --  function to be generated.
132    --
133    --  To avoid elaboration anomalies with freeze nodes, for untagged types
134    --  we generate both a subprogram declaration and a subprogram renaming
135    --  declaration, so that the attribute specification is handled as a
136    --  renaming_as_body. For tagged types, the specification is one of the
137    --  primitive specs.
138
139    generic
140       with procedure Replace_Type_Reference (N : Node_Id);
141    procedure Replace_Type_References_Generic (N : Node_Id; TName : Name_Id);
142    --  This is used to scan an expression for a predicate or invariant aspect
143    --  replacing occurrences of the name TName (the name of the subtype to
144    --  which the aspect applies) with appropriate references to the parameter
145    --  of the predicate function or invariant procedure. The procedure passed
146    --  as a generic parameter does the actual replacement of node N, which is
147    --  either a simple direct reference to TName, or a selected component that
148    --  represents an appropriately qualified occurrence of TName.
149
150    procedure Set_Biased
151      (E      : Entity_Id;
152       N      : Node_Id;
153       Msg    : String;
154       Biased : Boolean := True);
155    --  If Biased is True, sets Has_Biased_Representation flag for E, and
156    --  outputs a warning message at node N if Warn_On_Biased_Representation is
157    --  is True. This warning inserts the string Msg to describe the construct
158    --  causing biasing.
159
160    ----------------------------------------------
161    -- Table for Validate_Unchecked_Conversions --
162    ----------------------------------------------
163
164    --  The following table collects unchecked conversions for validation.
165    --  Entries are made by Validate_Unchecked_Conversion and then the call
166    --  to Validate_Unchecked_Conversions does the actual error checking and
167    --  posting of warnings. The reason for this delayed processing is to take
168    --  advantage of back-annotations of size and alignment values performed by
169    --  the back end.
170
171    --  Note: the reason we store a Source_Ptr value instead of a Node_Id is
172    --  that by the time Validate_Unchecked_Conversions is called, Sprint will
173    --  already have modified all Sloc values if the -gnatD option is set.
174
175    type UC_Entry is record
176       Eloc   : Source_Ptr; -- node used for posting warnings
177       Source : Entity_Id;  -- source type for unchecked conversion
178       Target : Entity_Id;  -- target type for unchecked conversion
179    end record;
180
181    package Unchecked_Conversions is new Table.Table (
182      Table_Component_Type => UC_Entry,
183      Table_Index_Type     => Int,
184      Table_Low_Bound      => 1,
185      Table_Initial        => 50,
186      Table_Increment      => 200,
187      Table_Name           => "Unchecked_Conversions");
188
189    ----------------------------------------
190    -- Table for Validate_Address_Clauses --
191    ----------------------------------------
192
193    --  If an address clause has the form
194
195    --    for X'Address use Expr
196
197    --  where Expr is of the form Y'Address or recursively is a reference to a
198    --  constant of either of these forms, and X and Y are entities of objects,
199    --  then if Y has a smaller alignment than X, that merits a warning about
200    --  possible bad alignment. The following table collects address clauses of
201    --  this kind. We put these in a table so that they can be checked after the
202    --  back end has completed annotation of the alignments of objects, since we
203    --  can catch more cases that way.
204
205    type Address_Clause_Check_Record is record
206       N : Node_Id;
207       --  The address clause
208
209       X : Entity_Id;
210       --  The entity of the object overlaying Y
211
212       Y : Entity_Id;
213       --  The entity of the object being overlaid
214
215       Off : Boolean;
216       --  Whether the address is offset within Y
217    end record;
218
219    package Address_Clause_Checks is new Table.Table (
220      Table_Component_Type => Address_Clause_Check_Record,
221      Table_Index_Type     => Int,
222      Table_Low_Bound      => 1,
223      Table_Initial        => 20,
224      Table_Increment      => 200,
225      Table_Name           => "Address_Clause_Checks");
226
227    -----------------------------------------
228    -- Adjust_Record_For_Reverse_Bit_Order --
229    -----------------------------------------
230
231    procedure Adjust_Record_For_Reverse_Bit_Order (R : Entity_Id) is
232       Comp : Node_Id;
233       CC   : Node_Id;
234
235    begin
236       --  Processing depends on version of Ada
237
238       --  For Ada 95, we just renumber bits within a storage unit. We do the
239       --  same for Ada 83 mode, since we recognize the Bit_Order attribute in
240       --  Ada 83, and are free to add this extension.
241
242       if Ada_Version < Ada_2005 then
243          Comp := First_Component_Or_Discriminant (R);
244          while Present (Comp) loop
245             CC := Component_Clause (Comp);
246
247             --  If component clause is present, then deal with the non-default
248             --  bit order case for Ada 95 mode.
249
250             --  We only do this processing for the base type, and in fact that
251             --  is important, since otherwise if there are record subtypes, we
252             --  could reverse the bits once for each subtype, which is wrong.
253
254             if Present (CC)
255               and then Ekind (R) = E_Record_Type
256             then
257                declare
258                   CFB : constant Uint    := Component_Bit_Offset (Comp);
259                   CSZ : constant Uint    := Esize (Comp);
260                   CLC : constant Node_Id := Component_Clause (Comp);
261                   Pos : constant Node_Id := Position (CLC);
262                   FB  : constant Node_Id := First_Bit (CLC);
263
264                   Storage_Unit_Offset : constant Uint :=
265                                           CFB / System_Storage_Unit;
266
267                   Start_Bit : constant Uint :=
268                                 CFB mod System_Storage_Unit;
269
270                begin
271                   --  Cases where field goes over storage unit boundary
272
273                   if Start_Bit + CSZ > System_Storage_Unit then
274
275                      --  Allow multi-byte field but generate warning
276
277                      if Start_Bit mod System_Storage_Unit = 0
278                        and then CSZ mod System_Storage_Unit = 0
279                      then
280                         Error_Msg_N
281                           ("multi-byte field specified with non-standard"
282                            & " Bit_Order?", CLC);
283
284                         if Bytes_Big_Endian then
285                            Error_Msg_N
286                              ("bytes are not reversed "
287                               & "(component is big-endian)?", CLC);
288                         else
289                            Error_Msg_N
290                              ("bytes are not reversed "
291                               & "(component is little-endian)?", CLC);
292                         end if;
293
294                         --  Do not allow non-contiguous field
295
296                      else
297                         Error_Msg_N
298                           ("attempt to specify non-contiguous field "
299                            & "not permitted", CLC);
300                         Error_Msg_N
301                           ("\caused by non-standard Bit_Order "
302                            & "specified", CLC);
303                         Error_Msg_N
304                           ("\consider possibility of using "
305                            & "Ada 2005 mode here", CLC);
306                      end if;
307
308                   --  Case where field fits in one storage unit
309
310                   else
311                      --  Give warning if suspicious component clause
312
313                      if Intval (FB) >= System_Storage_Unit
314                        and then Warn_On_Reverse_Bit_Order
315                      then
316                         Error_Msg_N
317                           ("?Bit_Order clause does not affect " &
318                            "byte ordering", Pos);
319                         Error_Msg_Uint_1 :=
320                           Intval (Pos) + Intval (FB) /
321                           System_Storage_Unit;
322                         Error_Msg_N
323                           ("?position normalized to ^ before bit " &
324                            "order interpreted", Pos);
325                      end if;
326
327                      --  Here is where we fix up the Component_Bit_Offset value
328                      --  to account for the reverse bit order. Some examples of
329                      --  what needs to be done are:
330
331                      --    First_Bit .. Last_Bit     Component_Bit_Offset
332                      --      old          new          old       new
333
334                      --     0 .. 0       7 .. 7         0         7
335                      --     0 .. 1       6 .. 7         0         6
336                      --     0 .. 2       5 .. 7         0         5
337                      --     0 .. 7       0 .. 7         0         4
338
339                      --     1 .. 1       6 .. 6         1         6
340                      --     1 .. 4       3 .. 6         1         3
341                      --     4 .. 7       0 .. 3         4         0
342
343                      --  The rule is that the first bit is is obtained by
344                      --  subtracting the old ending bit from storage_unit - 1.
345
346                      Set_Component_Bit_Offset
347                        (Comp,
348                         (Storage_Unit_Offset * System_Storage_Unit) +
349                           (System_Storage_Unit - 1) -
350                           (Start_Bit + CSZ - 1));
351
352                      Set_Normalized_First_Bit
353                        (Comp,
354                         Component_Bit_Offset (Comp) mod
355                           System_Storage_Unit);
356                   end if;
357                end;
358             end if;
359
360             Next_Component_Or_Discriminant (Comp);
361          end loop;
362
363       --  For Ada 2005, we do machine scalar processing, as fully described In
364       --  AI-133. This involves gathering all components which start at the
365       --  same byte offset and processing them together. Same approach is still
366       --  valid in later versions including Ada 2012.
367
368       else
369          declare
370             Max_Machine_Scalar_Size : constant Uint :=
371                                         UI_From_Int
372                                           (Standard_Long_Long_Integer_Size);
373             --  We use this as the maximum machine scalar size
374
375             Num_CC : Natural;
376             SSU    : constant Uint := UI_From_Int (System_Storage_Unit);
377
378          begin
379             --  This first loop through components does two things. First it
380             --  deals with the case of components with component clauses whose
381             --  length is greater than the maximum machine scalar size (either
382             --  accepting them or rejecting as needed). Second, it counts the
383             --  number of components with component clauses whose length does
384             --  not exceed this maximum for later processing.
385
386             Num_CC := 0;
387             Comp   := First_Component_Or_Discriminant (R);
388             while Present (Comp) loop
389                CC := Component_Clause (Comp);
390
391                if Present (CC) then
392                   declare
393                      Fbit : constant Uint :=
394                               Static_Integer (First_Bit (CC));
395                      Lbit : constant Uint :=
396                               Static_Integer (Last_Bit (CC));
397
398                   begin
399                      --  Case of component with last bit >= max machine scalar
400
401                      if Lbit >= Max_Machine_Scalar_Size then
402
403                         --  This is allowed only if first bit is zero, and
404                         --  last bit + 1 is a multiple of storage unit size.
405
406                         if Fbit = 0 and then (Lbit + 1) mod SSU = 0 then
407
408                            --  This is the case to give a warning if enabled
409
410                            if Warn_On_Reverse_Bit_Order then
411                               Error_Msg_N
412                                 ("multi-byte field specified with "
413                                  & "  non-standard Bit_Order?", CC);
414
415                               if Bytes_Big_Endian then
416                                  Error_Msg_N
417                                    ("\bytes are not reversed "
418                                     & "(component is big-endian)?", CC);
419                               else
420                                  Error_Msg_N
421                                    ("\bytes are not reversed "
422                                     & "(component is little-endian)?", CC);
423                               end if;
424                            end if;
425
426                         --  Give error message for RM 13.4.1(10) violation
427
428                         else
429                            Error_Msg_FE
430                              ("machine scalar rules not followed for&",
431                               First_Bit (CC), Comp);
432
433                            Error_Msg_Uint_1 := Lbit;
434                            Error_Msg_Uint_2 := Max_Machine_Scalar_Size;
435                            Error_Msg_F
436                              ("\last bit (^) exceeds maximum machine "
437                               & "scalar size (^)",
438                               First_Bit (CC));
439
440                            if (Lbit + 1) mod SSU /= 0 then
441                               Error_Msg_Uint_1 := SSU;
442                               Error_Msg_F
443                                 ("\and is not a multiple of Storage_Unit (^) "
444                                  & "(RM 13.4.1(10))",
445                                  First_Bit (CC));
446
447                            else
448                               Error_Msg_Uint_1 := Fbit;
449                               Error_Msg_F
450                                 ("\and first bit (^) is non-zero "
451                                  & "(RM 13.4.1(10))",
452                                  First_Bit (CC));
453                            end if;
454                         end if;
455
456                      --  OK case of machine scalar related component clause,
457                      --  For now, just count them.
458
459                      else
460                         Num_CC := Num_CC + 1;
461                      end if;
462                   end;
463                end if;
464
465                Next_Component_Or_Discriminant (Comp);
466             end loop;
467
468             --  We need to sort the component clauses on the basis of the
469             --  Position values in the clause, so we can group clauses with
470             --  the same Position. together to determine the relevant machine
471             --  scalar size.
472
473             Sort_CC : declare
474                Comps : array (0 .. Num_CC) of Entity_Id;
475                --  Array to collect component and discriminant entities. The
476                --  data starts at index 1, the 0'th entry is for the sort
477                --  routine.
478
479                function CP_Lt (Op1, Op2 : Natural) return Boolean;
480                --  Compare routine for Sort
481
482                procedure CP_Move (From : Natural; To : Natural);
483                --  Move routine for Sort
484
485                package Sorting is new GNAT.Heap_Sort_G (CP_Move, CP_Lt);
486
487                Start : Natural;
488                Stop  : Natural;
489                --  Start and stop positions in the component list of the set of
490                --  components with the same starting position (that constitute
491                --  components in a single machine scalar).
492
493                MaxL  : Uint;
494                --  Maximum last bit value of any component in this set
495
496                MSS   : Uint;
497                --  Corresponding machine scalar size
498
499                -----------
500                -- CP_Lt --
501                -----------
502
503                function CP_Lt (Op1, Op2 : Natural) return Boolean is
504                begin
505                   return Position (Component_Clause (Comps (Op1))) <
506                     Position (Component_Clause (Comps (Op2)));
507                end CP_Lt;
508
509                -------------
510                -- CP_Move --
511                -------------
512
513                procedure CP_Move (From : Natural; To : Natural) is
514                begin
515                   Comps (To) := Comps (From);
516                end CP_Move;
517
518                --  Start of processing for Sort_CC
519
520             begin
521                --  Collect the machine scalar relevant component clauses
522
523                Num_CC := 0;
524                Comp   := First_Component_Or_Discriminant (R);
525                while Present (Comp) loop
526                   declare
527                      CC   : constant Node_Id := Component_Clause (Comp);
528
529                   begin
530                      --  Collect only component clauses whose last bit is less
531                      --  than machine scalar size. Any component clause whose
532                      --  last bit exceeds this value does not take part in
533                      --  machine scalar layout considerations. The test for
534                      --  Error_Posted makes sure we exclude component clauses
535                      --  for which we already posted an error.
536
537                      if Present (CC)
538                        and then not Error_Posted (Last_Bit (CC))
539                        and then Static_Integer (Last_Bit (CC)) <
540                                                     Max_Machine_Scalar_Size
541                      then
542                         Num_CC := Num_CC + 1;
543                         Comps (Num_CC) := Comp;
544                      end if;
545                   end;
546
547                   Next_Component_Or_Discriminant (Comp);
548                end loop;
549
550                --  Sort by ascending position number
551
552                Sorting.Sort (Num_CC);
553
554                --  We now have all the components whose size does not exceed
555                --  the max machine scalar value, sorted by starting position.
556                --  In this loop we gather groups of clauses starting at the
557                --  same position, to process them in accordance with AI-133.
558
559                Stop := 0;
560                while Stop < Num_CC loop
561                   Start := Stop + 1;
562                   Stop  := Start;
563                   MaxL  :=
564                     Static_Integer
565                       (Last_Bit (Component_Clause (Comps (Start))));
566                   while Stop < Num_CC loop
567                      if Static_Integer
568                           (Position (Component_Clause (Comps (Stop + 1)))) =
569                         Static_Integer
570                           (Position (Component_Clause (Comps (Stop))))
571                      then
572                         Stop := Stop + 1;
573                         MaxL :=
574                           UI_Max
575                             (MaxL,
576                              Static_Integer
577                                (Last_Bit
578                                   (Component_Clause (Comps (Stop)))));
579                      else
580                         exit;
581                      end if;
582                   end loop;
583
584                   --  Now we have a group of component clauses from Start to
585                   --  Stop whose positions are identical, and MaxL is the
586                   --  maximum last bit value of any of these components.
587
588                   --  We need to determine the corresponding machine scalar
589                   --  size. This loop assumes that machine scalar sizes are
590                   --  even, and that each possible machine scalar has twice
591                   --  as many bits as the next smaller one.
592
593                   MSS := Max_Machine_Scalar_Size;
594                   while MSS mod 2 = 0
595                     and then (MSS / 2) >= SSU
596                     and then (MSS / 2) > MaxL
597                   loop
598                      MSS := MSS / 2;
599                   end loop;
600
601                   --  Here is where we fix up the Component_Bit_Offset value
602                   --  to account for the reverse bit order. Some examples of
603                   --  what needs to be done for the case of a machine scalar
604                   --  size of 8 are:
605
606                   --    First_Bit .. Last_Bit     Component_Bit_Offset
607                   --      old          new          old       new
608
609                   --     0 .. 0       7 .. 7         0         7
610                   --     0 .. 1       6 .. 7         0         6
611                   --     0 .. 2       5 .. 7         0         5
612                   --     0 .. 7       0 .. 7         0         4
613
614                   --     1 .. 1       6 .. 6         1         6
615                   --     1 .. 4       3 .. 6         1         3
616                   --     4 .. 7       0 .. 3         4         0
617
618                   --  The rule is that the first bit is obtained by subtracting
619                   --  the old ending bit from machine scalar size - 1.
620
621                   for C in Start .. Stop loop
622                      declare
623                         Comp : constant Entity_Id := Comps (C);
624                         CC   : constant Node_Id   :=
625                                  Component_Clause (Comp);
626                         LB   : constant Uint :=
627                                  Static_Integer (Last_Bit (CC));
628                         NFB  : constant Uint := MSS - Uint_1 - LB;
629                         NLB  : constant Uint := NFB + Esize (Comp) - 1;
630                         Pos  : constant Uint :=
631                                  Static_Integer (Position (CC));
632
633                      begin
634                         if Warn_On_Reverse_Bit_Order then
635                            Error_Msg_Uint_1 := MSS;
636                            Error_Msg_N
637                              ("info: reverse bit order in machine " &
638                               "scalar of length^?", First_Bit (CC));
639                            Error_Msg_Uint_1 := NFB;
640                            Error_Msg_Uint_2 := NLB;
641
642                            if Bytes_Big_Endian then
643                               Error_Msg_NE
644                                 ("?\info: big-endian range for "
645                                  & "component & is ^ .. ^",
646                                  First_Bit (CC), Comp);
647                            else
648                               Error_Msg_NE
649                                 ("?\info: little-endian range "
650                                  & "for component & is ^ .. ^",
651                                  First_Bit (CC), Comp);
652                            end if;
653                         end if;
654
655                         Set_Component_Bit_Offset (Comp, Pos * SSU + NFB);
656                         Set_Normalized_First_Bit (Comp, NFB mod SSU);
657                      end;
658                   end loop;
659                end loop;
660             end Sort_CC;
661          end;
662       end if;
663    end Adjust_Record_For_Reverse_Bit_Order;
664
665    -------------------------------------
666    -- Alignment_Check_For_Size_Change --
667    -------------------------------------
668
669    procedure Alignment_Check_For_Size_Change (Typ : Entity_Id; Size : Uint) is
670    begin
671       --  If the alignment is known, and not set by a rep clause, and is
672       --  inconsistent with the size being set, then reset it to unknown,
673       --  we assume in this case that the size overrides the inherited
674       --  alignment, and that the alignment must be recomputed.
675
676       if Known_Alignment (Typ)
677         and then not Has_Alignment_Clause (Typ)
678         and then Size mod (Alignment (Typ) * SSU) /= 0
679       then
680          Init_Alignment (Typ);
681       end if;
682    end Alignment_Check_For_Size_Change;
683
684    -----------------------------------
685    -- Analyze_Aspect_Specifications --
686    -----------------------------------
687
688    procedure Analyze_Aspect_Specifications (N : Node_Id; E : Entity_Id) is
689       Aspect : Node_Id;
690       Aitem  : Node_Id;
691       Ent    : Node_Id;
692
693       L : constant List_Id := Aspect_Specifications (N);
694
695       Ins_Node : Node_Id := N;
696       --  Insert pragmas (except Pre/Post/Invariant/Predicate) after this node
697
698       --  The general processing involves building an attribute definition
699       --  clause or a pragma node that corresponds to the aspect. Then one
700       --  of two things happens:
701
702       --  If we are required to delay the evaluation of this aspect to the
703       --  freeze point, we attach the corresponding pragma/attribute definition
704       --  clause to the aspect specification node, which is then placed in the
705       --  Rep Item chain. In this case we mark the entity by setting the flag
706       --  Has_Delayed_Aspects and we evaluate the rep item at the freeze point.
707
708       --  If no delay is required, we just insert the pragma or attribute
709       --  after the declaration, and it will get processed by the normal
710       --  circuit. The From_Aspect_Specification flag is set on the pragma
711       --  or attribute definition node in either case to activate special
712       --  processing (e.g. not traversing the list of homonyms for inline).
713
714       Delay_Required : Boolean := False;
715       --  Set True if delay is required
716
717    begin
718       pragma Assert (Present (L));
719
720       --  Loop through aspects
721
722       Aspect := First (L);
723       Aspect_Loop : while Present (Aspect) loop
724          declare
725             Loc  : constant Source_Ptr := Sloc (Aspect);
726             Id   : constant Node_Id    := Identifier (Aspect);
727             Expr : constant Node_Id    := Expression (Aspect);
728             Nam  : constant Name_Id    := Chars (Id);
729             A_Id : constant Aspect_Id  := Get_Aspect_Id (Nam);
730             Anod : Node_Id;
731
732             Eloc : Source_Ptr := No_Location;
733             --  Source location of expression, modified when we split PPC's. It
734             --  is set below when Expr is present.
735
736             procedure Check_False_Aspect_For_Derived_Type;
737             --  This procedure checks for the case of a false aspect for a
738             --  derived type, which improperly tries to cancel an aspect
739             --  inherited from the parent;
740
741             -----------------------------------------
742             -- Check_False_Aspect_For_Derived_Type --
743             -----------------------------------------
744
745             procedure Check_False_Aspect_For_Derived_Type is
746             begin
747                --  We are only checking derived types
748
749                if not Is_Derived_Type (E) then
750                   return;
751                end if;
752
753                case A_Id is
754                   when Aspect_Atomic | Aspect_Shared =>
755                      if not Is_Atomic (E) then
756                         return;
757                      end if;
758
759                   when Aspect_Atomic_Components =>
760                      if not Has_Atomic_Components (E) then
761                         return;
762                      end if;
763
764                   when Aspect_Discard_Names =>
765                      if not Discard_Names (E) then
766                         return;
767                      end if;
768
769                   when Aspect_Pack =>
770                      if not Is_Packed (E) then
771                         return;
772                      end if;
773
774                   when Aspect_Unchecked_Union =>
775                      if not Is_Unchecked_Union (E) then
776                         return;
777                      end if;
778
779                   when Aspect_Volatile =>
780                      if not Is_Volatile (E) then
781                         return;
782                      end if;
783
784                   when Aspect_Volatile_Components =>
785                      if not Has_Volatile_Components (E) then
786                         return;
787                      end if;
788
789                   when others =>
790                      return;
791                end case;
792
793                --  Fall through means we are canceling an inherited aspect
794
795                Error_Msg_Name_1 := Nam;
796                Error_Msg_NE
797                  ("derived type& inherits aspect%, cannot cancel", Expr, E);
798             end Check_False_Aspect_For_Derived_Type;
799
800          --  Start of processing for Aspect_Loop
801
802          begin
803             --  Skip aspect if already analyzed (not clear if this is needed)
804
805             if Analyzed (Aspect) then
806                goto Continue;
807             end if;
808
809             --  Set the source location of expression, used in the case of
810             --  a failed precondition/postcondition or invariant. Note that
811             --  the source location of the expression is not usually the best
812             --  choice here. For example, it gets located on the last AND
813             --  keyword in a chain of boolean expressiond AND'ed together.
814             --  It is best to put the message on the first character of the
815             --  assertion, which is the effect of the First_Node call here.
816
817             if Present (Expr) then
818                Eloc := Sloc (First_Node (Expr));
819             end if;
820
821             --  Check restriction No_Implementation_Aspect_Specifications
822
823             if Impl_Defined_Aspects (A_Id) then
824                Check_Restriction
825                  (No_Implementation_Aspect_Specifications, Aspect);
826             end if;
827
828             --  Check restriction No_Specification_Of_Aspect
829
830             Check_Restriction_No_Specification_Of_Aspect (Aspect);
831
832             --  Analyze this aspect
833
834             Set_Analyzed (Aspect);
835             Set_Entity (Aspect, E);
836             Ent := New_Occurrence_Of (E, Sloc (Id));
837
838             --  Check for duplicate aspect. Note that the Comes_From_Source
839             --  test allows duplicate Pre/Post's that we generate internally
840             --  to escape being flagged here.
841
842             if No_Duplicates_Allowed (A_Id) then
843                Anod := First (L);
844                while Anod /= Aspect loop
845                   if Same_Aspect
846                       (A_Id, Get_Aspect_Id (Chars (Identifier (Anod))))
847                     and then Comes_From_Source (Aspect)
848                   then
849                      Error_Msg_Name_1 := Nam;
850                      Error_Msg_Sloc := Sloc (Anod);
851
852                      --  Case of same aspect specified twice
853
854                      if Class_Present (Anod) = Class_Present (Aspect) then
855                         if not Class_Present (Anod) then
856                            Error_Msg_NE
857                              ("aspect% for & previously given#",
858                               Id, E);
859                         else
860                            Error_Msg_NE
861                              ("aspect `%''Class` for & previously given#",
862                               Id, E);
863                         end if;
864
865                         --  Case of Pre and Pre'Class both specified
866
867                      elsif Nam = Name_Pre then
868                         if Class_Present (Aspect) then
869                            Error_Msg_NE
870                              ("aspect `Pre''Class` for & is not allowed here",
871                               Id, E);
872                            Error_Msg_NE
873                              ("\since aspect `Pre` previously given#",
874                               Id, E);
875
876                         else
877                            Error_Msg_NE
878                              ("aspect `Pre` for & is not allowed here",
879                               Id, E);
880                            Error_Msg_NE
881                              ("\since aspect `Pre''Class` previously given#",
882                               Id, E);
883                         end if;
884                      end if;
885
886                      --  Allowed case of X and X'Class both specified
887                   end if;
888
889                   Next (Anod);
890                end loop;
891             end if;
892
893             --  Copy expression for later processing by the procedures
894             --  Check_Aspect_At_[Freeze_Point | End_Of_Declarations]
895
896             Set_Entity (Id, New_Copy_Tree (Expr));
897
898             --  Processing based on specific aspect
899
900             case A_Id is
901
902                --  No_Aspect should be impossible
903
904                when No_Aspect =>
905                   raise Program_Error;
906
907                --  Aspects taking an optional boolean argument. For all of
908                --  these we just create a matching pragma and insert it, if
909                --  the expression is missing or set to True. If the expression
910                --  is False, we can ignore the aspect with the exception that
911                --  in the case of a derived type, we must check for an illegal
912                --  attempt to cancel an inherited aspect.
913
914                when Boolean_Aspects =>
915                   Set_Is_Boolean_Aspect (Aspect);
916
917                   if Present (Expr)
918                     and then Is_False (Static_Boolean (Expr))
919                   then
920                      Check_False_Aspect_For_Derived_Type;
921                      goto Continue;
922                   end if;
923
924                   --  If True, build corresponding pragma node
925
926                   Aitem :=
927                     Make_Pragma (Loc,
928                       Pragma_Argument_Associations => New_List (Ent),
929                       Pragma_Identifier            =>
930                         Make_Identifier (Sloc (Id), Chars (Id)));
931
932                   --  Never need to delay for boolean aspects
933
934                   pragma Assert (not Delay_Required);
935
936                --  Library unit aspects. These are boolean aspects, but we
937                --  have to do special things with the insertion, since the
938                --  pragma belongs inside the declarations of a package.
939
940                when Library_Unit_Aspects =>
941                   if Present (Expr)
942                     and then Is_False (Static_Boolean (Expr))
943                   then
944                      goto Continue;
945                   end if;
946
947                   --  Build corresponding pragma node
948
949                   Aitem :=
950                     Make_Pragma (Loc,
951                       Pragma_Argument_Associations => New_List (Ent),
952                       Pragma_Identifier            =>
953                         Make_Identifier (Sloc (Id), Chars (Id)));
954
955                   --  This requires special handling in the case of a package
956                   --  declaration, the pragma needs to be inserted in the list
957                   --  of declarations for the associated package. There is no
958                   --  issue of visibility delay for these aspects.
959
960                   if Nkind (N) = N_Package_Declaration then
961                      if Nkind (Parent (N)) /= N_Compilation_Unit then
962                         Error_Msg_N
963                           ("incorrect context for library unit aspect&", Id);
964                      else
965                         Prepend
966                           (Aitem, Visible_Declarations (Specification (N)));
967                      end if;
968
969                      goto Continue;
970                   end if;
971
972                   --  If not package declaration, no delay is required
973
974                   pragma Assert (not Delay_Required);
975
976                --  Aspects related to container iterators. These aspects denote
977                --  subprograms, and thus must be delayed.
978
979                when Aspect_Constant_Indexing    |
980                     Aspect_Variable_Indexing    =>
981
982                   if not Is_Type (E) or else not Is_Tagged_Type (E) then
983                      Error_Msg_N ("indexing applies to a tagged type", N);
984                   end if;
985
986                   Aitem :=
987                     Make_Attribute_Definition_Clause (Loc,
988                       Name       => Ent,
989                       Chars      => Chars (Id),
990                       Expression => Relocate_Node (Expr));
991
992                   Delay_Required := True;
993                   Set_Is_Delayed_Aspect (Aspect);
994
995                when Aspect_Default_Iterator     |
996                     Aspect_Iterator_Element     =>
997
998                   Aitem :=
999                     Make_Attribute_Definition_Clause (Loc,
1000                       Name       => Ent,
1001                       Chars      => Chars (Id),
1002                       Expression => Relocate_Node (Expr));
1003
1004                   Delay_Required := True;
1005                   Set_Is_Delayed_Aspect (Aspect);
1006
1007                when Aspect_Implicit_Dereference =>
1008                   if not Is_Type (E)
1009                     or else not Has_Discriminants (E)
1010                   then
1011                      Error_Msg_N
1012                        ("Aspect must apply to a type with discriminants", N);
1013                      goto Continue;
1014
1015                   else
1016                      declare
1017                         Disc : Entity_Id;
1018
1019                      begin
1020                         Disc := First_Discriminant (E);
1021                         while Present (Disc) loop
1022                            if Chars (Expr) = Chars (Disc)
1023                              and then Ekind (Etype (Disc)) =
1024                                E_Anonymous_Access_Type
1025                            then
1026                               Set_Has_Implicit_Dereference (E);
1027                               Set_Has_Implicit_Dereference (Disc);
1028                               goto Continue;
1029                            end if;
1030
1031                            Next_Discriminant (Disc);
1032                         end loop;
1033
1034                         --  Error if no proper access discriminant.
1035
1036                         Error_Msg_NE
1037                          ("not an access discriminant of&", Expr, E);
1038                      end;
1039
1040                      goto Continue;
1041                   end if;
1042
1043                --  Aspects corresponding to attribute definition clauses
1044
1045                when Aspect_Address        |
1046                     Aspect_Alignment      |
1047                     Aspect_Bit_Order      |
1048                     Aspect_Component_Size |
1049                     Aspect_External_Tag   |
1050                     Aspect_Input          |
1051                     Aspect_Machine_Radix  |
1052                     Aspect_Object_Size    |
1053                     Aspect_Output         |
1054                     Aspect_Read           |
1055                     Aspect_Size           |
1056                     Aspect_Small          |
1057                     Aspect_Storage_Pool   |
1058                     Aspect_Storage_Size   |
1059                     Aspect_Stream_Size    |
1060                     Aspect_Value_Size     |
1061                     Aspect_Write          =>
1062
1063                   --  Construct the attribute definition clause
1064
1065                   Aitem :=
1066                     Make_Attribute_Definition_Clause (Loc,
1067                       Name       => Ent,
1068                       Chars      => Chars (Id),
1069                       Expression => Relocate_Node (Expr));
1070
1071                   --  A delay is required except in the common case where
1072                   --  the expression is a literal, in which case it is fine
1073                   --  to take care of it right away.
1074
1075                   if Nkind_In (Expr, N_Integer_Literal, N_String_Literal) then
1076                      pragma Assert (not Delay_Required);
1077                      null;
1078                   else
1079                      Delay_Required := True;
1080                      Set_Is_Delayed_Aspect (Aspect);
1081                   end if;
1082
1083                --  Aspects corresponding to pragmas with two arguments, where
1084                --  the first argument is a local name referring to the entity,
1085                --  and the second argument is the aspect definition expression
1086                --  which is an expression that does not get analyzed.
1087
1088                when Aspect_Suppress   |
1089                     Aspect_Unsuppress =>
1090
1091                   --  Construct the pragma
1092
1093                   Aitem :=
1094                     Make_Pragma (Loc,
1095                       Pragma_Argument_Associations => New_List (
1096                         New_Occurrence_Of (E, Loc),
1097                         Relocate_Node (Expr)),
1098                       Pragma_Identifier            =>
1099                         Make_Identifier (Sloc (Id), Chars (Id)));
1100
1101                   --  We don't have to play the delay game here, since the only
1102                   --  values are check names which don't get analyzed anyway.
1103
1104                   pragma Assert (not Delay_Required);
1105
1106                --  Aspects corresponding to pragmas with two arguments, where
1107                --  the second argument is a local name referring to the entity,
1108                --  and the first argument is the aspect definition expression.
1109
1110                when Aspect_Warnings =>
1111
1112                   --  Construct the pragma
1113
1114                   Aitem :=
1115                     Make_Pragma (Loc,
1116                       Pragma_Argument_Associations => New_List (
1117                         Relocate_Node (Expr),
1118                         New_Occurrence_Of (E, Loc)),
1119                       Pragma_Identifier            =>
1120                         Make_Identifier (Sloc (Id), Chars (Id)),
1121                       Class_Present                => Class_Present (Aspect));
1122
1123                   --  We don't have to play the delay game here, since the only
1124                   --  values are ON/OFF which don't get analyzed anyway.
1125
1126                   pragma Assert (not Delay_Required);
1127
1128                --  Default_Value and Default_Component_Value aspects. These
1129                --  are specially handled because they have no corresponding
1130                --  pragmas or attributes.
1131
1132                when Aspect_Default_Value | Aspect_Default_Component_Value =>
1133                   Error_Msg_Name_1 := Chars (Id);
1134
1135                   if not Is_Type (E) then
1136                      Error_Msg_N ("aspect% can only apply to a type", Id);
1137                      goto Continue;
1138
1139                   elsif not Is_First_Subtype (E) then
1140                      Error_Msg_N ("aspect% cannot apply to subtype", Id);
1141                      goto Continue;
1142
1143                   elsif A_Id = Aspect_Default_Value
1144                     and then not Is_Scalar_Type (E)
1145                   then
1146                      Error_Msg_N
1147                        ("aspect% can only be applied to scalar type", Id);
1148                      goto Continue;
1149
1150                   elsif A_Id = Aspect_Default_Component_Value then
1151                      if not Is_Array_Type (E) then
1152                         Error_Msg_N
1153                           ("aspect% can only be applied to array type", Id);
1154                         goto Continue;
1155                      elsif not Is_Scalar_Type (Component_Type (E)) then
1156                         Error_Msg_N
1157                           ("aspect% requires scalar components", Id);
1158                         goto Continue;
1159                      end if;
1160                   end if;
1161
1162                   Aitem := Empty;
1163                   Delay_Required := True;
1164                   Set_Is_Delayed_Aspect (Aspect);
1165                   Set_Has_Default_Aspect (Base_Type (Entity (Ent)));
1166
1167                when Aspect_Attach_Handler =>
1168                   Aitem :=
1169                     Make_Pragma (Loc,
1170                       Pragma_Identifier            =>
1171                         Make_Identifier (Sloc (Id), Name_Attach_Handler),
1172                       Pragma_Argument_Associations =>
1173                         New_List (Ent, Relocate_Node (Expr)));
1174
1175                   Set_From_Aspect_Specification (Aitem, True);
1176                   Set_Corresponding_Aspect (Aitem, Aspect);
1177
1178                   pragma Assert (not Delay_Required);
1179
1180                when Aspect_Priority           |
1181                     Aspect_Interrupt_Priority |
1182                     Aspect_Dispatching_Domain |
1183                     Aspect_CPU                =>
1184                   declare
1185                      Pname : Name_Id;
1186
1187                   begin
1188                      if A_Id = Aspect_Priority then
1189                         Pname := Name_Priority;
1190
1191                      elsif A_Id = Aspect_Interrupt_Priority then
1192                         Pname := Name_Interrupt_Priority;
1193
1194                      elsif A_Id = Aspect_CPU then
1195                         Pname := Name_CPU;
1196
1197                      else
1198                         Pname := Name_Dispatching_Domain;
1199                      end if;
1200
1201                      Aitem :=
1202                        Make_Pragma (Loc,
1203                            Pragma_Identifier            =>
1204                              Make_Identifier (Sloc (Id), Pname),
1205                            Pragma_Argument_Associations =>
1206                              New_List
1207                                (Make_Pragma_Argument_Association
1208                                   (Sloc       => Sloc (Id),
1209                                    Expression => Relocate_Node (Expr))));
1210
1211                      Set_From_Aspect_Specification (Aitem, True);
1212                      Set_Corresponding_Aspect (Aitem, Aspect);
1213
1214                      pragma Assert (not Delay_Required);
1215                   end;
1216
1217                --  Aspects Pre/Post generate Precondition/Postcondition pragmas
1218                --  with a first argument that is the expression, and a second
1219                --  argument that is an informative message if the test fails.
1220                --  This is inserted right after the declaration, to get the
1221                --  required pragma placement. The processing for the pragmas
1222                --  takes care of the required delay.
1223
1224                when Pre_Post_Aspects => declare
1225                   Pname : Name_Id;
1226
1227                begin
1228                   if A_Id = Aspect_Pre or else A_Id = Aspect_Precondition then
1229                      Pname := Name_Precondition;
1230                   else
1231                      Pname := Name_Postcondition;
1232                   end if;
1233
1234                   --  If the expressions is of the form A and then B, then
1235                   --  we generate separate Pre/Post aspects for the separate
1236                   --  clauses. Since we allow multiple pragmas, there is no
1237                   --  problem in allowing multiple Pre/Post aspects internally.
1238                   --  These should be treated in reverse order (B first and
1239                   --  A second) since they are later inserted just after N in
1240                   --  the order they are treated. This way, the pragma for A
1241                   --  ends up preceding the pragma for B, which may have an
1242                   --  importance for the error raised (either constraint error
1243                   --  or precondition error).
1244
1245                   --  We do not do this for Pre'Class, since we have to put
1246                   --  these conditions together in a complex OR expression
1247
1248                   --  We do not do this in ASIS mode, as ASIS relies on the
1249                   --  original node representing the complete expression, when
1250                   --  retrieving it through the source aspect table.
1251
1252                   if not ASIS_Mode
1253                     and then (Pname = Name_Postcondition
1254                                or else not Class_Present (Aspect))
1255                   then
1256                      while Nkind (Expr) = N_And_Then loop
1257                         Insert_After (Aspect,
1258                           Make_Aspect_Specification (Sloc (Left_Opnd (Expr)),
1259                             Identifier    => Identifier (Aspect),
1260                             Expression    => Relocate_Node (Left_Opnd (Expr)),
1261                             Class_Present => Class_Present (Aspect),
1262                             Split_PPC     => True));
1263                         Rewrite (Expr, Relocate_Node (Right_Opnd (Expr)));
1264                         Eloc := Sloc (Expr);
1265                      end loop;
1266                   end if;
1267
1268                   --  Build the precondition/postcondition pragma
1269
1270                   Aitem :=
1271                     Make_Pragma (Loc,
1272                       Pragma_Identifier            =>
1273                         Make_Identifier (Sloc (Id), Pname),
1274                       Class_Present                => Class_Present (Aspect),
1275                       Split_PPC                    => Split_PPC (Aspect),
1276                       Pragma_Argument_Associations => New_List (
1277                         Make_Pragma_Argument_Association (Eloc,
1278                           Chars      => Name_Check,
1279                           Expression => Relocate_Node (Expr))));
1280
1281                   --  Add message unless exception messages are suppressed
1282
1283                   if not Opt.Exception_Locations_Suppressed then
1284                      Append_To (Pragma_Argument_Associations (Aitem),
1285                        Make_Pragma_Argument_Association (Eloc,
1286                          Chars     => Name_Message,
1287                          Expression =>
1288                            Make_String_Literal (Eloc,
1289                              Strval => "failed "
1290                                        & Get_Name_String (Pname)
1291                                        & " from "
1292                                        & Build_Location_String (Eloc))));
1293                   end if;
1294
1295                   Set_From_Aspect_Specification (Aitem, True);
1296                   Set_Corresponding_Aspect (Aitem, Aspect);
1297                   Set_Is_Delayed_Aspect (Aspect);
1298
1299                   --  For Pre/Post cases, insert immediately after the entity
1300                   --  declaration, since that is the required pragma placement.
1301                   --  Note that for these aspects, we do not have to worry
1302                   --  about delay issues, since the pragmas themselves deal
1303                   --  with delay of visibility for the expression analysis.
1304
1305                   --  If the entity is a library-level subprogram, the pre/
1306                   --  postconditions must be treated as late pragmas.
1307
1308                   if Nkind (Parent (N)) = N_Compilation_Unit then
1309                      Add_Global_Declaration (Aitem);
1310                   else
1311                      Insert_After (N, Aitem);
1312                   end if;
1313
1314                   goto Continue;
1315                end;
1316
1317                --  Invariant aspects generate a corresponding pragma with a
1318                --  first argument that is the entity, a second argument that is
1319                --  the expression and a third argument that is an appropriate
1320                --  message. This is inserted right after the declaration, to
1321                --  get the required pragma placement. The pragma processing
1322                --  takes care of the required delay.
1323
1324                when Aspect_Invariant      |
1325                     Aspect_Type_Invariant =>
1326
1327                   --  Analysis of the pragma will verify placement legality:
1328                   --  an invariant must apply to a private type, or appear in
1329                   --  the private part of a spec and apply to a completion.
1330
1331                   --  Construct the pragma
1332
1333                   Aitem :=
1334                     Make_Pragma (Loc,
1335                       Pragma_Argument_Associations =>
1336                         New_List (Ent, Relocate_Node (Expr)),
1337                       Class_Present                => Class_Present (Aspect),
1338                       Pragma_Identifier            =>
1339                         Make_Identifier (Sloc (Id), Name_Invariant));
1340
1341                   --  Add message unless exception messages are suppressed
1342
1343                   if not Opt.Exception_Locations_Suppressed then
1344                      Append_To (Pragma_Argument_Associations (Aitem),
1345                        Make_Pragma_Argument_Association (Eloc,
1346                          Chars      => Name_Message,
1347                          Expression =>
1348                            Make_String_Literal (Eloc,
1349                              Strval => "failed invariant from "
1350                                        & Build_Location_String (Eloc))));
1351                   end if;
1352
1353                   Set_From_Aspect_Specification (Aitem, True);
1354                   Set_Corresponding_Aspect (Aitem, Aspect);
1355                   Set_Is_Delayed_Aspect (Aspect);
1356
1357                   --  For Invariant case, insert immediately after the entity
1358                   --  declaration. We do not have to worry about delay issues
1359                   --  since the pragma processing takes care of this.
1360
1361                   Insert_After (N, Aitem);
1362                   goto Continue;
1363
1364                --  Predicate aspects generate a corresponding pragma with a
1365                --  first argument that is the entity, and the second argument
1366                --  is the expression.
1367
1368                when Aspect_Dynamic_Predicate |
1369                     Aspect_Predicate         |
1370                     Aspect_Static_Predicate  =>
1371
1372                   --  Construct the pragma (always a pragma Predicate, with
1373                   --  flags recording whether it is static/dynamic).
1374
1375                   Aitem :=
1376                     Make_Pragma (Loc,
1377                       Pragma_Argument_Associations =>
1378                         New_List (Ent, Relocate_Node (Expr)),
1379                       Class_Present                => Class_Present (Aspect),
1380                       Pragma_Identifier            =>
1381                         Make_Identifier (Sloc (Id), Name_Predicate));
1382
1383                   Set_From_Aspect_Specification (Aitem, True);
1384                   Set_Corresponding_Aspect (Aitem, Aspect);
1385
1386                   --  Make sure we have a freeze node (it might otherwise be
1387                   --  missing in cases like subtype X is Y, and we would not
1388                   --  have a place to build the predicate function).
1389
1390                   Set_Has_Predicates (E);
1391
1392                   if Is_Private_Type (E)
1393                     and then Present (Full_View (E))
1394                   then
1395                      Set_Has_Predicates (Full_View (E));
1396                      Set_Has_Delayed_Aspects (Full_View (E));
1397                   end if;
1398
1399                   Ensure_Freeze_Node (E);
1400                   Set_Is_Delayed_Aspect (Aspect);
1401                   Delay_Required := True;
1402
1403                when Aspect_Test_Case => declare
1404                   Args      : List_Id;
1405                   Comp_Expr : Node_Id;
1406                   Comp_Assn : Node_Id;
1407                   New_Expr  : Node_Id;
1408
1409                begin
1410                   Args := New_List;
1411
1412                   if Nkind (Parent (N)) = N_Compilation_Unit then
1413                      Error_Msg_N
1414                        ("incorrect placement of aspect `Test_Case`", E);
1415                      goto Continue;
1416                   end if;
1417
1418                   if Nkind (Expr) /= N_Aggregate then
1419                      Error_Msg_NE
1420                        ("wrong syntax for aspect `Test_Case` for &", Id, E);
1421                      goto Continue;
1422                   end if;
1423
1424                   --  Make pragma expressions refer to the original aspect
1425                   --  expressions through the Original_Node link. This is used
1426                   --  in semantic analysis for ASIS mode, so that the original
1427                   --  expression also gets analyzed.
1428
1429                   Comp_Expr := First (Expressions (Expr));
1430                   while Present (Comp_Expr) loop
1431                      New_Expr := Relocate_Node (Comp_Expr);
1432                      Set_Original_Node (New_Expr, Comp_Expr);
1433                      Append
1434                        (Make_Pragma_Argument_Association (Sloc (Comp_Expr),
1435                           Expression => New_Expr),
1436                        Args);
1437                      Next (Comp_Expr);
1438                   end loop;
1439
1440                   Comp_Assn := First (Component_Associations (Expr));
1441                   while Present (Comp_Assn) loop
1442                      if List_Length (Choices (Comp_Assn)) /= 1
1443                        or else
1444                          Nkind (First (Choices (Comp_Assn))) /= N_Identifier
1445                      then
1446                         Error_Msg_NE
1447                           ("wrong syntax for aspect `Test_Case` for &", Id, E);
1448                         goto Continue;
1449                      end if;
1450
1451                      New_Expr := Relocate_Node (Expression (Comp_Assn));
1452                      Set_Original_Node (New_Expr, Expression (Comp_Assn));
1453                      Append (Make_Pragma_Argument_Association (
1454                        Sloc       => Sloc (Comp_Assn),
1455                        Chars      => Chars (First (Choices (Comp_Assn))),
1456                        Expression => New_Expr),
1457                        Args);
1458                      Next (Comp_Assn);
1459                   end loop;
1460
1461                   --  Build the test-case pragma
1462
1463                   Aitem :=
1464                     Make_Pragma (Loc,
1465                       Pragma_Identifier            =>
1466                         Make_Identifier (Sloc (Id), Name_Test_Case),
1467                       Pragma_Argument_Associations =>
1468                         Args);
1469
1470                   Set_From_Aspect_Specification (Aitem, True);
1471                   Set_Corresponding_Aspect (Aitem, Aspect);
1472                   Set_Is_Delayed_Aspect (Aspect);
1473
1474                   --  Insert immediately after the entity declaration
1475
1476                   Insert_After (N, Aitem);
1477
1478                   goto Continue;
1479                end;
1480
1481                when Aspect_Dimension =>
1482                   Analyze_Aspect_Dimension (N, Id, Expr);
1483                   goto Continue;
1484
1485                when Aspect_Dimension_System =>
1486                   Analyze_Aspect_Dimension_System (N, Id, Expr);
1487                   goto Continue;
1488
1489             end case;
1490
1491             --  If a delay is required, we delay the freeze (not much point in
1492             --  delaying the aspect if we don't delay the freeze!). The pragma
1493             --  or attribute clause if there is one is then attached to the
1494             --  aspect specification which is placed in the rep item list.
1495
1496             if Delay_Required then
1497                if Present (Aitem) then
1498                   Set_From_Aspect_Specification (Aitem, True);
1499
1500                   if Nkind (Aitem) = N_Pragma then
1501                      Set_Corresponding_Aspect (Aitem, Aspect);
1502                   end if;
1503
1504                   Set_Is_Delayed_Aspect (Aitem);
1505                   Set_Aspect_Rep_Item (Aspect, Aitem);
1506                end if;
1507
1508                Ensure_Freeze_Node (E);
1509                Set_Has_Delayed_Aspects (E);
1510                Record_Rep_Item (E, Aspect);
1511
1512             --  If no delay required, insert the pragma/clause in the tree
1513
1514             else
1515                Set_From_Aspect_Specification (Aitem, True);
1516
1517                if Nkind (Aitem) = N_Pragma then
1518                   Set_Corresponding_Aspect (Aitem, Aspect);
1519                end if;
1520
1521                --  If this is a compilation unit, we will put the pragma in
1522                --  the Pragmas_After list of the N_Compilation_Unit_Aux node.
1523
1524                if Nkind (Parent (Ins_Node)) = N_Compilation_Unit then
1525                   declare
1526                      Aux : constant Node_Id :=
1527                              Aux_Decls_Node (Parent (Ins_Node));
1528
1529                   begin
1530                      pragma Assert (Nkind (Aux) = N_Compilation_Unit_Aux);
1531
1532                      if No (Pragmas_After (Aux)) then
1533                         Set_Pragmas_After (Aux, Empty_List);
1534                      end if;
1535
1536                      --  For Pre_Post put at start of list, otherwise at end
1537
1538                      if A_Id in Pre_Post_Aspects then
1539                         Prepend (Aitem, Pragmas_After (Aux));
1540                      else
1541                         Append (Aitem, Pragmas_After (Aux));
1542                      end if;
1543                   end;
1544
1545                --  Here if not compilation unit case
1546
1547                else
1548                   case A_Id is
1549
1550                      --  For Pre/Post cases, insert immediately after the
1551                      --  entity declaration, since that is the required pragma
1552                      --  placement.
1553
1554                      when Pre_Post_Aspects =>
1555                         Insert_After (N, Aitem);
1556
1557                      --  For Priority aspects, insert into the task or
1558                      --  protected definition, which we need to create if it's
1559                      --  not there. The same applies to CPU and
1560                      --  Dispatching_Domain but only to tasks.
1561
1562                      when Aspect_Priority           |
1563                           Aspect_Interrupt_Priority |
1564                           Aspect_Dispatching_Domain |
1565                           Aspect_CPU                =>
1566                         declare
1567                            T : Node_Id; -- the type declaration
1568                            L : List_Id; -- list of decls of task/protected
1569
1570                         begin
1571                            if Nkind (N) = N_Object_Declaration then
1572                               T := Parent (Etype (Defining_Identifier (N)));
1573                            else
1574                               T := N;
1575                            end if;
1576
1577                            if Nkind (T) = N_Protected_Type_Declaration
1578                              and then A_Id /= Aspect_Dispatching_Domain
1579                              and then A_Id /= Aspect_CPU
1580                            then
1581                               pragma Assert
1582                                 (Present (Protected_Definition (T)));
1583
1584                               L := Visible_Declarations
1585                                      (Protected_Definition (T));
1586
1587                            elsif Nkind (T) = N_Task_Type_Declaration then
1588                               if No (Task_Definition (T)) then
1589                                  Set_Task_Definition
1590                                    (T,
1591                                     Make_Task_Definition
1592                                       (Sloc (T),
1593                                        Visible_Declarations => New_List,
1594                                        End_Label => Empty));
1595                               end if;
1596
1597                               L := Visible_Declarations (Task_Definition (T));
1598
1599                            else
1600                               raise Program_Error;
1601                            end if;
1602
1603                            Prepend (Aitem, To => L);
1604
1605                            --  Analyze rewritten pragma. Otherwise, its
1606                            --  analysis is done too late, after the task or
1607                            --  protected object has been created.
1608
1609                            Analyze (Aitem);
1610                         end;
1611
1612                      --  For all other cases, insert in sequence
1613
1614                      when others =>
1615                         Insert_After (Ins_Node, Aitem);
1616                         Ins_Node := Aitem;
1617                   end case;
1618                end if;
1619             end if;
1620          end;
1621
1622       <<Continue>>
1623          Next (Aspect);
1624       end loop Aspect_Loop;
1625    end Analyze_Aspect_Specifications;
1626
1627    -----------------------
1628    -- Analyze_At_Clause --
1629    -----------------------
1630
1631    --  An at clause is replaced by the corresponding Address attribute
1632    --  definition clause that is the preferred approach in Ada 95.
1633
1634    procedure Analyze_At_Clause (N : Node_Id) is
1635       CS : constant Boolean := Comes_From_Source (N);
1636
1637    begin
1638       --  This is an obsolescent feature
1639
1640       Check_Restriction (No_Obsolescent_Features, N);
1641
1642       if Warn_On_Obsolescent_Feature then
1643          Error_Msg_N
1644            ("at clause is an obsolescent feature (RM J.7(2))?", N);
1645          Error_Msg_N
1646            ("\use address attribute definition clause instead?", N);
1647       end if;
1648
1649       --  Rewrite as address clause
1650
1651       Rewrite (N,
1652         Make_Attribute_Definition_Clause (Sloc (N),
1653           Name  => Identifier (N),
1654           Chars => Name_Address,
1655           Expression => Expression (N)));
1656
1657       --  We preserve Comes_From_Source, since logically the clause still
1658       --  comes from the source program even though it is changed in form.
1659
1660       Set_Comes_From_Source (N, CS);
1661
1662       --  Analyze rewritten clause
1663
1664       Analyze_Attribute_Definition_Clause (N);
1665    end Analyze_At_Clause;
1666
1667    -----------------------------------------
1668    -- Analyze_Attribute_Definition_Clause --
1669    -----------------------------------------
1670
1671    procedure Analyze_Attribute_Definition_Clause (N : Node_Id) is
1672       Loc   : constant Source_Ptr   := Sloc (N);
1673       Nam   : constant Node_Id      := Name (N);
1674       Attr  : constant Name_Id      := Chars (N);
1675       Expr  : constant Node_Id      := Expression (N);
1676       Id    : constant Attribute_Id := Get_Attribute_Id (Attr);
1677
1678       Ent : Entity_Id;
1679       --  The entity of Nam after it is analyzed. In the case of an incomplete
1680       --  type, this is the underlying type.
1681
1682       U_Ent : Entity_Id;
1683       --  The underlying entity to which the attribute applies. Generally this
1684       --  is the Underlying_Type of Ent, except in the case where the clause
1685       --  applies to full view of incomplete type or private type in which case
1686       --  U_Ent is just a copy of Ent.
1687
1688       FOnly : Boolean := False;
1689       --  Reset to True for subtype specific attribute (Alignment, Size)
1690       --  and for stream attributes, i.e. those cases where in the call
1691       --  to Rep_Item_Too_Late, FOnly is set True so that only the freezing
1692       --  rules are checked. Note that the case of stream attributes is not
1693       --  clear from the RM, but see AI95-00137. Also, the RM seems to
1694       --  disallow Storage_Size for derived task types, but that is also
1695       --  clearly unintentional.
1696
1697       procedure Analyze_Stream_TSS_Definition (TSS_Nam : TSS_Name_Type);
1698       --  Common processing for 'Read, 'Write, 'Input and 'Output attribute
1699       --  definition clauses.
1700
1701       function Duplicate_Clause return Boolean;
1702       --  This routine checks if the aspect for U_Ent being given by attribute
1703       --  definition clause N is for an aspect that has already been specified,
1704       --  and if so gives an error message. If there is a duplicate, True is
1705       --  returned, otherwise if there is no error, False is returned.
1706
1707       procedure Check_Indexing_Functions;
1708       --  Check that the function in Constant_Indexing or Variable_Indexing
1709       --  attribute has the proper type structure. If the name is overloaded,
1710       --  check that all interpretations are legal.
1711
1712       procedure Check_Iterator_Functions;
1713       --  Check that there is a single function in Default_Iterator attribute
1714       --  has the proper type structure.
1715
1716       function Check_Primitive_Function (Subp : Entity_Id) return Boolean;
1717       --  Common legality check for the previous two
1718
1719       -----------------------------------
1720       -- Analyze_Stream_TSS_Definition --
1721       -----------------------------------
1722
1723       procedure Analyze_Stream_TSS_Definition (TSS_Nam : TSS_Name_Type) is
1724          Subp : Entity_Id := Empty;
1725          I    : Interp_Index;
1726          It   : Interp;
1727          Pnam : Entity_Id;
1728
1729          Is_Read : constant Boolean := (TSS_Nam = TSS_Stream_Read);
1730          --  True for Read attribute, false for other attributes
1731
1732          function Has_Good_Profile (Subp : Entity_Id) return Boolean;
1733          --  Return true if the entity is a subprogram with an appropriate
1734          --  profile for the attribute being defined.
1735
1736          ----------------------
1737          -- Has_Good_Profile --
1738          ----------------------
1739
1740          function Has_Good_Profile (Subp : Entity_Id) return Boolean is
1741             F              : Entity_Id;
1742             Is_Function    : constant Boolean := (TSS_Nam = TSS_Stream_Input);
1743             Expected_Ekind : constant array (Boolean) of Entity_Kind :=
1744                                (False => E_Procedure, True => E_Function);
1745             Typ            : Entity_Id;
1746
1747          begin
1748             if Ekind (Subp) /= Expected_Ekind (Is_Function) then
1749                return False;
1750             end if;
1751
1752             F := First_Formal (Subp);
1753
1754             if No (F)
1755               or else Ekind (Etype (F)) /= E_Anonymous_Access_Type
1756               or else Designated_Type (Etype (F)) /=
1757                                Class_Wide_Type (RTE (RE_Root_Stream_Type))
1758             then
1759                return False;
1760             end if;
1761
1762             if not Is_Function then
1763                Next_Formal (F);
1764
1765                declare
1766                   Expected_Mode : constant array (Boolean) of Entity_Kind :=
1767                                     (False => E_In_Parameter,
1768                                      True  => E_Out_Parameter);
1769                begin
1770                   if Parameter_Mode (F) /= Expected_Mode (Is_Read) then
1771                      return False;
1772                   end if;
1773                end;
1774
1775                Typ := Etype (F);
1776
1777             else
1778                Typ := Etype (Subp);
1779             end if;
1780
1781             return Base_Type (Typ) = Base_Type (Ent)
1782               and then No (Next_Formal (F));
1783          end Has_Good_Profile;
1784
1785       --  Start of processing for Analyze_Stream_TSS_Definition
1786
1787       begin
1788          FOnly := True;
1789
1790          if not Is_Type (U_Ent) then
1791             Error_Msg_N ("local name must be a subtype", Nam);
1792             return;
1793          end if;
1794
1795          Pnam := TSS (Base_Type (U_Ent), TSS_Nam);
1796
1797          --  If Pnam is present, it can be either inherited from an ancestor
1798          --  type (in which case it is legal to redefine it for this type), or
1799          --  be a previous definition of the attribute for the same type (in
1800          --  which case it is illegal).
1801
1802          --  In the first case, it will have been analyzed already, and we
1803          --  can check that its profile does not match the expected profile
1804          --  for a stream attribute of U_Ent. In the second case, either Pnam
1805          --  has been analyzed (and has the expected profile), or it has not
1806          --  been analyzed yet (case of a type that has not been frozen yet
1807          --  and for which the stream attribute has been set using Set_TSS).
1808
1809          if Present (Pnam)
1810            and then (No (First_Entity (Pnam)) or else Has_Good_Profile (Pnam))
1811          then
1812             Error_Msg_Sloc := Sloc (Pnam);
1813             Error_Msg_Name_1 := Attr;
1814             Error_Msg_N ("% attribute already defined #", Nam);
1815             return;
1816          end if;
1817
1818          Analyze (Expr);
1819
1820          if Is_Entity_Name (Expr) then
1821             if not Is_Overloaded (Expr) then
1822                if Has_Good_Profile (Entity (Expr)) then
1823                   Subp := Entity (Expr);
1824                end if;
1825
1826             else
1827                Get_First_Interp (Expr, I, It);
1828                while Present (It.Nam) loop
1829                   if Has_Good_Profile (It.Nam) then
1830                      Subp := It.Nam;
1831                      exit;
1832                   end if;
1833
1834                   Get_Next_Interp (I, It);
1835                end loop;
1836             end if;
1837          end if;
1838
1839          if Present (Subp) then
1840             if Is_Abstract_Subprogram (Subp) then
1841                Error_Msg_N ("stream subprogram must not be abstract", Expr);
1842                return;
1843             end if;
1844
1845             Set_Entity (Expr, Subp);
1846             Set_Etype (Expr, Etype (Subp));
1847
1848             New_Stream_Subprogram (N, U_Ent, Subp, TSS_Nam);
1849
1850          else
1851             Error_Msg_Name_1 := Attr;
1852             Error_Msg_N ("incorrect expression for% attribute", Expr);
1853          end if;
1854       end Analyze_Stream_TSS_Definition;
1855
1856       ------------------------------
1857       -- Check_Indexing_Functions --
1858       ------------------------------
1859
1860       procedure Check_Indexing_Functions is
1861
1862          procedure Check_One_Function (Subp : Entity_Id);
1863          --  Check one possible interpretation
1864
1865          ------------------------
1866          -- Check_One_Function --
1867          ------------------------
1868
1869          procedure Check_One_Function (Subp : Entity_Id) is
1870             Default_Element : constant Node_Id :=
1871                                 Find_Aspect
1872                                   (Etype (First_Formal (Subp)),
1873                                    Aspect_Iterator_Element);
1874
1875          begin
1876             if not Check_Primitive_Function (Subp) then
1877                Error_Msg_NE
1878                  ("aspect Indexing requires a function that applies to type&",
1879                    Subp, Ent);
1880             end if;
1881
1882             --  An indexing function must return either the default element of
1883             --  the container, or a reference type.
1884
1885             if Present (Default_Element) then
1886                Analyze (Default_Element);
1887                if Is_Entity_Name (Default_Element)
1888                  and then Covers (Entity (Default_Element), Etype (Subp))
1889                then
1890                   return;
1891                end if;
1892             end if;
1893
1894             --  Otherwise the return type must be a reference type.
1895
1896             if not Has_Implicit_Dereference (Etype (Subp)) then
1897                Error_Msg_N
1898                  ("function for indexing must return a reference type", Subp);
1899             end if;
1900          end Check_One_Function;
1901
1902       --  Start of processing for Check_Indexing_Functions
1903
1904       begin
1905          if In_Instance then
1906             return;
1907          end if;
1908
1909          Analyze (Expr);
1910
1911          if not Is_Overloaded (Expr) then
1912             Check_One_Function (Entity (Expr));
1913
1914          else
1915             declare
1916                I  : Interp_Index;
1917                It : Interp;
1918
1919             begin
1920                Get_First_Interp (Expr, I, It);
1921                while Present (It.Nam) loop
1922
1923                   --  Note that analysis will have added the interpretation
1924                   --  that corresponds to the dereference. We only check the
1925                   --  subprogram itself.
1926
1927                   if Is_Overloadable (It.Nam) then
1928                      Check_One_Function (It.Nam);
1929                   end if;
1930
1931                   Get_Next_Interp (I, It);
1932                end loop;
1933             end;
1934          end if;
1935       end Check_Indexing_Functions;
1936
1937       ------------------------------
1938       -- Check_Iterator_Functions --
1939       ------------------------------
1940
1941       procedure Check_Iterator_Functions is
1942          Default : Entity_Id;
1943
1944          function Valid_Default_Iterator (Subp : Entity_Id) return Boolean;
1945          --  Check one possible interpretation for validity
1946
1947          ----------------------------
1948          -- Valid_Default_Iterator --
1949          ----------------------------
1950
1951          function Valid_Default_Iterator (Subp : Entity_Id) return Boolean is
1952             Formal : Entity_Id;
1953
1954          begin
1955             if not Check_Primitive_Function (Subp) then
1956                return False;
1957             else
1958                Formal := First_Formal (Subp);
1959             end if;
1960
1961             --  False if any subsequent formal has no default expression
1962
1963             Formal := Next_Formal (Formal);
1964             while Present (Formal) loop
1965                if No (Expression (Parent (Formal))) then
1966                   return False;
1967                end if;
1968
1969                Next_Formal (Formal);
1970             end loop;
1971
1972             --  True if all subsequent formals have default expressions
1973
1974             return True;
1975          end Valid_Default_Iterator;
1976
1977       --  Start of processing for Check_Iterator_Functions
1978
1979       begin
1980          Analyze (Expr);
1981
1982          if not Is_Entity_Name (Expr) then
1983             Error_Msg_N ("aspect Iterator must be a function name", Expr);
1984          end if;
1985
1986          if not Is_Overloaded (Expr) then
1987             if not Check_Primitive_Function (Entity (Expr)) then
1988                Error_Msg_NE
1989                  ("aspect Indexing requires a function that applies to type&",
1990                    Entity (Expr), Ent);
1991             end if;
1992
1993             if not Valid_Default_Iterator (Entity (Expr)) then
1994                Error_Msg_N ("improper function for default iterator", Expr);
1995             end if;
1996
1997          else
1998             Default := Empty;
1999             declare
2000                I : Interp_Index;
2001                It : Interp;
2002
2003             begin
2004                Get_First_Interp (Expr, I, It);
2005                while Present (It.Nam) loop
2006                   if not Check_Primitive_Function (It.Nam)
2007                     or else not Valid_Default_Iterator (It.Nam)
2008                   then
2009                      Remove_Interp (I);
2010
2011                   elsif Present (Default) then
2012                      Error_Msg_N ("default iterator must be unique", Expr);
2013
2014                   else
2015                      Default := It.Nam;
2016                   end if;
2017
2018                   Get_Next_Interp (I, It);
2019                end loop;
2020             end;
2021
2022             if Present (Default) then
2023                Set_Entity (Expr, Default);
2024                Set_Is_Overloaded (Expr, False);
2025             end if;
2026          end if;
2027       end Check_Iterator_Functions;
2028
2029       -------------------------------
2030       -- Check_Primitive_Function  --
2031       -------------------------------
2032
2033       function Check_Primitive_Function (Subp : Entity_Id) return Boolean is
2034          Ctrl : Entity_Id;
2035
2036       begin
2037          if Ekind (Subp) /= E_Function then
2038             return False;
2039          end if;
2040
2041          if No (First_Formal (Subp)) then
2042             return False;
2043          else
2044             Ctrl := Etype (First_Formal (Subp));
2045          end if;
2046
2047          if Ctrl = Ent
2048            or else Ctrl = Class_Wide_Type (Ent)
2049            or else
2050              (Ekind (Ctrl) = E_Anonymous_Access_Type
2051                and then
2052                  (Designated_Type (Ctrl) = Ent
2053                    or else Designated_Type (Ctrl) = Class_Wide_Type (Ent)))
2054          then
2055             null;
2056
2057          else
2058             return False;
2059          end if;
2060
2061          return True;
2062       end Check_Primitive_Function;
2063
2064       ----------------------
2065       -- Duplicate_Clause --
2066       ----------------------
2067
2068       function Duplicate_Clause return Boolean is
2069          A : Node_Id;
2070
2071       begin
2072          --  Nothing to do if this attribute definition clause comes from
2073          --  an aspect specification, since we could not be duplicating an
2074          --  explicit clause, and we dealt with the case of duplicated aspects
2075          --  in Analyze_Aspect_Specifications.
2076
2077          if From_Aspect_Specification (N) then
2078             return False;
2079          end if;
2080
2081          --  Otherwise current clause may duplicate previous clause or a
2082          --  previously given aspect specification for the same aspect.
2083
2084          A := Get_Rep_Item_For_Entity (U_Ent, Chars (N));
2085
2086          if Present (A) then
2087             if Entity (A) = U_Ent then
2088                Error_Msg_Name_1 := Chars (N);
2089                Error_Msg_Sloc := Sloc (A);
2090                Error_Msg_NE ("aspect% for & previously given#", N, U_Ent);
2091                return True;
2092             end if;
2093          end if;
2094
2095          return False;
2096       end Duplicate_Clause;
2097
2098    --  Start of processing for Analyze_Attribute_Definition_Clause
2099
2100    begin
2101       --  The following code is a defense against recursion. Not clear that
2102       --  this can happen legitimately, but perhaps some error situations
2103       --  can cause it, and we did see this recursion during testing.
2104
2105       if Analyzed (N) then
2106          return;
2107       else
2108          Set_Analyzed (N, True);
2109       end if;
2110
2111       --  Process Ignore_Rep_Clauses option (we also ignore rep clauses in
2112       --  CodePeer mode or Alfa mode, since they are not relevant in these
2113       --  contexts).
2114
2115       if Ignore_Rep_Clauses or CodePeer_Mode or Alfa_Mode then
2116          case Id is
2117
2118             --  The following should be ignored. They do not affect legality
2119             --  and may be target dependent. The basic idea of -gnatI is to
2120             --  ignore any rep clauses that may be target dependent but do not
2121             --  affect legality (except possibly to be rejected because they
2122             --  are incompatible with the compilation target).
2123
2124             when Attribute_Alignment      |
2125                  Attribute_Bit_Order      |
2126                  Attribute_Component_Size |
2127                  Attribute_Machine_Radix  |
2128                  Attribute_Object_Size    |
2129                  Attribute_Size           |
2130                  Attribute_Stream_Size    |
2131                  Attribute_Value_Size     =>
2132                Rewrite (N, Make_Null_Statement (Sloc (N)));
2133                return;
2134
2135             --  We do not want too ignore 'Small in CodePeer_Mode or Alfa_Mode,
2136             --  since it has an impact on the exact computations performed.
2137
2138             --  Perhaps 'Small should also not be ignored by
2139             --  Ignore_Rep_Clauses ???
2140
2141             when Attribute_Small =>
2142                if Ignore_Rep_Clauses then
2143                   Rewrite (N, Make_Null_Statement (Sloc (N)));
2144                   return;
2145                end if;
2146
2147             --  The following should not be ignored, because in the first place
2148             --  they are reasonably portable, and should not cause problems in
2149             --  compiling code from another target, and also they do affect
2150             --  legality, e.g. failing to provide a stream attribute for a
2151             --  type may make a program illegal.
2152
2153             when Attribute_External_Tag |
2154                  Attribute_Input        |
2155                  Attribute_Output       |
2156                  Attribute_Read         |
2157                  Attribute_Storage_Pool |
2158                  Attribute_Storage_Size |
2159                  Attribute_Write        =>
2160                null;
2161
2162             --  Other cases are errors ("attribute& cannot be set with
2163             --  definition clause"), which will be caught below.
2164
2165             when others =>
2166                null;
2167          end case;
2168       end if;
2169
2170       Analyze (Nam);
2171       Ent := Entity (Nam);
2172
2173       if Rep_Item_Too_Early (Ent, N) then
2174          return;
2175       end if;
2176
2177       --  Rep clause applies to full view of incomplete type or private type if
2178       --  we have one (if not, this is a premature use of the type). However,
2179       --  certain semantic checks need to be done on the specified entity (i.e.
2180       --  the private view), so we save it in Ent.
2181
2182       if Is_Private_Type (Ent)
2183         and then Is_Derived_Type (Ent)
2184         and then not Is_Tagged_Type (Ent)
2185         and then No (Full_View (Ent))
2186       then
2187          --  If this is a private type whose completion is a derivation from
2188          --  another private type, there is no full view, and the attribute
2189          --  belongs to the type itself, not its underlying parent.
2190
2191          U_Ent := Ent;
2192
2193       elsif Ekind (Ent) = E_Incomplete_Type then
2194
2195          --  The attribute applies to the full view, set the entity of the
2196          --  attribute definition accordingly.
2197
2198          Ent := Underlying_Type (Ent);
2199          U_Ent := Ent;
2200          Set_Entity (Nam, Ent);
2201
2202       else
2203          U_Ent := Underlying_Type (Ent);
2204       end if;
2205
2206       --  Avoid cascaded error
2207
2208       if Etype (Nam) = Any_Type then
2209          return;
2210
2211       --  Must be declared in current scope
2212
2213       elsif Scope (Ent) /= Current_Scope then
2214          Error_Msg_N ("entity must be declared in this scope", Nam);
2215          return;
2216
2217       --  Must not be a source renaming (we do have some cases where the
2218       --  expander generates a renaming, and those cases are OK, in such
2219       --  cases any attribute applies to the renamed object as well).
2220
2221       elsif Is_Object (Ent)
2222         and then Present (Renamed_Object (Ent))
2223       then
2224          --  Case of renamed object from source, this is an error
2225
2226          if Comes_From_Source (Renamed_Object (Ent)) then
2227             Get_Name_String (Chars (N));
2228             Error_Msg_Strlen := Name_Len;
2229             Error_Msg_String (1 .. Name_Len) := Name_Buffer (1 .. Name_Len);
2230             Error_Msg_N
2231               ("~ clause not allowed for a renaming declaration "
2232                & "(RM 13.1(6))", Nam);
2233             return;
2234
2235          --  For the case of a compiler generated renaming, the attribute
2236          --  definition clause applies to the renamed object created by the
2237          --  expander. The easiest general way to handle this is to create a
2238          --  copy of the attribute definition clause for this object.
2239
2240          else
2241             Insert_Action (N,
2242               Make_Attribute_Definition_Clause (Loc,
2243                 Name       =>
2244                   New_Occurrence_Of (Entity (Renamed_Object (Ent)), Loc),
2245                 Chars      => Chars (N),
2246                 Expression => Duplicate_Subexpr (Expression (N))));
2247          end if;
2248
2249       --  If no underlying entity, use entity itself, applies to some
2250       --  previously detected error cases ???
2251
2252       elsif No (U_Ent) then
2253          U_Ent := Ent;
2254
2255       --  Cannot specify for a subtype (exception Object/Value_Size)
2256
2257       elsif Is_Type (U_Ent)
2258         and then not Is_First_Subtype (U_Ent)
2259         and then Id /= Attribute_Object_Size
2260         and then Id /= Attribute_Value_Size
2261         and then not From_At_Mod (N)
2262       then
2263          Error_Msg_N ("cannot specify attribute for subtype", Nam);
2264          return;
2265       end if;
2266
2267       Set_Entity (N, U_Ent);
2268
2269       --  Switch on particular attribute
2270
2271       case Id is
2272
2273          -------------
2274          -- Address --
2275          -------------
2276
2277          --  Address attribute definition clause
2278
2279          when Attribute_Address => Address : begin
2280
2281             --  A little error check, catch for X'Address use X'Address;
2282
2283             if Nkind (Nam) = N_Identifier
2284               and then Nkind (Expr) = N_Attribute_Reference
2285               and then Attribute_Name (Expr) = Name_Address
2286               and then Nkind (Prefix (Expr)) = N_Identifier
2287               and then Chars (Nam) = Chars (Prefix (Expr))
2288             then
2289                Error_Msg_NE
2290                  ("address for & is self-referencing", Prefix (Expr), Ent);
2291                return;
2292             end if;
2293
2294             --  Not that special case, carry on with analysis of expression
2295
2296             Analyze_And_Resolve (Expr, RTE (RE_Address));
2297
2298             --  Even when ignoring rep clauses we need to indicate that the
2299             --  entity has an address clause and thus it is legal to declare
2300             --  it imported.
2301
2302             if Ignore_Rep_Clauses then
2303                if Ekind_In (U_Ent, E_Variable, E_Constant) then
2304                   Record_Rep_Item (U_Ent, N);
2305                end if;
2306
2307                return;
2308             end if;
2309
2310             if Duplicate_Clause then
2311                null;
2312
2313             --  Case of address clause for subprogram
2314
2315             elsif Is_Subprogram (U_Ent) then
2316                if Has_Homonym (U_Ent) then
2317                   Error_Msg_N
2318                     ("address clause cannot be given " &
2319                      "for overloaded subprogram",
2320                      Nam);
2321                   return;
2322                end if;
2323
2324                --  For subprograms, all address clauses are permitted, and we
2325                --  mark the subprogram as having a deferred freeze so that Gigi
2326                --  will not elaborate it too soon.
2327
2328                --  Above needs more comments, what is too soon about???
2329
2330                Set_Has_Delayed_Freeze (U_Ent);
2331
2332             --  Case of address clause for entry
2333
2334             elsif Ekind (U_Ent) = E_Entry then
2335                if Nkind (Parent (N)) = N_Task_Body then
2336                   Error_Msg_N
2337                     ("entry address must be specified in task spec", Nam);
2338                   return;
2339                end if;
2340
2341                --  For entries, we require a constant address
2342
2343                Check_Constant_Address_Clause (Expr, U_Ent);
2344
2345                --  Special checks for task types
2346
2347                if Is_Task_Type (Scope (U_Ent))
2348                  and then Comes_From_Source (Scope (U_Ent))
2349                then
2350                   Error_Msg_N
2351                     ("?entry address declared for entry in task type", N);
2352                   Error_Msg_N
2353                     ("\?only one task can be declared of this type", N);
2354                end if;
2355
2356                --  Entry address clauses are obsolescent
2357
2358                Check_Restriction (No_Obsolescent_Features, N);
2359
2360                if Warn_On_Obsolescent_Feature then
2361                   Error_Msg_N
2362                     ("attaching interrupt to task entry is an " &
2363                      "obsolescent feature (RM J.7.1)?", N);
2364                   Error_Msg_N
2365                     ("\use interrupt procedure instead?", N);
2366                end if;
2367
2368             --  Case of an address clause for a controlled object which we
2369             --  consider to be erroneous.
2370
2371             elsif Is_Controlled (Etype (U_Ent))
2372               or else Has_Controlled_Component (Etype (U_Ent))
2373             then
2374                Error_Msg_NE
2375                  ("?controlled object& must not be overlaid", Nam, U_Ent);
2376                Error_Msg_N
2377                  ("\?Program_Error will be raised at run time", Nam);
2378                Insert_Action (Declaration_Node (U_Ent),
2379                  Make_Raise_Program_Error (Loc,
2380                    Reason => PE_Overlaid_Controlled_Object));
2381                return;
2382
2383             --  Case of address clause for a (non-controlled) object
2384
2385             elsif
2386               Ekind (U_Ent) = E_Variable
2387                 or else
2388               Ekind (U_Ent) = E_Constant
2389             then
2390                declare
2391                   Expr  : constant Node_Id := Expression (N);
2392                   O_Ent : Entity_Id;
2393                   Off   : Boolean;
2394
2395                begin
2396                   --  Exported variables cannot have an address clause, because
2397                   --  this cancels the effect of the pragma Export.
2398
2399                   if Is_Exported (U_Ent) then
2400                      Error_Msg_N
2401                        ("cannot export object with address clause", Nam);
2402                      return;
2403                   end if;
2404
2405                   Find_Overlaid_Entity (N, O_Ent, Off);
2406
2407                   --  Overlaying controlled objects is erroneous
2408
2409                   if Present (O_Ent)
2410                     and then (Has_Controlled_Component (Etype (O_Ent))
2411                                 or else Is_Controlled (Etype (O_Ent)))
2412                   then
2413                      Error_Msg_N
2414                        ("?cannot overlay with controlled object", Expr);
2415                      Error_Msg_N
2416                        ("\?Program_Error will be raised at run time", Expr);
2417                      Insert_Action (Declaration_Node (U_Ent),
2418                        Make_Raise_Program_Error (Loc,
2419                          Reason => PE_Overlaid_Controlled_Object));
2420                      return;
2421
2422                   elsif Present (O_Ent)
2423                     and then Ekind (U_Ent) = E_Constant
2424                     and then not Is_Constant_Object (O_Ent)
2425                   then
2426                      Error_Msg_N ("constant overlays a variable?", Expr);
2427
2428                   --  Imported variables can have an address clause, but then
2429                   --  the import is pretty meaningless except to suppress
2430                   --  initializations, so we do not need such variables to
2431                   --  be statically allocated (and in fact it causes trouble
2432                   --  if the address clause is a local value).
2433
2434                   elsif Is_Imported (U_Ent) then
2435                      Set_Is_Statically_Allocated (U_Ent, False);
2436                   end if;
2437
2438                   --  We mark a possible modification of a variable with an
2439                   --  address clause, since it is likely aliasing is occurring.
2440
2441                   Note_Possible_Modification (Nam, Sure => False);
2442
2443                   --  Here we are checking for explicit overlap of one variable
2444                   --  by another, and if we find this then mark the overlapped
2445                   --  variable as also being volatile to prevent unwanted
2446                   --  optimizations. This is a significant pessimization so
2447                   --  avoid it when there is an offset, i.e. when the object
2448                   --  is composite; they cannot be optimized easily anyway.
2449
2450                   if Present (O_Ent)
2451                     and then Is_Object (O_Ent)
2452                     and then not Off
2453                   then
2454                      Set_Treat_As_Volatile (O_Ent);
2455                   end if;
2456
2457                   --  Legality checks on the address clause for initialized
2458                   --  objects is deferred until the freeze point, because
2459                   --  a subsequent pragma might indicate that the object is
2460                   --  imported and thus not initialized.
2461
2462                   Set_Has_Delayed_Freeze (U_Ent);
2463
2464                   --  If an initialization call has been generated for this
2465                   --  object, it needs to be deferred to after the freeze node
2466                   --  we have just now added, otherwise GIGI will see a
2467                   --  reference to the variable (as actual to the IP call)
2468                   --  before its definition.
2469
2470                   declare
2471                      Init_Call : constant Node_Id := Find_Init_Call (U_Ent, N);
2472                   begin
2473                      if Present (Init_Call) then
2474                         Remove (Init_Call);
2475                         Append_Freeze_Action (U_Ent, Init_Call);
2476                      end if;
2477                   end;
2478
2479                   if Is_Exported (U_Ent) then
2480                      Error_Msg_N
2481                        ("& cannot be exported if an address clause is given",
2482                         Nam);
2483                      Error_Msg_N
2484                        ("\define and export a variable " &
2485                         "that holds its address instead",
2486                         Nam);
2487                   end if;
2488
2489                   --  Entity has delayed freeze, so we will generate an
2490                   --  alignment check at the freeze point unless suppressed.
2491
2492                   if not Range_Checks_Suppressed (U_Ent)
2493                     and then not Alignment_Checks_Suppressed (U_Ent)
2494                   then
2495                      Set_Check_Address_Alignment (N);
2496                   end if;
2497
2498                   --  Kill the size check code, since we are not allocating
2499                   --  the variable, it is somewhere else.
2500
2501                   Kill_Size_Check_Code (U_Ent);
2502
2503                   --  If the address clause is of the form:
2504
2505                   --    for Y'Address use X'Address
2506
2507                   --  or
2508
2509                   --    Const : constant Address := X'Address;
2510                   --    ...
2511                   --    for Y'Address use Const;
2512
2513                   --  then we make an entry in the table for checking the size
2514                   --  and alignment of the overlaying variable. We defer this
2515                   --  check till after code generation to take full advantage
2516                   --  of the annotation done by the back end. This entry is
2517                   --  only made if the address clause comes from source.
2518
2519                   --  If the entity has a generic type, the check will be
2520                   --  performed in the instance if the actual type justifies
2521                   --  it, and we do not insert the clause in the table to
2522                   --  prevent spurious warnings.
2523
2524                   if Address_Clause_Overlay_Warnings
2525                     and then Comes_From_Source (N)
2526                     and then Present (O_Ent)
2527                     and then Is_Object (O_Ent)
2528                   then
2529                      if not Is_Generic_Type (Etype (U_Ent)) then
2530                         Address_Clause_Checks.Append ((N, U_Ent, O_Ent, Off));
2531                      end if;
2532
2533                      --  If variable overlays a constant view, and we are
2534                      --  warning on overlays, then mark the variable as
2535                      --  overlaying a constant (we will give warnings later
2536                      --  if this variable is assigned).
2537
2538                      if Is_Constant_Object (O_Ent)
2539                        and then Ekind (U_Ent) = E_Variable
2540                      then
2541                         Set_Overlays_Constant (U_Ent);
2542                      end if;
2543                   end if;
2544                end;
2545
2546             --  Not a valid entity for an address clause
2547
2548             else
2549                Error_Msg_N ("address cannot be given for &", Nam);
2550             end if;
2551          end Address;
2552
2553          ---------------
2554          -- Alignment --
2555          ---------------
2556
2557          --  Alignment attribute definition clause
2558
2559          when Attribute_Alignment => Alignment : declare
2560             Align     : constant Uint := Get_Alignment_Value (Expr);
2561             Max_Align : constant Uint := UI_From_Int (Maximum_Alignment);
2562
2563          begin
2564             FOnly := True;
2565
2566             if not Is_Type (U_Ent)
2567               and then Ekind (U_Ent) /= E_Variable
2568               and then Ekind (U_Ent) /= E_Constant
2569             then
2570                Error_Msg_N ("alignment cannot be given for &", Nam);
2571
2572             elsif Duplicate_Clause then
2573                null;
2574
2575             elsif Align /= No_Uint then
2576                Set_Has_Alignment_Clause (U_Ent);
2577
2578                --  Tagged type case, check for attempt to set alignment to a
2579                --  value greater than Max_Align, and reset if so.
2580
2581                if Is_Tagged_Type (U_Ent) and then Align > Max_Align then
2582                   Error_Msg_N
2583                     ("?alignment for & set to Maximum_Aligment", Nam);
2584                      Set_Alignment (U_Ent, Max_Align);
2585
2586                --  All other cases
2587
2588                else
2589                   Set_Alignment (U_Ent, Align);
2590                end if;
2591
2592                --  For an array type, U_Ent is the first subtype. In that case,
2593                --  also set the alignment of the anonymous base type so that
2594                --  other subtypes (such as the itypes for aggregates of the
2595                --  type) also receive the expected alignment.
2596
2597                if Is_Array_Type (U_Ent) then
2598                   Set_Alignment (Base_Type (U_Ent), Align);
2599                end if;
2600             end if;
2601          end Alignment;
2602
2603          ---------------
2604          -- Bit_Order --
2605          ---------------
2606
2607          --  Bit_Order attribute definition clause
2608
2609          when Attribute_Bit_Order => Bit_Order : declare
2610          begin
2611             if not Is_Record_Type (U_Ent) then
2612                Error_Msg_N
2613                  ("Bit_Order can only be defined for record type", Nam);
2614
2615             elsif Duplicate_Clause then
2616                null;
2617
2618             else
2619                Analyze_And_Resolve (Expr, RTE (RE_Bit_Order));
2620
2621                if Etype (Expr) = Any_Type then
2622                   return;
2623
2624                elsif not Is_Static_Expression (Expr) then
2625                   Flag_Non_Static_Expr
2626                     ("Bit_Order requires static expression!", Expr);
2627
2628                else
2629                   if (Expr_Value (Expr) = 0) /= Bytes_Big_Endian then
2630                      Set_Reverse_Bit_Order (U_Ent, True);
2631                   end if;
2632                end if;
2633             end if;
2634          end Bit_Order;
2635
2636          --------------------
2637          -- Component_Size --
2638          --------------------
2639
2640          --  Component_Size attribute definition clause
2641
2642          when Attribute_Component_Size => Component_Size_Case : declare
2643             Csize    : constant Uint := Static_Integer (Expr);
2644             Ctyp     : Entity_Id;
2645             Btype    : Entity_Id;
2646             Biased   : Boolean;
2647             New_Ctyp : Entity_Id;
2648             Decl     : Node_Id;
2649
2650          begin
2651             if not Is_Array_Type (U_Ent) then
2652                Error_Msg_N ("component size requires array type", Nam);
2653                return;
2654             end if;
2655
2656             Btype := Base_Type (U_Ent);
2657             Ctyp := Component_Type (Btype);
2658
2659             if Duplicate_Clause then
2660                null;
2661
2662             elsif Rep_Item_Too_Early (Btype, N) then
2663                null;
2664
2665             elsif Csize /= No_Uint then
2666                Check_Size (Expr, Ctyp, Csize, Biased);
2667
2668                --  For the biased case, build a declaration for a subtype that
2669                --  will be used to represent the biased subtype that reflects
2670                --  the biased representation of components. We need the subtype
2671                --  to get proper conversions on referencing elements of the
2672                --  array. Note: component size clauses are ignored in VM mode.
2673
2674                if VM_Target = No_VM then
2675                   if Biased then
2676                      New_Ctyp :=
2677                        Make_Defining_Identifier (Loc,
2678                          Chars =>
2679                            New_External_Name (Chars (U_Ent), 'C', 0, 'T'));
2680
2681                      Decl :=
2682                        Make_Subtype_Declaration (Loc,
2683                          Defining_Identifier => New_Ctyp,
2684                          Subtype_Indication  =>
2685                            New_Occurrence_Of (Component_Type (Btype), Loc));
2686
2687                      Set_Parent (Decl, N);
2688                      Analyze (Decl, Suppress => All_Checks);
2689
2690                      Set_Has_Delayed_Freeze        (New_Ctyp, False);
2691                      Set_Esize                     (New_Ctyp, Csize);
2692                      Set_RM_Size                   (New_Ctyp, Csize);
2693                      Init_Alignment                (New_Ctyp);
2694                      Set_Is_Itype                  (New_Ctyp, True);
2695                      Set_Associated_Node_For_Itype (New_Ctyp, U_Ent);
2696
2697                      Set_Component_Type (Btype, New_Ctyp);
2698                      Set_Biased (New_Ctyp, N, "component size clause");
2699                   end if;
2700
2701                   Set_Component_Size (Btype, Csize);
2702
2703                --  For VM case, we ignore component size clauses
2704
2705                else
2706                   --  Give a warning unless we are in GNAT mode, in which case
2707                   --  the warning is suppressed since it is not useful.
2708
2709                   if not GNAT_Mode then
2710                      Error_Msg_N
2711                        ("?component size ignored in this configuration", N);
2712                   end if;
2713                end if;
2714
2715                --  Deal with warning on overridden size
2716
2717                if Warn_On_Overridden_Size
2718                  and then Has_Size_Clause (Ctyp)
2719                  and then RM_Size (Ctyp) /= Csize
2720                then
2721                   Error_Msg_NE
2722                     ("?component size overrides size clause for&",
2723                      N, Ctyp);
2724                end if;
2725
2726                Set_Has_Component_Size_Clause (Btype, True);
2727                Set_Has_Non_Standard_Rep (Btype, True);
2728             end if;
2729          end Component_Size_Case;
2730
2731          -----------------------
2732          -- Constant_Indexing --
2733          -----------------------
2734
2735          when Attribute_Constant_Indexing =>
2736             Check_Indexing_Functions;
2737
2738          ----------------------
2739          -- Default_Iterator --
2740          ----------------------
2741
2742          when Attribute_Default_Iterator =>  Default_Iterator : declare
2743             Func : Entity_Id;
2744
2745          begin
2746             if not Is_Tagged_Type (U_Ent) then
2747                Error_Msg_N
2748                  ("aspect Default_Iterator applies to  tagged type", Nam);
2749             end if;
2750
2751             Check_Iterator_Functions;
2752
2753             Analyze (Expr);
2754
2755             if not Is_Entity_Name (Expr)
2756               or else Ekind (Entity (Expr)) /= E_Function
2757             then
2758                Error_Msg_N ("aspect Iterator must be a function", Expr);
2759             else
2760                Func := Entity (Expr);
2761             end if;
2762
2763             if No (First_Formal (Func))
2764               or else Etype (First_Formal (Func)) /= U_Ent
2765             then
2766                Error_Msg_NE
2767                  ("Default Iterator must be a primitive of&", Func, U_Ent);
2768             end if;
2769          end Default_Iterator;
2770
2771          ------------------
2772          -- External_Tag --
2773          ------------------
2774
2775          when Attribute_External_Tag => External_Tag :
2776          begin
2777             if not Is_Tagged_Type (U_Ent) then
2778                Error_Msg_N ("should be a tagged type", Nam);
2779             end if;
2780
2781             if Duplicate_Clause then
2782                null;
2783
2784             else
2785                Analyze_And_Resolve (Expr, Standard_String);
2786
2787                if not Is_Static_Expression (Expr) then
2788                   Flag_Non_Static_Expr
2789                     ("static string required for tag name!", Nam);
2790                end if;
2791
2792                if VM_Target = No_VM then
2793                   Set_Has_External_Tag_Rep_Clause (U_Ent);
2794                else
2795                   Error_Msg_Name_1 := Attr;
2796                   Error_Msg_N
2797                     ("% attribute unsupported in this configuration", Nam);
2798                end if;
2799
2800                if not Is_Library_Level_Entity (U_Ent) then
2801                   Error_Msg_NE
2802                     ("?non-unique external tag supplied for &", N, U_Ent);
2803                   Error_Msg_N
2804                     ("?\same external tag applies to all subprogram calls", N);
2805                   Error_Msg_N
2806                     ("?\corresponding internal tag cannot be obtained", N);
2807                end if;
2808             end if;
2809          end External_Tag;
2810
2811          --------------------------
2812          -- Implicit_Dereference --
2813          --------------------------
2814
2815          when Attribute_Implicit_Dereference =>
2816
2817             --  Legality checks already performed at the point of
2818             --  the type declaration, aspect is not delayed.
2819
2820             null;
2821
2822          -----------
2823          -- Input --
2824          -----------
2825
2826          when Attribute_Input =>
2827             Analyze_Stream_TSS_Definition (TSS_Stream_Input);
2828             Set_Has_Specified_Stream_Input (Ent);
2829
2830          ----------------------
2831          -- Iterator_Element --
2832          ----------------------
2833
2834          when Attribute_Iterator_Element =>
2835             Analyze (Expr);
2836
2837             if not Is_Entity_Name (Expr)
2838               or else not Is_Type (Entity (Expr))
2839             then
2840                Error_Msg_N ("aspect Iterator_Element must be a type", Expr);
2841             end if;
2842
2843          -------------------
2844          -- Machine_Radix --
2845          -------------------
2846
2847          --  Machine radix attribute definition clause
2848
2849          when Attribute_Machine_Radix => Machine_Radix : declare
2850             Radix : constant Uint := Static_Integer (Expr);
2851
2852          begin
2853             if not Is_Decimal_Fixed_Point_Type (U_Ent) then
2854                Error_Msg_N ("decimal fixed-point type expected for &", Nam);
2855
2856             elsif Duplicate_Clause then
2857                null;
2858
2859             elsif Radix /= No_Uint then
2860                Set_Has_Machine_Radix_Clause (U_Ent);
2861                Set_Has_Non_Standard_Rep (Base_Type (U_Ent));
2862
2863                if Radix = 2 then
2864                   null;
2865                elsif Radix = 10 then
2866                   Set_Machine_Radix_10 (U_Ent);
2867                else
2868                   Error_Msg_N ("machine radix value must be 2 or 10", Expr);
2869                end if;
2870             end if;
2871          end Machine_Radix;
2872
2873          -----------------
2874          -- Object_Size --
2875          -----------------
2876
2877          --  Object_Size attribute definition clause
2878
2879          when Attribute_Object_Size => Object_Size : declare
2880             Size : constant Uint := Static_Integer (Expr);
2881
2882             Biased : Boolean;
2883             pragma Warnings (Off, Biased);
2884
2885          begin
2886             if not Is_Type (U_Ent) then
2887                Error_Msg_N ("Object_Size cannot be given for &", Nam);
2888
2889             elsif Duplicate_Clause then
2890                null;
2891
2892             else
2893                Check_Size (Expr, U_Ent, Size, Biased);
2894
2895                if Size /= 8
2896                     and then
2897                   Size /= 16
2898                     and then
2899                   Size /= 32
2900                     and then
2901                   UI_Mod (Size, 64) /= 0
2902                then
2903                   Error_Msg_N
2904                     ("Object_Size must be 8, 16, 32, or multiple of 64",
2905                      Expr);
2906                end if;
2907
2908                Set_Esize (U_Ent, Size);
2909                Set_Has_Object_Size_Clause (U_Ent);
2910                Alignment_Check_For_Size_Change (U_Ent, Size);
2911             end if;
2912          end Object_Size;
2913
2914          ------------
2915          -- Output --
2916          ------------
2917
2918          when Attribute_Output =>
2919             Analyze_Stream_TSS_Definition (TSS_Stream_Output);
2920             Set_Has_Specified_Stream_Output (Ent);
2921
2922          ----------
2923          -- Read --
2924          ----------
2925
2926          when Attribute_Read =>
2927             Analyze_Stream_TSS_Definition (TSS_Stream_Read);
2928             Set_Has_Specified_Stream_Read (Ent);
2929
2930          ----------
2931          -- Size --
2932          ----------
2933
2934          --  Size attribute definition clause
2935
2936          when Attribute_Size => Size : declare
2937             Size   : constant Uint := Static_Integer (Expr);
2938             Etyp   : Entity_Id;
2939             Biased : Boolean;
2940
2941          begin
2942             FOnly := True;
2943
2944             if Duplicate_Clause then
2945                null;
2946
2947             elsif not Is_Type (U_Ent)
2948               and then Ekind (U_Ent) /= E_Variable
2949               and then Ekind (U_Ent) /= E_Constant
2950             then
2951                Error_Msg_N ("size cannot be given for &", Nam);
2952
2953             elsif Is_Array_Type (U_Ent)
2954               and then not Is_Constrained (U_Ent)
2955             then
2956                Error_Msg_N
2957                  ("size cannot be given for unconstrained array", Nam);
2958
2959             elsif Size /= No_Uint then
2960                if VM_Target /= No_VM and then not GNAT_Mode then
2961
2962                   --  Size clause is not handled properly on VM targets.
2963                   --  Display a warning unless we are in GNAT mode, in which
2964                   --  case this is useless.
2965
2966                   Error_Msg_N
2967                     ("?size clauses are ignored in this configuration", N);
2968                end if;
2969
2970                if Is_Type (U_Ent) then
2971                   Etyp := U_Ent;
2972                else
2973                   Etyp := Etype (U_Ent);
2974                end if;
2975
2976                --  Check size, note that Gigi is in charge of checking that the
2977                --  size of an array or record type is OK. Also we do not check
2978                --  the size in the ordinary fixed-point case, since it is too
2979                --  early to do so (there may be subsequent small clause that
2980                --  affects the size). We can check the size if a small clause
2981                --  has already been given.
2982
2983                if not Is_Ordinary_Fixed_Point_Type (U_Ent)
2984                  or else Has_Small_Clause (U_Ent)
2985                then
2986                   Check_Size (Expr, Etyp, Size, Biased);
2987                   Set_Biased (U_Ent, N, "size clause", Biased);
2988                end if;
2989
2990                --  For types set RM_Size and Esize if possible
2991
2992                if Is_Type (U_Ent) then
2993                   Set_RM_Size (U_Ent, Size);
2994
2995                   --  For elementary types, increase Object_Size to power of 2,
2996                   --  but not less than a storage unit in any case (normally
2997                   --  this means it will be byte addressable).
2998
2999                   --  For all other types, nothing else to do, we leave Esize
3000                   --  (object size) unset, the back end will set it from the
3001                   --  size and alignment in an appropriate manner.
3002
3003                   --  In both cases, we check whether the alignment must be
3004                   --  reset in the wake of the size change.
3005
3006                   if Is_Elementary_Type (U_Ent) then
3007                      if Size <= System_Storage_Unit then
3008                         Init_Esize (U_Ent, System_Storage_Unit);
3009                      elsif Size <= 16 then
3010                         Init_Esize (U_Ent, 16);
3011                      elsif Size <= 32 then
3012                         Init_Esize (U_Ent, 32);
3013                      else
3014                         Set_Esize  (U_Ent, (Size + 63) / 64 * 64);
3015                      end if;
3016
3017                      Alignment_Check_For_Size_Change (U_Ent, Esize (U_Ent));
3018                   else
3019                      Alignment_Check_For_Size_Change (U_Ent, Size);
3020                   end if;
3021
3022                --  For objects, set Esize only
3023
3024                else
3025                   if Is_Elementary_Type (Etyp) then
3026                      if Size /= System_Storage_Unit
3027                           and then
3028                         Size /= System_Storage_Unit * 2
3029                           and then
3030                         Size /= System_Storage_Unit * 4
3031                            and then
3032                         Size /= System_Storage_Unit * 8
3033                      then
3034                         Error_Msg_Uint_1 := UI_From_Int (System_Storage_Unit);
3035                         Error_Msg_Uint_2 := Error_Msg_Uint_1 * 8;
3036                         Error_Msg_N
3037                           ("size for primitive object must be a power of 2"
3038                             & " in the range ^-^", N);
3039                      end if;
3040                   end if;
3041
3042                   Set_Esize (U_Ent, Size);
3043                end if;
3044
3045                Set_Has_Size_Clause (U_Ent);
3046             end if;
3047          end Size;
3048
3049          -----------
3050          -- Small --
3051          -----------
3052
3053          --  Small attribute definition clause
3054
3055          when Attribute_Small => Small : declare
3056             Implicit_Base : constant Entity_Id := Base_Type (U_Ent);
3057             Small         : Ureal;
3058
3059          begin
3060             Analyze_And_Resolve (Expr, Any_Real);
3061
3062             if Etype (Expr) = Any_Type then
3063                return;
3064
3065             elsif not Is_Static_Expression (Expr) then
3066                Flag_Non_Static_Expr
3067                  ("small requires static expression!", Expr);
3068                return;
3069
3070             else
3071                Small := Expr_Value_R (Expr);
3072
3073                if Small <= Ureal_0 then
3074                   Error_Msg_N ("small value must be greater than zero", Expr);
3075                   return;
3076                end if;
3077
3078             end if;
3079
3080             if not Is_Ordinary_Fixed_Point_Type (U_Ent) then
3081                Error_Msg_N
3082                  ("small requires an ordinary fixed point type", Nam);
3083
3084             elsif Has_Small_Clause (U_Ent) then
3085                Error_Msg_N ("small already given for &", Nam);
3086
3087             elsif Small > Delta_Value (U_Ent) then
3088                Error_Msg_N
3089                  ("small value must not be greater then delta value", Nam);
3090
3091             else
3092                Set_Small_Value (U_Ent, Small);
3093                Set_Small_Value (Implicit_Base, Small);
3094                Set_Has_Small_Clause (U_Ent);
3095                Set_Has_Small_Clause (Implicit_Base);
3096                Set_Has_Non_Standard_Rep (Implicit_Base);
3097             end if;
3098          end Small;
3099
3100          ------------------
3101          -- Storage_Pool --
3102          ------------------
3103
3104          --  Storage_Pool attribute definition clause
3105
3106          when Attribute_Storage_Pool => Storage_Pool : declare
3107             Pool : Entity_Id;
3108             T    : Entity_Id;
3109
3110          begin
3111             if Ekind (U_Ent) = E_Access_Subprogram_Type then
3112                Error_Msg_N
3113                  ("storage pool cannot be given for access-to-subprogram type",
3114                   Nam);
3115                return;
3116
3117             elsif not
3118               Ekind_In (U_Ent, E_Access_Type, E_General_Access_Type)
3119             then
3120                Error_Msg_N
3121                  ("storage pool can only be given for access types", Nam);
3122                return;
3123
3124             elsif Is_Derived_Type (U_Ent) then
3125                Error_Msg_N
3126                  ("storage pool cannot be given for a derived access type",
3127                   Nam);
3128
3129             elsif Duplicate_Clause then
3130                return;
3131
3132             elsif Present (Associated_Storage_Pool (U_Ent)) then
3133                Error_Msg_N ("storage pool already given for &", Nam);
3134                return;
3135             end if;
3136
3137             Analyze_And_Resolve
3138               (Expr, Class_Wide_Type (RTE (RE_Root_Storage_Pool)));
3139
3140             if not Denotes_Variable (Expr) then
3141                Error_Msg_N ("storage pool must be a variable", Expr);
3142                return;
3143             end if;
3144
3145             if Nkind (Expr) = N_Type_Conversion then
3146                T := Etype (Expression (Expr));
3147             else
3148                T := Etype (Expr);
3149             end if;
3150
3151             --  The Stack_Bounded_Pool is used internally for implementing
3152             --  access types with a Storage_Size. Since it only work properly
3153             --  when used on one specific type, we need to check that it is not
3154             --  hijacked improperly:
3155
3156             --    type T is access Integer;
3157             --    for T'Storage_Size use n;
3158             --    type Q is access Float;
3159             --    for Q'Storage_Size use T'Storage_Size; -- incorrect
3160
3161             if RTE_Available (RE_Stack_Bounded_Pool)
3162               and then Base_Type (T) = RTE (RE_Stack_Bounded_Pool)
3163             then
3164                Error_Msg_N ("non-shareable internal Pool", Expr);
3165                return;
3166             end if;
3167
3168             --  If the argument is a name that is not an entity name, then
3169             --  we construct a renaming operation to define an entity of
3170             --  type storage pool.
3171
3172             if not Is_Entity_Name (Expr)
3173               and then Is_Object_Reference (Expr)
3174             then
3175                Pool := Make_Temporary (Loc, 'P', Expr);
3176
3177                declare
3178                   Rnode : constant Node_Id :=
3179                             Make_Object_Renaming_Declaration (Loc,
3180                               Defining_Identifier => Pool,
3181                               Subtype_Mark        =>
3182                                 New_Occurrence_Of (Etype (Expr), Loc),
3183                               Name                => Expr);
3184
3185                begin
3186                   Insert_Before (N, Rnode);
3187                   Analyze (Rnode);
3188                   Set_Associated_Storage_Pool (U_Ent, Pool);
3189                end;
3190
3191             elsif Is_Entity_Name (Expr) then
3192                Pool := Entity (Expr);
3193
3194                --  If pool is a renamed object, get original one. This can
3195                --  happen with an explicit renaming, and within instances.
3196
3197                while Present (Renamed_Object (Pool))
3198                  and then Is_Entity_Name (Renamed_Object (Pool))
3199                loop
3200                   Pool := Entity (Renamed_Object (Pool));
3201                end loop;
3202
3203                if Present (Renamed_Object (Pool))
3204                  and then Nkind (Renamed_Object (Pool)) = N_Type_Conversion
3205                  and then Is_Entity_Name (Expression (Renamed_Object (Pool)))
3206                then
3207                   Pool := Entity (Expression (Renamed_Object (Pool)));
3208                end if;
3209
3210                Set_Associated_Storage_Pool (U_Ent, Pool);
3211
3212             elsif Nkind (Expr) = N_Type_Conversion
3213               and then Is_Entity_Name (Expression (Expr))
3214               and then Nkind (Original_Node (Expr)) = N_Attribute_Reference
3215             then
3216                Pool := Entity (Expression (Expr));
3217                Set_Associated_Storage_Pool (U_Ent, Pool);
3218
3219             else
3220                Error_Msg_N ("incorrect reference to a Storage Pool", Expr);
3221                return;
3222             end if;
3223          end Storage_Pool;
3224
3225          ------------------
3226          -- Storage_Size --
3227          ------------------
3228
3229          --  Storage_Size attribute definition clause
3230
3231          when Attribute_Storage_Size => Storage_Size : declare
3232             Btype : constant Entity_Id := Base_Type (U_Ent);
3233             Sprag : Node_Id;
3234
3235          begin
3236             if Is_Task_Type (U_Ent) then
3237                Check_Restriction (No_Obsolescent_Features, N);
3238
3239                if Warn_On_Obsolescent_Feature then
3240                   Error_Msg_N
3241                     ("storage size clause for task is an " &
3242                      "obsolescent feature (RM J.9)?", N);
3243                   Error_Msg_N ("\use Storage_Size pragma instead?", N);
3244                end if;
3245
3246                FOnly := True;
3247             end if;
3248
3249             if not Is_Access_Type (U_Ent)
3250               and then Ekind (U_Ent) /= E_Task_Type
3251             then
3252                Error_Msg_N ("storage size cannot be given for &", Nam);
3253
3254             elsif Is_Access_Type (U_Ent) and Is_Derived_Type (U_Ent) then
3255                Error_Msg_N
3256                  ("storage size cannot be given for a derived access type",
3257                   Nam);
3258
3259             elsif Duplicate_Clause then
3260                null;
3261
3262             else
3263                Analyze_And_Resolve (Expr, Any_Integer);
3264
3265                if Is_Access_Type (U_Ent) then
3266                   if Present (Associated_Storage_Pool (U_Ent)) then
3267                      Error_Msg_N ("storage pool already given for &", Nam);
3268                      return;
3269                   end if;
3270
3271                   if Is_OK_Static_Expression (Expr)
3272                     and then Expr_Value (Expr) = 0
3273                   then
3274                      Set_No_Pool_Assigned (Btype);
3275                   end if;
3276
3277                else -- Is_Task_Type (U_Ent)
3278                   Sprag := Get_Rep_Pragma (Btype, Name_Storage_Size);
3279
3280                   if Present (Sprag) then
3281                      Error_Msg_Sloc := Sloc (Sprag);
3282                      Error_Msg_N
3283                        ("Storage_Size already specified#", Nam);
3284                      return;
3285                   end if;
3286                end if;
3287
3288                Set_Has_Storage_Size_Clause (Btype);
3289             end if;
3290          end Storage_Size;
3291
3292          -----------------
3293          -- Stream_Size --
3294          -----------------
3295
3296          when Attribute_Stream_Size => Stream_Size : declare
3297             Size : constant Uint := Static_Integer (Expr);
3298
3299          begin
3300             if Ada_Version <= Ada_95 then
3301                Check_Restriction (No_Implementation_Attributes, N);
3302             end if;
3303
3304             if Duplicate_Clause then
3305                null;
3306
3307             elsif Is_Elementary_Type (U_Ent) then
3308                if Size /= System_Storage_Unit
3309                     and then
3310                   Size /= System_Storage_Unit * 2
3311                     and then
3312                   Size /= System_Storage_Unit * 4
3313                      and then
3314                   Size /= System_Storage_Unit * 8
3315                then
3316                   Error_Msg_Uint_1 := UI_From_Int (System_Storage_Unit);
3317                   Error_Msg_N
3318                     ("stream size for elementary type must be a"
3319                        & " power of 2 and at least ^", N);
3320
3321                elsif RM_Size (U_Ent) > Size then
3322                   Error_Msg_Uint_1 := RM_Size (U_Ent);
3323                   Error_Msg_N
3324                     ("stream size for elementary type must be a"
3325                        & " power of 2 and at least ^", N);
3326                end if;
3327
3328                Set_Has_Stream_Size_Clause (U_Ent);
3329
3330             else
3331                Error_Msg_N ("Stream_Size cannot be given for &", Nam);
3332             end if;
3333          end Stream_Size;
3334
3335          ----------------
3336          -- Value_Size --
3337          ----------------
3338
3339          --  Value_Size attribute definition clause
3340
3341          when Attribute_Value_Size => Value_Size : declare
3342             Size   : constant Uint := Static_Integer (Expr);
3343             Biased : Boolean;
3344
3345          begin
3346             if not Is_Type (U_Ent) then
3347                Error_Msg_N ("Value_Size cannot be given for &", Nam);
3348
3349             elsif Duplicate_Clause then
3350                null;
3351
3352             elsif Is_Array_Type (U_Ent)
3353               and then not Is_Constrained (U_Ent)
3354             then
3355                Error_Msg_N
3356                  ("Value_Size cannot be given for unconstrained array", Nam);
3357
3358             else
3359                if Is_Elementary_Type (U_Ent) then
3360                   Check_Size (Expr, U_Ent, Size, Biased);
3361                   Set_Biased (U_Ent, N, "value size clause", Biased);
3362                end if;
3363
3364                Set_RM_Size (U_Ent, Size);
3365             end if;
3366          end Value_Size;
3367
3368          -----------------------
3369          -- Variable_Indexing --
3370          -----------------------
3371
3372          when Attribute_Variable_Indexing =>
3373             Check_Indexing_Functions;
3374
3375          -----------
3376          -- Write --
3377          -----------
3378
3379          when Attribute_Write =>
3380             Analyze_Stream_TSS_Definition (TSS_Stream_Write);
3381             Set_Has_Specified_Stream_Write (Ent);
3382
3383          --  All other attributes cannot be set
3384
3385          when others =>
3386             Error_Msg_N
3387               ("attribute& cannot be set with definition clause", N);
3388       end case;
3389
3390       --  The test for the type being frozen must be performed after any
3391       --  expression the clause has been analyzed since the expression itself
3392       --  might cause freezing that makes the clause illegal.
3393
3394       if Rep_Item_Too_Late (U_Ent, N, FOnly) then
3395          return;
3396       end if;
3397    end Analyze_Attribute_Definition_Clause;
3398
3399    ----------------------------
3400    -- Analyze_Code_Statement --
3401    ----------------------------
3402
3403    procedure Analyze_Code_Statement (N : Node_Id) is
3404       HSS   : constant Node_Id   := Parent (N);
3405       SBody : constant Node_Id   := Parent (HSS);
3406       Subp  : constant Entity_Id := Current_Scope;
3407       Stmt  : Node_Id;
3408       Decl  : Node_Id;
3409       StmtO : Node_Id;
3410       DeclO : Node_Id;
3411
3412    begin
3413       --  Analyze and check we get right type, note that this implements the
3414       --  requirement (RM 13.8(1)) that Machine_Code be with'ed, since that
3415       --  is the only way that Asm_Insn could possibly be visible.
3416
3417       Analyze_And_Resolve (Expression (N));
3418
3419       if Etype (Expression (N)) = Any_Type then
3420          return;
3421       elsif Etype (Expression (N)) /= RTE (RE_Asm_Insn) then
3422          Error_Msg_N ("incorrect type for code statement", N);
3423          return;
3424       end if;
3425
3426       Check_Code_Statement (N);
3427
3428       --  Make sure we appear in the handled statement sequence of a
3429       --  subprogram (RM 13.8(3)).
3430
3431       if Nkind (HSS) /= N_Handled_Sequence_Of_Statements
3432         or else Nkind (SBody) /= N_Subprogram_Body
3433       then
3434          Error_Msg_N
3435            ("code statement can only appear in body of subprogram", N);
3436          return;
3437       end if;
3438
3439       --  Do remaining checks (RM 13.8(3)) if not already done
3440
3441       if not Is_Machine_Code_Subprogram (Subp) then
3442          Set_Is_Machine_Code_Subprogram (Subp);
3443
3444          --  No exception handlers allowed
3445
3446          if Present (Exception_Handlers (HSS)) then
3447             Error_Msg_N
3448               ("exception handlers not permitted in machine code subprogram",
3449                First (Exception_Handlers (HSS)));
3450          end if;
3451
3452          --  No declarations other than use clauses and pragmas (we allow
3453          --  certain internally generated declarations as well).
3454
3455          Decl := First (Declarations (SBody));
3456          while Present (Decl) loop
3457             DeclO := Original_Node (Decl);
3458             if Comes_From_Source (DeclO)
3459               and not Nkind_In (DeclO, N_Pragma,
3460                                        N_Use_Package_Clause,
3461                                        N_Use_Type_Clause,
3462                                        N_Implicit_Label_Declaration)
3463             then
3464                Error_Msg_N
3465                  ("this declaration not allowed in machine code subprogram",
3466                   DeclO);
3467             end if;
3468
3469             Next (Decl);
3470          end loop;
3471
3472          --  No statements other than code statements, pragmas, and labels.
3473          --  Again we allow certain internally generated statements.
3474
3475          --  In Ada 2012, qualified expressions are names, and the code
3476          --  statement is initially parsed as a procedure call.
3477
3478          Stmt := First (Statements (HSS));
3479          while Present (Stmt) loop
3480             StmtO := Original_Node (Stmt);
3481
3482             --  A procedure call transformed into a code statement is OK.
3483
3484             if Ada_Version >= Ada_2012
3485               and then Nkind (StmtO) = N_Procedure_Call_Statement
3486               and then Nkind (Name (StmtO)) = N_Qualified_Expression
3487             then
3488                null;
3489
3490             elsif Comes_From_Source (StmtO)
3491               and then not Nkind_In (StmtO, N_Pragma,
3492                                             N_Label,
3493                                             N_Code_Statement)
3494             then
3495                Error_Msg_N
3496                  ("this statement is not allowed in machine code subprogram",
3497                   StmtO);
3498             end if;
3499
3500             Next (Stmt);
3501          end loop;
3502       end if;
3503    end Analyze_Code_Statement;
3504
3505    -----------------------------------------------
3506    -- Analyze_Enumeration_Representation_Clause --
3507    -----------------------------------------------
3508
3509    procedure Analyze_Enumeration_Representation_Clause (N : Node_Id) is
3510       Ident    : constant Node_Id    := Identifier (N);
3511       Aggr     : constant Node_Id    := Array_Aggregate (N);
3512       Enumtype : Entity_Id;
3513       Elit     : Entity_Id;
3514       Expr     : Node_Id;
3515       Assoc    : Node_Id;
3516       Choice   : Node_Id;
3517       Val      : Uint;
3518
3519       Err : Boolean := False;
3520       --  Set True to avoid cascade errors and crashes on incorrect source code
3521
3522       Lo : constant Uint := Expr_Value (Type_Low_Bound (Universal_Integer));
3523       Hi : constant Uint := Expr_Value (Type_High_Bound (Universal_Integer));
3524       --  Allowed range of universal integer (= allowed range of enum lit vals)
3525
3526       Min : Uint;
3527       Max : Uint;
3528       --  Minimum and maximum values of entries
3529
3530       Max_Node : Node_Id;
3531       --  Pointer to node for literal providing max value
3532
3533    begin
3534       if Ignore_Rep_Clauses then
3535          return;
3536       end if;
3537
3538       --  First some basic error checks
3539
3540       Find_Type (Ident);
3541       Enumtype := Entity (Ident);
3542
3543       if Enumtype = Any_Type
3544         or else Rep_Item_Too_Early (Enumtype, N)
3545       then
3546          return;
3547       else
3548          Enumtype := Underlying_Type (Enumtype);
3549       end if;
3550
3551       if not Is_Enumeration_Type (Enumtype) then
3552          Error_Msg_NE
3553            ("enumeration type required, found}",
3554             Ident, First_Subtype (Enumtype));
3555          return;
3556       end if;
3557
3558       --  Ignore rep clause on generic actual type. This will already have
3559       --  been flagged on the template as an error, and this is the safest
3560       --  way to ensure we don't get a junk cascaded message in the instance.
3561
3562       if Is_Generic_Actual_Type (Enumtype) then
3563          return;
3564
3565       --  Type must be in current scope
3566
3567       elsif Scope (Enumtype) /= Current_Scope then
3568          Error_Msg_N ("type must be declared in this scope", Ident);
3569          return;
3570
3571       --  Type must be a first subtype
3572
3573       elsif not Is_First_Subtype (Enumtype) then
3574          Error_Msg_N ("cannot give enumeration rep clause for subtype", N);
3575          return;
3576
3577       --  Ignore duplicate rep clause
3578
3579       elsif Has_Enumeration_Rep_Clause (Enumtype) then
3580          Error_Msg_N ("duplicate enumeration rep clause ignored", N);
3581          return;
3582
3583       --  Don't allow rep clause for standard [wide_[wide_]]character
3584
3585       elsif Is_Standard_Character_Type (Enumtype) then
3586          Error_Msg_N ("enumeration rep clause not allowed for this type", N);
3587          return;
3588
3589       --  Check that the expression is a proper aggregate (no parentheses)
3590
3591       elsif Paren_Count (Aggr) /= 0 then
3592          Error_Msg
3593            ("extra parentheses surrounding aggregate not allowed",
3594             First_Sloc (Aggr));
3595          return;
3596
3597       --  All tests passed, so set rep clause in place
3598
3599       else
3600          Set_Has_Enumeration_Rep_Clause (Enumtype);
3601          Set_Has_Enumeration_Rep_Clause (Base_Type (Enumtype));
3602       end if;
3603
3604       --  Now we process the aggregate. Note that we don't use the normal
3605       --  aggregate code for this purpose, because we don't want any of the
3606       --  normal expansion activities, and a number of special semantic
3607       --  rules apply (including the component type being any integer type)
3608
3609       Elit := First_Literal (Enumtype);
3610
3611       --  First the positional entries if any
3612
3613       if Present (Expressions (Aggr)) then
3614          Expr := First (Expressions (Aggr));
3615          while Present (Expr) loop
3616             if No (Elit) then
3617                Error_Msg_N ("too many entries in aggregate", Expr);
3618                return;
3619             end if;
3620
3621             Val := Static_Integer (Expr);
3622
3623             --  Err signals that we found some incorrect entries processing
3624             --  the list. The final checks for completeness and ordering are
3625             --  skipped in this case.
3626
3627             if Val = No_Uint then
3628                Err := True;
3629             elsif Val < Lo or else Hi < Val then
3630                Error_Msg_N ("value outside permitted range", Expr);
3631                Err := True;
3632             end if;
3633
3634             Set_Enumeration_Rep (Elit, Val);
3635             Set_Enumeration_Rep_Expr (Elit, Expr);
3636             Next (Expr);
3637             Next (Elit);
3638          end loop;
3639       end if;
3640
3641       --  Now process the named entries if present
3642
3643       if Present (Component_Associations (Aggr)) then
3644          Assoc := First (Component_Associations (Aggr));
3645          while Present (Assoc) loop
3646             Choice := First (Choices (Assoc));
3647
3648             if Present (Next (Choice)) then
3649                Error_Msg_N
3650                  ("multiple choice not allowed here", Next (Choice));
3651                Err := True;
3652             end if;
3653
3654             if Nkind (Choice) = N_Others_Choice then
3655                Error_Msg_N ("others choice not allowed here", Choice);
3656                Err := True;
3657
3658             elsif Nkind (Choice) = N_Range then
3659
3660                --  ??? should allow zero/one element range here
3661
3662                Error_Msg_N ("range not allowed here", Choice);
3663                Err := True;
3664
3665             else
3666                Analyze_And_Resolve (Choice, Enumtype);
3667
3668                if Error_Posted (Choice) then
3669                   Err := True;
3670                end if;
3671
3672                if not Err then
3673                   if Is_Entity_Name (Choice)
3674                     and then Is_Type (Entity (Choice))
3675                   then
3676                      Error_Msg_N ("subtype name not allowed here", Choice);
3677                      Err := True;
3678
3679                      --  ??? should allow static subtype with zero/one entry
3680
3681                   elsif Etype (Choice) = Base_Type (Enumtype) then
3682                      if not Is_Static_Expression (Choice) then
3683                         Flag_Non_Static_Expr
3684                           ("non-static expression used for choice!", Choice);
3685                         Err := True;
3686
3687                      else
3688                         Elit := Expr_Value_E (Choice);
3689
3690                         if Present (Enumeration_Rep_Expr (Elit)) then
3691                            Error_Msg_Sloc :=
3692                              Sloc (Enumeration_Rep_Expr (Elit));
3693                            Error_Msg_NE
3694                              ("representation for& previously given#",
3695                               Choice, Elit);
3696                            Err := True;
3697                         end if;
3698
3699                         Set_Enumeration_Rep_Expr (Elit, Expression (Assoc));
3700
3701                         Expr := Expression (Assoc);
3702                         Val := Static_Integer (Expr);
3703
3704                         if Val = No_Uint then
3705                            Err := True;
3706
3707                         elsif Val < Lo or else Hi < Val then
3708                            Error_Msg_N ("value outside permitted range", Expr);
3709                            Err := True;
3710                         end if;
3711
3712                         Set_Enumeration_Rep (Elit, Val);
3713                      end if;
3714                   end if;
3715                end if;
3716             end if;
3717
3718             Next (Assoc);
3719          end loop;
3720       end if;
3721
3722       --  Aggregate is fully processed. Now we check that a full set of
3723       --  representations was given, and that they are in range and in order.
3724       --  These checks are only done if no other errors occurred.
3725
3726       if not Err then
3727          Min  := No_Uint;
3728          Max  := No_Uint;
3729
3730          Elit := First_Literal (Enumtype);
3731          while Present (Elit) loop
3732             if No (Enumeration_Rep_Expr (Elit)) then
3733                Error_Msg_NE ("missing representation for&!", N, Elit);
3734
3735             else
3736                Val := Enumeration_Rep (Elit);
3737
3738                if Min = No_Uint then
3739                   Min := Val;
3740                end if;
3741
3742                if Val /= No_Uint then
3743                   if Max /= No_Uint and then Val <= Max then
3744                      Error_Msg_NE
3745                        ("enumeration value for& not ordered!",
3746                         Enumeration_Rep_Expr (Elit), Elit);
3747                   end if;
3748
3749                   Max_Node := Enumeration_Rep_Expr (Elit);
3750                   Max := Val;
3751                end if;
3752
3753                --  If there is at least one literal whose representation is not
3754                --  equal to the Pos value, then note that this enumeration type
3755                --  has a non-standard representation.
3756
3757                if Val /= Enumeration_Pos (Elit) then
3758                   Set_Has_Non_Standard_Rep (Base_Type (Enumtype));
3759                end if;
3760             end if;
3761
3762             Next (Elit);
3763          end loop;
3764
3765          --  Now set proper size information
3766
3767          declare
3768             Minsize : Uint := UI_From_Int (Minimum_Size (Enumtype));
3769
3770          begin
3771             if Has_Size_Clause (Enumtype) then
3772
3773                --  All OK, if size is OK now
3774
3775                if RM_Size (Enumtype) >= Minsize then
3776                   null;
3777
3778                else
3779                   --  Try if we can get by with biasing
3780
3781                   Minsize :=
3782                     UI_From_Int (Minimum_Size (Enumtype, Biased => True));
3783
3784                   --  Error message if even biasing does not work
3785
3786                   if RM_Size (Enumtype) < Minsize then
3787                      Error_Msg_Uint_1 := RM_Size (Enumtype);
3788                      Error_Msg_Uint_2 := Max;
3789                      Error_Msg_N
3790                        ("previously given size (^) is too small "
3791                         & "for this value (^)", Max_Node);
3792
3793                   --  If biasing worked, indicate that we now have biased rep
3794
3795                   else
3796                      Set_Biased
3797                        (Enumtype, Size_Clause (Enumtype), "size clause");
3798                   end if;
3799                end if;
3800
3801             else
3802                Set_RM_Size    (Enumtype, Minsize);
3803                Set_Enum_Esize (Enumtype);
3804             end if;
3805
3806             Set_RM_Size   (Base_Type (Enumtype), RM_Size   (Enumtype));
3807             Set_Esize     (Base_Type (Enumtype), Esize     (Enumtype));
3808             Set_Alignment (Base_Type (Enumtype), Alignment (Enumtype));
3809          end;
3810       end if;
3811
3812       --  We repeat the too late test in case it froze itself!
3813
3814       if Rep_Item_Too_Late (Enumtype, N) then
3815          null;
3816       end if;
3817    end Analyze_Enumeration_Representation_Clause;
3818
3819    ----------------------------
3820    -- Analyze_Free_Statement --
3821    ----------------------------
3822
3823    procedure Analyze_Free_Statement (N : Node_Id) is
3824    begin
3825       Analyze (Expression (N));
3826    end Analyze_Free_Statement;
3827
3828    ---------------------------
3829    -- Analyze_Freeze_Entity --
3830    ---------------------------
3831
3832    procedure Analyze_Freeze_Entity (N : Node_Id) is
3833       E : constant Entity_Id := Entity (N);
3834
3835    begin
3836       --  Remember that we are processing a freezing entity. Required to
3837       --  ensure correct decoration of internal entities associated with
3838       --  interfaces (see New_Overloaded_Entity).
3839
3840       Inside_Freezing_Actions := Inside_Freezing_Actions + 1;
3841
3842       --  For tagged types covering interfaces add internal entities that link
3843       --  the primitives of the interfaces with the primitives that cover them.
3844       --  Note: These entities were originally generated only when generating
3845       --  code because their main purpose was to provide support to initialize
3846       --  the secondary dispatch tables. They are now generated also when
3847       --  compiling with no code generation to provide ASIS the relationship
3848       --  between interface primitives and tagged type primitives. They are
3849       --  also used to locate primitives covering interfaces when processing
3850       --  generics (see Derive_Subprograms).
3851
3852       if Ada_Version >= Ada_2005
3853         and then Ekind (E) = E_Record_Type
3854         and then Is_Tagged_Type (E)
3855         and then not Is_Interface (E)
3856         and then Has_Interfaces (E)
3857       then
3858          --  This would be a good common place to call the routine that checks
3859          --  overriding of interface primitives (and thus factorize calls to
3860          --  Check_Abstract_Overriding located at different contexts in the
3861          --  compiler). However, this is not possible because it causes
3862          --  spurious errors in case of late overriding.
3863
3864          Add_Internal_Interface_Entities (E);
3865       end if;
3866
3867       --  Check CPP types
3868
3869       if Ekind (E) = E_Record_Type
3870         and then Is_CPP_Class (E)
3871         and then Is_Tagged_Type (E)
3872         and then Tagged_Type_Expansion
3873         and then Expander_Active
3874       then
3875          if CPP_Num_Prims (E) = 0 then
3876
3877             --  If the CPP type has user defined components then it must import
3878             --  primitives from C++. This is required because if the C++ class
3879             --  has no primitives then the C++ compiler does not added the _tag
3880             --  component to the type.
3881
3882             pragma Assert (Chars (First_Entity (E)) = Name_uTag);
3883
3884             if First_Entity (E) /= Last_Entity (E) then
3885                Error_Msg_N
3886                  ("?'C'P'P type must import at least one primitive from C++",
3887                   E);
3888             end if;
3889          end if;
3890
3891          --  Check that all its primitives are abstract or imported from C++.
3892          --  Check also availability of the C++ constructor.
3893
3894          declare
3895             Has_Constructors : constant Boolean := Has_CPP_Constructors (E);
3896             Elmt             : Elmt_Id;
3897             Error_Reported   : Boolean := False;
3898             Prim             : Node_Id;
3899
3900          begin
3901             Elmt := First_Elmt (Primitive_Operations (E));
3902             while Present (Elmt) loop
3903                Prim := Node (Elmt);
3904
3905                if Comes_From_Source (Prim) then
3906                   if Is_Abstract_Subprogram (Prim) then
3907                      null;
3908
3909                   elsif not Is_Imported (Prim)
3910                     or else Convention (Prim) /= Convention_CPP
3911                   then
3912                      Error_Msg_N
3913                        ("?primitives of 'C'P'P types must be imported from C++"
3914                         & " or abstract", Prim);
3915
3916                   elsif not Has_Constructors
3917                      and then not Error_Reported
3918                   then
3919                      Error_Msg_Name_1 := Chars (E);
3920                      Error_Msg_N
3921                        ("?'C'P'P constructor required for type %", Prim);
3922                      Error_Reported := True;
3923                   end if;
3924                end if;
3925
3926                Next_Elmt (Elmt);
3927             end loop;
3928          end;
3929       end if;
3930
3931       Inside_Freezing_Actions := Inside_Freezing_Actions - 1;
3932
3933       --  If we have a type with predicates, build predicate function
3934
3935       if Is_Type (E) and then Has_Predicates (E) then
3936          Build_Predicate_Function (E, N);
3937       end if;
3938
3939       --  If type has delayed aspects, this is where we do the preanalysis at
3940       --  the freeze point, as part of the consistent visibility check. Note
3941       --  that this must be done after calling Build_Predicate_Function or
3942       --  Build_Invariant_Procedure since these subprograms fix occurrences of
3943       --  the subtype name in the saved expression so that they will not cause
3944       --  trouble in the preanalysis.
3945
3946       if Has_Delayed_Aspects (E) then
3947          declare
3948             Ritem : Node_Id;
3949
3950          begin
3951             --  Look for aspect specification entries for this entity
3952
3953             Ritem := First_Rep_Item (E);
3954             while Present (Ritem) loop
3955                if Nkind (Ritem) = N_Aspect_Specification
3956                  and then Entity (Ritem) = E
3957                  and then Is_Delayed_Aspect (Ritem)
3958                  and then Scope (E) = Current_Scope
3959                then
3960                   Check_Aspect_At_Freeze_Point (Ritem);
3961                end if;
3962
3963                Next_Rep_Item (Ritem);
3964             end loop;
3965          end;
3966       end if;
3967    end Analyze_Freeze_Entity;
3968
3969    ------------------------------------------
3970    -- Analyze_Record_Representation_Clause --
3971    ------------------------------------------
3972
3973    --  Note: we check as much as we can here, but we can't do any checks
3974    --  based on the position values (e.g. overlap checks) until freeze time
3975    --  because especially in Ada 2005 (machine scalar mode), the processing
3976    --  for non-standard bit order can substantially change the positions.
3977    --  See procedure Check_Record_Representation_Clause (called from Freeze)
3978    --  for the remainder of this processing.
3979
3980    procedure Analyze_Record_Representation_Clause (N : Node_Id) is
3981       Ident   : constant Node_Id := Identifier (N);
3982       Biased  : Boolean;
3983       CC      : Node_Id;
3984       Comp    : Entity_Id;
3985       Fbit    : Uint;
3986       Hbit    : Uint := Uint_0;
3987       Lbit    : Uint;
3988       Ocomp   : Entity_Id;
3989       Posit   : Uint;
3990       Rectype : Entity_Id;
3991
3992       CR_Pragma : Node_Id := Empty;
3993       --  Points to N_Pragma node if Complete_Representation pragma present
3994
3995    begin
3996       if Ignore_Rep_Clauses then
3997          return;
3998       end if;
3999
4000       Find_Type (Ident);
4001       Rectype := Entity (Ident);
4002
4003       if Rectype = Any_Type
4004         or else Rep_Item_Too_Early (Rectype, N)
4005       then
4006          return;
4007       else
4008          Rectype := Underlying_Type (Rectype);
4009       end if;
4010
4011       --  First some basic error checks
4012
4013       if not Is_Record_Type (Rectype) then
4014          Error_Msg_NE
4015            ("record type required, found}", Ident, First_Subtype (Rectype));
4016          return;
4017
4018       elsif Scope (Rectype) /= Current_Scope then
4019          Error_Msg_N ("type must be declared in this scope", N);
4020          return;
4021
4022       elsif not Is_First_Subtype (Rectype) then
4023          Error_Msg_N ("cannot give record rep clause for subtype", N);
4024          return;
4025
4026       elsif Has_Record_Rep_Clause (Rectype) then
4027          Error_Msg_N ("duplicate record rep clause ignored", N);
4028          return;
4029
4030       elsif Rep_Item_Too_Late (Rectype, N) then
4031          return;
4032       end if;
4033
4034       if Present (Mod_Clause (N)) then
4035          declare
4036             Loc     : constant Source_Ptr := Sloc (N);
4037             M       : constant Node_Id := Mod_Clause (N);
4038             P       : constant List_Id := Pragmas_Before (M);
4039             AtM_Nod : Node_Id;
4040
4041             Mod_Val : Uint;
4042             pragma Warnings (Off, Mod_Val);
4043
4044          begin
4045             Check_Restriction (No_Obsolescent_Features, Mod_Clause (N));
4046
4047             if Warn_On_Obsolescent_Feature then
4048                Error_Msg_N
4049                  ("mod clause is an obsolescent feature (RM J.8)?", N);
4050                Error_Msg_N
4051                  ("\use alignment attribute definition clause instead?", N);
4052             end if;
4053
4054             if Present (P) then
4055                Analyze_List (P);
4056             end if;
4057
4058             --  In ASIS_Mode mode, expansion is disabled, but we must convert
4059             --  the Mod clause into an alignment clause anyway, so that the
4060             --  back-end can compute and back-annotate properly the size and
4061             --  alignment of types that may include this record.
4062
4063             --  This seems dubious, this destroys the source tree in a manner
4064             --  not detectable by ASIS ???
4065
4066             if Operating_Mode = Check_Semantics and then ASIS_Mode then
4067                AtM_Nod :=
4068                  Make_Attribute_Definition_Clause (Loc,
4069                    Name       => New_Reference_To (Base_Type (Rectype), Loc),
4070                    Chars      => Name_Alignment,
4071                    Expression => Relocate_Node (Expression (M)));
4072
4073                Set_From_At_Mod (AtM_Nod);
4074                Insert_After (N, AtM_Nod);
4075                Mod_Val := Get_Alignment_Value (Expression (AtM_Nod));
4076                Set_Mod_Clause (N, Empty);
4077
4078             else
4079                --  Get the alignment value to perform error checking
4080
4081                Mod_Val := Get_Alignment_Value (Expression (M));
4082             end if;
4083          end;
4084       end if;
4085
4086       --  For untagged types, clear any existing component clauses for the
4087       --  type. If the type is derived, this is what allows us to override
4088       --  a rep clause for the parent. For type extensions, the representation
4089       --  of the inherited components is inherited, so we want to keep previous
4090       --  component clauses for completeness.
4091
4092       if not Is_Tagged_Type (Rectype) then
4093          Comp := First_Component_Or_Discriminant (Rectype);
4094          while Present (Comp) loop
4095             Set_Component_Clause (Comp, Empty);
4096             Next_Component_Or_Discriminant (Comp);
4097          end loop;
4098       end if;
4099
4100       --  All done if no component clauses
4101
4102       CC := First (Component_Clauses (N));
4103
4104       if No (CC) then
4105          return;
4106       end if;
4107
4108       --  A representation like this applies to the base type
4109
4110       Set_Has_Record_Rep_Clause (Base_Type (Rectype));
4111       Set_Has_Non_Standard_Rep  (Base_Type (Rectype));
4112       Set_Has_Specified_Layout  (Base_Type (Rectype));
4113
4114       --  Process the component clauses
4115
4116       while Present (CC) loop
4117
4118          --  Pragma
4119
4120          if Nkind (CC) = N_Pragma then
4121             Analyze (CC);
4122
4123             --  The only pragma of interest is Complete_Representation
4124
4125             if Pragma_Name (CC) = Name_Complete_Representation then
4126                CR_Pragma := CC;
4127             end if;
4128
4129          --  Processing for real component clause
4130
4131          else
4132             Posit := Static_Integer (Position  (CC));
4133             Fbit  := Static_Integer (First_Bit (CC));
4134             Lbit  := Static_Integer (Last_Bit  (CC));
4135
4136             if Posit /= No_Uint
4137               and then Fbit /= No_Uint
4138               and then Lbit /= No_Uint
4139             then
4140                if Posit < 0 then
4141                   Error_Msg_N
4142                     ("position cannot be negative", Position (CC));
4143
4144                elsif Fbit < 0 then
4145                   Error_Msg_N
4146                     ("first bit cannot be negative", First_Bit (CC));
4147
4148                --  The Last_Bit specified in a component clause must not be
4149                --  less than the First_Bit minus one (RM-13.5.1(10)).
4150
4151                elsif Lbit < Fbit - 1 then
4152                   Error_Msg_N
4153                     ("last bit cannot be less than first bit minus one",
4154                      Last_Bit (CC));
4155
4156                --  Values look OK, so find the corresponding record component
4157                --  Even though the syntax allows an attribute reference for
4158                --  implementation-defined components, GNAT does not allow the
4159                --  tag to get an explicit position.
4160
4161                elsif Nkind (Component_Name (CC)) = N_Attribute_Reference then
4162                   if Attribute_Name (Component_Name (CC)) = Name_Tag then
4163                      Error_Msg_N ("position of tag cannot be specified", CC);
4164                   else
4165                      Error_Msg_N ("illegal component name", CC);
4166                   end if;
4167
4168                else
4169                   Comp := First_Entity (Rectype);
4170                   while Present (Comp) loop
4171                      exit when Chars (Comp) = Chars (Component_Name (CC));
4172                      Next_Entity (Comp);
4173                   end loop;
4174
4175                   if No (Comp) then
4176
4177                      --  Maybe component of base type that is absent from
4178                      --  statically constrained first subtype.
4179
4180                      Comp := First_Entity (Base_Type (Rectype));
4181                      while Present (Comp) loop
4182                         exit when Chars (Comp) = Chars (Component_Name (CC));
4183                         Next_Entity (Comp);
4184                      end loop;
4185                   end if;
4186
4187                   if No (Comp) then
4188                      Error_Msg_N
4189                        ("component clause is for non-existent field", CC);
4190
4191                   --  Ada 2012 (AI05-0026): Any name that denotes a
4192                   --  discriminant of an object of an unchecked union type
4193                   --  shall not occur within a record_representation_clause.
4194
4195                   --  The general restriction of using record rep clauses on
4196                   --  Unchecked_Union types has now been lifted. Since it is
4197                   --  possible to introduce a record rep clause which mentions
4198                   --  the discriminant of an Unchecked_Union in non-Ada 2012
4199                   --  code, this check is applied to all versions of the
4200                   --  language.
4201
4202                   elsif Ekind (Comp) = E_Discriminant
4203                     and then Is_Unchecked_Union (Rectype)
4204                   then
4205                      Error_Msg_N
4206                        ("cannot reference discriminant of Unchecked_Union",
4207                         Component_Name (CC));
4208
4209                   elsif Present (Component_Clause (Comp)) then
4210
4211                      --  Diagnose duplicate rep clause, or check consistency
4212                      --  if this is an inherited component. In a double fault,
4213                      --  there may be a duplicate inconsistent clause for an
4214                      --  inherited component.
4215
4216                      if Scope (Original_Record_Component (Comp)) = Rectype
4217                        or else Parent (Component_Clause (Comp)) = N
4218                      then
4219                         Error_Msg_Sloc := Sloc (Component_Clause (Comp));
4220                         Error_Msg_N ("component clause previously given#", CC);
4221
4222                      else
4223                         declare
4224                            Rep1 : constant Node_Id := Component_Clause (Comp);
4225                         begin
4226                            if Intval (Position (Rep1)) /=
4227                                                    Intval (Position (CC))
4228                              or else Intval (First_Bit (Rep1)) /=
4229                                                    Intval (First_Bit (CC))
4230                              or else Intval (Last_Bit (Rep1)) /=
4231                                                    Intval (Last_Bit (CC))
4232                            then
4233                               Error_Msg_N ("component clause inconsistent "
4234                                 & "with representation of ancestor", CC);
4235                            elsif Warn_On_Redundant_Constructs then
4236                               Error_Msg_N ("?redundant component clause "
4237                                 & "for inherited component!", CC);
4238                            end if;
4239                         end;
4240                      end if;
4241
4242                   --  Normal case where this is the first component clause we
4243                   --  have seen for this entity, so set it up properly.
4244
4245                   else
4246                      --  Make reference for field in record rep clause and set
4247                      --  appropriate entity field in the field identifier.
4248
4249                      Generate_Reference
4250                        (Comp, Component_Name (CC), Set_Ref => False);
4251                      Set_Entity (Component_Name (CC), Comp);
4252
4253                      --  Update Fbit and Lbit to the actual bit number
4254
4255                      Fbit := Fbit + UI_From_Int (SSU) * Posit;
4256                      Lbit := Lbit + UI_From_Int (SSU) * Posit;
4257
4258                      if Has_Size_Clause (Rectype)
4259                        and then RM_Size (Rectype) <= Lbit
4260                      then
4261                         Error_Msg_N
4262                           ("bit number out of range of specified size",
4263                            Last_Bit (CC));
4264                      else
4265                         Set_Component_Clause     (Comp, CC);
4266                         Set_Component_Bit_Offset (Comp, Fbit);
4267                         Set_Esize                (Comp, 1 + (Lbit - Fbit));
4268                         Set_Normalized_First_Bit (Comp, Fbit mod SSU);
4269                         Set_Normalized_Position  (Comp, Fbit / SSU);
4270
4271                         if Warn_On_Overridden_Size
4272                           and then Has_Size_Clause (Etype (Comp))
4273                           and then RM_Size (Etype (Comp)) /= Esize (Comp)
4274                         then
4275                            Error_Msg_NE
4276                              ("?component size overrides size clause for&",
4277                               Component_Name (CC), Etype (Comp));
4278                         end if;
4279
4280                         --  This information is also set in the corresponding
4281                         --  component of the base type, found by accessing the
4282                         --  Original_Record_Component link if it is present.
4283
4284                         Ocomp := Original_Record_Component (Comp);
4285
4286                         if Hbit < Lbit then
4287                            Hbit := Lbit;
4288                         end if;
4289
4290                         Check_Size
4291                           (Component_Name (CC),
4292                            Etype (Comp),
4293                            Esize (Comp),
4294                            Biased);
4295
4296                         Set_Biased
4297                           (Comp, First_Node (CC), "component clause", Biased);
4298
4299                         if Present (Ocomp) then
4300                            Set_Component_Clause     (Ocomp, CC);
4301                            Set_Component_Bit_Offset (Ocomp, Fbit);
4302                            Set_Normalized_First_Bit (Ocomp, Fbit mod SSU);
4303                            Set_Normalized_Position  (Ocomp, Fbit / SSU);
4304                            Set_Esize                (Ocomp, 1 + (Lbit - Fbit));
4305
4306                            Set_Normalized_Position_Max
4307                              (Ocomp, Normalized_Position (Ocomp));
4308
4309                            --  Note: we don't use Set_Biased here, because we
4310                            --  already gave a warning above if needed, and we
4311                            --  would get a duplicate for the same name here.
4312
4313                            Set_Has_Biased_Representation
4314                              (Ocomp, Has_Biased_Representation (Comp));
4315                         end if;
4316
4317                         if Esize (Comp) < 0 then
4318                            Error_Msg_N ("component size is negative", CC);
4319                         end if;
4320                      end if;
4321                   end if;
4322                end if;
4323             end if;
4324          end if;
4325
4326          Next (CC);
4327       end loop;
4328
4329       --  Check missing components if Complete_Representation pragma appeared
4330
4331       if Present (CR_Pragma) then
4332          Comp := First_Component_Or_Discriminant (Rectype);
4333          while Present (Comp) loop
4334             if No (Component_Clause (Comp)) then
4335                Error_Msg_NE
4336                  ("missing component clause for &", CR_Pragma, Comp);
4337             end if;
4338
4339             Next_Component_Or_Discriminant (Comp);
4340          end loop;
4341
4342          --  If no Complete_Representation pragma, warn if missing components
4343
4344       elsif Warn_On_Unrepped_Components then
4345          declare
4346             Num_Repped_Components   : Nat := 0;
4347             Num_Unrepped_Components : Nat := 0;
4348
4349          begin
4350             --  First count number of repped and unrepped components
4351
4352             Comp := First_Component_Or_Discriminant (Rectype);
4353             while Present (Comp) loop
4354                if Present (Component_Clause (Comp)) then
4355                   Num_Repped_Components := Num_Repped_Components + 1;
4356                else
4357                   Num_Unrepped_Components := Num_Unrepped_Components + 1;
4358                end if;
4359
4360                Next_Component_Or_Discriminant (Comp);
4361             end loop;
4362
4363             --  We are only interested in the case where there is at least one
4364             --  unrepped component, and at least half the components have rep
4365             --  clauses. We figure that if less than half have them, then the
4366             --  partial rep clause is really intentional. If the component
4367             --  type has no underlying type set at this point (as for a generic
4368             --  formal type), we don't know enough to give a warning on the
4369             --  component.
4370
4371             if Num_Unrepped_Components > 0
4372               and then Num_Unrepped_Components < Num_Repped_Components
4373             then
4374                Comp := First_Component_Or_Discriminant (Rectype);
4375                while Present (Comp) loop
4376                   if No (Component_Clause (Comp))
4377                     and then Comes_From_Source (Comp)
4378                     and then Present (Underlying_Type (Etype (Comp)))
4379                     and then (Is_Scalar_Type (Underlying_Type (Etype (Comp)))
4380                                or else Size_Known_At_Compile_Time
4381                                          (Underlying_Type (Etype (Comp))))
4382                     and then not Has_Warnings_Off (Rectype)
4383                   then
4384                      Error_Msg_Sloc := Sloc (Comp);
4385                      Error_Msg_NE
4386                        ("?no component clause given for & declared #",
4387                         N, Comp);
4388                   end if;
4389
4390                   Next_Component_Or_Discriminant (Comp);
4391                end loop;
4392             end if;
4393          end;
4394       end if;
4395    end Analyze_Record_Representation_Clause;
4396
4397    -------------------------------
4398    -- Build_Invariant_Procedure --
4399    -------------------------------
4400
4401    --  The procedure that is constructed here has the form
4402
4403    --  procedure typInvariant (Ixxx : typ) is
4404    --  begin
4405    --     pragma Check (Invariant, exp, "failed invariant from xxx");
4406    --     pragma Check (Invariant, exp, "failed invariant from xxx");
4407    --     ...
4408    --     pragma Check (Invariant, exp, "failed inherited invariant from xxx");
4409    --     ...
4410    --  end typInvariant;
4411
4412    procedure Build_Invariant_Procedure (Typ : Entity_Id; N : Node_Id) is
4413       Loc   : constant Source_Ptr := Sloc (Typ);
4414       Stmts : List_Id;
4415       Spec  : Node_Id;
4416       SId   : Entity_Id;
4417       PDecl : Node_Id;
4418       PBody : Node_Id;
4419
4420       Visible_Decls : constant List_Id := Visible_Declarations (N);
4421       Private_Decls : constant List_Id := Private_Declarations (N);
4422
4423       procedure Add_Invariants (T : Entity_Id; Inherit : Boolean);
4424       --  Appends statements to Stmts for any invariants in the rep item chain
4425       --  of the given type. If Inherit is False, then we only process entries
4426       --  on the chain for the type Typ. If Inherit is True, then we ignore any
4427       --  Invariant aspects, but we process all Invariant'Class aspects, adding
4428       --  "inherited" to the exception message and generating an informational
4429       --  message about the inheritance of an invariant.
4430
4431       Object_Name : constant Name_Id := New_Internal_Name ('I');
4432       --  Name for argument of invariant procedure
4433
4434       Object_Entity : constant Node_Id :=
4435                         Make_Defining_Identifier (Loc, Object_Name);
4436       --  The procedure declaration entity for the argument
4437
4438       --------------------
4439       -- Add_Invariants --
4440       --------------------
4441
4442       procedure Add_Invariants (T : Entity_Id; Inherit : Boolean) is
4443          Ritem : Node_Id;
4444          Arg1  : Node_Id;
4445          Arg2  : Node_Id;
4446          Arg3  : Node_Id;
4447          Exp   : Node_Id;
4448          Loc   : Source_Ptr;
4449          Assoc : List_Id;
4450          Str   : String_Id;
4451
4452          procedure Replace_Type_Reference (N : Node_Id);
4453          --  Replace a single occurrence N of the subtype name with a reference
4454          --  to the formal of the predicate function. N can be an identifier
4455          --  referencing the subtype, or a selected component, representing an
4456          --  appropriately qualified occurrence of the subtype name.
4457
4458          procedure Replace_Type_References is
4459            new Replace_Type_References_Generic (Replace_Type_Reference);
4460          --  Traverse an expression replacing all occurrences of the subtype
4461          --  name with appropriate references to the object that is the formal
4462          --  parameter of the predicate function. Note that we must ensure
4463          --  that the type and entity information is properly set in the
4464          --  replacement node, since we will do a Preanalyze call of this
4465          --  expression without proper visibility of the procedure argument.
4466
4467          ----------------------------
4468          -- Replace_Type_Reference --
4469          ----------------------------
4470
4471          procedure Replace_Type_Reference (N : Node_Id) is
4472          begin
4473             --  Invariant'Class, replace with T'Class (obj)
4474
4475             if Class_Present (Ritem) then
4476                Rewrite (N,
4477                  Make_Type_Conversion (Loc,
4478                    Subtype_Mark =>
4479                      Make_Attribute_Reference (Loc,
4480                        Prefix         => New_Occurrence_Of (T, Loc),
4481                        Attribute_Name => Name_Class),
4482                    Expression   => Make_Identifier (Loc, Object_Name)));
4483
4484                Set_Entity (Expression (N), Object_Entity);
4485                Set_Etype  (Expression (N), Typ);
4486
4487             --  Invariant, replace with obj
4488
4489             else
4490                Rewrite (N, Make_Identifier (Loc, Object_Name));
4491                Set_Entity (N, Object_Entity);
4492                Set_Etype  (N, Typ);
4493             end if;
4494          end Replace_Type_Reference;
4495
4496       --  Start of processing for Add_Invariants
4497
4498       begin
4499          Ritem := First_Rep_Item (T);
4500          while Present (Ritem) loop
4501             if Nkind (Ritem) = N_Pragma
4502               and then Pragma_Name (Ritem) = Name_Invariant
4503             then
4504                Arg1 := First (Pragma_Argument_Associations (Ritem));
4505                Arg2 := Next (Arg1);
4506                Arg3 := Next (Arg2);
4507
4508                Arg1 := Get_Pragma_Arg (Arg1);
4509                Arg2 := Get_Pragma_Arg (Arg2);
4510
4511                --  For Inherit case, ignore Invariant, process only Class case
4512
4513                if Inherit then
4514                   if not Class_Present (Ritem) then
4515                      goto Continue;
4516                   end if;
4517
4518                --  For Inherit false, process only item for right type
4519
4520                else
4521                   if Entity (Arg1) /= Typ then
4522                      goto Continue;
4523                   end if;
4524                end if;
4525
4526                if No (Stmts) then
4527                   Stmts := Empty_List;
4528                end if;
4529
4530                Exp := New_Copy_Tree (Arg2);
4531                Loc := Sloc (Exp);
4532
4533                --  We need to replace any occurrences of the name of the type
4534                --  with references to the object, converted to type'Class in
4535                --  the case of Invariant'Class aspects.
4536
4537                Replace_Type_References (Exp, Chars (T));
4538
4539                --  If this invariant comes from an aspect, find the aspect
4540                --  specification, and replace the saved expression because
4541                --  we need the subtype references replaced for the calls to
4542                --  Preanalyze_Spec_Expressin in Check_Aspect_At_Freeze_Point
4543                --  and Check_Aspect_At_End_Of_Declarations.
4544
4545                if From_Aspect_Specification (Ritem) then
4546                   declare
4547                      Aitem : Node_Id;
4548
4549                   begin
4550                      --  Loop to find corresponding aspect, note that this
4551                      --  must be present given the pragma is marked delayed.
4552
4553                      Aitem := Next_Rep_Item (Ritem);
4554                      while Present (Aitem) loop
4555                         if Nkind (Aitem) = N_Aspect_Specification
4556                           and then Aspect_Rep_Item (Aitem) = Ritem
4557                         then
4558                            Set_Entity
4559                              (Identifier (Aitem), New_Copy_Tree (Exp));
4560                            exit;
4561                         end if;
4562
4563                         Aitem := Next_Rep_Item (Aitem);
4564                      end loop;
4565                   end;
4566                end if;
4567
4568                --  Now we need to preanalyze the expression to properly capture
4569                --  the visibility in the visible part. The expression will not
4570                --  be analyzed for real until the body is analyzed, but that is
4571                --  at the end of the private part and has the wrong visibility.
4572
4573                Set_Parent (Exp, N);
4574                Preanalyze_Spec_Expression (Exp, Standard_Boolean);
4575
4576                --  Build first two arguments for Check pragma
4577
4578                Assoc := New_List (
4579                  Make_Pragma_Argument_Association (Loc,
4580                    Expression => Make_Identifier (Loc, Name_Invariant)),
4581                  Make_Pragma_Argument_Association (Loc, Expression => Exp));
4582
4583                --  Add message if present in Invariant pragma
4584
4585                if Present (Arg3) then
4586                   Str := Strval (Get_Pragma_Arg (Arg3));
4587
4588                   --  If inherited case, and message starts "failed invariant",
4589                   --  change it to be "failed inherited invariant".
4590
4591                   if Inherit then
4592                      String_To_Name_Buffer (Str);
4593
4594                      if Name_Buffer (1 .. 16) = "failed invariant" then
4595                         Insert_Str_In_Name_Buffer ("inherited ", 8);
4596                         Str := String_From_Name_Buffer;
4597                      end if;
4598                   end if;
4599
4600                   Append_To (Assoc,
4601                     Make_Pragma_Argument_Association (Loc,
4602                       Expression => Make_String_Literal (Loc, Str)));
4603                end if;
4604
4605                --  Add Check pragma to list of statements
4606
4607                Append_To (Stmts,
4608                  Make_Pragma (Loc,
4609                    Pragma_Identifier            =>
4610                      Make_Identifier (Loc, Name_Check),
4611                    Pragma_Argument_Associations => Assoc));
4612
4613                --  If Inherited case and option enabled, output info msg. Note
4614                --  that we know this is a case of Invariant'Class.
4615
4616                if Inherit and Opt.List_Inherited_Aspects then
4617                   Error_Msg_Sloc := Sloc (Ritem);
4618                   Error_Msg_N
4619                     ("?info: & inherits `Invariant''Class` aspect from #",
4620                      Typ);
4621                end if;
4622             end if;
4623
4624          <<Continue>>
4625             Next_Rep_Item (Ritem);
4626          end loop;
4627       end Add_Invariants;
4628
4629    --  Start of processing for Build_Invariant_Procedure
4630
4631    begin
4632       Stmts := No_List;
4633       PDecl := Empty;
4634       PBody := Empty;
4635       Set_Etype (Object_Entity, Typ);
4636
4637       --  Add invariants for the current type
4638
4639       Add_Invariants (Typ, Inherit => False);
4640
4641       --  Add invariants for parent types
4642
4643       declare
4644          Current_Typ : Entity_Id;
4645          Parent_Typ  : Entity_Id;
4646
4647       begin
4648          Current_Typ := Typ;
4649          loop
4650             Parent_Typ := Etype (Current_Typ);
4651
4652             if Is_Private_Type (Parent_Typ)
4653               and then Present (Full_View (Base_Type (Parent_Typ)))
4654             then
4655                Parent_Typ := Full_View (Base_Type (Parent_Typ));
4656             end if;
4657
4658             exit when Parent_Typ = Current_Typ;
4659
4660             Current_Typ := Parent_Typ;
4661             Add_Invariants (Current_Typ, Inherit => True);
4662          end loop;
4663       end;
4664
4665       --  Build the procedure if we generated at least one Check pragma
4666
4667       if Stmts /= No_List then
4668
4669          --  Build procedure declaration
4670
4671          SId :=
4672            Make_Defining_Identifier (Loc,
4673              Chars => New_External_Name (Chars (Typ), "Invariant"));
4674          Set_Has_Invariants (SId);
4675          Set_Invariant_Procedure (Typ, SId);
4676
4677          Spec :=
4678            Make_Procedure_Specification (Loc,
4679              Defining_Unit_Name       => SId,
4680              Parameter_Specifications => New_List (
4681                Make_Parameter_Specification (Loc,
4682                  Defining_Identifier => Object_Entity,
4683                  Parameter_Type      => New_Occurrence_Of (Typ, Loc))));
4684
4685          PDecl := Make_Subprogram_Declaration (Loc, Specification => Spec);
4686
4687          --  Build procedure body
4688
4689          SId :=
4690            Make_Defining_Identifier (Loc,
4691              Chars => New_External_Name (Chars (Typ), "Invariant"));
4692
4693          Spec :=
4694            Make_Procedure_Specification (Loc,
4695              Defining_Unit_Name       => SId,
4696              Parameter_Specifications => New_List (
4697                Make_Parameter_Specification (Loc,
4698                  Defining_Identifier =>
4699                    Make_Defining_Identifier (Loc, Object_Name),
4700                  Parameter_Type => New_Occurrence_Of (Typ, Loc))));
4701
4702          PBody :=
4703            Make_Subprogram_Body (Loc,
4704              Specification              => Spec,
4705              Declarations               => Empty_List,
4706              Handled_Statement_Sequence =>
4707                Make_Handled_Sequence_Of_Statements (Loc,
4708                  Statements => Stmts));
4709
4710          --  Insert procedure declaration and spec at the appropriate points.
4711          --  Skip this if there are no private declarations (that's an error
4712          --  that will be diagnosed elsewhere, and there is no point in having
4713          --  an invariant procedure set if the full declaration is missing).
4714
4715          if Present (Private_Decls) then
4716
4717             --  The spec goes at the end of visible declarations, but they have
4718             --  already been analyzed, so we need to explicitly do the analyze.
4719
4720             Append_To (Visible_Decls, PDecl);
4721             Analyze (PDecl);
4722
4723             --  The body goes at the end of the private declarations, which we
4724             --  have not analyzed yet, so we do not need to perform an explicit
4725             --  analyze call. We skip this if there are no private declarations
4726             --  (this is an error that will be caught elsewhere);
4727
4728             Append_To (Private_Decls, PBody);
4729          end if;
4730       end if;
4731    end Build_Invariant_Procedure;
4732
4733    ------------------------------
4734    -- Build_Predicate_Function --
4735    ------------------------------
4736
4737    --  The procedure that is constructed here has the form
4738
4739    --  function typPredicate (Ixxx : typ) return Boolean is
4740    --  begin
4741    --     return
4742    --        exp1 and then exp2 and then ...
4743    --        and then typ1Predicate (typ1 (Ixxx))
4744    --        and then typ2Predicate (typ2 (Ixxx))
4745    --        and then ...;
4746    --  end typPredicate;
4747
4748    --  Here exp1, and exp2 are expressions from Predicate pragmas. Note that
4749    --  this is the point at which these expressions get analyzed, providing the
4750    --  required delay, and typ1, typ2, are entities from which predicates are
4751    --  inherited. Note that we do NOT generate Check pragmas, that's because we
4752    --  use this function even if checks are off, e.g. for membership tests.
4753
4754    procedure Build_Predicate_Function (Typ : Entity_Id; N : Node_Id) is
4755       Loc  : constant Source_Ptr := Sloc (Typ);
4756       Spec : Node_Id;
4757       SId  : Entity_Id;
4758       FDecl : Node_Id;
4759       FBody : Node_Id;
4760
4761       Expr : Node_Id;
4762       --  This is the expression for the return statement in the function. It
4763       --  is build by connecting the component predicates with AND THEN.
4764
4765       procedure Add_Call (T : Entity_Id);
4766       --  Includes a call to the predicate function for type T in Expr if T
4767       --  has predicates and Predicate_Function (T) is non-empty.
4768
4769       procedure Add_Predicates;
4770       --  Appends expressions for any Predicate pragmas in the rep item chain
4771       --  Typ to Expr. Note that we look only at items for this exact entity.
4772       --  Inheritance of predicates for the parent type is done by calling the
4773       --  Predicate_Function of the parent type, using Add_Call above.
4774
4775       Object_Name : constant Name_Id := New_Internal_Name ('I');
4776       --  Name for argument of Predicate procedure
4777
4778       Object_Entity : constant Entity_Id :=
4779                         Make_Defining_Identifier (Loc, Object_Name);
4780       --  The entity for the spec entity for the argument
4781
4782       Dynamic_Predicate_Present : Boolean := False;
4783       --  Set True if a dynamic predicate is present, results in the entire
4784       --  predicate being considered dynamic even if it looks static
4785
4786       Static_Predicate_Present : Node_Id := Empty;
4787       --  Set to N_Pragma node for a static predicate if one is encountered.
4788
4789       --------------
4790       -- Add_Call --
4791       --------------
4792
4793       procedure Add_Call (T : Entity_Id) is
4794          Exp : Node_Id;
4795
4796       begin
4797          if Present (T) and then Present (Predicate_Function (T)) then
4798             Set_Has_Predicates (Typ);
4799
4800             --  Build the call to the predicate function of T
4801
4802             Exp :=
4803               Make_Predicate_Call
4804                 (T, Convert_To (T, Make_Identifier (Loc, Object_Name)));
4805
4806             --  Add call to evolving expression, using AND THEN if needed
4807
4808             if No (Expr) then
4809                Expr := Exp;
4810             else
4811                Expr :=
4812                  Make_And_Then (Loc,
4813                    Left_Opnd  => Relocate_Node (Expr),
4814                    Right_Opnd => Exp);
4815             end if;
4816
4817             --  Output info message on inheritance if required. Note we do not
4818             --  give this information for generic actual types, since it is
4819             --  unwelcome noise in that case in instantiations. We also
4820             --  generally suppress the message in instantiations, and also
4821             --  if it involves internal names.
4822
4823             if Opt.List_Inherited_Aspects
4824               and then not Is_Generic_Actual_Type (Typ)
4825               and then Instantiation_Depth (Sloc (Typ)) = 0
4826               and then not Is_Internal_Name (Chars (T))
4827               and then not Is_Internal_Name (Chars (Typ))
4828             then
4829                Error_Msg_Sloc := Sloc (Predicate_Function (T));
4830                Error_Msg_Node_2 := T;
4831                Error_Msg_N ("?info: & inherits predicate from & #", Typ);
4832             end if;
4833          end if;
4834       end Add_Call;
4835
4836       --------------------
4837       -- Add_Predicates --
4838       --------------------
4839
4840       procedure Add_Predicates is
4841          Ritem : Node_Id;
4842          Arg1  : Node_Id;
4843          Arg2  : Node_Id;
4844
4845          procedure Replace_Type_Reference (N : Node_Id);
4846          --  Replace a single occurrence N of the subtype name with a reference
4847          --  to the formal of the predicate function. N can be an identifier
4848          --  referencing the subtype, or a selected component, representing an
4849          --  appropriately qualified occurrence of the subtype name.
4850
4851          procedure Replace_Type_References is
4852            new Replace_Type_References_Generic (Replace_Type_Reference);
4853          --  Traverse an expression changing every occurrence of an identifier
4854          --  whose name matches the name of the subtype with a reference to
4855          --  the formal parameter of the predicate function.
4856
4857          ----------------------------
4858          -- Replace_Type_Reference --
4859          ----------------------------
4860
4861          procedure Replace_Type_Reference (N : Node_Id) is
4862          begin
4863             Rewrite (N, Make_Identifier (Loc, Object_Name));
4864             Set_Entity (N, Object_Entity);
4865             Set_Etype (N, Typ);
4866          end Replace_Type_Reference;
4867
4868       --  Start of processing for Add_Predicates
4869
4870       begin
4871          Ritem := First_Rep_Item (Typ);
4872          while Present (Ritem) loop
4873             if Nkind (Ritem) = N_Pragma
4874               and then Pragma_Name (Ritem) = Name_Predicate
4875             then
4876                if Present (Corresponding_Aspect (Ritem)) then
4877                   case Chars (Identifier (Corresponding_Aspect (Ritem))) is
4878                      when Name_Dynamic_Predicate =>
4879                         Dynamic_Predicate_Present := True;
4880                      when Name_Static_Predicate =>
4881                         Static_Predicate_Present := Ritem;
4882                      when others =>
4883                         null;
4884                   end case;
4885                end if;
4886
4887                --  Acquire arguments
4888
4889                Arg1 := First (Pragma_Argument_Associations (Ritem));
4890                Arg2 := Next (Arg1);
4891
4892                Arg1 := Get_Pragma_Arg (Arg1);
4893                Arg2 := Get_Pragma_Arg (Arg2);
4894
4895                --  See if this predicate pragma is for the current type or for
4896                --  its full view. A predicate on a private completion is placed
4897                --  on the partial view beause this is the visible entity that
4898                --  is frozen.
4899
4900                if Entity (Arg1) = Typ
4901                  or else Full_View (Entity (Arg1)) = Typ
4902                then
4903
4904                   --  We have a match, this entry is for our subtype
4905
4906                   --  We need to replace any occurrences of the name of the
4907                   --  type with references to the object.
4908
4909                   Replace_Type_References (Arg2, Chars (Typ));
4910
4911                   --  If this predicate comes from an aspect, find the aspect
4912                   --  specification, and replace the saved expression because
4913                   --  we need the subtype references replaced for the calls to
4914                   --  Preanalyze_Spec_Expressin in Check_Aspect_At_Freeze_Point
4915                   --  and Check_Aspect_At_End_Of_Declarations.
4916
4917                   if From_Aspect_Specification (Ritem) then
4918                      declare
4919                         Aitem : Node_Id;
4920
4921                      begin
4922                         --  Loop to find corresponding aspect, note that this
4923                         --  must be present given the pragma is marked delayed.
4924
4925                         Aitem := Next_Rep_Item (Ritem);
4926                         loop
4927                            if Nkind (Aitem) = N_Aspect_Specification
4928                              and then Aspect_Rep_Item (Aitem) = Ritem
4929                            then
4930                               Set_Entity
4931                                 (Identifier (Aitem), New_Copy_Tree (Arg2));
4932                               exit;
4933                            end if;
4934
4935                            Aitem := Next_Rep_Item (Aitem);
4936                         end loop;
4937                      end;
4938                   end if;
4939
4940                   --  Now we can add the expression
4941
4942                   if No (Expr) then
4943                      Expr := Relocate_Node (Arg2);
4944
4945                   --  There already was a predicate, so add to it
4946
4947                   else
4948                      Expr :=
4949                        Make_And_Then (Loc,
4950                          Left_Opnd  => Relocate_Node (Expr),
4951                          Right_Opnd => Relocate_Node (Arg2));
4952                   end if;
4953                end if;
4954             end if;
4955
4956             Next_Rep_Item (Ritem);
4957          end loop;
4958       end Add_Predicates;
4959
4960    --  Start of processing for Build_Predicate_Function
4961
4962    begin
4963       --  Initialize for construction of statement list
4964
4965       Expr := Empty;
4966
4967       --  Return if already built or if type does not have predicates
4968
4969       if not Has_Predicates (Typ)
4970         or else Present (Predicate_Function (Typ))
4971       then
4972          return;
4973       end if;
4974
4975       --  Add Predicates for the current type
4976
4977       Add_Predicates;
4978
4979       --  Add predicates for ancestor if present
4980
4981       declare
4982          Atyp : constant Entity_Id := Nearest_Ancestor (Typ);
4983       begin
4984          if Present (Atyp) then
4985             Add_Call (Atyp);
4986          end if;
4987       end;
4988
4989       --  If we have predicates, build the function
4990
4991       if Present (Expr) then
4992
4993          --  Build function declaration
4994
4995          pragma Assert (Has_Predicates (Typ));
4996          SId :=
4997            Make_Defining_Identifier (Loc,
4998              Chars => New_External_Name (Chars (Typ), "Predicate"));
4999          Set_Has_Predicates (SId);
5000          Set_Predicate_Function (Typ, SId);
5001
5002          Spec :=
5003            Make_Function_Specification (Loc,
5004              Defining_Unit_Name       => SId,
5005              Parameter_Specifications => New_List (
5006                Make_Parameter_Specification (Loc,
5007                  Defining_Identifier => Object_Entity,
5008                  Parameter_Type      => New_Occurrence_Of (Typ, Loc))),
5009              Result_Definition        =>
5010                New_Occurrence_Of (Standard_Boolean, Loc));
5011
5012          FDecl := Make_Subprogram_Declaration (Loc, Specification => Spec);
5013
5014          --  Build function body
5015
5016          SId :=
5017            Make_Defining_Identifier (Loc,
5018              Chars => New_External_Name (Chars (Typ), "Predicate"));
5019
5020          Spec :=
5021            Make_Function_Specification (Loc,
5022              Defining_Unit_Name       => SId,
5023              Parameter_Specifications => New_List (
5024                Make_Parameter_Specification (Loc,
5025                  Defining_Identifier =>
5026                    Make_Defining_Identifier (Loc, Object_Name),
5027                  Parameter_Type =>
5028                    New_Occurrence_Of (Typ, Loc))),
5029              Result_Definition        =>
5030                New_Occurrence_Of (Standard_Boolean, Loc));
5031
5032          FBody :=
5033            Make_Subprogram_Body (Loc,
5034              Specification              => Spec,
5035              Declarations               => Empty_List,
5036              Handled_Statement_Sequence =>
5037                Make_Handled_Sequence_Of_Statements (Loc,
5038                  Statements => New_List (
5039                    Make_Simple_Return_Statement (Loc,
5040                      Expression => Expr))));
5041
5042          --  Insert declaration before freeze node and body after
5043
5044          Insert_Before_And_Analyze (N, FDecl);
5045          Insert_After_And_Analyze  (N, FBody);
5046
5047          --  Deal with static predicate case
5048
5049          if Ekind_In (Typ, E_Enumeration_Subtype,
5050                            E_Modular_Integer_Subtype,
5051                            E_Signed_Integer_Subtype)
5052            and then Is_Static_Subtype (Typ)
5053            and then not Dynamic_Predicate_Present
5054          then
5055             Build_Static_Predicate (Typ, Expr, Object_Name);
5056
5057             if Present (Static_Predicate_Present)
5058               and No (Static_Predicate (Typ))
5059             then
5060                Error_Msg_F
5061                  ("expression does not have required form for "
5062                   & "static predicate",
5063                   Next (First (Pragma_Argument_Associations
5064                                 (Static_Predicate_Present))));
5065             end if;
5066          end if;
5067       end if;
5068    end Build_Predicate_Function;
5069
5070    ----------------------------
5071    -- Build_Static_Predicate --
5072    ----------------------------
5073
5074    procedure Build_Static_Predicate
5075      (Typ  : Entity_Id;
5076       Expr : Node_Id;
5077       Nam  : Name_Id)
5078    is
5079       Loc : constant Source_Ptr := Sloc (Expr);
5080
5081       Non_Static : exception;
5082       --  Raised if something non-static is found
5083
5084       Btyp : constant Entity_Id := Base_Type (Typ);
5085
5086       BLo : constant Uint := Expr_Value (Type_Low_Bound  (Btyp));
5087       BHi : constant Uint := Expr_Value (Type_High_Bound (Btyp));
5088       --  Low bound and high bound value of base type of Typ
5089
5090       TLo : constant Uint := Expr_Value (Type_Low_Bound  (Typ));
5091       THi : constant Uint := Expr_Value (Type_High_Bound (Typ));
5092       --  Low bound and high bound values of static subtype Typ
5093
5094       type REnt is record
5095          Lo, Hi : Uint;
5096       end record;
5097       --  One entry in a Rlist value, a single REnt (range entry) value
5098       --  denotes one range from Lo to Hi. To represent a single value
5099       --  range Lo = Hi = value.
5100
5101       type RList is array (Nat range <>) of REnt;
5102       --  A list of ranges. The ranges are sorted in increasing order,
5103       --  and are disjoint (there is a gap of at least one value between
5104       --  each range in the table). A value is in the set of ranges in
5105       --  Rlist if it lies within one of these ranges
5106
5107       False_Range : constant RList :=
5108                       RList'(1 .. 0 => REnt'(No_Uint, No_Uint));
5109       --  An empty set of ranges represents a range list that can never be
5110       --  satisfied, since there are no ranges in which the value could lie,
5111       --  so it does not lie in any of them. False_Range is a canonical value
5112       --  for this empty set, but general processing should test for an Rlist
5113       --  with length zero (see Is_False predicate), since other null ranges
5114       --  may appear which must be treated as False.
5115
5116       True_Range : constant RList := RList'(1 => REnt'(BLo, BHi));
5117       --  Range representing True, value must be in the base range
5118
5119       function "and" (Left, Right : RList) return RList;
5120       --  And's together two range lists, returning a range list. This is
5121       --  a set intersection operation.
5122
5123       function "or" (Left, Right : RList) return RList;
5124       --  Or's together two range lists, returning a range list. This is a
5125       --  set union operation.
5126
5127       function "not" (Right : RList) return RList;
5128       --  Returns complement of a given range list, i.e. a range list
5129       --  representing all the values in TLo .. THi that are not in the
5130       --  input operand Right.
5131
5132       function Build_Val (V : Uint) return Node_Id;
5133       --  Return an analyzed N_Identifier node referencing this value, suitable
5134       --  for use as an entry in the Static_Predicate list. This node is typed
5135       --  with the base type.
5136
5137       function Build_Range (Lo, Hi : Uint) return Node_Id;
5138       --  Return an analyzed N_Range node referencing this range, suitable
5139       --  for use as an entry in the Static_Predicate list. This node is typed
5140       --  with the base type.
5141
5142       function Get_RList (Exp : Node_Id) return RList;
5143       --  This is a recursive routine that converts the given expression into
5144       --  a list of ranges, suitable for use in building the static predicate.
5145
5146       function Is_False (R : RList) return Boolean;
5147       pragma Inline (Is_False);
5148       --  Returns True if the given range list is empty, and thus represents
5149       --  a False list of ranges that can never be satisfied.
5150
5151       function Is_True (R : RList) return Boolean;
5152       --  Returns True if R trivially represents the True predicate by having
5153       --  a single range from BLo to BHi.
5154
5155       function Is_Type_Ref (N : Node_Id) return Boolean;
5156       pragma Inline (Is_Type_Ref);
5157       --  Returns if True if N is a reference to the type for the predicate in
5158       --  the expression (i.e. if it is an identifier whose Chars field matches
5159       --  the Nam given in the call).
5160
5161       function Lo_Val (N : Node_Id) return Uint;
5162       --  Given static expression or static range from a Static_Predicate list,
5163       --  gets expression value or low bound of range.
5164
5165       function Hi_Val (N : Node_Id) return Uint;
5166       --  Given static expression or static range from a Static_Predicate list,
5167       --  gets expression value of high bound of range.
5168
5169       function Membership_Entry (N : Node_Id) return RList;
5170       --  Given a single membership entry (range, value, or subtype), returns
5171       --  the corresponding range list. Raises Static_Error if not static.
5172
5173       function Membership_Entries (N : Node_Id) return RList;
5174       --  Given an element on an alternatives list of a membership operation,
5175       --  returns the range list corresponding to this entry and all following
5176       --  entries (i.e. returns the "or" of this list of values).
5177
5178       function Stat_Pred (Typ : Entity_Id) return RList;
5179       --  Given a type, if it has a static predicate, then return the predicate
5180       --  as a range list, otherwise raise Non_Static.
5181
5182       -----------
5183       -- "and" --
5184       -----------
5185
5186       function "and" (Left, Right : RList) return RList is
5187          FEnt : REnt;
5188          --  First range of result
5189
5190          SLeft : Nat := Left'First;
5191          --  Start of rest of left entries
5192
5193          SRight : Nat := Right'First;
5194          --  Start of rest of right entries
5195
5196       begin
5197          --  If either range is True, return the other
5198
5199          if Is_True (Left) then
5200             return Right;
5201          elsif Is_True (Right) then
5202             return Left;
5203          end if;
5204
5205          --  If either range is False, return False
5206
5207          if Is_False (Left) or else Is_False (Right) then
5208             return False_Range;
5209          end if;
5210
5211          --  Loop to remove entries at start that are disjoint, and thus
5212          --  just get discarded from the result entirely.
5213
5214          loop
5215             --  If no operands left in either operand, result is false
5216
5217             if SLeft > Left'Last or else SRight > Right'Last then
5218                return False_Range;
5219
5220             --  Discard first left operand entry if disjoint with right
5221
5222             elsif Left (SLeft).Hi < Right (SRight).Lo then
5223                SLeft := SLeft + 1;
5224
5225             --  Discard first right operand entry if disjoint with left
5226
5227             elsif Right (SRight).Hi < Left (SLeft).Lo then
5228                SRight := SRight + 1;
5229
5230             --  Otherwise we have an overlapping entry
5231
5232             else
5233                exit;
5234             end if;
5235          end loop;
5236
5237          --  Now we have two non-null operands, and first entries overlap.
5238          --  The first entry in the result will be the overlapping part of
5239          --  these two entries.
5240
5241          FEnt := REnt'(Lo => UI_Max (Left (SLeft).Lo, Right (SRight).Lo),
5242                        Hi => UI_Min (Left (SLeft).Hi, Right (SRight).Hi));
5243
5244          --  Now we can remove the entry that ended at a lower value, since
5245          --  its contribution is entirely contained in Fent.
5246
5247          if Left (SLeft).Hi <= Right (SRight).Hi then
5248             SLeft := SLeft + 1;
5249          else
5250             SRight := SRight + 1;
5251          end if;
5252
5253          --  Compute result by concatenating this first entry with the "and"
5254          --  of the remaining parts of the left and right operands. Note that
5255          --  if either of these is empty, "and" will yield empty, so that we
5256          --  will end up with just Fent, which is what we want in that case.
5257
5258          return
5259            FEnt & (Left (SLeft .. Left'Last) and Right (SRight .. Right'Last));
5260       end "and";
5261
5262       -----------
5263       -- "not" --
5264       -----------
5265
5266       function "not" (Right : RList) return RList is
5267       begin
5268          --  Return True if False range
5269
5270          if Is_False (Right) then
5271             return True_Range;
5272          end if;
5273
5274          --  Return False if True range
5275
5276          if Is_True (Right) then
5277             return False_Range;
5278          end if;
5279
5280          --  Here if not trivial case
5281
5282          declare
5283             Result : RList (1 .. Right'Length + 1);
5284             --  May need one more entry for gap at beginning and end
5285
5286             Count : Nat := 0;
5287             --  Number of entries stored in Result
5288
5289          begin
5290             --  Gap at start
5291
5292             if Right (Right'First).Lo > TLo then
5293                Count := Count + 1;
5294                Result (Count) := REnt'(TLo, Right (Right'First).Lo - 1);
5295             end if;
5296
5297             --  Gaps between ranges
5298
5299             for J in Right'First .. Right'Last - 1 loop
5300                Count := Count + 1;
5301                Result (Count) :=
5302                  REnt'(Right (J).Hi + 1, Right (J + 1).Lo - 1);
5303             end loop;
5304
5305             --  Gap at end
5306
5307             if Right (Right'Last).Hi < THi then
5308                Count := Count + 1;
5309                Result (Count) := REnt'(Right (Right'Last).Hi + 1, THi);
5310             end if;
5311
5312             return Result (1 .. Count);
5313          end;
5314       end "not";
5315
5316       ----------
5317       -- "or" --
5318       ----------
5319
5320       function "or" (Left, Right : RList) return RList is
5321          FEnt : REnt;
5322          --  First range of result
5323
5324          SLeft : Nat := Left'First;
5325          --  Start of rest of left entries
5326
5327          SRight : Nat := Right'First;
5328          --  Start of rest of right entries
5329
5330       begin
5331          --  If either range is True, return True
5332
5333          if Is_True (Left) or else Is_True (Right) then
5334             return True_Range;
5335          end if;
5336
5337          --  If either range is False (empty), return the other
5338
5339          if Is_False (Left) then
5340             return Right;
5341          elsif Is_False (Right) then
5342             return Left;
5343          end if;
5344
5345          --  Initialize result first entry from left or right operand
5346          --  depending on which starts with the lower range.
5347
5348          if Left (SLeft).Lo < Right (SRight).Lo then
5349             FEnt := Left (SLeft);
5350             SLeft := SLeft + 1;
5351          else
5352             FEnt := Right (SRight);
5353             SRight := SRight + 1;
5354          end if;
5355
5356          --  This loop eats ranges from left and right operands that
5357          --  are contiguous with the first range we are gathering.
5358
5359          loop
5360             --  Eat first entry in left operand if contiguous or
5361             --  overlapped by gathered first operand of result.
5362
5363             if SLeft <= Left'Last
5364               and then Left (SLeft).Lo <= FEnt.Hi + 1
5365             then
5366                FEnt.Hi := UI_Max (FEnt.Hi, Left (SLeft).Hi);
5367                SLeft := SLeft + 1;
5368
5369                --  Eat first entry in right operand if contiguous or
5370                --  overlapped by gathered right operand of result.
5371
5372             elsif SRight <= Right'Last
5373               and then Right (SRight).Lo <= FEnt.Hi + 1
5374             then
5375                FEnt.Hi := UI_Max (FEnt.Hi, Right (SRight).Hi);
5376                SRight := SRight + 1;
5377
5378                --  All done if no more entries to eat!
5379
5380             else
5381                exit;
5382             end if;
5383          end loop;
5384
5385          --  Obtain result as the first entry we just computed, concatenated
5386          --  to the "or" of the remaining results (if one operand is empty,
5387          --  this will just concatenate with the other
5388
5389          return
5390            FEnt & (Left (SLeft .. Left'Last) or Right (SRight .. Right'Last));
5391       end "or";
5392
5393       -----------------
5394       -- Build_Range --
5395       -----------------
5396
5397       function Build_Range (Lo, Hi : Uint) return Node_Id is
5398          Result : Node_Id;
5399       begin
5400          if Lo = Hi then
5401             return Build_Val (Hi);
5402          else
5403             Result :=
5404               Make_Range (Loc,
5405                 Low_Bound  => Build_Val (Lo),
5406                 High_Bound => Build_Val (Hi));
5407             Set_Etype (Result, Btyp);
5408             Set_Analyzed (Result);
5409             return Result;
5410          end if;
5411       end Build_Range;
5412
5413       ---------------
5414       -- Build_Val --
5415       ---------------
5416
5417       function Build_Val (V : Uint) return Node_Id is
5418          Result : Node_Id;
5419
5420       begin
5421          if Is_Enumeration_Type (Typ) then
5422             Result := Get_Enum_Lit_From_Pos (Typ, V, Loc);
5423          else
5424             Result := Make_Integer_Literal (Loc, V);
5425          end if;
5426
5427          Set_Etype (Result, Btyp);
5428          Set_Is_Static_Expression (Result);
5429          Set_Analyzed (Result);
5430          return Result;
5431       end Build_Val;
5432
5433       ---------------
5434       -- Get_RList --
5435       ---------------
5436
5437       function Get_RList (Exp : Node_Id) return RList is
5438          Op  : Node_Kind;
5439          Val : Uint;
5440
5441       begin
5442          --  Static expression can only be true or false
5443
5444          if Is_OK_Static_Expression (Exp) then
5445
5446             --  For False
5447
5448             if Expr_Value (Exp) = 0 then
5449                return False_Range;
5450             else
5451                return True_Range;
5452             end if;
5453          end if;
5454
5455          --  Otherwise test node type
5456
5457          Op := Nkind (Exp);
5458
5459          case Op is
5460
5461             --  And
5462
5463             when N_Op_And | N_And_Then =>
5464                return Get_RList (Left_Opnd (Exp))
5465                         and
5466                       Get_RList (Right_Opnd (Exp));
5467
5468             --  Or
5469
5470             when N_Op_Or | N_Or_Else =>
5471                return Get_RList (Left_Opnd (Exp))
5472                         or
5473                       Get_RList (Right_Opnd (Exp));
5474
5475             --  Not
5476
5477             when N_Op_Not =>
5478                return not Get_RList (Right_Opnd (Exp));
5479
5480             --  Comparisons of type with static value
5481
5482             when N_Op_Compare =>
5483                --  Type is left operand
5484
5485                if Is_Type_Ref (Left_Opnd (Exp))
5486                  and then Is_OK_Static_Expression (Right_Opnd (Exp))
5487                then
5488                   Val := Expr_Value (Right_Opnd (Exp));
5489
5490                   --  Typ is right operand
5491
5492                elsif Is_Type_Ref (Right_Opnd (Exp))
5493                  and then Is_OK_Static_Expression (Left_Opnd (Exp))
5494                then
5495                   Val := Expr_Value (Left_Opnd (Exp));
5496
5497                   --  Invert sense of comparison
5498
5499                   case Op is
5500                      when N_Op_Gt => Op := N_Op_Lt;
5501                      when N_Op_Lt => Op := N_Op_Gt;
5502                      when N_Op_Ge => Op := N_Op_Le;
5503                      when N_Op_Le => Op := N_Op_Ge;
5504                      when others  => null;
5505                   end case;
5506
5507                   --  Other cases are non-static
5508
5509                else
5510                   raise Non_Static;
5511                end if;
5512
5513                --  Construct range according to comparison operation
5514
5515                case Op is
5516                   when N_Op_Eq =>
5517                      return RList'(1 => REnt'(Val, Val));
5518
5519                   when N_Op_Ge =>
5520                      return RList'(1 => REnt'(Val, BHi));
5521
5522                   when N_Op_Gt =>
5523                      return RList'(1 => REnt'(Val + 1, BHi));
5524
5525                   when N_Op_Le =>
5526                      return RList'(1 => REnt'(BLo, Val));
5527
5528                   when N_Op_Lt =>
5529                      return RList'(1 => REnt'(BLo, Val - 1));
5530
5531                   when N_Op_Ne =>
5532                      return RList'(REnt'(BLo, Val - 1),
5533                                    REnt'(Val + 1, BHi));
5534
5535                   when others  =>
5536                      raise Program_Error;
5537                end case;
5538
5539             --  Membership (IN)
5540
5541             when N_In =>
5542                if not Is_Type_Ref (Left_Opnd (Exp)) then
5543                   raise Non_Static;
5544                end if;
5545
5546                if Present (Right_Opnd (Exp)) then
5547                   return Membership_Entry (Right_Opnd (Exp));
5548                else
5549                   return Membership_Entries (First (Alternatives (Exp)));
5550                end if;
5551
5552             --  Negative membership (NOT IN)
5553
5554             when N_Not_In =>
5555                if not Is_Type_Ref (Left_Opnd (Exp)) then
5556                   raise Non_Static;
5557                end if;
5558
5559                if Present (Right_Opnd (Exp)) then
5560                   return not Membership_Entry (Right_Opnd (Exp));
5561                else
5562                   return not Membership_Entries (First (Alternatives (Exp)));
5563                end if;
5564
5565             --  Function call, may be call to static predicate
5566
5567             when N_Function_Call =>
5568                if Is_Entity_Name (Name (Exp)) then
5569                   declare
5570                      Ent : constant Entity_Id := Entity (Name (Exp));
5571                   begin
5572                      if Has_Predicates (Ent) then
5573                         return Stat_Pred (Etype (First_Formal (Ent)));
5574                      end if;
5575                   end;
5576                end if;
5577
5578                --  Other function call cases are non-static
5579
5580                raise Non_Static;
5581
5582             --  Qualified expression, dig out the expression
5583
5584             when N_Qualified_Expression =>
5585                return Get_RList (Expression (Exp));
5586
5587             --  Xor operator
5588
5589             when N_Op_Xor =>
5590                return (Get_RList (Left_Opnd (Exp))
5591                         and not Get_RList (Right_Opnd (Exp)))
5592                  or   (Get_RList (Right_Opnd (Exp))
5593                         and not Get_RList (Left_Opnd (Exp)));
5594
5595             --  Any other node type is non-static
5596
5597             when others =>
5598                raise Non_Static;
5599          end case;
5600       end Get_RList;
5601
5602       ------------
5603       -- Hi_Val --
5604       ------------
5605
5606       function Hi_Val (N : Node_Id) return Uint is
5607       begin
5608          if Is_Static_Expression (N) then
5609             return Expr_Value (N);
5610          else
5611             pragma Assert (Nkind (N) = N_Range);
5612             return Expr_Value (High_Bound (N));
5613          end if;
5614       end Hi_Val;
5615
5616       --------------
5617       -- Is_False --
5618       --------------
5619
5620       function Is_False (R : RList) return Boolean is
5621       begin
5622          return R'Length = 0;
5623       end Is_False;
5624
5625       -------------
5626       -- Is_True --
5627       -------------
5628
5629       function Is_True (R : RList) return Boolean is
5630       begin
5631          return R'Length = 1
5632            and then R (R'First).Lo = BLo
5633            and then R (R'First).Hi = BHi;
5634       end Is_True;
5635
5636       -----------------
5637       -- Is_Type_Ref --
5638       -----------------
5639
5640       function Is_Type_Ref (N : Node_Id) return Boolean is
5641       begin
5642          return Nkind (N) = N_Identifier and then Chars (N) = Nam;
5643       end Is_Type_Ref;
5644
5645       ------------
5646       -- Lo_Val --
5647       ------------
5648
5649       function Lo_Val (N : Node_Id) return Uint is
5650       begin
5651          if Is_Static_Expression (N) then
5652             return Expr_Value (N);
5653          else
5654             pragma Assert (Nkind (N) = N_Range);
5655             return Expr_Value (Low_Bound (N));
5656          end if;
5657       end Lo_Val;
5658
5659       ------------------------
5660       -- Membership_Entries --
5661       ------------------------
5662
5663       function Membership_Entries (N : Node_Id) return RList is
5664       begin
5665          if No (Next (N)) then
5666             return Membership_Entry (N);
5667          else
5668             return Membership_Entry (N) or Membership_Entries (Next (N));
5669          end if;
5670       end Membership_Entries;
5671
5672       ----------------------
5673       -- Membership_Entry --
5674       ----------------------
5675
5676       function Membership_Entry (N : Node_Id) return RList is
5677          Val : Uint;
5678          SLo : Uint;
5679          SHi : Uint;
5680
5681       begin
5682          --  Range case
5683
5684          if Nkind (N) = N_Range then
5685             if not Is_Static_Expression (Low_Bound (N))
5686                  or else
5687                not Is_Static_Expression (High_Bound (N))
5688             then
5689                raise Non_Static;
5690             else
5691                SLo := Expr_Value (Low_Bound  (N));
5692                SHi := Expr_Value (High_Bound (N));
5693                return RList'(1 => REnt'(SLo, SHi));
5694             end if;
5695
5696          --  Static expression case
5697
5698          elsif Is_Static_Expression (N) then
5699             Val := Expr_Value (N);
5700             return RList'(1 => REnt'(Val, Val));
5701
5702          --  Identifier (other than static expression) case
5703
5704          else pragma Assert (Nkind (N) = N_Identifier);
5705
5706             --  Type case
5707
5708             if Is_Type (Entity (N)) then
5709
5710                --  If type has predicates, process them
5711
5712                if Has_Predicates (Entity (N)) then
5713                   return Stat_Pred (Entity (N));
5714
5715                --  For static subtype without predicates, get range
5716
5717                elsif Is_Static_Subtype (Entity (N)) then
5718                   SLo := Expr_Value (Type_Low_Bound  (Entity (N)));
5719                   SHi := Expr_Value (Type_High_Bound (Entity (N)));
5720                   return RList'(1 => REnt'(SLo, SHi));
5721
5722                --  Any other type makes us non-static
5723
5724                else
5725                   raise Non_Static;
5726                end if;
5727
5728             --  Any other kind of identifier in predicate (e.g. a non-static
5729             --  expression value) means this is not a static predicate.
5730
5731             else
5732                raise Non_Static;
5733             end if;
5734          end if;
5735       end Membership_Entry;
5736
5737       ---------------
5738       -- Stat_Pred --
5739       ---------------
5740
5741       function Stat_Pred (Typ : Entity_Id) return RList is
5742       begin
5743          --  Not static if type does not have static predicates
5744
5745          if not Has_Predicates (Typ)
5746            or else No (Static_Predicate (Typ))
5747          then
5748             raise Non_Static;
5749          end if;
5750
5751          --  Otherwise we convert the predicate list to a range list
5752
5753          declare
5754             Result : RList (1 .. List_Length (Static_Predicate (Typ)));
5755             P      : Node_Id;
5756
5757          begin
5758             P := First (Static_Predicate (Typ));
5759             for J in Result'Range loop
5760                Result (J) := REnt'(Lo_Val (P), Hi_Val (P));
5761                Next (P);
5762             end loop;
5763
5764             return Result;
5765          end;
5766       end Stat_Pred;
5767
5768    --  Start of processing for Build_Static_Predicate
5769
5770    begin
5771       --  Now analyze the expression to see if it is a static predicate
5772
5773       declare
5774          Ranges : constant RList := Get_RList (Expr);
5775          --  Range list from expression if it is static
5776
5777          Plist : List_Id;
5778
5779       begin
5780          --  Convert range list into a form for the static predicate. In the
5781          --  Ranges array, we just have raw ranges, these must be converted
5782          --  to properly typed and analyzed static expressions or range nodes.
5783
5784          --  Note: here we limit ranges to the ranges of the subtype, so that
5785          --  a predicate is always false for values outside the subtype. That
5786          --  seems fine, such values are invalid anyway, and considering them
5787          --  to fail the predicate seems allowed and friendly, and furthermore
5788          --  simplifies processing for case statements and loops.
5789
5790          Plist := New_List;
5791
5792          for J in Ranges'Range loop
5793             declare
5794                Lo : Uint := Ranges (J).Lo;
5795                Hi : Uint := Ranges (J).Hi;
5796
5797             begin
5798                --  Ignore completely out of range entry
5799
5800                if Hi < TLo or else Lo > THi then
5801                   null;
5802
5803                   --  Otherwise process entry
5804
5805                else
5806                   --  Adjust out of range value to subtype range
5807
5808                   if Lo < TLo then
5809                      Lo := TLo;
5810                   end if;
5811
5812                   if Hi > THi then
5813                      Hi := THi;
5814                   end if;
5815
5816                   --  Convert range into required form
5817
5818                   if Lo = Hi then
5819                      Append_To (Plist, Build_Val (Lo));
5820                   else
5821                      Append_To (Plist, Build_Range (Lo, Hi));
5822                   end if;
5823                end if;
5824             end;
5825          end loop;
5826
5827          --  Processing was successful and all entries were static, so now we
5828          --  can store the result as the predicate list.
5829
5830          Set_Static_Predicate (Typ, Plist);
5831
5832          --  The processing for static predicates put the expression into
5833          --  canonical form as a series of ranges. It also eliminated
5834          --  duplicates and collapsed and combined ranges. We might as well
5835          --  replace the alternatives list of the right operand of the
5836          --  membership test with the static predicate list, which will
5837          --  usually be more efficient.
5838
5839          declare
5840             New_Alts : constant List_Id := New_List;
5841             Old_Node : Node_Id;
5842             New_Node : Node_Id;
5843
5844          begin
5845             Old_Node := First (Plist);
5846             while Present (Old_Node) loop
5847                New_Node := New_Copy (Old_Node);
5848
5849                if Nkind (New_Node) = N_Range then
5850                   Set_Low_Bound  (New_Node, New_Copy (Low_Bound  (Old_Node)));
5851                   Set_High_Bound (New_Node, New_Copy (High_Bound (Old_Node)));
5852                end if;
5853
5854                Append_To (New_Alts, New_Node);
5855                Next (Old_Node);
5856             end loop;
5857
5858             --  If empty list, replace by False
5859
5860             if Is_Empty_List (New_Alts) then
5861                Rewrite (Expr, New_Occurrence_Of (Standard_False, Loc));
5862
5863             --  Else replace by set membership test
5864
5865             else
5866                Rewrite (Expr,
5867                  Make_In (Loc,
5868                    Left_Opnd    => Make_Identifier (Loc, Nam),
5869                    Right_Opnd   => Empty,
5870                    Alternatives => New_Alts));
5871
5872                --  Resolve new expression in function context
5873
5874                Install_Formals (Predicate_Function (Typ));
5875                Push_Scope (Predicate_Function (Typ));
5876                Analyze_And_Resolve (Expr, Standard_Boolean);
5877                Pop_Scope;
5878             end if;
5879          end;
5880       end;
5881
5882    --  If non-static, return doing nothing
5883
5884    exception
5885       when Non_Static =>
5886          return;
5887    end Build_Static_Predicate;
5888
5889    -----------------------------------------
5890    -- Check_Aspect_At_End_Of_Declarations --
5891    -----------------------------------------
5892
5893    procedure Check_Aspect_At_End_Of_Declarations (ASN : Node_Id) is
5894       Ent   : constant Entity_Id := Entity     (ASN);
5895       Ident : constant Node_Id   := Identifier (ASN);
5896
5897       Freeze_Expr : constant Node_Id := Expression (ASN);
5898       --  Expression from call to Check_Aspect_At_Freeze_Point
5899
5900       End_Decl_Expr : constant Node_Id := Entity (Ident);
5901       --  Expression to be analyzed at end of declarations
5902
5903       T : constant Entity_Id := Etype (Freeze_Expr);
5904       --  Type required for preanalyze call
5905
5906       A_Id : constant Aspect_Id := Get_Aspect_Id (Chars (Ident));
5907
5908       Err : Boolean;
5909       --  Set False if error
5910
5911       --  On entry to this procedure, Entity (Ident) contains a copy of the
5912       --  original expression from the aspect, saved for this purpose, and
5913       --  but Expression (Ident) is a preanalyzed copy of the expression,
5914       --  preanalyzed just after the freeze point.
5915
5916    begin
5917       --  Case of stream attributes, just have to compare entities
5918
5919       if A_Id = Aspect_Input  or else
5920          A_Id = Aspect_Output or else
5921          A_Id = Aspect_Read   or else
5922          A_Id = Aspect_Write
5923       then
5924          Analyze (End_Decl_Expr);
5925          Err := Entity (End_Decl_Expr) /= Entity (Freeze_Expr);
5926
5927       elsif A_Id = Aspect_Variable_Indexing or else
5928             A_Id = Aspect_Constant_Indexing or else
5929             A_Id = Aspect_Default_Iterator  or else
5930             A_Id = Aspect_Iterator_Element
5931       then
5932          --  Make type unfrozen before analysis, to prevent spurious errors
5933          --  about late attributes.
5934
5935          Set_Is_Frozen (Ent, False);
5936          Analyze (End_Decl_Expr);
5937          Analyze (Aspect_Rep_Item (ASN));
5938          Set_Is_Frozen (Ent, True);
5939
5940          --  If the end of declarations comes before any other freeze
5941          --  point, the Freeze_Expr is not analyzed: no check needed.
5942
5943          Err :=
5944            Analyzed (Freeze_Expr)
5945              and then not In_Instance
5946              and then Entity (End_Decl_Expr) /= Entity (Freeze_Expr);
5947
5948       --  All other cases
5949
5950       else
5951          --  In a generic context the aspect expressions have not been
5952          --  preanalyzed, so do it now. There are no conformance checks
5953          --  to perform in this case.
5954
5955          if No (T) then
5956             Check_Aspect_At_Freeze_Point (ASN);
5957             return;
5958          else
5959             Preanalyze_Spec_Expression (End_Decl_Expr, T);
5960          end if;
5961
5962          Err := not Fully_Conformant_Expressions (End_Decl_Expr, Freeze_Expr);
5963       end if;
5964
5965       --  Output error message if error
5966
5967       if Err then
5968          Error_Msg_NE
5969            ("visibility of aspect for& changes after freeze point",
5970             ASN, Ent);
5971          Error_Msg_NE
5972            ("?info: & is frozen here, aspects evaluated at this point",
5973             Freeze_Node (Ent), Ent);
5974       end if;
5975    end Check_Aspect_At_End_Of_Declarations;
5976
5977    ----------------------------------
5978    -- Check_Aspect_At_Freeze_Point --
5979    ----------------------------------
5980
5981    procedure Check_Aspect_At_Freeze_Point (ASN : Node_Id) is
5982       Ident : constant Node_Id := Identifier (ASN);
5983       --  Identifier (use Entity field to save expression)
5984
5985       T : Entity_Id;
5986       --  Type required for preanalyze call
5987
5988       A_Id : constant Aspect_Id := Get_Aspect_Id (Chars (Ident));
5989
5990    begin
5991       --  On entry to this procedure, Entity (Ident) contains a copy of the
5992       --  original expression from the aspect, saved for this purpose.
5993
5994       --  On exit from this procedure Entity (Ident) is unchanged, still
5995       --  containing that copy, but Expression (Ident) is a preanalyzed copy
5996       --  of the expression, preanalyzed just after the freeze point.
5997
5998       --  Make a copy of the expression to be preanalyed
5999
6000       Set_Expression (ASN, New_Copy_Tree (Entity (Ident)));
6001
6002       --  Find type for preanalyze call
6003
6004       case A_Id is
6005
6006          --  No_Aspect should be impossible
6007
6008          when No_Aspect =>
6009             raise Program_Error;
6010
6011          --  Library unit aspects should be impossible (never delayed)
6012
6013          when Library_Unit_Aspects =>
6014             raise Program_Error;
6015
6016          --  Aspects taking an optional boolean argument. Should be impossible
6017          --  since these are never delayed.
6018
6019          when Boolean_Aspects =>
6020             raise Program_Error;
6021
6022          --  Test_Case aspect applies to entries and subprograms, hence should
6023          --  never be delayed.
6024
6025          when Aspect_Test_Case =>
6026             raise Program_Error;
6027
6028          when Aspect_Attach_Handler =>
6029             T := RTE (RE_Interrupt_ID);
6030
6031          --  Default_Value is resolved with the type entity in question
6032
6033          when Aspect_Default_Value =>
6034             T := Entity (ASN);
6035
6036          --  Default_Component_Value is resolved with the component type
6037
6038          when Aspect_Default_Component_Value =>
6039             T := Component_Type (Entity (ASN));
6040
6041          --  Aspects corresponding to attribute definition clauses
6042
6043          when Aspect_Address =>
6044             T := RTE (RE_Address);
6045
6046          when Aspect_Bit_Order =>
6047             T := RTE (RE_Bit_Order);
6048
6049          when Aspect_CPU =>
6050             T := RTE (RE_CPU_Range);
6051
6052          when Aspect_Dispatching_Domain =>
6053             T := RTE (RE_Dispatching_Domain);
6054
6055          when Aspect_External_Tag =>
6056             T := Standard_String;
6057
6058          when Aspect_Priority | Aspect_Interrupt_Priority =>
6059             T := Standard_Integer;
6060
6061          when Aspect_Small =>
6062             T := Universal_Real;
6063
6064          when Aspect_Storage_Pool =>
6065             T := Class_Wide_Type (RTE (RE_Root_Storage_Pool));
6066
6067          when Aspect_Alignment      |
6068               Aspect_Component_Size |
6069               Aspect_Machine_Radix  |
6070               Aspect_Object_Size    |
6071               Aspect_Size           |
6072               Aspect_Storage_Size   |
6073               Aspect_Stream_Size    |
6074               Aspect_Value_Size     =>
6075             T := Any_Integer;
6076
6077          --  Stream attribute. Special case, the expression is just an entity
6078          --  that does not need any resolution, so just analyze.
6079
6080          when Aspect_Input  |
6081               Aspect_Output |
6082               Aspect_Read   |
6083               Aspect_Write  =>
6084             Analyze (Expression (ASN));
6085             return;
6086
6087          --  Same for Iterator aspects, where the expression is a function
6088          --  name. Legality rules are checked separately.
6089
6090          when Aspect_Constant_Indexing    |
6091               Aspect_Default_Iterator     |
6092               Aspect_Iterator_Element     |
6093               Aspect_Implicit_Dereference |
6094               Aspect_Variable_Indexing    =>
6095             Analyze (Expression (ASN));
6096             return;
6097
6098          --  Suppress/Unsuppress/Warnings should never be delayed
6099
6100          when Aspect_Suppress   |
6101               Aspect_Unsuppress |
6102               Aspect_Warnings   =>
6103             raise Program_Error;
6104
6105          --  Pre/Post/Invariant/Predicate take boolean expressions
6106
6107          when Aspect_Dynamic_Predicate |
6108               Aspect_Invariant         |
6109               Aspect_Pre               |
6110               Aspect_Precondition      |
6111               Aspect_Post              |
6112               Aspect_Postcondition     |
6113               Aspect_Predicate         |
6114               Aspect_Static_Predicate  |
6115               Aspect_Type_Invariant    =>
6116             T := Standard_Boolean;
6117
6118          when Aspect_Dimension        |
6119               Aspect_Dimension_System =>
6120             raise Program_Error;
6121
6122       end case;
6123
6124       --  Do the preanalyze call
6125
6126       Preanalyze_Spec_Expression (Expression (ASN), T);
6127    end Check_Aspect_At_Freeze_Point;
6128
6129    -----------------------------------
6130    -- Check_Constant_Address_Clause --
6131    -----------------------------------
6132
6133    procedure Check_Constant_Address_Clause
6134      (Expr  : Node_Id;
6135       U_Ent : Entity_Id)
6136    is
6137       procedure Check_At_Constant_Address (Nod : Node_Id);
6138       --  Checks that the given node N represents a name whose 'Address is
6139       --  constant (in the same sense as OK_Constant_Address_Clause, i.e. the
6140       --  address value is the same at the point of declaration of U_Ent and at
6141       --  the time of elaboration of the address clause.
6142
6143       procedure Check_Expr_Constants (Nod : Node_Id);
6144       --  Checks that Nod meets the requirements for a constant address clause
6145       --  in the sense of the enclosing procedure.
6146
6147       procedure Check_List_Constants (Lst : List_Id);
6148       --  Check that all elements of list Lst meet the requirements for a
6149       --  constant address clause in the sense of the enclosing procedure.
6150
6151       -------------------------------
6152       -- Check_At_Constant_Address --
6153       -------------------------------
6154
6155       procedure Check_At_Constant_Address (Nod : Node_Id) is
6156       begin
6157          if Is_Entity_Name (Nod) then
6158             if Present (Address_Clause (Entity ((Nod)))) then
6159                Error_Msg_NE
6160                  ("invalid address clause for initialized object &!",
6161                            Nod, U_Ent);
6162                Error_Msg_NE
6163                  ("address for& cannot" &
6164                     " depend on another address clause! (RM 13.1(22))!",
6165                   Nod, U_Ent);
6166
6167             elsif In_Same_Source_Unit (Entity (Nod), U_Ent)
6168               and then Sloc (U_Ent) < Sloc (Entity (Nod))
6169             then
6170                Error_Msg_NE
6171                  ("invalid address clause for initialized object &!",
6172                   Nod, U_Ent);
6173                Error_Msg_Node_2 := U_Ent;
6174                Error_Msg_NE
6175                  ("\& must be defined before & (RM 13.1(22))!",
6176                   Nod, Entity (Nod));
6177             end if;
6178
6179          elsif Nkind (Nod) = N_Selected_Component then
6180             declare
6181                T : constant Entity_Id := Etype (Prefix (Nod));
6182
6183             begin
6184                if (Is_Record_Type (T)
6185                     and then Has_Discriminants (T))
6186                  or else
6187                   (Is_Access_Type (T)
6188                      and then Is_Record_Type (Designated_Type (T))
6189                      and then Has_Discriminants (Designated_Type (T)))
6190                then
6191                   Error_Msg_NE
6192                     ("invalid address clause for initialized object &!",
6193                      Nod, U_Ent);
6194                   Error_Msg_N
6195                     ("\address cannot depend on component" &
6196                      " of discriminated record (RM 13.1(22))!",
6197                      Nod);
6198                else
6199                   Check_At_Constant_Address (Prefix (Nod));
6200                end if;
6201             end;
6202
6203          elsif Nkind (Nod) = N_Indexed_Component then
6204             Check_At_Constant_Address (Prefix (Nod));
6205             Check_List_Constants (Expressions (Nod));
6206
6207          else
6208             Check_Expr_Constants (Nod);
6209          end if;
6210       end Check_At_Constant_Address;
6211
6212       --------------------------
6213       -- Check_Expr_Constants --
6214       --------------------------
6215
6216       procedure Check_Expr_Constants (Nod : Node_Id) is
6217          Loc_U_Ent : constant Source_Ptr := Sloc (U_Ent);
6218          Ent       : Entity_Id           := Empty;
6219
6220       begin
6221          if Nkind (Nod) in N_Has_Etype
6222            and then Etype (Nod) = Any_Type
6223          then
6224             return;
6225          end if;
6226
6227          case Nkind (Nod) is
6228             when N_Empty | N_Error =>
6229                return;
6230
6231             when N_Identifier | N_Expanded_Name =>
6232                Ent := Entity (Nod);
6233
6234                --  We need to look at the original node if it is different
6235                --  from the node, since we may have rewritten things and
6236                --  substituted an identifier representing the rewrite.
6237
6238                if Original_Node (Nod) /= Nod then
6239                   Check_Expr_Constants (Original_Node (Nod));
6240
6241                   --  If the node is an object declaration without initial
6242                   --  value, some code has been expanded, and the expression
6243                   --  is not constant, even if the constituents might be
6244                   --  acceptable, as in A'Address + offset.
6245
6246                   if Ekind (Ent) = E_Variable
6247                     and then
6248                       Nkind (Declaration_Node (Ent)) = N_Object_Declaration
6249                     and then
6250                       No (Expression (Declaration_Node (Ent)))
6251                   then
6252                      Error_Msg_NE
6253                        ("invalid address clause for initialized object &!",
6254                         Nod, U_Ent);
6255
6256                   --  If entity is constant, it may be the result of expanding
6257                   --  a check. We must verify that its declaration appears
6258                   --  before the object in question, else we also reject the
6259                   --  address clause.
6260
6261                   elsif Ekind (Ent) = E_Constant
6262                     and then In_Same_Source_Unit (Ent, U_Ent)
6263                     and then Sloc (Ent) > Loc_U_Ent
6264                   then
6265                      Error_Msg_NE
6266                        ("invalid address clause for initialized object &!",
6267                         Nod, U_Ent);
6268                   end if;
6269
6270                   return;
6271                end if;
6272
6273                --  Otherwise look at the identifier and see if it is OK
6274
6275                if Ekind_In (Ent, E_Named_Integer, E_Named_Real)
6276                  or else Is_Type (Ent)
6277                then
6278                   return;
6279
6280                elsif
6281                   Ekind (Ent) = E_Constant
6282                     or else
6283                   Ekind (Ent) = E_In_Parameter
6284                then
6285                   --  This is the case where we must have Ent defined before
6286                   --  U_Ent. Clearly if they are in different units this
6287                   --  requirement is met since the unit containing Ent is
6288                   --  already processed.
6289
6290                   if not In_Same_Source_Unit (Ent, U_Ent) then
6291                      return;
6292
6293                   --  Otherwise location of Ent must be before the location
6294                   --  of U_Ent, that's what prior defined means.
6295
6296                   elsif Sloc (Ent) < Loc_U_Ent then
6297                      return;
6298
6299                   else
6300                      Error_Msg_NE
6301                        ("invalid address clause for initialized object &!",
6302                         Nod, U_Ent);
6303                      Error_Msg_Node_2 := U_Ent;
6304                      Error_Msg_NE
6305                        ("\& must be defined before & (RM 13.1(22))!",
6306                         Nod, Ent);
6307                   end if;
6308
6309                elsif Nkind (Original_Node (Nod)) = N_Function_Call then
6310                   Check_Expr_Constants (Original_Node (Nod));
6311
6312                else
6313                   Error_Msg_NE
6314                     ("invalid address clause for initialized object &!",
6315                      Nod, U_Ent);
6316
6317                   if Comes_From_Source (Ent) then
6318                      Error_Msg_NE
6319                        ("\reference to variable& not allowed"
6320                           & " (RM 13.1(22))!", Nod, Ent);
6321                   else
6322                      Error_Msg_N
6323                        ("non-static expression not allowed"
6324                           & " (RM 13.1(22))!", Nod);
6325                   end if;
6326                end if;
6327
6328             when N_Integer_Literal   =>
6329
6330                --  If this is a rewritten unchecked conversion, in a system
6331                --  where Address is an integer type, always use the base type
6332                --  for a literal value. This is user-friendly and prevents
6333                --  order-of-elaboration issues with instances of unchecked
6334                --  conversion.
6335
6336                if Nkind (Original_Node (Nod)) = N_Function_Call then
6337                   Set_Etype (Nod, Base_Type (Etype (Nod)));
6338                end if;
6339
6340             when N_Real_Literal      |
6341                  N_String_Literal    |
6342                  N_Character_Literal =>
6343                return;
6344
6345             when N_Range =>
6346                Check_Expr_Constants (Low_Bound (Nod));
6347                Check_Expr_Constants (High_Bound (Nod));
6348
6349             when N_Explicit_Dereference =>
6350                Check_Expr_Constants (Prefix (Nod));
6351
6352             when N_Indexed_Component =>
6353                Check_Expr_Constants (Prefix (Nod));
6354                Check_List_Constants (Expressions (Nod));
6355
6356             when N_Slice =>
6357                Check_Expr_Constants (Prefix (Nod));
6358                Check_Expr_Constants (Discrete_Range (Nod));
6359
6360             when N_Selected_Component =>
6361                Check_Expr_Constants (Prefix (Nod));
6362
6363             when N_Attribute_Reference =>
6364                if Attribute_Name (Nod) = Name_Address
6365                    or else
6366                   Attribute_Name (Nod) = Name_Access
6367                     or else
6368                   Attribute_Name (Nod) = Name_Unchecked_Access
6369                     or else
6370                   Attribute_Name (Nod) = Name_Unrestricted_Access
6371                then
6372                   Check_At_Constant_Address (Prefix (Nod));
6373
6374                else
6375                   Check_Expr_Constants (Prefix (Nod));
6376                   Check_List_Constants (Expressions (Nod));
6377                end if;
6378
6379             when N_Aggregate =>
6380                Check_List_Constants (Component_Associations (Nod));
6381                Check_List_Constants (Expressions (Nod));
6382
6383             when N_Component_Association =>
6384                Check_Expr_Constants (Expression (Nod));
6385
6386             when N_Extension_Aggregate =>
6387                Check_Expr_Constants (Ancestor_Part (Nod));
6388                Check_List_Constants (Component_Associations (Nod));
6389                Check_List_Constants (Expressions (Nod));
6390
6391             when N_Null =>
6392                return;
6393
6394             when N_Binary_Op | N_Short_Circuit | N_Membership_Test =>
6395                Check_Expr_Constants (Left_Opnd (Nod));
6396                Check_Expr_Constants (Right_Opnd (Nod));
6397
6398             when N_Unary_Op =>
6399                Check_Expr_Constants (Right_Opnd (Nod));
6400
6401             when N_Type_Conversion           |
6402                  N_Qualified_Expression      |
6403                  N_Allocator                 =>
6404                Check_Expr_Constants (Expression (Nod));
6405
6406             when N_Unchecked_Type_Conversion =>
6407                Check_Expr_Constants (Expression (Nod));
6408
6409                --  If this is a rewritten unchecked conversion, subtypes in
6410                --  this node are those created within the instance. To avoid
6411                --  order of elaboration issues, replace them with their base
6412                --  types. Note that address clauses can cause order of
6413                --  elaboration problems because they are elaborated by the
6414                --  back-end at the point of definition, and may mention
6415                --  entities declared in between (as long as everything is
6416                --  static). It is user-friendly to allow unchecked conversions
6417                --  in this context.
6418
6419                if Nkind (Original_Node (Nod)) = N_Function_Call then
6420                   Set_Etype (Expression (Nod),
6421                     Base_Type (Etype (Expression (Nod))));
6422                   Set_Etype (Nod, Base_Type (Etype (Nod)));
6423                end if;
6424
6425             when N_Function_Call =>
6426                if not Is_Pure (Entity (Name (Nod))) then
6427                   Error_Msg_NE
6428                     ("invalid address clause for initialized object &!",
6429                      Nod, U_Ent);
6430
6431                   Error_Msg_NE
6432                     ("\function & is not pure (RM 13.1(22))!",
6433                      Nod, Entity (Name (Nod)));
6434
6435                else
6436                   Check_List_Constants (Parameter_Associations (Nod));
6437                end if;
6438
6439             when N_Parameter_Association =>
6440                Check_Expr_Constants (Explicit_Actual_Parameter (Nod));
6441
6442             when others =>
6443                Error_Msg_NE
6444                  ("invalid address clause for initialized object &!",
6445                   Nod, U_Ent);
6446                Error_Msg_NE
6447                  ("\must be constant defined before& (RM 13.1(22))!",
6448                   Nod, U_Ent);
6449          end case;
6450       end Check_Expr_Constants;
6451
6452       --------------------------
6453       -- Check_List_Constants --
6454       --------------------------
6455
6456       procedure Check_List_Constants (Lst : List_Id) is
6457          Nod1 : Node_Id;
6458
6459       begin
6460          if Present (Lst) then
6461             Nod1 := First (Lst);
6462             while Present (Nod1) loop
6463                Check_Expr_Constants (Nod1);
6464                Next (Nod1);
6465             end loop;
6466          end if;
6467       end Check_List_Constants;
6468
6469    --  Start of processing for Check_Constant_Address_Clause
6470
6471    begin
6472       --  If rep_clauses are to be ignored, no need for legality checks. In
6473       --  particular, no need to pester user about rep clauses that violate
6474       --  the rule on constant addresses, given that these clauses will be
6475       --  removed by Freeze before they reach the back end.
6476
6477       if not Ignore_Rep_Clauses then
6478          Check_Expr_Constants (Expr);
6479       end if;
6480    end Check_Constant_Address_Clause;
6481
6482    ----------------------------------------
6483    -- Check_Record_Representation_Clause --
6484    ----------------------------------------
6485
6486    procedure Check_Record_Representation_Clause (N : Node_Id) is
6487       Loc     : constant Source_Ptr := Sloc (N);
6488       Ident   : constant Node_Id    := Identifier (N);
6489       Rectype : Entity_Id;
6490       Fent    : Entity_Id;
6491       CC      : Node_Id;
6492       Fbit    : Uint;
6493       Lbit    : Uint;
6494       Hbit    : Uint := Uint_0;
6495       Comp    : Entity_Id;
6496       Pcomp   : Entity_Id;
6497
6498       Max_Bit_So_Far : Uint;
6499       --  Records the maximum bit position so far. If all field positions
6500       --  are monotonically increasing, then we can skip the circuit for
6501       --  checking for overlap, since no overlap is possible.
6502
6503       Tagged_Parent : Entity_Id := Empty;
6504       --  This is set in the case of a derived tagged type for which we have
6505       --  Is_Fully_Repped_Tagged_Type True (indicating that all components are
6506       --  positioned by record representation clauses). In this case we must
6507       --  check for overlap between components of this tagged type, and the
6508       --  components of its parent. Tagged_Parent will point to this parent
6509       --  type. For all other cases Tagged_Parent is left set to Empty.
6510
6511       Parent_Last_Bit : Uint;
6512       --  Relevant only if Tagged_Parent is set, Parent_Last_Bit indicates the
6513       --  last bit position for any field in the parent type. We only need to
6514       --  check overlap for fields starting below this point.
6515
6516       Overlap_Check_Required : Boolean;
6517       --  Used to keep track of whether or not an overlap check is required
6518
6519       Overlap_Detected : Boolean := False;
6520       --  Set True if an overlap is detected
6521
6522       Ccount : Natural := 0;
6523       --  Number of component clauses in record rep clause
6524
6525       procedure Check_Component_Overlap (C1_Ent, C2_Ent : Entity_Id);
6526       --  Given two entities for record components or discriminants, checks
6527       --  if they have overlapping component clauses and issues errors if so.
6528
6529       procedure Find_Component;
6530       --  Finds component entity corresponding to current component clause (in
6531       --  CC), and sets Comp to the entity, and Fbit/Lbit to the zero origin
6532       --  start/stop bits for the field. If there is no matching component or
6533       --  if the matching component does not have a component clause, then
6534       --  that's an error and Comp is set to Empty, but no error message is
6535       --  issued, since the message was already given. Comp is also set to
6536       --  Empty if the current "component clause" is in fact a pragma.
6537
6538       -----------------------------
6539       -- Check_Component_Overlap --
6540       -----------------------------
6541
6542       procedure Check_Component_Overlap (C1_Ent, C2_Ent : Entity_Id) is
6543          CC1 : constant Node_Id := Component_Clause (C1_Ent);
6544          CC2 : constant Node_Id := Component_Clause (C2_Ent);
6545
6546       begin
6547          if Present (CC1) and then Present (CC2) then
6548
6549             --  Exclude odd case where we have two tag fields in the same
6550             --  record, both at location zero. This seems a bit strange, but
6551             --  it seems to happen in some circumstances, perhaps on an error.
6552
6553             if Chars (C1_Ent) = Name_uTag
6554                  and then
6555                Chars (C2_Ent) = Name_uTag
6556             then
6557                return;
6558             end if;
6559
6560             --  Here we check if the two fields overlap
6561
6562             declare
6563                S1 : constant Uint := Component_Bit_Offset (C1_Ent);
6564                S2 : constant Uint := Component_Bit_Offset (C2_Ent);
6565                E1 : constant Uint := S1 + Esize (C1_Ent);
6566                E2 : constant Uint := S2 + Esize (C2_Ent);
6567
6568             begin
6569                if E2 <= S1 or else E1 <= S2 then
6570                   null;
6571                else
6572                   Error_Msg_Node_2 := Component_Name (CC2);
6573                   Error_Msg_Sloc := Sloc (Error_Msg_Node_2);
6574                   Error_Msg_Node_1 := Component_Name (CC1);
6575                   Error_Msg_N
6576                     ("component& overlaps & #", Component_Name (CC1));
6577                   Overlap_Detected := True;
6578                end if;
6579             end;
6580          end if;
6581       end Check_Component_Overlap;
6582
6583       --------------------
6584       -- Find_Component --
6585       --------------------
6586
6587       procedure Find_Component is
6588
6589          procedure Search_Component (R : Entity_Id);
6590          --  Search components of R for a match. If found, Comp is set.
6591
6592          ----------------------
6593          -- Search_Component --
6594          ----------------------
6595
6596          procedure Search_Component (R : Entity_Id) is
6597          begin
6598             Comp := First_Component_Or_Discriminant (R);
6599             while Present (Comp) loop
6600
6601                --  Ignore error of attribute name for component name (we
6602                --  already gave an error message for this, so no need to
6603                --  complain here)
6604
6605                if Nkind (Component_Name (CC)) = N_Attribute_Reference then
6606                   null;
6607                else
6608                   exit when Chars (Comp) = Chars (Component_Name (CC));
6609                end if;
6610
6611                Next_Component_Or_Discriminant (Comp);
6612             end loop;
6613          end Search_Component;
6614
6615       --  Start of processing for Find_Component
6616
6617       begin
6618          --  Return with Comp set to Empty if we have a pragma
6619
6620          if Nkind (CC) = N_Pragma then
6621             Comp := Empty;
6622             return;
6623          end if;
6624
6625          --  Search current record for matching component
6626
6627          Search_Component (Rectype);
6628
6629          --  If not found, maybe component of base type that is absent from
6630          --  statically constrained first subtype.
6631
6632          if No (Comp) then
6633             Search_Component (Base_Type (Rectype));
6634          end if;
6635
6636          --  If no component, or the component does not reference the component
6637          --  clause in question, then there was some previous error for which
6638          --  we already gave a message, so just return with Comp Empty.
6639
6640          if No (Comp)
6641            or else Component_Clause (Comp) /= CC
6642          then
6643             Comp := Empty;
6644
6645          --  Normal case where we have a component clause
6646
6647          else
6648             Fbit := Component_Bit_Offset (Comp);
6649             Lbit := Fbit + Esize (Comp) - 1;
6650          end if;
6651       end Find_Component;
6652
6653    --  Start of processing for Check_Record_Representation_Clause
6654
6655    begin
6656       Find_Type (Ident);
6657       Rectype := Entity (Ident);
6658
6659       if Rectype = Any_Type then
6660          return;
6661       else
6662          Rectype := Underlying_Type (Rectype);
6663       end if;
6664
6665       --  See if we have a fully repped derived tagged type
6666
6667       declare
6668          PS : constant Entity_Id := Parent_Subtype (Rectype);
6669
6670       begin
6671          if Present (PS) and then Is_Fully_Repped_Tagged_Type (PS) then
6672             Tagged_Parent := PS;
6673
6674             --  Find maximum bit of any component of the parent type
6675
6676             Parent_Last_Bit := UI_From_Int (System_Address_Size - 1);
6677             Pcomp := First_Entity (Tagged_Parent);
6678             while Present (Pcomp) loop
6679                if Ekind_In (Pcomp, E_Discriminant, E_Component) then
6680                   if Component_Bit_Offset (Pcomp) /= No_Uint
6681                     and then Known_Static_Esize (Pcomp)
6682                   then
6683                      Parent_Last_Bit :=
6684                        UI_Max
6685                          (Parent_Last_Bit,
6686                           Component_Bit_Offset (Pcomp) + Esize (Pcomp) - 1);
6687                   end if;
6688
6689                   Next_Entity (Pcomp);
6690                end if;
6691             end loop;
6692          end if;
6693       end;
6694
6695       --  All done if no component clauses
6696
6697       CC := First (Component_Clauses (N));
6698
6699       if No (CC) then
6700          return;
6701       end if;
6702
6703       --  If a tag is present, then create a component clause that places it
6704       --  at the start of the record (otherwise gigi may place it after other
6705       --  fields that have rep clauses).
6706
6707       Fent := First_Entity (Rectype);
6708
6709       if Nkind (Fent) = N_Defining_Identifier
6710         and then Chars (Fent) = Name_uTag
6711       then
6712          Set_Component_Bit_Offset    (Fent, Uint_0);
6713          Set_Normalized_Position     (Fent, Uint_0);
6714          Set_Normalized_First_Bit    (Fent, Uint_0);
6715          Set_Normalized_Position_Max (Fent, Uint_0);
6716          Init_Esize                  (Fent, System_Address_Size);
6717
6718          Set_Component_Clause (Fent,
6719            Make_Component_Clause (Loc,
6720              Component_Name => Make_Identifier (Loc, Name_uTag),
6721
6722              Position  => Make_Integer_Literal (Loc, Uint_0),
6723              First_Bit => Make_Integer_Literal (Loc, Uint_0),
6724              Last_Bit  =>
6725                Make_Integer_Literal (Loc,
6726                  UI_From_Int (System_Address_Size))));
6727
6728          Ccount := Ccount + 1;
6729       end if;
6730
6731       Max_Bit_So_Far := Uint_Minus_1;
6732       Overlap_Check_Required := False;
6733
6734       --  Process the component clauses
6735
6736       while Present (CC) loop
6737          Find_Component;
6738
6739          if Present (Comp) then
6740             Ccount := Ccount + 1;
6741
6742             --  We need a full overlap check if record positions non-monotonic
6743
6744             if Fbit <= Max_Bit_So_Far then
6745                Overlap_Check_Required := True;
6746             end if;
6747
6748             Max_Bit_So_Far := Lbit;
6749
6750             --  Check bit position out of range of specified size
6751
6752             if Has_Size_Clause (Rectype)
6753               and then RM_Size (Rectype) <= Lbit
6754             then
6755                Error_Msg_N
6756                  ("bit number out of range of specified size",
6757                   Last_Bit (CC));
6758
6759                --  Check for overlap with tag field
6760
6761             else
6762                if Is_Tagged_Type (Rectype)
6763                  and then Fbit < System_Address_Size
6764                then
6765                   Error_Msg_NE
6766                     ("component overlaps tag field of&",
6767                      Component_Name (CC), Rectype);
6768                   Overlap_Detected := True;
6769                end if;
6770
6771                if Hbit < Lbit then
6772                   Hbit := Lbit;
6773                end if;
6774             end if;
6775
6776             --  Check parent overlap if component might overlap parent field
6777
6778             if Present (Tagged_Parent)
6779               and then Fbit <= Parent_Last_Bit
6780             then
6781                Pcomp := First_Component_Or_Discriminant (Tagged_Parent);
6782                while Present (Pcomp) loop
6783                   if not Is_Tag (Pcomp)
6784                     and then Chars (Pcomp) /= Name_uParent
6785                   then
6786                      Check_Component_Overlap (Comp, Pcomp);
6787                   end if;
6788
6789                   Next_Component_Or_Discriminant (Pcomp);
6790                end loop;
6791             end if;
6792          end if;
6793
6794          Next (CC);
6795       end loop;
6796
6797       --  Now that we have processed all the component clauses, check for
6798       --  overlap. We have to leave this till last, since the components can
6799       --  appear in any arbitrary order in the representation clause.
6800
6801       --  We do not need this check if all specified ranges were monotonic,
6802       --  as recorded by Overlap_Check_Required being False at this stage.
6803
6804       --  This first section checks if there are any overlapping entries at
6805       --  all. It does this by sorting all entries and then seeing if there are
6806       --  any overlaps. If there are none, then that is decisive, but if there
6807       --  are overlaps, they may still be OK (they may result from fields in
6808       --  different variants).
6809
6810       if Overlap_Check_Required then
6811          Overlap_Check1 : declare
6812
6813             OC_Fbit : array (0 .. Ccount) of Uint;
6814             --  First-bit values for component clauses, the value is the offset
6815             --  of the first bit of the field from start of record. The zero
6816             --  entry is for use in sorting.
6817
6818             OC_Lbit : array (0 .. Ccount) of Uint;
6819             --  Last-bit values for component clauses, the value is the offset
6820             --  of the last bit of the field from start of record. The zero
6821             --  entry is for use in sorting.
6822
6823             OC_Count : Natural := 0;
6824             --  Count of entries in OC_Fbit and OC_Lbit
6825
6826             function OC_Lt (Op1, Op2 : Natural) return Boolean;
6827             --  Compare routine for Sort
6828
6829             procedure OC_Move (From : Natural; To : Natural);
6830             --  Move routine for Sort
6831
6832             package Sorting is new GNAT.Heap_Sort_G (OC_Move, OC_Lt);
6833
6834             -----------
6835             -- OC_Lt --
6836             -----------
6837
6838             function OC_Lt (Op1, Op2 : Natural) return Boolean is
6839             begin
6840                return OC_Fbit (Op1) < OC_Fbit (Op2);
6841             end OC_Lt;
6842
6843             -------------
6844             -- OC_Move --
6845             -------------
6846
6847             procedure OC_Move (From : Natural; To : Natural) is
6848             begin
6849                OC_Fbit (To) := OC_Fbit (From);
6850                OC_Lbit (To) := OC_Lbit (From);
6851             end OC_Move;
6852
6853             --  Start of processing for Overlap_Check
6854
6855          begin
6856             CC := First (Component_Clauses (N));
6857             while Present (CC) loop
6858
6859                --  Exclude component clause already marked in error
6860
6861                if not Error_Posted (CC) then
6862                   Find_Component;
6863
6864                   if Present (Comp) then
6865                      OC_Count := OC_Count + 1;
6866                      OC_Fbit (OC_Count) := Fbit;
6867                      OC_Lbit (OC_Count) := Lbit;
6868                   end if;
6869                end if;
6870
6871                Next (CC);
6872             end loop;
6873
6874             Sorting.Sort (OC_Count);
6875
6876             Overlap_Check_Required := False;
6877             for J in 1 .. OC_Count - 1 loop
6878                if OC_Lbit (J) >= OC_Fbit (J + 1) then
6879                   Overlap_Check_Required := True;
6880                   exit;
6881                end if;
6882             end loop;
6883          end Overlap_Check1;
6884       end if;
6885
6886       --  If Overlap_Check_Required is still True, then we have to do the full
6887       --  scale overlap check, since we have at least two fields that do
6888       --  overlap, and we need to know if that is OK since they are in
6889       --  different variant, or whether we have a definite problem.
6890
6891       if Overlap_Check_Required then
6892          Overlap_Check2 : declare
6893             C1_Ent, C2_Ent : Entity_Id;
6894             --  Entities of components being checked for overlap
6895
6896             Clist : Node_Id;
6897             --  Component_List node whose Component_Items are being checked
6898
6899             Citem : Node_Id;
6900             --  Component declaration for component being checked
6901
6902          begin
6903             C1_Ent := First_Entity (Base_Type (Rectype));
6904
6905             --  Loop through all components in record. For each component check
6906             --  for overlap with any of the preceding elements on the component
6907             --  list containing the component and also, if the component is in
6908             --  a variant, check against components outside the case structure.
6909             --  This latter test is repeated recursively up the variant tree.
6910
6911             Main_Component_Loop : while Present (C1_Ent) loop
6912                if not Ekind_In (C1_Ent, E_Component, E_Discriminant) then
6913                   goto Continue_Main_Component_Loop;
6914                end if;
6915
6916                --  Skip overlap check if entity has no declaration node. This
6917                --  happens with discriminants in constrained derived types.
6918                --  Possibly we are missing some checks as a result, but that
6919                --  does not seem terribly serious.
6920
6921                if No (Declaration_Node (C1_Ent)) then
6922                   goto Continue_Main_Component_Loop;
6923                end if;
6924
6925                Clist := Parent (List_Containing (Declaration_Node (C1_Ent)));
6926
6927                --  Loop through component lists that need checking. Check the
6928                --  current component list and all lists in variants above us.
6929
6930                Component_List_Loop : loop
6931
6932                   --  If derived type definition, go to full declaration
6933                   --  If at outer level, check discriminants if there are any.
6934
6935                   if Nkind (Clist) = N_Derived_Type_Definition then
6936                      Clist := Parent (Clist);
6937                   end if;
6938
6939                   --  Outer level of record definition, check discriminants
6940
6941                   if Nkind_In (Clist, N_Full_Type_Declaration,
6942                                N_Private_Type_Declaration)
6943                   then
6944                      if Has_Discriminants (Defining_Identifier (Clist)) then
6945                         C2_Ent :=
6946                           First_Discriminant (Defining_Identifier (Clist));
6947                         while Present (C2_Ent) loop
6948                            exit when C1_Ent = C2_Ent;
6949                            Check_Component_Overlap (C1_Ent, C2_Ent);
6950                            Next_Discriminant (C2_Ent);
6951                         end loop;
6952                      end if;
6953
6954                      --  Record extension case
6955
6956                   elsif Nkind (Clist) = N_Derived_Type_Definition then
6957                      Clist := Empty;
6958
6959                      --  Otherwise check one component list
6960
6961                   else
6962                      Citem := First (Component_Items (Clist));
6963                      while Present (Citem) loop
6964                         if Nkind (Citem) = N_Component_Declaration then
6965                            C2_Ent := Defining_Identifier (Citem);
6966                            exit when C1_Ent = C2_Ent;
6967                            Check_Component_Overlap (C1_Ent, C2_Ent);
6968                         end if;
6969
6970                         Next (Citem);
6971                      end loop;
6972                   end if;
6973
6974                   --  Check for variants above us (the parent of the Clist can
6975                   --  be a variant, in which case its parent is a variant part,
6976                   --  and the parent of the variant part is a component list
6977                   --  whose components must all be checked against the current
6978                   --  component for overlap).
6979
6980                   if Nkind (Parent (Clist)) = N_Variant then
6981                      Clist := Parent (Parent (Parent (Clist)));
6982
6983                      --  Check for possible discriminant part in record, this
6984                      --  is treated essentially as another level in the
6985                      --  recursion. For this case the parent of the component
6986                      --  list is the record definition, and its parent is the
6987                      --  full type declaration containing the discriminant
6988                      --  specifications.
6989
6990                   elsif Nkind (Parent (Clist)) = N_Record_Definition then
6991                      Clist := Parent (Parent ((Clist)));
6992
6993                      --  If neither of these two cases, we are at the top of
6994                      --  the tree.
6995
6996                   else
6997                      exit Component_List_Loop;
6998                   end if;
6999                end loop Component_List_Loop;
7000
7001                <<Continue_Main_Component_Loop>>
7002                Next_Entity (C1_Ent);
7003
7004             end loop Main_Component_Loop;
7005          end Overlap_Check2;
7006       end if;
7007
7008       --  The following circuit deals with warning on record holes (gaps). We
7009       --  skip this check if overlap was detected, since it makes sense for the
7010       --  programmer to fix this illegality before worrying about warnings.
7011
7012       if not Overlap_Detected and Warn_On_Record_Holes then
7013          Record_Hole_Check : declare
7014             Decl : constant Node_Id := Declaration_Node (Base_Type (Rectype));
7015             --  Full declaration of record type
7016
7017             procedure Check_Component_List
7018               (CL   : Node_Id;
7019                Sbit : Uint;
7020                DS   : List_Id);
7021             --  Check component list CL for holes. The starting bit should be
7022             --  Sbit. which is zero for the main record component list and set
7023             --  appropriately for recursive calls for variants. DS is set to
7024             --  a list of discriminant specifications to be included in the
7025             --  consideration of components. It is No_List if none to consider.
7026
7027             --------------------------
7028             -- Check_Component_List --
7029             --------------------------
7030
7031             procedure Check_Component_List
7032               (CL   : Node_Id;
7033                Sbit : Uint;
7034                DS   : List_Id)
7035             is
7036                Compl : Integer;
7037
7038             begin
7039                Compl := Integer (List_Length (Component_Items (CL)));
7040
7041                if DS /= No_List then
7042                   Compl := Compl + Integer (List_Length (DS));
7043                end if;
7044
7045                declare
7046                   Comps : array (Natural range 0 .. Compl) of Entity_Id;
7047                   --  Gather components (zero entry is for sort routine)
7048
7049                   Ncomps : Natural := 0;
7050                   --  Number of entries stored in Comps (starting at Comps (1))
7051
7052                   Citem : Node_Id;
7053                   --  One component item or discriminant specification
7054
7055                   Nbit  : Uint;
7056                   --  Starting bit for next component
7057
7058                   CEnt  : Entity_Id;
7059                   --  Component entity
7060
7061                   Variant : Node_Id;
7062                   --  One variant
7063
7064                   function Lt (Op1, Op2 : Natural) return Boolean;
7065                   --  Compare routine for Sort
7066
7067                   procedure Move (From : Natural; To : Natural);
7068                   --  Move routine for Sort
7069
7070                   package Sorting is new GNAT.Heap_Sort_G (Move, Lt);
7071
7072                   --------
7073                   -- Lt --
7074                   --------
7075
7076                   function Lt (Op1, Op2 : Natural) return Boolean is
7077                   begin
7078                      return Component_Bit_Offset (Comps (Op1))
7079                        <
7080                        Component_Bit_Offset (Comps (Op2));
7081                   end Lt;
7082
7083                   ----------
7084                   -- Move --
7085                   ----------
7086
7087                   procedure Move (From : Natural; To : Natural) is
7088                   begin
7089                      Comps (To) := Comps (From);
7090                   end Move;
7091
7092                begin
7093                   --  Gather discriminants into Comp
7094
7095                   if DS /= No_List then
7096                      Citem := First (DS);
7097                      while Present (Citem) loop
7098                         if Nkind (Citem) = N_Discriminant_Specification then
7099                            declare
7100                               Ent : constant Entity_Id :=
7101                                       Defining_Identifier (Citem);
7102                            begin
7103                               if Ekind (Ent) = E_Discriminant then
7104                                  Ncomps := Ncomps + 1;
7105                                  Comps (Ncomps) := Ent;
7106                               end if;
7107                            end;
7108                         end if;
7109
7110                         Next (Citem);
7111                      end loop;
7112                   end if;
7113
7114                   --  Gather component entities into Comp
7115
7116                   Citem := First (Component_Items (CL));
7117                   while Present (Citem) loop
7118                      if Nkind (Citem) = N_Component_Declaration then
7119                         Ncomps := Ncomps + 1;
7120                         Comps (Ncomps) := Defining_Identifier (Citem);
7121                      end if;
7122
7123                      Next (Citem);
7124                   end loop;
7125
7126                   --  Now sort the component entities based on the first bit.
7127                   --  Note we already know there are no overlapping components.
7128
7129                   Sorting.Sort (Ncomps);
7130
7131                   --  Loop through entries checking for holes
7132
7133                   Nbit := Sbit;
7134                   for J in 1 .. Ncomps loop
7135                      CEnt := Comps (J);
7136                      Error_Msg_Uint_1 := Component_Bit_Offset (CEnt) - Nbit;
7137
7138                      if Error_Msg_Uint_1 > 0 then
7139                         Error_Msg_NE
7140                           ("?^-bit gap before component&",
7141                            Component_Name (Component_Clause (CEnt)), CEnt);
7142                      end if;
7143
7144                      Nbit := Component_Bit_Offset (CEnt) + Esize (CEnt);
7145                   end loop;
7146
7147                   --  Process variant parts recursively if present
7148
7149                   if Present (Variant_Part (CL)) then
7150                      Variant := First (Variants (Variant_Part (CL)));
7151                      while Present (Variant) loop
7152                         Check_Component_List
7153                           (Component_List (Variant), Nbit, No_List);
7154                         Next (Variant);
7155                      end loop;
7156                   end if;
7157                end;
7158             end Check_Component_List;
7159
7160          --  Start of processing for Record_Hole_Check
7161
7162          begin
7163             declare
7164                Sbit : Uint;
7165
7166             begin
7167                if Is_Tagged_Type (Rectype) then
7168                   Sbit := UI_From_Int (System_Address_Size);
7169                else
7170                   Sbit := Uint_0;
7171                end if;
7172
7173                if Nkind (Decl) = N_Full_Type_Declaration
7174                  and then Nkind (Type_Definition (Decl)) = N_Record_Definition
7175                then
7176                   Check_Component_List
7177                     (Component_List (Type_Definition (Decl)),
7178                      Sbit,
7179                      Discriminant_Specifications (Decl));
7180                end if;
7181             end;
7182          end Record_Hole_Check;
7183       end if;
7184
7185       --  For records that have component clauses for all components, and whose
7186       --  size is less than or equal to 32, we need to know the size in the
7187       --  front end to activate possible packed array processing where the
7188       --  component type is a record.
7189
7190       --  At this stage Hbit + 1 represents the first unused bit from all the
7191       --  component clauses processed, so if the component clauses are
7192       --  complete, then this is the length of the record.
7193
7194       --  For records longer than System.Storage_Unit, and for those where not
7195       --  all components have component clauses, the back end determines the
7196       --  length (it may for example be appropriate to round up the size
7197       --  to some convenient boundary, based on alignment considerations, etc).
7198
7199       if Unknown_RM_Size (Rectype) and then Hbit + 1 <= 32 then
7200
7201          --  Nothing to do if at least one component has no component clause
7202
7203          Comp := First_Component_Or_Discriminant (Rectype);
7204          while Present (Comp) loop
7205             exit when No (Component_Clause (Comp));
7206             Next_Component_Or_Discriminant (Comp);
7207          end loop;
7208
7209          --  If we fall out of loop, all components have component clauses
7210          --  and so we can set the size to the maximum value.
7211
7212          if No (Comp) then
7213             Set_RM_Size (Rectype, Hbit + 1);
7214          end if;
7215       end if;
7216    end Check_Record_Representation_Clause;
7217
7218    ----------------
7219    -- Check_Size --
7220    ----------------
7221
7222    procedure Check_Size
7223      (N      : Node_Id;
7224       T      : Entity_Id;
7225       Siz    : Uint;
7226       Biased : out Boolean)
7227    is
7228       UT : constant Entity_Id := Underlying_Type (T);
7229       M  : Uint;
7230
7231    begin
7232       Biased := False;
7233
7234       --  Dismiss cases for generic types or types with previous errors
7235
7236       if No (UT)
7237         or else UT = Any_Type
7238         or else Is_Generic_Type (UT)
7239         or else Is_Generic_Type (Root_Type (UT))
7240       then
7241          return;
7242
7243       --  Check case of bit packed array
7244
7245       elsif Is_Array_Type (UT)
7246         and then Known_Static_Component_Size (UT)
7247         and then Is_Bit_Packed_Array (UT)
7248       then
7249          declare
7250             Asiz : Uint;
7251             Indx : Node_Id;
7252             Ityp : Entity_Id;
7253
7254          begin
7255             Asiz := Component_Size (UT);
7256             Indx := First_Index (UT);
7257             loop
7258                Ityp := Etype (Indx);
7259
7260                --  If non-static bound, then we are not in the business of
7261                --  trying to check the length, and indeed an error will be
7262                --  issued elsewhere, since sizes of non-static array types
7263                --  cannot be set implicitly or explicitly.
7264
7265                if not Is_Static_Subtype (Ityp) then
7266                   return;
7267                end if;
7268
7269                --  Otherwise accumulate next dimension
7270
7271                Asiz := Asiz * (Expr_Value (Type_High_Bound (Ityp)) -
7272                                Expr_Value (Type_Low_Bound  (Ityp)) +
7273                                Uint_1);
7274
7275                Next_Index (Indx);
7276                exit when No (Indx);
7277             end loop;
7278
7279             if Asiz <= Siz then
7280                return;
7281             else
7282                Error_Msg_Uint_1 := Asiz;
7283                Error_Msg_NE
7284                  ("size for& too small, minimum allowed is ^", N, T);
7285                Set_Esize   (T, Asiz);
7286                Set_RM_Size (T, Asiz);
7287             end if;
7288          end;
7289
7290       --  All other composite types are ignored
7291
7292       elsif Is_Composite_Type (UT) then
7293          return;
7294
7295       --  For fixed-point types, don't check minimum if type is not frozen,
7296       --  since we don't know all the characteristics of the type that can
7297       --  affect the size (e.g. a specified small) till freeze time.
7298
7299       elsif Is_Fixed_Point_Type (UT)
7300         and then not Is_Frozen (UT)
7301       then
7302          null;
7303
7304       --  Cases for which a minimum check is required
7305
7306       else
7307          --  Ignore if specified size is correct for the type
7308
7309          if Known_Esize (UT) and then Siz = Esize (UT) then
7310             return;
7311          end if;
7312
7313          --  Otherwise get minimum size
7314
7315          M := UI_From_Int (Minimum_Size (UT));
7316
7317          if Siz < M then
7318
7319             --  Size is less than minimum size, but one possibility remains
7320             --  that we can manage with the new size if we bias the type.
7321
7322             M := UI_From_Int (Minimum_Size (UT, Biased => True));
7323
7324             if Siz < M then
7325                Error_Msg_Uint_1 := M;
7326                Error_Msg_NE
7327                  ("size for& too small, minimum allowed is ^", N, T);
7328                Set_Esize (T, M);
7329                Set_RM_Size (T, M);
7330             else
7331                Biased := True;
7332             end if;
7333          end if;
7334       end if;
7335    end Check_Size;
7336
7337    -------------------------
7338    -- Get_Alignment_Value --
7339    -------------------------
7340
7341    function Get_Alignment_Value (Expr : Node_Id) return Uint is
7342       Align : constant Uint := Static_Integer (Expr);
7343
7344    begin
7345       if Align = No_Uint then
7346          return No_Uint;
7347
7348       elsif Align <= 0 then
7349          Error_Msg_N ("alignment value must be positive", Expr);
7350          return No_Uint;
7351
7352       else
7353          for J in Int range 0 .. 64 loop
7354             declare
7355                M : constant Uint := Uint_2 ** J;
7356
7357             begin
7358                exit when M = Align;
7359
7360                if M > Align then
7361                   Error_Msg_N
7362                     ("alignment value must be power of 2", Expr);
7363                   return No_Uint;
7364                end if;
7365             end;
7366          end loop;
7367
7368          return Align;
7369       end if;
7370    end Get_Alignment_Value;
7371
7372    ----------------
7373    -- Initialize --
7374    ----------------
7375
7376    procedure Initialize is
7377    begin
7378       Address_Clause_Checks.Init;
7379       Independence_Checks.Init;
7380       Unchecked_Conversions.Init;
7381    end Initialize;
7382
7383    -------------------------
7384    -- Is_Operational_Item --
7385    -------------------------
7386
7387    function Is_Operational_Item (N : Node_Id) return Boolean is
7388    begin
7389       if Nkind (N) /= N_Attribute_Definition_Clause then
7390          return False;
7391       else
7392          declare
7393             Id    : constant Attribute_Id := Get_Attribute_Id (Chars (N));
7394          begin
7395             return   Id = Attribute_Input
7396               or else Id = Attribute_Output
7397               or else Id = Attribute_Read
7398               or else Id = Attribute_Write
7399               or else Id = Attribute_External_Tag;
7400          end;
7401       end if;
7402    end Is_Operational_Item;
7403
7404    ------------------
7405    -- Minimum_Size --
7406    ------------------
7407
7408    function Minimum_Size
7409      (T      : Entity_Id;
7410       Biased : Boolean := False) return Nat
7411    is
7412       Lo     : Uint    := No_Uint;
7413       Hi     : Uint    := No_Uint;
7414       LoR    : Ureal   := No_Ureal;
7415       HiR    : Ureal   := No_Ureal;
7416       LoSet  : Boolean := False;
7417       HiSet  : Boolean := False;
7418       B      : Uint;
7419       S      : Nat;
7420       Ancest : Entity_Id;
7421       R_Typ  : constant Entity_Id := Root_Type (T);
7422
7423    begin
7424       --  If bad type, return 0
7425
7426       if T = Any_Type then
7427          return 0;
7428
7429       --  For generic types, just return zero. There cannot be any legitimate
7430       --  need to know such a size, but this routine may be called with a
7431       --  generic type as part of normal processing.
7432
7433       elsif Is_Generic_Type (R_Typ)
7434         or else R_Typ = Any_Type
7435       then
7436          return 0;
7437
7438          --  Access types. Normally an access type cannot have a size smaller
7439          --  than the size of System.Address. The exception is on VMS, where
7440          --  we have short and long addresses, and it is possible for an access
7441          --  type to have a short address size (and thus be less than the size
7442          --  of System.Address itself). We simply skip the check for VMS, and
7443          --  leave it to the back end to do the check.
7444
7445       elsif Is_Access_Type (T) then
7446          if OpenVMS_On_Target then
7447             return 0;
7448          else
7449             return System_Address_Size;
7450          end if;
7451
7452       --  Floating-point types
7453
7454       elsif Is_Floating_Point_Type (T) then
7455          return UI_To_Int (Esize (R_Typ));
7456
7457       --  Discrete types
7458
7459       elsif Is_Discrete_Type (T) then
7460
7461          --  The following loop is looking for the nearest compile time known
7462          --  bounds following the ancestor subtype chain. The idea is to find
7463          --  the most restrictive known bounds information.
7464
7465          Ancest := T;
7466          loop
7467             if Ancest = Any_Type or else Etype (Ancest) = Any_Type then
7468                return 0;
7469             end if;
7470
7471             if not LoSet then
7472                if Compile_Time_Known_Value (Type_Low_Bound (Ancest)) then
7473                   Lo := Expr_Rep_Value (Type_Low_Bound (Ancest));
7474                   LoSet := True;
7475                   exit when HiSet;
7476                end if;
7477             end if;
7478
7479             if not HiSet then
7480                if Compile_Time_Known_Value (Type_High_Bound (Ancest)) then
7481                   Hi := Expr_Rep_Value (Type_High_Bound (Ancest));
7482                   HiSet := True;
7483                   exit when LoSet;
7484                end if;
7485             end if;
7486
7487             Ancest := Ancestor_Subtype (Ancest);
7488
7489             if No (Ancest) then
7490                Ancest := Base_Type (T);
7491
7492                if Is_Generic_Type (Ancest) then
7493                   return 0;
7494                end if;
7495             end if;
7496          end loop;
7497
7498       --  Fixed-point types. We can't simply use Expr_Value to get the
7499       --  Corresponding_Integer_Value values of the bounds, since these do not
7500       --  get set till the type is frozen, and this routine can be called
7501       --  before the type is frozen. Similarly the test for bounds being static
7502       --  needs to include the case where we have unanalyzed real literals for
7503       --  the same reason.
7504
7505       elsif Is_Fixed_Point_Type (T) then
7506
7507          --  The following loop is looking for the nearest compile time known
7508          --  bounds following the ancestor subtype chain. The idea is to find
7509          --  the most restrictive known bounds information.
7510
7511          Ancest := T;
7512          loop
7513             if Ancest = Any_Type or else Etype (Ancest) = Any_Type then
7514                return 0;
7515             end if;
7516
7517             --  Note: In the following two tests for LoSet and HiSet, it may
7518             --  seem redundant to test for N_Real_Literal here since normally
7519             --  one would assume that the test for the value being known at
7520             --  compile time includes this case. However, there is a glitch.
7521             --  If the real literal comes from folding a non-static expression,
7522             --  then we don't consider any non- static expression to be known
7523             --  at compile time if we are in configurable run time mode (needed
7524             --  in some cases to give a clearer definition of what is and what
7525             --  is not accepted). So the test is indeed needed. Without it, we
7526             --  would set neither Lo_Set nor Hi_Set and get an infinite loop.
7527
7528             if not LoSet then
7529                if Nkind (Type_Low_Bound (Ancest)) = N_Real_Literal
7530                  or else Compile_Time_Known_Value (Type_Low_Bound (Ancest))
7531                then
7532                   LoR := Expr_Value_R (Type_Low_Bound (Ancest));
7533                   LoSet := True;
7534                   exit when HiSet;
7535                end if;
7536             end if;
7537
7538             if not HiSet then
7539                if Nkind (Type_High_Bound (Ancest)) = N_Real_Literal
7540                  or else Compile_Time_Known_Value (Type_High_Bound (Ancest))
7541                then
7542                   HiR := Expr_Value_R (Type_High_Bound (Ancest));
7543                   HiSet := True;
7544                   exit when LoSet;
7545                end if;
7546             end if;
7547
7548             Ancest := Ancestor_Subtype (Ancest);
7549
7550             if No (Ancest) then
7551                Ancest := Base_Type (T);
7552
7553                if Is_Generic_Type (Ancest) then
7554                   return 0;
7555                end if;
7556             end if;
7557          end loop;
7558
7559          Lo := UR_To_Uint (LoR / Small_Value (T));
7560          Hi := UR_To_Uint (HiR / Small_Value (T));
7561
7562       --  No other types allowed
7563
7564       else
7565          raise Program_Error;
7566       end if;
7567
7568       --  Fall through with Hi and Lo set. Deal with biased case
7569
7570       if (Biased
7571            and then not Is_Fixed_Point_Type (T)
7572            and then not (Is_Enumeration_Type (T)
7573                           and then Has_Non_Standard_Rep (T)))
7574         or else Has_Biased_Representation (T)
7575       then
7576          Hi := Hi - Lo;
7577          Lo := Uint_0;
7578       end if;
7579
7580       --  Signed case. Note that we consider types like range 1 .. -1 to be
7581       --  signed for the purpose of computing the size, since the bounds have
7582       --  to be accommodated in the base type.
7583
7584       if Lo < 0 or else Hi < 0 then
7585          S := 1;
7586          B := Uint_1;
7587
7588          --  S = size, B = 2 ** (size - 1) (can accommodate -B .. +(B - 1))
7589          --  Note that we accommodate the case where the bounds cross. This
7590          --  can happen either because of the way the bounds are declared
7591          --  or because of the algorithm in Freeze_Fixed_Point_Type.
7592
7593          while Lo < -B
7594            or else Hi < -B
7595            or else Lo >= B
7596            or else Hi >= B
7597          loop
7598             B := Uint_2 ** S;
7599             S := S + 1;
7600          end loop;
7601
7602       --  Unsigned case
7603
7604       else
7605          --  If both bounds are positive, make sure that both are represen-
7606          --  table in the case where the bounds are crossed. This can happen
7607          --  either because of the way the bounds are declared, or because of
7608          --  the algorithm in Freeze_Fixed_Point_Type.
7609
7610          if Lo > Hi then
7611             Hi := Lo;
7612          end if;
7613
7614          --  S = size, (can accommodate 0 .. (2**size - 1))
7615
7616          S := 0;
7617          while Hi >= Uint_2 ** S loop
7618             S := S + 1;
7619          end loop;
7620       end if;
7621
7622       return S;
7623    end Minimum_Size;
7624
7625    ---------------------------
7626    -- New_Stream_Subprogram --
7627    ---------------------------
7628
7629    procedure New_Stream_Subprogram
7630      (N     : Node_Id;
7631       Ent   : Entity_Id;
7632       Subp  : Entity_Id;
7633       Nam   : TSS_Name_Type)
7634    is
7635       Loc       : constant Source_Ptr := Sloc (N);
7636       Sname     : constant Name_Id    := Make_TSS_Name (Base_Type (Ent), Nam);
7637       Subp_Id   : Entity_Id;
7638       Subp_Decl : Node_Id;
7639       F         : Entity_Id;
7640       Etyp      : Entity_Id;
7641
7642       Defer_Declaration : constant Boolean :=
7643                             Is_Tagged_Type (Ent) or else Is_Private_Type (Ent);
7644       --  For a tagged type, there is a declaration for each stream attribute
7645       --  at the freeze point, and we must generate only a completion of this
7646       --  declaration. We do the same for private types, because the full view
7647       --  might be tagged. Otherwise we generate a declaration at the point of
7648       --  the attribute definition clause.
7649
7650       function Build_Spec return Node_Id;
7651       --  Used for declaration and renaming declaration, so that this is
7652       --  treated as a renaming_as_body.
7653
7654       ----------------
7655       -- Build_Spec --
7656       ----------------
7657
7658       function Build_Spec return Node_Id is
7659          Out_P   : constant Boolean := (Nam = TSS_Stream_Read);
7660          Formals : List_Id;
7661          Spec    : Node_Id;
7662          T_Ref   : constant Node_Id := New_Reference_To (Etyp, Loc);
7663
7664       begin
7665          Subp_Id := Make_Defining_Identifier (Loc, Sname);
7666
7667          --  S : access Root_Stream_Type'Class
7668
7669          Formals := New_List (
7670                       Make_Parameter_Specification (Loc,
7671                         Defining_Identifier =>
7672                           Make_Defining_Identifier (Loc, Name_S),
7673                         Parameter_Type =>
7674                           Make_Access_Definition (Loc,
7675                             Subtype_Mark =>
7676                               New_Reference_To (
7677                                 Designated_Type (Etype (F)), Loc))));
7678
7679          if Nam = TSS_Stream_Input then
7680             Spec := Make_Function_Specification (Loc,
7681                       Defining_Unit_Name       => Subp_Id,
7682                       Parameter_Specifications => Formals,
7683                       Result_Definition        => T_Ref);
7684          else
7685             --  V : [out] T
7686
7687             Append_To (Formals,
7688               Make_Parameter_Specification (Loc,
7689                 Defining_Identifier => Make_Defining_Identifier (Loc, Name_V),
7690                 Out_Present         => Out_P,
7691                 Parameter_Type      => T_Ref));
7692
7693             Spec :=
7694               Make_Procedure_Specification (Loc,
7695                 Defining_Unit_Name       => Subp_Id,
7696                 Parameter_Specifications => Formals);
7697          end if;
7698
7699          return Spec;
7700       end Build_Spec;
7701
7702    --  Start of processing for New_Stream_Subprogram
7703
7704    begin
7705       F := First_Formal (Subp);
7706
7707       if Ekind (Subp) = E_Procedure then
7708          Etyp := Etype (Next_Formal (F));
7709       else
7710          Etyp := Etype (Subp);
7711       end if;
7712
7713       --  Prepare subprogram declaration and insert it as an action on the
7714       --  clause node. The visibility for this entity is used to test for
7715       --  visibility of the attribute definition clause (in the sense of
7716       --  8.3(23) as amended by AI-195).
7717
7718       if not Defer_Declaration then
7719          Subp_Decl :=
7720            Make_Subprogram_Declaration (Loc,
7721              Specification => Build_Spec);
7722
7723       --  For a tagged type, there is always a visible declaration for each
7724       --  stream TSS (it is a predefined primitive operation), and the
7725       --  completion of this declaration occurs at the freeze point, which is
7726       --  not always visible at places where the attribute definition clause is
7727       --  visible. So, we create a dummy entity here for the purpose of
7728       --  tracking the visibility of the attribute definition clause itself.
7729
7730       else
7731          Subp_Id :=
7732            Make_Defining_Identifier (Loc, New_External_Name (Sname, 'V'));
7733          Subp_Decl :=
7734            Make_Object_Declaration (Loc,
7735              Defining_Identifier => Subp_Id,
7736              Object_Definition   => New_Occurrence_Of (Standard_Boolean, Loc));
7737       end if;
7738
7739       Insert_Action (N, Subp_Decl);
7740       Set_Entity (N, Subp_Id);
7741
7742       Subp_Decl :=
7743         Make_Subprogram_Renaming_Declaration (Loc,
7744           Specification => Build_Spec,
7745           Name => New_Reference_To (Subp, Loc));
7746
7747       if Defer_Declaration then
7748          Set_TSS (Base_Type (Ent), Subp_Id);
7749       else
7750          Insert_Action (N, Subp_Decl);
7751          Copy_TSS (Subp_Id, Base_Type (Ent));
7752       end if;
7753    end New_Stream_Subprogram;
7754
7755    ------------------------
7756    -- Rep_Item_Too_Early --
7757    ------------------------
7758
7759    function Rep_Item_Too_Early (T : Entity_Id; N : Node_Id) return Boolean is
7760    begin
7761       --  Cannot apply non-operational rep items to generic types
7762
7763       if Is_Operational_Item (N) then
7764          return False;
7765
7766       elsif Is_Type (T)
7767         and then Is_Generic_Type (Root_Type (T))
7768       then
7769          Error_Msg_N ("representation item not allowed for generic type", N);
7770          return True;
7771       end if;
7772
7773       --  Otherwise check for incomplete type
7774
7775       if Is_Incomplete_Or_Private_Type (T)
7776         and then No (Underlying_Type (T))
7777         and then
7778           (Nkind (N) /= N_Pragma
7779             or else Get_Pragma_Id (N) /= Pragma_Import)
7780       then
7781          Error_Msg_N
7782            ("representation item must be after full type declaration", N);
7783          return True;
7784
7785       --  If the type has incomplete components, a representation clause is
7786       --  illegal but stream attributes and Convention pragmas are correct.
7787
7788       elsif Has_Private_Component (T) then
7789          if Nkind (N) = N_Pragma then
7790             return False;
7791          else
7792             Error_Msg_N
7793               ("representation item must appear after type is fully defined",
7794                 N);
7795             return True;
7796          end if;
7797       else
7798          return False;
7799       end if;
7800    end Rep_Item_Too_Early;
7801
7802    -----------------------
7803    -- Rep_Item_Too_Late --
7804    -----------------------
7805
7806    function Rep_Item_Too_Late
7807      (T     : Entity_Id;
7808       N     : Node_Id;
7809       FOnly : Boolean := False) return Boolean
7810    is
7811       S           : Entity_Id;
7812       Parent_Type : Entity_Id;
7813
7814       procedure Too_Late;
7815       --  Output the too late message. Note that this is not considered a
7816       --  serious error, since the effect is simply that we ignore the
7817       --  representation clause in this case.
7818
7819       --------------
7820       -- Too_Late --
7821       --------------
7822
7823       procedure Too_Late is
7824       begin
7825          Error_Msg_N ("|representation item appears too late!", N);
7826       end Too_Late;
7827
7828    --  Start of processing for Rep_Item_Too_Late
7829
7830    begin
7831       --  First make sure entity is not frozen (RM 13.1(9))
7832
7833       if Is_Frozen (T)
7834
7835         --  Exclude imported types, which may be frozen if they appear in a
7836         --  representation clause for a local type.
7837
7838         and then not From_With_Type (T)
7839
7840         --  Exclude generated entitiesa (not coming from source). The common
7841         --  case is when we generate a renaming which prematurely freezes the
7842         --  renamed internal entity, but we still want to be able to set copies
7843         --  of attribute values such as Size/Alignment.
7844
7845         and then Comes_From_Source (T)
7846       then
7847          Too_Late;
7848          S := First_Subtype (T);
7849
7850          if Present (Freeze_Node (S)) then
7851             Error_Msg_NE
7852               ("?no more representation items for }", Freeze_Node (S), S);
7853          end if;
7854
7855          return True;
7856
7857       --  Check for case of non-tagged derived type whose parent either has
7858       --  primitive operations, or is a by reference type (RM 13.1(10)).
7859
7860       elsif Is_Type (T)
7861         and then not FOnly
7862         and then Is_Derived_Type (T)
7863         and then not Is_Tagged_Type (T)
7864       then
7865          Parent_Type := Etype (Base_Type (T));
7866
7867          if Has_Primitive_Operations (Parent_Type) then
7868             Too_Late;
7869             Error_Msg_NE
7870               ("primitive operations already defined for&!", N, Parent_Type);
7871             return True;
7872
7873          elsif Is_By_Reference_Type (Parent_Type) then
7874             Too_Late;
7875             Error_Msg_NE
7876               ("parent type & is a by reference type!", N, Parent_Type);
7877             return True;
7878          end if;
7879       end if;
7880
7881       --  No error, link item into head of chain of rep items for the entity,
7882       --  but avoid chaining if we have an overloadable entity, and the pragma
7883       --  is one that can apply to multiple overloaded entities.
7884
7885       if Is_Overloadable (T)
7886         and then Nkind (N) = N_Pragma
7887       then
7888          declare
7889             Pname : constant Name_Id := Pragma_Name (N);
7890          begin
7891             if Pname = Name_Convention or else
7892                Pname = Name_Import     or else
7893                Pname = Name_Export     or else
7894                Pname = Name_External   or else
7895                Pname = Name_Interface
7896             then
7897                return False;
7898             end if;
7899          end;
7900       end if;
7901
7902       Record_Rep_Item (T, N);
7903       return False;
7904    end Rep_Item_Too_Late;
7905
7906    -------------------------------------
7907    -- Replace_Type_References_Generic --
7908    -------------------------------------
7909
7910    procedure Replace_Type_References_Generic (N : Node_Id; TName : Name_Id) is
7911
7912       function Replace_Node (N : Node_Id) return Traverse_Result;
7913       --  Processes a single node in the traversal procedure below, checking
7914       --  if node N should be replaced, and if so, doing the replacement.
7915
7916       procedure Replace_Type_Refs is new Traverse_Proc (Replace_Node);
7917       --  This instantiation provides the body of Replace_Type_References
7918
7919       ------------------
7920       -- Replace_Node --
7921       ------------------
7922
7923       function Replace_Node (N : Node_Id) return Traverse_Result is
7924          S : Entity_Id;
7925          P : Node_Id;
7926
7927       begin
7928          --  Case of identifier
7929
7930          if Nkind (N) = N_Identifier then
7931
7932             --  If not the type name, all done with this node
7933
7934             if Chars (N) /= TName then
7935                return Skip;
7936
7937             --  Otherwise do the replacement and we are done with this node
7938
7939             else
7940                Replace_Type_Reference (N);
7941                return Skip;
7942             end if;
7943
7944          --  Case of selected component (which is what a qualification
7945          --  looks like in the unanalyzed tree, which is what we have.
7946
7947          elsif Nkind (N) = N_Selected_Component then
7948
7949             --  If selector name is not our type, keeping going (we might
7950             --  still have an occurrence of the type in the prefix).
7951
7952             if Nkind (Selector_Name (N)) /= N_Identifier
7953               or else Chars (Selector_Name (N)) /= TName
7954             then
7955                return OK;
7956
7957             --  Selector name is our type, check qualification
7958
7959             else
7960                --  Loop through scopes and prefixes, doing comparison
7961
7962                S := Current_Scope;
7963                P := Prefix (N);
7964                loop
7965                   --  Continue if no more scopes or scope with no name
7966
7967                   if No (S) or else Nkind (S) not in N_Has_Chars then
7968                      return OK;
7969                   end if;
7970
7971                   --  Do replace if prefix is an identifier matching the
7972                   --  scope that we are currently looking at.
7973
7974                   if Nkind (P) = N_Identifier
7975                     and then Chars (P) = Chars (S)
7976                   then
7977                      Replace_Type_Reference (N);
7978                      return Skip;
7979                   end if;
7980
7981                   --  Go check scope above us if prefix is itself of the
7982                   --  form of a selected component, whose selector matches
7983                   --  the scope we are currently looking at.
7984
7985                   if Nkind (P) = N_Selected_Component
7986                     and then Nkind (Selector_Name (P)) = N_Identifier
7987                     and then Chars (Selector_Name (P)) = Chars (S)
7988                   then
7989                      S := Scope (S);
7990                      P := Prefix (P);
7991
7992                   --  For anything else, we don't have a match, so keep on
7993                   --  going, there are still some weird cases where we may
7994                   --  still have a replacement within the prefix.
7995
7996                   else
7997                      return OK;
7998                   end if;
7999                end loop;
8000             end if;
8001
8002             --  Continue for any other node kind
8003
8004          else
8005             return OK;
8006          end if;
8007       end Replace_Node;
8008
8009    begin
8010       Replace_Type_Refs (N);
8011    end Replace_Type_References_Generic;
8012
8013    -------------------------
8014    -- Same_Representation --
8015    -------------------------
8016
8017    function Same_Representation (Typ1, Typ2 : Entity_Id) return Boolean is
8018       T1 : constant Entity_Id := Underlying_Type (Typ1);
8019       T2 : constant Entity_Id := Underlying_Type (Typ2);
8020
8021    begin
8022       --  A quick check, if base types are the same, then we definitely have
8023       --  the same representation, because the subtype specific representation
8024       --  attributes (Size and Alignment) do not affect representation from
8025       --  the point of view of this test.
8026
8027       if Base_Type (T1) = Base_Type (T2) then
8028          return True;
8029
8030       elsif Is_Private_Type (Base_Type (T2))
8031         and then Base_Type (T1) = Full_View (Base_Type (T2))
8032       then
8033          return True;
8034       end if;
8035
8036       --  Tagged types never have differing representations
8037
8038       if Is_Tagged_Type (T1) then
8039          return True;
8040       end if;
8041
8042       --  Representations are definitely different if conventions differ
8043
8044       if Convention (T1) /= Convention (T2) then
8045          return False;
8046       end if;
8047
8048       --  Representations are different if component alignments differ
8049
8050       if (Is_Record_Type (T1) or else Is_Array_Type (T1))
8051         and then
8052          (Is_Record_Type (T2) or else Is_Array_Type (T2))
8053         and then Component_Alignment (T1) /= Component_Alignment (T2)
8054       then
8055          return False;
8056       end if;
8057
8058       --  For arrays, the only real issue is component size. If we know the
8059       --  component size for both arrays, and it is the same, then that's
8060       --  good enough to know we don't have a change of representation.
8061
8062       if Is_Array_Type (T1) then
8063          if Known_Component_Size (T1)
8064            and then Known_Component_Size (T2)
8065            and then Component_Size (T1) = Component_Size (T2)
8066          then
8067             if VM_Target = No_VM then
8068                return True;
8069
8070             --  In VM targets the representation of arrays with aliased
8071             --  components differs from arrays with non-aliased components
8072
8073             else
8074                return Has_Aliased_Components (Base_Type (T1))
8075                         =
8076                       Has_Aliased_Components (Base_Type (T2));
8077             end if;
8078          end if;
8079       end if;
8080
8081       --  Types definitely have same representation if neither has non-standard
8082       --  representation since default representations are always consistent.
8083       --  If only one has non-standard representation, and the other does not,
8084       --  then we consider that they do not have the same representation. They
8085       --  might, but there is no way of telling early enough.
8086
8087       if Has_Non_Standard_Rep (T1) then
8088          if not Has_Non_Standard_Rep (T2) then
8089             return False;
8090          end if;
8091       else
8092          return not Has_Non_Standard_Rep (T2);
8093       end if;
8094
8095       --  Here the two types both have non-standard representation, and we need
8096       --  to determine if they have the same non-standard representation.
8097
8098       --  For arrays, we simply need to test if the component sizes are the
8099       --  same. Pragma Pack is reflected in modified component sizes, so this
8100       --  check also deals with pragma Pack.
8101
8102       if Is_Array_Type (T1) then
8103          return Component_Size (T1) = Component_Size (T2);
8104
8105       --  Tagged types always have the same representation, because it is not
8106       --  possible to specify different representations for common fields.
8107
8108       elsif Is_Tagged_Type (T1) then
8109          return True;
8110
8111       --  Case of record types
8112
8113       elsif Is_Record_Type (T1) then
8114
8115          --  Packed status must conform
8116
8117          if Is_Packed (T1) /= Is_Packed (T2) then
8118             return False;
8119
8120          --  Otherwise we must check components. Typ2 maybe a constrained
8121          --  subtype with fewer components, so we compare the components
8122          --  of the base types.
8123
8124          else
8125             Record_Case : declare
8126                CD1, CD2 : Entity_Id;
8127
8128                function Same_Rep return Boolean;
8129                --  CD1 and CD2 are either components or discriminants. This
8130                --  function tests whether the two have the same representation
8131
8132                --------------
8133                -- Same_Rep --
8134                --------------
8135
8136                function Same_Rep return Boolean is
8137                begin
8138                   if No (Component_Clause (CD1)) then
8139                      return No (Component_Clause (CD2));
8140
8141                   else
8142                      return
8143                         Present (Component_Clause (CD2))
8144                           and then
8145                         Component_Bit_Offset (CD1) = Component_Bit_Offset (CD2)
8146                           and then
8147                         Esize (CD1) = Esize (CD2);
8148                   end if;
8149                end Same_Rep;
8150
8151             --  Start of processing for Record_Case
8152
8153             begin
8154                if Has_Discriminants (T1) then
8155                   CD1 := First_Discriminant (T1);
8156                   CD2 := First_Discriminant (T2);
8157
8158                   --  The number of discriminants may be different if the
8159                   --  derived type has fewer (constrained by values). The
8160                   --  invisible discriminants retain the representation of
8161                   --  the original, so the discrepancy does not per se
8162                   --  indicate a different representation.
8163
8164                   while Present (CD1)
8165                     and then Present (CD2)
8166                   loop
8167                      if not Same_Rep then
8168                         return False;
8169                      else
8170                         Next_Discriminant (CD1);
8171                         Next_Discriminant (CD2);
8172                      end if;
8173                   end loop;
8174                end if;
8175
8176                CD1 := First_Component (Underlying_Type (Base_Type (T1)));
8177                CD2 := First_Component (Underlying_Type (Base_Type (T2)));
8178
8179                while Present (CD1) loop
8180                   if not Same_Rep then
8181                      return False;
8182                   else
8183                      Next_Component (CD1);
8184                      Next_Component (CD2);
8185                   end if;
8186                end loop;
8187
8188                return True;
8189             end Record_Case;
8190          end if;
8191
8192       --  For enumeration types, we must check each literal to see if the
8193       --  representation is the same. Note that we do not permit enumeration
8194       --  representation clauses for Character and Wide_Character, so these
8195       --  cases were already dealt with.
8196
8197       elsif Is_Enumeration_Type (T1) then
8198          Enumeration_Case : declare
8199             L1, L2 : Entity_Id;
8200
8201          begin
8202             L1 := First_Literal (T1);
8203             L2 := First_Literal (T2);
8204
8205             while Present (L1) loop
8206                if Enumeration_Rep (L1) /= Enumeration_Rep (L2) then
8207                   return False;
8208                else
8209                   Next_Literal (L1);
8210                   Next_Literal (L2);
8211                end if;
8212             end loop;
8213
8214             return True;
8215
8216          end Enumeration_Case;
8217
8218       --  Any other types have the same representation for these purposes
8219
8220       else
8221          return True;
8222       end if;
8223    end Same_Representation;
8224
8225    ----------------
8226    -- Set_Biased --
8227    ----------------
8228
8229    procedure Set_Biased
8230      (E      : Entity_Id;
8231       N      : Node_Id;
8232       Msg    : String;
8233       Biased : Boolean := True)
8234    is
8235    begin
8236       if Biased then
8237          Set_Has_Biased_Representation (E);
8238
8239          if Warn_On_Biased_Representation then
8240             Error_Msg_NE
8241               ("?" & Msg & " forces biased representation for&", N, E);
8242          end if;
8243       end if;
8244    end Set_Biased;
8245
8246    --------------------
8247    -- Set_Enum_Esize --
8248    --------------------
8249
8250    procedure Set_Enum_Esize (T : Entity_Id) is
8251       Lo : Uint;
8252       Hi : Uint;
8253       Sz : Nat;
8254
8255    begin
8256       Init_Alignment (T);
8257
8258       --  Find the minimum standard size (8,16,32,64) that fits
8259
8260       Lo := Enumeration_Rep (Entity (Type_Low_Bound (T)));
8261       Hi := Enumeration_Rep (Entity (Type_High_Bound (T)));
8262
8263       if Lo < 0 then
8264          if Lo >= -Uint_2**07 and then Hi < Uint_2**07 then
8265             Sz := Standard_Character_Size;  -- May be > 8 on some targets
8266
8267          elsif Lo >= -Uint_2**15 and then Hi < Uint_2**15 then
8268             Sz := 16;
8269
8270          elsif Lo >= -Uint_2**31 and then Hi < Uint_2**31 then
8271             Sz := 32;
8272
8273          else pragma Assert (Lo >= -Uint_2**63 and then Hi < Uint_2**63);
8274             Sz := 64;
8275          end if;
8276
8277       else
8278          if Hi < Uint_2**08 then
8279             Sz := Standard_Character_Size;  -- May be > 8 on some targets
8280
8281          elsif Hi < Uint_2**16 then
8282             Sz := 16;
8283
8284          elsif Hi < Uint_2**32 then
8285             Sz := 32;
8286
8287          else pragma Assert (Hi < Uint_2**63);
8288             Sz := 64;
8289          end if;
8290       end if;
8291
8292       --  That minimum is the proper size unless we have a foreign convention
8293       --  and the size required is 32 or less, in which case we bump the size
8294       --  up to 32. This is required for C and C++ and seems reasonable for
8295       --  all other foreign conventions.
8296
8297       if Has_Foreign_Convention (T)
8298         and then Esize (T) < Standard_Integer_Size
8299       then
8300          Init_Esize (T, Standard_Integer_Size);
8301       else
8302          Init_Esize (T, Sz);
8303       end if;
8304    end Set_Enum_Esize;
8305
8306    ------------------------------
8307    -- Validate_Address_Clauses --
8308    ------------------------------
8309
8310    procedure Validate_Address_Clauses is
8311    begin
8312       for J in Address_Clause_Checks.First .. Address_Clause_Checks.Last loop
8313          declare
8314             ACCR : Address_Clause_Check_Record
8315                      renames Address_Clause_Checks.Table (J);
8316
8317             Expr : Node_Id;
8318
8319             X_Alignment : Uint;
8320             Y_Alignment : Uint;
8321
8322             X_Size : Uint;
8323             Y_Size : Uint;
8324
8325          begin
8326             --  Skip processing of this entry if warning already posted
8327
8328             if not Address_Warning_Posted (ACCR.N) then
8329
8330                Expr := Original_Node (Expression (ACCR.N));
8331
8332                --  Get alignments
8333
8334                X_Alignment := Alignment (ACCR.X);
8335                Y_Alignment := Alignment (ACCR.Y);
8336
8337                --  Similarly obtain sizes
8338
8339                X_Size := Esize (ACCR.X);
8340                Y_Size := Esize (ACCR.Y);
8341
8342                --  Check for large object overlaying smaller one
8343
8344                if Y_Size > Uint_0
8345                  and then X_Size > Uint_0
8346                  and then X_Size > Y_Size
8347                then
8348                   Error_Msg_NE
8349                     ("?& overlays smaller object", ACCR.N, ACCR.X);
8350                   Error_Msg_N
8351                     ("\?program execution may be erroneous", ACCR.N);
8352                   Error_Msg_Uint_1 := X_Size;
8353                   Error_Msg_NE
8354                     ("\?size of & is ^", ACCR.N, ACCR.X);
8355                   Error_Msg_Uint_1 := Y_Size;
8356                   Error_Msg_NE
8357                     ("\?size of & is ^", ACCR.N, ACCR.Y);
8358
8359                --  Check for inadequate alignment, both of the base object
8360                --  and of the offset, if any.
8361
8362                --  Note: we do not check the alignment if we gave a size
8363                --  warning, since it would likely be redundant.
8364
8365                elsif Y_Alignment /= Uint_0
8366                  and then (Y_Alignment < X_Alignment
8367                              or else (ACCR.Off
8368                                         and then
8369                                           Nkind (Expr) = N_Attribute_Reference
8370                                         and then
8371                                           Attribute_Name (Expr) = Name_Address
8372                                         and then
8373                                           Has_Compatible_Alignment
8374                                             (ACCR.X, Prefix (Expr))
8375                                              /= Known_Compatible))
8376                then
8377                   Error_Msg_NE
8378                     ("?specified address for& may be inconsistent "
8379                        & "with alignment",
8380                      ACCR.N, ACCR.X);
8381                   Error_Msg_N
8382                     ("\?program execution may be erroneous (RM 13.3(27))",
8383                      ACCR.N);
8384                   Error_Msg_Uint_1 := X_Alignment;
8385                   Error_Msg_NE
8386                     ("\?alignment of & is ^",
8387                      ACCR.N, ACCR.X);
8388                   Error_Msg_Uint_1 := Y_Alignment;
8389                   Error_Msg_NE
8390                     ("\?alignment of & is ^",
8391                      ACCR.N, ACCR.Y);
8392                   if Y_Alignment >= X_Alignment then
8393                      Error_Msg_N
8394                       ("\?but offset is not multiple of alignment",
8395                        ACCR.N);
8396                   end if;
8397                end if;
8398             end if;
8399          end;
8400       end loop;
8401    end Validate_Address_Clauses;
8402
8403    ---------------------------
8404    -- Validate_Independence --
8405    ---------------------------
8406
8407    procedure Validate_Independence is
8408       SU   : constant Uint := UI_From_Int (System_Storage_Unit);
8409       N    : Node_Id;
8410       E    : Entity_Id;
8411       IC   : Boolean;
8412       Comp : Entity_Id;
8413       Addr : Node_Id;
8414       P    : Node_Id;
8415
8416       procedure Check_Array_Type (Atyp : Entity_Id);
8417       --  Checks if the array type Atyp has independent components, and
8418       --  if not, outputs an appropriate set of error messages.
8419
8420       procedure No_Independence;
8421       --  Output message that independence cannot be guaranteed
8422
8423       function OK_Component (C : Entity_Id) return Boolean;
8424       --  Checks one component to see if it is independently accessible, and
8425       --  if so yields True, otherwise yields False if independent access
8426       --  cannot be guaranteed. This is a conservative routine, it only
8427       --  returns True if it knows for sure, it returns False if it knows
8428       --  there is a problem, or it cannot be sure there is no problem.
8429
8430       procedure Reason_Bad_Component (C : Entity_Id);
8431       --  Outputs continuation message if a reason can be determined for
8432       --  the component C being bad.
8433
8434       ----------------------
8435       -- Check_Array_Type --
8436       ----------------------
8437
8438       procedure Check_Array_Type (Atyp : Entity_Id) is
8439          Ctyp : constant Entity_Id := Component_Type (Atyp);
8440
8441       begin
8442          --  OK if no alignment clause, no pack, and no component size
8443
8444          if not Has_Component_Size_Clause (Atyp)
8445            and then not Has_Alignment_Clause (Atyp)
8446            and then not Is_Packed (Atyp)
8447          then
8448             return;
8449          end if;
8450
8451          --  Check actual component size
8452
8453          if not Known_Component_Size (Atyp)
8454            or else not (Addressable (Component_Size (Atyp))
8455                           and then Component_Size (Atyp) < 64)
8456            or else Component_Size (Atyp) mod Esize (Ctyp) /= 0
8457          then
8458             No_Independence;
8459
8460             --  Bad component size, check reason
8461
8462             if Has_Component_Size_Clause (Atyp) then
8463                P :=
8464                  Get_Attribute_Definition_Clause
8465                    (Atyp, Attribute_Component_Size);
8466
8467                if Present (P) then
8468                   Error_Msg_Sloc := Sloc (P);
8469                   Error_Msg_N ("\because of Component_Size clause#", N);
8470                   return;
8471                end if;
8472             end if;
8473
8474             if Is_Packed (Atyp) then
8475                P := Get_Rep_Pragma (Atyp, Name_Pack);
8476
8477                if Present (P) then
8478                   Error_Msg_Sloc := Sloc (P);
8479                   Error_Msg_N ("\because of pragma Pack#", N);
8480                   return;
8481                end if;
8482             end if;
8483
8484             --  No reason found, just return
8485
8486             return;
8487          end if;
8488
8489          --  Array type is OK independence-wise
8490
8491          return;
8492       end Check_Array_Type;
8493
8494       ---------------------
8495       -- No_Independence --
8496       ---------------------
8497
8498       procedure No_Independence is
8499       begin
8500          if Pragma_Name (N) = Name_Independent then
8501             Error_Msg_NE
8502               ("independence cannot be guaranteed for&", N, E);
8503          else
8504             Error_Msg_NE
8505               ("independent components cannot be guaranteed for&", N, E);
8506          end if;
8507       end No_Independence;
8508
8509       ------------------
8510       -- OK_Component --
8511       ------------------
8512
8513       function OK_Component (C : Entity_Id) return Boolean is
8514          Rec  : constant Entity_Id := Scope (C);
8515          Ctyp : constant Entity_Id := Etype (C);
8516
8517       begin
8518          --  OK if no component clause, no Pack, and no alignment clause
8519
8520          if No (Component_Clause (C))
8521            and then not Is_Packed (Rec)
8522            and then not Has_Alignment_Clause (Rec)
8523          then
8524             return True;
8525          end if;
8526
8527          --  Here we look at the actual component layout. A component is
8528          --  addressable if its size is a multiple of the Esize of the
8529          --  component type, and its starting position in the record has
8530          --  appropriate alignment, and the record itself has appropriate
8531          --  alignment to guarantee the component alignment.
8532
8533          --  Make sure sizes are static, always assume the worst for any
8534          --  cases where we cannot check static values.
8535
8536          if not (Known_Static_Esize (C)
8537                   and then Known_Static_Esize (Ctyp))
8538          then
8539             return False;
8540          end if;
8541
8542          --  Size of component must be addressable or greater than 64 bits
8543          --  and a multiple of bytes.
8544
8545          if not Addressable (Esize (C))
8546            and then Esize (C) < Uint_64
8547          then
8548             return False;
8549          end if;
8550
8551          --  Check size is proper multiple
8552
8553          if Esize (C) mod Esize (Ctyp) /= 0 then
8554             return False;
8555          end if;
8556
8557          --  Check alignment of component is OK
8558
8559          if not Known_Component_Bit_Offset (C)
8560            or else Component_Bit_Offset (C) < Uint_0
8561            or else Component_Bit_Offset (C) mod Esize (Ctyp) /= 0
8562          then
8563             return False;
8564          end if;
8565
8566          --  Check alignment of record type is OK
8567
8568          if not Known_Alignment (Rec)
8569            or else (Alignment (Rec) * SU) mod Esize (Ctyp) /= 0
8570          then
8571             return False;
8572          end if;
8573
8574          --  All tests passed, component is addressable
8575
8576          return True;
8577       end OK_Component;
8578
8579       --------------------------
8580       -- Reason_Bad_Component --
8581       --------------------------
8582
8583       procedure Reason_Bad_Component (C : Entity_Id) is
8584          Rec  : constant Entity_Id := Scope (C);
8585          Ctyp : constant Entity_Id := Etype (C);
8586
8587       begin
8588          --  If component clause present assume that's the problem
8589
8590          if Present (Component_Clause (C)) then
8591             Error_Msg_Sloc := Sloc (Component_Clause (C));
8592             Error_Msg_N ("\because of Component_Clause#", N);
8593             return;
8594          end if;
8595
8596          --  If pragma Pack clause present, assume that's the problem
8597
8598          if Is_Packed (Rec) then
8599             P := Get_Rep_Pragma (Rec, Name_Pack);
8600
8601             if Present (P) then
8602                Error_Msg_Sloc := Sloc (P);
8603                Error_Msg_N ("\because of pragma Pack#", N);
8604                return;
8605             end if;
8606          end if;
8607
8608          --  See if record has bad alignment clause
8609
8610          if Has_Alignment_Clause (Rec)
8611            and then Known_Alignment (Rec)
8612            and then (Alignment (Rec) * SU) mod Esize (Ctyp) /= 0
8613          then
8614             P := Get_Attribute_Definition_Clause (Rec, Attribute_Alignment);
8615
8616             if Present (P) then
8617                Error_Msg_Sloc := Sloc (P);
8618                Error_Msg_N ("\because of Alignment clause#", N);
8619             end if;
8620          end if;
8621
8622          --  Couldn't find a reason, so return without a message
8623
8624          return;
8625       end Reason_Bad_Component;
8626
8627    --  Start of processing for Validate_Independence
8628
8629    begin
8630       for J in Independence_Checks.First .. Independence_Checks.Last loop
8631          N  := Independence_Checks.Table (J).N;
8632          E  := Independence_Checks.Table (J).E;
8633          IC := Pragma_Name (N) = Name_Independent_Components;
8634
8635          --  Deal with component case
8636
8637          if Ekind (E) = E_Discriminant or else Ekind (E) = E_Component then
8638             if not OK_Component (E) then
8639                No_Independence;
8640                Reason_Bad_Component (E);
8641                goto Continue;
8642             end if;
8643          end if;
8644
8645          --  Deal with record with Independent_Components
8646
8647          if IC and then Is_Record_Type (E) then
8648             Comp := First_Component_Or_Discriminant (E);
8649             while Present (Comp) loop
8650                if not OK_Component (Comp) then
8651                   No_Independence;
8652                   Reason_Bad_Component (Comp);
8653                   goto Continue;
8654                end if;
8655
8656                Next_Component_Or_Discriminant (Comp);
8657             end loop;
8658          end if;
8659
8660          --  Deal with address clause case
8661
8662          if Is_Object (E) then
8663             Addr := Address_Clause (E);
8664
8665             if Present (Addr) then
8666                No_Independence;
8667                Error_Msg_Sloc := Sloc (Addr);
8668                Error_Msg_N ("\because of Address clause#", N);
8669                goto Continue;
8670             end if;
8671          end if;
8672
8673          --  Deal with independent components for array type
8674
8675          if IC and then Is_Array_Type (E) then
8676             Check_Array_Type (E);
8677          end if;
8678
8679          --  Deal with independent components for array object
8680
8681          if IC and then Is_Object (E) and then Is_Array_Type (Etype (E)) then
8682             Check_Array_Type (Etype (E));
8683          end if;
8684
8685       <<Continue>> null;
8686       end loop;
8687    end Validate_Independence;
8688
8689    -----------------------------------
8690    -- Validate_Unchecked_Conversion --
8691    -----------------------------------
8692
8693    procedure Validate_Unchecked_Conversion
8694      (N        : Node_Id;
8695       Act_Unit : Entity_Id)
8696    is
8697       Source : Entity_Id;
8698       Target : Entity_Id;
8699       Vnode  : Node_Id;
8700
8701    begin
8702       --  Obtain source and target types. Note that we call Ancestor_Subtype
8703       --  here because the processing for generic instantiation always makes
8704       --  subtypes, and we want the original frozen actual types.
8705
8706       --  If we are dealing with private types, then do the check on their
8707       --  fully declared counterparts if the full declarations have been
8708       --  encountered (they don't have to be visible, but they must exist!)
8709
8710       Source := Ancestor_Subtype (Etype (First_Formal (Act_Unit)));
8711
8712       if Is_Private_Type (Source)
8713         and then Present (Underlying_Type (Source))
8714       then
8715          Source := Underlying_Type (Source);
8716       end if;
8717
8718       Target := Ancestor_Subtype (Etype (Act_Unit));
8719
8720       --  If either type is generic, the instantiation happens within a generic
8721       --  unit, and there is nothing to check. The proper check will happen
8722       --  when the enclosing generic is instantiated.
8723
8724       if Is_Generic_Type (Source) or else Is_Generic_Type (Target) then
8725          return;
8726       end if;
8727
8728       if Is_Private_Type (Target)
8729         and then Present (Underlying_Type (Target))
8730       then
8731          Target := Underlying_Type (Target);
8732       end if;
8733
8734       --  Source may be unconstrained array, but not target
8735
8736       if Is_Array_Type (Target)
8737         and then not Is_Constrained (Target)
8738       then
8739          Error_Msg_N
8740            ("unchecked conversion to unconstrained array not allowed", N);
8741          return;
8742       end if;
8743
8744       --  Warn if conversion between two different convention pointers
8745
8746       if Is_Access_Type (Target)
8747         and then Is_Access_Type (Source)
8748         and then Convention (Target) /= Convention (Source)
8749         and then Warn_On_Unchecked_Conversion
8750       then
8751          --  Give warnings for subprogram pointers only on most targets. The
8752          --  exception is VMS, where data pointers can have different lengths
8753          --  depending on the pointer convention.
8754
8755          if Is_Access_Subprogram_Type (Target)
8756            or else Is_Access_Subprogram_Type (Source)
8757            or else OpenVMS_On_Target
8758          then
8759             Error_Msg_N
8760               ("?conversion between pointers with different conventions!", N);
8761          end if;
8762       end if;
8763
8764       --  Warn if one of the operands is Ada.Calendar.Time. Do not emit a
8765       --  warning when compiling GNAT-related sources.
8766
8767       if Warn_On_Unchecked_Conversion
8768         and then not In_Predefined_Unit (N)
8769         and then RTU_Loaded (Ada_Calendar)
8770         and then
8771           (Chars (Source) = Name_Time
8772              or else
8773            Chars (Target) = Name_Time)
8774       then
8775          --  If Ada.Calendar is loaded and the name of one of the operands is
8776          --  Time, there is a good chance that this is Ada.Calendar.Time.
8777
8778          declare
8779             Calendar_Time : constant Entity_Id :=
8780                               Full_View (RTE (RO_CA_Time));
8781          begin
8782             pragma Assert (Present (Calendar_Time));
8783
8784             if Source = Calendar_Time
8785               or else Target = Calendar_Time
8786             then
8787                Error_Msg_N
8788                  ("?representation of 'Time values may change between " &
8789                   "'G'N'A'T versions", N);
8790             end if;
8791          end;
8792       end if;
8793
8794       --  Make entry in unchecked conversion table for later processing by
8795       --  Validate_Unchecked_Conversions, which will check sizes and alignments
8796       --  (using values set by the back-end where possible). This is only done
8797       --  if the appropriate warning is active.
8798
8799       if Warn_On_Unchecked_Conversion then
8800          Unchecked_Conversions.Append
8801            (New_Val => UC_Entry'
8802               (Eloc   => Sloc (N),
8803                Source => Source,
8804                Target => Target));
8805
8806          --  If both sizes are known statically now, then back end annotation
8807          --  is not required to do a proper check but if either size is not
8808          --  known statically, then we need the annotation.
8809
8810          if Known_Static_RM_Size (Source)
8811            and then Known_Static_RM_Size (Target)
8812          then
8813             null;
8814          else
8815             Back_Annotate_Rep_Info := True;
8816          end if;
8817       end if;
8818
8819       --  If unchecked conversion to access type, and access type is declared
8820       --  in the same unit as the unchecked conversion, then set the flag
8821       --  No_Strict_Aliasing (no strict aliasing is implicit here)
8822
8823       if Is_Access_Type (Target) and then
8824         In_Same_Source_Unit (Target, N)
8825       then
8826          Set_No_Strict_Aliasing (Implementation_Base_Type (Target));
8827       end if;
8828
8829       --  Generate N_Validate_Unchecked_Conversion node for back end in case
8830       --  the back end needs to perform special validation checks.
8831
8832       --  Shouldn't this be in Exp_Ch13, since the check only gets done if we
8833       --  have full expansion and the back end is called ???
8834
8835       Vnode :=
8836         Make_Validate_Unchecked_Conversion (Sloc (N));
8837       Set_Source_Type (Vnode, Source);
8838       Set_Target_Type (Vnode, Target);
8839
8840       --  If the unchecked conversion node is in a list, just insert before it.
8841       --  If not we have some strange case, not worth bothering about.
8842
8843       if Is_List_Member (N) then
8844          Insert_After (N, Vnode);
8845       end if;
8846    end Validate_Unchecked_Conversion;
8847
8848    ------------------------------------
8849    -- Validate_Unchecked_Conversions --
8850    ------------------------------------
8851
8852    procedure Validate_Unchecked_Conversions is
8853    begin
8854       for N in Unchecked_Conversions.First .. Unchecked_Conversions.Last loop
8855          declare
8856             T : UC_Entry renames Unchecked_Conversions.Table (N);
8857
8858             Eloc   : constant Source_Ptr := T.Eloc;
8859             Source : constant Entity_Id  := T.Source;
8860             Target : constant Entity_Id  := T.Target;
8861
8862             Source_Siz : Uint;
8863             Target_Siz : Uint;
8864
8865          begin
8866             --  This validation check, which warns if we have unequal sizes for
8867             --  unchecked conversion, and thus potentially implementation
8868             --  dependent semantics, is one of the few occasions on which we
8869             --  use the official RM size instead of Esize. See description in
8870             --  Einfo "Handling of Type'Size Values" for details.
8871
8872             if Serious_Errors_Detected = 0
8873               and then Known_Static_RM_Size (Source)
8874               and then Known_Static_RM_Size (Target)
8875
8876               --  Don't do the check if warnings off for either type, note the
8877               --  deliberate use of OR here instead of OR ELSE to get the flag
8878               --  Warnings_Off_Used set for both types if appropriate.
8879
8880               and then not (Has_Warnings_Off (Source)
8881                               or
8882                             Has_Warnings_Off (Target))
8883             then
8884                Source_Siz := RM_Size (Source);
8885                Target_Siz := RM_Size (Target);
8886
8887                if Source_Siz /= Target_Siz then
8888                   Error_Msg
8889                     ("?types for unchecked conversion have different sizes!",
8890                      Eloc);
8891
8892                   if All_Errors_Mode then
8893                      Error_Msg_Name_1 := Chars (Source);
8894                      Error_Msg_Uint_1 := Source_Siz;
8895                      Error_Msg_Name_2 := Chars (Target);
8896                      Error_Msg_Uint_2 := Target_Siz;
8897                      Error_Msg ("\size of % is ^, size of % is ^?", Eloc);
8898
8899                      Error_Msg_Uint_1 := UI_Abs (Source_Siz - Target_Siz);
8900
8901                      if Is_Discrete_Type (Source)
8902                        and then Is_Discrete_Type (Target)
8903                      then
8904                         if Source_Siz > Target_Siz then
8905                            Error_Msg
8906                              ("\?^ high order bits of source will be ignored!",
8907                               Eloc);
8908
8909                         elsif Is_Unsigned_Type (Source) then
8910                            Error_Msg
8911                              ("\?source will be extended with ^ high order " &
8912                               "zero bits?!", Eloc);
8913
8914                         else
8915                            Error_Msg
8916                              ("\?source will be extended with ^ high order " &
8917                               "sign bits!",
8918                               Eloc);
8919                         end if;
8920
8921                      elsif Source_Siz < Target_Siz then
8922                         if Is_Discrete_Type (Target) then
8923                            if Bytes_Big_Endian then
8924                               Error_Msg
8925                                 ("\?target value will include ^ undefined " &
8926                                  "low order bits!",
8927                                  Eloc);
8928                            else
8929                               Error_Msg
8930                                 ("\?target value will include ^ undefined " &
8931                                  "high order bits!",
8932                                  Eloc);
8933                            end if;
8934
8935                         else
8936                            Error_Msg
8937                              ("\?^ trailing bits of target value will be " &
8938                               "undefined!", Eloc);
8939                         end if;
8940
8941                      else pragma Assert (Source_Siz > Target_Siz);
8942                         Error_Msg
8943                           ("\?^ trailing bits of source will be ignored!",
8944                            Eloc);
8945                      end if;
8946                   end if;
8947                end if;
8948             end if;
8949
8950             --  If both types are access types, we need to check the alignment.
8951             --  If the alignment of both is specified, we can do it here.
8952
8953             if Serious_Errors_Detected = 0
8954               and then Ekind (Source) in Access_Kind
8955               and then Ekind (Target) in Access_Kind
8956               and then Target_Strict_Alignment
8957               and then Present (Designated_Type (Source))
8958               and then Present (Designated_Type (Target))
8959             then
8960                declare
8961                   D_Source : constant Entity_Id := Designated_Type (Source);
8962                   D_Target : constant Entity_Id := Designated_Type (Target);
8963
8964                begin
8965                   if Known_Alignment (D_Source)
8966                     and then Known_Alignment (D_Target)
8967                   then
8968                      declare
8969                         Source_Align : constant Uint := Alignment (D_Source);
8970                         Target_Align : constant Uint := Alignment (D_Target);
8971
8972                      begin
8973                         if Source_Align < Target_Align
8974                           and then not Is_Tagged_Type (D_Source)
8975
8976                           --  Suppress warning if warnings suppressed on either
8977                           --  type or either designated type. Note the use of
8978                           --  OR here instead of OR ELSE. That is intentional,
8979                           --  we would like to set flag Warnings_Off_Used in
8980                           --  all types for which warnings are suppressed.
8981
8982                           and then not (Has_Warnings_Off (D_Source)
8983                                           or
8984                                         Has_Warnings_Off (D_Target)
8985                                           or
8986                                         Has_Warnings_Off (Source)
8987                                           or
8988                                         Has_Warnings_Off (Target))
8989                         then
8990                            Error_Msg_Uint_1 := Target_Align;
8991                            Error_Msg_Uint_2 := Source_Align;
8992                            Error_Msg_Node_1 := D_Target;
8993                            Error_Msg_Node_2 := D_Source;
8994                            Error_Msg
8995                              ("?alignment of & (^) is stricter than " &
8996                               "alignment of & (^)!", Eloc);
8997                            Error_Msg
8998                              ("\?resulting access value may have invalid " &
8999                               "alignment!", Eloc);
9000                         end if;
9001                      end;
9002                   end if;
9003                end;
9004             end if;
9005          end;
9006       end loop;
9007    end Validate_Unchecked_Conversions;
9008
9009 end Sem_Ch13;