1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2016, Free Software Foundation, Inc. --
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. --
21 -- GNAT was originally developed by the GNAT team at New York University. --
22 -- Extensive contributions were provided by Ada Core Technologies Inc. --
24 ------------------------------------------------------------------------------
26 with Atree
; use Atree
;
27 with Debug
; use Debug
;
28 with Debug_A
; use Debug_A
;
29 with Exp_Aggr
; use Exp_Aggr
;
30 with Exp_SPARK
; use Exp_SPARK
;
31 with Exp_Attr
; use Exp_Attr
;
32 with Exp_Ch2
; use Exp_Ch2
;
33 with Exp_Ch3
; use Exp_Ch3
;
34 with Exp_Ch4
; use Exp_Ch4
;
35 with Exp_Ch5
; use Exp_Ch5
;
36 with Exp_Ch6
; use Exp_Ch6
;
37 with Exp_Ch7
; use Exp_Ch7
;
38 with Exp_Ch8
; use Exp_Ch8
;
39 with Exp_Ch9
; use Exp_Ch9
;
40 with Exp_Ch11
; use Exp_Ch11
;
41 with Exp_Ch12
; use Exp_Ch12
;
42 with Exp_Ch13
; use Exp_Ch13
;
43 with Exp_Prag
; use Exp_Prag
;
44 with Ghost
; use Ghost
;
46 with Rtsfind
; use Rtsfind
;
48 with Sem_Ch8
; use Sem_Ch8
;
49 with Sem_Util
; use Sem_Util
;
50 with Sinfo
; use Sinfo
;
53 package body Expander
is
59 -- The following table is used to save values of the Expander_Active flag
60 -- when they are saved by Expander_Mode_Save_And_Set. We use an extendible
61 -- table (which is a bit of overkill) because it is easier than figuring
62 -- out a maximum value or bothering with range checks.
64 package Expander_Flags
is new Table
.Table
(
65 Table_Component_Type
=> Boolean,
66 Table_Index_Type
=> Int
,
69 Table_Increment
=> 200,
70 Table_Name
=> "Expander_Flags");
72 Abort_Bug_Box_Error
: exception;
73 -- Arbitrary exception to raise for implementation of -gnatd.B. See "when
74 -- N_Abort_Statement" below. See also debug.adb.
80 -- WARNING: This routine manages Ghost regions. Return statements must be
81 -- replaced by gotos which jump to the end of the routine and restore the
84 procedure Expand
(N
: Node_Id
) is
85 Mode
: Ghost_Mode_Type
;
88 -- If we were analyzing a default expression (or other spec expression)
89 -- the Full_Analysis flag must be off. If we are in expansion mode then
90 -- we must be performing a full analysis. If we are analyzing a generic
91 -- then Expansion must be off.
94 (not (Full_Analysis
and then In_Spec_Expression
)
95 and then (Full_Analysis
or else not Expander_Active
)
96 and then not (Inside_A_Generic
and then Expander_Active
));
98 -- Establish the Ghost mode of the context to ensure that any generated
99 -- nodes during expansion are marked as Ghost.
101 Set_Ghost_Mode
(N
, Mode
);
103 -- The GNATprove_Mode flag indicates that a light expansion for formal
104 -- verification should be used. This expansion is never done inside
105 -- generics, because otherwise, this breaks the name resolution
106 -- mechanism for generic instances.
108 if GNATprove_Mode
then
109 if not Inside_A_Generic
then
113 Set_Analyzed
(N
, Full_Analysis
);
115 -- Regular expansion is normally followed by special handling for
116 -- transient scopes for unconstrained results, etc. but this is not
117 -- needed, and in general cannot be done correctly, in this mode, so
122 -- There are three reasons for the Expander_Active flag to be false
124 -- The first is when are not generating code. In this mode the
125 -- Full_Analysis flag indicates whether we are performing a complete
126 -- analysis, in which case Full_Analysis = True or a pre-analysis in
127 -- which case Full_Analysis = False. See the spec of Sem for more info
130 -- The second reason for the Expander_Active flag to be False is that
131 -- we are performing a pre-analysis. During pre-analysis all expansion
132 -- activity is turned off to make sure nodes are semantically decorated
133 -- but no extra nodes are generated. This is for instance needed for
134 -- the first pass of aggregate semantic processing. Note that in this
135 -- case the Full_Analysis flag is set to False because the node will
136 -- subsequently be re-analyzed with expansion on (see the spec of sem).
138 -- Finally, expansion is turned off in a regular compilation if there
139 -- are serious errors. In that case there will be no further expansion,
140 -- but one cleanup action may be required: if a transient scope was
141 -- created (e.g. for a function that returns an unconstrained type) the
142 -- scope may still be on the stack, and must be removed explicitly,
143 -- given that the expansion actions that would normally process it will
144 -- not take place. This prevents cascaded errors due to stack mismatch.
146 elsif not Expander_Active
then
147 Set_Analyzed
(N
, Full_Analysis
);
149 if Serious_Errors_Detected
> 0 and then Scope_Is_Transient
then
151 (Scope_Stack
.Last
).Actions_To_Be_Wrapped
:= (others => No_List
);
159 Debug_A_Entry
("expanding ", N
);
161 -- Processing depends on node kind. For full details on the
162 -- expansion activity required in each case, see bodies of
163 -- corresponding expand routines.
166 when N_Abort_Statement
=>
167 Expand_N_Abort_Statement
(N
);
169 -- If -gnatd.B switch was given, crash the compiler. See
170 -- debug.adb for explanation.
172 if Debug_Flag_Dot_BB
then
173 raise Abort_Bug_Box_Error
;
176 when N_Accept_Statement
=>
177 Expand_N_Accept_Statement
(N
);
180 Expand_N_Aggregate
(N
);
183 Expand_N_Allocator
(N
);
186 Expand_N_And_Then
(N
);
188 when N_Assignment_Statement
=>
189 Expand_N_Assignment_Statement
(N
);
191 when N_Asynchronous_Select
=>
192 Expand_N_Asynchronous_Select
(N
);
194 when N_Attribute_Definition_Clause
=>
195 Expand_N_Attribute_Definition_Clause
(N
);
197 when N_Attribute_Reference
=>
198 Expand_N_Attribute_Reference
(N
);
200 when N_Block_Statement
=>
201 Expand_N_Block_Statement
(N
);
203 when N_Case_Expression
=>
204 Expand_N_Case_Expression
(N
);
206 when N_Case_Statement
=>
207 Expand_N_Case_Statement
(N
);
209 when N_Conditional_Entry_Call
=>
210 Expand_N_Conditional_Entry_Call
(N
);
212 when N_Delay_Relative_Statement
=>
213 Expand_N_Delay_Relative_Statement
(N
);
215 when N_Delay_Until_Statement
=>
216 Expand_N_Delay_Until_Statement
(N
);
218 when N_Delta_Aggregate
=>
219 Expand_N_Delta_Aggregate
(N
);
222 Expand_N_Entry_Body
(N
);
224 when N_Entry_Call_Statement
=>
225 Expand_N_Entry_Call_Statement
(N
);
227 when N_Entry_Declaration
=>
228 Expand_N_Entry_Declaration
(N
);
230 when N_Exception_Declaration
=>
231 Expand_N_Exception_Declaration
(N
);
233 when N_Exception_Renaming_Declaration
=>
234 Expand_N_Exception_Renaming_Declaration
(N
);
236 when N_Exit_Statement
=>
237 Expand_N_Exit_Statement
(N
);
239 when N_Expanded_Name
=>
240 Expand_N_Expanded_Name
(N
);
242 when N_Explicit_Dereference
=>
243 Expand_N_Explicit_Dereference
(N
);
245 when N_Expression_With_Actions
=>
246 Expand_N_Expression_With_Actions
(N
);
248 when N_Extended_Return_Statement
=>
249 Expand_N_Extended_Return_Statement
(N
);
251 when N_Extension_Aggregate
=>
252 Expand_N_Extension_Aggregate
(N
);
254 when N_Free_Statement
=>
255 Expand_N_Free_Statement
(N
);
257 when N_Freeze_Entity
=>
258 Expand_N_Freeze_Entity
(N
);
260 when N_Full_Type_Declaration
=>
261 Expand_N_Full_Type_Declaration
(N
);
263 when N_Function_Call
=>
264 Expand_N_Function_Call
(N
);
266 when N_Generic_Instantiation
=>
267 Expand_N_Generic_Instantiation
(N
);
269 when N_Goto_Statement
=>
270 Expand_N_Goto_Statement
(N
);
272 when N_Handled_Sequence_Of_Statements
=>
273 Expand_N_Handled_Sequence_Of_Statements
(N
);
276 Expand_N_Identifier
(N
);
278 when N_If_Expression
=>
279 Expand_N_If_Expression
(N
);
281 when N_Indexed_Component
=>
282 Expand_N_Indexed_Component
(N
);
284 when N_If_Statement
=>
285 Expand_N_If_Statement
(N
);
290 when N_Loop_Statement
=>
291 Expand_N_Loop_Statement
(N
);
299 when N_Object_Declaration
=>
300 Expand_N_Object_Declaration
(N
);
302 when N_Object_Renaming_Declaration
=>
303 Expand_N_Object_Renaming_Declaration
(N
);
315 Expand_N_Op_Concat
(N
);
318 Expand_N_Op_Divide
(N
);
324 Expand_N_Op_Expon
(N
);
339 Expand_N_Op_Minus
(N
);
344 when N_Op_Multiply
=>
345 Expand_N_Op_Multiply
(N
);
357 Expand_N_Op_Plus
(N
);
362 when N_Op_Rotate_Left
=>
363 Expand_N_Op_Rotate_Left
(N
);
365 when N_Op_Rotate_Right
=>
366 Expand_N_Op_Rotate_Right
(N
);
368 when N_Op_Shift_Left
=>
369 Expand_N_Op_Shift_Left
(N
);
371 when N_Op_Shift_Right
=>
372 Expand_N_Op_Shift_Right
(N
);
374 when N_Op_Shift_Right_Arithmetic
=>
375 Expand_N_Op_Shift_Right_Arithmetic
(N
);
377 when N_Op_Subtract
=>
378 Expand_N_Op_Subtract
(N
);
384 Expand_N_Or_Else
(N
);
386 when N_Package_Body
=>
387 Expand_N_Package_Body
(N
);
389 when N_Package_Declaration
=>
390 Expand_N_Package_Declaration
(N
);
392 when N_Package_Renaming_Declaration
=>
393 Expand_N_Package_Renaming_Declaration
(N
);
395 when N_Subprogram_Renaming_Declaration
=>
396 Expand_N_Subprogram_Renaming_Declaration
(N
);
401 when N_Procedure_Call_Statement
=>
402 Expand_N_Procedure_Call_Statement
(N
);
404 when N_Protected_Type_Declaration
=>
405 Expand_N_Protected_Type_Declaration
(N
);
407 when N_Protected_Body
=>
408 Expand_N_Protected_Body
(N
);
410 when N_Qualified_Expression
=>
411 Expand_N_Qualified_Expression
(N
);
413 when N_Quantified_Expression
=>
414 Expand_N_Quantified_Expression
(N
);
416 when N_Raise_Statement
=>
417 Expand_N_Raise_Statement
(N
);
419 when N_Raise_Constraint_Error
=>
420 Expand_N_Raise_Constraint_Error
(N
);
422 when N_Raise_Expression
=>
423 Expand_N_Raise_Expression
(N
);
425 when N_Raise_Program_Error
=>
426 Expand_N_Raise_Program_Error
(N
);
428 when N_Raise_Storage_Error
=>
429 Expand_N_Raise_Storage_Error
(N
);
431 when N_Real_Literal
=>
432 Expand_N_Real_Literal
(N
);
434 when N_Record_Representation_Clause
=>
435 Expand_N_Record_Representation_Clause
(N
);
437 when N_Requeue_Statement
=>
438 Expand_N_Requeue_Statement
(N
);
440 when N_Simple_Return_Statement
=>
441 Expand_N_Simple_Return_Statement
(N
);
443 when N_Selected_Component
=>
444 Expand_N_Selected_Component
(N
);
446 when N_Selective_Accept
=>
447 Expand_N_Selective_Accept
(N
);
449 when N_Single_Protected_Declaration
=>
450 Expand_N_Single_Protected_Declaration
(N
);
452 when N_Single_Task_Declaration
=>
453 Expand_N_Single_Task_Declaration
(N
);
458 when N_Subtype_Indication
=>
459 Expand_N_Subtype_Indication
(N
);
461 when N_Subprogram_Body
=>
462 Expand_N_Subprogram_Body
(N
);
464 when N_Subprogram_Body_Stub
=>
465 Expand_N_Subprogram_Body_Stub
(N
);
467 when N_Subprogram_Declaration
=>
468 Expand_N_Subprogram_Declaration
(N
);
471 Expand_N_Task_Body
(N
);
473 when N_Task_Type_Declaration
=>
474 Expand_N_Task_Type_Declaration
(N
);
476 when N_Timed_Entry_Call
=>
477 Expand_N_Timed_Entry_Call
(N
);
479 when N_Type_Conversion
=>
480 Expand_N_Type_Conversion
(N
);
482 when N_Unchecked_Expression
=>
483 Expand_N_Unchecked_Expression
(N
);
485 when N_Unchecked_Type_Conversion
=>
486 Expand_N_Unchecked_Type_Conversion
(N
);
488 when N_Variant_Part
=>
489 Expand_N_Variant_Part
(N
);
491 -- For all other node kinds, no expansion activity required
498 when RE_Not_Available
=>
502 -- Set result as analyzed and then do a possible transient wrap. The
503 -- transient wrap must be done after the Analyzed flag is set on, so
504 -- that we do not get a recursive attempt to expand the node N.
508 -- Deal with transient scopes
510 if Scope_Is_Transient
and then N
= Node_To_Be_Wrapped
then
512 when N_Procedure_Call_Statement
513 | N_Statement_Other_Than_Procedure_Call
515 Wrap_Transient_Statement
(N
);
517 when N_Object_Declaration
518 | N_Object_Renaming_Declaration
519 | N_Subtype_Declaration
521 Wrap_Transient_Declaration
(N
);
524 Wrap_Transient_Expression
(N
);
528 Debug_A_Exit
("expanding ", N
, " (done)");
532 Restore_Ghost_Mode
(Mode
);
535 ---------------------------
536 -- Expander_Mode_Restore --
537 ---------------------------
539 procedure Expander_Mode_Restore
is
541 -- Not active (has no effect) in ASIS and GNATprove modes (see comments
542 -- in spec of Expander_Mode_Save_And_Set).
544 if ASIS_Mode
or GNATprove_Mode
then
548 -- Otherwise restore the flag
550 Expander_Active
:= Expander_Flags
.Table
(Expander_Flags
.Last
);
551 Expander_Flags
.Decrement_Last
;
553 -- Keep expander off if serious errors detected. In this case we do not
554 -- need expansion, and continued expansion may cause cascaded errors or
557 if Serious_Errors_Detected
/= 0 then
558 Expander_Active
:= False;
560 end Expander_Mode_Restore
;
562 --------------------------------
563 -- Expander_Mode_Save_And_Set --
564 --------------------------------
566 procedure Expander_Mode_Save_And_Set
(Status
: Boolean) is
568 -- Not active (has no effect) in ASIS and GNATprove modes (see comments
569 -- in spec of Expander_Mode_Save_And_Set).
571 if ASIS_Mode
or GNATprove_Mode
then
575 -- Otherwise save and set the flag
577 Expander_Flags
.Increment_Last
;
578 Expander_Flags
.Table
(Expander_Flags
.Last
) := Expander_Active
;
579 Expander_Active
:= Status
;
580 end Expander_Mode_Save_And_Set
;