OSDN Git Service

2007-09-26 Robert Dewar <dewar@adacore.com>
[pf3gnuchains/gcc-fork.git] / gcc / ada / checks.adb
1 ------------------------------------------------------------------------------
2 --                                                                          --
3 --                         GNAT COMPILER COMPONENTS                         --
4 --                                                                          --
5 --                               C H E C K S                                --
6 --                                                                          --
7 --                                 B o d y                                  --
8 --                                                                          --
9 --          Copyright (C) 1992-2007, Free Software Foundation, Inc.         --
10 --                                                                          --
11 -- GNAT is free software;  you can  redistribute it  and/or modify it under --
12 -- terms of the  GNU General Public License as published  by the Free Soft- --
13 -- ware  Foundation;  either version 3,  or (at your option) any later ver- --
14 -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License --
17 -- for  more details.  You should have  received  a copy of the GNU General --
18 -- Public License  distributed with GNAT; see file COPYING3.  If not, go to --
19 -- http://www.gnu.org/licenses for a complete copy of the license.          --
20 --                                                                          --
21 -- GNAT was originally developed  by the GNAT team at  New York University. --
22 -- Extensive contributions were provided by Ada Core Technologies Inc.      --
23 --                                                                          --
24 ------------------------------------------------------------------------------
25
26 with Atree;    use Atree;
27 with Debug;    use Debug;
28 with Einfo;    use Einfo;
29 with Errout;   use Errout;
30 with Exp_Ch2;  use Exp_Ch2;
31 with Exp_Ch11; use Exp_Ch11;
32 with Exp_Pakd; use Exp_Pakd;
33 with Exp_Util; use Exp_Util;
34 with Elists;   use Elists;
35 with Eval_Fat; use Eval_Fat;
36 with Freeze;   use Freeze;
37 with Lib;      use Lib;
38 with Nlists;   use Nlists;
39 with Nmake;    use Nmake;
40 with Opt;      use Opt;
41 with Output;   use Output;
42 with Restrict; use Restrict;
43 with Rident;   use Rident;
44 with Rtsfind;  use Rtsfind;
45 with Sem;      use Sem;
46 with Sem_Eval; use Sem_Eval;
47 with Sem_Ch3;  use Sem_Ch3;
48 with Sem_Ch8;  use Sem_Ch8;
49 with Sem_Res;  use Sem_Res;
50 with Sem_Util; use Sem_Util;
51 with Sem_Warn; use Sem_Warn;
52 with Sinfo;    use Sinfo;
53 with Sinput;   use Sinput;
54 with Snames;   use Snames;
55 with Sprint;   use Sprint;
56 with Stand;    use Stand;
57 with Targparm; use Targparm;
58 with Tbuild;   use Tbuild;
59 with Ttypes;   use Ttypes;
60 with Urealp;   use Urealp;
61 with Validsw;  use Validsw;
62
63 package body Checks is
64
65    --  General note: many of these routines are concerned with generating
66    --  checking code to make sure that constraint error is raised at runtime.
67    --  Clearly this code is only needed if the expander is active, since
68    --  otherwise we will not be generating code or going into the runtime
69    --  execution anyway.
70
71    --  We therefore disconnect most of these checks if the expander is
72    --  inactive. This has the additional benefit that we do not need to
73    --  worry about the tree being messed up by previous errors (since errors
74    --  turn off expansion anyway).
75
76    --  There are a few exceptions to the above rule. For instance routines
77    --  such as Apply_Scalar_Range_Check that do not insert any code can be
78    --  safely called even when the Expander is inactive (but Errors_Detected
79    --  is 0). The benefit of executing this code when expansion is off, is
80    --  the ability to emit constraint error warning for static expressions
81    --  even when we are not generating code.
82
83    -------------------------------------
84    -- Suppression of Redundant Checks --
85    -------------------------------------
86
87    --  This unit implements a limited circuit for removal of redundant
88    --  checks. The processing is based on a tracing of simple sequential
89    --  flow. For any sequence of statements, we save expressions that are
90    --  marked to be checked, and then if the same expression appears later
91    --  with the same check, then under certain circumstances, the second
92    --  check can be suppressed.
93
94    --  Basically, we can suppress the check if we know for certain that
95    --  the previous expression has been elaborated (together with its
96    --  check), and we know that the exception frame is the same, and that
97    --  nothing has happened to change the result of the exception.
98
99    --  Let us examine each of these three conditions in turn to describe
100    --  how we ensure that this condition is met.
101
102    --  First, we need to know for certain that the previous expression has
103    --  been executed. This is done principly by the mechanism of calling
104    --  Conditional_Statements_Begin at the start of any statement sequence
105    --  and Conditional_Statements_End at the end. The End call causes all
106    --  checks remembered since the Begin call to be discarded. This does
107    --  miss a few cases, notably the case of a nested BEGIN-END block with
108    --  no exception handlers. But the important thing is to be conservative.
109    --  The other protection is that all checks are discarded if a label
110    --  is encountered, since then the assumption of sequential execution
111    --  is violated, and we don't know enough about the flow.
112
113    --  Second, we need to know that the exception frame is the same. We
114    --  do this by killing all remembered checks when we enter a new frame.
115    --  Again, that's over-conservative, but generally the cases we can help
116    --  with are pretty local anyway (like the body of a loop for example).
117
118    --  Third, we must be sure to forget any checks which are no longer valid.
119    --  This is done by two mechanisms, first the Kill_Checks_Variable call is
120    --  used to note any changes to local variables. We only attempt to deal
121    --  with checks involving local variables, so we do not need to worry
122    --  about global variables. Second, a call to any non-global procedure
123    --  causes us to abandon all stored checks, since such a all may affect
124    --  the values of any local variables.
125
126    --  The following define the data structures used to deal with remembering
127    --  checks so that redundant checks can be eliminated as described above.
128
129    --  Right now, the only expressions that we deal with are of the form of
130    --  simple local objects (either declared locally, or IN parameters) or
131    --  such objects plus/minus a compile time known constant. We can do
132    --  more later on if it seems worthwhile, but this catches many simple
133    --  cases in practice.
134
135    --  The following record type reflects a single saved check. An entry
136    --  is made in the stack of saved checks if and only if the expression
137    --  has been elaborated with the indicated checks.
138
139    type Saved_Check is record
140       Killed : Boolean;
141       --  Set True if entry is killed by Kill_Checks
142
143       Entity : Entity_Id;
144       --  The entity involved in the expression that is checked
145
146       Offset : Uint;
147       --  A compile time value indicating the result of adding or
148       --  subtracting a compile time value. This value is to be
149       --  added to the value of the Entity. A value of zero is
150       --  used for the case of a simple entity reference.
151
152       Check_Type : Character;
153       --  This is set to 'R' for a range check (in which case Target_Type
154       --  is set to the target type for the range check) or to 'O' for an
155       --  overflow check (in which case Target_Type is set to Empty).
156
157       Target_Type : Entity_Id;
158       --  Used only if Do_Range_Check is set. Records the target type for
159       --  the check. We need this, because a check is a duplicate only if
160       --  it has a the same target type (or more accurately one with a
161       --  range that is smaller or equal to the stored target type of a
162       --  saved check).
163    end record;
164
165    --  The following table keeps track of saved checks. Rather than use an
166    --  extensible table. We just use a table of fixed size, and we discard
167    --  any saved checks that do not fit. That's very unlikely to happen and
168    --  this is only an optimization in any case.
169
170    Saved_Checks : array (Int range 1 .. 200) of Saved_Check;
171    --  Array of saved checks
172
173    Num_Saved_Checks : Nat := 0;
174    --  Number of saved checks
175
176    --  The following stack keeps track of statement ranges. It is treated
177    --  as a stack. When Conditional_Statements_Begin is called, an entry
178    --  is pushed onto this stack containing the value of Num_Saved_Checks
179    --  at the time of the call. Then when Conditional_Statements_End is
180    --  called, this value is popped off and used to reset Num_Saved_Checks.
181
182    --  Note: again, this is a fixed length stack with a size that should
183    --  always be fine. If the value of the stack pointer goes above the
184    --  limit, then we just forget all saved checks.
185
186    Saved_Checks_Stack : array (Int range 1 .. 100) of Nat;
187    Saved_Checks_TOS : Nat := 0;
188
189    -----------------------
190    -- Local Subprograms --
191    -----------------------
192
193    procedure Apply_Float_Conversion_Check
194      (Ck_Node    : Node_Id;
195       Target_Typ : Entity_Id);
196    --  The checks on a conversion from a floating-point type to an integer
197    --  type are delicate. They have to be performed before conversion, they
198    --  have to raise an exception when the operand is a NaN, and rounding must
199    --  be taken into account to determine the safe bounds of the operand.
200
201    procedure Apply_Selected_Length_Checks
202      (Ck_Node    : Node_Id;
203       Target_Typ : Entity_Id;
204       Source_Typ : Entity_Id;
205       Do_Static  : Boolean);
206    --  This is the subprogram that does all the work for Apply_Length_Check
207    --  and Apply_Static_Length_Check. Expr, Target_Typ and Source_Typ are as
208    --  described for the above routines. The Do_Static flag indicates that
209    --  only a static check is to be done.
210
211    procedure Apply_Selected_Range_Checks
212      (Ck_Node    : Node_Id;
213       Target_Typ : Entity_Id;
214       Source_Typ : Entity_Id;
215       Do_Static  : Boolean);
216    --  This is the subprogram that does all the work for Apply_Range_Check.
217    --  Expr, Target_Typ and Source_Typ are as described for the above
218    --  routine. The Do_Static flag indicates that only a static check is
219    --  to be done.
220
221    type Check_Type is new Check_Id range Access_Check .. Division_Check;
222    function Check_Needed (Nod : Node_Id; Check : Check_Type) return Boolean;
223    --  This function is used to see if an access or division by zero check is
224    --  needed. The check is to be applied to a single variable appearing in the
225    --  source, and N is the node for the reference. If N is not of this form,
226    --  True is returned with no further processing. If N is of the right form,
227    --  then further processing determines if the given Check is needed.
228    --
229    --  The particular circuit is to see if we have the case of a check that is
230    --  not needed because it appears in the right operand of a short circuited
231    --  conditional where the left operand guards the check. For example:
232    --
233    --    if Var = 0 or else Q / Var > 12 then
234    --       ...
235    --    end if;
236    --
237    --  In this example, the division check is not required. At the same time
238    --  we can issue warnings for suspicious use of non-short-circuited forms,
239    --  such as:
240    --
241    --    if Var = 0 or Q / Var > 12 then
242    --       ...
243    --    end if;
244
245    procedure Find_Check
246      (Expr        : Node_Id;
247       Check_Type  : Character;
248       Target_Type : Entity_Id;
249       Entry_OK    : out Boolean;
250       Check_Num   : out Nat;
251       Ent         : out Entity_Id;
252       Ofs         : out Uint);
253    --  This routine is used by Enable_Range_Check and Enable_Overflow_Check
254    --  to see if a check is of the form for optimization, and if so, to see
255    --  if it has already been performed. Expr is the expression to check,
256    --  and Check_Type is 'R' for a range check, 'O' for an overflow check.
257    --  Target_Type is the target type for a range check, and Empty for an
258    --  overflow check. If the entry is not of the form for optimization,
259    --  then Entry_OK is set to False, and the remaining out parameters
260    --  are undefined. If the entry is OK, then Ent/Ofs are set to the
261    --  entity and offset from the expression. Check_Num is the number of
262    --  a matching saved entry in Saved_Checks, or zero if no such entry
263    --  is located.
264
265    function Get_Discriminal (E : Entity_Id; Bound : Node_Id) return Node_Id;
266    --  If a discriminal is used in constraining a prival, Return reference
267    --  to the discriminal of the protected body (which renames the parameter
268    --  of the enclosing protected operation). This clumsy transformation is
269    --  needed because privals are created too late and their actual subtypes
270    --  are not available when analysing the bodies of the protected operations.
271    --  This function is called whenever the bound is an entity and the scope
272    --  indicates a protected operation. If the bound is an in-parameter of
273    --  a protected operation that is not a prival, the function returns the
274    --  bound itself.
275    --  To be cleaned up???
276
277    function Guard_Access
278      (Cond    : Node_Id;
279       Loc     : Source_Ptr;
280       Ck_Node : Node_Id) return Node_Id;
281    --  In the access type case, guard the test with a test to ensure
282    --  that the access value is non-null, since the checks do not
283    --  not apply to null access values.
284
285    procedure Install_Static_Check (R_Cno : Node_Id; Loc : Source_Ptr);
286    --  Called by Apply_{Length,Range}_Checks to rewrite the tree with the
287    --  Constraint_Error node.
288
289    function Range_Or_Validity_Checks_Suppressed
290      (Expr : Node_Id) return Boolean;
291    --  Returns True if either range or validity checks or both are suppressed
292    --  for the type of the given expression, or, if the expression is the name
293    --  of an entity, if these checks are suppressed for the entity.
294
295    function Selected_Length_Checks
296      (Ck_Node    : Node_Id;
297       Target_Typ : Entity_Id;
298       Source_Typ : Entity_Id;
299       Warn_Node  : Node_Id) return Check_Result;
300    --  Like Apply_Selected_Length_Checks, except it doesn't modify
301    --  anything, just returns a list of nodes as described in the spec of
302    --  this package for the Range_Check function.
303
304    function Selected_Range_Checks
305      (Ck_Node    : Node_Id;
306       Target_Typ : Entity_Id;
307       Source_Typ : Entity_Id;
308       Warn_Node  : Node_Id) return Check_Result;
309    --  Like Apply_Selected_Range_Checks, except it doesn't modify anything,
310    --  just returns a list of nodes as described in the spec of this package
311    --  for the Range_Check function.
312
313    ------------------------------
314    -- Access_Checks_Suppressed --
315    ------------------------------
316
317    function Access_Checks_Suppressed (E : Entity_Id) return Boolean is
318    begin
319       if Present (E) and then Checks_May_Be_Suppressed (E) then
320          return Is_Check_Suppressed (E, Access_Check);
321       else
322          return Scope_Suppress (Access_Check);
323       end if;
324    end Access_Checks_Suppressed;
325
326    -------------------------------------
327    -- Accessibility_Checks_Suppressed --
328    -------------------------------------
329
330    function Accessibility_Checks_Suppressed (E : Entity_Id) return Boolean is
331    begin
332       if Present (E) and then Checks_May_Be_Suppressed (E) then
333          return Is_Check_Suppressed (E, Accessibility_Check);
334       else
335          return Scope_Suppress (Accessibility_Check);
336       end if;
337    end Accessibility_Checks_Suppressed;
338
339    -----------------------------
340    -- Activate_Division_Check --
341    -----------------------------
342
343    procedure Activate_Division_Check (N : Node_Id) is
344    begin
345       Set_Do_Division_Check (N, True);
346       Possible_Local_Raise (N, Standard_Constraint_Error);
347    end Activate_Division_Check;
348
349    -----------------------------
350    -- Activate_Overflow_Check --
351    -----------------------------
352
353    procedure Activate_Overflow_Check (N : Node_Id) is
354    begin
355       Set_Do_Overflow_Check (N, True);
356       Possible_Local_Raise (N, Standard_Constraint_Error);
357    end Activate_Overflow_Check;
358
359    --------------------------
360    -- Activate_Range_Check --
361    --------------------------
362
363    procedure Activate_Range_Check (N : Node_Id) is
364    begin
365       Set_Do_Range_Check (N, True);
366       Possible_Local_Raise (N, Standard_Constraint_Error);
367    end Activate_Range_Check;
368
369    ---------------------------------
370    -- Alignment_Checks_Suppressed --
371    ---------------------------------
372
373    function Alignment_Checks_Suppressed (E : Entity_Id) return Boolean is
374    begin
375       if Present (E) and then Checks_May_Be_Suppressed (E) then
376          return Is_Check_Suppressed (E, Alignment_Check);
377       else
378          return Scope_Suppress (Alignment_Check);
379       end if;
380    end Alignment_Checks_Suppressed;
381
382    -------------------------
383    -- Append_Range_Checks --
384    -------------------------
385
386    procedure Append_Range_Checks
387      (Checks       : Check_Result;
388       Stmts        : List_Id;
389       Suppress_Typ : Entity_Id;
390       Static_Sloc  : Source_Ptr;
391       Flag_Node    : Node_Id)
392    is
393       Internal_Flag_Node   : constant Node_Id    := Flag_Node;
394       Internal_Static_Sloc : constant Source_Ptr := Static_Sloc;
395
396       Checks_On : constant Boolean :=
397                     (not Index_Checks_Suppressed (Suppress_Typ))
398                        or else
399                     (not Range_Checks_Suppressed (Suppress_Typ));
400
401    begin
402       --  For now we just return if Checks_On is false, however this should
403       --  be enhanced to check for an always True value in the condition
404       --  and to generate a compilation warning???
405
406       if not Checks_On then
407          return;
408       end if;
409
410       for J in 1 .. 2 loop
411          exit when No (Checks (J));
412
413          if Nkind (Checks (J)) = N_Raise_Constraint_Error
414            and then Present (Condition (Checks (J)))
415          then
416             if not Has_Dynamic_Range_Check (Internal_Flag_Node) then
417                Append_To (Stmts, Checks (J));
418                Set_Has_Dynamic_Range_Check (Internal_Flag_Node);
419             end if;
420
421          else
422             Append_To
423               (Stmts,
424                 Make_Raise_Constraint_Error (Internal_Static_Sloc,
425                   Reason => CE_Range_Check_Failed));
426          end if;
427       end loop;
428    end Append_Range_Checks;
429
430    ------------------------
431    -- Apply_Access_Check --
432    ------------------------
433
434    procedure Apply_Access_Check (N : Node_Id) is
435       P : constant Node_Id := Prefix (N);
436
437    begin
438       --  We do not need checks if we are not generating code (i.e. the
439       --  expander is not active). This is not just an optimization, there
440       --  are cases (e.g. with pragma Debug) where generating the checks
441       --  can cause real trouble).
442
443       if not Expander_Active then
444          return;
445       end if;
446
447       --  No check if short circuiting makes check unnecessary
448
449       if not Check_Needed (P, Access_Check) then
450          return;
451       end if;
452
453       --  Otherwise go ahead and install the check
454
455       Install_Null_Excluding_Check (P);
456    end Apply_Access_Check;
457
458    -------------------------------
459    -- Apply_Accessibility_Check --
460    -------------------------------
461
462    procedure Apply_Accessibility_Check (N : Node_Id; Typ : Entity_Id) is
463       Loc         : constant Source_Ptr := Sloc (N);
464       Param_Ent   : constant Entity_Id  := Param_Entity (N);
465       Param_Level : Node_Id;
466       Type_Level  : Node_Id;
467
468    begin
469       if Inside_A_Generic then
470          return;
471
472       --  Only apply the run-time check if the access parameter
473       --  has an associated extra access level parameter and
474       --  when the level of the type is less deep than the level
475       --  of the access parameter.
476
477       elsif Present (Param_Ent)
478          and then Present (Extra_Accessibility (Param_Ent))
479          and then UI_Gt (Object_Access_Level (N),
480                          Type_Access_Level (Typ))
481          and then not Accessibility_Checks_Suppressed (Param_Ent)
482          and then not Accessibility_Checks_Suppressed (Typ)
483       then
484          Param_Level :=
485            New_Occurrence_Of (Extra_Accessibility (Param_Ent), Loc);
486
487          Type_Level :=
488            Make_Integer_Literal (Loc, Type_Access_Level (Typ));
489
490          --  Raise Program_Error if the accessibility level of the the access
491          --  parameter is deeper than the level of the target access type.
492
493          Insert_Action (N,
494            Make_Raise_Program_Error (Loc,
495              Condition =>
496                Make_Op_Gt (Loc,
497                  Left_Opnd  => Param_Level,
498                  Right_Opnd => Type_Level),
499              Reason => PE_Accessibility_Check_Failed));
500
501          Analyze_And_Resolve (N);
502       end if;
503    end Apply_Accessibility_Check;
504
505    --------------------------------
506    -- Apply_Address_Clause_Check --
507    --------------------------------
508
509    procedure Apply_Address_Clause_Check (E : Entity_Id; N : Node_Id) is
510       AC   : constant Node_Id    := Address_Clause (E);
511       Loc  : constant Source_Ptr := Sloc (AC);
512       Typ  : constant Entity_Id  := Etype (E);
513       Aexp : constant Node_Id    := Expression (AC);
514
515       Expr : Node_Id;
516       --  Address expression (not necessarily the same as Aexp, for example
517       --  when Aexp is a reference to a constant, in which case Expr gets
518       --  reset to reference the value expression of the constant.
519
520       Size_Warning_Output : Boolean := False;
521       --  If we output a size warning we set this True, to stop generating
522       --  what is likely to be an unuseful redundant alignment warning.
523
524       procedure Compile_Time_Bad_Alignment;
525       --  Post error warnings when alignment is known to be incompatible. Note
526       --  that we do not go as far as inserting a raise of Program_Error since
527       --  this is an erroneous case, and it may happen that we are lucky and an
528       --  underaligned address turns out to be OK after all. Also this warning
529       --  is suppressed if we already complained about the size.
530
531       --------------------------------
532       -- Compile_Time_Bad_Alignment --
533       --------------------------------
534
535       procedure Compile_Time_Bad_Alignment is
536       begin
537          if not Size_Warning_Output
538            and then Address_Clause_Overlay_Warnings
539          then
540             Error_Msg_FE
541               ("?specified address for& may be inconsistent with alignment ",
542                Aexp, E);
543             Error_Msg_FE
544               ("\?program execution may be erroneous (RM 13.3(27))",
545                Aexp, E);
546             Set_Address_Warning_Posted (AC);
547          end if;
548       end Compile_Time_Bad_Alignment;
549
550    --  Start of processing for Apply_Address_Clause_Check
551
552    begin
553       --  First obtain expression from address clause
554
555       Expr := Expression (AC);
556
557       --  The following loop digs for the real expression to use in the check
558
559       loop
560          --  For constant, get constant expression
561
562          if Is_Entity_Name (Expr)
563            and then Ekind (Entity (Expr)) = E_Constant
564          then
565             Expr := Constant_Value (Entity (Expr));
566
567          --  For unchecked conversion, get result to convert
568
569          elsif Nkind (Expr) = N_Unchecked_Type_Conversion then
570             Expr := Expression (Expr);
571
572          --  For (common case) of To_Address call, get argument
573
574          elsif Nkind (Expr) = N_Function_Call
575            and then Is_Entity_Name (Name (Expr))
576            and then Is_RTE (Entity (Name (Expr)), RE_To_Address)
577          then
578             Expr := First (Parameter_Associations (Expr));
579
580             if Nkind (Expr) = N_Parameter_Association then
581                Expr := Explicit_Actual_Parameter (Expr);
582             end if;
583
584          --  We finally have the real expression
585
586          else
587             exit;
588          end if;
589       end loop;
590
591       --  Output a warning if we have the situation of
592
593       --      for X'Address use Y'Address
594
595       --  and X and Y both have known object sizes, and Y is smaller than X
596
597       if Nkind (Expr) = N_Attribute_Reference
598         and then Attribute_Name (Expr) = Name_Address
599         and then Is_Entity_Name (Prefix (Expr))
600       then
601          declare
602             Exp_Ent  : constant Entity_Id := Entity (Prefix (Expr));
603             Obj_Size : Uint := No_Uint;
604             Exp_Size : Uint := No_Uint;
605
606          begin
607             if Known_Esize (E) then
608                Obj_Size := Esize (E);
609             elsif Known_Esize (Etype (E)) then
610                Obj_Size := Esize (Etype (E));
611             end if;
612
613             if Known_Esize (Exp_Ent) then
614                Exp_Size := Esize (Exp_Ent);
615             elsif Known_Esize (Etype (Exp_Ent)) then
616                Exp_Size := Esize (Etype (Exp_Ent));
617             end if;
618
619             if Obj_Size /= No_Uint
620               and then Exp_Size /= No_Uint
621               and then Obj_Size > Exp_Size
622               and then not Warnings_Off (E)
623             then
624                if Address_Clause_Overlay_Warnings then
625                   Error_Msg_FE
626                     ("?& overlays smaller object", Aexp, E);
627                   Error_Msg_FE
628                     ("\?program execution may be erroneous", Aexp, E);
629                   Size_Warning_Output := True;
630                   Set_Address_Warning_Posted (AC);
631                end if;
632             end if;
633          end;
634       end if;
635
636       --  See if alignment check needed. Note that we never need a check if the
637       --  maximum alignment is one, since the check will always succeed.
638
639       --  Note: we do not check for checks suppressed here, since that check
640       --  was done in Sem_Ch13 when the address clause was processed. We are
641       --  only called if checks were not suppressed. The reason for this is
642       --  that we have to delay the call to Apply_Alignment_Check till freeze
643       --  time (so that all types etc are elaborated), but we have to check
644       --  the status of check suppressing at the point of the address clause.
645
646       if No (AC)
647         or else not Check_Address_Alignment (AC)
648         or else Maximum_Alignment = 1
649       then
650          return;
651       end if;
652
653       --  See if we know that Expr is a bad alignment at compile time
654
655       if Compile_Time_Known_Value (Expr)
656         and then (Known_Alignment (E) or else Known_Alignment (Typ))
657       then
658          declare
659             AL : Uint := Alignment (Typ);
660
661          begin
662             --  The object alignment might be more restrictive than the
663             --  type alignment.
664
665             if Known_Alignment (E) then
666                AL := Alignment (E);
667             end if;
668
669             if Expr_Value (Expr) mod AL /= 0 then
670                Compile_Time_Bad_Alignment;
671             else
672                return;
673             end if;
674          end;
675
676       --  If the expression has the form X'Address, then we can find out if
677       --  the object X has an alignment that is compatible with the object E.
678
679       elsif Nkind (Expr) = N_Attribute_Reference
680         and then Attribute_Name (Expr) = Name_Address
681       then
682          declare
683             AR : constant Alignment_Result :=
684                    Has_Compatible_Alignment (E, Prefix (Expr));
685          begin
686             if AR = Known_Compatible then
687                return;
688             elsif AR = Known_Incompatible then
689                Compile_Time_Bad_Alignment;
690             end if;
691          end;
692       end if;
693
694       --  Here we do not know if the value is acceptable. Stricly we don't have
695       --  to do anything, since if the alignment is bad, we have an erroneous
696       --  program. However we are allowed to check for erroneous conditions and
697       --  we decide to do this by default if the check is not suppressed.
698
699       --  However, don't do the check if elaboration code is unwanted
700
701       if Restriction_Active (No_Elaboration_Code) then
702          return;
703
704       --  Generate a check to raise PE if alignment may be inappropriate
705
706       else
707          --  If the original expression is a non-static constant, use the
708          --  name of the constant itself rather than duplicating its
709          --  defining expression, which was extracted above.
710
711          --  Note: Expr is empty if the address-clause is applied to in-mode
712          --  actuals (allowed by 13.1(22)).
713
714          if not Present (Expr)
715            or else
716              (Is_Entity_Name (Expression (AC))
717                and then Ekind (Entity (Expression (AC))) = E_Constant
718                and then Nkind (Parent (Entity (Expression (AC))))
719                                  = N_Object_Declaration)
720          then
721             Expr := New_Copy_Tree (Expression (AC));
722          else
723             Remove_Side_Effects (Expr);
724          end if;
725
726          Insert_After_And_Analyze (N,
727            Make_Raise_Program_Error (Loc,
728              Condition =>
729                Make_Op_Ne (Loc,
730                  Left_Opnd =>
731                    Make_Op_Mod (Loc,
732                      Left_Opnd =>
733                        Unchecked_Convert_To
734                          (RTE (RE_Integer_Address), Expr),
735                      Right_Opnd =>
736                        Make_Attribute_Reference (Loc,
737                          Prefix => New_Occurrence_Of (E, Loc),
738                          Attribute_Name => Name_Alignment)),
739                  Right_Opnd => Make_Integer_Literal (Loc, Uint_0)),
740              Reason => PE_Misaligned_Address_Value),
741            Suppress => All_Checks);
742          return;
743       end if;
744
745    exception
746       --  If we have some missing run time component in configurable run time
747       --  mode then just skip the check (it is not required in any case).
748
749       when RE_Not_Available =>
750          return;
751    end Apply_Address_Clause_Check;
752
753    -------------------------------------
754    -- Apply_Arithmetic_Overflow_Check --
755    -------------------------------------
756
757    --  This routine is called only if the type is an integer type, and
758    --  a software arithmetic overflow check must be performed for op
759    --  (add, subtract, multiply). The check is performed only if
760    --  Software_Overflow_Checking is enabled and Do_Overflow_Check
761    --  is set. In this case we expand the operation into a more complex
762    --  sequence of tests that ensures that overflow is properly caught.
763
764    procedure Apply_Arithmetic_Overflow_Check (N : Node_Id) is
765       Loc   : constant Source_Ptr := Sloc (N);
766       Typ   : constant Entity_Id  := Etype (N);
767       Rtyp  : constant Entity_Id  := Root_Type (Typ);
768       Siz   : constant Int        := UI_To_Int (Esize (Rtyp));
769       Dsiz  : constant Int        := Siz * 2;
770       Opnod : Node_Id;
771       Ctyp  : Entity_Id;
772       Opnd  : Node_Id;
773       Cent  : RE_Id;
774
775    begin
776       --  Skip this if overflow checks are done in back end, or the overflow
777       --  flag is not set anyway, or we are not doing code expansion.
778       --  Special case CLI target, where arithmetic overflow checks can be
779       --  performed for integer and long_integer
780
781       if Backend_Overflow_Checks_On_Target
782         or else (VM_Target = CLI_Target and then Siz >= Standard_Integer_Size)
783         or else not Do_Overflow_Check (N)
784         or else not Expander_Active
785       then
786          return;
787       end if;
788
789       --  Otherwise, we generate the full general code for front end overflow
790       --  detection, which works by doing arithmetic in a larger type:
791
792       --    x op y
793
794       --  is expanded into
795
796       --    Typ (Checktyp (x) op Checktyp (y));
797
798       --  where Typ is the type of the original expression, and Checktyp is
799       --  an integer type of sufficient length to hold the largest possible
800       --  result.
801
802       --  In the case where check type exceeds the size of Long_Long_Integer,
803       --  we use a different approach, expanding to:
804
805       --    typ (xxx_With_Ovflo_Check (Integer_64 (x), Integer (y)))
806
807       --  where xxx is Add, Multiply or Subtract as appropriate
808
809       --  Find check type if one exists
810
811       if Dsiz <= Standard_Integer_Size then
812          Ctyp := Standard_Integer;
813
814       elsif Dsiz <= Standard_Long_Long_Integer_Size then
815          Ctyp := Standard_Long_Long_Integer;
816
817       --  No check type exists, use runtime call
818
819       else
820          if Nkind (N) = N_Op_Add then
821             Cent := RE_Add_With_Ovflo_Check;
822
823          elsif Nkind (N) = N_Op_Multiply then
824             Cent := RE_Multiply_With_Ovflo_Check;
825
826          else
827             pragma Assert (Nkind (N) = N_Op_Subtract);
828             Cent := RE_Subtract_With_Ovflo_Check;
829          end if;
830
831          Rewrite (N,
832            OK_Convert_To (Typ,
833              Make_Function_Call (Loc,
834                Name => New_Reference_To (RTE (Cent), Loc),
835                Parameter_Associations => New_List (
836                  OK_Convert_To (RTE (RE_Integer_64), Left_Opnd  (N)),
837                  OK_Convert_To (RTE (RE_Integer_64), Right_Opnd (N))))));
838
839          Analyze_And_Resolve (N, Typ);
840          return;
841       end if;
842
843       --  If we fall through, we have the case where we do the arithmetic in
844       --  the next higher type and get the check by conversion. In these cases
845       --  Ctyp is set to the type to be used as the check type.
846
847       Opnod := Relocate_Node (N);
848
849       Opnd := OK_Convert_To (Ctyp, Left_Opnd (Opnod));
850
851       Analyze (Opnd);
852       Set_Etype (Opnd, Ctyp);
853       Set_Analyzed (Opnd, True);
854       Set_Left_Opnd (Opnod, Opnd);
855
856       Opnd := OK_Convert_To (Ctyp, Right_Opnd (Opnod));
857
858       Analyze (Opnd);
859       Set_Etype (Opnd, Ctyp);
860       Set_Analyzed (Opnd, True);
861       Set_Right_Opnd (Opnod, Opnd);
862
863       --  The type of the operation changes to the base type of the check type,
864       --  and we reset the overflow check indication, since clearly no overflow
865       --  is possible now that we are using a double length type. We also set
866       --  the Analyzed flag to avoid a recursive attempt to expand the node.
867
868       Set_Etype             (Opnod, Base_Type (Ctyp));
869       Set_Do_Overflow_Check (Opnod, False);
870       Set_Analyzed          (Opnod, True);
871
872       --  Now build the outer conversion
873
874       Opnd := OK_Convert_To (Typ, Opnod);
875       Analyze (Opnd);
876       Set_Etype (Opnd, Typ);
877
878       --  In the discrete type case, we directly generate the range check for
879       --  the outer operand. This range check will implement the required
880       --  overflow check.
881
882       if Is_Discrete_Type (Typ) then
883          Rewrite (N, Opnd);
884          Generate_Range_Check (Expression (N), Typ, CE_Overflow_Check_Failed);
885
886       --  For other types, we enable overflow checking on the conversion,
887       --  after setting the node as analyzed to prevent recursive attempts
888       --  to expand the conversion node.
889
890       else
891          Set_Analyzed (Opnd, True);
892          Enable_Overflow_Check (Opnd);
893          Rewrite (N, Opnd);
894       end if;
895
896    exception
897       when RE_Not_Available =>
898          return;
899    end Apply_Arithmetic_Overflow_Check;
900
901    ----------------------------
902    -- Apply_Constraint_Check --
903    ----------------------------
904
905    procedure Apply_Constraint_Check
906      (N          : Node_Id;
907       Typ        : Entity_Id;
908       No_Sliding : Boolean := False)
909    is
910       Desig_Typ : Entity_Id;
911
912    begin
913       if Inside_A_Generic then
914          return;
915
916       elsif Is_Scalar_Type (Typ) then
917          Apply_Scalar_Range_Check (N, Typ);
918
919       elsif Is_Array_Type (Typ) then
920
921          --  A useful optimization: an aggregate with only an others clause
922          --  always has the right bounds.
923
924          if Nkind (N) = N_Aggregate
925            and then No (Expressions (N))
926            and then Nkind
927             (First (Choices (First (Component_Associations (N)))))
928               = N_Others_Choice
929          then
930             return;
931          end if;
932
933          if Is_Constrained (Typ) then
934             Apply_Length_Check (N, Typ);
935
936             if No_Sliding then
937                Apply_Range_Check (N, Typ);
938             end if;
939          else
940             Apply_Range_Check (N, Typ);
941          end if;
942
943       elsif (Is_Record_Type (Typ)
944                or else Is_Private_Type (Typ))
945         and then Has_Discriminants (Base_Type (Typ))
946         and then Is_Constrained (Typ)
947       then
948          Apply_Discriminant_Check (N, Typ);
949
950       elsif Is_Access_Type (Typ) then
951
952          Desig_Typ := Designated_Type (Typ);
953
954          --  No checks necessary if expression statically null
955
956          if Known_Null (N) then
957             if Can_Never_Be_Null (Typ) then
958                Install_Null_Excluding_Check (N);
959             end if;
960
961          --  No sliding possible on access to arrays
962
963          elsif Is_Array_Type (Desig_Typ) then
964             if Is_Constrained (Desig_Typ) then
965                Apply_Length_Check (N, Typ);
966             end if;
967
968             Apply_Range_Check (N, Typ);
969
970          elsif Has_Discriminants (Base_Type (Desig_Typ))
971             and then Is_Constrained (Desig_Typ)
972          then
973             Apply_Discriminant_Check (N, Typ);
974          end if;
975
976          --  Apply the the 2005 Null_Excluding check. Note that we do not apply
977          --  this check if the constraint node is illegal, as shown by having
978          --  an error posted. This additional guard prevents cascaded errors
979          --  and compiler aborts on illegal programs involving Ada 2005 checks.
980
981          if Can_Never_Be_Null (Typ)
982            and then not Can_Never_Be_Null (Etype (N))
983            and then not Error_Posted (N)
984          then
985             Install_Null_Excluding_Check (N);
986          end if;
987       end if;
988    end Apply_Constraint_Check;
989
990    ------------------------------
991    -- Apply_Discriminant_Check --
992    ------------------------------
993
994    procedure Apply_Discriminant_Check
995      (N   : Node_Id;
996       Typ : Entity_Id;
997       Lhs : Node_Id := Empty)
998    is
999       Loc       : constant Source_Ptr := Sloc (N);
1000       Do_Access : constant Boolean    := Is_Access_Type (Typ);
1001       S_Typ     : Entity_Id  := Etype (N);
1002       Cond      : Node_Id;
1003       T_Typ     : Entity_Id;
1004
1005       function Is_Aliased_Unconstrained_Component return Boolean;
1006       --  It is possible for an aliased component to have a nominal
1007       --  unconstrained subtype (through instantiation). If this is a
1008       --  discriminated component assigned in the expansion of an aggregate
1009       --  in an initialization, the check must be suppressed. This unusual
1010       --  situation requires a predicate of its own.
1011
1012       ----------------------------------------
1013       -- Is_Aliased_Unconstrained_Component --
1014       ----------------------------------------
1015
1016       function Is_Aliased_Unconstrained_Component return Boolean is
1017          Comp : Entity_Id;
1018          Pref : Node_Id;
1019
1020       begin
1021          if Nkind (Lhs) /= N_Selected_Component then
1022             return False;
1023          else
1024             Comp := Entity (Selector_Name (Lhs));
1025             Pref := Prefix (Lhs);
1026          end if;
1027
1028          if Ekind (Comp) /= E_Component
1029            or else not Is_Aliased (Comp)
1030          then
1031             return False;
1032          end if;
1033
1034          return not Comes_From_Source (Pref)
1035            and then In_Instance
1036            and then not Is_Constrained (Etype (Comp));
1037       end Is_Aliased_Unconstrained_Component;
1038
1039    --  Start of processing for Apply_Discriminant_Check
1040
1041    begin
1042       if Do_Access then
1043          T_Typ := Designated_Type (Typ);
1044       else
1045          T_Typ := Typ;
1046       end if;
1047
1048       --  Nothing to do if discriminant checks are suppressed or else no code
1049       --  is to be generated
1050
1051       if not Expander_Active
1052         or else Discriminant_Checks_Suppressed (T_Typ)
1053       then
1054          return;
1055       end if;
1056
1057       --  No discriminant checks necessary for an access when expression is
1058       --  statically Null. This is not only an optimization, it is fundamental
1059       --  because otherwise discriminant checks may be generated in init procs
1060       --  for types containing an access to a not-yet-frozen record, causing a
1061       --  deadly forward reference.
1062
1063       --  Also, if the expression is of an access type whose designated type is
1064       --  incomplete, then the access value must be null and we suppress the
1065       --  check.
1066
1067       if Known_Null (N) then
1068          return;
1069
1070       elsif Is_Access_Type (S_Typ) then
1071          S_Typ := Designated_Type (S_Typ);
1072
1073          if Ekind (S_Typ) = E_Incomplete_Type then
1074             return;
1075          end if;
1076       end if;
1077
1078       --  If an assignment target is present, then we need to generate the
1079       --  actual subtype if the target is a parameter or aliased object with
1080       --  an unconstrained nominal subtype.
1081
1082       --  Ada 2005 (AI-363): For Ada 2005, we limit the building of the actual
1083       --  subtype to the parameter and dereference cases, since other aliased
1084       --  objects are unconstrained (unless the nominal subtype is explicitly
1085       --  constrained). (But we also need to test for renamings???)
1086
1087       if Present (Lhs)
1088         and then (Present (Param_Entity (Lhs))
1089                    or else (Ada_Version < Ada_05
1090                              and then not Is_Constrained (T_Typ)
1091                              and then Is_Aliased_View (Lhs)
1092                              and then not Is_Aliased_Unconstrained_Component)
1093                    or else (Ada_Version >= Ada_05
1094                              and then not Is_Constrained (T_Typ)
1095                              and then Nkind (Lhs) = N_Explicit_Dereference
1096                              and then Nkind (Original_Node (Lhs)) /=
1097                                         N_Function_Call))
1098       then
1099          T_Typ := Get_Actual_Subtype (Lhs);
1100       end if;
1101
1102       --  Nothing to do if the type is unconstrained (this is the case where
1103       --  the actual subtype in the RM sense of N is unconstrained and no check
1104       --  is required).
1105
1106       if not Is_Constrained (T_Typ) then
1107          return;
1108
1109       --  Ada 2005: nothing to do if the type is one for which there is a
1110       --  partial view that is constrained.
1111
1112       elsif Ada_Version >= Ada_05
1113         and then Has_Constrained_Partial_View (Base_Type (T_Typ))
1114       then
1115          return;
1116       end if;
1117
1118       --  Nothing to do if the type is an Unchecked_Union
1119
1120       if Is_Unchecked_Union (Base_Type (T_Typ)) then
1121          return;
1122       end if;
1123
1124       --  Suppress checks if the subtypes are the same. the check must be
1125       --  preserved in an assignment to a formal, because the constraint is
1126       --  given by the actual.
1127
1128       if Nkind (Original_Node (N)) /= N_Allocator
1129         and then (No (Lhs)
1130           or else not Is_Entity_Name (Lhs)
1131           or else No (Param_Entity (Lhs)))
1132       then
1133          if (Etype (N) = Typ
1134               or else (Do_Access and then Designated_Type (Typ) = S_Typ))
1135            and then not Is_Aliased_View (Lhs)
1136          then
1137             return;
1138          end if;
1139
1140       --  We can also eliminate checks on allocators with a subtype mark that
1141       --  coincides with the context type. The context type may be a subtype
1142       --  without a constraint (common case, a generic actual).
1143
1144       elsif Nkind (Original_Node (N)) = N_Allocator
1145         and then Is_Entity_Name (Expression (Original_Node (N)))
1146       then
1147          declare
1148             Alloc_Typ : constant Entity_Id :=
1149                           Entity (Expression (Original_Node (N)));
1150
1151          begin
1152             if Alloc_Typ = T_Typ
1153               or else (Nkind (Parent (T_Typ)) = N_Subtype_Declaration
1154                         and then Is_Entity_Name (
1155                           Subtype_Indication (Parent (T_Typ)))
1156                         and then Alloc_Typ = Base_Type (T_Typ))
1157
1158             then
1159                return;
1160             end if;
1161          end;
1162       end if;
1163
1164       --  See if we have a case where the types are both constrained, and all
1165       --  the constraints are constants. In this case, we can do the check
1166       --  successfully at compile time.
1167
1168       --  We skip this check for the case where the node is a rewritten`
1169       --  allocator, because it already carries the context subtype, and
1170       --  extracting the discriminants from the aggregate is messy.
1171
1172       if Is_Constrained (S_Typ)
1173         and then Nkind (Original_Node (N)) /= N_Allocator
1174       then
1175          declare
1176             DconT : Elmt_Id;
1177             Discr : Entity_Id;
1178             DconS : Elmt_Id;
1179             ItemS : Node_Id;
1180             ItemT : Node_Id;
1181
1182          begin
1183             --  S_Typ may not have discriminants in the case where it is a
1184             --  private type completed by a default discriminated type. In that
1185             --  case, we need to get the constraints from the underlying_type.
1186             --  If the underlying type is unconstrained (i.e. has no default
1187             --  discriminants) no check is needed.
1188
1189             if Has_Discriminants (S_Typ) then
1190                Discr := First_Discriminant (S_Typ);
1191                DconS := First_Elmt (Discriminant_Constraint (S_Typ));
1192
1193             else
1194                Discr := First_Discriminant (Underlying_Type (S_Typ));
1195                DconS :=
1196                  First_Elmt
1197                    (Discriminant_Constraint (Underlying_Type (S_Typ)));
1198
1199                if No (DconS) then
1200                   return;
1201                end if;
1202
1203                --  A further optimization: if T_Typ is derived from S_Typ
1204                --  without imposing a constraint, no check is needed.
1205
1206                if Nkind (Original_Node (Parent (T_Typ))) =
1207                  N_Full_Type_Declaration
1208                then
1209                   declare
1210                      Type_Def : constant Node_Id :=
1211                                  Type_Definition
1212                                    (Original_Node (Parent (T_Typ)));
1213                   begin
1214                      if Nkind (Type_Def) = N_Derived_Type_Definition
1215                        and then Is_Entity_Name (Subtype_Indication (Type_Def))
1216                        and then Entity (Subtype_Indication (Type_Def)) = S_Typ
1217                      then
1218                         return;
1219                      end if;
1220                   end;
1221                end if;
1222             end if;
1223
1224             DconT  := First_Elmt (Discriminant_Constraint (T_Typ));
1225
1226             while Present (Discr) loop
1227                ItemS := Node (DconS);
1228                ItemT := Node (DconT);
1229
1230                --  For a discriminated component type constrained by the
1231                --  current instance of an enclosing type, there is no
1232                --  applicable discriminant check.
1233
1234                if Nkind (ItemT) = N_Attribute_Reference
1235                  and then Is_Access_Type (Etype (ItemT))
1236                  and then Is_Entity_Name (Prefix (ItemT))
1237                  and then Is_Type (Entity (Prefix (ItemT)))
1238                then
1239                   return;
1240                end if;
1241
1242                exit when
1243                  not Is_OK_Static_Expression (ItemS)
1244                    or else
1245                  not Is_OK_Static_Expression (ItemT);
1246
1247                if Expr_Value (ItemS) /= Expr_Value (ItemT) then
1248                   if Do_Access then   --  needs run-time check.
1249                      exit;
1250                   else
1251                      Apply_Compile_Time_Constraint_Error
1252                        (N, "incorrect value for discriminant&?",
1253                         CE_Discriminant_Check_Failed, Ent => Discr);
1254                      return;
1255                   end if;
1256                end if;
1257
1258                Next_Elmt (DconS);
1259                Next_Elmt (DconT);
1260                Next_Discriminant (Discr);
1261             end loop;
1262
1263             if No (Discr) then
1264                return;
1265             end if;
1266          end;
1267       end if;
1268
1269       --  Here we need a discriminant check. First build the expression
1270       --  for the comparisons of the discriminants:
1271
1272       --    (n.disc1 /= typ.disc1) or else
1273       --    (n.disc2 /= typ.disc2) or else
1274       --     ...
1275       --    (n.discn /= typ.discn)
1276
1277       Cond := Build_Discriminant_Checks (N, T_Typ);
1278
1279       --  If Lhs is set and is a parameter, then the condition is
1280       --  guarded by: lhs'constrained and then (condition built above)
1281
1282       if Present (Param_Entity (Lhs)) then
1283          Cond :=
1284            Make_And_Then (Loc,
1285              Left_Opnd =>
1286                Make_Attribute_Reference (Loc,
1287                  Prefix => New_Occurrence_Of (Param_Entity (Lhs), Loc),
1288                  Attribute_Name => Name_Constrained),
1289              Right_Opnd => Cond);
1290       end if;
1291
1292       if Do_Access then
1293          Cond := Guard_Access (Cond, Loc, N);
1294       end if;
1295
1296       Insert_Action (N,
1297         Make_Raise_Constraint_Error (Loc,
1298           Condition => Cond,
1299           Reason    => CE_Discriminant_Check_Failed));
1300    end Apply_Discriminant_Check;
1301
1302    ------------------------
1303    -- Apply_Divide_Check --
1304    ------------------------
1305
1306    procedure Apply_Divide_Check (N : Node_Id) is
1307       Loc   : constant Source_Ptr := Sloc (N);
1308       Typ   : constant Entity_Id  := Etype (N);
1309       Left  : constant Node_Id    := Left_Opnd (N);
1310       Right : constant Node_Id    := Right_Opnd (N);
1311
1312       LLB : Uint;
1313       Llo : Uint;
1314       Lhi : Uint;
1315       LOK : Boolean;
1316       Rlo : Uint;
1317       Rhi : Uint;
1318       ROK : Boolean;
1319
1320    begin
1321       if Expander_Active
1322         and then not Backend_Divide_Checks_On_Target
1323         and then Check_Needed (Right, Division_Check)
1324       then
1325          Determine_Range (Right, ROK, Rlo, Rhi);
1326
1327          --  See if division by zero possible, and if so generate test. This
1328          --  part of the test is not controlled by the -gnato switch.
1329
1330          if Do_Division_Check (N) then
1331             if (not ROK) or else (Rlo <= 0 and then 0 <= Rhi) then
1332                Insert_Action (N,
1333                  Make_Raise_Constraint_Error (Loc,
1334                    Condition =>
1335                      Make_Op_Eq (Loc,
1336                        Left_Opnd  => Duplicate_Subexpr_Move_Checks (Right),
1337                        Right_Opnd => Make_Integer_Literal (Loc, 0)),
1338                    Reason => CE_Divide_By_Zero));
1339             end if;
1340          end if;
1341
1342          --  Test for extremely annoying case of xxx'First divided by -1
1343
1344          if Do_Overflow_Check (N) then
1345             if Nkind (N) = N_Op_Divide
1346               and then Is_Signed_Integer_Type (Typ)
1347             then
1348                Determine_Range (Left, LOK, Llo, Lhi);
1349                LLB := Expr_Value (Type_Low_Bound (Base_Type (Typ)));
1350
1351                if ((not ROK) or else (Rlo <= (-1) and then (-1) <= Rhi))
1352                  and then
1353                  ((not LOK) or else (Llo = LLB))
1354                then
1355                   Insert_Action (N,
1356                     Make_Raise_Constraint_Error (Loc,
1357                       Condition =>
1358                         Make_And_Then (Loc,
1359
1360                            Make_Op_Eq (Loc,
1361                              Left_Opnd  =>
1362                                Duplicate_Subexpr_Move_Checks (Left),
1363                              Right_Opnd => Make_Integer_Literal (Loc, LLB)),
1364
1365                            Make_Op_Eq (Loc,
1366                              Left_Opnd =>
1367                                Duplicate_Subexpr (Right),
1368                              Right_Opnd =>
1369                                Make_Integer_Literal (Loc, -1))),
1370                       Reason => CE_Overflow_Check_Failed));
1371                end if;
1372             end if;
1373          end if;
1374       end if;
1375    end Apply_Divide_Check;
1376
1377    ----------------------------------
1378    -- Apply_Float_Conversion_Check --
1379    ----------------------------------
1380
1381    --  Let F and I be the source and target types of the conversion. The RM
1382    --  specifies that a floating-point value X is rounded to the nearest
1383    --  integer, with halfway cases being rounded away from zero. The rounded
1384    --  value of X is checked against I'Range.
1385
1386    --  The catch in the above paragraph is that there is no good way to know
1387    --  whether the round-to-integer operation resulted in overflow. A remedy is
1388    --  to perform a range check in the floating-point domain instead, however:
1389
1390    --      (1)  The bounds may not be known at compile time
1391    --      (2)  The check must take into account rounding or truncation.
1392    --      (3)  The range of type I may not be exactly representable in F.
1393    --      (4)  For the rounding case, The end-points I'First - 0.5 and
1394    --           I'Last + 0.5 may or may not be in range, depending on the
1395    --           sign of  I'First and I'Last.
1396    --      (5)  X may be a NaN, which will fail any comparison
1397
1398    --  The following steps correctly convert X with rounding:
1399
1400    --      (1) If either I'First or I'Last is not known at compile time, use
1401    --          I'Base instead of I in the next three steps and perform a
1402    --          regular range check against I'Range after conversion.
1403    --      (2) If I'First - 0.5 is representable in F then let Lo be that
1404    --          value and define Lo_OK as (I'First > 0). Otherwise, let Lo be
1405    --          F'Machine (I'First) and let Lo_OK be (Lo >= I'First).
1406    --          In other words, take one of the closest floating-point numbers
1407    --          (which is an integer value) to I'First, and see if it is in
1408    --          range or not.
1409    --      (3) If I'Last + 0.5 is representable in F then let Hi be that value
1410    --          and define Hi_OK as (I'Last < 0). Otherwise, let Hi be
1411    --          F'Machine (I'Last) and let Hi_OK be (Hi <= I'Last).
1412    --      (4) Raise CE when (Lo_OK and X < Lo) or (not Lo_OK and X <= Lo)
1413    --                     or (Hi_OK and X > Hi) or (not Hi_OK and X >= Hi)
1414
1415    --  For the truncating case, replace steps (2) and (3) as follows:
1416    --      (2) If I'First > 0, then let Lo be F'Pred (I'First) and let Lo_OK
1417    --          be False. Otherwise, let Lo be F'Succ (I'First - 1) and let
1418    --          Lo_OK be True.
1419    --      (3) If I'Last < 0, then let Hi be F'Succ (I'Last) and let Hi_OK
1420    --          be False. Otherwise let Hi be F'Pred (I'Last + 1) and let
1421    --          Hi_OK be False
1422
1423    procedure Apply_Float_Conversion_Check
1424      (Ck_Node    : Node_Id;
1425       Target_Typ : Entity_Id)
1426    is
1427       LB          : constant Node_Id    := Type_Low_Bound (Target_Typ);
1428       HB          : constant Node_Id    := Type_High_Bound (Target_Typ);
1429       Loc         : constant Source_Ptr := Sloc (Ck_Node);
1430       Expr_Type   : constant Entity_Id  := Base_Type (Etype (Ck_Node));
1431       Target_Base : constant Entity_Id  :=
1432                       Implementation_Base_Type (Target_Typ);
1433
1434       Par : constant Node_Id := Parent (Ck_Node);
1435       pragma Assert (Nkind (Par) = N_Type_Conversion);
1436       --  Parent of check node, must be a type conversion
1437
1438       Truncate  : constant Boolean := Float_Truncate (Par);
1439       Max_Bound : constant Uint :=
1440                     UI_Expon
1441                       (Machine_Radix (Expr_Type),
1442                        Machine_Mantissa (Expr_Type) - 1) - 1;
1443
1444       --  Largest bound, so bound plus or minus half is a machine number of F
1445
1446       Ifirst, Ilast : Uint;
1447       --  Bounds of integer type
1448
1449       Lo, Hi : Ureal;
1450       --  Bounds to check in floating-point domain
1451
1452       Lo_OK, Hi_OK : Boolean;
1453       --  True iff Lo resp. Hi belongs to I'Range
1454
1455       Lo_Chk, Hi_Chk : Node_Id;
1456       --  Expressions that are False iff check fails
1457
1458       Reason : RT_Exception_Code;
1459
1460    begin
1461       if not Compile_Time_Known_Value (LB)
1462           or not Compile_Time_Known_Value (HB)
1463       then
1464          declare
1465             --  First check that the value falls in the range of the base type,
1466             --  to prevent overflow during conversion and then perform a
1467             --  regular range check against the (dynamic) bounds.
1468
1469             pragma Assert (Target_Base /= Target_Typ);
1470
1471             Temp : constant Entity_Id :=
1472                     Make_Defining_Identifier (Loc,
1473                       Chars => New_Internal_Name ('T'));
1474
1475          begin
1476             Apply_Float_Conversion_Check (Ck_Node, Target_Base);
1477             Set_Etype (Temp, Target_Base);
1478
1479             Insert_Action (Parent (Par),
1480               Make_Object_Declaration (Loc,
1481                 Defining_Identifier => Temp,
1482                 Object_Definition => New_Occurrence_Of (Target_Typ, Loc),
1483                 Expression => New_Copy_Tree (Par)),
1484                 Suppress => All_Checks);
1485
1486             Insert_Action (Par,
1487               Make_Raise_Constraint_Error (Loc,
1488                 Condition =>
1489                   Make_Not_In (Loc,
1490                     Left_Opnd  => New_Occurrence_Of (Temp, Loc),
1491                     Right_Opnd => New_Occurrence_Of (Target_Typ, Loc)),
1492                 Reason => CE_Range_Check_Failed));
1493             Rewrite (Par, New_Occurrence_Of (Temp, Loc));
1494
1495             return;
1496          end;
1497       end if;
1498
1499       --  Get the bounds of the target type
1500
1501       Ifirst := Expr_Value (LB);
1502       Ilast  := Expr_Value (HB);
1503
1504       --  Check against lower bound
1505
1506       if Truncate and then Ifirst > 0 then
1507          Lo := Pred (Expr_Type, UR_From_Uint (Ifirst));
1508          Lo_OK := False;
1509
1510       elsif Truncate then
1511          Lo := Succ (Expr_Type, UR_From_Uint (Ifirst - 1));
1512          Lo_OK := True;
1513
1514       elsif abs (Ifirst) < Max_Bound then
1515          Lo := UR_From_Uint (Ifirst) - Ureal_Half;
1516          Lo_OK := (Ifirst > 0);
1517
1518       else
1519          Lo := Machine (Expr_Type, UR_From_Uint (Ifirst), Round_Even, Ck_Node);
1520          Lo_OK := (Lo >= UR_From_Uint (Ifirst));
1521       end if;
1522
1523       if Lo_OK then
1524
1525          --  Lo_Chk := (X >= Lo)
1526
1527          Lo_Chk := Make_Op_Ge (Loc,
1528                      Left_Opnd => Duplicate_Subexpr_No_Checks (Ck_Node),
1529                      Right_Opnd => Make_Real_Literal (Loc, Lo));
1530
1531       else
1532          --  Lo_Chk := (X > Lo)
1533
1534          Lo_Chk := Make_Op_Gt (Loc,
1535                      Left_Opnd => Duplicate_Subexpr_No_Checks (Ck_Node),
1536                      Right_Opnd => Make_Real_Literal (Loc, Lo));
1537       end if;
1538
1539       --  Check against higher bound
1540
1541       if Truncate and then Ilast < 0 then
1542          Hi := Succ (Expr_Type, UR_From_Uint (Ilast));
1543          Lo_OK := False;
1544
1545       elsif Truncate then
1546          Hi := Pred (Expr_Type, UR_From_Uint (Ilast + 1));
1547          Hi_OK := True;
1548
1549       elsif abs (Ilast) < Max_Bound then
1550          Hi := UR_From_Uint (Ilast) + Ureal_Half;
1551          Hi_OK := (Ilast < 0);
1552       else
1553          Hi := Machine (Expr_Type, UR_From_Uint (Ilast), Round_Even, Ck_Node);
1554          Hi_OK := (Hi <= UR_From_Uint (Ilast));
1555       end if;
1556
1557       if Hi_OK then
1558
1559          --  Hi_Chk := (X <= Hi)
1560
1561          Hi_Chk := Make_Op_Le (Loc,
1562                      Left_Opnd => Duplicate_Subexpr_No_Checks (Ck_Node),
1563                      Right_Opnd => Make_Real_Literal (Loc, Hi));
1564
1565       else
1566          --  Hi_Chk := (X < Hi)
1567
1568          Hi_Chk := Make_Op_Lt (Loc,
1569                      Left_Opnd => Duplicate_Subexpr_No_Checks (Ck_Node),
1570                      Right_Opnd => Make_Real_Literal (Loc, Hi));
1571       end if;
1572
1573       --  If the bounds of the target type are the same as those of the base
1574       --  type, the check is an overflow check as a range check is not
1575       --  performed in these cases.
1576
1577       if Expr_Value (Type_Low_Bound (Target_Base)) = Ifirst
1578         and then Expr_Value (Type_High_Bound (Target_Base)) = Ilast
1579       then
1580          Reason := CE_Overflow_Check_Failed;
1581       else
1582          Reason := CE_Range_Check_Failed;
1583       end if;
1584
1585       --  Raise CE if either conditions does not hold
1586
1587       Insert_Action (Ck_Node,
1588         Make_Raise_Constraint_Error (Loc,
1589           Condition => Make_Op_Not (Loc, Make_And_Then (Loc, Lo_Chk, Hi_Chk)),
1590           Reason    => Reason));
1591    end Apply_Float_Conversion_Check;
1592
1593    ------------------------
1594    -- Apply_Length_Check --
1595    ------------------------
1596
1597    procedure Apply_Length_Check
1598      (Ck_Node    : Node_Id;
1599       Target_Typ : Entity_Id;
1600       Source_Typ : Entity_Id := Empty)
1601    is
1602    begin
1603       Apply_Selected_Length_Checks
1604         (Ck_Node, Target_Typ, Source_Typ, Do_Static => False);
1605    end Apply_Length_Check;
1606
1607    -----------------------
1608    -- Apply_Range_Check --
1609    -----------------------
1610
1611    procedure Apply_Range_Check
1612      (Ck_Node    : Node_Id;
1613       Target_Typ : Entity_Id;
1614       Source_Typ : Entity_Id := Empty)
1615    is
1616    begin
1617       Apply_Selected_Range_Checks
1618         (Ck_Node, Target_Typ, Source_Typ, Do_Static => False);
1619    end Apply_Range_Check;
1620
1621    ------------------------------
1622    -- Apply_Scalar_Range_Check --
1623    ------------------------------
1624
1625    --  Note that Apply_Scalar_Range_Check never turns the Do_Range_Check flag
1626    --  off if it is already set on.
1627
1628    procedure Apply_Scalar_Range_Check
1629      (Expr       : Node_Id;
1630       Target_Typ : Entity_Id;
1631       Source_Typ : Entity_Id := Empty;
1632       Fixed_Int  : Boolean   := False)
1633    is
1634       Parnt   : constant Node_Id := Parent (Expr);
1635       S_Typ   : Entity_Id;
1636       Arr     : Node_Id   := Empty;  -- initialize to prevent warning
1637       Arr_Typ : Entity_Id := Empty;  -- initialize to prevent warning
1638       OK      : Boolean;
1639
1640       Is_Subscr_Ref : Boolean;
1641       --  Set true if Expr is a subscript
1642
1643       Is_Unconstrained_Subscr_Ref : Boolean;
1644       --  Set true if Expr is a subscript of an unconstrained array. In this
1645       --  case we do not attempt to do an analysis of the value against the
1646       --  range of the subscript, since we don't know the actual subtype.
1647
1648       Int_Real : Boolean;
1649       --  Set to True if Expr should be regarded as a real value even though
1650       --  the type of Expr might be discrete.
1651
1652       procedure Bad_Value;
1653       --  Procedure called if value is determined to be out of range
1654
1655       ---------------
1656       -- Bad_Value --
1657       ---------------
1658
1659       procedure Bad_Value is
1660       begin
1661          Apply_Compile_Time_Constraint_Error
1662            (Expr, "value not in range of}?", CE_Range_Check_Failed,
1663             Ent => Target_Typ,
1664             Typ => Target_Typ);
1665       end Bad_Value;
1666
1667    --  Start of processing for Apply_Scalar_Range_Check
1668
1669    begin
1670       --  Return if check obviously not needed
1671
1672       if
1673          --  Not needed inside generic
1674
1675          Inside_A_Generic
1676
1677          --  Not needed if previous error
1678
1679          or else Target_Typ = Any_Type
1680          or else Nkind (Expr) = N_Error
1681
1682          --  Not needed for non-scalar type
1683
1684          or else not Is_Scalar_Type (Target_Typ)
1685
1686          --  Not needed if we know node raises CE already
1687
1688          or else Raises_Constraint_Error (Expr)
1689       then
1690          return;
1691       end if;
1692
1693       --  Now, see if checks are suppressed
1694
1695       Is_Subscr_Ref :=
1696         Is_List_Member (Expr) and then Nkind (Parnt) = N_Indexed_Component;
1697
1698       if Is_Subscr_Ref then
1699          Arr := Prefix (Parnt);
1700          Arr_Typ := Get_Actual_Subtype_If_Available (Arr);
1701       end if;
1702
1703       if not Do_Range_Check (Expr) then
1704
1705          --  Subscript reference. Check for Index_Checks suppressed
1706
1707          if Is_Subscr_Ref then
1708
1709             --  Check array type and its base type
1710
1711             if Index_Checks_Suppressed (Arr_Typ)
1712               or else Index_Checks_Suppressed (Base_Type (Arr_Typ))
1713             then
1714                return;
1715
1716             --  Check array itself if it is an entity name
1717
1718             elsif Is_Entity_Name (Arr)
1719               and then Index_Checks_Suppressed (Entity (Arr))
1720             then
1721                return;
1722
1723             --  Check expression itself if it is an entity name
1724
1725             elsif Is_Entity_Name (Expr)
1726               and then Index_Checks_Suppressed (Entity (Expr))
1727             then
1728                return;
1729             end if;
1730
1731          --  All other cases, check for Range_Checks suppressed
1732
1733          else
1734             --  Check target type and its base type
1735
1736             if Range_Checks_Suppressed (Target_Typ)
1737               or else Range_Checks_Suppressed (Base_Type (Target_Typ))
1738             then
1739                return;
1740
1741             --  Check expression itself if it is an entity name
1742
1743             elsif Is_Entity_Name (Expr)
1744               and then Range_Checks_Suppressed (Entity (Expr))
1745             then
1746                return;
1747
1748             --  If Expr is part of an assignment statement, then check left
1749             --  side of assignment if it is an entity name.
1750
1751             elsif Nkind (Parnt) = N_Assignment_Statement
1752               and then Is_Entity_Name (Name (Parnt))
1753               and then Range_Checks_Suppressed (Entity (Name (Parnt)))
1754             then
1755                return;
1756             end if;
1757          end if;
1758       end if;
1759
1760       --  Do not set range checks if they are killed
1761
1762       if Nkind (Expr) = N_Unchecked_Type_Conversion
1763         and then Kill_Range_Check (Expr)
1764       then
1765          return;
1766       end if;
1767
1768       --  Do not set range checks for any values from System.Scalar_Values
1769       --  since the whole idea of such values is to avoid checking them!
1770
1771       if Is_Entity_Name (Expr)
1772         and then Is_RTU (Scope (Entity (Expr)), System_Scalar_Values)
1773       then
1774          return;
1775       end if;
1776
1777       --  Now see if we need a check
1778
1779       if No (Source_Typ) then
1780          S_Typ := Etype (Expr);
1781       else
1782          S_Typ := Source_Typ;
1783       end if;
1784
1785       if not Is_Scalar_Type (S_Typ) or else S_Typ = Any_Type then
1786          return;
1787       end if;
1788
1789       Is_Unconstrained_Subscr_Ref :=
1790         Is_Subscr_Ref and then not Is_Constrained (Arr_Typ);
1791
1792       --  Always do a range check if the source type includes infinities and
1793       --  the target type does not include infinities. We do not do this if
1794       --  range checks are killed.
1795
1796       if Is_Floating_Point_Type (S_Typ)
1797         and then Has_Infinities (S_Typ)
1798         and then not Has_Infinities (Target_Typ)
1799       then
1800          Enable_Range_Check (Expr);
1801       end if;
1802
1803       --  Return if we know expression is definitely in the range of the target
1804       --  type as determined by Determine_Range. Right now we only do this for
1805       --  discrete types, and not fixed-point or floating-point types.
1806
1807       --  The additional less-precise tests below catch these cases
1808
1809       --  Note: skip this if we are given a source_typ, since the point of
1810       --  supplying a Source_Typ is to stop us looking at the expression.
1811       --  We could sharpen this test to be out parameters only ???
1812
1813       if Is_Discrete_Type (Target_Typ)
1814         and then Is_Discrete_Type (Etype (Expr))
1815         and then not Is_Unconstrained_Subscr_Ref
1816         and then No (Source_Typ)
1817       then
1818          declare
1819             Tlo : constant Node_Id := Type_Low_Bound  (Target_Typ);
1820             Thi : constant Node_Id := Type_High_Bound (Target_Typ);
1821             Lo  : Uint;
1822             Hi  : Uint;
1823
1824          begin
1825             if Compile_Time_Known_Value (Tlo)
1826               and then Compile_Time_Known_Value (Thi)
1827             then
1828                declare
1829                   Lov : constant Uint := Expr_Value (Tlo);
1830                   Hiv : constant Uint := Expr_Value (Thi);
1831
1832                begin
1833                   --  If range is null, we for sure have a constraint error
1834                   --  (we don't even need to look at the value involved,
1835                   --  since all possible values will raise CE).
1836
1837                   if Lov > Hiv then
1838                      Bad_Value;
1839                      return;
1840                   end if;
1841
1842                   --  Otherwise determine range of value
1843
1844                   Determine_Range (Expr, OK, Lo, Hi);
1845
1846                   if OK then
1847
1848                      --  If definitely in range, all OK
1849
1850                      if Lo >= Lov and then Hi <= Hiv then
1851                         return;
1852
1853                      --  If definitely not in range, warn
1854
1855                      elsif Lov > Hi or else Hiv < Lo then
1856                         Bad_Value;
1857                         return;
1858
1859                      --  Otherwise we don't know
1860
1861                      else
1862                         null;
1863                      end if;
1864                   end if;
1865                end;
1866             end if;
1867          end;
1868       end if;
1869
1870       Int_Real :=
1871         Is_Floating_Point_Type (S_Typ)
1872           or else (Is_Fixed_Point_Type (S_Typ) and then not Fixed_Int);
1873
1874       --  Check if we can determine at compile time whether Expr is in the
1875       --  range of the target type. Note that if S_Typ is within the bounds
1876       --  of Target_Typ then this must be the case. This check is meaningful
1877       --  only if this is not a conversion between integer and real types.
1878
1879       if not Is_Unconstrained_Subscr_Ref
1880         and then
1881            Is_Discrete_Type (S_Typ) = Is_Discrete_Type (Target_Typ)
1882         and then
1883           (In_Subrange_Of (S_Typ, Target_Typ, Fixed_Int)
1884              or else
1885            Is_In_Range (Expr, Target_Typ, Fixed_Int, Int_Real))
1886       then
1887          return;
1888
1889       elsif Is_Out_Of_Range (Expr, Target_Typ, Fixed_Int, Int_Real) then
1890          Bad_Value;
1891          return;
1892
1893       --  In the floating-point case, we only do range checks if the type is
1894       --  constrained. We definitely do NOT want range checks for unconstrained
1895       --  types, since we want to have infinities
1896
1897       elsif Is_Floating_Point_Type (S_Typ) then
1898          if Is_Constrained (S_Typ) then
1899             Enable_Range_Check (Expr);
1900          end if;
1901
1902       --  For all other cases we enable a range check unconditionally
1903
1904       else
1905          Enable_Range_Check (Expr);
1906          return;
1907       end if;
1908    end Apply_Scalar_Range_Check;
1909
1910    ----------------------------------
1911    -- Apply_Selected_Length_Checks --
1912    ----------------------------------
1913
1914    procedure Apply_Selected_Length_Checks
1915      (Ck_Node    : Node_Id;
1916       Target_Typ : Entity_Id;
1917       Source_Typ : Entity_Id;
1918       Do_Static  : Boolean)
1919    is
1920       Cond     : Node_Id;
1921       R_Result : Check_Result;
1922       R_Cno    : Node_Id;
1923
1924       Loc         : constant Source_Ptr := Sloc (Ck_Node);
1925       Checks_On   : constant Boolean :=
1926                       (not Index_Checks_Suppressed (Target_Typ))
1927                         or else
1928                       (not Length_Checks_Suppressed (Target_Typ));
1929
1930    begin
1931       if not Expander_Active then
1932          return;
1933       end if;
1934
1935       R_Result :=
1936         Selected_Length_Checks (Ck_Node, Target_Typ, Source_Typ, Empty);
1937
1938       for J in 1 .. 2 loop
1939          R_Cno := R_Result (J);
1940          exit when No (R_Cno);
1941
1942          --  A length check may mention an Itype which is attached to a
1943          --  subsequent node. At the top level in a package this can cause
1944          --  an order-of-elaboration problem, so we make sure that the itype
1945          --  is referenced now.
1946
1947          if Ekind (Current_Scope) = E_Package
1948            and then Is_Compilation_Unit (Current_Scope)
1949          then
1950             Ensure_Defined (Target_Typ, Ck_Node);
1951
1952             if Present (Source_Typ) then
1953                Ensure_Defined (Source_Typ, Ck_Node);
1954
1955             elsif Is_Itype (Etype (Ck_Node)) then
1956                Ensure_Defined (Etype (Ck_Node), Ck_Node);
1957             end if;
1958          end if;
1959
1960          --  If the item is a conditional raise of constraint error, then have
1961          --  a look at what check is being performed and ???
1962
1963          if Nkind (R_Cno) = N_Raise_Constraint_Error
1964            and then Present (Condition (R_Cno))
1965          then
1966             Cond := Condition (R_Cno);
1967
1968             --  Case where node does not now have a dynamic check
1969
1970             if not Has_Dynamic_Length_Check (Ck_Node) then
1971
1972                --  If checks are on, just insert the check
1973
1974                if Checks_On then
1975                   Insert_Action (Ck_Node, R_Cno);
1976
1977                   if not Do_Static then
1978                      Set_Has_Dynamic_Length_Check (Ck_Node);
1979                   end if;
1980
1981                --  If checks are off, then analyze the length check after
1982                --  temporarily attaching it to the tree in case the relevant
1983                --  condition can be evaluted at compile time. We still want a
1984                --  compile time warning in this case.
1985
1986                else
1987                   Set_Parent (R_Cno, Ck_Node);
1988                   Analyze (R_Cno);
1989                end if;
1990             end if;
1991
1992             --  Output a warning if the condition is known to be True
1993
1994             if Is_Entity_Name (Cond)
1995               and then Entity (Cond) = Standard_True
1996             then
1997                Apply_Compile_Time_Constraint_Error
1998                  (Ck_Node, "wrong length for array of}?",
1999                   CE_Length_Check_Failed,
2000                   Ent => Target_Typ,
2001                   Typ => Target_Typ);
2002
2003             --  If we were only doing a static check, or if checks are not
2004             --  on, then we want to delete the check, since it is not needed.
2005             --  We do this by replacing the if statement by a null statement
2006
2007             elsif Do_Static or else not Checks_On then
2008                Remove_Warning_Messages (R_Cno);
2009                Rewrite (R_Cno, Make_Null_Statement (Loc));
2010             end if;
2011
2012          else
2013             Install_Static_Check (R_Cno, Loc);
2014          end if;
2015       end loop;
2016    end Apply_Selected_Length_Checks;
2017
2018    ---------------------------------
2019    -- Apply_Selected_Range_Checks --
2020    ---------------------------------
2021
2022    procedure Apply_Selected_Range_Checks
2023      (Ck_Node    : Node_Id;
2024       Target_Typ : Entity_Id;
2025       Source_Typ : Entity_Id;
2026       Do_Static  : Boolean)
2027    is
2028       Cond     : Node_Id;
2029       R_Result : Check_Result;
2030       R_Cno    : Node_Id;
2031
2032       Loc       : constant Source_Ptr := Sloc (Ck_Node);
2033       Checks_On : constant Boolean :=
2034                     (not Index_Checks_Suppressed (Target_Typ))
2035                       or else
2036                     (not Range_Checks_Suppressed (Target_Typ));
2037
2038    begin
2039       if not Expander_Active or else not Checks_On then
2040          return;
2041       end if;
2042
2043       R_Result :=
2044         Selected_Range_Checks (Ck_Node, Target_Typ, Source_Typ, Empty);
2045
2046       for J in 1 .. 2 loop
2047
2048          R_Cno := R_Result (J);
2049          exit when No (R_Cno);
2050
2051          --  If the item is a conditional raise of constraint error, then have
2052          --  a look at what check is being performed and ???
2053
2054          if Nkind (R_Cno) = N_Raise_Constraint_Error
2055            and then Present (Condition (R_Cno))
2056          then
2057             Cond := Condition (R_Cno);
2058
2059             if not Has_Dynamic_Range_Check (Ck_Node) then
2060                Insert_Action (Ck_Node, R_Cno);
2061
2062                if not Do_Static then
2063                   Set_Has_Dynamic_Range_Check (Ck_Node);
2064                end if;
2065             end if;
2066
2067             --  Output a warning if the condition is known to be True
2068
2069             if Is_Entity_Name (Cond)
2070               and then Entity (Cond) = Standard_True
2071             then
2072                --  Since an N_Range is technically not an expression, we have
2073                --  to set one of the bounds to C_E and then just flag the
2074                --  N_Range. The warning message will point to the lower bound
2075                --  and complain about a range, which seems OK.
2076
2077                if Nkind (Ck_Node) = N_Range then
2078                   Apply_Compile_Time_Constraint_Error
2079                     (Low_Bound (Ck_Node), "static range out of bounds of}?",
2080                      CE_Range_Check_Failed,
2081                      Ent => Target_Typ,
2082                      Typ => Target_Typ);
2083
2084                   Set_Raises_Constraint_Error (Ck_Node);
2085
2086                else
2087                   Apply_Compile_Time_Constraint_Error
2088                     (Ck_Node, "static value out of range of}?",
2089                      CE_Range_Check_Failed,
2090                      Ent => Target_Typ,
2091                      Typ => Target_Typ);
2092                end if;
2093
2094             --  If we were only doing a static check, or if checks are not
2095             --  on, then we want to delete the check, since it is not needed.
2096             --  We do this by replacing the if statement by a null statement
2097
2098             elsif Do_Static or else not Checks_On then
2099                Remove_Warning_Messages (R_Cno);
2100                Rewrite (R_Cno, Make_Null_Statement (Loc));
2101             end if;
2102
2103          else
2104             Install_Static_Check (R_Cno, Loc);
2105          end if;
2106       end loop;
2107    end Apply_Selected_Range_Checks;
2108
2109    -------------------------------
2110    -- Apply_Static_Length_Check --
2111    -------------------------------
2112
2113    procedure Apply_Static_Length_Check
2114      (Expr       : Node_Id;
2115       Target_Typ : Entity_Id;
2116       Source_Typ : Entity_Id := Empty)
2117    is
2118    begin
2119       Apply_Selected_Length_Checks
2120         (Expr, Target_Typ, Source_Typ, Do_Static => True);
2121    end Apply_Static_Length_Check;
2122
2123    -------------------------------------
2124    -- Apply_Subscript_Validity_Checks --
2125    -------------------------------------
2126
2127    procedure Apply_Subscript_Validity_Checks (Expr : Node_Id) is
2128       Sub : Node_Id;
2129
2130    begin
2131       pragma Assert (Nkind (Expr) = N_Indexed_Component);
2132
2133       --  Loop through subscripts
2134
2135       Sub := First (Expressions (Expr));
2136       while Present (Sub) loop
2137
2138          --  Check one subscript. Note that we do not worry about enumeration
2139          --  type with holes, since we will convert the value to a Pos value
2140          --  for the subscript, and that convert will do the necessary validity
2141          --  check.
2142
2143          Ensure_Valid (Sub, Holes_OK => True);
2144
2145          --  Move to next subscript
2146
2147          Sub := Next (Sub);
2148       end loop;
2149    end Apply_Subscript_Validity_Checks;
2150
2151    ----------------------------------
2152    -- Apply_Type_Conversion_Checks --
2153    ----------------------------------
2154
2155    procedure Apply_Type_Conversion_Checks (N : Node_Id) is
2156       Target_Type : constant Entity_Id := Etype (N);
2157       Target_Base : constant Entity_Id := Base_Type (Target_Type);
2158       Expr        : constant Node_Id   := Expression (N);
2159       Expr_Type   : constant Entity_Id := Etype (Expr);
2160
2161    begin
2162       if Inside_A_Generic then
2163          return;
2164
2165       --  Skip these checks if serious errors detected, there are some nasty
2166       --  situations of incomplete trees that blow things up.
2167
2168       elsif Serious_Errors_Detected > 0 then
2169          return;
2170
2171       --  Scalar type conversions of the form Target_Type (Expr) require a
2172       --  range check if we cannot be sure that Expr is in the base type of
2173       --  Target_Typ and also that Expr is in the range of Target_Typ. These
2174       --  are not quite the same condition from an implementation point of
2175       --  view, but clearly the second includes the first.
2176
2177       elsif Is_Scalar_Type (Target_Type) then
2178          declare
2179             Conv_OK  : constant Boolean := Conversion_OK (N);
2180             --  If the Conversion_OK flag on the type conversion is set and no
2181             --  floating point type is involved in the type conversion then
2182             --  fixed point values must be read as integral values.
2183
2184             Float_To_Int : constant Boolean :=
2185                              Is_Floating_Point_Type (Expr_Type)
2186                                and then Is_Integer_Type (Target_Type);
2187
2188          begin
2189             if not Overflow_Checks_Suppressed (Target_Base)
2190               and then not In_Subrange_Of (Expr_Type, Target_Base, Conv_OK)
2191               and then not Float_To_Int
2192             then
2193                Activate_Overflow_Check (N);
2194             end if;
2195
2196             if not Range_Checks_Suppressed (Target_Type)
2197               and then not Range_Checks_Suppressed (Expr_Type)
2198             then
2199                if Float_To_Int then
2200                   Apply_Float_Conversion_Check (Expr, Target_Type);
2201                else
2202                   Apply_Scalar_Range_Check
2203                     (Expr, Target_Type, Fixed_Int => Conv_OK);
2204                end if;
2205             end if;
2206          end;
2207
2208       elsif Comes_From_Source (N)
2209         and then Is_Record_Type (Target_Type)
2210         and then Is_Derived_Type (Target_Type)
2211         and then not Is_Tagged_Type (Target_Type)
2212         and then not Is_Constrained (Target_Type)
2213         and then Present (Stored_Constraint (Target_Type))
2214       then
2215          --  An unconstrained derived type may have inherited discriminant
2216          --  Build an actual discriminant constraint list using the stored
2217          --  constraint, to verify that the expression of the parent type
2218          --  satisfies the constraints imposed by the (unconstrained!)
2219          --  derived type. This applies to value conversions, not to view
2220          --  conversions of tagged types.
2221
2222          declare
2223             Loc         : constant Source_Ptr := Sloc (N);
2224             Cond        : Node_Id;
2225             Constraint  : Elmt_Id;
2226             Discr_Value : Node_Id;
2227             Discr       : Entity_Id;
2228
2229             New_Constraints : constant Elist_Id := New_Elmt_List;
2230             Old_Constraints : constant Elist_Id :=
2231                                 Discriminant_Constraint (Expr_Type);
2232
2233          begin
2234             Constraint := First_Elmt (Stored_Constraint (Target_Type));
2235             while Present (Constraint) loop
2236                Discr_Value := Node (Constraint);
2237
2238                if Is_Entity_Name (Discr_Value)
2239                  and then Ekind (Entity (Discr_Value)) = E_Discriminant
2240                then
2241                   Discr := Corresponding_Discriminant (Entity (Discr_Value));
2242
2243                   if Present (Discr)
2244                     and then Scope (Discr) = Base_Type (Expr_Type)
2245                   then
2246                      --  Parent is constrained by new discriminant. Obtain
2247                      --  Value of original discriminant in expression. If the
2248                      --  new discriminant has been used to constrain more than
2249                      --  one of the stored discriminants, this will provide the
2250                      --  required consistency check.
2251
2252                      Append_Elmt (
2253                         Make_Selected_Component (Loc,
2254                           Prefix =>
2255                             Duplicate_Subexpr_No_Checks
2256                               (Expr, Name_Req => True),
2257                           Selector_Name =>
2258                             Make_Identifier (Loc, Chars (Discr))),
2259                                 New_Constraints);
2260
2261                   else
2262                      --  Discriminant of more remote ancestor ???
2263
2264                      return;
2265                   end if;
2266
2267                --  Derived type definition has an explicit value for this
2268                --  stored discriminant.
2269
2270                else
2271                   Append_Elmt
2272                     (Duplicate_Subexpr_No_Checks (Discr_Value),
2273                      New_Constraints);
2274                end if;
2275
2276                Next_Elmt (Constraint);
2277             end loop;
2278
2279             --  Use the unconstrained expression type to retrieve the
2280             --  discriminants of the parent, and apply momentarily the
2281             --  discriminant constraint synthesized above.
2282
2283             Set_Discriminant_Constraint (Expr_Type, New_Constraints);
2284             Cond := Build_Discriminant_Checks (Expr, Expr_Type);
2285             Set_Discriminant_Constraint (Expr_Type, Old_Constraints);
2286
2287             Insert_Action (N,
2288               Make_Raise_Constraint_Error (Loc,
2289                 Condition => Cond,
2290                 Reason    => CE_Discriminant_Check_Failed));
2291          end;
2292
2293       --  For arrays, conversions are applied during expansion, to take into
2294       --  accounts changes of representation. The checks become range checks on
2295       --  the base type or length checks on the subtype, depending on whether
2296       --  the target type is unconstrained or constrained.
2297
2298       else
2299          null;
2300       end if;
2301    end Apply_Type_Conversion_Checks;
2302
2303    ----------------------------------------------
2304    -- Apply_Universal_Integer_Attribute_Checks --
2305    ----------------------------------------------
2306
2307    procedure Apply_Universal_Integer_Attribute_Checks (N : Node_Id) is
2308       Loc : constant Source_Ptr := Sloc (N);
2309       Typ : constant Entity_Id  := Etype (N);
2310
2311    begin
2312       if Inside_A_Generic then
2313          return;
2314
2315       --  Nothing to do if checks are suppressed
2316
2317       elsif Range_Checks_Suppressed (Typ)
2318         and then Overflow_Checks_Suppressed (Typ)
2319       then
2320          return;
2321
2322       --  Nothing to do if the attribute does not come from source. The
2323       --  internal attributes we generate of this type do not need checks,
2324       --  and furthermore the attempt to check them causes some circular
2325       --  elaboration orders when dealing with packed types.
2326
2327       elsif not Comes_From_Source (N) then
2328          return;
2329
2330       --  If the prefix is a selected component that depends on a discriminant
2331       --  the check may improperly expose a discriminant instead of using
2332       --  the bounds of the object itself. Set the type of the attribute to
2333       --  the base type of the context, so that a check will be imposed when
2334       --  needed (e.g. if the node appears as an index).
2335
2336       elsif Nkind (Prefix (N)) = N_Selected_Component
2337         and then Ekind (Typ) = E_Signed_Integer_Subtype
2338         and then Depends_On_Discriminant (Scalar_Range (Typ))
2339       then
2340          Set_Etype (N, Base_Type (Typ));
2341
2342       --  Otherwise, replace the attribute node with a type conversion node
2343       --  whose expression is the attribute, retyped to universal integer, and
2344       --  whose subtype mark is the target type. The call to analyze this
2345       --  conversion will set range and overflow checks as required for proper
2346       --  detection of an out of range value.
2347
2348       else
2349          Set_Etype    (N, Universal_Integer);
2350          Set_Analyzed (N, True);
2351
2352          Rewrite (N,
2353            Make_Type_Conversion (Loc,
2354              Subtype_Mark => New_Occurrence_Of (Typ, Loc),
2355              Expression   => Relocate_Node (N)));
2356
2357          Analyze_And_Resolve (N, Typ);
2358          return;
2359       end if;
2360
2361    end Apply_Universal_Integer_Attribute_Checks;
2362
2363    -------------------------------
2364    -- Build_Discriminant_Checks --
2365    -------------------------------
2366
2367    function Build_Discriminant_Checks
2368      (N     : Node_Id;
2369       T_Typ : Entity_Id) return Node_Id
2370    is
2371       Loc      : constant Source_Ptr := Sloc (N);
2372       Cond     : Node_Id;
2373       Disc     : Elmt_Id;
2374       Disc_Ent : Entity_Id;
2375       Dref     : Node_Id;
2376       Dval     : Node_Id;
2377
2378       function Aggregate_Discriminant_Val (Disc : Entity_Id) return Node_Id;
2379
2380       ----------------------------------
2381       -- Aggregate_Discriminant_Value --
2382       ----------------------------------
2383
2384       function Aggregate_Discriminant_Val (Disc : Entity_Id) return Node_Id is
2385          Assoc : Node_Id;
2386
2387       begin
2388          --  The aggregate has been normalized with named associations. We use
2389          --  the Chars field to locate the discriminant to take into account
2390          --  discriminants in derived types, which carry the same name as those
2391          --  in the parent.
2392
2393          Assoc := First (Component_Associations (N));
2394          while Present (Assoc) loop
2395             if Chars (First (Choices (Assoc))) = Chars (Disc) then
2396                return Expression (Assoc);
2397             else
2398                Next (Assoc);
2399             end if;
2400          end loop;
2401
2402          --  Discriminant must have been found in the loop above
2403
2404          raise Program_Error;
2405       end Aggregate_Discriminant_Val;
2406
2407    --  Start of processing for Build_Discriminant_Checks
2408
2409    begin
2410       --  Loop through discriminants evolving the condition
2411
2412       Cond := Empty;
2413       Disc := First_Elmt (Discriminant_Constraint (T_Typ));
2414
2415       --  For a fully private type, use the discriminants of the parent type
2416
2417       if Is_Private_Type (T_Typ)
2418         and then No (Full_View (T_Typ))
2419       then
2420          Disc_Ent := First_Discriminant (Etype (Base_Type (T_Typ)));
2421       else
2422          Disc_Ent := First_Discriminant (T_Typ);
2423       end if;
2424
2425       while Present (Disc) loop
2426          Dval := Node (Disc);
2427
2428          if Nkind (Dval) = N_Identifier
2429            and then Ekind (Entity (Dval)) = E_Discriminant
2430          then
2431             Dval := New_Occurrence_Of (Discriminal (Entity (Dval)), Loc);
2432          else
2433             Dval := Duplicate_Subexpr_No_Checks (Dval);
2434          end if;
2435
2436          --  If we have an Unchecked_Union node, we can infer the discriminants
2437          --  of the node.
2438
2439          if Is_Unchecked_Union (Base_Type (T_Typ)) then
2440             Dref := New_Copy (
2441               Get_Discriminant_Value (
2442                 First_Discriminant (T_Typ),
2443                 T_Typ,
2444                 Stored_Constraint (T_Typ)));
2445
2446          elsif Nkind (N) = N_Aggregate then
2447             Dref :=
2448                Duplicate_Subexpr_No_Checks
2449                  (Aggregate_Discriminant_Val (Disc_Ent));
2450
2451          else
2452             Dref :=
2453               Make_Selected_Component (Loc,
2454                 Prefix =>
2455                   Duplicate_Subexpr_No_Checks (N, Name_Req => True),
2456                 Selector_Name =>
2457                   Make_Identifier (Loc, Chars (Disc_Ent)));
2458
2459             Set_Is_In_Discriminant_Check (Dref);
2460          end if;
2461
2462          Evolve_Or_Else (Cond,
2463            Make_Op_Ne (Loc,
2464              Left_Opnd => Dref,
2465              Right_Opnd => Dval));
2466
2467          Next_Elmt (Disc);
2468          Next_Discriminant (Disc_Ent);
2469       end loop;
2470
2471       return Cond;
2472    end Build_Discriminant_Checks;
2473
2474    ------------------
2475    -- Check_Needed --
2476    ------------------
2477
2478    function Check_Needed (Nod : Node_Id; Check : Check_Type) return Boolean is
2479       N : Node_Id;
2480       P : Node_Id;
2481       K : Node_Kind;
2482       L : Node_Id;
2483       R : Node_Id;
2484
2485    begin
2486       --  Always check if not simple entity
2487
2488       if Nkind (Nod) not in N_Has_Entity
2489         or else not Comes_From_Source (Nod)
2490       then
2491          return True;
2492       end if;
2493
2494       --  Look up tree for short circuit
2495
2496       N := Nod;
2497       loop
2498          P := Parent (N);
2499          K := Nkind (P);
2500
2501          if K not in N_Subexpr then
2502             return True;
2503
2504          --  Or/Or Else case, left operand must be equality test
2505
2506          elsif K = N_Op_Or or else K = N_Or_Else then
2507             exit when N = Right_Opnd (P)
2508               and then Nkind (Left_Opnd (P)) = N_Op_Eq;
2509
2510          --  And/And then case, left operand must be inequality test
2511
2512          elsif K = N_Op_And or else K = N_And_Then then
2513             exit when N = Right_Opnd (P)
2514               and then Nkind (Left_Opnd (P)) = N_Op_Ne;
2515          end if;
2516
2517          N := P;
2518       end loop;
2519
2520       --  If we fall through the loop, then we have a conditional with an
2521       --  appropriate test as its left operand. So test further.
2522
2523       L := Left_Opnd (P);
2524
2525       if Nkind (L) = N_Op_Not then
2526          L := Right_Opnd (L);
2527       end if;
2528
2529       R := Right_Opnd (L);
2530       L := Left_Opnd (L);
2531
2532       --  Left operand of test must match original variable
2533
2534       if Nkind (L) not in N_Has_Entity
2535         or else Entity (L) /= Entity (Nod)
2536       then
2537          return True;
2538       end if;
2539
2540       --  Right operand of test must be key value (zero or null)
2541
2542       case Check is
2543          when Access_Check =>
2544             if not Known_Null (R) then
2545                return True;
2546             end if;
2547
2548          when Division_Check =>
2549             if not Compile_Time_Known_Value (R)
2550               or else Expr_Value (R) /= Uint_0
2551             then
2552                return True;
2553             end if;
2554
2555          when others =>
2556             raise Program_Error;
2557       end case;
2558
2559       --  Here we have the optimizable case, warn if not short-circuited
2560
2561       if K = N_Op_And or else K = N_Op_Or then
2562          case Check is
2563             when Access_Check =>
2564                Error_Msg_N
2565                  ("Constraint_Error may be raised (access check)?",
2566                   Parent (Nod));
2567             when Division_Check =>
2568                Error_Msg_N
2569                  ("Constraint_Error may be raised (zero divide)?",
2570                   Parent (Nod));
2571
2572             when others =>
2573                raise Program_Error;
2574          end case;
2575
2576          if K = N_Op_And then
2577             Error_Msg_N ("use `AND THEN` instead of AND?", P);
2578          else
2579             Error_Msg_N ("use `OR ELSE` instead of OR?", P);
2580          end if;
2581
2582          --  If not short-circuited, we need the ckeck
2583
2584          return True;
2585
2586       --  If short-circuited, we can omit the check
2587
2588       else
2589          return False;
2590       end if;
2591    end Check_Needed;
2592
2593    -----------------------------------
2594    -- Check_Valid_Lvalue_Subscripts --
2595    -----------------------------------
2596
2597    procedure Check_Valid_Lvalue_Subscripts (Expr : Node_Id) is
2598    begin
2599       --  Skip this if range checks are suppressed
2600
2601       if Range_Checks_Suppressed (Etype (Expr)) then
2602          return;
2603
2604       --  Only do this check for expressions that come from source. We assume
2605       --  that expander generated assignments explicitly include any necessary
2606       --  checks. Note that this is not just an optimization, it avoids
2607       --  infinite recursions!
2608
2609       elsif not Comes_From_Source (Expr) then
2610          return;
2611
2612       --  For a selected component, check the prefix
2613
2614       elsif Nkind (Expr) = N_Selected_Component then
2615          Check_Valid_Lvalue_Subscripts (Prefix (Expr));
2616          return;
2617
2618       --  Case of indexed component
2619
2620       elsif Nkind (Expr) = N_Indexed_Component then
2621          Apply_Subscript_Validity_Checks (Expr);
2622
2623          --  Prefix may itself be or contain an indexed component, and these
2624          --  subscripts need checking as well.
2625
2626          Check_Valid_Lvalue_Subscripts (Prefix (Expr));
2627       end if;
2628    end Check_Valid_Lvalue_Subscripts;
2629
2630    ----------------------------------
2631    -- Null_Exclusion_Static_Checks --
2632    ----------------------------------
2633
2634    procedure Null_Exclusion_Static_Checks (N : Node_Id) is
2635       Error_Node : Node_Id;
2636       Expr       : Node_Id;
2637       Has_Null   : constant Boolean := Has_Null_Exclusion (N);
2638       K          : constant Node_Kind := Nkind (N);
2639       Typ        : Entity_Id;
2640
2641    begin
2642       pragma Assert
2643         (K = N_Component_Declaration
2644            or else K = N_Discriminant_Specification
2645            or else K = N_Function_Specification
2646            or else K = N_Object_Declaration
2647            or else K = N_Parameter_Specification);
2648
2649       if K = N_Function_Specification then
2650          Typ := Etype (Defining_Entity (N));
2651       else
2652          Typ := Etype (Defining_Identifier (N));
2653       end if;
2654
2655       case K is
2656          when N_Component_Declaration =>
2657             if Present (Access_Definition (Component_Definition (N))) then
2658                Error_Node := Component_Definition (N);
2659             else
2660                Error_Node := Subtype_Indication (Component_Definition (N));
2661             end if;
2662
2663          when N_Discriminant_Specification =>
2664             Error_Node    := Discriminant_Type (N);
2665
2666          when N_Function_Specification =>
2667             Error_Node    := Result_Definition (N);
2668
2669          when N_Object_Declaration =>
2670             Error_Node    := Object_Definition (N);
2671
2672          when N_Parameter_Specification =>
2673             Error_Node    := Parameter_Type (N);
2674
2675          when others =>
2676             raise Program_Error;
2677       end case;
2678
2679       if Has_Null then
2680
2681          --  Enforce legality rule 3.10 (13): A null exclusion can only be
2682          --  applied to an access [sub]type.
2683
2684          if not Is_Access_Type (Typ) then
2685             Error_Msg_N
2686               ("`NOT NULL` allowed only for an access type", Error_Node);
2687
2688          --  Enforce legality rule RM 3.10(14/1): A null exclusion can only
2689          --  be applied to a [sub]type that does not exclude null already.
2690
2691          elsif Can_Never_Be_Null (Typ)
2692
2693             --  No need to check itypes that have a null exclusion because
2694             --  they are already examined at their point of creation.
2695
2696            and then not Is_Itype (Typ)
2697          then
2698             Error_Msg_NE
2699               ("`NOT NULL` not allowed (& already excludes null)",
2700                Error_Node, Typ);
2701          end if;
2702       end if;
2703
2704       --  Check that null-excluding objects are always initialized
2705
2706       if K = N_Object_Declaration
2707         and then No (Expression (N))
2708         and then not No_Initialization (N)
2709       then
2710          --  Add an expression that assigns null. This node is needed by
2711          --  Apply_Compile_Time_Constraint_Error, which will replace this with
2712          --  a Constraint_Error node.
2713
2714          Set_Expression (N, Make_Null (Sloc (N)));
2715          Set_Etype (Expression (N), Etype (Defining_Identifier (N)));
2716
2717          Apply_Compile_Time_Constraint_Error
2718            (N      => Expression (N),
2719             Msg    => "(Ada 2005) null-excluding objects must be initialized?",
2720             Reason => CE_Null_Not_Allowed);
2721       end if;
2722
2723       --  Check that a null-excluding component, formal or object is not
2724       --  being assigned a null value. Otherwise generate a warning message
2725       --  and replace Expression (N) by a N_Contraint_Error node.
2726
2727       if K /= N_Function_Specification then
2728          Expr := Expression (N);
2729
2730          if Present (Expr) and then Known_Null (Expr) then
2731             case K is
2732                when N_Component_Declaration      |
2733                     N_Discriminant_Specification =>
2734                   Apply_Compile_Time_Constraint_Error
2735                     (N      => Expr,
2736                      Msg    => "(Ada 2005) null not allowed " &
2737                                "in null-excluding components?",
2738                      Reason => CE_Null_Not_Allowed);
2739
2740                when N_Object_Declaration =>
2741                   Apply_Compile_Time_Constraint_Error
2742                     (N      => Expr,
2743                      Msg    => "(Ada 2005) null not allowed " &
2744                                "in null-excluding objects?",
2745                      Reason => CE_Null_Not_Allowed);
2746
2747                when N_Parameter_Specification =>
2748                   Apply_Compile_Time_Constraint_Error
2749                     (N      => Expr,
2750                      Msg    => "(Ada 2005) null not allowed " &
2751                                "in null-excluding formals?",
2752                      Reason => CE_Null_Not_Allowed);
2753
2754                when others =>
2755                   null;
2756             end case;
2757          end if;
2758       end if;
2759    end Null_Exclusion_Static_Checks;
2760
2761    ----------------------------------
2762    -- Conditional_Statements_Begin --
2763    ----------------------------------
2764
2765    procedure Conditional_Statements_Begin is
2766    begin
2767       Saved_Checks_TOS := Saved_Checks_TOS + 1;
2768
2769       --  If stack overflows, kill all checks, that way we know to simply reset
2770       --  the number of saved checks to zero on return. This should never occur
2771       --  in practice.
2772
2773       if Saved_Checks_TOS > Saved_Checks_Stack'Last then
2774          Kill_All_Checks;
2775
2776       --  In the normal case, we just make a new stack entry saving the current
2777       --  number of saved checks for a later restore.
2778
2779       else
2780          Saved_Checks_Stack (Saved_Checks_TOS) := Num_Saved_Checks;
2781
2782          if Debug_Flag_CC then
2783             w ("Conditional_Statements_Begin: Num_Saved_Checks = ",
2784                Num_Saved_Checks);
2785          end if;
2786       end if;
2787    end Conditional_Statements_Begin;
2788
2789    --------------------------------
2790    -- Conditional_Statements_End --
2791    --------------------------------
2792
2793    procedure Conditional_Statements_End is
2794    begin
2795       pragma Assert (Saved_Checks_TOS > 0);
2796
2797       --  If the saved checks stack overflowed, then we killed all checks, so
2798       --  setting the number of saved checks back to zero is correct. This
2799       --  should never occur in practice.
2800
2801       if Saved_Checks_TOS > Saved_Checks_Stack'Last then
2802          Num_Saved_Checks := 0;
2803
2804       --  In the normal case, restore the number of saved checks from the top
2805       --  stack entry.
2806
2807       else
2808          Num_Saved_Checks := Saved_Checks_Stack (Saved_Checks_TOS);
2809          if Debug_Flag_CC then
2810             w ("Conditional_Statements_End: Num_Saved_Checks = ",
2811                Num_Saved_Checks);
2812          end if;
2813       end if;
2814
2815       Saved_Checks_TOS := Saved_Checks_TOS - 1;
2816    end Conditional_Statements_End;
2817
2818    ---------------------
2819    -- Determine_Range --
2820    ---------------------
2821
2822    Cache_Size : constant := 2 ** 10;
2823    type Cache_Index is range 0 .. Cache_Size - 1;
2824    --  Determine size of below cache (power of 2 is more efficient!)
2825
2826    Determine_Range_Cache_N  : array (Cache_Index) of Node_Id;
2827    Determine_Range_Cache_Lo : array (Cache_Index) of Uint;
2828    Determine_Range_Cache_Hi : array (Cache_Index) of Uint;
2829    --  The above arrays are used to implement a small direct cache for
2830    --  Determine_Range calls. Because of the way Determine_Range recursively
2831    --  traces subexpressions, and because overflow checking calls the routine
2832    --  on the way up the tree, a quadratic behavior can otherwise be
2833    --  encountered in large expressions. The cache entry for node N is stored
2834    --  in the (N mod Cache_Size) entry, and can be validated by checking the
2835    --  actual node value stored there.
2836
2837    procedure Determine_Range
2838      (N  : Node_Id;
2839       OK : out Boolean;
2840       Lo : out Uint;
2841       Hi : out Uint)
2842    is
2843       Typ : constant Entity_Id := Etype (N);
2844
2845       Lo_Left : Uint;
2846       Hi_Left : Uint;
2847       --  Lo and Hi bounds of left operand
2848
2849       Lo_Right : Uint;
2850       Hi_Right : Uint;
2851       --  Lo and Hi bounds of right (or only) operand
2852
2853       Bound : Node_Id;
2854       --  Temp variable used to hold a bound node
2855
2856       Hbound : Uint;
2857       --  High bound of base type of expression
2858
2859       Lor : Uint;
2860       Hir : Uint;
2861       --  Refined values for low and high bounds, after tightening
2862
2863       OK1 : Boolean;
2864       --  Used in lower level calls to indicate if call succeeded
2865
2866       Cindex : Cache_Index;
2867       --  Used to search cache
2868
2869       function OK_Operands return Boolean;
2870       --  Used for binary operators. Determines the ranges of the left and
2871       --  right operands, and if they are both OK, returns True, and puts
2872       --  the results in Lo_Right, Hi_Right, Lo_Left, Hi_Left
2873
2874       -----------------
2875       -- OK_Operands --
2876       -----------------
2877
2878       function OK_Operands return Boolean is
2879       begin
2880          Determine_Range (Left_Opnd  (N), OK1, Lo_Left,  Hi_Left);
2881
2882          if not OK1 then
2883             return False;
2884          end if;
2885
2886          Determine_Range (Right_Opnd (N), OK1, Lo_Right, Hi_Right);
2887          return OK1;
2888       end OK_Operands;
2889
2890    --  Start of processing for Determine_Range
2891
2892    begin
2893       --  Prevent junk warnings by initializing range variables
2894
2895       Lo  := No_Uint;
2896       Hi  := No_Uint;
2897       Lor := No_Uint;
2898       Hir := No_Uint;
2899
2900       --  If the type is not discrete, or is undefined, then we can't do
2901       --  anything about determining the range.
2902
2903       if No (Typ) or else not Is_Discrete_Type (Typ)
2904         or else Error_Posted (N)
2905       then
2906          OK := False;
2907          return;
2908       end if;
2909
2910       --  For all other cases, we can determine the range
2911
2912       OK := True;
2913
2914       --  If value is compile time known, then the possible range is the one
2915       --  value that we know this expression definitely has!
2916
2917       if Compile_Time_Known_Value (N) then
2918          Lo := Expr_Value (N);
2919          Hi := Lo;
2920          return;
2921       end if;
2922
2923       --  Return if already in the cache
2924
2925       Cindex := Cache_Index (N mod Cache_Size);
2926
2927       if Determine_Range_Cache_N (Cindex) = N then
2928          Lo := Determine_Range_Cache_Lo (Cindex);
2929          Hi := Determine_Range_Cache_Hi (Cindex);
2930          return;
2931       end if;
2932
2933       --  Otherwise, start by finding the bounds of the type of the expression,
2934       --  the value cannot be outside this range (if it is, then we have an
2935       --  overflow situation, which is a separate check, we are talking here
2936       --  only about the expression value).
2937
2938       --  We use the actual bound unless it is dynamic, in which case use the
2939       --  corresponding base type bound if possible. If we can't get a bound
2940       --  then we figure we can't determine the range (a peculiar case, that
2941       --  perhaps cannot happen, but there is no point in bombing in this
2942       --  optimization circuit.
2943
2944       --  First the low bound
2945
2946       Bound := Type_Low_Bound (Typ);
2947
2948       if Compile_Time_Known_Value (Bound) then
2949          Lo := Expr_Value (Bound);
2950
2951       elsif Compile_Time_Known_Value (Type_Low_Bound (Base_Type (Typ))) then
2952          Lo := Expr_Value (Type_Low_Bound (Base_Type (Typ)));
2953
2954       else
2955          OK := False;
2956          return;
2957       end if;
2958
2959       --  Now the high bound
2960
2961       Bound := Type_High_Bound (Typ);
2962
2963       --  We need the high bound of the base type later on, and this should
2964       --  always be compile time known. Again, it is not clear that this
2965       --  can ever be false, but no point in bombing.
2966
2967       if Compile_Time_Known_Value (Type_High_Bound (Base_Type (Typ))) then
2968          Hbound := Expr_Value (Type_High_Bound (Base_Type (Typ)));
2969          Hi := Hbound;
2970
2971       else
2972          OK := False;
2973          return;
2974       end if;
2975
2976       --  If we have a static subtype, then that may have a tighter bound so
2977       --  use the upper bound of the subtype instead in this case.
2978
2979       if Compile_Time_Known_Value (Bound) then
2980          Hi := Expr_Value (Bound);
2981       end if;
2982
2983       --  We may be able to refine this value in certain situations. If any
2984       --  refinement is possible, then Lor and Hir are set to possibly tighter
2985       --  bounds, and OK1 is set to True.
2986
2987       case Nkind (N) is
2988
2989          --  For unary plus, result is limited by range of operand
2990
2991          when N_Op_Plus =>
2992             Determine_Range (Right_Opnd (N), OK1, Lor, Hir);
2993
2994          --  For unary minus, determine range of operand, and negate it
2995
2996          when N_Op_Minus =>
2997             Determine_Range (Right_Opnd (N), OK1, Lo_Right, Hi_Right);
2998
2999             if OK1 then
3000                Lor := -Hi_Right;
3001                Hir := -Lo_Right;
3002             end if;
3003
3004          --  For binary addition, get range of each operand and do the
3005          --  addition to get the result range.
3006
3007          when N_Op_Add =>
3008             if OK_Operands then
3009                Lor := Lo_Left + Lo_Right;
3010                Hir := Hi_Left + Hi_Right;
3011             end if;
3012
3013          --  Division is tricky. The only case we consider is where the right
3014          --  operand is a positive constant, and in this case we simply divide
3015          --  the bounds of the left operand
3016
3017          when N_Op_Divide =>
3018             if OK_Operands then
3019                if Lo_Right = Hi_Right
3020                  and then Lo_Right > 0
3021                then
3022                   Lor := Lo_Left / Lo_Right;
3023                   Hir := Hi_Left / Lo_Right;
3024
3025                else
3026                   OK1 := False;
3027                end if;
3028             end if;
3029
3030          --  For binary subtraction, get range of each operand and do the worst
3031          --  case subtraction to get the result range.
3032
3033          when N_Op_Subtract =>
3034             if OK_Operands then
3035                Lor := Lo_Left - Hi_Right;
3036                Hir := Hi_Left - Lo_Right;
3037             end if;
3038
3039          --  For MOD, if right operand is a positive constant, then result must
3040          --  be in the allowable range of mod results.
3041
3042          when N_Op_Mod =>
3043             if OK_Operands then
3044                if Lo_Right = Hi_Right
3045                  and then Lo_Right /= 0
3046                then
3047                   if Lo_Right > 0 then
3048                      Lor := Uint_0;
3049                      Hir := Lo_Right - 1;
3050
3051                   else -- Lo_Right < 0
3052                      Lor := Lo_Right + 1;
3053                      Hir := Uint_0;
3054                   end if;
3055
3056                else
3057                   OK1 := False;
3058                end if;
3059             end if;
3060
3061          --  For REM, if right operand is a positive constant, then result must
3062          --  be in the allowable range of mod results.
3063
3064          when N_Op_Rem =>
3065             if OK_Operands then
3066                if Lo_Right = Hi_Right
3067                  and then Lo_Right /= 0
3068                then
3069                   declare
3070                      Dval : constant Uint := (abs Lo_Right) - 1;
3071
3072                   begin
3073                      --  The sign of the result depends on the sign of the
3074                      --  dividend (but not on the sign of the divisor, hence
3075                      --  the abs operation above).
3076
3077                      if Lo_Left < 0 then
3078                         Lor := -Dval;
3079                      else
3080                         Lor := Uint_0;
3081                      end if;
3082
3083                      if Hi_Left < 0 then
3084                         Hir := Uint_0;
3085                      else
3086                         Hir := Dval;
3087                      end if;
3088                   end;
3089
3090                else
3091                   OK1 := False;
3092                end if;
3093             end if;
3094
3095          --  Attribute reference cases
3096
3097          when N_Attribute_Reference =>
3098             case Attribute_Name (N) is
3099
3100                --  For Pos/Val attributes, we can refine the range using the
3101                --  possible range of values of the attribute expression
3102
3103                when Name_Pos | Name_Val =>
3104                   Determine_Range (First (Expressions (N)), OK1, Lor, Hir);
3105
3106                --  For Length attribute, use the bounds of the corresponding
3107                --  index type to refine the range.
3108
3109                when Name_Length =>
3110                   declare
3111                      Atyp : Entity_Id := Etype (Prefix (N));
3112                      Inum : Nat;
3113                      Indx : Node_Id;
3114
3115                      LL, LU : Uint;
3116                      UL, UU : Uint;
3117
3118                   begin
3119                      if Is_Access_Type (Atyp) then
3120                         Atyp := Designated_Type (Atyp);
3121                      end if;
3122
3123                      --  For string literal, we know exact value
3124
3125                      if Ekind (Atyp) = E_String_Literal_Subtype then
3126                         OK := True;
3127                         Lo := String_Literal_Length (Atyp);
3128                         Hi := String_Literal_Length (Atyp);
3129                         return;
3130                      end if;
3131
3132                      --  Otherwise check for expression given
3133
3134                      if No (Expressions (N)) then
3135                         Inum := 1;
3136                      else
3137                         Inum :=
3138                           UI_To_Int (Expr_Value (First (Expressions (N))));
3139                      end if;
3140
3141                      Indx := First_Index (Atyp);
3142                      for J in 2 .. Inum loop
3143                         Indx := Next_Index (Indx);
3144                      end loop;
3145
3146                      Determine_Range
3147                        (Type_Low_Bound (Etype (Indx)), OK1, LL, LU);
3148
3149                      if OK1 then
3150                         Determine_Range
3151                           (Type_High_Bound (Etype (Indx)), OK1, UL, UU);
3152
3153                         if OK1 then
3154
3155                            --  The maximum value for Length is the biggest
3156                            --  possible gap between the values of the bounds.
3157                            --  But of course, this value cannot be negative.
3158
3159                            Hir := UI_Max (Uint_0, UU - LL);
3160
3161                            --  For constrained arrays, the minimum value for
3162                            --  Length is taken from the actual value of the
3163                            --  bounds, since the index will be exactly of
3164                            --  this subtype.
3165
3166                            if Is_Constrained (Atyp) then
3167                               Lor := UI_Max (Uint_0, UL - LU);
3168
3169                            --  For an unconstrained array, the minimum value
3170                            --  for length is always zero.
3171
3172                            else
3173                               Lor := Uint_0;
3174                            end if;
3175                         end if;
3176                      end if;
3177                   end;
3178
3179                --  No special handling for other attributes
3180                --  Probably more opportunities exist here ???
3181
3182                when others =>
3183                   OK1 := False;
3184
3185             end case;
3186
3187          --  For type conversion from one discrete type to another, we can
3188          --  refine the range using the converted value.
3189
3190          when N_Type_Conversion =>
3191             Determine_Range (Expression (N), OK1, Lor, Hir);
3192
3193          --  Nothing special to do for all other expression kinds
3194
3195          when others =>
3196             OK1 := False;
3197             Lor := No_Uint;
3198             Hir := No_Uint;
3199       end case;
3200
3201       --  At this stage, if OK1 is true, then we know that the actual
3202       --  result of the computed expression is in the range Lor .. Hir.
3203       --  We can use this to restrict the possible range of results.
3204
3205       if OK1 then
3206
3207          --  If the refined value of the low bound is greater than the
3208          --  type high bound, then reset it to the more restrictive
3209          --  value. However, we do NOT do this for the case of a modular
3210          --  type where the possible upper bound on the value is above the
3211          --  base type high bound, because that means the result could wrap.
3212
3213          if Lor > Lo
3214            and then not (Is_Modular_Integer_Type (Typ)
3215                            and then Hir > Hbound)
3216          then
3217             Lo := Lor;
3218          end if;
3219
3220          --  Similarly, if the refined value of the high bound is less
3221          --  than the value so far, then reset it to the more restrictive
3222          --  value. Again, we do not do this if the refined low bound is
3223          --  negative for a modular type, since this would wrap.
3224
3225          if Hir < Hi
3226            and then not (Is_Modular_Integer_Type (Typ)
3227                           and then Lor < Uint_0)
3228          then
3229             Hi := Hir;
3230          end if;
3231       end if;
3232
3233       --  Set cache entry for future call and we are all done
3234
3235       Determine_Range_Cache_N  (Cindex) := N;
3236       Determine_Range_Cache_Lo (Cindex) := Lo;
3237       Determine_Range_Cache_Hi (Cindex) := Hi;
3238       return;
3239
3240    --  If any exception occurs, it means that we have some bug in the compiler
3241    --  possibly triggered by a previous error, or by some unforseen peculiar
3242    --  occurrence. However, this is only an optimization attempt, so there is
3243    --  really no point in crashing the compiler. Instead we just decide, too
3244    --  bad, we can't figure out a range in this case after all.
3245
3246    exception
3247       when others =>
3248
3249          --  Debug flag K disables this behavior (useful for debugging)
3250
3251          if Debug_Flag_K then
3252             raise;
3253          else
3254             OK := False;
3255             Lo := No_Uint;
3256             Hi := No_Uint;
3257             return;
3258          end if;
3259    end Determine_Range;
3260
3261    ------------------------------------
3262    -- Discriminant_Checks_Suppressed --
3263    ------------------------------------
3264
3265    function Discriminant_Checks_Suppressed (E : Entity_Id) return Boolean is
3266    begin
3267       if Present (E) then
3268          if Is_Unchecked_Union (E) then
3269             return True;
3270          elsif Checks_May_Be_Suppressed (E) then
3271             return Is_Check_Suppressed (E, Discriminant_Check);
3272          end if;
3273       end if;
3274
3275       return Scope_Suppress (Discriminant_Check);
3276    end Discriminant_Checks_Suppressed;
3277
3278    --------------------------------
3279    -- Division_Checks_Suppressed --
3280    --------------------------------
3281
3282    function Division_Checks_Suppressed (E : Entity_Id) return Boolean is
3283    begin
3284       if Present (E) and then Checks_May_Be_Suppressed (E) then
3285          return Is_Check_Suppressed (E, Division_Check);
3286       else
3287          return Scope_Suppress (Division_Check);
3288       end if;
3289    end Division_Checks_Suppressed;
3290
3291    -----------------------------------
3292    -- Elaboration_Checks_Suppressed --
3293    -----------------------------------
3294
3295    function Elaboration_Checks_Suppressed (E : Entity_Id) return Boolean is
3296    begin
3297       --  The complication in this routine is that if we are in the dynamic
3298       --  model of elaboration, we also check All_Checks, since All_Checks
3299       --  does not set Elaboration_Check explicitly.
3300
3301       if Present (E) then
3302          if Kill_Elaboration_Checks (E) then
3303             return True;
3304
3305          elsif Checks_May_Be_Suppressed (E) then
3306             if Is_Check_Suppressed (E, Elaboration_Check) then
3307                return True;
3308             elsif Dynamic_Elaboration_Checks then
3309                return Is_Check_Suppressed (E, All_Checks);
3310             else
3311                return False;
3312             end if;
3313          end if;
3314       end if;
3315
3316       if Scope_Suppress (Elaboration_Check) then
3317          return True;
3318       elsif Dynamic_Elaboration_Checks then
3319          return Scope_Suppress (All_Checks);
3320       else
3321          return False;
3322       end if;
3323    end Elaboration_Checks_Suppressed;
3324
3325    ---------------------------
3326    -- Enable_Overflow_Check --
3327    ---------------------------
3328
3329    procedure Enable_Overflow_Check (N : Node_Id) is
3330       Typ : constant Entity_Id  := Base_Type (Etype (N));
3331       Chk : Nat;
3332       OK  : Boolean;
3333       Ent : Entity_Id;
3334       Ofs : Uint;
3335       Lo  : Uint;
3336       Hi  : Uint;
3337
3338    begin
3339       if Debug_Flag_CC then
3340          w ("Enable_Overflow_Check for node ", Int (N));
3341          Write_Str ("  Source location = ");
3342          wl (Sloc (N));
3343          pg (Union_Id (N));
3344       end if;
3345
3346       --  Nothing to do if the range of the result is known OK. We skip this
3347       --  for conversions, since the caller already did the check, and in any
3348       --  case the condition for deleting the check for a type conversion is
3349       --  different in any case.
3350
3351       if Nkind (N) /= N_Type_Conversion then
3352          Determine_Range (N, OK, Lo, Hi);
3353
3354          --  Note in the test below that we assume that if a bound of the
3355          --  range is equal to that of the type. That's not quite accurate
3356          --  but we do this for the following reasons:
3357
3358          --   a) The way that Determine_Range works, it will typically report
3359          --      the bounds of the value as being equal to the bounds of the
3360          --      type, because it either can't tell anything more precise, or
3361          --      does not think it is worth the effort to be more precise.
3362
3363          --   b) It is very unusual to have a situation in which this would
3364          --      generate an unnecessary overflow check (an example would be
3365          --      a subtype with a range 0 .. Integer'Last - 1 to which the
3366          --      literal value one is added.
3367
3368          --   c) The alternative is a lot of special casing in this routine
3369          --      which would partially duplicate Determine_Range processing.
3370
3371          if OK
3372            and then Lo > Expr_Value (Type_Low_Bound  (Typ))
3373            and then Hi < Expr_Value (Type_High_Bound (Typ))
3374          then
3375             if Debug_Flag_CC then
3376                w ("No overflow check required");
3377             end if;
3378
3379             return;
3380          end if;
3381       end if;
3382
3383       --  If not in optimizing mode, set flag and we are done. We are also done
3384       --  (and just set the flag) if the type is not a discrete type, since it
3385       --  is not worth the effort to eliminate checks for other than discrete
3386       --  types. In addition, we take this same path if we have stored the
3387       --  maximum number of checks possible already (a very unlikely situation,
3388       --  but we do not want to blow up!)
3389
3390       if Optimization_Level = 0
3391         or else not Is_Discrete_Type (Etype (N))
3392         or else Num_Saved_Checks = Saved_Checks'Last
3393       then
3394          Activate_Overflow_Check (N);
3395
3396          if Debug_Flag_CC then
3397             w ("Optimization off");
3398          end if;
3399
3400          return;
3401       end if;
3402
3403       --  Otherwise evaluate and check the expression
3404
3405       Find_Check
3406         (Expr        => N,
3407          Check_Type  => 'O',
3408          Target_Type => Empty,
3409          Entry_OK    => OK,
3410          Check_Num   => Chk,
3411          Ent         => Ent,
3412          Ofs         => Ofs);
3413
3414       if Debug_Flag_CC then
3415          w ("Called Find_Check");
3416          w ("  OK = ", OK);
3417
3418          if OK then
3419             w ("  Check_Num = ", Chk);
3420             w ("  Ent       = ", Int (Ent));
3421             Write_Str ("  Ofs       = ");
3422             pid (Ofs);
3423          end if;
3424       end if;
3425
3426       --  If check is not of form to optimize, then set flag and we are done
3427
3428       if not OK then
3429          Activate_Overflow_Check (N);
3430          return;
3431       end if;
3432
3433       --  If check is already performed, then return without setting flag
3434
3435       if Chk /= 0 then
3436          if Debug_Flag_CC then
3437             w ("Check suppressed!");
3438          end if;
3439
3440          return;
3441       end if;
3442
3443       --  Here we will make a new entry for the new check
3444
3445       Activate_Overflow_Check (N);
3446       Num_Saved_Checks := Num_Saved_Checks + 1;
3447       Saved_Checks (Num_Saved_Checks) :=
3448         (Killed      => False,
3449          Entity      => Ent,
3450          Offset      => Ofs,
3451          Check_Type  => 'O',
3452          Target_Type => Empty);
3453
3454       if Debug_Flag_CC then
3455          w ("Make new entry, check number = ", Num_Saved_Checks);
3456          w ("  Entity = ", Int (Ent));
3457          Write_Str ("  Offset = ");
3458          pid (Ofs);
3459          w ("  Check_Type = O");
3460          w ("  Target_Type = Empty");
3461       end if;
3462
3463    --  If we get an exception, then something went wrong, probably because of
3464    --  an error in the structure of the tree due to an incorrect program. Or it
3465    --  may be a bug in the optimization circuit. In either case the safest
3466    --  thing is simply to set the check flag unconditionally.
3467
3468    exception
3469       when others =>
3470          Activate_Overflow_Check (N);
3471
3472          if Debug_Flag_CC then
3473             w ("  exception occurred, overflow flag set");
3474          end if;
3475
3476          return;
3477    end Enable_Overflow_Check;
3478
3479    ------------------------
3480    -- Enable_Range_Check --
3481    ------------------------
3482
3483    procedure Enable_Range_Check (N : Node_Id) is
3484       Chk  : Nat;
3485       OK   : Boolean;
3486       Ent  : Entity_Id;
3487       Ofs  : Uint;
3488       Ttyp : Entity_Id;
3489       P    : Node_Id;
3490
3491    begin
3492       --  Return if unchecked type conversion with range check killed. In this
3493       --  case we never set the flag (that's what Kill_Range_Check is about!)
3494
3495       if Nkind (N) = N_Unchecked_Type_Conversion
3496         and then Kill_Range_Check (N)
3497       then
3498          return;
3499       end if;
3500
3501       --  Check for various cases where we should suppress the range check
3502
3503       --  No check if range checks suppressed for type of node
3504
3505       if Present (Etype (N))
3506         and then Range_Checks_Suppressed (Etype (N))
3507       then
3508          return;
3509
3510       --  No check if node is an entity name, and range checks are suppressed
3511       --  for this entity, or for the type of this entity.
3512
3513       elsif Is_Entity_Name (N)
3514         and then (Range_Checks_Suppressed (Entity (N))
3515                     or else Range_Checks_Suppressed (Etype (Entity (N))))
3516       then
3517          return;
3518
3519       --  No checks if index of array, and index checks are suppressed for
3520       --  the array object or the type of the array.
3521
3522       elsif Nkind (Parent (N)) = N_Indexed_Component then
3523          declare
3524             Pref : constant Node_Id := Prefix (Parent (N));
3525          begin
3526             if Is_Entity_Name (Pref)
3527               and then Index_Checks_Suppressed (Entity (Pref))
3528             then
3529                return;
3530             elsif Index_Checks_Suppressed (Etype (Pref)) then
3531                return;
3532             end if;
3533          end;
3534       end if;
3535
3536       --  Debug trace output
3537
3538       if Debug_Flag_CC then
3539          w ("Enable_Range_Check for node ", Int (N));
3540          Write_Str ("  Source location = ");
3541          wl (Sloc (N));
3542          pg (Union_Id (N));
3543       end if;
3544
3545       --  If not in optimizing mode, set flag and we are done. We are also done
3546       --  (and just set the flag) if the type is not a discrete type, since it
3547       --  is not worth the effort to eliminate checks for other than discrete
3548       --  types. In addition, we take this same path if we have stored the
3549       --  maximum number of checks possible already (a very unlikely situation,
3550       --  but we do not want to blow up!)
3551
3552       if Optimization_Level = 0
3553         or else No (Etype (N))
3554         or else not Is_Discrete_Type (Etype (N))
3555         or else Num_Saved_Checks = Saved_Checks'Last
3556       then
3557          Activate_Range_Check (N);
3558
3559          if Debug_Flag_CC then
3560             w ("Optimization off");
3561          end if;
3562
3563          return;
3564       end if;
3565
3566       --  Otherwise find out the target type
3567
3568       P := Parent (N);
3569
3570       --  For assignment, use left side subtype
3571
3572       if Nkind (P) = N_Assignment_Statement
3573         and then Expression (P) = N
3574       then
3575          Ttyp := Etype (Name (P));
3576
3577       --  For indexed component, use subscript subtype
3578
3579       elsif Nkind (P) = N_Indexed_Component then
3580          declare
3581             Atyp : Entity_Id;
3582             Indx : Node_Id;
3583             Subs : Node_Id;
3584
3585          begin
3586             Atyp := Etype (Prefix (P));
3587
3588             if Is_Access_Type (Atyp) then
3589                Atyp := Designated_Type (Atyp);
3590
3591                --  If the prefix is an access to an unconstrained array,
3592                --  perform check unconditionally: it depends on the bounds of
3593                --  an object and we cannot currently recognize whether the test
3594                --  may be redundant.
3595
3596                if not Is_Constrained (Atyp) then
3597                   Activate_Range_Check (N);
3598                   return;
3599                end if;
3600
3601             --  Ditto if the prefix is an explicit dereference whose designated
3602             --  type is unconstrained.
3603
3604             elsif Nkind (Prefix (P)) = N_Explicit_Dereference
3605               and then not Is_Constrained (Atyp)
3606             then
3607                Activate_Range_Check (N);
3608                return;
3609             end if;
3610
3611             Indx := First_Index (Atyp);
3612             Subs := First (Expressions (P));
3613             loop
3614                if Subs = N then
3615                   Ttyp := Etype (Indx);
3616                   exit;
3617                end if;
3618
3619                Next_Index (Indx);
3620                Next (Subs);
3621             end loop;
3622          end;
3623
3624       --  For now, ignore all other cases, they are not so interesting
3625
3626       else
3627          if Debug_Flag_CC then
3628             w ("  target type not found, flag set");
3629          end if;
3630
3631          Activate_Range_Check (N);
3632          return;
3633       end if;
3634
3635       --  Evaluate and check the expression
3636
3637       Find_Check
3638         (Expr        => N,
3639          Check_Type  => 'R',
3640          Target_Type => Ttyp,
3641          Entry_OK    => OK,
3642          Check_Num   => Chk,
3643          Ent         => Ent,
3644          Ofs         => Ofs);
3645
3646       if Debug_Flag_CC then
3647          w ("Called Find_Check");
3648          w ("Target_Typ = ", Int (Ttyp));
3649          w ("  OK = ", OK);
3650
3651          if OK then
3652             w ("  Check_Num = ", Chk);
3653             w ("  Ent       = ", Int (Ent));
3654             Write_Str ("  Ofs       = ");
3655             pid (Ofs);
3656          end if;
3657       end if;
3658
3659       --  If check is not of form to optimize, then set flag and we are done
3660
3661       if not OK then
3662          if Debug_Flag_CC then
3663             w ("  expression not of optimizable type, flag set");
3664          end if;
3665
3666          Activate_Range_Check (N);
3667          return;
3668       end if;
3669
3670       --  If check is already performed, then return without setting flag
3671
3672       if Chk /= 0 then
3673          if Debug_Flag_CC then
3674             w ("Check suppressed!");
3675          end if;
3676
3677          return;
3678       end if;
3679
3680       --  Here we will make a new entry for the new check
3681
3682       Activate_Range_Check (N);
3683       Num_Saved_Checks := Num_Saved_Checks + 1;
3684       Saved_Checks (Num_Saved_Checks) :=
3685         (Killed      => False,
3686          Entity      => Ent,
3687          Offset      => Ofs,
3688          Check_Type  => 'R',
3689          Target_Type => Ttyp);
3690
3691       if Debug_Flag_CC then
3692          w ("Make new entry, check number = ", Num_Saved_Checks);
3693          w ("  Entity = ", Int (Ent));
3694          Write_Str ("  Offset = ");
3695          pid (Ofs);
3696          w ("  Check_Type = R");
3697          w ("  Target_Type = ", Int (Ttyp));
3698          pg (Union_Id (Ttyp));
3699       end if;
3700
3701    --  If we get an exception, then something went wrong, probably because of
3702    --  an error in the structure of the tree due to an incorrect program. Or
3703    --  it may be a bug in the optimization circuit. In either case the safest
3704    --  thing is simply to set the check flag unconditionally.
3705
3706    exception
3707       when others =>
3708          Activate_Range_Check (N);
3709
3710          if Debug_Flag_CC then
3711             w ("  exception occurred, range flag set");
3712          end if;
3713
3714          return;
3715    end Enable_Range_Check;
3716
3717    ------------------
3718    -- Ensure_Valid --
3719    ------------------
3720
3721    procedure Ensure_Valid (Expr : Node_Id; Holes_OK : Boolean := False) is
3722       Typ : constant Entity_Id  := Etype (Expr);
3723
3724    begin
3725       --  Ignore call if we are not doing any validity checking
3726
3727       if not Validity_Checks_On then
3728          return;
3729
3730       --  Ignore call if range or validity checks suppressed on entity or type
3731
3732       elsif Range_Or_Validity_Checks_Suppressed (Expr) then
3733          return;
3734
3735       --  No check required if expression is from the expander, we assume the
3736       --  expander will generate whatever checks are needed. Note that this is
3737       --  not just an optimization, it avoids infinite recursions!
3738
3739       --  Unchecked conversions must be checked, unless they are initialized
3740       --  scalar values, as in a component assignment in an init proc.
3741
3742       --  In addition, we force a check if Force_Validity_Checks is set
3743
3744       elsif not Comes_From_Source (Expr)
3745         and then not Force_Validity_Checks
3746         and then (Nkind (Expr) /= N_Unchecked_Type_Conversion
3747                     or else Kill_Range_Check (Expr))
3748       then
3749          return;
3750
3751       --  No check required if expression is known to have valid value
3752
3753       elsif Expr_Known_Valid (Expr) then
3754          return;
3755
3756       --  Ignore case of enumeration with holes where the flag is set not to
3757       --  worry about holes, since no special validity check is needed
3758
3759       elsif Is_Enumeration_Type (Typ)
3760         and then Has_Non_Standard_Rep (Typ)
3761         and then Holes_OK
3762       then
3763          return;
3764
3765       --  No check required on the left-hand side of an assignment
3766
3767       elsif Nkind (Parent (Expr)) = N_Assignment_Statement
3768         and then Expr = Name (Parent (Expr))
3769       then
3770          return;
3771
3772       --  No check on a univeral real constant. The context will eventually
3773       --  convert it to a machine number for some target type, or report an
3774       --  illegality.
3775
3776       elsif Nkind (Expr) = N_Real_Literal
3777         and then Etype (Expr) = Universal_Real
3778       then
3779          return;
3780
3781       --  If the expression denotes a component of a packed boolean arrray,
3782       --  no possible check applies. We ignore the old ACATS chestnuts that
3783       --  involve Boolean range True..True.
3784
3785       --  Note: validity checks are generated for expressions that yield a
3786       --  scalar type, when it is possible to create a value that is outside of
3787       --  the type. If this is a one-bit boolean no such value exists. This is
3788       --  an optimization, and it also prevents compiler blowing up during the
3789       --  elaboration of improperly expanded packed array references.
3790
3791       elsif Nkind (Expr) = N_Indexed_Component
3792         and then Is_Bit_Packed_Array (Etype (Prefix (Expr)))
3793         and then Root_Type (Etype (Expr)) = Standard_Boolean
3794       then
3795          return;
3796
3797       --  An annoying special case. If this is an out parameter of a scalar
3798       --  type, then the value is not going to be accessed, therefore it is
3799       --  inappropriate to do any validity check at the call site.
3800
3801       else
3802          --  Only need to worry about scalar types
3803
3804          if Is_Scalar_Type (Typ) then
3805             declare
3806                P : Node_Id;
3807                N : Node_Id;
3808                E : Entity_Id;
3809                F : Entity_Id;
3810                A : Node_Id;
3811                L : List_Id;
3812
3813             begin
3814                --  Find actual argument (which may be a parameter association)
3815                --  and the parent of the actual argument (the call statement)
3816
3817                N := Expr;
3818                P := Parent (Expr);
3819
3820                if Nkind (P) = N_Parameter_Association then
3821                   N := P;
3822                   P := Parent (N);
3823                end if;
3824
3825                --  Only need to worry if we are argument of a procedure call
3826                --  since functions don't have out parameters. If this is an
3827                --  indirect or dispatching call, get signature from the
3828                --  subprogram type.
3829
3830                if Nkind (P) = N_Procedure_Call_Statement then
3831                   L := Parameter_Associations (P);
3832
3833                   if Is_Entity_Name (Name (P)) then
3834                      E := Entity (Name (P));
3835                   else
3836                      pragma Assert (Nkind (Name (P)) = N_Explicit_Dereference);
3837                      E := Etype (Name (P));
3838                   end if;
3839
3840                   --  Only need to worry if there are indeed actuals, and if
3841                   --  this could be a procedure call, otherwise we cannot get a
3842                   --  match (either we are not an argument, or the mode of the
3843                   --  formal is not OUT). This test also filters out the
3844                   --  generic case.
3845
3846                   if Is_Non_Empty_List (L)
3847                     and then Is_Subprogram (E)
3848                   then
3849                      --  This is the loop through parameters, looking for an
3850                      --  OUT parameter for which we are the argument.
3851
3852                      F := First_Formal (E);
3853                      A := First (L);
3854                      while Present (F) loop
3855                         if Ekind (F) = E_Out_Parameter and then A = N then
3856                            return;
3857                         end if;
3858
3859                         Next_Formal (F);
3860                         Next (A);
3861                      end loop;
3862                   end if;
3863                end if;
3864             end;
3865          end if;
3866       end if;
3867
3868       --  If we fall through, a validity check is required
3869
3870       Insert_Valid_Check (Expr);
3871    end Ensure_Valid;
3872
3873    ----------------------
3874    -- Expr_Known_Valid --
3875    ----------------------
3876
3877    function Expr_Known_Valid (Expr : Node_Id) return Boolean is
3878       Typ : constant Entity_Id := Etype (Expr);
3879
3880    begin
3881       --  Non-scalar types are always considered valid, since they never give
3882       --  rise to the issues of erroneous or bounded error behavior that are
3883       --  the concern. In formal reference manual terms the notion of validity
3884       --  only applies to scalar types. Note that even when packed arrays are
3885       --  represented using modular types, they are still arrays semantically,
3886       --  so they are also always valid (in particular, the unused bits can be
3887       --  random rubbish without affecting the validity of the array value).
3888
3889       if not Is_Scalar_Type (Typ) or else Is_Packed_Array_Type (Typ) then
3890          return True;
3891
3892       --  If no validity checking, then everything is considered valid
3893
3894       elsif not Validity_Checks_On then
3895          return True;
3896
3897       --  Floating-point types are considered valid unless floating-point
3898       --  validity checks have been specifically turned on.
3899
3900       elsif Is_Floating_Point_Type (Typ)
3901         and then not Validity_Check_Floating_Point
3902       then
3903          return True;
3904
3905       --  If the expression is the value of an object that is known to be
3906       --  valid, then clearly the expression value itself is valid.
3907
3908       elsif Is_Entity_Name (Expr)
3909         and then Is_Known_Valid (Entity (Expr))
3910       then
3911          return True;
3912
3913       --  References to discriminants are always considered valid. The value
3914       --  of a discriminant gets checked when the object is built. Within the
3915       --  record, we consider it valid, and it is important to do so, since
3916       --  otherwise we can try to generate bogus validity checks which
3917       --  reference discriminants out of scope. Discriminants of concurrent
3918       --  types are excluded for the same reason.
3919
3920       elsif Is_Entity_Name (Expr)
3921         and then Denotes_Discriminant (Expr, Check_Concurrent => True)
3922       then
3923          return True;
3924
3925       --  If the type is one for which all values are known valid, then we are
3926       --  sure that the value is valid except in the slightly odd case where
3927       --  the expression is a reference to a variable whose size has been
3928       --  explicitly set to a value greater than the object size.
3929
3930       elsif Is_Known_Valid (Typ) then
3931          if Is_Entity_Name (Expr)
3932            and then Ekind (Entity (Expr)) = E_Variable
3933            and then Esize (Entity (Expr)) > Esize (Typ)
3934          then
3935             return False;
3936          else
3937             return True;
3938          end if;
3939
3940       --  Integer and character literals always have valid values, where
3941       --  appropriate these will be range checked in any case.
3942
3943       elsif Nkind (Expr) = N_Integer_Literal
3944               or else
3945             Nkind (Expr) = N_Character_Literal
3946       then
3947          return True;
3948
3949       --  If we have a type conversion or a qualification of a known valid
3950       --  value, then the result will always be valid.
3951
3952       elsif Nkind (Expr) = N_Type_Conversion
3953               or else
3954             Nkind (Expr) = N_Qualified_Expression
3955       then
3956          return Expr_Known_Valid (Expression (Expr));
3957
3958       --  The result of any operator is always considered valid, since we
3959       --  assume the necessary checks are done by the operator. For operators
3960       --  on floating-point operations, we must also check when the operation
3961       --  is the right-hand side of an assignment, or is an actual in a call.
3962
3963       elsif Nkind (Expr) in N_Op then
3964          if Is_Floating_Point_Type (Typ)
3965             and then Validity_Check_Floating_Point
3966             and then
3967               (Nkind (Parent (Expr)) = N_Assignment_Statement
3968                 or else Nkind (Parent (Expr)) = N_Function_Call
3969                 or else Nkind (Parent (Expr)) = N_Parameter_Association)
3970          then
3971             return False;
3972          else
3973             return True;
3974          end if;
3975
3976       --  The result of a membership test is always valid, since it is true or
3977       --  false, there are no other possibilities.
3978
3979       elsif Nkind (Expr) in N_Membership_Test then
3980          return True;
3981
3982       --  For all other cases, we do not know the expression is valid
3983
3984       else
3985          return False;
3986       end if;
3987    end Expr_Known_Valid;
3988
3989    ----------------
3990    -- Find_Check --
3991    ----------------
3992
3993    procedure Find_Check
3994      (Expr        : Node_Id;
3995       Check_Type  : Character;
3996       Target_Type : Entity_Id;
3997       Entry_OK    : out Boolean;
3998       Check_Num   : out Nat;
3999       Ent         : out Entity_Id;
4000       Ofs         : out Uint)
4001    is
4002       function Within_Range_Of
4003         (Target_Type : Entity_Id;
4004          Check_Type  : Entity_Id) return Boolean;
4005       --  Given a requirement for checking a range against Target_Type, and
4006       --  and a range Check_Type against which a check has already been made,
4007       --  determines if the check against check type is sufficient to ensure
4008       --  that no check against Target_Type is required.
4009
4010       ---------------------
4011       -- Within_Range_Of --
4012       ---------------------
4013
4014       function Within_Range_Of
4015         (Target_Type : Entity_Id;
4016          Check_Type  : Entity_Id) return Boolean
4017       is
4018       begin
4019          if Target_Type = Check_Type then
4020             return True;
4021
4022          else
4023             declare
4024                Tlo : constant Node_Id := Type_Low_Bound  (Target_Type);
4025                Thi : constant Node_Id := Type_High_Bound (Target_Type);
4026                Clo : constant Node_Id := Type_Low_Bound  (Check_Type);
4027                Chi : constant Node_Id := Type_High_Bound (Check_Type);
4028
4029             begin
4030                if (Tlo = Clo
4031                      or else (Compile_Time_Known_Value (Tlo)
4032                                 and then
4033                               Compile_Time_Known_Value (Clo)
4034                                 and then
4035                               Expr_Value (Clo) >= Expr_Value (Tlo)))
4036                  and then
4037                   (Thi = Chi
4038                      or else (Compile_Time_Known_Value (Thi)
4039                                 and then
4040                               Compile_Time_Known_Value (Chi)
4041                                 and then
4042                               Expr_Value (Chi) <= Expr_Value (Clo)))
4043                then
4044                   return True;
4045                else
4046                   return False;
4047                end if;
4048             end;
4049          end if;
4050       end Within_Range_Of;
4051
4052    --  Start of processing for Find_Check
4053
4054    begin
4055       --  Establish default, to avoid warnings from GCC
4056
4057       Check_Num := 0;
4058
4059       --  Case of expression is simple entity reference
4060
4061       if Is_Entity_Name (Expr) then
4062          Ent := Entity (Expr);
4063          Ofs := Uint_0;
4064
4065       --  Case of expression is entity + known constant
4066
4067       elsif Nkind (Expr) = N_Op_Add
4068         and then Compile_Time_Known_Value (Right_Opnd (Expr))
4069         and then Is_Entity_Name (Left_Opnd (Expr))
4070       then
4071          Ent := Entity (Left_Opnd (Expr));
4072          Ofs := Expr_Value (Right_Opnd (Expr));
4073
4074       --  Case of expression is entity - known constant
4075
4076       elsif Nkind (Expr) = N_Op_Subtract
4077         and then Compile_Time_Known_Value (Right_Opnd (Expr))
4078         and then Is_Entity_Name (Left_Opnd (Expr))
4079       then
4080          Ent := Entity (Left_Opnd (Expr));
4081          Ofs := UI_Negate (Expr_Value (Right_Opnd (Expr)));
4082
4083       --  Any other expression is not of the right form
4084
4085       else
4086          Ent := Empty;
4087          Ofs := Uint_0;
4088          Entry_OK := False;
4089          return;
4090       end if;
4091
4092       --  Come here with expression of appropriate form, check if entity is an
4093       --  appropriate one for our purposes.
4094
4095       if (Ekind (Ent) = E_Variable
4096             or else
4097           Ekind (Ent) = E_Constant
4098             or else
4099           Ekind (Ent) = E_Loop_Parameter
4100             or else
4101           Ekind (Ent) = E_In_Parameter)
4102         and then not Is_Library_Level_Entity (Ent)
4103       then
4104          Entry_OK := True;
4105       else
4106          Entry_OK := False;
4107          return;
4108       end if;
4109
4110       --  See if there is matching check already
4111
4112       for J in reverse 1 .. Num_Saved_Checks loop
4113          declare
4114             SC : Saved_Check renames Saved_Checks (J);
4115
4116          begin
4117             if SC.Killed = False
4118               and then SC.Entity = Ent
4119               and then SC.Offset = Ofs
4120               and then SC.Check_Type = Check_Type
4121               and then Within_Range_Of (Target_Type, SC.Target_Type)
4122             then
4123                Check_Num := J;
4124                return;
4125             end if;
4126          end;
4127       end loop;
4128
4129       --  If we fall through entry was not found
4130
4131       Check_Num := 0;
4132       return;
4133    end Find_Check;
4134
4135    ---------------------------------
4136    -- Generate_Discriminant_Check --
4137    ---------------------------------
4138
4139    --  Note: the code for this procedure is derived from the
4140    --  Emit_Discriminant_Check Routine in trans.c.
4141
4142    procedure Generate_Discriminant_Check (N : Node_Id) is
4143       Loc  : constant Source_Ptr := Sloc (N);
4144       Pref : constant Node_Id    := Prefix (N);
4145       Sel  : constant Node_Id    := Selector_Name (N);
4146
4147       Orig_Comp : constant Entity_Id :=
4148                     Original_Record_Component (Entity (Sel));
4149       --  The original component to be checked
4150
4151       Discr_Fct : constant Entity_Id :=
4152                     Discriminant_Checking_Func (Orig_Comp);
4153       --  The discriminant checking function
4154
4155       Discr : Entity_Id;
4156       --  One discriminant to be checked in the type
4157
4158       Real_Discr : Entity_Id;
4159       --  Actual discriminant in the call
4160
4161       Pref_Type : Entity_Id;
4162       --  Type of relevant prefix (ignoring private/access stuff)
4163
4164       Args : List_Id;
4165       --  List of arguments for function call
4166
4167       Formal : Entity_Id;
4168       --  Keep track of the formal corresponding to the actual we build for
4169       --  each discriminant, in order to be able to perform the necessary type
4170       --  conversions.
4171
4172       Scomp : Node_Id;
4173       --  Selected component reference for checking function argument
4174
4175    begin
4176       Pref_Type := Etype (Pref);
4177
4178       --  Force evaluation of the prefix, so that it does not get evaluated
4179       --  twice (once for the check, once for the actual reference). Such a
4180       --  double evaluation is always a potential source of inefficiency,
4181       --  and is functionally incorrect in the volatile case, or when the
4182       --  prefix may have side-effects. An entity or a component of an
4183       --  entity requires no evaluation.
4184
4185       if Is_Entity_Name (Pref) then
4186          if Treat_As_Volatile (Entity (Pref)) then
4187             Force_Evaluation (Pref, Name_Req => True);
4188          end if;
4189
4190       elsif Treat_As_Volatile (Etype (Pref)) then
4191             Force_Evaluation (Pref, Name_Req => True);
4192
4193       elsif Nkind (Pref) = N_Selected_Component
4194         and then Is_Entity_Name (Prefix (Pref))
4195       then
4196          null;
4197
4198       else
4199          Force_Evaluation (Pref, Name_Req => True);
4200       end if;
4201
4202       --  For a tagged type, use the scope of the original component to
4203       --  obtain the type, because ???
4204
4205       if Is_Tagged_Type (Scope (Orig_Comp)) then
4206          Pref_Type := Scope (Orig_Comp);
4207
4208       --  For an untagged derived type, use the discriminants of the parent
4209       --  which have been renamed in the derivation, possibly by a one-to-many
4210       --  discriminant constraint. For non-tagged type, initially get the Etype
4211       --  of the prefix
4212
4213       else
4214          if Is_Derived_Type (Pref_Type)
4215            and then Number_Discriminants (Pref_Type) /=
4216                     Number_Discriminants (Etype (Base_Type (Pref_Type)))
4217          then
4218             Pref_Type := Etype (Base_Type (Pref_Type));
4219          end if;
4220       end if;
4221
4222       --  We definitely should have a checking function, This routine should
4223       --  not be called if no discriminant checking function is present.
4224
4225       pragma Assert (Present (Discr_Fct));
4226
4227       --  Create the list of the actual parameters for the call. This list
4228       --  is the list of the discriminant fields of the record expression to
4229       --  be discriminant checked.
4230
4231       Args   := New_List;
4232       Formal := First_Formal (Discr_Fct);
4233       Discr  := First_Discriminant (Pref_Type);
4234       while Present (Discr) loop
4235
4236          --  If we have a corresponding discriminant field, and a parent
4237          --  subtype is present, then we want to use the corresponding
4238          --  discriminant since this is the one with the useful value.
4239
4240          if Present (Corresponding_Discriminant (Discr))
4241            and then Ekind (Pref_Type) = E_Record_Type
4242            and then Present (Parent_Subtype (Pref_Type))
4243          then
4244             Real_Discr := Corresponding_Discriminant (Discr);
4245          else
4246             Real_Discr := Discr;
4247          end if;
4248
4249          --  Construct the reference to the discriminant
4250
4251          Scomp :=
4252            Make_Selected_Component (Loc,
4253              Prefix =>
4254                Unchecked_Convert_To (Pref_Type,
4255                  Duplicate_Subexpr (Pref)),
4256              Selector_Name => New_Occurrence_Of (Real_Discr, Loc));
4257
4258          --  Manually analyze and resolve this selected component. We really
4259          --  want it just as it appears above, and do not want the expander
4260          --  playing discriminal games etc with this reference. Then we append
4261          --  the argument to the list we are gathering.
4262
4263          Set_Etype (Scomp, Etype (Real_Discr));
4264          Set_Analyzed (Scomp, True);
4265          Append_To (Args, Convert_To (Etype (Formal), Scomp));
4266
4267          Next_Formal_With_Extras (Formal);
4268          Next_Discriminant (Discr);
4269       end loop;
4270
4271       --  Now build and insert the call
4272
4273       Insert_Action (N,
4274         Make_Raise_Constraint_Error (Loc,
4275           Condition =>
4276             Make_Function_Call (Loc,
4277               Name => New_Occurrence_Of (Discr_Fct, Loc),
4278               Parameter_Associations => Args),
4279           Reason => CE_Discriminant_Check_Failed));
4280    end Generate_Discriminant_Check;
4281
4282    ---------------------------
4283    -- Generate_Index_Checks --
4284    ---------------------------
4285
4286    procedure Generate_Index_Checks (N : Node_Id) is
4287       Loc : constant Source_Ptr := Sloc (N);
4288       A   : constant Node_Id    := Prefix (N);
4289       Sub : Node_Id;
4290       Ind : Nat;
4291       Num : List_Id;
4292
4293    begin
4294       --  Ignore call if index checks suppressed for array object or type
4295
4296       if (Is_Entity_Name (A) and then Index_Checks_Suppressed (Entity (A)))
4297         or else Index_Checks_Suppressed (Etype (A))
4298       then
4299          return;
4300       end if;
4301
4302       --  Generate the checks
4303
4304       Sub := First (Expressions (N));
4305       Ind := 1;
4306       while Present (Sub) loop
4307          if Do_Range_Check (Sub) then
4308             Set_Do_Range_Check (Sub, False);
4309
4310             --  Force evaluation except for the case of a simple name of a
4311             --  non-volatile entity.
4312
4313             if not Is_Entity_Name (Sub)
4314               or else Treat_As_Volatile (Entity (Sub))
4315             then
4316                Force_Evaluation (Sub);
4317             end if;
4318
4319             --  Generate a raise of constraint error with the appropriate
4320             --  reason and a condition of the form:
4321
4322             --    Base_Type(Sub) not in array'range (subscript)
4323
4324             --  Note that the reason we generate the conversion to the base
4325             --  type here is that we definitely want the range check to take
4326             --  place, even if it looks like the subtype is OK. Optimization
4327             --  considerations that allow us to omit the check have already
4328             --  been taken into account in the setting of the Do_Range_Check
4329             --  flag earlier on.
4330
4331             if Ind = 1 then
4332                Num := No_List;
4333             else
4334                Num :=  New_List (Make_Integer_Literal (Loc, Ind));
4335             end if;
4336
4337             Insert_Action (N,
4338               Make_Raise_Constraint_Error (Loc,
4339                 Condition =>
4340                   Make_Not_In (Loc,
4341                     Left_Opnd  =>
4342                       Convert_To (Base_Type (Etype (Sub)),
4343                         Duplicate_Subexpr_Move_Checks (Sub)),
4344                     Right_Opnd =>
4345                       Make_Attribute_Reference (Loc,
4346                         Prefix         => Duplicate_Subexpr_Move_Checks (A),
4347                         Attribute_Name => Name_Range,
4348                         Expressions    => Num)),
4349                 Reason => CE_Index_Check_Failed));
4350          end if;
4351
4352          Ind := Ind + 1;
4353          Next (Sub);
4354       end loop;
4355    end Generate_Index_Checks;
4356
4357    --------------------------
4358    -- Generate_Range_Check --
4359    --------------------------
4360
4361    procedure Generate_Range_Check
4362      (N           : Node_Id;
4363       Target_Type : Entity_Id;
4364       Reason      : RT_Exception_Code)
4365    is
4366       Loc              : constant Source_Ptr := Sloc (N);
4367       Source_Type      : constant Entity_Id  := Etype (N);
4368       Source_Base_Type : constant Entity_Id  := Base_Type (Source_Type);
4369       Target_Base_Type : constant Entity_Id  := Base_Type (Target_Type);
4370
4371    begin
4372       --  First special case, if the source type is already within the range
4373       --  of the target type, then no check is needed (probably we should have
4374       --  stopped Do_Range_Check from being set in the first place, but better
4375       --  late than later in preventing junk code!
4376
4377       --  We do NOT apply this if the source node is a literal, since in this
4378       --  case the literal has already been labeled as having the subtype of
4379       --  the target.
4380
4381       if In_Subrange_Of (Source_Type, Target_Type)
4382         and then not
4383           (Nkind (N) = N_Integer_Literal
4384              or else
4385            Nkind (N) = N_Real_Literal
4386              or else
4387            Nkind (N) = N_Character_Literal
4388              or else
4389            (Is_Entity_Name (N)
4390               and then Ekind (Entity (N)) = E_Enumeration_Literal))
4391       then
4392          return;
4393       end if;
4394
4395       --  We need a check, so force evaluation of the node, so that it does
4396       --  not get evaluated twice (once for the check, once for the actual
4397       --  reference). Such a double evaluation is always a potential source
4398       --  of inefficiency, and is functionally incorrect in the volatile case.
4399
4400       if not Is_Entity_Name (N)
4401         or else Treat_As_Volatile (Entity (N))
4402       then
4403          Force_Evaluation (N);
4404       end if;
4405
4406       --  The easiest case is when Source_Base_Type and Target_Base_Type are
4407       --  the same since in this case we can simply do a direct check of the
4408       --  value of N against the bounds of Target_Type.
4409
4410       --    [constraint_error when N not in Target_Type]
4411
4412       --  Note: this is by far the most common case, for example all cases of
4413       --  checks on the RHS of assignments are in this category, but not all
4414       --  cases are like this. Notably conversions can involve two types.
4415
4416       if Source_Base_Type = Target_Base_Type then
4417          Insert_Action (N,
4418            Make_Raise_Constraint_Error (Loc,
4419              Condition =>
4420                Make_Not_In (Loc,
4421                  Left_Opnd  => Duplicate_Subexpr (N),
4422                  Right_Opnd => New_Occurrence_Of (Target_Type, Loc)),
4423              Reason => Reason));
4424
4425       --  Next test for the case where the target type is within the bounds
4426       --  of the base type of the source type, since in this case we can
4427       --  simply convert these bounds to the base type of T to do the test.
4428
4429       --    [constraint_error when N not in
4430       --       Source_Base_Type (Target_Type'First)
4431       --         ..
4432       --       Source_Base_Type(Target_Type'Last))]
4433
4434       --  The conversions will always work and need no check
4435
4436       elsif In_Subrange_Of (Target_Type, Source_Base_Type) then
4437          Insert_Action (N,
4438            Make_Raise_Constraint_Error (Loc,
4439              Condition =>
4440                Make_Not_In (Loc,
4441                  Left_Opnd  => Duplicate_Subexpr (N),
4442
4443                  Right_Opnd =>
4444                    Make_Range (Loc,
4445                      Low_Bound =>
4446                        Convert_To (Source_Base_Type,
4447                          Make_Attribute_Reference (Loc,
4448                            Prefix =>
4449                              New_Occurrence_Of (Target_Type, Loc),
4450                            Attribute_Name => Name_First)),
4451
4452                      High_Bound =>
4453                        Convert_To (Source_Base_Type,
4454                          Make_Attribute_Reference (Loc,
4455                            Prefix =>
4456                              New_Occurrence_Of (Target_Type, Loc),
4457                            Attribute_Name => Name_Last)))),
4458              Reason => Reason));
4459
4460       --  Note that at this stage we now that the Target_Base_Type is not in
4461       --  the range of the Source_Base_Type (since even the Target_Type itself
4462       --  is not in this range). It could still be the case that Source_Type is
4463       --  in range of the target base type since we have not checked that case.
4464
4465       --  If that is the case, we can freely convert the source to the target,
4466       --  and then test the target result against the bounds.
4467
4468       elsif In_Subrange_Of (Source_Type, Target_Base_Type) then
4469
4470          --  We make a temporary to hold the value of the converted value
4471          --  (converted to the base type), and then we will do the test against
4472          --  this temporary.
4473
4474          --     Tnn : constant Target_Base_Type := Target_Base_Type (N);
4475          --     [constraint_error when Tnn not in Target_Type]
4476
4477          --  Then the conversion itself is replaced by an occurrence of Tnn
4478
4479          declare
4480             Tnn : constant Entity_Id :=
4481                     Make_Defining_Identifier (Loc,
4482                       Chars => New_Internal_Name ('T'));
4483
4484          begin
4485             Insert_Actions (N, New_List (
4486               Make_Object_Declaration (Loc,
4487                 Defining_Identifier => Tnn,
4488                 Object_Definition   =>
4489                   New_Occurrence_Of (Target_Base_Type, Loc),
4490                 Constant_Present    => True,
4491                 Expression          =>
4492                   Make_Type_Conversion (Loc,
4493                     Subtype_Mark => New_Occurrence_Of (Target_Base_Type, Loc),
4494                     Expression   => Duplicate_Subexpr (N))),
4495
4496               Make_Raise_Constraint_Error (Loc,
4497                 Condition =>
4498                   Make_Not_In (Loc,
4499                     Left_Opnd  => New_Occurrence_Of (Tnn, Loc),
4500                     Right_Opnd => New_Occurrence_Of (Target_Type, Loc)),
4501
4502                 Reason => Reason)));
4503
4504             Rewrite (N, New_Occurrence_Of (Tnn, Loc));
4505
4506             --  Set the type of N, because the declaration for Tnn might not
4507             --  be analyzed yet, as is the case if N appears within a record
4508             --  declaration, as a discriminant constraint or expression.
4509
4510             Set_Etype (N, Target_Base_Type);
4511          end;
4512
4513       --  At this stage, we know that we have two scalar types, which are
4514       --  directly convertible, and where neither scalar type has a base
4515       --  range that is in the range of the other scalar type.
4516
4517       --  The only way this can happen is with a signed and unsigned type.
4518       --  So test for these two cases:
4519
4520       else
4521          --  Case of the source is unsigned and the target is signed
4522
4523          if Is_Unsigned_Type (Source_Base_Type)
4524            and then not Is_Unsigned_Type (Target_Base_Type)
4525          then
4526             --  If the source is unsigned and the target is signed, then we
4527             --  know that the source is not shorter than the target (otherwise
4528             --  the source base type would be in the target base type range).
4529
4530             --  In other words, the unsigned type is either the same size as
4531             --  the target, or it is larger. It cannot be smaller.
4532
4533             pragma Assert
4534               (Esize (Source_Base_Type) >= Esize (Target_Base_Type));
4535
4536             --  We only need to check the low bound if the low bound of the
4537             --  target type is non-negative. If the low bound of the target
4538             --  type is negative, then we know that we will fit fine.
4539
4540             --  If the high bound of the target type is negative, then we
4541             --  know we have a constraint error, since we can't possibly
4542             --  have a negative source.
4543
4544             --  With these two checks out of the way, we can do the check
4545             --  using the source type safely
4546
4547             --  This is definitely the most annoying case!
4548
4549             --    [constraint_error
4550             --       when (Target_Type'First >= 0
4551             --               and then
4552             --                 N < Source_Base_Type (Target_Type'First))
4553             --         or else Target_Type'Last < 0
4554             --         or else N > Source_Base_Type (Target_Type'Last)];
4555
4556             --  We turn off all checks since we know that the conversions
4557             --  will work fine, given the guards for negative values.
4558
4559             Insert_Action (N,
4560               Make_Raise_Constraint_Error (Loc,
4561                 Condition =>
4562                   Make_Or_Else (Loc,
4563                     Make_Or_Else (Loc,
4564                       Left_Opnd =>
4565                         Make_And_Then (Loc,
4566                           Left_Opnd => Make_Op_Ge (Loc,
4567                             Left_Opnd =>
4568                               Make_Attribute_Reference (Loc,
4569                                 Prefix =>
4570                                   New_Occurrence_Of (Target_Type, Loc),
4571                                 Attribute_Name => Name_First),
4572                             Right_Opnd => Make_Integer_Literal (Loc, Uint_0)),
4573
4574                           Right_Opnd =>
4575                             Make_Op_Lt (Loc,
4576                               Left_Opnd => Duplicate_Subexpr (N),
4577                               Right_Opnd =>
4578                                 Convert_To (Source_Base_Type,
4579                                   Make_Attribute_Reference (Loc,
4580                                     Prefix =>
4581                                       New_Occurrence_Of (Target_Type, Loc),
4582                                     Attribute_Name => Name_First)))),
4583
4584                       Right_Opnd =>
4585                         Make_Op_Lt (Loc,
4586                           Left_Opnd =>
4587                             Make_Attribute_Reference (Loc,
4588                               Prefix => New_Occurrence_Of (Target_Type, Loc),
4589                               Attribute_Name => Name_Last),
4590                             Right_Opnd => Make_Integer_Literal (Loc, Uint_0))),
4591
4592                     Right_Opnd =>
4593                       Make_Op_Gt (Loc,
4594                         Left_Opnd => Duplicate_Subexpr (N),
4595                         Right_Opnd =>
4596                           Convert_To (Source_Base_Type,
4597                             Make_Attribute_Reference (Loc,
4598                               Prefix => New_Occurrence_Of (Target_Type, Loc),
4599                               Attribute_Name => Name_Last)))),
4600
4601                 Reason => Reason),
4602               Suppress  => All_Checks);
4603
4604          --  Only remaining possibility is that the source is signed and
4605          --  the target is unsigned
4606
4607          else
4608             pragma Assert (not Is_Unsigned_Type (Source_Base_Type)
4609                              and then Is_Unsigned_Type (Target_Base_Type));
4610
4611             --  If the source is signed and the target is unsigned, then we
4612             --  know that the target is not shorter than the source (otherwise
4613             --  the target base type would be in the source base type range).
4614
4615             --  In other words, the unsigned type is either the same size as
4616             --  the target, or it is larger. It cannot be smaller.
4617
4618             --  Clearly we have an error if the source value is negative since
4619             --  no unsigned type can have negative values. If the source type
4620             --  is non-negative, then the check can be done using the target
4621             --  type.
4622
4623             --    Tnn : constant Target_Base_Type (N) := Target_Type;
4624
4625             --    [constraint_error
4626             --       when N < 0 or else Tnn not in Target_Type];
4627
4628             --  We turn off all checks for the conversion of N to the target
4629             --  base type, since we generate the explicit check to ensure that
4630             --  the value is non-negative
4631
4632             declare
4633                Tnn : constant Entity_Id :=
4634                        Make_Defining_Identifier (Loc,
4635                          Chars => New_Internal_Name ('T'));
4636
4637             begin
4638                Insert_Actions (N, New_List (
4639                  Make_Object_Declaration (Loc,
4640                    Defining_Identifier => Tnn,
4641                    Object_Definition   =>
4642                      New_Occurrence_Of (Target_Base_Type, Loc),
4643                    Constant_Present    => True,
4644                    Expression          =>
4645                      Make_Type_Conversion (Loc,
4646                        Subtype_Mark =>
4647                          New_Occurrence_Of (Target_Base_Type, Loc),
4648                        Expression   => Duplicate_Subexpr (N))),
4649
4650                  Make_Raise_Constraint_Error (Loc,
4651                    Condition =>
4652                      Make_Or_Else (Loc,
4653                        Left_Opnd =>
4654                          Make_Op_Lt (Loc,
4655                            Left_Opnd  => Duplicate_Subexpr (N),
4656                            Right_Opnd => Make_Integer_Literal (Loc, Uint_0)),
4657
4658                        Right_Opnd =>
4659                          Make_Not_In (Loc,
4660                            Left_Opnd  => New_Occurrence_Of (Tnn, Loc),
4661                            Right_Opnd =>
4662                              New_Occurrence_Of (Target_Type, Loc))),
4663
4664                    Reason => Reason)),
4665                  Suppress => All_Checks);
4666
4667                --  Set the Etype explicitly, because Insert_Actions may have
4668                --  placed the declaration in the freeze list for an enclosing
4669                --  construct, and thus it is not analyzed yet.
4670
4671                Set_Etype (Tnn, Target_Base_Type);
4672                Rewrite (N, New_Occurrence_Of (Tnn, Loc));
4673             end;
4674          end if;
4675       end if;
4676    end Generate_Range_Check;
4677
4678    ------------------
4679    -- Get_Check_Id --
4680    ------------------
4681
4682    function Get_Check_Id (N : Name_Id) return Check_Id is
4683    begin
4684       --  For standard check name, we can do a direct computation
4685
4686       if N in First_Check_Name .. Last_Check_Name then
4687          return Check_Id (N - (First_Check_Name - 1));
4688
4689       --  For non-standard names added by pragma Check_Name, search table
4690
4691       else
4692          for J in All_Checks + 1 .. Check_Names.Last loop
4693             if Check_Names.Table (J) = N then
4694                return J;
4695             end if;
4696          end loop;
4697       end if;
4698
4699       --  No matching name found
4700
4701       return No_Check_Id;
4702    end Get_Check_Id;
4703
4704    ---------------------
4705    -- Get_Discriminal --
4706    ---------------------
4707
4708    function Get_Discriminal (E : Entity_Id; Bound : Node_Id) return Node_Id is
4709       Loc : constant Source_Ptr := Sloc (E);
4710       D   : Entity_Id;
4711       Sc  : Entity_Id;
4712
4713    begin
4714       --  The bound can be a bona fide parameter of a protected operation,
4715       --  rather than a prival encoded as an in-parameter.
4716
4717       if No (Discriminal_Link (Entity (Bound))) then
4718          return Bound;
4719       end if;
4720
4721       --  Climb the scope stack looking for an enclosing protected type. If
4722       --  we run out of scopes, return the bound itself.
4723
4724       Sc := Scope (E);
4725       while Present (Sc) loop
4726          if Sc = Standard_Standard then
4727             return Bound;
4728
4729          elsif Ekind (Sc) = E_Protected_Type then
4730             exit;
4731          end if;
4732
4733          Sc := Scope (Sc);
4734       end loop;
4735
4736       D := First_Discriminant (Sc);
4737       while Present (D) loop
4738          if Chars (D) = Chars (Bound) then
4739             return New_Occurrence_Of (Discriminal (D), Loc);
4740          end if;
4741
4742          Next_Discriminant (D);
4743       end loop;
4744
4745       return Bound;
4746    end Get_Discriminal;
4747
4748    ----------------------
4749    -- Get_Range_Checks --
4750    ----------------------
4751
4752    function Get_Range_Checks
4753      (Ck_Node    : Node_Id;
4754       Target_Typ : Entity_Id;
4755       Source_Typ : Entity_Id := Empty;
4756       Warn_Node  : Node_Id   := Empty) return Check_Result
4757    is
4758    begin
4759       return Selected_Range_Checks
4760         (Ck_Node, Target_Typ, Source_Typ, Warn_Node);
4761    end Get_Range_Checks;
4762
4763    ------------------
4764    -- Guard_Access --
4765    ------------------
4766
4767    function Guard_Access
4768      (Cond    : Node_Id;
4769       Loc     : Source_Ptr;
4770       Ck_Node : Node_Id) return Node_Id
4771    is
4772    begin
4773       if Nkind (Cond) = N_Or_Else then
4774          Set_Paren_Count (Cond, 1);
4775       end if;
4776
4777       if Nkind (Ck_Node) = N_Allocator then
4778          return Cond;
4779       else
4780          return
4781            Make_And_Then (Loc,
4782              Left_Opnd =>
4783                Make_Op_Ne (Loc,
4784                  Left_Opnd  => Duplicate_Subexpr_No_Checks (Ck_Node),
4785                  Right_Opnd => Make_Null (Loc)),
4786              Right_Opnd => Cond);
4787       end if;
4788    end Guard_Access;
4789
4790    -----------------------------
4791    -- Index_Checks_Suppressed --
4792    -----------------------------
4793
4794    function Index_Checks_Suppressed (E : Entity_Id) return Boolean is
4795    begin
4796       if Present (E) and then Checks_May_Be_Suppressed (E) then
4797          return Is_Check_Suppressed (E, Index_Check);
4798       else
4799          return Scope_Suppress (Index_Check);
4800       end if;
4801    end Index_Checks_Suppressed;
4802
4803    ----------------
4804    -- Initialize --
4805    ----------------
4806
4807    procedure Initialize is
4808    begin
4809       for J in Determine_Range_Cache_N'Range loop
4810          Determine_Range_Cache_N (J) := Empty;
4811       end loop;
4812
4813       Check_Names.Init;
4814
4815       for J in Int range 1 .. All_Checks loop
4816          Check_Names.Append (Name_Id (Int (First_Check_Name) + J - 1));
4817       end loop;
4818    end Initialize;
4819
4820    -------------------------
4821    -- Insert_Range_Checks --
4822    -------------------------
4823
4824    procedure Insert_Range_Checks
4825      (Checks       : Check_Result;
4826       Node         : Node_Id;
4827       Suppress_Typ : Entity_Id;
4828       Static_Sloc  : Source_Ptr := No_Location;
4829       Flag_Node    : Node_Id    := Empty;
4830       Do_Before    : Boolean    := False)
4831    is
4832       Internal_Flag_Node   : Node_Id    := Flag_Node;
4833       Internal_Static_Sloc : Source_Ptr := Static_Sloc;
4834
4835       Check_Node : Node_Id;
4836       Checks_On  : constant Boolean :=
4837                      (not Index_Checks_Suppressed (Suppress_Typ))
4838                        or else
4839                      (not Range_Checks_Suppressed (Suppress_Typ));
4840
4841    begin
4842       --  For now we just return if Checks_On is false, however this should be
4843       --  enhanced to check for an always True value in the condition and to
4844       --  generate a compilation warning???
4845
4846       if not Expander_Active or else not Checks_On then
4847          return;
4848       end if;
4849
4850       if Static_Sloc = No_Location then
4851          Internal_Static_Sloc := Sloc (Node);
4852       end if;
4853
4854       if No (Flag_Node) then
4855          Internal_Flag_Node := Node;
4856       end if;
4857
4858       for J in 1 .. 2 loop
4859          exit when No (Checks (J));
4860
4861          if Nkind (Checks (J)) = N_Raise_Constraint_Error
4862            and then Present (Condition (Checks (J)))
4863          then
4864             if not Has_Dynamic_Range_Check (Internal_Flag_Node) then
4865                Check_Node := Checks (J);
4866                Mark_Rewrite_Insertion (Check_Node);
4867
4868                if Do_Before then
4869                   Insert_Before_And_Analyze (Node, Check_Node);
4870                else
4871                   Insert_After_And_Analyze (Node, Check_Node);
4872                end if;
4873
4874                Set_Has_Dynamic_Range_Check (Internal_Flag_Node);
4875             end if;
4876
4877          else
4878             Check_Node :=
4879               Make_Raise_Constraint_Error (Internal_Static_Sloc,
4880                 Reason => CE_Range_Check_Failed);
4881             Mark_Rewrite_Insertion (Check_Node);
4882
4883             if Do_Before then
4884                Insert_Before_And_Analyze (Node, Check_Node);
4885             else
4886                Insert_After_And_Analyze (Node, Check_Node);
4887             end if;
4888          end if;
4889       end loop;
4890    end Insert_Range_Checks;
4891
4892    ------------------------
4893    -- Insert_Valid_Check --
4894    ------------------------
4895
4896    procedure Insert_Valid_Check (Expr : Node_Id) is
4897       Loc : constant Source_Ptr := Sloc (Expr);
4898       Exp : Node_Id;
4899
4900    begin
4901       --  Do not insert if checks off, or if not checking validity
4902
4903       if not Validity_Checks_On
4904         or else Range_Or_Validity_Checks_Suppressed (Expr)
4905       then
4906          return;
4907       end if;
4908
4909       --  If we have a checked conversion, then validity check applies to
4910       --  the expression inside the conversion, not the result, since if
4911       --  the expression inside is valid, then so is the conversion result.
4912
4913       Exp := Expr;
4914       while Nkind (Exp) = N_Type_Conversion loop
4915          Exp := Expression (Exp);
4916       end loop;
4917
4918       --  We are about to insert the validity check for Exp. We save and
4919       --  reset the Do_Range_Check flag over this validity check, and then
4920       --  put it back for the final original reference (Exp may be rewritten).
4921
4922       declare
4923          DRC : constant Boolean := Do_Range_Check (Exp);
4924
4925       begin
4926          Set_Do_Range_Check (Exp, False);
4927
4928          --  Insert the validity check. Note that we do this with validity
4929          --  checks turned off, to avoid recursion, we do not want validity
4930          --  checks on the validity checking code itself!
4931
4932          Insert_Action
4933            (Expr,
4934             Make_Raise_Constraint_Error (Loc,
4935               Condition =>
4936                 Make_Op_Not (Loc,
4937                   Right_Opnd =>
4938                     Make_Attribute_Reference (Loc,
4939                       Prefix =>
4940                         Duplicate_Subexpr_No_Checks (Exp, Name_Req => True),
4941                       Attribute_Name => Name_Valid)),
4942               Reason => CE_Invalid_Data),
4943             Suppress => Validity_Check);
4944
4945          --  If the expression is a a reference to an element of a bit-packed
4946          --  array, then it is rewritten as a renaming declaration. If the
4947          --  expression is an actual in a call, it has not been expanded,
4948          --  waiting for the proper point at which to do it. The same happens
4949          --  with renamings, so that we have to force the expansion now. This
4950          --  non-local complication is due to code in exp_ch2,adb, exp_ch4.adb
4951          --  and exp_ch6.adb.
4952
4953          if Is_Entity_Name (Exp)
4954            and then Nkind (Parent (Entity (Exp))) =
4955                       N_Object_Renaming_Declaration
4956          then
4957             declare
4958                Old_Exp : constant Node_Id := Name (Parent (Entity (Exp)));
4959             begin
4960                if Nkind (Old_Exp) = N_Indexed_Component
4961                  and then Is_Bit_Packed_Array (Etype (Prefix (Old_Exp)))
4962                then
4963                   Expand_Packed_Element_Reference (Old_Exp);
4964                end if;
4965             end;
4966          end if;
4967
4968          --  Put back the Do_Range_Check flag on the resulting (possibly
4969          --  rewritten) expression.
4970
4971          --  Note: it might be thought that a validity check is not required
4972          --  when a range check is present, but that's not the case, because
4973          --  the back end is allowed to assume for the range check that the
4974          --  operand is within its declared range (an assumption that validity
4975          --  checking is all about NOT assuming!)
4976
4977          --  Note: no need to worry about Possible_Local_Raise here, it will
4978          --  already have been called if original node has Do_Range_Check set.
4979
4980          Set_Do_Range_Check (Exp, DRC);
4981       end;
4982    end Insert_Valid_Check;
4983
4984    ----------------------------------
4985    -- Install_Null_Excluding_Check --
4986    ----------------------------------
4987
4988    procedure Install_Null_Excluding_Check (N : Node_Id) is
4989       Loc : constant Source_Ptr := Sloc (N);
4990       Typ : constant Entity_Id  := Etype (N);
4991
4992       function In_Declarative_Region_Of_Subprogram_Body return Boolean;
4993       --  Determine whether node N, a reference to an *in* parameter, is
4994       --  inside the declarative region of the current subprogram body.
4995
4996       procedure Mark_Non_Null;
4997       --  After installation of check, if the node in question is an entity
4998       --  name, then mark this entity as non-null if possible.
4999
5000       ----------------------------------------------
5001       -- In_Declarative_Region_Of_Subprogram_Body --
5002       ----------------------------------------------
5003
5004       function In_Declarative_Region_Of_Subprogram_Body return Boolean is
5005          E     : constant Entity_Id := Entity (N);
5006          S     : constant Entity_Id := Current_Scope;
5007          S_Par : Node_Id;
5008
5009       begin
5010          pragma Assert (Ekind (E) = E_In_Parameter);
5011
5012          --  Two initial context checks. We must be inside a subprogram body
5013          --  with declarations and reference must not appear in nested scopes.
5014
5015          if (Ekind (S) /= E_Function
5016              and then Ekind (S) /= E_Procedure)
5017            or else Scope (E) /= S
5018          then
5019             return False;
5020          end if;
5021
5022          S_Par := Parent (Parent (S));
5023
5024          if Nkind (S_Par) /= N_Subprogram_Body
5025            or else No (Declarations (S_Par))
5026          then
5027             return False;
5028          end if;
5029
5030          declare
5031             N_Decl : Node_Id;
5032             P      : Node_Id;
5033
5034          begin
5035             --  Retrieve the declaration node of N (if any). Note that N
5036             --  may be a part of a complex initialization expression.
5037
5038             P := Parent (N);
5039             N_Decl := Empty;
5040             while Present (P) loop
5041
5042                --  While traversing the parent chain, we find that N
5043                --  belongs to a statement, thus it may never appear in
5044                --  a declarative region.
5045
5046                if Nkind (P) in N_Statement_Other_Than_Procedure_Call
5047                  or else Nkind (P) = N_Procedure_Call_Statement
5048                then
5049                   return False;
5050                end if;
5051
5052                if Nkind (P) in N_Declaration
5053                  and then Nkind (P) not in N_Subprogram_Specification
5054                then
5055                   N_Decl := P;
5056                   exit;
5057                end if;
5058
5059                P := Parent (P);
5060             end loop;
5061
5062             if No (N_Decl) then
5063                return False;
5064             end if;
5065
5066             return List_Containing (N_Decl) = Declarations (S_Par);
5067          end;
5068       end In_Declarative_Region_Of_Subprogram_Body;
5069
5070       -------------------
5071       -- Mark_Non_Null --
5072       -------------------
5073
5074       procedure Mark_Non_Null is
5075       begin
5076          --  Only case of interest is if node N is an entity name
5077
5078          if Is_Entity_Name (N) then
5079
5080             --  For sure, we want to clear an indication that this is known to
5081             --  be null, since if we get past this check, it definitely is not!
5082
5083             Set_Is_Known_Null (Entity (N), False);
5084
5085             --  We can mark the entity as known to be non-null if either it is
5086             --  safe to capture the value, or in the case of an IN parameter,
5087             --  which is a constant, if the check we just installed is in the
5088             --  declarative region of the subprogram body. In this latter case,
5089             --  a check is decisive for the rest of the body, since we know we
5090             --  must complete all declarations before executing the body.
5091
5092             if Safe_To_Capture_Value (N, Entity (N))
5093               or else
5094                 (Ekind (Entity (N)) = E_In_Parameter
5095                    and then In_Declarative_Region_Of_Subprogram_Body)
5096             then
5097                Set_Is_Known_Non_Null (Entity (N));
5098             end if;
5099          end if;
5100       end Mark_Non_Null;
5101
5102    --  Start of processing for Install_Null_Excluding_Check
5103
5104    begin
5105       pragma Assert (Is_Access_Type (Typ));
5106
5107       --  No check inside a generic (why not???)
5108
5109       if Inside_A_Generic then
5110          return;
5111       end if;
5112
5113       --  No check needed if known to be non-null
5114
5115       if Known_Non_Null (N) then
5116          return;
5117       end if;
5118
5119       --  If known to be null, here is where we generate a compile time check
5120
5121       if Known_Null (N) then
5122          Apply_Compile_Time_Constraint_Error
5123            (N,
5124             "null value not allowed here?",
5125             CE_Access_Check_Failed);
5126          Mark_Non_Null;
5127          return;
5128       end if;
5129
5130       --  If entity is never assigned, for sure a warning is appropriate
5131
5132       if Is_Entity_Name (N) then
5133          Check_Unset_Reference (N);
5134       end if;
5135
5136       --  No check needed if checks are suppressed on the range. Note that we
5137       --  don't set Is_Known_Non_Null in this case (we could legitimately do
5138       --  so, since the program is erroneous, but we don't like to casually
5139       --  propagate such conclusions from erroneosity).
5140
5141       if Access_Checks_Suppressed (Typ) then
5142          return;
5143       end if;
5144
5145       --  No check needed for access to concurrent record types generated by
5146       --  the expander. This is not just an optimization (though it does indeed
5147       --  remove junk checks). It also avoids generation of junk warnings.
5148
5149       if Nkind (N) in N_Has_Chars
5150         and then Chars (N) = Name_uObject
5151         and then Is_Concurrent_Record_Type
5152                    (Directly_Designated_Type (Etype (N)))
5153       then
5154          return;
5155       end if;
5156
5157       --  Otherwise install access check
5158
5159       Insert_Action (N,
5160         Make_Raise_Constraint_Error (Loc,
5161           Condition =>
5162             Make_Op_Eq (Loc,
5163               Left_Opnd  => Duplicate_Subexpr_Move_Checks (N),
5164               Right_Opnd => Make_Null (Loc)),
5165           Reason => CE_Access_Check_Failed));
5166
5167       Mark_Non_Null;
5168    end Install_Null_Excluding_Check;
5169
5170    --------------------------
5171    -- Install_Static_Check --
5172    --------------------------
5173
5174    procedure Install_Static_Check (R_Cno : Node_Id; Loc : Source_Ptr) is
5175       Stat : constant Boolean   := Is_Static_Expression (R_Cno);
5176       Typ  : constant Entity_Id := Etype (R_Cno);
5177
5178    begin
5179       Rewrite (R_Cno,
5180         Make_Raise_Constraint_Error (Loc,
5181           Reason => CE_Range_Check_Failed));
5182       Set_Analyzed (R_Cno);
5183       Set_Etype (R_Cno, Typ);
5184       Set_Raises_Constraint_Error (R_Cno);
5185       Set_Is_Static_Expression (R_Cno, Stat);
5186    end Install_Static_Check;
5187
5188    ---------------------
5189    -- Kill_All_Checks --
5190    ---------------------
5191
5192    procedure Kill_All_Checks is
5193    begin
5194       if Debug_Flag_CC then
5195          w ("Kill_All_Checks");
5196       end if;
5197
5198       --  We reset the number of saved checks to zero, and also modify all
5199       --  stack entries for statement ranges to indicate that the number of
5200       --  checks at each level is now zero.
5201
5202       Num_Saved_Checks := 0;
5203
5204       for J in 1 .. Saved_Checks_TOS loop
5205          Saved_Checks_Stack (J) := 0;
5206       end loop;
5207    end Kill_All_Checks;
5208
5209    -----------------
5210    -- Kill_Checks --
5211    -----------------
5212
5213    procedure Kill_Checks (V : Entity_Id) is
5214    begin
5215       if Debug_Flag_CC then
5216          w ("Kill_Checks for entity", Int (V));
5217       end if;
5218
5219       for J in 1 .. Num_Saved_Checks loop
5220          if Saved_Checks (J).Entity = V then
5221             if Debug_Flag_CC then
5222                w ("   Checks killed for saved check ", J);
5223             end if;
5224
5225             Saved_Checks (J).Killed := True;
5226          end if;
5227       end loop;
5228    end Kill_Checks;
5229
5230    ------------------------------
5231    -- Length_Checks_Suppressed --
5232    ------------------------------
5233
5234    function Length_Checks_Suppressed (E : Entity_Id) return Boolean is
5235    begin
5236       if Present (E) and then Checks_May_Be_Suppressed (E) then
5237          return Is_Check_Suppressed (E, Length_Check);
5238       else
5239          return Scope_Suppress (Length_Check);
5240       end if;
5241    end Length_Checks_Suppressed;
5242
5243    --------------------------------
5244    -- Overflow_Checks_Suppressed --
5245    --------------------------------
5246
5247    function Overflow_Checks_Suppressed (E : Entity_Id) return Boolean is
5248    begin
5249       if Present (E) and then Checks_May_Be_Suppressed (E) then
5250          return Is_Check_Suppressed (E, Overflow_Check);
5251       else
5252          return Scope_Suppress (Overflow_Check);
5253       end if;
5254    end Overflow_Checks_Suppressed;
5255    -----------------------------
5256    -- Range_Checks_Suppressed --
5257    -----------------------------
5258
5259    function Range_Checks_Suppressed (E : Entity_Id) return Boolean is
5260    begin
5261       if Present (E) then
5262
5263          --  Note: for now we always suppress range checks on Vax float types,
5264          --  since Gigi does not know how to generate these checks.
5265
5266          if Vax_Float (E) then
5267             return True;
5268          elsif Kill_Range_Checks (E) then
5269             return True;
5270          elsif Checks_May_Be_Suppressed (E) then
5271             return Is_Check_Suppressed (E, Range_Check);
5272          end if;
5273       end if;
5274
5275       return Scope_Suppress (Range_Check);
5276    end Range_Checks_Suppressed;
5277
5278    -----------------------------------------
5279    -- Range_Or_Validity_Checks_Suppressed --
5280    -----------------------------------------
5281
5282    --  Note: the coding would be simpler here if we simply made appropriate
5283    --  calls to Range/Validity_Checks_Suppressed, but that would result in
5284    --  duplicated checks which we prefer to avoid.
5285
5286    function Range_Or_Validity_Checks_Suppressed
5287      (Expr : Node_Id) return Boolean
5288    is
5289    begin
5290       --  Immediate return if scope checks suppressed for either check
5291
5292       if Scope_Suppress (Range_Check) or Scope_Suppress (Validity_Check) then
5293          return True;
5294       end if;
5295
5296       --  If no expression, that's odd, decide that checks are suppressed,
5297       --  since we don't want anyone trying to do checks in this case, which
5298       --  is most likely the result of some other error.
5299
5300       if No (Expr) then
5301          return True;
5302       end if;
5303
5304       --  Expression is present, so perform suppress checks on type
5305
5306       declare
5307          Typ : constant Entity_Id := Etype (Expr);
5308       begin
5309          if Vax_Float (Typ) then
5310             return True;
5311          elsif Checks_May_Be_Suppressed (Typ)
5312            and then (Is_Check_Suppressed (Typ, Range_Check)
5313                        or else
5314                      Is_Check_Suppressed (Typ, Validity_Check))
5315          then
5316             return True;
5317          end if;
5318       end;
5319
5320       --  If expression is an entity name, perform checks on this entity
5321
5322       if Is_Entity_Name (Expr) then
5323          declare
5324             Ent : constant Entity_Id := Entity (Expr);
5325          begin
5326             if Checks_May_Be_Suppressed (Ent) then
5327                return Is_Check_Suppressed (Ent, Range_Check)
5328                  or else Is_Check_Suppressed (Ent, Validity_Check);
5329             end if;
5330          end;
5331       end if;
5332
5333       --  If we fall through, no checks suppressed
5334
5335       return False;
5336    end Range_Or_Validity_Checks_Suppressed;
5337
5338    -------------------
5339    -- Remove_Checks --
5340    -------------------
5341
5342    procedure Remove_Checks (Expr : Node_Id) is
5343       Discard : Traverse_Result;
5344       pragma Warnings (Off, Discard);
5345
5346       function Process (N : Node_Id) return Traverse_Result;
5347       --  Process a single node during the traversal
5348
5349       function Traverse is new Traverse_Func (Process);
5350       --  The traversal function itself
5351
5352       -------------
5353       -- Process --
5354       -------------
5355
5356       function Process (N : Node_Id) return Traverse_Result is
5357       begin
5358          if Nkind (N) not in N_Subexpr then
5359             return Skip;
5360          end if;
5361
5362          Set_Do_Range_Check (N, False);
5363
5364          case Nkind (N) is
5365             when N_And_Then =>
5366                Discard := Traverse (Left_Opnd (N));
5367                return Skip;
5368
5369             when N_Attribute_Reference =>
5370                Set_Do_Overflow_Check (N, False);
5371
5372             when N_Function_Call =>
5373                Set_Do_Tag_Check (N, False);
5374
5375             when N_Op =>
5376                Set_Do_Overflow_Check (N, False);
5377
5378                case Nkind (N) is
5379                   when N_Op_Divide =>
5380                      Set_Do_Division_Check (N, False);
5381
5382                   when N_Op_And =>
5383                      Set_Do_Length_Check (N, False);
5384
5385                   when N_Op_Mod =>
5386                      Set_Do_Division_Check (N, False);
5387
5388                   when N_Op_Or =>
5389                      Set_Do_Length_Check (N, False);
5390
5391                   when N_Op_Rem =>
5392                      Set_Do_Division_Check (N, False);
5393
5394                   when N_Op_Xor =>
5395                      Set_Do_Length_Check (N, False);
5396
5397                   when others =>
5398                      null;
5399                end case;
5400
5401             when N_Or_Else =>
5402                Discard := Traverse (Left_Opnd (N));
5403                return Skip;
5404
5405             when N_Selected_Component =>
5406                Set_Do_Discriminant_Check (N, False);
5407
5408             when N_Type_Conversion =>
5409                Set_Do_Length_Check   (N, False);
5410                Set_Do_Tag_Check      (N, False);
5411                Set_Do_Overflow_Check (N, False);
5412
5413             when others =>
5414                null;
5415          end case;
5416
5417          return OK;
5418       end Process;
5419
5420    --  Start of processing for Remove_Checks
5421
5422    begin
5423       Discard := Traverse (Expr);
5424    end Remove_Checks;
5425
5426    ----------------------------
5427    -- Selected_Length_Checks --
5428    ----------------------------
5429
5430    function Selected_Length_Checks
5431      (Ck_Node    : Node_Id;
5432       Target_Typ : Entity_Id;
5433       Source_Typ : Entity_Id;
5434       Warn_Node  : Node_Id) return Check_Result
5435    is
5436       Loc         : constant Source_Ptr := Sloc (Ck_Node);
5437       S_Typ       : Entity_Id;
5438       T_Typ       : Entity_Id;
5439       Expr_Actual : Node_Id;
5440       Exptyp      : Entity_Id;
5441       Cond        : Node_Id := Empty;
5442       Do_Access   : Boolean := False;
5443       Wnode       : Node_Id := Warn_Node;
5444       Ret_Result  : Check_Result := (Empty, Empty);
5445       Num_Checks  : Natural := 0;
5446
5447       procedure Add_Check (N : Node_Id);
5448       --  Adds the action given to Ret_Result if N is non-Empty
5449
5450       function Get_E_Length (E : Entity_Id; Indx : Nat) return Node_Id;
5451       function Get_N_Length (N : Node_Id; Indx : Nat) return Node_Id;
5452       --  Comments required ???
5453
5454       function Same_Bounds (L : Node_Id; R : Node_Id) return Boolean;
5455       --  True for equal literals and for nodes that denote the same constant
5456       --  entity, even if its value is not a static constant. This includes the
5457       --  case of a discriminal reference within an init proc. Removes some
5458       --  obviously superfluous checks.
5459
5460       function Length_E_Cond
5461         (Exptyp : Entity_Id;
5462          Typ    : Entity_Id;
5463          Indx   : Nat) return Node_Id;
5464       --  Returns expression to compute:
5465       --    Typ'Length /= Exptyp'Length
5466
5467       function Length_N_Cond
5468         (Expr : Node_Id;
5469          Typ  : Entity_Id;
5470          Indx : Nat) return Node_Id;
5471       --  Returns expression to compute:
5472       --    Typ'Length /= Expr'Length
5473
5474       ---------------
5475       -- Add_Check --
5476       ---------------
5477
5478       procedure Add_Check (N : Node_Id) is
5479       begin
5480          if Present (N) then
5481
5482             --  For now, ignore attempt to place more than 2 checks ???
5483
5484             if Num_Checks = 2 then
5485                return;
5486             end if;
5487
5488             pragma Assert (Num_Checks <= 1);
5489             Num_Checks := Num_Checks + 1;
5490             Ret_Result (Num_Checks) := N;
5491          end if;
5492       end Add_Check;
5493
5494       ------------------
5495       -- Get_E_Length --
5496       ------------------
5497
5498       function Get_E_Length (E : Entity_Id; Indx : Nat) return Node_Id is
5499          SE : constant Entity_Id := Scope (E);
5500          N  : Node_Id;
5501          E1 : Entity_Id := E;
5502
5503       begin
5504          if Ekind (Scope (E)) = E_Record_Type
5505            and then Has_Discriminants (Scope (E))
5506          then
5507             N := Build_Discriminal_Subtype_Of_Component (E);
5508
5509             if Present (N) then
5510                Insert_Action (Ck_Node, N);
5511                E1 := Defining_Identifier (N);
5512             end if;
5513          end if;
5514
5515          if Ekind (E1) = E_String_Literal_Subtype then
5516             return
5517               Make_Integer_Literal (Loc,
5518                 Intval => String_Literal_Length (E1));
5519
5520          elsif SE /= Standard_Standard
5521            and then Ekind (Scope (SE)) = E_Protected_Type
5522            and then Has_Discriminants (Scope (SE))
5523            and then Has_Completion (Scope (SE))
5524            and then not Inside_Init_Proc
5525          then
5526             --  If the type whose length is needed is a private component
5527             --  constrained by a discriminant, we must expand the 'Length
5528             --  attribute into an explicit computation, using the discriminal
5529             --  of the current protected operation. This is because the actual
5530             --  type of the prival is constructed after the protected opera-
5531             --  tion has been fully expanded.
5532
5533             declare
5534                Indx_Type : Node_Id;
5535                Lo        : Node_Id;
5536                Hi        : Node_Id;
5537                Do_Expand : Boolean := False;
5538
5539             begin
5540                Indx_Type := First_Index (E);
5541
5542                for J in 1 .. Indx - 1 loop
5543                   Next_Index (Indx_Type);
5544                end loop;
5545
5546                Get_Index_Bounds (Indx_Type, Lo, Hi);
5547
5548                if Nkind (Lo) = N_Identifier
5549                  and then Ekind (Entity (Lo)) = E_In_Parameter
5550                then
5551                   Lo := Get_Discriminal (E, Lo);
5552                   Do_Expand := True;
5553                end if;
5554
5555                if Nkind (Hi) = N_Identifier
5556                  and then Ekind (Entity (Hi)) = E_In_Parameter
5557                then
5558                   Hi := Get_Discriminal (E, Hi);
5559                   Do_Expand := True;
5560                end if;
5561
5562                if Do_Expand then
5563                   if not Is_Entity_Name (Lo) then
5564                      Lo := Duplicate_Subexpr_No_Checks (Lo);
5565                   end if;
5566
5567                   if not Is_Entity_Name (Hi) then
5568                      Lo := Duplicate_Subexpr_No_Checks (Hi);
5569                   end if;
5570
5571                   N :=
5572                     Make_Op_Add (Loc,
5573                       Left_Opnd =>
5574                         Make_Op_Subtract (Loc,
5575                           Left_Opnd  => Hi,
5576                           Right_Opnd => Lo),
5577
5578                       Right_Opnd => Make_Integer_Literal (Loc, 1));
5579                   return N;
5580
5581                else
5582                   N :=
5583                     Make_Attribute_Reference (Loc,
5584                       Attribute_Name => Name_Length,
5585                       Prefix =>
5586                         New_Occurrence_Of (E1, Loc));
5587
5588                   if Indx > 1 then
5589                      Set_Expressions (N, New_List (
5590                        Make_Integer_Literal (Loc, Indx)));
5591                   end if;
5592
5593                   return N;
5594                end if;
5595             end;
5596
5597          else
5598             N :=
5599               Make_Attribute_Reference (Loc,
5600                 Attribute_Name => Name_Length,
5601                 Prefix =>
5602                   New_Occurrence_Of (E1, Loc));
5603
5604             if Indx > 1 then
5605                Set_Expressions (N, New_List (
5606                  Make_Integer_Literal (Loc, Indx)));
5607             end if;
5608
5609             return N;
5610          end if;
5611       end Get_E_Length;
5612
5613       ------------------
5614       -- Get_N_Length --
5615       ------------------
5616
5617       function Get_N_Length (N : Node_Id; Indx : Nat) return Node_Id is
5618       begin
5619          return
5620            Make_Attribute_Reference (Loc,
5621              Attribute_Name => Name_Length,
5622              Prefix =>
5623                Duplicate_Subexpr_No_Checks (N, Name_Req => True),
5624              Expressions => New_List (
5625                Make_Integer_Literal (Loc, Indx)));
5626       end Get_N_Length;
5627
5628       -------------------
5629       -- Length_E_Cond --
5630       -------------------
5631
5632       function Length_E_Cond
5633         (Exptyp : Entity_Id;
5634          Typ    : Entity_Id;
5635          Indx   : Nat) return Node_Id
5636       is
5637       begin
5638          return
5639            Make_Op_Ne (Loc,
5640              Left_Opnd  => Get_E_Length (Typ, Indx),
5641              Right_Opnd => Get_E_Length (Exptyp, Indx));
5642       end Length_E_Cond;
5643
5644       -------------------
5645       -- Length_N_Cond --
5646       -------------------
5647
5648       function Length_N_Cond
5649         (Expr : Node_Id;
5650          Typ  : Entity_Id;
5651          Indx : Nat) return Node_Id
5652       is
5653       begin
5654          return
5655            Make_Op_Ne (Loc,
5656              Left_Opnd  => Get_E_Length (Typ, Indx),
5657              Right_Opnd => Get_N_Length (Expr, Indx));
5658       end Length_N_Cond;
5659
5660       -----------------
5661       -- Same_Bounds --
5662       -----------------
5663
5664       function Same_Bounds (L : Node_Id; R : Node_Id) return Boolean is
5665       begin
5666          return
5667            (Nkind (L) = N_Integer_Literal
5668              and then Nkind (R) = N_Integer_Literal
5669              and then Intval (L) = Intval (R))
5670
5671           or else
5672             (Is_Entity_Name (L)
5673               and then Ekind (Entity (L)) = E_Constant
5674               and then ((Is_Entity_Name (R)
5675                          and then Entity (L) = Entity (R))
5676                         or else
5677                        (Nkind (R) = N_Type_Conversion
5678                          and then Is_Entity_Name (Expression (R))
5679                          and then Entity (L) = Entity (Expression (R)))))
5680
5681           or else
5682             (Is_Entity_Name (R)
5683               and then Ekind (Entity (R)) = E_Constant
5684               and then Nkind (L) = N_Type_Conversion
5685               and then Is_Entity_Name (Expression (L))
5686               and then Entity (R) = Entity (Expression (L)))
5687
5688          or else
5689             (Is_Entity_Name (L)
5690               and then Is_Entity_Name (R)
5691               and then Entity (L) = Entity (R)
5692               and then Ekind (Entity (L)) = E_In_Parameter
5693               and then Inside_Init_Proc);
5694       end Same_Bounds;
5695
5696    --  Start of processing for Selected_Length_Checks
5697
5698    begin
5699       if not Expander_Active then
5700          return Ret_Result;
5701       end if;
5702
5703       if Target_Typ = Any_Type
5704         or else Target_Typ = Any_Composite
5705         or else Raises_Constraint_Error (Ck_Node)
5706       then
5707          return Ret_Result;
5708       end if;
5709
5710       if No (Wnode) then
5711          Wnode := Ck_Node;
5712       end if;
5713
5714       T_Typ := Target_Typ;
5715
5716       if No (Source_Typ) then
5717          S_Typ := Etype (Ck_Node);
5718       else
5719          S_Typ := Source_Typ;
5720       end if;
5721
5722       if S_Typ = Any_Type or else S_Typ = Any_Composite then
5723          return Ret_Result;
5724       end if;
5725
5726       if Is_Access_Type (T_Typ) and then Is_Access_Type (S_Typ) then
5727          S_Typ := Designated_Type (S_Typ);
5728          T_Typ := Designated_Type (T_Typ);
5729          Do_Access := True;
5730
5731          --  A simple optimization for the null case
5732
5733          if Known_Null (Ck_Node) then
5734             return Ret_Result;
5735          end if;
5736       end if;
5737
5738       if Is_Array_Type (T_Typ) and then Is_Array_Type (S_Typ) then
5739          if Is_Constrained (T_Typ) then
5740
5741             --  The checking code to be generated will freeze the
5742             --  corresponding array type. However, we must freeze the
5743             --  type now, so that the freeze node does not appear within
5744             --  the generated condional expression, but ahead of it.
5745
5746             Freeze_Before (Ck_Node, T_Typ);
5747
5748             Expr_Actual := Get_Referenced_Object (Ck_Node);
5749             Exptyp      := Get_Actual_Subtype (Ck_Node);
5750
5751             if Is_Access_Type (Exptyp) then
5752                Exptyp := Designated_Type (Exptyp);
5753             end if;
5754
5755             --  String_Literal case. This needs to be handled specially be-
5756             --  cause no index types are available for string literals. The
5757             --  condition is simply:
5758
5759             --    T_Typ'Length = string-literal-length
5760
5761             if Nkind (Expr_Actual) = N_String_Literal
5762               and then Ekind (Etype (Expr_Actual)) = E_String_Literal_Subtype
5763             then
5764                Cond :=
5765                  Make_Op_Ne (Loc,
5766                    Left_Opnd  => Get_E_Length (T_Typ, 1),
5767                    Right_Opnd =>
5768                      Make_Integer_Literal (Loc,
5769                        Intval =>
5770                          String_Literal_Length (Etype (Expr_Actual))));
5771
5772             --  General array case. Here we have a usable actual subtype for
5773             --  the expression, and the condition is built from the two types
5774             --  (Do_Length):
5775
5776             --     T_Typ'Length     /= Exptyp'Length     or else
5777             --     T_Typ'Length (2) /= Exptyp'Length (2) or else
5778             --     T_Typ'Length (3) /= Exptyp'Length (3) or else
5779             --     ...
5780
5781             elsif Is_Constrained (Exptyp) then
5782                declare
5783                   Ndims : constant Nat := Number_Dimensions (T_Typ);
5784
5785                   L_Index  : Node_Id;
5786                   R_Index  : Node_Id;
5787                   L_Low    : Node_Id;
5788                   L_High   : Node_Id;
5789                   R_Low    : Node_Id;
5790                   R_High   : Node_Id;
5791                   L_Length : Uint;
5792                   R_Length : Uint;
5793                   Ref_Node : Node_Id;
5794
5795                begin
5796                   --  At the library level, we need to ensure that the type of
5797                   --  the object is elaborated before the check itself is
5798                   --  emitted. This is only done if the object is in the
5799                   --  current compilation unit, otherwise the type is frozen
5800                   --  and elaborated in its unit.
5801
5802                   if Is_Itype (Exptyp)
5803                     and then
5804                       Ekind (Cunit_Entity (Current_Sem_Unit)) = E_Package
5805                     and then
5806                       not In_Package_Body (Cunit_Entity (Current_Sem_Unit))
5807                     and then In_Open_Scopes (Scope (Exptyp))
5808                   then
5809                      Ref_Node := Make_Itype_Reference (Sloc (Ck_Node));
5810                      Set_Itype (Ref_Node, Exptyp);
5811                      Insert_Action (Ck_Node, Ref_Node);
5812                   end if;
5813
5814                   L_Index := First_Index (T_Typ);
5815                   R_Index := First_Index (Exptyp);
5816
5817                   for Indx in 1 .. Ndims loop
5818                      if not (Nkind (L_Index) = N_Raise_Constraint_Error
5819                                or else
5820                              Nkind (R_Index) = N_Raise_Constraint_Error)
5821                      then
5822                         Get_Index_Bounds (L_Index, L_Low, L_High);
5823                         Get_Index_Bounds (R_Index, R_Low, R_High);
5824
5825                         --  Deal with compile time length check. Note that we
5826                         --  skip this in the access case, because the access
5827                         --  value may be null, so we cannot know statically.
5828
5829                         if not Do_Access
5830                           and then Compile_Time_Known_Value (L_Low)
5831                           and then Compile_Time_Known_Value (L_High)
5832                           and then Compile_Time_Known_Value (R_Low)
5833                           and then Compile_Time_Known_Value (R_High)
5834                         then
5835                            if Expr_Value (L_High) >= Expr_Value (L_Low) then
5836                               L_Length := Expr_Value (L_High) -
5837                                           Expr_Value (L_Low) + 1;
5838                            else
5839                               L_Length := UI_From_Int (0);
5840                            end if;
5841
5842                            if Expr_Value (R_High) >= Expr_Value (R_Low) then
5843                               R_Length := Expr_Value (R_High) -
5844                                           Expr_Value (R_Low) + 1;
5845                            else
5846                               R_Length := UI_From_Int (0);
5847                            end if;
5848
5849                            if L_Length > R_Length then
5850                               Add_Check
5851                                 (Compile_Time_Constraint_Error
5852                                   (Wnode, "too few elements for}?", T_Typ));
5853
5854                            elsif  L_Length < R_Length then
5855                               Add_Check
5856                                 (Compile_Time_Constraint_Error
5857                                   (Wnode, "too many elements for}?", T_Typ));
5858                            end if;
5859
5860                         --  The comparison for an individual index subtype
5861                         --  is omitted if the corresponding index subtypes
5862                         --  statically match, since the result is known to
5863                         --  be true. Note that this test is worth while even
5864                         --  though we do static evaluation, because non-static
5865                         --  subtypes can statically match.
5866
5867                         elsif not
5868                           Subtypes_Statically_Match
5869                             (Etype (L_Index), Etype (R_Index))
5870
5871                           and then not
5872                             (Same_Bounds (L_Low, R_Low)
5873                               and then Same_Bounds (L_High, R_High))
5874                         then
5875                            Evolve_Or_Else
5876                              (Cond, Length_E_Cond (Exptyp, T_Typ, Indx));
5877                         end if;
5878
5879                         Next (L_Index);
5880                         Next (R_Index);
5881                      end if;
5882                   end loop;
5883                end;
5884
5885             --  Handle cases where we do not get a usable actual subtype that
5886             --  is constrained. This happens for example in the function call
5887             --  and explicit dereference cases. In these cases, we have to get
5888             --  the length or range from the expression itself, making sure we
5889             --  do not evaluate it more than once.
5890
5891             --  Here Ck_Node is the original expression, or more properly the
5892             --  result of applying Duplicate_Expr to the original tree, forcing
5893             --  the result to be a name.
5894
5895             else
5896                declare
5897                   Ndims : constant Nat := Number_Dimensions (T_Typ);
5898
5899                begin
5900                   --  Build the condition for the explicit dereference case
5901
5902                   for Indx in 1 .. Ndims loop
5903                      Evolve_Or_Else
5904                        (Cond, Length_N_Cond (Ck_Node, T_Typ, Indx));
5905                   end loop;
5906                end;
5907             end if;
5908          end if;
5909       end if;
5910
5911       --  Construct the test and insert into the tree
5912
5913       if Present (Cond) then
5914          if Do_Access then
5915             Cond := Guard_Access (Cond, Loc, Ck_Node);
5916          end if;
5917
5918          Add_Check
5919            (Make_Raise_Constraint_Error (Loc,
5920               Condition => Cond,
5921               Reason => CE_Length_Check_Failed));
5922       end if;
5923
5924       return Ret_Result;
5925    end Selected_Length_Checks;
5926
5927    ---------------------------
5928    -- Selected_Range_Checks --
5929    ---------------------------
5930
5931    function Selected_Range_Checks
5932      (Ck_Node    : Node_Id;
5933       Target_Typ : Entity_Id;
5934       Source_Typ : Entity_Id;
5935       Warn_Node  : Node_Id) return Check_Result
5936    is
5937       Loc         : constant Source_Ptr := Sloc (Ck_Node);
5938       S_Typ       : Entity_Id;
5939       T_Typ       : Entity_Id;
5940       Expr_Actual : Node_Id;
5941       Exptyp      : Entity_Id;
5942       Cond        : Node_Id := Empty;
5943       Do_Access   : Boolean := False;
5944       Wnode       : Node_Id  := Warn_Node;
5945       Ret_Result  : Check_Result := (Empty, Empty);
5946       Num_Checks  : Integer := 0;
5947
5948       procedure Add_Check (N : Node_Id);
5949       --  Adds the action given to Ret_Result if N is non-Empty
5950
5951       function Discrete_Range_Cond
5952         (Expr : Node_Id;
5953          Typ  : Entity_Id) return Node_Id;
5954       --  Returns expression to compute:
5955       --    Low_Bound (Expr) < Typ'First
5956       --      or else
5957       --    High_Bound (Expr) > Typ'Last
5958
5959       function Discrete_Expr_Cond
5960         (Expr : Node_Id;
5961          Typ  : Entity_Id) return Node_Id;
5962       --  Returns expression to compute:
5963       --    Expr < Typ'First
5964       --      or else
5965       --    Expr > Typ'Last
5966
5967       function Get_E_First_Or_Last
5968         (E    : Entity_Id;
5969          Indx : Nat;
5970          Nam  : Name_Id) return Node_Id;
5971       --  Returns expression to compute:
5972       --    E'First or E'Last
5973
5974       function Get_N_First (N : Node_Id; Indx : Nat) return Node_Id;
5975       function Get_N_Last  (N : Node_Id; Indx : Nat) return Node_Id;
5976       --  Returns expression to compute:
5977       --    N'First or N'Last using Duplicate_Subexpr_No_Checks
5978
5979       function Range_E_Cond
5980         (Exptyp : Entity_Id;
5981          Typ    : Entity_Id;
5982          Indx   : Nat)
5983          return   Node_Id;
5984       --  Returns expression to compute:
5985       --    Exptyp'First < Typ'First or else Exptyp'Last > Typ'Last
5986
5987       function Range_Equal_E_Cond
5988         (Exptyp : Entity_Id;
5989          Typ    : Entity_Id;
5990          Indx   : Nat) return Node_Id;
5991       --  Returns expression to compute:
5992       --    Exptyp'First /= Typ'First or else Exptyp'Last /= Typ'Last
5993
5994       function Range_N_Cond
5995         (Expr : Node_Id;
5996          Typ  : Entity_Id;
5997          Indx : Nat) return Node_Id;
5998       --  Return expression to compute:
5999       --    Expr'First < Typ'First or else Expr'Last > Typ'Last
6000
6001       ---------------
6002       -- Add_Check --
6003       ---------------
6004
6005       procedure Add_Check (N : Node_Id) is
6006       begin
6007          if Present (N) then
6008
6009             --  For now, ignore attempt to place more than 2 checks ???
6010
6011             if Num_Checks = 2 then
6012                return;
6013             end if;
6014
6015             pragma Assert (Num_Checks <= 1);
6016             Num_Checks := Num_Checks + 1;
6017             Ret_Result (Num_Checks) := N;
6018          end if;
6019       end Add_Check;
6020
6021       -------------------------
6022       -- Discrete_Expr_Cond --
6023       -------------------------
6024
6025       function Discrete_Expr_Cond
6026         (Expr : Node_Id;
6027          Typ  : Entity_Id) return Node_Id
6028       is
6029       begin
6030          return
6031            Make_Or_Else (Loc,
6032              Left_Opnd =>
6033                Make_Op_Lt (Loc,
6034                  Left_Opnd =>
6035                    Convert_To (Base_Type (Typ),
6036                      Duplicate_Subexpr_No_Checks (Expr)),
6037                  Right_Opnd =>
6038                    Convert_To (Base_Type (Typ),
6039                                Get_E_First_Or_Last (Typ, 0, Name_First))),
6040
6041              Right_Opnd =>
6042                Make_Op_Gt (Loc,
6043                  Left_Opnd =>
6044                    Convert_To (Base_Type (Typ),
6045                      Duplicate_Subexpr_No_Checks (Expr)),
6046                  Right_Opnd =>
6047                    Convert_To
6048                      (Base_Type (Typ),
6049                       Get_E_First_Or_Last (Typ, 0, Name_Last))));
6050       end Discrete_Expr_Cond;
6051
6052       -------------------------
6053       -- Discrete_Range_Cond --
6054       -------------------------
6055
6056       function Discrete_Range_Cond
6057         (Expr : Node_Id;
6058          Typ  : Entity_Id) return Node_Id
6059       is
6060          LB : Node_Id := Low_Bound (Expr);
6061          HB : Node_Id := High_Bound (Expr);
6062
6063          Left_Opnd  : Node_Id;
6064          Right_Opnd : Node_Id;
6065
6066       begin
6067          if Nkind (LB) = N_Identifier
6068            and then Ekind (Entity (LB)) = E_Discriminant
6069          then
6070             LB := New_Occurrence_Of (Discriminal (Entity (LB)), Loc);
6071          end if;
6072
6073          if Nkind (HB) = N_Identifier
6074            and then Ekind (Entity (HB)) = E_Discriminant
6075          then
6076             HB := New_Occurrence_Of (Discriminal (Entity (HB)), Loc);
6077          end if;
6078
6079          Left_Opnd :=
6080            Make_Op_Lt (Loc,
6081              Left_Opnd  =>
6082                Convert_To
6083                  (Base_Type (Typ), Duplicate_Subexpr_No_Checks (LB)),
6084
6085              Right_Opnd =>
6086                Convert_To
6087                  (Base_Type (Typ), Get_E_First_Or_Last (Typ, 0, Name_First)));
6088
6089          if Base_Type (Typ) = Typ then
6090             return Left_Opnd;
6091
6092          elsif Compile_Time_Known_Value (High_Bound (Scalar_Range (Typ)))
6093             and then
6094                Compile_Time_Known_Value (High_Bound (Scalar_Range
6095                                                      (Base_Type (Typ))))
6096          then
6097             if Is_Floating_Point_Type (Typ) then
6098                if Expr_Value_R (High_Bound (Scalar_Range (Typ))) =
6099                   Expr_Value_R (High_Bound (Scalar_Range (Base_Type (Typ))))
6100                then
6101                   return Left_Opnd;
6102                end if;
6103
6104             else
6105                if Expr_Value (High_Bound (Scalar_Range (Typ))) =
6106                   Expr_Value (High_Bound (Scalar_Range (Base_Type (Typ))))
6107                then
6108                   return Left_Opnd;
6109                end if;
6110             end if;
6111          end if;
6112
6113          Right_Opnd :=
6114            Make_Op_Gt (Loc,
6115              Left_Opnd  =>
6116                Convert_To
6117                  (Base_Type (Typ), Duplicate_Subexpr_No_Checks (HB)),
6118
6119              Right_Opnd =>
6120                Convert_To
6121                  (Base_Type (Typ),
6122                   Get_E_First_Or_Last (Typ, 0, Name_Last)));
6123
6124          return Make_Or_Else (Loc, Left_Opnd, Right_Opnd);
6125       end Discrete_Range_Cond;
6126
6127       -------------------------
6128       -- Get_E_First_Or_Last --
6129       -------------------------
6130
6131       function Get_E_First_Or_Last
6132         (E    : Entity_Id;
6133          Indx : Nat;
6134          Nam  : Name_Id) return Node_Id
6135       is
6136          N     : Node_Id;
6137          LB    : Node_Id;
6138          HB    : Node_Id;
6139          Bound : Node_Id;
6140
6141       begin
6142          if Is_Array_Type (E) then
6143             N := First_Index (E);
6144
6145             for J in 2 .. Indx loop
6146                Next_Index (N);
6147             end loop;
6148
6149          else
6150             N := Scalar_Range (E);
6151          end if;
6152
6153          if Nkind (N) = N_Subtype_Indication then
6154             LB := Low_Bound (Range_Expression (Constraint (N)));
6155             HB := High_Bound (Range_Expression (Constraint (N)));
6156
6157          elsif Is_Entity_Name (N) then
6158             LB := Type_Low_Bound  (Etype (N));
6159             HB := Type_High_Bound (Etype (N));
6160
6161          else
6162             LB := Low_Bound  (N);
6163             HB := High_Bound (N);
6164          end if;
6165
6166          if Nam = Name_First then
6167             Bound := LB;
6168          else
6169             Bound := HB;
6170          end if;
6171
6172          if Nkind (Bound) = N_Identifier
6173            and then Ekind (Entity (Bound)) = E_Discriminant
6174          then
6175             --  If this is a task discriminant, and we are the body, we must
6176             --  retrieve the corresponding body discriminal. This is another
6177             --  consequence of the early creation of discriminals, and the
6178             --  need to generate constraint checks before their declarations
6179             --  are made visible.
6180
6181             if Is_Concurrent_Record_Type (Scope (Entity (Bound)))  then
6182                declare
6183                   Tsk : constant Entity_Id :=
6184                           Corresponding_Concurrent_Type
6185                            (Scope (Entity (Bound)));
6186                   Disc : Entity_Id;
6187
6188                begin
6189                   if In_Open_Scopes (Tsk)
6190                     and then Has_Completion (Tsk)
6191                   then
6192                      --  Find discriminant of original task, and use its
6193                      --  current discriminal, which is the renaming within
6194                      --  the task body.
6195
6196                      Disc :=  First_Discriminant (Tsk);
6197                      while Present (Disc) loop
6198                         if Chars (Disc) = Chars (Entity (Bound)) then
6199                            Set_Scope (Discriminal (Disc), Tsk);
6200                            return New_Occurrence_Of (Discriminal (Disc), Loc);
6201                         end if;
6202
6203                         Next_Discriminant (Disc);
6204                      end loop;
6205
6206                      --  That loop should always succeed in finding a matching
6207                      --  entry and returning. Fatal error if not.
6208
6209                      raise Program_Error;
6210
6211                   else
6212                      return
6213                        New_Occurrence_Of (Discriminal (Entity (Bound)), Loc);
6214                   end if;
6215                end;
6216             else
6217                return New_Occurrence_Of (Discriminal (Entity (Bound)), Loc);
6218             end if;
6219
6220          elsif Nkind (Bound) = N_Identifier
6221            and then Ekind (Entity (Bound)) = E_In_Parameter
6222            and then not Inside_Init_Proc
6223          then
6224             return Get_Discriminal (E, Bound);
6225
6226          elsif Nkind (Bound) = N_Integer_Literal then
6227             return Make_Integer_Literal (Loc, Intval (Bound));
6228
6229          --  Case of a bound rewritten to an N_Raise_Constraint_Error node
6230          --  because it is an out-of-range value. Duplicate_Subexpr cannot be
6231          --  called on this node because an N_Raise_Constraint_Error is not
6232          --  side effect free, and we may not assume that we are in the proper
6233          --  context to remove side effects on it at the point of reference.
6234
6235          elsif Nkind (Bound) = N_Raise_Constraint_Error then
6236             return New_Copy_Tree (Bound);
6237
6238          else
6239             return Duplicate_Subexpr_No_Checks (Bound);
6240          end if;
6241       end Get_E_First_Or_Last;
6242
6243       -----------------
6244       -- Get_N_First --
6245       -----------------
6246
6247       function Get_N_First (N : Node_Id; Indx : Nat) return Node_Id is
6248       begin
6249          return
6250            Make_Attribute_Reference (Loc,
6251              Attribute_Name => Name_First,
6252              Prefix =>
6253                Duplicate_Subexpr_No_Checks (N, Name_Req => True),
6254              Expressions => New_List (
6255                Make_Integer_Literal (Loc, Indx)));
6256       end Get_N_First;
6257
6258       ----------------
6259       -- Get_N_Last --
6260       ----------------
6261
6262       function Get_N_Last (N : Node_Id; Indx : Nat) return Node_Id is
6263       begin
6264          return
6265            Make_Attribute_Reference (Loc,
6266              Attribute_Name => Name_Last,
6267              Prefix =>
6268                Duplicate_Subexpr_No_Checks (N, Name_Req => True),
6269              Expressions => New_List (
6270               Make_Integer_Literal (Loc, Indx)));
6271       end Get_N_Last;
6272
6273       ------------------
6274       -- Range_E_Cond --
6275       ------------------
6276
6277       function Range_E_Cond
6278         (Exptyp : Entity_Id;
6279          Typ    : Entity_Id;
6280          Indx   : Nat) return Node_Id
6281       is
6282       begin
6283          return
6284            Make_Or_Else (Loc,
6285              Left_Opnd =>
6286                Make_Op_Lt (Loc,
6287                  Left_Opnd => Get_E_First_Or_Last (Exptyp, Indx, Name_First),
6288                  Right_Opnd  => Get_E_First_Or_Last (Typ, Indx, Name_First)),
6289
6290              Right_Opnd =>
6291                Make_Op_Gt (Loc,
6292                  Left_Opnd => Get_E_First_Or_Last (Exptyp, Indx, Name_Last),
6293                  Right_Opnd  => Get_E_First_Or_Last (Typ, Indx, Name_Last)));
6294       end Range_E_Cond;
6295
6296       ------------------------
6297       -- Range_Equal_E_Cond --
6298       ------------------------
6299
6300       function Range_Equal_E_Cond
6301         (Exptyp : Entity_Id;
6302          Typ    : Entity_Id;
6303          Indx   : Nat) return Node_Id
6304       is
6305       begin
6306          return
6307            Make_Or_Else (Loc,
6308              Left_Opnd =>
6309                Make_Op_Ne (Loc,
6310                  Left_Opnd => Get_E_First_Or_Last (Exptyp, Indx, Name_First),
6311                  Right_Opnd  => Get_E_First_Or_Last (Typ, Indx, Name_First)),
6312              Right_Opnd =>
6313                Make_Op_Ne (Loc,
6314                  Left_Opnd => Get_E_First_Or_Last (Exptyp, Indx, Name_Last),
6315                  Right_Opnd  => Get_E_First_Or_Last (Typ, Indx, Name_Last)));
6316       end Range_Equal_E_Cond;
6317
6318       ------------------
6319       -- Range_N_Cond --
6320       ------------------
6321
6322       function Range_N_Cond
6323         (Expr : Node_Id;
6324          Typ  : Entity_Id;
6325          Indx : Nat) return Node_Id
6326       is
6327       begin
6328          return
6329            Make_Or_Else (Loc,
6330              Left_Opnd =>
6331                Make_Op_Lt (Loc,
6332                  Left_Opnd => Get_N_First (Expr, Indx),
6333                  Right_Opnd  => Get_E_First_Or_Last (Typ, Indx, Name_First)),
6334
6335              Right_Opnd =>
6336                Make_Op_Gt (Loc,
6337                  Left_Opnd => Get_N_Last (Expr, Indx),
6338                  Right_Opnd  => Get_E_First_Or_Last (Typ, Indx, Name_Last)));
6339       end Range_N_Cond;
6340
6341    --  Start of processing for Selected_Range_Checks
6342
6343    begin
6344       if not Expander_Active then
6345          return Ret_Result;
6346       end if;
6347
6348       if Target_Typ = Any_Type
6349         or else Target_Typ = Any_Composite
6350         or else Raises_Constraint_Error (Ck_Node)
6351       then
6352          return Ret_Result;
6353       end if;
6354
6355       if No (Wnode) then
6356          Wnode := Ck_Node;
6357       end if;
6358
6359       T_Typ := Target_Typ;
6360
6361       if No (Source_Typ) then
6362          S_Typ := Etype (Ck_Node);
6363       else
6364          S_Typ := Source_Typ;
6365       end if;
6366
6367       if S_Typ = Any_Type or else S_Typ = Any_Composite then
6368          return Ret_Result;
6369       end if;
6370
6371       --  The order of evaluating T_Typ before S_Typ seems to be critical
6372       --  because S_Typ can be derived from Etype (Ck_Node), if it's not passed
6373       --  in, and since Node can be an N_Range node, it might be invalid.
6374       --  Should there be an assert check somewhere for taking the Etype of
6375       --  an N_Range node ???
6376
6377       if Is_Access_Type (T_Typ) and then Is_Access_Type (S_Typ) then
6378          S_Typ := Designated_Type (S_Typ);
6379          T_Typ := Designated_Type (T_Typ);
6380          Do_Access := True;
6381
6382          --  A simple optimization for the null case
6383
6384          if Known_Null (Ck_Node) then
6385             return Ret_Result;
6386          end if;
6387       end if;
6388
6389       --  For an N_Range Node, check for a null range and then if not
6390       --  null generate a range check action.
6391
6392       if Nkind (Ck_Node) = N_Range then
6393
6394          --  There's no point in checking a range against itself
6395
6396          if Ck_Node = Scalar_Range (T_Typ) then
6397             return Ret_Result;
6398          end if;
6399
6400          declare
6401             T_LB       : constant Node_Id := Type_Low_Bound  (T_Typ);
6402             T_HB       : constant Node_Id := Type_High_Bound (T_Typ);
6403             LB         : constant Node_Id := Low_Bound (Ck_Node);
6404             HB         : constant Node_Id := High_Bound (Ck_Node);
6405             Null_Range : Boolean;
6406
6407             Out_Of_Range_L : Boolean;
6408             Out_Of_Range_H : Boolean;
6409
6410          begin
6411             --  Check for case where everything is static and we can
6412             --  do the check at compile time. This is skipped if we
6413             --  have an access type, since the access value may be null.
6414
6415             --  ??? This code can be improved since you only need to know
6416             --  that the two respective bounds (LB & T_LB or HB & T_HB)
6417             --  are known at compile time to emit pertinent messages.
6418
6419             if Compile_Time_Known_Value (LB)
6420               and then Compile_Time_Known_Value (HB)
6421               and then Compile_Time_Known_Value (T_LB)
6422               and then Compile_Time_Known_Value (T_HB)
6423               and then not Do_Access
6424             then
6425                --  Floating-point case
6426
6427                if Is_Floating_Point_Type (S_Typ) then
6428                   Null_Range := Expr_Value_R (HB) < Expr_Value_R (LB);
6429                   Out_Of_Range_L :=
6430                     (Expr_Value_R (LB) < Expr_Value_R (T_LB))
6431                        or else
6432                     (Expr_Value_R (LB) > Expr_Value_R (T_HB));
6433
6434                   Out_Of_Range_H :=
6435                     (Expr_Value_R (HB) > Expr_Value_R (T_HB))
6436                        or else
6437                     (Expr_Value_R (HB) < Expr_Value_R (T_LB));
6438
6439                --  Fixed or discrete type case
6440
6441                else
6442                   Null_Range := Expr_Value (HB) < Expr_Value (LB);
6443                   Out_Of_Range_L :=
6444                     (Expr_Value (LB) < Expr_Value (T_LB))
6445                     or else
6446                     (Expr_Value (LB) > Expr_Value (T_HB));
6447
6448                   Out_Of_Range_H :=
6449                     (Expr_Value (HB) > Expr_Value (T_HB))
6450                     or else
6451                     (Expr_Value (HB) < Expr_Value (T_LB));
6452                end if;
6453
6454                if not Null_Range then
6455                   if Out_Of_Range_L then
6456                      if No (Warn_Node) then
6457                         Add_Check
6458                           (Compile_Time_Constraint_Error
6459                              (Low_Bound (Ck_Node),
6460                               "static value out of range of}?", T_Typ));
6461
6462                      else
6463                         Add_Check
6464                           (Compile_Time_Constraint_Error
6465                             (Wnode,
6466                              "static range out of bounds of}?", T_Typ));
6467                      end if;
6468                   end if;
6469
6470                   if Out_Of_Range_H then
6471                      if No (Warn_Node) then
6472                         Add_Check
6473                           (Compile_Time_Constraint_Error
6474                              (High_Bound (Ck_Node),
6475                               "static value out of range of}?", T_Typ));
6476
6477                      else
6478                         Add_Check
6479                           (Compile_Time_Constraint_Error
6480                              (Wnode,
6481                               "static range out of bounds of}?", T_Typ));
6482                      end if;
6483                   end if;
6484
6485                end if;
6486
6487             else
6488                declare
6489                   LB : Node_Id := Low_Bound (Ck_Node);
6490                   HB : Node_Id := High_Bound (Ck_Node);
6491
6492                begin
6493                   --  If either bound is a discriminant and we are within the
6494                   --  record declaration, it is a use of the discriminant in a
6495                   --  constraint of a component, and nothing can be checked
6496                   --  here. The check will be emitted within the init proc.
6497                   --  Before then, the discriminal has no real meaning.
6498                   --  Similarly, if the entity is a discriminal, there is no
6499                   --  check to perform yet.
6500
6501                   --  The same holds within a discriminated synchronized type,
6502                   --  where the discriminant may constrain a component or an
6503                   --  entry family.
6504
6505                   if Nkind (LB) = N_Identifier
6506                     and then Denotes_Discriminant (LB, True)
6507                   then
6508                      if Current_Scope = Scope (Entity (LB))
6509                        or else Is_Concurrent_Type (Current_Scope)
6510                        or else Ekind (Entity (LB)) /= E_Discriminant
6511                      then
6512                         return Ret_Result;
6513                      else
6514                         LB :=
6515                           New_Occurrence_Of (Discriminal (Entity (LB)), Loc);
6516                      end if;
6517                   end if;
6518
6519                   if Nkind (HB) = N_Identifier
6520                     and then Denotes_Discriminant (HB, True)
6521                   then
6522                      if Current_Scope = Scope (Entity (HB))
6523                        or else Is_Concurrent_Type (Current_Scope)
6524                        or else Ekind (Entity (HB)) /= E_Discriminant
6525                      then
6526                         return Ret_Result;
6527                      else
6528                         HB :=
6529                           New_Occurrence_Of (Discriminal (Entity (HB)), Loc);
6530                      end if;
6531                   end if;
6532
6533                   Cond := Discrete_Range_Cond (Ck_Node, T_Typ);
6534                   Set_Paren_Count (Cond, 1);
6535
6536                   Cond :=
6537                     Make_And_Then (Loc,
6538                       Left_Opnd =>
6539                         Make_Op_Ge (Loc,
6540                           Left_Opnd  => Duplicate_Subexpr_No_Checks (HB),
6541                           Right_Opnd => Duplicate_Subexpr_No_Checks (LB)),
6542                       Right_Opnd => Cond);
6543                end;
6544             end if;
6545          end;
6546
6547       elsif Is_Scalar_Type (S_Typ) then
6548
6549          --  This somewhat duplicates what Apply_Scalar_Range_Check does,
6550          --  except the above simply sets a flag in the node and lets
6551          --  gigi generate the check base on the Etype of the expression.
6552          --  Sometimes, however we want to do a dynamic check against an
6553          --  arbitrary target type, so we do that here.
6554
6555          if Ekind (Base_Type (S_Typ)) /= Ekind (Base_Type (T_Typ)) then
6556             Cond := Discrete_Expr_Cond (Ck_Node, T_Typ);
6557
6558          --  For literals, we can tell if the constraint error will be
6559          --  raised at compile time, so we never need a dynamic check, but
6560          --  if the exception will be raised, then post the usual warning,
6561          --  and replace the literal with a raise constraint error
6562          --  expression. As usual, skip this for access types
6563
6564          elsif Compile_Time_Known_Value (Ck_Node)
6565            and then not Do_Access
6566          then
6567             declare
6568                LB : constant Node_Id := Type_Low_Bound (T_Typ);
6569                UB : constant Node_Id := Type_High_Bound (T_Typ);
6570
6571                Out_Of_Range  : Boolean;
6572                Static_Bounds : constant Boolean :=
6573                                  Compile_Time_Known_Value (LB)
6574                                    and Compile_Time_Known_Value (UB);
6575
6576             begin
6577                --  Following range tests should use Sem_Eval routine ???
6578
6579                if Static_Bounds then
6580                   if Is_Floating_Point_Type (S_Typ) then
6581                      Out_Of_Range :=
6582                        (Expr_Value_R (Ck_Node) < Expr_Value_R (LB))
6583                          or else
6584                        (Expr_Value_R (Ck_Node) > Expr_Value_R (UB));
6585
6586                   else -- fixed or discrete type
6587                      Out_Of_Range :=
6588                        Expr_Value (Ck_Node) < Expr_Value (LB)
6589                          or else
6590                        Expr_Value (Ck_Node) > Expr_Value (UB);
6591                   end if;
6592
6593                   --  Bounds of the type are static and the literal is
6594                   --  out of range so make a warning message.
6595
6596                   if Out_Of_Range then
6597                      if No (Warn_Node) then
6598                         Add_Check
6599                           (Compile_Time_Constraint_Error
6600                              (Ck_Node,
6601                               "static value out of range of}?", T_Typ));
6602
6603                      else
6604                         Add_Check
6605                           (Compile_Time_Constraint_Error
6606                              (Wnode,
6607                               "static value out of range of}?", T_Typ));
6608                      end if;
6609                   end if;
6610
6611                else
6612                   Cond := Discrete_Expr_Cond (Ck_Node, T_Typ);
6613                end if;
6614             end;
6615
6616          --  Here for the case of a non-static expression, we need a runtime
6617          --  check unless the source type range is guaranteed to be in the
6618          --  range of the target type.
6619
6620          else
6621             if not In_Subrange_Of (S_Typ, T_Typ) then
6622                Cond := Discrete_Expr_Cond (Ck_Node, T_Typ);
6623             end if;
6624          end if;
6625       end if;
6626
6627       if Is_Array_Type (T_Typ) and then Is_Array_Type (S_Typ) then
6628          if Is_Constrained (T_Typ) then
6629
6630             Expr_Actual := Get_Referenced_Object (Ck_Node);
6631             Exptyp      := Get_Actual_Subtype (Expr_Actual);
6632
6633             if Is_Access_Type (Exptyp) then
6634                Exptyp := Designated_Type (Exptyp);
6635             end if;
6636
6637             --  String_Literal case. This needs to be handled specially be-
6638             --  cause no index types are available for string literals. The
6639             --  condition is simply:
6640
6641             --    T_Typ'Length = string-literal-length
6642
6643             if Nkind (Expr_Actual) = N_String_Literal then
6644                null;
6645
6646             --  General array case. Here we have a usable actual subtype for
6647             --  the expression, and the condition is built from the two types
6648
6649             --     T_Typ'First     < Exptyp'First     or else
6650             --     T_Typ'Last      > Exptyp'Last      or else
6651             --     T_Typ'First(1)  < Exptyp'First(1)  or else
6652             --     T_Typ'Last(1)   > Exptyp'Last(1)   or else
6653             --     ...
6654
6655             elsif Is_Constrained (Exptyp) then
6656                declare
6657                   Ndims : constant Nat := Number_Dimensions (T_Typ);
6658
6659                   L_Index : Node_Id;
6660                   R_Index : Node_Id;
6661                   L_Low   : Node_Id;
6662                   L_High  : Node_Id;
6663                   R_Low   : Node_Id;
6664                   R_High  : Node_Id;
6665
6666                begin
6667                   L_Index := First_Index (T_Typ);
6668                   R_Index := First_Index (Exptyp);
6669
6670                   for Indx in 1 .. Ndims loop
6671                      if not (Nkind (L_Index) = N_Raise_Constraint_Error
6672                                or else
6673                              Nkind (R_Index) = N_Raise_Constraint_Error)
6674                      then
6675                         Get_Index_Bounds (L_Index, L_Low, L_High);
6676                         Get_Index_Bounds (R_Index, R_Low, R_High);
6677
6678                         --  Deal with compile time length check. Note that we
6679                         --  skip this in the access case, because the access
6680                         --  value may be null, so we cannot know statically.
6681
6682                         if not
6683                           Subtypes_Statically_Match
6684                             (Etype (L_Index), Etype (R_Index))
6685                         then
6686                            --  If the target type is constrained then we
6687                            --  have to check for exact equality of bounds
6688                            --  (required for qualified expressions).
6689
6690                            if Is_Constrained (T_Typ) then
6691                               Evolve_Or_Else
6692                                 (Cond,
6693                                  Range_Equal_E_Cond (Exptyp, T_Typ, Indx));
6694
6695                            else
6696                               Evolve_Or_Else
6697                                 (Cond, Range_E_Cond (Exptyp, T_Typ, Indx));
6698                            end if;
6699                         end if;
6700
6701                         Next (L_Index);
6702                         Next (R_Index);
6703
6704                      end if;
6705                   end loop;
6706                end;
6707
6708             --  Handle cases where we do not get a usable actual subtype that
6709             --  is constrained. This happens for example in the function call
6710             --  and explicit dereference cases. In these cases, we have to get
6711             --  the length or range from the expression itself, making sure we
6712             --  do not evaluate it more than once.
6713
6714             --  Here Ck_Node is the original expression, or more properly the
6715             --  result of applying Duplicate_Expr to the original tree,
6716             --  forcing the result to be a name.
6717
6718             else
6719                declare
6720                   Ndims : constant Nat := Number_Dimensions (T_Typ);
6721
6722                begin
6723                   --  Build the condition for the explicit dereference case
6724
6725                   for Indx in 1 .. Ndims loop
6726                      Evolve_Or_Else
6727                        (Cond, Range_N_Cond (Ck_Node, T_Typ, Indx));
6728                   end loop;
6729                end;
6730
6731             end if;
6732
6733          else
6734             --  For a conversion to an unconstrained array type, generate an
6735             --  Action to check that the bounds of the source value are within
6736             --  the constraints imposed by the target type (RM 4.6(38)). No
6737             --  check is needed for a conversion to an access to unconstrained
6738             --  array type, as 4.6(24.15/2) requires the designated subtypes
6739             --  of the two access types to statically match.
6740
6741             if Nkind (Parent (Ck_Node)) = N_Type_Conversion
6742               and then not Do_Access
6743             then
6744                declare
6745                   Opnd_Index : Node_Id;
6746                   Targ_Index : Node_Id;
6747                   Opnd_Range : Node_Id;
6748
6749                begin
6750                   Opnd_Index := First_Index (Get_Actual_Subtype (Ck_Node));
6751                   Targ_Index := First_Index (T_Typ);
6752
6753                   while Present (Opnd_Index) loop
6754
6755                      --  If the index is a range, use its bounds. If it is an
6756                      --  entity (as will be the case if it is a named subtype
6757                      --  or an itype created for a slice) retrieve its range.
6758
6759                      if Is_Entity_Name (Opnd_Index)
6760                        and then Is_Type (Entity (Opnd_Index))
6761                      then
6762                         Opnd_Range := Scalar_Range (Entity (Opnd_Index));
6763                      else
6764                         Opnd_Range := Opnd_Index;
6765                      end if;
6766
6767                      if Nkind (Opnd_Range) = N_Range then
6768                         if Is_In_Range
6769                              (Low_Bound (Opnd_Range), Etype (Targ_Index))
6770                           and then
6771                             Is_In_Range
6772                              (High_Bound (Opnd_Range), Etype (Targ_Index))
6773                         then
6774                            null;
6775
6776                         --  If null range, no check needed
6777
6778                         elsif
6779                           Compile_Time_Known_Value (High_Bound (Opnd_Range))
6780                             and then
6781                           Compile_Time_Known_Value (Low_Bound (Opnd_Range))
6782                             and then
6783                               Expr_Value (High_Bound (Opnd_Range)) <
6784                                   Expr_Value (Low_Bound (Opnd_Range))
6785                         then
6786                            null;
6787
6788                         elsif Is_Out_Of_Range
6789                                 (Low_Bound (Opnd_Range), Etype (Targ_Index))
6790                           or else
6791                               Is_Out_Of_Range
6792                                 (High_Bound (Opnd_Range), Etype (Targ_Index))
6793                         then
6794                            Add_Check
6795                              (Compile_Time_Constraint_Error
6796                                (Wnode, "value out of range of}?", T_Typ));
6797
6798                         else
6799                            Evolve_Or_Else
6800                              (Cond,
6801                               Discrete_Range_Cond
6802                                 (Opnd_Range, Etype (Targ_Index)));
6803                         end if;
6804                      end if;
6805
6806                      Next_Index (Opnd_Index);
6807                      Next_Index (Targ_Index);
6808                   end loop;
6809                end;
6810             end if;
6811          end if;
6812       end if;
6813
6814       --  Construct the test and insert into the tree
6815
6816       if Present (Cond) then
6817          if Do_Access then
6818             Cond := Guard_Access (Cond, Loc, Ck_Node);
6819          end if;
6820
6821          Add_Check
6822            (Make_Raise_Constraint_Error (Loc,
6823               Condition => Cond,
6824               Reason    => CE_Range_Check_Failed));
6825       end if;
6826
6827       return Ret_Result;
6828    end Selected_Range_Checks;
6829
6830    -------------------------------
6831    -- Storage_Checks_Suppressed --
6832    -------------------------------
6833
6834    function Storage_Checks_Suppressed (E : Entity_Id) return Boolean is
6835    begin
6836       if Present (E) and then Checks_May_Be_Suppressed (E) then
6837          return Is_Check_Suppressed (E, Storage_Check);
6838       else
6839          return Scope_Suppress (Storage_Check);
6840       end if;
6841    end Storage_Checks_Suppressed;
6842
6843    ---------------------------
6844    -- Tag_Checks_Suppressed --
6845    ---------------------------
6846
6847    function Tag_Checks_Suppressed (E : Entity_Id) return Boolean is
6848    begin
6849       if Present (E) then
6850          if Kill_Tag_Checks (E) then
6851             return True;
6852          elsif Checks_May_Be_Suppressed (E) then
6853             return Is_Check_Suppressed (E, Tag_Check);
6854          end if;
6855       end if;
6856
6857       return Scope_Suppress (Tag_Check);
6858    end Tag_Checks_Suppressed;
6859
6860    --------------------------
6861    -- Validity_Check_Range --
6862    --------------------------
6863
6864    procedure Validity_Check_Range (N : Node_Id) is
6865    begin
6866       if Validity_Checks_On and Validity_Check_Operands then
6867          if Nkind (N) = N_Range then
6868             Ensure_Valid (Low_Bound (N));
6869             Ensure_Valid (High_Bound (N));
6870          end if;
6871       end if;
6872    end Validity_Check_Range;
6873
6874    --------------------------------
6875    -- Validity_Checks_Suppressed --
6876    --------------------------------
6877
6878    function Validity_Checks_Suppressed (E : Entity_Id) return Boolean is
6879    begin
6880       if Present (E) and then Checks_May_Be_Suppressed (E) then
6881          return Is_Check_Suppressed (E, Validity_Check);
6882       else
6883          return Scope_Suppress (Validity_Check);
6884       end if;
6885    end Validity_Checks_Suppressed;
6886
6887 end Checks;