| blob | cc5553e09ab9c4b175d5d538cf3ba1d29080ad19 |
1 ------------------------------------------------------------------------------
2 -- --
3 -- GNAT COMPILER COMPONENTS --
4 -- --
5 -- F R E E Z E --
6 -- --
7 -- B o d y --
8 -- --
9 -- Copyright (C) 1992-2014, 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 ------------------------------------------------------------------------------
72 -----------------------
73 -- Local Subprograms --
74 -----------------------
77 -- Typ is a type that is being frozen. If no size clause is given,
78 -- but a default Esize has been computed, then this default Esize is
79 -- adjusted up if necessary to be consistent with a given alignment,
80 -- but never to a value greater than Long_Long_Integer'Size. This
81 -- is used for all discrete types and for fixed-point types.
83 procedure Build_And_Analyze_Renamed_Body
87 -- Build body for a renaming declaration, insert in tree and analyze
90 -- Apply legality checks to address clauses for object declarations,
91 -- at the point the object is frozen. Also ensure any initialization is
92 -- performed only after the object has been frozen.
94 procedure Check_Component_Storage_Order
99 -- For an Encl_Type that has a Scalar_Storage_Order attribute definition
100 -- clause, verify that the component type has an explicit and compatible
101 -- attribute/aspect. For arrays, Comp is Empty; for records, it is the
102 -- entity of the component under consideration. For an Encl_Type that
103 -- does not have a Scalar_Storage_Order attribute definition clause,
104 -- verify that the component also does not have such a clause.
105 -- ADC is the attribute definition clause if present (or Empty). On return,
106 -- Comp_ADC_Present is set True if the component has a Scalar_Storage_Order
107 -- attribute definition clause.
110 -- When an expression function is frozen by a use of it, the expression
111 -- itself is frozen. Check that the expression does not include references
112 -- to deferred constants without completion. We report this at the freeze
113 -- point of the function, to provide a better error message.
114 --
115 -- In most cases the expression itself is frozen by the time the function
116 -- itself is frozen, because the formals will be frozen by then. However,
117 -- Attribute references to outer types are freeze points for those types;
118 -- this routine generates the required freeze nodes for them.
121 -- E is a base type. If E is tagged or has a component that is aliased
122 -- or tagged or contains something this is aliased or tagged, set
123 -- Strict_Alignment.
127 -- If E is a fixed-point or discrete type, then all the necessary work
128 -- to freeze it is completed except for possible setting of the flag
129 -- Is_Unsigned_Type, which is done by this procedure. The call has no
130 -- effect if the entity E is not a discrete or fixed-point type.
132 procedure Freeze_And_Append
136 -- Freezes Ent using Freeze_Entity, and appends the resulting list of
137 -- nodes to Result, modifying Result from No_List if necessary. N has
138 -- the same usage as in Freeze_Entity.
141 -- Freeze enumeration type. The Esize field is set as processing
142 -- proceeds (i.e. set by default when the type is declared and then
143 -- adjusted by rep clauses. What this procedure does is to make sure
144 -- that if a foreign convention is specified, and no specific size
145 -- is given, then the size must be at least Integer'Size.
148 -- If an object is frozen which has Is_Statically_Allocated set, then
149 -- all referenced types must also be marked with this flag. This routine
150 -- is in charge of meeting this requirement for the object entity E.
153 -- Perform freezing actions for a subprogram (create extra formals,
154 -- and set proper default mechanism values). Note that this routine
155 -- is not called for internal subprograms, for which neither of these
156 -- actions is needed (or desirable, we do not want for example to have
157 -- these extra formals present in initialization procedures, where they
158 -- would serve no purpose). In this call E is either a subprogram or
159 -- a subprogram type (i.e. an access to a subprogram).
162 -- True if T is not private and has no private components, or has a full
163 -- view. Used to determine whether the designated type of an access type
164 -- should be frozen when the access type is frozen. This is done when an
165 -- allocator is frozen, or an expression that may involve attributes of
166 -- the designated type. Otherwise freezing the access type does not freeze
167 -- the designated type.
169 procedure Process_Default_Expressions
172 -- This procedure is called for each subprogram to complete processing of
173 -- default expressions at the point where all types are known to be frozen.
174 -- The expressions must be analyzed in full, to make sure that all error
175 -- processing is done (they have only been pre-analyzed). If the expression
176 -- is not an entity or literal, its analysis may generate code which must
177 -- not be executed. In that case we build a function body to hold that
178 -- code. This wrapper function serves no other purpose (it used to be
179 -- called to evaluate the default, but now the default is inlined at each
180 -- point of call).
183 -- Typ is a record or array type that is being frozen. This routine sets
184 -- the default component alignment from the scope stack values if the
185 -- alignment is otherwise not specified.
188 -- As each entity is frozen, this routine is called to deal with the
189 -- setting of Debug_Info_Needed for the entity. This flag is set if
190 -- the entity comes from source, or if we are in Debug_Generated_Code
191 -- mode or if the -gnatdV debug flag is set. However, it never sets
192 -- the flag if Debug_Info_Off is set. This procedure also ensures that
193 -- subsidiary entities have the flag set as required.
196 -- T is a record or array type that is being frozen. If it is a base type,
197 -- and if SSO_Set_Low/High_By_Default is set, then Reverse_Storage order
198 -- will be set appropriately. Note that an explicit occurrence of aspect
199 -- Scalar_Storage_Order or an explicit setting of this aspect with an
200 -- attribute definition clause occurs, then these two flags are reset in
201 -- any case, so call will have no effect.
204 -- T is a type of a component that we know to be an Itype. We don't want
205 -- this to have a Freeze_Node, so ensure it doesn't. Do the same for any
206 -- Full_View or Corresponding_Record_Type.
208 procedure Warn_Overlay
212 -- Expr is the expression for an address clause for entity Nam whose type
213 -- is Typ. If Typ has a default initialization, and there is no explicit
214 -- initialization in the source declaration, check whether the address
215 -- clause might cause overlaying of an entity, and emit a warning on the
216 -- side effect that the initialization will cause.
218 -------------------------------
219 -- Adjust_Esize_For_Alignment --
220 -------------------------------
225 begin
231 then
237 ------------------------------------
238 -- Build_And_Analyze_Renamed_Body --
239 ------------------------------------
241 procedure Build_And_Analyze_Renamed_Body
245 is
251 begin
252 -- If the renamed subprogram is intrinsic, there is no need for a
253 -- wrapper body: we set the alias that will be called and expanded which
254 -- completes the declaration. This transformation is only legal if the
255 -- renamed entity has already been elaborated.
257 -- Note that it is legal for a renaming_as_body to rename an intrinsic
258 -- subprogram, as long as the renaming occurs before the new entity
259 -- is frozen (RM 8.5.4 (5)).
263 then
265 else
271 and then
275 -- We can make the renaming entity intrinsic if the renamed function
276 -- has an interface name, or if it is one of the shift/rotate
277 -- operations known to the compiler.
279 and then
282 Name_Rotate_Right,
283 Name_Shift_Left,
284 Name_Shift_Right,
285 Name_Shift_Right_Arithmetic))
286 then
291 else
298 else
307 ------------------------
308 -- Build_Renamed_Body --
309 ------------------------
311 function Build_Renamed_Body
314 is
316 -- We use for the source location of the renamed body, the location of
317 -- the spec entity. It might seem more natural to use the location of
318 -- the renaming declaration itself, but that would be wrong, since then
319 -- the body we create would look as though it was created far too late,
320 -- and this could cause problems with elaboration order analysis,
321 -- particularly in connection with instantiations.
336 -- If the renamed entity is a primitive operation given in prefix form,
337 -- the prefix is the target object and it has to be added as the first
338 -- actual in the generated call.
340 begin
341 -- Determine the entity being renamed, which is the target of the call
342 -- statement. If the name is an explicit dereference, this is a renaming
343 -- of a subprogram type rather than a subprogram. The name itself is
344 -- fully analyzed.
355 else
362 else
368 -- If the renamed entity is a predefined operator, retain full name
369 -- to ensure its visibility.
373 then
375 else
379 else
382 and then
385 then
387 -- Retrieve the target object, to be added as a first actual
388 -- in the call.
393 else
397 -- Original name may have been overloaded, but is fully resolved now
402 -- For simple renamings, subsequent calls can be expanded directly as
403 -- calls to the renamed entity. The body must be generated in any case
404 -- for calls that may appear elsewhere. This is not done in the case
405 -- where the subprogram is an instantiation because the actual proper
406 -- body has not been built yet.
411 then
415 -- The body generated for this renaming is an internal artifact, and
416 -- does not constitute a freeze point for the called entity.
423 declare
427 begin
428 -- The controlling formal may be an access parameter, or the
429 -- actual may be an access value, so adjust accordingly.
433 then
434 Actuals := New_List
439 then
440 Actuals := New_List
444 else
452 else
463 -- If the renamed entity is an entry, inherit its profile. For other
464 -- renamings as bodies, both profiles must be subtype conformant, so it
465 -- is not necessary to replace the profile given in the declaration.
466 -- However, default values that are aggregates are rewritten when
467 -- partially analyzed, so we recover the original aggregate to insure
468 -- that subsequent conformity checking works. Similarly, if the default
469 -- expression was constant-folded, recover the original expression.
479 N_Access_Definition
480 then
488 then
499 -- If the renamed entity is a function, the generated body contains a
500 -- return statement. Otherwise, build a procedure call. If the entity is
501 -- an entry, subsequent analysis of the call will transform it into the
502 -- proper entry or protected operation call. If the renamed entity is
503 -- a character literal, return it directly.
509 then
510 Call_Node :=
512 Expression =>
518 Call_Node :=
523 Call_Node :=
527 else
528 Call_Node :=
534 -- Create entities for subprogram body and formals
547 Body_Node :=
551 Handled_Statement_Sequence =>
561 -- Link the body to the entity whose declaration it completes. If
562 -- the body is analyzed when the renamed entity is frozen, it may
563 -- be necessary to restore the proper scope (see package Exp_Ch13).
567 then
569 else
576 --------------------------
577 -- Check_Address_Clause --
578 --------------------------
589 begin
596 -- Has_Delayed_Freeze was set on E when the address clause was
597 -- analyzed, and must remain set because we want the address
598 -- clause to be elaborated only after any entity it references
599 -- has been elaborated.
602 -- If Rep_Clauses are to be ignored, remove address clause from
603 -- list attached to entity, because it may be illegal for gigi,
604 -- for example by breaking order of elaboration..
607 declare
610 begin
616 else
619 loop
629 -- And now remove the address clause
635 then
641 -- Capture initialization value at point of declaration,
642 -- and make explicit assignment legal, because object may
643 -- be a constant.
649 -- Move initialization to freeze actions (once the object has
650 -- been frozen, and the address clause alignment check has been
651 -- performed.
660 -- If the objet is tagged, check whether the tag must be
661 -- reassigned expliitly.
671 -----------------------------
672 -- Check_Compile_Time_Size --
673 -----------------------------
678 -- Sets the compile time known size (32 bits or less) in the Esize
679 -- field, of T checking for a size clause that was given which attempts
680 -- to give a smaller size, and also checking for an alignment clause.
683 -- Recursive function that does all the work
686 -- If T is a constrained subtype, its size is not known if any of its
687 -- discriminant constraints is not static and it is not a null record.
688 -- The test is conservative and doesn't check that the components are
689 -- in fact constrained by non-static discriminant values. Could be made
690 -- more precise ???
692 --------------------
693 -- Set_Small_Size --
694 --------------------
697 begin
701 -- Check for bad size clause given
706 Error_Msg_NE
711 -- Set size if not set already
718 ----------------
719 -- Size_Known --
720 ----------------
729 begin
733 -- Always True for scalar types. This is true even for generic formal
734 -- scalar types. We used to return False in the latter case, but the
735 -- size is known at compile time, even in the template, we just do
736 -- not know the exact size but that's not the point of this routine.
740 then
743 -- Array types
747 -- String literals always have known size, and we can set it
754 -- Unconstrained types never have known at compile time size
759 -- Don't do any recursion on type with error posted, since we may
760 -- have a malformed type that leads us into a loop.
765 -- Otherwise if component size unknown, then array size unknown
771 -- Check for all indexes static, and also compute possible size
772 -- (in case it is less than 32 and may be packable).
774 declare
778 begin
787 else
795 then
798 else
803 else
815 -- Access types always have known at compile time sizes
820 -- For non-generic private types, go to underlying type if present
825 then
826 -- Don't do any recursion on type with error posted, since we may
827 -- have a malformed type that leads us into a loop.
831 else
835 -- Record types
839 -- A class-wide type is never considered to have a known size
844 -- A subtype of a variant record must not have non-static
845 -- discriminated components.
849 then
852 -- Don't do any recursion on type with error posted, since we may
853 -- have a malformed type that leads us into a loop.
859 -- Now look at the components of the record
861 declare
862 -- The following two variables are used to keep track of the
863 -- size of packed records if we can tell the size of the packed
864 -- record in the front end. Packed_Size_Known is True if so far
865 -- we can figure out the size. It is initialized to True for a
866 -- packed record, unless the record has discriminants or atomic
867 -- components or independent components.
869 -- The reason we eliminate the discriminated case is that
870 -- we don't know the way the back end lays out discriminated
871 -- packed records. If Packed_Size_Known is True, then
872 -- Packed_Size is the size in bits so far.
881 -- Size in bits so far
883 begin
884 -- Test for variant part present
890 N_Record_Definition
892 and then
893 Present (Variant_Part
895 then
896 -- If variant part is present, and type is unconstrained,
897 -- then we must have defaulted discriminants, or a size
898 -- clause must be present for the type, or else the size
899 -- is definitely not known at compile time.
902 and then
905 then
910 -- Loop through components
916 -- We do not know the packed size if there is a component
917 -- clause present (we possibly could, but this would only
918 -- help in the case of a record with partial rep clauses.
919 -- That's because in the case of full rep clauses, the
920 -- size gets figured out anyway by a different circuit).
926 -- We do not know the packed size if we have a by reference
927 -- type, or an atomic type or an atomic component, or an
928 -- aliased component (because packing does not touch these).
934 then
938 -- We need to identify a component that is an array where
939 -- the index type is an enumeration type with non-standard
940 -- representation, and some bound of the type depends on a
941 -- discriminant.
943 -- This is because gigi computes the size by doing a
944 -- substitution of the appropriate discriminant value in
945 -- the size expression for the base type, and gigi is not
946 -- clever enough to evaluate the resulting expression (which
947 -- involves a call to rep_to_pos) at compile time.
949 -- It would be nice if gigi would either recognize that
950 -- this expression can be computed at compile time, or
951 -- alternatively figured out the size from the subtype
952 -- directly, where all the information is at hand ???
956 then
957 declare
965 begin
972 then
978 then
983 then
993 -- Clearly size of record is not known if the size of one of
994 -- the components is not known.
1000 -- Accumulate packed size if possible
1004 -- We can only deal with elementary types, since for
1005 -- non-elementary components, alignment enters into the
1006 -- picture, and we don't know enough to handle proper
1007 -- alignment in this context. Packed arrays count as
1008 -- elementary if the representation is a modular type.
1012 and then Present
1014 and then Is_Modular_Integer_Type
1016 then
1017 -- Packed size unknown if we have an atomic type
1018 -- or a by reference type, since the back end
1019 -- knows how these are layed out.
1023 then
1026 -- If RM_Size is known and static, then we can keep
1027 -- accumulating the packed size
1031 -- A little glitch, to be removed sometime ???
1032 -- gigi does not understand zero sizes yet.
1037 -- Normal case where we can keep accumulating the
1038 -- packed array size.
1040 else
1044 -- If we have a field whose RM_Size is not known then
1045 -- we can't figure out the packed size here.
1047 else
1051 -- If we have a non-elementary type we can't figure out
1052 -- the packed array size (alignment issues).
1054 else
1069 -- All other cases, size not known at compile time
1071 else
1076 -------------------------------------
1077 -- Static_Discriminated_Components --
1078 -------------------------------------
1080 function Static_Discriminated_Components
1082 is
1085 begin
1089 then
1103 -- Start of processing for Check_Compile_Time_Size
1105 begin
1109 -----------------------------------
1110 -- Check_Component_Storage_Order --
1111 -----------------------------------
1113 procedure Check_Component_Storage_Order
1118 is
1124 -- Set for the record case, True if Comp starts on a byte boundary
1125 -- (in which case it is allowed to have different storage order).
1128 -- Set True when the component is a nested composite, and it does not
1129 -- have the same scalar storage order as Encl_Type.
1133 begin
1134 -- Record case
1144 else
1145 -- If a component clause is present, check if the component starts
1146 -- on a storage element boundary. Otherwise conservatively assume
1147 -- it does so only in the case where the record is not packed.
1150 Comp_Byte_Aligned :=
1152 else
1159 -- Array case
1161 else
1168 -- Note: the Reverse_Storage_Order flag is set on the base type, but
1169 -- the attribute definition clause is attached to the first subtype.
1172 Comp_ADC := Get_Attribute_Definition_Clause
1174 Attribute_Scalar_Storage_Order);
1177 -- Case of record or array component: check storage order compatibility
1180 Comp_SSO_Differs :=
1182 /=
1185 -- Parent and extension must have same storage order
1189 Error_Msg_N
1194 -- If enclosing composite has explicit SSO then nested composite must
1195 -- have explicit SSO as well.
1201 -- If component and composite SSO differs, check that component
1202 -- falls on byte boundaries and isn't packed.
1206 -- Component SSO differs from enclosing composite:
1208 -- Reject if component is a packed array, as it may be represented
1209 -- as a scalar internally.
1212 Error_Msg_N
1216 -- Reject if composite is a packed array, as it may be rewritten
1217 -- into an array of scalars.
1223 -- Reject if not byte aligned
1226 and then not Comp_Byte_Aligned
1227 then
1228 Error_Msg_N
1234 -- Enclosing type has explicit SSO: non-composite component must not
1235 -- be aliased.
1238 Error_Msg_N
1244 -----------------------------
1245 -- Check_Debug_Info_Needed --
1246 -----------------------------
1249 begin
1254 or else Debug_Generated_Code
1255 or else Debug_Flag_VV
1257 then
1262 -------------------------------
1263 -- Check_Expression_Function --
1264 -------------------------------
1270 -- Function to search for deferred constant
1272 -------------------
1273 -- Find_Constant --
1274 -------------------
1277 begin
1278 -- When a constant is initialized with the result of a dispatching
1279 -- call, the constant declaration is rewritten as a renaming of the
1280 -- displaced function result. This scenario is not a premature use of
1281 -- a constant even though the Has_Completion flag is not set.
1288 N_Object_Declaration
1291 then
1292 Error_Msg_NE
1300 then
1310 -- Start of processing for Check_Expression_Function
1312 begin
1317 then
1322 ----------------------------
1323 -- Check_Strict_Alignment --
1324 ----------------------------
1329 begin
1347 then
1357 -------------------------
1358 -- Check_Unsigned_Type --
1359 -------------------------
1366 begin
1371 -- Do not attempt to analyze case where range was in error
1377 -- The situation that is non trivial is something like
1379 -- subtype x1 is integer range -10 .. +10;
1380 -- subtype x2 is x1 range 0 .. V1;
1381 -- subtype x3 is x2 range V2 .. V3;
1382 -- subtype x4 is x3 range V4 .. V5;
1384 -- where Vn are variables. Here the base type is signed, but we still
1385 -- know that x4 is unsigned because of the lower bound of x2.
1387 -- The only way to deal with this is to look up the ancestor chain
1390 loop
1404 else
1407 -- If no ancestor had a static lower bound, go to base type
1411 -- Note: the reason we still check for a compile time known
1412 -- value for the base type is that at least in the case of
1413 -- generic formals, we can have bounds that fail this test,
1414 -- and there may be other cases in error situations.
1426 then
1436 -------------------------
1437 -- Is_Atomic_Aggregate --
1438 -------------------------
1440 function Is_Atomic_Aggregate
1443 is
1449 begin
1452 -- Array may be qualified, so find outer context
1460 then
1462 New_N :=
1473 else
1478 -----------------------------------------------
1479 -- Explode_Initialization_Compound_Statement --
1480 -----------------------------------------------
1485 begin
1488 then
1491 -- Note that we rewrite Init_Stmts into a NULL statement, rather than
1492 -- just removing it, because Freeze_All may rely on this particular
1493 -- Node_Id still being present in the enclosing list to know where to
1494 -- stop freezing.
1502 ----------------
1503 -- Freeze_All --
1504 ----------------
1506 -- Note: the easy coding for this procedure would be to just build a
1507 -- single list of freeze nodes and then insert them and analyze them
1508 -- all at once. This won't work, because the analysis of earlier freeze
1509 -- nodes may recursively freeze types which would otherwise appear later
1510 -- on in the freeze list. So we must analyze and expand the freeze nodes
1511 -- as they are generated.
1518 -- This is the internal recursive routine that does freezing of entities
1519 -- (but NOT the analysis of default expressions, which should not be
1520 -- recursive, we don't want to analyze those till we are sure that ALL
1521 -- the types are frozen).
1523 --------------------
1524 -- Freeze_All_Ent --
1525 --------------------
1533 -- If freeze nodes are present, insert and analyze, and reset cursor
1534 -- for next insertion.
1536 -------------------
1537 -- Process_Flist --
1538 -------------------
1541 begin
1548 else
1554 -- Start or processing for Freeze_All_Ent
1556 begin
1560 -- If the entity is an inner package which is not a package
1561 -- renaming, then its entities must be frozen at this point. Note
1562 -- that such entities do NOT get frozen at the end of the nested
1563 -- package itself (only library packages freeze).
1565 -- Same is true for task declarations, where anonymous records
1566 -- created for entry parameters must be frozen.
1572 then
1583 then
1590 N_Single_Task_Declaration)
1591 then
1594 End_Scope;
1596 -- For a derived tagged type, we must ensure that all the
1597 -- primitive operations of the parent have been frozen, so that
1598 -- their addresses will be in the parent's dispatch table at the
1599 -- point it is inherited.
1605 then
1606 declare
1613 begin
1620 then
1622 Process_Flist;
1632 Process_Flist;
1634 -- If already frozen, and there are delayed aspects, this is where
1635 -- we do the visibility check for these aspects (see Sem_Ch13 spec
1636 -- for a description of how we handle aspect visibility).
1640 -- Retrieve the visibility to the discriminants in order to
1641 -- analyze properly the aspects.
1645 declare
1648 begin
1654 then
1665 -- If an incomplete type is still not frozen, this may be a
1666 -- premature freezing because of a body declaration that follows.
1667 -- Indicate where the freezing took place. Freezing will happen
1668 -- if the body comes from source, but not if it is internally
1669 -- generated, for example as the body of a type invariant.
1671 -- If the freezing is caused by the end of the current declarative
1672 -- part, it is a Taft Amendment type, and there is no error.
1676 then
1677 declare
1680 begin
1681 -- The presence of a body freezes all entities previously
1682 -- declared in the current list of declarations, but this
1683 -- does not apply if the body does not come from source.
1684 -- A type invariant is transformed into a subprogram body
1685 -- which is placed at the end of the private part of the
1686 -- current package, but this body does not freeze incomplete
1687 -- types that may be declared in this private part.
1690 N_Entry_Body,
1691 N_Package_Body,
1692 N_Protected_Body,
1693 N_Task_Body)
1695 and then
1698 then
1700 Error_Msg_NE
1711 -- Start of processing for Freeze_All
1713 begin
1716 -- Now that all types are frozen, we can deal with default expressions
1717 -- that require us to build a default expression functions. This is the
1718 -- point at which such functions are constructed (after all types that
1719 -- might be used in such expressions have been frozen).
1721 -- For subprograms that are renaming_as_body, we create the wrapper
1722 -- bodies as needed.
1724 -- We also add finalization chains to access types whose designated
1725 -- types are controlled. This is normally done when freezing the type,
1726 -- but this misses recursive type definitions where the later members
1727 -- of the recursion introduce controlled components.
1729 -- Loop through entities
1744 else
1750 and then
1752 = N_Subprogram_Renaming_Declaration
1753 then
1754 Build_And_Analyze_Renamed_Body
1761 N_Single_Task_Declaration)
1762 then
1763 declare
1766 begin
1771 then
1779 -- We add finalization masters to access types whose designated types
1780 -- require finalization. This is normally done when freezing the
1781 -- type, but this misses recursive type definitions where the later
1782 -- members of the recursion introduce controlled components (such as
1783 -- can happen when incomplete types are involved), as well cases
1784 -- where a component type is private and the controlled full type
1785 -- occurs after the access type is frozen. Cases that don't need a
1786 -- finalization master are generic formal types (the actual type will
1787 -- have it) and types derived from them, and types with Java and CIL
1788 -- conventions, since those are used for API bindings.
1789 -- (Are there any other cases that should be excluded here???)
1795 then
1803 -----------------------
1804 -- Freeze_And_Append --
1805 -----------------------
1807 procedure Freeze_And_Append
1811 is
1813 begin
1817 else
1823 -------------------
1824 -- Freeze_Before --
1825 -------------------
1830 begin
1840 -------------------
1841 -- Freeze_Entity --
1842 -------------------
1853 -- This could use a comment ???
1856 -- Used to detect attempt to freeze function declared in another unit
1859 -- List of freezing actions, left at No_List if none
1862 -- This flag gets set to true for a variable with default initialization
1865 -- N is a freezing action to be appended to the Result
1868 -- If Loc is a freeze_entity that appears after the last declaration
1869 -- in the scope, inhibit error messages on late completion.
1872 -- Check that an Access or Unchecked_Access attribute with a prefix
1873 -- which is the current instance type can only be applied when the type
1874 -- is limited.
1877 -- Give warning for modulus of 8, 16, 32, or 64 given as an explicit
1878 -- integer literal without an explicit corresponding size clause. The
1879 -- caller has checked that Utype is a modular integer type.
1882 -- Freeze array type, including freezing index and component types
1885 -- Create Freeze_Generic_Entity nodes for types declared in a generic
1886 -- package. Recurse on inner generic packages.
1889 -- Freeze formals and return type of subprogram. If some type in the
1890 -- profile is a limited view, freezing of the entity will take place
1891 -- elsewhere, and the function returns False. This routine will be
1892 -- modified if and when we can implement AI05-019 efficiently ???
1895 -- Freeze record type, including freezing component types, and freezing
1896 -- primitive operations if this is a tagged type.
1899 -- Determine whether an arbitrary entity is subject to Boolean aspect
1900 -- Import and its value is specified as True.
1903 -- Following AI05-151, a function can return a limited view of a type
1904 -- declared elsewhere. In that case the function cannot be frozen at
1905 -- the end of its enclosing package. If its first use is in a different
1906 -- unit, it cannot be frozen there, but if the call is legal the full
1907 -- view of the return type is available and the subprogram can now be
1908 -- frozen. However the freeze node cannot be inserted at the point of
1909 -- call, but rather must go in the package holding the function, so that
1910 -- the backend can process it in the proper context.
1913 -- If E is an entity for an imported subprogram with pre/post-conditions
1914 -- then this procedure will create a wrapper to ensure that proper run-
1915 -- time checking of the pre/postconditions. See body for details.
1917 -------------------
1918 -- Add_To_Result --
1919 -------------------
1922 begin
1925 else
1930 ----------------------------
1931 -- After_Last_Declaration --
1932 ----------------------------
1937 begin
1943 else
1947 else
1952 ----------------------------
1953 -- Check_Current_Instance --
1954 ----------------------------
1959 -- Determine whether Typ is compatible with the rules for aliased
1960 -- views of types as defined in RM 3.10 in the various dialects.
1963 -- Process routine to apply check to given node
1965 -----------------------------
1966 -- Is_Aliased_View_Of_Type --
1967 -----------------------------
1972 begin
1973 -- Common case
1977 then
1980 -- The following paragraphs describe what a legal aliased view of
1981 -- a type is in the various dialects of Ada.
1983 -- Ada 95
1985 -- The current instance of a limited type, and a formal parameter
1986 -- or generic formal object of a tagged type.
1988 -- Ada 95 limited type
1989 -- * Type with reserved word "limited"
1990 -- * A protected or task type
1991 -- * A composite type with limited component
1996 -- Ada 2005
1998 -- The current instance of a limited tagged type, a protected
1999 -- type, a task type, or a type that has the reserved word
2000 -- "limited" in its full definition ... a formal parameter or
2001 -- generic formal object of a tagged type.
2003 -- Ada 2005 limited type
2004 -- * Type with reserved word "limited", "synchronized", "task"
2005 -- or "protected"
2006 -- * A composite type with limited component
2007 -- * A derived type whose parent is a non-interface limited type
2010 return
2012 or else
2017 -- Ada 2012 and beyond
2019 -- The current instance of an immutably limited type ... a formal
2020 -- parameter or generic formal object of a tagged type.
2022 -- Ada 2012 limited type
2023 -- * Type with reserved word "limited", "synchronized", "task"
2024 -- or "protected"
2025 -- * A composite type with limited component
2026 -- * A derived type whose parent is a non-interface limited type
2027 -- * An incomplete view
2029 -- Ada 2012 immutably limited type
2030 -- * Explicitly limited record type
2031 -- * Record extension with "limited" present
2032 -- * Non-formal limited private type that is either tagged
2033 -- or has at least one access discriminant with a default
2034 -- expression
2035 -- * Task type, protected type or synchronized interface
2036 -- * Type derived from immutably limited type
2038 else
2039 return
2045 -------------
2046 -- Process --
2047 -------------
2050 begin
2054 Name_Unchecked_Access)
2058 then
2060 Error_Msg_N
2063 else
2064 Error_Msg_N
2071 else
2081 -- Local variables
2086 -- Start of processing for Check_Current_Instance
2088 begin
2094 ------------------------------
2095 -- Check_Suspicious_Modulus --
2096 ------------------------------
2101 begin
2107 declare
2110 begin
2112 declare
2116 begin
2118 declare
2122 begin
2123 -- First case, modulus and size are the same. This
2124 -- happens if you have something like mod 32, with
2125 -- an explicit size of 32, this is for sure a case
2126 -- where the warning is given, since it is seems
2127 -- very unlikely that someone would want e.g. a
2128 -- five bit type stored in 32 bits. It is much
2129 -- more likely they wanted a 32-bit type.
2134 -- Second case, the modulus is 32 or 64 and no
2135 -- size clause is present. This is a less clear
2136 -- case for giving the warning, but in the case
2137 -- of 32/64 (5-bit or 6-bit types) these seem rare
2138 -- enough that it is a likely error (and in any
2139 -- case using 2**5 or 2**6 in these cases seems
2140 -- clearer. We don't include 8 or 16 here, simply
2141 -- because in practice 3-bit and 4-bit types are
2142 -- more common and too many false positives if
2143 -- we warn in these cases.
2147 then
2150 -- No warning needed
2152 else
2156 -- If we fall through, give warning
2159 Error_Msg_N
2161 Modulus);
2170 -----------------------
2171 -- Freeze_Array_Type --
2172 -----------------------
2180 -- Set true if any of the index types is an enumeration type with a
2181 -- non-standard representation.
2183 begin
2192 then
2199 -- Processing that is done only for base types
2203 -- Deal with default setting of reverse storage order
2207 -- Propagate flags for component type
2211 then
2219 -- Warn for pragma Pack overriding foreign convention
2223 then
2224 declare
2229 begin
2233 Error_Msg_N
2236 Error_Msg_N
2243 -- If packing was requested or if the component size was
2244 -- set explicitly, then see if bit packing is required. This
2245 -- processing is only done for base types, since all of the
2246 -- representation aspects involved are type-related.
2248 -- This is not just an optimization, if we start processing the
2249 -- subtypes, they interfere with the settings on the base type
2250 -- (this is because Is_Packed has a slightly different meaning
2251 -- before and after freezing).
2253 declare
2257 begin
2261 then
2270 else
2273 -- We can set the component size if it is less than 16,
2274 -- rounding it up to the next storage unit size.
2280 else
2284 -- Set component size up to match alignment if it would
2285 -- otherwise be less than the alignment. This deals with
2286 -- cases of types whose alignment exceeds their size (the
2287 -- padded type cases).
2290 declare
2292 begin
2300 -- Case of component size that may result in packing
2303 declare
2309 Get_Attribute_Definition_Clause
2312 begin
2313 -- Warn if we have pack and component size so that the
2314 -- pack is ignored.
2316 -- Note: here we must check for the presence of a
2317 -- component size before checking for a Pack pragma to
2318 -- deal with the case where the array type is a derived
2319 -- type whose parent is currently private.
2323 and then Warn_On_Redundant_Constructs
2324 then
2326 Error_Msg_NE
2328 Error_Msg_N
2334 -- Set component size if not already set by a component
2335 -- size clause.
2341 -- Check for base type of 8, 16, 32 bits, where an
2342 -- unsigned subtype has a length one less than the
2343 -- base type (e.g. Natural subtype of Integer).
2345 -- In such cases, if a component size was not set
2346 -- explicitly, then generate a warning.
2352 then
2356 Error_Msg_N
2358 Pack_Pragma);
2359 Error_Msg_N
2361 Pack_Pragma);
2365 -- Actual packing is not needed for 8, 16, 32, 64. Also
2366 -- not needed for 24 if alignment is 1.
2373 then
2374 -- Here the array was requested to be packed, but
2375 -- the packing request had no effect, so Is_Packed
2376 -- is reset.
2378 -- Note: semantically this means that we lose track
2379 -- of the fact that a derived type inherited a pragma
2380 -- Pack that was non- effective, but that seems fine.
2382 -- We regard a Pack pragma as a request to set a
2383 -- representation characteristic, and this request
2384 -- may be ignored.
2391 then
2395 -- In all other cases, packing is indeed needed
2397 else
2406 -- Check for Atomic_Components or Aliased with unsuitable packing
2407 -- or explicit component size clause given.
2410 or else
2412 and then
2414 then
2418 -- Outputs error messages for incorrect CS clause or pragma
2419 -- Pack for aliased or atomic components (T is "aliased" or
2420 -- "atomic");
2422 -----------------
2423 -- Complain_CS --
2424 -----------------
2427 begin
2429 Clause :=
2430 Get_Attribute_Definition_Clause
2434 Error_Msg_N
2438 Error_Msg_N
2441 else
2442 Error_Msg_N
2447 else
2448 Error_Msg_N
2456 -- Start of processing for Alias_Atomic_Check
2458 begin
2459 -- If object size of component type isn't known, we cannot
2460 -- be sure so we defer to the back end.
2465 -- Case where component size has no effect. First check for
2466 -- object size of component type multiple of the storage
2467 -- unit size.
2471 -- OK in both packing case and component size case if RM
2472 -- size is known and static and same as the object size.
2474 and then
2478 -- Or if we have an explicit component size clause and
2479 -- the component size and object size are equal.
2481 or else
2484 then
2489 then
2494 then
2500 -- Warn for case of atomic type
2506 then
2507 Error_Msg_NE
2522 -- Check for scalar storage order
2524 declare
2526 begin
2527 Check_Component_Storage_Order
2530 ADC => Get_Attribute_Definition_Clause
2532 Attribute_Scalar_Storage_Order),
2536 -- Processing that is done only for subtypes
2538 else
2539 -- Acquire alignment from base type
2547 -- Specific checks for bit-packed arrays
2551 -- Check number of elements for bit packed arrays that come from
2552 -- source and have compile time known ranges. The bit-packed
2553 -- arrays circuitry does not support arrays with more than
2554 -- Integer'Last + 1 elements, and when this restriction is
2555 -- violated, causes incorrect data access.
2557 -- For the case where this is not compile time known, a run-time
2558 -- check should be generated???
2561 declare
2567 begin
2573 -- Never generate an error if any index is of a generic
2574 -- type. We will check this in instances.
2581 Ilen :=
2587 -- No attempt is made to check number of elements if not
2588 -- compile time known.
2601 then
2602 Error_Msg_N
2609 -- Check size
2612 declare
2616 begin
2617 -- It is not clear if it is possible to have no size clause
2618 -- at this stage, but it is not worth worrying about. Post
2619 -- error on the entity name in the size clause if present,
2620 -- else on the type entity itself.
2624 else
2631 -- If any of the index types was an enumeration type with a non-
2632 -- standard rep clause, then we indicate that the array type is
2633 -- always packed (even if it is not bit packed).
2642 -- If the array is packed, we must create the packed array type to be
2643 -- used to actually implement the type. This is only needed for real
2644 -- array types (not for string literal types, since they are present
2645 -- only for the front end).
2649 then
2653 -- Make sure that we have the necessary routines to implement the
2654 -- packing, and complain now if not. Note that we only test this
2655 -- for constrained array types.
2661 then
2662 declare
2666 begin
2669 then
2670 Error_Msg_CRT
2674 -- Cancel the packing
2684 -- Size information of packed array type is copied to the array
2685 -- type, since this is really the representation. But do not
2686 -- override explicit existing size values. If the ancestor subtype
2687 -- is constrained the Packed_Array_Impl_Type will be inherited
2688 -- from it, but the size may have been provided already, and
2689 -- must not be overridden either.
2692 and then
2695 then
2707 -- For non-packed arrays set the alignment of the array to the
2708 -- alignment of the component type if it is unknown. Skip this
2709 -- in atomic case (atomic arrays may need larger alignments).
2718 then
2723 -----------------------------
2724 -- Freeze_Generic_Entities --
2725 -----------------------------
2732 begin
2751 --------------------
2752 -- Freeze_Profile --
2753 --------------------
2760 begin
2761 -- Loop through formals
2767 -- AI05-0151: incomplete types can appear in a profile. By the
2768 -- time the entity is frozen, the full view must be available,
2769 -- unless it is a limited view.
2774 then
2786 then
2787 -- If the type of a formal is incomplete, subprogram is being
2788 -- frozen prematurely. Within an instance (but not within a
2789 -- wrapper package) this is an artifact of our need to regard
2790 -- the end of an instantiation as a freeze point. Otherwise it
2791 -- is a definite error.
2798 elsif not After_Last_Declaration
2799 and then not Freezing_Library_Level_Tagged_Type
2800 then
2802 Error_Msg
2807 -- Check suspicious parameter for C function. These tests apply
2808 -- only to exported/imported subprograms.
2810 if Warn_On_Export_Import
2813 or else
2820 then
2821 -- Qualify mention of formals with subprogram name
2825 -- Check suspicious use of fat C pointer
2829 then
2830 Error_Msg_N
2833 -- Check suspicious return of boolean
2840 then
2841 Error_Msg_N
2843 Error_Msg_N
2847 -- Check suspicious tagged type
2850 or else
2854 then
2855 Error_Msg_N
2859 -- Check wrong convention subprogram pointer
2863 then
2864 Error_Msg_N
2868 Error_Msg_NE
2873 -- Turn off name qualification after message output
2878 -- Check for unconstrained array in exported foreign convention
2879 -- case.
2885 and then Warn_On_Export_Import
2887 -- Exclude VM case, since both .NET and JVM can handle
2888 -- unconstrained arrays without a problem.
2891 then
2894 -- If this is an inherited operation, place the warning on
2895 -- the derived type declaration, rather than on the original
2896 -- subprogram.
2899 then
2905 else
2921 -- If the formal is an anonymous_access_to_subprogram
2922 -- freeze the subprogram type as well, to prevent
2923 -- scope anomalies in gigi, because there is no other
2924 -- clear point at which it could be frozen.
2928 then
2936 -- Case of function: similar checks on return type
2940 -- Check whether function is declared elsewhere.
2942 Late_Freezing :=
2947 -- Freeze return type
2951 -- AI05-0151: the return type may have been incomplete
2952 -- at the point of declaration. Replace it with the full
2953 -- view, unless the current type is a limited view. In
2954 -- that case the full view is in a different unit, and
2955 -- gigi finds the non-limited view after the other unit
2956 -- is elaborated.
2961 then
2965 -- If the return type is a limited view and the non-
2966 -- limited view is still incomplete, the function has
2967 -- to be frozen at a later time.
2971 and then
2973 then
2981 -- Check suspicious return type for C function
2983 if Warn_On_Export_Import
2985 or else
2988 then
2989 -- Check suspicious return of fat C pointer
2995 then
2999 -- Check suspicious return of boolean
3007 then
3008 declare
3011 begin
3012 Error_Msg_NE
3014 Error_Msg_NE
3019 -- Check suspicious return tagged type
3023 and then
3024 Is_Tagged_Type
3029 then
3033 -- Check return of wrong convention subprogram pointer
3039 then
3043 Error_Msg_NE
3049 -- Give warning for suspicious return of a result of an
3050 -- unconstrained array type in a foreign convention function.
3054 -- We are looking for a return of unconstrained array
3059 -- Exclude imported routines, the warning does not belong on
3060 -- the import, but rather on the routine definition.
3064 -- Exclude VM case, since both .NET and JVM can handle return
3065 -- of unconstrained arrays without a problem.
3069 -- Check that general warning is enabled, and that it is not
3070 -- suppressed for this particular case.
3072 and then Warn_On_Export_Import
3075 then
3084 ------------------------
3085 -- Freeze_Record_Type --
3086 ------------------------
3098 -- Set True if the record type scope Rec has been pushed on the scope
3099 -- stack. Needed for the analysis of delayed aspects specified to the
3100 -- components of Rec.
3103 -- Scalar_Storage_Order attribute definition clause for the record
3106 -- Set True if we find at least one component with no component
3107 -- clause (used to warn about useless Pack pragmas).
3110 -- Set True if we find at least one component with a component
3111 -- clause (used to warn about useless Bit_Order pragmas, and also
3112 -- to detect cases where Implicit_Packing may have an effect).
3115 -- Set True if we find at least one component which is aliased. This
3116 -- is used to prevent Implicit_Packing of the record, since packing
3117 -- cannot modify the size of alignment of an aliased component.
3120 -- Set True if we find at least one component whose type has a
3121 -- Scalar_Storage_Order attribute definition clause.
3124 -- Set False if we encounter a component of a non-scalar type
3128 -- Accumulates total RM_Size values and total Esize values of all
3129 -- scalar components. Used for processing of Implicit_Packing.
3132 -- If N is an allocator, possibly wrapped in one or more level of
3133 -- qualified expression(s), return the inner allocator node, else
3134 -- return Empty.
3137 -- If the component subtype is an access to a constrained subtype of
3138 -- an already frozen type, make the subtype frozen as well. It might
3139 -- otherwise be frozen in the wrong scope, and a freeze node on
3140 -- subtype has no effect. Similarly, if the component subtype is a
3141 -- regular (not protected) access to subprogram, set the anonymous
3142 -- subprogram type to frozen as well, to prevent an out-of-scope
3143 -- freeze node at some eventual point of call. Protected operations
3144 -- are handled elsewhere.
3147 -- Make sure that all types mentioned in Discrete_Choices of the
3148 -- variants referenceed by the Variant_Part VP are frozen. This is
3149 -- a recursive routine to deal with nested variants.
3151 ---------------------
3152 -- Check_Allocator --
3153 ---------------------
3157 begin
3159 loop
3164 else
3170 -----------------
3171 -- Check_Itype --
3172 -----------------
3177 begin
3180 then
3183 -- In addition, add an Itype_Reference to ensure that the
3184 -- access subtype is elaborated early enough. This cannot be
3185 -- done if the subtype may depend on discriminants.
3190 then
3198 then
3203 ------------------------------------
3204 -- Freeze_Choices_In_Variant_Part --
3205 ------------------------------------
3214 begin
3215 -- Loop through variants
3220 -- Loop through choices, checking that all types are frozen
3226 then
3233 -- Check for nested variant part to process
3247 -- Start of processing for Freeze_Record_Type
3249 begin
3250 -- Deal with delayed aspect specifications for components. The
3251 -- analysis of the aspect is required to be delayed to the freeze
3252 -- point, thus we analyze the pragma or attribute definition
3253 -- clause in the tree at this point. We also analyze the aspect
3254 -- specification node at the freeze point when the aspect doesn't
3255 -- correspond to pragma/attribute definition clause.
3261 then
3266 -- The visibility to the discriminants must be restored in
3267 -- order to properly analyze the aspects.
3280 -- Pop the scope if Rec scope has been pushed on the scope stack
3281 -- during the delayed aspect analysis process.
3288 Pop_Scope;
3291 -- Freeze components and embedded subtypes
3300 -- Handle the component and discriminant case
3303 declare
3306 begin
3307 -- Freezing a record type freezes the type of each of its
3308 -- components. However, if the type of the component is
3309 -- part of this record, we do not want or need a separate
3310 -- Freeze_Node. Note that Is_Itype is wrong because that's
3311 -- also set in private type cases. We also can't check for
3312 -- the Scope being exactly Rec because of private types and
3313 -- record extensions.
3318 then
3324 -- Warn for pragma Pack overriding foreign convention
3329 -- Don't warn for aliased components, since override
3330 -- cannot happen in that case.
3333 then
3334 declare
3339 begin
3343 Error_Msg_N
3345 PP);
3347 Error_Msg_NE
3354 -- Check for error of component clause given for variable
3355 -- sized type. We have to delay this test till this point,
3356 -- since the component type has to be frozen for us to know
3357 -- if it is variable length.
3362 -- We omit this test in a generic context, it will be
3363 -- applied at instantiation time.
3368 -- Also omit this test in CodePeer mode, since we do not
3369 -- have sufficient info on size and rep clauses.
3374 -- Omit check if component has a generic type. This can
3375 -- happen in an instantiation within a generic in ASIS
3376 -- mode, where we force freeze actions without full
3377 -- expansion.
3382 -- Do the check
3384 elsif not
3385 Size_Known_At_Compile_Time
3387 then
3388 Error_Msg_N
3393 else
3397 -- Case of component requires byte alignment
3401 -- Set the enclosing record to also require byte align
3405 -- Check for component clause that is inconsistent with
3406 -- the required byte boundary alignment.
3411 then
3412 Error_Msg_N
3420 -- Gather data for possible Implicit_Packing later. Note that at
3421 -- this stage we might be dealing with a real component, or with
3422 -- an implicit subtype declaration.
3426 else
3427 Scalar_Component_Total_RM_Size :=
3429 Scalar_Component_Total_Esize :=
3433 -- If the component is an Itype with Delayed_Freeze and is either
3434 -- a record or array subtype and its base type has not yet been
3435 -- frozen, we must remove this from the entity list of this record
3436 -- and put it on the entity list of the scope of its base type.
3437 -- Note that we know that this is not the type of a component
3438 -- since we cleared Has_Delayed_Freeze for it in the previous
3439 -- loop. Thus this must be the Designated_Type of an access type,
3440 -- which is the type of a component.
3448 then
3449 declare
3453 begin
3454 -- We have a difficult case to handle here. Suppose Rec is
3455 -- subtype being defined in a subprogram that's created as
3456 -- part of the freezing of Rec'Base. In that case, we know
3457 -- that Comp'Base must have already been frozen by the time
3458 -- we get to elaborate this because Gigi doesn't elaborate
3459 -- any bodies until it has elaborated all of the declarative
3460 -- part. But Is_Frozen will not be set at this point because
3461 -- we are processing code in lexical order.
3463 -- We detect this case by going up the Scope chain of Rec
3464 -- and seeing if we have a subprogram scope before reaching
3465 -- the top of the scope chain or that of Comp'Base. If we
3466 -- do, then mark that Comp'Base will actually be frozen. If
3467 -- so, we merely undelay it.
3484 else
3487 else
3491 -- Insert in entity list of scope of base type (which
3492 -- must be an enclosing scope, because still unfrozen).
3498 -- If the component is an access type with an allocator as default
3499 -- value, the designated type will be frozen by the corresponding
3500 -- expression in init_proc. In order to place the freeze node for
3501 -- the designated type before that for the current record type,
3502 -- freeze it now.
3504 -- Same process if the component is an array of access types,
3505 -- initialized with an aggregate. If the designated type is
3506 -- private, it cannot contain allocators, and it is premature
3507 -- to freeze the type, so we check for this as well.
3512 then
3513 declare
3517 begin
3520 -- If component is pointer to a class-wide type, freeze
3521 -- the specific type in the expression being allocated.
3522 -- The expression may be a subtype indication, in which
3523 -- case freeze the subtype mark.
3525 if Is_Class_Wide_Type
3527 then
3529 Freeze_And_Append
3533 then
3534 Freeze_And_Append
3542 else
3543 Freeze_And_Append
3551 then
3554 -- Freeze the designated type when initializing a component with
3555 -- an aggregate in case the aggregate contains allocators.
3557 -- type T is ...;
3558 -- type T_Ptr is access all T;
3559 -- type T_Array is array ... of T_Ptr;
3561 -- type Rec is record
3562 -- Comp : T_Array := (others => ...);
3563 -- end record;
3567 then
3568 declare
3571 Designated_Type
3574 begin
3575 -- The only case when this sort of freezing is not done is
3576 -- when the designated type is class-wide and the root type
3577 -- is the record owning the component. This scenario results
3578 -- in a circularity because the class-wide type requires
3579 -- primitives that have not been created yet as the root
3580 -- type is in the process of being frozen.
3582 -- type Rec is tagged;
3583 -- type Rec_Ptr is access all Rec'Class;
3584 -- type Rec_Array is array ... of Rec_Ptr;
3586 -- type Rec is record
3587 -- Comp : Rec_Array := (others => ...);
3588 -- end record;
3592 then
3600 then
3610 -- Deal with default setting of reverse storage order
3614 -- Check consistent attribute setting on component types
3616 SSO_ADC := Get_Attribute_Definition_Clause
3619 declare
3621 begin
3624 Check_Component_Storage_Order
3634 -- Now deal with reverse storage order/bit order issues
3638 -- Check compatibility of Scalar_Storage_Order with Bit_Order, if
3639 -- the former is specified.
3643 -- Note: report error on Rec, not on SSO_ADC, as ADC may apply
3644 -- to some ancestor type.
3647 Error_Msg_N
3652 -- Warn if there is an Scalar_Storage_Order attribute definition
3653 -- clause but no component clause, no component that itself has
3654 -- such an attribute definition, and no pragma Pack.
3657 or else
3658 SSO_ADC_Component
3659 or else
3661 then
3662 Error_Msg_N
3664 SSO_ADC);
3668 -- Deal with Bit_Order aspect
3676 then
3677 -- Warn if clause has no effect when no component clause is
3678 -- present, but suppress warning if the Bit_Order is required
3679 -- due to the presence of a Scalar_Storage_Order attribute.
3681 Error_Msg_N
3683 Error_Msg_N
3686 -- Here is where we do the processing to adjust component clauses
3687 -- for reversed bit order, when not using reverse SSO.
3691 then
3694 -- Case where we have both an explicit Bit_Order and the same
3695 -- Scalar_Storage_Order: leave record untouched, the back-end
3696 -- will take care of required layout conversions.
3698 else
3704 -- Complete error checking on record representation clause (e.g.
3705 -- overlap of components). This is called after adjusting the
3706 -- record for reverse bit order.
3708 declare
3710 begin
3716 -- Set OK_To_Reorder_Components depending on debug flags
3720 or else
3722 then
3727 -- Check for useless pragma Pack when all components placed. We only
3728 -- do this check for record types, not subtypes, since a subtype may
3729 -- have all its components placed, and it still makes perfectly good
3730 -- sense to pack other subtypes or the parent type. We do not give
3731 -- this warning if Optimize_Alignment is set to Space, since the
3732 -- pragma Pack does have an effect in this case (it always resets
3733 -- the alignment to one).
3737 and then not Unplaced_Component
3739 then
3740 -- Reset packed status. Probably not necessary, but we do it so
3741 -- that there is no chance of the back end doing something strange
3742 -- with this redundant indication of packing.
3746 -- Give warning if redundant constructs warnings on
3749 Error_Msg_N -- CODEFIX
3755 -- If this is the record corresponding to a remote type, freeze the
3756 -- remote type here since that is what we are semantically freezing.
3757 -- This prevents the freeze node for that type in an inner scope.
3764 -- Check for controlled components and unchecked unions.
3769 -- Do not set Has_Controlled_Component on a class-wide
3770 -- equivalent type. See Make_CW_Equivalent_Type.
3773 and then
3775 or else
3778 or else
3780 and then
3782 and then
3783 Has_Controlled_Component
3785 then
3793 -- Scan component declaration for likely misuses of current
3794 -- instance, either in a constraint or a default expression.
3804 -- Enforce the restriction that access attributes with a current
3805 -- instance prefix can only apply to limited types. This comment
3806 -- is floating here, but does not seem to belong here???
3808 -- Set component alignment if not otherwise already set
3812 -- For first subtypes, check if there are any fixed-point fields with
3813 -- component clauses, where we must check the size. This is not done
3814 -- till the freeze point since for fixed-point types, we do not know
3815 -- the size until the type is frozen. Similar processing applies to
3816 -- bit packed arrays.
3824 then
3825 Check_Size
3829 Junk);
3836 -- Generate warning for applying C or C++ convention to a record
3837 -- with discriminants. This is suppressed for the unchecked union
3838 -- case, since the whole point in this case is interface C. We also
3839 -- do not generate this within instantiations, since we will have
3840 -- generated a message on the template.
3845 or else
3848 and then not In_Instance
3851 then
3852 declare
3856 begin
3861 Error_Msg_N
3863 A2);
3864 else
3865 Error_Msg_N
3867 A2);
3870 Error_Msg_NE
3876 -- See if Size is too small as is (and implicit packing might help)
3880 -- No implicit packing if even one component is explicitly placed
3882 and then not Placed_Component
3884 -- Or even one component is aliased
3886 and then not Aliased_Component
3888 -- Must have size clause and all scalar components
3891 and then All_Scalar_Components
3893 -- Do not try implicit packing on records with discriminants, too
3894 -- complicated, especially in the variant record case.
3898 -- We can implicitly pack if the specified size of the record is
3899 -- less than the sum of the object sizes (no point in packing if
3900 -- this is not the case).
3904 -- And the total RM size cannot be greater than the specified size
3905 -- since otherwise packing will not get us where we have to be.
3909 -- Never do implicit packing in CodePeer or SPARK modes since
3910 -- we don't do any packing in these modes, since this generates
3911 -- over-complex code that confuses static analysis, and in
3912 -- general, neither CodePeer not GNATprove care about the
3913 -- internal representation of objects.
3916 then
3917 -- If implicit packing enabled, do it
3922 -- Otherwise flag the size clause
3924 else
3925 declare
3927 begin
3928 Error_Msg_NE -- CODEFIX
3930 Error_Msg_N -- CODEFIX
3937 -- The following checks are only relevant when SPARK_Mode is on as
3938 -- they are not standard Ada legality rules.
3943 -- A discriminated type cannot be effectively volatile
3944 -- (SPARK RM C.6(4)).
3949 -- A tagged type cannot be effectively volatile
3950 -- (SPARK RM C.6(5)).
3956 -- A non-effectively volatile record type cannot contain
3957 -- effectively volatile components (SPARK RM C.6(2)).
3959 else
3964 then
3966 Error_Msg_N
3976 -- All done if not a full record definition
3982 -- Finally we need to check the variant part to make sure that
3983 -- all types within choices are properly frozen as part of the
3984 -- freezing of the record type.
3991 begin
3992 -- Find component list
4004 then
4009 -- Case of variant part present
4015 -- Note: we used to call Check_Choices here, but it is too early,
4016 -- since predicated subtypes are frozen here, but their freezing
4017 -- actions are in Analyze_Freeze_Entity, which has not been called
4018 -- yet for entities frozen within this procedure, so we moved that
4019 -- call to the Analyze_Freeze_Entity for the record type.
4023 -- Check that all the primitives of an interface type are abstract
4024 -- or null procedures.
4028 then
4029 declare
4033 begin
4040 -- Avoid reporting the error on inherited primitives
4043 then
4048 Error_Msg_N
4052 else
4053 Error_Msg_N
4065 -------------------------------
4066 -- Has_Boolean_Aspect_Import --
4067 -------------------------------
4074 begin
4080 -- The value of aspect Import is True when the expression is
4081 -- either missing or it is explicitly set to True.
4087 then
4098 ----------------------------
4099 -- Late_Freeze_Subprogram --
4100 ----------------------------
4107 begin
4110 else
4117 ------------------------------
4118 -- Wrap_Imported_Subprogram --
4119 ------------------------------
4121 -- The issue here is that our normal approach of checking preconditions
4122 -- and postconditions does not work for imported procedures, since we
4123 -- are not generating code for the body. To get around this we create
4124 -- a wrapper, as shown by the following example:
4126 -- procedure K (A : Integer);
4127 -- pragma Import (C, K);
4129 -- The spec is rewritten by removing the effects of pragma Import, but
4130 -- leaving the convention unchanged, as though the source had said:
4132 -- procedure K (A : Integer);
4133 -- pragma Convention (C, K);
4135 -- and we create a body, added to the entity K freeze actions, which
4136 -- looks like:
4138 -- procedure K (A : Integer) is
4139 -- procedure K (A : Integer);
4140 -- pragma Import (C, K);
4141 -- begin
4142 -- K (A);
4143 -- end K;
4145 -- Now the contract applies in the normal way to the outer procedure,
4146 -- and the inner procedure has no contracts, so there is no problem
4147 -- in just calling it to get the original effect.
4149 -- In the case of a function, we create an appropriate return statement
4150 -- for the subprogram body that calls the inner procedure.
4162 begin
4163 -- Nothing to do if not imported
4168 -- Test enabling conditions for wrapping
4173 and then not GNATprove_Mode
4174 then
4175 -- Here we do the wrap
4177 -- Note on calls to Copy_Separate_Tree. The trees we are copying
4178 -- here are fully analyzed, but we definitely want fully syntactic
4179 -- unanalyzed trees in the body we construct, so that the analysis
4180 -- generates the right visibility, and that is exactly what the
4181 -- calls to Copy_Separate_Tree give us.
4183 -- Acquire copy of Inline pragma
4187 -- Fix up spec to be not imported any more
4194 -- Grab the subprogram declaration and specification
4198 -- Build parameter list that we need
4207 -- Build the call
4210 Stmt :=
4212 Expression =>
4217 else
4218 Stmt :=
4224 -- Now build the body
4226 Bod :=
4228 Specification =>
4232 Specification =>
4234 Iprag),
4235 Handled_Statement_Sequence =>
4240 -- Append the body to freeze result
4245 -- Case of imported subprogram that does not get wrapped
4247 else
4248 -- Set Is_Public. All imported entities need an external symbol
4249 -- created for them since they are always referenced from another
4250 -- object file. Note this used to be set when we set Is_Imported
4251 -- back in Sem_Prag, but now we delay it to this point, since we
4252 -- don't want to set this flag if we wrap an imported subprogram.
4258 -- Start of processing for Freeze_Entity
4260 begin
4261 -- We are going to test for various reasons why this entity need not be
4262 -- frozen here, but in the case of an Itype that's defined within a
4263 -- record, that test actually applies to the record.
4269 then
4273 -- Do not freeze if already frozen since we only need one freeze node
4278 -- It is improper to freeze an external entity within a generic because
4279 -- its freeze node will appear in a non-valid context. The entity will
4280 -- be frozen in the proper scope after the current generic is analyzed.
4281 -- However, aspects must be analyzed because they may be queried later
4282 -- within the generic itself, and the corresponding pragma or attribute
4283 -- definition has not been analyzed yet.
4292 -- AI05-0213: A formal incomplete type does not freeze the actual. In
4293 -- the instance, the same applies to the subtype renaming the actual.
4299 then
4302 -- Formal subprograms are never frozen
4307 -- Generic types are never frozen as they lack delayed semantic checks
4312 -- Do not freeze a global entity within an inner scope created during
4313 -- expansion. A call to subprogram E within some internal procedure
4314 -- (a stream attribute for example) might require freezing E, but the
4315 -- freeze node must appear in the same declarative part as E itself.
4316 -- The two-pass elaboration mechanism in gigi guarantees that E will
4317 -- be frozen before the inner call is elaborated. We exclude constants
4318 -- from this test, because deferred constants may be frozen early, and
4319 -- must be diagnosed (e.g. in the case of a deferred constant being used
4320 -- in a default expression). If the enclosing subprogram comes from
4321 -- source, or is a generic instance, then the freeze point is the one
4322 -- mandated by the language, and we freeze the entity. A subprogram that
4323 -- is a child unit body that acts as a spec does not have a spec that
4324 -- comes from source, but can only come from source.
4329 then
4330 declare
4333 begin
4340 then
4342 else
4351 -- Similarly, an inlined instance body may make reference to global
4352 -- entities, but these references cannot be the proper freezing point
4353 -- for them, and in the absence of inlining freezing will take place in
4354 -- their own scope. Normally instance bodies are analyzed after the
4355 -- enclosing compilation, and everything has been frozen at the proper
4356 -- place, but with front-end inlining an instance body is compiled
4357 -- before the end of the enclosing scope, and as a result out-of-order
4358 -- freezing must be prevented.
4360 elsif Front_End_Inlining
4361 and then In_Instance_Body
4363 then
4364 declare
4367 begin
4372 else
4386 -- Add checks to detect proper initialization of scalars that may appear
4387 -- as subprogram parameters.
4393 -- Deal with delayed aspect specifications. The analysis of the aspect
4394 -- is required to be delayed to the freeze point, thus we analyze the
4395 -- pragma or attribute definition clause in the tree at this point. We
4396 -- also analyze the aspect specification node at the freeze point when
4397 -- the aspect doesn't correspond to pragma/attribute definition clause.
4403 -- Here to freeze the entity
4407 -- Case of entity being frozen is other than a type
4411 -- If entity is exported or imported and does not have an external
4412 -- name, now is the time to provide the appropriate default name.
4413 -- Skip this if the entity is stubbed, since we don't need a name
4414 -- for any stubbed routine. For the case on intrinsics, if no
4415 -- external name is specified, then calls will be handled in
4416 -- Exp_Intr.Expand_Intrinsic_Call, and no name is needed. If an
4417 -- external name is provided, then Expand_Intrinsic_Call leaves
4418 -- calls in place for expansion by GIGI.
4424 then
4425 Set_Encoded_Interface_Name
4428 -- If entity is an atomic object appearing in a declaration and
4429 -- the expression is an aggregate, assign it to a temporary to
4430 -- ensure that the actual assignment is done atomically rather
4431 -- than component-wise (the assignment to the temp may be done
4432 -- component-wise, but that is harmless).
4439 then
4443 -- Subprogram case
4447 -- Check for needing to wrap imported subprogram
4451 -- Freeze all parameter types and the return type (RM 13.14(14)).
4452 -- However skip this for internal subprograms. This is also where
4453 -- any extra formal parameters are created since we now know
4454 -- whether the subprogram will use a foreign convention.
4456 -- In Ada 2012, freezing a subprogram does not always freeze
4457 -- the corresponding profile (see AI05-019). An attribute
4458 -- reference is not a freezing point of the profile.
4459 -- Other constructs that should not freeze ???
4461 -- This processing doesn't apply to internal entities (see below)
4469 -- Must freeze its parent first if it is a derived subprogram
4475 -- We don't freeze internal subprograms, because we don't normally
4476 -- want addition of extra formals or mechanism setting to happen
4477 -- for those. However we do pass through predefined dispatching
4478 -- cases, since extra formals may be needed in some cases, such as
4479 -- for the stream 'Input function (build-in-place formals).
4483 then
4492 -- If warning on suspicious contracts then check for the case of
4493 -- a postcondition other than False for a No_Return subprogram.
4496 and then Warn_On_Suspicious_Contract
4498 then
4499 declare
4503 begin
4506 Name_Postcondition,
4507 Name_Refined_Post)
4508 then
4509 Exp :=
4510 Expression
4515 then
4516 Error_Msg_NE
4527 -- Here for other than a subprogram or type
4529 else
4530 -- If entity has a type, and it is not a generic unit, then
4531 -- freeze it first (RM 13.14(10)).
4535 then
4538 -- For an object of an anonymous array type, aspects on the
4539 -- object declaration apply to the type itself. This is the
4540 -- case for Atomic_Components, Volatile_Components, and
4541 -- Independent_Components. In these cases analysis of the
4542 -- generated pragma will mark the anonymous types accordingly,
4543 -- and the object itself does not require a freeze node.
4549 then
4556 -- Special processing for objects created by object declaration
4560 -- Abstract type allowed only for C++ imported variables or
4561 -- constants.
4563 -- Note: we inhibit this check for objects that do not come
4564 -- from source because there is at least one case (the
4565 -- expansion of x'Class'Input where x is abstract) where we
4566 -- legitimately generate an abstract object.
4572 then
4577 Error_Msg_NE
4582 Error_Msg_N -- CODEFIX
4588 -- For object created by object declaration, perform required
4589 -- categorization (preelaborate and pure) checks. Defer these
4590 -- checks to freeze time since pragma Import inhibits default
4591 -- initialization and thus pragma Import affects these checks.
4595 -- If there is an address clause, check that it is valid
4599 -- Reset Is_True_Constant for non-constant aliased object. We
4600 -- consider that the fact that a non-constant object is aliased
4601 -- may indicate that some funny business is going on, e.g. an
4602 -- aliased object is passed by reference to a procedure which
4603 -- captures the address of the object, which is later used to
4604 -- assign a new value, even though the compiler thinks that
4605 -- it is not modified. Such code is highly dubious, but we
4606 -- choose to make it "work" for non-constant aliased objects.
4607 -- Note that we used to do this for all aliased objects,
4608 -- whether or not constant, but this caused anomalies down
4609 -- the line because we ended up with static objects that
4610 -- were not Is_True_Constant. Not resetting Is_True_Constant
4611 -- for (aliased) constant objects ensures that this anomaly
4612 -- never occurs.
4614 -- However, we don't do that for internal entities. We figure
4615 -- that if we deliberately set Is_True_Constant for an internal
4616 -- entity, e.g. a dispatch table entry, then we mean it.
4621 then
4625 -- If the object needs any kind of default initialization, an
4626 -- error must be issued if No_Default_Initialization applies.
4627 -- The check doesn't apply to imported objects, which are not
4628 -- ever default initialized, and is why the check is deferred
4629 -- until freezing, at which point we know if Import applies.
4630 -- Deferred constants are also exempted from this test because
4631 -- their completion is explicit, or through an import pragma.
4635 then
4641 and then
4646 or else
4649 then
4651 Check_Restriction
4655 -- Check that a Thread_Local_Storage variable does not have
4656 -- default initialization, and any explicit initialization must
4657 -- either be the null constant or a static constant.
4660 declare
4662 begin
4663 if Has_Default_Initialization
4664 or else
4666 and then
4668 or else not
4670 or else
4672 then
4673 Error_Msg_NE
4676 Error_Msg_NE
4683 -- For imported objects, set Is_Public unless there is also an
4684 -- address clause, which means that there is no external symbol
4685 -- needed for the Import (Is_Public may still be set for other
4686 -- unrelated reasons). Note that we delayed this processing
4687 -- till freeze time so that we can be sure not to set the flag
4688 -- if there is an address clause. If there is such a clause,
4689 -- then the only purpose of the Import pragma is to suppress
4690 -- implicit initialization.
4696 -- For source objects that are not Imported and are library
4697 -- level, if no linker section pragma was given inherit the
4698 -- appropriate linker section from the corresponding type.
4704 then
4705 Set_Linker_Section_Pragma
4709 -- For convention C objects of an enumeration type, warn if
4710 -- the size is not integer size and no explicit size given.
4711 -- Skip warning for Boolean, and Character, assume programmer
4712 -- expects 8-bit sizes for these cases.
4715 or else
4722 then
4724 Error_Msg_N
4726 E);
4731 -- Check that a constant which has a pragma Volatile[_Components]
4732 -- or Atomic[_Components] also has a pragma Import (RM C.6(13)).
4734 -- Note: Atomic[_Components] also sets Volatile[_Components]
4740 then
4741 -- Make sure we actually have a pragma, and have not merely
4742 -- inherited the indication from elsewhere (e.g. an address
4743 -- clause, which is not good enough in RM terms).
4746 or else
4748 then
4749 Error_Msg_N
4754 or else
4756 then
4757 Error_Msg_N
4763 -- Static objects require special handling
4767 then
4771 -- Remaining step is to layout objects
4775 then
4779 -- For an object that does not have delayed freezing, and whose
4780 -- initialization actions have been captured in a compound
4781 -- statement, move them back now directly within the enclosing
4782 -- statement sequence.
4786 then
4791 -- Case of a type or subtype being frozen
4793 else
4794 -- We used to check here that a full type must have preelaborable
4795 -- initialization if it completes a private type specified with
4796 -- pragma Preelaborable_Initialization, but that missed cases where
4797 -- the types occur within a generic package, since the freezing
4798 -- that occurs within a containing scope generally skips traversal
4799 -- of a generic unit's declarations (those will be frozen within
4800 -- instances). This check was moved to Analyze_Package_Specification.
4802 -- The type may be defined in a generic unit. This can occur when
4803 -- freezing a generic function that returns the type (which is
4804 -- defined in a parent unit). It is clearly meaningless to freeze
4805 -- this type. However, if it is a subtype, its size may be determi-
4806 -- nable and used in subsequent checks, so might as well try to
4807 -- compute it.
4809 -- In Ada 2012, Freeze_Entities is also used in the front end to
4810 -- trigger the analysis of aspect expressions, so in this case we
4811 -- want to continue the freezing process.
4815 and then
4818 then
4823 -- Check for error of Type_Invariant'Class applied to an untagged
4824 -- type (check delayed to freeze time when full type is available).
4826 declare
4828 begin
4832 then
4833 Error_Msg_NE
4836 Error_Msg_N
4841 -- A Ghost type cannot be effectively volatile (SPARK RM 6.9(8))
4845 then
4849 -- Deal with special cases of freezing for subtype
4853 -- Before we do anything else, a specialized test for the case of
4854 -- a size given for an array where the array needs to be packed,
4855 -- but was not so the size cannot be honored. This is the case
4856 -- where implicit packing may apply. The reason we do this so
4857 -- early is that if we have implicit packing, the layout of the
4858 -- base type is affected, so we must do this before we freeze
4859 -- the base type.
4861 -- We could do this processing only if implicit packing is enabled
4862 -- since in all other cases, the error would be caught by the back
4863 -- end. However, we choose to do the check even if we do not have
4864 -- implicit packing enabled, since this allows us to give a more
4865 -- useful error message (advising use of pragmas Implicit_Packing
4866 -- or Pack).
4869 declare
4880 -- Number of elements in array
4882 begin
4883 -- Check enabling conditions. These are straightforward
4884 -- except for the test for a limited composite type. This
4885 -- eliminates the rare case of a array of limited components
4886 -- where there are issues of whether or not we can go ahead
4887 -- and pack the array (since we can't freely pack and unpack
4888 -- arrays if they are limited).
4890 -- Note that we check the root type explicitly because the
4891 -- whole point is we are doing this test before we have had
4892 -- a chance to freeze the base type (and it is that freeze
4893 -- action that causes stuff to be inherited).
4906 then
4907 -- Compute number of elements in array
4915 and then
4917 then
4921 Num_Elmts :=
4922 Num_Elmts *
4928 -- What we are looking for here is the situation where
4929 -- the RM_Size given would be exactly right if there was
4930 -- a pragma Pack (resulting in the component size being
4931 -- the same as the RM_Size). Furthermore, the component
4932 -- type size must be an odd size (not a multiple of
4933 -- storage unit). If the component RM size is an exact
4934 -- number of storage units that is a power of two, the
4935 -- array is not packed and has a standard representation.
4939 then
4940 -- For implicit packing mode, just set the component
4941 -- size silently.
4949 -- Otherwise give an error message
4951 else
4952 Error_Msg_NE
4954 Error_Msg_N -- CODEFIX
4960 and then Implicit_Packing
4961 and then
4963 or else
4965 or else
4967 then
4968 -- Not a packed array, but indicate the desired
4969 -- component size, for the back-end.
4979 -- If ancestor subtype present, freeze that first. Note that this
4980 -- will also get the base type frozen. Need RM reference ???
4987 -- No ancestor subtype present
4989 else
4990 -- See if we have a nearest ancestor that has a predicate.
4991 -- That catches the case of derived type with a predicate.
4992 -- Need RM reference here ???
5000 -- Freeze base type before freezing the entity (RM 13.14(15))
5007 -- A subtype inherits all the type-related representation aspects
5008 -- from its parents (RM 13.1(8)).
5012 -- For a derived type, freeze its parent type first (RM 13.14(15))
5018 -- A derived type inherits each type-related representation aspect
5019 -- of its parent type that was directly specified before the
5020 -- declaration of the derived type (RM 13.1(15)).
5025 -- Check for incompatible size and alignment for record type
5027 if Warn_On_Size_Alignment
5031 -- If explicit Object_Size clause given assume that the programmer
5032 -- knows what he is doing, and expects the compiler behavior.
5036 -- Check for size not a multiple of alignment
5039 then
5040 declare
5046 begin
5049 -- Give a warning
5053 Error_Msg_NE
5059 else
5061 Error_Msg_NE
5074 -- Array type
5079 -- For a class-wide type, the corresponding specific type is
5080 -- frozen as well (RM 13.14(15))
5085 -- If the base type of the class-wide type is still incomplete,
5086 -- the class-wide remains unfrozen as well. This is legal when
5087 -- E is the formal of a primitive operation of some other type
5088 -- which is being frozen.
5095 -- The equivalent type associated with a class-wide subtype needs
5096 -- to be frozen to ensure that its layout is done.
5100 then
5104 -- Generate an itype reference for a library-level class-wide type
5105 -- at the freeze point. Otherwise the first explicit reference to
5106 -- the type may appear in an inner scope which will be rejected by
5107 -- the back-end.
5111 then
5112 declare
5115 begin
5118 -- From a gigi point of view, a class-wide subtype derives
5119 -- from its record equivalent type. As a result, the itype
5120 -- reference must appear after the freeze node of the
5121 -- equivalent type or gigi will reject the reference.
5125 then
5127 else
5133 -- For a record type or record subtype, freeze all component types
5134 -- (RM 13.14(15)). We test for E_Record_(sub)Type here, rather than
5135 -- using Is_Record_Type, because we don't want to attempt the freeze
5136 -- for the case of a private type with record extension (we will do
5137 -- that later when the full type is frozen).
5142 then
5145 -- For a concurrent type, freeze corresponding record type. This does
5146 -- not correspond to any specific rule in the RM, but the record type
5147 -- is essentially part of the concurrent type. Also freeze all local
5148 -- entities. This includes record types created for entry parameter
5149 -- blocks and whatever local entities may appear in the private part.
5163 -- The guard on the presence of the Etype seems to be needed
5164 -- for some CodePeer (-gnatcC) cases, but not clear why???
5169 then
5180 -- Private types are required to point to the same freeze node as
5181 -- their corresponding full views. The freeze node itself has to
5182 -- point to the partial view of the entity (because from the partial
5183 -- view, we can retrieve the full view, but not the reverse).
5184 -- However, in order to freeze correctly, we need to freeze the full
5185 -- view. If we are freezing at the end of a scope (or within the
5186 -- scope) of the private type, the partial and full views will have
5187 -- been swapped, the full view appears first in the entity chain and
5188 -- the swapping mechanism ensures that the pointers are properly set
5189 -- (on scope exit).
5191 -- If we encounter the partial view before the full view (e.g. when
5192 -- freezing from another scope), we freeze the full view, and then
5193 -- set the pointers appropriately since we cannot rely on swapping to
5194 -- fix things up (subtypes in an outer scope might not get swapped).
5196 -- If the full view is itself private, the above requirements apply
5197 -- to the underlying full view instead of the full view. But there is
5198 -- no swapping mechanism for the underlying full view so we need to
5199 -- set the pointers appropriately in both cases.
5203 then
5204 -- The construction of the dispatch table associated with library
5205 -- level tagged types forces freezing of all the primitives of the
5206 -- type, which may cause premature freezing of the partial view.
5207 -- For example:
5209 -- package Pkg is
5210 -- type T is tagged private;
5211 -- type DT is new T with private;
5212 -- procedure Prim (X : in out T; Y : in out DT'Class);
5213 -- private
5214 -- type T is tagged null record;
5215 -- Obj : T;
5216 -- type DT is new T with null record;
5217 -- end;
5219 -- In this case the type will be frozen later by the usual
5220 -- mechanism: an object declaration, an instantiation, or the
5221 -- end of a declarative part.
5225 then
5229 -- Case of full view present
5233 -- If full view has already been frozen, then no further
5234 -- processing is required
5240 -- Otherwise freeze full view and patch the pointers so that
5241 -- the freeze node will elaborate both views in the back end.
5242 -- However, if full view is itself private, freeze underlying
5243 -- full view instead and patch the pointers so that the freeze
5244 -- node will elaborate the three views in the back end.
5246 else
5247 declare
5250 begin
5253 then
5261 then
5268 else
5281 else
5282 -- {Incomplete,Private}_Subtypes with Full_Views
5283 -- constrained by discriminants.
5294 -- AI-117 requires that the convention of a partial view be the
5295 -- same as the convention of the full view. Note that this is a
5296 -- recognized breach of privacy, but it's essential for logical
5297 -- consistency of representation, and the lack of a rule in
5298 -- RM95 was an oversight.
5305 -- Size information is copied from the full view to the
5306 -- incomplete or private view for consistency.
5308 -- We skip this is the full view is not a type. This is very
5309 -- strange of course, and can only happen as a result of
5310 -- certain illegalities, such as a premature attempt to derive
5311 -- from an incomplete type.
5320 -- Case of underlying full view present
5324 then
5329 -- Patch the pointers so that the freeze node will elaborate
5330 -- both views in the back end.
5339 else
5349 -- Case of no full view present. If entity is derived or subtype,
5350 -- it is safe to freeze, correctness depends on the frozen status
5351 -- of parent. Otherwise it is either premature usage, or a Taft
5352 -- amendment type, so diagnosis is at the point of use and the
5353 -- type might be frozen later.
5358 else
5363 -- For access subprogram, freeze types of all formals, the return
5364 -- type was already frozen, since it is the Etype of the function.
5365 -- Formal types can be tagged Taft amendment types, but otherwise
5366 -- they cannot be incomplete.
5374 then
5378 -- AI05-151: Incomplete types are allowed in access to
5379 -- subprogram specifications.
5382 Error_Msg_NE
5393 -- For access to a protected subprogram, freeze the equivalent type
5394 -- (however this is not set if we are not generating code or if this
5395 -- is an anonymous type used just for resolution).
5403 -- Generic types are never seen by the back-end, and are also not
5404 -- processed by the expander (since the expander is turned off for
5405 -- generic processing), so we never need freeze nodes for them.
5411 -- Some special processing for non-generic types to complete
5412 -- representation details not known till the freeze point.
5417 -- Some error checks required for ordinary fixed-point type. Defer
5418 -- these till the freeze-point since we need the small and range
5419 -- values. We only do these checks for base types
5424 Error_Msg_N
5429 Error_Msg_N
5435 Error_Msg_N
5441 Error_Msg_N
5453 and then Warn_On_Suspicious_Modulus_Value
5454 then
5458 -- The pool applies to named and anonymous access types, but not
5459 -- to subprogram and to internal types generated for 'Access
5460 -- references.
5465 then
5466 -- If a pragma Default_Storage_Pool applies, and this type has no
5467 -- Storage_Pool or Storage_Size clause (which must have occurred
5468 -- before the freezing point), then use the default. This applies
5469 -- only to base types.
5471 -- None of this applies to access to subprograms, for which there
5472 -- are clearly no pools.
5478 then
5479 -- Case of pragma Default_Storage_Pool (null)
5484 -- Case of pragma Default_Storage_Pool (storage_pool_NAME)
5486 else
5491 -- Check restriction for standard storage pool
5497 -- Deal with error message for pure access type. This is not an
5498 -- error in Ada 2005 if there is no pool (see AI-366).
5504 then
5508 Error_Msg_N
5512 Error_Msg_N
5515 else
5516 Error_Msg_N
5523 -- Case of composite types
5527 -- AI-117 requires that all new primitives of a tagged type must
5528 -- inherit the convention of the full view of the type. Inherited
5529 -- and overriding operations are defined to inherit the convention
5530 -- of their parent or overridden subprogram (also specified in
5531 -- AI-117), which will have occurred earlier (in Derive_Subprogram
5532 -- and New_Overloaded_Entity). Here we set the convention of
5533 -- primitives that are still convention Ada, which will ensure
5534 -- that any new primitives inherit the type's convention. Class-
5535 -- wide types can have a foreign convention inherited from their
5536 -- specific type, but are excluded from this since they don't have
5537 -- any associated primitives.
5542 then
5543 declare
5547 begin
5559 -- If the type is a simple storage pool type, then this is where
5560 -- we attempt to locate and validate its Allocate, Deallocate, and
5561 -- Storage_Size operations (the first is required, and the latter
5562 -- two are optional). We also verify that the full type for a
5563 -- private type is allowed to be a simple storage pool type.
5567 then
5568 -- If the type is marked Has_Private_Declaration, then this is
5569 -- a full type for a private type that was specified with the
5570 -- pragma Simple_Storage_Pool_Type, and here we ensure that the
5571 -- pragma is allowed for the full type (for example, it can't
5572 -- be an array type, or a nonlimited record type).
5577 then
5579 Error_Msg_N
5590 procedure Validate_Simple_Pool_Op_Formal
5597 -- Validate one formal Pool_Op_Formal of the candidate pool
5598 -- operation Pool_Op. The formal must be of Expected_Type
5599 -- and have mode Expected_Mode. OK_Formal will be set to
5600 -- False if the formal doesn't match. If OK_Formal is False
5601 -- on entry, then the formal will effectively be ignored
5602 -- (because validation of the pool op has already failed).
5603 -- Upon return, Pool_Op_Formal will be updated to the next
5604 -- formal, if any.
5606 procedure Validate_Simple_Pool_Operation
5608 -- Search for and validate a simple pool operation with the
5609 -- name Op_Name. If the name is Allocate, then there must be
5610 -- exactly one such primitive operation for the simple pool
5611 -- type. If the name is Deallocate or Storage_Size, then
5612 -- there can be at most one such primitive operation. The
5613 -- profile of the located primitive must conform to what
5614 -- is expected for each operation.
5616 ------------------------------------
5617 -- Validate_Simple_Pool_Op_Formal --
5618 ------------------------------------
5620 procedure Validate_Simple_Pool_Op_Formal
5627 is
5628 begin
5629 -- If OK_Formal is False on entry, then simply ignore
5630 -- the formal, because an earlier formal has already
5631 -- been flagged.
5636 -- If no formal is passed in, then issue an error for a
5637 -- missing formal.
5640 Error_Msg_NE
5650 -- If the pool type was expected for this formal, then
5651 -- this will not be considered a candidate operation
5652 -- for the simple pool, so we unset OK_Formal so that
5653 -- the op and any later formals will be ignored.
5660 else
5661 Error_Msg_NE
5668 -- Issue error if formal's mode is not the expected one
5671 Error_Msg_N
5673 Pool_Op_Formal);
5676 -- Advance to the next formal
5681 ------------------------------------
5682 -- Validate_Simple_Pool_Operation --
5683 ------------------------------------
5685 procedure Validate_Simple_Pool_Operation
5687 is
5693 begin
5694 pragma Assert
5696 Name_Deallocate,
5697 Name_Storage_Size));
5701 -- For each homonym declared immediately in the scope
5702 -- of the simple storage pool type, determine whether
5703 -- the homonym is an operation of the pool type, and,
5704 -- if so, check that its profile is as expected for
5705 -- a simple pool operation of that name.
5711 then
5716 -- The first parameter must be of the pool type
5717 -- in order for the operation to qualify.
5720 Validate_Simple_Pool_Op_Formal
5723 else
5724 Validate_Simple_Pool_Op_Formal
5729 -- If another operation with this name has already
5730 -- been located for the type, then flag an error,
5731 -- since we only allow the type to have a single
5732 -- such primitive.
5735 Error_Msg_NE
5740 -- In the case of Allocate and Deallocate, a formal
5741 -- of type System.Address is required.
5744 Validate_Simple_Pool_Op_Formal
5749 Validate_Simple_Pool_Op_Formal
5754 -- In the case of Allocate and Deallocate, formals
5755 -- of type Storage_Count are required as the third
5756 -- and fourth parameters.
5759 Validate_Simple_Pool_Op_Formal
5762 Validate_Simple_Pool_Op_Formal
5767 -- If no mismatched formals have been found (Is_OK)
5768 -- and no excess formals are present, then this
5769 -- operation has been validated, so record it.
5779 -- There must be a valid Allocate operation for the type,
5780 -- so issue an error if none was found.
5784 then
5790 -- Simple pool operations can't be abstract
5793 Error_Msg_N
5798 -- The Storage_Size operation must be a function with
5799 -- Storage_Count as its result type.
5803 Error_Msg_N
5807 Error_Msg_NE
5812 -- Allocate and Deallocate must be procedures
5815 Error_Msg_N
5821 -- Start of processing for Validate_Simple_Pool_Ops
5823 begin
5831 -- Now that all types from which E may depend are frozen, see if the
5832 -- size is known at compile time, if it must be unsigned, or if
5833 -- strict alignment is required
5842 -- Do not allow a size clause for a type which does not have a size
5843 -- that is known at compile time
5847 then
5848 -- Suppress this message if errors posted on E, even if we are
5849 -- in all errors mode, since this is often a junk message
5852 Error_Msg_N
5858 -- Now we set/verify the representation information, in particular
5859 -- the size and alignment values. This processing is not required for
5860 -- generic types, since generic types do not play any part in code
5861 -- generation, and so the size and alignment values for such types
5862 -- are irrelevant. Ditto for types declared within a generic unit,
5863 -- which may have components that depend on generic parameters, and
5864 -- that will be recreated in an instance.
5869 -- Otherwise we call the layout procedure
5871 else
5875 -- If this is an access to subprogram whose designated type is itself
5876 -- a subprogram type, the return type of this anonymous subprogram
5877 -- type must be decorated as well.
5881 then
5885 -- If the type has a Defaut_Value/Default_Component_Value aspect,
5886 -- this is where we analye the expression (after the type is frozen,
5887 -- since in the case of Default_Value, we are analyzing with the
5888 -- type itself, and we treat Default_Component_Value similarly for
5889 -- the sake of uniformity).
5892 declare
5897 begin
5902 else
5913 Flag_Non_Static_Expr
5920 -- End of freeze processing for type entities
5923 -- Here is where we logically freeze the current entity. If it has a
5924 -- freeze node, then this is the point at which the freeze node is
5925 -- linked into the result list.
5929 -- If a freeze node is already allocated, use it, otherwise allocate
5930 -- a new one. The preallocation happens in the case of anonymous base
5931 -- types, where we preallocate so that we can set First_Subtype_Link.
5932 -- Note that we reset the Sloc to the current freeze location.
5938 else
5949 -- A final pass over record types with discriminants. If the type
5950 -- has an incomplete declaration, there may be constrained access
5951 -- subtypes declared elsewhere, which do not depend on the discrimi-
5952 -- nants of the type, and which are used as component types (i.e.
5953 -- the full view is a recursive type). The designated types of these
5954 -- subtypes can only be elaborated after the type itself, and they
5955 -- need an itype reference.
5959 then
5960 declare
5965 begin
5975 then
5987 -- When a type is frozen, the first subtype of the type is frozen as
5988 -- well (RM 13.14(15)). This has to be done after freezing the type,
5989 -- since obviously the first subtype depends on its own base type.
5994 -- If we just froze a tagged non-class wide record, then freeze the
5995 -- corresponding class-wide type. This must be done after the tagged
5996 -- type itself is frozen, because the class-wide type refers to the
5997 -- tagged type which generates the class.
6002 then
6009 -- Special handling for subprograms
6013 -- If subprogram has address clause then reset Is_Public flag, since
6014 -- we do not want the backend to generate external references.
6018 then
6026 -----------------------------
6027 -- Freeze_Enumeration_Type --
6028 -----------------------------
6031 begin
6032 -- By default, if no size clause is present, an enumeration type with
6033 -- Convention C is assumed to interface to a C enum, and has integer
6034 -- size. This applies to types. For subtypes, verify that its base
6035 -- type has no size clause either. Treat other foreign conventions
6036 -- in the same way, and also make sure alignment is set right.
6043 -- Don't do this if Short_Enums on target
6045 and then not Target_Short_Enums
6046 then
6050 -- Normal Ada case or size clause present or not Long_C_Enums on target
6052 else
6053 -- If the enumeration type interfaces to C, and it has a size clause
6054 -- that specifies less than int size, it warrants a warning. The
6055 -- user may intend the C type to be an enum or a char, so this is
6056 -- not by itself an error that the Ada compiler can detect, but it
6057 -- it is a worth a heads-up. For Boolean and Character types we
6058 -- assume that the programmer has the proper C type in mind.
6066 -- Don't do this if Short_Enums on target
6068 and then not Target_Short_Enums
6069 then
6070 Error_Msg_N
6078 -----------------------
6079 -- Freeze_Expression --
6080 -----------------------
6091 -- This flag is set true if the entity must be frozen outside the
6092 -- current subprogram. This happens in the case of expander generated
6093 -- subprograms (_Init_Proc, _Input, _Output, _Read, _Write) which do
6094 -- not freeze all entities like other bodies, but which nevertheless
6095 -- may reference entities that have to be frozen before the body and
6096 -- obviously cannot be frozen inside the body.
6099 -- If the expression is an array aggregate, the type of the component
6100 -- expressions is also frozen. If the component type is an access type
6101 -- and the expressions include allocators, the designed type is frozen
6102 -- as well.
6105 -- Given an N_Handled_Sequence_Of_Statements node N, determines whether
6106 -- it is the handled statement sequence of an expander-generated
6107 -- subprogram (init proc, stream subprogram, or renaming as body).
6108 -- If so, this is not a freezing context.
6110 -----------------------------------------
6111 -- Find_Aggregate_Component_Desig_Type --
6112 -----------------------------------------
6118 begin
6144 ----------------------
6145 -- In_Expanded_Body --
6146 ----------------------
6152 begin
6155 else
6162 else
6165 -- The following are expander-created bodies, or bodies that
6166 -- are not freeze points.
6175 N_Subprogram_Renaming_Declaration,
6176 N_Expression_Function))
6177 then
6179 else
6185 -- Start of processing for Freeze_Expression
6187 begin
6188 -- Immediate return if freezing is inhibited. This flag is set by the
6189 -- analyzer to stop freezing on generated expressions that would cause
6190 -- freezing if they were in the source program, but which are not
6191 -- supposed to freeze, since they are created.
6197 -- If expression is non-static, then it does not freeze in a default
6198 -- expression, see section "Handling of Default Expressions" in the
6199 -- spec of package Sem for further details. Note that we have to make
6200 -- sure that we actually have a real expression (if we have a subtype
6201 -- indication, we can't test Is_OK_Static_Expression). However, we
6202 -- exclude the case of the prefix of an attribute of a static scalar
6203 -- subtype from this early return, because static subtype attributes
6204 -- should always cause freezing, even in default expressions, but
6205 -- the attribute may not have been marked as static yet (because in
6206 -- Resolve_Attribute, the call to Eval_Attribute follows the call of
6207 -- Freeze_Expression on the prefix).
6209 if In_Spec_Exp
6216 then
6220 -- Freeze type of expression if not frozen already
6228 -- Base type may be an derived numeric type that is frozen at
6229 -- the point of declaration, but first_subtype is still unfrozen.
6236 -- For entity name, freeze entity if not frozen already. A special
6237 -- exception occurs for an identifier that did not come from source.
6238 -- We don't let such identifiers freeze a non-internal entity, i.e.
6239 -- an entity that did come from source, since such an identifier was
6240 -- generated by the expander, and cannot have any semantic effect on
6241 -- the freezing semantics. For example, this stops the parameter of
6242 -- an initialization procedure from freezing the variable.
6249 then
6256 else
6260 -- For an allocator freeze designated type if not frozen already
6262 -- For an aggregate whose component type is an access type, freeze the
6263 -- designated type now, so that its freeze does not appear within the
6264 -- loop that might be created in the expansion of the aggregate. If the
6265 -- designated type is a private type without full view, the expression
6266 -- cannot contain an allocator, so the type is not frozen.
6268 -- For a function, we freeze the entity when the subprogram declaration
6269 -- is frozen, but a function call may appear in an initialization proc.
6270 -- before the declaration is frozen. We need to generate the extra
6271 -- formals, if any, to ensure that the expansion of the call includes
6272 -- the proper actuals. This only applies to Ada subprograms, not to
6273 -- imported ones.
6284 then
6286 -- Check whether aggregate includes allocators.
6291 when N_Selected_Component |
6292 N_Indexed_Component |
6293 N_Slice =>
6304 then
6315 then
6319 -- All done if nothing needs freezing
6324 then
6328 -- Examine the enclosing context by climbing the parent chain. The
6329 -- traversal serves two purposes - to detect scenarios where freezeing
6330 -- is not needed and to find the proper insertion point for the freeze
6331 -- nodes. Although somewhat similar to Insert_Actions, this traversal
6332 -- is freezing semantics-sensitive. Inserting freeze nodes blindly in
6333 -- the tree may result in types being frozen too early.
6336 loop
6339 -- If we don't have a parent, then we are not in a well-formed tree.
6340 -- This is an unusual case, but there are some legitimate situations
6341 -- in which this occurs, notably when the expressions in the range of
6342 -- a type declaration are resolved. We simply ignore the freeze
6343 -- request in this case. Is this right ???
6349 -- See if we have got to an appropriate point in the tree
6353 -- A special test for the exception of (RM 13.14(8)) for the case
6354 -- of per-object expressions (RM 3.8(18)) occurring in component
6355 -- definition or a discrete subtype definition. Note that we test
6356 -- for a component declaration which includes both cases we are
6357 -- interested in, and furthermore the tree does not have explicit
6358 -- nodes for either of these two constructs.
6362 -- The case we want to test for here is an identifier that is
6363 -- a per-object expression, this is either a discriminant that
6364 -- appears in a context other than the component declaration
6365 -- or it is a reference to the type of the enclosing construct.
6367 -- For either of these cases, we skip the freezing
6369 if not In_Spec_Expression
6372 then
6373 -- We recognize the discriminant case by just looking for
6374 -- a reference to a discriminant. It can only be one for
6375 -- the enclosing construct. Skip freezing in this case.
6380 -- For the case of a reference to the enclosing record,
6381 -- (or task or protected type), we look for a type that
6382 -- matches the current scope.
6389 -- If we have an enumeration literal that appears as the choice in
6390 -- the aggregate of an enumeration representation clause, then
6391 -- freezing does not occur (RM 13.14(10)).
6395 -- The case we are looking for is an enumeration literal
6399 then
6400 -- If enumeration literal appears directly as the choice,
6401 -- do not freeze (this is the normal non-overloaded case)
6405 then
6408 -- If enumeration literal appears as the name of function
6409 -- which is the choice, then also do not freeze. This
6410 -- happens in the overloaded literal case, where the
6411 -- enumeration literal is temporarily changed to a function
6412 -- call for overloading analysis purposes.
6415 and then
6417 and then
6419 then
6424 -- Normally if the parent is a handled sequence of statements,
6425 -- then the current node must be a statement, and that is an
6426 -- appropriate place to insert a freeze node.
6430 -- An exception occurs when the sequence of statements is for
6431 -- an expander generated body that did not do the usual freeze
6432 -- all operation. In this case we usually want to freeze
6433 -- outside this body, not inside it, and we skip past the
6434 -- subprogram body that we are inside.
6437 declare
6441 begin
6442 -- Freeze the entity only when it is declared inside the
6443 -- body of the expander generated procedure. This case
6444 -- is recognized by the scope of the entity or its type,
6445 -- which is either the spec for some enclosing body, or
6446 -- (in the case of init_procs, for which there are no
6447 -- separate specs) the current scope.
6453 or else
6455 then
6461 then
6466 -- An expression function may act as a completion of
6467 -- a function declaration. As such, it can reference
6468 -- entities declared between the two views:
6470 -- Hidden []; -- 1
6471 -- function F return ...;
6472 -- private
6473 -- function Hidden return ...;
6474 -- function F return ... is (Hidden); -- 2
6476 -- Refering to the example above, freezing the expression
6477 -- of F (2) would place Hidden's freeze node (1) in the
6478 -- wrong place. Avoid explicit freezing and let the usual
6479 -- scenarios do the job - for example, reaching the end
6480 -- of the private declarations, or a call to F.
6483 N_Expression_Function
6484 then
6487 -- Freeze outside the body
6489 else
6495 -- Here if normal case where we are in handled statement
6496 -- sequence and want to do the insertion right there.
6498 else
6502 -- If parent is a body or a spec or a block, then the current node
6503 -- is a statement or declaration and we can insert the freeze node
6504 -- before it.
6506 when N_Block_Statement |
6507 N_Entry_Body |
6508 N_Package_Body |
6509 N_Package_Specification |
6510 N_Protected_Body |
6511 N_Subprogram_Body |
6514 -- The expander is allowed to define types in any statements list,
6515 -- so any of the following parent nodes also mark a freezing point
6516 -- if the actual node is in a list of statements or declarations.
6518 when N_Abortable_Part |
6519 N_Accept_Alternative |
6520 N_And_Then |
6521 N_Case_Statement_Alternative |
6522 N_Compilation_Unit_Aux |
6523 N_Conditional_Entry_Call |
6524 N_Delay_Alternative |
6525 N_Elsif_Part |
6526 N_Entry_Call_Alternative |
6527 N_Exception_Handler |
6528 N_Extended_Return_Statement |
6529 N_Freeze_Entity |
6530 N_If_Statement |
6531 N_Or_Else |
6532 N_Selective_Accept |
6533 N_Triggering_Alternative =>
6537 -- Freeze nodes produced by an expression coming from the Actions
6538 -- list of a N_Expression_With_Actions node must remain within the
6539 -- Actions list. Inserting the freeze nodes further up the tree
6540 -- may lead to use before declaration issues in the case of array
6541 -- types.
6546 then
6550 -- Note: N_Loop_Statement is a special case. A type that appears
6551 -- in the source can never be frozen in a loop (this occurs only
6552 -- because of a loop expanded by the expander), so we keep on
6553 -- going. Otherwise we terminate the search. Same is true of any
6554 -- entity which comes from source. (if they have predefined type,
6555 -- that type does not appear to come from source, but the entity
6556 -- should not be frozen here).
6562 -- For all other cases, keep looking at parents
6568 -- We fall through the case if we did not yet find the proper
6569 -- place in the free for inserting the freeze node, so climb.
6574 -- If the expression appears in a record or an initialization procedure,
6575 -- the freeze nodes are collected and attached to the current scope, to
6576 -- be inserted and analyzed on exit from the scope, to insure that
6577 -- generated entities appear in the correct scope. If the expression is
6578 -- a default for a discriminant specification, the scope is still void.
6579 -- The expression can also appear in the discriminant part of a private
6580 -- or concurrent type.
6582 -- If the expression appears in a constrained subcomponent of an
6583 -- enclosing record declaration, the freeze nodes must be attached to
6584 -- the outer record type so they can eventually be placed in the
6585 -- enclosing declaration list.
6587 -- The other case requiring this special handling is if we are in a
6588 -- default expression, since in that case we are about to freeze a
6589 -- static type, and the freeze scope needs to be the outer scope, not
6590 -- the scope of the subprogram with the default parameter.
6592 -- For default expressions and other spec expressions in generic units,
6593 -- the Move_Freeze_Nodes mechanism (see sem_ch12.adb) takes care of
6594 -- placing them at the proper place, after the generic unit.
6597 or else Freeze_Outside
6602 then
6603 declare
6608 begin
6621 -- The current scope may be that of a constrained component of
6622 -- an enclosing record declaration, or of a loop of an enclosing
6623 -- quantified expression, which is above the current scope in the
6624 -- scope stack. Indeed in the context of a quantified expression,
6625 -- a scope is created and pushed above the current scope in order
6626 -- to emulate the loop-like behavior of the quantified expression.
6627 -- If the expression is within a top-level pragma, as for a pre-
6628 -- condition on a library-level subprogram, nothing to do.
6633 N_Quantified_Expression)
6634 then
6641 Freeze_Nodes;
6642 else
6652 -- Now we have the right place to do the freezing. First, a special
6653 -- adjustment, if we are in spec-expression analysis mode, these freeze
6654 -- actions must not be thrown away (normally all inserted actions are
6655 -- thrown away in this mode. However, the freeze actions are from static
6656 -- expressions and one of the important reasons we are doing this
6657 -- special analysis is to get these freeze actions. Therefore we turn
6658 -- off the In_Spec_Expression mode to propagate these freeze actions.
6659 -- This also means they get properly analyzed and expanded.
6663 -- Freeze the designated type of an allocator (RM 13.14(13))
6669 -- Freeze type of expression (RM 13.14(10)). Note that we took care of
6670 -- the enumeration representation clause exception in the loop above.
6676 -- Freeze name if one is present (RM 13.14(11))
6682 -- Restore In_Spec_Expression flag
6687 -----------------------------
6688 -- Freeze_Fixed_Point_Type --
6689 -----------------------------
6691 -- Certain fixed-point types and subtypes, including implicit base types
6692 -- and declared first subtypes, have not yet set up a range. This is
6693 -- because the range cannot be set until the Small and Size values are
6694 -- known, and these are not known till the type is frozen.
6696 -- To signal this case, Scalar_Range contains an unanalyzed syntactic range
6697 -- whose bounds are unanalyzed real literals. This routine will recognize
6698 -- this case, and transform this range node into a properly typed range
6699 -- with properly analyzed and resolved values.
6716 -- Save original bounds (for shaving tests)
6719 -- Actual size chosen
6722 -- Returns size of type with given bounds. Also leaves these
6723 -- bounds set as the current bounds of the Typ.
6725 -----------
6726 -- Fsize --
6727 -----------
6730 begin
6736 -- Start of processing for Freeze_Fixed_Point_Type
6738 begin
6739 -- If Esize of a subtype has not previously been set, set it now
6746 else
6751 -- Immediate return if the range is already analyzed. This means that
6752 -- the range is already set, and does not need to be computed by this
6753 -- routine.
6759 -- Immediate return if either of the bounds raises Constraint_Error
6763 then
6773 -- Ordinary fixed-point case
6777 -- For the ordinary fixed-point case, we are allowed to fudge the
6778 -- end-points up or down by small. Generally we prefer to fudge up,
6779 -- i.e. widen the bounds for non-model numbers so that the end points
6780 -- are included. However there are cases in which this cannot be
6781 -- done, and indeed cases in which we may need to narrow the bounds.
6782 -- The following circuit makes the decision.
6784 -- Note: our terminology here is that Incl_EP means that the bounds
6785 -- are widened by Small if necessary to include the end points, and
6786 -- Excl_EP means that the bounds are narrowed by Small to exclude the
6787 -- end-points if this reduces the size.
6789 -- Note that in the Incl case, all we care about is including the
6790 -- end-points. In the Excl case, we want to narrow the bounds as
6791 -- much as permitted by the RM, to give the smallest possible size.
6808 begin
6809 -- First step. Base types are required to be symmetrical. Right
6810 -- now, the base type range is a copy of the first subtype range.
6811 -- This will be corrected before we are done, but right away we
6812 -- need to deal with the case where both bounds are non-negative.
6813 -- In this case, we set the low bound to the negative of the high
6814 -- bound, to make sure that the size is computed to include the
6815 -- required sign. Note that we do not need to worry about the
6816 -- case of both bounds negative, because the sign will be dealt
6817 -- with anyway. Furthermore we can't just go making such a bound
6818 -- symmetrical, since in a twos-complement system, there is an
6819 -- extra negative value which could not be accommodated on the
6820 -- positive side.
6825 then
6830 -- Compute the fudged bounds. If the number is a model number,
6831 -- then we do nothing to include it, but we are allowed to backoff
6832 -- to the next adjacent model number when we exclude it. If it is
6833 -- not a model number then we straddle the two values with the
6834 -- model numbers on either side.
6840 else
6844 -- The low value excluding the end point is Small greater, but
6845 -- we do not do this exclusion if the low value is positive,
6846 -- since it can't help the size and could actually hurt by
6847 -- crossing the high bound.
6852 -- If the value went from negative to zero, then we have the
6853 -- case where Loval_Incl_EP is the model number just below
6854 -- zero, so we want to stick to the negative value for the
6855 -- base type to maintain the condition that the size will
6856 -- include signed values.
6860 then
6864 else
6868 -- Similar processing for upper bound and high value
6874 else
6880 else
6884 -- One further adjustment is needed. In the case of subtypes, we
6885 -- cannot go outside the range of the base type, or we get
6886 -- peculiarities, and the base type range is already set. This
6887 -- only applies to the Incl values, since clearly the Excl values
6888 -- are already as restricted as they are allowed to be.
6895 -- Get size including and excluding end points
6900 -- No need to exclude end-points if it does not reduce size
6910 -- Now we set the actual size to be used. We want to use the
6911 -- bounds fudged up to include the end-points but only if this
6912 -- can be done without violating a specifically given size
6913 -- size clause or causing an unacceptable increase in size.
6915 -- Case of size clause given
6919 -- Use the inclusive size only if it is consistent with
6920 -- the explicitly specified size.
6927 -- If the inclusive size is too large, we try excluding
6928 -- the end-points (will be caught later if does not work).
6930 else
6936 -- Case of size clause not given
6938 else
6939 -- If we have a base type whose corresponding first subtype
6940 -- has an explicit size that is large enough to include our
6941 -- end-points, then do so. There is no point in working hard
6942 -- to get a base type whose size is smaller than the specified
6943 -- size of the first subtype.
6949 then
6954 -- If excluding the end-points makes the size smaller and
6955 -- results in a size of 8,16,32,64, then we take the smaller
6956 -- size. For the 64 case, this is compulsory. For the other
6957 -- cases, it seems reasonable. We like to include end points
6958 -- if we can, but not at the expense of moving to the next
6959 -- natural boundary of size.
6963 then
6968 -- Otherwise we can definitely include the end points
6970 else
6976 -- One pathological case: normally we never fudge a low bound
6977 -- down, since it would seem to increase the size (if it has
6978 -- any effect), but for ranges containing single value, or no
6979 -- values, the high bound can be small too large. Consider:
6981 -- type t is delta 2.0**(-14)
6982 -- range 131072.0 .. 0;
6984 -- That lower bound is *just* outside the range of 32 bits, and
6985 -- does need fudging down in this case. Note that the bounds
6986 -- will always have crossed here, since the high bound will be
6987 -- fudged down if necessary, as in the case of:
6989 -- type t is delta 2.0**(-14)
6990 -- range 131072.0 .. 131072.0;
6992 -- So we detect the situation by looking for crossed bounds,
6993 -- and if the bounds are crossed, and the low bound is greater
6994 -- than zero, we will always back it off by small, since this
6995 -- is completely harmless.
7002 -- And of course, we need to do exactly the same parallel
7003 -- fudge for flat ranges in the negative region.
7016 -- For the decimal case, none of this fudging is required, since there
7017 -- are no end-point problems in the decimal case (the end-points are
7018 -- always included).
7020 else
7024 -- At this stage, the actual size has been calculated and the proper
7025 -- required bounds are stored in the low and high bounds.
7029 Error_Msg_N
7031 Typ);
7035 -- Check size against explicit given size
7041 Error_Msg_NE
7045 else
7049 -- Increase size to next natural boundary if no size clause given
7051 else
7058 else
7066 -- If we have a base type, then expand the bounds so that they extend to
7067 -- the full width of the allocated size in bits, to avoid junk range
7068 -- checks on intermediate computations.
7075 -- Final step is to reanalyze the bounds using the proper type
7076 -- and set the Corresponding_Integer_Value fields of the literals.
7082 -- Resolve with universal fixed if the base type, and the base type if
7083 -- it is a subtype. Note we can't resolve the base type with itself,
7084 -- that would be a reference before definition.
7088 else
7092 -- Set corresponding integer value for bound
7094 Set_Corresponding_Integer_Value
7097 -- Similar processing for high bound
7105 else
7109 Set_Corresponding_Integer_Value
7112 -- Set type of range to correspond to bounds
7116 -- Set Esize to calculated size if not set already
7122 -- Set RM_Size if not already set. If already set, check value
7124 declare
7127 begin
7132 Error_Msg_NE
7137 else
7142 -- Check for shaving
7146 Error_Msg_N
7148 Error_Msg_N
7153 Error_Msg_N
7155 Error_Msg_N
7161 ------------------
7162 -- Freeze_Itype --
7163 ------------------
7168 begin
7177 --------------------------
7178 -- Freeze_Static_Object --
7179 --------------------------
7184 -- Exception raised if the type of a static object cannot be made
7185 -- static. This happens if the type depends on non-global objects.
7188 -- Called to ensure that an expression used as part of a type definition
7189 -- is statically allocatable, which means that the expression type is
7190 -- statically allocatable, and the expression is either static, or a
7191 -- reference to a library level constant.
7194 -- Called to mark a type as static, checking that it is possible
7195 -- to set the type as static. If it is not possible, then the
7196 -- exception Cannot_Be_Static is raised.
7198 -----------------------------
7199 -- Ensure_Expression_Is_SA --
7200 -----------------------------
7205 begin
7217 then
7225 -----------------------
7226 -- Ensure_Type_Is_SA --
7227 -----------------------
7233 begin
7234 -- If type is library level, we are all set
7240 -- We are also OK if the type already marked as statically allocated,
7241 -- which means we processed it before.
7247 -- Mark type as statically allocated
7251 -- Check that it is safe to statically allocate this type
7269 declare
7273 begin
7285 else
7294 then
7313 else
7318 -- Start of processing for Freeze_Static_Object
7320 begin
7323 exception
7326 -- If the object that cannot be static is imported or exported, then
7327 -- issue an error message saying that this object cannot be imported
7328 -- or exported. If it has an address clause it is an overlay in the
7329 -- current partition and the static requirement is not relevant.
7330 -- Do not issue any error message when ignoring rep clauses.
7337 Error_Msg_N
7341 -- Otherwise must be exported, something is wrong if compiler
7342 -- is marking something as statically allocated which cannot be).
7345 Error_Msg_N
7350 -----------------------
7351 -- Freeze_Subprogram --
7352 -----------------------
7358 begin
7359 -- Subprogram may not have an address clause unless it is imported
7363 Error_Msg_N
7370 -- Reset the Pure indication on an imported subprogram unless an
7371 -- explicit Pure_Function pragma was present or the subprogram is an
7372 -- intrinsic. We do this because otherwise it is an insidious error
7373 -- to call a non-pure function from pure unit and have calls
7374 -- mysteriously optimized away. What happens here is that the Import
7375 -- can bypass the normal check to ensure that pure units call only pure
7376 -- subprograms.
7378 -- The reason for the intrinsic exception is that in general, intrinsic
7379 -- functions (such as shifts) are pure anyway. The only exceptions are
7380 -- the intrinsics in GNAT.Source_Info, and that unit is not marked Pure
7381 -- in any case, so no problem arises.
7387 then
7391 -- For non-foreign convention subprograms, this is where we create
7392 -- the extra formals (for accessibility level and constrained bit
7393 -- information). We delay this till the freeze point precisely so
7394 -- that we know the convention.
7400 -- If this is convention Ada and a Valued_Procedure, that's odd
7405 and then Warn_On_Export_Import
7406 then
7407 Error_Msg_N
7412 -- Case of foreign convention
7414 else
7417 -- For foreign conventions, warn about return of unconstrained array
7422 -- If no return type, probably some other error, e.g. a
7423 -- missing full declaration, so ignore.
7428 -- If the return type is generic, we have emitted a warning
7429 -- earlier on, and there is nothing else to check here. Specific
7430 -- instantiations may lead to erroneous behavior.
7435 -- Display warning if returning unconstrained array
7440 -- Check appropriate warning is enabled (should we check for
7441 -- Warnings (Off) on specific entities here, probably so???)
7443 and then Warn_On_Export_Import
7445 -- Exclude the VM case, since return of unconstrained arrays
7446 -- is properly handled in both the JVM and .NET cases.
7449 then
7450 Error_Msg_N
7457 -- If any of the formals for an exported foreign convention
7458 -- subprogram have defaults, then emit an appropriate warning since
7459 -- this is odd (default cannot be used from non-Ada code)
7464 if Warn_On_Export_Import
7466 then
7467 Error_Msg_N
7477 -- Pragma Inline_Always is disallowed for dispatching subprograms
7478 -- because the address of such subprograms is saved in the dispatch
7479 -- table to support dispatching calls, and dispatching calls cannot
7480 -- be inlined. This is consistent with the restriction against using
7481 -- 'Access or 'Address on an Inline_Always subprogram.
7485 then
7486 Error_Msg_N
7490 -- Because of the implicit representation of inherited predefined
7491 -- operators in the front-end, the overriding status of the operation
7492 -- may be affected when a full view of a type is analyzed, and this is
7493 -- not captured by the analysis of the corresponding type declaration.
7494 -- Therefore the correctness of a not-overriding indicator must be
7495 -- rechecked when the subprogram is frozen.
7499 then
7504 ----------------------
7505 -- Is_Fully_Defined --
7506 ----------------------
7509 begin
7518 then
7519 -- Verify that the record type has no components with private types
7520 -- without completion.
7522 declare
7525 begin
7537 -- For the designated type of an access to subprogram, all types in
7538 -- the profile must be fully defined.
7541 declare
7544 begin
7557 else
7563 ---------------------------------
7564 -- Process_Default_Expressions --
7565 ---------------------------------
7567 procedure Process_Default_Expressions
7570 is
7577 begin
7580 -- A subprogram instance and its associated anonymous subprogram share
7581 -- their signature. The default expression functions are defined in the
7582 -- wrapper packages for the anonymous subprogram, and should not be
7583 -- generated again for the instance.
7588 then
7596 -- We work with a copy of the default expression because we
7597 -- do not want to disturb the original, since this would mess
7598 -- up the conformance checking.
7602 -- The analysis of the expression may generate insert actions,
7603 -- which of course must not be executed. We wrap those actions
7604 -- in a procedure that is not called, and later on eliminated.
7605 -- The following cases have no side-effects, and are analyzed
7606 -- directly.
7610 N_Integer_Literal,
7611 N_Character_Literal,
7612 N_String_Literal,
7613 N_Real_Literal)
7617 then
7618 -- If there is no default function, we must still do a full
7619 -- analyze call on the default value, to ensure that all error
7620 -- checks are performed, e.g. those associated with static
7621 -- evaluation. Note: this branch will always be taken if the
7622 -- analyzer is turned off (but we still need the error checks).
7624 -- Note: the setting of parent here is to meet the requirement
7625 -- that we can only analyze the expression while attached to
7626 -- the tree. Really the requirement is that the parent chain
7627 -- be set, we don't actually need to be in the tree.
7632 -- Default expressions are resolved with their own type if the
7633 -- context is generic, to avoid anomalies with private types.
7637 else
7641 -- If that resolved expression will raise constraint error,
7642 -- then flag the default value as raising constraint error.
7643 -- This allows a proper error message on the calls.
7649 -- If the default is a parameterless call, we use the name of
7650 -- the called function directly, and there is no body to build.
7654 then
7657 -- Else construct and analyze the body of a wrapper procedure
7658 -- that contains an object declaration to hold the expression.
7659 -- Given that this is done only to complete the analysis, it
7660 -- simpler to build a procedure than a function which might
7661 -- involve secondary stack expansion.
7663 else
7666 Dbody :=
7668 Specification =>
7675 Object_Definition =>
7679 Handled_Statement_Sequence =>
7696 ----------------------------------------
7697 -- Set_Component_Alignment_If_Not_Set --
7698 ----------------------------------------
7701 begin
7702 -- Ignore if not base type, subtypes don't need anything
7708 -- Do not override existing representation
7719 else
7720 Set_Component_Alignment
7726 --------------------------
7727 -- Set_SSO_From_Default --
7728 --------------------------
7731 begin
7732 -- Set default SSO for an array or record base type, except in case of
7733 -- a type extension (which always inherits the SSO of its parent type).
7740 then
7742 or else
7745 -- For a record type, if native bit order is specified explicitly,
7746 -- then never set reverse SSO from default.
7748 and then not
7752 then
7753 -- If flags cause reverse storage order, then set the result. Note
7754 -- that we would have ignored the pragma setting the non default
7755 -- storage order in any case, hence the assertion at this point.
7760 -- For a record type, also set reversed bit order. Note that if
7761 -- a bit order has been specified explicitly, then this is a
7762 -- no-op, as per the guard above.
7771 ------------------
7772 -- Undelay_Type --
7773 ------------------
7776 begin
7780 -- Since we don't want T to have a Freeze_Node, we don't want its
7781 -- Full_View or Corresponding_Record_Type to have one either.
7783 -- ??? Fundamentally, this whole handling is unpleasant. What we really
7784 -- want is to be sure that for an Itype that's part of record R and is a
7785 -- subtype of type T, that it's frozen after the later of the freeze
7786 -- points of R and T. We have no way of doing that directly, so what we
7787 -- do is force most such Itypes to be frozen as part of freezing R via
7788 -- this procedure and only delay the ones that need to be delayed
7789 -- (mostly the designated types of access types that are defined as part
7790 -- of the record).
7796 then
7804 then
7809 ------------------
7810 -- Warn_Overlay --
7811 ------------------
7813 procedure Warn_Overlay
7817 is
7819 -- The object to which the address clause applies
7825 begin
7826 -- No warning if address clause overlay warnings are off
7832 -- No warning if there is an explicit initialization
7840 -- We only give the warning for non-imported entities of a type for
7841 -- which a non-null base init proc is defined, or for objects of access
7842 -- types with implicit null initialization, or when Normalize_Scalars
7843 -- applies and the type is scalar or a string type (the latter being
7844 -- tested for because predefined String types are initialized by inline
7845 -- code rather than by an init_proc). Note that we do not give the
7846 -- warning for Initialize_Scalars, since we suppressed initialization
7847 -- in this case. Also, do not warn if Suppress_Initialization is set.
7857 then
7860 then
7865 then
7872 then
7879 -- A function call (most likely to To_Address) is probably not an
7880 -- overlay, so skip warning. Ditto if the function call was inlined
7881 -- and transformed into an entity.
7889 -- If a pragma Import follows, we assume that it is for the current
7890 -- target of the address clause, and skip the warning.
7895 then
7901 Error_Msg_N
7903 Nam);
7904 else
7905 Error_Msg_N
7907 Nam);
7910 -- Add friendly warning if initialization comes from a packed array
7911 -- component.
7914 declare
7917 begin
7922 then
7926 then
7927 Error_Msg_NE
7932 else
7939 Error_Msg_N
7942 Nam);