75995743c04e4f9d3104c7accf2e11636ebee185
[gcc.git] / gcc / ada / einfo.ads
1 ------------------------------------------------------------------------------
2 -- --
3 -- GNAT COMPILER COMPONENTS --
4 -- --
5 -- E I N F O --
6 -- --
7 -- S p e c --
8 -- --
9 -- Copyright (C) 1992-2013, 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. --
17 -- --
18 -- As a special exception under Section 7 of GPL version 3, you are granted --
19 -- additional permissions described in the GCC Runtime Library Exception, --
20 -- version 3.1, as published by the Free Software Foundation. --
21 -- --
22 -- You should have received a copy of the GNU General Public License and --
23 -- a copy of the GCC Runtime Library Exception along with this program; --
24 -- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
25 -- <http://www.gnu.org/licenses/>. --
26 -- --
27 -- GNAT was originally developed by the GNAT team at New York University. --
28 -- Extensive contributions were provided by Ada Core Technologies Inc. --
29 -- --
30 ------------------------------------------------------------------------------
31
32 with Snames; use Snames;
33 with Types; use Types;
34 with Uintp; use Uintp;
35 with Urealp; use Urealp;
36
37 package Einfo is
38
39 -- This package defines the annotations to the abstract syntax tree that
40 -- are needed to support semantic processing of an Ada compilation.
41
42 -- Note that after editing this spec and the corresponding body it is
43 -- required to run ceinfo to check the consistentcy of spec and body.
44 -- See ceinfo.adb for more information about the checks made.
45
46 -- These annotations are for the most part attributes of declared entities,
47 -- and they correspond to conventional symbol table information. Other
48 -- attributes include sets of meanings for overloaded names, possible
49 -- types for overloaded expressions, flags to indicate deferred constants,
50 -- incomplete types, etc. These attributes are stored in available fields
51 -- in tree nodes (i.e. fields not used by the parser, as defined by the
52 -- Sinfo package specification), and accessed by means of a set of
53 -- subprograms which define an abstract interface.
54
55 -- There are two kinds of semantic information
56
57 -- First, the tree nodes with the following Nkind values:
58
59 -- N_Defining_Identifier
60 -- N_Defining_Character_Literal
61 -- N_Defining_Operator_Symbol
62
63 -- are called Entities, and constitute the information that would often
64 -- be stored separately in a symbol table. These nodes are all extended
65 -- to provide extra space, and contain fields which depend on the entity
66 -- kind, as defined by the contents of the Ekind field. The use of the
67 -- Ekind field, and the associated fields in the entity, are defined
68 -- in this package, as are the access functions to these fields.
69
70 -- Second, in some cases semantic information is stored directly in other
71 -- kinds of nodes, e.g. the Etype field, used to indicate the type of an
72 -- expression. The access functions to these fields are defined in the
73 -- Sinfo package, but their full documentation is to be found in
74 -- the Einfo package specification.
75
76 -- Declaration processing places information in the nodes of their defining
77 -- identifiers. Name resolution places in all other occurrences of an
78 -- identifier a pointer to the corresponding defining occurrence.
79
80 --------------------------------
81 -- The XEINFO Utility Program --
82 --------------------------------
83
84 -- XEINFO is a utility program which automatically produces a C header file,
85 -- einfo.h from the spec and body of package Einfo. It reads the input
86 -- files einfo.ads and einfo.adb and produces the output file einfo.h.
87 -- XEINFO is run automatically by the build scripts when you do a full
88 -- bootstrap.
89
90 -- In order for this utility program to operate correctly, the form of the
91 -- einfo.ads and einfo.adb files must meet certain requirements and be laid
92 -- out in a specific manner.
93
94 -- The general form of einfo.ads is as follows:
95
96 -- type declaration for type Entity_Kind
97 -- subtype declarations declaring subranges of Entity_Kind
98 -- subtype declarations declaring synonyms for some standard types
99 -- function specs for attributes
100 -- procedure specs
101 -- pragma Inline declarations
102
103 -- This order must be observed. There are no restrictions on the procedures,
104 -- since the C header file only includes functions (Gigi is not allowed to
105 -- modify the generated tree). However, functions are required to have headers
106 -- that fit on a single line.
107
108 -- XEINFO reads and processes the function specs and the pragma Inlines. For
109 -- functions that are declared as inlined, XEINFO reads the corresponding body
110 -- from einfo.adb, and processes it into C code. This results in some strict
111 -- restrictions on which functions can be inlined:
112
113 -- The function spec must be on a single line
114
115 -- There can only be a single statement, contained on a single line,
116 -- not counting any pragma Assert statements.
117
118 -- This single statement must either be a function call with simple,
119 -- single token arguments, or it must be a membership test of the form
120 -- a in b, where a and b are single tokens.
121
122 -- For functions that are not inlined, there is no restriction on the body,
123 -- and XEINFO generates a direct reference in the C header file which allows
124 -- the C code in Gigi to directly call the corresponding Ada body.
125
126 ----------------------------------
127 -- Handling of Type'Size Values --
128 ----------------------------------
129
130 -- The Ada 95 RM contains some rather peculiar (to us!) rules on the value
131 -- of type'Size (see RM 13.3(55)). We have found that attempting to use
132 -- these RM Size values generally, and in particular for determining the
133 -- default size of objects, creates chaos, and major incompatibilities in
134 -- existing code.
135
136 -- We proceed as follows, for discrete and fixed-point subtypes, we have
137 -- two separate sizes for each subtype:
138
139 -- The Object_Size, which is used for determining the default size of
140 -- objects and components. This size value can be referred to using the
141 -- Object_Size attribute. The phrase "is used" here means that it is
142 -- the basis of the determination of the size. The backend is free to
143 -- pad this up if necessary for efficiency, e.g. an 8-bit stand-alone
144 -- character might be stored in 32 bits on a machine with no efficient
145 -- byte access instructions such as the Alpha.
146
147 -- The default rules for the value of Object_Size for fixed-point and
148 -- discrete types are as follows:
149
150 -- The Object_Size for base subtypes reflect the natural hardware
151 -- size in bits (see Ttypes and Cstand for integer types). For
152 -- enumeration and fixed-point base subtypes have 8. 16. 32 or 64
153 -- bits for this size, depending on the range of values to be stored.
154
155 -- The Object_Size of a subtype is the same as the Object_Size of
156 -- the subtype from which it is obtained.
157
158 -- The Object_Size of a derived base type is copied from the parent
159 -- base type, and the Object_Size of a derived first subtype is copied
160 -- from the parent first subtype.
161
162 -- The Value_Size which is the number of bits required to store a value
163 -- of the type. This size can be referred to using the Value_Size
164 -- attribute. This value is used to determine how tightly to pack
165 -- records or arrays with components of this type, and also affects
166 -- the semantics of unchecked conversion (unchecked conversions where
167 -- the Value_Size values differ generate a warning, and are potentially
168 -- target dependent).
169
170 -- The default rule for the value of Value_Size are as follows:
171
172 -- The Value_Size for a base subtype is the minimum number of bits
173 -- required to store all values of the type (including the sign bit
174 -- only if negative values are possible).
175
176 -- If a subtype statically matches the first subtype, then it has
177 -- by default the same Value_Size as the first subtype. This is a
178 -- consequence of RM 13.1(14) ("if two subtypes statically match,
179 -- then their subtype-specific aspects are the same".)
180
181 -- All other subtypes have a Value_Size corresponding to the minimum
182 -- number of bits required to store all values of the subtype. For
183 -- dynamic bounds, it is assumed that the value can range down or up
184 -- to the corresponding bound of the ancestor
185
186 -- The RM defined attribute Size corresponds to the Value_Size attribute
187
188 -- The Size attribute may be defined for a first-named subtype. This sets
189 -- the Value_Size of the first-named subtype to the given value, and the
190 -- Object_Size of this first-named subtype to the given value padded up
191 -- to an appropriate boundary. It is a consequence of the default rules
192 -- above that this Object_Size will apply to all further subtypes. On the
193 -- other hand, Value_Size is affected only for the first subtype, any
194 -- dynamic subtypes obtained from it directly, and any statically matching
195 -- subtypes. The Value_Size of any other static subtypes is not affected.
196
197 -- Value_Size and Object_Size may be explicitly set for any subtype using
198 -- an attribute definition clause. Note that the use of these attributes
199 -- can cause the RM 13.1(14) rule to be violated. If two access types
200 -- reference aliased objects whose subtypes have differing Object_Size
201 -- values as a result of explicit attribute definition clauses, then it
202 -- is erroneous to convert from one access subtype to the other.
203
204 -- At the implementation level, Esize stores the Object_Size and the
205 -- RM_Size field stores the Value_Size (and hence the value of the
206 -- Size attribute, which, as noted above, is equivalent to Value_Size).
207
208 -- To get a feel for the difference, consider the following examples (note
209 -- that in each case the base is short_short_integer with a size of 8):
210
211 -- Object_Size Value_Size
212
213 -- type x1 is range 0..5; 8 3
214
215 -- type x2 is range 0..5;
216 -- for x2'size use 12; 16 12
217
218 -- subtype x3 is x2 range 0 .. 3; 16 2
219
220 -- subtype x4 is x2'base range 0 .. 10; 8 4
221
222 -- subtype x5 is x2 range 0 .. dynamic; 16 (7)
223
224 -- subtype x6 is x2'base range 0 .. dynamic; 8 (7)
225
226 -- Note: the entries marked (7) are not actually specified by the Ada 95 RM,
227 -- but it seems in the spirit of the RM rules to allocate the minimum number
228 -- of bits known to be large enough to hold the given range of values.
229
230 -- So far, so good, but GNAT has to obey the RM rules, so the question is
231 -- under what conditions must the RM Size be used. The following is a list
232 -- of the occasions on which the RM Size must be used:
233
234 -- Component size for packed arrays or records
235 -- Value of the attribute Size for a type
236 -- Warning about sizes not matching for unchecked conversion
237
238 -- The RM_Size field keeps track of the RM Size as needed in these
239 -- three situations.
240
241 -- For elementary types other than discrete and fixed-point types, the
242 -- Object_Size and Value_Size are the same (and equivalent to the RM
243 -- attribute Size). Only Size may be specified for such types.
244
245 -- For composite types, Object_Size and Value_Size are computed from their
246 -- respective value for the type of each element as well as the layout.
247
248 -- All size attributes are stored as Uint values. Negative values are used to
249 -- reference GCC expressions for the case of non-static sizes, as explained
250 -- in Repinfo.
251
252 --------------------------------------
253 -- Delayed Freezing and Elaboration --
254 --------------------------------------
255
256 -- The flag Has_Delayed_Freeze indicates that an entity carries an explicit
257 -- freeze node, which appears later in the expanded tree.
258
259 -- a) The flag is used by the front-end to trigger expansion actions which
260 -- include the generation of that freeze node. Typically this happens at the
261 -- end of the current compilation unit, or before the first subprogram body is
262 -- encountered in the current unit. See files freeze and exp_ch13 for details
263 -- on the actions triggered by a freeze node, which include the construction
264 -- of initialization procedures and dispatch tables.
265
266 -- b) The presence of a freeze node on an entity is used by the backend to
267 -- defer elaboration of the entity until its freeze node is seen. In the
268 -- absence of an explicit freeze node, an entity is frozen (and elaborated)
269 -- at the point of declaration.
270
271 -- For object declarations, the flag is set when an address clause for the
272 -- object is encountered. Legality checks on the address expression only take
273 -- place at the freeze point of the object.
274
275 -- Most types have an explicit freeze node, because they cannot be elaborated
276 -- until all representation and operational items that apply to them have been
277 -- analyzed. Private types and incomplete types have the flag set as well, as
278 -- do task and protected types.
279
280 -- Implicit base types created for type derivations, as well as classwide
281 -- types created for all tagged types, have the flag set.
282
283 -- If a subprogram has an access parameter whose designated type is incomplete
284 -- the subprogram has the flag set.
285
286 -----------------------
287 -- Entity Attributes --
288 -----------------------
289
290 -- This section contains a complete list of the attributes that are defined
291 -- on entities. Some attributes apply to all entities, others only to certain
292 -- kinds of entities. In the latter case the attribute should only be set or
293 -- accessed if the Ekind field indicates an appropriate entity.
294
295 -- There are two kinds of attributes that apply to entities, stored and
296 -- synthesized. Stored attributes correspond to a field or flag in the entity
297 -- itself. Such attributes are identified in the table below by giving the
298 -- field or flag in the attribute that is used to hold the attribute value.
299 -- Synthesized attributes are not stored directly, but are rather computed as
300 -- needed from other attributes, or from information in the tree. These are
301 -- marked "synthesized" in the table below. The stored attributes have both
302 -- access functions and set procedures to set the corresponding values, while
303 -- synthesized attributes have only access functions.
304
305 -- Note: in the case of Node, Uint, or Elist fields, there are cases where
306 -- the same physical field is used for different purposes in different
307 -- entities, so these access functions should only be referenced for the
308 -- class of entities in which they are defined as being present. Flags are
309 -- not overlapped in this way, but nevertheless as a matter of style and
310 -- abstraction (which may or may not be checked by assertions in the body),
311 -- this restriction should be observed for flag fields as well.
312
313 -- Note: certain of the attributes on types apply only to base types, and
314 -- are so noted by the notation [base type only]. These are cases where the
315 -- attribute of any subtype is the same as the attribute of the base type.
316 -- The attribute can be referenced on a subtype (and automatically retrieves
317 -- the value from the base type). However, it is an error to try to set the
318 -- attribute on other than the base type, and if assertions are enabled,
319 -- an attempt to set the attribute on a subtype will raise an assert error.
320
321 -- Other attributes are noted as applying to the [implementation base type
322 -- only]. These are representation attributes which must always apply to a
323 -- full non-private type, and where the attributes are always on the full
324 -- type. The attribute can be referenced on a subtype (and automatically
325 -- retries the value from the implementation base type). However, it is an
326 -- error to try to set the attribute on other than the implementation base
327 -- type, and if assertions are enabled, an attempt to set the attribute on a
328 -- subtype will raise an assert error.
329
330 -- Abstract_States (Elist25)
331 -- Defined for E_Package entities. Contains a list of all the abstract
332 -- states declared by the related package.
333
334 -- Accept_Address (Elist21)
335 -- Defined in entries. If an accept has a statement sequence, then an
336 -- address variable is created, which is used to hold the address of the
337 -- parameters, as passed by the runtime. Accept_Address holds an element
338 -- list which represents a stack of entities for these address variables.
339 -- The current entry is the top of the stack, which is the last element
340 -- on the list. A stack is required to handle the case of nested select
341 -- statements referencing the same entry.
342
343 -- Access_Disp_Table (Elist16) [implementation base type only]
344 -- Defined in E_Record_Type and E_Record_Subtype entities. Set in tagged
345 -- types to point to their dispatch tables. The first two entities are
346 -- associated with the primary dispatch table: 1) primary dispatch table
347 -- with user-defined primitives 2) primary dispatch table with predefined
348 -- primitives. For each interface type covered by the tagged type we also
349 -- have: 3) secondary dispatch table with thunks of primitives covering
350 -- user-defined interface primitives, 4) secondary dispatch table with
351 -- thunks of predefined primitives, 5) secondary dispatch table with user
352 -- defined primitives, and 6) secondary dispatch table with predefined
353 -- primitives. The last entity of this list is an access type declaration
354 -- used to expand dispatching calls through the primary dispatch table.
355 -- For a non-tagged record, contains No_Elist.
356
357 -- Actual_Subtype (Node17)
358 -- Defined in variables, constants, and formal parameters. This is the
359 -- subtype imposed by the value of the object, as opposed to its nominal
360 -- subtype, which is imposed by the declaration. The actual subtype
361 -- differs from the nominal one when the latter is indefinite (as in the
362 -- case of an unconstrained formal parameter, or a variable declared
363 -- with an unconstrained type and an initial value). The nominal subtype
364 -- is the Etype entry for the entity. The Actual_Subtype field is set
365 -- only if the actual subtype differs from the nominal subtype. If the
366 -- actual and nominal subtypes are the same, then the Actual_Subtype
367 -- field is Empty, and Etype indicates both types.
368 --
369 -- For objects, the Actual_Subtype is set only if this is a discriminated
370 -- type. For arrays, the bounds of the expression are obtained and the
371 -- Etype of the object is directly the constrained subtype. This is
372 -- rather irregular, and the semantic checks that depend on the nominal
373 -- subtype being unconstrained use flag Is_Constr_Subt_For_U_Nominal(qv).
374
375 -- Address_Clause (synthesized)
376 -- Applies to entries, objects and subprograms. Set if an address clause
377 -- is present which references the object or subprogram and points to
378 -- the N_Attribute_Definition_Clause node. Empty if no Address clause.
379 -- The expression in the address clause is always a constant that is
380 -- defined before the entity to which the address clause applies.
381 -- Note: Gigi references this field in E_Task_Type entities???
382
383 -- Address_Taken (Flag104)
384 -- Defined in all entities. Set if the Address or Unrestricted_Access
385 -- attribute is applied directly to the entity, i.e. the entity is the
386 -- entity of the prefix of the attribute reference. Also set if the
387 -- entity is the second argument of an Asm_Input or Asm_Output attribute,
388 -- as the construct may entail taking its address. Used by Gigi to make
389 -- sure that the address can be meaningfully taken, and also in the case
390 -- of subprograms to control output of certain warnings.
391
392 -- Aft_Value (synthesized)
393 -- Applies to fixed and decimal types. Computes a universal integer
394 -- that holds value of the Aft attribute for the type.
395
396 -- Alias (Node18)
397 -- Defined in overloadable entities (literals, subprograms, entries) and
398 -- subprograms that cover a primitive operation of an abstract interface
399 -- (that is, subprograms with the Interface_Alias attribute). In case of
400 -- overloaded entities it points to the parent subprogram of a derived
401 -- subprogram. In case of abstract interface subprograms it points to the
402 -- subprogram that covers the abstract interface primitive. Also used for
403 -- a subprogram renaming, where it points to the renamed subprogram. For
404 -- an inherited operation (of a type extension) that is overridden in a
405 -- private part, the Alias is the overriding operation. In this fashion a
406 -- call from outside the package ends up executing the new body even if
407 -- non-dispatching, and a call from inside calls the overriding operation
408 -- because it hides the implicit one. Alias is always empty for entries.
409
410 -- Alignment (Uint14)
411 -- Defined in entities for types and also in constants, variables
412 -- (including exceptions where it refers to the static data allocated for
413 -- an exception), loop parameters, and formal parameters. This indicates
414 -- the desired alignment for a type, or the actual alignment for an
415 -- object. A value of zero (Uint_0) indicates that the alignment has not
416 -- been set yet. The alignment can be set by an explicit alignment
417 -- clause, or set by the front-end in package Layout, or set by the
418 -- back-end as part of the back end back-annotation process. The
419 -- alignment field is also defined in E_Exception entities, but there it
420 -- is used only by the back-end for back annotation.
421
422 -- Alignment_Clause (synthesized)
423 -- Applies to all entities for types and objects. If an alignment
424 -- attribute definition clause is present for the entity, then this
425 -- function returns the N_Attribute_Definition clause that specifies the
426 -- alignment. If no alignment clause applies to the type, then the call
427 -- to this function returns Empty. Note that the call can return a
428 -- non-Empty value even if Has_Alignment_Clause is not set (happens with
429 -- subtype and derived type declarations). Note also that a record
430 -- definition clause with an (obsolescent) mod clause is converted
431 -- into an attribute definition clause for this purpose.
432
433 -- Associated_Formal_Package (Node12)
434 -- Defined in packages that are the actuals of formal_packages. Points
435 -- to the entity in the declaration for the formal package.
436
437 -- Associated_Node_For_Itype (Node8)
438 -- Defined in all type and subtype entities. Set non-Empty only for
439 -- Itypes. Set to point to the associated node for the Itype, i.e.
440 -- the node whose elaboration generated the Itype. This is used for
441 -- copying trees, to determine whether or not to copy an Itype, and
442 -- also for accessibility checks on anonymous access types. This
443 -- node is typically an object declaration, component declaration,
444 -- type or subtype declaration. For an access discriminant in a type
445 -- declaration, the associated_node_for_itype is the discriminant
446 -- specification. For an access parameter it is the enclosing subprogram
447 -- declaration.
448 --
449 -- Itypes have no explicit declaration, and therefore are not attached to
450 -- the tree: their Parent field is always empty. The Associated_Node_For_
451 -- Itype is the only way to determine the construct that leads to the
452 -- creation of a given itype entity.
453
454 -- Associated_Storage_Pool (Node22) [root type only]
455 -- Defined in simple and general access type entities. References the
456 -- storage pool to be used for the corresponding collection. A value of
457 -- Empty means that the default pool is to be used. This is defined
458 -- only in the root type, since derived types must have the same pool
459 -- as the parent type.
460
461 -- Barrier_Function (Node12)
462 -- Defined in protected entries and entry families. This is the
463 -- subprogram declaration for the body of the function that returns
464 -- the value of the entry barrier.
465
466 -- Base_Type (synthesized)
467 -- Applies to all type and subtype entities. Returns the base type of a
468 -- type or subtype. The base type of a type is the type itself. The base
469 -- type of a subtype is the type that it constrains (which is always
470 -- a type entity, not some other subtype). Note that in the case of a
471 -- subtype of a private type, it is possible for the base type attribute
472 -- to return a private type, even if the subtype to which it applies is
473 -- non-private. See also Implementation_Base_Type. Note: it is allowed to
474 -- apply Base_Type to other than a type, in which case it simply returns
475 -- the entity unchanged.
476
477 -- Block_Node (Node11)
478 -- Defined in block entities. Points to the identifier in the
479 -- Block_Statement itself. Used when retrieving the block construct
480 -- for finalization purposes, The block entity has an implicit label
481 -- declaration in the enclosing declarative part, and has otherwise
482 -- no direct connection in the tree with the block statement. The
483 -- link is to the identifier (which is an occurrence of the entity)
484 -- and not to the block_statement itself, because the statement may
485 -- be rewritten, e.g. in the process of removing dead code.
486
487 -- Body_Entity (Node19)
488 -- Defined in package and generic package entities, points to the
489 -- corresponding package body entity if one is present.
490
491 -- Body_Needed_For_SAL (Flag40)
492 -- Defined in package and subprogram entities that are compilation
493 -- units. Indicates that the source for the body must be included
494 -- when the unit is part of a standalone library.
495
496 -- Body_References (Elist16)
497 -- Defined in abstract state entities. Only set if Has_Body_References
498 -- flag is set True, in which case it contains an element list of global
499 -- references (identifiers) in the current package body to this abstract
500 -- state that are illegal if the abstract state has a visible refinement.
501
502 -- C_Pass_By_Copy (Flag125) [implementation base type only]
503 -- Defined in record types. Set if a pragma Convention for the record
504 -- type specifies convention C_Pass_By_Copy. This convention name is
505 -- treated as identical in all respects to convention C, except that
506 -- if it is specified for a record type, then the C_Pass_By_Copy flag
507 -- is set, and if a foreign convention subprogram has a formal of the
508 -- corresponding type, then the parameter passing mechanism will be
509 -- set to By_Copy (unless specifically overridden by an Import or
510 -- Export pragma).
511
512 -- Can_Never_Be_Null (Flag38)
513 -- This flag is defined in all entities, but can only be set in an object
514 -- which can never have a null value. Set for constant access values
515 -- initialized to a non-null value. This is also set for all access
516 -- parameters in Ada 83 and Ada 95 modes, and for access parameters
517 -- that explicitly exclude null in Ada 2005.
518 --
519 -- This is used to avoid unnecessary resetting of the Is_Known_Non_Null
520 -- flag for such entities. In Ada 2005 mode, this is also used when
521 -- determining subtype conformance of subprogram profiles to ensure
522 -- that two formals have the same null-exclusion status.
523 --
524 -- ??? This is also set on some access types, eg the Etype of the
525 -- anonymous access type of a controlling formal.
526
527 -- Can_Use_Internal_Rep (Flag229) [base type only]
528 -- Defined in Access_Subprogram_Kind nodes. This flag is set by the
529 -- front end and used by the back end. False means that the back end
530 -- must represent the type in the same way as Convention-C types (and
531 -- other foreign-convention types). On many targets, this means that
532 -- the back end will use dynamically generated trampolines for nested
533 -- subprograms. True means that the back end can represent the type in
534 -- some internal way. On the aforementioned targets, this means that the
535 -- back end will not use dynamically generated trampolines. This flag
536 -- must be False if Has_Foreign_Convention is True; otherwise, the front
537 -- end is free to set the policy.
538 --
539 -- Setting this False in all cases corresponds to the traditional back
540 -- end strategy, where all access-to-subprogram types are represented the
541 -- same way, independent of the Convention. For further details, see also
542 -- Always_Compatible_Rep in Targparm.
543 --
544 -- Efficiency note: On targets that use dynamically generated
545 -- trampolines, False generally favors efficiency of top-level
546 -- subprograms, whereas True generally favors efficiency of nested
547 -- ones. On other targets, this flag has little or no effect on
548 -- efficiency. The front end should take this into account. In
549 -- particular, pragma Favor_Top_Level gives a hint that the flag
550 -- should be False.
551 --
552 -- Note: We considered using Convention-C for this purpose, but we need
553 -- this separate flag, because Convention-C implies that in the case of
554 -- P'[Unrestricted_]Access, P also have convention C. Sometimes we want
555 -- to have Can_Use_Internal_Rep False for an access type, but allow P to
556 -- have convention Ada.
557
558 -- Chars (Name1)
559 -- Defined in all entities. This field contains an entry into the names
560 -- table that has the character string of the identifier, character
561 -- literal or operator symbol. See Namet for further details. Note that
562 -- throughout the processing of the front end, this name is the simple
563 -- unqualified name. However, just before gigi is called, a call is made
564 -- to Qualify_All_Entity_Names. This causes entity names to be qualified
565 -- using the encoding described in exp_dbug.ads, and from that point on
566 -- (including post gigi steps such as cross-reference generation), the
567 -- entities will contain the encoded qualified names.
568
569 -- Checks_May_Be_Suppressed (Flag31)
570 -- Defined in all entities. Set if a pragma Suppress or Unsuppress
571 -- mentions the entity specifically in the second argument. If this
572 -- flag is set the Global_Entity_Suppress and Local_Entity_Suppress
573 -- tables must be consulted to determine if there actually is an active
574 -- Suppress or Unsuppress pragma that applies to the entity.
575
576 -- Class_Wide_Type (Node9)
577 -- Defined in all type entities. For a tagged type or subtype, returns
578 -- the corresponding implicitly declared class-wide type. For a
579 -- class-wide type, returns itself. Set to Empty for non-tagged types.
580
581 -- Cloned_Subtype (Node16)
582 -- Defined in E_Record_Subtype and E_Class_Wide_Subtype entities.
583 -- Each such entity can either have a Discriminant_Constraint, in
584 -- which case it represents a distinct type from the base type (and
585 -- will have a list of components and discrimants in the list headed by
586 -- First_Entity) or else no such constraint, in which case it will be a
587 -- copy of the base type.
588 --
589 -- o Each element of the list in First_Entity is copied from the base
590 -- type; in that case, this field is Empty.
591 --
592 -- o The list in First_Entity is shared with the base type; in that
593 -- case, this field points to that entity.
594 --
595 -- A record or classwide subtype may also be a copy of some other
596 -- subtype and share the entities in the First_Entity with that subtype.
597 -- In that case, this field points to that subtype.
598 --
599 -- For E_Class_Wide_Subtype, the presence of Equivalent_Type overrides
600 -- this field. Note that this field ONLY appears in subtype entries, not
601 -- in type entries, it is not defined, and it is an error to reference
602 -- Cloned_Subtype in an E_Record_Type or E_Class_Wide_Type entity.
603
604 -- Comes_From_Source
605 -- This flag appears on all nodes, including entities, and indicates
606 -- that the node was created by the scanner or parser from the original
607 -- source. Thus for entities, it indicates that the entity is defined
608 -- in the original source program.
609
610 -- Component_Alignment (special field) [base type only]
611 -- Defined in array and record entities. Contains a value of type
612 -- Component_Alignment_Kind indicating the alignment of components.
613 -- Set to Calign_Default normally, but can be overridden by use of
614 -- the Component_Alignment pragma. Note: this field is currently
615 -- stored in a non-standard way, see body for details.
616
617 -- Component_Bit_Offset (Uint11)
618 -- Defined in record components (E_Component, E_Discriminant) if a
619 -- component clause applies to the component. First bit position of
620 -- given component, computed from the first bit and position values
621 -- given in the component clause. A value of No_Uint means that the
622 -- value is not yet known. The value can be set by the appearance of
623 -- an explicit component clause in a record representation clause,
624 -- or it can be set by the front-end in package Layout, or it can be
625 -- set by the backend. By the time backend processing is completed,
626 -- this field is always set. A negative value is used to represent
627 -- a value which is not known at compile time, and must be computed
628 -- at run-time (this happens if fields of a record have variable
629 -- lengths). See package Layout for details of these values.
630 --
631 -- Note: Component_Bit_Offset is redundant with respect to the fields
632 -- Normalized_First_Bit and Normalized_Position, and could in principle
633 -- be eliminated, but it is convenient in several situations, including
634 -- use in Gigi, to have this redundant field.
635
636 -- Component_Clause (Node13)
637 -- Defined in record components and discriminants. If a record
638 -- representation clause is present for the corresponding record type a
639 -- that specifies a position for the component, then the Component_Clause
640 -- field of the E_Component entity points to the N_Component_Clause node.
641 -- Set to Empty if no record representation clause was present, or if
642 -- there was no specification for this component.
643
644 -- Component_Size (Uint22) [implementation base type only]
645 -- Defined in array types. It contains the component size value for
646 -- the array. A value of No_Uint means that the value is not yet set.
647 -- The value can be set by the use of a component size clause, or
648 -- by the front end in package Layout, or by the backend. A negative
649 -- value is used to represent a value which is not known at compile
650 -- time, and must be computed at run-time (this happens if the type
651 -- of the component has a variable length size). See package Layout
652 -- for details of these values.
653
654 -- Component_Type (Node20) [implementation base type only]
655 -- Defined in array types and string types. References component type.
656
657 -- Corresponding_Concurrent_Type (Node18)
658 -- Defined in record types that are constructed by the expander to
659 -- represent task and protected types (Is_Concurrent_Record_Type flag
660 -- set). Points to the entity for the corresponding task type or the
661 -- protected type.
662
663 -- Corresponding_Discriminant (Node19)
664 -- Defined in discriminants of a derived type, when the discriminant is
665 -- used to constrain a discriminant of the parent type. Points to the
666 -- corresponding discriminant in the parent type. Otherwise it is Empty.
667
668 -- Corresponding_Equality (Node30)
669 -- Defined in function entities for implicit inequality operators.
670 -- Denotes the explicit or derived equality operation that creates
671 -- the implicit inequality. Note that this field is not present in
672 -- other function entities, only in implicit inequality routines,
673 -- where Comes_From_Source is always False.
674
675 -- Corresponding_Protected_Entry (Node18)
676 -- Defined in subprogram bodies. Set for subprogram bodies that implement
677 -- a protected type entry to point to the entity for the entry.
678
679 -- Corresponding_Record_Type (Node18)
680 -- Defined in protected and task types and subtypes. References the
681 -- entity for the corresponding record type constructed by the expander
682 -- (see Exp_Ch9). This type is used to represent values of the task type.
683
684 -- Corresponding_Remote_Type (Node22)
685 -- Defined in record types that describe the fat pointer structure for
686 -- Remote_Access_To_Subprogram types. References the original access
687 -- to subprogram type.
688
689 -- CR_Discriminant (Node23)
690 -- Defined in discriminants of concurrent types. Denotes the homologous
691 -- discriminant of the corresponding record type. The CR_Discriminant is
692 -- created at the same time as the discriminal, and used to replace
693 -- occurrences of the discriminant within the type declaration.
694
695 -- Current_Use_Clause (Node27)
696 -- Defined in packages and in types. For packages, denotes the use
697 -- package clause currently in scope that makes the package use_visible.
698 -- For types, it denotes the use_type clause that makes the operators of
699 -- the type visible. Used for more precise warning messages on redundant
700 -- use clauses.
701
702 -- Current_Value (Node9)
703 -- Defined in all object entities. Set in E_Variable, E_Constant, formal
704 -- parameters and E_Loop_Parameter entities if we have trackable current
705 -- values. Set non-Empty if the (constant) current value of the variable
706 -- is known, This value is valid only for references from the same
707 -- sequential scope as the entity. The sequential scope of an entity
708 -- includes the immediate scope and any contained scopes that are package
709 -- specs, package bodies, blocks (at any nesting level) or statement
710 -- sequences in IF or loop statements.
711 --
712 -- Another related use of this field is to record information about the
713 -- value obtained from an IF or WHILE statement condition. If the IF or
714 -- ELSIF or WHILE condition has the form "NOT {,NOT] OBJ RELOP VAL ",
715 -- or OBJ [AND [THEN]] expr, where OBJ refers to an entity with a
716 -- Current_Value field, RELOP is one of the six relational operators, and
717 -- VAL is a compile-time known value then the Current_Value field of OBJ
718 -- points to the N_If_Statement, N_Elsif_Part, or N_Iteration_Scheme node
719 -- of the relevant construct, and the Condition field of this can be
720 -- consulted to give information about the value of OBJ. For more details
721 -- on this usage, see the procedure Exp_Util.Get_Current_Value_Condition.
722
723 -- Debug_Info_Off (Flag166)
724 -- Defined in all entities. Set if a pragma Suppress_Debug_Info applies
725 -- to the entity, or if internal processing in the compiler determines
726 -- that suppression of debug information is desirable. Note that this
727 -- flag is only for use by the front end as part of the processing for
728 -- determining if Needs_Debug_Info should be set. The back end should
729 -- always test Needs_Debug_Info, it should never test Debug_Info_Off.
730
731 -- Debug_Renaming_Link (Node25)
732 -- Used to link the variable associated with a debug renaming declaration
733 -- to the renamed entity. See Exp_Dbug.Debug_Renaming_Declaration for
734 -- details of the use of this field.
735
736 -- Declaration_Node (synthesized)
737 -- Applies to all entities. Returns the tree node for the construct that
738 -- declared the entity. Normally this is just the Parent of the entity.
739 -- One exception arises with child units, where the parent of the entity
740 -- is a selected component/defining program unit name. Another exception
741 -- is that if the entity is an incomplete type that has been completed or
742 -- a private type, then we obtain the declaration node denoted by the
743 -- full type, i.e. the full type declaration node. Also note that for
744 -- subprograms, this returns the {function,procedure}_specification, not
745 -- the subprogram_declaration.
746
747 -- Default_Aspect_Component_Value (Node19) [base type only]
748 -- Defined in array types. Holds the static value specified in a
749 -- Default_Component_Value aspect specification for the array type.
750
751 -- Default_Aspect_Value (Node19) [base type only]
752 -- Defined in scalar types. Holds the static value specified in a
753 -- Default_Value aspect specification for the type.
754
755 -- Default_Expr_Function (Node21)
756 -- Defined in parameters. It holds the entity of the parameterless
757 -- function that is built to evaluate the default expression if it is
758 -- more complex than a simple identifier or literal. For the latter
759 -- simple cases or if there is no default value, this field is Empty.
760
761 -- Default_Expressions_Processed (Flag108)
762 -- A flag in subprograms (functions, operators, procedures) and in
763 -- entries and entry families used to indicate that default expressions
764 -- have been processed and to avoid multiple calls to process the
765 -- default expressions (see Freeze.Process_Default_Expressions), which
766 -- would not only waste time, but also generate false error messages.
767
768 -- Default_Value (Node20)
769 -- Defined in formal parameters. Points to the node representing the
770 -- expression for the default value for the parameter. Empty if the
771 -- parameter has no default value (which is always the case for OUT
772 -- and IN OUT parameters in the absence of errors).
773
774 -- Delay_Cleanups (Flag114)
775 -- Defined in entities that have finalization lists (subprograms
776 -- blocks, and tasks). Set if there are pending generic body
777 -- instantiations for the corresponding entity. If this flag is
778 -- set, then generation of cleanup actions for the corresponding
779 -- entity must be delayed, since the insertion of the generic body
780 -- may affect cleanup generation (see Inline for further details).
781
782 -- Delay_Subprogram_Descriptors (Flag50)
783 -- Defined in entities for which exception subprogram descriptors
784 -- are generated (subprograms, package declarations and package
785 -- bodies). Defined if there are pending generic body instantiations
786 -- for the corresponding entity. If this flag is set, then generation
787 -- of the subprogram descriptor for the corresponding enities must
788 -- be delayed, since the insertion of the generic body may add entries
789 -- to the list of handlers.
790 --
791 -- Note: for subprograms, Delay_Subprogram_Descriptors is set if and
792 -- only if Delay_Cleanups is set. But Delay_Cleanups can be set for a
793 -- a block (in which case Delay_Subprogram_Descriptors is set for the
794 -- containing subprogram). In addition Delay_Subprogram_Descriptors is
795 -- set for a library level package declaration or body which contains
796 -- delayed instantiations (in this case the descriptor refers to the
797 -- enclosing elaboration procedure).
798
799 -- Delta_Value (Ureal18)
800 -- Defined in fixed and decimal types. Points to a universal real
801 -- that holds value of delta for the type, as given in the declaration
802 -- or as inherited by a subtype or derived type.
803
804 -- Dependent_Instances (Elist8)
805 -- Defined in packages that are instances. Holds list of instances
806 -- of inner generics. Used to place freeze nodes for those instances
807 -- after that of the current one, i.e. after the corresponding generic
808 -- bodies.
809
810 -- Depends_On_Private (Flag14)
811 -- Defined in all type entities. Set if the type is private or if it
812 -- depends on a private type.
813
814 -- Designated_Type (synthesized)
815 -- Applies to access types. Returns the designated type. Differs
816 -- from Directly_Designated_Type in that if the access type refers
817 -- to an incomplete type, and the full type is available, then this
818 -- full type is returned instead of the incomplete type.
819
820 -- Digits_Value (Uint17)
821 -- Defined in floating point types and subtypes and decimal types and
822 -- subtypes. Contains the Digits value specified in the declaration.
823
824 -- Direct_Primitive_Operations (Elist10)
825 -- Defined in tagged types and subtypes (including synchronized types),
826 -- in tagged private types and in tagged incomplete types. Element list
827 -- of entities for primitive operations of the tagged type. Not defined
828 -- in untagged types. In order to follow the C++ ABI, entities of
829 -- primitives that come from source must be stored in this list in the
830 -- order of their occurrence in the sources. For incomplete types the
831 -- list is always empty.
832
833 -- Directly_Designated_Type (Node20)
834 -- Defined in access types. This field points to the type that is
835 -- directly designated by the access type. In the case of an access
836 -- type to an incomplete type, this field references the incomplete
837 -- type. Directly_Designated_Type is typically used in implementing the
838 -- static semantics of the language; in implementing dynamic semantics,
839 -- we typically want the full view of the designated type. The function
840 -- Designated_Type obtains this full type in the case of access to an
841 -- incomplete type.
842
843 -- Discard_Names (Flag88)
844 -- Defined in types and exception entities. Set if pragma Discard_Names
845 -- applies to the entity. It is also set for declarative regions and
846 -- package specs for which a Discard_Names pragma with zero arguments
847 -- has been encountered. The purpose of setting this flag is to be able
848 -- to set the Discard_Names attribute on enumeration types declared
849 -- after the pragma within the same declarative region. This flag is
850 -- set to False if a Keep_Names pragma appears for an enumeration type.
851
852 -- Discriminal (Node17)
853 -- Defined in discriminants (Discriminant formal: GNAT's first
854 -- coinage). The entity used as a formal parameter that corresponds
855 -- to a discriminant. See section "Handling of Discriminants" for
856 -- full details of the use of discriminals.
857
858 -- Discriminal_Link (Node10)
859 -- Defined in E_In_Parameter or E_Constant entities. For discriminals,
860 -- points back to corresponding discriminant. For other entities, must
861 -- remain Empty.
862
863 -- Discriminant_Checking_Func (Node20)
864 -- Defined in components. Points to the defining identifier of the
865 -- function built by the expander returns a Boolean indicating whether
866 -- the given record component exists for the current discriminant
867 -- values.
868
869 -- Discriminant_Constraint (Elist21)
870 -- Defined in entities whose Has_Discriminants flag is set (concurrent
871 -- types, subtypes, record types and subtypes, private types and
872 -- subtypes, limited private types and subtypes and incomplete types).
873 -- It is an error to reference the Discriminant_Constraint field if
874 -- Has_Discriminants is False.
875 --
876 -- If the Is_Constrained flag is set, Discriminant_Constraint points
877 -- to an element list containing the discriminant constraints in the
878 -- same order in which the discriminants are declared.
879 --
880 -- If the Is_Constrained flag is not set but the discriminants of the
881 -- unconstrained type have default initial values then this field
882 -- points to an element list giving these default initial values in
883 -- the same order in which the discriminants are declared. Note that
884 -- in this case the entity cannot be a tagged record type, because
885 -- discriminants in this case cannot have defaults.
886 --
887 -- If the entity is a tagged record implicit type, then this field is
888 -- inherited from the first subtype (so that the itype is subtype
889 -- conformant with its first subtype, which is needed when the first
890 -- subtype overrides primitive operations inherited by the implicit
891 -- base type).
892 --
893 -- In all other cases Discriminant_Constraint contains the empty
894 -- Elist (ie it is initialized with a call to New_Elmt_List).
895
896 -- Discriminant_Default_Value (Node20)
897 -- Defined in discriminants. Points to the node representing the
898 -- expression for the default value of the discriminant. Set to
899 -- Empty if the discriminant has no default value.
900
901 -- Discriminant_Number (Uint15)
902 -- Defined in discriminants. Gives the ranking of a discriminant in
903 -- the list of discriminants of the type, i.e. a sequential integer
904 -- index starting at 1 and ranging up to number of discriminants.
905
906 -- Dispatch_Table_Wrappers (Elist26) [implementation base type only]
907 -- Defined in E_Record_Type and E_Record_Subtype entities. Set in library
908 -- level tagged type entities if we are generating statically allocated
909 -- dispatch tables. Points to the list of dispatch table wrappers
910 -- associated with the tagged type. For a non-tagged record, contains
911 -- No_Elist.
912
913 -- DTC_Entity (Node16)
914 -- Defined in function and procedure entities. Set to Empty unless
915 -- the subprogram is dispatching in which case it references the
916 -- Dispatch Table pointer Component. For regular Ada tagged this, this
917 -- is the _Tag component. For CPP_Class types and their descendants,
918 -- this points to the component entity in the record that holds the
919 -- Vtable pointer for the Vtable containing the entry referencing the
920 -- subprogram.
921
922 -- DT_Entry_Count (Uint15)
923 -- Defined in E_Component entities. Only used for component marked
924 -- Is_Tag. Store the number of entries in the Vtable (or Dispatch Table)
925
926 -- DT_Offset_To_Top_Func (Node25)
927 -- Defined in E_Component entities. Only used for component marked
928 -- Is_Tag. If present it stores the Offset_To_Top function used to
929 -- provide this value in tagged types whose ancestor has discriminants.
930
931 -- DT_Position (Uint15)
932 -- Defined in function and procedure entities which are dispatching
933 -- (should not be referenced without first checking that flag
934 -- Is_Dispatching_Operation is True). Contains the offset into
935 -- the Vtable for the entry that references the subprogram.
936
937 -- Ekind (Ekind)
938 -- Defined in all entities. Contains a value of the enumeration type
939 -- Entity_Kind declared in a subsequent section in this spec.
940
941 -- Elaborate_Body_Desirable (Flag210)
942 -- Defined in package entities. Set if the elaboration circuitry detects
943 -- a case where there is a package body that modifies one or more visible
944 -- entities in the package spec and there is no explicit Elaborate_Body
945 -- pragma for the package. This information is passed on to the binder,
946 -- which attempts, but does not promise, to elaborate the body as close
947 -- to the spec as possible.
948
949 -- Elaboration_Entity (Node13)
950 -- Defined in generic and non-generic package and subprogram entities.
951 -- This is a counter associated with the unit that is initially set to
952 -- zero, is incremented when an elaboration request for the unit is
953 -- made, and is decremented when a finalization request for the unit
954 -- is made. This is used for three purposes. First, it is used to
955 -- implement access before elaboration checks (the counter must be
956 -- non-zero to call a subprogram at elaboration time). Second, it is
957 -- used to guard against repeated execution of the elaboration code.
958 -- Third, it is used to ensure that the finalization code is executed
959 -- only after all clients have requested it.
960 --
961 -- Note that we always allocate this counter, and set this field, but
962 -- we do not always actually use it. It is only used if it is needed
963 -- for access before elaboration use (see Elaboration_Entity_Required
964 -- flag) or if either the spec or the body has elaboration code. If
965 -- neither of these two conditions holds, then the entity is still
966 -- allocated (since we don't know early enough whether or not there
967 -- is elaboration code), but is simply not used for any purpose.
968
969 -- Elaboration_Entity_Required (Flag174)
970 -- Defined in generic and non-generic package and subprogram entities.
971 -- Set only if Elaboration_Entity is non-Empty to indicate that the
972 -- counter is required to be non-zero even if there is no other
973 -- elaboration code. This occurs when the Elaboration_Entity counter
974 -- is used for access before elaboration checks. If the counter is
975 -- only used to prevent multiple execution of the elaboration code,
976 -- then if there is no other elaboration code, obviously there is no
977 -- need to set the flag.
978
979 -- Enclosing_Scope (Node18)
980 -- Defined in labels. Denotes the innermost enclosing construct that
981 -- contains the label. Identical to the scope of the label, except for
982 -- labels declared in the body of an accept statement, in which case the
983 -- entry_name is the Enclosing_Scope. Used to validate goto's within
984 -- accept statements.
985
986 -- Entry_Accepted (Flag152)
987 -- Defined in E_Entry and E_Entry_Family entities. Set if there is
988 -- at least one accept for this entry in the task body. Used to
989 -- generate warnings for missing accepts.
990
991 -- Entry_Bodies_Array (Node15)
992 -- Defined in protected types for which Has_Entries is true.
993 -- This is the defining identifier for the array of entry body
994 -- action procedures and barrier functions used by the runtime to
995 -- execute the user code associated with each entry.
996
997 -- Entry_Cancel_Parameter (Node23)
998 -- Defined in blocks. This only applies to a block statement for
999 -- which the Is_Asynchronous_Call_Block flag is set. It
1000 -- contains the defining identifier of an object that must be
1001 -- passed to the Cancel_Task_Entry_Call or Cancel_Protected_Entry_Call
1002 -- call in the cleanup handler added to the block by
1003 -- Exp_Ch7.Expand_Cleanup_Actions. This parameter is a Boolean
1004 -- object for task entry calls and a Communications_Block object
1005 -- in the case of protected entry calls. In both cases the objects
1006 -- are declared in outer scopes to this block.
1007
1008 -- Entry_Component (Node11)
1009 -- Defined in formal parameters (in, in out and out parameters). Used
1010 -- only for formals of entries. References the corresponding component
1011 -- of the entry parameter record for the entry.
1012
1013 -- Entry_Formal (Node16)
1014 -- Defined in components of the record built to correspond to entry
1015 -- parameters. This field points from the component to the formal. It
1016 -- is the back pointer corresponding to Entry_Component.
1017
1018 -- Entry_Index_Constant (Node18)
1019 -- Defined in an entry index parameter. This is an identifier that
1020 -- eventually becomes the name of a constant representing the index
1021 -- of the entry family member whose entry body is being executed. Used
1022 -- to expand references to the entry index specification identifier.
1023
1024 -- Entry_Index_Type (synthesized)
1025 -- Applies to an entry family. Denotes Etype of the subtype indication
1026 -- in the entry declaration. Used to resolve the index expression in an
1027 -- accept statement for a member of the family, and in the prefix of
1028 -- 'COUNT when it applies to a family member.
1029
1030 -- Contract (Node34)
1031 -- Defined in entry, entry family, package, package body, subprogram and
1032 -- subprogram body entities as well as their respective generic forms. A
1033 -- contract is also applicable to a variable. Points to the contract of
1034 -- the entity, holding various assertion items and data classifiers.
1035
1036 -- Entry_Parameters_Type (Node15)
1037 -- Defined in entries. Points to the access-to-record type that is
1038 -- constructed by the expander to hold a reference to the parameter
1039 -- values. This reference is manipulated (as an address) by the
1040 -- tasking runtime. The designated record represents a packaging
1041 -- up of the entry parameters (see Exp_Ch9.Expand_N_Entry_Declaration
1042 -- for further details). Entry_Parameters_Type is Empty if the entry
1043 -- has no parameters.
1044
1045 -- Enumeration_Pos (Uint11)
1046 -- Defined in enumeration literals. Contains the position number
1047 -- corresponding to the value of the enumeration literal.
1048
1049 -- Enumeration_Rep (Uint12)
1050 -- Defined in enumeration literals. Contains the representation that
1051 -- corresponds to the value of the enumeration literal. Note that
1052 -- this is normally the same as Enumeration_Pos except in the presence
1053 -- of representation clauses, where Pos will still represent the
1054 -- position of the literal within the type and Rep will have be the
1055 -- value given in the representation clause.
1056
1057 -- Enumeration_Rep_Expr (Node22)
1058 -- Defined in enumeration literals. Points to the expression in an
1059 -- associated enumeration rep clause that provides the representation
1060 -- value for this literal. Empty if no enumeration rep clause for this
1061 -- literal (or if rep clause does not have an entry for this literal,
1062 -- an error situation). This is also used to catch duplicate entries
1063 -- for the same literal.
1064
1065 -- Enum_Pos_To_Rep (Node23)
1066 -- Defined in enumeration types (but not enumeration subtypes). Set to
1067 -- Empty unless the enumeration type has a non-standard representation
1068 -- (i.e. at least one literal has a representation value different from
1069 -- its pos value). In this case, Enum_Pos_To_Rep is the entity for an
1070 -- array constructed when the type is frozen that maps Pos values to
1071 -- corresponding Rep values. The index type of this array is Natural,
1072 -- and the component type is a suitable integer type that holds the
1073 -- full range of representation values.
1074
1075 -- Equivalent_Type (Node18)
1076 -- Defined in class wide types and subtypes, access to protected
1077 -- subprogram types, and in exception types. For a classwide type, it
1078 -- is always Empty. For a class wide subtype, it points to an entity
1079 -- created by the expander which gives Gigi an easily understandable
1080 -- equivalent of the class subtype with a known size (given by an
1081 -- initial value). See Exp_Util.Expand_Class_Wide_Subtype for further
1082 -- details. For E_Exception_Type, this points to the record containing
1083 -- the data necessary to represent exceptions (for further details, see
1084 -- System.Standard_Library. For access_to_protected subprograms, it
1085 -- denotes a record that holds pointers to the operation and to the
1086 -- protected object. For remote Access_To_Subprogram types, it denotes
1087 -- the record that is the fat pointer representation of an RAST.
1088
1089 -- Esize (Uint12)
1090 -- Defined in all types and subtypes, and also for components, constants,
1091 -- and variables, including exceptions where it refers to the static data
1092 -- allocated for an exception. Contains the Object_Size of the type or of
1093 -- the object. A value of zero indicates that the value is not yet known.
1094 --
1095 -- For the case of components where a component clause is present, the
1096 -- value is the value from the component clause, which must be non-
1097 -- negative (but may be zero, which is acceptable for the case of
1098 -- a type with only one possible value). It is also possible for Esize
1099 -- of a component to be set without a component clause defined, which
1100 -- means that the component size is specified, but not the position.
1101 -- See also RM_Size and the section on "Handling of Type'Size Values".
1102 -- During gigi processing, the value is back annotated for all zero
1103 -- values, so that after the call to gigi, the value is properly set.
1104
1105 -- Etype (Node5)
1106 -- Defined in all entities. Represents the type of the entity, which
1107 -- is itself another entity. For a type entity, points to the parent
1108 -- type for a derived type, or if the type is not derived, points to
1109 -- itself. For a subtype entity, Etype points to the base type. For
1110 -- a class wide type, points to the corresponding specific type. For a
1111 -- subprogram or subprogram type, Etype has the return type of a function
1112 -- or is set to Standard_Void_Type to represent a procedure.
1113 --
1114 -- Note one obscure case: for pragma Default_Storage_Pool (null), the
1115 -- Etype of the N_Null node is Empty.
1116
1117 -- Exception_Code (Uint22)
1118 -- Defined in exception entities. Set to zero unless either an
1119 -- Import_Exception or Export_Exception pragma applies to the
1120 -- pragma and specifies a Code value. See description of these
1121 -- pragmas for details. Note that this field is relevant only if
1122 -- Is_VMS_Exception is set.
1123
1124 -- Extra_Formal (Node15)
1125 -- Defined in formal parameters in the non-generic case. Certain
1126 -- parameters require extra implicit information to be passed (e.g. the
1127 -- flag indicating if an unconstrained variant record argument is
1128 -- constrained, and the accessibility level for access parameters. See
1129 -- description of Extra_Constrained, Extra_Accessibility fields for
1130 -- further details. Extra formal parameters are constructed to represent
1131 -- these values, and chained to the end of the list of formals using the
1132 -- Extra_Formal field (i.e. the Extra_Formal field of the last "real"
1133 -- formal points to the first extra formal, and the Extra_Formal field of
1134 -- each extra formal points to the next one, with Empty indicating the
1135 -- end of the list of extra formals.
1136
1137 -- Extra_Formals (Node28)
1138 -- Applies to subprograms and subprogram types, and also in entries
1139 -- and entry families. Returns first extra formal of the subprogram
1140 -- or entry. Returns Empty if there are no extra formals.
1141
1142 -- Extra_Accessibility (Node13)
1143 -- Defined in formal parameters in the non-generic case. Normally Empty,
1144 -- but if expansion is active, and a parameter is one for which a
1145 -- dynamic accessibility check is required, then an extra formal of type
1146 -- Natural is created (see description of field Extra_Formal), and the
1147 -- Extra_Accessibility field of the formal parameter points to the entity
1148 -- for this extra formal. Also defined in variables when compiling
1149 -- receiving stubs. In this case, a non Empty value means that this
1150 -- variable's accessibility depth has been transmitted by the caller and
1151 -- must be retrieved through the entity designed by this field instead of
1152 -- being computed.
1153
1154 -- Extra_Accessibility_Of_Result (Node19)
1155 -- Defined in (non-generic) Function, Operator, and Subprogram_Type
1156 -- entities. Normally Empty, but if expansion is active, and a function
1157 -- is one for which "the accessibility level of the result ... determined
1158 -- by the point of call" (AI05-0234) is needed, then an extra formal of
1159 -- subtype Natural is created (see description of field Extra_Formal),
1160 -- and the Extra_Accessibility_Of_Result field of the function points to
1161 -- the entity for this extra formal.
1162
1163 -- Extra_Constrained (Node23)
1164 -- Defined in formal parameters in the non-generic case. Normally Empty,
1165 -- but if expansion is active and a parameter is one for which a dynamic
1166 -- indication of its constrained status is required, then an extra formal
1167 -- of type Boolean is created (see description of field Extra_Formal),
1168 -- and the Extra_Constrained field of the formal parameter points to the
1169 -- entity for this extra formal. Also defined in variables when compiling
1170 -- receiving stubs. In this case, a non empty value means that this
1171 -- variable's constrained status has been transmitted by the caller and
1172 -- must be retrieved through the entity designed by this field instead of
1173 -- being computed.
1174
1175 -- Finalization_Master (Node23) [root type only]
1176 -- Defined in access-to-controlled or access-to-class-wide types. The
1177 -- field contains the entity of the finalization master which handles
1178 -- dynamically allocated controlled objects referenced by the access
1179 -- type. Empty for access-to-subprogram types. Empty for access types
1180 -- whose designated type does not need finalization actions.
1181
1182 -- Finalize_Storage_Only (Flag158) [base type only]
1183 -- Defined in all types. Set on direct controlled types to which a
1184 -- valid Finalize_Storage_Only pragma applies. This flag is also set on
1185 -- composite types when they have at least one controlled component and
1186 -- all their controlled components are Finalize_Storage_Only. It is also
1187 -- inherited by type derivation except for direct controlled types where
1188 -- the Finalize_Storage_Only pragma is required at each level of
1189 -- derivation.
1190
1191 -- Finalizer (Node28)
1192 -- Applies to package declarations and bodies. Contains the entity of the
1193 -- library-level program which finalizes all package-level controlled
1194 -- objects.
1195
1196 -- First_Component (synthesized)
1197 -- Applies to record types. Returns the first component by following the
1198 -- chain of declared entities for the record until a component is found
1199 -- (one with an Ekind of E_Component). The discriminants are skipped. If
1200 -- the record is null, then Empty is returned.
1201
1202 -- First_Component_Or_Discriminant (synthesized)
1203 -- Similar to First_Component, but discriminants are not skipped, so will
1204 -- find the first discriminant if discriminants are present.
1205
1206 -- First_Entity (Node17)
1207 -- Defined in all entities which act as scopes to which a list of
1208 -- associated entities is attached (blocks, class subtypes and types,
1209 -- entries, functions, loops, packages, procedures, protected objects,
1210 -- record types and subtypes, private types, task types and subtypes).
1211 -- Points to a list of associated entities using the Next_Entity field
1212 -- as a chain pointer with Empty marking the end of the list.
1213
1214 -- First_Exit_Statement (Node8)
1215 -- Defined in E_Loop entity. The exit statements for a loop are chained
1216 -- (in reverse order of appearance) using this field to point to the
1217 -- first entry in the chain (last exit statement in the loop). The
1218 -- entries are chained through the Next_Exit_Statement field of the
1219 -- N_Exit_Statement node with Empty marking the end of the list.
1220
1221 -- First_Formal (synthesized)
1222 -- Applies to subprograms and subprogram types, and also in entries
1223 -- and entry families. Returns first formal of the subprogram or entry.
1224 -- The formals are the first entities declared in a subprogram or in
1225 -- a subprogram type (the designated type of an Access_To_Subprogram
1226 -- definition) or in an entry.
1227
1228 -- First_Formal_With_Extras (synthesized)
1229 -- Applies to subprograms and subprogram types, and also in entries
1230 -- and entry families. Returns first formal of the subprogram or entry.
1231 -- Returns Empty if there are no formals. The list returned includes
1232 -- all the extra formals (see description of Extra_Formals field).
1233
1234 -- First_Index (Node17)
1235 -- Defined in array types and subtypes and in string types and subtypes.
1236 -- By introducing implicit subtypes for the index constraints, we have
1237 -- the same structure for constrained and unconstrained arrays, subtype
1238 -- marks and discrete ranges are both represented by a subtype. This
1239 -- function returns the tree node corresponding to an occurrence of the
1240 -- first index (NOT the entity for the type). Subsequent indices are
1241 -- obtained using Next_Index. Note that this field is defined for the
1242 -- case of string literal subtypes, but is always Empty.
1243
1244 -- First_Literal (Node17)
1245 -- Defined in all enumeration types, including character and boolean
1246 -- types. This field points to the first enumeration literal entity
1247 -- for the type (i.e. it is set to First (Literals (N)) where N is
1248 -- the enumeration type definition node. A special case occurs with
1249 -- standard character and wide character types, where this field is
1250 -- Empty, since there are no enumeration literal lists in these cases.
1251 -- Note that this field is set in enumeration subtypes, but it still
1252 -- points to the first literal of the base type in this case.
1253
1254 -- First_Optional_Parameter (Node14)
1255 -- Defined in (non-generic) function and procedure entities. Set to a
1256 -- non-null value only if a pragma Import_Function, Import_Procedure
1257 -- or Import_Valued_Procedure specifies a First_Optional_Parameter
1258 -- argument, in which case this field points to the parameter entity
1259 -- corresponding to the specified parameter.
1260
1261 -- First_Private_Entity (Node16)
1262 -- Defined in all entities containing private parts (packages, protected
1263 -- types and subtypes, task types and subtypes). The entities on the
1264 -- entity chain are in order of declaration, so the entries for private
1265 -- entities are at the end of the chain. This field points to the first
1266 -- entity for the private part. It is Empty if there are no entities
1267 -- declared in the private part or if there is no private part.
1268
1269 -- First_Rep_Item (Node6)
1270 -- Defined in all entities. If non-empty, points to a linked list of
1271 -- representation pragmas nodes and representation clause nodes that
1272 -- apply to the entity, linked using Next_Rep_Item, with Empty marking
1273 -- the end of the list. In the case of derived types and subtypes, the
1274 -- new entity inherits the chain at the point of declaration. This means
1275 -- that it is possible to have multiple instances of the same kind of rep
1276 -- item on the chain, in which case it is the first one that applies to
1277 -- the entity.
1278 --
1279 -- Note: pragmas that can apply to more than one overloadable entity,
1280 -- (Convention, Interface, Inline, Inline_Always, Import, Export,
1281 -- External) are never present on this chain when they apply to
1282 -- overloadable entities, since it is impossible for a given pragma
1283 -- to be on more than one chain at a time.
1284 --
1285 -- For most representation items, the representation information is
1286 -- reflected in other fields and flags in the entity. For example if a
1287 -- record representation clause is present, the component entities
1288 -- reflect the specified information. However, there are some items that
1289 -- are only reflected in the chain. These include:
1290 --
1291 -- Machine_Attribute pragma
1292 -- Link_Alias pragma
1293 -- Linker_Section pragma
1294 -- Linker_Constructor pragma
1295 -- Linker_Destructor pragma
1296 -- Weak_External pragma
1297 -- Thread_Local_Storage pragma
1298 --
1299 -- If any of these items are present, then the flag Has_Gigi_Rep_Item is
1300 -- set, indicating that Gigi should search the chain.
1301 --
1302 -- Other representation items are included in the chain so that error
1303 -- messages can easily locate the relevant nodes for posting errors.
1304 -- Note in particular that size clauses are defined only for this
1305 -- purpose, and should only be accessed if Has_Size_Clause is set.
1306
1307 -- Float_Rep (Uint10)
1308 -- Defined in floating-point entities. Contains a value of type
1309 -- Float_Rep_Kind. Together with the Digits_Value uniquely defines
1310 -- the floating-point representation to be used.
1311
1312 -- Freeze_Node (Node7)
1313 -- Defined in all entities. If there is an associated freeze node for the
1314 -- entity, this field references this freeze node. If no freeze node is
1315 -- associated with the entity, then this field is Empty. See package
1316 -- Freeze for further details.
1317
1318 -- From_Limited_With (Flag159)
1319 -- Defined in abtract states, package and type entities. Set to True when
1320 -- the related entity is generated by the expansion of a limited with
1321 -- clause. Such an entity is said to be a "shadow" - it acts as the
1322 -- abstract view of a state or variable or as the incomplete view of a
1323 -- type by inheriting relevant attributes from the said entity.
1324
1325 -- Full_View (Node11)
1326 -- Defined in all type and subtype entities and in deferred constants.
1327 -- References the entity for the corresponding full type declaration.
1328 -- For all types other than private and incomplete types, this field
1329 -- always contains Empty. If an incomplete type E1 is completed by a
1330 -- private type E2 whose full type declaration entity is E3 then the
1331 -- full view of E1 is E2, and the full view of E2 is E3. See also
1332 -- Underlying_Type.
1333
1334 -- Generic_Homonym (Node11)
1335 -- Defined in generic packages. The generic homonym is the entity of
1336 -- a renaming declaration inserted in every generic unit. It is used
1337 -- to resolve the name of a local entity that is given by a qualified
1338 -- name, when the generic entity itself is hidden by a local name.
1339
1340 -- Generic_Renamings (Elist23)
1341 -- Defined in package and subprogram instances. Holds mapping that
1342 -- associates generic parameters with the corresponding instances, in
1343 -- those cases where the instance is an entity.
1344
1345 -- Handler_Records (List10)
1346 -- Defined in subprogram and package entities. Points to a list of
1347 -- identifiers referencing the handler record entities for the
1348 -- corresponding unit.
1349
1350 -- Has_Aliased_Components (Flag135) [implementation base type only]
1351 -- Defined in array type entities. Indicates that the component type
1352 -- of the array is aliased.
1353
1354 -- Has_Alignment_Clause (Flag46)
1355 -- Defined in all type entities and objects. Indicates if an alignment
1356 -- clause has been given for the entity. If set, then Alignment_Clause
1357 -- returns the N_Attribute_Definition node for the alignment attribute
1358 -- definition clause. Note that it is possible for this flag to be False
1359 -- even when Alignment_Clause returns non_Empty (this happens in the case
1360 -- of derived type declarations).
1361
1362 -- Has_All_Calls_Remote (Flag79)
1363 -- Defined in all library unit entities. Set if the library unit has an
1364 -- All_Calls_Remote pragma. Note that such entities must also be RCI
1365 -- entities, so the flag Is_Remote_Call_Interface will always be set if
1366 -- this flag is set.
1367
1368 -- Has_Anonymous_Master (Flag253)
1369 -- Defined in units (top-level functions and procedures, library-level
1370 -- packages). Set if the associated unit contains a heterogeneous
1371 -- finalization master. The master's name is of the form <unit>AM and it
1372 -- services anonymous access-to-controlled types with an undetermined
1373 -- lifetime.
1374
1375 -- Has_Atomic_Components (Flag86) [implementation base type only]
1376 -- Defined in all types and objects. Set only for an array type or
1377 -- an array object if a valid pragma Atomic_Components applies to the
1378 -- type or object. Note that in the case of an object, this flag is
1379 -- only set on the object if there was an explicit pragma for the
1380 -- object. In other words, the proper test for whether an object has
1381 -- atomic components is to see if either the object or its base type
1382 -- has this flag set. Note that in the case of a type, the pragma will
1383 -- be chained to the rep item chain of the first subtype in the usual
1384 -- manner.
1385
1386 -- Has_Attach_Handler (synthesized)
1387 -- Applies to record types that are constructed by the expander to
1388 -- represent protected types. Returns True if there is at least one
1389 -- Attach_Handler pragma in the corresponding specification.
1390
1391 -- Has_Biased_Representation (Flag139)
1392 -- Defined in discrete types (where it applies to the type'size value),
1393 -- and to objects (both stand-alone and components), where it applies to
1394 -- the size of the object from a size or record component clause. In
1395 -- all cases it indicates that the size in question is smaller than
1396 -- would normally be required, but that the size requirement can be
1397 -- satisfied by using a biased representation, in which stored values
1398 -- have the low bound (Expr_Value (Type_Low_Bound (T)) subtracted to
1399 -- reduce the required size. For example, a type with a range of 1..2
1400 -- takes one bit, using 0 to represent 1 and 1 to represent 2.
1401 --
1402 -- Note that in the object and component cases, the flag is only set if
1403 -- the type is unbiased, but the object specifies a smaller size than the
1404 -- size of the type, forcing biased representation for the object, but
1405 -- the subtype is still an unbiased type.
1406
1407 -- Has_Body_References (Flag264)
1408 -- Defined in entities for abstract states. Set if Body_References has
1409 -- at least one entry.
1410
1411 -- Has_Completion (Flag26)
1412 -- Defined in all entities that require a completion (functions,
1413 -- procedures, private types, limited private types, incomplete types,
1414 -- constants and packages that require a body). The flag is set if the
1415 -- completion has been encountered and analyzed.
1416
1417 -- Has_Completion_In_Body (Flag71)
1418 -- Defined in all entities for types and subtypes. Set only in "Taft
1419 -- amendment types" (incomplete types whose full declaration appears in
1420 -- the package body).
1421
1422 -- Has_Complex_Representation (Flag140) [implementation base type only]
1423 -- Defined in all type entities. Set only for a record base type to
1424 -- which a valid pragma Complex_Representation applies.
1425
1426 -- Has_Component_Size_Clause (Flag68) [implementation base type only]
1427 -- Defined in all type entities. Set if a component size clause is
1428 -- Defined for the given type. Note that this flag can be False even
1429 -- if Component_Size is non-zero (happens in the case of derived types).
1430
1431 -- Has_Constrained_Partial_View (Flag187)
1432 -- Defined in private type and their completions, when the private
1433 -- type has no discriminants and the full view has discriminants with
1434 -- defaults. In Ada 2005 heap-allocated objects of such types are not
1435 -- constrained, and can change their discriminants with full assignment.
1436 --
1437 -- Ada 2012 has an additional rule (3.3. (23/10.3)) concerning objects
1438 -- declared in a generic package body. Objects whose type is an untagged
1439 -- generic formal private type are considered to have a constrained
1440 -- partial view. The predicate Object_Type_Has_Constrained_Partial_View
1441 -- in sem_aux is used to test for this case.
1442
1443 -- Has_Contiguous_Rep (Flag181)
1444 -- Defined in enumeration types. Set if the type as a representation
1445 -- clause whose entries are successive integers.
1446
1447 -- Has_Controlling_Result (Flag98)
1448 -- Defined in E_Function entities. Set if the function is a primitive
1449 -- function of a tagged type which can dispatch on result.
1450
1451 -- Has_Controlled_Component (Flag43) [base type only]
1452 -- Defined in all type and subtype entities. Set only for composite type
1453 -- entities which contain a component that either is a controlled type,
1454 -- or itself contains controlled component (i.e. either Is_Controlled or
1455 -- Has_Controlled_Component is set for at least one component).
1456
1457 -- Has_Convention_Pragma (Flag119)
1458 -- Defined in all entities. Set for an entity for which a valid pragma
1459 -- Convention, Import, or Export has been given. Used to prevent more
1460 -- than one such pragma appearing for a given entity (RM B.1(45)).
1461
1462 -- Has_Delayed_Aspects (Flag200)
1463 -- Defined in all entities. Set if the Rep_Item chain for the entity has
1464 -- one or more N_Aspect_Definition nodes chained which are not to be
1465 -- evaluated till the freeze point. The aspect definition expression
1466 -- clause has been preanalyzed to get visibility at the point of use,
1467 -- but no other action has been taken.
1468
1469 -- Has_Delayed_Freeze (Flag18)
1470 -- Defined in all entities. Set to indicate that an explicit freeze
1471 -- node must be generated for the entity at its freezing point. See
1472 -- separate section ("Delayed Freezing and Elaboration") for details.
1473
1474 -- Has_Default_Aspect (Flag39) [base type only]
1475 -- Defined in entities for types and subtypes, set for scalar types with
1476 -- a Default_Value aspect and array types with a Default_Component_Value
1477 -- apsect. If this flag is set, then a corresponding aspect specification
1478 -- node will be present on the rep item chain for the entity.
1479
1480 -- Has_Delayed_Rep_Aspects (Flag261)
1481 -- Defined in all type and subtypes. This flag is set if there is at
1482 -- least one aspect for a representation characteristic that has to be
1483 -- delayed and is one of the characteristics that may be inherited by
1484 -- types derived from this type if not overridden. If this flag is set,
1485 -- then types derived from this type have May_Inherit_Delayed_Rep_Aspects
1486 -- set, signalling that Freeze.Inhert_Delayed_Rep_Aspects must be called
1487 -- at the freeze point of the derived type.
1488
1489 -- Has_Discriminants (Flag5)
1490 -- Defined in all types and subtypes. For types that are allowed to have
1491 -- discriminants (record types and subtypes, task types and subtypes,
1492 -- protected types and subtypes, private types, limited private types,
1493 -- and incomplete types), indicates if the corresponding type or subtype
1494 -- has a known discriminant part. Always false for all other types.
1495
1496 -- Has_Dispatch_Table (Flag220)
1497 -- Defined in E_Record_Types that are tagged. Set to indicate that the
1498 -- corresponding dispatch table is already built. This flag is used to
1499 -- avoid duplicate construction of library level dispatch tables (because
1500 -- the declaration of library level objects cause premature construction
1501 -- of the table); otherwise the code that builds the table is added at
1502 -- the end of the list of declarations of the package.
1503
1504 -- Has_Dynamic_Predicate_Aspect (Flag258)
1505 -- Defined in all types and subtypes. Set if a Dynamic_Predicate aspect
1506 -- applies to the type. Note that we can tell if a dynamic predicate is
1507 -- present by looking at Has_Predicates and Static_Predicate, but that
1508 -- could have come from a Predicate aspect or pragma, and we need to
1509 -- record the difference so that we can use the right set of check
1510 -- policies to figure out if the predicate is active.
1511
1512 -- Has_Entries (synthesized)
1513 -- Applies to concurrent types. True if any entries are declared
1514 -- within the task or protected definition for the type.
1515
1516 -- Has_Enumeration_Rep_Clause (Flag66)
1517 -- Defined in enumeration types. Set if an enumeration representation
1518 -- clause has been given for this enumeration type. Used to prevent more
1519 -- than one enumeration representation clause for a given type. Note
1520 -- that this does not imply a representation with holes, since the rep
1521 -- clause may merely confirm the default 0..N representation.
1522
1523 -- Has_External_Tag_Rep_Clause (Flag110)
1524 -- Defined in tagged types. Set if an external_tag rep. clause has been
1525 -- given for this type. Use to avoid the generation of the default
1526 -- external_tag.
1527
1528 -- Has_Exit (Flag47)
1529 -- Defined in loop entities. Set if the loop contains an exit statement.
1530
1531 -- Has_Foreign_Convention (synthesized)
1532 -- Applies to all entities. Determines if the Convention for the
1533 -- entity is a foreign convention (i.e. is other than Convention_Ada,
1534 -- Convention_Intrinsic, Convention_Entry or Convention_Protected).
1535
1536 -- Has_Forward_Instantiation (Flag175)
1537 -- Defined in package entities. Set for packages that instantiate local
1538 -- generic entities before the corresponding generic body has been seen.
1539 -- If a package has a forward instantiation, we cannot inline subprograms
1540 -- appearing in the same package because the placement requirements of
1541 -- the instance will conflict with the linear elaboration of front-end
1542 -- inlining.
1543
1544 -- Has_Fully_Qualified_Name (Flag173)
1545 -- Defined in all entities. Set if the name in the Chars field has been
1546 -- replaced by the fully qualified name, as used for debug output. See
1547 -- Exp_Dbug for a full description of the use of this flag and also the
1548 -- related flag Has_Qualified_Name.
1549
1550 -- Has_Gigi_Rep_Item (Flag82)
1551 -- Defined in all entities. Set if the rep item chain (referenced by
1552 -- First_Rep_Item and linked through the Next_Rep_Item chain) contains a
1553 -- representation item that needs to be specially processed by Gigi, i.e.
1554 -- one of the following items:
1555 --
1556 -- Machine_Attribute pragma
1557 -- Linker_Alias pragma
1558 -- Linker_Section pragma
1559 -- Linker_Constructor pragma
1560 -- Linker_Destructor pragma
1561 -- Weak_External pragma
1562 -- Thread_Local_Storage pragma
1563 --
1564 -- If this flag is set, then Gigi should scan the rep item chain to
1565 -- process any of these items that appear. At least one such item will
1566 -- be present.
1567
1568 -- Has_Homonym (Flag56)
1569 -- Defined in all entities. Set if an entity has a homonym in the same
1570 -- scope. Used by Gigi to generate unique names for such entities.
1571
1572 -- Has_Implicit_Dereference (Flag251)
1573 -- Defined in types and discriminants. Set if the type has an aspect
1574 -- Implicit_Dereference. Set also on the discriminant named in the aspect
1575 -- clause, to simplify type resolution.
1576
1577 -- Has_Independent_Components (Flag34)
1578 -- Defined in objects and types. Set if the aspect Independent_Components
1579 -- applies (as set by coresponding pragma or aspect specification).
1580
1581 -- Has_Inheritable_Invariants (Flag248)
1582 -- Defined in all type entities. Set in private types from which one
1583 -- or more Invariant'Class aspects will be inherited if a another type is
1584 -- derived from the type (i.e. those types which have an Invariant'Class
1585 -- aspect, or which inherit one or more Invariant'Class aspects). Also
1586 -- set in the corresponding full types. Note that it might be the full
1587 -- type which has inheritable invariants, and in this case the flag will
1588 -- also be set in the private type.
1589
1590 -- Has_Initial_Value (Flag219)
1591 -- Defined in entities for variables and out parameters. Set if there
1592 -- is an explicit initial value expression in the declaration of the
1593 -- variable. Note that this is set only if this initial value is
1594 -- explicit, it is not set for the case of implicit initialization
1595 -- of access types or controlled types. Always set to False for out
1596 -- parameters. Also defined in entities for in and in-out parameters,
1597 -- but always false in these cases.
1598
1599 -- Has_Interrupt_Handler (synthesized)
1600 -- Applies to all protected type entities. Set if the protected type
1601 -- definition contains at least one procedure to which a pragma
1602 -- Interrupt_Handler applies.
1603
1604 -- Has_Invariants (Flag232)
1605 -- Defined in all type entities and in subprogram entities. Set in
1606 -- private types if an Invariant or Invariant'Class aspect applies to the
1607 -- type, or if the type inherits one or more Invariant'Class aspects.
1608 -- Also set in the corresponding full type. Note: if this flag is set
1609 -- True, then usually the Invariant_Procedure attribute is set once the
1610 -- type is frozen, however this may not be true in some error situations.
1611 -- Note that it might be the full type which has inheritable invariants,
1612 -- and then the flag will also be set in the private type.
1613
1614 -- Has_Loop_Entry_Attributes (Flag260)
1615 -- Defined in E_Loop entities. Set when the loop is subject to at least
1616 -- one attribute 'Loop_Entry. The flag also implies that the loop has
1617 -- already been transformed. See Expand_Loop_Entry_Attribute for details.
1618
1619 -- Has_Machine_Radix_Clause (Flag83)
1620 -- Defined in decimal types and subtypes, set if a Machine_Radix
1621 -- representation clause is present. This flag is used to detect
1622 -- the error of multiple machine radix clauses for a single type.
1623
1624 -- Has_Master_Entity (Flag21)
1625 -- Defined in entities that can appear in the scope stack (see spec
1626 -- of Sem). It is set if a task master entity (_master) has been
1627 -- declared and initialized in the corresponding scope.
1628
1629 -- Has_Missing_Return (Flag142)
1630 -- Defined in functions and generic functions. Set if there is one or
1631 -- more missing return statements in the function. This is used to
1632 -- control wrapping of the body in Exp_Ch6 to ensure that the program
1633 -- error exception is correctly raised in this case at runtime.
1634
1635 -- Has_Nested_Block_With_Handler (Flag101)
1636 -- Defined in scope entities. Set if there is a nested block within the
1637 -- scope that has an exception handler and the two scopes are in the
1638 -- same procedure. This is used by the backend for controlling certain
1639 -- optimizations to ensure that they are consistent with exceptions.
1640 -- See documentation in Gigi for further details.
1641
1642 -- Has_Non_Null_Refinement (synth)
1643 -- Defined in E_Abstract_State entities. True if the state has at least
1644 -- one variable or state constituent in aspect/pragma Refined_State.
1645
1646 -- Has_Non_Standard_Rep (Flag75) [implementation base type only]
1647 -- Defined in all type entities. Set when some representation clause
1648 -- or pragma causes the representation of the item to be significantly
1649 -- modified. In this category are changes of small or radix for a
1650 -- fixed-point type, change of component size for an array, and record
1651 -- or enumeration representation clauses, as well as packed pragmas.
1652 -- All other representation clauses (e.g. Size and Alignment clauses)
1653 -- are not considered to be significant since they do not affect
1654 -- stored bit patterns.
1655
1656 -- Has_Null_Abstract_State (synth)
1657 -- Defined in package entities. True if the package is subject to a null
1658 -- Abstract_State aspect/pragma.
1659
1660 -- Has_Null_Refinement (synth)
1661 -- Defined in E_Abstract_State entities. True if the state has a null
1662 -- refinement in aspect/pragma Refined_State.
1663
1664 -- Has_Object_Size_Clause (Flag172)
1665 -- Defined in entities for types and subtypes. Set if an Object_Size
1666 -- clause has been processed for the type Used to prevent multiple
1667 -- Object_Size clauses for a given entity.
1668
1669 -- Has_Per_Object_Constraint (Flag154)
1670 -- Defined in E_Component entities. Set if the subtype of the component
1671 -- has a per object constraint. Per object constraints result from the
1672 -- following situations :
1673 --
1674 -- 1. N_Attribute_Reference - when the prefix is the enclosing type and
1675 -- the attribute is Access.
1676 -- 2. N_Discriminant_Association - when the expression uses the
1677 -- discriminant of the enclosing type.
1678 -- 3. N_Index_Or_Discriminant_Constraint - when at least one of the
1679 -- individual constraints is a per object constraint.
1680 -- 4. N_Range - when the lower or upper bound uses the discriminant of
1681 -- the enclosing type.
1682 -- 5. N_Range_Constraint - when the range expression uses the
1683 -- discriminant of the enclosing type.
1684
1685 -- Has_Postconditions (Flag240)
1686 -- Defined in subprogram entities. Set if postconditions are active for
1687 -- the procedure, and a _postconditions procedure has been generated.
1688
1689 -- Has_Pragma_Controlled (Flag27) [implementation base type only]
1690 -- Defined in access type entities. It is set if a pragma Controlled
1691 -- applies to the access type.
1692
1693 -- Has_Pragma_Elaborate_Body (Flag150)
1694 -- Defined in all entities. Set in compilation unit entities if a
1695 -- pragma Elaborate_Body applies to the compilation unit.
1696
1697 -- Has_Pragma_Inline (Flag157)
1698 -- Defined in all entities. Set for functions and procedures for which a
1699 -- pragma Inline or Inline_Always applies to the subprogram. Note that
1700 -- this flag can be set even if Is_Inlined is not set. This happens for
1701 -- pragma Inline (if Inline_Active is False). In other words, the flag
1702 -- Has_Pragma_Inline represents the formal semantic status, and is used
1703 -- for checking semantic correctness. The flag Is_Inlined indicates
1704 -- whether inlining is actually active for the entity.
1705
1706 -- Has_Pragma_Inline_Always (Flag230)
1707 -- Defined in all entities. Set for functions and procedures for which a
1708 -- pragma Inline_Always applies. Note that if this flag is set, the flag
1709 -- Has_Pragma_Inline is also set.
1710
1711 -- Has_Pragma_No_Inline (Flag201)
1712 -- Defined in all entities. Set for functions and procedures for which a
1713 -- pragma No_Inline applies. Note that if this flag is set, the flag
1714 -- Has_Pragma_Inline_Always cannot be set.
1715
1716 -- Has_Pragma_Ordered (Flag198) [implementation base type only]
1717 -- Defined in entities for enumeration types. If set indicates that a
1718 -- valid pragma Ordered was given for the type. This flag is inherited
1719 -- by derived enumeration types. We don't need to distinguish the derived
1720 -- case since we allow multiple occurrences of this pragma anyway.
1721
1722 -- Has_Pragma_Pack (Flag121) [implementation base type only]
1723 -- Defined in array and record type entities. If set, indicates that a
1724 -- valid pragma Pack was given for the type. Note that this flag is not
1725 -- inherited by derived type. See also the Is_Packed flag.
1726
1727 -- Has_Pragma_Pure (Flag203)
1728 -- Defined in all entities. If set, indicates that a valid pragma Pure
1729 -- was given for the entity. In some cases, we need to test whether
1730 -- Is_Pure was explicitly set using this pragma.
1731
1732 -- Has_Pragma_Preelab_Init (Flag221)
1733 -- Defined in type and subtype entities. If set indicates that a valid
1734 -- pragma Preelaborable_Initialization applies to the type.
1735
1736 -- Has_Pragma_Pure_Function (Flag179)
1737 -- Defined in all entities. If set, indicates that a valid pragma
1738 -- Pure_Function was given for the entity. In some cases, we need to
1739 -- know that Is_Pure was explicitly set using this pragma. We also set
1740 -- this flag for some internal entities that we know should be treated
1741 -- as pure for optimization purposes.
1742
1743 -- Has_Pragma_Thread_Local_Storage (Flag169)
1744 -- Defined in all entities. If set, indicates that a valid pragma
1745 -- Thread_Local_Storage was given for the entity.
1746
1747 -- Has_Pragma_Unmodified (Flag233)
1748 -- Defined in all entities. Can only be set for variables (E_Variable,
1749 -- E_Out_Parameter, E_In_Out_Parameter). Set if a valid pragma Unmodified
1750 -- applies to the variable, indicating that no warning should be given
1751 -- if the entity is never modified. Note that clients should generally
1752 -- not test this flag directly, but instead use function Has_Unmodified.
1753
1754 -- Has_Pragma_Unreferenced (Flag180)
1755 -- Defined in all entities. Set if a valid pragma Unreferenced applies
1756 -- to the entity, indicating that no warning should be given if the
1757 -- entity has no references, but a warning should be given if it is
1758 -- in fact referenced. For private types, this flag is set in both the
1759 -- private entity and full entity if the pragma applies to either. Note
1760 -- that clients should generally not test this flag directly, but instead
1761 -- use function Has_Unreferenced.
1762
1763 -- Has_Pragma_Unreferenced_Objects (Flag212)
1764 -- Defined in type and subtype entities. Set if a valid pragma
1765 -- Unreferenced_Objects applies to the type, indicating that no warning
1766 -- should be given for objects of such a type for being unreferenced
1767 -- (but unlike the case with pragma Unreferenced, it is ok to reference
1768 -- such an object and no warning is generated.
1769
1770 -- Has_Predicates (Flag250)
1771 -- Defined in type and subtype entities. Set if a pragma Predicate or
1772 -- Predicate aspect applies to the type or subtype, or if it inherits a
1773 -- Predicate aspect from its parent or progenitor types.
1774
1775 -- Has_Primitive_Operations (Flag120) [base type only]
1776 -- Defined in all type entities. Set if at least one primitive operation
1777 -- is defined for the type.
1778
1779 -- Has_Private_Ancestor (Flag151)
1780 -- Applies to untagged derived types and to type extensions. True when
1781 -- some ancestor is derived from a private type, making some components
1782 -- invisible and aggregates illegal. Used to check the legality of
1783 -- selected components and aggregates. The flag is set at the point of
1784 -- derivation. The legality of an aggregate of a type with a private
1785 -- ancestor must be checked because it also depends on the visibility
1786 -- at the point the aggregate is resolved. See sem_aggr.adb. This is
1787 -- part of AI05-0115.
1788
1789 -- Has_Private_Declaration (Flag155)
1790 -- Defined in all entities. Set if it is the defining entity of a private
1791 -- type declaration or its corresponding full declaration. This flag is
1792 -- thus preserved when the full and the partial views are exchanged, to
1793 -- indicate if a full type declaration is a completion. Used for semantic
1794 -- checks in E.4(18) and elsewhere.
1795
1796 -- Has_Qualified_Name (Flag161)
1797 -- Defined in all entities. Set if the name in the Chars field has
1798 -- been replaced by its qualified name, as used for debug output. See
1799 -- Exp_Dbug for a full description of qualification requirements. For
1800 -- some entities, the name is the fully qualified name, but there are
1801 -- exceptions. In particular, for local variables in procedures, we
1802 -- do not include the procedure itself or higher scopes. See also the
1803 -- flag Has_Fully_Qualified_Name, which is set if the name does indeed
1804 -- include the fully qualified name.
1805
1806 -- Has_RACW (Flag214)
1807 -- Defined in package spec entities. Set if the spec contains the
1808 -- declaration of a remote access-to-classwide type.
1809
1810 -- Has_Record_Rep_Clause (Flag65) [implementation base type only]
1811 -- Defined in record types. Set if a record representation clause has
1812 -- been given for this record type. Used to prevent more than one such
1813 -- clause for a given record type. Note that this is initially cleared
1814 -- for a derived type, even though the representation is inherited. See
1815 -- also the flag Has_Specified_Layout.
1816
1817 -- Has_Recursive_Call (Flag143)
1818 -- Defined in procedures. Set if a direct parameterless recursive call
1819 -- is detected while analyzing the body. Used to activate some error
1820 -- checks for infinite recursion.
1821
1822 -- Has_Size_Clause (Flag29)
1823 -- Defined in entities for types and objects. Set if a size clause is
1824 -- defined for the entity. Used to prevent multiple Size clauses for a
1825 -- given entity. Note that it is always initially cleared for a derived
1826 -- type, even though the Size for such a type is inherited from a Size
1827 -- clause given for the parent type.
1828
1829 -- Has_Small_Clause (Flag67)
1830 -- Defined in ordinary fixed point types (but not subtypes). Indicates
1831 -- that a small clause has been given for the entity. Used to prevent
1832 -- multiple Small clauses for a given entity. Note that it is always
1833 -- initially cleared for a derived type, even though the Small for such
1834 -- a type is inherited from a Small clause given for the parent type.
1835
1836 -- Has_Specified_Layout (Flag100) [implementation base type only]
1837 -- Defined in all type entities. Set for a record type or subtype if
1838 -- the record layout has been specified by a record representation
1839 -- clause. Note that this differs from the flag Has_Record_Rep_Clause
1840 -- in that it is inherited by a derived type. Has_Record_Rep_Clause is
1841 -- used to indicate that the type is mentioned explicitly in a record
1842 -- representation clause, and thus is not inherited by a derived type.
1843 -- This flag is always False for non-record types.
1844
1845 -- Has_Specified_Stream_Input (Flag190)
1846 -- Has_Specified_Stream_Output (Flag191)
1847 -- Has_Specified_Stream_Read (Flag192)
1848 -- Has_Specified_Stream_Write (Flag193)
1849 -- Defined in all type and subtype entities. Set for a given view if the
1850 -- corresponding stream-oriented attribute has been defined by an
1851 -- attribute definition clause. When such a clause occurs, a TSS is set
1852 -- on the underlying full view; the flags are used to track visibility of
1853 -- the attribute definition clause for partial or incomplete views.
1854
1855 -- Has_Static_Discriminants (Flag211)
1856 -- Defined in record subtypes constrained by discriminant values. Set if
1857 -- all the discriminant values have static values, meaning that in the
1858 -- case of a variant record, the component list can be trimmed down to
1859 -- include only the components corresponding to these discriminants.
1860
1861 -- Has_Static_Predicate_Aspect (Flag259)
1862 -- Defined in all types and subtypes. Set if a Dynamic_Predicate aspect
1863 -- applies to the type. Note that we can tell if a static predicate is
1864 -- present by looking at Has_Predicates and Static_Predicate, but that
1865 -- could have come from a Predicate aspect or pragma, and we need to
1866 -- record the difference so that we can use the right set of check
1867 -- policies to figure out if the predicate is active.
1868
1869 -- Has_Storage_Size_Clause (Flag23) [implementation base type only]
1870 -- Defined in task types and access types. It is set if a Storage_Size
1871 -- clause is present for the type. Used to prevent multiple clauses for
1872 -- one type. Note that this flag is initially cleared for a derived type
1873 -- even though the Storage_Size for such a type is inherited from a
1874 -- Storage_Size clause given for the parent type. Note that in the case
1875 -- of access types, this flag is defined only in the root type, since a
1876 -- storage size clause cannot be given to a derived type.
1877
1878 -- Has_Stream_Size_Clause (Flag184)
1879 -- Defined in all entities. It is set for types which have a Stream_Size
1880 -- clause attribute. Used to prevent multiple Stream_Size clauses for a
1881 -- given entity, and also whether it is necessary to check for a stream
1882 -- size clause.
1883
1884 -- Has_Task (Flag30) [base type only]
1885 -- Defined in all type entities. Set on task types themselves, and also
1886 -- (recursively) on any composite type which has a component for which
1887 -- Has_Task is set. The meaning is that an allocator or declaration of
1888 -- such an object must create the required tasks. Note: the flag is not
1889 -- set on access types, even if they designate an object that Has_Task.
1890
1891 -- Has_Thunks (Flag228)
1892 -- Applies to E_Constant entities marked Is_Tag. True for secondary tag
1893 -- referencing a dispatch table whose contents are pointers to thunks.
1894
1895 -- Has_Unchecked_Union (Flag123) [base type only]
1896 -- Defined in all type entities. Set on unchecked unions themselves
1897 -- and (recursively) on any composite type which has a component for
1898 -- which Has_Unchecked_Union is set. The meaning is that a comparison
1899 -- operation for the type is not permitted. Note that the flag is not
1900 -- set on access types, even if they designate an object that has
1901 -- the flag Has_Unchecked_Union set.
1902
1903 -- Has_Unknown_Discriminants (Flag72)
1904 -- Defined in all entities. Set for types with unknown discriminants.
1905 -- Types can have unknown discriminants either from their declaration or
1906 -- through type derivation. The use of this flag exactly meets the spec
1907 -- in RM 3.7(26). Note that all class-wide types are considered to have
1908 -- unknown discriminants. Note that both flags Has_Discriminants and
1909 -- Has_Unknown_Discriminants may be true for a type. Class-wide types and
1910 -- their subtypes have unknown discriminants and can have declared ones
1911 -- as well. Private types declared with unknown discriminants may have a
1912 -- full view that has explicit discriminants, and both flag will be set
1913 -- on the partial view, to insure that discriminants are properly
1914 -- inherited in certain contexts.
1915
1916 -- Has_Up_Level_Access (Flag215)
1917 -- Defined in E_Variable and E_Constant entities. Set if the entity
1918 -- is a local variable declared in a subprogram p and is accessed in
1919 -- a subprogram nested inside p. Currently this flag is only set when
1920 -- VM_Target /= No_VM, for efficiency, since only the .NET back-end
1921 -- makes use of it to generate proper code for up-level references.
1922
1923 -- Has_Visible_Refinement (Flag263)
1924 -- Defined in E_Abstract_State entities. Set when a state has at least
1925 -- one refinement constituent and analysis is in the region between
1926 -- pragma Refined_State and the end of the package body declarations.
1927
1928 -- Has_Volatile_Components (Flag87) [implementation base type only]
1929 -- Defined in all types and objects. Set only for an array type or array
1930 -- object if a valid pragma Volatile_Components or a valid pragma
1931 -- Atomic_Components applies to the type or object. Note that in the case
1932 -- of an object, this flag is only set on the object if there was an
1933 -- explicit pragma for the object. In other words, the proper test for
1934 -- whether an object has volatile components is to see if either the
1935 -- object or its base type has this flag set. Note that in the case of a
1936 -- type the pragma will be chained to the rep item chain of the first
1937 -- subtype in the usual manner.
1938
1939 -- Has_Xref_Entry (Flag182)
1940 -- Defined in all entities. Set if an entity has an entry in the Xref
1941 -- information generated in ali files. This is true for all source
1942 -- entities in the extended main source file. It is also true of entities
1943 -- in other packages that are referenced directly or indirectly from the
1944 -- main source file (indirect reference occurs when the main source file
1945 -- references an entity with a type reference. See package Lib.Xref for
1946 -- further details).
1947
1948 -- Hiding_Loop_Variable (Node8)
1949 -- Defined in variables. Set only if a variable of a discrete type is
1950 -- hidden by a loop variable in the same local scope, in which case
1951 -- the Hiding_Loop_Variable field of the hidden variable points to
1952 -- the E_Loop_Parameter entity doing the hiding. Used in processing
1953 -- warning messages if the hidden variable turns out to be unused
1954 -- or is referenced without being set.
1955
1956 -- Homonym (Node4)
1957 -- Defined in all entities. Link for list of entities that have the
1958 -- same source name and that are declared in the same or enclosing
1959 -- scopes. Homonyms in the same scope are overloaded. Used for name
1960 -- resolution and for the generation of debugging information.
1961
1962 -- Implementation_Base_Type (synthesized)
1963 -- Applies to all entities. For types, similar to Base_Type, but never
1964 -- returns a private type when applied to a non-private type. Instead in
1965 -- this case, it always returns the Underlying_Type of the base type, so
1966 -- that we still have a concrete type. For entities other than types,
1967 -- returns the entity unchanged.
1968
1969 -- In_Package_Body (Flag48)
1970 -- Defined in package entities. Set on the entity that denotes the
1971 -- package (the defining occurrence of the package declaration) while
1972 -- analyzing and expanding the package body. Reset on completion of
1973 -- analysis/expansion.
1974
1975 -- In_Private_Part (Flag45)
1976 -- Defined in all entities. Can be set only in package entities and
1977 -- objects. For package entities, this flag is set to indicate that the
1978 -- private part of the package is being analyzed. The flag is reset at
1979 -- the end of the package declaration. For objects it indicates that the
1980 -- declaration of the object occurs in the private part of a package.
1981
1982 -- Initialization_Statements (Node28)
1983 -- Defined in constants and variables. For a composite object initialized
1984 -- initialized with an aggregate that has been converted to a sequence
1985 -- of assignments, points to a block statement containing the
1986 -- assignments.
1987
1988 -- Inner_Instances (Elist23)
1989 -- Defined in generic units. Contains element list of units that are
1990 -- instantiated within the given generic. Used to diagnose circular
1991 -- instantiations.
1992
1993 -- Interface_Alias (Node25)
1994 -- Defined in subprograms that cover a primitive operation of an abstract
1995 -- interface type. Can be set only if the Is_Hidden flag is also set,
1996 -- since such entities are always hidden. Points to its associated
1997 -- interface subprogram. It is used to register the subprogram in
1998 -- secondary dispatch table of the interface (Ada 2005: AI-251).
1999
2000 -- Interface_Name (Node21)
2001 -- Defined in constants, variables, exceptions, functions, procedures,
2002 -- packages, components (JGNAT only), discriminants (JGNAT only), and
2003 -- access to subprograms (JGNAT only). Set to Empty unless an export,
2004 -- import, or interface name pragma has explicitly specified an external
2005 -- name, in which case it references an N_String_Literal node for the
2006 -- specified external name. In the case of exceptions, the field is set
2007 -- by Import_Exception/Export_Exception (which can be used in OpenVMS
2008 -- versions only). Note that if this field is Empty, and Is_Imported
2009 -- or Is_Exported is set, then the default interface name is the name
2010 -- of the entity, cased in a manner that is appropriate to the system
2011 -- in use. Note that Interface_Name is ignored if an address clause
2012 -- is present (since it is meaningless in this case).
2013 --
2014 -- An additional special case usage of this field is in JGNAT for
2015 -- E_Component and E_Discriminant. JGNAT allows these entities to be
2016 -- imported by specifying pragma Import within a component's containing
2017 -- record definition. This supports interfacing to object fields defined
2018 -- within Java classes, and such pragmas are generated by the jvm2ada
2019 -- binding generator tool whenever it processes classes with public
2020 -- object fields. A pragma Import for a component can define the
2021 -- External_Name of the imported Java field (which is generally needed,
2022 -- because Java names are case sensitive).
2023
2024 -- Interfaces (Elist25)
2025 -- Defined in record types and subtypes. List of abstract interfaces
2026 -- implemented by a tagged type that are not already implemented by the
2027 -- ancestors (Ada 2005: AI-251).
2028
2029 -- Invariant_Procedure (synthesized)
2030 -- Defined in types and subtypes. Set for private types if one or more
2031 -- Invariant, or Invariant'Class, or inherited Invariant'Class aspects
2032 -- apply to the type. Points to the entity for a procedure which checks
2033 -- the invariant. This invariant procedure takes a single argument of the
2034 -- given type, and returns if the invariant holds, or raises exception
2035 -- Assertion_Error with an appropriate message if it does not hold. This
2036 -- attribute is defined but always empty for private subtypes. This
2037 -- attribute is also set for the corresponding full type.
2038 --
2039 -- Note: the reason this is marked as a synthesized attribute is that the
2040 -- way this is stored is as an element of the Subprograms_For_Type field.
2041
2042 -- In_Use (Flag8)
2043 -- Defined in packages and types. Set when analyzing a use clause for
2044 -- the corresponding entity. Reset at end of corresponding declarative
2045 -- part. The flag on a type is also used to determine the visibility of
2046 -- the primitive operators of the type.
2047
2048 -- Is_Abstract_Subprogram (Flag19)
2049 -- Defined in all subprograms and entries. Set for abstract subprograms.
2050 -- Always False for enumeration literals and entries. See also
2051 -- Requires_Overriding.
2052
2053 -- Is_Abstract_Type (Flag146)
2054 -- Defined in all types. Set for abstract types.
2055
2056 -- Is_Access_Constant (Flag69)
2057 -- Defined in access types and subtypes. Indicates that the keyword
2058 -- constant was present in the access type definition.
2059
2060 -- Is_Access_Protected_Subprogram_Type (synthesized)
2061 -- Applies to all types, true for named and anonymous access to
2062 -- protected subprograms.
2063
2064 -- Is_Access_Type (synthesized)
2065 -- Applies to all entities, true for access types and subtypes
2066
2067 -- Is_Ada_2005_Only (Flag185)
2068 -- Defined in all entities, true if a valid pragma Ada_05 or Ada_2005
2069 -- applies to the entity which specifically names the entity, indicating
2070 -- that the entity is Ada 2005 only. Note that this flag is not set if
2071 -- the entity is part of a unit compiled with the normal no-argument form
2072 -- of pragma Ada_05 or Ada_2005.
2073
2074 -- Is_Ada_2012_Only (Flag199)
2075 -- Defined in all entities, true if a valid pragma Ada_12 or Ada_2012
2076 -- applies to the entity which specifically names the entity, indicating
2077 -- that the entity is Ada 2012 only. Note that this flag is not set if
2078 -- the entity is part of a unit compiled with the normal no-argument form
2079 -- of pragma Ada_12 or Ada_2012.
2080
2081 -- Is_Aliased (Flag15)
2082 -- Defined in all entities. Set for objects and types whose declarations
2083 -- carry the keyword aliased, and on record components that have the
2084 -- keyword. For Ada 2012, also applies to formal parameters.
2085
2086 -- Is_AST_Entry (Flag132)
2087 -- Defined in entry entities. Set if a valid pragma AST_Entry applies
2088 -- to the entry. This flag can only be set in OpenVMS versions of GNAT.
2089 -- Note: we also allow the flag to appear in entry families, but given
2090 -- the current implementation of the pragma AST_Entry, this flag will
2091 -- always be False in entry families.
2092
2093 -- Is_Atomic (Flag85)
2094 -- Defined in all type entities, and also in constants, components and
2095 -- variables. Set if a pragma Atomic or Shared applies to the entity.
2096 -- In the case of private and incomplete types, this flag is set in
2097 -- both the partial view and the full view.
2098
2099 -- Is_Array_Type (synthesized)
2100 -- Applies to all entities, true for array types and subtypes
2101
2102 -- Is_Asynchronous (Flag81)
2103 -- Defined in all type entities and in procedure entities. Set
2104 -- if a pragma Asynchronous applies to the entity.
2105
2106 -- Is_Base_Type (synthesized)
2107 -- Applies to type and subtype entities. True if entity is a base type
2108
2109 -- Is_Bit_Packed_Array (Flag122) [implementation base type only]
2110 -- Defined in all entities. This flag is set for a packed array type that
2111 -- is bit packed (i.e. the component size is known by the front end and
2112 -- is in the range 1-7, 9-15, 17-31, or 33-63). Is_Packed is always set
2113 -- if Is_Bit_Packed_Array is set, but it is possible for Is_Packed to be
2114 -- set without Is_Bit_Packed_Array for the case of an array having one or
2115 -- more index types that are enumeration types with non-standard
2116 -- enumeration representations.
2117
2118 -- Is_Boolean_Type (synthesized)
2119 -- Applies to all entities, true for boolean types and subtypes,
2120 -- i.e. Standard.Boolean and all types ultimately derived from it.
2121
2122 -- Is_Called (Flag102)
2123 -- Defined in subprograms. Returns true if the subprogram is called
2124 -- in the unit being compiled or in a unit in the context. Used for
2125 -- inlining.
2126
2127 -- Is_Character_Type (Flag63)
2128 -- Defined in all entities. Set for character types and subtypes,
2129 -- i.e. enumeration types that have at least one character literal.
2130
2131 -- Is_Child_Unit (Flag73)
2132 -- Defined in all entities. Set only for defining entities of program
2133 -- units that are child units (but False for subunits).
2134
2135 -- Is_Class_Wide_Type (synthesized)
2136 -- Applies to all entities, true for class wide types and subtypes
2137
2138 -- Is_Class_Wide_Equivalent_Type (Flag35)
2139 -- Defined in record types and subtypes. Set to True, if the type acts
2140 -- as a class-wide equivalent type, i.e. the Equivalent_Type field of
2141 -- some class-wide subtype entity references this record type.
2142
2143 -- Is_Compilation_Unit (Flag149)
2144 -- Defined in all entities. Set if the entity is a package or subprogram
2145 -- entity for a compilation unit other than a subunit (since we treat
2146 -- subunits as part of the same compilation operation as the ultimate
2147 -- parent, we do not consider them to be separate units for this flag).
2148
2149 -- Is_Completely_Hidden (Flag103)
2150 -- Defined in all entities. This flag can be set only for E_Discriminant
2151 -- entities. This flag can be set only for girder discriminants of
2152 -- untagged types. When set, the entity is a girder discriminant of a
2153 -- derived untagged type which is not directly visible in the derived
2154 -- type because the derived type or one of its ancestors have renamed the
2155 -- discriminants in the root type. Note: there are girder discriminants
2156 -- which are not Completely_Hidden (e.g. discriminants of a root type).
2157
2158 -- Is_Composite_Type (synthesized)
2159 -- Applies to all entities, true for all composite types and
2160 -- subtypes. Either Is_Composite_Type or Is_Elementary_Type (but
2161 -- not both) is true of any type.
2162
2163 -- Is_Concurrent_Record_Type (Flag20)
2164 -- Defined in record types and subtypes. Set if the type was created
2165 -- by the expander to represent a task or protected type. For every
2166 -- concurrent type, such as record type is constructed, and task and
2167 -- protected objects are instances of this record type at runtime
2168 -- (Gigi will replace declarations of the concurrent type using the
2169 -- declarations of the corresponding record type). See package Exp_Ch9
2170 -- for further details.
2171
2172 -- Is_Concurrent_Type (synthesized)
2173 -- Applies to all entities, true for task types and subtypes and for
2174 -- protected types and subtypes.
2175
2176 -- Is_Constant_Object (synthesized)
2177 -- Applies to all entities, true for E_Constant, E_Loop_Parameter, and
2178 -- E_In_Parameter entities.
2179
2180 -- Is_Constrained (Flag12)
2181 -- Defined in types or subtypes which may have index, discriminant
2182 -- or range constraint (i.e. array types and subtypes, record types
2183 -- and subtypes, string types and subtypes, and all numeric types).
2184 -- Set if the type or subtype is constrained.
2185
2186 -- Is_Constr_Subt_For_U_Nominal (Flag80)
2187 -- Defined in all types and subtypes. Set only for the constructed
2188 -- subtype of an object whose nominal subtype is unconstrained. Note
2189 -- that the constructed subtype itself will be constrained.
2190
2191 -- Is_Constr_Subt_For_UN_Aliased (Flag141)
2192 -- Defined in all types and subtypes. This flag can be set only if
2193 -- Is_Constr_Subt_For_U_Nominal is also set. It indicates that in
2194 -- addition the object concerned is aliased. This flag is used by
2195 -- Gigi to determine whether a template must be constructed.
2196
2197 -- Is_Constructor (Flag76)
2198 -- Defined in function and procedure entities. Set if a pragma
2199 -- CPP_Constructor applies to the subprogram.
2200
2201 -- Is_Controlled (Flag42) [base type only]
2202 -- Defined in all type entities. Indicates that the type is controlled,
2203 -- i.e. is either a descendant of Ada.Finalization.Controlled or of
2204 -- Ada.Finalization.Limited_Controlled.
2205
2206 -- Is_Controlling_Formal (Flag97)
2207 -- Defined in all Formal_Kind entities. Marks the controlling parameters
2208 -- of dispatching operations.
2209
2210 -- Is_CPP_Class (Flag74)
2211 -- Defined in all type entities, set only for tagged types to which a
2212 -- valid pragma Import (CPP, ...) or pragma CPP_Class has been applied.
2213
2214 -- Is_Decimal_Fixed_Point_Type (synthesized)
2215 -- Applies to all type entities, true for decimal fixed point
2216 -- types and subtypes.
2217
2218 -- Is_Descendent_Of_Address (Flag223)
2219 -- Defined in all entities. True if the entity is type System.Address,
2220 -- or (recursively) a subtype or derived type of System.Address.
2221
2222 -- Is_Discrete_Type (synthesized)
2223 -- Applies to all entities, true for all discrete types and subtypes
2224
2225 -- Is_Discrete_Or_Fixed_Point_Type (synthesized)
2226 -- Applies to all entities, true for all discrete types and subtypes
2227 -- and all fixed-point types and subtypes.
2228
2229 -- Is_Discrim_SO_Function (Flag176)
2230 -- Defined in all entities. Set only in E_Function entities that Layout
2231 -- creates to compute discriminant-dependent dynamic size/offset values.
2232
2233 -- Is_Discriminal (synthesized)
2234 -- Applies to all entities, true for renamings of discriminants. Such
2235 -- entities appear as constants or IN parameters.
2236
2237 -- Is_Dispatch_Table_Entity (Flag234)
2238 -- Applies to all entities. Set to indicate to the backend that this
2239 -- entity is associated with a dispatch table.
2240
2241 -- Is_Dispatching_Operation (Flag6)
2242 -- Defined in all entities. Set for procedures, functions, generic
2243 -- procedures, and generic functions if the corresponding operation
2244 -- is dispatching.
2245
2246 -- Is_Dynamic_Scope (synthesized)
2247 -- Applies to all Entities. Returns True if the entity is a dynamic
2248 -- scope (i.e. a block, subprogram, task_type, entry
2249 -- or extended return statement).
2250
2251 -- Is_Elementary_Type (synthesized)
2252 -- Applies to all entities, true for all elementary types and
2253 -- subtypes. Either Is_Composite_Type or Is_Elementary_Type (but
2254 -- not both) is true of any type.
2255
2256 -- Is_Eliminated (Flag124)
2257 -- Defined in type entities, subprogram entities, and object entities.
2258 -- Indicates that the corresponding entity has been eliminated by use
2259 -- of pragma Eliminate. Also used to mark subprogram entities whose
2260 -- declaration and body are within unreachable code that is removed.
2261
2262 -- Is_Enumeration_Type (synthesized)
2263 -- Defined in all entities, true for enumeration types and subtypes
2264
2265 -- Is_Entry (synthesized)
2266 -- Applies to all entities, True only for entry and entry family
2267 -- entities and False for all other entity kinds.
2268
2269 -- Is_Entry_Formal (Flag52)
2270 -- Defined in all entities. Set only for entry formals (which can only
2271 -- be in, in-out or out parameters). This flag is used to speed up the
2272 -- test for the need to replace references in Exp_Ch2.
2273
2274 -- Is_Exported (Flag99)
2275 -- Defined in all entities. Set if the entity is exported. For now we
2276 -- only allow the export of constants, exceptions, functions, procedures
2277 -- and variables, but that may well change later on. Exceptions can only
2278 -- be exported in the OpenVMS and Java VM implementations of GNAT.
2279
2280 -- Is_External_State (synthesized)
2281 -- Applies to all entities, true for abstract states that are subject to
2282 -- option External.
2283
2284 -- Is_Finalizer (synthesized)
2285 -- Applies to all entities, true for procedures containing finalization
2286 -- code to process local or library level objects.
2287
2288 -- Is_First_Subtype (Flag70)
2289 -- Defined in all entities. True for first subtypes (RM 3.2.1(6)),
2290 -- i.e. the entity in the type declaration that introduced the type.
2291 -- This may be the base type itself (e.g. for record declarations and
2292 -- enumeration type declarations), or it may be the first subtype of
2293 -- an anonymous base type (e.g. for integer type declarations or
2294 -- constrained array declarations).
2295
2296 -- Is_Fixed_Point_Type (synthesized)
2297 -- Applies to all entities, true for decimal and ordinary fixed
2298 -- point types and subtypes
2299
2300 -- Is_Floating_Point_Type (synthesized)
2301 -- Applies to all entities, true for float types and subtypes
2302
2303 -- Is_Formal (synthesized)
2304 -- Applies to all entities, true for IN, IN OUT and OUT parameters
2305
2306 -- Is_Formal_Object (synthesized)
2307 -- Applies to all entities, true for generic IN and IN OUT parameters
2308
2309 -- Is_Formal_Subprogram (Flag111)
2310 -- Defined in all entities. Set for generic formal subprograms.
2311
2312 -- Is_For_Access_Subtype (Flag118)
2313 -- Defined in E_Private_Subtype and E_Record_Subtype entities. Means the
2314 -- sole purpose of the type is to be designated by an Access_Subtype and
2315 -- hence should not be expanded into components because the type may not
2316 -- have been found or frozen yet.
2317
2318 -- Is_Frozen (Flag4)
2319 -- Defined in all type and subtype entities. Set if type or subtype has
2320 -- been frozen.
2321
2322 -- Is_Generic_Actual_Type (Flag94)
2323 -- Defined in all type and subtype entities. Set in the subtype
2324 -- declaration that renames the generic formal as a subtype of the
2325 -- actual. Guarantees that the subtype is not static within the instance.
2326
2327 -- Is_Generic_Instance (Flag130)
2328 -- Defined in all entities. Set to indicate that the entity is an
2329 -- instance of a generic unit, or a formal package (which is an instance
2330 -- of the template).
2331
2332 -- Is_Generic_Subprogram (synthesized)
2333 -- Applies to all entities. Yields True for a generic subprogram
2334 -- (generic function, generic subprogram), False for all other entities.
2335
2336 -- Is_Generic_Type (Flag13)
2337 -- Defined in all entities. Set for types which are generic formal types.
2338 -- Such types have an Ekind that corresponds to their classification, so
2339 -- the Ekind cannot be used to identify generic formal types.
2340
2341 -- Is_Generic_Unit (synthesized)
2342 -- Applies to all entities. Yields True for a generic unit (generic
2343 -- package, generic function, generic procedure), and False for all
2344 -- other entities.
2345
2346 -- Is_Ghost_Entity (synthesized)
2347 -- Applies to all entities. Yields True for a subprogram or a whole
2348 -- object that has convention Ghost.
2349
2350 -- Is_Ghost_Subprogram (synthesized)
2351 -- Applies to all entities. Yields True for a subprogram that has a Ghost
2352 -- convention.
2353
2354 -- Is_Hidden (Flag57)
2355 -- Defined in all entities. Set for all entities declared in the
2356 -- private part or body of a package. Also marks generic formals of a
2357 -- formal package declared without a box. For library level entities,
2358 -- this flag is set if the entity is not publicly visible. This flag
2359 -- is reset when compiling the body of the package where the entity
2360 -- is declared, when compiling the private part or body of a public
2361 -- child unit, and when compiling a private child unit (see Install_
2362 -- Private_Declaration in sem_ch7).
2363
2364 -- Is_Hidden_Open_Scope (Flag171)
2365 -- Defined in all entities. Set for a scope that contains the
2366 -- instantiation of a child unit, and whose entities are not visible
2367 -- during analysis of the instance.
2368
2369 -- Is_Immediately_Visible (Flag7)
2370 -- Defined in all entities. Set if entity is immediately visible, i.e.
2371 -- is defined in some currently open scope (RM 8.3(4)).
2372
2373 -- Is_Implementation_Defined (Flag254)
2374 -- Defined in all entities. Set if a pragma Implementation_Defined is
2375 -- applied to the pragma. Used to mark all implementation defined
2376 -- identifiers in standard library packages, and to implement the
2377 -- restriction No_Implementation_Identifiers.
2378
2379 -- Is_Imported (Flag24)
2380 -- Defined in all entities. Set if the entity is imported. For now we
2381 -- only allow the import of exceptions, functions, procedures, packages.
2382 -- and variables. Exceptions can only be imported in the OpenVMS and
2383 -- Java VM implementations of GNAT. Packages and types can only be
2384 -- imported in the Java VM implementation.
2385
2386 -- Is_Incomplete_Or_Private_Type (synthesized)
2387 -- Applies to all entities, true for private and incomplete types
2388
2389 -- Is_Incomplete_Type (synthesized)
2390 -- Applies to all entities, true for incomplete types and subtypes
2391
2392 -- Is_Inlined (Flag11)
2393 -- Defined in all entities. Set for functions and procedures which are
2394 -- to be inlined. For subprograms created during expansion, this flag
2395 -- may be set directly by the expander to request inlining. Also set
2396 -- for packages that contain inlined subprograms, whose bodies must be
2397 -- be compiled. Is_Inlined is also set on generic subprograms and is
2398 -- inherited by their instances. It is also set on the body entities
2399 -- of inlined subprograms. See also Has_Pragma_Inline.
2400
2401 -- Is_Input_Only_State (synthesized)
2402 -- Applies to all entities, true for abstract states that are subject to
2403 -- option Input_Only.
2404
2405 -- Is_Instantiated (Flag126)
2406 -- Defined in generic packages and generic subprograms. Set if the unit
2407 -- is instantiated from somewhere in the extended main source unit. This
2408 -- flag is used to control warnings about the unit being uninstantiated.
2409 -- Also set in a package that is used as an actual for a generic package
2410 -- formal in an instantiation. Also set on a parent instance, in the
2411 -- instantiation of a child, which is implicitly declared in the parent.
2412
2413 -- Is_Integer_Type (synthesized)
2414 -- Applies to all entities, true for integer types and subtypes
2415
2416 -- Is_Interface (Flag186)
2417 -- Defined in record types and subtypes. Set to indicate that the current
2418 -- entity corresponds with an abstract interface. Because abstract
2419 -- interfaces are conceptually a special kind of abstract tagged types
2420 -- we represent them by means of tagged record types and subtypes
2421 -- marked with this attribute. This allows us to reuse most of the
2422 -- compiler support for abstract tagged types to implement interfaces
2423 -- (Ada 2005: AI-251).
2424
2425 -- Is_Internal (Flag17)
2426 -- Defined in all entities. Set to indicate an entity created during
2427 -- semantic processing (e.g. an implicit type, or a temporary). The
2428 -- current uses of this flag are:
2429 --
2430 -- 1) Internal entities (such as temporaries generated for the result
2431 -- of an inlined function call or dummy variables generated for the
2432 -- debugger). Set to indicate that they need not be initialized, even
2433 -- when scalars are initialized or normalized;
2434 --
2435 -- 2) Predefined primitives of tagged types. Set to mark that they
2436 -- have specific properties: first they are primitives even if they
2437 -- are not defined in the type scope (the freezing point is not
2438 -- necessarily in the same scope), and second the predefined equality
2439 -- can be overridden by a user-defined equality, no body will be
2440 -- generated in this case.
2441 --
2442 -- 3) Object declarations generated by the expander that are implicitly
2443 -- imported or exported so that they can be marked in Sprint output.
2444 --
2445 -- 4) Internal entities in the list of primitives of tagged types that
2446 -- are used to handle secondary dispatch tables. These entities have
2447 -- also the attribute Interface_Alias.
2448
2449 -- Is_Interrupt_Handler (Flag89)
2450 -- Defined in procedures. Set if a pragma Interrupt_Handler applies
2451 -- to the procedure. The procedure must be parameterless, and on all
2452 -- targets except AAMP it must be a protected procedure.
2453
2454 -- Is_Intrinsic_Subprogram (Flag64)
2455 -- Defined in functions and procedures. It is set if a valid pragma
2456 -- Interface or Import is present for this subprogram specifying pragma
2457 -- Intrinsic. Valid means that the name and profile of the subprogram
2458 -- match the requirements of one of the recognized intrinsic subprograms
2459 -- (see package Sem_Intr for details). Note: the value of Convention for
2460 -- such an entity will be set to Convention_Intrinsic, but it is the
2461 -- setting of Is_Intrinsic_Subprogram, NOT simply having convention set
2462 -- to intrinsic, which causes intrinsic code to be generated.
2463
2464 -- Is_Invariant_Procedure (Flag257)
2465 -- Defined in functions an procedures. Set for a generated invariant
2466 -- procedure to identify it easily in the
2467
2468 -- Is_Itype (Flag91)
2469 -- Defined in all entities. Set to indicate that a type is an Itype,
2470 -- which means that the declaration for the type does not appear
2471 -- explicitly in the tree. Instead gigi will elaborate the type when it
2472 -- is first used. Has_Delayed_Freeze can be set for Itypes, and the
2473 -- meaning is that the first use (the one which causes the type to be
2474 -- defined) will be the freeze node. Note that an important restriction
2475 -- on Itypes is that the first use of such a type (the one that causes it
2476 -- to be defined) must be in the same scope as the type.
2477
2478 -- Is_Known_Non_Null (Flag37)
2479 -- Defined in all entities. Relevant (and can be set) only for
2480 -- objects of an access type. It is set if the object is currently
2481 -- known to have a non-null value (meaning that no access checks
2482 -- are needed). The indication can for example come from assignment
2483 -- of an access parameter or an allocator whose value is known non-null.
2484 --
2485 -- Note: this flag is set according to the sequential flow of the
2486 -- program, watching the current value of the variable. However, this
2487 -- processing can miss cases of changing the value of an aliased or
2488 -- constant object, so even if this flag is set, it should not be
2489 -- believed if the variable is aliased or volatile. It would be a
2490 -- little neater to avoid the flag being set in the first place in
2491 -- such cases, but that's trickier, and there is only one place that
2492 -- tests the value anyway.
2493 --
2494 -- The flag is dynamically set and reset as semantic analysis and
2495 -- expansion proceeds. Its value is meaningless once the tree is
2496 -- fully constructed, since it simply indicates the last state.
2497 -- Thus this flag has no meaning to the back end.
2498
2499 -- Is_Known_Null (Flag204)
2500 -- Defined in all entities. Relevant (and can be set ) only for
2501 -- objects of an access type. It is set if the object is currently known
2502 -- to have a null value (meaning that a dereference will surely raise
2503 -- constraint error exception). The indication can come from an
2504 -- assignment or object declaration.
2505 --
2506 -- The comments above about sequential flow and aliased and volatile for
2507 -- the Is_Known_Non_Null flag apply equally to the Is_Known_Null flag.
2508
2509 -- Is_Known_Valid (Flag170)
2510 -- Defined in all entities. Relevant for types (and subtype) and
2511 -- for objects (and enumeration literals) of a discrete type.
2512 --
2513 -- The purpose of this flag is to implement the requirement stated
2514 -- in (RM 13.9.1(9-11)) which require that the use of possibly invalid
2515 -- values may not cause programs to become erroneous. See the function
2516 -- Checks.Expr_Known_Valid for further details. Note that the setting
2517 -- is conservative, in the sense that if the flag is set, it must be
2518 -- right. If the flag is not set, nothing is known about the validity.
2519 --
2520 -- For enumeration literals, the flag is always set, since clearly
2521 -- an enumeration literal represents a valid value. Range checks
2522 -- where necessary will ensure that this valid value is appropriate.
2523 --
2524 -- For objects, the flag indicates the state of knowledge about the
2525 -- current value of the object. This may be modified during expansion,
2526 -- and thus the final value is not relevant to gigi.
2527 --
2528 -- For types and subtypes, the flag is set if all possible bit patterns
2529 -- of length Object_Size (i.e. Esize of the type) represent valid values
2530 -- of the type. In general for such tytpes, all values are valid, the
2531 -- only exception being the case where an object of the type has an
2532 -- explicit size that is greater than Object_Size.
2533 --
2534 -- For non-discrete objects, the setting of the Is_Known_Valid flag is
2535 -- not defined, and is not relevant, since the considerations of the
2536 -- requirement in (RM 13.9.1(9-11)) do not apply.
2537 --
2538 -- The flag is dynamically set and reset as semantic analysis and
2539 -- expansion proceeds. Its value is meaningless once the tree is
2540 -- fully constructed, since it simply indicates the last state.
2541 -- Thus this flag has no meaning to the back end.
2542
2543 -- Is_Limited_Composite (Flag106)
2544 -- Defined in all entities. Set for composite types that have a limited
2545 -- component. Used to enforce the rule that operations on the composite
2546 -- type that depend on the full view of the component do not become
2547 -- visible until the immediate scope of the composite type itself
2548 -- (RM 7.3.1 (5)).
2549
2550 -- Is_Limited_Interface (Flag197)
2551 -- Defined in record types and subtypes. True for interface types, if
2552 -- interface is declared limited, task, protected, or synchronized, or
2553 -- is derived from a limited interface.
2554
2555 -- Is_Limited_Record (Flag25)
2556 -- Defined in all entities. Set to true for record (sub)types if the
2557 -- record is declared to be limited. Note that this flag is not set
2558 -- simply because some components of the record are limited.
2559
2560 -- Is_Local_Anonymous_Access (Flag194)
2561 -- Defined in access types. Set for an anonymous access type to indicate
2562 -- that the type is created for a record component with an access
2563 -- definition, an array component, or (pre-Ada 2012) a standalone object.
2564 -- Such anonymous types have an accessibility level equal to that of the
2565 -- declaration in which they appear, unlike the anonymous access types
2566 -- that are created for access parameters, access discriminants, and
2567 -- (as of Ada 2012) stand-alone objects.
2568
2569 -- Is_Machine_Code_Subprogram (Flag137)
2570 -- Defined in subprogram entities. Set to indicate that the subprogram
2571 -- is a machine code subprogram (i.e. its body includes at least one
2572 -- code statement). Also indicates that all necessary semantic checks
2573 -- as required by RM 13.8(3) have been performed.
2574
2575 -- Is_Modular_Integer_Type (synthesized)
2576 -- Applies to all entities. True if entity is a modular integer type
2577
2578 -- Is_Non_Static_Subtype (Flag109)
2579 -- Defined in all type and subtype entities. It is set in some (but not
2580 -- all) cases in which a subtype is known to be non-static. Before this
2581 -- flag was added, the computation of whether a subtype was static was
2582 -- entirely synthesized, by looking at the bounds, and the immediate
2583 -- subtype parent. However, this method does not work for some Itypes
2584 -- that have no parent set (and the only way to find the immediate
2585 -- subtype parent is to go through the tree). For now, this flag is set
2586 -- conservatively, i.e. if it is set then for sure the subtype is non-
2587 -- static, but if it is not set, then the type may or may not be static.
2588 -- Thus the test for a static subtype is that this flag is clear AND that
2589 -- the bounds are static AND that the parent subtype (if available to be
2590 -- tested) is static. Eventually we should make sure this flag is always
2591 -- set right, at which point, these comments can be removed, and the
2592 -- tests for static subtypes greatly simplified.
2593
2594 -- Is_Non_Volatile_State (synthesized)
2595 -- Applies to all entities, true for abstract states that are subject to
2596 -- option Non_Volatile.
2597
2598 -- Is_Null_Init_Proc (Flag178)
2599 -- Defined in procedure entities. Set for generated init proc procedures
2600 -- (used to initialize composite types), if the code for the procedure
2601 -- is null (i.e. is a return and nothing else). Such null initialization
2602 -- procedures are generated in case some client is compiled using the
2603 -- Initialize_Scalars pragma, generating a call to this null procedure,
2604 -- but there is no need to call such procedures within a compilation
2605 -- unit, and this flag is used to suppress such calls.
2606
2607 -- Is_Null_State (synthesized)
2608 -- Applies to all entities, true for an abstract state declared with
2609 -- keyword null.
2610
2611 -- Is_Numeric_Type (synthesized)
2612 -- Applies to all entities, true for all numeric types and subtypes
2613 -- (integer, fixed, float).
2614
2615 -- Is_Object (synthesized)
2616 -- Applies to all entities, true for entities representing objects,
2617 -- including generic formal parameters.
2618
2619 -- Is_Obsolescent (Flag153)
2620 -- Defined in all entities. Set for any entity for which a valid pragma
2621 -- Obsolescent applies.
2622
2623 -- Is_Only_Out_Parameter (Flag226)
2624 -- Defined in formal parameter entities. Set if this parameter is the
2625 -- only OUT parameter for this formal part. If there is more than one
2626 -- out parameter, or if there is some other IN OUT parameter then this
2627 -- flag is not set in any of them. Used in generation of warnings.
2628
2629 -- Is_Optional_Parameter (Flag134)
2630 -- Defined in parameter entities. Set if the parameter is specified as
2631 -- optional by use of a First_Optional_Parameter argument to one of the
2632 -- extended Import pragmas. Can only be set for OpenVMS versions of GNAT.
2633
2634 -- Is_Ordinary_Fixed_Point_Type (synthesized)
2635 -- Applies to all entities, true for ordinary fixed point types and
2636 -- subtypes.
2637
2638 -- Is_Output_Only_State (synthesized)
2639 -- Applies to all entities, true for abstract states that are subject to
2640 -- option Output_Only.
2641
2642 -- Is_Package_Or_Generic_Package (synthesized)
2643 -- Applies to all entities. True for packages and generic packages.
2644 -- False for all other entities.
2645
2646 -- Is_Package_Body_Entity (Flag160)
2647 -- Defined in all entities. Set for entities defined at the top level
2648 -- of a package body. Used to control externally generated names.
2649
2650 -- Is_Packed (Flag51) [implementation base type only]
2651 -- Defined in all type entities. This flag is set only for record and
2652 -- array types which have a packed representation. There are three
2653 -- cases which cause packing:
2654 --
2655 -- 1. Explicit use of pragma Pack for an array of package components
2656 -- 2. Explicit use of pragma Pack to pack a record
2657 -- 4. Setting Component_Size of an array to a bit-packable value
2658 -- 3. Indexing an array with a non-standard enumeration type.
2659 --
2660 -- For records, Is_Packed is always set if Has_Pragma_Pack is set,
2661 -- and can also be set on its own in a derived type which inherited
2662 -- its packed status.
2663 --
2664 -- For arrays, Is_Packed is set if an array is bit packed (i.e. the
2665 -- component size is known at compile time and is 1-7, 9-15 or 17-31),
2666 -- or if the array has one or more index types that are enumeration
2667 -- types with non-standard representations (in GNAT, we store such
2668 -- arrays compactly, using the Pos of the enumeration type value).
2669 --
2670 -- As for the case of records, Is_Packed can be set on its own for a
2671 -- derived type, with the same dual before/after freeze meaning.
2672 -- Is_Packed can also be set as the result of an explicit component
2673 -- size clause that specifies an appropriate component size.
2674 --
2675 -- In the bit packed array case, Is_Bit_Packed_Array will be set in
2676 -- the bit packed case once the array type is frozen.
2677 --
2678 -- Before an array type is frozen, Is_Packed will always be set if
2679 -- Has_Pragma_Pack is set. Before the freeze point, it is not possible
2680 -- to know the component size, since the component type is not frozen
2681 -- until the array type is frozen. Thus Is_Packed for an array type
2682 -- before it is frozen means that packed is required. Then if it turns
2683 -- out that the component size is not suitable for bit packing, the
2684 -- Is_Packed flag gets turned off.
2685
2686 -- Is_Packed_Array_Type (Flag138)
2687 -- Defined in all entities. This flag is set on the entity for the type
2688 -- used to implement a packed array (either a modular type, or a subtype
2689 -- of Packed_Bytes{1,2,4} as appropriate). The flag is set if and only
2690 -- if the type appears in the Packed_Array_Type field of some other type
2691 -- entity. It is used by Gigi to activate the special processing for such
2692 -- types (unchecked conversions that would not otherwise be allowed are
2693 -- allowed for such types). If the Is_Packed_Array_Type flag is set in
2694 -- an entity, then the Original_Array_Type field of this entity points
2695 -- to the original array type for which this is the packed array type.
2696
2697 -- Is_Potentially_Use_Visible (Flag9)
2698 -- Defined in all entities. Set if entity is potentially use visible,
2699 -- i.e. it is defined in a package that appears in a currently active
2700 -- use clause (RM 8.4(8)). Note that potentially use visible entities
2701 -- are not necessarily use visible (RM 8.4(9-11)).
2702
2703 -- Is_Predicate_Function (Flag255)
2704 -- Present in functions and procedures. Set for generated predicate
2705 -- functions.
2706
2707 -- Is_Predicate_Function_M (Flag256)
2708 -- Present in functions and procedures. Set for special version of
2709 -- predicate function generated for use in membership tests, where
2710 -- raise expressions are transformed to return False.
2711
2712 -- Is_Preelaborated (Flag59)
2713 -- Defined in all entities, set in E_Package and E_Generic_Package
2714 -- entities to which a pragma Preelaborate is applied, and also in
2715 -- all entities within such packages. Note that the fact that this
2716 -- flag is set does not necesarily mean that no elaboration code is
2717 -- generated for the package.
2718
2719 -- Is_Primitive (Flag218)
2720 -- Defined in overloadable entities and in generic subprograms. Set to
2721 -- indicate that this is a primitive operation of some type, which may
2722 -- be a tagged type or a non-tagged type. Used to verify overriding
2723 -- indicators in bodies.
2724
2725 -- Is_Primitive_Wrapper (Flag195)
2726 -- Defined in functions and procedures created by the expander to serve
2727 -- as an indirection mechanism to overriding primitives of concurrent
2728 -- types, entries and protected procedures.
2729
2730 -- Is_Prival (synthesized)
2731 -- Applies to all entities, true for renamings of private protected
2732 -- components. Such entities appear as constants or variables.
2733
2734 -- Is_Private_Composite (Flag107)
2735 -- Defined in composite types that have a private component. Used to
2736 -- enforce the rule that operations on the composite type that depend
2737 -- on the full view of the component, do not become visible until the
2738 -- immediate scope of the composite type itself (7.3.1 (5)). Both this
2739 -- flag and Is_Limited_Composite are needed.
2740
2741 -- Is_Private_Descendant (Flag53)
2742 -- Defined in entities that can represent library units (packages,
2743 -- functions, procedures). Set if the library unit is itself a private
2744 -- child unit, or if it is the descendent of a private child unit.
2745
2746 -- Is_Private_Primitive (Flag245)
2747 -- Defined in subprograms. Set if the operation is a primitive of a
2748 -- tagged type (procedure or function dispatching on result) whose
2749 -- full view has not been seen. Used in particular for primitive
2750 -- subprograms of a synchronized type declared between the two views
2751 -- of the type, so that the wrapper built for such a subprogram can
2752 -- be given the proper signature.
2753
2754 -- Is_Private_Type (synthesized)
2755 -- Applies to all entities, true for private types and subtypes,
2756 -- as well as for record with private types as subtypes
2757
2758 -- Is_Processed_Transient (Flag252)
2759 -- Defined in entities of variables and constants. Set when a transient
2760 -- object needs to be finalized and it has already been processed by the
2761 -- transient scope machinery. This flag signals the general finalization
2762 -- mechanism to ignore the transient object.
2763
2764 -- Is_Protected_Component (synthesized)
2765 -- Applicable to all entities, true if the entity denotes a private
2766 -- component of a protected type.
2767
2768 -- Is_Protected_Interface (synthesized)
2769 -- Defined in types that are interfaces. True if interface is declared
2770 -- protected, or is derived from protected interfaces.
2771
2772 -- Is_Protected_Type (synthesized)
2773 -- Applies to all entities, true for protected types and subtypes
2774
2775 -- Is_Public (Flag10)
2776 -- Defined in all entities. Set to indicate that an entity defined in
2777 -- one compilation unit can be referenced from other compilation units.
2778 -- If this reference causes a reference in the generated variable, for
2779 -- example in the case of a variable name, then Gigi will generate an
2780 -- appropriate external name for use by the linker.
2781
2782 -- Is_Protected_Record_Type (synthesized)
2783 -- Applies to all entities, true if Is_Concurrent_Record_Type is true and
2784 -- Corresponding_Concurrent_Type is a protected type.
2785
2786 -- Is_Pure (Flag44)
2787 -- Defined in all entities. Set in all entities of a unit to which a
2788 -- pragma Pure is applied, and also set for the entity of the unit
2789 -- itself. In addition, this flag may be set for any other functions
2790 -- or procedures that are known to be side effect free, so in the case
2791 -- of subprograms, the Is_Pure flag may be used by the optimizer to
2792 -- imply that it can assume freedom from side effects (other than those
2793 -- resulting from assignment to out parameters, or to objects designated
2794 -- by access parameters).
2795
2796 -- Is_Pure_Unit_Access_Type (Flag189)
2797 -- Defined in access type and subtype entities. Set if the type or
2798 -- subtype appears in a pure unit. Used to give an error message at
2799 -- freeze time if the access type has a storage pool.
2800
2801 -- Is_RACW_Stub_Type (Flag244)
2802 -- Defined in all types, true for the stub types generated for remote
2803 -- access-to-class-wide types.
2804
2805 -- Is_Raised (Flag224)
2806 -- Defined in exception entities. Set if the entity is referenced by a
2807 -- a raise statement.
2808
2809 -- Is_Real_Type (synthesized)
2810 -- Applies to all entities, true for real types and subtypes
2811
2812 -- Is_Record_Type (synthesized)
2813 -- Applies to all entities, true for record types and subtypes,
2814 -- includes class-wide types and subtypes (which are also records)
2815
2816 -- Is_Remote_Call_Interface (Flag62)
2817 -- Defined in all entities. Set in E_Package and E_Generic_Package
2818 -- entities to which a pragma Remote_Call_Interface is applied, and
2819 -- also on entities declared in the visible part of such a package.
2820
2821 -- Is_Remote_Types (Flag61)
2822 -- Defined in all entities. Set in E_Package and E_Generic_Package
2823 -- entities to which a pragma Remote_Types is applied, and also on
2824 -- entities declared in the visible part of the spec of such a package.
2825 -- Also set for types which are generic formal types to which the
2826 -- pragma Remote_Access_Type applies.
2827
2828 -- Is_Renaming_Of_Object (Flag112)
2829 -- Defined in all entities, set only for a variable or constant for
2830 -- which the Renamed_Object field is non-empty and for which the
2831 -- renaming is handled by the front end, by macro substitution of
2832 -- a copy of the (evaluated) name tree whereever the variable is used.
2833
2834 -- Is_Return_Object (Flag209)
2835 -- Defined in all object entities. True if the object is the return
2836 -- object of an extended_return_statement; False otherwise.
2837
2838 -- Is_Safe_To_Reevaluate (Flag249)
2839 -- Defined in all entities. Set in variables that are initialized by
2840 -- means of an assignment statement. When initialized their contents
2841 -- never change and hence they can be seen by the backend as constants.
2842 -- See also Is_True_Constant.
2843
2844 -- Is_Scalar_Type (synthesized)
2845 -- Applies to all entities, true for scalar types and subtypes
2846
2847 -- Is_Shared_Passive (Flag60)
2848 -- Defined in all entities. Set in E_Package and E_Generic_Package
2849 -- entities to which a pragma Shared_Passive is applied, and also in
2850 -- all entities within such packages.
2851
2852 -- Is_Standard_Character_Type (synthesized)
2853 -- Applies to all entities, true for types and subtypes whose root type
2854 -- is one of the standard character types (Character, Wide_Character,
2855 -- Wide_Wide_Character).
2856
2857 -- Is_Statically_Allocated (Flag28)
2858 -- Defined in all entities. This can only be set for exception,
2859 -- variable, constant, and type/subtype entities. If the flag is set,
2860 -- then the variable or constant must be allocated statically rather
2861 -- than on the local stack frame. For exceptions, the meaning is that
2862 -- the exception data should be allocated statically (and indeed this
2863 -- flag is always set for exceptions, since exceptions do not have
2864 -- local scope). For a type, the meaning is that the type must be
2865 -- elaborated at the global level rather than locally. No type marked
2866 -- with this flag may depend on a local variable, or on any other type
2867 -- which does not also have this flag set to True. For a variable or
2868 -- or constant, if the flag is set, then the type of the object must
2869 -- either be declared at the library level, or it must also have the
2870 -- flag set (since to allocate the object statically, its type must
2871 -- also be elaborated globally).
2872
2873 -- Is_String_Type (synthesized)
2874 -- Applies to all type entities. Determines if the given type is a
2875 -- string type, i.e. it is directly a string type or string subtype,
2876 -- or a string slice type, or an array type with one dimension and a
2877 -- component type that is a character type.
2878
2879 -- Is_Subprogram (synthesized)
2880 -- Applies to all entities, true for function, procedure and operator
2881 -- entities.
2882
2883 -- Is_Synchronized_Interface (synthesized)
2884 -- Defined in types that are interfaces. True if interface is declared
2885 -- synchronized, task, or protected, or is derived from a synchronized
2886 -- interface.
2887
2888 -- Is_Tag (Flag78)
2889 -- Defined in E_Component and E_Constant entities. For regular tagged
2890 -- type this flag is set on the tag component (whose name is Name_uTag).
2891 -- For CPP_Class tagged types, this flag marks the pointer to the main
2892 -- vtable (i.e. the one to be extended by derivation).
2893
2894 -- Is_Tagged_Type (Flag55)
2895 -- Defined in all entities. Set for an entity for a tagged type.
2896
2897 -- Is_Task_Interface (synthesized)
2898 -- Defined in types that are interfaces. True if interface is declared as
2899 -- a task interface, or if it is derived from task interfaces.
2900
2901 -- Is_Task_Record_Type (synthesized)
2902 -- Applies to all entities. True if Is_Concurrent_Record_Type
2903 -- Corresponding_Concurrent_Type is a task type.
2904
2905 -- Is_Task_Type (synthesized)
2906 -- Applies to all entities. True for task types and subtypes
2907
2908 -- Is_Thunk (Flag225)
2909 -- Defined in all entities. True for subprograms that are thunks: that is
2910 -- small subprograms built by the expander for tagged types that cover
2911 -- interface types. As part of the runtime call to an interface, thunks
2912 -- displace the pointer to the object (pointer named "this" in the C++
2913 -- terminology) from a secondary dispatch table to the primary dispatch
2914 -- table associated with a given tagged type; if the thunk is a function
2915 -- that returns an object which covers an interface type then the thunk
2916 -- displaces the pointer to the object from the primary dispatch table to
2917 -- the secondary dispatch table associated with the interface type. Set
2918 -- by Expand_Interface_Thunk and used by Expand_Call to handle extra
2919 -- actuals associated with accessibility level.
2920
2921 -- Is_Trivial_Subprogram (Flag235)
2922 -- Defined in all entities. Set in subprograms where either the body
2923 -- consists of a single null statement, or the first or only statement
2924 -- of the body raises an exception. This is used for suppressing certain
2925 -- warnings, see Sem_Ch6.Analyze_Subprogram_Body discussion for details.
2926
2927 -- Is_True_Constant (Flag163)
2928 -- Defined in all entities for constants and variables. Set in constants
2929 -- and variables which have an initial value specified but which are
2930 -- never assigned, partially or in the whole. For variables, it means
2931 -- that the variable was initialized but never modified, and hence can be
2932 -- treated as a constant by the code generator. For a constant, it means
2933 -- that the constant was not modified by generated code (e.g. to set a
2934 -- discriminant in an init proc). Assignments by user or generated code
2935 -- will reset this flag. See also Is_Safe_To_Reevaluate.
2936
2937 -- Is_Type (synthesized)
2938 -- Applies to all entities, true for a type entity
2939
2940 -- Is_Unchecked_Union (Flag117) [implementation base type only]
2941 -- Defined in all entities. Set only in record types to which the
2942 -- pragma Unchecked_Union has been validly applied.
2943
2944 -- Is_Underlying_Record_View (Flag246) [base type only]
2945 -- Defined in all entities. Set only in record types that represent the
2946 -- underlying record view. This view is built for derivations of types
2947 -- with unknown discriminants; it is a record with the same structure
2948 -- as its corresponding record type, but whose parent is the full view
2949 -- of the parent in the original type extension.
2950
2951 -- Is_Unsigned_Type (Flag144)
2952 -- Defined in all types, but can be set only for discrete and fixed-point
2953 -- type and subtype entities. This flag is only valid if the entity is
2954 -- frozen. If set it indicates that the representation is known to be
2955 -- unsigned (i.e. that no negative values appear in the range). This is
2956 -- normally just a reflection of the lower bound of the subtype or base
2957 -- type, but there is one case in which the setting is non-obvious,
2958 -- namely the case of an unsigned subtype of a signed type from which
2959 -- a further subtype is obtained using variable bounds. This further
2960 -- subtype is still unsigned, but this cannot be determined by looking
2961 -- at its bounds or the bounds of the corresponding base type.
2962
2963 -- Is_Valued_Procedure (Flag127)
2964 -- Defined in procedure entities. Set if an Import_Valued_Procedure
2965 -- or Export_Valued_Procedure pragma applies to the procedure entity.
2966
2967 -- Is_Visible_Formal (Flag206)
2968 -- Defined in all entities. Set for instances of the formals of a
2969 -- formal package. Indicates that the entity must be made visible in the
2970 -- body of the instance, to reproduce the visibility of the generic.
2971 -- This simplifies visibility settings in instance bodies.
2972
2973 -- Is_Visible_Lib_Unit (Flag116)
2974 -- Defined in all (root or child) library unit entities. Once compiled,
2975 -- library units remain chained to the entities in the parent scope, and
2976 -- a separate flag must be used to indicate whether the names are visible
2977 -- by selected notation, or not.
2978
2979 -- Is_VMS_Exception (Flag133)
2980 -- Defined in all entities. Set only for exception entities where the
2981 -- exception was specified in an Import_Exception or Export_Exception
2982 -- pragma with the VMS option for Form. See description of these pragmas
2983 -- for details. This flag can only be set in OpenVMS versions of GNAT.
2984
2985 -- Is_Volatile (Flag16)
2986 -- Defined in all type entities, and also in constants, components and
2987 -- variables. Set if a pragma Volatile applies to the entity. Also set
2988 -- if pragma Shared or pragma Atomic applies to entity. In the case of
2989 -- private or incomplete types, this flag is set in both the private
2990 -- and full view. The flag is not set reliably on private subtypes,
2991 -- and is always retrieved from the base type (but this is not a base-
2992 -- type-only attribute because it applies to other entities). Note that
2993 -- the back end should use Treat_As_Volatile, rather than Is_Volatile
2994 -- to indicate code generation requirements for volatile variables.
2995 -- Similarly, any front end test which is concerned with suppressing
2996 -- optimizations on volatile objects should test Treat_As_Volatile
2997 -- rather than testing this flag.
2998
2999 -- Is_Wrapper_Package (synthesized)
3000 -- Defined in package entities. Indicates that the package has been
3001 -- created as a wrapper for a subprogram instantiation.
3002
3003 -- Itype_Printed (Flag202)
3004 -- Defined in all type and subtype entities. Set in Itypes if the Itype
3005 -- has been printed by Sprint. This is used to avoid printing an Itype
3006 -- more than once.
3007
3008 -- Kill_Elaboration_Checks (Flag32)
3009 -- Defined in all entities. Set by the expander to kill elaboration
3010 -- checks which are known not to be needed. Equivalent in effect to
3011 -- the use of pragma Suppress (Elaboration_Checks) for that entity
3012 -- except that the effect is permanent and cannot be undone by a
3013 -- subsequent pragma Unsuppress.
3014
3015 -- Kill_Range_Checks (Flag33)
3016 -- Defined in all entities. Equivalent in effect to the use of pragma
3017 -- Suppress (Range_Checks) for that entity except that the result is
3018 -- permanent and cannot be undone by a subsequent pragma Unsuppress.
3019 -- This is currently only used in one odd situation in Sem_Ch3 for
3020 -- record types, and it would be good to get rid of it???
3021
3022 -- Known_To_Have_Preelab_Init (Flag207)
3023 -- Defined in all type and subtype entities. If set, then the type is
3024 -- known to have preelaborable initialization. In the case of a partial
3025 -- view of a private type, it is only possible for this to be set if a
3026 -- pragma Preelaborable_Initialization is given for the type. For other
3027 -- types, it is never set if the type does not have preelaborable
3028 -- initialization, it may or may not be set if the type does have
3029 -- preelaborable initialization.
3030
3031 -- Last_Assignment (Node26)
3032 -- Defined in entities for variables, and OUT or IN OUT formals. Set for
3033 -- a local variable or formal to point to the left side of an assignment
3034 -- statement assigning a value to the variable. Cleared if the value of
3035 -- the entity is referenced. Used to warn about dubious assignment
3036 -- statements whose value is not used.
3037
3038 -- Last_Entity (Node20)
3039 -- Defined in all entities which act as scopes to which a list of
3040 -- associated entities is attached (blocks, class subtypes and types,
3041 -- entries, functions, loops, packages, procedures, protected objects,
3042 -- record types and subtypes, private types, task types and subtypes).
3043 -- Points to the last entry in the list of associated entities chained
3044 -- through the Next_Entity field. Empty if no entities are chained.
3045
3046 -- Last_Formal (synthesized)
3047 -- Applies to subprograms and subprogram types, and also in entries
3048 -- and entry families. Returns last formal of the subprogram or entry.
3049 -- The formals are the first entities declared in a subprogram or in
3050 -- a subprogram type (the designated type of an Access_To_Subprogram
3051 -- definition) or in an entry.
3052
3053 -- Limited_View (Node23)
3054 -- Defined in non-generic package entities that are not instances. Bona
3055 -- fide package with the limited-view list through the first_entity and
3056 -- first_private attributes. The elements of this list are the shadow
3057 -- entities created for the types and local packages that are declared
3058 -- in a package appearing in a limited_with clause (Ada 2005: AI-50217)
3059
3060 -- Lit_Indexes (Node15)
3061 -- Defined in enumeration types and subtypes. Non-empty only for the
3062 -- case of an enumeration root type, where it contains the entity for
3063 -- the generated indexes entity. See unit Exp_Imgv for full details of
3064 -- the nature and use of this entity for implementing the Image and
3065 -- Value attributes for the enumeration type in question.
3066
3067 -- Lit_Strings (Node16)
3068 -- Defined in enumeration types and subtypes. Non-empty only for the
3069 -- case of an enumeration root type, where it contains the entity for
3070 -- the literals string entity. See unit Exp_Imgv for full details of
3071 -- the nature and use of this entity for implementing the Image and
3072 -- Value attributes for the enumeration type in question.
3073
3074 -- Low_Bound_Tested (Flag205)
3075 -- Defined in all entities. Currently this can only be set for formal
3076 -- parameter entries of a standard unconstrained one-dimensional array
3077 -- or string type. Indicates that an explicit test of the low bound of
3078 -- the formal appeared in the code, e.g. in a pragma Assert. If this
3079 -- flag is set, warnings about assuming the index low bound to be one
3080 -- are suppressed.
3081
3082 -- Machine_Radix_10 (Flag84)
3083 -- Defined in decimal types and subtypes, set if the Machine_Radix is 10,
3084 -- as the result of the specification of a machine radix representation
3085 -- clause. Note that it is possible for this flag to be set without
3086 -- having Has_Machine_Radix_Clause True. This happens when a type is
3087 -- derived from a type with a clause present.
3088
3089 -- Master_Id (Node17)
3090 -- Defined in access types and subtypes. Empty unless Has_Task is
3091 -- set for the designated type, in which case it points to the entity
3092 -- for the Master_Id for the access type master. Also set for access-to-
3093 -- limited-class-wide types whose root may be extended with task
3094 -- components, and for access-to-limited-interfaces because they can be
3095 -- used to reference tasks implementing such interface.
3096
3097 -- Materialize_Entity (Flag168)
3098 -- Defined in all entities. Set only for renamed obects which should be
3099 -- materialized for debugging purposes. This means that a memory location
3100 -- containing the renamed address should be allocated. This is needed so
3101 -- that the debugger can find the entity.
3102
3103 -- May_Inherit_Delayed_Rep_Aspects (Flag262)
3104 -- Defined in all entities for types and subtypes. Set if the type is
3105 -- derived from a type which has delayed rep aspects (marked by the flag
3106 -- Has_Delayed_Rep_Aspects being set). In this case, at the freeze point
3107 -- for the derived type we know that the parent type is frozen, and if
3108 -- a given attribute has not been set for the derived type, we copy the
3109 -- value from the parent type. See Freeze.Inherit_Delayed_Rep_Aspects.
3110
3111 -- Mechanism (Uint8) (returned as Mechanism_Type)
3112 -- Defined in functions and non-generic formal parameters. Indicates
3113 -- the mechanism to be used for the function return or for the formal
3114 -- parameter. See separate section on passing mechanisms. This field
3115 -- is also set (to the default value of zero) in a subprogram body
3116 -- entity but not used in this context.
3117
3118 -- Modulus (Uint17) [base type only]
3119 -- Defined in modular types. Contains the modulus. For the binary case,
3120 -- this will be a power of 2, but if Non_Binary_Modulus is set, then it
3121 -- will not be a power of 2.
3122
3123 -- Must_Be_On_Byte_Boundary (Flag183)
3124 -- Defined in entities for types and subtypes. Set if objects of the type
3125 -- must always be allocated on a byte boundary (more accurately a storage
3126 -- unit boundary). The front end checks that component clauses respect
3127 -- this rule, and the back end ensures that record packing does not
3128 -- violate this rule. Currently the flag is set only for packed arrays
3129 -- longer than 64 bits where the component size is not a power of 2.
3130
3131 -- Must_Have_Preelab_Init (Flag208)
3132 -- Defined in entities for types and subtypes. Set in the full type of a
3133 -- private type or subtype if a pragma Has_Preelaborable_Initialization
3134 -- is present for the private type. Used to check that the full type has
3135 -- preelaborable initialization at freeze time (this has to be deferred
3136 -- to the freeze point because of the rule about overriding Initialize).
3137
3138 -- Needs_Debug_Info (Flag147)
3139 -- Defined in all entities. Set if the entity requires normal debugging
3140 -- information to be generated. This is true of all entities that have
3141 -- Comes_From_Source set, and also transitively for entities associated
3142 -- with such components (e.g. their types). It is true for all entities
3143 -- in Debug_Generated_Code mode (-gnatD switch). This is the flag that
3144 -- the back end should check to determine whether or not to generate
3145 -- debugging information for an entity. Note that callers should always
3146 -- use Sem_Util.Set_Debug_Info_Needed, rather than Set_Needs_Debug_Info,
3147 -- so that the flag is set properly on subsidiary entities.
3148
3149 -- Needs_No_Actuals (Flag22)
3150 -- Defined in callable entities (subprograms, entries, access to
3151 -- subprograms) which can be called without actuals because all of
3152 -- their formals (if any) have default values. This flag simplifies the
3153 -- resolution of the syntactic ambiguity involving a call to these
3154 -- entities when the return type is an array type, and a call can be
3155 -- interpreted as an indexing of the result of the call. It is also
3156 -- used to resolve various cases of entry calls.
3157
3158 -- Never_Set_In_Source (Flag115)
3159 -- Defined in all entities, but can be set only for variables and
3160 -- parameters. This flag is set if the object is never assigned a value
3161 -- in user source code, either by assignment or by being used as an out
3162 -- or in out parameter. Note that this flag is not reset from using an
3163 -- initial value, so if you want to test for this case as well, test the
3164 -- Has_Initial_Value flag also.
3165 --
3166 -- This flag is only for the purposes of issuing warnings, it must not
3167 -- be used by the code generator to indicate that the variable is in
3168 -- fact a constant, since some assignments in generated code do not
3169 -- count (for example, the call to an init proc to assign some but
3170 -- not all of the fields in a partially initialized record). The code
3171 -- generator should instead use the flag Is_True_Constant.
3172 --
3173 -- For the purposes of this warning, the default assignment of
3174 -- access variables to null is not considered the assignment of
3175 -- of a value (so the warning can be given for code that relies
3176 -- on this initial null value, when no other value is ever set).
3177 --
3178 -- In variables and out parameters, if this flag is set after full
3179 -- processing of the corresponding declarative unit, it indicates that
3180 -- the variable or parameter was never set, and a warning message can
3181 -- be issued.
3182 --
3183 -- Note: this flag is initially set, and then cleared on encountering
3184 -- any construct that might conceivably legitimately set the value.
3185 -- Thus during the analysis of a declarative region and its associated
3186 -- statement sequence, the meaning of the flag is "not set yet", and
3187 -- once this analysis is complete the flag means "never assigned".
3188
3189 -- Note: for variables appearing in package declarations, this flag
3190 -- is never set. That is because there is no way to tell if some
3191 -- client modifies the variable (or in the case of variables in the
3192 -- private part, if some child unit modifies the variables).
3193
3194 -- Note: in the case of renamed objects, the flag must be set in the
3195 -- ultimate renamed object. Clients noting a possible modification
3196 -- should use the Note_Possible_Modification procedure in Sem_Util
3197 -- rather than Set_Never_Set_In_Source precisely to deal properly with
3198 -- the renaming possibility.
3199
3200 -- Next_Component (synthesized)
3201 -- Applies to record components. Returns the next component by following
3202 -- the chain of declared entities until one is found which corresponds to
3203 -- a component (Ekind is E_Component). Any internal types generated from
3204 -- the subtype indications of the record components are skipped. Returns
3205 -- Empty if no more components.
3206
3207 -- Next_Component_Or_Discriminant (synthesized)
3208 -- Similar to Next_Component, but includes components and discriminants
3209 -- so the input can have either E_Component or E_Discriminant, and the
3210 -- same is true for the result. Returns Empty if no more components or
3211 -- discriminants in the record.
3212
3213 -- Next_Discriminant (synthesized)
3214 -- Applies to discriminants returned by First/Next_Discriminant.
3215 -- Returns the next language-defined (ie: perhaps non-girder)
3216 -- discriminant by following the chain of declared entities as long as
3217 -- the kind of the entity corresponds to a discriminant. Note that the
3218 -- discriminants might be the only components of the record.
3219 -- Returns Empty if there are no more.
3220
3221 -- Next_Entity (Node2)
3222 -- Defined in all entities. The entities of a scope are chained, with
3223 -- the head of the list being in the First_Entity field of the scope
3224 -- entity. All entities use the Next_Entity field as a forward pointer
3225 -- for this list, with Empty indicating the end of the list. Since this
3226 -- field is in the base part of the entity, the access routines for this
3227 -- field are in Sinfo.
3228
3229 -- Next_Formal (synthesized)
3230 -- Applies to the entity for a formal parameter. Returns the next
3231 -- formal parameter of the subprogram or subprogram type. Returns
3232 -- Empty if there are no more formals.
3233
3234 -- Next_Formal_With_Extras (synthesized)
3235 -- Applies to the entity for a formal parameter. Returns the next
3236 -- formal parameter of the subprogram or subprogram type. Returns
3237 -- Empty if there are no more formals. The list returned includes
3238 -- all the extra formals (see description of Extra_Formal field)
3239
3240 -- Next_Index (synthesized)
3241 -- Applies to array types and subtypes and to string types and
3242 -- subtypes. Yields the next index. The first index is obtained by
3243 -- using the First_Index attribute, and then subsequent indexes are
3244 -- obtained by applying Next_Index to the previous index. Empty is
3245 -- returned to indicate that there are no more indexes. Note that
3246 -- unlike most attributes in this package, Next_Index applies to
3247 -- nodes for the indexes, not to entities.
3248
3249 -- Next_Inlined_Subprogram (Node12)
3250 -- Defined in subprograms. Used to chain inlined subprograms used in
3251 -- the current compilation, in the order in which they must be compiled
3252 -- by Gigi to insure that all inlinings are performed.
3253
3254 -- Next_Literal (synthesized)
3255 -- Applies to enumeration literals, returns the next literal, or
3256 -- Empty if applied to the last literal. This is actually a synonym
3257 -- for Next, but its use is preferred in this context.
3258
3259 -- Non_Binary_Modulus (Flag58) [base type only]
3260 -- Defined in all subtype and type entities. Set for modular integer
3261 -- types if the modulus value is other than a power of 2.
3262
3263 -- Non_Limited_View (Node17)
3264 -- Defined in abstract states and incomplete types that act as shadow
3265 -- entities created when analysing a limited with clause (Ada 2005:
3266 -- AI-50217). Points to the defining entity of the original declaration.
3267
3268 -- Nonzero_Is_True (Flag162) [base type only]
3269 -- Defined in enumeration types. Set if any non-zero value is to be
3270 -- interpreted as true. Currently this is set for derived Boolean
3271 -- types which have a convention of C, C++ or Fortran.
3272
3273 -- No_Pool_Assigned (Flag131) [root type only]
3274 -- Defined in access types. Set if a storage size clause applies to the
3275 -- variable with a static expression value of zero. This flag is used to
3276 -- generate errors if any attempt is made to allocate or free an instance
3277 -- of such an access type. This is set only in the root type, since
3278 -- derived types must have the same pool.
3279
3280 -- No_Return (Flag113)
3281 -- Defined in all entities. Always false except in the case of procedures
3282 -- and generic procedures for which a pragma No_Return is given.
3283
3284 -- Normalized_First_Bit (Uint8)
3285 -- Defined in components and discriminants. Indicates the normalized
3286 -- value of First_Bit for the component, i.e. the offset within the
3287 -- lowest addressed storage unit containing part or all of the field.
3288 -- Set to No_Uint if no first bit position is assigned yet.
3289
3290 -- Normalized_Position (Uint14)
3291 -- Defined in components and discriminants. Indicates the normalized
3292 -- value of Position for the component, i.e. the offset in storage
3293 -- units from the start of the record to the lowest addressed storage
3294 -- unit containing part or all of the field.
3295
3296 -- Normalized_Position_Max (Uint10)
3297 -- Defined in components and discriminants. For almost all cases, this
3298 -- is the same as Normalized_Position. The one exception is for the case
3299 -- of a discriminated record containing one or more arrays whose length
3300 -- depends on discriminants. In this case, the Normalized_Position_Max
3301 -- field represents the maximum possible value of Normalized_Position
3302 -- assuming min/max values for discriminant subscripts in all fields.
3303 -- This is used by Layout in front end layout mode to properly computed
3304 -- the maximum size such records (needed for allocation purposes when
3305 -- there are default discriminants, and also for the 'Size value).
3306
3307 -- No_Strict_Aliasing (Flag136) [base type only]
3308 -- Defined in access types. Set to direct the back end to avoid any
3309 -- optimizations based on an assumption about the aliasing status of
3310 -- objects designated by the access type. For the case of the gcc
3311 -- back end, the effect is as though all references to objects of
3312 -- the type were compiled with -fno-strict-aliasing. This flag is
3313 -- set if an unchecked conversion with the access type as a target
3314 -- type occurs in the same source unit as the declaration of the
3315 -- access type, or if an explicit pragma No_Strict_Aliasing applies.
3316
3317 -- Number_Dimensions (synthesized)
3318 -- Applies to array types and subtypes. Returns the number of dimensions
3319 -- of the array type or subtype as a value of type Pos.
3320
3321 -- Number_Entries (synthesized)
3322 -- Applies to concurrent types. Returns the number of entries that are
3323 -- declared within the task or protected definition for the type.
3324
3325 -- Number_Formals (synthesized)
3326 -- Applies to subprograms and subprogram types. Yields the number of
3327 -- formals as a value of type Pos.
3328
3329 -- OK_To_Rename (Flag247)
3330 -- Defined only in entities for variables. If this flag is set, it
3331 -- means that if the entity is used as the initial value of an object
3332 -- declaration, the object declaration can be safely converted into a
3333 -- renaming to avoid an extra copy. This is set for variables which are
3334 -- generated by the expander to hold the result of evaluating some
3335 -- expression. Most notably, the local variables used to store the result
3336 -- of concatenations are so marked (see Exp_Ch4.Expand_Concatenate). It
3337 -- is only worth setting this flag for composites, since for primitive
3338 -- types, it is cheaper to do the copy.
3339
3340 -- OK_To_Reorder_Components (Flag239) [base type only]
3341 -- Defined in record types. Set if the back end is permitted to reorder
3342 -- the components. If not set, the record must be layed out in the order
3343 -- in which the components are declared textually. Currently this flag
3344 -- can only be set by debug switches.
3345
3346 -- Optimize_Alignment_Space (Flag241)
3347 -- Defined in type, subtype, variable, and constant entities. This
3348 -- flag records that the type or object is to be layed out in a manner
3349 -- consistent with Optimize_Alignment (Space) mode. The compiler and
3350 -- binder ensure a consistent view of any given type or object. If pragma
3351 -- Optimize_Alignment (Off) mode applies to the type/object, then neither
3352 -- of the flags Optimize_Alignment_Space/Optimize_Alignment_Time is set.
3353
3354 -- Optimize_Alignment_Time (Flag242)
3355 -- Defined in type, subtype, variable, and constant entities. This
3356 -- flag records that the type or object is to be layed out in a manner
3357 -- consistent with Optimize_Alignment (Time) mode. The compiler and
3358 -- binder ensure a consistent view of any given type or object. If pragma
3359 -- Optimize_Alignment (Off) mode applies to the type/object, then neither
3360 -- of the flags Optimize_Alignment_Space/Optimize_Alignment_Time is set.
3361
3362 -- Original_Access_Type (Node26)
3363 -- Defined in E_Access_Subprogram_Type entities. Set only if the access
3364 -- type was generated by the expander as part of processing an access
3365 -- to protected subprogram type. Points to the access to protected
3366 -- subprogram type.
3367
3368 -- Original_Array_Type (Node21)
3369 -- Defined in modular types and array types and subtypes. Set only
3370 -- if the Is_Packed_Array_Type flag is set, indicating that the type
3371 -- is the implementation type for a packed array, and in this case it
3372 -- points to the original array type for which this is the packed
3373 -- array implementation type.
3374
3375 -- Original_Record_Component (Node22)
3376 -- Defined in components, including discriminants. The usage depends
3377 -- on whether the record is a base type and whether it is tagged.
3378 --
3379 -- In base tagged types:
3380 -- When the component is inherited in a record extension, it points
3381 -- to the original component (the entity of the ancestor component
3382 -- which is not itself inherited) otherwise it points to itself.
3383 -- Gigi uses this attribute to implement the automatic dereference in
3384 -- the extension and to apply the transformation:
3385 --
3386 -- Rec_Ext.Comp -> Rec_Ext.Parent. ... .Parent.Comp
3387 --
3388 -- In base non-tagged types:
3389 -- Always points to itself except for non-girder discriminants, where
3390 -- it points to the girder discriminant it renames.
3391 --
3392 -- In subtypes (tagged and untagged):
3393 -- Points to the component in the base type.
3394
3395 -- Overlays_Constant (Flag243)
3396 -- Defined in all entities. Set only for a variable for which there is
3397 -- an address clause which causes the variable to overlay a constant.
3398
3399 -- Overridden_Operation (Node26)
3400 -- Defined in subprograms. For overriding operations, points to the
3401 -- user-defined parent subprogram that is being overridden. Note: this
3402 -- attribute uses the same field as Static_Initialization. The latter
3403 -- is only defined for internal initialization procedures, for which
3404 -- Overridden_Operation is irrelevant. Thus this attribute must not be
3405 -- set for init_procs.
3406
3407 -- Package_Instantiation (Node26)
3408 -- Defined in packages and generic packages. When defined, this field
3409 -- references an N_Generic_Instantiation node associated with an
3410 -- instantiated package. In the case where the referenced node has
3411 -- been rewritten to an N_Package_Specification, the instantiation
3412 -- node is available from the Original_Node field of the package spec
3413 -- node. This is currently not guaranteed to be set in all cases, but
3414 -- when set, the field is used in Get_Package_Instantiation_Node as
3415 -- one of the means of obtaining the instantiation node. Eventually
3416 -- it should be set in all cases, including package entities associated
3417 -- with formal packages. ???
3418
3419 -- Packed_Array_Type (Node23)
3420 -- Defined in array types and subtypes, including the string literal
3421 -- subtype case, if the corresponding type is packed (either bit packed
3422 -- or packed to eliminate holes in non-contiguous enumeration type index
3423 -- types). References the type used to represent the packed array, which
3424 -- is either a modular type for short static arrays, or an array of
3425 -- System.Unsigned. Note that in some situations (internal types, and
3426 -- references to fields of variant records), it is not always possible
3427 -- to construct this type in advance of its use. If Packed_Array_Type
3428 -- is empty, then the necessary type is declared on the fly for each
3429 -- reference to the array.
3430
3431 -- Parameter_Mode (synthesized)
3432 -- Applies to formal parameter entities. This is a synonym for Ekind,
3433 -- used when obtaining the formal kind of a formal parameter (the result
3434 -- is one of E_[In/Out/In_Out]_Parameter)
3435
3436 -- Parent_Subtype (Node19) [base type only]
3437 -- Defined in E_Record_Type. Set only for derived tagged types, in which
3438 -- case it points to the subtype of the parent type. This is the type
3439 -- that is used as the Etype of the _parent field.
3440
3441 -- Postcondition_Proc (Node8)
3442 -- Defined only in procedure entities, saves the entity of the generated
3443 -- postcondition proc if one is present, otherwise is set to Empty. Used
3444 -- to generate the call to this procedure in case the expander inserts
3445 -- implicit return statements.
3446
3447 -- PPC_Wrapper (Node25)
3448 -- Defined in entries and entry families. Set only if pre- or post-
3449 -- conditions are present. The precondition_wrapper body is the original
3450 -- entry call, decorated with the given precondition for the entry.
3451
3452 -- Predicate_Function (synthesized)
3453 -- Defined in all types. Set for types for which (Has_Predicates is True)
3454 -- and for which a predicate procedure has been built that tests that the
3455 -- specified predicates are True. Contains the entity for the function
3456 -- which takes a single argument of the given type, and returns True if
3457 -- the predicate holds and False if it does not.
3458 --
3459 -- Note: the reason this is marked as a synthesized attribute is that the
3460 -- way this is stored is as an element of the Subprograms_For_Type field.
3461
3462 -- Predicate_Function_M (synthesized)
3463 -- Defined in all types. Present only if Predicate_Function is present,
3464 -- and only if the predicate function has Raise_Expression nodes. It
3465 -- is the special version created for membership tests, where if one of
3466 -- these raise expressions is executed, the result is to return False.
3467
3468 -- Primitive_Operations (synthesized)
3469 -- Defined in concurrent types, tagged record types and subtypes, tagged
3470 -- private types and tagged incomplete types. For concurrent types whose
3471 -- Corresponding_Record_Type (CRT) is available, returns the list of
3472 -- Direct_Primitive_Operations of its CRT; otherwise returns No_Elist.
3473 -- For all the other types returns the Direct_Primitive_Operations.
3474
3475 -- Prival (Node17)
3476 -- Defined in private components of protected types. Refers to the entity
3477 -- of the component renaming declaration generated inside protected
3478 -- subprograms, entries or barrier functions.
3479
3480 -- Prival_Link (Node20)
3481 -- Defined in constants and variables which rename private components of
3482 -- protected types. Set to the original private component.
3483
3484 -- Private_Dependents (Elist18)
3485 -- Defined in private (sub)types. Records the subtypes of the private
3486 -- type, derivations from it, and records and arrays with components
3487 -- dependent on the type.
3488 --
3489 -- The subtypes are traversed when installing and deinstalling (the full
3490 -- view of) a private type in order to ensure correct view of the
3491 -- subtypes.
3492 --
3493 -- Used in similar fashion for incomplete types: holds list of subtypes
3494 -- of these incomplete types that have discriminant constraints. The
3495 -- full views of these subtypes are constructed when the full view of
3496 -- the incomplete type is processed.
3497
3498 -- In addition, if the incomplete type is the designated type in an
3499 -- access definition for an access parameter, the operation may be
3500 -- a dispatching primitive operation, which is only known when the full
3501 -- declaration of the type is seen. Subprograms that have such an
3502 -- access parameter are also placed in the list of private_dependents.
3503
3504 -- Private_View (Node22)
3505 -- For each private type, three entities are allocated, the private view,
3506 -- the full view, and the shadow entity. The shadow entity contains a
3507 -- copy of the private view and is used for restoring the proper private
3508 -- view after a region in which the full view is visible (and is copied
3509 -- into the entity normally used for the private view during this period
3510 -- of visibility). The Private_View field is self-referential when the
3511 -- private view lives in its normal entity, but in the copy that is made
3512 -- in the shadow entity, it points to the proper location in which to
3513 -- restore the private view saved in the shadow.
3514
3515 -- Protected_Formal (Node22)
3516 -- Defined in formal parameters (in, in out and out parameters). Used
3517 -- only for formals of protected operations. References corresponding
3518 -- formal parameter in the unprotected version of the operation that
3519 -- is created during expansion.
3520
3521 -- Protected_Body_Subprogram (Node11)
3522 -- Defined in protected operations. References the entity for the
3523 -- subprogram which implements the body of the operation.
3524
3525 -- Protection_Object (Node23)
3526 -- Applies to protected entries, entry families and subprograms. Denotes
3527 -- the entity which is used to rename the _object component of protected
3528 -- types.
3529
3530 -- Reachable (Flag49)
3531 -- Defined in labels. The flag is set over the range of statements in
3532 -- which a goto to that label is legal.
3533
3534 -- Referenced (Flag156)
3535 -- Defined in all entities. Set if the entity is referenced, except for
3536 -- the case of an appearance of a simple variable that is not a renaming
3537 -- as the left side of an assignment in which case Referenced_As_LHS is
3538 -- set instead, or a similar appearance as an out parameter actual, in
3539 -- which case Referenced_As_Out_Parameter is set.
3540
3541 -- Referenced_As_LHS (Flag36):
3542 -- Defined in all entities. This flag is set instead of Referenced if a
3543 -- simple variable that is not a renaming appears as the left side of an
3544 -- assignment. The reason we distinguish this kind of reference is that
3545 -- we have a separate warning for variables that are only assigned and
3546 -- never read.
3547
3548 -- Referenced_As_Out_Parameter (Flag227):
3549 -- Defined in all entities. This flag is set instead of Referenced if a
3550 -- simple variable that is not a renaming appears as an actual for an out
3551 -- formal. The reason we distinguish this kind of reference is that
3552 -- we have a separate warning for variables that are only assigned and
3553 -- never read, and out parameters are a special case.
3554
3555 -- Refined_State (Node10)
3556 -- Defined in abstract states and variables. Contains the entity of an
3557 -- ancestor state whose refinement mentions this item.
3558
3559 -- Refinement_Constituents (Elist8)
3560 -- Present in abstract state entities. Contains all the constituents that
3561 -- refine the state, in other words, all the hidden states that appear in
3562 -- the constituent_list of aspect/pragma Refined_State.
3563
3564 -- Register_Exception_Call (Node20)
3565 -- Defined in exception entities. When an exception is declared,
3566 -- a call is expanded to Register_Exception. This field points to
3567 -- the expanded N_Procedure_Call_Statement node for this call. It
3568 -- is used for Import/Export_Exception processing to modify the
3569 -- register call to make appropriate entries in the special tables
3570 -- used for handling these pragmas at runtime.
3571
3572 -- Related_Array_Object (Node25)
3573 -- Defined in array types and subtypes. Used only for the base type
3574 -- and subtype created for an anonymous array object. Set to point
3575 -- to the entity of the corresponding array object. Currently used
3576 -- only for type-related error messages.
3577
3578 -- Related_Expression (Node24)
3579 -- Defined in variables and types. When Set for internally generated
3580 -- entities, it may be used to denote the source expression whose
3581 -- elaboration created the variable declaration. If set, it is used
3582 -- for generating clearer messages from CodePeer. It is used on source
3583 -- entities that are variables in iterator specifications, to provide
3584 -- a link to the container that is the domain of iteration. This allows
3585 -- for better cross-reference information when the loop modifies elements
3586 -- of the container, and suppresses spurious warnings.
3587 --
3588 -- Shouldn't it also be used for the same purpose in errout? It seems
3589 -- odd to have two mechanisms here???
3590
3591 -- Related_Instance (Node15)
3592 -- Defined in the wrapper packages created for subprogram instances.
3593 -- The internal subprogram that implements the instance is inside the
3594 -- wrapper package, but for debugging purposes its external symbol
3595 -- must correspond to the name and scope of the related instance.
3596
3597 -- Related_Type (Node27)
3598 -- Defined in components, constants and variables. Set when there is an
3599 -- associated dispatch table to point to entities containing primary or
3600 -- secondary tags. Not set in the _tag component of record types.
3601
3602 -- Relative_Deadline_Variable (Node26) [implementation base type only]
3603 -- Defined in task type entities. This flag is set if a valid and
3604 -- effective pragma Relative_Deadline applies to the base type. Points
3605 -- to the entity for a variable that is created to hold the value given
3606 -- in a Relative_Deadline pragma for a task type.
3607
3608 -- Renamed_Entity (Node18)
3609 -- Defined in exceptions, packages, subprograms and generic units. Set
3610 -- for entities that are defined by a renaming declaration. Denotes the
3611 -- renamed entity, or transitively the ultimate renamed entity if
3612 -- there is a chain of renaming declarations. Empty if no renaming.
3613
3614 -- Renamed_In_Spec (Flag231)
3615
3616 -- Defined in package entities. If a package renaming occurs within
3617 -- a package spec, then this flag is set on the renamed package. The
3618 -- purpose is to prevent a warning about unused entities in the renamed
3619 -- package. Such a warning would be inappropriate since clients of the
3620 -- package can see the entities in the package via the renaming.
3621
3622 -- Renamed_Object (Node18)
3623 -- Defined in all objects (constants, variables, components, formal
3624 -- parameters, generic formal parameters, and loop parameters).
3625 -- ??? Defined in discriminants?
3626 -- Set non-Empty if the object was declared by a renaming declaration,
3627 -- in which case it references the tree node for the name of the renamed
3628 -- object. This is only possible for the variable and constant cases.
3629 -- For formal parameters, this field is used in the course of inline
3630 -- expansion, to map the formals of a subprogram into the corresponding
3631 -- actuals. For formals of a task entry, it denotes the local renaming
3632 -- that replaces the actual within the accept statement. The field is
3633 -- Empty otherwise (it is always empty for loop parameters).
3634
3635 -- Renaming_Map (Uint9)
3636 -- Defined in generic subprograms, generic packages, and their
3637 -- instances. Also defined in the instances of the corresponding
3638 -- bodies. Denotes the renaming map (generic entities => instance
3639 -- entities) used to construct the instance by givin an index into
3640 -- the tables used to represent these maps. See Sem_Ch12 for further
3641 -- details. The maps for package instances are also used when the
3642 -- instance is the actual corresponding to a formal package.
3643
3644 -- Requires_Overriding (Flag213)
3645 -- Defined in all subprograms and entries. Set for subprograms that
3646 -- require overriding as defined by RM-2005-3.9.3(6/2). Note that this
3647 -- is True only for implicitly declare subprograms; it is not set on the
3648 -- parent type's subprogram. See also Is_Abstract_Subprogram.
3649
3650 -- Return_Present (Flag54)
3651 -- Defined in function and generic function entities. Set if the
3652 -- function contains a return statement (used for error checking).
3653 -- This flag can also be set in procedure and generic procedure
3654 -- entities (for convenience in setting it), but is only tested
3655 -- for the function case.
3656
3657 -- Return_Applies_To (Node8)
3658 -- Defined in E_Return_Statement. Points to the entity representing
3659 -- the construct to which the return statement applies, as defined in
3660 -- RM-6.5(4/2). Note that a (simple) return statement within an
3661 -- extended_return_statement applies to the extended_return_statement,
3662 -- even though it causes the whole function to return.
3663
3664 -- Returns_By_Ref (Flag90)
3665 -- Defined in function entities, to indicate that the function
3666 -- returns the result by reference, either because its return type is a
3667 -- by-reference-type or because it uses explicitly the secondary stack.
3668
3669 -- Reverse_Bit_Order (Flag164) [base type only]
3670 -- Defined in all record type entities. Set if entity has a Bit_Order
3671 -- aspect (set by an aspect clause or attribute definition clause) that
3672 -- has reversed the order of bits from the default value. When this flag
3673 -- is set, a component clause must specify a set of bits entirely within
3674 -- a single storage unit (Ada 95) or within a single machine scalar (see
3675 -- Ada 2005 AI-133), or must occupy an integral number of storage units.
3676
3677 -- Reverse_Storage_Order (Flag93) [base type only]
3678 -- Defined in all record and array type entities. Set if entity has a
3679 -- Scalar_Storage_Order aspect (set by an aspect clause or attribute
3680 -- definition clause) that has reversed the order of storage elements
3681 -- from the default value. When this flag is set for a record type,
3682 -- the Bit_Order aspect must be set to the same value (either explicitly
3683 -- or as the target default value).
3684
3685 -- RM_Size (Uint13)
3686 -- Defined in all type and subtype entities. Contains the value of
3687 -- type'Size as defined in the RM. See also the Esize field and
3688 -- and the description on "Handling of Type'Size Values". A value
3689 -- of zero in this field for a non-discrete type means that
3690 -- the front end has not yet determined the size value. For the
3691 -- case of a discrete type, this field is always set by the front
3692 -- end and zero is a legitimate value for a type with one value.
3693
3694 -- Root_Type (synthesized)
3695 -- Applies to all type entities. For class-wide types, return the root
3696 -- type of the class covered by the CW type, otherwise returns the
3697 -- ultimate derivation ancestor of the given type. This function
3698 -- preserves the view, i.e. the Root_Type of a partial view is the
3699 -- partial view of the ultimate ancestor, the Root_Type of a full view
3700 -- is the full view of the ultimate ancestor. Note that this function
3701 -- does not correspond exactly to the use of root type in the RM, since
3702 -- in the RM root type applies to a class of types, not to a type.
3703
3704 -- Scalar_Range (Node20)
3705 -- Defined in all scalar types (including modular types, where the
3706 -- bounds are 0 .. modulus - 1). References a node in the tree that
3707 -- contains the bounds for the range. Note that this information
3708 -- could be obtained by rummaging around the tree, but it is more
3709 -- convenient to have it immediately at hand in the entity. The
3710 -- contents of Scalar_Range can either be an N_Subtype_Indication
3711 -- node (with a constraint), or a Range node, but not a simple
3712 -- subtype reference (a subtype is converted into a range).
3713
3714 -- Scale_Value (Uint15)
3715 -- Defined in decimal fixed-point types and subtypes. Contains the scale
3716 -- for the type (i.e. the value of type'Scale = the number of decimal
3717 -- digits after the decimal point).
3718
3719 -- Scope (Node3)
3720 -- Defined in all entities. Points to the entity for the scope (block,
3721 -- loop, subprogram, package etc.) in which the entity is declared.
3722 -- Since this field is in the base part of the entity node, the access
3723 -- routines for this field are in Sinfo. Note that for a child package,
3724 -- the Scope will be the parent package, and for a non-child package,
3725 -- the Scope will be Standard.
3726
3727 -- Scope_Depth (synthesized)
3728 -- Applies to program units, blocks, concurrent types and entries, and
3729 -- also to record types, i.e. to any entity that can appear on the scope
3730 -- stack. Yields the scope depth value, which for those entities other
3731 -- than records is simply the scope depth value, for record entities, it
3732 -- is the Scope_Depth of the record scope.
3733
3734 -- Scope_Depth_Value (Uint22)
3735 -- Defined in program units, blocks, concurrent types, and entries.
3736 -- Indicates the number of scopes that statically enclose the declaration
3737 -- of the unit or type. Library units have a depth of zero. Note that
3738 -- record types can act as scopes but do NOT have this field set (see
3739 -- Scope_Depth above)
3740
3741 -- Scope_Depth_Set (synthesized)
3742 -- Applies to a special predicate function that returns a Boolean value
3743 -- indicating whether or not the Scope_Depth field has been set. It is
3744 -- needed, since returns an invalid value in this case!
3745
3746 -- Sec_Stack_Needed_For_Return (Flag167)
3747 -- Defined in scope entities (blocks, functions, procedures, tasks,
3748 -- entries). Set to True when secondary stack is used to hold the
3749 -- returned value of a function and thus should not be released on
3750 -- scope exit.
3751
3752 -- Shadow_Entities (List14)
3753 -- Defined in package and generic package entities. Points to a list
3754 -- of entities that correspond to private types. For each private type
3755 -- a shadow entity is created that holds a copy of the private view.
3756 -- In regions of the program where the full views of these private
3757 -- entities are visible, the full view is copied into the entity that
3758 -- is normally used to hold the private view, but the shadow entity
3759 -- copy is unchanged. The shadow entities are then used to restore the
3760 -- original private views at the end of the region. This list is a
3761 -- standard format list (i.e. First (Shadow_Entities) is the first
3762 -- entry and subsequent entries are obtained using Next.
3763
3764 -- Shared_Var_Procs_Instance (Node22)
3765 -- Defined in variables. Set non-Empty only if Is_Shared_Passive is
3766 -- set, in which case this is the entity for the associated instance of
3767 -- System.Shared_Storage.Shared_Var_Procs. See Exp_Smem for full details.
3768
3769 -- Size_Check_Code (Node19)
3770 -- Defined in constants and variables. Normally Empty. Set if code is
3771 -- generated to check the size of the object. This field is used to
3772 -- suppress this code if a subsequent address clause is encountered.
3773
3774 -- Size_Clause (synthesized)
3775 -- Applies to all entities. If a size clause is present in the rep
3776 -- item chain for an entity then the attribute definition clause node
3777 -- for the size clause is returned. Otherwise Size_Clause returns Empty
3778 -- if no item is present. Usually this is only meaningful if the flag
3779 -- Has_Size_Clause is set. This is because when the representation item
3780 -- chain is copied for a derived type, it can inherit a size clause that
3781 -- is not applicable to the entity.
3782
3783 -- Size_Depends_On_Discriminant (Flag177)
3784 -- Defined in all entities for types and subtypes. Indicates that the
3785 -- size of the type depends on the value of one or more discriminants.
3786 -- Currently, this flag is only set for arrays which have one or more
3787 -- bounds depending on a discriminant value.
3788
3789 -- Size_Known_At_Compile_Time (Flag92)
3790 -- Defined in all entities for types and subtypes. Indicates that the
3791 -- size of objects of the type is known at compile time. This flag is
3792 -- used to optimize some generated code sequences, and also to enable
3793 -- some error checks (e.g. disallowing component clauses on variable
3794 -- length objects). It is set conservatively (i.e. if it is True, the
3795 -- size is certainly known at compile time, if it is False, then the
3796 -- size may or may not be known at compile time, but the code will
3797 -- assume that it is not known).
3798
3799 -- Small_Value (Ureal21)
3800 -- Defined in fixed point types. Points to the universal real for the
3801 -- Small of the type, either as given in a representation clause, or
3802 -- as computed (as a power of two) by the compiler.
3803
3804 -- SPARK_Aux_Pragma (Node33)
3805 -- Present in package spec and body entities. For a package spec entity
3806 -- it relates to the SPARK mode setting for the private part. This field
3807 -- points to the N_Pragma node that applies to the private part. This is
3808 -- either set with a local SPARK_Mode pragma in the private part or it is
3809 -- inherited from the SPARK mode that applies to the rest of the spec.
3810 -- For a package body, it similarly applies to the SPARK mode setting for
3811 -- the elaboration sequence after the BEGIN. In the case where the pragma
3812 -- is inherited, the SPARK_Aux_Pragma_Inherited flag is set in the
3813 -- package spec or body entity.
3814
3815 -- SPARK_Aux_Pragma_Inherited (Flag266)
3816 -- Present in the entities of subprogram specs and bodies as well as
3817 -- in package specs and bodies. Set if the SPARK_Aux_Pragma field
3818 -- points to a pragma that is inherited, rather than a local one.
3819
3820 -- SPARK_Pragma (Node32)
3821 -- Present in the entities of subprogram specs and bodies as well as in
3822 -- package specs and bodies. Points to the N_Pragma node that applies to
3823 -- the spec or body. This is either set by a local SPARK_Mode pragma or
3824 -- is inherited from the context (from an outer scope for the spec case
3825 -- or from the spec for the body case). In the case where it is inherited
3826 -- the flag SPARK_Pragma_Inherited is set. Empty if no SPARK_Mode pragma
3827 -- is applicable.
3828
3829 -- SPARK_Pragma_Inherited (Flag265)
3830 -- Present in the entities of subprogram specs and bodies as well as in
3831 -- package specs and bodies. Set if the SPARK_Pragma field points to a
3832 -- pragma that is inherited, rather than a local one.
3833
3834 -- Spec_Entity (Node19)
3835 -- Defined in package body entities. Points to corresponding package
3836 -- spec entity. Also defined in subprogram body parameters in the
3837 -- case where there is a separate spec, where this field references
3838 -- the corresponding parameter entities in the spec.
3839
3840 -- Static_Predicate (List25)
3841 -- Defined in discrete types/subtypes with predicates (Has_Predicates
3842 -- set). Set if the type/subtype has a static predicate. Points to a
3843 -- list of expression and N_Range nodes that represent the predicate
3844 -- in canonical form. The canonical form has entries sorted in ascending
3845 -- order, with duplicates eliminated, and adjacent ranges coalesced, so
3846 -- that there is always a gap in the values between successive entries.
3847 -- The entries in this list are fully analyzed and typed with the base
3848 -- type of the subtype. Note that all entries are static and have values
3849 -- within the subtype range.
3850
3851 -- Status_Flag_Or_Transient_Decl (Node15)
3852 -- Defined in variables and constants. Applies to objects that require
3853 -- special treatment by the finalization machinery, such as extended
3854 -- return results, IF and CASE expression results, and objects inside
3855 -- N_Expression_With_Actions nodes. The attribute contains the entity
3856 -- of a flag which specifies particular behavior over a region of code
3857 -- or the declaration of a "hook" object.
3858 -- In which case is it a flag, or a hook object???
3859
3860 -- Storage_Size_Variable (Node15) [implementation base type only]
3861 -- Defined in access types and task type entities. This flag is set
3862 -- if a valid and effective pragma Storage_Size applies to the base
3863 -- type. Points to the entity for a variable that is created to
3864 -- hold the value given in a Storage_Size pragma for an access
3865 -- collection or a task type. Note that in the access type case,
3866 -- this field is defined only in the root type (since derived types
3867 -- share the same storage pool).
3868
3869 -- Static_Elaboration_Desired (Flag77)
3870 -- Defined in library-level packages. Set by the pragma of the same
3871 -- name, to indicate that static initialization must be attempted for
3872 -- all types declared in the package, and that a warning must be emitted
3873 -- for those types to which static initialization is not available.
3874
3875 -- Static_Initialization (Node30)
3876 -- Defined in initialization procedures for types whose objects can be
3877 -- initialized statically. The value of this attribute is a positional
3878 -- aggregate whose components are compile-time static values. Used
3879 -- when available in object declarations to eliminate the call to the
3880 -- initialization procedure, and to minimize elaboration code. Note:
3881 -- This attribute uses the same field as Overridden_Operation, which is
3882 -- irrelevant in init_procs.
3883
3884 -- Stored_Constraint (Elist23)
3885 -- Defined in entities that can have discriminants (concurrent types
3886 -- subtypes, record types and subtypes, private types and subtypes,
3887 -- limited private types and subtypes and incomplete types). Points
3888 -- to an element list containing the expressions for each of the
3889 -- stored discriminants for the record (sub)type.
3890
3891 -- Strict_Alignment (Flag145) [implementation base type only]
3892 -- Defined in all type entities. Indicates that some containing part
3893 -- is either aliased or tagged. This prohibits packing the object
3894 -- tighter than its natural size and alignment.
3895
3896 -- String_Literal_Length (Uint16)
3897 -- Defined in string literal subtypes (which are created to correspond
3898 -- to string literals in the program). Contains the length of the string
3899 -- literal.
3900
3901 -- String_Literal_Low_Bound (Node15)
3902 -- Defined in string literal subtypes (which are created to correspond
3903 -- to string literals in the program). Contains an expression whose
3904 -- value represents the low bound of the literal. This is a copy of
3905 -- the low bound of the applicable index constraint if there is one,
3906 -- or a copy of the low bound of the index base type if not.
3907
3908 -- Subprograms_For_Type (Node29)
3909 -- Defined in all type entities, and in subprogram entities. This is used
3910 -- to hold a list of subprogram entities for subprograms associated with
3911 -- the type, linked through the Subprogram_List field of the subprogram
3912 -- entity. Basically this is a way of multiplexing the single field to
3913 -- hold more than one entity (since we ran out of space in some type
3914 -- entities). This is currently used for Invariant_Procedure and also
3915 -- for Predicate_Function, and clients will always use the latter two
3916 -- names to access entries in this list.
3917
3918 -- Suppress_Elaboration_Warnings (Flag148)
3919 -- Defined in all entities, can be set only for subprogram entities and
3920 -- for variables. If this flag is set then Sem_Elab will not generate
3921 -- elaboration warnings for the subprogram or variable. Suppression of
3922 -- such warnings is automatic for subprograms for which elaboration
3923 -- checks are suppressed (without the need to set this flag), but the
3924 -- flag is also set for various internal entities (such as init procs)
3925 -- which are known not to generate any possible access before
3926 -- elaboration, and it is set on variables when a warning is given to
3927 -- avoid multiple elaboration warnings for the same variable.
3928
3929 -- Suppress_Initialization (Flag105)
3930 -- Defined in all type and subtype entities. If set for the base type,
3931 -- then the generation of initialization procedures is suppressed for the
3932 -- type. Any other implicit initialiation (e.g. from the use of pragma
3933 -- Initialize_Scalars) is also suppressed if this flag is set either for
3934 -- the subtype in question, or for the base type. Set by use of pragma
3935 -- Suppress_Initialization and also for internal entities where we know
3936 -- that no initialization is required. For example, enumeration image
3937 -- table entities set it.
3938
3939 -- Suppress_Style_Checks (Flag165)
3940 -- Defined in all entities. Suppresses any style checks specifically
3941 -- associated with the given entity if set.
3942
3943 -- Suppress_Value_Tracking_On_Call (Flag217)
3944 -- Defined in all entities. Set in a scope entity if value tracking is to
3945 -- be suppressed on any call within the scope. Used when an access to a
3946 -- local subprogram is computed, to deal with the possibility that this
3947 -- value may be passed around, and if used, may clobber a local variable.
3948
3949 -- Task_Body_Procedure (Node25)
3950 -- Defined in task types and subtypes. Points to the entity for the task
3951 -- task body procedure (as further described in Exp_Ch9, task bodies are
3952 -- expanded into procedures). A convenient function to retrieve this
3953 -- field is Sem_Util.Get_Task_Body_Procedure.
3954 --
3955 -- The last sentence is odd??? Why not have Task_Body_Procedure go to the
3956 -- Underlying_Type of the Root_Type???
3957
3958 -- Thunk_Entity (Node31)
3959 -- Defined in functions and procedures which have been classified as
3960 -- Is_Thunk. Set to the target entity called by the thunk.
3961
3962 -- Treat_As_Volatile (Flag41)
3963 -- Defined in all type entities, and also in constants, components and
3964 -- variables. Set if this entity is to be treated as volatile for code
3965 -- generation purposes. Always set if Is_Volatile is set, but can also
3966 -- be set as a result of situations (such as address overlays) where
3967 -- the front end wishes to force volatile handling to inhibit aliasing
3968 -- optimization which might be legally ok, but is undesirable. Note
3969 -- that the back end always tests this flag rather than Is_Volatile.
3970 -- The front end tests Is_Volatile if it is concerned with legality
3971 -- checks associated with declared volatile variables, but if the test
3972 -- is for the purposes of suppressing optimizations, then the front
3973 -- end should test Treat_As_Volatile rather than Is_Volatile.
3974 --
3975 -- Note: before testing Treat_As_Volatile, consider whether it would
3976 -- be more appropriate to use Exp_Util.Is_Volatile_Reference instead,
3977 -- which catches more cases of volatile references.
3978
3979 -- Type_High_Bound (synthesized)
3980 -- Applies to scalar types. Returns the tree node (Node_Id) that contains
3981 -- the high bound of a scalar type. The returned value is literal for a
3982 -- base type, but may be an expression in the case of scalar type with
3983 -- dynamic bounds. Note that in the case of a fixed point type, the high
3984 -- bound is in units of small, and is an integer.
3985
3986 -- Type_Low_Bound (synthesized)
3987 -- Applies to scalar types. Returns the tree node (Node_Id) that contains
3988 -- the low bound of a scalar type. The returned value is literal for a
3989 -- base type, but may be an expression in the case of scalar type with
3990 -- dynamic bounds. Note that in the case of a fixed point type, the low
3991 -- bound is in units of small, and is an integer.
3992
3993 -- Underlying_Full_View (Node19)
3994 -- Defined in private subtypes that are the completion of other private
3995 -- types, or in private types that are derived from private subtypes. If
3996 -- the full view of a private type T is derived from another private type
3997 -- with discriminants Td, the full view of T is also private, and there
3998 -- is no way to attach to it a further full view that would convey the
3999 -- structure of T to the back end. The Underlying_Full_ View is an
4000 -- attribute of the full view that is a subtype of Td with the same
4001 -- constraint as the declaration for T. The declaration for this subtype
4002 -- is built at the point of the declaration of T, either as completion,
4003 -- or as a subtype declaration where the base type is private and has a
4004 -- private completion. If Td is already constrained, then its full view
4005 -- can serve directly as the full view of T.
4006
4007 -- Underlying_Record_View (Node28)
4008 -- Defined in record types. Set for record types that are extensions of
4009 -- types with unknown discriminants, and also set for internally built
4010 -- underlying record views to reference its original record type. Record
4011 -- types that are extensions of types with unknown discriminants do not
4012 -- have a completion, but they cannot be used without having some
4013 -- discriminated view at hand. This view is a record type with the same
4014 -- structure, whose parent type is the full view of the parent in the
4015 -- original type extension.
4016
4017 -- Underlying_Type (synthesized)
4018 -- Applies to all entities. This is the identity function except in the
4019 -- case where it is applied to an incomplete or private type, in which
4020 -- case it is the underlying type of the type declared by the completion,
4021 -- or Empty if the completion has not yet been encountered and analyzed.
4022 --
4023 -- Note: the reason this attribute applies to all entities, and not just
4024 -- types, is to legitimize code where Underlying_Type is applied to an
4025 -- entity which may or may not be a type, with the intent that if it is a
4026 -- type, its underlying type is taken.
4027
4028 -- Universal_Aliasing (Flag216) [implementation base type only]
4029 -- Defined in all type entities. Set to direct the back-end to avoid
4030 -- any optimizations based on type-based alias analysis for this type.
4031 -- Indicates that objects of this type can alias objects of any other
4032 -- types, which guarantees that any objects can be referenced through
4033 -- access types designating this type safely, whatever the actual type
4034 -- of these objects. In other words, the effect is as though access
4035 -- types designating this type were subject to No_Strict_Aliasing.
4036
4037 -- Unset_Reference (Node16)
4038 -- Defined in variables and out parameters. This is normally Empty. It
4039 -- is set to point to an identifier that represents a reference to the
4040 -- entity before any value has been set. Only the first such reference
4041 -- is identified. This field is used to generate a warning message if
4042 -- necessary (see Sem_Warn.Check_Unset_Reference).
4043
4044 -- Used_As_Generic_Actual (Flag222)
4045 -- Defined in all entities, set if the entity is used as an argument to
4046 -- a generic instantiation. Used to tune certain warning messages.
4047
4048 -- Uses_Lock_Free (Flag188)
4049 -- Defined in protected type entities. Set to True when the Lock Free
4050 -- implementation is used for the protected type. This implemenatation is
4051 -- based on atomic transactions and doesn't require anymore the use of
4052 -- Protection object (see System.Tasking.Protected_Objects).
4053
4054 -- Uses_Sec_Stack (Flag95)
4055 -- Defined in scope entities (blocks,functions, procedures, tasks,
4056 -- entries). Set to True when secondary stack is used in this scope and
4057 -- must be released on exit unless Sec_Stack_Needed_For_Return is set.
4058
4059 -- Warnings_Off (Flag96)
4060 -- Defined in all entities. Set if a pragma Warnings (Off, entity-name)
4061 -- is used to suppress warnings for a given entity. It is also used by
4062 -- the compiler in some situations to kill spurious warnings. Note that
4063 -- clients should generally not test this flag directly, but instead
4064 -- use function Has_Warnings_Off.
4065
4066 -- Warnings_Off_Used (Flag236)
4067 -- Defined in all entities. Can only be set if Warnings_Off is set. If
4068 -- set indicates that a warning was suppressed by the Warnings_Off flag,
4069 -- and Unmodified/Unreferenced would not have suppressed the warning.
4070
4071 -- Warnings_Off_Used_Unmodified (Flag237)
4072 -- Defined in all entities. Can only be set if Warnings_Off is set and
4073 -- Has_Pragma_Unmodified is not set. If set indicates that a warning was
4074 -- suppressed by the Warnings_Off status but that pragma Unmodified
4075 -- would also have suppressed the warning.
4076
4077 -- Warnings_Off_Used_Unreferenced (Flag238)
4078 -- Defined in all entities. Can only be set if Warnings_Off is set and
4079 -- Has_Pragma_Unreferenced is not set. If set indicates that a warning
4080 -- was suppressed by the Warnings_Off status but that pragma Unreferenced
4081 -- would also have suppressed the warning.
4082
4083 -- Was_Hidden (Flag196)
4084 -- Defined in all entities. Used to save the value of the Is_Hidden
4085 -- attribute when the limited-view is installed (Ada 2005: AI-217).
4086
4087 -- Wrapped_Entity (Node27)
4088 -- Defined in functions and procedures which have been classified as
4089 -- Is_Primitive_Wrapper. Set to the entity being wrapper.
4090
4091 --------------------------------------
4092 -- Delayed Freezing and Elaboration --
4093 --------------------------------------
4094
4095 -- The flag Has_Delayed_Freeze indicates that an entity carries an explicit
4096 -- freeze node, which appears later in the expanded tree.
4097
4098 -- a) The flag is used by the front-end to trigger expansion actions
4099 -- which include the generation of that freeze node. Typically this happens at
4100 -- the end of the current compilation unit, or before the first subprogram
4101 -- body is encountered in the current unit. See files freeze and exp_ch13 for
4102 -- details on the actions triggered by a freeze node, which include the
4103 -- construction of initialization procedures and dispatch tables.
4104
4105 -- b) The flag is used by the backend to defer elaboration of the entity until
4106 -- its freeze node is seen. In the absence of an explicit freeze node, an
4107 -- entity is frozen (and elaborated) at the point of declaration.
4108
4109 -- For object declarations, the flag is set when an address clause for the
4110 -- object is encountered. Legality checks on the address expression only
4111 -- take place at the freeze point of the object.
4112
4113 -- Most types have an explicit freeze node, because they cannot be elaborated
4114 -- until all representation and operational items that apply to them have been
4115 -- analyzed. Private types and incomplete types have the flag set as well, as
4116 -- do task and protected types.
4117
4118 -- Implicit base types created for type derivations, as well as classwide
4119 -- types created for all tagged types, have the flag set.
4120
4121 -- If a subprogram has an access parameter whose designated type is incomplete
4122 -- the subprogram has the flag set.
4123
4124 ------------------
4125 -- Access Kinds --
4126 ------------------
4127
4128 -- The following entity kinds are introduced by the corresponding type
4129 -- definitions:
4130
4131 -- E_Access_Type,
4132 -- E_General_Access_Type,
4133 -- E_Access_Subprogram_Type,
4134 -- E_Anonymous_Access_Subprogram_Type,
4135 -- E_Access_Protected_Subprogram_Type,
4136 -- E_Anonymous_Access_Protected_Subprogram_Type
4137 -- E_Anonymous_Access_Type.
4138
4139 -- E_Access_Subtype is for an access subtype created by a subtype
4140 -- declaration.
4141
4142 -- In addition, we define the kind E_Allocator_Type to label allocators.
4143 -- This is because special resolution rules apply to this construct.
4144 -- Eventually the constructs are labeled with the access type imposed by
4145 -- the context. Gigi should never see the type E_Allocator.
4146
4147 -- Similarly, the type E_Access_Attribute_Type is used as the initial kind
4148 -- associated with an access attribute. After resolution a specific access
4149 -- type will be established as determined by the context.
4150
4151 -- Finally, the type Any_Access is used to label -null- during type
4152 -- resolution. Any_Access is also replaced by the context type after
4153 -- resolution.
4154
4155 --------------------------------
4156 -- Classification of Entities --
4157 --------------------------------
4158
4159 -- The classification of program entities which follows is a refinement of
4160 -- the list given in RM 3.1(1). E.g., separate entities denote subtypes of
4161 -- different type classes. Ada 95 entities include class wide types,
4162 -- protected types, subprogram types, generalized access types, generic
4163 -- formal derived types and generic formal packages.
4164
4165 -- The order chosen for these kinds allows us to classify related entities
4166 -- so that they are contiguous. As a result, they do not appear in the
4167 -- exact same order as their order of first appearance in the LRM (For
4168 -- example, private types are listed before packages). The contiguity
4169 -- allows us to define useful subtypes (see below) such as type entities,
4170 -- overloaded entities, etc.
4171
4172 -- Each entity (explicitly or implicitly declared) has a kind, which is
4173 -- a value of the following type:
4174
4175 type Entity_Kind is (
4176
4177 E_Void,
4178 -- The initial Ekind value for a newly created entity. Also used as the
4179 -- Ekind for Standard_Void_Type, a type entity in Standard used as a
4180 -- dummy type for the return type of a procedure (the reason we create
4181 -- this type is to share the circuits for performing overload resolution
4182 -- on calls).
4183
4184 -------------
4185 -- Objects --
4186 -------------
4187
4188 E_Component,
4189 -- Components of a record declaration, private declarations of
4190 -- protected objects.
4191
4192 E_Constant,
4193 -- Constants created by an object declaration with a constant keyword
4194
4195 E_Discriminant,
4196 -- A discriminant, created by the use of a discriminant in a type
4197 -- declaration.
4198
4199 E_Loop_Parameter,
4200 -- A loop parameter created by a for loop
4201
4202 E_Variable,
4203 -- Variables created by an object declaration with no constant keyword
4204
4205 ------------------------
4206 -- Parameter Entities --
4207 ------------------------
4208
4209 -- Parameters are also objects
4210
4211 E_Out_Parameter,
4212 -- An out parameter of a subprogram or entry
4213
4214 E_In_Out_Parameter,
4215 -- An in-out parameter of a subprogram or entry
4216
4217 E_In_Parameter,
4218 -- An in parameter of a subprogram or entry
4219
4220 --------------------------------
4221 -- Generic Parameter Entities --
4222 --------------------------------
4223
4224 -- Generic parameters are also objects
4225
4226 E_Generic_In_Out_Parameter,
4227 -- A generic in out parameter, created by the use of a generic in out
4228 -- parameter in a generic declaration.
4229
4230 E_Generic_In_Parameter,
4231 -- A generic in parameter, created by the use of a generic in
4232 -- parameter in a generic declaration.
4233
4234 -------------------
4235 -- Named Numbers --
4236 -------------------
4237
4238 E_Named_Integer,
4239 -- Named numbers created by a number declaration with an integer value
4240
4241 E_Named_Real,
4242 -- Named numbers created by a number declaration with a real value
4243
4244 -----------------------
4245 -- Enumeration Types --
4246 -----------------------
4247
4248 E_Enumeration_Type,
4249 -- Enumeration types, created by an enumeration type declaration
4250
4251 E_Enumeration_Subtype,
4252 -- Enumeration subtypes, created by an explicit or implicit subtype
4253 -- declaration applied to an enumeration type or subtype.
4254
4255 -------------------
4256 -- Numeric Types --
4257 -------------------
4258
4259 E_Signed_Integer_Type,
4260 -- Signed integer type, used for the anonymous base type of the
4261 -- integer subtype created by an integer type declaration.
4262
4263 E_Signed_Integer_Subtype,
4264 -- Signed integer subtype, created by either an integer subtype or
4265 -- integer type declaration (in the latter case an integer type is
4266 -- created for the base type, and this is the first named subtype).
4267
4268 E_Modular_Integer_Type,
4269 -- Modular integer type, used for the anonymous base type of the
4270 -- integer subtype created by a modular integer type declaration.
4271
4272 E_Modular_Integer_Subtype,
4273 -- Modular integer subtype, created by either an modular subtype
4274 -- or modular type declaration (in the latter case a modular type
4275 -- is created for the base type, and this is the first named subtype).
4276
4277 E_Ordinary_Fixed_Point_Type,
4278 -- Ordinary fixed type, used for the anonymous base type of the
4279 -- fixed subtype created by an ordinary fixed point type declaration.
4280
4281 E_Ordinary_Fixed_Point_Subtype,
4282 -- Ordinary fixed point subtype, created by either an ordinary fixed
4283 -- point subtype or ordinary fixed point type declaration (in the
4284 -- latter case a fixed point type is created for the base type, and
4285 -- this is the first named subtype).
4286
4287 E_Decimal_Fixed_Point_Type,
4288 -- Decimal fixed type, used for the anonymous base type of the decimal
4289 -- fixed subtype created by an ordinary fixed point type declaration.
4290
4291 E_Decimal_Fixed_Point_Subtype,
4292 -- Decimal fixed point subtype, created by either a decimal fixed point
4293 -- subtype or decimal fixed point type declaration (in the latter case
4294 -- a fixed point type is created for the base type, and this is the
4295 -- first named subtype).
4296
4297 E_Floating_Point_Type,
4298 -- Floating point type, used for the anonymous base type of the
4299 -- floating point subtype created by a floating point type declaration.
4300
4301 E_Floating_Point_Subtype,
4302
4303 -- Floating point subtype, created by either a floating point subtype
4304 -- or floating point type declaration (in the latter case a floating
4305 -- point type is created for the base type, and this is the first
4306 -- named subtype).
4307
4308 ------------------
4309 -- Access Types --
4310 ------------------
4311
4312 E_Access_Type,
4313 -- An access type created by an access type declaration with no all
4314 -- keyword present. Note that the predefined type Any_Access, which
4315 -- has E_Access_Type Ekind, is used to label NULL in the upwards pass
4316 -- of type analysis, to be replaced by the true access type in the
4317 -- downwards resolution pass.
4318
4319 E_Access_Subtype,
4320 -- An access subtype created by a subtype declaration for any access
4321 -- type (whether or not it is a general access type).
4322
4323 E_Access_Attribute_Type,
4324 -- An access type created for an access attribute (such as 'Access,
4325 -- 'Unrestricted_Access and Unchecked_Access)
4326
4327 E_Allocator_Type,
4328 -- A special internal type used to label allocators and attribute
4329 -- references using 'Access. This is needed because special resolution
4330 -- rules apply to these constructs. On the resolution pass, this type
4331 -- is always replaced by the actual access type, so Gigi should never
4332 -- see types with this Ekind.
4333
4334 E_General_Access_Type,
4335 -- An access type created by an access type declaration with the all
4336 -- keyword present.
4337
4338 E_Access_Subprogram_Type,
4339 -- An access to subprogram type, created by an access to subprogram
4340 -- declaration.
4341
4342 E_Anonymous_Access_Subprogram_Type,
4343 -- An anonymous access to subprogram type, created by an access to
4344 -- subprogram declaration, or generated for a current instance of
4345 -- a type name appearing within a component definition that has an
4346 -- anonymous access to subprogram type.
4347
4348 E_Access_Protected_Subprogram_Type,
4349 -- An access to a protected subprogram, created by the corresponding
4350 -- declaration. Values of such a type denote both a protected object
4351 -- and a protected operation within, and have different compile-time
4352 -- and run-time properties than other access to subprograms.
4353
4354 E_Anonymous_Access_Protected_Subprogram_Type,
4355 -- An anonymous access to protected subprogram type, created by an
4356 -- access to subprogram declaration.
4357
4358 E_Anonymous_Access_Type,
4359 -- An anonymous access type created by an access parameter or access
4360 -- discriminant.
4361
4362 ---------------------
4363 -- Composite Types --
4364 ---------------------
4365
4366 E_Array_Type,
4367 -- An array type created by an array type declaration. Includes all
4368 -- cases of arrays, except for string types.
4369
4370 E_Array_Subtype,
4371 -- An array subtype, created by an explicit array subtype declaration,
4372 -- or the use of an anonymous array subtype.
4373
4374 E_String_Type,
4375 -- A string type, i.e. an array type whose component type is a character
4376 -- type, and for which string literals can thus be written.
4377
4378 E_String_Subtype,
4379 -- A string subtype, created by an explicit subtype declaration for a
4380 -- string type, or the use of an anonymous subtype of a string type,
4381
4382 E_String_Literal_Subtype,
4383 -- A special string subtype, used only to describe the type of a string
4384 -- literal (will always be one dimensional, with literal bounds).
4385
4386 E_Class_Wide_Type,
4387 -- A class wide type, created by any tagged type declaration (i.e. if
4388 -- a tagged type is declared, the corresponding class type is always
4389 -- created, using this Ekind value).
4390
4391 E_Class_Wide_Subtype,
4392 -- A subtype of a class wide type, created by a subtype declaration
4393 -- used to declare a subtype of a class type.
4394
4395 E_Record_Type,
4396 -- A record type, created by a record type declaration
4397
4398 E_Record_Subtype,
4399 -- A record subtype, created by a record subtype declaration
4400
4401 E_Record_Type_With_Private,
4402 -- Used for types defined by a private extension declaration, and
4403 -- for tagged private types. Includes the fields for both private
4404 -- types and for record types (with the sole exception of
4405 -- Corresponding_Concurrent_Type which is obviously not needed).
4406 -- This entity is considered to be both a record type and
4407 -- a private type.
4408
4409 E_Record_Subtype_With_Private,
4410 -- A subtype of a type defined by a private extension declaration
4411
4412 E_Private_Type,
4413 -- A private type, created by a private type declaration
4414 -- that has neither the keyword limited nor the keyword tagged.
4415
4416 E_Private_Subtype,
4417 -- A subtype of a private type, created by a subtype declaration used
4418 -- to declare a subtype of a private type.
4419
4420 E_Limited_Private_Type,
4421 -- A limited private type, created by a private type declaration that
4422 -- has the keyword limited, but not the keyword tagged.
4423
4424 E_Limited_Private_Subtype,
4425 -- A subtype of a limited private type, created by a subtype declaration
4426 -- used to declare a subtype of a limited private type.
4427
4428 E_Incomplete_Type,
4429 -- An incomplete type, created by an incomplete type declaration
4430
4431 E_Incomplete_Subtype,
4432 -- An incomplete subtype, created by a subtype declaration where the
4433 -- subtype mark denotes an incomplete type.
4434
4435 E_Task_Type,
4436 -- A task type, created by a task type declaration. An entity with this
4437 -- Ekind is also created to describe the anonymous type of a task that
4438 -- is created by a single task declaration.
4439
4440 E_Task_Subtype,
4441 -- A subtype of a task type, created by a subtype declaration used to
4442 -- declare a subtype of a task type.
4443
4444 E_Protected_Type,
4445 -- A protected type, created by a protected type declaration. An entity
4446 -- with this Ekind is also created to describe the anonymous type of
4447 -- a protected object created by a single protected declaration.
4448
4449 E_Protected_Subtype,
4450 -- A subtype of a protected type, created by a subtype declaration used
4451 -- to declare a subtype of a protected type.
4452
4453 -----------------
4454 -- Other Types --
4455 -----------------
4456
4457 E_Exception_Type,
4458 -- The type of an exception created by an exception declaration
4459
4460 E_Subprogram_Type,
4461 -- This is the designated type of an Access_To_Subprogram. Has type
4462 -- and signature like a subprogram entity, so can appear in calls,
4463 -- which are resolved like regular calls, except that such an entity
4464 -- is not overloadable.
4465
4466 ---------------------------
4467 -- Overloadable Entities --
4468 ---------------------------
4469
4470 E_Enumeration_Literal,
4471 -- An enumeration literal, created by the use of the literal in an
4472 -- enumeration type definition.
4473
4474 E_Function,
4475 -- A function, created by a function declaration or a function body
4476 -- that acts as its own declaration.
4477
4478 E_Operator,
4479 -- A predefined operator, appearing in Standard, or an implicitly
4480 -- defined concatenation operator created whenever an array is
4481 -- declared. We do not make normal derived operators explicit in
4482 -- the tree, but the concatenation operators are made explicit.
4483
4484 E_Procedure,
4485 -- A procedure, created by a procedure declaration or a procedure
4486 -- body that acts as its own declaration.
4487
4488 E_Entry,
4489 -- An entry, created by an entry declaration in a task or protected
4490 -- object.
4491
4492 E_Abstract_State,
4493 -- A state abstraction. Used to designate entities introduced by aspect
4494 -- or pragma Abstract_State. The entity carries the various properties
4495 -- of the state.
4496
4497 --------------------
4498 -- Other Entities --
4499 --------------------
4500
4501 E_Entry_Family,
4502 -- An entry family, created by an entry family declaration in a
4503 -- task or protected type definition.
4504
4505 E_Block,
4506 -- A block identifier, created by an explicit or implicit label on
4507 -- a block or declare statement.
4508
4509 E_Entry_Index_Parameter,
4510 -- An entry index parameter created by an entry index specification
4511 -- for the body of a protected entry family.
4512
4513 E_Exception,
4514 -- An exception created by an exception declaration. The exception
4515 -- itself uses E_Exception for the Ekind, the implicit type that is
4516 -- created to represent its type uses the Ekind E_Exception_Type.
4517
4518 E_Generic_Function,
4519 -- A generic function. This is the entity for a generic function
4520 -- created by a generic subprogram declaration.
4521
4522 E_Generic_Procedure,
4523 -- A generic function. This is the entity for a generic procedure
4524 -- created by a generic subprogram declaration.
4525
4526 E_Generic_Package,
4527 -- A generic package, this is the entity for a generic package created
4528 -- by a generic package declaration.
4529
4530 E_Label,
4531 -- The defining entity for a label. Note that this is created by the
4532 -- implicit label declaration, not the occurrence of the label itself,
4533 -- which is simply a direct name referring to the label.
4534
4535 E_Loop,
4536 -- A loop identifier, created by an explicit or implicit label on a
4537 -- loop statement.
4538
4539 E_Return_Statement,
4540 -- A dummy entity created for each return statement. Used to hold
4541 -- information about the return statement (what it applies to) and in
4542 -- rules checking. For example, a simple_return_statement that applies
4543 -- to an extended_return_statement cannot have an expression; this
4544 -- requires putting the E_Return_Statement entity for the
4545 -- extended_return_statement on the scope stack.
4546
4547 E_Package,
4548 -- A package, created by a package declaration
4549
4550 E_Package_Body,
4551 -- A package body. This entity serves only limited functions, since
4552 -- most semantic analysis uses the package entity (E_Package). However
4553 -- there are some attributes that are significant for the body entity.
4554 -- For example, collection of exception handlers.
4555
4556 E_Protected_Object,
4557 -- A protected object, created by an object declaration that declares
4558 -- an object of a protected type.
4559
4560 E_Protected_Body,
4561 -- A protected body. This entity serves almost no function, since all
4562 -- semantic analysis uses the protected entity (E_Protected_Type)
4563
4564 E_Task_Body,
4565 -- A task body. This entity serves almost no function, since all
4566 -- semantic analysis uses the protected entity (E_Task_Type).
4567
4568 E_Subprogram_Body
4569 -- A subprogram body. Used when a subprogram has a separate declaration
4570 -- to represent the entity for the body. This entity serves almost no
4571 -- function, since all semantic analysis uses the subprogram entity
4572 -- for the declaration (E_Function or E_Procedure).
4573 );
4574
4575 for Entity_Kind'Size use 8;
4576 -- The data structures in Atree assume this!
4577
4578 --------------------------
4579 -- Subtype Declarations --
4580 --------------------------
4581
4582 -- The above entities are arranged so that they can be conveniently grouped
4583 -- into subtype ranges. Note that for each of the xxx_Kind ranges defined
4584 -- below, there is a corresponding Is_xxx (or for types, Is_xxx_Type)
4585 -- predicate which is to be used in preference to direct range tests using
4586 -- the subtype name. However, the subtype names are available for direct
4587 -- use, e.g. as choices in case statements.
4588
4589 subtype Access_Kind is Entity_Kind range
4590 E_Access_Type ..
4591 -- E_Access_Subtype
4592 -- E_Access_Attribute_Type
4593 -- E_Allocator_Type
4594 -- E_General_Access_Type
4595 -- E_Access_Subprogram_Type
4596 -- E_Anonymous_Access_Subprogram_Type
4597 -- E_Access_Protected_Subprogram_Type
4598 -- E_Anonymous_Access_Protected_Subprogram_Type
4599 E_Anonymous_Access_Type;
4600
4601 subtype Access_Subprogram_Kind is Entity_Kind range
4602 E_Access_Subprogram_Type ..
4603 -- E_Anonymous_Access_Subprogram_Type
4604 -- E_Access_Protected_Subprogram_Type
4605 E_Anonymous_Access_Protected_Subprogram_Type;
4606
4607 subtype Access_Protected_Kind is Entity_Kind range
4608 E_Access_Protected_Subprogram_Type ..
4609 E_Anonymous_Access_Protected_Subprogram_Type;
4610
4611 subtype Aggregate_Kind is Entity_Kind range
4612 E_Array_Type ..
4613 -- E_Array_Subtype
4614 -- E_String_Type
4615 -- E_String_Subtype
4616 -- E_String_Literal_Subtype
4617 -- E_Class_Wide_Type
4618 -- E_Class_Wide_Subtype
4619 -- E_Record_Type
4620 E_Record_Subtype;
4621
4622 subtype Array_Kind is Entity_Kind range
4623 E_Array_Type ..
4624 -- E_Array_Subtype
4625 -- E_String_Type
4626 -- E_String_Subtype
4627 E_String_Literal_Subtype;
4628
4629 subtype Assignable_Kind is Entity_Kind range
4630 E_Variable ..
4631 -- E_Out_Parameter
4632 E_In_Out_Parameter;
4633
4634 subtype Class_Wide_Kind is Entity_Kind range
4635 E_Class_Wide_Type ..
4636 E_Class_Wide_Subtype;
4637
4638 subtype Composite_Kind is Entity_Kind range
4639 E_Array_Type ..
4640 -- E_Array_Subtype
4641 -- E_String_Type
4642 -- E_String_Subtype
4643 -- E_String_Literal_Subtype
4644 -- E_Class_Wide_Type
4645 -- E_Class_Wide_Subtype
4646 -- E_Record_Type
4647 -- E_Record_Subtype
4648 -- E_Record_Type_With_Private
4649 -- E_Record_Subtype_With_Private
4650 -- E_Private_Type
4651 -- E_Private_Subtype
4652 -- E_Limited_Private_Type
4653 -- E_Limited_Private_Subtype
4654 -- E_Incomplete_Type
4655 -- E_Incomplete_Subtype
4656 -- E_Task_Type
4657 -- E_Task_Subtype,
4658 -- E_Protected_Type,
4659 E_Protected_Subtype;
4660
4661 subtype Concurrent_Kind is Entity_Kind range
4662 E_Task_Type ..
4663 -- E_Task_Subtype,
4664 -- E_Protected_Type,
4665 E_Protected_Subtype;
4666
4667 subtype Concurrent_Body_Kind is Entity_Kind range
4668 E_Protected_Body ..
4669 E_Task_Body;
4670
4671 subtype Decimal_Fixed_Point_Kind is Entity_Kind range
4672 E_Decimal_Fixed_Point_Type ..
4673 E_Decimal_Fixed_Point_Subtype;
4674
4675 subtype Digits_Kind is Entity_Kind range
4676 E_Decimal_Fixed_Point_Type ..
4677 -- E_Decimal_Fixed_Point_Subtype
4678 -- E_Floating_Point_Type
4679 E_Floating_Point_Subtype;
4680
4681 subtype Discrete_Kind is Entity_Kind range
4682 E_Enumeration_Type ..
4683 -- E_Enumeration_Subtype
4684 -- E_Signed_Integer_Type
4685 -- E_Signed_Integer_Subtype
4686 -- E_Modular_Integer_Type
4687 E_Modular_Integer_Subtype;
4688
4689 subtype Discrete_Or_Fixed_Point_Kind is Entity_Kind range
4690 E_Enumeration_Type ..
4691 -- E_Enumeration_Subtype
4692 -- E_Signed_Integer_Type
4693 -- E_Signed_Integer_Subtype
4694 -- E_Modular_Integer_Type
4695 -- E_Modular_Integer_Subtype
4696 -- E_Ordinary_Fixed_Point_Type
4697 -- E_Ordinary_Fixed_Point_Subtype
4698 -- E_Decimal_Fixed_Point_Type
4699 E_Decimal_Fixed_Point_Subtype;
4700
4701 subtype Elementary_Kind is Entity_Kind range
4702 E_Enumeration_Type ..
4703 -- E_Enumeration_Subtype
4704 -- E_Signed_Integer_Type
4705 -- E_Signed_Integer_Subtype
4706 -- E_Modular_Integer_Type
4707 -- E_Modular_Integer_Subtype
4708 -- E_Ordinary_Fixed_Point_Type
4709 -- E_Ordinary_Fixed_Point_Subtype
4710 -- E_Decimal_Fixed_Point_Type
4711 -- E_Decimal_Fixed_Point_Subtype
4712 -- E_Floating_Point_Type
4713 -- E_Floating_Point_Subtype
4714 -- E_Access_Type
4715 -- E_Access_Subtype
4716 -- E_Access_Attribute_Type
4717 -- E_Allocator_Type
4718 -- E_General_Access_Type
4719 -- E_Access_Subprogram_Type
4720 -- E_Access_Protected_Subprogram_Type
4721 -- E_Anonymous_Access_Subprogram_Type
4722 -- E_Anonymous_Access_Protected_Subprogram_Type
4723 E_Anonymous_Access_Type;
4724
4725 subtype Enumeration_Kind is Entity_Kind range
4726 E_Enumeration_Type ..
4727 E_Enumeration_Subtype;
4728
4729 subtype Entry_Kind is Entity_Kind range
4730 E_Entry ..
4731 E_Entry_Family;
4732
4733 subtype Fixed_Point_Kind is Entity_Kind range
4734 E_Ordinary_Fixed_Point_Type ..
4735 -- E_Ordinary_Fixed_Point_Subtype
4736 -- E_Decimal_Fixed_Point_Type
4737 E_Decimal_Fixed_Point_Subtype;
4738
4739 subtype Float_Kind is Entity_Kind range
4740 E_Floating_Point_Type ..
4741 E_Floating_Point_Subtype;
4742
4743 subtype Formal_Kind is Entity_Kind range
4744 E_Out_Parameter ..
4745 -- E_In_Out_Parameter
4746 E_In_Parameter;
4747
4748 subtype Formal_Object_Kind is Entity_Kind range
4749 E_Generic_In_Out_Parameter ..
4750 E_Generic_In_Parameter;
4751
4752 subtype Generic_Subprogram_Kind is Entity_Kind range
4753 E_Generic_Function ..
4754 E_Generic_Procedure;
4755
4756 subtype Generic_Unit_Kind is Entity_Kind range
4757 E_Generic_Function ..
4758 -- E_Generic_Procedure
4759 E_Generic_Package;
4760
4761 subtype Incomplete_Kind is Entity_Kind range
4762 E_Incomplete_Type ..
4763 E_Incomplete_Subtype;
4764
4765 subtype Incomplete_Or_Private_Kind is Entity_Kind range
4766 E_Record_Type_With_Private ..
4767 -- E_Record_Subtype_With_Private
4768 -- E_Private_Type
4769 -- E_Private_Subtype
4770 -- E_Limited_Private_Type
4771 -- E_Limited_Private_Subtype
4772 -- E_Incomplete_Type
4773 E_Incomplete_Subtype;
4774
4775 subtype Integer_Kind is Entity_Kind range
4776 E_Signed_Integer_Type ..
4777 -- E_Signed_Integer_Subtype
4778 -- E_Modular_Integer_Type
4779 E_Modular_Integer_Subtype;
4780
4781 subtype Modular_Integer_Kind is Entity_Kind range
4782 E_Modular_Integer_Type ..
4783 E_Modular_Integer_Subtype;
4784
4785 subtype Named_Kind is Entity_Kind range
4786 E_Named_Integer ..
4787 E_Named_Real;
4788
4789 subtype Numeric_Kind is Entity_Kind range
4790 E_Signed_Integer_Type ..
4791 -- E_Signed_Integer_Subtype
4792 -- E_Modular_Integer_Type
4793 -- E_Modular_Integer_Subtype
4794 -- E_Ordinary_Fixed_Point_Type
4795 -- E_Ordinary_Fixed_Point_Subtype
4796 -- E_Decimal_Fixed_Point_Type
4797 -- E_Decimal_Fixed_Point_Subtype
4798 -- E_Floating_Point_Type
4799 E_Floating_Point_Subtype;
4800
4801 subtype Object_Kind is Entity_Kind range
4802 E_Component ..
4803 -- E_Constant
4804 -- E_Discriminant
4805 -- E_Loop_Parameter
4806 -- E_Variable
4807 -- E_Out_Parameter
4808 -- E_In_Out_Parameter
4809 -- E_In_Parameter
4810 -- E_Generic_In_Out_Parameter
4811 E_Generic_In_Parameter;
4812
4813 subtype Ordinary_Fixed_Point_Kind is Entity_Kind range
4814 E_Ordinary_Fixed_Point_Type ..
4815 E_Ordinary_Fixed_Point_Subtype;
4816
4817 subtype Overloadable_Kind is Entity_Kind range
4818 E_Enumeration_Literal ..
4819 -- E_Function
4820 -- E_Operator
4821 -- E_Procedure
4822 -- E_Entry
4823 E_Abstract_State;
4824
4825 subtype Private_Kind is Entity_Kind range
4826 E_Record_Type_With_Private ..
4827 -- E_Record_Subtype_With_Private
4828 -- E_Private_Type
4829 -- E_Private_Subtype
4830 -- E_Limited_Private_Type
4831 E_Limited_Private_Subtype;
4832
4833 subtype Protected_Kind is Entity_Kind range
4834 E_Protected_Type ..
4835 E_Protected_Subtype;
4836
4837 subtype Real_Kind is Entity_Kind range
4838 E_Ordinary_Fixed_Point_Type ..
4839 -- E_Ordinary_Fixed_Point_Subtype
4840 -- E_Decimal_Fixed_Point_Type
4841 -- E_Decimal_Fixed_Point_Subtype
4842 -- E_Floating_Point_Type
4843 E_Floating_Point_Subtype;
4844
4845 subtype Record_Kind is Entity_Kind range
4846 E_Class_Wide_Type ..
4847 -- E_Class_Wide_Subtype
4848 -- E_Record_Type
4849 -- E_Record_Subtype
4850 -- E_Record_Type_With_Private
4851 E_Record_Subtype_With_Private;
4852
4853 subtype Scalar_Kind is Entity_Kind range
4854 E_Enumeration_Type ..
4855 -- E_Enumeration_Subtype
4856 -- E_Signed_Integer_Type
4857 -- E_Signed_Integer_Subtype
4858 -- E_Modular_Integer_Type
4859 -- E_Modular_Integer_Subtype
4860 -- E_Ordinary_Fixed_Point_Type
4861 -- E_Ordinary_Fixed_Point_Subtype
4862 -- E_Decimal_Fixed_Point_Type
4863 -- E_Decimal_Fixed_Point_Subtype
4864 -- E_Floating_Point_Type
4865 E_Floating_Point_Subtype;
4866
4867 subtype String_Kind is Entity_Kind range
4868 E_String_Type ..
4869 -- E_String_Subtype
4870 E_String_Literal_Subtype;
4871
4872 subtype Subprogram_Kind is Entity_Kind range
4873 E_Function ..
4874 -- E_Operator
4875 E_Procedure;
4876
4877 subtype Signed_Integer_Kind is Entity_Kind range
4878 E_Signed_Integer_Type ..
4879 E_Signed_Integer_Subtype;
4880
4881 subtype Task_Kind is Entity_Kind range
4882 E_Task_Type ..
4883 E_Task_Subtype;
4884
4885 subtype Type_Kind is Entity_Kind range
4886 E_Enumeration_Type ..
4887 -- E_Enumeration_Subtype
4888 -- E_Signed_Integer_Type
4889 -- E_Signed_Integer_Subtype
4890 -- E_Modular_Integer_Type
4891 -- E_Modular_Integer_Subtype
4892 -- E_Ordinary_Fixed_Point_Type
4893 -- E_Ordinary_Fixed_Point_Subtype
4894 -- E_Decimal_Fixed_Point_Type
4895 -- E_Decimal_Fixed_Point_Subtype
4896 -- E_Floating_Point_Type
4897 -- E_Floating_Point_Subtype
4898 -- E_Access_Type
4899 -- E_Access_Subtype
4900 -- E_Access_Attribute_Type
4901 -- E_Allocator_Type,
4902 -- E_General_Access_Type
4903 -- E_Access_Subprogram_Type,
4904 -- E_Access_Protected_Subprogram_Type
4905 -- E_Anonymous_Access_Subprogram_Type
4906 -- E_Anonymous_Access_Protected_Subprogram_Type
4907 -- E_Anonymous_Access_Type
4908 -- E_Array_Type
4909 -- E_Array_Subtype
4910 -- E_String_Type
4911 -- E_String_Subtype
4912 -- E_String_Literal_Subtype
4913 -- E_Class_Wide_Subtype
4914 -- E_Class_Wide_Type
4915 -- E_Record_Type
4916 -- E_Record_Subtype
4917 -- E_Record_Type_With_Private
4918 -- E_Record_Subtype_With_Private
4919 -- E_Private_Type
4920 -- E_Private_Subtype
4921 -- E_Limited_Private_Type
4922 -- E_Limited_Private_Subtype
4923 -- E_Incomplete_Type
4924 -- E_Incomplete_Subtype
4925 -- E_Task_Type
4926 -- E_Task_Subtype
4927 -- E_Protected_Type
4928 -- E_Protected_Subtype
4929 -- E_Exception_Type
4930 E_Subprogram_Type;
4931
4932 --------------------------------------------------------
4933 -- Description of Defined Attributes for Entity_Kinds --
4934 --------------------------------------------------------
4935
4936 -- For each enumeration value defined in Entity_Kind we list all the
4937 -- attributes defined in Einfo which can legally be applied to an entity
4938 -- of that kind. The implementation of the attribute functions (and for
4939 -- non-synthesized attributes, of the corresponding set procedures) are
4940 -- in the Einfo body.
4941
4942 -- The following attributes are defined in all entities
4943
4944 -- Ekind (Ekind)
4945
4946 -- Chars (Name1)
4947 -- Next_Entity (Node2)
4948 -- Scope (Node3)
4949 -- Homonym (Node4)
4950 -- Etype (Node5)
4951 -- First_Rep_Item (Node6)
4952 -- Freeze_Node (Node7)
4953
4954 -- Address_Taken (Flag104)
4955 -- Can_Never_Be_Null (Flag38)
4956 -- Checks_May_Be_Suppressed (Flag31)
4957 -- Debug_Info_Off (Flag166)
4958 -- Has_Convention_Pragma (Flag119)
4959 -- Has_Delayed_Aspects (Flag200)
4960 -- Has_Delayed_Freeze (Flag18)
4961 -- Has_Fully_Qualified_Name (Flag173)
4962 -- Has_Gigi_Rep_Item (Flag82)
4963 -- Has_Homonym (Flag56)
4964 -- Has_Pragma_Elaborate_Body (Flag150)
4965 -- Has_Pragma_Inline (Flag157)
4966 -- Has_Pragma_Inline_Always (Flag230)
4967 -- Has_Pragma_No_Inline (Flag201)
4968 -- Has_Pragma_Pure (Flag203)
4969 -- Has_Pragma_Pure_Function (Flag179)
4970 -- Has_Pragma_Thread_Local_Storage (Flag169)
4971 -- Has_Pragma_Unmodified (Flag233)
4972 -- Has_Pragma_Unreferenced (Flag180)
4973 -- Has_Private_Declaration (Flag155)
4974 -- Has_Qualified_Name (Flag161)
4975 -- Has_Stream_Size_Clause (Flag184)
4976 -- Has_Unknown_Discriminants (Flag72)
4977 -- Has_Xref_Entry (Flag182)
4978 -- In_Private_Part (Flag45)
4979 -- Is_Ada_2005_Only (Flag185)
4980 -- Is_Ada_2012_Only (Flag199)
4981 -- Is_Bit_Packed_Array (Flag122) (base type only)
4982 -- Is_Aliased (Flag15)
4983 -- Is_Character_Type (Flag63)
4984 -- Is_Child_Unit (Flag73)
4985 -- Is_Compilation_Unit (Flag149)
4986 -- Is_Completely_Hidden (Flag103)
4987 -- Is_Descendent_Of_Address (Flag223)
4988 -- Is_Discrim_SO_Function (Flag176)
4989 -- Is_Dispatch_Table_Entity (Flag234)
4990 -- Is_Dispatching_Operation (Flag6)
4991 -- Is_Entry_Formal (Flag52)
4992 -- Is_Exported (Flag99)
4993 -- Is_First_Subtype (Flag70)
4994 -- Is_Formal_Subprogram (Flag111)
4995 -- Is_Generic_Instance (Flag130)
4996 -- Is_Generic_Type (Flag13)
4997 -- Is_Hidden (Flag57)
4998 -- Is_Hidden_Open_Scope (Flag171)
4999 -- Is_Immediately_Visible (Flag7)
5000 -- Is_Implementation_Defined (Flag254)
5001 -- Is_Imported (Flag24)
5002 -- Is_Inlined (Flag11)
5003 -- Is_Internal (Flag17)
5004 -- Is_Itype (Flag91)
5005 -- Is_Known_Non_Null (Flag37)
5006 -- Is_Known_Null (Flag204)
5007 -- Is_Known_Valid (Flag170)
5008 -- Is_Limited_Composite (Flag106)
5009 -- Is_Limited_Record (Flag25)
5010 -- Is_Obsolescent (Flag153)
5011 -- Is_Package_Body_Entity (Flag160)
5012 -- Is_Packed_Array_Type (Flag138)
5013 -- Is_Potentially_Use_Visible (Flag9)
5014 -- Is_Preelaborated (Flag59)
5015 -- Is_Primitive_Wrapper (Flag195)
5016 -- Is_Public (Flag10)
5017 -- Is_Pure (Flag44)
5018 -- Is_Remote_Call_Interface (Flag62)
5019 -- Is_Remote_Types (Flag61)
5020 -- Is_Renaming_Of_Object (Flag112)
5021 -- Is_Shared_Passive (Flag60)
5022 -- Is_Statically_Allocated (Flag28)
5023 -- Is_Tagged_Type (Flag55)
5024 -- Is_Thunk (Flag225)
5025 -- Is_Trivial_Subprogram (Flag235)
5026 -- Is_Unchecked_Union (Flag117)
5027 -- Is_Visible_Formal (Flag206)
5028 -- Is_VMS_Exception (Flag133)
5029 -- Kill_Elaboration_Checks (Flag32)
5030 -- Kill_Range_Checks (Flag33)
5031 -- Low_Bound_Tested (Flag205)
5032 -- Materialize_Entity (Flag168)
5033 -- Needs_Debug_Info (Flag147)
5034 -- Never_Set_In_Source (Flag115)
5035 -- No_Return (Flag113)
5036 -- Overlays_Constant (Flag243)
5037 -- Referenced (Flag156)
5038 -- Referenced_As_LHS (Flag36)
5039 -- Referenced_As_Out_Parameter (Flag227)
5040 -- Suppress_Elaboration_Warnings (Flag148)
5041 -- Suppress_Style_Checks (Flag165)
5042 -- Suppress_Value_Tracking_On_Call (Flag217)
5043 -- Used_As_Generic_Actual (Flag222)
5044 -- Warnings_Off (Flag96)
5045 -- Warnings_Off_Used (Flag236)
5046 -- Warnings_Off_Used_Unmodified (Flag237)
5047 -- Warnings_Off_Used_Unreferenced (Flag238)
5048 -- Was_Hidden (Flag196)
5049
5050 -- Declaration_Node (synth)
5051 -- Has_Foreign_Convention (synth)
5052 -- Is_Dynamic_Scope (synth)
5053 -- Is_Standard_Character_Type (synth)
5054 -- Underlying_Type (synth)
5055 -- all classification attributes (synth)
5056
5057 -- The following list of access functions applies to all entities for
5058 -- types and subtypes. References to this list appear subsequently as
5059 -- as "(plus type attributes)" for each appropriate Entity_Kind.
5060
5061 -- Associated_Node_For_Itype (Node8)
5062 -- Class_Wide_Type (Node9)
5063 -- Full_View (Node11)
5064 -- Esize (Uint12)
5065 -- RM_Size (Uint13)
5066 -- Alignment (Uint14)
5067 -- Related_Expression (Node24)
5068 -- Current_Use_Clause (Node27)
5069 -- Subprograms_For_Type (Node29)
5070
5071 -- Depends_On_Private (Flag14)
5072 -- Discard_Names (Flag88)
5073 -- Finalize_Storage_Only (Flag158) (base type only)
5074 -- From_Limited_With (Flag159)
5075 -- Has_Aliased_Components (Flag135) (base type only)
5076 -- Has_Alignment_Clause (Flag46)
5077 -- Has_Atomic_Components (Flag86) (base type only)
5078 -- Has_Completion_In_Body (Flag71)
5079 -- Has_Complex_Representation (Flag140) (base type only)
5080 -- Has_Constrained_Partial_View (Flag187)
5081 -- Has_Controlled_Component (Flag43) (base type only)
5082 -- Has_Default_Aspect (Flag39) (base type only)
5083 -- Has_Delayed_Rep_Aspects (Flag261)
5084 -- Has_Discriminants (Flag5)
5085 -- Has_Dynamic_Predicate_Aspect (Flag258)
5086 -- Has_Independent_Components (Flag34) (base type only)
5087 -- Has_Inheritable_Invariants (Flag248)
5088 -- Has_Invariants (Flag232)
5089 -- Has_Non_Standard_Rep (Flag75) (base type only)
5090 -- Has_Object_Size_Clause (Flag172)
5091 -- Has_Pragma_Preelab_Init (Flag221)
5092 -- Has_Pragma_Unreferenced_Objects (Flag212)
5093 -- Has_Predicates (Flag250)
5094 -- Has_Primitive_Operations (Flag120) (base type only)
5095 -- Has_Size_Clause (Flag29)
5096 -- Has_Specified_Layout (Flag100) (base type only)
5097 -- Has_Specified_Stream_Input (Flag190)
5098 -- Has_Specified_Stream_Output (Flag191)
5099 -- Has_Specified_Stream_Read (Flag192)
5100 -- Has_Specified_Stream_Write (Flag193)
5101 -- Has_Static_Predicate_Aspect (Flag259)
5102 -- Has_Task (Flag30) (base type only)
5103 -- Has_Unchecked_Union (Flag123) (base type only)
5104 -- Has_Volatile_Components (Flag87) (base type only)
5105 -- In_Use (Flag8)
5106 -- Is_Abstract_Type (Flag146)
5107 -- Is_Asynchronous (Flag81)
5108 -- Is_Atomic (Flag85)
5109 -- Is_Constr_Subt_For_U_Nominal (Flag80)
5110 -- Is_Constr_Subt_For_UN_Aliased (Flag141)
5111 -- Is_Controlled (Flag42) (base type only)
5112 -- Is_Eliminated (Flag124)
5113 -- Is_Frozen (Flag4)
5114 -- Is_Generic_Actual_Type (Flag94)
5115 -- Is_RACW_Stub_Type (Flag244)
5116 -- Is_Non_Static_Subtype (Flag109)
5117 -- Is_Packed (Flag51) (base type only)
5118 -- Is_Private_Composite (Flag107)
5119 -- Is_Unsigned_Type (Flag144)
5120 -- Is_Volatile (Flag16)
5121 -- Itype_Printed (Flag202) (itypes only)
5122 -- Known_To_Have_Preelab_Init (Flag207)
5123 -- May_Inherit_Delayed_Rep_Aspects (Flag262)
5124 -- Must_Be_On_Byte_Boundary (Flag183)
5125 -- Must_Have_Preelab_Init (Flag208)
5126 -- Optimize_Alignment_Space (Flag241)
5127 -- Optimize_Alignment_Time (Flag242)
5128 -- Size_Depends_On_Discriminant (Flag177)
5129 -- Size_Known_At_Compile_Time (Flag92)
5130 -- Strict_Alignment (Flag145) (base type only)
5131 -- Suppress_Initialization (Flag105)
5132 -- Treat_As_Volatile (Flag41)
5133 -- Universal_Aliasing (Flag216) (impl base type only)
5134
5135 -- Alignment_Clause (synth)
5136 -- Base_Type (synth)
5137 -- Implementation_Base_Type (synth)
5138 -- Invariant_Procedure (synth)
5139 -- Is_Access_Protected_Subprogram_Type (synth)
5140 -- Predicate_Function (synth)
5141 -- Predicate_Function_M (synth)
5142 -- Root_Type (synth)
5143 -- Size_Clause (synth)
5144
5145 ------------------------------------------
5146 -- Applicable attributes by entity kind --
5147 ------------------------------------------
5148
5149 -- E_Abstract_State
5150 -- Refinement_Constituents (Elist8)
5151 -- Refined_State (Node10)
5152 -- Body_References (Elist16)
5153 -- Non_Limited_View (Node17)
5154 -- From_Limited_With (Flag159)
5155 -- Has_Body_References (Flag264)
5156 -- Has_Visible_Refinement (Flag263)
5157 -- Has_Non_Null_Refinement (synth)
5158 -- Has_Null_Refinement (synth)
5159 -- Is_External_State (synth)
5160 -- Is_Input_Only_State (synth)
5161 -- Is_Null_State (synth)
5162 -- Is_Output_Only_State (synth)
5163 -- Is_Non_Volatile_State (synth)
5164
5165 -- E_Access_Protected_Subprogram_Type
5166 -- Equivalent_Type (Node18)
5167 -- Directly_Designated_Type (Node20)
5168 -- Needs_No_Actuals (Flag22)
5169 -- Can_Use_Internal_Rep (Flag229)
5170 -- (plus type attributes)
5171
5172 -- E_Access_Subprogram_Type
5173 -- Equivalent_Type (Node18) (remote types only)
5174 -- Directly_Designated_Type (Node20)
5175 -- Interface_Name (Node21) (JGNAT usage only)
5176 -- Needs_No_Actuals (Flag22)
5177 -- Original_Access_Type (Node26)
5178 -- Can_Use_Internal_Rep (Flag229)
5179 -- (plus type attributes)
5180
5181 -- E_Access_Type
5182 -- E_Access_Subtype
5183 -- Storage_Size_Variable (Node15) (base type only)
5184 -- Master_Id (Node17)
5185 -- Directly_Designated_Type (Node20)
5186 -- Associated_Storage_Pool (Node22) (base type only)
5187 -- Finalization_Master (Node23) (base type only)
5188 -- Has_Pragma_Controlled (Flag27) (base type only)
5189 -- Has_Storage_Size_Clause (Flag23) (base type only)
5190 -- Is_Access_Constant (Flag69)
5191 -- Is_Local_Anonymous_Access (Flag194)
5192 -- Is_Pure_Unit_Access_Type (Flag189)
5193 -- No_Pool_Assigned (Flag131) (base type only)
5194 -- No_Strict_Aliasing (Flag136) (base type only)
5195 -- (plus type attributes)
5196
5197 -- E_Access_Attribute_Type
5198 -- Directly_Designated_Type (Node20)
5199 -- (plus type attributes)
5200
5201 -- E_Allocator_Type
5202 -- Directly_Designated_Type (Node20)
5203 -- (plus type attributes)
5204
5205 -- E_Anonymous_Access_Subprogram_Type
5206 -- E_Anonymous_Access_Protected_Subprogram_Type
5207 -- Storage_Size_Variable (Node15) ??? is this needed ???
5208 -- Directly_Designated_Type (Node20)
5209 -- Can_Use_Internal_Rep (Flag229)
5210 -- (plus type attributes)
5211
5212 -- E_Anonymous_Access_Type
5213 -- Storage_Size_Variable (Node15) ??? is this needed ???
5214 -- Directly_Designated_Type (Node20)
5215 -- Finalization_Master (Node23)
5216 -- (plus type attributes)
5217
5218 -- E_Array_Type
5219 -- E_Array_Subtype
5220 -- First_Index (Node17)
5221 -- Default_Aspect_Component_Value (Node19) (base type only)
5222 -- Component_Type (Node20) (base type only)
5223 -- Original_Array_Type (Node21)
5224 -- Component_Size (Uint22) (base type only)
5225 -- Packed_Array_Type (Node23)
5226 -- Related_Array_Object (Node25)
5227 -- Component_Alignment (special) (base type only)
5228 -- Has_Component_Size_Clause (Flag68) (base type only)
5229 -- Has_Pragma_Pack (Flag121) (impl base type only)
5230 -- Is_Constrained (Flag12)
5231 -- Reverse_Storage_Order (Flag93) (base type only)
5232 -- Next_Index (synth)
5233 -- Number_Dimensions (synth)
5234 -- (plus type attributes)
5235
5236 -- E_Block
5237 -- Block_Node (Node11)
5238 -- First_Entity (Node17)
5239 -- Last_Entity (Node20)
5240 -- Scope_Depth_Value (Uint22)
5241 -- Entry_Cancel_Parameter (Node23)
5242 -- Delay_Cleanups (Flag114)
5243 -- Discard_Names (Flag88)
5244 -- Has_Master_Entity (Flag21)
5245 -- Has_Nested_Block_With_Handler (Flag101)
5246 -- Sec_Stack_Needed_For_Return (Flag167)
5247 -- Uses_Sec_Stack (Flag95)
5248 -- Scope_Depth (synth)
5249
5250 -- E_Class_Wide_Type
5251 -- E_Class_Wide_Subtype
5252 -- Direct_Primitive_Operations (Elist10)
5253 -- Cloned_Subtype (Node16) (subtype case only)
5254 -- First_Entity (Node17)
5255 -- Equivalent_Type (Node18) (always Empty for type)
5256 -- Last_Entity (Node20)
5257 -- First_Component (synth)
5258 -- First_Component_Or_Discriminant (synth)
5259 -- (plus type attributes)
5260
5261 -- E_Component
5262 -- Normalized_First_Bit (Uint8)
5263 -- Current_Value (Node9) (always Empty)
5264 -- Normalized_Position_Max (Uint10)
5265 -- Component_Bit_Offset (Uint11)
5266 -- Esize (Uint12)
5267 -- Component_Clause (Node13)
5268 -- Normalized_Position (Uint14)
5269 -- DT_Entry_Count (Uint15)
5270 -- Entry_Formal (Node16)
5271 -- Prival (Node17)
5272 -- Renamed_Object (Node18) (always Empty)
5273 -- Discriminant_Checking_Func (Node20)
5274 -- Interface_Name (Node21) (JGNAT usage only)
5275 -- Original_Record_Component (Node22)
5276 -- DT_Offset_To_Top_Func (Node25)
5277 -- Related_Type (Node27)
5278 -- Has_Biased_Representation (Flag139)
5279 -- Has_Per_Object_Constraint (Flag154)
5280 -- Is_Atomic (Flag85)
5281 -- Is_Tag (Flag78)
5282 -- Is_Volatile (Flag16)
5283 -- Treat_As_Volatile (Flag41)
5284 -- Is_Return_Object (Flag209)
5285 -- Next_Component (synth)
5286 -- Next_Component_Or_Discriminant (synth)
5287
5288 -- E_Constant
5289 -- E_Loop_Parameter
5290 -- Current_Value (Node9) (always Empty)
5291 -- Discriminal_Link (Node10)
5292 -- Full_View (Node11)
5293 -- Esize (Uint12)
5294 -- Extra_Accessibility (Node13) (constants only)
5295 -- Alignment (Uint14)
5296 -- Status_Flag_Or_Transient_Decl (Node15) (constants only)
5297 -- Actual_Subtype (Node17)
5298 -- Renamed_Object (Node18)
5299 -- Size_Check_Code (Node19) (constants only)
5300 -- Prival_Link (Node20) (privals only)
5301 -- Interface_Name (Node21) (constants only)
5302 -- Related_Type (Node27) (constants only)
5303 -- Initialization_Statements (Node28)
5304 -- Has_Alignment_Clause (Flag46)
5305 -- Has_Atomic_Components (Flag86)
5306 -- Has_Biased_Representation (Flag139)
5307 -- Has_Completion (Flag26) (constants only)
5308 -- Has_Independent_Components (Flag34) (base type only)
5309 -- Has_Thunks (Flag228) (constants only)
5310 -- Has_Size_Clause (Flag29)
5311 -- Has_Up_Level_Access (Flag215)
5312 -- Has_Volatile_Components (Flag87)
5313 -- Is_Atomic (Flag85)
5314 -- Is_Eliminated (Flag124)
5315 -- Is_Processed_Transient (Flag252) (constants only)
5316 -- Is_Return_Object (Flag209)
5317 -- Is_True_Constant (Flag163)
5318 -- Is_Volatile (Flag16)
5319 -- Optimize_Alignment_Space (Flag241) (constants only)
5320 -- Optimize_Alignment_Time (Flag242) (constants only)
5321 -- Treat_As_Volatile (Flag41)
5322 -- Address_Clause (synth)
5323 -- Alignment_Clause (synth)
5324 -- Size_Clause (synth)
5325
5326 -- E_Decimal_Fixed_Point_Type
5327 -- E_Decimal_Fixed_Subtype
5328 -- Scale_Value (Uint15)
5329 -- Digits_Value (Uint17)
5330 -- Scalar_Range (Node20)
5331 -- Delta_Value (Ureal18)
5332 -- Small_Value (Ureal21)
5333 -- Has_Machine_Radix_Clause (Flag83)
5334 -- Machine_Radix_10 (Flag84)
5335 -- Aft_Value (synth)
5336 -- Type_Low_Bound (synth)
5337 -- Type_High_Bound (synth)
5338 -- (plus type attributes)
5339
5340 -- E_Discriminant
5341 -- Normalized_First_Bit (Uint8)
5342 -- Current_Value (Node9) (always Empty)
5343 -- Normalized_Position_Max (Uint10)
5344 -- Component_Bit_Offset (Uint11)
5345 -- Esize (Uint12)
5346 -- Component_Clause (Node13)
5347 -- Normalized_Position (Uint14)
5348 -- Discriminant_Number (Uint15)
5349 -- Discriminal (Node17)
5350 -- Renamed_Object (Node18) (always Empty)
5351 -- Corresponding_Discriminant (Node19)
5352 -- Discriminant_Default_Value (Node20)
5353 -- Interface_Name (Node21) (JGNAT usage only)
5354 -- Original_Record_Component (Node22)
5355 -- CR_Discriminant (Node23)
5356 -- Is_Return_Object (Flag209)
5357 -- Next_Component_Or_Discriminant (synth)
5358 -- Next_Discriminant (synth)
5359 -- Next_Stored_Discriminant (synth)
5360
5361 -- E_Entry
5362 -- E_Entry_Family
5363 -- Protected_Body_Subprogram (Node11)
5364 -- Barrier_Function (Node12)
5365 -- Entry_Parameters_Type (Node15)
5366 -- First_Entity (Node17)
5367 -- Alias (Node18) (for entry only. Empty)
5368 -- Last_Entity (Node20)
5369 -- Accept_Address (Elist21)
5370 -- Scope_Depth_Value (Uint22)
5371 -- Protection_Object (Node23) (protected kind)
5372 -- PPC_Wrapper (Node25)
5373 -- Extra_Formals (Node28)
5374 -- Contract (Node34)
5375 -- Default_Expressions_Processed (Flag108)
5376 -- Entry_Accepted (Flag152)
5377 -- Is_AST_Entry (Flag132) (for entry only)
5378 -- Needs_No_Actuals (Flag22)
5379 -- Sec_Stack_Needed_For_Return (Flag167)
5380 -- Uses_Sec_Stack (Flag95)
5381 -- Address_Clause (synth)
5382 -- Entry_Index_Type (synth)
5383 -- First_Formal (synth)
5384 -- First_Formal_With_Extras (synth)
5385 -- Last_Formal (synth)
5386 -- Number_Formals (synth)
5387 -- Scope_Depth (synth)
5388
5389 -- E_Entry_Index_Parameter
5390 -- Entry_Index_Constant (Node18)
5391
5392 -- E_Enumeration_Literal
5393 -- Enumeration_Pos (Uint11)
5394 -- Enumeration_Rep (Uint12)
5395 -- Alias (Node18)
5396 -- Enumeration_Rep_Expr (Node22)
5397 -- Next_Literal (synth)
5398
5399 -- E_Enumeration_Type
5400 -- E_Enumeration_Subtype
5401 -- Lit_Indexes (Node15) (root type only)
5402 -- Lit_Strings (Node16) (root type only)
5403 -- First_Literal (Node17)
5404 -- Default_Aspect_Value (Node19) (base type only)
5405 -- Scalar_Range (Node20)
5406 -- Enum_Pos_To_Rep (Node23) (type only)
5407 -- Static_Predicate (List25)
5408 -- Has_Biased_Representation (Flag139)
5409 -- Has_Contiguous_Rep (Flag181)
5410 -- Has_Enumeration_Rep_Clause (Flag66)
5411 -- Has_Pragma_Ordered (Flag198) (base type only)
5412 -- Nonzero_Is_True (Flag162) (base type only)
5413 -- Type_Low_Bound (synth)
5414 -- Type_High_Bound (synth)
5415 -- (plus type attributes)
5416
5417 -- E_Exception
5418 -- Esize (Uint12)
5419 -- Alignment (Uint14)
5420 -- Renamed_Entity (Node18)
5421 -- Register_Exception_Call (Node20)
5422 -- Interface_Name (Node21)
5423 -- Exception_Code (Uint22)
5424 -- Discard_Names (Flag88)
5425 -- Is_VMS_Exception (Flag133)
5426 -- Is_Raised (Flag224)
5427
5428 -- E_Exception_Type
5429 -- Equivalent_Type (Node18)
5430 -- (plus type attributes)
5431
5432 -- E_Floating_Point_Type
5433 -- E_Floating_Point_Subtype
5434 -- Digits_Value (Uint17)
5435 -- Float_Rep (Uint10) (Float_Rep_Kind)
5436 -- Default_Aspect_Value (Node19) (base type only)
5437 -- Scalar_Range (Node20)
5438 -- Machine_Emax_Value (synth)
5439 -- Machine_Emin_Value (synth)
5440 -- Machine_Mantissa_Value (synth)
5441 -- Machine_Radix_Value (synth)
5442 -- Model_Emin_Value (synth)
5443 -- Model_Epsilon_Value (synth)
5444 -- Model_Mantissa_Value (synth)
5445 -- Model_Small_Value (synth)
5446 -- Safe_Emax_Value (synth)
5447 -- Safe_First_Value (synth)
5448 -- Safe_Last_Value (synth)
5449 -- Type_Low_Bound (synth)
5450 -- Type_High_Bound (synth)
5451 -- Vax_Float (synth)
5452 -- (plus type attributes)
5453
5454 -- E_Function
5455 -- E_Generic_Function
5456 -- Mechanism (Uint8) (Mechanism_Type)
5457 -- Renaming_Map (Uint9)
5458 -- Handler_Records (List10) (non-generic case only)
5459 -- Protected_Body_Subprogram (Node11)
5460 -- Next_Inlined_Subprogram (Node12)
5461 -- Elaboration_Entity (Node13) (not implicit /=)
5462 -- First_Optional_Parameter (Node14) (non-generic case only)
5463 -- DT_Position (Uint15)
5464 -- DTC_Entity (Node16)
5465 -- First_Entity (Node17)
5466 -- Alias (Node18) (non-generic case only)
5467 -- Renamed_Entity (Node18) (generic case only)
5468 -- Extra_Accessibility_Of_Result (Node19) (non-generic case only)
5469 -- Last_Entity (Node20)
5470 -- Interface_Name (Node21)
5471 -- Scope_Depth_Value (Uint22)
5472 -- Generic_Renamings (Elist23) (for an instance)
5473 -- Inner_Instances (Elist23) (generic case only)
5474 -- Protection_Object (Node23) (for concurrent kind)
5475 -- Interface_Alias (Node25)
5476 -- Overridden_Operation (Node26)
5477 -- Wrapped_Entity (Node27) (non-generic case only)
5478 -- Extra_Formals (Node28)
5479 -- Subprograms_For_Type (Node29)
5480 -- Corresponding_Equality (Node30) (implicit /= only)
5481 -- Thunk_Entity (Node31) (thunk case only)
5482 -- SPARK_Pragma (Node32)
5483 -- Contract (Node34)
5484 -- Body_Needed_For_SAL (Flag40)
5485 -- Elaboration_Entity_Required (Flag174)
5486 -- Default_Expressions_Processed (Flag108)
5487 -- Delay_Cleanups (Flag114)
5488 -- Delay_Subprogram_Descriptors (Flag50)
5489 -- Discard_Names (Flag88)
5490 -- Has_Anonymous_Master (Flag253)
5491 -- Has_Completion (Flag26)
5492 -- Has_Controlling_Result (Flag98)
5493 -- Has_Invariants (Flag232)
5494 -- Has_Master_Entity (Flag21)
5495 -- Has_Missing_Return (Flag142)
5496 -- Has_Nested_Block_With_Handler (Flag101)
5497 -- Has_Postconditions (Flag240)
5498 -- Has_Recursive_Call (Flag143)
5499 -- Is_Abstract_Subprogram (Flag19) (non-generic case only)
5500 -- Is_Called (Flag102) (non-generic case only)
5501 -- Is_Constructor (Flag76)
5502 -- Is_Discrim_SO_Function (Flag176)
5503 -- Is_Eliminated (Flag124)
5504 -- Is_Instantiated (Flag126) (generic case only)
5505 -- Is_Intrinsic_Subprogram (Flag64)
5506 -- Is_Invariant_Procedure (Flag257) (non-generic case only)
5507 -- Is_Machine_Code_Subprogram (Flag137) (non-generic case only)
5508 -- Is_Predicate_Function (Flag255) (non-generic case only)
5509 -- Is_Predicate_Function_M (Flag256) (non-generic case only)
5510 -- Is_Primitive (Flag218)
5511 -- Is_Primitive_Wrapper (Flag195) (non-generic case only)
5512 -- Is_Private_Descendant (Flag53)
5513 -- Is_Private_Primitive (Flag245) (non-generic case only)
5514 -- Is_Pure (Flag44)
5515 -- Is_Visible_Lib_Unit (Flag116)
5516 -- Needs_No_Actuals (Flag22)
5517 -- Requires_Overriding (Flag213) (non-generic case only)
5518 -- Return_Present (Flag54)
5519 -- Returns_By_Ref (Flag90)
5520 -- Sec_Stack_Needed_For_Return (Flag167)
5521 -- SPARK_Pragma_Inherited (Flag265)
5522 -- Uses_Sec_Stack (Flag95)
5523 -- Address_Clause (synth)
5524 -- First_Formal (synth)
5525 -- First_Formal_With_Extras (synth)
5526 -- Is_Ghost_Entity (synth) (non-generic case only)
5527 -- Is_Ghost_Subprogram (synth) (non-generic case only)
5528 -- Last_Formal (synth)
5529 -- Number_Formals (synth)
5530 -- Scope_Depth (synth)
5531
5532 -- E_General_Access_Type
5533 -- Storage_Size_Variable (Node15) (base type only)
5534 -- Master_Id (Node17)
5535 -- Directly_Designated_Type (Node20)
5536 -- Associated_Storage_Pool (Node22) (root type only)
5537 -- Finalization_Master (Node23) (root type only)
5538 -- (plus type attributes)
5539
5540 -- E_Generic_In_Parameter
5541 -- E_Generic_In_Out_Parameter
5542 -- Current_Value (Node9) (always Empty)
5543 -- Entry_Component (Node11)
5544 -- Actual_Subtype (Node17)
5545 -- Renamed_Object (Node18) (always Empty)
5546 -- Default_Value (Node20)
5547 -- Protected_Formal (Node22)
5548 -- Is_Controlling_Formal (Flag97)
5549 -- Is_Return_Object (Flag209)
5550 -- Parameter_Mode (synth)
5551
5552 -- E_Incomplete_Type
5553 -- E_Incomplete_Subtype
5554 -- Direct_Primitive_Operations (Elist10)
5555 -- Non_Limited_View (Node17)
5556 -- Private_Dependents (Elist18)
5557 -- Discriminant_Constraint (Elist21)
5558 -- Stored_Constraint (Elist23)
5559 -- (plus type attributes)
5560
5561 -- E_In_Parameter
5562 -- E_In_Out_Parameter
5563 -- E_Out_Parameter
5564 -- Mechanism (Uint8) (Mechanism_Type)
5565 -- Current_Value (Node9)
5566 -- Discriminal_Link (Node10) (discriminals only)
5567 -- Entry_Component (Node11)
5568 -- Esize (Uint12)
5569 -- Extra_Accessibility (Node13)
5570 -- Alignment (Uint14)
5571 -- Extra_Formal (Node15)
5572 -- Unset_Reference (Node16)
5573 -- Actual_Subtype (Node17)
5574 -- Renamed_Object (Node18)
5575 -- Spec_Entity (Node19)
5576 -- Default_Value (Node20)
5577 -- Default_Expr_Function (Node21)
5578 -- Protected_Formal (Node22)
5579 -- Extra_Constrained (Node23)
5580 -- Last_Assignment (Node26) (OUT, IN-OUT only)
5581 -- Has_Initial_Value (Flag219)
5582 -- Is_Controlling_Formal (Flag97)
5583 -- Is_Only_Out_Parameter (Flag226)
5584 -- Is_Optional_Parameter (Flag134)
5585 -- Low_Bound_Tested (Flag205)
5586 -- Is_Return_Object (Flag209)
5587 -- Parameter_Mode (synth)
5588
5589 -- E_Label
5590 -- Enclosing_Scope (Node18)
5591 -- Reachable (Flag49)
5592
5593 -- E_Limited_Private_Type
5594 -- E_Limited_Private_Subtype
5595 -- First_Entity (Node17)
5596 -- Private_Dependents (Elist18)
5597 -- Underlying_Full_View (Node19)
5598 -- Last_Entity (Node20)
5599 -- Discriminant_Constraint (Elist21)
5600 -- Private_View (Node22)
5601 -- Stored_Constraint (Elist23)
5602 -- Has_Completion (Flag26)
5603 -- (plus type attributes)
5604
5605 -- E_Loop
5606 -- First_Exit_Statement (Node8)
5607 -- Has_Exit (Flag47)
5608 -- Has_Loop_Entry_Attributes (Flag260)
5609 -- Has_Master_Entity (Flag21)
5610 -- Has_Nested_Block_With_Handler (Flag101)
5611
5612 -- E_Modular_Integer_Type
5613 -- E_Modular_Integer_Subtype
5614 -- Modulus (Uint17) (base type only)
5615 -- Default_Aspect_Value (Node19) (base type only)
5616 -- Original_Array_Type (Node21)
5617 -- Scalar_Range (Node20)
5618 -- Static_Predicate (List25)
5619 -- Non_Binary_Modulus (Flag58) (base type only)
5620 -- Has_Biased_Representation (Flag139)
5621 -- Type_Low_Bound (synth)
5622 -- Type_High_Bound (synth)
5623 -- (plus type attributes)
5624
5625 -- E_Named_Integer
5626
5627 -- E_Named_Real
5628
5629 -- E_Operator
5630 -- First_Entity (Node17)
5631 -- Alias (Node18)
5632 -- Extra_Accessibility_Of_Result (Node19)
5633 -- Last_Entity (Node20)
5634 -- Overridden_Operation (Node26)
5635 -- Subprograms_For_Type (Node29)
5636 -- Contract (Node34)
5637 -- Has_Invariants (Flag232)
5638 -- Has_Postconditions (Flag240)
5639 -- Is_Machine_Code_Subprogram (Flag137)
5640 -- Is_Pure (Flag44)
5641 -- Is_Intrinsic_Subprogram (Flag64)
5642 -- Is_Primitive (Flag218)
5643 -- Default_Expressions_Processed (Flag108)
5644 -- Aren't there more flags and fields? seems like this list should be
5645 -- more similar to the E_Function list, which is much longer ???
5646
5647 -- E_Ordinary_Fixed_Point_Type
5648 -- E_Ordinary_Fixed_Point_Subtype
5649 -- Delta_Value (Ureal18)
5650 -- Default_Aspect_Value (Node19) (base type only)
5651 -- Scalar_Range (Node20)
5652 -- Small_Value (Ureal21)
5653 -- Has_Small_Clause (Flag67)
5654 -- Aft_Value (synth)
5655 -- Type_Low_Bound (synth)
5656 -- Type_High_Bound (synth)
5657 -- (plus type attributes)
5658
5659 -- E_Package
5660 -- E_Generic_Package
5661 -- Dependent_Instances (Elist8) (for an instance)
5662 -- Renaming_Map (Uint9)
5663 -- Handler_Records (List10) (non-generic case only)
5664 -- Generic_Homonym (Node11) (generic case only)
5665 -- Associated_Formal_Package (Node12)
5666 -- Elaboration_Entity (Node13)
5667 -- Shadow_Entities (List14)
5668 -- Related_Instance (Node15) (non-generic case only)
5669 -- First_Private_Entity (Node16)
5670 -- First_Entity (Node17)
5671 -- Renamed_Entity (Node18)
5672 -- Body_Entity (Node19)
5673 -- Last_Entity (Node20)
5674 -- Interface_Name (Node21)
5675 -- Scope_Depth_Value (Uint22)
5676 -- Generic_Renamings (Elist23) (for an instance)
5677 -- Inner_Instances (Elist23) (generic case only)
5678 -- Limited_View (Node23) (non-generic/instance)
5679 -- Abstract_States (Elist25)
5680 -- Package_Instantiation (Node26)
5681 -- Current_Use_Clause (Node27)
5682 -- Finalizer (Node28) (non-generic case only)
5683 -- SPARK_Aux_Pragma (Node33)
5684 -- SPARK_Pragma (Node32)
5685 -- Contract (Node34)
5686 -- Delay_Subprogram_Descriptors (Flag50)
5687 -- Body_Needed_For_SAL (Flag40)
5688 -- Discard_Names (Flag88)
5689 -- Elaboration_Entity_Required (Flag174)
5690 -- Elaborate_Body_Desirable (Flag210) (non-generic case only)
5691 -- From_Limited_With (Flag159)
5692 -- Has_All_Calls_Remote (Flag79)
5693 -- Has_Anonymous_Master (Flag253)
5694 -- Has_Completion (Flag26)
5695 -- Has_Forward_Instantiation (Flag175)
5696 -- Has_Master_Entity (Flag21)
5697 -- Has_RACW (Flag214) (non-generic case only)
5698 -- In_Package_Body (Flag48)
5699 -- In_Use (Flag8)
5700 -- Is_Instantiated (Flag126)
5701 -- Is_Private_Descendant (Flag53)
5702 -- Is_Visible_Lib_Unit (Flag116)
5703 -- Renamed_In_Spec (Flag231) (non-generic case only)
5704 -- SPARK_Aux_Pragma_Inherited (Flag266)
5705 -- SPARK_Pragma_Inherited (Flag265)
5706 -- Static_Elaboration_Desired (Flag77) (non-generic case only)
5707 -- Has_Null_Abstract_State (synth)
5708 -- Is_Wrapper_Package (synth) (non-generic case only)
5709 -- Scope_Depth (synth)
5710
5711 -- E_Package_Body
5712 -- Handler_Records (List10) (non-generic case only)
5713 -- Related_Instance (Node15) (non-generic case only)
5714 -- First_Entity (Node17)
5715 -- Spec_Entity (Node19)
5716 -- Last_Entity (Node20)
5717 -- Scope_Depth_Value (Uint22)
5718 -- Finalizer (Node28) (non-generic case only)
5719 -- SPARK_Aux_Pragma (Node33)
5720 -- SPARK_Pragma (Node32)
5721 -- Contract (Node34)
5722 -- Delay_Subprogram_Descriptors (Flag50)
5723 -- Has_Anonymous_Master (Flag253)
5724 -- SPARK_Aux_Pragma_Inherited (Flag266)
5725 -- SPARK_Pragma_Inherited (Flag265)
5726 -- Scope_Depth (synth)
5727
5728 -- E_Private_Type
5729 -- E_Private_Subtype
5730 -- Direct_Primitive_Operations (Elist10)
5731 -- First_Entity (Node17)
5732 -- Private_Dependents (Elist18)
5733 -- Underlying_Full_View (Node19)
5734 -- Last_Entity (Node20)
5735 -- Discriminant_Constraint (Elist21)
5736 -- Private_View (Node22)
5737 -- Stored_Constraint (Elist23)
5738 -- Has_Completion (Flag26)
5739 -- Is_Controlled (Flag42) (base type only)
5740 -- Is_For_Access_Subtype (Flag118) (subtype only)
5741 -- (plus type attributes)
5742
5743 -- E_Procedure
5744 -- E_Generic_Procedure
5745 -- Postcondition_Proc (Node8) (non-generic case only)
5746 -- Renaming_Map (Uint9)
5747 -- Handler_Records (List10) (non-generic case only)
5748 -- Protected_Body_Subprogram (Node11)
5749 -- Next_Inlined_Subprogram (Node12)
5750 -- Elaboration_Entity (Node13)
5751 -- First_Optional_Parameter (Node14) (non-generic case only)
5752 -- DT_Position (Uint15)
5753 -- DTC_Entity (Node16)
5754 -- First_Entity (Node17)
5755 -- Alias (Node18) (non-generic case only)
5756 -- Renamed_Entity (Node18) (generic case only)
5757 -- Last_Entity (Node20)
5758 -- Interface_Name (Node21)
5759 -- Scope_Depth_Value (Uint22)
5760 -- Generic_Renamings (Elist23) (for an instance)
5761 -- Inner_Instances (Elist23) (generic case only)
5762 -- Protection_Object (Node23) (for concurrent kind)
5763 -- Interface_Alias (Node25)
5764 -- Overridden_Operation (Node26) (never for init proc)
5765 -- Wrapped_Entity (Node27) (non-generic case only)
5766 -- Extra_Formals (Node28)
5767 -- Static_Initialization (Node30) (init_proc only)
5768 -- Thunk_Entity (Node31) (thunk case only)
5769 -- SPARK_Pragma (Node32)
5770 -- Contract (Node34)
5771 -- Body_Needed_For_SAL (Flag40)
5772 -- Delay_Cleanups (Flag114)
5773 -- Discard_Names (Flag88)
5774 -- Elaboration_Entity_Required (Flag174)
5775 -- Default_Expressions_Processed (Flag108)
5776 -- Delay_Cleanups (Flag114)
5777 -- Delay_Subprogram_Descriptors (Flag50)
5778 -- Discard_Names (Flag88)
5779 -- Has_Anonymous_Master (Flag253)
5780 -- Has_Completion (Flag26)
5781 -- Has_Invariants (Flag232)
5782 -- Has_Master_Entity (Flag21)
5783 -- Has_Nested_Block_With_Handler (Flag101)
5784 -- Has_Postconditions (Flag240)
5785 -- Is_Abstract_Subprogram (Flag19) (non-generic case only)
5786 -- Is_Asynchronous (Flag81)
5787 -- Is_Called (Flag102) (non-generic case only)
5788 -- Is_Constructor (Flag76)
5789 -- Is_Eliminated (Flag124)
5790 -- Is_Instantiated (Flag126) (generic case only)
5791 -- Is_Interrupt_Handler (Flag89)
5792 -- Is_Intrinsic_Subprogram (Flag64)
5793 -- Is_Invariant_Procedure (Flag257) (non-generic case only)
5794 -- Is_Machine_Code_Subprogram (Flag137) (non-generic case only)
5795 -- Is_Null_Init_Proc (Flag178)
5796 -- Is_Predicate_Function (Flag255) (non-generic case only)
5797 -- Is_Predicate_Function_M (Flag256) (non-generic case only)
5798 -- Is_Primitive (Flag218)
5799 -- Is_Primitive_Wrapper (Flag195) (non-generic case only)
5800 -- Is_Private_Descendant (Flag53)
5801 -- Is_Private_Primitive (Flag245) (non-generic case only)
5802 -- Is_Pure (Flag44)
5803 -- Is_Valued_Procedure (Flag127)
5804 -- Is_Visible_Lib_Unit (Flag116)
5805 -- Needs_No_Actuals (Flag22)
5806 -- No_Return (Flag113)
5807 -- Requires_Overriding (Flag213) (non-generic case only)
5808 -- Sec_Stack_Needed_For_Return (Flag167)
5809 -- SPARK_Pragma_Inherited (Flag265)
5810 -- Address_Clause (synth)
5811 -- First_Formal (synth)
5812 -- First_Formal_With_Extras (synth)
5813 -- Is_Finalizer (synth)
5814 -- Is_Ghost_Entity (synth) (non-generic case only)
5815 -- Is_Ghost_Subprogram (synth) (non-generic case only)
5816 -- Last_Formal (synth)
5817 -- Number_Formals (synth)
5818
5819 -- E_Protected_Body
5820 -- (any others??? First/Last Entity, Scope_Depth???)
5821
5822 -- E_Protected_Object
5823
5824 -- E_Protected_Type
5825 -- E_Protected_Subtype
5826 -- Direct_Primitive_Operations (Elist10)
5827 -- Entry_Bodies_Array (Node15)
5828 -- First_Private_Entity (Node16)
5829 -- First_Entity (Node17)
5830 -- Corresponding_Record_Type (Node18)
5831 -- Last_Entity (Node20)
5832 -- Discriminant_Constraint (Elist21)
5833 -- Scope_Depth_Value (Uint22)
5834 -- Scope_Depth (synth)
5835 -- Stored_Constraint (Elist23)
5836 -- Has_Interrupt_Handler (synth)
5837 -- Sec_Stack_Needed_For_Return (Flag167) ???
5838 -- Uses_Lock_Free (Flag188)
5839 -- Uses_Sec_Stack (Flag95) ???
5840 -- Has_Entries (synth)
5841 -- Number_Entries (synth)
5842
5843 -- E_Record_Type
5844 -- E_Record_Subtype
5845 -- Direct_Primitive_Operations (Elist10)
5846 -- Access_Disp_Table (Elist16) (base type only)
5847 -- Cloned_Subtype (Node16) (subtype case only)
5848 -- First_Entity (Node17)
5849 -- Corresponding_Concurrent_Type (Node18)
5850 -- Parent_Subtype (Node19) (base type only)
5851 -- Last_Entity (Node20)
5852 -- Discriminant_Constraint (Elist21)
5853 -- Corresponding_Remote_Type (Node22)
5854 -- Stored_Constraint (Elist23)
5855 -- Interfaces (Elist25)
5856 -- Dispatch_Table_Wrappers (Elist26) (base type only)
5857 -- Underlying_Record_View (Node28) (base type only)
5858 -- Component_Alignment (special) (base type only)
5859 -- C_Pass_By_Copy (Flag125) (base type only)
5860 -- Has_Dispatch_Table (Flag220) (base tagged type only)
5861 -- Has_External_Tag_Rep_Clause (Flag110)
5862 -- Has_Pragma_Pack (Flag121) (impl base type only)
5863 -- Has_Private_Ancestor (Flag151)
5864 -- Has_Record_Rep_Clause (Flag65) (base type only)
5865 -- Has_Static_Discriminants (Flag211) (subtype only)
5866 -- Is_Class_Wide_Equivalent_Type (Flag35)
5867 -- Is_Concurrent_Record_Type (Flag20)
5868 -- Is_Constrained (Flag12)
5869 -- Is_Controlled (Flag42) (base type only)
5870 -- Is_Interface (Flag186)
5871 -- Is_Limited_Interface (Flag197)
5872 -- OK_To_Reorder_Components (Flag239) (base type only)
5873 -- Reverse_Bit_Order (Flag164) (base type only)
5874 -- Reverse_Storage_Order (Flag93) (base type only)
5875 -- First_Component (synth)
5876 -- First_Component_Or_Discriminant (synth)
5877 -- (plus type attributes)
5878
5879 -- E_Record_Type_With_Private
5880 -- E_Record_Subtype_With_Private
5881 -- Direct_Primitive_Operations (Elist10)
5882 -- First_Entity (Node17)
5883 -- Private_Dependents (Elist18)
5884 -- Underlying_Full_View (Node19)
5885 -- Last_Entity (Node20)
5886 -- Discriminant_Constraint (Elist21)
5887 -- Private_View (Node22)
5888 -- Stored_Constraint (Elist23)
5889 -- Interfaces (Elist25)
5890 -- Has_Completion (Flag26)
5891 -- Has_Private_Ancestor (Flag151)
5892 -- Has_Record_Rep_Clause (Flag65) (base type only)
5893 -- Has_External_Tag_Rep_Clause (Flag110)
5894 -- Is_Concurrent_Record_Type (Flag20)
5895 -- Is_Constrained (Flag12)
5896 -- Is_Controlled (Flag42) (base type only)
5897 -- Is_Interface (Flag186)
5898 -- Is_Limited_Interface (Flag197)
5899 -- OK_To_Reorder_Components (Flag239) (base type only)
5900 -- Reverse_Bit_Order (Flag164) (base type only)
5901 -- Reverse_Storage_Order (Flag93) (base type only)
5902 -- First_Component (synth)
5903 -- First_Component_Or_Discriminant (synth)
5904 -- (plus type attributes)
5905
5906 -- E_Return_Statement
5907 -- Return_Applies_To (Node8)
5908
5909 -- E_Signed_Integer_Type
5910 -- E_Signed_Integer_Subtype
5911 -- Default_Aspect_Value (Node19) (base type only)
5912 -- Scalar_Range (Node20)
5913 -- Static_Predicate (List25)
5914 -- Has_Biased_Representation (Flag139)
5915 -- Type_Low_Bound (synth)
5916 -- Type_High_Bound (synth)
5917 -- (plus type attributes)
5918
5919 -- E_String_Type
5920 -- E_String_Subtype
5921 -- First_Index (Node17)
5922 -- Component_Type (Node20) (base type only)
5923 -- Is_Constrained (Flag12)
5924 -- Next_Index (synth)
5925 -- Number_Dimensions (synth)
5926 -- (plus type attributes)
5927
5928 -- E_String_Literal_Subtype
5929 -- String_Literal_Low_Bound (Node15)
5930 -- String_Literal_Length (Uint16)
5931 -- First_Index (Node17) (always Empty)
5932 -- Packed_Array_Type (Node23)
5933 -- (plus type attributes)
5934
5935 -- E_Subprogram_Body
5936 -- Mechanism (Uint8)
5937 -- First_Entity (Node17)
5938 -- Corresponding_Protected_Entry (Node18)
5939 -- Last_Entity (Node20)
5940 -- Scope_Depth_Value (Uint22)
5941 -- Extra_Formals (Node28)
5942 -- SPARK_Pragma (Node32)
5943 -- SPARK_Pragma_Inherited (Flag265)
5944 -- Contract (Node34)
5945 -- Scope_Depth (synth)
5946
5947 -- E_Subprogram_Type
5948 -- Extra_Accessibility_Of_Result (Node19)
5949 -- Directly_Designated_Type (Node20)
5950 -- Extra_Formals (Node28)
5951 -- First_Formal (synth)
5952 -- First_Formal_With_Extras (synth)
5953 -- Last_Formal (synth)
5954 -- Number_Formals (synth)
5955 -- (plus type attributes)
5956
5957 -- E_Task_Body
5958 -- (any others??? First/Last Entity, Scope_Depth???)
5959
5960 -- E_Task_Type
5961 -- E_Task_Subtype
5962 -- Direct_Primitive_Operations (Elist10)
5963 -- Storage_Size_Variable (Node15) (base type only)
5964 -- First_Private_Entity (Node16)
5965 -- First_Entity (Node17)
5966 -- Corresponding_Record_Type (Node18)
5967 -- Last_Entity (Node20)
5968 -- Discriminant_Constraint (Elist21)
5969 -- Scope_Depth_Value (Uint22)
5970 -- Scope_Depth (synth)
5971 -- Stored_Constraint (Elist23)
5972 -- Task_Body_Procedure (Node25)
5973 -- Delay_Cleanups (Flag114)
5974 -- Has_Master_Entity (Flag21)
5975 -- Has_Storage_Size_Clause (Flag23) (base type only)
5976 -- Uses_Sec_Stack (Flag95) ???
5977 -- Sec_Stack_Needed_For_Return (Flag167) ???
5978 -- Has_Entries (synth)
5979 -- Number_Entries (synth)
5980 -- Relative_Deadline_Variable (Node26) (base type only)
5981 -- (plus type attributes)
5982
5983 -- E_Variable
5984 -- Hiding_Loop_Variable (Node8)
5985 -- Current_Value (Node9)
5986 -- Refined_State (Node10)
5987 -- Esize (Uint12)
5988 -- Extra_Accessibility (Node13)
5989 -- Alignment (Uint14)
5990 -- Status_Flag_Or_Transient_Decl (Node15) (transient object only)
5991 -- Unset_Reference (Node16)
5992 -- Actual_Subtype (Node17)
5993 -- Renamed_Object (Node18)
5994 -- Size_Check_Code (Node19)
5995 -- Prival_Link (Node20)
5996 -- Interface_Name (Node21)
5997 -- Shared_Var_Procs_Instance (Node22)
5998 -- Extra_Constrained (Node23)
5999 -- Related_Expression (Node24)
6000 -- Debug_Renaming_Link (Node25)
6001 -- Last_Assignment (Node26)
6002 -- Related_Type (Node27)
6003 -- Initialization_Statements (Node28)
6004 -- Contract (Node34)
6005 -- Has_Alignment_Clause (Flag46)
6006 -- Has_Atomic_Components (Flag86)
6007 -- Has_Biased_Representation (Flag139)
6008 -- Has_Independent_Components (Flag34) (base type only)
6009 -- Has_Initial_Value (Flag219)
6010 -- Has_Size_Clause (Flag29)
6011 -- Has_Up_Level_Access (Flag215)
6012 -- Has_Volatile_Components (Flag87)
6013 -- Is_Atomic (Flag85)
6014 -- Is_Eliminated (Flag124)
6015 -- Is_Processed_Transient (Flag252)
6016 -- Is_Safe_To_Reevaluate (Flag249)
6017 -- Is_Shared_Passive (Flag60)
6018 -- Is_True_Constant (Flag163)
6019 -- Is_Volatile (Flag16)
6020 -- Is_Return_Object (Flag209)
6021 -- OK_To_Rename (Flag247)
6022 -- Optimize_Alignment_Space (Flag241)
6023 -- Optimize_Alignment_Time (Flag242)
6024 -- Treat_As_Volatile (Flag41)
6025 -- Address_Clause (synth)
6026 -- Alignment_Clause (synth)
6027 -- Is_Ghost_Entity (synth)
6028 -- Size_Clause (synth)
6029
6030 -- E_Void
6031 -- Since E_Void is the initial Ekind value of an entity when it is first
6032 -- created, one might expect that no attributes would be defined on such
6033 -- an entity until its Ekind field is set. However, in practice, there
6034 -- are many instances in which fields of an E_Void entity are set in the
6035 -- code prior to setting the Ekind field. This is not well documented or
6036 -- well controlled, and needs cleaning up later. Meanwhile, the access
6037 -- procedures in the body of Einfo permit many, but not all, attributes
6038 -- to be applied to an E_Void entity, precisely so that this kind of
6039 -- pre-setting of attributes works. This is really a hole in the dynamic
6040 -- type checking, since there is no assurance that the eventual Ekind
6041 -- value will be appropriate for the attributes set, and the consequence
6042 -- is that the dynamic type checking in the Einfo body is unnecessarily
6043 -- weak. To be looked at systematically some time ???
6044
6045 ---------------------------------
6046 -- Component_Alignment Control --
6047 ---------------------------------
6048
6049 -- There are four types of alignment possible for array and record
6050 -- types, and a field in the type entities contains a value of the
6051 -- following type indicating which alignment choice applies. For full
6052 -- details of the meaning of these alignment types, see description
6053 -- of the Component_Alignment pragma
6054
6055 type Component_Alignment_Kind is (
6056 Calign_Default, -- default alignment
6057 Calign_Component_Size, -- natural alignment for component size
6058 Calign_Component_Size_4, -- natural for size <= 4, 4 for size >= 4
6059 Calign_Storage_Unit); -- all components byte aligned
6060
6061 -----------------------------------
6062 -- Floating Point Representation --
6063 -----------------------------------
6064
6065 type Float_Rep_Kind is (
6066 IEEE_Binary, -- IEEE 754p conform binary format
6067 VAX_Native, -- VAX D, F, G or H format
6068 AAMP); -- AAMP format
6069
6070 ---------------
6071 -- Iterators --
6072 ---------------
6073
6074 -- In addition to attributes that are stored as plain data, other
6075 -- attributes are procedural, and require some small amount of
6076 -- computation. Of course, from the point of view of a user of this
6077 -- package, the distinction is not visible (even the field information
6078 -- provided below should be disregarded, as it is subject to change
6079 -- without notice!). A number of attributes appear as lists: lists of
6080 -- formals, lists of actuals, of discriminants, etc. For these, pairs
6081 -- of functions are defined, which take the form:
6082
6083 -- function First_Thing (E : Enclosing_Construct) return Thing;
6084 -- function Next_Thing (T : Thing) return Thing;
6085
6086 -- The end of iteration is always signaled by a value of Empty, so that
6087 -- loops over these chains invariably have the form:
6088
6089 -- This : Thing;
6090 -- ...
6091 -- This := First_Thing (E);
6092
6093 -- while Present (This) loop
6094 -- Do_Something_With (This);
6095 -- ...
6096 -- This := Next_Thing (This);
6097 -- end loop;
6098
6099 -----------------------------------
6100 -- Handling of Check Suppression --
6101 -----------------------------------
6102
6103 -- There are three ways that checks can be suppressed:
6104
6105 -- 1. At the command line level
6106 -- 2. At the scope level.
6107 -- 3. At the entity level.
6108
6109 -- See spec of Sem in sem.ads for details of the data structures used
6110 -- to keep track of these various methods for suppressing checks.
6111
6112 -------------------------------
6113 -- Handling of Discriminants --
6114 -------------------------------
6115
6116 -- During semantic processing, discriminants are separate entities which
6117 -- reflect the semantic properties and allowed usage of discriminants in
6118 -- the language.
6119
6120 -- In the case of discriminants used as bounds, the references are handled
6121 -- directly, since special processing is needed in any case. However, there
6122 -- are two circumstances in which discriminants are referenced in a quite
6123 -- general manner, like any other variables:
6124
6125 -- In initialization expressions for records. Note that the expressions
6126 -- used in Priority, Storage_Size, Task_Info and Relative_Deadline
6127 -- pragmas are effectively in this category, since these pragmas are
6128 -- converted to initialized record fields in the Corresponding_Record_
6129 -- Type.
6130
6131 -- In task and protected bodies, where the discriminant values may be
6132 -- referenced freely within these bodies. Discriminants can also appear
6133 -- in bounds of entry families and in defaults of operations.
6134
6135 -- In both these cases, the discriminants must be treated essentially as
6136 -- objects. The following approach is used to simplify and minimize the
6137 -- special processing that is required.
6138
6139 -- When a record type with discriminants is analyzed, semantic processing
6140 -- creates the entities for the discriminants. It also creates additional
6141 -- sets of entities called discriminals, one for each of the discriminants,
6142 -- and the Discriminal field of the discriminant entity points to this
6143 -- additional entity, which is initially created as an uninitialized
6144 -- (E_Void) entity.
6145
6146 -- During expansion of expressions, any discriminant reference is replaced
6147 -- by a reference to the corresponding discriminal. When the initialization
6148 -- procedure for the record is created (there will always be one, since
6149 -- discriminants are present, see Exp_Ch3 for further details), the
6150 -- discriminals are used as the entities for the formal parameters of
6151 -- this initialization procedure. The references to these discriminants
6152 -- have already been replaced by references to these discriminals, which
6153 -- are now the formal parameters corresponding to the required objects.
6154
6155 -- In the case of a task or protected body, the semantics similarly creates
6156 -- a set of discriminals for the discriminants of the task or protected
6157 -- type. When the procedure is created for the task body, the parameter
6158 -- passed in is a reference to the task value type, which contains the
6159 -- required discriminant values. The expander creates a set of declarations
6160 -- of the form:
6161
6162 -- discr_nameD : constant discr_type renames _task.discr_name;
6163
6164 -- where discr_nameD is the discriminal entity referenced by the task
6165 -- discriminant, and _task is the task value passed in as the parameter.
6166 -- Again, any references to discriminants in the task body have been
6167 -- replaced by the discriminal reference, which is now an object that
6168 -- contains the required value.
6169
6170 -- This approach for tasks means that two sets of discriminals are needed
6171 -- for a task type, one for the initialization procedure, and one for the
6172 -- task body. This works out nicely, since the semantics allocates one set
6173 -- for the task itself, and one set for the corresponding record.
6174
6175 -- The one bit of trickiness arises in making sure that the right set of
6176 -- discriminals is used at the right time. First the task definition is
6177 -- processed. Any references to discriminants here are replaced by the
6178 -- corresponding *task* discriminals (the record type doesn't even exist
6179 -- yet, since it is constructed as part of the expansion of the task
6180 -- declaration, which happens after the semantic processing of the task
6181 -- definition). The discriminants to be used for the corresponding record
6182 -- are created at the same time as the other discriminals, and held in the
6183 -- CR_Discriminant field of the discriminant. A use of the discriminant in
6184 -- a bound for an entry family is replaced with the CR_Discriminant because
6185 -- it controls the bound of the entry queue array which is a component of
6186 -- the corresponding record.
6187
6188 -- Just before the record initialization routine is constructed, the
6189 -- expander exchanges the task and record discriminals. This has two
6190 -- effects. First the generation of the record initialization routine
6191 -- uses the discriminals that are now on the record, which is the set
6192 -- that used to be on the task, which is what we want.
6193
6194 -- Second, a new set of (so far unused) discriminals is now on the task
6195 -- discriminants, and it is this set that will be used for expanding the
6196 -- task body, and also for the discriminal declarations at the start of
6197 -- the task body.
6198
6199 ---------------------------------------------------
6200 -- Handling of private data in protected objects --
6201 ---------------------------------------------------
6202
6203 -- Private components in protected types pose problems similar to those
6204 -- of discriminants. Private data is visible and can be directly referenced
6205 -- from protected bodies. However, when protected entries and subprograms
6206 -- are expanded into corresponding bodies and barrier functions, private
6207 -- components lose their original context and visibility.
6208
6209 -- To remedy this side effect of expansion, private components are expanded
6210 -- into renamings called "privals", by analogy with "discriminals".
6211
6212 -- private_comp : comp_type renames _object.private_comp;
6213
6214 -- Prival declarations are inserted during the analysis of subprogram and
6215 -- entry bodies to ensure proper visibility for any subsequent expansion.
6216 -- _Object is the formal parameter of the generated corresponding body or
6217 -- a local renaming which denotes the protected object obtained from entry
6218 -- parameter _O. Privals receive minimal decoration upon creation and are
6219 -- categorized as either E_Variable for the general case or E_Constant when
6220 -- they appear in functions.
6221
6222 -- Along with the local declarations, each private component carries a
6223 -- placeholder which references the prival entity in the current body. This
6224 -- form of indirection is used to resolve name clashes of privals and other
6225 -- locally visible entities such as parameters, local objects, entry family
6226 -- indexes or identifiers used in the barrier condition.
6227
6228 -- When analyzing the statements of a protected subprogram or entry, any
6229 -- reference to a private component must resolve to the locally declared
6230 -- prival through normal visibility. In case of name conflicts (the cases
6231 -- above), the prival is marked as hidden and acts as a weakly declared
6232 -- entity. As a result, the reference points to the correct entity. When a
6233 -- private component is denoted by an expanded name (prot_type.comp for
6234 -- example), the expansion mechanism uses the placeholder of the component
6235 -- to correct the Entity and Etype of the reference.
6236
6237 -------------------
6238 -- Type Synonyms --
6239 -------------------
6240
6241 -- The following type synonyms are used to tidy up the function and
6242 -- procedure declarations that follow, and also to make it possible to meet
6243 -- the requirement for the XEINFO utility that all function specs must fit
6244 -- on a single source line.
6245
6246 subtype B is Boolean;
6247 subtype C is Component_Alignment_Kind;
6248 subtype E is Entity_Id;
6249 subtype F is Float_Rep_Kind;
6250 subtype M is Mechanism_Type;
6251 subtype N is Node_Id;
6252 subtype U is Uint;
6253 subtype R is Ureal;
6254 subtype L is Elist_Id;
6255 subtype S is List_Id;
6256
6257 --------------------------------
6258 -- Attribute Access Functions --
6259 --------------------------------
6260
6261 -- All attributes are manipulated through a procedural interface. This
6262 -- section contains the functions used to obtain attribute values which
6263 -- correspond to values in fields or flags in the entity itself.
6264
6265 function Abstract_States (Id : E) return L;
6266 function Accept_Address (Id : E) return L;
6267 function Access_Disp_Table (Id : E) return L;
6268 function Actual_Subtype (Id : E) return E;
6269 function Address_Taken (Id : E) return B;
6270 function Alias (Id : E) return E;
6271 function Alignment (Id : E) return U;
6272 function Associated_Formal_Package (Id : E) return E;
6273 function Associated_Node_For_Itype (Id : E) return N;
6274 function Associated_Storage_Pool (Id : E) return E;
6275 function Barrier_Function (Id : E) return N;
6276 function Block_Node (Id : E) return N;
6277 function Body_Entity (Id : E) return E;
6278 function Body_Needed_For_SAL (Id : E) return B;
6279 function Body_References (Id : E) return L;
6280 function CR_Discriminant (Id : E) return E;
6281 function C_Pass_By_Copy (Id : E) return B;
6282 function Can_Never_Be_Null (Id : E) return B;
6283 function Can_Use_Internal_Rep (Id : E) return B;
6284 function Checks_May_Be_Suppressed (Id : E) return B;
6285 function Class_Wide_Type (Id : E) return E;
6286 function Cloned_Subtype (Id : E) return E;
6287 function Component_Alignment (Id : E) return C;
6288 function Component_Bit_Offset (Id : E) return U;
6289 function Component_Clause (Id : E) return N;
6290 function Component_Size (Id : E) return U;
6291 function Component_Type (Id : E) return E;
6292 function Contract (Id : E) return N;
6293 function Corresponding_Concurrent_Type (Id : E) return E;
6294 function Corresponding_Discriminant (Id : E) return E;
6295 function Corresponding_Equality (Id : E) return E;
6296 function Corresponding_Protected_Entry (Id : E) return E;
6297 function Corresponding_Record_Type (Id : E) return E;
6298 function Corresponding_Remote_Type (Id : E) return E;
6299 function Current_Use_Clause (Id : E) return E;
6300 function Current_Value (Id : E) return N;
6301 function DTC_Entity (Id : E) return E;
6302 function DT_Entry_Count (Id : E) return U;
6303 function DT_Offset_To_Top_Func (Id : E) return E;
6304 function DT_Position (Id : E) return U;
6305 function Debug_Info_Off (Id : E) return B;
6306 function Debug_Renaming_Link (Id : E) return E;
6307 function Default_Aspect_Component_Value (Id : E) return N;
6308 function Default_Aspect_Value (Id : E) return N;
6309 function Default_Expr_Function (Id : E) return E;
6310 function Default_Expressions_Processed (Id : E) return B;
6311 function Default_Value (Id : E) return N;
6312 function Delay_Cleanups (Id : E) return B;
6313 function Delay_Subprogram_Descriptors (Id : E) return B;
6314 function Delta_Value (Id : E) return R;
6315 function Dependent_Instances (Id : E) return L;
6316 function Depends_On_Private (Id : E) return B;
6317 function Digits_Value (Id : E) return U;
6318 function Direct_Primitive_Operations (Id : E) return L;
6319 function Directly_Designated_Type (Id : E) return E;
6320 function Discard_Names (Id : E) return B;
6321 function Discriminal (Id : E) return E;
6322 function Discriminal_Link (Id : E) return E;
6323 function Discriminant_Checking_Func (Id : E) return E;
6324 function Discriminant_Constraint (Id : E) return L;
6325 function Discriminant_Default_Value (Id : E) return N;
6326 function Discriminant_Number (Id : E) return U;
6327 function Dispatch_Table_Wrappers (Id : E) return L;
6328 function Elaborate_Body_Desirable (Id : E) return B;
6329 function Elaboration_Entity (Id : E) return E;
6330 function Elaboration_Entity_Required (Id : E) return B;
6331 function Enclosing_Scope (Id : E) return E;
6332 function Entry_Accepted (Id : E) return B;
6333 function Entry_Bodies_Array (Id : E) return E;
6334 function Entry_Cancel_Parameter (Id : E) return E;
6335 function Entry_Component (Id : E) return E;
6336 function Entry_Formal (Id : E) return E;
6337 function Entry_Index_Constant (Id : E) return E;
6338 function Entry_Index_Type (Id : E) return E;
6339 function Entry_Parameters_Type (Id : E) return E;
6340 function Enum_Pos_To_Rep (Id : E) return E;
6341 function Enumeration_Pos (Id : E) return U;
6342 function Enumeration_Rep (Id : E) return U;
6343 function Enumeration_Rep_Expr (Id : E) return N;
6344 function Equivalent_Type (Id : E) return E;
6345 function Esize (Id : E) return U;
6346 function Exception_Code (Id : E) return U;
6347 function Extra_Accessibility (Id : E) return E;
6348 function Extra_Accessibility_Of_Result (Id : E) return E;
6349 function Extra_Constrained (Id : E) return E;
6350 function Extra_Formal (Id : E) return E;
6351 function Extra_Formals (Id : E) return E;
6352 function Finalization_Master (Id : E) return E;
6353 function Finalize_Storage_Only (Id : E) return B;
6354 function Finalizer (Id : E) return E;
6355 function First_Entity (Id : E) return E;
6356 function First_Exit_Statement (Id : E) return N;
6357 function First_Index (Id : E) return N;
6358 function First_Literal (Id : E) return E;
6359 function First_Optional_Parameter (Id : E) return E;
6360 function First_Private_Entity (Id : E) return E;
6361 function First_Rep_Item (Id : E) return N;
6362 function Float_Rep (Id : E) return F;
6363 function Freeze_Node (Id : E) return N;
6364 function From_Limited_With (Id : E) return B;
6365 function Full_View (Id : E) return E;
6366 function Generic_Homonym (Id : E) return E;
6367 function Generic_Renamings (Id : E) return L;
6368 function Handler_Records (Id : E) return S;
6369 function Has_Aliased_Components (Id : E) return B;
6370 function Has_Alignment_Clause (Id : E) return B;
6371 function Has_All_Calls_Remote (Id : E) return B;
6372 function Has_Anonymous_Master (Id : E) return B;
6373 function Has_Atomic_Components (Id : E) return B;
6374 function Has_Biased_Representation (Id : E) return B;
6375 function Has_Body_References (Id : E) return B;
6376 function Has_Completion (Id : E) return B;
6377 function Has_Completion_In_Body (Id : E) return B;
6378 function Has_Complex_Representation (Id : E) return B;
6379 function Has_Component_Size_Clause (Id : E) return B;
6380 function Has_Constrained_Partial_View (Id : E) return B;
6381 function Has_Contiguous_Rep (Id : E) return B;
6382 function Has_Controlled_Component (Id : E) return B;
6383 function Has_Controlling_Result (Id : E) return B;
6384 function Has_Convention_Pragma (Id : E) return B;
6385 function Has_Default_Aspect (Id : E) return B;
6386 function Has_Delayed_Aspects (Id : E) return B;
6387 function Has_Delayed_Freeze (Id : E) return B;
6388 function Has_Delayed_Rep_Aspects (Id : E) return B;
6389 function Has_Discriminants (Id : E) return B;
6390 function Has_Dispatch_Table (Id : E) return B;
6391 function Has_Dynamic_Predicate_Aspect (Id : E) return B;
6392 function Has_Enumeration_Rep_Clause (Id : E) return B;
6393 function Has_Exit (Id : E) return B;
6394 function Has_External_Tag_Rep_Clause (Id : E) return B;
6395 function Has_Forward_Instantiation (Id : E) return B;
6396 function Has_Fully_Qualified_Name (Id : E) return B;
6397 function Has_Gigi_Rep_Item (Id : E) return B;
6398 function Has_Homonym (Id : E) return B;
6399 function Has_Implicit_Dereference (Id : E) return B;
6400 function Has_Independent_Components (Id : E) return B;
6401 function Has_Inheritable_Invariants (Id : E) return B;
6402 function Has_Initial_Value (Id : E) return B;
6403 function Has_Interrupt_Handler (Id : E) return B;
6404 function Has_Invariants (Id : E) return B;
6405 function Has_Loop_Entry_Attributes (Id : E) return B;
6406 function Has_Machine_Radix_Clause (Id : E) return B;
6407 function Has_Master_Entity (Id : E) return B;
6408 function Has_Missing_Return (Id : E) return B;
6409 function Has_Nested_Block_With_Handler (Id : E) return B;
6410 function Has_Non_Standard_Rep (Id : E) return B;
6411 function Has_Object_Size_Clause (Id : E) return B;
6412 function Has_Per_Object_Constraint (Id : E) return B;
6413 function Has_Postconditions (Id : E) return B;
6414 function Has_Pragma_Controlled (Id : E) return B;
6415 function Has_Pragma_Elaborate_Body (Id : E) return B;
6416 function Has_Pragma_Inline (Id : E) return B;
6417 function Has_Pragma_Inline_Always (Id : E) return B;
6418 function Has_Pragma_No_Inline (Id : E) return B;
6419 function Has_Pragma_Ordered (Id : E) return B;
6420 function Has_Pragma_Pack (Id : E) return B;
6421 function Has_Pragma_Preelab_Init (Id : E) return B;
6422 function Has_Pragma_Pure (Id : E) return B;
6423 function Has_Pragma_Pure_Function (Id : E) return B;
6424 function Has_Pragma_Thread_Local_Storage (Id : E) return B;
6425 function Has_Pragma_Unmodified (Id : E) return B;
6426 function Has_Pragma_Unreferenced (Id : E) return B;
6427 function Has_Pragma_Unreferenced_Objects (Id : E) return B;
6428 function Has_Predicates (Id : E) return B;
6429 function Has_Primitive_Operations (Id : E) return B;
6430 function Has_Private_Ancestor (Id : E) return B;
6431 function Has_Private_Declaration (Id : E) return B;
6432 function Has_Qualified_Name (Id : E) return B;
6433 function Has_RACW (Id : E) return B;
6434 function Has_Record_Rep_Clause (Id : E) return B;
6435 function Has_Recursive_Call (Id : E) return B;
6436 function Has_Size_Clause (Id : E) return B;
6437 function Has_Small_Clause (Id : E) return B;
6438 function Has_Specified_Layout (Id : E) return B;
6439 function Has_Specified_Stream_Input (Id : E) return B;
6440 function Has_Specified_Stream_Output (Id : E) return B;
6441 function Has_Specified_Stream_Read (Id : E) return B;
6442 function Has_Specified_Stream_Write (Id : E) return B;
6443 function Has_Static_Discriminants (Id : E) return B;
6444 function Has_Static_Predicate_Aspect (Id : E) return B;
6445 function Has_Storage_Size_Clause (Id : E) return B;
6446 function Has_Stream_Size_Clause (Id : E) return B;
6447 function Has_Task (Id : E) return B;
6448 function Has_Thunks (Id : E) return B;
6449 function Has_Unchecked_Union (Id : E) return B;
6450 function Has_Unknown_Discriminants (Id : E) return B;
6451 function Has_Up_Level_Access (Id : E) return B;
6452 function Has_Visible_Refinement (Id : E) return B;
6453 function Has_Volatile_Components (Id : E) return B;
6454 function Has_Xref_Entry (Id : E) return B;
6455 function Hiding_Loop_Variable (Id : E) return E;
6456 function Homonym (Id : E) return E;
6457 function In_Package_Body (Id : E) return B;
6458 function In_Private_Part (Id : E) return B;
6459 function In_Use (Id : E) return B;
6460 function Initialization_Statements (Id : E) return N;
6461 function Inner_Instances (Id : E) return L;
6462 function Interface_Alias (Id : E) return E;
6463 function Interface_Name (Id : E) return N;
6464 function Interfaces (Id : E) return L;
6465 function Is_AST_Entry (Id : E) return B;
6466 function Is_Abstract_Subprogram (Id : E) return B;
6467 function Is_Abstract_Type (Id : E) return B;
6468 function Is_Access_Constant (Id : E) return B;
6469 function Is_Ada_2005_Only (Id : E) return B;
6470 function Is_Ada_2012_Only (Id : E) return B;
6471 function Is_Aliased (Id : E) return B;
6472 function Is_Asynchronous (Id : E) return B;
6473 function Is_Atomic (Id : E) return B;
6474 function Is_Bit_Packed_Array (Id : E) return B;
6475 function Is_CPP_Class (Id : E) return B;
6476 function Is_Called (Id : E) return B;
6477 function Is_Character_Type (Id : E) return B;
6478 function Is_Child_Unit (Id : E) return B;
6479 function Is_Class_Wide_Equivalent_Type (Id : E) return B;
6480 function Is_Compilation_Unit (Id : E) return B;
6481 function Is_Completely_Hidden (Id : E) return B;
6482 function Is_Constr_Subt_For_UN_Aliased (Id : E) return B;
6483 function Is_Constr_Subt_For_U_Nominal (Id : E) return B;
6484 function Is_Constrained (Id : E) return B;
6485 function Is_Constructor (Id : E) return B;
6486 function Is_Controlled (Id : E) return B;
6487 function Is_Controlling_Formal (Id : E) return B;
6488 function Is_Descendent_Of_Address (Id : E) return B;
6489 function Is_Discrim_SO_Function (Id : E) return B;
6490 function Is_Dispatch_Table_Entity (Id : E) return B;
6491 function Is_Dispatching_Operation (Id : E) return B;
6492 function Is_Eliminated (Id : E) return B;
6493 function Is_Entry_Formal (Id : E) return B;
6494 function Is_Exported (Id : E) return B;
6495 function Is_First_Subtype (Id : E) return B;
6496 function Is_For_Access_Subtype (Id : E) return B;
6497 function Is_Frozen (Id : E) return B;
6498 function Is_Generic_Instance (Id : E) return B;
6499 function Is_Hidden (Id : E) return B;
6500 function Is_Hidden_Open_Scope (Id : E) return B;
6501 function Is_Immediately_Visible (Id : E) return B;
6502 function Is_Implementation_Defined (Id : E) return B;
6503 function Is_Imported (Id : E) return B;
6504 function Is_Inlined (Id : E) return B;
6505 function Is_Instantiated (Id : E) return B;
6506 function Is_Interface (Id : E) return B;
6507 function Is_Internal (Id : E) return B;
6508 function Is_Interrupt_Handler (Id : E) return B;
6509 function Is_Intrinsic_Subprogram (Id : E) return B;
6510 function Is_Invariant_Procedure (Id : E) return B;
6511 function Is_Itype (Id : E) return B;
6512 function Is_Known_Non_Null (Id : E) return B;
6513 function Is_Known_Null (Id : E) return B;
6514 function Is_Known_Valid (Id : E) return B;
6515 function Is_Limited_Composite (Id : E) return B;
6516 function Is_Limited_Interface (Id : E) return B;
6517 function Is_Local_Anonymous_Access (Id : E) return B;
6518 function Is_Machine_Code_Subprogram (Id : E) return B;
6519 function Is_Non_Static_Subtype (Id : E) return B;
6520 function Is_Null_Init_Proc (Id : E) return B;
6521 function Is_Obsolescent (Id : E) return B;
6522 function Is_Only_Out_Parameter (Id : E) return B;
6523 function Is_Optional_Parameter (Id : E) return B;
6524 function Is_Package_Body_Entity (Id : E) return B;
6525 function Is_Packed (Id : E) return B;
6526 function Is_Packed_Array_Type (Id : E) return B;
6527 function Is_Potentially_Use_Visible (Id : E) return B;
6528 function Is_Predicate_Function (Id : E) return B;
6529 function Is_Predicate_Function_M (Id : E) return B;
6530 function Is_Preelaborated (Id : E) return B;
6531 function Is_Primitive (Id : E) return B;
6532 function Is_Primitive_Wrapper (Id : E) return B;
6533 function Is_Private_Composite (Id : E) return B;
6534 function Is_Private_Descendant (Id : E) return B;
6535 function Is_Private_Primitive (Id : E) return B;
6536 function Is_Processed_Transient (Id : E) return B;
6537 function Is_Public (Id : E) return B;
6538 function Is_Pure (Id : E) return B;
6539 function Is_Pure_Unit_Access_Type (Id : E) return B;
6540 function Is_RACW_Stub_Type (Id : E) return B;
6541 function Is_Raised (Id : E) return B;
6542 function Is_Remote_Call_Interface (Id : E) return B;
6543 function Is_Remote_Types (Id : E) return B;
6544 function Is_Renaming_Of_Object (Id : E) return B;
6545 function Is_Return_Object (Id : E) return B;
6546 function Is_Safe_To_Reevaluate (Id : E) return B;
6547 function Is_Shared_Passive (Id : E) return B;
6548 function Is_Statically_Allocated (Id : E) return B;
6549 function Is_Tag (Id : E) return B;
6550 function Is_Tagged_Type (Id : E) return B;
6551 function Is_Thunk (Id : E) return B;
6552 function Is_Trivial_Subprogram (Id : E) return B;
6553 function Is_True_Constant (Id : E) return B;
6554 function Is_Unchecked_Union (Id : E) return B;
6555 function Is_Underlying_Record_View (Id : E) return B;
6556 function Is_Unsigned_Type (Id : E) return B;
6557 function Is_VMS_Exception (Id : E) return B;
6558 function Is_Valued_Procedure (Id : E) return B;
6559 function Is_Visible_Formal (Id : E) return B;
6560 function Is_Visible_Lib_Unit (Id : E) return B;
6561 function Is_Volatile (Id : E) return B;
6562 function Itype_Printed (Id : E) return B;
6563 function Kill_Elaboration_Checks (Id : E) return B;
6564 function Kill_Range_Checks (Id : E) return B;
6565 function Known_To_Have_Preelab_Init (Id : E) return B;
6566 function Last_Assignment (Id : E) return N;
6567 function Last_Entity (Id : E) return E;
6568 function Limited_View (Id : E) return E;
6569 function Lit_Indexes (Id : E) return E;
6570 function Lit_Strings (Id : E) return E;
6571 function Low_Bound_Tested (Id : E) return B;
6572 function Machine_Radix_10 (Id : E) return B;
6573 function Master_Id (Id : E) return E;
6574 function Materialize_Entity (Id : E) return B;
6575 function May_Inherit_Delayed_Rep_Aspects (Id : E) return B;
6576 function Mechanism (Id : E) return M;
6577 function Modulus (Id : E) return U;
6578 function Must_Be_On_Byte_Boundary (Id : E) return B;
6579 function Must_Have_Preelab_Init (Id : E) return B;
6580 function Needs_Debug_Info (Id : E) return B;
6581 function Needs_No_Actuals (Id : E) return B;
6582 function Never_Set_In_Source (Id : E) return B;
6583 function Next_Inlined_Subprogram (Id : E) return E;
6584 function No_Pool_Assigned (Id : E) return B;
6585 function No_Return (Id : E) return B;
6586 function No_Strict_Aliasing (Id : E) return B;
6587 function Non_Binary_Modulus (Id : E) return B;
6588 function Non_Limited_View (Id : E) return E;
6589 function Nonzero_Is_True (Id : E) return B;
6590 function Normalized_First_Bit (Id : E) return U;
6591 function Normalized_Position (Id : E) return U;
6592 function Normalized_Position_Max (Id : E) return U;
6593 function OK_To_Rename (Id : E) return B;
6594 function OK_To_Reorder_Components (Id : E) return B;
6595 function Optimize_Alignment_Space (Id : E) return B;
6596 function Optimize_Alignment_Time (Id : E) return B;
6597 function Original_Access_Type (Id : E) return E;
6598 function Original_Array_Type (Id : E) return E;
6599 function Original_Record_Component (Id : E) return E;
6600 function Overlays_Constant (Id : E) return B;
6601 function Overridden_Operation (Id : E) return E;
6602 function PPC_Wrapper (Id : E) return E;
6603 function Package_Instantiation (Id : E) return N;
6604 function Packed_Array_Type (Id : E) return E;
6605 function Parent_Subtype (Id : E) return E;
6606 function Postcondition_Proc (Id : E) return E;
6607 function Prival (Id : E) return E;
6608 function Prival_Link (Id : E) return E;
6609 function Private_Dependents (Id : E) return L;
6610 function Private_View (Id : E) return N;
6611 function Protected_Body_Subprogram (Id : E) return E;
6612 function Protected_Formal (Id : E) return E;
6613 function Protection_Object (Id : E) return E;
6614 function RM_Size (Id : E) return U;
6615 function Reachable (Id : E) return B;
6616 function Referenced (Id : E) return B;
6617 function Referenced_As_LHS (Id : E) return B;
6618 function Referenced_As_Out_Parameter (Id : E) return B;
6619 function Refined_State (Id : E) return E;
6620 function Refinement_Constituents (Id : E) return L;
6621 function Register_Exception_Call (Id : E) return N;
6622 function Related_Array_Object (Id : E) return E;
6623 function Related_Expression (Id : E) return N;
6624 function Related_Instance (Id : E) return E;
6625 function Related_Type (Id : E) return E;
6626 function Relative_Deadline_Variable (Id : E) return E;
6627 function Renamed_Entity (Id : E) return N;
6628 function Renamed_In_Spec (Id : E) return B;
6629 function Renamed_Object (Id : E) return N;
6630 function Renaming_Map (Id : E) return U;
6631 function Requires_Overriding (Id : E) return B;
6632 function Return_Applies_To (Id : E) return N;
6633 function Return_Present (Id : E) return B;
6634 function Returns_By_Ref (Id : E) return B;
6635 function Reverse_Bit_Order (Id : E) return B;
6636 function Reverse_Storage_Order (Id : E) return B;
6637 function Scalar_Range (Id : E) return N;
6638 function Scale_Value (Id : E) return U;
6639 function Scope_Depth_Value (Id : E) return U;
6640 function Sec_Stack_Needed_For_Return (Id : E) return B;
6641 function Shadow_Entities (Id : E) return S;
6642 function Shared_Var_Procs_Instance (Id : E) return E;
6643 function Size_Check_Code (Id : E) return N;
6644 function Size_Depends_On_Discriminant (Id : E) return B;
6645 function Size_Known_At_Compile_Time (Id : E) return B;
6646 function Small_Value (Id : E) return R;
6647 function SPARK_Aux_Pragma (Id : E) return N;
6648 function SPARK_Aux_Pragma_Inherited (Id : E) return B;
6649 function SPARK_Pragma (Id : E) return N;
6650 function SPARK_Pragma_Inherited (Id : E) return B;
6651 function Spec_Entity (Id : E) return E;
6652 function Static_Elaboration_Desired (Id : E) return B;
6653 function Static_Initialization (Id : E) return N;
6654 function Static_Predicate (Id : E) return S;
6655 function Status_Flag_Or_Transient_Decl (Id : E) return E;
6656 function Storage_Size_Variable (Id : E) return E;
6657 function Stored_Constraint (Id : E) return L;
6658 function Strict_Alignment (Id : E) return B;
6659 function String_Literal_Length (Id : E) return U;
6660 function String_Literal_Low_Bound (Id : E) return N;
6661 function Subprograms_For_Type (Id : E) return E;
6662 function Suppress_Elaboration_Warnings (Id : E) return B;
6663 function Suppress_Initialization (Id : E) return B;
6664 function Suppress_Style_Checks (Id : E) return B;
6665 function Suppress_Value_Tracking_On_Call (Id : E) return B;
6666 function Task_Body_Procedure (Id : E) return N;
6667 function Thunk_Entity (Id : E) return E;
6668 function Treat_As_Volatile (Id : E) return B;
6669 function Underlying_Full_View (Id : E) return E;
6670 function Underlying_Record_View (Id : E) return E;
6671 function Universal_Aliasing (Id : E) return B;
6672 function Unset_Reference (Id : E) return N;
6673 function Used_As_Generic_Actual (Id : E) return B;
6674 function Uses_Lock_Free (Id : E) return B;
6675 function Uses_Sec_Stack (Id : E) return B;
6676 function Vax_Float (Id : E) return B;
6677 function Warnings_Off (Id : E) return B;
6678 function Warnings_Off_Used (Id : E) return B;
6679 function Warnings_Off_Used_Unmodified (Id : E) return B;
6680 function Warnings_Off_Used_Unreferenced (Id : E) return B;
6681 function Was_Hidden (Id : E) return B;
6682 function Wrapped_Entity (Id : E) return E;
6683
6684 -------------------------------
6685 -- Classification Attributes --
6686 -------------------------------
6687
6688 -- These functions provide a convenient functional notation for testing
6689 -- whether an Ekind value belongs to a specified kind, for example the
6690 -- function Is_Elementary_Type tests if its argument is in Elementary_Kind.
6691 -- In some cases, the test is of an entity attribute (e.g. in the case of
6692 -- Is_Generic_Type where the Ekind does not provide the needed information)
6693
6694 function Is_Access_Type (Id : E) return B;
6695 function Is_Access_Protected_Subprogram_Type (Id : E) return B;
6696 function Is_Access_Subprogram_Type (Id : E) return B;
6697 function Is_Aggregate_Type (Id : E) return B;
6698 function Is_Array_Type (Id : E) return B;
6699 function Is_Assignable (Id : E) return B;
6700 function Is_Class_Wide_Type (Id : E) return B;
6701 function Is_Composite_Type (Id : E) return B;
6702 function Is_Concurrent_Body (Id : E) return B;
6703 function Is_Concurrent_Record_Type (Id : E) return B;
6704 function Is_Concurrent_Type (Id : E) return B;
6705 function Is_Decimal_Fixed_Point_Type (Id : E) return B;
6706 function Is_Digits_Type (Id : E) return B;
6707 function Is_Discrete_Or_Fixed_Point_Type (Id : E) return B;
6708 function Is_Discrete_Type (Id : E) return B;
6709 function Is_Elementary_Type (Id : E) return B;
6710 function Is_Entry (Id : E) return B;
6711 function Is_Enumeration_Type (Id : E) return B;
6712 function Is_Fixed_Point_Type (Id : E) return B;
6713 function Is_Floating_Point_Type (Id : E) return B;
6714 function Is_Formal (Id : E) return B;
6715 function Is_Formal_Object (Id : E) return B;
6716 function Is_Formal_Subprogram (Id : E) return B;
6717 function Is_Generic_Actual_Type (Id : E) return B;
6718 function Is_Generic_Unit (Id : E) return B;
6719 function Is_Generic_Type (Id : E) return B;
6720 function Is_Generic_Subprogram (Id : E) return B;
6721 function Is_Incomplete_Or_Private_Type (Id : E) return B;
6722 function Is_Incomplete_Type (Id : E) return B;
6723 function Is_Integer_Type (Id : E) return B;
6724 function Is_Limited_Record (Id : E) return B;
6725 function Is_Modular_Integer_Type (Id : E) return B;
6726 function Is_Named_Number (Id : E) return B;
6727 function Is_Numeric_Type (Id : E) return B;
6728 function Is_Object (Id : E) return B;
6729 function Is_Ordinary_Fixed_Point_Type (Id : E) return B;
6730 function Is_Overloadable (Id : E) return B;
6731 function Is_Private_Type (Id : E) return B;
6732 function Is_Protected_Type (Id : E) return B;
6733 function Is_Real_Type (Id : E) return B;
6734 function Is_Record_Type (Id : E) return B;
6735 function Is_Scalar_Type (Id : E) return B;
6736 function Is_Signed_Integer_Type (Id : E) return B;
6737 function Is_Subprogram (Id : E) return B;
6738 function Is_Task_Type (Id : E) return B;
6739 function Is_Type (Id : E) return B;
6740
6741 -------------------------------------
6742 -- Synthesized Attribute Functions --
6743 -------------------------------------
6744
6745 -- The functions in this section synthesize attributes from the tree,
6746 -- so they do not correspond to defined fields in the entity itself.
6747
6748 function Address_Clause (Id : E) return N;
6749 function Aft_Value (Id : E) return U;
6750 function Alignment_Clause (Id : E) return N;
6751 function Base_Type (Id : E) return E;
6752 function Declaration_Node (Id : E) return N;
6753 function Designated_Type (Id : E) return E;
6754 function First_Component (Id : E) return E;
6755 function First_Component_Or_Discriminant (Id : E) return E;
6756 function First_Formal (Id : E) return E;
6757 function First_Formal_With_Extras (Id : E) return E;
6758 function Has_Attach_Handler (Id : E) return B;
6759 function Has_Entries (Id : E) return B;
6760 function Has_Foreign_Convention (Id : E) return B;
6761 function Has_Non_Null_Refinement (Id : E) return B;
6762 function Has_Null_Abstract_State (Id : E) return B;
6763 function Has_Null_Refinement (Id : E) return B;
6764 function Implementation_Base_Type (Id : E) return E;
6765 function Is_Base_Type (Id : E) return B;
6766 function Is_Boolean_Type (Id : E) return B;
6767 function Is_Constant_Object (Id : E) return B;
6768 function Is_Discriminal (Id : E) return B;
6769 function Is_Dynamic_Scope (Id : E) return B;
6770 function Is_External_State (Id : E) return B;
6771 function Is_Finalizer (Id : E) return B;
6772 function Is_Ghost_Entity (Id : E) return B;
6773 function Is_Ghost_Subprogram (Id : E) return B;
6774 function Is_Input_Only_State (Id : E) return B;
6775 function Is_Non_Volatile_State (Id : E) return B;
6776 function Is_Null_State (Id : E) return B;
6777 function Is_Output_Only_State (Id : E) return B;
6778 function Is_Package_Or_Generic_Package (Id : E) return B;
6779 function Is_Prival (Id : E) return B;
6780 function Is_Protected_Component (Id : E) return B;
6781 function Is_Protected_Interface (Id : E) return B;
6782 function Is_Protected_Record_Type (Id : E) return B;
6783 function Is_Standard_Character_Type (Id : E) return B;
6784 function Is_String_Type (Id : E) return B;
6785 function Is_Synchronized_Interface (Id : E) return B;
6786 function Is_Task_Interface (Id : E) return B;
6787 function Is_Task_Record_Type (Id : E) return B;
6788 function Is_Wrapper_Package (Id : E) return B;
6789 function Last_Formal (Id : E) return E;
6790 function Machine_Emax_Value (Id : E) return U;
6791 function Machine_Emin_Value (Id : E) return U;
6792 function Machine_Mantissa_Value (Id : E) return U;
6793 function Machine_Radix_Value (Id : E) return U;
6794 function Model_Emin_Value (Id : E) return U;
6795 function Model_Epsilon_Value (Id : E) return R;
6796 function Model_Mantissa_Value (Id : E) return U;
6797 function Model_Small_Value (Id : E) return R;
6798 function Next_Component (Id : E) return E;
6799 function Next_Component_Or_Discriminant (Id : E) return E;
6800 function Next_Discriminant (Id : E) return E;
6801 function Next_Formal (Id : E) return E;
6802 function Next_Formal_With_Extras (Id : E) return E;
6803 function Next_Literal (Id : E) return E;
6804 function Next_Stored_Discriminant (Id : E) return E;
6805 function Number_Dimensions (Id : E) return Pos;
6806 function Number_Entries (Id : E) return Nat;
6807 function Number_Formals (Id : E) return Pos;
6808 function Parameter_Mode (Id : E) return Formal_Kind;
6809 function Primitive_Operations (Id : E) return L;
6810 function Root_Type (Id : E) return E;
6811 function Safe_Emax_Value (Id : E) return U;
6812 function Safe_First_Value (Id : E) return R;
6813 function Safe_Last_Value (Id : E) return R;
6814 function Scope_Depth_Set (Id : E) return B;
6815 function Size_Clause (Id : E) return N;
6816 function Stream_Size_Clause (Id : E) return N;
6817 function Type_High_Bound (Id : E) return N;
6818 function Type_Low_Bound (Id : E) return N;
6819 function Underlying_Type (Id : E) return E;
6820
6821 ----------------------------------------------
6822 -- Type Representation Attribute Predicates --
6823 ----------------------------------------------
6824
6825 -- These predicates test the setting of the indicated attribute. If the
6826 -- value has been set, then Known is True, and Unknown is False. If no
6827 -- value is set, then Known is False and Unknown is True. The Known_Static
6828 -- predicate is true only if the value is set (Known) and is set to a
6829 -- compile time known value. Note that in the case of Alignment and
6830 -- Normalized_First_Bit, dynamic values are not possible, so we do not
6831 -- need a separate Known_Static calls in these cases. The not set (unknown)
6832 -- values are as follows:
6833
6834 -- Alignment Uint_0 or No_Uint
6835 -- Component_Size Uint_0 or No_Uint
6836 -- Component_Bit_Offset No_Uint
6837 -- Digits_Value Uint_0 or No_Uint
6838 -- Esize Uint_0 or No_Uint
6839 -- Normalized_First_Bit No_Uint
6840 -- Normalized_Position No_Uint
6841 -- Normalized_Position_Max No_Uint
6842 -- RM_Size Uint_0 or No_Uint
6843
6844 -- It would be cleaner to use No_Uint in all these cases, but historically
6845 -- we chose to use Uint_0 at first, and the change over will take time ???
6846 -- This is particularly true for the RM_Size field, where a value of zero
6847 -- is legitimate. We deal with this by a nasty kludge that knows that the
6848 -- value is always known static for discrete types (and no other types can
6849 -- have an RM_Size value of zero).
6850
6851 -- In two cases, Known_Static_Esize and Known_Static_RM_Size, there is one
6852 -- more consideration, which is that we always return False for generic
6853 -- types. Within a template, the size can look known, because of the fake
6854 -- size values we put in template types, but they are not really known and
6855 -- anyone testing if they are known within the template should get False as
6856 -- a result to prevent incorrect assumptions.
6857
6858 function Known_Alignment (E : Entity_Id) return B;
6859 function Known_Component_Bit_Offset (E : Entity_Id) return B;
6860 function Known_Component_Size (E : Entity_Id) return B;
6861 function Known_Esize (E : Entity_Id) return B;
6862 function Known_Normalized_First_Bit (E : Entity_Id) return B;
6863 function Known_Normalized_Position (E : Entity_Id) return B;
6864 function Known_Normalized_Position_Max (E : Entity_Id) return B;
6865 function Known_RM_Size (E : Entity_Id) return B;
6866
6867 function Known_Static_Component_Bit_Offset (E : Entity_Id) return B;
6868 function Known_Static_Component_Size (E : Entity_Id) return B;
6869 function Known_Static_Esize (E : Entity_Id) return B;
6870 function Known_Static_Normalized_First_Bit (E : Entity_Id) return B;
6871 function Known_Static_Normalized_Position (E : Entity_Id) return B;
6872 function Known_Static_Normalized_Position_Max (E : Entity_Id) return B;
6873 function Known_Static_RM_Size (E : Entity_Id) return B;
6874
6875 function Unknown_Alignment (E : Entity_Id) return B;
6876 function Unknown_Component_Bit_Offset (E : Entity_Id) return B;
6877 function Unknown_Component_Size (E : Entity_Id) return B;
6878 function Unknown_Esize (E : Entity_Id) return B;
6879 function Unknown_Normalized_First_Bit (E : Entity_Id) return B;
6880 function Unknown_Normalized_Position (E : Entity_Id) return B;
6881 function Unknown_Normalized_Position_Max (E : Entity_Id) return B;
6882 function Unknown_RM_Size (E : Entity_Id) return B;
6883
6884 ------------------------------
6885 -- Attribute Set Procedures --
6886 ------------------------------
6887
6888 procedure Set_Abstract_States (Id : E; V : L);
6889 procedure Set_Accept_Address (Id : E; V : L);
6890 procedure Set_Access_Disp_Table (Id : E; V : L);
6891 procedure Set_Actual_Subtype (Id : E; V : E);
6892 procedure Set_Address_Taken (Id : E; V : B := True);
6893 procedure Set_Alias (Id : E; V : E);
6894 procedure Set_Alignment (Id : E; V : U);
6895 procedure Set_Associated_Formal_Package (Id : E; V : E);
6896 procedure Set_Associated_Node_For_Itype (Id : E; V : N);
6897 procedure Set_Associated_Storage_Pool (Id : E; V : E);
6898 procedure Set_Barrier_Function (Id : E; V : N);
6899 procedure Set_Block_Node (Id : E; V : N);
6900 procedure Set_Body_Entity (Id : E; V : E);
6901 procedure Set_Body_Needed_For_SAL (Id : E; V : B := True);
6902 procedure Set_Body_References (Id : E; V : L);
6903 procedure Set_CR_Discriminant (Id : E; V : E);
6904 procedure Set_C_Pass_By_Copy (Id : E; V : B := True);
6905 procedure Set_Can_Never_Be_Null (Id : E; V : B := True);
6906 procedure Set_Can_Use_Internal_Rep (Id : E; V : B := True);
6907 procedure Set_Checks_May_Be_Suppressed (Id : E; V : B := True);
6908 procedure Set_Class_Wide_Type (Id : E; V : E);
6909 procedure Set_Cloned_Subtype (Id : E; V : E);
6910 procedure Set_Component_Alignment (Id : E; V : C);
6911 procedure Set_Component_Bit_Offset (Id : E; V : U);
6912 procedure Set_Component_Clause (Id : E; V : N);
6913 procedure Set_Component_Size (Id : E; V : U);
6914 procedure Set_Component_Type (Id : E; V : E);
6915 procedure Set_Contract (Id : E; V : N);
6916 procedure Set_Corresponding_Concurrent_Type (Id : E; V : E);
6917 procedure Set_Corresponding_Discriminant (Id : E; V : E);
6918 procedure Set_Corresponding_Equality (Id : E; V : E);
6919 procedure Set_Corresponding_Protected_Entry (Id : E; V : E);
6920 procedure Set_Corresponding_Record_Type (Id : E; V : E);
6921 procedure Set_Corresponding_Remote_Type (Id : E; V : E);
6922 procedure Set_Current_Use_Clause (Id : E; V : E);
6923 procedure Set_Current_Value (Id : E; V : N);
6924 procedure Set_DTC_Entity (Id : E; V : E);
6925 procedure Set_DT_Entry_Count (Id : E; V : U);
6926 procedure Set_DT_Offset_To_Top_Func (Id : E; V : E);
6927 procedure Set_DT_Position (Id : E; V : U);
6928 procedure Set_Debug_Info_Off (Id : E; V : B := True);
6929 procedure Set_Debug_Renaming_Link (Id : E; V : E);
6930 procedure Set_Default_Aspect_Component_Value (Id : E; V : N);
6931 procedure Set_Default_Aspect_Value (Id : E; V : N);
6932 procedure Set_Default_Expr_Function (Id : E; V : E);
6933 procedure Set_Default_Expressions_Processed (Id : E; V : B := True);
6934 procedure Set_Default_Value (Id : E; V : N);
6935 procedure Set_Delay_Cleanups (Id : E; V : B := True);
6936 procedure Set_Delay_Subprogram_Descriptors (Id : E; V : B := True);
6937 procedure Set_Delta_Value (Id : E; V : R);
6938 procedure Set_Dependent_Instances (Id : E; V : L);
6939 procedure Set_Depends_On_Private (Id : E; V : B := True);
6940 procedure Set_Digits_Value (Id : E; V : U);
6941 procedure Set_Direct_Primitive_Operations (Id : E; V : L);
6942 procedure Set_Directly_Designated_Type (Id : E; V : E);
6943 procedure Set_Discard_Names (Id : E; V : B := True);
6944 procedure Set_Discriminal (Id : E; V : E);
6945 procedure Set_Discriminal_Link (Id : E; V : E);
6946 procedure Set_Discriminant_Checking_Func (Id : E; V : E);
6947 procedure Set_Discriminant_Constraint (Id : E; V : L);
6948 procedure Set_Discriminant_Default_Value (Id : E; V : N);
6949 procedure Set_Discriminant_Number (Id : E; V : U);
6950 procedure Set_Dispatch_Table_Wrappers (Id : E; V : L);
6951 procedure Set_Elaborate_Body_Desirable (Id : E; V : B := True);
6952 procedure Set_Elaboration_Entity (Id : E; V : E);
6953 procedure Set_Elaboration_Entity_Required (Id : E; V : B := True);
6954 procedure Set_Enclosing_Scope (Id : E; V : E);
6955 procedure Set_Entry_Accepted (Id : E; V : B := True);
6956 procedure Set_Entry_Bodies_Array (Id : E; V : E);
6957 procedure Set_Entry_Cancel_Parameter (Id : E; V : E);
6958 procedure Set_Entry_Component (Id : E; V : E);
6959 procedure Set_Entry_Formal (Id : E; V : E);
6960 procedure Set_Entry_Index_Constant (Id : E; V : E);
6961 procedure Set_Entry_Parameters_Type (Id : E; V : E);
6962 procedure Set_Enum_Pos_To_Rep (Id : E; V : E);
6963 procedure Set_Enumeration_Pos (Id : E; V : U);
6964 procedure Set_Enumeration_Rep (Id : E; V : U);
6965 procedure Set_Enumeration_Rep_Expr (Id : E; V : N);
6966 procedure Set_Equivalent_Type (Id : E; V : E);
6967 procedure Set_Esize (Id : E; V : U);
6968 procedure Set_Exception_Code (Id : E; V : U);
6969 procedure Set_Extra_Accessibility (Id : E; V : E);
6970 procedure Set_Extra_Accessibility_Of_Result (Id : E; V : E);
6971 procedure Set_Extra_Constrained (Id : E; V : E);
6972 procedure Set_Extra_Formal (Id : E; V : E);
6973 procedure Set_Extra_Formals (Id : E; V : E);
6974 procedure Set_Finalization_Master (Id : E; V : E);
6975 procedure Set_Finalize_Storage_Only (Id : E; V : B := True);
6976 procedure Set_Finalizer (Id : E; V : E);
6977 procedure Set_First_Entity (Id : E; V : E);
6978 procedure Set_First_Exit_Statement (Id : E; V : N);
6979 procedure Set_First_Index (Id : E; V : N);
6980 procedure Set_First_Literal (Id : E; V : E);
6981 procedure Set_First_Optional_Parameter (Id : E; V : E);
6982 procedure Set_First_Private_Entity (Id : E; V : E);
6983 procedure Set_First_Rep_Item (Id : E; V : N);
6984 procedure Set_Float_Rep (Id : E; V : F);
6985 procedure Set_Freeze_Node (Id : E; V : N);
6986 procedure Set_From_Limited_With (Id : E; V : B := True);
6987 procedure Set_Full_View (Id : E; V : E);
6988 procedure Set_Generic_Homonym (Id : E; V : E);
6989 procedure Set_Generic_Renamings (Id : E; V : L);
6990 procedure Set_Handler_Records (Id : E; V : S);
6991 procedure Set_Has_Aliased_Components (Id : E; V : B := True);
6992 procedure Set_Has_Alignment_Clause (Id : E; V : B := True);
6993 procedure Set_Has_All_Calls_Remote (Id : E; V : B := True);
6994 procedure Set_Has_Anonymous_Master (Id : E; V : B := True);
6995 procedure Set_Has_Atomic_Components (Id : E; V : B := True);
6996 procedure Set_Has_Biased_Representation (Id : E; V : B := True);
6997 procedure Set_Has_Body_References (Id : E; V : B := True);
6998 procedure Set_Has_Completion (Id : E; V : B := True);
6999 procedure Set_Has_Completion_In_Body (Id : E; V : B := True);
7000 procedure Set_Has_Complex_Representation (Id : E; V : B := True);
7001 procedure Set_Has_Component_Size_Clause (Id : E; V : B := True);
7002 procedure Set_Has_Constrained_Partial_View (Id : E; V : B := True);
7003 procedure Set_Has_Contiguous_Rep (Id : E; V : B := True);
7004 procedure Set_Has_Controlled_Component (Id : E; V : B := True);
7005 procedure Set_Has_Controlling_Result (Id : E; V : B := True);
7006 procedure Set_Has_Convention_Pragma (Id : E; V : B := True);
7007 procedure Set_Has_Default_Aspect (Id : E; V : B := True);
7008 procedure Set_Has_Delayed_Aspects (Id : E; V : B := True);
7009 procedure Set_Has_Delayed_Freeze (Id : E; V : B := True);
7010 procedure Set_Has_Delayed_Rep_Aspects (Id : E; V : B := True);
7011 procedure Set_Has_Discriminants (Id : E; V : B := True);
7012 procedure Set_Has_Dispatch_Table (Id : E; V : B := True);
7013 procedure Set_Has_Dynamic_Predicate_Aspect (Id : E; V : B := True);
7014 procedure Set_Has_Enumeration_Rep_Clause (Id : E; V : B := True);
7015 procedure Set_Has_Exit (Id : E; V : B := True);
7016 procedure Set_Has_External_Tag_Rep_Clause (Id : E; V : B := True);
7017 procedure Set_Has_Forward_Instantiation (Id : E; V : B := True);
7018 procedure Set_Has_Fully_Qualified_Name (Id : E; V : B := True);
7019 procedure Set_Has_Gigi_Rep_Item (Id : E; V : B := True);
7020 procedure Set_Has_Homonym (Id : E; V : B := True);
7021 procedure Set_Has_Implicit_Dereference (Id : E; V : B := True);
7022 procedure Set_Has_Independent_Components (Id : E; V : B := True);
7023 procedure Set_Has_Inheritable_Invariants (Id : E; V : B := True);
7024 procedure Set_Has_Initial_Value (Id : E; V : B := True);
7025 procedure Set_Has_Invariants (Id : E; V : B := True);
7026 procedure Set_Has_Loop_Entry_Attributes (Id : E; V : B := True);
7027 procedure Set_Has_Machine_Radix_Clause (Id : E; V : B := True);
7028 procedure Set_Has_Master_Entity (Id : E; V : B := True);
7029 procedure Set_Has_Missing_Return (Id : E; V : B := True);
7030 procedure Set_Has_Nested_Block_With_Handler (Id : E; V : B := True);
7031 procedure Set_Has_Non_Standard_Rep (Id : E; V : B := True);
7032 procedure Set_Has_Object_Size_Clause (Id : E; V : B := True);
7033 procedure Set_Has_Per_Object_Constraint (Id : E; V : B := True);
7034 procedure Set_Has_Postconditions (Id : E; V : B := True);
7035 procedure Set_Has_Pragma_Controlled (Id : E; V : B := True);
7036 procedure Set_Has_Pragma_Elaborate_Body (Id : E; V : B := True);
7037 procedure Set_Has_Pragma_Inline (Id : E; V : B := True);
7038 procedure Set_Has_Pragma_Inline_Always (Id : E; V : B := True);
7039 procedure Set_Has_Pragma_No_Inline (Id : E; V : B := True);
7040 procedure Set_Has_Pragma_Ordered (Id : E; V : B := True);
7041 procedure Set_Has_Pragma_Pack (Id : E; V : B := True);
7042 procedure Set_Has_Pragma_Preelab_Init (Id : E; V : B := True);
7043 procedure Set_Has_Pragma_Pure (Id : E; V : B := True);
7044 procedure Set_Has_Pragma_Pure_Function (Id : E; V : B := True);
7045 procedure Set_Has_Pragma_Thread_Local_Storage (Id : E; V : B := True);
7046 procedure Set_Has_Pragma_Unmodified (Id : E; V : B := True);
7047 procedure Set_Has_Pragma_Unreferenced (Id : E; V : B := True);
7048 procedure Set_Has_Pragma_Unreferenced_Objects (Id : E; V : B := True);
7049 procedure Set_Has_Predicates (Id : E; V : B := True);
7050 procedure Set_Has_Primitive_Operations (Id : E; V : B := True);
7051 procedure Set_Has_Private_Ancestor (Id : E; V : B := True);
7052 procedure Set_Has_Private_Declaration (Id : E; V : B := True);
7053 procedure Set_Has_Qualified_Name (Id : E; V : B := True);
7054 procedure Set_Has_RACW (Id : E; V : B := True);
7055 procedure Set_Has_Record_Rep_Clause (Id : E; V : B := True);
7056 procedure Set_Has_Recursive_Call (Id : E; V : B := True);
7057 procedure Set_Has_Size_Clause (Id : E; V : B := True);
7058 procedure Set_Has_Small_Clause (Id : E; V : B := True);
7059 procedure Set_Has_Specified_Layout (Id : E; V : B := True);
7060 procedure Set_Has_Specified_Stream_Input (Id : E; V : B := True);
7061 procedure Set_Has_Specified_Stream_Output (Id : E; V : B := True);
7062 procedure Set_Has_Specified_Stream_Read (Id : E; V : B := True);
7063 procedure Set_Has_Specified_Stream_Write (Id : E; V : B := True);
7064 procedure Set_Has_Static_Discriminants (Id : E; V : B := True);
7065 procedure Set_Has_Static_Predicate_Aspect (Id : E; V : B := True);
7066 procedure Set_Has_Storage_Size_Clause (Id : E; V : B := True);
7067 procedure Set_Has_Stream_Size_Clause (Id : E; V : B := True);
7068 procedure Set_Has_Task (Id : E; V : B := True);
7069 procedure Set_Has_Thunks (Id : E; V : B := True);
7070 procedure Set_Has_Unchecked_Union (Id : E; V : B := True);
7071 procedure Set_Has_Unknown_Discriminants (Id : E; V : B := True);
7072 procedure Set_Has_Up_Level_Access (Id : E; V : B := True);
7073 procedure Set_Has_Visible_Refinement (Id : E; V : B := True);
7074 procedure Set_Has_Volatile_Components (Id : E; V : B := True);
7075 procedure Set_Has_Xref_Entry (Id : E; V : B := True);
7076 procedure Set_Hiding_Loop_Variable (Id : E; V : E);
7077 procedure Set_Homonym (Id : E; V : E);
7078 procedure Set_In_Package_Body (Id : E; V : B := True);
7079 procedure Set_In_Private_Part (Id : E; V : B := True);
7080 procedure Set_In_Use (Id : E; V : B := True);
7081 procedure Set_Initialization_Statements (Id : E; V : N);
7082 procedure Set_Inner_Instances (Id : E; V : L);
7083 procedure Set_Interface_Alias (Id : E; V : E);
7084 procedure Set_Interface_Name (Id : E; V : N);
7085 procedure Set_Interfaces (Id : E; V : L);
7086 procedure Set_Is_AST_Entry (Id : E; V : B := True);
7087 procedure Set_Is_Abstract_Subprogram (Id : E; V : B := True);
7088 procedure Set_Is_Abstract_Type (Id : E; V : B := True);
7089 procedure Set_Is_Access_Constant (Id : E; V : B := True);
7090 procedure Set_Is_Ada_2005_Only (Id : E; V : B := True);
7091 procedure Set_Is_Ada_2012_Only (Id : E; V : B := True);
7092 procedure Set_Is_Aliased (Id : E; V : B := True);
7093 procedure Set_Is_Asynchronous (Id : E; V : B := True);
7094 procedure Set_Is_Atomic (Id : E; V : B := True);
7095 procedure Set_Is_Bit_Packed_Array (Id : E; V : B := True);
7096 procedure Set_Is_CPP_Class (Id : E; V : B := True);
7097 procedure Set_Is_Called (Id : E; V : B := True);
7098 procedure Set_Is_Character_Type (Id : E; V : B := True);
7099 procedure Set_Is_Child_Unit (Id : E; V : B := True);
7100 procedure Set_Is_Class_Wide_Equivalent_Type (Id : E; V : B := True);
7101 procedure Set_Is_Compilation_Unit (Id : E; V : B := True);
7102 procedure Set_Is_Completely_Hidden (Id : E; V : B := True);
7103 procedure Set_Is_Concurrent_Record_Type (Id : E; V : B := True);
7104 procedure Set_Is_Constr_Subt_For_UN_Aliased (Id : E; V : B := True);
7105 procedure Set_Is_Constr_Subt_For_U_Nominal (Id : E; V : B := True);
7106 procedure Set_Is_Constrained (Id : E; V : B := True);
7107 procedure Set_Is_Constructor (Id : E; V : B := True);
7108 procedure Set_Is_Controlled (Id : E; V : B := True);
7109 procedure Set_Is_Controlling_Formal (Id : E; V : B := True);
7110 procedure Set_Is_Descendent_Of_Address (Id : E; V : B := True);
7111 procedure Set_Is_Discrim_SO_Function (Id : E; V : B := True);
7112 procedure Set_Is_Dispatch_Table_Entity (Id : E; V : B := True);
7113 procedure Set_Is_Dispatching_Operation (Id : E; V : B := True);
7114 procedure Set_Is_Eliminated (Id : E; V : B := True);
7115 procedure Set_Is_Entry_Formal (Id : E; V : B := True);
7116 procedure Set_Is_Exported (Id : E; V : B := True);
7117 procedure Set_Is_First_Subtype (Id : E; V : B := True);
7118 procedure Set_Is_For_Access_Subtype (Id : E; V : B := True);
7119 procedure Set_Is_Formal_Subprogram (Id : E; V : B := True);
7120 procedure Set_Is_Frozen (Id : E; V : B := True);
7121 procedure Set_Is_Generic_Actual_Type (Id : E; V : B := True);
7122 procedure Set_Is_Generic_Instance (Id : E; V : B := True);
7123 procedure Set_Is_Generic_Type (Id : E; V : B := True);
7124 procedure Set_Is_Hidden (Id : E; V : B := True);
7125 procedure Set_Is_Hidden_Open_Scope (Id : E; V : B := True);
7126 procedure Set_Is_Immediately_Visible (Id : E; V : B := True);
7127 procedure Set_Is_Implementation_Defined (Id : E; V : B := True);
7128 procedure Set_Is_Imported (Id : E; V : B := True);
7129 procedure Set_Is_Inlined (Id : E; V : B := True);
7130 procedure Set_Is_Instantiated (Id : E; V : B := True);
7131 procedure Set_Is_Interface (Id : E; V : B := True);
7132 procedure Set_Is_Internal (Id : E; V : B := True);
7133 procedure Set_Is_Interrupt_Handler (Id : E; V : B := True);
7134 procedure Set_Is_Intrinsic_Subprogram (Id : E; V : B := True);
7135 procedure Set_Is_Invariant_Procedure (Id : E; V : B := True);
7136 procedure Set_Is_Itype (Id : E; V : B := True);
7137 procedure Set_Is_Known_Non_Null (Id : E; V : B := True);
7138 procedure Set_Is_Known_Null (Id : E; V : B := True);
7139 procedure Set_Is_Known_Valid (Id : E; V : B := True);
7140 procedure Set_Is_Limited_Composite (Id : E; V : B := True);
7141 procedure Set_Is_Limited_Interface (Id : E; V : B := True);
7142 procedure Set_Is_Limited_Record (Id : E; V : B := True);
7143 procedure Set_Is_Local_Anonymous_Access (Id : E; V : B := True);
7144 procedure Set_Is_Machine_Code_Subprogram (Id : E; V : B := True);
7145 procedure Set_Is_Non_Static_Subtype (Id : E; V : B := True);
7146 procedure Set_Is_Null_Init_Proc (Id : E; V : B := True);
7147 procedure Set_Is_Obsolescent (Id : E; V : B := True);
7148 procedure Set_Is_Only_Out_Parameter (Id : E; V : B := True);
7149 procedure Set_Is_Optional_Parameter (Id : E; V : B := True);
7150 procedure Set_Is_Package_Body_Entity (Id : E; V : B := True);
7151 procedure Set_Is_Packed (Id : E; V : B := True);
7152 procedure Set_Is_Packed_Array_Type (Id : E; V : B := True);
7153 procedure Set_Is_Potentially_Use_Visible (Id : E; V : B := True);
7154 procedure Set_Is_Predicate_Function (Id : E; V : B := True);
7155 procedure Set_Is_Predicate_Function_M (Id : E; V : B := True);
7156 procedure Set_Is_Preelaborated (Id : E; V : B := True);
7157 procedure Set_Is_Primitive (Id : E; V : B := True);
7158 procedure Set_Is_Primitive_Wrapper (Id : E; V : B := True);
7159 procedure Set_Is_Private_Composite (Id : E; V : B := True);
7160 procedure Set_Is_Private_Descendant (Id : E; V : B := True);
7161 procedure Set_Is_Private_Primitive (Id : E; V : B := True);
7162 procedure Set_Is_Processed_Transient (Id : E; V : B := True);
7163 procedure Set_Is_Public (Id : E; V : B := True);
7164 procedure Set_Is_Pure (Id : E; V : B := True);
7165 procedure Set_Is_Pure_Unit_Access_Type (Id : E; V : B := True);
7166 procedure Set_Is_RACW_Stub_Type (Id : E; V : B := True);
7167 procedure Set_Is_Raised (Id : E; V : B := True);
7168 procedure Set_Is_Remote_Call_Interface (Id : E; V : B := True);
7169 procedure Set_Is_Remote_Types (Id : E; V : B := True);
7170 procedure Set_Is_Renaming_Of_Object (Id : E; V : B := True);
7171 procedure Set_Is_Return_Object (Id : E; V : B := True);
7172 procedure Set_Is_Safe_To_Reevaluate (Id : E; V : B := True);
7173 procedure Set_Is_Shared_Passive (Id : E; V : B := True);
7174 procedure Set_Is_Statically_Allocated (Id : E; V : B := True);
7175 procedure Set_Is_Tag (Id : E; V : B := True);
7176 procedure Set_Is_Tagged_Type (Id : E; V : B := True);
7177 procedure Set_Is_Thunk (Id : E; V : B := True);
7178 procedure Set_Is_Trivial_Subprogram (Id : E; V : B := True);
7179 procedure Set_Is_True_Constant (Id : E; V : B := True);
7180 procedure Set_Is_Unchecked_Union (Id : E; V : B := True);
7181 procedure Set_Is_Underlying_Record_View (Id : E; V : B := True);
7182 procedure Set_Is_Unsigned_Type (Id : E; V : B := True);
7183 procedure Set_Is_VMS_Exception (Id : E; V : B := True);
7184 procedure Set_Is_Valued_Procedure (Id : E; V : B := True);
7185 procedure Set_Is_Visible_Formal (Id : E; V : B := True);
7186 procedure Set_Is_Visible_Lib_Unit (Id : E; V : B := True);
7187 procedure Set_Is_Volatile (Id : E; V : B := True);
7188 procedure Set_Itype_Printed (Id : E; V : B := True);
7189 procedure Set_Kill_Elaboration_Checks (Id : E; V : B := True);
7190 procedure Set_Kill_Range_Checks (Id : E; V : B := True);
7191 procedure Set_Known_To_Have_Preelab_Init (Id : E; V : B := True);
7192 procedure Set_Last_Assignment (Id : E; V : N);
7193 procedure Set_Last_Entity (Id : E; V : E);
7194 procedure Set_Limited_View (Id : E; V : E);
7195 procedure Set_Lit_Indexes (Id : E; V : E);
7196 procedure Set_Lit_Strings (Id : E; V : E);
7197 procedure Set_Low_Bound_Tested (Id : E; V : B := True);
7198 procedure Set_Machine_Radix_10 (Id : E; V : B := True);
7199 procedure Set_Master_Id (Id : E; V : E);
7200 procedure Set_Materialize_Entity (Id : E; V : B := True);
7201 procedure Set_May_Inherit_Delayed_Rep_Aspects (Id : E; V : B := True);
7202 procedure Set_Mechanism (Id : E; V : M);
7203 procedure Set_Modulus (Id : E; V : U);
7204 procedure Set_Must_Be_On_Byte_Boundary (Id : E; V : B := True);
7205 procedure Set_Must_Have_Preelab_Init (Id : E; V : B := True);
7206 procedure Set_Needs_Debug_Info (Id : E; V : B := True);
7207 procedure Set_Needs_No_Actuals (Id : E; V : B := True);
7208 procedure Set_Never_Set_In_Source (Id : E; V : B := True);
7209 procedure Set_Next_Inlined_Subprogram (Id : E; V : E);
7210 procedure Set_No_Pool_Assigned (Id : E; V : B := True);
7211 procedure Set_No_Return (Id : E; V : B := True);
7212 procedure Set_No_Strict_Aliasing (Id : E; V : B := True);
7213 procedure Set_Non_Binary_Modulus (Id : E; V : B := True);
7214 procedure Set_Non_Limited_View (Id : E; V : E);
7215 procedure Set_Nonzero_Is_True (Id : E; V : B := True);
7216 procedure Set_Normalized_First_Bit (Id : E; V : U);
7217 procedure Set_Normalized_Position (Id : E; V : U);
7218 procedure Set_Normalized_Position_Max (Id : E; V : U);
7219 procedure Set_OK_To_Rename (Id : E; V : B := True);
7220 procedure Set_OK_To_Reorder_Components (Id : E; V : B := True);
7221 procedure Set_Optimize_Alignment_Space (Id : E; V : B := True);
7222 procedure Set_Optimize_Alignment_Time (Id : E; V : B := True);
7223 procedure Set_Original_Access_Type (Id : E; V : E);
7224 procedure Set_Original_Array_Type (Id : E; V : E);
7225 procedure Set_Original_Record_Component (Id : E; V : E);
7226 procedure Set_Overlays_Constant (Id : E; V : B := True);
7227 procedure Set_Overridden_Operation (Id : E; V : E);
7228 procedure Set_PPC_Wrapper (Id : E; V : E);
7229 procedure Set_Package_Instantiation (Id : E; V : N);
7230 procedure Set_Packed_Array_Type (Id : E; V : E);
7231 procedure Set_Parent_Subtype (Id : E; V : E);
7232 procedure Set_Postcondition_Proc (Id : E; V : E);
7233 procedure Set_Prival (Id : E; V : E);
7234 procedure Set_Prival_Link (Id : E; V : E);
7235 procedure Set_Private_Dependents (Id : E; V : L);
7236 procedure Set_Private_View (Id : E; V : N);
7237 procedure Set_Protected_Body_Subprogram (Id : E; V : E);
7238 procedure Set_Protected_Formal (Id : E; V : E);
7239 procedure Set_Protection_Object (Id : E; V : E);
7240 procedure Set_RM_Size (Id : E; V : U);
7241 procedure Set_Reachable (Id : E; V : B := True);
7242 procedure Set_Referenced (Id : E; V : B := True);
7243 procedure Set_Referenced_As_LHS (Id : E; V : B := True);
7244 procedure Set_Referenced_As_Out_Parameter (Id : E; V : B := True);
7245 procedure Set_Refined_State (Id : E; V : E);
7246 procedure Set_Refinement_Constituents (Id : E; V : L);
7247 procedure Set_Register_Exception_Call (Id : E; V : N);
7248 procedure Set_Related_Array_Object (Id : E; V : E);
7249 procedure Set_Related_Expression (Id : E; V : N);
7250 procedure Set_Related_Instance (Id : E; V : E);
7251 procedure Set_Related_Type (Id : E; V : E);
7252 procedure Set_Relative_Deadline_Variable (Id : E; V : E);
7253 procedure Set_Renamed_Entity (Id : E; V : N);
7254 procedure Set_Renamed_In_Spec (Id : E; V : B := True);
7255 procedure Set_Renamed_Object (Id : E; V : N);
7256 procedure Set_Renaming_Map (Id : E; V : U);
7257 procedure Set_Requires_Overriding (Id : E; V : B := True);
7258 procedure Set_Return_Applies_To (Id : E; V : N);
7259 procedure Set_Return_Present (Id : E; V : B := True);
7260 procedure Set_Returns_By_Ref (Id : E; V : B := True);
7261 procedure Set_Reverse_Bit_Order (Id : E; V : B := True);
7262 procedure Set_Reverse_Storage_Order (Id : E; V : B := True);
7263 procedure Set_Scalar_Range (Id : E; V : N);
7264 procedure Set_Scale_Value (Id : E; V : U);
7265 procedure Set_Scope_Depth_Value (Id : E; V : U);
7266 procedure Set_Sec_Stack_Needed_For_Return (Id : E; V : B := True);
7267 procedure Set_Shadow_Entities (Id : E; V : S);
7268 procedure Set_Shared_Var_Procs_Instance (Id : E; V : E);
7269 procedure Set_Size_Check_Code (Id : E; V : N);
7270 procedure Set_Size_Depends_On_Discriminant (Id : E; V : B := True);
7271 procedure Set_Size_Known_At_Compile_Time (Id : E; V : B := True);
7272 procedure Set_Small_Value (Id : E; V : R);
7273 procedure Set_SPARK_Aux_Pragma (Id : E; V : N);
7274 procedure Set_SPARK_Aux_Pragma_Inherited (Id : E; V : B := True);
7275 procedure Set_SPARK_Pragma (Id : E; V : N);
7276 procedure Set_SPARK_Pragma_Inherited (Id : E; V : B := True);
7277 procedure Set_Spec_Entity (Id : E; V : E);
7278 procedure Set_Static_Elaboration_Desired (Id : E; V : B);
7279 procedure Set_Static_Initialization (Id : E; V : N);
7280 procedure Set_Static_Predicate (Id : E; V : S);
7281 procedure Set_Status_Flag_Or_Transient_Decl (Id : E; V : E);
7282 procedure Set_Storage_Size_Variable (Id : E; V : E);
7283 procedure Set_Stored_Constraint (Id : E; V : L);
7284 procedure Set_Strict_Alignment (Id : E; V : B := True);
7285 procedure Set_String_Literal_Length (Id : E; V : U);
7286 procedure Set_String_Literal_Low_Bound (Id : E; V : N);
7287 procedure Set_Subprograms_For_Type (Id : E; V : E);
7288 procedure Set_Suppress_Elaboration_Warnings (Id : E; V : B := True);
7289 procedure Set_Suppress_Initialization (Id : E; V : B := True);
7290 procedure Set_Suppress_Style_Checks (Id : E; V : B := True);
7291 procedure Set_Suppress_Value_Tracking_On_Call (Id : E; V : B := True);
7292 procedure Set_Task_Body_Procedure (Id : E; V : N);
7293 procedure Set_Thunk_Entity (Id : E; V : E);
7294 procedure Set_Treat_As_Volatile (Id : E; V : B := True);
7295 procedure Set_Underlying_Full_View (Id : E; V : E);
7296 procedure Set_Underlying_Record_View (Id : E; V : E);
7297 procedure Set_Universal_Aliasing (Id : E; V : B := True);
7298 procedure Set_Unset_Reference (Id : E; V : N);
7299 procedure Set_Used_As_Generic_Actual (Id : E; V : B := True);
7300 procedure Set_Uses_Lock_Free (Id : E; V : B := True);
7301 procedure Set_Uses_Sec_Stack (Id : E; V : B := True);
7302 procedure Set_Warnings_Off (Id : E; V : B := True);
7303 procedure Set_Warnings_Off_Used (Id : E; V : B := True);
7304 procedure Set_Warnings_Off_Used_Unmodified (Id : E; V : B := True);
7305 procedure Set_Warnings_Off_Used_Unreferenced (Id : E; V : B := True);
7306 procedure Set_Was_Hidden (Id : E; V : B := True);
7307 procedure Set_Wrapped_Entity (Id : E; V : E);
7308
7309 ---------------------------------------------------
7310 -- Access to Subprograms in Subprograms_For_Type --
7311 ---------------------------------------------------
7312
7313 function Invariant_Procedure (Id : E) return N;
7314 function Predicate_Function (Id : E) return N;
7315 function Predicate_Function_M (Id : E) return N;
7316
7317 procedure Set_Invariant_Procedure (Id : E; V : E);
7318 procedure Set_Predicate_Function (Id : E; V : E);
7319 procedure Set_Predicate_Function_M (Id : E; V : E);
7320
7321 -----------------------------------
7322 -- Field Initialization Routines --
7323 -----------------------------------
7324
7325 -- These routines are overloadings of some of the above Set procedures
7326 -- where the argument is normally a Uint. The overloadings take an Int
7327 -- parameter instead, and appropriately convert it. There are also
7328 -- versions that implicitly initialize to the appropriate "not set"
7329 -- value. The not set (unknown) values are as follows:
7330
7331 -- Alignment Uint_0
7332 -- Component_Size Uint_0
7333 -- Component_Bit_Offset No_Uint
7334 -- Digits_Value Uint_0
7335 -- Esize Uint_0
7336 -- Normalized_First_Bit No_Uint
7337 -- Normalized_Position No_Uint
7338 -- Normalized_Position_Max No_Uint
7339 -- RM_Size Uint_0
7340
7341 -- It would be cleaner to use No_Uint in all these cases, but historically
7342 -- we chose to use Uint_0 at first, and the change over will take time ???
7343 -- This is particularly true for the RM_Size field, where a value of zero
7344 -- is legitimate and causes some kludges around the code.
7345
7346 -- Contrary to the corresponding Set procedures above, these routines
7347 -- do NOT check the entity kind of their argument, instead they set the
7348 -- underlying Uint fields directly (this allows them to be used for
7349 -- entities whose Ekind has not been set yet).
7350
7351 procedure Init_Alignment (Id : E; V : Int);
7352 procedure Init_Component_Size (Id : E; V : Int);
7353 procedure Init_Component_Bit_Offset (Id : E; V : Int);
7354 procedure Init_Digits_Value (Id : E; V : Int);
7355 procedure Init_Esize (Id : E; V : Int);
7356 procedure Init_Normalized_First_Bit (Id : E; V : Int);
7357 procedure Init_Normalized_Position (Id : E; V : Int);
7358 procedure Init_Normalized_Position_Max (Id : E; V : Int);
7359 procedure Init_RM_Size (Id : E; V : Int);
7360
7361 procedure Init_Alignment (Id : E);
7362 procedure Init_Component_Size (Id : E);
7363 procedure Init_Component_Bit_Offset (Id : E);
7364 procedure Init_Digits_Value (Id : E);
7365 procedure Init_Esize (Id : E);
7366 procedure Init_Normalized_First_Bit (Id : E);
7367 procedure Init_Normalized_Position (Id : E);
7368 procedure Init_Normalized_Position_Max (Id : E);
7369 procedure Init_RM_Size (Id : E);
7370
7371 procedure Init_Size_Align (Id : E);
7372 -- This procedure initializes both size fields and the alignment
7373 -- field to all be Unknown.
7374
7375 procedure Init_Object_Size_Align (Id : E);
7376 -- Same as Init_Size_Align except RM_Size field (which is only for types)
7377 -- is unaffected.
7378
7379 procedure Init_Size (Id : E; V : Int);
7380 -- Initialize both the Esize and RM_Size fields of E to V
7381
7382 procedure Init_Component_Location (Id : E);
7383 -- Initializes all fields describing the location of a component
7384 -- (Normalized_Position, Component_Bit_Offset, Normalized_First_Bit,
7385 -- Normalized_Position_Max, Esize) to all be Unknown.
7386
7387 ---------------
7388 -- Iterators --
7389 ---------------
7390
7391 -- The call to Next_xxx (obj) is equivalent to obj := Next_xxx (obj)
7392 -- We define the set of Proc_Next_xxx routines simply for the purposes
7393 -- of inlining them without necessarily inlining the function.
7394
7395 procedure Proc_Next_Component (N : in out Node_Id);
7396 procedure Proc_Next_Component_Or_Discriminant (N : in out Node_Id);
7397 procedure Proc_Next_Discriminant (N : in out Node_Id);
7398 procedure Proc_Next_Formal (N : in out Node_Id);
7399 procedure Proc_Next_Formal_With_Extras (N : in out Node_Id);
7400 procedure Proc_Next_Index (N : in out Node_Id);
7401 procedure Proc_Next_Inlined_Subprogram (N : in out Node_Id);
7402 procedure Proc_Next_Literal (N : in out Node_Id);
7403 procedure Proc_Next_Stored_Discriminant (N : in out Node_Id);
7404
7405 pragma Inline (Proc_Next_Component);
7406 pragma Inline (Proc_Next_Component_Or_Discriminant);
7407 pragma Inline (Proc_Next_Discriminant);
7408 pragma Inline (Proc_Next_Formal);
7409 pragma Inline (Proc_Next_Formal_With_Extras);
7410 pragma Inline (Proc_Next_Index);
7411 pragma Inline (Proc_Next_Inlined_Subprogram);
7412 pragma Inline (Proc_Next_Literal);
7413 pragma Inline (Proc_Next_Stored_Discriminant);
7414
7415 procedure Next_Component (N : in out Node_Id)
7416 renames Proc_Next_Component;
7417
7418 procedure Next_Component_Or_Discriminant (N : in out Node_Id)
7419 renames Proc_Next_Component_Or_Discriminant;
7420
7421 procedure Next_Discriminant (N : in out Node_Id)
7422 renames Proc_Next_Discriminant;
7423
7424 procedure Next_Formal (N : in out Node_Id)
7425 renames Proc_Next_Formal;
7426
7427 procedure Next_Formal_With_Extras (N : in out Node_Id)
7428 renames Proc_Next_Formal_With_Extras;
7429
7430 procedure Next_Index (N : in out Node_Id)
7431 renames Proc_Next_Index;
7432
7433 procedure Next_Inlined_Subprogram (N : in out Node_Id)
7434 renames Proc_Next_Inlined_Subprogram;
7435
7436 procedure Next_Literal (N : in out Node_Id)
7437 renames Proc_Next_Literal;
7438
7439 procedure Next_Stored_Discriminant (N : in out Node_Id)
7440 renames Proc_Next_Stored_Discriminant;
7441
7442 ---------------------------
7443 -- Testing Warning Flags --
7444 ---------------------------
7445
7446 -- These routines are to be used rather than testing flags Warnings_Off,
7447 -- Has_Pragma_Unmodified, Has_Pragma_Unreferenced. They deal with setting
7448 -- the flags Warnings_Off_Used[_Unmodified|Unreferenced] for later access.
7449
7450 function Has_Warnings_Off (E : Entity_Id) return Boolean;
7451 -- If Warnings_Off is set on E, then returns True and also sets the flag
7452 -- Warnings_Off_Used on E. If Warnings_Off is not set on E, returns False
7453 -- and has no side effect.
7454
7455 function Has_Unmodified (E : Entity_Id) return Boolean;
7456 -- If flag Has_Pragma_Unmodified is set on E, returns True with no side
7457 -- effects. Otherwise if Warnings_Off is set on E, returns True and also
7458 -- sets the flag Warnings_Off_Used_Unmodified on E. If neither of the flags
7459 -- Warnings_Off nor Has_Pragma_Unmodified is set, returns False with no
7460 -- side effects.
7461
7462 function Has_Unreferenced (E : Entity_Id) return Boolean;
7463 -- If flag Has_Pragma_Unreferenced is set on E, returns True with no side
7464 -- effects. Otherwise if Warnings_Off is set on E, returns True and also
7465 -- sets the flag Warnings_Off_Used_Unreferenced on E. If neither of the
7466 -- flags Warnings_Off nor Has_Pragma_Unreferenced is set, returns False
7467 -- with no side effects.
7468
7469 ----------------------------------------------
7470 -- Subprograms for Accessing Rep Item Chain --
7471 ----------------------------------------------
7472
7473 -- The First_Rep_Item field of every entity points to a linked list (linked
7474 -- through Next_Rep_Item) of representation pragmas, attribute definition
7475 -- clauses, representation clauses, and aspect specifications that apply to
7476 -- the item. Note that in the case of types, it is assumed that any such
7477 -- rep items for a base type also apply to all subtypes. This is achieved
7478 -- by having the chain for subtypes link onto the chain for the base type,
7479 -- so that new entries for the subtype are added at the start of the chain.
7480 --
7481 -- Note: aspect specification nodes are linked only when evaluation of the
7482 -- expression is deferred to the freeze point. For further details see
7483 -- Sem_Ch13.Analyze_Aspect_Specifications.
7484
7485 function Get_Attribute_Definition_Clause
7486 (E : Entity_Id;
7487 Id : Attribute_Id) return Node_Id;
7488 -- Searches the Rep_Item chain for a given entity E, for an instance of an
7489 -- attribute definition clause with the given attribute Id. If found, the
7490 -- value returned is the N_Attribute_Definition_Clause node, otherwise
7491 -- Empty is returned.
7492
7493 function Get_Pragma (E : Entity_Id; Id : Pragma_Id) return Node_Id;
7494 -- Searches the Rep_Item chain of entity E, for an instance of a pragma
7495 -- with the given pragma Id. If found, the value returned is the N_Pragma
7496 -- node, otherwise Empty is returned. The following contract pragmas that
7497 -- appear in N_Contract nodes are also handled by this routine:
7498 -- Abstract_State
7499 -- Async_Readers
7500 -- Async_Writers
7501 -- Contract_Cases
7502 -- Depends
7503 -- Effective_Reads
7504 -- Effective_Writes
7505 -- Global
7506 -- Initial_Condition
7507 -- Initializes
7508 -- Precondition
7509 -- Postcondition
7510 -- Refined_Depends
7511 -- Refined_Global
7512 -- Refined_State
7513
7514 function Get_Record_Representation_Clause (E : Entity_Id) return Node_Id;
7515 -- Searches the Rep_Item chain for a given entity E, for a record
7516 -- representation clause, and if found, returns it. Returns Empty
7517 -- if no such clause is found.
7518
7519 function Present_In_Rep_Item (E : Entity_Id; N : Node_Id) return Boolean;
7520 -- Return True if N is present in the Rep_Item chain for a given entity E
7521
7522 procedure Record_Rep_Item (E : Entity_Id; N : Node_Id);
7523 -- N is the node for a representation pragma, representation clause, an
7524 -- attribute definition clause, or an aspect specification that applies to
7525 -- entity E. This procedure links the node N onto the Rep_Item chain for
7526 -- entity E. Note that it is an error to call this procedure with E being
7527 -- overloadable, and N being a pragma that applies to multiple overloadable
7528 -- entities (Convention, Interface, Inline, Inline_Always, Import, Export,
7529 -- External). This is not allowed even in the case where the entity is not
7530 -- overloaded, since we can't rely on it being present in the overloaded
7531 -- case, it is not useful to have it present in the non-overloaded case.
7532
7533 -------------------------------
7534 -- Miscellaneous Subprograms --
7535 -------------------------------
7536
7537 procedure Append_Entity (Id : Entity_Id; V : Entity_Id);
7538 -- Add an entity to the list of entities declared in the scope V
7539
7540 function Get_Full_View (T : Entity_Id) return Entity_Id;
7541 -- If T is an incomplete type and the full declaration has been seen, or
7542 -- is the name of a class_wide type whose root is incomplete, return the
7543 -- corresponding full declaration, else return T itself.
7544
7545 function Is_Entity_Name (N : Node_Id) return Boolean;
7546 -- Test if the node N is the name of an entity (i.e. is an identifier,
7547 -- expanded name, or an attribute reference that returns an entity).
7548
7549 function Next_Index (Id : Node_Id) return Node_Id;
7550 -- Given an index from a previous call to First_Index or Next_Index,
7551 -- returns a node representing the occurrence of the next index subtype,
7552 -- or Empty if there are no more index subtypes.
7553
7554 function Scope_Depth (Id : Entity_Id) return Uint;
7555 -- Returns the scope depth value of the Id, unless the Id is a record
7556 -- type, in which case it returns the scope depth of the record scope.
7557
7558 function Subtype_Kind (K : Entity_Kind) return Entity_Kind;
7559 -- Given an entity_kind K this function returns the entity_kind
7560 -- corresponding to subtype kind of the type represented by K. For
7561 -- example if K is E_Signed_Integer_Type then E_Signed_Integer_Subtype
7562 -- is returned. If K is already a subtype kind it itself is returned. An
7563 -- internal error is generated if no such correspondence exists for K.
7564
7565 ----------------------------------
7566 -- Debugging Output Subprograms --
7567 ----------------------------------
7568
7569 procedure Write_Entity_Flags (Id : Entity_Id; Prefix : String);
7570 -- Writes a series of entries giving a line for each flag that is
7571 -- set to True. Each line is prefixed by the given string
7572
7573 procedure Write_Entity_Info (Id : Entity_Id; Prefix : String);
7574 -- A debugging procedure to write out information about an entity
7575
7576 procedure Write_Field6_Name (Id : Entity_Id);
7577 procedure Write_Field7_Name (Id : Entity_Id);
7578 procedure Write_Field8_Name (Id : Entity_Id);
7579 procedure Write_Field9_Name (Id : Entity_Id);
7580 procedure Write_Field10_Name (Id : Entity_Id);
7581 procedure Write_Field11_Name (Id : Entity_Id);
7582 procedure Write_Field12_Name (Id : Entity_Id);
7583 procedure Write_Field13_Name (Id : Entity_Id);
7584 procedure Write_Field14_Name (Id : Entity_Id);
7585 procedure Write_Field15_Name (Id : Entity_Id);
7586 procedure Write_Field16_Name (Id : Entity_Id);
7587 procedure Write_Field17_Name (Id : Entity_Id);
7588 procedure Write_Field18_Name (Id : Entity_Id);
7589 procedure Write_Field19_Name (Id : Entity_Id);
7590 procedure Write_Field20_Name (Id : Entity_Id);
7591 procedure Write_Field21_Name (Id : Entity_Id);
7592 procedure Write_Field22_Name (Id : Entity_Id);
7593 procedure Write_Field23_Name (Id : Entity_Id);
7594 procedure Write_Field24_Name (Id : Entity_Id);
7595 procedure Write_Field25_Name (Id : Entity_Id);
7596 procedure Write_Field26_Name (Id : Entity_Id);
7597 procedure Write_Field27_Name (Id : Entity_Id);
7598 procedure Write_Field28_Name (Id : Entity_Id);
7599 procedure Write_Field29_Name (Id : Entity_Id);
7600 procedure Write_Field30_Name (Id : Entity_Id);
7601 procedure Write_Field31_Name (Id : Entity_Id);
7602 procedure Write_Field32_Name (Id : Entity_Id);
7603 procedure Write_Field33_Name (Id : Entity_Id);
7604 procedure Write_Field34_Name (Id : Entity_Id);
7605 procedure Write_Field35_Name (Id : Entity_Id);
7606 -- These routines are used in Treepr to output a nice symbolic name for
7607 -- the given field, depending on the Ekind. No blanks or end of lines are
7608 -- output, just the characters of the field name.
7609
7610 --------------------
7611 -- Inline Pragmas --
7612 --------------------
7613
7614 -- Note that these inline pragmas are referenced by the XEINFO utility
7615 -- program in preparing the corresponding C header, and only those
7616 -- subprograms meeting the requirements documented in the section on
7617 -- XEINFO may be referenced in this section.
7618
7619 pragma Inline (Abstract_States);
7620 pragma Inline (Accept_Address);
7621 pragma Inline (Access_Disp_Table);
7622 pragma Inline (Actual_Subtype);
7623 pragma Inline (Address_Taken);
7624 pragma Inline (Alias);
7625 pragma Inline (Alignment);
7626 pragma Inline (Associated_Formal_Package);
7627 pragma Inline (Associated_Node_For_Itype);
7628 pragma Inline (Associated_Storage_Pool);
7629 pragma Inline (Barrier_Function);
7630 pragma Inline (Block_Node);
7631 pragma Inline (Body_Entity);
7632 pragma Inline (Body_Needed_For_SAL);
7633 pragma Inline (Body_References);
7634 pragma Inline (CR_Discriminant);
7635 pragma Inline (C_Pass_By_Copy);
7636 pragma Inline (Can_Never_Be_Null);
7637 pragma Inline (Can_Use_Internal_Rep);
7638 pragma Inline (Checks_May_Be_Suppressed);
7639 pragma Inline (Class_Wide_Type);
7640 pragma Inline (Cloned_Subtype);
7641 pragma Inline (Component_Bit_Offset);
7642 pragma Inline (Component_Clause);
7643 pragma Inline (Component_Size);
7644 pragma Inline (Component_Type);
7645 pragma Inline (Contract);
7646 pragma Inline (Corresponding_Concurrent_Type);
7647 pragma Inline (Corresponding_Discriminant);
7648 pragma Inline (Corresponding_Equality);
7649 pragma Inline (Corresponding_Protected_Entry);
7650 pragma Inline (Corresponding_Record_Type);
7651 pragma Inline (Corresponding_Remote_Type);
7652 pragma Inline (Current_Use_Clause);
7653 pragma Inline (Current_Value);
7654 pragma Inline (DTC_Entity);
7655 pragma Inline (DT_Entry_Count);
7656 pragma Inline (DT_Offset_To_Top_Func);
7657 pragma Inline (DT_Position);
7658 pragma Inline (Debug_Info_Off);
7659 pragma Inline (Debug_Renaming_Link);
7660 pragma Inline (Default_Aspect_Component_Value);
7661 pragma Inline (Default_Aspect_Value);
7662 pragma Inline (Default_Expr_Function);
7663 pragma Inline (Default_Expressions_Processed);
7664 pragma Inline (Default_Value);
7665 pragma Inline (Delay_Cleanups);
7666 pragma Inline (Delay_Subprogram_Descriptors);
7667 pragma Inline (Delta_Value);
7668 pragma Inline (Dependent_Instances);
7669 pragma Inline (Depends_On_Private);
7670 pragma Inline (Digits_Value);
7671 pragma Inline (Direct_Primitive_Operations);
7672 pragma Inline (Directly_Designated_Type);
7673 pragma Inline (Discard_Names);
7674 pragma Inline (Discriminal);
7675 pragma Inline (Discriminal_Link);
7676 pragma Inline (Discriminant_Checking_Func);
7677 pragma Inline (Discriminant_Constraint);
7678 pragma Inline (Discriminant_Default_Value);
7679 pragma Inline (Discriminant_Number);
7680 pragma Inline (Dispatch_Table_Wrappers);
7681 pragma Inline (Elaborate_Body_Desirable);
7682 pragma Inline (Elaboration_Entity);
7683 pragma Inline (Elaboration_Entity_Required);
7684 pragma Inline (Enclosing_Scope);
7685 pragma Inline (Entry_Accepted);
7686 pragma Inline (Entry_Bodies_Array);
7687 pragma Inline (Entry_Cancel_Parameter);
7688 pragma Inline (Entry_Component);
7689 pragma Inline (Entry_Formal);
7690 pragma Inline (Entry_Index_Constant);
7691 pragma Inline (Entry_Index_Type);
7692 pragma Inline (Entry_Parameters_Type);
7693 pragma Inline (Enum_Pos_To_Rep);
7694 pragma Inline (Enumeration_Pos);
7695 pragma Inline (Enumeration_Rep);
7696 pragma Inline (Enumeration_Rep_Expr);
7697 pragma Inline (Equivalent_Type);
7698 pragma Inline (Esize);
7699 pragma Inline (Exception_Code);
7700 pragma Inline (Extra_Accessibility);
7701 pragma Inline (Extra_Accessibility_Of_Result);
7702 pragma Inline (Extra_Constrained);
7703 pragma Inline (Extra_Formal);
7704 pragma Inline (Extra_Formals);
7705 pragma Inline (Finalization_Master);
7706 pragma Inline (Finalizer);
7707 pragma Inline (First_Entity);
7708 pragma Inline (First_Exit_Statement);
7709 pragma Inline (First_Index);
7710 pragma Inline (First_Literal);
7711 pragma Inline (First_Optional_Parameter);
7712 pragma Inline (First_Private_Entity);
7713 pragma Inline (First_Rep_Item);
7714 pragma Inline (Freeze_Node);
7715 pragma Inline (From_Limited_With);
7716 pragma Inline (Full_View);
7717 pragma Inline (Generic_Homonym);
7718 pragma Inline (Generic_Renamings);
7719 pragma Inline (Handler_Records);
7720 pragma Inline (Has_Aliased_Components);
7721 pragma Inline (Has_Alignment_Clause);
7722 pragma Inline (Has_All_Calls_Remote);
7723 pragma Inline (Has_Anonymous_Master);
7724 pragma Inline (Has_Atomic_Components);
7725 pragma Inline (Has_Biased_Representation);
7726 pragma Inline (Has_Body_References);
7727 pragma Inline (Has_Completion);
7728 pragma Inline (Has_Completion_In_Body);
7729 pragma Inline (Has_Complex_Representation);
7730 pragma Inline (Has_Component_Size_Clause);
7731 pragma Inline (Has_Constrained_Partial_View);
7732 pragma Inline (Has_Contiguous_Rep);
7733 pragma Inline (Has_Controlled_Component);
7734 pragma Inline (Has_Controlling_Result);
7735 pragma Inline (Has_Convention_Pragma);
7736 pragma Inline (Has_Default_Aspect);
7737 pragma Inline (Has_Delayed_Aspects);
7738 pragma Inline (Has_Delayed_Freeze);
7739 pragma Inline (Has_Delayed_Rep_Aspects);
7740 pragma Inline (Has_Discriminants);
7741 pragma Inline (Has_Dispatch_Table);
7742 pragma Inline (Has_Dynamic_Predicate_Aspect);
7743 pragma Inline (Has_Enumeration_Rep_Clause);
7744 pragma Inline (Has_Exit);
7745 pragma Inline (Has_External_Tag_Rep_Clause);
7746 pragma Inline (Has_Forward_Instantiation);
7747 pragma Inline (Has_Fully_Qualified_Name);
7748 pragma Inline (Has_Gigi_Rep_Item);
7749 pragma Inline (Has_Homonym);
7750 pragma Inline (Has_Implicit_Dereference);
7751 pragma Inline (Has_Independent_Components);
7752 pragma Inline (Has_Inheritable_Invariants);
7753 pragma Inline (Has_Initial_Value);
7754 pragma Inline (Has_Invariants);
7755 pragma Inline (Has_Loop_Entry_Attributes);
7756 pragma Inline (Has_Machine_Radix_Clause);
7757 pragma Inline (Has_Master_Entity);
7758 pragma Inline (Has_Missing_Return);
7759 pragma Inline (Has_Nested_Block_With_Handler);
7760 pragma Inline (Has_Non_Standard_Rep);
7761 pragma Inline (Has_Object_Size_Clause);
7762 pragma Inline (Has_Per_Object_Constraint);
7763 pragma Inline (Has_Postconditions);
7764 pragma Inline (Has_Pragma_Controlled);
7765 pragma Inline (Has_Pragma_Elaborate_Body);
7766 pragma Inline (Has_Pragma_Inline);
7767 pragma Inline (Has_Pragma_Inline_Always);
7768 pragma Inline (Has_Pragma_No_Inline);
7769 pragma Inline (Has_Pragma_Ordered);
7770 pragma Inline (Has_Pragma_Pack);
7771 pragma Inline (Has_Pragma_Preelab_Init);
7772 pragma Inline (Has_Pragma_Pure);
7773 pragma Inline (Has_Pragma_Pure_Function);
7774 pragma Inline (Has_Pragma_Thread_Local_Storage);
7775 pragma Inline (Has_Pragma_Unmodified);
7776 pragma Inline (Has_Pragma_Unreferenced);
7777 pragma Inline (Has_Pragma_Unreferenced_Objects);
7778 pragma Inline (Has_Predicates);
7779 pragma Inline (Has_Primitive_Operations);
7780 pragma Inline (Has_Private_Ancestor);
7781 pragma Inline (Has_Private_Declaration);
7782 pragma Inline (Has_Qualified_Name);
7783 pragma Inline (Has_RACW);
7784 pragma Inline (Has_Record_Rep_Clause);
7785 pragma Inline (Has_Recursive_Call);
7786 pragma Inline (Has_Size_Clause);
7787 pragma Inline (Has_Small_Clause);
7788 pragma Inline (Has_Specified_Layout);
7789 pragma Inline (Has_Specified_Stream_Input);
7790 pragma Inline (Has_Specified_Stream_Output);
7791 pragma Inline (Has_Specified_Stream_Read);
7792 pragma Inline (Has_Specified_Stream_Write);
7793 pragma Inline (Has_Static_Discriminants);
7794 pragma Inline (Has_Static_Predicate_Aspect);
7795 pragma Inline (Has_Storage_Size_Clause);
7796 pragma Inline (Has_Stream_Size_Clause);
7797 pragma Inline (Has_Task);
7798 pragma Inline (Has_Thunks);
7799 pragma Inline (Has_Unchecked_Union);
7800 pragma Inline (Has_Unknown_Discriminants);
7801 pragma Inline (Has_Up_Level_Access);
7802 pragma Inline (Has_Visible_Refinement);
7803 pragma Inline (Has_Volatile_Components);
7804 pragma Inline (Has_Xref_Entry);
7805 pragma Inline (Hiding_Loop_Variable);
7806 pragma Inline (Homonym);
7807 pragma Inline (In_Package_Body);
7808 pragma Inline (In_Private_Part);
7809 pragma Inline (In_Use);
7810 pragma Inline (Inner_Instances);
7811 pragma Inline (Interface_Alias);
7812 pragma Inline (Interface_Name);
7813 pragma Inline (Interfaces);
7814 pragma Inline (Is_AST_Entry);
7815 pragma Inline (Is_Abstract_Subprogram);
7816 pragma Inline (Is_Abstract_Type);
7817 pragma Inline (Is_Access_Constant);
7818 pragma Inline (Is_Access_Protected_Subprogram_Type);
7819 pragma Inline (Is_Access_Subprogram_Type);
7820 pragma Inline (Is_Access_Type);
7821 pragma Inline (Is_Ada_2005_Only);
7822 pragma Inline (Is_Ada_2012_Only);
7823 pragma Inline (Is_Aggregate_Type);
7824 pragma Inline (Is_Aliased);
7825 pragma Inline (Is_Array_Type);
7826 pragma Inline (Is_Assignable);
7827 pragma Inline (Is_Asynchronous);
7828 pragma Inline (Is_Atomic);
7829 pragma Inline (Is_Bit_Packed_Array);
7830 pragma Inline (Is_CPP_Class);
7831 pragma Inline (Is_Called);
7832 pragma Inline (Is_Character_Type);
7833 pragma Inline (Is_Child_Unit);
7834 pragma Inline (Is_Class_Wide_Equivalent_Type);
7835 pragma Inline (Is_Class_Wide_Type);
7836 pragma Inline (Is_Compilation_Unit);
7837 pragma Inline (Is_Completely_Hidden);
7838 pragma Inline (Is_Composite_Type);
7839 pragma Inline (Is_Concurrent_Body);
7840 pragma Inline (Is_Concurrent_Record_Type);
7841 pragma Inline (Is_Concurrent_Type);
7842 pragma Inline (Is_Constr_Subt_For_UN_Aliased);
7843 pragma Inline (Is_Constr_Subt_For_U_Nominal);
7844 pragma Inline (Is_Constrained);
7845 pragma Inline (Is_Constructor);
7846 pragma Inline (Is_Controlled);
7847 pragma Inline (Is_Controlling_Formal);
7848 pragma Inline (Is_Decimal_Fixed_Point_Type);
7849 pragma Inline (Is_Descendent_Of_Address);
7850 pragma Inline (Is_Digits_Type);
7851 pragma Inline (Is_Discrete_Or_Fixed_Point_Type);
7852 pragma Inline (Is_Discrete_Type);
7853 pragma Inline (Is_Discrim_SO_Function);
7854 pragma Inline (Is_Dispatch_Table_Entity);
7855 pragma Inline (Is_Dispatching_Operation);
7856 pragma Inline (Is_Elementary_Type);
7857 pragma Inline (Is_Eliminated);
7858 pragma Inline (Is_Entry);
7859 pragma Inline (Is_Entry_Formal);
7860 pragma Inline (Is_Enumeration_Type);
7861 pragma Inline (Is_Exported);
7862 pragma Inline (Is_First_Subtype);
7863 pragma Inline (Is_Fixed_Point_Type);
7864 pragma Inline (Is_Floating_Point_Type);
7865 pragma Inline (Is_For_Access_Subtype);
7866 pragma Inline (Is_Formal);
7867 pragma Inline (Is_Formal_Object);
7868 pragma Inline (Is_Formal_Subprogram);
7869 pragma Inline (Is_Frozen);
7870 pragma Inline (Is_Generic_Actual_Type);
7871 pragma Inline (Is_Generic_Instance);
7872 pragma Inline (Is_Generic_Subprogram);
7873 pragma Inline (Is_Generic_Type);
7874 pragma Inline (Is_Generic_Unit);
7875 pragma Inline (Is_Hidden);
7876 pragma Inline (Is_Hidden_Open_Scope);
7877 pragma Inline (Is_Immediately_Visible);
7878 pragma Inline (Is_Implementation_Defined);
7879 pragma Inline (Is_Imported);
7880 pragma Inline (Is_Incomplete_Or_Private_Type);
7881 pragma Inline (Is_Incomplete_Type);
7882 pragma Inline (Is_Inlined);
7883 pragma Inline (Is_Instantiated);
7884 pragma Inline (Is_Integer_Type);
7885 pragma Inline (Is_Interface);
7886 pragma Inline (Is_Internal);
7887 pragma Inline (Is_Interrupt_Handler);
7888 pragma Inline (Is_Intrinsic_Subprogram);
7889 pragma Inline (Is_Invariant_Procedure);
7890 pragma Inline (Is_Itype);
7891 pragma Inline (Is_Known_Non_Null);
7892 pragma Inline (Is_Known_Null);
7893 pragma Inline (Is_Known_Valid);
7894 pragma Inline (Is_Limited_Composite);
7895 pragma Inline (Is_Limited_Interface);
7896 pragma Inline (Is_Limited_Record);
7897 pragma Inline (Is_Local_Anonymous_Access);
7898 pragma Inline (Is_Machine_Code_Subprogram);
7899 pragma Inline (Is_Modular_Integer_Type);
7900 pragma Inline (Is_Named_Number);
7901 pragma Inline (Is_Non_Static_Subtype);
7902 pragma Inline (Is_Null_Init_Proc);
7903 pragma Inline (Is_Numeric_Type);
7904 pragma Inline (Is_Object);
7905 pragma Inline (Is_Obsolescent);
7906 pragma Inline (Is_Only_Out_Parameter);
7907 pragma Inline (Is_Optional_Parameter);
7908 pragma Inline (Is_Ordinary_Fixed_Point_Type);
7909 pragma Inline (Is_Overloadable);
7910 pragma Inline (Is_Package_Body_Entity);
7911 pragma Inline (Is_Packed);
7912 pragma Inline (Is_Packed_Array_Type);
7913 pragma Inline (Is_Potentially_Use_Visible);
7914 pragma Inline (Is_Predicate_Function);
7915 pragma Inline (Is_Predicate_Function_M);
7916 pragma Inline (Is_Preelaborated);
7917 pragma Inline (Is_Primitive);
7918 pragma Inline (Is_Primitive_Wrapper);
7919 pragma Inline (Is_Private_Composite);
7920 pragma Inline (Is_Private_Descendant);
7921 pragma Inline (Is_Private_Primitive);
7922 pragma Inline (Is_Private_Type);
7923 pragma Inline (Is_Processed_Transient);
7924 pragma Inline (Is_Protected_Type);
7925 pragma Inline (Is_Public);
7926 pragma Inline (Is_Pure);
7927 pragma Inline (Is_Pure_Unit_Access_Type);
7928 pragma Inline (Is_RACW_Stub_Type);
7929 pragma Inline (Is_Raised);
7930 pragma Inline (Is_Real_Type);
7931 pragma Inline (Is_Record_Type);
7932 pragma Inline (Is_Remote_Call_Interface);
7933 pragma Inline (Is_Remote_Types);
7934 pragma Inline (Is_Renaming_Of_Object);
7935 pragma Inline (Is_Return_Object);
7936 pragma Inline (Is_Safe_To_Reevaluate);
7937 pragma Inline (Is_Scalar_Type);
7938 pragma Inline (Is_Shared_Passive);
7939 pragma Inline (Is_Signed_Integer_Type);
7940 pragma Inline (Is_Statically_Allocated);
7941 pragma Inline (Is_Subprogram);
7942 pragma Inline (Is_Tag);
7943 pragma Inline (Is_Tagged_Type);
7944 pragma Inline (Is_Task_Type);
7945 pragma Inline (Is_Thunk);
7946 pragma Inline (Is_Trivial_Subprogram);
7947 pragma Inline (Is_True_Constant);
7948 pragma Inline (Is_Type);
7949 pragma Inline (Is_Unchecked_Union);
7950 pragma Inline (Is_Underlying_Record_View);
7951 pragma Inline (Is_Unsigned_Type);
7952 pragma Inline (Is_VMS_Exception);
7953 pragma Inline (Is_Valued_Procedure);
7954 pragma Inline (Is_Visible_Formal);
7955 pragma Inline (Is_Visible_Lib_Unit);
7956 pragma Inline (Itype_Printed);
7957 pragma Inline (Kill_Elaboration_Checks);
7958 pragma Inline (Kill_Range_Checks);
7959 pragma Inline (Known_To_Have_Preelab_Init);
7960 pragma Inline (Last_Assignment);
7961 pragma Inline (Last_Entity);
7962 pragma Inline (Limited_View);
7963 pragma Inline (Lit_Indexes);
7964 pragma Inline (Lit_Strings);
7965 pragma Inline (Low_Bound_Tested);
7966 pragma Inline (Machine_Radix_10);
7967 pragma Inline (Master_Id);
7968 pragma Inline (Materialize_Entity);
7969 pragma Inline (May_Inherit_Delayed_Rep_Aspects);
7970 pragma Inline (Mechanism);
7971 pragma Inline (Modulus);
7972 pragma Inline (Must_Be_On_Byte_Boundary);
7973 pragma Inline (Must_Have_Preelab_Init);
7974 pragma Inline (Needs_Debug_Info);
7975 pragma Inline (Needs_No_Actuals);
7976 pragma Inline (Never_Set_In_Source);
7977 pragma Inline (Next_Index);
7978 pragma Inline (Next_Inlined_Subprogram);
7979 pragma Inline (Next_Literal);
7980 pragma Inline (No_Pool_Assigned);
7981 pragma Inline (No_Return);
7982 pragma Inline (No_Strict_Aliasing);
7983 pragma Inline (Non_Binary_Modulus);
7984 pragma Inline (Non_Limited_View);
7985 pragma Inline (Nonzero_Is_True);
7986 pragma Inline (Normalized_First_Bit);
7987 pragma Inline (Normalized_Position);
7988 pragma Inline (Normalized_Position_Max);
7989 pragma Inline (OK_To_Rename);
7990 pragma Inline (OK_To_Reorder_Components);
7991 pragma Inline (Optimize_Alignment_Space);
7992 pragma Inline (Optimize_Alignment_Time);
7993 pragma Inline (Original_Access_Type);
7994 pragma Inline (Original_Array_Type);
7995 pragma Inline (Original_Record_Component);
7996 pragma Inline (Overlays_Constant);
7997 pragma Inline (Overridden_Operation);
7998 pragma Inline (PPC_Wrapper);
7999 pragma Inline (Package_Instantiation);
8000 pragma Inline (Packed_Array_Type);
8001 pragma Inline (Parameter_Mode);
8002 pragma Inline (Parent_Subtype);
8003 pragma Inline (Postcondition_Proc);
8004 pragma Inline (Prival);
8005 pragma Inline (Prival_Link);
8006 pragma Inline (Private_Dependents);
8007 pragma Inline (Private_View);
8008 pragma Inline (Protected_Body_Subprogram);
8009 pragma Inline (Protected_Formal);
8010 pragma Inline (Protection_Object);
8011 pragma Inline (RM_Size);
8012 pragma Inline (Reachable);
8013 pragma Inline (Referenced);
8014 pragma Inline (Referenced_As_LHS);
8015 pragma Inline (Referenced_As_Out_Parameter);
8016 pragma Inline (Refined_State);
8017 pragma Inline (Refinement_Constituents);
8018 pragma Inline (Register_Exception_Call);
8019 pragma Inline (Related_Array_Object);
8020 pragma Inline (Related_Expression);
8021 pragma Inline (Related_Instance);
8022 pragma Inline (Related_Type);
8023 pragma Inline (Relative_Deadline_Variable);
8024 pragma Inline (Renamed_Entity);
8025 pragma Inline (Renamed_In_Spec);
8026 pragma Inline (Renamed_Object);
8027 pragma Inline (Renaming_Map);
8028 pragma Inline (Requires_Overriding);
8029 pragma Inline (Return_Applies_To);
8030 pragma Inline (Return_Present);
8031 pragma Inline (Returns_By_Ref);
8032 pragma Inline (Reverse_Bit_Order);
8033 pragma Inline (Reverse_Storage_Order);
8034 pragma Inline (Scalar_Range);
8035 pragma Inline (Scale_Value);
8036 pragma Inline (Scope_Depth_Value);
8037 pragma Inline (Sec_Stack_Needed_For_Return);
8038 pragma Inline (Shadow_Entities);
8039 pragma Inline (Shared_Var_Procs_Instance);
8040 pragma Inline (Size_Check_Code);
8041 pragma Inline (Size_Depends_On_Discriminant);
8042 pragma Inline (Size_Known_At_Compile_Time);
8043 pragma Inline (Small_Value);
8044 pragma Inline (SPARK_Aux_Pragma);
8045 pragma Inline (SPARK_Aux_Pragma_Inherited);
8046 pragma Inline (SPARK_Pragma);
8047 pragma Inline (SPARK_Pragma_Inherited);
8048 pragma Inline (Spec_Entity);
8049 pragma Inline (Static_Elaboration_Desired);
8050 pragma Inline (Static_Initialization);
8051 pragma Inline (Static_Predicate);
8052 pragma Inline (Status_Flag_Or_Transient_Decl);
8053 pragma Inline (Storage_Size_Variable);
8054 pragma Inline (Stored_Constraint);
8055 pragma Inline (Strict_Alignment);
8056 pragma Inline (String_Literal_Length);
8057 pragma Inline (String_Literal_Low_Bound);
8058 pragma Inline (Subprograms_For_Type);
8059 pragma Inline (Suppress_Elaboration_Warnings);
8060 pragma Inline (Suppress_Initialization);
8061 pragma Inline (Suppress_Style_Checks);
8062 pragma Inline (Suppress_Value_Tracking_On_Call);
8063 pragma Inline (Task_Body_Procedure);
8064 pragma Inline (Thunk_Entity);
8065 pragma Inline (Treat_As_Volatile);
8066 pragma Inline (Underlying_Full_View);
8067 pragma Inline (Underlying_Record_View);
8068 pragma Inline (Universal_Aliasing);
8069 pragma Inline (Unset_Reference);
8070 pragma Inline (Used_As_Generic_Actual);
8071 pragma Inline (Uses_Lock_Free);
8072 pragma Inline (Uses_Sec_Stack);
8073 pragma Inline (Warnings_Off);
8074 pragma Inline (Warnings_Off_Used);
8075 pragma Inline (Warnings_Off_Used_Unmodified);
8076 pragma Inline (Warnings_Off_Used_Unreferenced);
8077 pragma Inline (Was_Hidden);
8078 pragma Inline (Wrapped_Entity);
8079
8080 pragma Inline (Init_Alignment);
8081 pragma Inline (Init_Component_Bit_Offset);
8082 pragma Inline (Init_Component_Size);
8083 pragma Inline (Init_Digits_Value);
8084 pragma Inline (Init_Esize);
8085 pragma Inline (Init_RM_Size);
8086
8087 pragma Inline (Set_Abstract_States);
8088 pragma Inline (Set_Accept_Address);
8089 pragma Inline (Set_Access_Disp_Table);
8090 pragma Inline (Set_Actual_Subtype);
8091 pragma Inline (Set_Address_Taken);
8092 pragma Inline (Set_Alias);
8093 pragma Inline (Set_Alignment);
8094 pragma Inline (Set_Associated_Formal_Package);
8095 pragma Inline (Set_Associated_Node_For_Itype);
8096 pragma Inline (Set_Associated_Storage_Pool);
8097 pragma Inline (Set_Barrier_Function);
8098 pragma Inline (Set_Block_Node);
8099 pragma Inline (Set_Body_Entity);
8100 pragma Inline (Set_Body_Needed_For_SAL);
8101 pragma Inline (Set_Body_References);
8102 pragma Inline (Set_CR_Discriminant);
8103 pragma Inline (Set_C_Pass_By_Copy);
8104 pragma Inline (Set_Can_Never_Be_Null);
8105 pragma Inline (Set_Can_Use_Internal_Rep);
8106 pragma Inline (Set_Checks_May_Be_Suppressed);
8107 pragma Inline (Set_Class_Wide_Type);
8108 pragma Inline (Set_Cloned_Subtype);
8109 pragma Inline (Set_Component_Bit_Offset);
8110 pragma Inline (Set_Component_Clause);
8111 pragma Inline (Set_Component_Size);
8112 pragma Inline (Set_Component_Type);
8113 pragma Inline (Set_Contract);
8114 pragma Inline (Set_Corresponding_Concurrent_Type);
8115 pragma Inline (Set_Corresponding_Discriminant);
8116 pragma Inline (Set_Corresponding_Equality);
8117 pragma Inline (Set_Corresponding_Protected_Entry);
8118 pragma Inline (Set_Corresponding_Record_Type);
8119 pragma Inline (Set_Corresponding_Remote_Type);
8120 pragma Inline (Set_Current_Use_Clause);
8121 pragma Inline (Set_Current_Value);
8122 pragma Inline (Set_DTC_Entity);
8123 pragma Inline (Set_DT_Entry_Count);
8124 pragma Inline (Set_DT_Offset_To_Top_Func);
8125 pragma Inline (Set_DT_Position);
8126 pragma Inline (Set_Debug_Info_Off);
8127 pragma Inline (Set_Debug_Renaming_Link);
8128 pragma Inline (Set_Default_Aspect_Component_Value);
8129 pragma Inline (Set_Default_Aspect_Value);
8130 pragma Inline (Set_Default_Expr_Function);
8131 pragma Inline (Set_Default_Expressions_Processed);
8132 pragma Inline (Set_Default_Value);
8133 pragma Inline (Set_Delay_Cleanups);
8134 pragma Inline (Set_Delay_Subprogram_Descriptors);
8135 pragma Inline (Set_Delta_Value);
8136 pragma Inline (Set_Dependent_Instances);
8137 pragma Inline (Set_Depends_On_Private);
8138 pragma Inline (Set_Digits_Value);
8139 pragma Inline (Set_Direct_Primitive_Operations);
8140 pragma Inline (Set_Directly_Designated_Type);
8141 pragma Inline (Set_Discard_Names);
8142 pragma Inline (Set_Discriminal);
8143 pragma Inline (Set_Discriminal_Link);
8144 pragma Inline (Set_Discriminant_Checking_Func);
8145 pragma Inline (Set_Discriminant_Constraint);
8146 pragma Inline (Set_Discriminant_Default_Value);
8147 pragma Inline (Set_Discriminant_Number);
8148 pragma Inline (Set_Dispatch_Table_Wrappers);
8149 pragma Inline (Set_Elaborate_Body_Desirable);
8150 pragma Inline (Set_Elaboration_Entity);
8151 pragma Inline (Set_Elaboration_Entity_Required);
8152 pragma Inline (Set_Enclosing_Scope);
8153 pragma Inline (Set_Entry_Accepted);
8154 pragma Inline (Set_Entry_Bodies_Array);
8155 pragma Inline (Set_Entry_Cancel_Parameter);
8156 pragma Inline (Set_Entry_Component);
8157 pragma Inline (Set_Entry_Formal);
8158 pragma Inline (Set_Entry_Parameters_Type);
8159 pragma Inline (Set_Enum_Pos_To_Rep);
8160 pragma Inline (Set_Enumeration_Pos);
8161 pragma Inline (Set_Enumeration_Rep);
8162 pragma Inline (Set_Enumeration_Rep_Expr);
8163 pragma Inline (Set_Equivalent_Type);
8164 pragma Inline (Set_Esize);
8165 pragma Inline (Set_Exception_Code);
8166 pragma Inline (Set_Extra_Accessibility);
8167 pragma Inline (Set_Extra_Accessibility_Of_Result);
8168 pragma Inline (Set_Extra_Constrained);
8169 pragma Inline (Set_Extra_Formal);
8170 pragma Inline (Set_Extra_Formals);
8171 pragma Inline (Set_Finalization_Master);
8172 pragma Inline (Set_Finalizer);
8173 pragma Inline (Set_First_Entity);
8174 pragma Inline (Set_First_Exit_Statement);
8175 pragma Inline (Set_First_Index);
8176 pragma Inline (Set_First_Literal);
8177 pragma Inline (Set_First_Optional_Parameter);
8178 pragma Inline (Set_First_Private_Entity);
8179 pragma Inline (Set_First_Rep_Item);
8180 pragma Inline (Set_Freeze_Node);
8181 pragma Inline (Set_From_Limited_With);
8182 pragma Inline (Set_Full_View);
8183 pragma Inline (Set_Generic_Homonym);
8184 pragma Inline (Set_Generic_Renamings);
8185 pragma Inline (Set_Handler_Records);
8186 pragma Inline (Set_Has_Aliased_Components);
8187 pragma Inline (Set_Has_Alignment_Clause);
8188 pragma Inline (Set_Has_All_Calls_Remote);
8189 pragma Inline (Set_Has_Anonymous_Master);
8190 pragma Inline (Set_Has_Atomic_Components);
8191 pragma Inline (Set_Has_Biased_Representation);
8192 pragma Inline (Set_Has_Body_References);
8193 pragma Inline (Set_Has_Completion);
8194 pragma Inline (Set_Has_Completion_In_Body);
8195 pragma Inline (Set_Has_Complex_Representation);
8196 pragma Inline (Set_Has_Component_Size_Clause);
8197 pragma Inline (Set_Has_Constrained_Partial_View);
8198 pragma Inline (Set_Has_Contiguous_Rep);
8199 pragma Inline (Set_Has_Controlled_Component);
8200 pragma Inline (Set_Has_Controlling_Result);
8201 pragma Inline (Set_Has_Convention_Pragma);
8202 pragma Inline (Set_Has_Default_Aspect);
8203 pragma Inline (Set_Has_Delayed_Aspects);
8204 pragma Inline (Set_Has_Delayed_Freeze);
8205 pragma Inline (Set_Has_Delayed_Rep_Aspects);
8206 pragma Inline (Set_Has_Discriminants);
8207 pragma Inline (Set_Has_Dispatch_Table);
8208 pragma Inline (Set_Has_Dynamic_Predicate_Aspect);
8209 pragma Inline (Set_Has_Enumeration_Rep_Clause);
8210 pragma Inline (Set_Has_Exit);
8211 pragma Inline (Set_Has_External_Tag_Rep_Clause);
8212 pragma Inline (Set_Has_Forward_Instantiation);
8213 pragma Inline (Set_Has_Fully_Qualified_Name);
8214 pragma Inline (Set_Has_Gigi_Rep_Item);
8215 pragma Inline (Set_Has_Homonym);
8216 pragma Inline (Set_Has_Implicit_Dereference);
8217 pragma Inline (Set_Has_Independent_Components);
8218 pragma Inline (Set_Has_Inheritable_Invariants);
8219 pragma Inline (Set_Has_Initial_Value);
8220 pragma Inline (Set_Has_Invariants);
8221 pragma Inline (Set_Has_Loop_Entry_Attributes);
8222 pragma Inline (Set_Has_Machine_Radix_Clause);
8223 pragma Inline (Set_Has_Master_Entity);
8224 pragma Inline (Set_Has_Missing_Return);
8225 pragma Inline (Set_Has_Nested_Block_With_Handler);
8226 pragma Inline (Set_Has_Non_Standard_Rep);
8227 pragma Inline (Set_Has_Object_Size_Clause);
8228 pragma Inline (Set_Has_Per_Object_Constraint);
8229 pragma Inline (Set_Has_Postconditions);
8230 pragma Inline (Set_Has_Pragma_Controlled);
8231 pragma Inline (Set_Has_Pragma_Elaborate_Body);
8232 pragma Inline (Set_Has_Pragma_Inline);
8233 pragma Inline (Set_Has_Pragma_Inline_Always);
8234 pragma Inline (Set_Has_Pragma_No_Inline);
8235 pragma Inline (Set_Has_Pragma_Ordered);
8236 pragma Inline (Set_Has_Pragma_Pack);
8237 pragma Inline (Set_Has_Pragma_Preelab_Init);
8238 pragma Inline (Set_Has_Pragma_Pure);
8239 pragma Inline (Set_Has_Pragma_Pure_Function);
8240 pragma Inline (Set_Has_Pragma_Thread_Local_Storage);
8241 pragma Inline (Set_Has_Pragma_Unmodified);
8242 pragma Inline (Set_Has_Pragma_Unreferenced);
8243 pragma Inline (Set_Has_Pragma_Unreferenced_Objects);
8244 pragma Inline (Set_Has_Predicates);
8245 pragma Inline (Set_Has_Primitive_Operations);
8246 pragma Inline (Set_Has_Private_Ancestor);
8247 pragma Inline (Set_Has_Private_Declaration);
8248 pragma Inline (Set_Has_Qualified_Name);
8249 pragma Inline (Set_Has_RACW);
8250 pragma Inline (Set_Has_Record_Rep_Clause);
8251 pragma Inline (Set_Has_Recursive_Call);
8252 pragma Inline (Set_Has_Size_Clause);
8253 pragma Inline (Set_Has_Small_Clause);
8254 pragma Inline (Set_Has_Specified_Layout);
8255 pragma Inline (Set_Has_Specified_Stream_Input);
8256 pragma Inline (Set_Has_Specified_Stream_Output);
8257 pragma Inline (Set_Has_Specified_Stream_Read);
8258 pragma Inline (Set_Has_Specified_Stream_Write);
8259 pragma Inline (Set_Has_Static_Discriminants);
8260 pragma Inline (Set_Has_Static_Predicate_Aspect);
8261 pragma Inline (Set_Has_Storage_Size_Clause);
8262 pragma Inline (Set_Has_Stream_Size_Clause);
8263 pragma Inline (Set_Has_Task);
8264 pragma Inline (Set_Has_Thunks);
8265 pragma Inline (Set_Has_Unchecked_Union);
8266 pragma Inline (Set_Has_Unknown_Discriminants);
8267 pragma Inline (Set_Has_Up_Level_Access);
8268 pragma Inline (Set_Has_Visible_Refinement);
8269 pragma Inline (Set_Has_Volatile_Components);
8270 pragma Inline (Set_Has_Xref_Entry);
8271 pragma Inline (Set_Hiding_Loop_Variable);
8272 pragma Inline (Set_Homonym);
8273 pragma Inline (Set_In_Package_Body);
8274 pragma Inline (Set_In_Private_Part);
8275 pragma Inline (Set_In_Use);
8276 pragma Inline (Set_Inner_Instances);
8277 pragma Inline (Set_Interface_Alias);
8278 pragma Inline (Set_Interface_Name);
8279 pragma Inline (Set_Interfaces);
8280 pragma Inline (Set_Is_AST_Entry);
8281 pragma Inline (Set_Is_Abstract_Subprogram);
8282 pragma Inline (Set_Is_Abstract_Type);
8283 pragma Inline (Set_Is_Access_Constant);
8284 pragma Inline (Set_Is_Ada_2005_Only);
8285 pragma Inline (Set_Is_Ada_2012_Only);
8286 pragma Inline (Set_Is_Aliased);
8287 pragma Inline (Set_Is_Asynchronous);
8288 pragma Inline (Set_Is_Atomic);
8289 pragma Inline (Set_Is_Bit_Packed_Array);
8290 pragma Inline (Set_Is_CPP_Class);
8291 pragma Inline (Set_Is_Called);
8292 pragma Inline (Set_Is_Character_Type);
8293 pragma Inline (Set_Is_Child_Unit);
8294 pragma Inline (Set_Is_Class_Wide_Equivalent_Type);
8295 pragma Inline (Set_Is_Compilation_Unit);
8296 pragma Inline (Set_Is_Completely_Hidden);
8297 pragma Inline (Set_Is_Concurrent_Record_Type);
8298 pragma Inline (Set_Is_Constr_Subt_For_UN_Aliased);
8299 pragma Inline (Set_Is_Constr_Subt_For_U_Nominal);
8300 pragma Inline (Set_Is_Constrained);
8301 pragma Inline (Set_Is_Constructor);
8302 pragma Inline (Set_Is_Controlled);
8303 pragma Inline (Set_Is_Controlling_Formal);
8304 pragma Inline (Set_Is_Descendent_Of_Address);
8305 pragma Inline (Set_Is_Discrim_SO_Function);
8306 pragma Inline (Set_Is_Dispatch_Table_Entity);
8307 pragma Inline (Set_Is_Dispatching_Operation);
8308 pragma Inline (Set_Is_Eliminated);
8309 pragma Inline (Set_Is_Entry_Formal);
8310 pragma Inline (Set_Is_Exported);
8311 pragma Inline (Set_Is_First_Subtype);
8312 pragma Inline (Set_Is_For_Access_Subtype);
8313 pragma Inline (Set_Is_Formal_Subprogram);
8314 pragma Inline (Set_Is_Frozen);
8315 pragma Inline (Set_Is_Generic_Actual_Type);
8316 pragma Inline (Set_Is_Generic_Instance);
8317 pragma Inline (Set_Is_Generic_Type);
8318 pragma Inline (Set_Is_Hidden);
8319 pragma Inline (Set_Is_Hidden_Open_Scope);
8320 pragma Inline (Set_Is_Immediately_Visible);
8321 pragma Inline (Set_Is_Implementation_Defined);
8322 pragma Inline (Set_Is_Imported);
8323 pragma Inline (Set_Is_Inlined);
8324 pragma Inline (Set_Is_Instantiated);
8325 pragma Inline (Set_Is_Interface);
8326 pragma Inline (Set_Is_Internal);
8327 pragma Inline (Set_Is_Interrupt_Handler);
8328 pragma Inline (Set_Is_Intrinsic_Subprogram);
8329 pragma Inline (Set_Is_Invariant_Procedure);
8330 pragma Inline (Set_Is_Itype);
8331 pragma Inline (Set_Is_Known_Non_Null);
8332 pragma Inline (Set_Is_Known_Null);
8333 pragma Inline (Set_Is_Known_Valid);
8334 pragma Inline (Set_Is_Limited_Composite);
8335 pragma Inline (Set_Is_Limited_Interface);
8336 pragma Inline (Set_Is_Limited_Record);
8337 pragma Inline (Set_Is_Local_Anonymous_Access);
8338 pragma Inline (Set_Is_Machine_Code_Subprogram);
8339 pragma Inline (Set_Is_Non_Static_Subtype);
8340 pragma Inline (Set_Is_Null_Init_Proc);
8341 pragma Inline (Set_Is_Obsolescent);
8342 pragma Inline (Set_Is_Only_Out_Parameter);
8343 pragma Inline (Set_Is_Optional_Parameter);
8344 pragma Inline (Set_Is_Package_Body_Entity);
8345 pragma Inline (Set_Is_Packed);
8346 pragma Inline (Set_Is_Packed_Array_Type);
8347 pragma Inline (Set_Is_Potentially_Use_Visible);
8348 pragma Inline (Set_Is_Predicate_Function);
8349 pragma Inline (Set_Is_Predicate_Function_M);
8350 pragma Inline (Set_Is_Preelaborated);
8351 pragma Inline (Set_Is_Primitive);
8352 pragma Inline (Set_Is_Primitive_Wrapper);
8353 pragma Inline (Set_Is_Private_Composite);
8354 pragma Inline (Set_Is_Private_Descendant);
8355 pragma Inline (Set_Is_Private_Primitive);
8356 pragma Inline (Set_Is_Processed_Transient);
8357 pragma Inline (Set_Is_Public);
8358 pragma Inline (Set_Is_Pure);
8359 pragma Inline (Set_Is_Pure_Unit_Access_Type);
8360 pragma Inline (Set_Is_RACW_Stub_Type);
8361 pragma Inline (Set_Is_Raised);
8362 pragma Inline (Set_Is_Remote_Call_Interface);
8363 pragma Inline (Set_Is_Remote_Types);
8364 pragma Inline (Set_Is_Renaming_Of_Object);
8365 pragma Inline (Set_Is_Return_Object);
8366 pragma Inline (Set_Is_Safe_To_Reevaluate);
8367 pragma Inline (Set_Is_Shared_Passive);
8368 pragma Inline (Set_Is_Statically_Allocated);
8369 pragma Inline (Set_Is_Tag);
8370 pragma Inline (Set_Is_Tagged_Type);
8371 pragma Inline (Set_Is_Thunk);
8372 pragma Inline (Set_Is_Trivial_Subprogram);
8373 pragma Inline (Set_Is_True_Constant);
8374 pragma Inline (Set_Is_Unchecked_Union);
8375 pragma Inline (Set_Is_Underlying_Record_View);
8376 pragma Inline (Set_Is_Unsigned_Type);
8377 pragma Inline (Set_Is_VMS_Exception);
8378 pragma Inline (Set_Is_Valued_Procedure);
8379 pragma Inline (Set_Is_Visible_Formal);
8380 pragma Inline (Set_Is_Visible_Lib_Unit);
8381 pragma Inline (Set_Is_Volatile);
8382 pragma Inline (Set_Itype_Printed);
8383 pragma Inline (Set_Kill_Elaboration_Checks);
8384 pragma Inline (Set_Kill_Range_Checks);
8385 pragma Inline (Set_Known_To_Have_Preelab_Init);
8386 pragma Inline (Set_Last_Assignment);
8387 pragma Inline (Set_Last_Entity);
8388 pragma Inline (Set_Limited_View);
8389 pragma Inline (Set_Lit_Indexes);
8390 pragma Inline (Set_Lit_Strings);
8391 pragma Inline (Set_Low_Bound_Tested);
8392 pragma Inline (Set_Machine_Radix_10);
8393 pragma Inline (Set_Master_Id);
8394 pragma Inline (Set_Materialize_Entity);
8395 pragma Inline (Set_May_Inherit_Delayed_Rep_Aspects);
8396 pragma Inline (Set_Mechanism);
8397 pragma Inline (Set_Modulus);
8398 pragma Inline (Set_Must_Be_On_Byte_Boundary);
8399 pragma Inline (Set_Must_Have_Preelab_Init);
8400 pragma Inline (Set_Needs_Debug_Info);
8401 pragma Inline (Set_Needs_No_Actuals);
8402 pragma Inline (Set_Never_Set_In_Source);
8403 pragma Inline (Set_Next_Inlined_Subprogram);
8404 pragma Inline (Set_No_Pool_Assigned);
8405 pragma Inline (Set_No_Return);
8406 pragma Inline (Set_No_Strict_Aliasing);
8407 pragma Inline (Set_Non_Binary_Modulus);
8408 pragma Inline (Set_Non_Limited_View);
8409 pragma Inline (Set_Nonzero_Is_True);
8410 pragma Inline (Set_Normalized_First_Bit);
8411 pragma Inline (Set_Normalized_Position);
8412 pragma Inline (Set_Normalized_Position_Max);
8413 pragma Inline (Set_OK_To_Rename);
8414 pragma Inline (Set_OK_To_Reorder_Components);
8415 pragma Inline (Set_Optimize_Alignment_Space);
8416 pragma Inline (Set_Optimize_Alignment_Time);
8417 pragma Inline (Set_Original_Access_Type);
8418 pragma Inline (Set_Original_Array_Type);
8419 pragma Inline (Set_Original_Record_Component);
8420 pragma Inline (Set_Overlays_Constant);
8421 pragma Inline (Set_Overridden_Operation);
8422 pragma Inline (Set_PPC_Wrapper);
8423 pragma Inline (Set_Package_Instantiation);
8424 pragma Inline (Set_Packed_Array_Type);
8425 pragma Inline (Set_Parent_Subtype);
8426 pragma Inline (Set_Postcondition_Proc);
8427 pragma Inline (Set_Prival);
8428 pragma Inline (Set_Prival_Link);
8429 pragma Inline (Set_Private_Dependents);
8430 pragma Inline (Set_Private_View);
8431 pragma Inline (Set_Protected_Body_Subprogram);
8432 pragma Inline (Set_Protected_Formal);
8433 pragma Inline (Set_Protection_Object);
8434 pragma Inline (Set_RM_Size);
8435 pragma Inline (Set_Reachable);
8436 pragma Inline (Set_Referenced);
8437 pragma Inline (Set_Referenced_As_LHS);
8438 pragma Inline (Set_Referenced_As_Out_Parameter);
8439 pragma Inline (Set_Refined_State);
8440 pragma Inline (Set_Refinement_Constituents);
8441 pragma Inline (Set_Register_Exception_Call);
8442 pragma Inline (Set_Related_Array_Object);
8443 pragma Inline (Set_Related_Expression);
8444 pragma Inline (Set_Related_Instance);
8445 pragma Inline (Set_Related_Type);
8446 pragma Inline (Set_Relative_Deadline_Variable);
8447 pragma Inline (Set_Renamed_Entity);
8448 pragma Inline (Set_Renamed_In_Spec);
8449 pragma Inline (Set_Renamed_Object);
8450 pragma Inline (Set_Renaming_Map);
8451 pragma Inline (Set_Requires_Overriding);
8452 pragma Inline (Set_Return_Applies_To);
8453 pragma Inline (Set_Return_Present);
8454 pragma Inline (Set_Returns_By_Ref);
8455 pragma Inline (Set_Reverse_Bit_Order);
8456 pragma Inline (Set_Reverse_Storage_Order);
8457 pragma Inline (Set_Scalar_Range);
8458 pragma Inline (Set_Scale_Value);
8459 pragma Inline (Set_Scope_Depth_Value);
8460 pragma Inline (Set_Sec_Stack_Needed_For_Return);
8461 pragma Inline (Set_Shadow_Entities);
8462 pragma Inline (Set_Shared_Var_Procs_Instance);
8463 pragma Inline (Set_Size_Check_Code);
8464 pragma Inline (Set_Size_Depends_On_Discriminant);
8465 pragma Inline (Set_Size_Known_At_Compile_Time);
8466 pragma Inline (Set_Small_Value);
8467 pragma Inline (Set_SPARK_Aux_Pragma);
8468 pragma Inline (Set_SPARK_Aux_Pragma_Inherited);
8469 pragma Inline (Set_SPARK_Pragma);
8470 pragma Inline (Set_SPARK_Pragma_Inherited);
8471 pragma Inline (Set_Spec_Entity);
8472 pragma Inline (Set_Static_Elaboration_Desired);
8473 pragma Inline (Set_Static_Initialization);
8474 pragma Inline (Set_Static_Predicate);
8475 pragma Inline (Set_Status_Flag_Or_Transient_Decl);
8476 pragma Inline (Set_Storage_Size_Variable);
8477 pragma Inline (Set_Stored_Constraint);
8478 pragma Inline (Set_Strict_Alignment);
8479 pragma Inline (Set_String_Literal_Length);
8480 pragma Inline (Set_String_Literal_Low_Bound);
8481 pragma Inline (Set_Subprograms_For_Type);
8482 pragma Inline (Set_Suppress_Elaboration_Warnings);
8483 pragma Inline (Set_Suppress_Initialization);
8484 pragma Inline (Set_Suppress_Style_Checks);
8485 pragma Inline (Set_Suppress_Value_Tracking_On_Call);
8486 pragma Inline (Set_Task_Body_Procedure);
8487 pragma Inline (Set_Thunk_Entity);
8488 pragma Inline (Set_Treat_As_Volatile);
8489 pragma Inline (Set_Underlying_Full_View);
8490 pragma Inline (Set_Underlying_Record_View);
8491 pragma Inline (Set_Universal_Aliasing);
8492 pragma Inline (Set_Unset_Reference);
8493 pragma Inline (Set_Used_As_Generic_Actual);
8494 pragma Inline (Set_Uses_Lock_Free);
8495 pragma Inline (Set_Uses_Sec_Stack);
8496 pragma Inline (Set_Warnings_Off);
8497 pragma Inline (Set_Warnings_Off_Used);
8498 pragma Inline (Set_Warnings_Off_Used_Unmodified);
8499 pragma Inline (Set_Warnings_Off_Used_Unreferenced);
8500 pragma Inline (Set_Was_Hidden);
8501 pragma Inline (Set_Wrapped_Entity);
8502
8503 -- END XEINFO INLINES
8504
8505 -- The following Inline pragmas are *not* read by xeinfo when building
8506 -- the C version of this interface automatically (so the C version will
8507 -- end up making out of line calls). The pragma scan in xeinfo will be
8508 -- terminated on encountering the END XEINFO INLINES line. We inline
8509 -- things here which are small, but not of the canonical attribute
8510 -- access/set format that can be handled by xeinfo.
8511
8512 pragma Inline (Base_Type);
8513 pragma Inline (Is_Base_Type);
8514 pragma Inline (Is_Package_Or_Generic_Package);
8515 pragma Inline (Is_Volatile);
8516 pragma Inline (Is_Wrapper_Package);
8517 pragma Inline (Known_RM_Size);
8518 pragma Inline (Known_Static_Component_Bit_Offset);
8519 pragma Inline (Known_Static_RM_Size);
8520 pragma Inline (Scope_Depth);
8521 pragma Inline (Scope_Depth_Set);
8522 pragma Inline (Unknown_RM_Size);
8523
8524 end Einfo;