1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2019, 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 Checks
; use Checks
;
28 with Einfo
; use Einfo
;
29 with Exp_Ch3
; use Exp_Ch3
;
31 with Exp_Imgv
; use Exp_Imgv
;
32 with Exp_Tss
; use Exp_Tss
;
33 with Exp_Util
; use Exp_Util
;
34 with Freeze
; use Freeze
;
35 with Namet
; use Namet
;
36 with Nlists
; use Nlists
;
37 with Nmake
; use Nmake
;
39 with Restrict
; use Restrict
;
40 with Rident
; use Rident
;
41 with Rtsfind
; use Rtsfind
;
43 with Sem_Aux
; use Sem_Aux
;
44 with Sem_Ch7
; use Sem_Ch7
;
45 with Sem_Ch8
; use Sem_Ch8
;
46 with Sem_Eval
; use Sem_Eval
;
47 with Sem_Util
; use Sem_Util
;
48 with Sinfo
; use Sinfo
;
49 with Snames
; use Snames
;
50 with Tbuild
; use Tbuild
;
51 with Uintp
; use Uintp
;
52 with Validsw
; use Validsw
;
54 package body Exp_Ch13
is
56 ------------------------------------------
57 -- Expand_N_Attribute_Definition_Clause --
58 ------------------------------------------
60 -- Expansion action depends on attribute involved
62 procedure Expand_N_Attribute_Definition_Clause
(N
: Node_Id
) is
63 Loc
: constant Source_Ptr
:= Sloc
(N
);
64 Exp
: constant Node_Id
:= Expression
(N
);
69 Ent
:= Entity
(Name
(N
));
72 Ent
:= Underlying_Type
(Ent
);
75 case Get_Attribute_Id
(Chars
(N
)) is
81 when Attribute_Address
=>
83 -- If there is an initialization which did not come from the
84 -- source program, then it is an artifact of our expansion, and we
85 -- suppress it. The case we are most concerned about here is the
86 -- initialization of a packed array to all false, which seems
87 -- inappropriate for variable to which an address clause is
88 -- applied. The expression may itself have been rewritten if the
89 -- type is packed array, so we need to examine whether the
90 -- original node is in the source. An exception though is the case
91 -- of an access variable which is default initialized to null, and
92 -- such initialization is retained.
94 -- Furthermore, if the initialization is the equivalent aggregate
95 -- of the type initialization procedure, it replaces an implicit
96 -- call to the init proc, and must be respected. Note that for
97 -- packed types we do not build equivalent aggregates.
99 -- Also, if Init_Or_Norm_Scalars applies, then we need to retain
100 -- any default initialization for objects of scalar types and
101 -- types with scalar components. Normally a composite type will
102 -- have an init_proc in the presence of Init_Or_Norm_Scalars,
103 -- so when that flag is set we have just have to do a test for
104 -- scalar and string types (the predefined string types such as
105 -- String and Wide_String don't have an init_proc).
108 Decl
: constant Node_Id
:= Declaration_Node
(Ent
);
109 Typ
: constant Entity_Id
:= Etype
(Ent
);
112 if Nkind
(Decl
) = N_Object_Declaration
113 and then Present
(Expression
(Decl
))
114 and then Nkind
(Expression
(Decl
)) /= N_Null
116 not Comes_From_Source
(Original_Node
(Expression
(Decl
)))
118 if Present
(Base_Init_Proc
(Typ
))
120 Present
(Static_Initialization
(Base_Init_Proc
(Typ
)))
124 elsif Init_Or_Norm_Scalars
125 and then (Is_Scalar_Type
(Typ
)
126 or else Is_String_Type
(Typ
))
131 Set_Expression
(Decl
, Empty
);
134 -- An object declaration to which an address clause applies
135 -- has a delayed freeze, but the address expression itself
136 -- must be elaborated at the point it appears. If the object
137 -- is controlled, additional checks apply elsewhere.
138 -- If the attribute comes from an aspect specification it
139 -- is being elaborated at the freeze point and side effects
140 -- need not be removed (and shouldn't, if the expression
141 -- depends on other entities that have delayed freeze).
142 -- This is another consequence of the delayed analysis of
143 -- aspects, and a real semantic difference.
145 elsif Nkind
(Decl
) = N_Object_Declaration
146 and then not Needs_Constant_Address
(Decl
, Typ
)
147 and then not From_Aspect_Specification
(N
)
149 Remove_Side_Effects
(Exp
);
157 when Attribute_Alignment
=>
159 -- As required by Gigi, we guarantee that the operand is an
160 -- integer literal (this simplifies things in Gigi).
162 if Nkind
(Exp
) /= N_Integer_Literal
then
163 Rewrite
(Exp
, Make_Integer_Literal
(Loc
, Expr_Value
(Exp
)));
166 -- A complex case arises if the alignment clause applies to an
167 -- unconstrained object initialized with a function call. The
168 -- result of the call is placed on the secondary stack, and the
169 -- declaration is rewritten as a renaming of a dereference, which
170 -- fails expansion. We must introduce a temporary and assign its
171 -- value to the existing entity.
173 if Nkind
(Parent
(Ent
)) = N_Object_Renaming_Declaration
174 and then not Is_Entity_Name
(Renamed_Object
(Ent
))
177 Decl
: constant Node_Id
:= Parent
(Ent
);
178 Loc
: constant Source_Ptr
:= Sloc
(N
);
179 Temp
: constant Entity_Id
:= Make_Temporary
(Loc
, 'T');
184 -- Replace entity with temporary and reanalyze
186 Set_Defining_Identifier
(Decl
, Temp
);
187 Set_Analyzed
(Decl
, False);
190 -- Introduce new declaration for entity but do not reanalyze
191 -- because entity is already in scope. Type and expression
192 -- are already resolved.
195 Make_Object_Declaration
(Loc
,
196 Defining_Identifier
=> Ent
,
198 New_Occurrence_Of
(Etype
(Ent
), Loc
),
199 Expression
=> New_Occurrence_Of
(Temp
, Loc
));
201 Set_Renamed_Object
(Ent
, Empty
);
202 Insert_After
(Decl
, New_Decl
);
211 when Attribute_Storage_Size
=>
213 -- If the type is a task type, then assign the value of the
214 -- storage size to the Size variable associated with the task.
215 -- Insert the assignment right after the declaration of the Size
220 -- task_typeZ := expression
222 if Ekind
(Ent
) = E_Task_Type
then
228 Make_Assignment_Statement
(Loc
,
230 New_Occurrence_Of
(Storage_Size_Variable
(Ent
), Loc
),
232 Convert_To
(RTE
(RE_Size_Type
), Expression
(N
)));
234 -- If the clause is not generated by an aspect, insert
235 -- the assignment here. Freezing rules ensure that this
236 -- is safe, or clause will have been rejected already.
238 if Is_List_Member
(N
) then
239 Insert_After
(N
, Assign
);
241 -- Otherwise, insert assignment after task declaration.
245 (Parent
(Storage_Size_Variable
(Entity
(N
))), Assign
);
251 -- For Storage_Size for an access type, create a variable to hold
252 -- the value of the specified size with name typeV and expand an
253 -- assignment statement to initialize this value.
255 elsif Is_Access_Type
(Ent
) then
257 -- We don't need the variable for a storage size of zero
259 if not No_Pool_Assigned
(Ent
) then
261 Make_Defining_Identifier
(Loc
,
262 Chars
=> New_External_Name
(Chars
(Ent
), 'V'));
264 -- Insert the declaration of the object
267 Make_Object_Declaration
(Loc
,
268 Defining_Identifier
=> V
,
270 New_Occurrence_Of
(RTE
(RE_Storage_Offset
), Loc
),
272 Convert_To
(RTE
(RE_Storage_Offset
), Expression
(N
))));
274 Set_Storage_Size_Variable
(Ent
, Entity_Id
(V
));
278 -- Other attributes require no expansion
283 end Expand_N_Attribute_Definition_Clause
;
285 -----------------------------
286 -- Expand_N_Free_Statement --
287 -----------------------------
289 procedure Expand_N_Free_Statement
(N
: Node_Id
) is
290 Expr
: constant Node_Id
:= Expression
(N
);
294 -- Certain run-time configurations and targets do not provide support
295 -- for controlled types.
297 if Restriction_Active
(No_Finalization
) then
301 -- Use the base type to perform the check for finalization master
305 if Ekind
(Typ
) = E_Access_Subtype
then
309 -- Handle private access types
311 if Is_Private_Type
(Typ
)
312 and then Present
(Full_View
(Typ
))
314 Typ
:= Full_View
(Typ
);
317 -- Do not create a custom Deallocate when freeing an object with
318 -- suppressed finalization. In such cases the object is never attached
319 -- to a master, so it does not need to be detached. Use a regular free
320 -- statement instead.
322 if No
(Finalization_Master
(Typ
)) then
326 -- Use a temporary to store the result of a complex expression. Perform
327 -- the following transformation:
329 -- Free (Complex_Expression);
331 -- Temp : constant Type_Of_Expression := Complex_Expression;
334 if Nkind
(Expr
) /= N_Identifier
then
336 Expr_Typ
: constant Entity_Id
:= Etype
(Expr
);
337 Loc
: constant Source_Ptr
:= Sloc
(N
);
342 Temp_Id
:= Make_Temporary
(Loc
, 'T');
344 Make_Object_Declaration
(Loc
,
345 Defining_Identifier
=> Temp_Id
,
346 Object_Definition
=> New_Occurrence_Of
(Expr_Typ
, Loc
),
347 Expression
=> Relocate_Node
(Expr
)));
349 New_Expr
:= New_Occurrence_Of
(Temp_Id
, Loc
);
350 Set_Etype
(New_Expr
, Expr_Typ
);
352 Set_Expression
(N
, New_Expr
);
356 -- Create a custom Deallocate for a controlled object. This routine
357 -- ensures that the hidden list header will be deallocated along with
358 -- the actual object.
360 Build_Allocate_Deallocate_Proc
(N
, Is_Allocate
=> False);
361 end Expand_N_Free_Statement
;
363 ----------------------------
364 -- Expand_N_Freeze_Entity --
365 ----------------------------
367 procedure Expand_N_Freeze_Entity
(N
: Node_Id
) is
368 E
: constant Entity_Id
:= Entity
(N
);
371 Delete
: Boolean := False;
373 In_Other_Scope
: Boolean;
374 In_Outer_Scope
: Boolean;
377 -- If there are delayed aspect specifications, we insert them just
378 -- before the freeze node. They are already analyzed so we don't need
379 -- to reanalyze them (they were analyzed before the type was frozen),
380 -- but we want them in the tree for the back end, and so that the
381 -- listing from sprint is clearer on where these occur logically.
383 if Has_Delayed_Aspects
(E
) then
389 -- Look for aspect specs for this entity
391 Ritem
:= First_Rep_Item
(E
);
392 while Present
(Ritem
) loop
393 if Nkind
(Ritem
) = N_Aspect_Specification
394 and then Entity
(Ritem
) = E
396 Aitem
:= Aspect_Rep_Item
(Ritem
);
398 -- Skip this for aspects (e.g. Current_Value) for which
399 -- there is no corresponding pragma or attribute.
403 -- Also skip if we have a null statement rather than a
404 -- delayed aspect (this happens when we are ignoring rep
405 -- items from use of the -gnatI switch).
407 and then Nkind
(Aitem
) /= N_Null_Statement
409 pragma Assert
(Is_Delayed_Aspect
(Aitem
));
410 Insert_Before
(N
, Aitem
);
414 Next_Rep_Item
(Ritem
);
419 -- Processing for objects
421 if Is_Object
(E
) then
422 if Present
(Address_Clause
(E
)) then
423 Apply_Address_Clause_Check
(E
, N
);
426 -- Analyze actions in freeze node, if any
428 if Present
(Actions
(N
)) then
432 Act
:= First
(Actions
(N
));
433 while Present
(Act
) loop
440 -- If initialization statements have been captured in a compound
441 -- statement, insert them back into the tree now.
443 Explode_Initialization_Compound_Statement
(E
);
446 -- Only other items requiring any front end action are types and
449 elsif not Is_Type
(E
) and then not Is_Subprogram
(E
) then
453 -- Here E is a type or a subprogram
455 E_Scope
:= Scope
(E
);
457 -- This is an error protection against previous errors
460 Check_Error_Detected
;
464 -- The entity may be a subtype declared for a constrained record
465 -- component, in which case the relevant scope is the scope of
466 -- the record. This happens for class-wide subtypes created for
467 -- a constrained type extension with inherited discriminants.
470 and then Ekind
(E_Scope
) not in Concurrent_Kind
472 E_Scope
:= Scope
(E_Scope
);
474 -- The entity may be a subtype declared for an iterator
476 elsif Ekind
(E_Scope
) = E_Loop
then
477 E_Scope
:= Scope
(E_Scope
);
480 -- Remember that we are processing a freezing entity and its freezing
481 -- nodes. This flag (non-zero = set) is used to avoid the need of
482 -- climbing through the tree while processing the freezing actions (ie.
483 -- to avoid generating spurious warnings or to avoid killing constant
484 -- indications while processing the code associated with freezing
485 -- actions). We use a counter to deal with nesting.
487 Inside_Freezing_Actions
:= Inside_Freezing_Actions
+ 1;
489 -- If we are freezing entities defined in protected types, they belong
490 -- in the enclosing scope, given that the original type has been
491 -- expanded away. The same is true for entities in task types, in
492 -- particular the parameter records of entries (Entities in bodies are
493 -- all frozen within the body). If we are in the task body, this is a
494 -- proper scope. If we are within a subprogram body, the proper scope
495 -- is the corresponding spec. This may happen for itypes generated in
496 -- the bodies of protected operations.
498 if Ekind
(E_Scope
) = E_Protected_Type
499 or else (Ekind
(E_Scope
) = E_Task_Type
500 and then not Has_Completion
(E_Scope
))
502 E_Scope
:= Scope
(E_Scope
);
504 elsif Ekind
(E_Scope
) = E_Subprogram_Body
then
505 E_Scope
:= Corresponding_Spec
(Unit_Declaration_Node
(E_Scope
));
508 -- If the scope of the entity is in open scopes, it is the current one
509 -- or an enclosing one, including a loop, a block, or a subprogram.
511 if In_Open_Scopes
(E_Scope
) then
512 In_Other_Scope
:= False;
513 In_Outer_Scope
:= E_Scope
/= Current_Scope
;
515 -- Otherwise it is a local package or a different compilation unit
518 In_Other_Scope
:= True;
519 In_Outer_Scope
:= False;
522 -- If the entity being frozen is defined in a scope that is not
523 -- currently on the scope stack, we must establish the proper
524 -- visibility before freezing the entity and related subprograms.
526 if In_Other_Scope
then
527 Push_Scope
(E_Scope
);
529 -- Finalizers are little odd in terms of freezing. The spec of the
530 -- procedure appears in the declarations while the body appears in
531 -- the statement part of a single construct. Since the finalizer must
532 -- be called by the At_End handler of the construct, the spec is
533 -- manually frozen right after its declaration. The only side effect
534 -- of this action appears in contexts where the construct is not in
535 -- its final resting place. These contexts are:
537 -- * Entry bodies - The declarations and statements are moved to
538 -- the procedure equivalen of the entry.
539 -- * Protected subprograms - The declarations and statements are
540 -- moved to the non-protected version of the subprogram.
541 -- * Task bodies - The declarations and statements are moved to the
542 -- task body procedure.
543 -- * Blocks that will be rewritten as subprograms when unnesting
546 -- Visible declarations do not need to be installed in these three
547 -- cases since it does not make semantic sense to do so. All entities
548 -- referenced by a finalizer are visible and already resolved, plus
549 -- the enclosing scope may not have visible declarations at all.
551 if Ekind
(E
) = E_Procedure
552 and then Is_Finalizer
(E
)
555 or else (Is_Subprogram
(E_Scope
)
556 and then Is_Protected_Type
(Scope
(E_Scope
)))
557 or else Is_Task_Type
(E_Scope
)
558 or else Ekind
(E_Scope
) = E_Block
)
562 Install_Visible_Declarations
(E_Scope
);
565 if Is_Package_Or_Generic_Package
(E_Scope
) or else
566 Is_Protected_Type
(E_Scope
) or else
567 Is_Task_Type
(E_Scope
)
569 Install_Private_Declarations
(E_Scope
);
572 -- If the entity is in an outer scope, then that scope needs to
573 -- temporarily become the current scope so that operations created
574 -- during type freezing will be declared in the right scope and
575 -- can properly override any corresponding inherited operations.
577 elsif In_Outer_Scope
then
578 Push_Scope
(E_Scope
);
581 -- If type, freeze the type
584 Delete
:= Freeze_Type
(N
);
586 -- And for enumeration type, build the enumeration tables
588 if Is_Enumeration_Type
(E
) then
589 Build_Enumeration_Image_Tables
(E
, N
);
592 -- If subprogram, freeze the subprogram
594 elsif Is_Subprogram
(E
) then
595 Exp_Ch6
.Freeze_Subprogram
(N
);
597 -- Ada 2005 (AI-251): Remove the freezing node associated with the
598 -- entities internally used by the frontend to register primitives
599 -- covering abstract interfaces. The call to Freeze_Subprogram has
600 -- already expanded the code that fills the corresponding entry in
601 -- its secondary dispatch table and therefore the code generator
602 -- has nothing else to do with this freezing node.
604 Delete
:= Present
(Interface_Alias
(E
));
607 -- Analyze actions generated by freezing. The init_proc contains source
608 -- expressions that may raise Constraint_Error, and the assignment
609 -- procedure for complex types needs checks on individual component
610 -- assignments, but all other freezing actions should be compiled with
613 if Present
(Actions
(N
)) then
614 Decl
:= First
(Actions
(N
));
615 while Present
(Decl
) loop
616 if Nkind
(Decl
) = N_Subprogram_Body
617 and then (Is_Init_Proc
(Defining_Entity
(Decl
))
619 Chars
(Defining_Entity
(Decl
)) = Name_uAssign
)
623 -- A subprogram body created for a renaming_as_body completes
624 -- a previous declaration, which may be in a different scope.
625 -- Establish the proper scope before analysis.
627 elsif Nkind
(Decl
) = N_Subprogram_Body
628 and then Present
(Corresponding_Spec
(Decl
))
629 and then Scope
(Corresponding_Spec
(Decl
)) /= Current_Scope
631 Push_Scope
(Scope
(Corresponding_Spec
(Decl
)));
632 Analyze
(Decl
, Suppress
=> All_Checks
);
635 -- We treat generated equality specially, if validity checks are
636 -- enabled, in order to detect components default-initialized
637 -- with invalid values.
639 elsif Nkind
(Decl
) = N_Subprogram_Body
640 and then Chars
(Defining_Entity
(Decl
)) = Name_Op_Eq
641 and then Validity_Checks_On
642 and then Initialize_Scalars
645 Save_Force
: constant Boolean := Force_Validity_Checks
;
647 Force_Validity_Checks
:= True;
649 Force_Validity_Checks
:= Save_Force
;
652 -- All other freezing actions
655 Analyze
(Decl
, Suppress
=> All_Checks
);
662 -- If we are to delete this N_Freeze_Entity, do so by rewriting so that
663 -- a loop on all nodes being inserted will work propertly.
666 Rewrite
(N
, Make_Null_Statement
(Sloc
(N
)));
669 -- Pop scope if we installed one for the analysis
671 if In_Other_Scope
then
672 if Ekind
(Current_Scope
) = E_Package
then
673 End_Package_Scope
(E_Scope
);
678 elsif In_Outer_Scope
then
682 -- Restore previous value of the nesting-level counter that records
683 -- whether we are inside a (possibly nested) call to this procedure.
685 Inside_Freezing_Actions
:= Inside_Freezing_Actions
- 1;
686 end Expand_N_Freeze_Entity
;
688 -------------------------------------------
689 -- Expand_N_Record_Representation_Clause --
690 -------------------------------------------
692 -- The only expansion required is for the case of a mod clause present,
693 -- which is removed, and translated into an alignment representation
694 -- clause inserted immediately after the record rep clause with any
695 -- initial pragmas inserted at the start of the component clause list.
697 procedure Expand_N_Record_Representation_Clause
(N
: Node_Id
) is
698 Loc
: constant Source_Ptr
:= Sloc
(N
);
699 Rectype
: constant Entity_Id
:= Entity
(Identifier
(N
));
706 if Present
(Mod_Clause
(N
)) and then not Ignore_Rep_Clauses
then
707 Mod_Val
:= Expr_Value
(Expression
(Mod_Clause
(N
)));
708 Citems
:= Pragmas_Before
(Mod_Clause
(N
));
710 if Present
(Citems
) then
711 Append_List_To
(Citems
, Component_Clauses
(N
));
712 Set_Component_Clauses
(N
, Citems
);
716 Make_Attribute_Definition_Clause
(Loc
,
717 Name
=> New_Occurrence_Of
(Base_Type
(Rectype
), Loc
),
718 Chars
=> Name_Alignment
,
719 Expression
=> Make_Integer_Literal
(Loc
, Mod_Val
));
721 Set_From_At_Mod
(AtM_Nod
);
722 Insert_After
(N
, AtM_Nod
);
723 Set_Mod_Clause
(N
, Empty
);
726 -- If the record representation clause has no components, then
727 -- completely remove it. Note that we also have to remove
728 -- ourself from the Rep Item list.
730 if Is_Empty_List
(Component_Clauses
(N
)) then
731 if First_Rep_Item
(Rectype
) = N
then
732 Set_First_Rep_Item
(Rectype
, Next_Rep_Item
(N
));
734 Repitem
:= First_Rep_Item
(Rectype
);
735 while Present
(Next_Rep_Item
(Repitem
)) loop
736 if Next_Rep_Item
(Repitem
) = N
then
737 Set_Next_Rep_Item
(Repitem
, Next_Rep_Item
(N
));
741 Next_Rep_Item
(Repitem
);
746 Make_Null_Statement
(Loc
));
748 end Expand_N_Record_Representation_Clause
;