* gimplify.c (find_single_pointer_decl_1): New static function.
[official-gcc.git] / gcc / ada / einfo.ads
blob189a9ecfffe78c28e44c9bd4e96e26d5bbe590e0
1 ------------------------------------------------------------------------------
2 -- --
3 -- GNAT COMPILER COMPONENTS --
4 -- --
5 -- E I N F O --
6 -- --
7 -- S p e c --
8 -- --
9 -- Copyright (C) 1992-2005, 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 2, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
17 -- for more details. You should have received a copy of the GNU General --
18 -- Public License distributed with GNAT; see file COPYING. If not, write --
19 -- to the Free Software Foundation, 51 Franklin Street, Fifth Floor, --
20 -- Boston, MA 02110-1301, USA. --
21 -- --
22 -- As a special exception, if other files instantiate generics from this --
23 -- unit, or you link this unit with other files to produce an executable, --
24 -- this unit does not by itself cause the resulting executable to be --
25 -- covered by the GNU General Public License. This exception does not --
26 -- however invalidate any other reasons why the executable file might be --
27 -- covered by the GNU Public License. --
28 -- --
29 -- GNAT was originally developed by the GNAT team at New York University. --
30 -- Extensive contributions were provided by Ada Core Technologies Inc. --
31 -- --
32 ------------------------------------------------------------------------------
34 with Snames; use Snames;
35 with Types; use Types;
36 with Uintp; use Uintp;
37 with Urealp; use Urealp;
39 package Einfo is
41 -- This package defines the annotations to the abstract syntax tree that
42 -- are needed to support semantic processing of an Ada compilation.
44 -- Note that after editing this spec and the corresponding body it is
45 -- required to run ceinfo to check the consistentcy of spec and body.
46 -- See ceinfo.adb for more information about the checks made.
48 -- These annotations are for the most part attributes of declared entities,
49 -- and they correspond to conventional symbol table information. Other
50 -- attributes include sets of meanings for overloaded names, possible
51 -- types for overloaded expressions, flags to indicate deferred constants,
52 -- incomplete types, etc. These attributes are stored in available fields
53 -- in tree nodes (i.e. fields not used by the parser, as defined by the
54 -- Sinfo package specification), and accessed by means of a set of
55 -- subprograms which define an abstract interface.
57 -- There are two kinds of semantic information
59 -- First, the tree nodes with the following Nkind values:
61 -- N_Defining_Identifier
62 -- N_Defining_Character_Literal
63 -- N_Defining_Operator_Symbol
65 -- are called Entities, and constitute the information that would often
66 -- be stored separately in a symbol table. These nodes are all extended
67 -- to provide extra space, and contain fields which depend on the entity
68 -- kind, as defined by the contents of the Ekind field. The use of the
69 -- Ekind field, and the associated fields in the entity, are defined
70 -- in this package, as are the access functions to these fields.
72 -- Second, in some cases semantic information is stored directly in other
73 -- kinds of nodes, e.g. the Etype field, used to indicate the type of an
74 -- expression. The access functions to these fields are defined in the
75 -- Sinfo package, but their full documentation is to be found in
76 -- the Einfo package specification.
78 -- Declaration processing places information in the nodes of their defining
79 -- identifiers. Name resolution places in all other occurrences of an
80 -- identifier a pointer to the corresponding defining occurrence.
82 --------------------------------
83 -- The XEINFO Utility Program --
84 --------------------------------
86 -- XEINFO is a utility program which automatically produces a C header file,
87 -- a-xeinfo.h from the spec and body of package Einfo. It reads the input
88 -- files einfo.ads and einfo.adb and produces the output file a-xeinfo.h.
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.
94 -- The general form of einfo.ads is as follows:
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
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.
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 xeinfo.adb, and processes it into C code. This results in some strict
111 -- restrictions on which functions can be inlined:
113 -- The function spec must be on a single line
115 -- There can only be a single statement, contained on a single line,
116 -- not counting any pragma Assert statements.
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.
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.
126 ----------------------------------
127 -- Handling of Type'Size Values --
128 ----------------------------------
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 incompatibilies in
134 -- existing code.
136 -- We proceed as follows, for discrete and fixed-point subtypes, we have
137 -- two separate sizes for each subtype:
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.
147 -- The default rules for the value of Object_Size for fixed-point and
148 -- discrete types are as follows:
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.
155 -- The Object_Size of a subtype is the same as the Object_Size of
156 -- the subtype from which it is obtained.
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.
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).
170 -- The default rule for the value of Value_Size are as follows:
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).
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".)
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
186 -- The RM defined attribute Size corresponds to the Value_Size attribute
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 -- otyher 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.
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.
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).
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):
211 -- Object_Size Value_Size
213 -- type x1 is range 0..5; 8 3
215 -- type x2 is range 0..5;
216 -- for x2'size use 12; 12 12
218 -- subtype x3 is x2 range 0 .. 3; 12 2
220 -- subtype x4 is x2'base range 0 .. 10; 8 4
222 -- subtype x5 is x2 range 0 .. dynamic; 12 (7)
224 -- subtype x6 is x2'base range 0 .. dynamic; 8 (7)
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.
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:
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
238 -- The RM_Size field keeps track of the RM Size as needed in these
239 -- three situations.
241 -- For types other than discrete and fixed-point types, the Object_Size
242 -- and Value_Size are the same (and equivalent to the RM attribute Size).
243 -- Only Size may be specified for such types.
245 -----------------------
246 -- Entity Attributes --
247 -----------------------
249 -- This section contains a complete list of the attributes that are defined
250 -- on entities. Some attributes apply to all entities, others only to certain
251 -- kinds of entities. In the latter case the attribute should only be set or
252 -- accessed if the Ekind field indicates an appropriate entity.
254 -- There are two kinds of attributes that apply to entities, stored and
255 -- synthesized. Stored attributes correspond to a field or flag in the entity
256 -- itself. Such attributes are identified in the table below by giving the
257 -- field or flag in the attribute that is used to hold the attribute value.
258 -- Synthesized attributes are not stored directly, but are rather computed as
259 -- needed from other attributes, or from information in the tree. These are
260 -- marked "synthesized" in the table below. The stored attributes have both
261 -- access functions and set procedures to set the corresponding values, while
262 -- synthesized attributes have only access functions.
264 -- Note: in the case of Node, Uint, or Elist fields, there are cases where
265 -- the same physical field is used for different purposes in different
266 -- entities, so these access functions should only be referenced for the
267 -- class of entities in which they are defined as being present. Flags are
268 -- not overlapped in this way, but nevertheless as a matter of style and
269 -- abstraction (which may or may not be checked by assertions in the body),
270 -- this restriction should be observed for flag fields as well.
272 -- Note: certain of the attributes on types apply only to base types, and
273 -- are so noted by the notation [base type only]. These are cases where the
274 -- attribute of any subtype is the same as the attribute of the base type.
275 -- The attribute can be referenced on a subtype (and automatically retrieves
276 -- the value from the base type). However, it is an error to try to set the
277 -- attribute on other than the base type, and if assertions are enabled,
278 -- an attempt to set the attribute on a subtype will raise an assert error.
280 -- Other attributes are noted as applying the implementation base type only.
281 -- These are representation attributes which must always apply to a full
282 -- non-private type, and where the attributes are always on the full type.
283 -- The attribute can be referenced on a subtype (and automatically retries
284 -- the value from the implementation base type). However, it is an error
285 -- to try to set the attribute on other than the implementation base type,
286 -- and if assertions are enabled, an attempt to set the attribute on a
287 -- subtype will raise an assert error.
289 -- Abstract_Interfaces (Elist24)
290 -- Present in record types and subtypes. List of abstract interfaces
291 -- implemented by a tagged type that are not already implemented by the
292 -- ancestors (Ada 2005: AI-251).
294 -- Abstract_Interface_Alias (Node25)
295 -- Present in subprograms that cover a primitive operation of an abstract
296 -- interface type. Points to its associated interface subprogram. It is
297 -- used to register the subprogram in secondary dispatch table of the
298 -- interface (Ada 2005: AI-251).
300 -- Accept_Address (Elist21)
301 -- Present in entries. If an accept has a statement sequence, then an
302 -- address variable is created, which is used to hold the address of the
303 -- parameters, as passed by the runtime. Accept_Address holds an element
304 -- list which represents a stack of entities for these address variables.
305 -- The current entry is the top of the stack, which is the last element
306 -- on the list. A stack is required to handle the case of nested select
307 -- statements referencing the same entry.
309 -- Actual_Subtype (Node17)
310 -- Present in variables, constants, and formal parameters. This is the
311 -- subtype imposed by the value of the object, as opposed to its nominal
312 -- subtype, which is imposed by the declaration. The actual subtype
313 -- differs from the nominal one when the latter is indefinite (as in the
314 -- case of an unconstrained formal parameter, or a variable declared
315 -- with an unconstrained type and an initial value). The nominal subtype
316 -- is the Etype entry for the entity. The Actual_Subtype field is set
317 -- only if the actual subtype differs from the nominal subtype. If the
318 -- actual and nominal subtypes are the same, then the Actual_Subtype
319 -- field is Empty, and Etype indicates both types.
321 -- For objects, the Actual_Subtype is set only if this is a discriminated
322 -- type. For arrays, the bounds of the expression are obtained and the
323 -- Etype of the object is directly the constrained subtype. This is
324 -- rather irregular, and the semantic checks that depend on the nominal
325 -- subtype being unconstrained use flag Is_Constr_Subt_For_U_Nominal(qv).
327 -- Access_Disp_Table (Elist16) [implementation base type only]
328 -- Present in record type entities. For a tagged type, points to the
329 -- dispatch tables associated with the tagged type. For a non-tagged
330 -- record, contains Empty.
332 -- Address_Clause (synthesized)
333 -- Applies to entries, objects and subprograms. Set if an address clause
334 -- is present which references the object or subprogram and points to
335 -- the N_Attribute_Definition_Clause node. Empty if no Address clause.
336 -- The expression in the address clause is always a constant that is
337 -- defined before the entity to which the address clause applies.
338 -- Note: Gigi references this field in E_Task_Type entities???
340 -- Address_Taken (Flag104)
341 -- Present in all entities. Set if the Address or Unrestricted_Access
342 -- attribute is applied directly to the entity, i.e. the entity is the
343 -- entity of the prefix of the attribute reference. Used by Gigi to
344 -- make sure that the address can be meaningfully taken.
346 -- Alias (Node18)
347 -- Present in overloaded entities (literals, subprograms, entries).
348 -- Points to parent subprogram of a derived subprogram. Also used for
349 -- a subprogram renaming, where it points to the renamed subprogram.
350 -- Always empty for entries.
352 -- Alignment (Uint14)
353 -- Present in entities for types and also in constants, variables,
354 -- loop parameters, and formal parameters. This indicates the desired
355 -- alignment for a type, or the actual alignment for an object. A value
356 -- of zero (Uint_0) indicates that the alignment has not been set yet.
357 -- The alignment can be set by an explicit alignment clause, or set by
358 -- the front-end in package Layout, or set by the back-end as part of
359 -- the back end back-annotation process. The alignment field is also
360 -- present in E_Exception entities, but there it is used only by the
361 -- back-end for back annotation.
363 -- Alignment_Clause (synthesized)
364 -- Appllies to all entities for types and objects. If an alignment
365 -- attribute definition clause is present for the entity, then this
366 -- function returns the N_Attribute_Definition clause that specifies the
367 -- alignment. If no alignment clause applies to the type, then the call
368 -- to this function returns Empty. Note that the call can return a
369 -- non-Empty value even if Has_Alignment_Clause is not set (happens with
370 -- subtype and derived type declarations). Note also that a record
371 -- definition clause with an (obsolescent) mod clause is converted
372 -- into an attribute definition clause for this purpose.
374 -- Ancestor_Subtype (synthesized)
375 -- Applies to all type and subtype entities. If the argument is a
376 -- subtype then it returns the subtype or type from which the subtype
377 -- was obtained, otherwise it returns Empty.
379 -- Associated_Formal_Package (Node12)
380 -- Present in packages that are the actuals of formal_packages. Points
381 -- to the entity in the declaration for the formal package.
383 -- Associated_Node_For_Itype (Node8)
384 -- Present in all type and subtype entities. Set non-Empty only for
385 -- Itypes. Set to point to the associated node for the Itype, i.e.
386 -- the node whose elaboration generated the Itype. This is used for
387 -- copying trees, to determine whether or not to copy an Itype.
389 -- Associated_Storage_Pool (Node22) [root type only]
390 -- Present in simple and general access type entities. References the
391 -- storage pool to be used for the corresponding collection. A value of
392 -- Empty means that the default pool is to be used. This is present
393 -- only in the root type, since derived types must have the same pool
394 -- as the parent type.
396 -- Associated_Final_Chain (Node23)
397 -- Present in simple and general access type entities. References the
398 -- List_Controller object that holds the finalization chain on which
399 -- are attached dynamically allocated objects referenced by the access
400 -- type. Empty when the access type cannot reference a controlled object.
402 -- Barrier_Function (Node12)
403 -- Present in protected entries and entry families. This is the
404 -- subprogram declaration for the body of the function that returns
405 -- the value of the entry barrier.
407 -- Base_Type (synthesized)
408 -- Applies to all type entities. Returns the base type of a type or
409 -- subtype. The base type of a type is the type itself. The base type
410 -- of a subtype is the type that it constrains (which is always a type
411 -- entity, not some other subtype). Note that in the case of a subtype
412 -- of a private type, it is possible for the base type attribute to
413 -- return a private type, even if the subtype to which it applies is
414 -- non-private. See also Implementation_Base_Type. Note: it is allowed
415 -- to apply Base_Type to other than a type, in which case it simply
416 -- returns the entity unchanged.
418 -- Block_Node (Node11)
419 -- Present in block entities. Points to the identifier in the
420 -- Block_Statement itself. Used when retrieving the block construct
421 -- for finalization purposes, The block entity has an implicit label
422 -- declaration in the enclosing declarative part, and has otherwise
423 -- no direct connection in the tree with the block statement. The
424 -- link is to the identifier (which is an occurence of the entity)
425 -- and not to the block_statement itself, because the statement may
426 -- be rewritten, e.g. in the process of removing dead code.
428 -- Body_Entity (Node19)
429 -- Present in package and generic package entities, points to the
430 -- corresponding package body entity if one is present.
432 -- Body_Needed_For_SAL (Flag40)
433 -- Present in package and subprogram entities that are compilation
434 -- units. Indicates that the source for the body must be included
435 -- when the unit is part of a standalone library.
437 -- C_Pass_By_Copy (Flag125) [implementation base type only]
438 -- Present in record types. Set if a pragma Convention for the record
439 -- type specifies convention C_Pass_By_Copy. This convention name is
440 -- treated as identical in all respects to convention C, except that
441 -- if it is specified for a record type, then the C_Pass_By_Copy flag
442 -- is set, and if a foreign convention subprogram has a formal of the
443 -- corresponding type, then the parameter passing mechanism will be
444 -- set to By_Copy (unless specifically overridden by an Import or
445 -- Export pragma).
447 -- Can_Never_Be_Null (Flag38)
448 -- This flag is present in all entities, but can only be set in an
449 -- object which can never have a null value. This is used to avoid
450 -- unncessary resetting of the Is_Known_Non_Null flag for such
451 -- entities. The cases where this is set True are constant access
452 -- values initialized to a non-null value, and access parameters.
454 -- Chars (Name1)
455 -- Present in all entities. This field contains an entry into the names
456 -- table that has the character string of the identifier, character
457 -- literal or operator symbol. See Namet for further details. Note that
458 -- throughout the processing of the front end, this name is the simple
459 -- unqualified name. However, just before gigi is called, a call is made
460 -- to Qualify_All_Entity_Names. This causes entity names to be qualified
461 -- using the encoding described in exp_dbug.ads, and from that point on
462 -- (including post gigi steps such as cross-reference generation), the
463 -- entities will contain the encoded qualified names.
465 -- Checks_May_Be_Suppressed (Flag31)
466 -- Present in all entities. Set if a pragma Suppress or Unsuppress
467 -- mentions the entity specifically in the second argument. If this
468 -- flag is set the the Global_Entity_Suppress and Local_Entity_Suppress
469 -- tables must be consulted to determine if the is actually an active
470 -- Suppress or Unsuppress pragma that applies to the entity.
472 -- Class_Wide_Type (Node9)
473 -- Present in all type entities. For a tagged type or subtype, returns
474 -- the corresponding implicitly declared class-wide type. Set to Empty
475 -- for non-tagged types.
477 -- Cloned_Subtype (Node16)
478 -- Present in E_Record_Subtype and E_Class_Wide_Subtype entities.
479 -- Each such entity can either have a Discriminant_Constraint, in
480 -- which case it represents a distinct type from the base type (and
481 -- will have a list of components and discrimants in the list headed by
482 -- First_Entity) or else no such constraint, in which case it will be a
483 -- copy of the base type.
485 -- o Each element of the list in First_Entity is copied from the base
486 -- type; in that case, this field is Empty.
488 -- o The list in First_Entity is shared with the base type; in that
489 -- case, this field points to that entity.
491 -- A record or classwide subtype may also be a copy of some other
492 -- subtype and share the entities in the First_Entity with that subtype.
493 -- In that case, this field points to that subtype.
495 -- For E_Class_Wide_Subtype, the presence of Equivalent_Type overrides
496 -- this field. Note that this field ONLY appears in subtype entries, not
497 -- in type entries, it is not present, and it is an error to reference
498 -- Cloned_Subtype in an E_Record_Type or E_Class_Wide_Type entity.
500 -- Comes_From_Source
501 -- This flag appears on all nodes, including entities, and indicates
502 -- that the node was created by the scanner or parser from the original
503 -- source. Thus for entities, it indicates that the entity is defined
504 -- in the original source program.
506 -- Component_Alignment (special field) [base type only]
507 -- Present in array and record entities. Contains a value of type
508 -- Component_Alignment_Kind indicating the alignment of components.
509 -- Set to Calign_Default normally, but can be overridden by use of
510 -- the Component_Alignment pragma. Note: this field is currently
511 -- stored in a non-standard way, see body for details.
513 -- Component_Bit_Offset (Uint11)
514 -- Present in record components (E_Component, E_Discriminant) if a
515 -- component clause applies to the component. First bit position of
516 -- given component, computed from the first bit and position values
517 -- given in the component clause. A value of No_Uint means that the
518 -- value is not yet known. The value can be set by the appearence of
519 -- an explicit component clause in a record representation clause,
520 -- or it can be set by the front-end in package Layout, or it can be
521 -- set by the backend. By the time backend processing is completed,
522 -- this field is always set. A negative value is used to represent
523 -- a value which is not known at compile time, and must be computed
524 -- at run-time (this happens if fields of a record have variable
525 -- lengths). See package Layout for details of these values.
527 -- Note: this field is obsolescent, to be eventually replaced entirely
528 -- by Normalized_First_Bit and Normalized_Position, but for the moment,
529 -- gigi is still using (and back annotating) this field, and gigi does
530 -- not know about the new fields. For the front end layout case, the
531 -- Component_Bit_Offset field is only set if it is static, and otherwise
532 -- the new Normalized_First_Bit and Normalized_Position fields are used.
534 -- Component_Clause (Node13)
535 -- Present in record components and discriminants. If a record
536 -- representation clause is present for the corresponding record
537 -- type a that specifies a position for the component, then the
538 -- Component_Clause field of the E_Component entity points to the
539 -- N_Component_Clause node. Set to Empty if no record representation
540 -- clause was present, or if there was no specification for this
541 -- component.
543 -- Component_Size (Uint22) [implementation base type only]
544 -- Present in array types. It contains the component size value for
545 -- the array. A value of No_Uint means that the value is not yet set.
546 -- The value can be set by the use of a component size clause, or
547 -- by the front end in package Layout, or by the backend. A negative
548 -- value is used to represent a value which is not known at compile
549 -- time, and must be computed at run-time (this happens if the type
550 -- of the component has a variable length size). See package Layout
551 -- for details of these values.
553 -- Component_Type (Node20) [implementation base type only]
554 -- Present in array types and string types. References component type.
556 -- Constant_Value (synthesized)
557 -- Applies to variables, constants, named integers, and named reals.
558 -- Obtains the initialization expression for the entity. Will return
559 -- Empty for for a deferred constant whose full view is not available
560 -- or in some other cases of internal entities, which cannot be treated
561 -- as constants from the point of view of constant folding. Empty is
562 -- also returned for variables with no initialization expression.
564 -- Corresponding_Concurrent_Type (Node18)
565 -- Present in record types that are constructed by the expander to
566 -- represent task and protected types (Is_Concurrent_Record_Type flag
567 -- set True). Points to the entity for the corresponding task type or
568 -- protected type.
570 -- Corresponding_Discriminant (Node19)
571 -- Present in discriminants of a derived type, when the discriminant is
572 -- used to constrain a discriminant of the parent type. Points to the
573 -- corresponding discriminant in the parent type. Otherwise it is Empty.
575 -- Corresponding_Equality (Node13)
576 -- Present in function entities for implicit inequality operators.
577 -- Denotes the explicit or derived equality operation that creates
578 -- the implicit inequality. Note that this field is not present in
579 -- other function entities, only in implicit inequality routines,
580 -- where Comes_From_Source is always False.
582 -- Corresponding_Record_Type (Node18)
583 -- Present in protected and task types and subtypes. References the
584 -- entity for the corresponding record type constructed by the expander
585 -- (see Exp_Ch9). This type is used to represent values of the task type.
587 -- Corresponding_Remote_Type (Node22)
588 -- Present in record types that describe the fat pointer structure for
589 -- Remote_Access_To_Subrogram types. References the original access type.
591 -- CR_Discriminant (Node23)
592 -- Present in discriminants of concurrent types. Denotes the homologous
593 -- discriminant of the corresponding record type. The CR_Discriminant is
594 -- created at the same time as the discriminal, and used to replace
595 -- occurrences of the discriminant within the type declaration.
597 -- Current_Value (Node9)
598 -- Present in E_Variable, E_Out_Parameter and E_In_Out_Parameter
599 -- entities. Set non-Empty if the (constant) current value of the
600 -- variable is known. This value is valid only for references from
601 -- the same sequential scope as the entity. The sequential scope
602 -- of an entity includes the immediate scope and any contained
603 -- scopes that are package specs, package bodies, or blocks (at
604 -- any nesting level). For convenience in coding, this field is
605 -- also present in other object entities (E_Loop_Parameter and
606 -- E_In_Parameter and E_Constant), but is not used to hold a
607 -- constant value, since value tracking is not needed in this case.
609 -- Another related use of this field is to record information
610 -- about the value obtained from an IF statement condition.
611 -- If the IF/ELSIF condition has the form "[NOT] OBJ RELOP VAL",
612 -- where OBJ is a reference to an entity with a Current_Value field,
613 -- RELOP is one of the six relational operators, and VAL is a compile-
614 -- time known value, then the Current_Value field if OBJ is set to
615 -- point to the N_If_Statement or N_Elsif_Part node of the relevant
616 -- construct. For more details on this usage, see the procedure
617 -- Exp_Util.Get_Current_Value_Condition.
619 -- Debug_Info_Off (Flag166)
620 -- Present in all entities. Set if a pragma Suppress_Debug_Info applies
621 -- to the entity, or if internal processing in the compiler determines
622 -- that suppression of debug information is desirable. Note that this
623 -- flag is only for use by the front end as part of the processing for
624 -- determining if Needs_Debug_Info should be set. The back end should
625 -- always test Needs_Debug_Info, it should never test Debug_Info_Off.
627 -- Debug_Renaming_Link (Node13)
628 -- Used to link the enumeration literal of a debug renaming declaration
629 -- to the renamed entity. See Exp_Dbug.Debug_Renaming_Declaration for
630 -- details of the use of this field.
632 -- Declaration_Node (synthesized)
633 -- Applies to all entities. Returns the tree node for the declaration
634 -- that declared the entity. Normally this is just the Parent of the
635 -- entity. One exception arises with child units, where the parent of
636 -- the entity is a selected component or a defining program unit name.
637 -- Another exception is that if the entity is an incomplete type that
638 -- has been completed, then we obtain the declaration node denoted by
639 -- the full type, i.e. the full type declaration node.
641 -- Default_Expr_Function (Node21)
642 -- Present in parameters. It holds the entity of the parameterless
643 -- function that is built to evaluate the default expression if it is
644 -- more complex than a simple identifier or literal. For the latter
645 -- simple cases or if there is no default value, this field is Empty.
647 -- Default_Expressions_Processed (Flag108)
648 -- A flag in subprograms (functions, operators, procedures) and in
649 -- entries and entry families used to indicate that default expressions
650 -- have been processed and to avoid multiple calls to process the
651 -- default expressions (see Freeze.Process_Default_Expressions), which
652 -- would not only waste time, but also generate false error messages.
654 -- Default_Value (Node20)
655 -- Present in formal parameters. Points to the node representing the
656 -- expression for the default value for the parameter. Empty if the
657 -- parameter has no default value (which is always the case for OUT
658 -- and IN OUT parameters in the absence of errors).
660 -- Delay_Cleanups (Flag114)
661 -- Present in entities that have finalization lists (subprograms
662 -- blocks, and tasks). Set if there are pending generic body
663 -- instantiations for the corresponding entity. If this flag is
664 -- set, then generation of cleanup actions for the corresponding
665 -- entity must be delayed, since the insertion of the generic body
666 -- may affect cleanup generation (see Inline for further details).
668 -- Delay_Subprogram_Descriptors (Flag50)
669 -- Present in entities for which exception subprogram descriptors
670 -- are generated (subprograms, package declarations and package
671 -- bodies). Present if there are pending generic body instantiations
672 -- for the corresponding entity. If this flag is set, then generation
673 -- of the subprogram descriptor for the corresponding enities must
674 -- be delayed, since the insertion of the generic body may add entries
675 -- to the list of handlers.
677 -- Note: for subprograms, Delay_Subprogram_Descriptors is set if and
678 -- only if Delay_Cleanups is set. But Delay_Cleanups can be set for a
679 -- a block (in which case Delay_Subprogram_Descriptors is set for the
680 -- containing subprogram). In addition Delay_Subprogram_Descriptors is
681 -- set for a library level package declaration or body which contains
682 -- delayed instantiations (in this case the descriptor refers to the
683 -- enclosing elaboration procedure).
685 -- Delta_Value (Ureal18)
686 -- Present in fixed and decimal types. Points to a universal real
687 -- that holds value of delta for the type, as given in the declaration
688 -- or as inherited by a subtype or derived type.
690 -- Dependent_Instances (Elist8)
691 -- Present in packages that are instances. Holds list of instances
692 -- of inner generics. Used to place freeze nodes for those instances
693 -- after that of the current one, i.e. after the corresponding generic
694 -- bodies.
696 -- Depends_On_Private (Flag14)
697 -- Present in all type entities. Set if the type is private or if it
698 -- depends on a private type.
700 -- Designated_Type (synthesized)
701 -- Applies to access types. Returns the designated type. Differs
702 -- from Directly_Designated_Type in that if the access type refers
703 -- to an incomplete type, and the full type is available, then this
704 -- full type is returned instead of the incomplete type.
706 -- Digits_Value (Uint17)
707 -- Present in floating point types and subtypes and decimal types and
708 -- subtypes. Contains the Digits value specified in the declaration.
710 -- Directly_Designated_Type (Node20)
711 -- Present in access types. This field points to the type that is
712 -- directly designated by the access type. In the case of an access
713 -- type to an incomplete type, this field references the incomplete
714 -- type. Note that in the semantic processing, what is useful in
715 -- nearly all cases is the full type designated by the access type.
716 -- The function Designated_Type obtains this full type in the case of
717 -- access to an incomplete type.
719 -- Discard_Names (Flag88)
720 -- Present in types and exception entities. Set if pragma Discard_Names
721 -- applies to the entity. It is also set for declarative regions and
722 -- package specs for which a Discard_Names pragma with zero arguments
723 -- has been encountered. The purpose of setting this flag is to be able
724 -- to set the Discard_Names attribute on enumeration types declared
725 -- after the pragma within the same declarative region. This flag is
726 -- set to False if a Keep_Names pragma appears for an enumeration type.
728 -- Discriminal (Node17)
729 -- Present in discriminants (Discriminant formal: GNAT's first
730 -- coinage). The entity used as a formal parameter that corresponds
731 -- to a discriminant. See section "Handling of Discriminants" for
732 -- full details of the use of discriminals.
734 -- Discriminal_Link (Node10)
735 -- Present in discriminals (which have an Ekind of E_In_Parameter,
736 -- or E_Constant), points back to corresponding discriminant.
738 -- Discriminant_Checking_Func (Node20)
739 -- Present in components. Points to the defining identifier of the
740 -- function built by the expander returns a Boolean indicating whether
741 -- the given record component exists for the current discriminant
742 -- values.
744 -- Discriminant_Constraint (Elist21)
745 -- Present in entities whose Has_Discriminants flag is set (concurrent
746 -- types, subtypes, record types and subtypes, private types and
747 -- subtypes, limited private types and subtypes and incomplete types).
748 -- It is an error to reference the Discriminant_Constraint field if
749 -- Has_Discriminants is False.
751 -- If the Is_Constrained flag is set, Discriminant_Constraint points
752 -- to an element list containing the discriminant constraints in the
753 -- same order in which the discriminants are declared.
755 -- If the Is_Constrained flag is not set but the discriminants of the
756 -- unconstrained type have default initial values then this field
757 -- points to an element list giving these default initial values in
758 -- the same order in which the discriminants are declared. Note that
759 -- in this case the entity cannot be a tagged record type, because
760 -- discriminants in this case cannot have defaults.
762 -- If the entity is a tagged record implicit type, then this field is
763 -- inherited from the first subtype (so that the itype is subtype
764 -- conformant with its first subtype, which is needed when the first
765 -- subtype overrides primitive operations inherited by the implicit
766 -- base type).
768 -- In all other cases Discriminant_Constraint contains the empty
769 -- Elist (ie it is initialized with a call to New_Elmt_List).
771 -- Discriminant_Default_Value (Node20)
772 -- Present in discriminants. Points to the node representing the
773 -- expression for the default value of the discriminant. Set to
774 -- Empty if the discriminant has no default value.
776 -- Discriminant_Number (Uint15)
777 -- Present in discriminants. Gives the ranking of a discriminant in
778 -- the list of discriminants of the type, i.e. a sequential integer
779 -- index starting at 1 and ranging up to Number_Discriminants.
781 -- DTC_Entity (Node16)
782 -- Present in function and procedure entities. Set to Empty unless
783 -- the subprogram is dispatching in which case it references the
784 -- Dispatch Table pointer Component. That is to say the component _tag
785 -- for regular Ada tagged types, for CPP_Class types and their
786 -- descendants this field points to the component entity in the record
787 -- that is the Vtable pointer for the Vtable containing the entry that
788 -- references the subprogram.
790 -- DT_Entry_Count (Uint15)
791 -- Present in E_Component entities. Only used for component marked
792 -- Is_Tag. Store the number of entries in the Vtable (or Dispatch Table)
794 -- DT_Position (Uint15)
795 -- Present in function and procedure entities which are dispatching
796 -- (should not be referenced without first checking that flag
797 -- Is_Dispatching_Operation is True). Contains the offset into
798 -- the Vtable for the entry that references the subprogram.
800 -- Ekind (Ekind)
801 -- Present in all entities. Contains a value of the enumeration type
802 -- Entity_Kind declared in a subsequent section in this spec.
804 -- Elaborate_All_Desirable (Flag146)
805 -- Present in package and subprogram entities, and in generic package
806 -- and subprogram entities. Set if internal analysis of a client that
807 -- with's this unit determines that Elaborate_All is desirable, i.e.
808 -- that there is a possibility that Program_Error may be raised if
809 -- Elaborate_All conditions cannot be met.
811 -- Elaboration_Entity (Node13)
812 -- Present in generic and non-generic package and subprogram
813 -- entities. This is a boolean entity associated with the unit that
814 -- is initiallly set to False, and is set True when the unit is
815 -- elaborated. This is used for two purposes. First, it is used to
816 -- implement required access before elaboration checks (the flag
817 -- must be true to call a subprogram at elaboration time). Second,
818 -- it is used to guard against repeated execution of the generated
819 -- elaboration code.
821 -- Note that we always allocate this flag, and set this field, but
822 -- we do not always actually use it. It is only used if it is needed
823 -- for access-before-elaboration use (see Elaboration_Entity_Required
824 -- flag) or if either the spec or the body has elaboration code. If
825 -- neither of these two conditions holds, then the entity is still
826 -- allocated (since we don't know early enough whether or not there
827 -- is elaboration code), but is simply not used for any purpose.
829 -- Elaboration_Entity_Required (Flag174)
830 -- Present in generics and non-generic package and subprogram
831 -- entities. Set only if Elaboration_Entity is non-Empty to indicate
832 -- that the boolean is required to be set even if there is no other
833 -- elaboration code. This occurs when the Elaboration_Entity flag
834 -- is used for required access-before-elaboration checking. If the
835 -- flag is only for preventing multiple execution of the elaboration
836 -- code, then if there is no other elaboration code, obviously there
837 -- is no need to set the flag.
839 -- Enclosing_Dynamic_Scope (synthesized)
840 -- Appliesa to all entities. Returns the closest dynamic scope in which
841 -- the entity is declared or Standard_Standard for library-level entities
843 -- Enclosing_Scope (Node18)
844 -- Present in labels. Denotes the innermost enclosing construct that
845 -- contains the label. Identical to the scope of the label, except for
846 -- labels declared in the body of an accept statement, in which case the
847 -- entry_name is the Enclosing_Scope. Used to validate goto's within
848 -- accept statements.
850 -- Entry_Accepted (Flag152)
851 -- Present in E_Entry and E_Entry_Family entities. Set if there is
852 -- at least one accept for this entry in the task body. Used to
853 -- generate warnings for missing accepts.
855 -- Entry_Bodies_Array (Node15)
856 -- Present in protected types for which Has_Entries is true.
857 -- This is the defining identifier for the array of entry body
858 -- action procedures and barrier functions used by the runtime to
859 -- execute the user code associated with each entry.
861 -- Entry_Cancel_Parameter (Node23)
862 -- Present in blocks. This only applies to a block statement for
863 -- which the Is_Asynchronous_Call_Block flag is set. It
864 -- contains the defining identifier of an object that must be
865 -- passed to the Cancel_Task_Entry_Call or Cancel_Protected_Entry_Call
866 -- call in the cleanup handler added to the block by
867 -- Exp_Ch7.Expand_Cleanup_Actions. This parameter is a Boolean
868 -- object for task entry calls and a Communications_Block object
869 -- in the case of protected entry calls. In both cases the objects
870 -- are declared in outer scopes to this block.
872 -- Entry_Component (Node11)
873 -- Present in formal parameters (in, in out and out parameters). Used
874 -- only for formals of entries. References the corresponding component
875 -- of the entry parameter record for the entry.
877 -- Entry_Formal (Node16)
878 -- Present in components of the record built to correspond to entry
879 -- parameters. This field points from the component to the formal. It
880 -- is the back pointer corresponding to Entry_Component.
882 -- Entry_Index_Constant (Node18)
883 -- Present in an entry index parameter. This is an identifier that
884 -- eventually becomes the name of a constant representing the index
885 -- of the entry family member whose entry body is being executed. Used
886 -- to expand references to the entry index specification identifier.
888 -- Entry_Index_Type (synthesized)
889 -- Applies to an entry family. Denotes Etype of the subtype indication
890 -- in the entry declaration. Used to resolve the index expression in an
891 -- accept statement for a member of the family, and in the prefix of
892 -- 'COUNT when it applies to a family member.
894 -- Entry_Parameters_Type (Node15)
895 -- Present in entries. Points to the access-to-record type that is
896 -- constructed by the expander to hold a reference to the parameter
897 -- values. This reference is manipulated (as an address) by the
898 -- tasking runtime. The designated record represents a packaging
899 -- up of the entry parameters (see Exp_Ch9.Expand_N_Entry_Declaration
900 -- for further details). Entry_Parameters_Type is Empty if the entry
901 -- has no parameters.
903 -- Enumeration_Pos (Uint11)
904 -- Present in enumeration literals. Contains the position number
905 -- corresponding to the value of the enumeration literal.
907 -- Enumeration_Rep (Uint12)
908 -- Present in enumeration literals. Contains the representation that
909 -- corresponds to the value of the enumeration literal. Note that
910 -- this is normally the same as Enumeration_Pos except in the presence
911 -- of representation clauses, where Pos will still represent the
912 -- position of the literal within the type and Rep will have be the
913 -- value given in the representation clause.
915 -- Enumeration_Rep_Expr (Node22)
916 -- Present in enumeration literals. Points to the expression in an
917 -- associated enumeration rep clause that provides the representation
918 -- value for this literal. Empty if no enumeration rep clause for this
919 -- literal (or if rep clause does not have an entry for this literal,
920 -- an error situation). This is also used to catch duplicate entries
921 -- for the same literal.
923 -- Enum_Pos_To_Rep (Node23)
924 -- Present in enumeration types (but not enumeration subtypes). Set to
925 -- Empty unless the enumeration type has a non-standard representation
926 -- (i.e. at least one literal has a representation value different from
927 -- its pos value). In this case, Enum_Pos_To_Rep is the entity for an
928 -- array constructed when the type is frozen that maps Pos values to
929 -- corresponding Rep values. The index type of this array is Natural,
930 -- and the component type is a suitable integer type that holds the
931 -- full range of representation values.
933 -- Equivalent_Type (Node18)
934 -- Present in class wide types and subtypes, access to protected
935 -- subprogram types, and in exception_types. For a classwide type, it
936 -- is always Empty. For a class wide subtype, it points to an entity
937 -- created by the expander which gives Gigi an easily understandable
938 -- equivalent of the class subtype with a known size (given by an
939 -- initial value). See Exp_Util.Expand_Class_Wide_Subtype for further
940 -- details. For E_exception_type, this points to the record containing
941 -- the data necessary to represent exceptions (for further details, see
942 -- System.Standard_Library. For access_to_protected subprograms, it
943 -- denotes a record that holds pointers to the operation and to the
944 -- protected object. For remote Access_To_Subprogram types, it denotes
945 -- the record that is the fat pointer representation of an RAST.
947 -- Esize (Uint12)
948 -- Present in all types and subtypes, and also for components, constants,
949 -- and variables. Contains the Object_Size of the type or of the object.
950 -- A value of zero indicates that the value is not yet known.
952 -- For the case of components where a component clause is present, the
953 -- value is the value from the component clause, which must be non-
954 -- negative (but may be zero, which is acceptable for the case of
955 -- a type with only one possible value). It is also possible for Esize
956 -- of a component to be set without a component clause present, which
957 -- means that the component size is specified, but not the position.
958 -- See also RM_Size and the section on "Handling of Type'Size Values".
959 -- During gigi processing, the value is back annotated for all zero
960 -- values, so that after the call to gigi, the value is properly set.
962 -- Etype (Node5)
963 -- Present in all entities. Represents the type of the entity, which
964 -- is itself another entity. For a type entity, points to the parent
965 -- type for a derived type, or if the type is not derived, points to
966 -- itself. For a subtype entity, Etype points to the base type. For
967 -- a class wide type, points to the parent type. For a subprogram or
968 -- subprogram type, Etype has the return type of a function or is set
969 -- to Standard_Void_Type to represent a procedure.
971 -- Exception_Code (Uint22)
972 -- Present in exception entitites. Set to zero unless either an
973 -- Import_Exception or Export_Exception pragma applies to the
974 -- pragma and specifies a Code value. See description of these
975 -- pragmas for details. Note that this field is relevant only if
976 -- Is_VMS_Exception is set.
978 -- Extra_Formal (Node15)
979 -- Present in formal parameters in the non-generic case. Certain
980 -- parameters require extra implicit information to be passed
981 -- (e.g. the flag indicating if an unconstrained variant record
982 -- argument is constrained, and the accessibility level for
983 -- access parameters. See description of Extra_Constrained,
984 -- Extra_Accessibility fields for further details. Extra formal
985 -- parameters are constructed to represent these values, and
986 -- chained to the end of the list of formals using the
987 -- Extra_Formal field (i.e. the Extra_Formal field of the last
988 -- "real" formal points to the first extra formal, and the
989 -- Extra_Formal field of each extra formal points to the next
990 -- one, with Empty indicating the end of the list of extra
991 -- formals.
993 -- Extra_Accessibility (Node13)
994 -- Present in formal parameters in the non-generic case if
995 -- expansion is active. Normally Empty, but if a parameter is
996 -- one for which a dynamic accessibility check is required, then
997 -- an extra formal of type Natural is created (see description
998 -- of field Extra_Formal), and the Extra_Accessibility field of
999 -- the formal parameter points to the entity for this extra
1000 -- formal. Also present in variables when compiling receiving
1001 -- stubs. In this case, a non Empty value means that this
1002 -- variable's accessibility depth has been transmitted by the
1003 -- caller and must be retrieved through the entity designed by
1004 -- this field instead of being computed.
1006 -- Extra_Constrained (Node23)
1007 -- Present in formal parameters in the non-generic case if
1008 -- expansion is active. Normally Empty, but if a parameter is
1009 -- one for which a dynamic indication of its constrained status
1010 -- is required, then an extra formal of type Boolean is created
1011 -- (see description of field Extra_Formal), and the
1012 -- Extra_Constrained field of the formal parameter points to the
1013 -- entity for this extra formal. Also present in variables when
1014 -- compiling receiving stubs. In this case, a non empty value
1015 -- means that this variable's constrained status has been
1016 -- transmitted by the caller and must be retrieved through the
1017 -- entity designed by this field instead of being computed.
1019 -- Finalization_Chain_Entity (Node19)
1020 -- Present in scopes which can have finalizable entities (blocks,
1021 -- functions, procedures, tasks, entries). When this field is empty it
1022 -- means that there are no finalization actions to perform on exit of the
1023 -- scope. When this field contains 'Error', it means that no
1024 -- finalization actions should happen at this level and the
1025 -- finalization chain of a parent scope shall be used (??? this is
1026 -- an improper use of 'Error' and should be changed). otherwise it
1027 -- contains an entity of type Finalizable_Ptr that is the head of the
1028 -- list of objects to finalize on exit. See "Finalization Management"
1029 -- section in exp_ch7.adb for more details.
1031 -- Finalize_Storage_Only (Flag158) [base type only]
1032 -- Present in all types. Set on direct controlled types to which a
1033 -- valid Finalize_Storage_Only pragma applies. This flag is also set on
1034 -- composite types when they have at least one controlled component and
1035 -- all their controlled components are Finalize_Storage_Only. It is also
1036 -- inherited by type derivation except for direct controlled types where
1037 -- the Finalize_Storage_Only pragma is required at each level of
1038 -- derivation.
1040 -- First_Component (synthesized)
1041 -- Applies to record types. Returns the first component by following
1042 -- the chain of declared entities for the record until a component
1043 -- is found (one with an Ekind of E_Component). The discriminants are
1044 -- skipped. If the record is null, then Empty is returned.
1046 -- First_Discriminant (synthesized)
1047 -- Applies to types with discriminants. The discriminants are the
1048 -- first entities declared in the type, so normally this is equivalent
1049 -- to First_Entity. The exception arises for tagged types, where the
1050 -- tag itself is prepended to the front of the entity chain, so the
1051 -- First_Discriminant function steps past the tag if it is present.
1053 -- First_Entity (Node17)
1054 -- Present in all entities which act as scopes to which a list of
1055 -- associated entities is attached (blocks, class subtypes and types,
1056 -- entries, functions, loops, packages, procedures, protected objects,
1057 -- record types and subtypes, private types, task types and subtypes).
1058 -- Points to a list of associated entities using the Next_Entity field
1059 -- as a chain pointer with Empty marking the end of the list.
1061 -- First_Formal (synthesized)
1062 -- Applies to subprograms and subprogram types, and also in entries
1063 -- and entry families. Returns first formal of the subprogram or entry.
1064 -- The formals are the first entities declared in a subprogram or in
1065 -- a subprogram type (the designated type of an Access_To_Subprogram
1066 -- definition) or in an entry.
1068 -- First_Index (Node17)
1069 -- Present in array types and subtypes and in string types and subtypes.
1070 -- By introducing implicit subtypes for the index constraints, we have
1071 -- the same structure for constrained and unconstrained arrays, subtype
1072 -- marks and discrete ranges are both represented by a subtype. This
1073 -- function returns the tree node corresponding to an occurrence of the
1074 -- first index (NOT the entity for the type). Subsequent indexes are
1075 -- obtained using Next_Index. Note that this field is present for the
1076 -- case of string literal subtypes, but is always Empty.
1078 -- First_Literal (Node17)
1079 -- Present in all enumeration types, including character and boolean
1080 -- types. This field points to the first enumeration literal entity
1081 -- for the type (i.e. it is set to First (Literals (N)) where N is
1082 -- the enumeration type definition node. A special case occurs with
1083 -- standard character and wide character types, where this field is
1084 -- Empty, since there are no enumeration literal lists in these cases.
1085 -- Note that this field is set in enumeration subtypes, but it still
1086 -- points to the first literal of the base type in this case.
1088 -- First_Optional_Parameter (Node14)
1089 -- Present in (non-generic) function and procedure entities. Set to a
1090 -- non-null value only if a pragma Import_Function, Import_Procedure
1091 -- or Import_Valued_Procedure specifies a First_Optional_Parameter
1092 -- argument, in which case this field points to the parameter entity
1093 -- corresponding to the specified parameter.
1095 -- First_Private_Entity (Node16)
1096 -- Present in all entities containing private parts (packages,
1097 -- protected types and subtypes, task types and subtypes). The
1098 -- entities on the entity chain are in order of declaration, so the
1099 -- entries for private entities are at the end of the chain. This
1100 -- field points to the first entity for the private part. It is
1101 -- Empty if there are no entities declared in the private part or
1102 -- if there is no private part.
1104 -- First_Rep_Item (Node6)
1105 -- Present in all entities. If non-empty, points to a linked list of
1106 -- representation pragmas nodes and representation clause nodes that
1107 -- apply to the entity, linked using Next_Rep_Item, with Empty marking
1108 -- the end of the list. In the case of derived types and subtypes, the
1109 -- new entity inherits the chain at the point of declaration. This
1110 -- means that it is possible to have multiple instances of the same
1111 -- kind of rep item on the chain, in which case it is the first one
1112 -- that applies to the entity.
1114 -- For most representation items, the representation information is
1115 -- reflected in other fields and flags in the entity. For example if
1116 -- a record representation clause is present, the component entities
1117 -- reflect the specified information. However, there are some items
1118 -- that are only reflected in the chain. These include:
1120 -- Alignment attribute definition clause
1121 -- Machine_Attribute pragma
1122 -- Link_Alias pragma
1123 -- Link-Section pragma
1124 -- Weak_External pragma
1126 -- If any of these items are present, then the flag Has_Gigi_Rep_Item
1127 -- is set, indicating that Gigi should search the chain.
1129 -- Other representation items are included in the chain so that error
1130 -- messages can easily locate the relevant nodes for posting errors.
1131 -- Note in particular that size clauses are present only for this
1132 -- purpose, and should only be accessed if Has_Size_Clause is set.
1134 -- First_Stored_Discriminant (synthesized)
1135 -- Applies to types with discriminants. Gives the first discriminant
1136 -- stored in the object. In many cases, these are the same as the
1137 -- normal visible discriminants for the type, but in the case of
1138 -- renamed discriminants, this is not always the case.
1140 -- For tagged types, and untagged types which are root types or
1141 -- derived types but which do not rename discriminants in their
1142 -- root type, the stored discriminants are the same as the actual
1143 -- discriminants of the type, and hence this function is the same
1144 -- as First_Discriminant.
1146 -- For derived non-tagged types that rename discriminants in the root
1147 -- type this is the first of the discriminants that occurr in the
1148 -- root type. To be precise, in this case stored discriminants are
1149 -- entities attached to the entity chain of the derived type which
1150 -- are a copy of the discriminants of the root type. Furthermore their
1151 -- Is_Completely_Hidden flag is set since although they are actually
1152 -- stored in the object, they are not in the set of discriminants that
1153 -- is visble in the type.
1155 -- For derived untagged types, stored discriminants are the real
1156 -- discriminants from Gigi's standpoint, i.e. those that will be
1157 -- stored in actual objects of the type.
1159 -- First_Subtype (synthesized)
1160 -- Applies to all types and subtypes. For types, yields the first
1161 -- subtype of the type. For subtypes, yields the first subtype of
1162 -- the base type of the subtype.
1164 -- Freeze_Node (Node7)
1165 -- Present in all entities. If there is an associated freeze node for
1166 -- the entity, this field references this freeze node. If no freeze
1167 -- node is associated with the entity, then this field is Empty. See
1168 -- package Freeze for further details.
1170 -- From_With_Type (Flag159)
1171 -- Present in package and type entities. Indicates that the entity
1172 -- appears in a With_Type clause in the context of some other unit,
1173 -- either as the prefix (which must be a package), or as a type name.
1174 -- The package can only be used to retrieve such a type, and the type
1175 -- can be used only in component declarations and access definitions.
1176 -- The With_Type clause is used to construct mutually recursive
1177 -- types, i.e. record types (Java classes) that hold pointers to each
1178 -- other. If such a type is an access type, it has no explicit freeze
1179 -- node, so that the back-end does not attempt to elaborate it.
1180 -- Currently this flag is also used to implement Ada 2005 (AI-50217).
1181 -- It will be renamed to From_Limited_With after removal of the current
1182 -- GNAT with_type clause???
1184 -- Full_View (Node11)
1185 -- Present in all type and subtype entities and in deferred constants.
1186 -- References the entity for the corresponding full type declaration.
1187 -- For all types other than private and incomplete types, this field
1188 -- always contains Empty. See also Underlying_Type.
1190 -- Function_Returns_With_DSP (Flag169)
1191 -- Present in all subprogram entities, and type entities for access
1192 -- to subprogram values. Set True if the function (or referenced
1193 -- function in the case of an access value) returns with using the
1194 -- DSP (depressed stack pointer) approach. This can only be set
1195 -- True if Targparm.Functions_Return_By_DSP_On_Target is True and
1196 -- the function returns a value of a type whose size is not known
1197 -- at compile time.
1199 -- Generic_Homonym (Node11)
1200 -- Present in generic packages. The generic homonym is the entity of
1201 -- a renaming declaration inserted in every generic unit. It is used
1202 -- to resolve the name of a local entity that is given by a qualified
1203 -- name, when the generic entity itself is hidden by a local name.
1205 -- Generic_Renamings (Elist23)
1206 -- Present in package and subprogram instances. Holds mapping that
1207 -- associates generic parameters with the corresponding instances, in
1208 -- those cases where the instance is an entity.
1210 -- Handler_Records (List10)
1211 -- Present in subprogram and package entities. Points to a list of
1212 -- identifiers referencing the handler record entities for the
1213 -- corresponding unit.
1215 -- Has_Aliased_Components (Flag135) [implementation base type only]
1216 -- Present in array type entities. Indicates that the component type
1217 -- of the array is aliased.
1219 -- Has_Alignment_Clause (Flag46)
1220 -- Present in all type entities and objects. Indicates if an alignment
1221 -- clause has been given for the entity. If set, then Alignment_Clause
1222 -- returns the N_Attribute_Definition node for the alignment attribute
1223 -- definition clause. Note that it is possible for this flag to be False
1224 -- even when Alignment_Clause returns non_Empty (this happens in the case
1225 -- of derived type declarations).
1227 -- Has_All_Calls_Remote (Flag79)
1228 -- Present in all library unit entities. Set true if the library unit
1229 -- has an All_Calls_Remote pragma. Note that such entities must also
1230 -- be RCI entities, so the flag Is_Remote_Call_Interface will always
1231 -- be set if this flag is set.
1233 -- Has_Atomic_Components (Flag86) [implementation base type only]
1234 -- Present in all types and objects. Set only for an array type or
1235 -- an array object if a valid pragma Atomic_Components applies to the
1236 -- type or object. Note that in the case of an object, this flag is
1237 -- only set on the object if there was an explicit pragma for the
1238 -- object. In other words, the proper test for whether an object has
1239 -- atomic components is to see if either the object or its base type
1240 -- has this flag set. Note that in the case of a type, the pragma will
1241 -- be chained to the rep item chain of the first subtype in the usual
1242 -- manner.
1244 -- Has_Attach_Handler (synthesized)
1245 -- Applies to record types that are constructed by the expander to
1246 -- represent protected types. Returns True if there is at least one
1247 -- Attach_Handler pragma in the corresponding specification.
1249 -- Has_Biased_Representation (Flag139)
1250 -- Present in discrete types (where it applies to the type'size value),
1251 -- and to objects (both stand-alone and components), where it applies to
1252 -- the size of the object from a size or record component clause. In
1253 -- all cases it indicates that the size in question is smaller than
1254 -- would normally be required, but that the size requirement can be
1255 -- satisfied by using a biased representation, in which stored values
1256 -- have the low bound (Expr_Value (Type_Low_Bound (T)) subtracted to
1257 -- reduce the required size. For example, a type with a range of 1..2
1258 -- takes one bit, using 0 to represent 1 and 1 to represent 2.
1260 -- Note that in the object and component cases, the flag is only set
1261 -- if the type is unbiased, but the object specifies a smaller size
1262 -- than the size of the type, forcing biased representation for the
1263 -- object, but the subtype is still an unbiased type.
1265 -- Has_Completion (Flag26)
1266 -- Present in all entities that require a completion (functions,
1267 -- procedures, private types, limited private types, incomplete types,
1268 -- constants and packages that require a body). The flag is set if the
1269 -- completion has been encountered and analyzed.
1271 -- Has_Completion_In_Body (Flag71)
1272 -- Present in "Taft amendment types" that is to say incomplete types
1273 -- whose full declaration appears in the package body.
1275 -- Has_Complex_Representation (Flag140) [implementation base type only]
1276 -- Present in all type entities. Set only for a record base type to
1277 -- which a valid pragma Complex_Representation applies.
1279 -- Has_Component_Size_Clause (Flag68) [implementation base type only]
1280 -- Present in all type entities. Set if a component size clause is
1281 -- present for the given type. Note that this flag can be False even
1282 -- if Component_Size is non-zero (happens in the case of derived types).
1284 -- Has_Constrained_Partial_View (Flag187)
1285 -- Present in private type and their completions, when the private
1286 -- type has no discriminants and the full view has discriminants with
1287 -- defaults. In Ada 2005 heap-allocated objects of such types are not
1288 -- constrained, and can change their discriminants with full assignment.
1290 -- Has_Contiguous_Rep (Flag181)
1291 -- Present in enumeration types. True if the type as a representation
1292 -- clause whose entries are successive integers.
1294 -- Has_Controlling_Result (Flag98)
1295 -- Present in E_Function entities. True if The function is a primitive
1296 -- function of a tagged type which can dispatch on result
1298 -- Has_Controlled_Component (Flag43) [base type only]
1299 -- Present in all entities. Set only for composite type entities which
1300 -- contain a component that either is a controlled type, or itself
1301 -- contains controlled component (i.e. either Has_Controlled_Component
1302 -- or Is_Controlled is set for at least one component).
1304 -- Has_Convention_Pragma (Flag119)
1305 -- Present in an entity for which a Convention, Import, or Export
1306 -- pragma has been given. Used to prevent more than one such pragma
1307 -- appearing for a given entity (RM B.1(45)).
1309 -- Has_Delayed_Freeze (Flag18)
1310 -- Present in all entities. Set to indicate that an explicit freeze
1311 -- node must be generated for the entity at its freezing point. See
1312 -- separate section ("Delayed Freezing and Elaboration") for details.
1314 -- Has_Discriminants (Flag5)
1315 -- Present in all types and subtypes. For types that are allowed to have
1316 -- discriminants (record types and subtypes, task types and subtypes,
1317 -- protected types and subtypes, private types, limited private types,
1318 -- and incomplete types), indicates if the corresponding type or subtype
1319 -- has a known discriminant part. Always false for all other types.
1321 -- Has_Entries (synthesized)
1322 -- Applies to concurrent types. True if any entries are declared
1323 -- within the task or protected definition for the type.
1325 -- Has_Enumeration_Rep_Clause (Flag66)
1326 -- Present in enumeration types. Set if an enumeration representation
1327 -- clause has been given for this enumeration type. Used to prevent more
1328 -- than one enumeration representation clause for a given type. Note
1329 -- that this does not imply a representation with holes, since the rep
1330 -- clause may merely confirm the default 0..N representation.
1332 -- Has_External_Tag_Rep_Clause (Flag110)
1333 -- Present in tagged types. Set if an external_tag rep. clause has been
1334 -- given for this type. Use to avoid the generation of the default
1335 -- external_tag.
1337 -- Has_Exit (Flag47)
1338 -- Present in loop entities. Set if the loop contains an exit statement.
1340 -- Has_Foreign_Convention (synthesized)
1341 -- Applies to all entities. Determines if the Convention for the
1342 -- entity is a foreign convention (i.e. is other than Convention_Ada,
1343 -- Convention_Intrinsic, Convention_Entry or Convention_Protected).
1345 -- Has_Forward_Instantiation (Flag175)
1346 -- Present in package entities. Set true for packages that contain
1347 -- instantiations of local generic entities, before the corresponding
1348 -- generic body has been seen. If a package has a forward instantiation,
1349 -- we cannot inline subprograms appearing in the same package because
1350 -- the placement requirements of the instance will conflict with the
1351 -- linear elaboration of front-end inlining.
1353 -- Has_Fully_Qualified_Name (Flag173)
1354 -- Present in all entities. Set True if the name in the Chars field
1355 -- has been replaced by the fully qualified name, as used for debug
1356 -- output. See Exp_Dbug for a full description of the use of this
1357 -- flag and also the related flag Has_Qualified_Name.
1359 -- Has_Gigi_Rep_Item (Flag82)
1360 -- This flag is set if the rep item chain (referenced by First_Rep_Item
1361 -- and linked through the Next_Rep_Item chain) contains a representation
1362 -- item that needs to be specially processed by Gigi, i.e. one of the
1363 -- following items:
1365 -- Machine_Attribute pragma
1366 -- Linker_Alias pragma
1367 -- Linker_Section pragma
1368 -- Linker_Constructor pragma
1369 -- Linker_Destructor pragma
1370 -- Weak_External pragma
1372 -- If this flag is set, then Gigi should scan the rep item chain to
1373 -- process any of these items that appear. At least one such item will
1374 -- be present.
1376 -- Has_Homonym (Flag56)
1377 -- Present in all entities. Set if an entity has a homonym in the same
1378 -- scope. Used by Gigi to generate unique names for such entities.
1380 -- Has_Interrupt_Handler (synthesized)
1381 -- Applies to all protected type entities. Set if the protected type
1382 -- definition contains at least one procedure to which a pragma
1383 -- Interrupt_Handler applies.
1385 -- Has_Machine_Radix_Clause (Flag83)
1386 -- Present in decimal types and subtypes, set if a Machine_Radix
1387 -- representation clause is present. This flag is used to detect
1388 -- the error of multiple machine radix clauses for a single type.
1390 -- Has_Master_Entity (Flag21)
1391 -- Present in entities that can appear in the scope stack (see spec
1392 -- of Sem). It is set if a task master entity (_master) has been
1393 -- declared and initialized in the corresponding scope.
1395 -- Has_Missing_Return (Flag142)
1396 -- Present in functions and generic functions. Set if there is one or
1397 -- more missing return statements in the function. This is used to
1398 -- control wrapping of the body in Exp_Ch6 to ensure that the program
1399 -- error exeption is correctly raised in this case at runtime.
1401 -- Has_Nested_Block_With_Handler (Flag101)
1402 -- Present in scope entities. Set if there is a nested block within the
1403 -- scope that has an exception handler and the two scopes are in the
1404 -- same procedure. This is used by the backend for controlling certain
1405 -- optimizations to ensure that they are consistent with exceptions.
1406 -- See documentation in Gigi for further details.
1408 -- Has_Non_Standard_Rep (Flag75) [implementation base type only]
1409 -- Present in all type entities. Set when some representation clause
1410 -- or pragma causes the representation of the item to be significantly
1411 -- modified. In this category are changes of small or radix for a
1412 -- fixed-point type, change of component size for an array, and record
1413 -- or enumeration representation clauses, as well as packed pragmas.
1414 -- All other representation clauses (e.g. Size and Alignment clauses)
1415 -- are not considered to be significant since they do not affect
1416 -- stored bit patterns.
1418 -- Has_Object_Size_Clause (Flag172)
1419 -- Present in entities for types and subtypes. Set if an Object_Size
1420 -- clause has been processed for the type Used to prevent multiple
1421 -- Object_Size clauses for a given entity.
1423 -- Has_Per_Object_Constraint (Flag154)
1424 -- Present in E_Component entities, true if the subtype of the
1425 -- component has a per object constraint. Per object constraints result
1426 -- from the following situations:
1428 -- 1. N_Attribute_Reference - when the prefix is the enclosing type and
1429 -- the attribute is Access.
1430 -- 2. N_Discriminant_Association - when the expression uses the
1431 -- discriminant of the enclosing type.
1432 -- 3. N_Index_Or_Discriminant_Constraint - when at least one of the
1433 -- individual constraints is a per object constraint.
1434 -- 4. N_Range - when the lower or upper bound uses the discriminant of
1435 -- the enclosing type.
1436 -- 5. N_Range_Constraint - when the range expression uses the
1437 -- discriminant of the enclosing type.
1439 -- Has_Persistent_BSS (Flag188)
1440 -- Present in all entities. Set True for entities to which a valid
1441 -- pragma Persistent_BSS applies. Note that although the pragma is
1442 -- only meaningful for objects, we set it for all entities in a unit
1443 -- to which the pragma applies, as well as the unit entity itself, for
1444 -- convenience in propagating the flag to contained entities.
1446 -- Has_Pragma_Controlled (Flag27) [implementation base type only]
1447 -- Present in access type entities. It is set if a pragma Controlled
1448 -- applies to the access type.
1450 -- Has_Pragma_Elaborate_Body (Flag150)
1451 -- Present in all entities. Set in compilation unit entities if a
1452 -- pragma Elaborate_Body applies to the compilation unit.
1454 -- Has_Pragma_Inline (Flag157)
1455 -- Present in all entities. Set for functions and procedures for which
1456 -- a pragma Inline or Inline_Always applies to the subprogram. Note
1457 -- that this flag can be set even if Is_Inlined is not set. This
1458 -- happens for pragma Inline (if Inline_Active is False). In other
1459 -- words, the flag Has_Pragma_Inline represents the formal semantic
1460 -- status, and is used for checking semantic correctness.
1461 -- The flag Is_Inlined indicates whether inlining is actually active
1462 -- for the entity.
1464 -- Has_Pragma_Pack (Flag121) [implementation base type only]
1465 -- Present in all entities. It indicates that a valid pragma Pack was
1466 -- was given for the type. Note that this flag is not inherited by a
1467 -- derived type. See also the Is_Packed flag.
1469 -- Has_Pragma_Pure_Function (Flag179)
1470 -- Present in subprogram entities. It indicates that a valid pragma
1471 -- Pure_Function was given for the entity. In some cases, we need to
1472 -- know that Is_Pure was explicitly set using this pragma.
1474 -- Has_Pragma_Unreferenced (Flag180)
1475 -- Present in all entities. Set if a valid pragma Unreferenced applies
1476 -- to the pragma, indicating that no warning should be given if the
1477 -- entity has no references, but a warning should be given if it is
1478 -- in fact referenced.
1480 -- Has_Primitive_Operations (Flag120) [base type only]
1481 -- Present in all type entities. Set if at least one primitive operation
1482 -- is defined for the type.
1484 -- Has_Private_Ancestor (synthesized)
1485 -- Applies to all type and subtype entities. Returns True if at least
1486 -- one ancestor is private, and otherwise False if there are no private
1487 -- ancestors.
1489 -- Has_Private_Declaration (Flag155)
1490 -- Present in all entities. Returns True if it is the defining entity
1491 -- of a private type declaration or its corresponding full declaration.
1492 -- This flag is thus preserved when the full and the partial views are
1493 -- exchanged, to indicate if a full type declaration is a completion.
1494 -- Used for semantic checks in E.4 (18), and elsewhere.
1496 -- Has_Qualified_Name (Flag161)
1497 -- Present in all entities. Set True if the name in the Chars field
1498 -- has been replaced by its qualified name, as used for debug output.
1499 -- See Exp_Dbug for a full description of qualification requirements.
1500 -- For some entities, the name is the fully qualified name, but there
1501 -- are exceptions. In particular, for local variables in procedures,
1502 -- we do not include the procedure itself or higher scopes. See also
1503 -- the flag Has_Fully_Qualified_Name, which is set if the name does
1504 -- indeed include the fully qualified name.
1506 -- Has_Record_Rep_Clause (Flag65) [implementation base type only]
1507 -- Present in record types. Set if a record representation clause has
1508 -- been given for this record type. Used to prevent more than one such
1509 -- clause for a given record type. Note that this is initially cleared
1510 -- for a derived type, even though the representation is inherited. See
1511 -- also the flag Has_Specified_Layout.
1513 -- Has_Recursive_Call (Flag143)
1514 -- Present in procedures. Set if a direct parameterless recursive call
1515 -- is detected while analyzing the body. Used to activate some error
1516 -- checks for infinite recursion.
1518 -- Has_Size_Clause (Flag29)
1519 -- Present in entities for types and objects. Set if a size clause is
1520 -- present for the entity. Used to prevent multiple Size clauses for a
1521 -- given entity. Note that it is always initially cleared for a derived
1522 -- type, even though the Size for such a type is inherited from a Size
1523 -- clause given for the parent type.
1525 -- Has_Small_Clause (Flag67)
1526 -- Present in ordinary fixed point types (but not subtypes). Indicates
1527 -- that a small clause has been given for the entity. Used to prevent
1528 -- multiple Small clauses for a given entity. Note that it is always
1529 -- initially cleared for a derived type, even though the Small for such
1530 -- a type is inherited from a Small clause given for the parent type.
1532 -- Has_Specified_Layout (Flag100) [implementation base type only]
1533 -- Present in all type entities. Set for a record type or subtype if
1534 -- the record layout has been specified by a record representation
1535 -- clause. Note that this differs from the flag Has_Record_Rep_Clause
1536 -- in that it is inherited by a derived type. Has_Record_Rep_Clause is
1537 -- used to indicate that the type is mentioned explicitly in a record
1538 -- representation clause, and thus is not inherited by a derived type.
1539 -- This flag is always False for non-record types.
1541 -- Has_Specified_Stream_Input (Flag190)
1542 -- Has_Specified_Stream_Output (Flag191)
1543 -- Has_Specified_Stream_Read (Flag192)
1544 -- Has_Specified_Stream_Write (Flag193)
1545 -- Present in all type and subtype entities. Set for a given view if the
1546 -- corresponding stream-oriented attribute has been defined by an
1547 -- attribute definition clause. When such a clause occurs, a TSS is set
1548 -- on the underlying full view; the flags are used to track visibility of
1549 -- the attribute definition clause for partial or incomplete views.
1551 -- Has_Storage_Size_Clause (Flag23) [implementation base type only]
1552 -- Present in task types and access types. It is set if a Storage_Size
1553 -- clause is present for the type. Used to prevent multiple clauses for
1554 -- one type. Note that this flag is initially cleared for a derived type
1555 -- even though the Storage_Size for such a type is inherited from a
1556 -- Storage_Size clause given for the parent type. Note that in the case
1557 -- of access types, this flag is present only in the root type, since a
1558 -- storage size clause cannot be given to a derived type.
1560 -- Has_Stream_Size_Clause (Flag184)
1561 -- This flag is set on types which have a Stream_Size clause attribute.
1562 -- Used to prevent multiple Stream_Size clauses for a given entity.
1564 -- Has_Subprogram_Descriptor (Flag93)
1565 -- This flag is set on entities for which zero-cost exception subprogram
1566 -- descriptors can be generated (subprograms and library level package
1567 -- declarations and bodies). It indicates that a subprogram descriptor
1568 -- has been generated, and is used to suppress generation of multiple
1569 -- descriptors (e.g. when instantiating generic bodies).
1571 -- Has_Task (Flag30) [base type only]
1572 -- Present in all type entities. Set on task types themselves, and also
1573 -- (recursively) on any composite type which has a component for which
1574 -- Has_Task is set. The meaning is that an allocator of such an object
1575 -- must create the required tasks. Note that the flag is not set on
1576 -- access types, even if they designate an object that Has_Task.
1578 -- Has_Unchecked_Union (Flag123) [base type only]
1579 -- Present in all type entities. Set on unchecked unions themselves
1580 -- and (recursively) on any composite type which has a component for
1581 -- which Has_Unchecked_Union is set. The meaning is that a comparison
1582 -- operation for the type is not permitted. Note that the flag is not
1583 -- set on access types, even if they designate an object that has
1584 -- the flag Has_Unchecked_Union set.
1586 -- Has_Unknown_Discriminants (Flag72)
1587 -- Present in all type entities. Types can have unknown discriminants
1588 -- either from their declaration or through type derivation. The use
1589 -- of this flag exactly meets the spec in RM 3.7(26). Note that all
1590 -- class-wide types are considered to have unknown discriminants.
1591 -- Note that both Has_Discriminants and Has_Unknown_Discriminants may
1592 -- be true for a type. Class-wide types and their subtypes have
1593 -- unknown discriminants and can have declared ones as well. Private
1594 -- types declared with unknown discriminants may have a full view that
1595 -- has explicit discriminants, and both flag will be set on the partial
1596 -- view, to insure that discriminants are properly inherited in certain
1597 -- contexts.
1599 -- Has_Volatile_Components (Flag87) [implementation base type only]
1600 -- Present in all types and objects. Set only for an array type or
1601 -- array object if a valid pragma Volatile_Components or a valid
1602 -- pragma Atomic_Components applies to the type or object. Note that
1603 -- in the case of an object, this flag is only set on the object if
1604 -- there was an explicit pragma for the object. In other words, the
1605 -- proper test for whether an object has volatile components is to
1606 -- see if either the object or its base type has this flag set. Note
1607 -- that in the case of a type the pragma will be chained to the rep
1608 -- item chain of the first subtype in the usual manner.
1610 -- Has_Xref_Entry (Flag182)
1611 -- This flag is set if an entity has an entry in the Xref information
1612 -- generated in ali files. This is true for all source entities in the
1613 -- extended main source file. It is also true of entities in other
1614 -- packages that are referenced directly or indirectly from the main
1615 -- source file (indirect reference occurs when the main source file
1616 -- references an entity with a type reference. See package Lib.Xref
1617 -- for further details).
1619 -- Hiding_Loop_Variable (Node8)
1620 -- Present in variables. Set only if a variable of a discrete type is
1621 -- hidden by a loop variable in the same local scope, in which case
1622 -- the Hiding_Loop_Variable field of the hidden variable points to
1623 -- the E_Loop_Parameter entity doing the hiding. Used in processing
1624 -- warning messages if the hidden variable turns out to be unused
1625 -- or is referenced without being set.
1627 -- Homonym (Node4)
1628 -- Present in all entities. Link for list of entities that have the
1629 -- same source name and that are declared in the same or enclosing
1630 -- scopes. Homonyms in the same scope are overloaded. Used for name
1631 -- resolution and for the generation of debugging information.
1633 -- Implementation_Base_Type (synthesized)
1634 -- Applies to all types. Similar to Base_Type, but never returns a
1635 -- private type when applied to a non-private type. Instead in this
1636 -- case, it always returns the Underlying_Type of the base type, so that
1637 -- we still have a concrete type. Note: it is allowed to apply
1638 -- Implementation_Base_Type to other than a type, in which case it
1639 -- simply returns the entity unchanged.
1641 -- In_Package_Body (Flag48)
1642 -- Set on the entity that denotes the package (the defining occurrence
1643 -- of the package declaration) while analyzing and expanding the package
1644 -- body. Reset on completion of analysis/expansion.
1646 -- In_Private_Part (Flag45)
1647 -- Present in package entities. Flag is set to indicate that the
1648 -- private part is being analyzed. The flag is reset at the end of the
1649 -- package declaration.
1651 -- Inner_Instances (Elist23)
1652 -- Present in generic units. Contains element list of units that are
1653 -- instantiated within the given generic. Used to diagnose circular
1654 -- instantiations.
1656 -- Interface_Name (Node21)
1657 -- Present in exceptions, functions, procedures, variables, constants,
1658 -- and packages. Set to Empty unless an export, import, or interface
1659 -- name pragma has explicitly specified an external name, in which
1660 -- case it references an N_String_Literal node for the specified
1661 -- external name. In the case of exceptions, the field is set by
1662 -- Import_Exception/Export_Exception (which can be used in OpenVMS
1663 -- versions only). Note that if this field is Empty, and Is_Imported
1664 -- or Is_Exported is set, then the default interface name is the name
1665 -- of the entity, cased in a manner that is appropriate to the system
1666 -- in use. Note that Interface_Name is ignored if an address clause
1667 -- is present (since it is meaningless in this case).
1669 -- An additional special case usage of this field is in JGNAT for
1670 -- E_Component and E_Discriminant. JGNAT allows these entities to
1671 -- be imported by specifying pragma Import within a component's
1672 -- containing record definition. This supports interfacing to
1673 -- object fields defined within Java classes, and such pragmas
1674 -- are generated by the jvm2ada binding generator tool whenever
1675 -- it processes classes with public object fields. A pragma Import
1676 -- for a component can define the External_Name of the imported
1677 -- Java field (which is generally needed, because Java names are
1678 -- case sensitive).
1680 -- In_Use (Flag8)
1681 -- Present in packages and types. Set when analyzing a use clause for
1682 -- the corresponding entity. Reset at end of corresponding declarative
1683 -- part. The flag on a type is also used to determine the visibility of
1684 -- the primitive operators of the type.
1686 -- Is_Abstract (Flag19)
1687 -- Present in all types, and also for functions and procedures. Set
1688 -- for abstract types and abstract subprograms.
1690 -- Is_Local_Anonymous_Access (Flag194)
1691 -- Present in access types. Set for an anonymous access type to indicate
1692 -- that the type is created for a record component with an access
1693 -- definition, an array component, or a stand-alone object. Such
1694 -- anonymous types have an accessibility level equal to that of the
1695 -- declaration in which they appear, unlike the anonymous access types
1696 -- that are created for access parameters and access discriminants.
1698 -- Is_Access_Constant (Flag69)
1699 -- Present in access types and subtypes. Indicates that the keyword
1700 -- constant was present in the access type definition.
1702 -- Is_Access_Type (synthesized)
1703 -- Applies to all entities, true for access types and subtypes
1705 -- Is_Ada_2005 (Flag185)
1706 -- Applies to all entities, true if a valid pragma Ada_05 applies to the
1707 -- entity, indicating that the entity is Ada 2005 only.
1709 -- Is_Aliased (Flag15)
1710 -- Present in objects whose declarations carry the keyword aliased,
1711 -- and on record components that have the keyword.
1713 -- Is_Always_Inlined (synthesized)
1714 -- Present in subprograms. True if there is a pragma Inline_Always for
1715 -- the subprogram.
1717 -- Is_AST_Entry (Flag132)
1718 -- Present in entry entities. Set if a valid pragma AST_Entry applies
1719 -- to the entry. This flag can only be set in OpenVMS versions of GNAT.
1720 -- Note: we also allow the flag to appear in entry families, but given
1721 -- the current implementation of the pragma AST_Entry, this flag will
1722 -- always be False in entry families.
1724 -- Is_Atomic (Flag85)
1725 -- Present in all type entities, and also in constants, components and
1726 -- variables. Set if a pragma Atomic or Shared applies to the entity.
1727 -- In the case of private and incomplete types, this flag is set in
1728 -- both the partial view and the full view.
1730 -- Is_Array_Type (synthesized)
1731 -- Applies to all entities, true for array types and subtypes
1733 -- Is_Asynchronous (Flag81)
1734 -- Present in all type entities and in procedure entities. Set
1735 -- if a pragma Asynchronous applies to the entity.
1737 -- Is_Bit_Packed_Array (Flag122) [implementation base type only]
1738 -- Present in all entities. This flag is set for a packed array
1739 -- type that is bit packed (i.e. the component size is known by the
1740 -- front end and is in the range 1-7, 9-15, 17-31, or 33-63). Is_Packed
1741 -- is always set if Is_Bit_Packed_Array is set, but it is possible for
1742 -- Is_Packed to be set without Is_Bit_Packed_Array for the case of an
1743 -- array having one or more index types that are enumeration types
1744 -- with non-standard enumeration representations.
1746 -- Is_Boolean_Type (synthesized)
1747 -- Applies to all entities, true for boolean types and subtypes,
1748 -- i.e. Standard.Boolean and all types ultimately derived from it.
1750 -- Is_By_Copy_Type (synthesized)
1751 -- Applies to all type entities. Returns true if the entity is
1752 -- a by copy type (RM 6.2(3)).
1754 -- Is_By_Reference_Type (synthesized)
1755 -- Applies to all type entities. True if the type is required to
1756 -- be passed by reference, as defined in (RM 6.2(4-9)).
1758 -- Is_Called (Flag102)
1759 -- Present in subprograms. Returns true if the subprogram is called
1760 -- in the unit being compiled or in a unit in the context. Used for
1761 -- inlining.
1763 -- Is_Character_Type (Flag63)
1764 -- Present in all entities, true for character types and subtypes,
1765 -- i.e. enumeration types that have at least one character literal.
1767 -- Is_Child_Unit (Flag73)
1768 -- Present in all entities. Set only for defining entities of program
1769 -- units that are child units (but False for subunits).
1771 -- Is_Class_Wide_Type (synthesized)
1772 -- Applies to all entities, true for class wide types and subtypes
1774 -- Is_Class_Wide_Equivalent_Type (Flag35)
1775 -- Present in record types and subtypes. Set to True, if the type acts
1776 -- as a class-wide equivalent type, i.e. the Equivalent_Type field of
1777 -- some class-wide subtype entity references this record type.
1779 -- Is_Compilation_Unit (Flag149)
1780 -- Present in all entities. Set if the entity is a package or subprogram
1781 -- entity for a compilation unit other than a subunit (since we treat
1782 -- subunits as part of the same compilation operation as the ultimate
1783 -- parent, we do not consider them to be separate units for this flag).
1785 -- Is_Completely_Hidden (Flag103)
1786 -- A flag set on an E_Discriminant entity. This flag can be set only
1787 -- for girder discriminants of untagged types. When set, the entity
1788 -- is a girder discriminant of a derived untagged type which is not
1789 -- directly visible in the derived type because the derived type or
1790 -- one of its ancestors have renamed the discriminants in the root
1791 -- type. Note that there are girder discriminants which are not
1792 -- Completely_Hidden (e.g. the discriminants of a root type).
1794 -- Is_Composite_Type (synthesized)
1795 -- Applies to all entities, true for all composite types and
1796 -- subtypes. Either Is_Composite_Type or Is_Elementary_Type (but
1797 -- not both) is true of any type.
1799 -- Is_Concurrent_Record_Type (Flag20)
1800 -- Present in record types and subtypes. Set if the type was created
1801 -- by the expander to represent a task or protected type. For every
1802 -- concurrent type, such as record type is constructed, and task and
1803 -- protected objects are instances of this record type at runtime
1804 -- (Gigi will replace declarations of the concurrent type using the
1805 -- declarations of the corresponding record type). See package Exp_Ch9
1806 -- for further details.
1808 -- Is_Concurrent_Type (synthesized)
1809 -- Applies to all entities, true for task types and subtypes and
1810 -- for protected types and subtypes.
1812 -- Is_Constrained (Flag12)
1813 -- Present in types or subtypes which may have index, discriminant
1814 -- or range constraint (i.e. array types and subtypes, record types
1815 -- and subtypes, string types and subtypes, and all numeric types).
1816 -- Set if the type or subtype is constrained.
1818 -- Is_Constr_Subt_For_U_Nominal (Flag80)
1819 -- Present in all types and subtypes. Set true only for the constructed
1820 -- subtype of an object whose nominal subtype is unconstrained. Note
1821 -- that the constructed subtype itself will be constrained.
1823 -- Is_Constr_Subt_For_UN_Aliased (Flag141)
1824 -- This flag can only be set if Is_Constr_Subt_For_U_Nominal is set. It
1825 -- indicates that in addition the object concerned is aliased. This flag
1826 -- is used by Gigi to determine whether a template must be constructed.
1828 -- Is_Constructor (Flag76)
1829 -- Present in function and procedure entities. Set if a pragma
1830 -- CPP_Constructor applies to the subprogram.
1832 -- Is_Controlled (Flag42) [base type only]
1833 -- Present in all type entities. Indicates that the type is controlled,
1834 -- i.e. is either a descendant of Ada.Finalization.Controlled or of
1835 -- Ada.Finalization.Limited_Controlled.
1837 -- Is_Controlling_Formal (Flag97)
1838 -- Present in all Formal_Kind entity. Marks the controlling parameters
1839 -- of dispatching operations.
1841 -- Is_CPP_Class (Flag74)
1842 -- Present in all type entities, set only for tagged and untagged
1843 -- record types to which the pragma CPP_Class has been applied.
1845 -- Is_Decimal_Fixed_Point_Type (synthesized)
1846 -- Applies to all type entities, true for decimal fixed point
1847 -- types and subtypes.
1849 -- Is_Derived_Type (synthesized)
1850 -- Applies to all type entities. Determine if given entity is a
1851 -- derived type
1853 -- Is_Discrete_Type (synthesized)
1854 -- Applies to all entities, true for all discrete types and subtypes
1856 -- Is_Discrete__Or_Fixed_Point_Type (synthesized)
1857 -- Applies to all entities, true for all discrete types and subtypes
1858 -- and all fixed-point types and subtypes.
1860 -- Is_Discrim_SO_Function (Flag176)
1861 -- Present in all entities, set only in E_Function entities that Layout
1862 -- creates to compute discriminant-dependent dynamic size/offset values.
1864 -- Is_Dispatching_Operation (Flag6)
1865 -- Present in all entities. Set true for procedures, functions,
1866 -- generic procedures and generic functions if the corresponding
1867 -- operation is dispatching.
1869 -- Is_Dynamic_Scope (synthesized)
1870 -- Applies to all Entities. Returns True if the entity is a dynamic
1871 -- scope (i.e. a block, a subprogram a task_type or an entry).
1873 -- Is_Elementary_Type (synthesized)
1874 -- Applies to all entities, true for all elementary types and
1875 -- subtypes. Either Is_Composite_Type or Is_Elementary_Type (but
1876 -- not both) is true of any type.
1878 -- Is_Eliminated (Flag124)
1879 -- Present in type entities, subprogram entities, and object entities.
1880 -- Indicates that the corresponding entity has been eliminated by use
1881 -- of pragma Eliminate. Also used to mark subprogram entities whose
1882 -- declaration and body are within unreachable code that is removed.
1884 -- Is_Enumeration_Type (synthesized)
1885 -- Present in all entities, true for enumeration types and subtypes
1887 -- Is_Entry (synthesized)
1888 -- Applies to all entities, True only for entry and entry family
1889 -- entities and False for all other entity kinds.
1891 -- Is_Entry_Formal (Flag52)
1892 -- Present in all entities. Set only for entry formals (which can
1893 -- only be in, in-out or out parameters). This flag is used to speed
1894 -- up the test for the need to replace references in Exp_Ch2.
1896 -- Is_Exported (Flag99)
1897 -- Present in all entities. Set if the entity is exported. For now we
1898 -- only allow the export of constants, exceptions, functions, procedures
1899 -- and variables, but that may well change later on. Exceptions can only
1900 -- be exported in the OpenVMS and Java VM implementations of GNAT.
1902 -- Is_First_Subtype (Flag70)
1903 -- Present in all entities. True for first subtypes (RM 3.2.1(6)),
1904 -- i.e. the entity in the type declaration that introduced the type.
1905 -- This may be the base type itself (e.g. for record declarations and
1906 -- enumeration type declarations), or it may be the first subtype of
1907 -- an anonymous base type (e.g. for integer type declarations or
1908 -- constrained array declarations).
1910 -- Is_Fixed_Point_Type (synthesized)
1911 -- Applies to all entities, true for decimal and ordinary fixed
1912 -- point types and subtypes
1914 -- Is_Floating_Point_Type (synthesized)
1915 -- Applies to all entities, true for float types and subtypes
1917 -- Is_Formal (synthesized)
1918 -- Applies to all entities, true for IN, IN OUT and OUT parameters
1920 -- Is_Formal_Subprogram (Flag111)
1921 -- Defined on all entities, true for generic formal subprograms.
1923 -- Is_For_Access_Subtype (Flag118)
1924 -- Present in E_Private_Subtype and E_Record_Subtype entities.
1925 -- Means the sole purpose of the type is to be designated by an
1926 -- Access_Subtype and hence should not be expanded into components
1927 -- because the type may not have been found or frozen yet.
1929 -- Is_Frozen (Flag4)
1930 -- Present in all type entities. Set if the type has been frozen.
1932 -- Is_Generic_Actual_Type (Flag94)
1933 -- Present in the subtype declaration that renames the generic formal
1934 -- as a subtype of the actual. Guarantees that the subtype is not static
1935 -- within the instance.
1937 -- Is_Generic_Instance (Flag130)
1938 -- Present in all entities. Set to indicate that the entity is an
1939 -- instance of a generic unit.
1941 -- Is_Generic_Subprogram (synthesized)
1942 -- Applies to all entities. Yields True for a generic subprogram
1943 -- (generic function, generic subprogram), False for all other entities.
1945 -- Is_Generic_Type (Flag13)
1946 -- Present in all types and subtypes. Set for types which are generic
1947 -- formal types. Such types have an Ekind that corresponds to their
1948 -- classification, so the Ekind cannot be used to identify generic types.
1950 -- Is_Generic_Unit (synthesized)
1951 -- Applies to all entities. Yields True for a generic unit (generic
1952 -- package, generic function, generic procedure), and False for all
1953 -- other entities.
1955 -- Is_Hidden (Flag57)
1956 -- Present in all entities. Set true for all entities declared in the
1957 -- private part or body of a package. Also marks generic formals of a
1958 -- formal package declared without a box. For library level entities,
1959 -- this flag is set if the entity is not publicly visible.
1961 -- Is_Hidden_Open_Scope (Flag171)
1962 -- Present in all entities. Set true for a scope that contains the
1963 -- instantiation of a child unit, and whose entities are not visible
1964 -- during analysis of the instance.
1966 -- Is_Immediately_Visible (Flag7)
1967 -- Present in all entities. Set if entity is immediately visible, i.e.
1968 -- is defined in some currently open scope (RM 8.3(4)).
1970 -- Is_Imported (Flag24)
1971 -- Present in all entities. Set if the entity is imported. For now we
1972 -- only allow the import of exceptions, functions, procedures, packages.
1973 -- and variables. Exceptions can only be imported in the OpenVMS and
1974 -- Java VM implementations of GNAT. Packages and types can only be
1975 -- imported in the Java VM implementation.
1977 -- Is_Incomplete_Or_Private_Type (synthesized)
1978 -- Applies to all entities, true for private and incomplete types
1980 -- Is_Indefinite_Subtype (synthesized)
1981 -- Applies to all entities for types and subtypes. Determines if given
1982 -- entity is an unconstrained array type or subtype, a discriminated
1983 -- record type or subtype with no initial discriminant values or a
1984 -- class wide type or subtype.
1986 -- Is_Inlined (Flag11)
1987 -- Present in all entities. Set for functions and procedures which are
1988 -- to be inlined. For subprograms created during expansion, this flag
1989 -- may be set directly by the expander to request inlining. Also set
1990 -- for packages that contain inlined subprograms, whose bodies must be
1991 -- be compiled. Is_Inlined is also set on generic subprograms and is
1992 -- inherited by their instances. It is also set on the body entities
1993 -- of inlined subprograms. See also Has_Pragma_Inline.
1995 -- Is_Instantiated (Flag126)
1996 -- Present in generic packages and generic subprograms. Set if the unit
1997 -- is instantiated from somewhere in the extended main source unit. This
1998 -- flag is used to control warnings about the unit being uninstantiated.
1999 -- Also set in a package that is used as an actual for a generic package
2000 -- formal in an instantiation. Also set on a parent instance, in the
2001 -- instantiation of a child, which is implicitly declared in the parent.
2003 -- Is_Integer_Type (synthesized)
2004 -- Applies to all entities, true for integer types and subtypes
2006 -- Is_Interface (Flag186)
2007 -- Present in record types and subtypes to indicate that the current
2008 -- entity corresponds with an abstract interface. Because abstract
2009 -- interfaces are conceptually a special kind of abstract tagged types
2010 -- we represent them by means of tagged record types and subtypes
2011 -- marked with this attribute. This allows us to reuse most of the
2012 -- compiler support for abstract tagged types to implement interfaces
2013 -- (Ada 2005: AI-251).
2015 -- Is_Internal (Flag17)
2016 -- Present in all entities. Set to indicate an entity created during
2017 -- semantic processing (e.g. an implicit type, or a temporary). The
2018 -- only current use of this flag is to indicate that temporaries
2019 -- generated for the result of an inlined function call need not be
2020 -- initialized, even when scalars are initialized or normalized.
2022 -- Is_Interrupt_Handler (Flag89)
2023 -- Present in procedures. Set if a pragma Interrupt_Handler applies
2024 -- to the procedure. The procedure must be parameterless, and on all
2025 -- targets except AAMP it must be a protected procedure.
2027 -- Is_Intrinsic_Subprogram (Flag64)
2028 -- Present in functions and procedures. It is set if a valid pragma
2029 -- Interface or Import is present for this subprogram specifying pragma
2030 -- Intrinsic. Valid means that the name and profile of the subprogram
2031 -- match the requirements of one of the recognized intrinsic subprograms
2032 -- (see package Sem_Intr for details). Note: the value of Convention for
2033 -- such an entity will be set to Convention_Intrinsic, but it is the
2034 -- setting of Is_Intrinsic_Subprogram, NOT simply having convention set
2035 -- to intrinsic, which causes intrinsic code to be generated.
2037 -- Is_Itype (Flag91)
2038 -- Present in all entities, set for Itypes. If it is set, then the
2039 -- declaration for the type does not appear explicitly in the tree.
2040 -- Instead gigi will elaborate the type when it is first used.
2041 -- Has_Delayed_Freeze can be set for Itypes, and the meaning is that
2042 -- the first use (the one which causes the type to be defined) will
2043 -- be the freeze node. Note that an important restriction on Itypes
2044 -- is that the first use of such a type (the one that causes it to be
2045 -- defined) must be in the same scope as the type.
2047 -- Is_Known_Non_Null (Flag37)
2048 -- Present in all entities. Relevant (and can be set True) only for
2049 -- objects of an access type. It is set if the object is currently
2050 -- known to have a non-null value (meaning that no access checks
2051 -- are needed). The indication can for example come from assignment
2052 -- of an access parameter or an allocator.
2054 -- Note: this flag is set according to the sequential flow of the
2055 -- program, watching the current value of the variable. However,
2056 -- this processing can miss cases of changing the value of an aliased
2057 -- or constant object, so even if this flag is set, it should not
2058 -- be believed if the variable is aliased or volatile. It would
2059 -- be a little neater to avoid the flag being set in the first
2060 -- place in such cases, but that's trickier, and there is only
2061 -- one place that tests the value anyway.
2063 -- The flag is dynamically set and reset as semantic analysis and
2064 -- expansion proceeds. Its value is meaningless once the tree is
2065 -- fully constructed, since it simply indicates the last state.
2066 -- Thus this flag has no meaning to the back end.
2068 -- Is_Known_Valid (Flag170)
2069 -- Present in all entities. Relevant for types (and subtype) and
2070 -- for objects (and enumeration literals) of a discrete type.
2072 -- The purpose of this flag is to implement the requirement stated
2073 -- in (RM 13.9.1(9-11)) which require that the use of possibly invalid
2074 -- values may not cause programs to become erroneous. See the function
2075 -- Exp_Util.Expr_Known_Valid for further details. Note that the setting
2076 -- is conservative, in the sense that if the flag is set, it must be
2077 -- right. If the flag is not set, nothing is known about the validity.
2079 -- For enumeration literals, the flag is always set, since clearly
2080 -- an enumeration literal represents a valid value. Range checks
2081 -- where necessary will ensure that this valid value is appropriate.
2083 -- For objects, the flag indicates the state of knowledge about the
2084 -- current value of the object. This may be modified during expansion,
2085 -- and thus the final value is not relevant to gigi.
2087 -- For types and subtypes, the flag is set if all possible bit patterns
2088 -- of length Object_Size (i.e. Esize of the type) represent valid values
2089 -- of the type. In general for such tytpes, all values are valid, the
2090 -- only exception being the case where an object of the type has an
2091 -- explicit size that is greater than Object_Size.
2093 -- For non-discrete objects, the setting of the Is_Known_Valid flag is
2094 -- not defined, and is not relevant, since the considerations of the
2095 -- requirement in (RM 13.9.1(9-11)) do not apply.
2097 -- The flag is dynamically set and reset as semantic analysis and
2098 -- expansion proceeds. Its value is meaningless once the tree is
2099 -- fully constructed, since it simply indicates the last state.
2100 -- Thus this flag has no meaning to the back end.
2102 -- Is_Limited_Composite (Flag106)
2103 -- Present in all entities. True for composite types that have a
2104 -- limited component. Used to enforce the rule that operations on
2105 -- the composite type that depend on the full view of the component
2106 -- do not become visible until the immediate scope of the composite
2107 -- type itself (RM 7.3.1 (5)).
2109 -- Is_Limited_Record (Flag25)
2110 -- Present in all entities. Set to true for record (sub)types if the
2111 -- record is declared to be limited. Note that this flag is not set
2112 -- simply because some components of the record are limited.
2114 -- Is_Limited_Type (synthesized)
2115 -- Applies to all entities. True if entity is a limited type (limited
2116 -- private type, task type, protected type, composite containing a
2117 -- limited component, or a subtype of any of these types).
2119 -- Is_Machine_Code_Subprogram (Flag137)
2120 -- Present in subprogram entities. Set to indicate that the subprogram
2121 -- is a machine code subprogram (i.e. its body includes at least one
2122 -- code statement). Also indicates that all necessary semantic checks
2123 -- as required by RM 13.8(3) have been performed.
2125 -- Is_Modular_Integer_Type (synthesized)
2126 -- Applies to all entities. True if entity is a modular integer type
2128 -- Is_Non_Static_Subtype (Flag109)
2129 -- This flag is present in all type and subtype entities. It is set in
2130 -- some (but not all) cases in which a subtype is known to be non-static.
2131 -- Before this flag was added, the computation of whether a subtype was
2132 -- static was entirely synthesized, by looking at the bounds, and the
2133 -- immediate subtype parent. However, this method does not work for some
2134 -- Itypes that have no parent set (and the only way to find the immediate
2135 -- subtype parent is to go through the tree). For now, this flay is set
2136 -- conservatively, i.e. if it is set then for sure the subtype is non-
2137 -- static, but if it is not set, then the type may or may not be static.
2138 -- Thus the test for a static subtype is that this flag is clear AND
2139 -- that the bounds are static AND that the parent subtype (if available
2140 -- to be tested) is static. Eventually we should make sure this flag
2141 -- is always set right, at which point, these comments can be removed,
2142 -- and the tests for static subtypes greatly simplified.
2144 -- Is_Null_Init_Proc (Flag178)
2145 -- Present in procedure entities. Set for generated init proc procedures
2146 -- (used to initialize composite types), if the code for the procedure
2147 -- is null (i.e. is a return and nothing else). Such null initialization
2148 -- procedures are generated in case some client is compiled using the
2149 -- Initialize_Scalars pragma, generating a call to this null procedure,
2150 -- but there is no need to call such procedures within a compilation
2151 -- unit, and this flag is used to suppress such calls.
2153 -- Is_Numeric_Type (synthesized)
2154 -- Applies to all entities, true for all numeric types and subtypes
2155 -- (integer, fixed, float).
2157 -- Is_Object (synthesized)
2158 -- Applies to all entities, true for entities representing objects,
2159 -- including generic formal parameters.
2161 -- Is_Obsolescent (Flag153)
2162 -- Present in all entities. Set only for subprograms when a valid pragma
2163 -- Obsolescent applies to the subprogram.
2165 -- Is_Optional_Parameter (Flag134)
2166 -- Present in parameter entities. Set if the parameter is specified as
2167 -- optional by use of a First_Optional_Parameter argument to one of the
2168 -- extended Import pragmas. Can only be set for OpenVMS versions of GNAT.
2170 -- Is_Ordinary_Fixed_Point_Type (synthesized)
2171 -- Applies to all entities, true for ordinary fixed point types
2172 -- and subtypes
2174 -- Is_Overriding_Operation (Flag39)
2175 -- Present in subprograms. Set if the subprogram is a primitive
2176 -- operation of a derived type, that overrides an inherited operation.
2178 -- Is_Package (synthesized)
2179 -- Applies to all entities. True for packages and generic packages.
2180 -- False for all other entities.
2182 -- Is_Package_Body_Entity (Flag160)
2183 -- Present in all entities. Set for entities defined at the top level
2184 -- of a package body. Used to control externally generated names.
2186 -- Is_Packed (Flag51) [implementation base type only]
2187 -- Present in all type entities. This flag is set only for record and
2188 -- array types which have a packed representation. There are three
2189 -- cases which cause packing:
2191 -- 1. Explicit use of pragma Pack for an array of package components
2192 -- 2. Explicit use of pragma Pack to pack a record
2193 -- 4. Setting Component_Size of an array to a bit-packable value
2194 -- 3. Indexing an array with a non-standard enumeration type.
2196 -- For records, Is_Packed is always set if Has_Pack_Pragma is set,
2197 -- and can also be set on its own in a derived type which inherited
2198 -- its packed status.
2200 -- For arrays, Is_Packed is set if an array is bit packed (i.e. the
2201 -- component size is known at compile time and is 1-7, 9-15 or 17-31),
2202 -- or if the array has one or more index types that are enumeration
2203 -- types with non-standard representations (in GNAT, we store such
2204 -- arrays compactly, using the Pos of the enumeration type value).
2206 -- As for the case of records, Is_Packed can be set on its own for a
2207 -- derived type, with the same dual before/after freeze meaning.
2208 -- Is_Packed can also be set as the result of an explicit component
2209 -- size clause that specifies an appropriate component size.
2211 -- In the bit packed array case, Is_Bit_Packed_Array will be set in
2212 -- the bit packed case once the array type is frozen.
2214 -- Before an array type is frozen, Is_Packed will always be set if
2215 -- Has_Pack_Pragma is set. Before the freeze point, it is not possible
2216 -- to know the component size, since the component type is not frozen
2217 -- until the array type is frozen. Thus Is_Packed for an array type
2218 -- before it is frozen means that packed is required. Then if it turns
2219 -- out that the component size is not suitable for bit packing, the
2220 -- Is_Packed flag gets turned off.
2222 -- Is_Packed_Array_Type (Flag138)
2223 -- Present in all entities. This flag is set on the entity for the type
2224 -- used to implement a packed array (either a modular type, or a subtype
2225 -- of Packed_Bytes{1,2,4} as appropriate). The flag is set if and only
2226 -- if the type appears in the Packed_Array_Type field of some other type
2227 -- entity. It is used by Gigi to activate the special processing for such
2228 -- types (unchecked conversions that would not otherwise be allowed are
2229 -- allowed for such types). If the Is_Packed_Array_Type flag is set in
2230 -- an entity, then the Original_Array_Type field of this entity points
2231 -- to the original array type for which this is the packed array type.
2233 -- Is_Potentially_Use_Visible (Flag9)
2234 -- Present in all entities. Set if entity is potentially use visible,
2235 -- i.e. it is defined in a package that appears in a currently active
2236 -- use clause (RM 8.4(8)). Note that potentially use visible entities
2237 -- are not necessarily use visible (RM 8.4(9-11)).
2239 -- Is_Preelaborated (Flag59)
2240 -- Present in all entities, set in E_Package and E_Generic_Package
2241 -- entities to which a pragma Preelaborate is applied, and also in
2242 -- all entities within such packages. Note that the fact that this
2243 -- flag is set does not necesarily mean that no elaboration code is
2244 -- generated for the package.
2246 -- Is_Primitive_Wrapper (Flag195)
2247 -- Present in E_Procedures. Primitive wrappers are Expander-generated
2248 -- procedures that wrap entries of protected or task types implementing
2249 -- a limited interface.
2251 -- Is_Private_Composite (Flag107)
2252 -- Present in composite types that have a private component. Used to
2253 -- enforce the rule that operations on the composite type that depend
2254 -- on the full view of the component, do not become visible until the
2255 -- immediate scope of the composite type itself (7.3.1 (5)). Both this
2256 -- flag and Is_Limited_Composite are needed.
2258 -- Is_Private_Descendant (Flag53)
2259 -- Present in entities that can represent library units (packages,
2260 -- functions, procedures). Set if the library unit is itself a private
2261 -- child unit, or if it is the descendent of a private child unit.
2263 -- Is_Private_Type (synthesized)
2264 -- Applies to all entities, true for private types and subtypes,
2265 -- as well as for record with private types as subtypes
2267 -- Is_Protected_Type (synthesized)
2268 -- Applies to all entities, true for protected types and subtypes
2270 -- Is_Public (Flag10)
2271 -- Present in all entities. Set to indicate that an entity defined in
2272 -- one compilation unit can be referenced from other compilation units.
2273 -- If this reference causes a reference in the generated variable, for
2274 -- example in the case of a variable name, then Gigi will generate an
2275 -- appropriate external name for use by the linker.
2277 -- Is_Protected_Private (synthesized)
2278 -- Applies to a record component. Returns true if this component
2279 -- is used to represent a private declaration of a protected type.
2281 -- Is_Protected_Record_Type (synthesized)
2282 -- Applies to all entities, true if Is_Concurrent_Record_Type
2283 -- Corresponding_Concurrent_Type is a protected type.
2285 -- Is_Pure (Flag44)
2286 -- Present in all entities. Set in all entities of a unit to which a
2287 -- pragma Pure is applied, and also set for the entity of the unit
2288 -- itself. In addition, this flag may be set for any other functions
2289 -- or procedures that are known to be side effect free, so in the case
2290 -- of subprograms, the Is_Pure flag may be used by the optimizer to
2291 -- imply that it can assume freedom from side effects (other than those
2292 -- resulting from assignment to out parameters, or to objects designated
2293 -- by access parameters).
2295 -- Is_Pure_Unit_Access_Type (Flag189)
2296 -- Present in access type and subtype entities. Set if the type or
2297 -- subtype appears in a pure unit. Used to give an error message at
2298 -- freeze time if the access type has a storage pool.
2300 -- Is_Real_Type (synthesized)
2301 -- Applies to all entities, true for real types and subtypes
2303 -- Is_Record_Type (synthesized)
2304 -- Applies to all entities, true for record types and subtypes,
2305 -- includes class-wide types and subtypes (which are also records)
2307 -- Is_Remote_Call_Interface (Flag62)
2308 -- Present in all entities, set in E_Package and E_Generic_Package
2309 -- entities to which a pragma Remote_Call_Interace is applied, and
2310 -- also in all entities within such packages.
2312 -- Is_Remote_Types (Flag61)
2313 -- Present in all entities, set in E_Package and E_Generic_Package
2314 -- entities to which a pragma Remote_Types is applied, and also in
2315 -- all entities within such packages.
2317 -- Is_Renaming_Of_Object (Flag112)
2318 -- Present in all entities, set only for a variable or constant for
2319 -- which the Renamed_Object field is non-empty and for which the
2320 -- renaming is handled by the front end, by macro substitution of
2321 -- a copy of the (evaluated) name tree whereever the variable is used.
2323 -- Is_Return_By_Reference_Type (synthesized)
2324 -- Applies to all type entities. True if the type is required to
2325 -- be returned by reference, as defined in 6.5(11-16).
2327 -- Is_Scalar_Type (synthesized)
2328 -- Applies to all entities, true for scalar types and subtypes
2330 -- Is_Shared_Passive (Flag60)
2331 -- Present in all entities, set in E_Package and E_Generic_Package
2332 -- entities to which a pragma Shared_Passive is applied, and also in
2333 -- all entities within such packages.
2335 -- Is_Statically_Allocated (Flag28)
2336 -- Present in all entities. This can only be set True for exception,
2337 -- variable, constant, and type/subtype entities. If the flag is set,
2338 -- then the variable or constant must be allocated statically rather
2339 -- than on the local stack frame. For exceptions, the meaning is that
2340 -- the exception data should be allocated statically (and indeed this
2341 -- flag is always set for exceptions, since exceptions do not have
2342 -- local scope). For a type, the meaning is that the type must be
2343 -- elaborated at the global level rather than locally. No type marked
2344 -- with this flag may depend on a local variable, or on any other type
2345 -- which does not also have this flag set to True. For a variable or
2346 -- or constant, if the flag is set, then the type of the object must
2347 -- either be declared at the library level, or it must also have the
2348 -- flag set (since to allocate the oject statically, its type must
2349 -- also be elaborated globally).
2351 -- Is_Subprogram (synthesized)
2352 -- Applies to all entities, true for bodies of functions, procedures
2353 -- and operators.
2355 -- Is_String_Type (synthesized)
2356 -- Applies to all type entities. Determines if the given type is a
2357 -- string type, i.e. it is directly a string type or string subtype,
2358 -- or a string slice type, or an array type with one dimension and a
2359 -- component type that is a character type.
2361 -- Is_Tag (Flag78)
2362 -- Present in E_Component. For regular tagged type this flag is set on
2363 -- the tag component (whose name is Name_uTag) and for CPP_Class tagged
2364 -- types, this flag marks the pointer to the main vtable (i.e. the one
2365 -- to be extended by derivation)
2367 -- Is_Tagged_Type (Flag55)
2368 -- Present in all entities, true for an entity for a tagged type.
2370 -- Is_Task_Record_Type (synthesized)
2371 -- Applies to all entities, true if Is_Concurrent_Record_Type
2372 -- Corresponding_Concurrent_Type is a task type.
2374 -- Is_Task_Type (synthesized)
2375 -- Applies to all entities, true for task types and subtypes
2377 -- Is_Thread_Body (Flag77)
2378 -- Applies to subprogram entities. Set if a valid Thread_Body pragma
2379 -- applies to this subprogram, which is thus a thread body.
2381 -- Is_True_Constant (Flag163)
2382 -- This flag is set in constants and variables which have an initial
2383 -- value specified but which are never assigned, partially or in the
2384 -- whole. For variables, it means that the variable was initialized
2385 -- but never modified, and hence can be treated as a constant by the
2386 -- code generator. For a constant, it means that the constant was not
2387 -- modified by generated code (e.g. to set a discriminant in an init
2388 -- proc). Assignments by user or generated code will reset this flag.
2390 -- Note: there is one situation in which the back end does not permit
2391 -- this flag to be set, even if no assignments are generated. This is
2392 -- the case of an object of a record or array type which is initialized
2393 -- with an aggregate, and is itself used as the expression initializing
2394 -- an atomic object, or the right hand side of an assignment to an atomic
2395 -- object. In this case the object must not have Is_True_Constant set,
2396 -- even though no assignments are generated (the reason for this is that
2397 -- the back end must not optimize the object away, because that would
2398 -- violate the restriction on aggregates in these positions).
2400 -- Is_Type (synthesized)
2401 -- Applies to all entities, true for a type entity
2403 -- Is_Unchecked_Union (Flag117)
2404 -- Present in all entities. Set only in record types to which the
2405 -- pragma Unchecked_Union has been validly applied.
2407 -- Is_Unsigned_Type (Flag144)
2408 -- Present in all types, but can be set only for discrete and fixed-point
2409 -- type and subtype entities. This flag is only valid if the entity is
2410 -- frozen. If set it indicates that the representation is known to be
2411 -- unsigned (i.e. that no negative values appear in the range). This is
2412 -- normally just a reflection of the lower bound of the subtype or base
2413 -- type, but there is one case in which the setting is non-obvious,
2414 -- namely the case of an unsigned subtype of a signed type from which
2415 -- a further subtype is obtained using variable bounds. This further
2416 -- subtype is still unsigned, but this cannot be determined by looking
2417 -- at its bounds or the bounds of the corresponding base type.
2419 -- Is_Valued_Procedure (Flag127)
2420 -- Present in procedure entities. Set if an Import_Valued_Procedure
2421 -- or Export_Valued_Procedure pragma applies to the procedure entity.
2423 -- Is_Visible_Child_Unit (Flag116)
2424 -- Present in compilation units that are child units. Once compiled,
2425 -- child units remain chained to the entities in the parent unit, and
2426 -- a separate flag must be used to indicate whether the names are
2427 -- visible by selected notation, or not.
2429 -- Is_VMS_Exception (Flag133)
2430 -- Present in all entities. Set only for exception entities where the
2431 -- exception was specified in an Import_Exception or Export_Exception
2432 -- pragma with the VMS option for Form. See description of these pragmas
2433 -- for details. This flag can only be set in OpenVMS versions of GNAT.
2435 -- Is_Volatile (Flag16)
2436 -- Present in all type entities, and also in constants, components and
2437 -- variables. Set if a pragma Volatile applies to the entity. Also set
2438 -- if pragma Shared or pragma Atomic applies to entity. In the case of
2439 -- private or incomplete types, this flag is set in both the private
2440 -- and full view. The flag is not set reliably on private subtypes,
2441 -- and is always retrieved from the base type (but this is not a base-
2442 -- type-only attribute because it applies to other entities). Note that
2443 -- the back end should use Treat_As_Volatile, rather than Is_Volatile
2444 -- to indicate code generation requirements for volatile variables.
2445 -- Similarly, any front end test which is concerned with suppressing
2446 -- optimizations on volatile objects should test Treat_As_Volatile
2447 -- rather than testing this flag.
2449 -- Is_Wrapper_Package (synthesized)
2450 -- Present in package entities. Indicates that the package has been
2451 -- created as a wrapper for a subprogram instantiation.
2453 -- Kill_Elaboration_Checks (Flag32)
2454 -- Present in all entities. Set by the expander to kill elaboration
2455 -- checks which are known not to be needed. Equivalent in effect to
2456 -- the use of pragma Supress (Elaboration_Checks) for that entity
2457 -- except that the effect is permanent and cannot be undone by a
2458 -- subsequent pragma Unsuppress.
2460 -- Kill_Range_Checks (Flag33)
2461 -- Present in all entities. Set by the expander to kill elaboration
2462 -- checks which are known not to be needed. Equivalent in effect to
2463 -- the use of pragma Supress (Range_Checks) for that entity except
2464 -- that the result is permanent and cannot be undone by a subsequent
2465 -- pragma Unsuppress.
2467 -- Kill_Tag_Checks (Flag34)
2468 -- Present in all entities. Set by the expander to kill elaboration
2469 -- checks which are known not to be needed. Equivalent in effect to
2470 -- the use of pragma Supress (Tag_Checks) for that entity except
2471 -- that the result is permanent and cannot be undone by a subsequent
2472 -- pragma Unsuppress.
2474 -- Last_Entity (Node20)
2475 -- Present in all entities which act as scopes to which a list of
2476 -- associated entities is attached (blocks, class subtypes and types,
2477 -- entries, functions, loops, packages, procedures, protected objects,
2478 -- record types and subtypes, private types, task types and subtypes).
2479 -- Points to a the last entry in the list of associated entities chained
2480 -- through the Next_Entity field. Empty if no entities are chained.
2482 -- Limited_View (Node23)
2483 -- Present in non-generic package entities that are not instances. Bona
2484 -- fide package with the limited-view list through the first_entity and
2485 -- first_private attributes. The elements of this list are the shadow
2486 -- entities created for the types and local packages that are declared
2487 -- in a package appearing in a limited_with clause (Ada 2005: AI-50217)
2489 -- Lit_Indexes (Node15)
2490 -- Present in enumeration types and subtypes. Non-empty only for the
2491 -- case of an enumeration root type, where it contains the entity for
2492 -- the generated indexes entity. See unit Exp_Imgv for full details of
2493 -- the nature and use of this entity for implkementing the Image and
2494 -- Value attributes for the enumeration type in question.
2496 -- Lit_Strings (Node16)
2497 -- Present in enumeration types and subtypes. Non-empty only for the
2498 -- case of an enumeration root type, where it contains the entity for
2499 -- the literals string entity. See unit Exp_Imgv for full details of
2500 -- the nature and use of this entity for implementing the Image and
2501 -- Value attributes for the enumeration type in question.
2503 -- Machine_Radix_10 (Flag84)
2504 -- Present in decimal types and subtypes, set if the Machine_Radix
2505 -- is 10, as the result of the specification of a machine radix
2506 -- representation clause. Note that it is possible for this flag
2507 -- to be set without having Has_Machine_Radix_Clause True. This
2508 -- happens when a type is derived from a type with a clause present.
2510 -- Master_Id (Node17)
2511 -- Present in access types and subtypes. Empty unless Has_Task is
2512 -- set for the designated type, in which case it points to the entity
2513 -- for the Master_Id for the access type master.
2515 -- Materialize_Entity (Flag168)
2516 -- Present in all entities. Set only for constant or renamed entities
2517 -- which should be materialized for debugging purposes. In the case of
2518 -- a constant, a memory location should be allocated containing the
2519 -- value. In the case of a renaming, a memory location containing the
2520 -- renamed address should be allocated.
2522 -- Mechanism (Uint8) (returned as Mechanism_Type)
2523 -- Present in functions and non-generic formal parameters. Indicates
2524 -- the mechanism to be used for the function return or for the formal
2525 -- parameter. See separate section on passing mechanisms. This field
2526 -- is also set (to the default value of zero) in a subprogram body
2527 -- entity but not used in this context.
2529 -- Modulus (Uint17) [base type only]
2530 -- Present in modular types. Contains the modulus. For the binary
2531 -- case, this will be a power of 2, but if Non_Binary_Modulus is
2532 -- set, then it will not be a power of 2.
2534 -- Must_Be_On_Byte_Boundary (Flag183)
2535 -- Present in entities for types and subtypes. Set if objects of
2536 -- the type must always be allocated on a byte boundary (more
2537 -- accurately a storage unit boundary). The front end checks that
2538 -- component clauses respect this rule, and the back end ensures
2539 -- that record packing does not violate this rule. Currently the
2540 -- flag is set only for packed arrays longer than 64 bits where
2541 -- the component size is not a power of 2.
2543 -- Needs_Debug_Info (Flag147)
2544 -- Present in all entities. Set if the entity requires debugging
2545 -- information to be generated. This is true of all entities that
2546 -- have Comes_From_Source set, and also transitively for entities
2547 -- associated with such components (e.g. their types). It is true
2548 -- for all entities in Debug_Generated_Code mode (-gnatD switch).
2549 -- This is the flag that the back end should check to determine
2550 -- whether or not to generate debugging information for an entity.
2552 -- Needs_No_Actuals (Flag22)
2553 -- Present in callable entities (subprograms, entries, access to
2554 -- subprograms) which can be called without actuals because all of
2555 -- their formals (if any) have default values. This flag simplifies the
2556 -- resolution of the syntactic ambiguity involving a call to these
2557 -- entities when the return type is an array type, and a call can be
2558 -- interpreted as an indexing of the result of the call. It is also
2559 -- used to resolve various cases of entry calls.
2561 -- Never_Set_In_Source (Flag115)
2562 -- Present in all entities, but relevant only for variables and
2563 -- parameters. This flag is set if the object is never assigned
2564 -- a value in user source code, either by assignment or by the
2565 -- use of an initial value, or by some other means.
2567 -- This flag is only for the purposes of issuing warnings, it must not
2568 -- be used by the code generator to indicate that the variable is in
2569 -- fact a constant, since some assignments in generated code do not
2570 -- count (for example, the call to an init proc to assign some but
2571 -- not all of the fields in a partially initialized record). The code
2572 -- generator should instead use the flag Is_True_Constant.
2574 -- For the purposes of this warning, the default assignment of
2575 -- access variables to null is not considered the assignment of
2576 -- of a value (so the warning can be given for code that relies
2577 -- on this initial null value, when no other value is ever set).
2579 -- In variables and out parameters, if this flag is set after full
2580 -- processing of the corresponding declarative unit, it indicates that
2581 -- the variable or parameter was never set, and a warning message can
2582 -- be issued.
2584 -- Note: this flag is initially set, and then cleared on encountering
2585 -- any construct that might conceivably legitimately set the value.
2586 -- Thus during the analysis of a declarative region and its associated
2587 -- statement sequence, the meaning of the flag is "not set yet", and
2588 -- once this analysis is complete the flag means "never assigned".
2590 -- Note: for variables appearing in package declarations, this flag
2591 -- is never set. That is because there is no way to tell if some
2592 -- client modifies the variable (or in the case of variables in the
2593 -- private part, if some child unit modifies the variables).
2595 -- Note: in the case of renamed objects, the flag must be set in the
2596 -- ultimate renamed object. Clients noting a possible modification
2597 -- should use the Note_Possible_Modification procedure in Sem_Util
2598 -- rather than Set_Never_Set_In_Source precisely to deal properly with
2599 -- the renaming possibility.
2601 -- Next_Component (synthesized)
2602 -- Applies to record components. Returns the next component by
2603 -- following the chain of declared entities until one is found which
2604 -- corresponds to a component (Ekind is E_Component). Any internal types
2605 -- generated from the subtype indications of the record components are
2606 -- skipped. Returns Empty if no more components.
2608 -- Next_Discriminant (synthesized)
2609 -- Applies to discriminants returned by First/Next_Discriminant.
2610 -- Returns the next language-defined (ie: perhaps non-girder)
2611 -- discriminant by following the chain of declared entities as long as
2612 -- the kind of the entity corresponds to a discriminant. Note that the
2613 -- discriminants might be the only components of the record.
2614 -- Returns Empty if there are no more.
2616 -- Next_Entity (Node2)
2617 -- Present in all entities. The entities of a scope are chained, with
2618 -- the head of the list being in the First_Entity field of the scope
2619 -- entity. All entities use the Next_Entity field as a forward pointer
2620 -- for this list, with Empty indicating the end of the list. Since this
2621 -- field is in the base part of the entity, the access routines for this
2622 -- field are in Sinfo.
2624 -- Next_Formal (synthesized)
2625 -- Applies to the entity for a formal parameter. Returns the next
2626 -- formal parameter of the subprogram or subprogram type. Returns
2627 -- Empty if there are no more formals.
2629 -- Next_Formal_With_Extras (synthesized)
2630 -- Applies to the entity for a formal parameter. Returns the next
2631 -- formal parameter of the subprogram or subprogram type. Returns
2632 -- Empty if there are no more formals. The list returned includes
2633 -- all the extra formals (see description of Extra_Formal field)
2635 -- Next_Girder_Discriminant (synthesized)
2636 -- Applies to discriminants. Set only for a discriminant returned by
2637 -- a call to First/Next_Girder_Discriminant. Returns next girder
2638 -- discriminant, if there are more (see complete description in
2639 -- First_Girder_Discriminant), or Empty if there are no more.
2641 -- Next_Index (synthesized)
2642 -- Applies to array types and subtypes and to string types and
2643 -- subtypes. Yields the next index. The first index is obtained by
2644 -- using the First_Index attribute, and then subsequent indexes are
2645 -- obtained by applying Next_Index to the previous index. Empty is
2646 -- returned to indicate that there are no more indexes. Note that
2647 -- unlike most attributes in this package, Next_Index applies to
2648 -- nodes for the indexes, not to entities.
2650 -- Next_Inlined_Subprogram (Node12)
2651 -- Present in subprograms. Used to chain inlined subprograms used in
2652 -- the current compilation, in the order in which they must be compiled
2653 -- by Gigi to insure that all inlinings are performed.
2655 -- Next_Literal (synthesized)
2656 -- Applies to enumeration literals, returns the next literal, or
2657 -- Empty if applied to the last literal. This is actually a synonym
2658 -- for Next, but its use is preferred in this context.
2660 -- Non_Binary_Modulus (Flag58) [base type only]
2661 -- Present in modular integer types. Set if the modulus for the type
2662 -- is other than a power of 2.
2664 -- Non_Limited_View (Node17)
2665 -- Present in incomplete types that are the shadow entities created
2666 -- when analyzing a limited_with_clause (Ada 2005: AI-50217). Points to
2667 -- the defining entity in the original declaration.
2669 -- Nonzero_Is_True (Flag162) [base type only]
2670 -- Present in enumeration types. True if any non-zero value is to be
2671 -- interpreted as true. Currently this is set true for derived Boolean
2672 -- types which have a convention of C, C++ or Fortran.
2674 -- No_Pool_Assigned (Flag131) [root type only]
2675 -- Present in access types. Set if a storage size clause applies to
2676 -- the variable with a compile time known value of zero. This flag is
2677 -- used to generate warnings if any attempt is made to allocate or free
2678 -- an instance of such an access type. This is set only in the root
2679 -- type, since derived types must have the same pool.
2681 -- No_Return (Flag113)
2682 -- Present in procedure and generic procedure entries. Indicates that
2683 -- a pragma No_Return applies to the procedure.
2685 -- Normalized_First_Bit (Uint8)
2686 -- Present in components and discriminants. Indicates the normalized
2687 -- value of First_Bit for the component, i.e. the offset within the
2688 -- lowest addressed storage unit containing part or all of the field.
2689 -- Set to No_Uint if no first bit position is assigned yet.
2691 -- Normalized_Position (Uint14)
2692 -- Present in components and discriminants. Indicates the normalized
2693 -- value of Position for the component, i.e. the offset in storage
2694 -- units from the start of the record to the lowest addressed storage
2695 -- unit containing part or all of the field.
2697 -- Normalized_Position_Max (Uint10)
2698 -- Present in components and discriminants. For almost all cases, this
2699 -- is the same as Normalized_Position. The one exception is for the case
2700 -- of a discriminated record containing one or more arrays whose length
2701 -- depends on discriminants. In this case, the Normalized_Position_Max
2702 -- field represents the maximum possible value of Normalized_Position
2703 -- assuming min/max values for discriminant subscripts in all fields.
2704 -- This is used by Layout in front end layout mode to properly computed
2705 -- the maximum size such records (needed for allocation purposes when
2706 -- there are default discriminants, and also for the 'Size value).
2708 -- No_Strict_Aliasing (Flag136) [base type only]
2709 -- Present in access types. Set to direct the back end to avoid any
2710 -- optimizations based on an assumption about the aliasing status of
2711 -- objects designated by the access type. For the case of the gcc
2712 -- back end, the effect is as though all references to objects of
2713 -- the type were compiled with -fno-strict-aliasing. This flag is
2714 -- set if an unchecked conversion with the access type as a target
2715 -- type occurs in the same source unit as the declaration of the
2716 -- access type, or if an explicit pragma No_Strict_Aliasing applies.
2718 -- Number_Dimensions (synthesized)
2719 -- Applies to array types and subtypes. Returns the number of dimensions
2720 -- of the array type or subtype as a value of type Pos.
2722 -- Number_Discriminants (synthesized)
2723 -- Applies to all types with discriminants. Yields the number of
2724 -- discriminants as a value of type Pos.
2726 -- Number_Entries (synthesized)
2727 -- Applies to concurrent types. Returns the number of entries that are
2728 -- declared within the task or protected definition for the type.
2730 -- Number_Formals (synthesized)
2731 -- Applies to subprograms and subprogram types. Yields the number of
2732 -- formals as a value of type Pos.
2734 -- Obsolescent_Warning (Node24)
2735 -- Present in subprogram entities. Set non-empty only if the pragma
2736 -- Obsolescent had a string argument, in which case it records the
2737 -- contents of the corresponding string literal node.
2739 -- Original_Access_Type (Node21)
2740 -- Present in access to subprogram types. Anonymous access to protected
2741 -- subprogram types are replaced by an occurrence of an internal access
2742 -- to subprogram type. This field links the replacement entity with the
2743 -- original entity.
2745 -- Original_Array_Type (Node21)
2746 -- Present in modular types and array types and subtypes. Set only
2747 -- if the Is_Packed_Array_Type flag is set, indicating that the type
2748 -- is the implementation type for a packed array, and in this case it
2749 -- points to the original array type for which this is the packed
2750 -- array implementation type.
2752 -- Object_Ref (Node17)
2753 -- Present in protected bodies. This is an implicit prival for the
2754 -- Protection object associated with a protected object. See Prival
2755 -- for further details on the use of privals.
2757 -- Original_Record_Component (Node22)
2758 -- Present in components, including discriminants. The usage depends
2759 -- on whether the record is a base type and whether it is tagged.
2761 -- In base tagged types:
2762 -- When the component is inherited in a record extension, it points
2763 -- to the original component (the entity of the ancestor component
2764 -- which is not itself inherited) otherwise it points to itself.
2765 -- Gigi uses this attribute to implement the automatic dereference in
2766 -- the extension and to apply the transformation:
2768 -- Rec_Ext.Comp -> Rec_Ext.Parent. ... .Parent.Comp
2770 -- In base non-tagged types:
2771 -- Always points to itself except for non-girder discriminants, where
2772 -- it points to the girder discriminant it renames.
2774 -- In subtypes (tagged and untagged):
2775 -- Points to the component in the base type.
2777 -- Overridden_Operation (Node26)
2778 -- Present in subprograms. For overriding operations, points to the
2779 -- user-defined parent subprogram that is being overridden.
2781 -- Packed_Array_Type (Node23)
2782 -- Present in array types and subtypes, including the string literal
2783 -- subtype case, if the corresponding type is packed (either bit packed
2784 -- or packed to eliminate holes in non-contiguous enumeration type
2785 -- index types). References the type used to represent the packed array,
2786 -- which is either a modular type for short static arrays, or an
2787 -- array of System.Unsigned. Note that in some situations (internal
2788 -- types, and references to fields of variant records), it is not
2789 -- always possible to construct this type in advance of its use. If
2790 -- Packed_Array_Type is empty, then the necessary type is declared
2791 -- on the fly for each reference to the array.
2793 -- Parameter_Mode (synthesized)
2794 -- Applies to formal parameter entities. This is a synonym for Ekind,
2795 -- used when obtaining the formal kind of a formal parameter (the result
2796 -- is one of E_[In/Out/In_Out]_Paramter)
2798 -- Parent_Subtype (Node19)
2799 -- Present in E_Record_Type. Points to the subtype to use for a
2800 -- field that references the parent record.
2802 -- Primitive_Operations (Elist15)
2803 -- Present in tagged record types and subtypes and in tagged private
2804 -- types. Points to an element list of entities for primitive operations
2805 -- for the tagged type. Not present (and not set) in untagged types (it
2806 -- is an error to reference the primitive operations field of a type
2807 -- that is not tagged).
2809 -- Private_Dependents (Elist18)
2810 -- Present in private (sub)types. Records the subtypes of the
2811 -- private type, derivations from it, and records and arrays
2812 -- with components dependent on the type.
2814 -- The subtypes are traversed when installing and deinstalling
2815 -- (the full view of) a private type in order to ensure correct
2816 -- view of the subtypes.
2818 -- Used in similar fashion for incomplete types: holds list of subtypes
2819 -- of these incomplete types that have discriminant constraints. The
2820 -- full views of these subtypes are constructed when the full view of
2821 -- the incomplete type is processed.
2823 -- In addition, if the incomplete type is the designated type in an
2824 -- access definition for an access parameter, the operation may be
2825 -- a dispatching primitive operation, which is only known when the full
2826 -- declaration of the type is seen. Subprograms that have such an
2827 -- access parameter are also placed in the list of private_dependents.
2829 -- Prival (Node17)
2830 -- Present in components. Used for representing private declarations
2831 -- of protected objects (private formal: by analogy to Discriminal_Link).
2832 -- Empty unless the synthesized Is_Protected_Private attribute is
2833 -- true. The entity used as a formal parameter that corresponds to
2834 -- the to the private declaration in protected operations. See
2835 -- "Private data in protected objects" for details.
2837 -- Privals_Chain (Elist23)
2838 -- Present in protected operations (subprograms and entries). Links
2839 -- all occurrences of the Privals in the body of the operation, in
2840 -- order to patch their types at the end of their expansion. See
2841 -- "Private data in protected objects" for details.
2843 -- Private_View (Node22)
2844 -- For each private type, three entities are allocated, the private view,
2845 -- the full view, and the shadow entity. The shadow entity contains a
2846 -- copy of the private view and is used for restoring the proper private
2847 -- view after a region in which the full view is visible (and is copied
2848 -- into the entity normally used for the private view during this period
2849 -- of visibility). The Private_View field is self-referential when the
2850 -- private view lives in its normal entity, but in the copy that is made
2851 -- in the shadow entity, it points to the proper location in which to
2852 -- restore the private view saved in the shadow.
2854 -- Protected_Formal (Node22)
2855 -- Present in formal parameters (in, in out and out parameters). Used
2856 -- only for formals of protected operations. References corresponding
2857 -- formal parameter in the unprotected version of the operation that
2858 -- is created during expansion.
2860 -- Protected_Body_Subprogram (Node11)
2861 -- Present in protected operations. References the entity for the
2862 -- subprogram which implements the body of the operation.
2864 -- Protected_Operation (Node23)
2865 -- Present in components. Used for representing private declarations
2866 -- of protected objects. Empty unless the synthesized attribute
2867 -- Is_Protected_Private is True. This is the entity corresponding
2868 -- to the body of the protected operation currently being analyzed,
2869 -- and which will eventually use the current Prival associated with
2870 -- this component to refer to the renaming of a private object
2871 -- component. As soon as the expander generates this renaming, this
2872 -- attribute is changed to refer to the next protected subprogram.
2873 -- See "Private data in protected objects" for details.
2875 -- Reachable (Flag49)
2876 -- Present in labels. The flag is set over the range of statements in
2877 -- which a goto to that label is legal.
2879 -- Referenced (Flag156)
2880 -- Present in all entities, set if the entity is referenced, except
2881 -- for the case of an appearence of a simple variable that is not a
2882 -- renaming, as the left side of an assignment in which case the flag
2883 -- Referenced_As_LHS is set instead.
2885 -- Referenced_As_LHS (Flag36): This flag is set instead of
2886 -- Referenced if a simple variable that is not a renaming appears as
2887 -- the left side of an assignment. The reason we distinguish this kind
2888 -- of reference is that we have a separate warning for variables that
2889 -- are only assigned and never read.
2891 -- Referenced_Object (Node10)
2892 -- Present in all type entities. Set non-Empty only for type entities
2893 -- constructed for unconstrained objects, or objects that depend on
2894 -- discriminants. Points to the expression from which the actual
2895 -- subtype of the object can be evaluated.
2897 -- Register_Exception_Call (Node20)
2898 -- Present in exception entities. When an exception is declared,
2899 -- a call is expanded to Register_Exception. This field points to
2900 -- the expanded N_Procedure_Call_Statement node for this call. It
2901 -- is used for Import/Export_Exception processing to modify the
2902 -- register call to make appropriate entries in the special tables
2903 -- used for handling these pragmas at runtime.
2905 -- Related_Array_Object (Node19)
2906 -- Present in array types and subtypes. Used only for the base type
2907 -- and subtype created for an anonymous array object. Set to point
2908 -- to the entity of the corresponding array object. Currently used
2909 -- only for type-related error messages.
2911 -- Related_Instance (Node15)
2912 -- Present in the wrapper packages created for subprogram instances.
2913 -- The internal subprogram that implements the instance is inside the
2914 -- wrapper package, but for debugging purposes its external symbol
2915 -- must correspond to the name and scope of the related instance.
2917 -- Renamed_Entity (Node18)
2918 -- Present in exceptions, packages and generic units that are defined
2919 -- by a renaming declaration. Denotes the renamed entity, or transit-
2920 -- itively the ultimate renamed entity if there is a chain of renaming
2921 -- declarations.
2923 -- Renamed_Object (Node18)
2924 -- Present in all objects (constants, variables, components, formal
2925 -- parameters, generic formal parameters, and loop parameters). Set
2926 -- non-Empty if the object was declared by a renaming declaration, in
2927 -- which case it references the tree node for the name of the renamed
2928 -- object. This is only possible for the variable and constant cases.
2929 -- For formal parameters, this field is used in the course of inline
2930 -- expansion, to map the formals of a subprogram into the corresponding
2931 -- actuals. For formals of a task entry, it denotes the local renaming
2932 -- that replaces the actual within the accept statement.
2933 -- The field is Empty otherwise.
2935 -- Renaming_Map (Uint9)
2936 -- Present in generic subprograms, generic packages, and their
2937 -- instances. Also present in the instances of the corresponding
2938 -- bodies. Denotes the renaming map (generic entities => instance
2939 -- entities) used to construct the instance by givin an index into
2940 -- the tables used to represent these maps. See Sem_Ch12 for further
2941 -- details. The maps for package instances are also used when the
2942 -- instance is the actual corresponding to a formal package.
2944 -- Return_Present (Flag54)
2945 -- Present in function and generic function entities. Set if the
2946 -- function contains a return statement (used for error checking).
2947 -- This flag can also be set in procedure and generic procedure
2948 -- entities (for convenience in setting it), but is only tested
2949 -- for the function case.
2951 -- Returns_By_Ref (Flag90)
2952 -- Present in function entities, to indicate that the function
2953 -- returns the result by reference, either because its return typ is a
2954 -- by-reference-type or because it uses explicitly the secondary stack.
2956 -- Reverse_Bit_Order (Flag164) [base type only]
2957 -- Present in all record type entities. Set if a valid pragma an
2958 -- attribute represention clause for Bit_Order has reversed the order
2959 -- of bits from the default value. When this flag is set, a component
2960 -- clause must specify a set of bits entirely contained in a single
2961 -- storage unit.
2963 -- RM_Size (Uint13)
2964 -- Present in all type and subtype entities. Contains the value of
2965 -- type'Size as defined in the RM. See also the Esize field and
2966 -- and the description on "Handling of Type'Size Values". A value
2967 -- of zero in this field for a non-discrete type means that
2968 -- the front end has not yet determined the size value. For the
2969 -- case of a discrete type, this field is always set by the front
2970 -- end and zero is a legitimate value for a type with one value.
2972 -- Root_Type (synthesized)
2973 -- Applies to all type entities. For class-wide types, return the root
2974 -- type of the class covered by the CW type, otherwise returns the
2975 -- ultimate derivation ancestor of the given type. This function
2976 -- preserves the view, i.e. the Root_Type of a partial view is the
2977 -- partial view of the ulimate ancestor, the Root_Type of a full view
2978 -- is the full view of the ultimate ancestor. Note that this function
2979 -- does not correspond exactly to the use of root type in the RM, since
2980 -- in the RM root type applies to a class of types, not to a type.
2982 -- Scalar_Range (Node20)
2983 -- Present in all scalar types (including modular types, where the
2984 -- bounds are 0 .. modulus - 1). References a node in the tree that
2985 -- contains the bounds for the range. Note that this information
2986 -- could be obtained by rummaging around the tree, but it is more
2987 -- convenient to have it immediately at hand in the entity. The
2988 -- contents of Scalar_Range can either be an N_Subtype_Indication
2989 -- node (with a constraint), or a Range node, but not a simple
2990 -- subtype reference (a subtype is converted into a range).
2992 -- Scale_Value (Uint15)
2993 -- Present in decimal fixed-point types and subtypes. Contains the scale
2994 -- for the type (i.e. the value of type'Scale = the number of decimal
2995 -- digits after the decimal point).
2997 -- Scope (Node3)
2998 -- Present in all entities. Points to the entity for the scope (block,
2999 -- loop, subprogram, package etc.) in which the entity is declared.
3000 -- Since this field is in the base part of the entity node, the access
3001 -- routines for this field are in Sinfo.
3003 -- Scope_Depth (synth)
3004 -- Applies to program units, blocks, concurrent types and entries,
3005 -- and also to record types, i.e. to any entity that can appear on
3006 -- the scope stack. Yields the scope depth value, which for those
3007 -- entities other than records is simply the scope depth value,
3008 -- for record entities, it is the Scope_Depth of the record scope.
3010 -- Scope_Depth_Value (Uint22)
3011 -- Present in program units, blocks, concurrent types and entries.
3012 -- Indicates the number of scopes that statically enclose the
3013 -- declaration of the unit or type. Library units have a depth of zero.
3014 -- Note that record types can act as scopes but do NOT have this field
3015 -- set (see Scope_Depth above)
3017 -- Scope_Depth_Set (synthesized)
3018 -- Applies to a special predicate function that returns a Boolean value
3019 -- indicating whether or not the Scope_Depth field has been set. It
3020 -- is needed, since returns an invalid value in this case!
3022 -- Sec_Stack_Needed_For_Return (Flag167)
3023 -- Present in scope entities (blocks, functions, procedures, tasks,
3024 -- entries). Set to True when secondary stack is used to hold
3025 -- the returned value of a function and thus should not be
3026 -- released on scope exit.
3028 -- Shadow_Entities (List14)
3029 -- Present in package and generic package entities. Points to a list
3030 -- of entities that correspond to private types. For each private type
3031 -- a shadow entity is created that holds a copy of the private view.
3032 -- In regions of the program where the full views of these private
3033 -- entities are visible, the full view is copied into the entity that
3034 -- is normally used to hold the private view, but the shadow entity
3035 -- copy is unchanged. The shadow entities are then used to restore the
3036 -- original private views at the end of the region. This list is a
3037 -- standard format list (i.e. First (Shadow_Entities) is the first
3038 -- entry and subsequent entries are obtained using Next.
3040 -- Shared_Var_Assign_Proc (Node22)
3041 -- Present in variables. Set non-Empty only if Is_Shared_Passive is
3042 -- set, in which case this is the entity for the shared memory assign
3043 -- routine. See Exp_Smem for full details.
3045 -- Shared_Var_Read_Proc (Node15)
3046 -- Present in variables. Set non-Empty only if Is_Shared_Passive is
3047 -- set, in which case this is the entity for the shared memory read
3048 -- routine. See Exp_Smem for full details.
3050 -- Size_Check_Code (Node19)
3051 -- Present in constants and variables. Normally Empty. Set if code is
3052 -- generated to check the size of the object. This field is used to
3053 -- suppress this code if a subsequent address clause is encountered.
3055 -- Size_Clause (synthesized)
3056 -- Applies to all entities. If a size clause is present in the rep
3057 -- item chain for an entity then the attribute definition clause node
3058 -- for the size clause is returned. Otherwise Size_Clause returns Empty
3059 -- if no item is present. Usually this is only meaningful if the flag
3060 -- Has_Size_Clause is set. This is because when the representation item
3061 -- chain is copied for a derived type, it can inherit a size clause that
3062 -- is not applicable to the entity.
3064 -- Size_Depends_On_Discriminant (Flag177)
3065 -- Present in all entities for types and subtypes. Indicates that the
3066 -- size of the type depends on the value of one or more discriminants.
3067 -- Currently, this flag is only set in front end layout mode for arrays
3068 -- which have one or more bounds depending on a discriminant value.
3070 -- Size_Known_At_Compile_Time (Flag92)
3071 -- Present in all entities for types and subtypes. Indicates that the
3072 -- size of objects of the type is known at compile time. This flag is
3073 -- used to optimize some generated code sequences, and also to enable
3074 -- some error checks (e.g. disallowing component clauses on variable
3075 -- length objects. It is set conservatively (i.e. if it is True, the
3076 -- size is certainly known at compile time, if it is False, then the
3077 -- size may or may not be known at compile time, but the code will
3078 -- assume that it is not known).
3080 -- Small_Value (Ureal21)
3081 -- Present in fixed point types. Points to the universal real for the
3082 -- Small of the type, either as given in a representation clause, or
3083 -- as computed (as a power of two) by the compiler.
3085 -- Spec_Entity (Node19)
3086 -- Present in package body entities. Points to corresponding package
3087 -- spec entity. Also present in subprogram body parameters in the
3088 -- case where there is a separate spec, where this field references
3089 -- the corresponding parameter entities in the spec.
3091 -- Storage_Size_Variable (Node15) [implementation base type only]
3092 -- Present in access types and task type entities. This flag is set
3093 -- if a valid and effective pragma Storage_Size applies to the base
3094 -- type. Points to the entity for a variable that is created to
3095 -- hold the value given in a Storage_Size pragma for an access
3096 -- collection or a task type. Note that in the access type case,
3097 -- this field is present only in the root type (since derived types
3098 -- share the same storage pool).
3100 -- Stored_Constraint (Elist23)
3101 -- Present in entities that can have discriminants (concurrent types
3102 -- subtypes, record types and subtypes, private types and subtypes,
3103 -- limited private types and subtypes and incomplete types). Points
3104 -- to an element list containing the expressions for each of the
3105 -- stored discriminants for the record (sub)type.
3107 -- Strict_Alignment (Flag145) [implementation base type only]
3108 -- Present in all type entities. Indicates that some containing part
3109 -- is either aliased or tagged. This prohibits packing the object
3110 -- tighter than its natural size and alignment.
3112 -- String_Literal_Length (Uint16)
3113 -- Present in string literal subtypes (which are created to correspond
3114 -- to string literals in the program). Contains the length of the string
3115 -- literal.
3117 -- String_Literal_Low_Bound (Node15)
3118 -- Present in string literal subtypes (which are created to correspond
3119 -- to string literals in the program). Contains an expression whose
3120 -- value represents the low bound of the literal. This is a copy of
3121 -- the low bound of the applicable index constraint if there is one,
3122 -- or a copy of the low bound of the index base type if not.
3124 -- Suppress_Elaboration_Warnings (Flag148)
3125 -- Present in all entities, relevant only for subprogram entities. If
3126 -- this flag is set then Sem_Elab will not generate elaboration warnings
3127 -- for the subprogram. Suppression of such warnings is automatic for
3128 -- subprograms for which elaboration checks are suppressed (without the
3129 -- need to set this flag), but the flag is also set for various internal
3130 -- entities (such as init procs) which are known not to generate any
3131 -- possible access before elaboration. (we need a clear description of
3132 -- how this flag differs in effect from Elaboration_Checks_Suppressed???)
3134 -- Suppress_Init_Proc (Flag105) [base type only]
3135 -- Present in all type entities. Set to suppress the generation of
3136 -- initialization procedures where they are known to be not needed.
3137 -- For example, the enumeration image table entity uses this flag.
3139 -- Suppress_Style_Checks (Flag165)
3140 -- Present in all entities. Suppresses any style checks specifically
3141 -- associated with the given entity if set.
3143 -- Task_Body_Procedure (Node24)
3144 -- Present in task types and subtypes. Points to the entity for
3145 -- the task body procedure (as further described in Exp_Ch9, task
3146 -- bodies are expanded into procedures). A convenient function to
3147 -- retrieve this field is Sem_Util.Get_Task_Body_Procedure.
3149 -- First_Tag_Component (synthesized)
3150 -- Applies to tagged record types, returns the entity for the first
3151 -- _Tag field in this record.
3153 -- Next_Tag_Component (synthesized)
3154 -- Applies to components of tagged record types. Given a _Tag field
3155 -- of a record, returns the next _Tag field in this record.
3157 -- Treat_As_Volatile (Flag41)
3158 -- Present in all type entities, and also in constants, components and
3159 -- variables. Set if this entity is to be treated as volatile for code
3160 -- generation purposes. Always set if Is_Volatile is set, but can also
3161 -- be set as a result of situations (such as address overlays) where
3162 -- the front end wishes to force volatile handling to inhibit aliasing
3163 -- optimization which might be legally ok, but is undesirable. Note
3164 -- that the back end always tests this flag rather than Is_Volatile.
3165 -- The front end tests Is_Volatile if it is concerned with legality
3166 -- checks associated with declared volatile variables, but if the test
3167 -- is for the purposes of suppressing optimizations, then the front
3168 -- end should test Treat_As_Volatile rather than Is_Volatile.
3170 -- Type_High_Bound (synthesized)
3171 -- Applies to scalar types. Returns the tree node (Node_Id) that
3172 -- contains the high bound of a scalar type. The returned value is a
3173 -- literal for a base type, but may be an expression in the case of a
3174 -- scalar type with dynamic bounds. Note that in the case of a fixed
3175 -- point type, the high bound is in units of small, and is an integer.
3177 -- Type_Low_Bound (synthesized)
3178 -- Applies to scalar types. Returns the tree node (Node_Id) that
3179 -- contains the low bound of a scalar type. The returned value is a
3180 -- literal for a base type, but may be an expression in the case of a
3181 -- scalar type with dynamic bounds. Note that in the case of a fixed
3182 -- point type, the low bound is in units of small, and is an integer.
3184 -- Underlying_Full_View (Node19)
3185 -- Present in private subtypes that are the completion of other private
3186 -- types, or in private types that are derived from private subtypes.
3187 -- If the full view of a private type T is derived from another
3188 -- private type with discriminants Td, the full view of T is also
3189 -- private, and there is no way to attach to it a further full view that
3190 -- would convey the structure of T to the back end. The Underlying_Full_
3191 -- View is an attribute of the full view that is a subtype of Td with
3192 -- the same constraint as the declaration for T. The declaration for this
3193 -- subtype is built at the point of the declaration of T, either as a
3194 -- completion, or as a subtype declaration where the base type is private
3195 -- and has a private completion. If Td is already constrained, then its
3196 -- full view can serve directly as the full view of T.
3198 -- Underlying_Type (synthesized)
3199 -- Applies to all entities. This is the identity function except in
3200 -- the case where it is applied to an incomplete or private type,
3201 -- in which case it is the underlying type of the type declared by
3202 -- the completion, or Empty if the completion has not yet been
3203 -- encountered and analyzed.
3205 -- Note: the reason this attribute applies to all entities, and not
3206 -- just types, is to legitimize code where Underlying_Type is applied
3207 -- to an entity which may or may not be a type, with the intent that
3208 -- if it is a type, its underlying type is taken.
3210 -- Unset_Reference (Node16)
3211 -- Present in variables and out parameters. This is normally Empty.
3212 -- It is set to point to an identifier that represents a reference
3213 -- to the entity before any value has been set. Only the first such
3214 -- reference is identified. This field is used to generate a warning
3215 -- message if necessary (see Sem_Warn.Check_Unset_Reference).
3217 -- Uses_Sec_Stack (Flag95)
3218 -- Present in scope entities (blocks,functions, procedures, tasks,
3219 -- entries). Set to True when secondary stack is used in this scope and
3220 -- must be released on exit unless Sec_Stack_Needed_For_Return is set.
3222 -- Vax_Float (Flag151) [base type only]
3223 -- Present in all type entities. Set only on the base type of float
3224 -- types with Vax format. The particular format is determined by the
3225 -- Digits_Value value which is 6,9,15 for F_Float, D_Float, G_Float.
3227 -- Warnings_Off (Flag96)
3228 -- Present in all entities. Set if a pragma Warnings (Off, entity-name)
3229 -- is used to suppress warnings for a given entity. It is also used by
3230 -- the compiler in some situations to kill spurious warnings.
3232 -- Was_Hidden (Flag196)
3233 -- Present in all entities. Used to save the value of the Is_Hidden
3234 -- attribute when the limited-view is installed (Ada 2005: AI-217).
3236 -- Wrapped_Entity (Node27)
3237 -- Present in an E_Procedure classified as a Is_Primitive_Wrapper. Set
3238 -- to the entity that is being wrapped.
3240 ------------------
3241 -- Access Kinds --
3242 ------------------
3244 -- The following three entity kinds are introduced by the corresponding
3245 -- type definitions:
3247 -- E_Access_Type,
3248 -- E_General_Access_Type,
3249 -- E_Anonymous_Access_Subprogram_Type,
3250 -- E_Anonymous_Access_Protected_Subprogram_Type
3251 -- E_Anonymous_Access_Type.
3253 -- In addition, we define the kind E_Allocator_Type to label
3254 -- allocators. This is because special resolution rules apply to this
3255 -- construct. Eventually the constructs are labeled with the access
3256 -- type imposed by the context. Gigi should never see the type
3257 -- E_Allocator.
3259 -- Similarly, the type E_Access_Attribute_Type is used as the initial
3260 -- kind associated with an access attribute. After resolution a specific
3261 -- access type will be established as determined by the context.
3263 -- Finally, the type Any_Access is used to label -null- during type
3264 -- resolution. Any_Access is also replaced by the context type after
3265 -- resolution.
3267 --------------------------------
3268 -- Classification of Entities --
3269 --------------------------------
3271 -- The classification of program entities which follows is a refinement of
3272 -- the list given in RM 3.1(1). E.g., separate entities denote subtypes of
3273 -- different type classes. Ada 95 entities include class wide types,
3274 -- protected types, subprogram types, generalized access types, generic
3275 -- formal derived types and generic formal packages.
3277 -- The order chosen for these kinds allows us to classify related entities
3278 -- so that they are contiguous. As a result, they do not appear in the
3279 -- exact same order as their order of first appearance in the LRM (For
3280 -- example, private types are listed before packages). The contiguity
3281 -- allows us to define useful subtypes (see below) such as type entities,
3282 -- overloaded entities, etc.
3284 -- Each entity (explicitly or implicitly declared) has a kind, which is
3285 -- a value of the following type:
3287 type Entity_Kind is (
3289 E_Void,
3290 -- The initial Ekind value for a newly created entity. Also used as
3291 -- the Ekind for Standard_Void_Type, a type entity in Standard used
3292 -- as a dummy type for the return type of a procedure (the reason we
3293 -- create this type is to share the circuits for performing overload
3294 -- resolution on calls).
3296 -------------
3297 -- Objects --
3298 -------------
3300 E_Variable,
3301 -- Variables created by an object declaration with no constant keyword
3303 E_Component,
3304 -- Components of a record declaration, private declarations of
3305 -- protected objects.
3307 E_Constant,
3308 -- Constants created by an object declaration with a constant keyword
3310 E_Discriminant,
3311 -- A discriminant, created by the use of a discriminant in a type
3312 -- declaration.
3314 E_Loop_Parameter,
3315 -- A loop parameter created by a for loop
3317 ------------------------
3318 -- Parameter Entities --
3319 ------------------------
3321 -- Parameters are also objects
3323 E_In_Parameter,
3324 -- An in parameter of a subprogram or entry
3326 E_Out_Parameter,
3327 -- An out parameter of a subprogram or entry
3329 E_In_Out_Parameter,
3330 -- An in-out parameter of a subprogram or entry
3332 --------------------------------
3333 -- Generic Parameter Entities --
3334 --------------------------------
3336 -- Generic parameters are also objects
3338 E_Generic_In_Out_Parameter,
3339 -- A generic in out parameter, created by the use of a generic in out
3340 -- parameter in a generic declaration.
3342 E_Generic_In_Parameter,
3343 -- A generic in parameter, created by the use of a generic in
3344 -- parameter in a generic declaration.
3346 -------------------
3347 -- Named Numbers --
3348 -------------------
3350 E_Named_Integer,
3351 -- Named numbers created by a number declaration with an integer value
3353 E_Named_Real,
3354 -- Named numbers created by a number declaration with a real value
3356 -----------------------
3357 -- Enumeration Types --
3358 -----------------------
3360 E_Enumeration_Type,
3361 -- Enumeration types, created by an enumeration type declaration
3363 E_Enumeration_Subtype,
3364 -- Enumeration subtypes, created by an explicit or implicit subtype
3365 -- declaration applied to an enumeration type or subtype.
3367 -------------------
3368 -- Numeric Types --
3369 -------------------
3371 E_Signed_Integer_Type,
3372 -- Signed integer type, used for the anonymous base type of the
3373 -- integer subtype created by an integer type declaration.
3375 E_Signed_Integer_Subtype,
3376 -- Signed integer subtype, created by either an integer subtype or
3377 -- integer type declaration (in the latter case an integer type is
3378 -- created for the base type, and this is the first named subtype).
3380 E_Modular_Integer_Type,
3381 -- Modular integer type, used for the anonymous base type of the
3382 -- integer subtype created by a modular integer type declaration.
3384 E_Modular_Integer_Subtype,
3385 -- Modular integer subtype, created by either an modular subtype
3386 -- or modular type declaration (in the latter case a modular type
3387 -- is created for the base type, and this is the first named subtype).
3389 E_Ordinary_Fixed_Point_Type,
3390 -- Ordinary fixed type, used for the anonymous base type of the
3391 -- fixed subtype created by an ordinary fixed point type declaration.
3393 E_Ordinary_Fixed_Point_Subtype,
3394 -- Ordinary fixed point subtype, created by either an ordinary fixed
3395 -- point subtype or ordinary fixed point type declaration (in the
3396 -- latter case a fixed point type is created for the base type, and
3397 -- this is the first named subtype).
3399 E_Decimal_Fixed_Point_Type,
3400 -- Decimal fixed type, used for the anonymous base type of the decimal
3401 -- fixed subtype created by an ordinary fixed point type declaration.
3403 E_Decimal_Fixed_Point_Subtype,
3404 -- Decimal fixed point subtype, created by either a decimal fixed point
3405 -- subtype or decimal fixed point type declaration (in the latter case
3406 -- a fixed point type is created for the base type, and this is the
3407 -- first named subtype).
3409 E_Floating_Point_Type,
3410 -- Floating point type, used for the anonymous base type of the
3411 -- floating point subtype created by a floating point type declaration.
3413 E_Floating_Point_Subtype,
3414 -- Floating point subtype, created by either a floating point subtype
3415 -- or floating point type declaration (in the latter case a floating
3416 -- point type is created for the base type, and this is the first
3417 -- named subtype).
3419 ------------------
3420 -- Access Types --
3421 ------------------
3423 E_Access_Type,
3424 -- An access type created by an access type declaration with no all
3425 -- keyword present. Note that the predefined type Any_Access, which
3426 -- has E_Access_Type Ekind, is used to label NULL in the upwards pass
3427 -- of type analysis, to be replaced by the true access type in the
3428 -- downwards resolution pass.
3430 E_Access_Subtype,
3431 -- An access subtype created by a subtype declaration for any access
3432 -- type (whether or not it is a general access type).
3434 E_Access_Attribute_Type,
3435 -- An access type created for an access attribute (such as 'Access,
3436 -- 'Unrestricted_Access and Unchecked_Access)
3438 E_Allocator_Type,
3439 -- A special internal type used to label allocators and attribute
3440 -- references using 'Access. This is needed because special resolution
3441 -- rules apply to these constructs. On the resolution pass, this type
3442 -- is always replaced by the actual access type, so Gigi should never
3443 -- see types with this Ekind.
3445 E_General_Access_Type,
3446 -- An access type created by an access type declaration with the all
3447 -- keyword present.
3449 E_Access_Subprogram_Type,
3450 -- An access to subprogram type, created by an access to subprogram
3451 -- declaration.
3453 E_Access_Protected_Subprogram_Type,
3454 -- An access to a protected subprogram, created by the corresponding
3455 -- declaration. Values of such a type denote both a protected object
3456 -- and a protected operation within, and have different compile-time
3457 -- and run-time properties than other access to subprograms.
3459 E_Anonymous_Access_Subprogram_Type,
3460 -- An anonymous access to subprogram type, created by an access to
3461 -- subprogram declaration.
3463 E_Anonymous_Access_Protected_Subprogram_Type,
3464 -- An anonymous access to protected subprogram type, created by an
3465 -- access to subprogram declaration.
3467 E_Anonymous_Access_Type,
3468 -- An anonymous access type created by an access parameter or access
3469 -- discriminant.
3471 ---------------------
3472 -- Composite Types --
3473 ---------------------
3475 E_Array_Type,
3476 -- An array type created by an array type declaration. Includes all
3477 -- cases of arrays, except for string types.
3479 E_Array_Subtype,
3480 -- An array subtype, created by an explicit array subtype declaration,
3481 -- or the use of an anonymous array subtype.
3483 E_String_Type,
3484 -- A string type, i.e. an array type whose component type is a character
3485 -- type, and for which string literals can thus be written.
3487 E_String_Subtype,
3488 -- A string subtype, created by an explicit subtype declaration for a
3489 -- string type, or the use of an anonymous subtype of a string type,
3491 E_String_Literal_Subtype,
3492 -- A special string subtype, used only to describe the type of a string
3493 -- literal (will always be one dimensional, with literal bounds).
3495 E_Class_Wide_Type,
3496 -- A class wide type, created by any tagged type declaration (i.e. if
3497 -- a tagged type is declared, the corresponding class type is always
3498 -- created, using this Ekind value).
3500 E_Class_Wide_Subtype,
3501 -- A subtype of a class wide type, created by a subtype declaration
3502 -- used to declare a subtype of a class type.
3504 E_Record_Type,
3505 -- A record type, created by a record type declaration
3507 E_Record_Subtype,
3508 -- A record subtype, created by a record subtype declaration
3510 E_Record_Type_With_Private,
3511 -- Used for types defined by a private extension declaration, and
3512 -- for tagged private types. Includes the fields for both private
3513 -- types and for record types (with the sole exception of
3514 -- Corresponding_Concurrent_Type which is obviously not needed).
3515 -- This entity is considered to be both a record type and
3516 -- a private type.
3518 E_Record_Subtype_With_Private,
3519 -- A subtype of a type defined by a private extension declaration
3521 E_Private_Type,
3522 -- A private type, created by a private type declaration
3523 -- that has neither the keyword limited nor the keyword tagged.
3525 E_Private_Subtype,
3526 -- A subtype of a private type, created by a subtype declaration used
3527 -- to declare a subtype of a private type.
3529 E_Limited_Private_Type,
3530 -- A limited private type, created by a private type declaration that
3531 -- has the keyword limited, but not the keyword tagged.
3533 E_Limited_Private_Subtype,
3534 -- A subtype of a limited private type, created by a subtype declaration
3535 -- used to declare a subtype of a limited private type.
3537 E_Incomplete_Type,
3538 -- An incomplete type, created by an incomplete type declaration
3540 E_Task_Type,
3541 -- A task type, created by a task type declaration. An entity with this
3542 -- Ekind is also created to describe the anonymous type of a task that
3543 -- is created by a single task declaration.
3545 E_Task_Subtype,
3546 -- A subtype of a task type, created by a subtype declaration used to
3547 -- declare a subtype of a task type.
3549 E_Protected_Type,
3550 -- A protected type, created by a protected type declaration. An entity
3551 -- with this Ekind is also created to describe the anonymous type of
3552 -- a protected object created by a single protected declaration.
3554 E_Protected_Subtype,
3555 -- A subtype of a protected type, created by a subtype declaration used
3556 -- to declare a subtype of a protected type.
3558 -----------------
3559 -- Other Types --
3560 -----------------
3562 E_Exception_Type,
3563 -- The type of an exception created by an exception declaration
3565 E_Subprogram_Type,
3566 -- This is the designated type of an Access_To_Subprogram. Has type
3567 -- and signature like a subprogram entity, so can appear in calls,
3568 -- which are resolved like regular calls, except that such an entity
3569 -- is not overloadable.
3571 ---------------------------
3572 -- Overloadable Entities --
3573 ---------------------------
3575 E_Enumeration_Literal,
3576 -- An enumeration literal, created by the use of the literal in an
3577 -- enumeration type definition.
3579 E_Function,
3580 -- A function, created by a function declaration or a function body
3581 -- that acts as its own declaration.
3583 E_Operator,
3584 -- A predefined operator, appearing in Standard, or an implicitly
3585 -- defined concatenation operator created whenever an array is
3586 -- declared. We do not make normal derived operators explicit in
3587 -- the tree, but the concatenation operators are made explicit.
3589 E_Procedure,
3590 -- A procedure, created by a procedure declaration or a procedure
3591 -- body that acts as its own declaration.
3593 E_Entry,
3594 -- An entry, created by an entry declaration in a task or protected
3595 -- object.
3597 --------------------
3598 -- Other Entities --
3599 --------------------
3601 E_Entry_Family,
3602 -- An entry family, created by an entry family declaration in a
3603 -- task or protected type definition.
3605 E_Block,
3606 -- A block identifier, created by an explicit or implicit label on
3607 -- a block or declare statement.
3609 E_Entry_Index_Parameter,
3610 -- An entry index parameter created by an entry index specification
3611 -- for the body of a protected entry family.
3613 E_Exception,
3614 -- An exception created by an exception declaration. The exception
3615 -- itself uses E_Exception for the Ekind, the implicit type that is
3616 -- created to represent its type uses the Ekind E_Exception_Type.
3618 E_Generic_Function,
3619 -- A generic function. This is the entity for a generic function
3620 -- created by a generic subprogram declaration.
3622 E_Generic_Procedure,
3623 -- A generic function. This is the entity for a generic procedure
3624 -- created by a generic subprogram declaration.
3626 E_Generic_Package,
3627 -- A generic package, this is the entity for a generic package created
3628 -- by a generic package declaration.
3630 E_Label,
3631 -- The defining entity for a label. Note that this is created by the
3632 -- implicit label declaration, not the occurrence of the label itself,
3633 -- which is simply a direct name referring to the label.
3635 E_Loop,
3636 -- A loop identifier, created by an explicit or implicit label on a
3637 -- loop statement.
3639 E_Package,
3640 -- A package, created by a package declaration
3642 E_Package_Body,
3643 -- A package body. This entity serves only limited functions, since
3644 -- most semantic analysis uses the package entity (E_Package). However
3645 -- there are some attributes that are significant for the body entity.
3646 -- For example, collection of exception handlers.
3648 E_Protected_Object,
3649 -- A protected object, created by an object declaration that declares
3650 -- an object of a protected type.
3652 E_Protected_Body,
3653 -- A protected body. This entity serves almost no function, since all
3654 -- semantic analysis uses the protected entity (E_Protected_Type)
3656 E_Task_Body,
3657 -- A task body. This entity serves almost no function, since all
3658 -- semantic analysis uses the protected entity (E_Task_Type).
3660 E_Subprogram_Body
3661 -- A subprogram body. Used when a subprogram has a separate declaration
3662 -- to represent the entity for the body. This entity serves almost no
3663 -- function, since all semantic analysis uses the subprogram entity
3664 -- for the declaration (E_Function or E_Procedure).
3667 for Entity_Kind'Size use 8;
3668 -- The data structures in Atree assume this!
3670 --------------------------
3671 -- Subtype Declarations --
3672 --------------------------
3674 -- The above entities are arranged so that they can be conveniently
3675 -- grouped into subtype ranges. Note that for each of the xxx_Kind
3676 -- ranges defined below, there is a corresponding Is_xxx.. predicate
3677 -- which is to be used in preference to direct range tests using the
3678 -- subtype name. However, the subtype names are available for direct
3679 -- use, e.g. as choices in case statements.
3681 subtype Access_Kind is Entity_Kind range
3682 E_Access_Type ..
3683 -- E_Access_Subtype
3684 -- E_Access_Attribute_Type
3685 -- E_Allocator_Type
3686 -- E_General_Access_Type
3687 -- E_Access_Subprogram_Type
3688 -- E_Access_Protected_Subprogram_Type
3689 -- E_Anonymous_Access_Subprogram_Type
3690 -- E_Anonymous_Access_Protected_Subprogram_Type
3691 E_Anonymous_Access_Type;
3693 subtype Array_Kind is Entity_Kind range
3694 E_Array_Type ..
3695 -- E_Array_Subtype
3696 -- E_String_Type
3697 -- E_String_Subtype
3698 E_String_Literal_Subtype;
3700 subtype Class_Wide_Kind is Entity_Kind range
3701 E_Class_Wide_Type ..
3702 E_Class_Wide_Subtype;
3704 subtype Composite_Kind is Entity_Kind range
3705 E_Array_Type ..
3706 -- E_Array_Subtype
3707 -- E_String_Type
3708 -- E_String_Subtype
3709 -- E_String_Literal_Subtype
3710 -- E_Class_Wide_Type
3711 -- E_Class_Wide_Subtype
3712 -- E_Record_Type
3713 -- E_Record_Subtype
3714 -- E_Record_Type_With_Private
3715 -- E_Record_Subtype_With_Private
3716 -- E_Private_Type
3717 -- E_Private_Subtype
3718 -- E_Limited_Private_Type
3719 -- E_Limited_Private_Subtype
3720 -- E_Incomplete_Type
3721 -- E_Task_Type
3722 -- E_Task_Subtype,
3723 -- E_Protected_Type,
3724 E_Protected_Subtype;
3726 subtype Concurrent_Kind is Entity_Kind range
3727 E_Task_Type ..
3728 -- E_Task_Subtype,
3729 -- E_Protected_Type,
3730 E_Protected_Subtype;
3732 subtype Concurrent_Body_Kind is Entity_Kind range
3733 E_Protected_Body ..
3734 E_Task_Body;
3736 subtype Decimal_Fixed_Point_Kind is Entity_Kind range
3737 E_Decimal_Fixed_Point_Type ..
3738 E_Decimal_Fixed_Point_Subtype;
3740 subtype Digits_Kind is Entity_Kind range
3741 E_Decimal_Fixed_Point_Type ..
3742 -- E_Decimal_Fixed_Point_Subtype
3743 -- E_Floating_Point_Type
3744 E_Floating_Point_Subtype;
3746 subtype Discrete_Kind is Entity_Kind range
3747 E_Enumeration_Type ..
3748 -- E_Enumeration_Subtype
3749 -- E_Signed_Integer_Type
3750 -- E_Signed_Integer_Subtype
3751 -- E_Modular_Integer_Type
3752 E_Modular_Integer_Subtype;
3754 subtype Discrete_Or_Fixed_Point_Kind is Entity_Kind range
3755 E_Enumeration_Type ..
3756 -- E_Enumeration_Subtype
3757 -- E_Signed_Integer_Type
3758 -- E_Signed_Integer_Subtype
3759 -- E_Modular_Integer_Type
3760 -- E_Modular_Integer_Subtype
3761 -- E_Ordinary_Fixed_Point_Type
3762 -- E_Ordinary_Fixed_Point_Subtype
3763 -- E_Decimal_Fixed_Point_Type
3764 E_Decimal_Fixed_Point_Subtype;
3766 subtype Elementary_Kind is Entity_Kind range
3767 E_Enumeration_Type ..
3768 -- E_Enumeration_Subtype
3769 -- E_Signed_Integer_Type
3770 -- E_Signed_Integer_Subtype
3771 -- E_Modular_Integer_Type
3772 -- E_Modular_Integer_Subtype
3773 -- E_Ordinary_Fixed_Point_Type
3774 -- E_Ordinary_Fixed_Point_Subtype
3775 -- E_Decimal_Fixed_Point_Type
3776 -- E_Decimal_Fixed_Point_Subtype
3777 -- E_Floating_Point_Type
3778 -- E_Floating_Point_Subtype
3779 -- E_Access_Type
3780 -- E_Access_Subtype
3781 -- E_Access_Attribute_Type
3782 -- E_Allocator_Type
3783 -- E_General_Access_Type
3784 -- E_Access_Subprogram_Type
3785 -- E_Access_Protected_Subprogram_Type
3786 -- E_Anonymous_Access_Subprogram_Type
3787 -- E_Anonymous_Access_Protected_Subprogram_Type
3788 E_Anonymous_Access_Type;
3790 subtype Enumeration_Kind is Entity_Kind range
3791 E_Enumeration_Type ..
3792 E_Enumeration_Subtype;
3794 subtype Entry_Kind is Entity_Kind range
3795 E_Entry ..
3796 E_Entry_Family;
3798 subtype Fixed_Point_Kind is Entity_Kind range
3799 E_Ordinary_Fixed_Point_Type ..
3800 -- E_Ordinary_Fixed_Point_Subtype
3801 -- E_Decimal_Fixed_Point_Type
3802 E_Decimal_Fixed_Point_Subtype;
3804 subtype Float_Kind is Entity_Kind range
3805 E_Floating_Point_Type ..
3806 E_Floating_Point_Subtype;
3808 subtype Formal_Kind is Entity_Kind range
3809 E_In_Parameter ..
3810 -- E_Out_Parameter
3811 E_In_Out_Parameter;
3813 subtype Generic_Subprogram_Kind is Entity_Kind range
3814 E_Generic_Function ..
3815 E_Generic_Procedure;
3817 subtype Generic_Unit_Kind is Entity_Kind range
3818 E_Generic_Function ..
3819 -- E_Generic_Procedure
3820 E_Generic_Package;
3822 subtype Incomplete_Or_Private_Kind is Entity_Kind range
3823 E_Record_Type_With_Private ..
3824 -- E_Record_Subtype_With_Private
3825 -- E_Private_Type
3826 -- E_Private_Subtype
3827 -- E_Limited_Private_Type
3828 -- E_Limited_Private_Subtype
3829 E_Incomplete_Type;
3831 subtype Integer_Kind is Entity_Kind range
3832 E_Signed_Integer_Type ..
3833 -- E_Signed_Integer_Subtype
3834 -- E_Modular_Integer_Type
3835 E_Modular_Integer_Subtype;
3837 subtype Modular_Integer_Kind is Entity_Kind range
3838 E_Modular_Integer_Type ..
3839 E_Modular_Integer_Subtype;
3841 subtype Named_Kind is Entity_Kind range
3842 E_Named_Integer ..
3843 E_Named_Real;
3845 subtype Numeric_Kind is Entity_Kind range
3846 E_Signed_Integer_Type ..
3847 -- E_Signed_Integer_Subtype
3848 -- E_Modular_Integer_Type
3849 -- E_Modular_Integer_Subtype
3850 -- E_Ordinary_Fixed_Point_Type
3851 -- E_Ordinary_Fixed_Point_Subtype
3852 -- E_Decimal_Fixed_Point_Type
3853 -- E_Decimal_Fixed_Point_Subtype
3854 -- E_Floating_Point_Type
3855 E_Floating_Point_Subtype;
3857 subtype Object_Kind is Entity_Kind range
3858 E_Variable ..
3859 -- E_Component
3860 -- E_Constant
3861 -- E_Discriminant
3862 -- E_Loop_Parameter
3863 -- E_In_Parameter
3864 -- E_Out_Parameter
3865 -- E_In_Out_Parameter
3866 -- E_Generic_In_Out_Parameter
3867 E_Generic_In_Parameter;
3869 subtype Ordinary_Fixed_Point_Kind is Entity_Kind range
3870 E_Ordinary_Fixed_Point_Type ..
3871 E_Ordinary_Fixed_Point_Subtype;
3873 subtype Overloadable_Kind is Entity_Kind range
3874 E_Enumeration_Literal ..
3875 -- E_Function
3876 -- E_Operator
3877 -- E_Procedure
3878 E_Entry;
3880 subtype Private_Kind is Entity_Kind range
3881 E_Record_Type_With_Private ..
3882 -- E_Record_Subtype_With_Private
3883 -- E_Private_Type
3884 -- E_Private_Subtype
3885 -- E_Limited_Private_Type
3886 E_Limited_Private_Subtype;
3888 subtype Protected_Kind is Entity_Kind range
3889 E_Protected_Type ..
3890 E_Protected_Subtype;
3892 subtype Real_Kind is Entity_Kind range
3893 E_Ordinary_Fixed_Point_Type ..
3894 -- E_Ordinary_Fixed_Point_Subtype
3895 -- E_Decimal_Fixed_Point_Type
3896 -- E_Decimal_Fixed_Point_Subtype
3897 -- E_Floating_Point_Type
3898 E_Floating_Point_Subtype;
3900 subtype Record_Kind is Entity_Kind range
3901 E_Class_Wide_Type ..
3902 -- E_Class_Wide_Subtype
3903 -- E_Record_Type
3904 -- E_Record_Subtype
3905 -- E_Record_Type_With_Private
3906 E_Record_Subtype_With_Private;
3908 subtype Scalar_Kind is Entity_Kind range
3909 E_Enumeration_Type ..
3910 -- E_Enumeration_Subtype
3911 -- E_Signed_Integer_Type
3912 -- E_Signed_Integer_Subtype
3913 -- E_Modular_Integer_Type
3914 -- E_Modular_Integer_Subtype
3915 -- E_Ordinary_Fixed_Point_Type
3916 -- E_Ordinary_Fixed_Point_Subtype
3917 -- E_Decimal_Fixed_Point_Type
3918 -- E_Decimal_Fixed_Point_Subtype
3919 -- E_Floating_Point_Type
3920 E_Floating_Point_Subtype;
3922 subtype String_Kind is Entity_Kind range
3923 E_String_Type ..
3924 -- E_String_Subtype
3925 E_String_Literal_Subtype;
3927 subtype Subprogram_Kind is Entity_Kind range
3928 E_Function ..
3929 -- E_Operator
3930 E_Procedure;
3932 subtype Signed_Integer_Kind is Entity_Kind range
3933 E_Signed_Integer_Type ..
3934 E_Signed_Integer_Subtype;
3936 subtype Task_Kind is Entity_Kind range
3937 E_Task_Type ..
3938 E_Task_Subtype;
3940 subtype Type_Kind is Entity_Kind range
3941 E_Enumeration_Type ..
3942 -- E_Enumeration_Subtype
3943 -- E_Signed_Integer_Type
3944 -- E_Signed_Integer_Subtype
3945 -- E_Modular_Integer_Type
3946 -- E_Modular_Integer_Subtype
3947 -- E_Ordinary_Fixed_Point_Type
3948 -- E_Ordinary_Fixed_Point_Subtype
3949 -- E_Decimal_Fixed_Point_Type
3950 -- E_Decimal_Fixed_Point_Subtype
3951 -- E_Floating_Point_Type
3952 -- E_Floating_Point_Subtype
3953 -- E_Access_Type
3954 -- E_Access_Subtype
3955 -- E_Access_Attribute_Type
3956 -- E_Allocator_Type,
3957 -- E_General_Access_Type
3958 -- E_Access_Subprogram_Type,
3959 -- E_Access_Protected_Subprogram_Type
3960 -- E_Anonymous_Access_Subprogram_Type
3961 -- E_Anonymous_Access_Protected_Subprogram_Type
3962 -- E_Anonymous_Access_Type
3963 -- E_Array_Type
3964 -- E_Array_Subtype
3965 -- E_String_Type
3966 -- E_String_Subtype
3967 -- E_String_Literal_Subtype
3968 -- E_Class_Wide_Subtype
3969 -- E_Class_Wide_Type
3970 -- E_Record_Type
3971 -- E_Record_Subtype
3972 -- E_Record_Type_With_Private
3973 -- E_Record_Subtype_With_Private
3974 -- E_Private_Type
3975 -- E_Private_Subtype
3976 -- E_Limited_Private_Type
3977 -- E_Limited_Private_Subtype
3978 -- E_Incomplete_Type
3979 -- E_Task_Type
3980 -- E_Task_Subtype
3981 -- E_Protected_Type
3982 -- E_Protected_Subtype
3983 -- E_Exception_Type
3984 E_Subprogram_Type;
3986 --------------------------------------------------------
3987 -- Description of Defined Attributes for Entity_Kinds --
3988 --------------------------------------------------------
3990 -- For each enumeration value defined in Entity_Kind we list all the
3991 -- attributes defined in Einfo which can legally be applied to an entity
3992 -- of that kind. The implementation of the attribute functions (and for
3993 -- non-synthetized attributes, of the corresponding set procedures) are
3994 -- in the Einfo body.
3996 -- The following attributes apply to all entities
3998 -- Ekind (Ekind)
4000 -- Chars (Name1)
4001 -- Next_Entity (Node2)
4002 -- Scope (Node3)
4003 -- Homonym (Node4)
4004 -- Etype (Node5)
4005 -- First_Rep_Item (Node6)
4006 -- Freeze_Node (Node7)
4008 -- Address_Taken (Flag104)
4009 -- Can_Never_Be_Null (Flag38)
4010 -- Checks_May_Be_Suppressed (Flag31)
4011 -- Debug_Info_Off (Flag166)
4012 -- Has_Controlled_Component (Flag43) (base type only)
4013 -- Has_Convention_Pragma (Flag119)
4014 -- Has_Delayed_Freeze (Flag18)
4015 -- Has_Fully_Qualified_Name (Flag173)
4016 -- Has_Gigi_Rep_Item (Flag82)
4017 -- Has_Homonym (Flag56)
4018 -- Has_Persistent_BSS (Flag188)
4019 -- Has_Pragma_Elaborate_Body (Flag150)
4020 -- Has_Pragma_Inline (Flag157)
4021 -- Has_Pragma_Unreferenced (Flag180)
4022 -- Has_Private_Declaration (Flag155)
4023 -- Has_Qualified_Name (Flag161)
4024 -- Has_Unknown_Discriminants (Flag72)
4025 -- Has_Xref_Entry (Flag182)
4026 -- Is_Ada_2005 (Flag185)
4027 -- Is_Bit_Packed_Array (Flag122) (base type only)
4028 -- Is_Child_Unit (Flag73)
4029 -- Is_Compilation_Unit (Flag149)
4030 -- Is_Completely_Hidden (Flag103)
4031 -- Is_Discrim_SO_Function (Flag176)
4032 -- Is_Dispatching_Operation (Flag6)
4033 -- Is_Exported (Flag99)
4034 -- Is_First_Subtype (Flag70)
4035 -- Is_Formal_Subprogram (Flag111)
4036 -- Is_Generic_Instance (Flag130)
4037 -- Is_Hidden (Flag57)
4038 -- Is_Hidden_Open_Scope (Flag171)
4039 -- Is_Immediately_Visible (Flag7)
4040 -- Is_Imported (Flag24)
4041 -- Is_Inlined (Flag11)
4042 -- Is_Internal (Flag17)
4043 -- Is_Itype (Flag91)
4044 -- Is_Known_Non_Null (Flag37)
4045 -- Is_Known_Valid (Flag170)
4046 -- Is_Limited_Composite (Flag106)
4047 -- Is_Limited_Record (Flag25)
4048 -- Is_Obsolescent (Flag153)
4049 -- Is_Package_Body_Entity (Flag160)
4050 -- Is_Packed_Array_Type (Flag138)
4051 -- Is_Potentially_Use_Visible (Flag9)
4052 -- Is_Preelaborated (Flag59)
4053 -- Is_Primitive_Wrapper (Flag195)
4054 -- Is_Public (Flag10)
4055 -- Is_Pure (Flag44)
4056 -- Is_Remote_Call_Interface (Flag62)
4057 -- Is_Remote_Types (Flag61)
4058 -- Is_Shared_Passive (Flag60)
4059 -- Is_Statically_Allocated (Flag28)
4060 -- Is_Unchecked_Union (Flag117)
4061 -- Is_VMS_Exception (Flag133)
4062 -- Kill_Elaboration_Checks (Flag32)
4063 -- Kill_Range_Checks (Flag33)
4064 -- Kill_Tag_Checks (Flag34)
4065 -- Materialize_Entity (Flag168)
4066 -- Needs_Debug_Info (Flag147)
4067 -- Referenced (Flag156)
4068 -- Referenced_As_LHS (Flag36)
4069 -- Suppress_Elaboration_Warnings (Flag148)
4070 -- Suppress_Style_Checks (Flag165)
4071 -- Was_Hidden (Flag196)
4073 -- Declaration_Node (synth)
4074 -- Enclosing_Dynamic_Scope (synth)
4075 -- Has_Foreign_Convention (synth)
4076 -- Is_Dynamic_Scope (synth)
4077 -- Is_Limited_Type (synth)
4078 -- Underlying_Type (synth)
4079 -- all classification attributes (synth)
4081 -- The following list of access functions applies to all entities for
4082 -- types and subtypes. References to this list appear subsequently as
4083 -- as "(plus type attributes)" for each appropriate Entity_Kind.
4085 -- Associated_Node_For_Itype (Node8)
4086 -- Class_Wide_Type (Node9)
4087 -- Referenced_Object (Node10)
4088 -- Full_View (Node11)
4089 -- Esize (Uint12)
4090 -- RM_Size (Uint13)
4091 -- Alignment (Uint14)
4093 -- Depends_On_Private (Flag14)
4094 -- Discard_Names (Flag88)
4095 -- Finalize_Storage_Only (Flag158) (base type only)
4096 -- From_With_Type (Flag159)
4097 -- Has_Aliased_Components (Flag135) (base type only)
4098 -- Has_Alignment_Clause (Flag46)
4099 -- Has_Atomic_Components (Flag86) (base type only)
4100 -- Has_Complex_Representation (Flag140) (base type only)
4101 -- Has_Constrained_Partial_View (Flag187)
4102 -- Has_Discriminants (Flag5)
4103 -- Has_Non_Standard_Rep (Flag75) (base type only)
4104 -- Has_Object_Size_Clause (Flag172)
4105 -- Has_Primitive_Operations (Flag120) (base type only)
4106 -- Has_Size_Clause (Flag29)
4107 -- Has_Specified_Layout (Flag100) (base type only)
4108 -- Has_Specified_Stream_Input (Flag190)
4109 -- Has_Specified_Stream_Output (Flag191)
4110 -- Has_Specified_Stream_Read (Flag192)
4111 -- Has_Specified_Stream_Write (Flag193)
4112 -- Has_Task (Flag30) (base type only)
4113 -- Has_Unchecked_Union (Flag123) (base type only)
4114 -- Has_Volatile_Components (Flag87) (base type only)
4115 -- In_Use (Flag8)
4116 -- Is_Abstract (Flag19)
4117 -- Is_Asynchronous (Flag81)
4118 -- Is_Atomic (Flag85)
4119 -- Is_Constr_Subt_For_U_Nominal (Flag80)
4120 -- Is_Constr_Subt_For_UN_Aliased (Flag141)
4121 -- Is_Controlled (Flag42) (base type only)
4122 -- Is_Eliminated (Flag124)
4123 -- Is_Frozen (Flag4)
4124 -- Is_Generic_Actual_Type (Flag94)
4125 -- Is_Generic_Type (Flag13)
4126 -- Is_Non_Static_Subtype (Flag109)
4127 -- Is_Packed (Flag51) (base type only)
4128 -- Is_Private_Composite (Flag107)
4129 -- Is_Renaming_Of_Object (Flag112)
4130 -- Is_Tagged_Type (Flag55)
4131 -- Is_Unsigned_Type (Flag144)
4132 -- Is_Volatile (Flag16)
4133 -- Must_Be_On_Byte_Boundary (Flag183)
4134 -- Size_Depends_On_Discriminant (Flag177)
4135 -- Size_Known_At_Compile_Time (Flag92)
4136 -- Strict_Alignment (Flag145) (base type only)
4137 -- Suppress_Init_Proc (Flag105) (base type only)
4138 -- Treat_As_Volatile (Flag41)
4140 -- Alignment_Clause (synth)
4141 -- Ancestor_Subtype (synth)
4142 -- Base_Type (synth)
4143 -- First_Subtype (synth)
4144 -- Has_Private_Ancestor (synth)
4145 -- Implementation_Base_Type (synth)
4146 -- Is_By_Copy_Type (synth)
4147 -- Is_By_Reference_Type (synth)
4148 -- Is_Return_By_Reference_Type (synth)
4149 -- Root_Type (synth)
4150 -- Size_Clause (synth)
4152 ------------------------------------------
4153 -- Applicable attributes by entity kind --
4154 ------------------------------------------
4156 -- E_Access_Protected_Subprogram_Type
4157 -- Equivalent_Type (Node18)
4158 -- Directly_Designated_Type (Node20)
4159 -- Original_Access_Type (Node21)
4160 -- Needs_No_Actuals (Flag22)
4161 -- (plus type attributes)
4163 -- E_Access_Subprogram_Type
4164 -- Equivalent_Type (Node18) (remote types only)
4165 -- Directly_Designated_Type (Node20)
4166 -- Original_Access_Type (Node21)
4167 -- Needs_No_Actuals (Flag22)
4168 -- (plus type attributes)
4170 -- E_Access_Type
4171 -- E_Access_Subtype
4172 -- Storage_Size_Variable (Node15) (base type only)
4173 -- Master_Id (Node17)
4174 -- Directly_Designated_Type (Node20)
4175 -- Associated_Storage_Pool (Node22) (base type only)
4176 -- Associated_Final_Chain (Node23)
4177 -- Has_Pragma_Controlled (Flag27) (base type only)
4178 -- Has_Storage_Size_Clause (Flag23) (base type only)
4179 -- Is_Local_Anonymous_Access (Flag194)
4180 -- Is_Access_Constant (Flag69)
4181 -- Is_Pure_Unit_Access_Type (Flag189)
4182 -- No_Pool_Assigned (Flag131) (base type only)
4183 -- No_Strict_Aliasing (Flag136) (base type only)
4184 -- (plus type attributes)
4186 -- E_Access_Attribute_Type
4187 -- Directly_Designated_Type (Node20)
4188 -- (plus type attributes)
4190 -- E_Allocator_Type
4191 -- Directly_Designated_Type (Node20)
4192 -- (plus type attributes)
4194 -- E_Anonymous_Access_Subprogram_Type
4195 -- E_Anonymous_Access_Protected_Subprogram_Type
4196 -- E_Anonymous_Access_Type
4197 -- Storage_Size_Variable (Node15) ??? is this needed ???
4198 -- Directly_Designated_Type (Node20)
4199 -- (plus type attributes)
4201 -- E_Array_Type
4202 -- E_Array_Subtype
4203 -- First_Index (Node17)
4204 -- Related_Array_Object (Node19)
4205 -- Component_Type (Node20) (base type only)
4206 -- Original_Array_Type (Node21)
4207 -- Component_Size (Uint22) (base type only)
4208 -- Packed_Array_Type (Node23)
4209 -- Component_Alignment (special) (base type only)
4210 -- Has_Component_Size_Clause (Flag68) (base type only)
4211 -- Has_Pragma_Pack (Flag121) (base type only)
4212 -- Is_Aliased (Flag15)
4213 -- Is_Constrained (Flag12)
4214 -- Next_Index (synth)
4215 -- Number_Dimensions (synth)
4216 -- (plus type attributes)
4218 -- E_Block
4219 -- Block_Node (Node11)
4220 -- First_Entity (Node17)
4221 -- Last_Entity (Node20)
4222 -- Delay_Cleanups (Flag114)
4223 -- Discard_Names (Flag88)
4224 -- Finalization_Chain_Entity (Node19)
4225 -- Scope_Depth_Value (Uint22)
4226 -- Entry_Cancel_Parameter (Node23)
4227 -- Has_Master_Entity (Flag21)
4228 -- Has_Nested_Block_With_Handler (Flag101)
4229 -- Sec_Stack_Needed_For_Return (Flag167)
4230 -- Uses_Sec_Stack (Flag95)
4231 -- Scope_Depth (synth)
4233 -- E_Class_Wide_Type
4234 -- E_Class_Wide_Subtype
4235 -- Cloned_Subtype (Node16) (subtype case only)
4236 -- First_Entity (Node17)
4237 -- Equivalent_Type (Node18) (always Empty in type case)
4238 -- Last_Entity (Node20)
4239 -- First_Component (synth)
4240 -- (plus type attributes)
4242 -- E_Component
4243 -- Normalized_First_Bit (Uint8)
4244 -- Current_Value (Node9) (always Empty)
4245 -- Normalized_Position_Max (Uint10)
4246 -- Component_Bit_Offset (Uint11)
4247 -- Esize (Uint12)
4248 -- Component_Clause (Node13)
4249 -- Normalized_Position (Uint14)
4250 -- DT_Entry_Count (Uint15)
4251 -- Entry_Formal (Node16)
4252 -- Prival (Node17)
4253 -- Renamed_Object (Node18) (always Empty)
4254 -- Discriminant_Checking_Func (Node20)
4255 -- Interface_Name (Node21) (JGNAT usage only)
4256 -- Original_Record_Component (Node22)
4257 -- Protected_Operation (Node23)
4258 -- Has_Biased_Representation (Flag139)
4259 -- Has_Per_Object_Constraint (Flag154)
4260 -- Is_Atomic (Flag85)
4261 -- Is_Tag (Flag78)
4262 -- Is_Volatile (Flag16)
4263 -- Treat_As_Volatile (Flag41)
4264 -- Is_Protected_Private (synth)
4265 -- Next_Component (synth)
4266 -- Next_Tag_Component (synth)
4268 -- E_Constant
4269 -- E_Loop_Parameter
4270 -- Current_Value (Node9) (always Empty)
4271 -- Discriminal_Link (Node10) (discriminals only)
4272 -- Full_View (Node11)
4273 -- Esize (Uint12)
4274 -- Alignment (Uint14)
4275 -- Actual_Subtype (Node17)
4276 -- Renamed_Object (Node18)
4277 -- Size_Check_Code (Node19) (constants only)
4278 -- Interface_Name (Node21)
4279 -- Has_Alignment_Clause (Flag46)
4280 -- Has_Atomic_Components (Flag86)
4281 -- Has_Biased_Representation (Flag139)
4282 -- Has_Completion (Flag26) (constants only)
4283 -- Has_Size_Clause (Flag29)
4284 -- Has_Volatile_Components (Flag87)
4285 -- Is_Atomic (Flag85)
4286 -- Is_Eliminated (Flag124)
4287 -- Is_True_Constant (Flag163)
4288 -- Is_Volatile (Flag16)
4289 -- Never_Set_In_Source (Flag115)
4290 -- Treat_As_Volatile (Flag41)
4291 -- Address_Clause (synth)
4292 -- Alignment_Clause (synth)
4293 -- Constant_Value (synth)
4294 -- Size_Clause (synth)
4296 -- E_Decimal_Fixed_Point_Type
4297 -- E_Decimal_Fixed_Subtype
4298 -- Scale_Value (Uint15)
4299 -- Digits_Value (Uint17)
4300 -- Scalar_Range (Node20)
4301 -- Delta_Value (Ureal18)
4302 -- Small_Value (Ureal21)
4303 -- Has_Machine_Radix_Clause (Flag83)
4304 -- Machine_Radix_10 (Flag84)
4305 -- Type_Low_Bound (synth)
4306 -- Type_High_Bound (synth)
4307 -- (plus type attributes)
4309 -- E_Discriminant
4310 -- Normalized_First_Bit (Uint8)
4311 -- Current_Value (Node9) (always Empty)
4312 -- Normalized_Position_Max (Uint10)
4313 -- Component_Bit_Offset (Uint11)
4314 -- Esize (Uint12)
4315 -- Component_Clause (Node13)
4316 -- Normalized_Position (Uint14)
4317 -- Discriminant_Number (Uint15)
4318 -- Discriminal (Node17)
4319 -- Renamed_Object (Node18) (always Empty)
4320 -- Corresponding_Discriminant (Node19)
4321 -- Discriminant_Default_Value (Node20)
4322 -- Interface_Name (Node21) (JGNAT usage only)
4323 -- Original_Record_Component (Node22)
4324 -- CR_Discriminant (Node23)
4325 -- Next_Discriminant (synth)
4326 -- Next_Stored_Discriminant (synth)
4328 -- E_Entry
4329 -- E_Entry_Family
4330 -- Protected_Body_Subprogram (Node11)
4331 -- Barrier_Function (Node12)
4332 -- Entry_Parameters_Type (Node15)
4333 -- First_Entity (Node17)
4334 -- Alias (Node18) (Entry only. Always empty)
4335 -- Finalization_Chain_Entity (Node19)
4336 -- Last_Entity (Node20)
4337 -- Accept_Address (Elist21)
4338 -- Scope_Depth_Value (Uint22)
4339 -- Privals_Chain (Elist23) (for a protected entry)
4340 -- Default_Expressions_Processed (Flag108)
4341 -- Entry_Accepted (Flag152)
4342 -- Is_AST_Entry (Flag132) (for entry only)
4343 -- Needs_No_Actuals (Flag22)
4344 -- Sec_Stack_Needed_For_Return (Flag167)
4345 -- Uses_Sec_Stack (Flag95)
4346 -- Address_Clause (synth)
4347 -- First_Formal (synth)
4348 -- Entry_Index_Type (synth)
4349 -- Number_Formals (synth)
4350 -- Scope_Depth (synth)
4352 -- E_Entry_Index_Parameter
4353 -- Entry_Index_Constant (Node18)
4355 -- E_Enumeration_Literal
4356 -- Enumeration_Pos (Uint11)
4357 -- Enumeration_Rep (Uint12)
4358 -- Debug_Renaming_Link (Node13)
4359 -- Alias (Node18)
4360 -- Enumeration_Rep_Expr (Node22)
4361 -- Next_Literal (synth)
4363 -- E_Enumeration_Type
4364 -- E_Enumeration_Subtype
4365 -- Lit_Indexes (Node15) (root type only)
4366 -- Lit_Strings (Node16) (root type only)
4367 -- First_Literal (Node17)
4368 -- Scalar_Range (Node20)
4369 -- Enum_Pos_To_Rep (Node23) (type only, not subtype)
4370 -- Has_Biased_Representation (Flag139)
4371 -- Has_Contiguous_Rep (Flag181)
4372 -- Has_Enumeration_Rep_Clause (Flag66)
4373 -- Nonzero_Is_True (Flag162) (base type only)
4374 -- Type_Low_Bound (synth)
4375 -- Type_High_Bound (synth)
4376 -- (plus type attributes)
4378 -- E_Exception
4379 -- Alignment (Uint14)
4380 -- Renamed_Entity (Node18)
4381 -- Register_Exception_Call (Node20)
4382 -- Interface_Name (Node21)
4383 -- Exception_Code (Uint22)
4384 -- Discard_Names (Flag88)
4385 -- Is_VMS_Exception (Flag133)
4387 -- E_Exception_Type
4388 -- Equivalent_Type (Node18)
4389 -- (plus type attributes)
4391 -- E_Floating_Point_Type
4392 -- E_Floating_Point_Subtype
4393 -- Digits_Value (Uint17)
4394 -- Scalar_Range (Node20)
4395 -- Type_Low_Bound (synth)
4396 -- Type_High_Bound (synth)
4397 -- (plus type attributes)
4399 -- E_Function
4400 -- E_Generic_Function
4401 -- Mechanism (Uint8) (returns Mechanism_Type)
4402 -- Renaming_Map (Uint9)
4403 -- Handler_Records (List10) (non-generic case only)
4404 -- Protected_Body_Subprogram (Node11)
4405 -- Next_Inlined_Subprogram (Node12)
4406 -- Corresponding_Equality (Node13) (implicit /= only)
4407 -- Elaboration_Entity (Node13) (all other cases)
4408 -- First_Optional_Parameter (Node14) (non-generic case only)
4409 -- DT_Position (Uint15)
4410 -- DTC_Entity (Node16)
4411 -- First_Entity (Node17)
4412 -- Alias (Node18) (non-generic case only)
4413 -- Renamed_Entity (Node18) (generic case only)
4414 -- Finalization_Chain_Entity (Node19)
4415 -- Last_Entity (Node20)
4416 -- Interface_Name (Node21)
4417 -- Scope_Depth_Value (Uint22)
4418 -- Generic_Renamings (Elist23) (for an instance)
4419 -- Inner_Instances (Elist23) (for a generic function)
4420 -- Privals_Chain (Elist23) (for a protected function)
4421 -- Obsolescent_Warning (Node24)
4422 -- Abstract_Interface_Alias (Node25)
4423 -- Overridden_Operation (Node26)
4424 -- Body_Needed_For_SAL (Flag40)
4425 -- Elaboration_Entity_Required (Flag174)
4426 -- Function_Returns_With_DSP (Flag169)
4427 -- Default_Expressions_Processed (Flag108)
4428 -- Delay_Cleanups (Flag114)
4429 -- Delay_Subprogram_Descriptors (Flag50)
4430 -- Discard_Names (Flag88)
4431 -- Elaborate_All_Desirable (Flag146)
4432 -- Has_Completion (Flag26)
4433 -- Has_Controlling_Result (Flag98)
4434 -- Has_Master_Entity (Flag21)
4435 -- Has_Missing_Return (Flag142)
4436 -- Has_Nested_Block_With_Handler (Flag101)
4437 -- Has_Pragma_Pure_Function (Flag179) (non-generic case only)
4438 -- Has_Recursive_Call (Flag143)
4439 -- Has_Subprogram_Descriptor (Flag93)
4440 -- Is_Abstract (Flag19)
4441 -- Is_Called (Flag102) (non-generic case only)
4442 -- Is_Constructor (Flag76)
4443 -- Is_Discrim_SO_Function (Flag176)
4444 -- Is_Eliminated (Flag124)
4445 -- Is_Instantiated (Flag126) (generic case only)
4446 -- Is_Intrinsic_Subprogram (Flag64)
4447 -- Is_Machine_Code_Subprogram (Flag137) (non-generic case only)
4448 -- Is_Overriding_Operation (Flag39) (non-generic case only)
4449 -- Is_Private_Descendant (Flag53)
4450 -- Is_Pure (Flag44)
4451 -- Is_Thread_Body (Flag77) (non-generic case only)
4452 -- Is_Visible_Child_Unit (Flag116)
4453 -- Needs_No_Actuals (Flag22)
4454 -- Return_Present (Flag54)
4455 -- Returns_By_Ref (Flag90)
4456 -- Sec_Stack_Needed_For_Return (Flag167)
4457 -- Uses_Sec_Stack (Flag95)
4458 -- Address_Clause (synth)
4459 -- First_Formal (synth)
4460 -- Number_Formals (synth)
4461 -- Scope_Depth (synth)
4463 -- E_General_Access_Type
4464 -- Storage_Size_Variable (Node15) (base type only)
4465 -- Master_Id (Node17)
4466 -- Directly_Designated_Type (Node20)
4467 -- Associated_Storage_Pool (Node22) (base type only)
4468 -- Associated_Final_Chain (Node23)
4469 -- (plus type attributes)
4471 -- E_Generic_In_Parameter
4472 -- E_Generic_In_Out_Parameter
4473 -- Current_Value (Node9) (always Empty)
4474 -- Entry_Component (Node11)
4475 -- Actual_Subtype (Node17)
4476 -- Renamed_Object (Node18) (always Empty)
4477 -- Default_Value (Node20)
4478 -- Protected_Formal (Node22)
4479 -- Is_Controlling_Formal (Flag97)
4480 -- Is_Entry_Formal (Flag52)
4481 -- Parameter_Mode (synth)
4483 -- E_Incomplete_Type
4484 -- Non_Limited_View (Node17)
4485 -- Private_Dependents (Elist18)
4486 -- Discriminant_Constraint (Elist21)
4487 -- Stored_Constraint (Elist23)
4488 -- First_Discriminant (synth)
4489 -- First_Stored_Discriminant (synth)
4490 -- (plus type attributes)
4492 -- E_In_Parameter
4493 -- E_In_Out_Parameter
4494 -- E_Out_Parameter
4495 -- Mechanism (Uint8) (returns Mechanism_Type)
4496 -- Current_Value (Node9) (always Empty for IN case)
4497 -- Discriminal_Link (Node10) (discriminals only)
4498 -- Entry_Component (Node11)
4499 -- Esize (Uint12)
4500 -- Extra_Accessibility (Node13)
4501 -- Alignment (Uint14)
4502 -- Extra_Formal (Node15)
4503 -- Unset_Reference (Node16)
4504 -- Actual_Subtype (Node17)
4505 -- Renamed_Object (Node18)
4506 -- Spec_Entity (Node19)
4507 -- Default_Value (Node20)
4508 -- Default_Expr_Function (Node21)
4509 -- Protected_Formal (Node22)
4510 -- Extra_Constrained (Node23)
4511 -- Is_Controlling_Formal (Flag97)
4512 -- Is_Entry_Formal (Flag52)
4513 -- Is_Optional_Parameter (Flag134)
4514 -- Never_Set_In_Source (Flag115)
4515 -- Parameter_Mode (synth)
4517 -- E_Label
4518 -- Enclosing_Scope (Node18)
4519 -- Reachable (Flag49)
4521 -- E_Limited_Private_Type
4522 -- E_Limited_Private_Subtype
4523 -- First_Entity (Node17)
4524 -- Private_Dependents (Elist18)
4525 -- Underlying_Full_View (Node19)
4526 -- Last_Entity (Node20)
4527 -- Discriminant_Constraint (Elist21)
4528 -- Private_View (Node22)
4529 -- Stored_Constraint (Elist23)
4530 -- Has_Completion (Flag26)
4531 -- Has_Completion_In_Body (Flag71)
4532 -- First_Discriminant (synth)
4533 -- First_Stored_Discriminant (synth)
4534 -- (plus type attributes)
4536 -- E_Loop
4537 -- Has_Exit (Flag47)
4538 -- Has_Master_Entity (Flag21)
4539 -- Has_Nested_Block_With_Handler (Flag101)
4541 -- E_Modular_Integer_Type
4542 -- E_Modular_Integer_Subtype
4543 -- Modulus (Uint17) (base type only)
4544 -- Original_Array_Type (Node21)
4545 -- Scalar_Range (Node20)
4546 -- Non_Binary_Modulus (Flag58) (base type only)
4547 -- Has_Biased_Representation (Flag139)
4548 -- Type_Low_Bound (synth)
4549 -- Type_High_Bound (synth)
4550 -- (plus type attributes)
4552 -- E_Named_Integer
4553 -- Constant_Value (synth)
4555 -- E_Named_Real
4556 -- Constant_Value (synth)
4558 -- E_Operator
4559 -- First_Entity (Node17)
4560 -- Alias (Node18)
4561 -- Last_Entity (Node20)
4562 -- Is_Machine_Code_Subprogram (Flag137)
4563 -- Is_Pure (Flag44)
4564 -- Is_Intrinsic_Subprogram (Flag64)
4565 -- Is_Overriding_Operation (Flag39)
4566 -- Default_Expressions_Processed (Flag108)
4567 -- Has_Pragma_Pure_Function (Flag179)
4569 -- E_Ordinary_Fixed_Point_Type
4570 -- E_Ordinary_Fixed_Point_Subtype
4571 -- Delta_Value (Ureal18)
4572 -- Scalar_Range (Node20)
4573 -- Small_Value (Ureal21)
4574 -- Has_Small_Clause (Flag67)
4575 -- Type_Low_Bound (synth)
4576 -- Type_High_Bound (synth)
4577 -- (plus type attributes)
4579 -- E_Package
4580 -- E_Generic_Package
4581 -- Dependent_Instances (Elist8) (for an instance)
4582 -- Renaming_Map (Uint9)
4583 -- Handler_Records (List10) (non-generic case only)
4584 -- Generic_Homonym (Node11) (generic case only)
4585 -- Associated_Formal_Package (Node12)
4586 -- Elaboration_Entity (Node13)
4587 -- Shadow_Entities (List14)
4588 -- Related_Instance (Node15) (non-generic case only)
4589 -- First_Private_Entity (Node16)
4590 -- First_Entity (Node17)
4591 -- Renamed_Entity (Node18)
4592 -- Body_Entity (Node19)
4593 -- Last_Entity (Node20)
4594 -- Interface_Name (Node21)
4595 -- Scope_Depth_Value (Uint22)
4596 -- Generic_Renamings (Elist23) (for an instance)
4597 -- Inner_Instances (Elist23) (generic case only)
4598 -- Limited_View (Node23) (non-generic, not instance)
4599 -- Delay_Subprogram_Descriptors (Flag50)
4600 -- Body_Needed_For_SAL (Flag40)
4601 -- Discard_Names (Flag88)
4602 -- Elaborate_All_Desirable (Flag146)
4603 -- Elaboration_Entity_Required (Flag174)
4604 -- From_With_Type (Flag159)
4605 -- Has_All_Calls_Remote (Flag79)
4606 -- Has_Completion (Flag26)
4607 -- Has_Forward_Instantiation (Flag175)
4608 -- Has_Master_Entity (Flag21)
4609 -- Has_Subprogram_Descriptor (Flag93)
4610 -- In_Package_Body (Flag48)
4611 -- In_Private_Part (Flag45)
4612 -- In_Use (Flag8)
4613 -- Is_Instantiated (Flag126)
4614 -- Is_Private_Descendant (Flag53)
4615 -- Is_Visible_Child_Unit (Flag116)
4616 -- Is_Wrapper_Package (synth) (non-generic case only)
4617 -- Scope_Depth (synth)
4619 -- E_Package_Body
4620 -- Handler_Records (List10) (non-generic case only)
4621 -- Related_Instance (Node15) (non-generic case only)
4622 -- First_Entity (Node17)
4623 -- Spec_Entity (Node19)
4624 -- Last_Entity (Node20)
4625 -- Scope_Depth_Value (Uint22)
4626 -- Scope_Depth (synth)
4627 -- Delay_Subprogram_Descriptors (Flag50)
4628 -- Has_Subprogram_Descriptor (Flag93)
4630 -- E_Private_Type
4631 -- E_Private_Subtype
4632 -- Primitive_Operations (Elist15)
4633 -- First_Entity (Node17)
4634 -- Private_Dependents (Elist18)
4635 -- Underlying_Full_View (Node19)
4636 -- Last_Entity (Node20)
4637 -- Discriminant_Constraint (Elist21)
4638 -- Private_View (Node22)
4639 -- Stored_Constraint (Elist23)
4640 -- Has_Completion (Flag26)
4641 -- Has_Completion_In_Body (Flag71)
4642 -- Is_Controlled (Flag42) (base type only)
4643 -- Is_For_Access_Subtype (Flag118) (subtype only)
4644 -- First_Discriminant (synth)
4645 -- First_Stored_Discriminant (synth)
4646 -- (plus type attributes)
4648 -- E_Procedure
4649 -- E_Generic_Procedure
4650 -- Renaming_Map (Uint9)
4651 -- Handler_Records (List10) (non-generic case only)
4652 -- Protected_Body_Subprogram (Node11)
4653 -- Next_Inlined_Subprogram (Node12)
4654 -- Elaboration_Entity (Node13)
4655 -- First_Optional_Parameter (Node14) (non-generic case only)
4656 -- DT_Position (Uint15)
4657 -- DTC_Entity (Node16)
4658 -- First_Entity (Node17)
4659 -- Alias (Node18) (non-generic case only)
4660 -- Renamed_Entity (Node18) (generic case only)
4661 -- Finalization_Chain_Entity (Node19)
4662 -- Last_Entity (Node20)
4663 -- Interface_Name (Node21)
4664 -- Scope_Depth_Value (Uint22)
4665 -- Scope_Depth (synth)
4666 -- Generic_Renamings (Elist23) (for an instance)
4667 -- Inner_Instances (Elist23) (for a generic procedure)
4668 -- Privals_Chain (Elist23) (for a protected procedure)
4669 -- Obsolescent_Warning (Node24)
4670 -- Abstract_Interface_Alias (Node25)
4671 -- Overridden_Operation (Node26)
4672 -- Wrapped_Entity (Node27) (non-generic case only)
4674 -- Body_Needed_For_SAL (Flag40)
4675 -- Elaboration_Entity_Required (Flag174)
4676 -- Function_Returns_With_DSP (Flag169) (always False for procedure)
4677 -- Default_Expressions_Processed (Flag108)
4678 -- Delay_Cleanups (Flag114)
4679 -- Delay_Subprogram_Descriptors (Flag50)
4680 -- Discard_Names (Flag88)
4681 -- Elaborate_All_Desirable (Flag146)
4682 -- Has_Completion (Flag26)
4683 -- Has_Master_Entity (Flag21)
4684 -- Has_Nested_Block_With_Handler (Flag101)
4685 -- Has_Pragma_Pure_Function (Flag179) (non-generic case only)
4686 -- Has_Subprogram_Descriptor (Flag93)
4687 -- Is_Visible_Child_Unit (Flag116)
4688 -- Is_Abstract (Flag19)
4689 -- Is_Asynchronous (Flag81)
4690 -- Is_Called (Flag102) (non-generic subprogram)
4691 -- Is_Constructor (Flag76)
4692 -- Is_Eliminated (Flag124)
4693 -- Is_Instantiated (Flag126) (generic case only)
4694 -- Is_Interrupt_Handler (Flag89)
4695 -- Is_Intrinsic_Subprogram (Flag64)
4696 -- Is_Machine_Code_Subprogram (Flag137) (non-generic case only)
4697 -- Is_Null_Init_Proc (Flag178)
4698 -- Is_Overriding_Operation (Flag39) (non-generic case only)
4699 -- Is_Primitive_Wrapper (Flag195) (non-generic case only)
4701 -- Is_Private_Descendant (Flag53)
4702 -- Is_Pure (Flag44)
4703 -- Is_Thread_Body (Flag77) (non-generic case only)
4704 -- Is_Valued_Procedure (Flag127)
4705 -- Is_Visible_Child_Unit (Flag116)
4706 -- Needs_No_Actuals (Flag22)
4707 -- No_Return (Flag113)
4708 -- Sec_Stack_Needed_For_Return (Flag167)
4709 -- Address_Clause (synth)
4710 -- First_Formal (synth)
4711 -- Number_Formals (synth)
4713 -- E_Protected_Body
4714 -- Object_Ref (Node17)
4715 -- (any others??? First/Last Entity, Scope_Depth???)
4717 -- E_Protected_Object
4719 -- E_Protected_Type
4720 -- E_Protected_Subtype
4721 -- Entry_Bodies_Array (Node15)
4722 -- First_Private_Entity (Node16)
4723 -- First_Entity (Node17)
4724 -- Corresponding_Record_Type (Node18)
4725 -- Finalization_Chain_Entity (Node19)
4726 -- Last_Entity (Node20)
4727 -- Discriminant_Constraint (Elist21)
4728 -- Scope_Depth_Value (Uint22)
4729 -- Scope_Depth (synth)
4730 -- Stored_Constraint (Elist23)
4731 -- Has_Interrupt_Handler (synth)
4732 -- Sec_Stack_Needed_For_Return (Flag167) ???
4733 -- Uses_Sec_Stack (Flag95) ???
4734 -- Has_Entries (synth)
4735 -- Number_Entries (synth)
4737 -- E_Record_Type
4738 -- E_Record_Subtype
4739 -- Primitive_Operations (Elist15)
4740 -- Access_Disp_Table (Elist16) (base type only)
4741 -- Cloned_Subtype (Node16) (subtype case only)
4742 -- First_Entity (Node17)
4743 -- Corresponding_Concurrent_Type (Node18)
4744 -- Parent_Subtype (Node19)
4745 -- Last_Entity (Node20)
4746 -- Discriminant_Constraint (Elist21)
4747 -- Corresponding_Remote_Type (Node22)
4748 -- Stored_Constraint (Elist23)
4749 -- Abstract_Interfaces (Elist24)
4750 -- Component_Alignment (special) (base type only)
4751 -- C_Pass_By_Copy (Flag125) (base type only)
4752 -- Has_External_Tag_Rep_Clause (Flag110)
4753 -- Has_Record_Rep_Clause (Flag65) (base type only)
4754 -- Is_Class_Wide_Equivalent_Type (Flag35)
4755 -- Is_Concurrent_Record_Type (Flag20)
4756 -- Is_Constrained (Flag12)
4757 -- Is_Controlled (Flag42) (base type only)
4758 -- Is_Interface (Flag186)
4759 -- Reverse_Bit_Order (Flag164) (base type only)
4760 -- First_Component (synth)
4761 -- First_Discriminant (synth)
4762 -- First_Stored_Discriminant (synth)
4763 -- First_Tag_Component (synth)
4764 -- (plus type attributes)
4766 -- E_Record_Type_With_Private
4767 -- E_Record_Subtype_With_Private
4768 -- Primitive_Operations (Elist15)
4769 -- Access_Disp_Table (Elist16) (base type only)
4770 -- First_Entity (Node17)
4771 -- Private_Dependents (Elist18)
4772 -- Underlying_Full_View (Node19)
4773 -- Last_Entity (Node20)
4774 -- Discriminant_Constraint (Elist21)
4775 -- Private_View (Node22)
4776 -- Stored_Constraint (Elist23)
4777 -- Abstract_Interfaces (Elist24)
4778 -- Has_Completion (Flag26)
4779 -- Has_Completion_In_Body (Flag71)
4780 -- Has_Record_Rep_Clause (Flag65) (base type only)
4781 -- Has_External_Tag_Rep_Clause (Flag110)
4782 -- Is_Concurrent_Record_Type (Flag20)
4783 -- Is_Constrained (Flag12)
4784 -- Is_Controlled (Flag42) (base type only)
4785 -- Is_Interface (Flag186)
4786 -- Reverse_Bit_Order (Flag164) (base type only)
4787 -- First_Component (synth)
4788 -- First_Discriminant (synth)
4789 -- First_Stored_Discriminant (synth)
4790 -- First_Tag_Component (synth)
4791 -- (plus type attributes)
4793 -- E_Signed_Integer_Type
4794 -- E_Signed_Integer_Subtype
4795 -- Scalar_Range (Node20)
4796 -- Has_Biased_Representation (Flag139)
4797 -- Type_Low_Bound (synth)
4798 -- Type_High_Bound (synth)
4799 -- (plus type attributes)
4801 -- E_String_Type
4802 -- E_String_Subtype
4803 -- First_Index (Node17)
4804 -- Component_Type (Node20) (base type only)
4805 -- Is_Constrained (Flag12)
4806 -- Next_Index (synth)
4807 -- Number_Dimensions (synth)
4808 -- (plus type attributes)
4810 -- E_String_Literal_Subtype
4811 -- String_Literal_Low_Bound (Node15)
4812 -- String_Literal_Length (Uint16)
4813 -- First_Index (Node17) (always Empty)
4814 -- Packed_Array_Type (Node23)
4815 -- (plus type attributes)
4817 -- E_Subprogram_Body
4818 -- Mechanism (Uint8)
4819 -- First_Entity (Node17)
4820 -- Last_Entity (Node20)
4821 -- Scope_Depth_Value (Uint22)
4822 -- Scope_Depth (synth)
4824 -- E_Subprogram_Type
4825 -- Directly_Designated_Type (Node20)
4826 -- First_Formal (synth)
4827 -- Number_Formals (synth)
4828 -- Function_Returns_With_DSP (Flag169)
4829 -- (plus type attributes)
4831 -- E_Task_Body
4832 -- (any others??? First/Last Entity, Scope_Depth???)
4834 -- E_Task_Type
4835 -- E_Task_Subtype
4836 -- Storage_Size_Variable (Node15) (base type only)
4837 -- First_Private_Entity (Node16)
4838 -- First_Entity (Node17)
4839 -- Corresponding_Record_Type (Node18)
4840 -- Finalization_Chain_Entity (Node19)
4841 -- Last_Entity (Node20)
4842 -- Discriminant_Constraint (Elist21)
4843 -- Scope_Depth_Value (Uint22)
4844 -- Scope_Depth (synth)
4845 -- Stored_Constraint (Elist23)
4846 -- Task_Body_Procedure (Node24)
4847 -- Delay_Cleanups (Flag114)
4848 -- Has_Master_Entity (Flag21)
4849 -- Has_Storage_Size_Clause (Flag23) (base type only)
4850 -- Uses_Sec_Stack (Flag95) ???
4851 -- Sec_Stack_Needed_For_Return (Flag167) ???
4852 -- Has_Entries (synth)
4853 -- Number_Entries (synth)
4854 -- (plus type attributes)
4856 -- E_Variable
4857 -- Hiding_Loop_Variable (Node8)
4858 -- Current_Value (Node9)
4859 -- Esize (Uint12)
4860 -- Extra_Accessibility (Node13)
4861 -- Alignment (Uint14)
4862 -- Shared_Var_Read_Proc (Node15)
4863 -- Unset_Reference (Node16)
4864 -- Actual_Subtype (Node17)
4865 -- Renamed_Object (Node18)
4866 -- Size_Check_Code (Node19)
4867 -- Interface_Name (Node21)
4868 -- Shared_Var_Assign_Proc (Node22)
4869 -- Extra_Constrained (Node23)
4870 -- Has_Alignment_Clause (Flag46)
4871 -- Has_Atomic_Components (Flag86)
4872 -- Has_Biased_Representation (Flag139)
4873 -- Has_Size_Clause (Flag29)
4874 -- Has_Volatile_Components (Flag87)
4875 -- Is_Atomic (Flag85)
4876 -- Is_Eliminated (Flag124)
4877 -- Is_Shared_Passive (Flag60)
4878 -- Is_True_Constant (Flag163)
4879 -- Is_Volatile (Flag16)
4880 -- Never_Set_In_Source (Flag115)
4881 -- Treat_As_Volatile (Flag41)
4882 -- Address_Clause (synth)
4883 -- Alignment_Clause (synth)
4884 -- Constant_Value (synth)
4885 -- Size_Clause (synth)
4887 -- E_Void
4888 -- Since E_Void is the initial Ekind value of an entity when it is first
4889 -- created, one might expect that no attributes would be defined on such
4890 -- an entity until its Ekind field is set. However, in practice, there
4891 -- are many instances in which fields of an E_Void entity are set in the
4892 -- code prior to setting the Ekind field. This is not well documented or
4893 -- well controlled, and needs cleaning up later. Meanwhile, the access
4894 -- procedures in the body of Einfo permit many, but not all, attributes
4895 -- to be applied to an E_Void entity, precisely so that this kind of
4896 -- pre-setting of attributes works. This is really a hole in the dynamic
4897 -- type checking, since there is no assurance that the eventual Ekind
4898 -- value will be appropriate for the attributes set, and the consequence
4899 -- is that the dynamic type checking in the Einfo body is unnecessarily
4900 -- weak. To be looked at systematically some time ???
4902 ---------------------------------
4903 -- Component_Alignment Control --
4904 ---------------------------------
4906 -- There are four types of alignment possible for array and record
4907 -- types, and a field in the type entities contains a value of the
4908 -- following type indicating which alignment choice applies. For full
4909 -- details of the meaning of these aligment types, see description
4910 -- of the Component_Alignment pragma
4912 type Component_Alignment_Kind is (
4913 Calign_Default, -- default alignment
4914 Calign_Component_Size, -- natural alignment for component size
4915 Calign_Component_Size_4, -- natural for size <= 4, 4 for size >= 4
4916 Calign_Storage_Unit); -- all components byte aligned
4918 ---------------
4919 -- Iterators --
4920 ---------------
4922 -- In addition to attributes that are stored as plain data, other
4923 -- attributes are procedural, and require some small amount of
4924 -- computation. Of course, from the point of view of a user of this
4925 -- package, the distinction is not visible (even the field information
4926 -- provided below should be disregarded, as it is subject to change
4927 -- without notice!). A number of attributes appear as lists: lists of
4928 -- formals, lists of actuals, of discriminants, etc. For these, pairs
4929 -- of functions are defined, which take the form:
4931 -- function First_Thing (E : Enclosing_Construct) return Thing;
4932 -- function Next_Thing (T : Thing) return Thing;
4934 -- The end of iteration is always signaled by a value of Empty, so that
4935 -- loops over these chains invariably have the form:
4937 -- This : Thing;
4938 -- ...
4939 -- This := First_Thing (E);
4941 -- while Present (This) loop
4942 -- Do_Something_With (This);
4943 -- ...
4944 -- This := Next_Thing (This);
4945 -- end loop;
4947 -----------------------------------
4948 -- Handling of Check Suppression --
4949 -----------------------------------
4951 -- There are three ways that checks can be suppressed:
4953 -- 1. At the command line level
4954 -- 2. At the scope level.
4955 -- 3. At the entity level.
4957 -- See spec of Sem in sem.ads for details of the data structures used
4958 -- to keep track of these various methods for suppressing checks.
4960 -------------------------------
4961 -- Handling of Discriminants --
4962 -------------------------------
4964 -- During semantic processing, discriminants are separate entities which
4965 -- reflect the semantic properties and allowed usage of discriminants in
4966 -- the language.
4968 -- In the case of discriminants used as bounds, the references are handled
4969 -- directly, since special processing is needed in any case. However, there
4970 -- are two circumstances in which discriminants are referenced in a quite
4971 -- general manner, like any other variables:
4973 -- In initialization expressions for records. Note that the expressions
4974 -- used in Priority, Storage_Size, and Task_Info pragmas are effectively
4975 -- in this category, since these pragmas are converted to initialized
4976 -- record fields in the Corresponding_Record_Type.
4978 -- In task and protected bodies, where the discriminant values may be
4979 -- referenced freely within these bodies. Discriminants can also appear
4980 -- in bounds of entry families and in defaults of operations.
4982 -- In both these cases, the discriminants must be treated essentially as
4983 -- objects. The following approach is used to simplify and minimize the
4984 -- special processing that is required.
4986 -- When a record type with discriminants is processed, the semantic
4987 -- processing creates the entities for the discriminants. It also creates
4988 -- an additional set of entities, called discriminals, one for each of
4989 -- the discriminants, and the Discriminal field of the discriminant entity
4990 -- points to this additional entity, which is initially created as an
4991 -- uninitialized (E_Void) entity.
4993 -- During expansion of expressions, any discriminant reference is replaced
4994 -- by a reference to the corresponding discriminal. When the initialization
4995 -- procedure for the record is created (there will always be one, since
4996 -- discriminants are present, see Exp_Ch3 for further details), the
4997 -- discriminals are used as the entities for the formal parameters of
4998 -- this initialization procedure. The references to these discriminants
4999 -- have already been replaced by references to these discriminals, which
5000 -- are now the formal parameters corresponding to the required objects.
5002 -- In the case of a task or protected body, the semantics similarly
5003 -- creates a set of discriminals for the discriminants of the task or
5004 -- protected type. When the procedure is created for the task body,
5005 -- the parameter passed in is a reference to the task value type, which
5006 -- contains the required discriminant values. The expander creates a
5007 -- set of declarations of the form:
5009 -- discriminal : constant dtype renames _Task.discriminant;
5011 -- where discriminal is the discriminal entity referenced by the task
5012 -- discriminant, and _Task is the task value passed in as the parameter.
5013 -- Again, any references to discriminants in the task body have been
5014 -- replaced by the discriminal reference, which is now an object that
5015 -- contains the required value.
5017 -- This approach for tasks means that two sets of discriminals are needed
5018 -- for a task type, one for the initialization procedure, and one for the
5019 -- task body. This works out nicely, since the semantics allocates one set
5020 -- for the task itself, and one set for the corresponding record.
5022 -- The one bit of trickiness arises in making sure that the right set of
5023 -- discriminals is used at the right time. First the task definition is
5024 -- processed. Any references to discriminants here are replaced by the
5025 -- the corresponding *task* discriminals (the record type doesn't even
5026 -- exist yet, since it is constructed as part of the expansion of the
5027 -- task declaration, which happens after the semantic processing of the
5028 -- task definition). The discriminants to be used for the corresponding
5029 -- record are created at the same time as the other discriminals, and
5030 -- held in the CR_Discriminant field of the discriminant. A use of the
5031 -- discriminant in a bound for an entry family is replaced with the CR_
5032 -- discriminant because it controls the bound of the entry queue array
5033 -- which is a component of the corresponding record.
5035 -- Just before the record initialization routine is constructed, the
5036 -- expander exchanges the task and record discriminals. This has two
5037 -- effects. First the generation of the record initialization routine
5038 -- uses the discriminals that are now on the record, which is the set
5039 -- that used to be on the task, which is what we want.
5041 -- Second, a new set of (so far unused) discriminals is now on the task
5042 -- discriminants, and it is this set that will be used for expanding the
5043 -- task body, and also for the discriminal declarations at the start of
5044 -- the task body.
5046 ---------------------------------------
5047 -- Private data in protected objects --
5048 ---------------------------------------
5050 -- Private object declarations in protected types pose problems
5051 -- similar to those of discriminants. They are expanded to components
5052 -- of a record which is passed as the parameter "_object" to expanded
5053 -- forms of all protected operations. As with discriminants, timing
5054 -- of this expansion is a problem. The sequence of statements for a
5055 -- protected operation is expanded before the operation itself, so the
5056 -- formal parameter for the record object containing the private data
5057 -- does not exist when the references to that data are expanded.
5059 -- For this reason, private data is handled in the same way as
5060 -- discriminants, expanding references to private data in protected
5061 -- operations (which appear as components) to placeholders which will
5062 -- eventually become renamings of the private selected components
5063 -- of the "_object" formal parameter. These placeholders are called
5064 -- "privals", by analogy to the "discriminals" used to implement
5065 -- discriminants. They are attached to the component declaration nodes
5066 -- representing the private object declarations of the protected type.
5068 -- As with discriminals, each protected subprogram needs a unique set
5069 -- of privals, since they must refer to renamings of components of a
5070 -- formal parameter of that operation. Entry bodies need another set,
5071 -- which they all share and which is associated with renamings in the
5072 -- Service_Entries procedure for the protected type (this is not yet
5073 -- implemented???). This means that we must associate a new set of
5074 -- privals (and discriminals) with the private declarations after
5075 -- the body of a protected subprogram is processed.
5077 -- The last complication is the presence of discriminants and discriminated
5078 -- components. In the corresponding record, the components are constrained
5079 -- by the discriminants of the record, but within each protected operation
5080 -- they are constrained by the discriminants of the actual. The actual
5081 -- subtypes of those components are constructed as for other unconstrained
5082 -- formals, but the privals are created before the formal object is added
5083 -- to the parameter list of the protected operation, so they carry the
5084 -- nominal subtype of the original component. After the protected operation
5085 -- is actually created (in the expansion of the protected body) we must
5086 -- patch the types of each prival occurrence with the proper actual subtype
5087 -- which is by now set. The Privals_Chain is used for this patching.
5089 -------------------
5090 -- Type Synonyms --
5091 -------------------
5093 -- The following type synonyms are used to tidy up the function and
5094 -- procedure declarations that follow, and also to make it possible
5095 -- to meet the requirement for the XEINFO utility that all function
5096 -- specs must fit on a single source line.
5098 subtype B is Boolean;
5099 subtype C is Component_Alignment_Kind;
5100 subtype E is Entity_Id;
5101 subtype M is Mechanism_Type;
5102 subtype N is Node_Id;
5103 subtype U is Uint;
5104 subtype R is Ureal;
5105 subtype L is Elist_Id;
5106 subtype S is List_Id;
5108 --------------------------------
5109 -- Attribute Access Functions --
5110 --------------------------------
5112 -- All attributes are manipulated through a procedural interface. This
5113 -- section contains the functions used to obtain attribute values which
5114 -- correspond to values in fields or flags in the entity itself.
5116 function Abstract_Interfaces (Id : E) return L;
5117 function Accept_Address (Id : E) return L;
5118 function Access_Disp_Table (Id : E) return L;
5119 function Actual_Subtype (Id : E) return E;
5120 function Address_Taken (Id : E) return B;
5121 function Alias (Id : E) return E;
5122 function Abstract_Interface_Alias (Id : E) return E;
5123 function Alignment (Id : E) return U;
5124 function Associated_Final_Chain (Id : E) return E;
5125 function Associated_Formal_Package (Id : E) return E;
5126 function Associated_Node_For_Itype (Id : E) return N;
5127 function Associated_Storage_Pool (Id : E) return E;
5128 function Barrier_Function (Id : E) return N;
5129 function Block_Node (Id : E) return N;
5130 function Body_Entity (Id : E) return E;
5131 function Body_Needed_For_SAL (Id : E) return B;
5132 function CR_Discriminant (Id : E) return E;
5133 function C_Pass_By_Copy (Id : E) return B;
5134 function Can_Never_Be_Null (Id : E) return B;
5135 function Checks_May_Be_Suppressed (Id : E) return B;
5136 function Class_Wide_Type (Id : E) return E;
5137 function Cloned_Subtype (Id : E) return E;
5138 function Component_Alignment (Id : E) return C;
5139 function Component_Clause (Id : E) return N;
5140 function Component_Bit_Offset (Id : E) return U;
5141 function Component_Size (Id : E) return U;
5142 function Component_Type (Id : E) return E;
5143 function Corresponding_Concurrent_Type (Id : E) return E;
5144 function Corresponding_Discriminant (Id : E) return E;
5145 function Corresponding_Equality (Id : E) return E;
5146 function Corresponding_Record_Type (Id : E) return E;
5147 function Corresponding_Remote_Type (Id : E) return E;
5148 function Current_Value (Id : E) return N;
5149 function Debug_Info_Off (Id : E) return B;
5150 function Debug_Renaming_Link (Id : E) return E;
5151 function DTC_Entity (Id : E) return E;
5152 function DT_Entry_Count (Id : E) return U;
5153 function DT_Position (Id : E) return U;
5154 function Default_Expr_Function (Id : E) return E;
5155 function Default_Expressions_Processed (Id : E) return B;
5156 function Default_Value (Id : E) return N;
5157 function Delay_Cleanups (Id : E) return B;
5158 function Delay_Subprogram_Descriptors (Id : E) return B;
5159 function Delta_Value (Id : E) return R;
5160 function Dependent_Instances (Id : E) return L;
5161 function Depends_On_Private (Id : E) return B;
5162 function Digits_Value (Id : E) return U;
5163 function Directly_Designated_Type (Id : E) return E;
5164 function Discard_Names (Id : E) return B;
5165 function Discriminal (Id : E) return E;
5166 function Discriminal_Link (Id : E) return E;
5167 function Discriminant_Checking_Func (Id : E) return E;
5168 function Discriminant_Constraint (Id : E) return L;
5169 function Discriminant_Default_Value (Id : E) return N;
5170 function Discriminant_Number (Id : E) return U;
5171 function Elaborate_All_Desirable (Id : E) return B;
5172 function Elaboration_Entity (Id : E) return E;
5173 function Elaboration_Entity_Required (Id : E) return B;
5174 function Enclosing_Scope (Id : E) return E;
5175 function Entry_Accepted (Id : E) return B;
5176 function Entry_Bodies_Array (Id : E) return E;
5177 function Entry_Cancel_Parameter (Id : E) return E;
5178 function Entry_Component (Id : E) return E;
5179 function Entry_Formal (Id : E) return E;
5180 function Entry_Index_Constant (Id : E) return E;
5181 function Entry_Index_Type (Id : E) return E;
5182 function Entry_Parameters_Type (Id : E) return E;
5183 function Enum_Pos_To_Rep (Id : E) return E;
5184 function Enumeration_Pos (Id : E) return U;
5185 function Enumeration_Rep (Id : E) return U;
5186 function Enumeration_Rep_Expr (Id : E) return N;
5187 function Equivalent_Type (Id : E) return E;
5188 function Esize (Id : E) return U;
5189 function Exception_Code (Id : E) return U;
5190 function Extra_Accessibility (Id : E) return E;
5191 function Extra_Constrained (Id : E) return E;
5192 function Extra_Formal (Id : E) return E;
5193 function Finalization_Chain_Entity (Id : E) return E;
5194 function Finalize_Storage_Only (Id : E) return B;
5195 function First_Entity (Id : E) return E;
5196 function First_Index (Id : E) return N;
5197 function First_Literal (Id : E) return E;
5198 function First_Optional_Parameter (Id : E) return E;
5199 function First_Private_Entity (Id : E) return E;
5200 function First_Rep_Item (Id : E) return N;
5201 function Freeze_Node (Id : E) return N;
5202 function From_With_Type (Id : E) return B;
5203 function Full_View (Id : E) return E;
5204 function Function_Returns_With_DSP (Id : E) return B;
5205 function Generic_Homonym (Id : E) return E;
5206 function Generic_Renamings (Id : E) return L;
5207 function Handler_Records (Id : E) return S;
5208 function Has_Aliased_Components (Id : E) return B;
5209 function Has_Alignment_Clause (Id : E) return B;
5210 function Has_All_Calls_Remote (Id : E) return B;
5211 function Has_Atomic_Components (Id : E) return B;
5212 function Has_Biased_Representation (Id : E) return B;
5213 function Has_Completion (Id : E) return B;
5214 function Has_Completion_In_Body (Id : E) return B;
5215 function Has_Complex_Representation (Id : E) return B;
5216 function Has_Component_Size_Clause (Id : E) return B;
5217 function Has_Constrained_Partial_View (Id : E) return B;
5218 function Has_Contiguous_Rep (Id : E) return B;
5219 function Has_Controlled_Component (Id : E) return B;
5220 function Has_Controlling_Result (Id : E) return B;
5221 function Has_Convention_Pragma (Id : E) return B;
5222 function Has_Delayed_Freeze (Id : E) return B;
5223 function Has_Discriminants (Id : E) return B;
5224 function Has_Enumeration_Rep_Clause (Id : E) return B;
5225 function Has_Exit (Id : E) return B;
5226 function Has_External_Tag_Rep_Clause (Id : E) return B;
5227 function Has_Fully_Qualified_Name (Id : E) return B;
5228 function Has_Gigi_Rep_Item (Id : E) return B;
5229 function Has_Homonym (Id : E) return B;
5230 function Has_Interrupt_Handler (Id : E) return B;
5231 function Has_Machine_Radix_Clause (Id : E) return B;
5232 function Has_Master_Entity (Id : E) return B;
5233 function Has_Missing_Return (Id : E) return B;
5234 function Has_Nested_Block_With_Handler (Id : E) return B;
5235 function Has_Forward_Instantiation (Id : E) return B;
5236 function Has_Non_Standard_Rep (Id : E) return B;
5237 function Has_Object_Size_Clause (Id : E) return B;
5238 function Has_Per_Object_Constraint (Id : E) return B;
5239 function Has_Persistent_BSS (Id : E) return B;
5240 function Has_Pragma_Controlled (Id : E) return B;
5241 function Has_Pragma_Elaborate_Body (Id : E) return B;
5242 function Has_Pragma_Inline (Id : E) return B;
5243 function Has_Pragma_Pack (Id : E) return B;
5244 function Has_Pragma_Pure_Function (Id : E) return B;
5245 function Has_Pragma_Unreferenced (Id : E) return B;
5246 function Has_Primitive_Operations (Id : E) return B;
5247 function Has_Qualified_Name (Id : E) return B;
5248 function Has_Record_Rep_Clause (Id : E) return B;
5249 function Has_Recursive_Call (Id : E) return B;
5250 function Has_Size_Clause (Id : E) return B;
5251 function Has_Small_Clause (Id : E) return B;
5252 function Has_Specified_Layout (Id : E) return B;
5253 function Has_Specified_Stream_Input (Id : E) return B;
5254 function Has_Specified_Stream_Output (Id : E) return B;
5255 function Has_Specified_Stream_Read (Id : E) return B;
5256 function Has_Specified_Stream_Write (Id : E) return B;
5257 function Has_Storage_Size_Clause (Id : E) return B;
5258 function Has_Stream_Size_Clause (Id : E) return B;
5259 function Has_Subprogram_Descriptor (Id : E) return B;
5260 function Has_Task (Id : E) return B;
5261 function Has_Unchecked_Union (Id : E) return B;
5262 function Has_Unknown_Discriminants (Id : E) return B;
5263 function Has_Volatile_Components (Id : E) return B;
5264 function Has_Xref_Entry (Id : E) return B;
5265 function Hiding_Loop_Variable (Id : E) return E;
5266 function Homonym (Id : E) return E;
5267 function In_Package_Body (Id : E) return B;
5268 function In_Private_Part (Id : E) return B;
5269 function In_Use (Id : E) return B;
5270 function Inner_Instances (Id : E) return L;
5271 function Interface_Name (Id : E) return N;
5272 function Is_AST_Entry (Id : E) return B;
5273 function Is_Abstract (Id : E) return B;
5274 function Is_Local_Anonymous_Access (Id : E) return B;
5275 function Is_Access_Constant (Id : E) return B;
5276 function Is_Ada_2005 (Id : E) return B;
5277 function Is_Aliased (Id : E) return B;
5278 function Is_Asynchronous (Id : E) return B;
5279 function Is_Atomic (Id : E) return B;
5280 function Is_Bit_Packed_Array (Id : E) return B;
5281 function Is_CPP_Class (Id : E) return B;
5282 function Is_Called (Id : E) return B;
5283 function Is_Character_Type (Id : E) return B;
5284 function Is_Child_Unit (Id : E) return B;
5285 function Is_Class_Wide_Equivalent_Type (Id : E) return B;
5286 function Is_Compilation_Unit (Id : E) return B;
5287 function Is_Completely_Hidden (Id : E) return B;
5288 function Is_Constr_Subt_For_UN_Aliased (Id : E) return B;
5289 function Is_Constr_Subt_For_U_Nominal (Id : E) return B;
5290 function Is_Constrained (Id : E) return B;
5291 function Is_Constructor (Id : E) return B;
5292 function Is_Controlled (Id : E) return B;
5293 function Is_Controlling_Formal (Id : E) return B;
5294 function Is_Discrim_SO_Function (Id : E) return B;
5295 function Is_Dispatching_Operation (Id : E) return B;
5296 function Is_Eliminated (Id : E) return B;
5297 function Is_Entry_Formal (Id : E) return B;
5298 function Is_Exported (Id : E) return B;
5299 function Is_First_Subtype (Id : E) return B;
5300 function Is_For_Access_Subtype (Id : E) return B;
5301 function Is_Frozen (Id : E) return B;
5302 function Is_Generic_Instance (Id : E) return B;
5303 function Is_Hidden (Id : E) return B;
5304 function Is_Hidden_Open_Scope (Id : E) return B;
5305 function Is_Immediately_Visible (Id : E) return B;
5306 function Is_Imported (Id : E) return B;
5307 function Is_Inlined (Id : E) return B;
5308 function Is_Interface (Id : E) return B;
5309 function Is_Instantiated (Id : E) return B;
5310 function Is_Internal (Id : E) return B;
5311 function Is_Interrupt_Handler (Id : E) return B;
5312 function Is_Intrinsic_Subprogram (Id : E) return B;
5313 function Is_Itype (Id : E) return B;
5314 function Is_Known_Non_Null (Id : E) return B;
5315 function Is_Known_Valid (Id : E) return B;
5316 function Is_Limited_Composite (Id : E) return B;
5317 function Is_Machine_Code_Subprogram (Id : E) return B;
5318 function Is_Non_Static_Subtype (Id : E) return B;
5319 function Is_Null_Init_Proc (Id : E) return B;
5320 function Is_Obsolescent (Id : E) return B;
5321 function Is_Optional_Parameter (Id : E) return B;
5322 function Is_Package_Body_Entity (Id : E) return B;
5323 function Is_Packed (Id : E) return B;
5324 function Is_Packed_Array_Type (Id : E) return B;
5325 function Is_Potentially_Use_Visible (Id : E) return B;
5326 function Is_Preelaborated (Id : E) return B;
5327 function Is_Primitive_Wrapper (Id : E) return B;
5329 function Is_Private_Composite (Id : E) return B;
5330 function Is_Private_Descendant (Id : E) return B;
5331 function Is_Public (Id : E) return B;
5332 function Is_Pure (Id : E) return B;
5333 function Is_Pure_Unit_Access_Type (Id : E) return B;
5334 function Is_Remote_Call_Interface (Id : E) return B;
5335 function Is_Remote_Types (Id : E) return B;
5336 function Is_Renaming_Of_Object (Id : E) return B;
5337 function Is_Shared_Passive (Id : E) return B;
5338 function Is_Statically_Allocated (Id : E) return B;
5339 function Is_Tag (Id : E) return B;
5340 function Is_Tagged_Type (Id : E) return B;
5341 function Is_Thread_Body (Id : E) return B;
5342 function Is_True_Constant (Id : E) return B;
5343 function Is_Unchecked_Union (Id : E) return B;
5344 function Is_Unsigned_Type (Id : E) return B;
5345 function Is_VMS_Exception (Id : E) return B;
5346 function Is_Valued_Procedure (Id : E) return B;
5347 function Is_Visible_Child_Unit (Id : E) return B;
5348 function Is_Volatile (Id : E) return B;
5349 function Is_Wrapper_Package (Id : E) return B;
5350 function Kill_Elaboration_Checks (Id : E) return B;
5351 function Kill_Range_Checks (Id : E) return B;
5352 function Kill_Tag_Checks (Id : E) return B;
5353 function Last_Entity (Id : E) return E;
5354 function Limited_View (Id : E) return E;
5355 function Lit_Indexes (Id : E) return E;
5356 function Lit_Strings (Id : E) return E;
5357 function Machine_Radix_10 (Id : E) return B;
5358 function Master_Id (Id : E) return E;
5359 function Materialize_Entity (Id : E) return B;
5360 function Mechanism (Id : E) return M;
5361 function Modulus (Id : E) return U;
5362 function Must_Be_On_Byte_Boundary (Id : E) return B;
5363 function Needs_Debug_Info (Id : E) return B;
5364 function Needs_No_Actuals (Id : E) return B;
5365 function Never_Set_In_Source (Id : E) return B;
5366 function Next_Inlined_Subprogram (Id : E) return E;
5367 function No_Pool_Assigned (Id : E) return B;
5368 function No_Return (Id : E) return B;
5369 function No_Strict_Aliasing (Id : E) return B;
5370 function Non_Binary_Modulus (Id : E) return B;
5371 function Non_Limited_View (Id : E) return E;
5372 function Nonzero_Is_True (Id : E) return B;
5373 function Normalized_First_Bit (Id : E) return U;
5374 function Normalized_Position (Id : E) return U;
5375 function Normalized_Position_Max (Id : E) return U;
5376 function Object_Ref (Id : E) return E;
5377 function Obsolescent_Warning (Id : E) return N;
5378 function Original_Access_Type (Id : E) return E;
5379 function Original_Array_Type (Id : E) return E;
5380 function Original_Record_Component (Id : E) return E;
5381 function Overridden_Operation (Id : E) return E;
5382 function Packed_Array_Type (Id : E) return E;
5383 function Parent_Subtype (Id : E) return E;
5384 function Primitive_Operations (Id : E) return L;
5385 function Prival (Id : E) return E;
5386 function Privals_Chain (Id : E) return L;
5387 function Private_Dependents (Id : E) return L;
5388 function Private_View (Id : E) return N;
5389 function Protected_Body_Subprogram (Id : E) return E;
5390 function Protected_Formal (Id : E) return E;
5391 function Protected_Operation (Id : E) return E;
5392 function RM_Size (Id : E) return U;
5393 function Reachable (Id : E) return B;
5394 function Referenced (Id : E) return B;
5395 function Referenced_As_LHS (Id : E) return B;
5396 function Referenced_Object (Id : E) return N;
5397 function Register_Exception_Call (Id : E) return N;
5398 function Related_Array_Object (Id : E) return E;
5399 function Related_Instance (Id : E) return E;
5400 function Renamed_Entity (Id : E) return N;
5401 function Renamed_Object (Id : E) return N;
5402 function Renaming_Map (Id : E) return U;
5403 function Return_Present (Id : E) return B;
5404 function Returns_By_Ref (Id : E) return B;
5405 function Reverse_Bit_Order (Id : E) return B;
5406 function Scalar_Range (Id : E) return N;
5407 function Scale_Value (Id : E) return U;
5408 function Scope_Depth_Value (Id : E) return U;
5409 function Sec_Stack_Needed_For_Return (Id : E) return B;
5410 function Shadow_Entities (Id : E) return S;
5411 function Shared_Var_Assign_Proc (Id : E) return E;
5412 function Shared_Var_Read_Proc (Id : E) return E;
5413 function Size_Check_Code (Id : E) return N;
5414 function Size_Known_At_Compile_Time (Id : E) return B;
5415 function Size_Depends_On_Discriminant (Id : E) return B;
5416 function Small_Value (Id : E) return R;
5417 function Spec_Entity (Id : E) return E;
5418 function Storage_Size_Variable (Id : E) return E;
5419 function Stored_Constraint (Id : E) return L;
5420 function Strict_Alignment (Id : E) return B;
5421 function String_Literal_Length (Id : E) return U;
5422 function String_Literal_Low_Bound (Id : E) return N;
5423 function Suppress_Elaboration_Warnings (Id : E) return B;
5424 function Suppress_Init_Proc (Id : E) return B;
5425 function Suppress_Style_Checks (Id : E) return B;
5426 function Task_Body_Procedure (Id : E) return N;
5427 function Treat_As_Volatile (Id : E) return B;
5428 function Underlying_Full_View (Id : E) return E;
5429 function Unset_Reference (Id : E) return N;
5430 function Uses_Sec_Stack (Id : E) return B;
5431 function Vax_Float (Id : E) return B;
5432 function Warnings_Off (Id : E) return B;
5433 function Was_Hidden (Id : E) return B;
5434 function Wrapped_Entity (Id : E) return E;
5436 -------------------------------
5437 -- Classification Attributes --
5438 -------------------------------
5440 -- These functions provide a convenient functional notation for testing
5441 -- whether an Ekind value belongs to a specified kind, for example the
5442 -- function Is_Elementary_Type tests if its argument is in Elementary_Kind.
5443 -- In some cases, the test is of an entity attribute (e.g. in the case of
5444 -- Is_Generic_Type where the Ekind does not provide the needed information)
5446 function Is_Access_Type (Id : E) return B;
5447 function Is_Array_Type (Id : E) return B;
5448 function Is_Class_Wide_Type (Id : E) return B;
5449 function Is_Composite_Type (Id : E) return B;
5450 function Is_Concurrent_Body (Id : E) return B;
5451 function Is_Concurrent_Record_Type (Id : E) return B;
5452 function Is_Concurrent_Type (Id : E) return B;
5453 function Is_Decimal_Fixed_Point_Type (Id : E) return B;
5454 function Is_Digits_Type (Id : E) return B;
5455 function Is_Discrete_Or_Fixed_Point_Type (Id : E) return B;
5456 function Is_Discrete_Type (Id : E) return B;
5457 function Is_Elementary_Type (Id : E) return B;
5458 function Is_Entry (Id : E) return B;
5459 function Is_Enumeration_Type (Id : E) return B;
5460 function Is_Fixed_Point_Type (Id : E) return B;
5461 function Is_Floating_Point_Type (Id : E) return B;
5462 function Is_Formal (Id : E) return B;
5463 function Is_Formal_Subprogram (Id : E) return B;
5464 function Is_Generic_Actual_Type (Id : E) return B;
5465 function Is_Generic_Unit (Id : E) return B;
5466 function Is_Generic_Type (Id : E) return B;
5467 function Is_Generic_Subprogram (Id : E) return B;
5468 function Is_Incomplete_Or_Private_Type (Id : E) return B;
5469 function Is_Integer_Type (Id : E) return B;
5470 function Is_Limited_Record (Id : E) return B;
5471 function Is_Modular_Integer_Type (Id : E) return B;
5472 function Is_Named_Number (Id : E) return B;
5473 function Is_Numeric_Type (Id : E) return B;
5474 function Is_Object (Id : E) return B;
5475 function Is_Ordinary_Fixed_Point_Type (Id : E) return B;
5476 function Is_Overloadable (Id : E) return B;
5477 function Is_Overriding_Operation (Id : E) return B;
5478 function Is_Private_Type (Id : E) return B;
5479 function Is_Protected_Type (Id : E) return B;
5480 function Is_Real_Type (Id : E) return B;
5481 function Is_Record_Type (Id : E) return B;
5482 function Is_Scalar_Type (Id : E) return B;
5483 function Is_Signed_Integer_Type (Id : E) return B;
5484 function Is_Subprogram (Id : E) return B;
5485 function Is_Task_Type (Id : E) return B;
5486 function Is_Type (Id : E) return B;
5488 -------------------------------------
5489 -- Synthesized Attribute Functions --
5490 -------------------------------------
5492 -- The functions in this section synthesize attributes from the tree,
5493 -- so they do not correspond to defined fields in the entity itself.
5495 function Address_Clause (Id : E) return N;
5496 function Alignment_Clause (Id : E) return N;
5497 function Ancestor_Subtype (Id : E) return E;
5498 function Base_Type (Id : E) return E;
5499 function Constant_Value (Id : E) return N;
5500 function Declaration_Node (Id : E) return N;
5501 function Designated_Type (Id : E) return E;
5502 function Enclosing_Dynamic_Scope (Id : E) return E;
5503 function First_Component (Id : E) return E;
5504 function First_Discriminant (Id : E) return E;
5505 function First_Formal (Id : E) return E;
5506 function First_Stored_Discriminant (Id : E) return E;
5507 function First_Subtype (Id : E) return E;
5508 function Has_Attach_Handler (Id : E) return B;
5509 function Has_Entries (Id : E) return B;
5510 function Has_Foreign_Convention (Id : E) return B;
5511 function Has_Private_Ancestor (Id : E) return B;
5512 function Has_Private_Declaration (Id : E) return B;
5513 function Implementation_Base_Type (Id : E) return E;
5514 function Is_Always_Inlined (Id : E) return B;
5515 function Is_Boolean_Type (Id : E) return B;
5516 function Is_By_Copy_Type (Id : E) return B;
5517 function Is_By_Reference_Type (Id : E) return B;
5518 function Is_Derived_Type (Id : E) return B;
5519 function Is_Dynamic_Scope (Id : E) return B;
5520 function Is_Indefinite_Subtype (Id : E) return B;
5521 function Is_Limited_Type (Id : E) return B;
5522 function Is_Package (Id : E) return B;
5523 function Is_Protected_Private (Id : E) return B;
5524 function Is_Protected_Record_Type (Id : E) return B;
5525 function Is_Return_By_Reference_Type (Id : E) return B;
5526 function Is_String_Type (Id : E) return B;
5527 function Is_Task_Record_Type (Id : E) return B;
5528 function Next_Component (Id : E) return E;
5529 function Next_Discriminant (Id : E) return E;
5530 function Next_Formal (Id : E) return E;
5531 function Next_Formal_With_Extras (Id : E) return E;
5532 function Next_Literal (Id : E) return E;
5533 function Next_Stored_Discriminant (Id : E) return E;
5534 function Number_Dimensions (Id : E) return Pos;
5535 function Number_Discriminants (Id : E) return Pos;
5536 function Number_Entries (Id : E) return Nat;
5537 function Number_Formals (Id : E) return Pos;
5538 function Parameter_Mode (Id : E) return Formal_Kind;
5539 function Root_Type (Id : E) return E;
5540 function Scope_Depth_Set (Id : E) return B;
5541 function Size_Clause (Id : E) return N;
5542 function Stream_Size_Clause (Id : E) return N;
5543 function First_Tag_Component (Id : E) return E;
5544 function Next_Tag_Component (Id : E) return E;
5545 function Type_High_Bound (Id : E) return N;
5546 function Type_Low_Bound (Id : E) return N;
5547 function Underlying_Type (Id : E) return E;
5549 ----------------------------------------------
5550 -- Type Representation Attribute Predicates --
5551 ----------------------------------------------
5553 -- These predicates test the setting of the indicated attribute. If
5554 -- the value has been set, then Known is True, and Unknown is False.
5555 -- If no value is set, then Known is False and Unknown is True. The
5556 -- Known_Static predicate is true only if the value is set (Known)
5557 -- and is set to a compile time known value. Note that in the case
5558 -- of Alignment and Normalized_First_Bit, dynamic values are not
5559 -- possible, so we do not need a separate Known_Static calls in
5560 -- these cases. The not set (unknown values are as follows:
5562 -- Alignment Uint_0 or No_Uint
5563 -- Component_Size Uint_0 or No_Uint
5564 -- Component_Bit_Offset No_Uint
5565 -- Digits_Value Uint_0 or No_Uint
5566 -- Esize Uint_0 or No_Uint
5567 -- Normalized_First_Bit No_Uint
5568 -- Normalized_Position No_Uint
5569 -- Normalized_Position_Max No_Uint
5570 -- RM_Size Uint_0 or No_Uint
5572 -- It would be cleaner to use No_Uint in all these cases, but historically
5573 -- we chose to use Uint_0 at first, and the change over will take time ???
5574 -- This is particularly true for the RM_Size field, where a value of zero
5575 -- is legitimate. We deal with this by a nasty kludge that knows that the
5576 -- value is always known static for discrete types (and no other types can
5577 -- have an RM_Size value of zero).
5579 function Known_Alignment (E : Entity_Id) return B;
5580 function Known_Component_Bit_Offset (E : Entity_Id) return B;
5581 function Known_Component_Size (E : Entity_Id) return B;
5582 function Known_Esize (E : Entity_Id) return B;
5583 function Known_Normalized_First_Bit (E : Entity_Id) return B;
5584 function Known_Normalized_Position (E : Entity_Id) return B;
5585 function Known_Normalized_Position_Max (E : Entity_Id) return B;
5586 function Known_RM_Size (E : Entity_Id) return B;
5588 function Known_Static_Component_Bit_Offset (E : Entity_Id) return B;
5589 function Known_Static_Component_Size (E : Entity_Id) return B;
5590 function Known_Static_Esize (E : Entity_Id) return B;
5591 function Known_Static_Normalized_First_Bit (E : Entity_Id) return B;
5592 function Known_Static_Normalized_Position (E : Entity_Id) return B;
5593 function Known_Static_Normalized_Position_Max (E : Entity_Id) return B;
5594 function Known_Static_RM_Size (E : Entity_Id) return B;
5596 function Unknown_Alignment (E : Entity_Id) return B;
5597 function Unknown_Component_Bit_Offset (E : Entity_Id) return B;
5598 function Unknown_Component_Size (E : Entity_Id) return B;
5599 function Unknown_Esize (E : Entity_Id) return B;
5600 function Unknown_Normalized_First_Bit (E : Entity_Id) return B;
5601 function Unknown_Normalized_Position (E : Entity_Id) return B;
5602 function Unknown_Normalized_Position_Max (E : Entity_Id) return B;
5603 function Unknown_RM_Size (E : Entity_Id) return B;
5605 ------------------------------
5606 -- Attribute Set Procedures --
5607 ------------------------------
5609 procedure Set_Abstract_Interfaces (Id : E; V : L);
5610 procedure Set_Accept_Address (Id : E; V : L);
5611 procedure Set_Access_Disp_Table (Id : E; V : L);
5612 procedure Set_Actual_Subtype (Id : E; V : E);
5613 procedure Set_Address_Taken (Id : E; V : B := True);
5614 procedure Set_Alias (Id : E; V : E);
5615 procedure Set_Abstract_Interface_Alias (Id : E; V : E);
5616 procedure Set_Alignment (Id : E; V : U);
5617 procedure Set_Associated_Final_Chain (Id : E; V : E);
5618 procedure Set_Associated_Formal_Package (Id : E; V : E);
5619 procedure Set_Associated_Node_For_Itype (Id : E; V : N);
5620 procedure Set_Associated_Storage_Pool (Id : E; V : E);
5621 procedure Set_Barrier_Function (Id : E; V : N);
5622 procedure Set_Block_Node (Id : E; V : N);
5623 procedure Set_Body_Entity (Id : E; V : E);
5624 procedure Set_Body_Needed_For_SAL (Id : E; V : B := True);
5625 procedure Set_CR_Discriminant (Id : E; V : E);
5626 procedure Set_C_Pass_By_Copy (Id : E; V : B := True);
5627 procedure Set_Can_Never_Be_Null (Id : E; V : B := True);
5628 procedure Set_Checks_May_Be_Suppressed (Id : E; V : B := True);
5629 procedure Set_Class_Wide_Type (Id : E; V : E);
5630 procedure Set_Cloned_Subtype (Id : E; V : E);
5631 procedure Set_Component_Alignment (Id : E; V : C);
5632 procedure Set_Component_Bit_Offset (Id : E; V : U);
5633 procedure Set_Component_Clause (Id : E; V : N);
5634 procedure Set_Component_Size (Id : E; V : U);
5635 procedure Set_Component_Type (Id : E; V : E);
5636 procedure Set_Corresponding_Concurrent_Type (Id : E; V : E);
5637 procedure Set_Corresponding_Discriminant (Id : E; V : E);
5638 procedure Set_Corresponding_Equality (Id : E; V : E);
5639 procedure Set_Corresponding_Record_Type (Id : E; V : E);
5640 procedure Set_Corresponding_Remote_Type (Id : E; V : E);
5641 procedure Set_Current_Value (Id : E; V : N);
5642 procedure Set_Debug_Info_Off (Id : E; V : B := True);
5643 procedure Set_Debug_Renaming_Link (Id : E; V : E);
5644 procedure Set_DTC_Entity (Id : E; V : E);
5645 procedure Set_DT_Entry_Count (Id : E; V : U);
5646 procedure Set_DT_Position (Id : E; V : U);
5647 procedure Set_Default_Expr_Function (Id : E; V : E);
5648 procedure Set_Default_Expressions_Processed (Id : E; V : B := True);
5649 procedure Set_Default_Value (Id : E; V : N);
5650 procedure Set_Delay_Cleanups (Id : E; V : B := True);
5651 procedure Set_Delay_Subprogram_Descriptors (Id : E; V : B := True);
5652 procedure Set_Delta_Value (Id : E; V : R);
5653 procedure Set_Dependent_Instances (Id : E; V : L);
5654 procedure Set_Depends_On_Private (Id : E; V : B := True);
5655 procedure Set_Digits_Value (Id : E; V : U);
5656 procedure Set_Directly_Designated_Type (Id : E; V : E);
5657 procedure Set_Discard_Names (Id : E; V : B := True);
5658 procedure Set_Discriminal (Id : E; V : E);
5659 procedure Set_Discriminal_Link (Id : E; V : E);
5660 procedure Set_Discriminant_Checking_Func (Id : E; V : E);
5661 procedure Set_Discriminant_Constraint (Id : E; V : L);
5662 procedure Set_Discriminant_Default_Value (Id : E; V : N);
5663 procedure Set_Discriminant_Number (Id : E; V : U);
5664 procedure Set_Elaborate_All_Desirable (Id : E; V : B := True);
5665 procedure Set_Elaboration_Entity (Id : E; V : E);
5666 procedure Set_Elaboration_Entity_Required (Id : E; V : B := True);
5667 procedure Set_Enclosing_Scope (Id : E; V : E);
5668 procedure Set_Entry_Accepted (Id : E; V : B := True);
5669 procedure Set_Entry_Bodies_Array (Id : E; V : E);
5670 procedure Set_Entry_Cancel_Parameter (Id : E; V : E);
5671 procedure Set_Entry_Component (Id : E; V : E);
5672 procedure Set_Entry_Formal (Id : E; V : E);
5673 procedure Set_Entry_Index_Constant (Id : E; V : E);
5674 procedure Set_Entry_Parameters_Type (Id : E; V : E);
5675 procedure Set_Enum_Pos_To_Rep (Id : E; V : E);
5676 procedure Set_Enumeration_Pos (Id : E; V : U);
5677 procedure Set_Enumeration_Rep (Id : E; V : U);
5678 procedure Set_Enumeration_Rep_Expr (Id : E; V : N);
5679 procedure Set_Equivalent_Type (Id : E; V : E);
5680 procedure Set_Esize (Id : E; V : U);
5681 procedure Set_Exception_Code (Id : E; V : U);
5682 procedure Set_Extra_Accessibility (Id : E; V : E);
5683 procedure Set_Extra_Constrained (Id : E; V : E);
5684 procedure Set_Extra_Formal (Id : E; V : E);
5685 procedure Set_Finalization_Chain_Entity (Id : E; V : E);
5686 procedure Set_Finalize_Storage_Only (Id : E; V : B := True);
5687 procedure Set_First_Entity (Id : E; V : E);
5688 procedure Set_First_Index (Id : E; V : N);
5689 procedure Set_First_Literal (Id : E; V : E);
5690 procedure Set_First_Optional_Parameter (Id : E; V : E);
5691 procedure Set_First_Private_Entity (Id : E; V : E);
5692 procedure Set_First_Rep_Item (Id : E; V : N);
5693 procedure Set_Freeze_Node (Id : E; V : N);
5694 procedure Set_From_With_Type (Id : E; V : B := True);
5695 procedure Set_Full_View (Id : E; V : E);
5696 procedure Set_Function_Returns_With_DSP (Id : E; V : B := True);
5697 procedure Set_Generic_Homonym (Id : E; V : E);
5698 procedure Set_Generic_Renamings (Id : E; V : L);
5699 procedure Set_Handler_Records (Id : E; V : S);
5700 procedure Set_Has_Aliased_Components (Id : E; V : B := True);
5701 procedure Set_Has_Alignment_Clause (Id : E; V : B := True);
5702 procedure Set_Has_All_Calls_Remote (Id : E; V : B := True);
5703 procedure Set_Has_Atomic_Components (Id : E; V : B := True);
5704 procedure Set_Has_Biased_Representation (Id : E; V : B := True);
5705 procedure Set_Has_Completion (Id : E; V : B := True);
5706 procedure Set_Has_Completion_In_Body (Id : E; V : B := True);
5707 procedure Set_Has_Complex_Representation (Id : E; V : B := True);
5708 procedure Set_Has_Component_Size_Clause (Id : E; V : B := True);
5709 procedure Set_Has_Constrained_Partial_View (Id : E; V : B := True);
5710 procedure Set_Has_Contiguous_Rep (Id : E; V : B := True);
5711 procedure Set_Has_Controlled_Component (Id : E; V : B := True);
5712 procedure Set_Has_Controlling_Result (Id : E; V : B := True);
5713 procedure Set_Has_Convention_Pragma (Id : E; V : B := True);
5714 procedure Set_Has_Delayed_Freeze (Id : E; V : B := True);
5715 procedure Set_Has_Discriminants (Id : E; V : B := True);
5716 procedure Set_Has_Enumeration_Rep_Clause (Id : E; V : B := True);
5717 procedure Set_Has_Exit (Id : E; V : B := True);
5718 procedure Set_Has_External_Tag_Rep_Clause (Id : E; V : B := True);
5719 procedure Set_Has_Fully_Qualified_Name (Id : E; V : B := True);
5720 procedure Set_Has_Gigi_Rep_Item (Id : E; V : B := True);
5721 procedure Set_Has_Homonym (Id : E; V : B := True);
5722 procedure Set_Has_Machine_Radix_Clause (Id : E; V : B := True);
5723 procedure Set_Has_Master_Entity (Id : E; V : B := True);
5724 procedure Set_Has_Missing_Return (Id : E; V : B := True);
5725 procedure Set_Has_Nested_Block_With_Handler (Id : E; V : B := True);
5726 procedure Set_Has_Forward_Instantiation (Id : E; V : B := True);
5727 procedure Set_Has_Non_Standard_Rep (Id : E; V : B := True);
5728 procedure Set_Has_Object_Size_Clause (Id : E; V : B := True);
5729 procedure Set_Has_Per_Object_Constraint (Id : E; V : B := True);
5730 procedure Set_Has_Persistent_BSS (Id : E; V : B := True);
5731 procedure Set_Has_Pragma_Controlled (Id : E; V : B := True);
5732 procedure Set_Has_Pragma_Elaborate_Body (Id : E; V : B := True);
5733 procedure Set_Has_Pragma_Inline (Id : E; V : B := True);
5734 procedure Set_Has_Pragma_Pack (Id : E; V : B := True);
5735 procedure Set_Has_Pragma_Pure_Function (Id : E; V : B := True);
5736 procedure Set_Has_Pragma_Unreferenced (Id : E; V : B := True);
5737 procedure Set_Has_Primitive_Operations (Id : E; V : B := True);
5738 procedure Set_Has_Private_Declaration (Id : E; V : B := True);
5739 procedure Set_Has_Qualified_Name (Id : E; V : B := True);
5740 procedure Set_Has_Record_Rep_Clause (Id : E; V : B := True);
5741 procedure Set_Has_Recursive_Call (Id : E; V : B := True);
5742 procedure Set_Has_Size_Clause (Id : E; V : B := True);
5743 procedure Set_Has_Small_Clause (Id : E; V : B := True);
5744 procedure Set_Has_Specified_Layout (Id : E; V : B := True);
5745 procedure Set_Has_Specified_Stream_Input (Id : E; V : B := True);
5746 procedure Set_Has_Specified_Stream_Output (Id : E; V : B := True);
5747 procedure Set_Has_Specified_Stream_Read (Id : E; V : B := True);
5748 procedure Set_Has_Specified_Stream_Write (Id : E; V : B := True);
5749 procedure Set_Has_Storage_Size_Clause (Id : E; V : B := True);
5750 procedure Set_Has_Stream_Size_Clause (Id : E; V : B := True);
5751 procedure Set_Has_Subprogram_Descriptor (Id : E; V : B := True);
5752 procedure Set_Has_Task (Id : E; V : B := True);
5753 procedure Set_Has_Unchecked_Union (Id : E; V : B := True);
5754 procedure Set_Has_Unknown_Discriminants (Id : E; V : B := True);
5755 procedure Set_Has_Volatile_Components (Id : E; V : B := True);
5756 procedure Set_Has_Xref_Entry (Id : E; V : B := True);
5757 procedure Set_Hiding_Loop_Variable (Id : E; V : E);
5758 procedure Set_Homonym (Id : E; V : E);
5759 procedure Set_In_Package_Body (Id : E; V : B := True);
5760 procedure Set_In_Private_Part (Id : E; V : B := True);
5761 procedure Set_In_Use (Id : E; V : B := True);
5762 procedure Set_Inner_Instances (Id : E; V : L);
5763 procedure Set_Interface_Name (Id : E; V : N);
5764 procedure Set_Is_AST_Entry (Id : E; V : B := True);
5765 procedure Set_Is_Abstract (Id : E; V : B := True);
5766 procedure Set_Is_Local_Anonymous_Access (Id : E; V : B := True);
5767 procedure Set_Is_Access_Constant (Id : E; V : B := True);
5768 procedure Set_Is_Ada_2005 (Id : E; V : B := True);
5769 procedure Set_Is_Aliased (Id : E; V : B := True);
5770 procedure Set_Is_Asynchronous (Id : E; V : B := True);
5771 procedure Set_Is_Atomic (Id : E; V : B := True);
5772 procedure Set_Is_Bit_Packed_Array (Id : E; V : B := True);
5773 procedure Set_Is_CPP_Class (Id : E; V : B := True);
5774 procedure Set_Is_Called (Id : E; V : B := True);
5775 procedure Set_Is_Character_Type (Id : E; V : B := True);
5776 procedure Set_Is_Child_Unit (Id : E; V : B := True);
5777 procedure Set_Is_Class_Wide_Equivalent_Type (Id : E; V : B := True);
5778 procedure Set_Is_Compilation_Unit (Id : E; V : B := True);
5779 procedure Set_Is_Completely_Hidden (Id : E; V : B := True);
5780 procedure Set_Is_Concurrent_Record_Type (Id : E; V : B := True);
5781 procedure Set_Is_Constr_Subt_For_UN_Aliased (Id : E; V : B := True);
5782 procedure Set_Is_Constr_Subt_For_U_Nominal (Id : E; V : B := True);
5783 procedure Set_Is_Constrained (Id : E; V : B := True);
5784 procedure Set_Is_Constructor (Id : E; V : B := True);
5785 procedure Set_Is_Controlled (Id : E; V : B := True);
5786 procedure Set_Is_Controlling_Formal (Id : E; V : B := True);
5787 procedure Set_Is_Discrim_SO_Function (Id : E; V : B := True);
5788 procedure Set_Is_Dispatching_Operation (Id : E; V : B := True);
5789 procedure Set_Is_Eliminated (Id : E; V : B := True);
5790 procedure Set_Is_Entry_Formal (Id : E; V : B := True);
5791 procedure Set_Is_Exported (Id : E; V : B := True);
5792 procedure Set_Is_First_Subtype (Id : E; V : B := True);
5793 procedure Set_Is_For_Access_Subtype (Id : E; V : B := True);
5794 procedure Set_Is_Formal_Subprogram (Id : E; V : B := True);
5795 procedure Set_Is_Frozen (Id : E; V : B := True);
5796 procedure Set_Is_Generic_Actual_Type (Id : E; V : B := True);
5797 procedure Set_Is_Generic_Instance (Id : E; V : B := True);
5798 procedure Set_Is_Generic_Type (Id : E; V : B := True);
5799 procedure Set_Is_Hidden (Id : E; V : B := True);
5800 procedure Set_Is_Hidden_Open_Scope (Id : E; V : B := True);
5801 procedure Set_Is_Immediately_Visible (Id : E; V : B := True);
5802 procedure Set_Is_Imported (Id : E; V : B := True);
5803 procedure Set_Is_Inlined (Id : E; V : B := True);
5804 procedure Set_Is_Interface (Id : E; V : B := True);
5805 procedure Set_Is_Instantiated (Id : E; V : B := True);
5806 procedure Set_Is_Internal (Id : E; V : B := True);
5807 procedure Set_Is_Interrupt_Handler (Id : E; V : B := True);
5808 procedure Set_Is_Intrinsic_Subprogram (Id : E; V : B := True);
5809 procedure Set_Is_Itype (Id : E; V : B := True);
5810 procedure Set_Is_Known_Non_Null (Id : E; V : B := True);
5811 procedure Set_Is_Known_Valid (Id : E; V : B := True);
5812 procedure Set_Is_Limited_Composite (Id : E; V : B := True);
5813 procedure Set_Is_Limited_Record (Id : E; V : B := True);
5814 procedure Set_Is_Machine_Code_Subprogram (Id : E; V : B := True);
5815 procedure Set_Is_Non_Static_Subtype (Id : E; V : B := True);
5816 procedure Set_Is_Null_Init_Proc (Id : E; V : B := True);
5817 procedure Set_Is_Obsolescent (Id : E; V : B := True);
5818 procedure Set_Is_Optional_Parameter (Id : E; V : B := True);
5819 procedure Set_Is_Overriding_Operation (Id : E; V : B := True);
5820 procedure Set_Is_Package_Body_Entity (Id : E; V : B := True);
5821 procedure Set_Is_Packed (Id : E; V : B := True);
5822 procedure Set_Is_Packed_Array_Type (Id : E; V : B := True);
5823 procedure Set_Is_Potentially_Use_Visible (Id : E; V : B := True);
5824 procedure Set_Is_Preelaborated (Id : E; V : B := True);
5825 procedure Set_Is_Primitive_Wrapper (Id : E; V : B := True);
5827 procedure Set_Is_Private_Composite (Id : E; V : B := True);
5828 procedure Set_Is_Private_Descendant (Id : E; V : B := True);
5829 procedure Set_Is_Public (Id : E; V : B := True);
5830 procedure Set_Is_Pure (Id : E; V : B := True);
5831 procedure Set_Is_Pure_Unit_Access_Type (Id : E; V : B := True);
5832 procedure Set_Is_Remote_Call_Interface (Id : E; V : B := True);
5833 procedure Set_Is_Remote_Types (Id : E; V : B := True);
5834 procedure Set_Is_Renaming_Of_Object (Id : E; V : B := True);
5835 procedure Set_Is_Shared_Passive (Id : E; V : B := True);
5836 procedure Set_Is_Statically_Allocated (Id : E; V : B := True);
5837 procedure Set_Is_Tag (Id : E; V : B := True);
5838 procedure Set_Is_Tagged_Type (Id : E; V : B := True);
5839 procedure Set_Is_Thread_Body (Id : E; V : B := True);
5840 procedure Set_Is_True_Constant (Id : E; V : B := True);
5841 procedure Set_Is_Unchecked_Union (Id : E; V : B := True);
5842 procedure Set_Is_Unsigned_Type (Id : E; V : B := True);
5843 procedure Set_Is_VMS_Exception (Id : E; V : B := True);
5844 procedure Set_Is_Valued_Procedure (Id : E; V : B := True);
5845 procedure Set_Is_Visible_Child_Unit (Id : E; V : B := True);
5846 procedure Set_Is_Volatile (Id : E; V : B := True);
5847 procedure Set_Kill_Elaboration_Checks (Id : E; V : B := True);
5848 procedure Set_Kill_Range_Checks (Id : E; V : B := True);
5849 procedure Set_Kill_Tag_Checks (Id : E; V : B := True);
5850 procedure Set_Last_Entity (Id : E; V : E);
5851 procedure Set_Limited_View (Id : E; V : E);
5852 procedure Set_Lit_Indexes (Id : E; V : E);
5853 procedure Set_Lit_Strings (Id : E; V : E);
5854 procedure Set_Machine_Radix_10 (Id : E; V : B := True);
5855 procedure Set_Master_Id (Id : E; V : E);
5856 procedure Set_Materialize_Entity (Id : E; V : B := True);
5857 procedure Set_Mechanism (Id : E; V : M);
5858 procedure Set_Modulus (Id : E; V : U);
5859 procedure Set_Must_Be_On_Byte_Boundary (Id : E; V : B := True);
5860 procedure Set_Needs_Debug_Info (Id : E; V : B := True);
5861 procedure Set_Needs_No_Actuals (Id : E; V : B := True);
5862 procedure Set_Never_Set_In_Source (Id : E; V : B := True);
5863 procedure Set_Next_Inlined_Subprogram (Id : E; V : E);
5864 procedure Set_No_Pool_Assigned (Id : E; V : B := True);
5865 procedure Set_No_Return (Id : E; V : B := True);
5866 procedure Set_No_Strict_Aliasing (Id : E; V : B := True);
5867 procedure Set_Non_Binary_Modulus (Id : E; V : B := True);
5868 procedure Set_Non_Limited_View (Id : E; V : E);
5869 procedure Set_Nonzero_Is_True (Id : E; V : B := True);
5870 procedure Set_Normalized_First_Bit (Id : E; V : U);
5871 procedure Set_Normalized_Position (Id : E; V : U);
5872 procedure Set_Normalized_Position_Max (Id : E; V : U);
5873 procedure Set_Object_Ref (Id : E; V : E);
5874 procedure Set_Obsolescent_Warning (Id : E; V : N);
5875 procedure Set_Original_Access_Type (Id : E; V : E);
5876 procedure Set_Original_Array_Type (Id : E; V : E);
5877 procedure Set_Original_Record_Component (Id : E; V : E);
5878 procedure Set_Overridden_Operation (Id : E; V : E);
5879 procedure Set_Packed_Array_Type (Id : E; V : E);
5880 procedure Set_Parent_Subtype (Id : E; V : E);
5881 procedure Set_Primitive_Operations (Id : E; V : L);
5882 procedure Set_Prival (Id : E; V : E);
5883 procedure Set_Privals_Chain (Id : E; V : L);
5884 procedure Set_Private_Dependents (Id : E; V : L);
5885 procedure Set_Private_View (Id : E; V : N);
5886 procedure Set_Protected_Body_Subprogram (Id : E; V : E);
5887 procedure Set_Protected_Formal (Id : E; V : E);
5888 procedure Set_Protected_Operation (Id : E; V : N);
5889 procedure Set_RM_Size (Id : E; V : U);
5890 procedure Set_Reachable (Id : E; V : B := True);
5891 procedure Set_Referenced (Id : E; V : B := True);
5892 procedure Set_Referenced_As_LHS (Id : E; V : B := True);
5893 procedure Set_Referenced_Object (Id : E; V : N);
5894 procedure Set_Register_Exception_Call (Id : E; V : N);
5895 procedure Set_Related_Array_Object (Id : E; V : E);
5896 procedure Set_Related_Instance (Id : E; V : E);
5897 procedure Set_Renamed_Entity (Id : E; V : N);
5898 procedure Set_Renamed_Object (Id : E; V : N);
5899 procedure Set_Renaming_Map (Id : E; V : U);
5900 procedure Set_Return_Present (Id : E; V : B := True);
5901 procedure Set_Returns_By_Ref (Id : E; V : B := True);
5902 procedure Set_Reverse_Bit_Order (Id : E; V : B := True);
5903 procedure Set_Scalar_Range (Id : E; V : N);
5904 procedure Set_Scale_Value (Id : E; V : U);
5905 procedure Set_Scope_Depth_Value (Id : E; V : U);
5906 procedure Set_Sec_Stack_Needed_For_Return (Id : E; V : B := True);
5907 procedure Set_Shadow_Entities (Id : E; V : S);
5908 procedure Set_Shared_Var_Assign_Proc (Id : E; V : E);
5909 procedure Set_Shared_Var_Read_Proc (Id : E; V : E);
5910 procedure Set_Size_Check_Code (Id : E; V : N);
5911 procedure Set_Size_Depends_On_Discriminant (Id : E; V : B := True);
5912 procedure Set_Size_Known_At_Compile_Time (Id : E; V : B := True);
5913 procedure Set_Small_Value (Id : E; V : R);
5914 procedure Set_Spec_Entity (Id : E; V : E);
5915 procedure Set_Storage_Size_Variable (Id : E; V : E);
5916 procedure Set_Stored_Constraint (Id : E; V : L);
5917 procedure Set_Strict_Alignment (Id : E; V : B := True);
5918 procedure Set_String_Literal_Length (Id : E; V : U);
5919 procedure Set_String_Literal_Low_Bound (Id : E; V : N);
5920 procedure Set_Suppress_Elaboration_Warnings (Id : E; V : B := True);
5921 procedure Set_Suppress_Init_Proc (Id : E; V : B := True);
5922 procedure Set_Suppress_Style_Checks (Id : E; V : B := True);
5923 procedure Set_Task_Body_Procedure (Id : E; V : N);
5924 procedure Set_Treat_As_Volatile (Id : E; V : B := True);
5925 procedure Set_Underlying_Full_View (Id : E; V : E);
5926 procedure Set_Unset_Reference (Id : E; V : N);
5927 procedure Set_Uses_Sec_Stack (Id : E; V : B := True);
5928 procedure Set_Vax_Float (Id : E; V : B := True);
5929 procedure Set_Warnings_Off (Id : E; V : B := True);
5930 procedure Set_Was_Hidden (Id : E; V : B := True);
5931 procedure Set_Wrapped_Entity (Id : E; V : E);
5933 -----------------------------------
5934 -- Field Initialization Routines --
5935 -----------------------------------
5937 -- These routines are overloadings of some of the above Set procedures
5938 -- where the argument is normally a Uint. The overloadings take an Int
5939 -- parameter instead, and appropriately convert it. There are also
5940 -- versions that implicitly initialize to the appropriate "not set"
5941 -- value. The not set (unknown) values are as follows:
5943 -- Alignment Uint_0
5944 -- Component_Size Uint_0
5945 -- Component_Bit_Offset No_Uint
5946 -- Digits_Value Uint_0
5947 -- Esize Uint_0
5948 -- Normalized_First_Bit No_Uint
5949 -- Normalized_Position No_Uint
5950 -- Normalized_Position_Max No_Uint
5951 -- RM_Size Uint_0
5953 -- It would be cleaner to use No_Uint in all these cases, but historically
5954 -- we chose to use Uint_0 at first, and the change over will take time ???
5955 -- This is particularly true for the RM_Size field, where a value of zero
5956 -- is legitimate and causes some kludges around the code.
5958 procedure Init_Alignment (Id : E; V : Int);
5959 procedure Init_Component_Size (Id : E; V : Int);
5960 procedure Init_Component_Bit_Offset (Id : E; V : Int);
5961 procedure Init_Digits_Value (Id : E; V : Int);
5962 procedure Init_Esize (Id : E; V : Int);
5963 procedure Init_Normalized_First_Bit (Id : E; V : Int);
5964 procedure Init_Normalized_Position (Id : E; V : Int);
5965 procedure Init_Normalized_Position_Max (Id : E; V : Int);
5966 procedure Init_RM_Size (Id : E; V : Int);
5968 procedure Init_Alignment (Id : E);
5969 procedure Init_Component_Size (Id : E);
5970 procedure Init_Component_Bit_Offset (Id : E);
5971 procedure Init_Digits_Value (Id : E);
5972 procedure Init_Esize (Id : E);
5973 procedure Init_Normalized_First_Bit (Id : E);
5974 procedure Init_Normalized_Position (Id : E);
5975 procedure Init_Normalized_Position_Max (Id : E);
5976 procedure Init_RM_Size (Id : E);
5978 procedure Init_Size_Align (Id : E);
5979 -- This procedure initializes both size fields and the alignment
5980 -- field to all be Unknown.
5982 procedure Init_Size (Id : E; V : Int);
5983 -- Initialize both the Esize and RM_Size fields of E to V
5985 procedure Init_Component_Location (Id : E);
5986 -- Initializes all fields describing the location of a component
5987 -- (Normalized_Position, Component_Bit_Offset, Normalized_First_Bit,
5988 -- Normalized_Position_Max, Esize) to all be Unknown.
5990 ---------------
5991 -- Iterators --
5992 ---------------
5994 -- The call to Next_xxx (obj) is equivalent to obj := Next_xxx (obj)
5995 -- We define the set of Proc_Next_xxx routines simply for the purposes
5996 -- of inlining them without necessarily inlining the function.
5998 procedure Proc_Next_Component (N : in out Node_Id);
5999 procedure Proc_Next_Discriminant (N : in out Node_Id);
6000 procedure Proc_Next_Formal (N : in out Node_Id);
6001 procedure Proc_Next_Formal_With_Extras (N : in out Node_Id);
6002 procedure Proc_Next_Index (N : in out Node_Id);
6003 procedure Proc_Next_Inlined_Subprogram (N : in out Node_Id);
6004 procedure Proc_Next_Literal (N : in out Node_Id);
6005 procedure Proc_Next_Stored_Discriminant (N : in out Node_Id);
6007 pragma Inline (Proc_Next_Component);
6008 pragma Inline (Proc_Next_Discriminant);
6009 pragma Inline (Proc_Next_Formal);
6010 pragma Inline (Proc_Next_Formal_With_Extras);
6011 pragma Inline (Proc_Next_Index);
6012 pragma Inline (Proc_Next_Inlined_Subprogram);
6013 pragma Inline (Proc_Next_Literal);
6014 pragma Inline (Proc_Next_Stored_Discriminant);
6016 procedure Next_Component (N : in out Node_Id)
6017 renames Proc_Next_Component;
6019 procedure Next_Discriminant (N : in out Node_Id)
6020 renames Proc_Next_Discriminant;
6022 procedure Next_Formal (N : in out Node_Id)
6023 renames Proc_Next_Formal;
6025 procedure Next_Formal_With_Extras (N : in out Node_Id)
6026 renames Proc_Next_Formal_With_Extras;
6028 procedure Next_Index (N : in out Node_Id)
6029 renames Proc_Next_Index;
6031 procedure Next_Inlined_Subprogram (N : in out Node_Id)
6032 renames Proc_Next_Inlined_Subprogram;
6034 procedure Next_Literal (N : in out Node_Id)
6035 renames Proc_Next_Literal;
6037 procedure Next_Stored_Discriminant (N : in out Node_Id)
6038 renames Proc_Next_Stored_Discriminant;
6040 ----------------------------------------------
6041 -- Subprograms for Accessing Rep Item Chain --
6042 ----------------------------------------------
6044 -- The First_Rep_Item field of every entity points to a linked list
6045 -- (linked through Next_Rep_Item) of representation pragmas and
6046 -- attribute definition clauses that apply to the item. Note that
6047 -- in the case of types, it is assumed that any such rep items for
6048 -- a base type also apply to all subtypes. This is implemented by
6049 -- having the chain for subtypes link onto the chain for the base
6050 -- type, so that any new entries for the subtype are added at the
6051 -- start of the chain.
6053 function Get_Attribute_Definition_Clause
6054 (E : Entity_Id;
6055 Id : Attribute_Id) return Node_Id;
6056 -- Searches the Rep_Item chain for a given entity E, for an instance
6057 -- of an attribute definition clause with the given attribute Id. If
6058 -- found, the value returned is the N_Attribute_Definition_Clause node,
6059 -- otherwise Empty is returned.
6061 function Get_Rep_Pragma (E : Entity_Id; Nam : Name_Id) return Node_Id;
6062 -- Searches the Rep_Item chain for the given entity E, for an instance
6063 -- of a representation pragma with the given name Nam. If found then
6064 -- the value returned is the N_Pragma node, otherwise Empty is returned.
6066 function Has_Rep_Pragma (E : Entity_Id; Nam : Name_Id) return Boolean;
6067 -- Searches the Rep_Item chain for the given entity E, for an instance
6068 -- of representation pragma with the given name Nam. If found then True
6069 -- is returned, otherwise False indicates that no matching entry was found.
6071 function Has_Attribute_Definition_Clause
6072 (E : Entity_Id;
6073 Id : Attribute_Id) return Boolean;
6074 -- Searches the Rep_Item chain for a given entity E, for an instance
6075 -- of an attribute definition clause with the given attribute Id. If
6076 -- found, True is returned, otherwise False indicates that no matching
6077 -- entry was found.
6079 procedure Record_Rep_Item (E : Entity_Id; N : Node_Id);
6080 -- N is the node for either a representation pragma or an attribute
6081 -- definition clause that applies to entity E. This procedure links
6082 -- the node N onto the Rep_Item chain for entity E.
6084 -------------------------------
6085 -- Miscellaneous Subprograms --
6086 -------------------------------
6088 procedure Append_Entity (Id : Entity_Id; V : Entity_Id);
6089 -- Add an entity to the list of entities declared in the scope V
6091 function Is_Entity_Name (N : Node_Id) return Boolean;
6092 -- Test if the node N is the name of an entity (i.e. is an identifier,
6093 -- expanded name, or an attribute reference that returns an entity).
6095 function Next_Index (Id : Node_Id) return Node_Id;
6096 -- Given an index from a previous call to First_Index or Next_Index,
6097 -- returns a node representing the occurrence of the next index subtype,
6098 -- or Empty if there are no more index subtypes.
6100 function Scope_Depth (Id : Entity_Id) return Uint;
6101 -- Returns the scope depth value of the Id, unless the Id is a record
6102 -- type, in which case it returns the scope depth of the record scope.
6104 function Subtype_Kind (K : Entity_Kind) return Entity_Kind;
6105 -- Given an entity_kind K this function returns the entity_kind
6106 -- corresponding to subtype kind of the type represented by K. For
6107 -- example if K is E_Signed_Integer_Type then E_Signed_Integer_Subtype
6108 -- is returned. If K is already a subtype kind it itself is returned. An
6109 -- internal error is generated if no such correspondence exists for K.
6111 ----------------------------------
6112 -- Debugging Output Subprograms --
6113 ----------------------------------
6115 procedure Write_Entity_Flags (Id : Entity_Id; Prefix : String);
6116 -- Writes a series of entries giving a line for each flag that is
6117 -- set to True. Each line is prefixed by the given string
6119 procedure Write_Entity_Info (Id : Entity_Id; Prefix : String);
6120 -- A debugging procedure to write out information about an entity
6122 procedure Write_Field6_Name (Id : Entity_Id);
6123 procedure Write_Field7_Name (Id : Entity_Id);
6124 procedure Write_Field8_Name (Id : Entity_Id);
6125 procedure Write_Field9_Name (Id : Entity_Id);
6126 procedure Write_Field10_Name (Id : Entity_Id);
6127 procedure Write_Field11_Name (Id : Entity_Id);
6128 procedure Write_Field12_Name (Id : Entity_Id);
6129 procedure Write_Field13_Name (Id : Entity_Id);
6130 procedure Write_Field14_Name (Id : Entity_Id);
6131 procedure Write_Field15_Name (Id : Entity_Id);
6132 procedure Write_Field16_Name (Id : Entity_Id);
6133 procedure Write_Field17_Name (Id : Entity_Id);
6134 procedure Write_Field18_Name (Id : Entity_Id);
6135 procedure Write_Field19_Name (Id : Entity_Id);
6136 procedure Write_Field20_Name (Id : Entity_Id);
6137 procedure Write_Field21_Name (Id : Entity_Id);
6138 procedure Write_Field22_Name (Id : Entity_Id);
6139 procedure Write_Field23_Name (Id : Entity_Id);
6140 procedure Write_Field24_Name (Id : Entity_Id);
6141 procedure Write_Field25_Name (Id : Entity_Id);
6142 procedure Write_Field26_Name (Id : Entity_Id);
6143 procedure Write_Field27_Name (Id : Entity_Id);
6144 -- These routines are used to output a nice symbolic name for the given
6145 -- field, depending on the Ekind. No blanks or end of lines are output,
6146 -- just the characters of the field name.
6148 --------------------
6149 -- Inline Pragmas --
6150 --------------------
6152 -- Note that these inline pragmas are referenced by the XEINFO utility
6153 -- program in preparing the corresponding C header, and only those
6154 -- subprograms meeting the requirements documented in the section on
6155 -- XEINFO may be referenced in this section.
6157 pragma Inline (Abstract_Interfaces);
6158 pragma Inline (Accept_Address);
6159 pragma Inline (Access_Disp_Table);
6160 pragma Inline (Actual_Subtype);
6161 pragma Inline (Address_Taken);
6162 pragma Inline (Abstract_Interface_Alias);
6163 pragma Inline (Alias);
6164 pragma Inline (Alignment);
6165 pragma Inline (Associated_Final_Chain);
6166 pragma Inline (Associated_Formal_Package);
6167 pragma Inline (Associated_Node_For_Itype);
6168 pragma Inline (Associated_Storage_Pool);
6169 pragma Inline (Barrier_Function);
6170 pragma Inline (Block_Node);
6171 pragma Inline (Body_Entity);
6172 pragma Inline (Body_Needed_For_SAL);
6173 pragma Inline (CR_Discriminant);
6174 pragma Inline (C_Pass_By_Copy);
6175 pragma Inline (Can_Never_Be_Null);
6176 pragma Inline (Checks_May_Be_Suppressed);
6177 pragma Inline (Class_Wide_Type);
6178 pragma Inline (Cloned_Subtype);
6179 pragma Inline (Component_Bit_Offset);
6180 pragma Inline (Component_Clause);
6181 pragma Inline (Component_Size);
6182 pragma Inline (Component_Type);
6183 pragma Inline (Corresponding_Concurrent_Type);
6184 pragma Inline (Corresponding_Discriminant);
6185 pragma Inline (Corresponding_Equality);
6186 pragma Inline (Corresponding_Record_Type);
6187 pragma Inline (Corresponding_Remote_Type);
6188 pragma Inline (Current_Value);
6189 pragma Inline (Debug_Info_Off);
6190 pragma Inline (Debug_Renaming_Link);
6191 pragma Inline (DTC_Entity);
6192 pragma Inline (DT_Entry_Count);
6193 pragma Inline (DT_Position);
6194 pragma Inline (Default_Expr_Function);
6195 pragma Inline (Default_Expressions_Processed);
6196 pragma Inline (Default_Value);
6197 pragma Inline (Delay_Cleanups);
6198 pragma Inline (Delay_Subprogram_Descriptors);
6199 pragma Inline (Delta_Value);
6200 pragma Inline (Dependent_Instances);
6201 pragma Inline (Depends_On_Private);
6202 pragma Inline (Digits_Value);
6203 pragma Inline (Directly_Designated_Type);
6204 pragma Inline (Discard_Names);
6205 pragma Inline (Discriminal);
6206 pragma Inline (Discriminal_Link);
6207 pragma Inline (Discriminant_Checking_Func);
6208 pragma Inline (Discriminant_Constraint);
6209 pragma Inline (Discriminant_Default_Value);
6210 pragma Inline (Discriminant_Number);
6211 pragma Inline (Elaborate_All_Desirable);
6212 pragma Inline (Elaboration_Entity);
6213 pragma Inline (Elaboration_Entity_Required);
6214 pragma Inline (Enclosing_Scope);
6215 pragma Inline (Entry_Accepted);
6216 pragma Inline (Entry_Bodies_Array);
6217 pragma Inline (Entry_Cancel_Parameter);
6218 pragma Inline (Entry_Component);
6219 pragma Inline (Entry_Formal);
6220 pragma Inline (Entry_Index_Constant);
6221 pragma Inline (Entry_Index_Type);
6222 pragma Inline (Entry_Parameters_Type);
6223 pragma Inline (Enum_Pos_To_Rep);
6224 pragma Inline (Enumeration_Pos);
6225 pragma Inline (Enumeration_Rep);
6226 pragma Inline (Enumeration_Rep_Expr);
6227 pragma Inline (Equivalent_Type);
6228 pragma Inline (Esize);
6229 pragma Inline (Exception_Code);
6230 pragma Inline (Extra_Accessibility);
6231 pragma Inline (Extra_Constrained);
6232 pragma Inline (Extra_Formal);
6233 pragma Inline (Finalization_Chain_Entity);
6234 pragma Inline (First_Entity);
6235 pragma Inline (First_Index);
6236 pragma Inline (First_Literal);
6237 pragma Inline (First_Optional_Parameter);
6238 pragma Inline (First_Private_Entity);
6239 pragma Inline (First_Rep_Item);
6240 pragma Inline (Freeze_Node);
6241 pragma Inline (From_With_Type);
6242 pragma Inline (Full_View);
6243 pragma Inline (Function_Returns_With_DSP);
6244 pragma Inline (Generic_Homonym);
6245 pragma Inline (Generic_Renamings);
6246 pragma Inline (Handler_Records);
6247 pragma Inline (Has_Aliased_Components);
6248 pragma Inline (Has_Alignment_Clause);
6249 pragma Inline (Has_All_Calls_Remote);
6250 pragma Inline (Has_Atomic_Components);
6251 pragma Inline (Has_Biased_Representation);
6252 pragma Inline (Has_Completion);
6253 pragma Inline (Has_Completion_In_Body);
6254 pragma Inline (Has_Complex_Representation);
6255 pragma Inline (Has_Component_Size_Clause);
6256 pragma Inline (Has_Constrained_Partial_View);
6257 pragma Inline (Has_Contiguous_Rep);
6258 pragma Inline (Has_Controlled_Component);
6259 pragma Inline (Has_Controlling_Result);
6260 pragma Inline (Has_Convention_Pragma);
6261 pragma Inline (Has_Delayed_Freeze);
6262 pragma Inline (Has_Discriminants);
6263 pragma Inline (Has_Enumeration_Rep_Clause);
6264 pragma Inline (Has_Exit);
6265 pragma Inline (Has_External_Tag_Rep_Clause);
6266 pragma Inline (Has_Fully_Qualified_Name);
6267 pragma Inline (Has_Gigi_Rep_Item);
6268 pragma Inline (Has_Homonym);
6269 pragma Inline (Has_Machine_Radix_Clause);
6270 pragma Inline (Has_Master_Entity);
6271 pragma Inline (Has_Missing_Return);
6272 pragma Inline (Has_Nested_Block_With_Handler);
6273 pragma Inline (Has_Forward_Instantiation);
6274 pragma Inline (Has_Non_Standard_Rep);
6275 pragma Inline (Has_Object_Size_Clause);
6276 pragma Inline (Has_Per_Object_Constraint);
6277 pragma Inline (Has_Persistent_BSS);
6278 pragma Inline (Has_Pragma_Controlled);
6279 pragma Inline (Has_Pragma_Elaborate_Body);
6280 pragma Inline (Has_Pragma_Inline);
6281 pragma Inline (Has_Pragma_Pack);
6282 pragma Inline (Has_Pragma_Pure_Function);
6283 pragma Inline (Has_Pragma_Unreferenced);
6284 pragma Inline (Has_Primitive_Operations);
6285 pragma Inline (Has_Private_Declaration);
6286 pragma Inline (Has_Qualified_Name);
6287 pragma Inline (Has_Record_Rep_Clause);
6288 pragma Inline (Has_Recursive_Call);
6289 pragma Inline (Has_Size_Clause);
6290 pragma Inline (Has_Small_Clause);
6291 pragma Inline (Has_Specified_Layout);
6292 pragma Inline (Has_Specified_Stream_Input);
6293 pragma Inline (Has_Specified_Stream_Output);
6294 pragma Inline (Has_Specified_Stream_Read);
6295 pragma Inline (Has_Specified_Stream_Write);
6296 pragma Inline (Has_Storage_Size_Clause);
6297 pragma Inline (Has_Stream_Size_Clause);
6298 pragma Inline (Has_Subprogram_Descriptor);
6299 pragma Inline (Has_Task);
6300 pragma Inline (Has_Unchecked_Union);
6301 pragma Inline (Has_Unknown_Discriminants);
6302 pragma Inline (Has_Volatile_Components);
6303 pragma Inline (Has_Xref_Entry);
6304 pragma Inline (Hiding_Loop_Variable);
6305 pragma Inline (Homonym);
6306 pragma Inline (In_Package_Body);
6307 pragma Inline (In_Private_Part);
6308 pragma Inline (In_Use);
6309 pragma Inline (Inner_Instances);
6310 pragma Inline (Interface_Name);
6311 pragma Inline (Is_AST_Entry);
6312 pragma Inline (Is_Abstract);
6313 pragma Inline (Is_Local_Anonymous_Access);
6314 pragma Inline (Is_Access_Constant);
6315 pragma Inline (Is_Ada_2005);
6316 pragma Inline (Is_Access_Type);
6317 pragma Inline (Is_Aliased);
6318 pragma Inline (Is_Array_Type);
6319 pragma Inline (Is_Asynchronous);
6320 pragma Inline (Is_Atomic);
6321 pragma Inline (Is_Bit_Packed_Array);
6322 pragma Inline (Is_CPP_Class);
6323 pragma Inline (Is_Called);
6324 pragma Inline (Is_Character_Type);
6325 pragma Inline (Is_Child_Unit);
6326 pragma Inline (Is_Class_Wide_Equivalent_Type);
6327 pragma Inline (Is_Class_Wide_Type);
6328 pragma Inline (Is_Compilation_Unit);
6329 pragma Inline (Is_Completely_Hidden);
6330 pragma Inline (Is_Composite_Type);
6331 pragma Inline (Is_Concurrent_Body);
6332 pragma Inline (Is_Concurrent_Record_Type);
6333 pragma Inline (Is_Concurrent_Type);
6334 pragma Inline (Is_Constr_Subt_For_UN_Aliased);
6335 pragma Inline (Is_Constr_Subt_For_U_Nominal);
6336 pragma Inline (Is_Constrained);
6337 pragma Inline (Is_Constructor);
6338 pragma Inline (Is_Controlled);
6339 pragma Inline (Is_Controlling_Formal);
6340 pragma Inline (Is_Decimal_Fixed_Point_Type);
6341 pragma Inline (Is_Discrim_SO_Function);
6342 pragma Inline (Is_Digits_Type);
6343 pragma Inline (Is_Discrete_Or_Fixed_Point_Type);
6344 pragma Inline (Is_Discrete_Type);
6345 pragma Inline (Is_Dispatching_Operation);
6346 pragma Inline (Is_Elementary_Type);
6347 pragma Inline (Is_Eliminated);
6348 pragma Inline (Is_Entry);
6349 pragma Inline (Is_Entry_Formal);
6350 pragma Inline (Is_Enumeration_Type);
6351 pragma Inline (Is_Exported);
6352 pragma Inline (Is_First_Subtype);
6353 pragma Inline (Is_Fixed_Point_Type);
6354 pragma Inline (Is_Floating_Point_Type);
6355 pragma Inline (Is_For_Access_Subtype);
6356 pragma Inline (Is_Formal);
6357 pragma Inline (Is_Formal_Subprogram);
6358 pragma Inline (Is_Frozen);
6359 pragma Inline (Is_Generic_Actual_Type);
6360 pragma Inline (Is_Generic_Instance);
6361 pragma Inline (Is_Generic_Subprogram);
6362 pragma Inline (Is_Generic_Type);
6363 pragma Inline (Is_Generic_Unit);
6364 pragma Inline (Is_Hidden);
6365 pragma Inline (Is_Hidden_Open_Scope);
6366 pragma Inline (Is_Immediately_Visible);
6367 pragma Inline (Is_Imported);
6368 pragma Inline (Is_Incomplete_Or_Private_Type);
6369 pragma Inline (Is_Inlined);
6370 pragma Inline (Is_Interface);
6371 pragma Inline (Is_Instantiated);
6372 pragma Inline (Is_Integer_Type);
6373 pragma Inline (Is_Internal);
6374 pragma Inline (Is_Interrupt_Handler);
6375 pragma Inline (Is_Intrinsic_Subprogram);
6376 pragma Inline (Is_Itype);
6377 pragma Inline (Is_Known_Non_Null);
6378 pragma Inline (Is_Known_Valid);
6379 pragma Inline (Is_Limited_Composite);
6380 pragma Inline (Is_Limited_Record);
6381 pragma Inline (Is_Machine_Code_Subprogram);
6382 pragma Inline (Is_Modular_Integer_Type);
6383 pragma Inline (Is_Named_Number);
6384 pragma Inline (Is_Non_Static_Subtype);
6385 pragma Inline (Is_Null_Init_Proc);
6386 pragma Inline (Is_Obsolescent);
6387 pragma Inline (Is_Numeric_Type);
6388 pragma Inline (Is_Object);
6389 pragma Inline (Is_Optional_Parameter);
6390 pragma Inline (Is_Package_Body_Entity);
6391 pragma Inline (Is_Ordinary_Fixed_Point_Type);
6392 pragma Inline (Is_Overloadable);
6393 pragma Inline (Is_Overriding_Operation);
6394 pragma Inline (Is_Packed);
6395 pragma Inline (Is_Packed_Array_Type);
6396 pragma Inline (Is_Potentially_Use_Visible);
6397 pragma Inline (Is_Preelaborated);
6398 pragma Inline (Is_Primitive_Wrapper);
6400 pragma Inline (Is_Private_Composite);
6401 pragma Inline (Is_Private_Descendant);
6402 pragma Inline (Is_Private_Type);
6403 pragma Inline (Is_Protected_Type);
6404 pragma Inline (Is_Public);
6405 pragma Inline (Is_Pure);
6406 pragma Inline (Is_Pure_Unit_Access_Type);
6407 pragma Inline (Is_Real_Type);
6408 pragma Inline (Is_Record_Type);
6409 pragma Inline (Is_Remote_Call_Interface);
6410 pragma Inline (Is_Remote_Types);
6411 pragma Inline (Is_Renaming_Of_Object);
6412 pragma Inline (Is_Scalar_Type);
6413 pragma Inline (Is_Shared_Passive);
6414 pragma Inline (Is_Signed_Integer_Type);
6415 pragma Inline (Is_Statically_Allocated);
6416 pragma Inline (Is_Subprogram);
6417 pragma Inline (Is_Tag);
6418 pragma Inline (Is_Tagged_Type);
6419 pragma Inline (Is_Thread_Body);
6420 pragma Inline (Is_True_Constant);
6421 pragma Inline (Is_Task_Type);
6422 pragma Inline (Is_Type);
6423 pragma Inline (Is_Unchecked_Union);
6424 pragma Inline (Is_Unsigned_Type);
6425 pragma Inline (Is_VMS_Exception);
6426 pragma Inline (Is_Valued_Procedure);
6427 pragma Inline (Is_Visible_Child_Unit);
6428 pragma Inline (Kill_Elaboration_Checks);
6429 pragma Inline (Kill_Range_Checks);
6430 pragma Inline (Kill_Tag_Checks);
6431 pragma Inline (Last_Entity);
6432 pragma Inline (Limited_View);
6433 pragma Inline (Lit_Indexes);
6434 pragma Inline (Lit_Strings);
6435 pragma Inline (Machine_Radix_10);
6436 pragma Inline (Master_Id);
6437 pragma Inline (Materialize_Entity);
6438 pragma Inline (Mechanism);
6439 pragma Inline (Modulus);
6440 pragma Inline (Must_Be_On_Byte_Boundary);
6441 pragma Inline (Needs_Debug_Info);
6442 pragma Inline (Needs_No_Actuals);
6443 pragma Inline (Never_Set_In_Source);
6444 pragma Inline (Next_Index);
6445 pragma Inline (Next_Inlined_Subprogram);
6446 pragma Inline (Next_Literal);
6447 pragma Inline (No_Pool_Assigned);
6448 pragma Inline (No_Return);
6449 pragma Inline (No_Strict_Aliasing);
6450 pragma Inline (Non_Binary_Modulus);
6451 pragma Inline (Non_Limited_View);
6452 pragma Inline (Nonzero_Is_True);
6453 pragma Inline (Normalized_First_Bit);
6454 pragma Inline (Normalized_Position);
6455 pragma Inline (Normalized_Position_Max);
6456 pragma Inline (Object_Ref);
6457 pragma Inline (Obsolescent_Warning);
6458 pragma Inline (Original_Access_Type);
6459 pragma Inline (Original_Array_Type);
6460 pragma Inline (Original_Record_Component);
6461 pragma Inline (Overridden_Operation);
6462 pragma Inline (Packed_Array_Type);
6463 pragma Inline (Parameter_Mode);
6464 pragma Inline (Parent_Subtype);
6465 pragma Inline (Primitive_Operations);
6466 pragma Inline (Prival);
6467 pragma Inline (Privals_Chain);
6468 pragma Inline (Private_Dependents);
6469 pragma Inline (Private_View);
6470 pragma Inline (Protected_Body_Subprogram);
6471 pragma Inline (Protected_Formal);
6472 pragma Inline (Protected_Operation);
6473 pragma Inline (RM_Size);
6474 pragma Inline (Reachable);
6475 pragma Inline (Referenced);
6476 pragma Inline (Referenced_As_LHS);
6477 pragma Inline (Referenced_Object);
6478 pragma Inline (Register_Exception_Call);
6479 pragma Inline (Related_Array_Object);
6480 pragma Inline (Related_Instance);
6481 pragma Inline (Renamed_Entity);
6482 pragma Inline (Renamed_Object);
6483 pragma Inline (Renaming_Map);
6484 pragma Inline (Return_Present);
6485 pragma Inline (Returns_By_Ref);
6486 pragma Inline (Reverse_Bit_Order);
6487 pragma Inline (Scalar_Range);
6488 pragma Inline (Scale_Value);
6489 pragma Inline (Scope_Depth_Value);
6490 pragma Inline (Sec_Stack_Needed_For_Return);
6491 pragma Inline (Shadow_Entities);
6492 pragma Inline (Shared_Var_Assign_Proc);
6493 pragma Inline (Shared_Var_Read_Proc);
6494 pragma Inline (Size_Check_Code);
6495 pragma Inline (Size_Depends_On_Discriminant);
6496 pragma Inline (Size_Known_At_Compile_Time);
6497 pragma Inline (Small_Value);
6498 pragma Inline (Spec_Entity);
6499 pragma Inline (Storage_Size_Variable);
6500 pragma Inline (Stored_Constraint);
6501 pragma Inline (Strict_Alignment);
6502 pragma Inline (String_Literal_Length);
6503 pragma Inline (String_Literal_Low_Bound);
6504 pragma Inline (Suppress_Elaboration_Warnings);
6505 pragma Inline (Suppress_Init_Proc);
6506 pragma Inline (Suppress_Style_Checks);
6507 pragma Inline (Task_Body_Procedure);
6508 pragma Inline (Treat_As_Volatile);
6509 pragma Inline (Underlying_Full_View);
6510 pragma Inline (Unset_Reference);
6511 pragma Inline (Uses_Sec_Stack);
6512 pragma Inline (Vax_Float);
6513 pragma Inline (Warnings_Off);
6514 pragma Inline (Was_Hidden);
6515 pragma Inline (Wrapped_Entity);
6517 pragma Inline (Init_Alignment);
6518 pragma Inline (Init_Component_Bit_Offset);
6519 pragma Inline (Init_Component_Size);
6520 pragma Inline (Init_Digits_Value);
6521 pragma Inline (Init_Esize);
6522 pragma Inline (Init_RM_Size);
6524 pragma Inline (Set_Abstract_Interfaces);
6525 pragma Inline (Set_Accept_Address);
6526 pragma Inline (Set_Access_Disp_Table);
6527 pragma Inline (Set_Actual_Subtype);
6528 pragma Inline (Set_Address_Taken);
6529 pragma Inline (Set_Abstract_Interface_Alias);
6530 pragma Inline (Set_Alias);
6531 pragma Inline (Set_Alignment);
6532 pragma Inline (Set_Associated_Final_Chain);
6533 pragma Inline (Set_Associated_Formal_Package);
6534 pragma Inline (Set_Associated_Node_For_Itype);
6535 pragma Inline (Set_Associated_Storage_Pool);
6536 pragma Inline (Set_Barrier_Function);
6537 pragma Inline (Set_Block_Node);
6538 pragma Inline (Set_Body_Entity);
6539 pragma Inline (Set_Body_Needed_For_SAL);
6540 pragma Inline (Set_CR_Discriminant);
6541 pragma Inline (Set_C_Pass_By_Copy);
6542 pragma Inline (Set_Can_Never_Be_Null);
6543 pragma Inline (Set_Checks_May_Be_Suppressed);
6544 pragma Inline (Set_Class_Wide_Type);
6545 pragma Inline (Set_Cloned_Subtype);
6546 pragma Inline (Set_Component_Bit_Offset);
6547 pragma Inline (Set_Component_Clause);
6548 pragma Inline (Set_Component_Size);
6549 pragma Inline (Set_Component_Type);
6550 pragma Inline (Set_Corresponding_Concurrent_Type);
6551 pragma Inline (Set_Corresponding_Discriminant);
6552 pragma Inline (Set_Corresponding_Equality);
6553 pragma Inline (Set_Corresponding_Record_Type);
6554 pragma Inline (Set_Corresponding_Remote_Type);
6555 pragma Inline (Set_Current_Value);
6556 pragma Inline (Set_Debug_Info_Off);
6557 pragma Inline (Set_Debug_Renaming_Link);
6558 pragma Inline (Set_DTC_Entity);
6559 pragma Inline (Set_DT_Position);
6560 pragma Inline (Set_Default_Expr_Function);
6561 pragma Inline (Set_Default_Expressions_Processed);
6562 pragma Inline (Set_Default_Value);
6563 pragma Inline (Set_Delay_Cleanups);
6564 pragma Inline (Set_Delay_Subprogram_Descriptors);
6565 pragma Inline (Set_Delta_Value);
6566 pragma Inline (Set_Dependent_Instances);
6567 pragma Inline (Set_Depends_On_Private);
6568 pragma Inline (Set_Digits_Value);
6569 pragma Inline (Set_Directly_Designated_Type);
6570 pragma Inline (Set_Discard_Names);
6571 pragma Inline (Set_Discriminal);
6572 pragma Inline (Set_Discriminal_Link);
6573 pragma Inline (Set_Discriminant_Checking_Func);
6574 pragma Inline (Set_Discriminant_Constraint);
6575 pragma Inline (Set_Discriminant_Default_Value);
6576 pragma Inline (Set_Discriminant_Number);
6577 pragma Inline (Set_Elaborate_All_Desirable);
6578 pragma Inline (Set_Elaboration_Entity);
6579 pragma Inline (Set_Elaboration_Entity_Required);
6580 pragma Inline (Set_Enclosing_Scope);
6581 pragma Inline (Set_Entry_Accepted);
6582 pragma Inline (Set_Entry_Bodies_Array);
6583 pragma Inline (Set_Entry_Cancel_Parameter);
6584 pragma Inline (Set_Entry_Component);
6585 pragma Inline (Set_Entry_Formal);
6586 pragma Inline (Set_Entry_Parameters_Type);
6587 pragma Inline (Set_Enum_Pos_To_Rep);
6588 pragma Inline (Set_Enumeration_Pos);
6589 pragma Inline (Set_Enumeration_Rep);
6590 pragma Inline (Set_Enumeration_Rep_Expr);
6591 pragma Inline (Set_Equivalent_Type);
6592 pragma Inline (Set_Esize);
6593 pragma Inline (Set_Exception_Code);
6594 pragma Inline (Set_Extra_Accessibility);
6595 pragma Inline (Set_Extra_Constrained);
6596 pragma Inline (Set_Extra_Formal);
6597 pragma Inline (Set_Finalization_Chain_Entity);
6598 pragma Inline (Set_First_Entity);
6599 pragma Inline (Set_First_Index);
6600 pragma Inline (Set_First_Literal);
6601 pragma Inline (Set_First_Optional_Parameter);
6602 pragma Inline (Set_First_Private_Entity);
6603 pragma Inline (Set_First_Rep_Item);
6604 pragma Inline (Set_Freeze_Node);
6605 pragma Inline (Set_From_With_Type);
6606 pragma Inline (Set_Full_View);
6607 pragma Inline (Set_Function_Returns_With_DSP);
6608 pragma Inline (Set_Generic_Homonym);
6609 pragma Inline (Set_Generic_Renamings);
6610 pragma Inline (Set_Handler_Records);
6611 pragma Inline (Set_Has_Aliased_Components);
6612 pragma Inline (Set_Has_Alignment_Clause);
6613 pragma Inline (Set_Has_All_Calls_Remote);
6614 pragma Inline (Set_Has_Atomic_Components);
6615 pragma Inline (Set_Has_Biased_Representation);
6616 pragma Inline (Set_Has_Completion);
6617 pragma Inline (Set_Has_Completion_In_Body);
6618 pragma Inline (Set_Has_Complex_Representation);
6619 pragma Inline (Set_Has_Component_Size_Clause);
6620 pragma Inline (Set_Has_Constrained_Partial_View);
6621 pragma Inline (Set_Has_Contiguous_Rep);
6622 pragma Inline (Set_Has_Controlled_Component);
6623 pragma Inline (Set_Has_Controlling_Result);
6624 pragma Inline (Set_Has_Convention_Pragma);
6625 pragma Inline (Set_Has_Delayed_Freeze);
6626 pragma Inline (Set_Has_Discriminants);
6627 pragma Inline (Set_Has_Enumeration_Rep_Clause);
6628 pragma Inline (Set_Has_Exit);
6629 pragma Inline (Set_Has_External_Tag_Rep_Clause);
6630 pragma Inline (Set_Has_Fully_Qualified_Name);
6631 pragma Inline (Set_Has_Gigi_Rep_Item);
6632 pragma Inline (Set_Has_Homonym);
6633 pragma Inline (Set_Has_Machine_Radix_Clause);
6634 pragma Inline (Set_Has_Master_Entity);
6635 pragma Inline (Set_Has_Missing_Return);
6636 pragma Inline (Set_Has_Nested_Block_With_Handler);
6637 pragma Inline (Set_Has_Forward_Instantiation);
6638 pragma Inline (Set_Has_Non_Standard_Rep);
6639 pragma Inline (Set_Has_Object_Size_Clause);
6640 pragma Inline (Set_Has_Per_Object_Constraint);
6641 pragma Inline (Set_Has_Persistent_BSS);
6642 pragma Inline (Set_Has_Pragma_Controlled);
6643 pragma Inline (Set_Has_Pragma_Elaborate_Body);
6644 pragma Inline (Set_Has_Pragma_Inline);
6645 pragma Inline (Set_Has_Pragma_Pack);
6646 pragma Inline (Set_Has_Pragma_Pure_Function);
6647 pragma Inline (Set_Has_Pragma_Unreferenced);
6648 pragma Inline (Set_Has_Primitive_Operations);
6649 pragma Inline (Set_Has_Private_Declaration);
6650 pragma Inline (Set_Has_Qualified_Name);
6651 pragma Inline (Set_Has_Record_Rep_Clause);
6652 pragma Inline (Set_Has_Recursive_Call);
6653 pragma Inline (Set_Has_Size_Clause);
6654 pragma Inline (Set_Has_Small_Clause);
6655 pragma Inline (Set_Has_Specified_Layout);
6656 pragma Inline (Set_Has_Specified_Stream_Input);
6657 pragma Inline (Set_Has_Specified_Stream_Output);
6658 pragma Inline (Set_Has_Specified_Stream_Read);
6659 pragma Inline (Set_Has_Specified_Stream_Write);
6660 pragma Inline (Set_Has_Storage_Size_Clause);
6661 pragma Inline (Set_Has_Subprogram_Descriptor);
6662 pragma Inline (Set_Has_Task);
6663 pragma Inline (Set_Has_Unchecked_Union);
6664 pragma Inline (Set_Has_Unknown_Discriminants);
6665 pragma Inline (Set_Has_Volatile_Components);
6666 pragma Inline (Set_Has_Xref_Entry);
6667 pragma Inline (Set_Hiding_Loop_Variable);
6668 pragma Inline (Set_Homonym);
6669 pragma Inline (Set_In_Package_Body);
6670 pragma Inline (Set_In_Private_Part);
6671 pragma Inline (Set_In_Use);
6672 pragma Inline (Set_Inner_Instances);
6673 pragma Inline (Set_Interface_Name);
6674 pragma Inline (Set_Is_AST_Entry);
6675 pragma Inline (Set_Is_Abstract);
6676 pragma Inline (Set_Is_Local_Anonymous_Access);
6677 pragma Inline (Set_Is_Access_Constant);
6678 pragma Inline (Set_Is_Ada_2005);
6679 pragma Inline (Set_Is_Aliased);
6680 pragma Inline (Set_Is_Asynchronous);
6681 pragma Inline (Set_Is_Atomic);
6682 pragma Inline (Set_Is_Bit_Packed_Array);
6683 pragma Inline (Set_Is_CPP_Class);
6684 pragma Inline (Set_Is_Called);
6685 pragma Inline (Set_Is_Character_Type);
6686 pragma Inline (Set_Is_Child_Unit);
6687 pragma Inline (Set_Is_Class_Wide_Equivalent_Type);
6688 pragma Inline (Set_Is_Compilation_Unit);
6689 pragma Inline (Set_Is_Completely_Hidden);
6690 pragma Inline (Set_Is_Concurrent_Record_Type);
6691 pragma Inline (Set_Is_Constr_Subt_For_U_Nominal);
6692 pragma Inline (Set_Is_Constr_Subt_For_UN_Aliased);
6693 pragma Inline (Set_Is_Constrained);
6694 pragma Inline (Set_Is_Constructor);
6695 pragma Inline (Set_Is_Controlled);
6696 pragma Inline (Set_Is_Controlling_Formal);
6697 pragma Inline (Set_Is_Discrim_SO_Function);
6698 pragma Inline (Set_Is_Dispatching_Operation);
6699 pragma Inline (Set_Is_Eliminated);
6700 pragma Inline (Set_Is_Entry_Formal);
6701 pragma Inline (Set_Is_Exported);
6702 pragma Inline (Set_Is_First_Subtype);
6703 pragma Inline (Set_Is_For_Access_Subtype);
6704 pragma Inline (Set_Is_Formal_Subprogram);
6705 pragma Inline (Set_Is_Frozen);
6706 pragma Inline (Set_Is_Generic_Actual_Type);
6707 pragma Inline (Set_Is_Generic_Instance);
6708 pragma Inline (Set_Is_Generic_Type);
6709 pragma Inline (Set_Is_Hidden);
6710 pragma Inline (Set_Is_Hidden_Open_Scope);
6711 pragma Inline (Set_Is_Immediately_Visible);
6712 pragma Inline (Set_Is_Imported);
6713 pragma Inline (Set_Is_Inlined);
6714 pragma Inline (Set_Is_Interface);
6715 pragma Inline (Set_Is_Instantiated);
6716 pragma Inline (Set_Is_Internal);
6717 pragma Inline (Set_Is_Interrupt_Handler);
6718 pragma Inline (Set_Is_Intrinsic_Subprogram);
6719 pragma Inline (Set_Is_Itype);
6720 pragma Inline (Set_Is_Known_Non_Null);
6721 pragma Inline (Set_Is_Known_Valid);
6722 pragma Inline (Set_Is_Limited_Composite);
6723 pragma Inline (Set_Is_Limited_Record);
6724 pragma Inline (Set_Is_Machine_Code_Subprogram);
6725 pragma Inline (Set_Is_Non_Static_Subtype);
6726 pragma Inline (Set_Is_Null_Init_Proc);
6727 pragma Inline (Set_Is_Obsolescent);
6728 pragma Inline (Set_Is_Optional_Parameter);
6729 pragma Inline (Set_Is_Overriding_Operation);
6730 pragma Inline (Set_Is_Package_Body_Entity);
6731 pragma Inline (Set_Is_Packed);
6732 pragma Inline (Set_Is_Packed_Array_Type);
6733 pragma Inline (Set_Is_Potentially_Use_Visible);
6734 pragma Inline (Set_Is_Preelaborated);
6735 pragma Inline (Set_Is_Primitive_Wrapper);
6737 pragma Inline (Set_Is_Private_Composite);
6738 pragma Inline (Set_Is_Private_Descendant);
6739 pragma Inline (Set_Is_Public);
6740 pragma Inline (Set_Is_Pure);
6741 pragma Inline (Set_Is_Pure_Unit_Access_Type);
6742 pragma Inline (Set_Is_Remote_Call_Interface);
6743 pragma Inline (Set_Is_Remote_Types);
6744 pragma Inline (Set_Is_Renaming_Of_Object);
6745 pragma Inline (Set_Is_Shared_Passive);
6746 pragma Inline (Set_Is_Statically_Allocated);
6747 pragma Inline (Set_Is_Tag);
6748 pragma Inline (Set_Is_Tagged_Type);
6749 pragma Inline (Set_Is_Thread_Body);
6750 pragma Inline (Set_Is_True_Constant);
6751 pragma Inline (Set_Is_Unchecked_Union);
6752 pragma Inline (Set_Is_Unsigned_Type);
6753 pragma Inline (Set_Is_VMS_Exception);
6754 pragma Inline (Set_Is_Valued_Procedure);
6755 pragma Inline (Set_Is_Visible_Child_Unit);
6756 pragma Inline (Set_Is_Volatile);
6757 pragma Inline (Set_Kill_Elaboration_Checks);
6758 pragma Inline (Set_Kill_Range_Checks);
6759 pragma Inline (Set_Kill_Tag_Checks);
6760 pragma Inline (Set_Last_Entity);
6761 pragma Inline (Set_Limited_View);
6762 pragma Inline (Set_Lit_Indexes);
6763 pragma Inline (Set_Lit_Strings);
6764 pragma Inline (Set_Machine_Radix_10);
6765 pragma Inline (Set_Master_Id);
6766 pragma Inline (Set_Materialize_Entity);
6767 pragma Inline (Set_Mechanism);
6768 pragma Inline (Set_Modulus);
6769 pragma Inline (Set_Must_Be_On_Byte_Boundary);
6770 pragma Inline (Set_Needs_Debug_Info);
6771 pragma Inline (Set_Needs_No_Actuals);
6772 pragma Inline (Set_Never_Set_In_Source);
6773 pragma Inline (Set_Next_Inlined_Subprogram);
6774 pragma Inline (Set_No_Pool_Assigned);
6775 pragma Inline (Set_No_Return);
6776 pragma Inline (Set_No_Strict_Aliasing);
6777 pragma Inline (Set_Non_Binary_Modulus);
6778 pragma Inline (Set_Non_Limited_View);
6779 pragma Inline (Set_Nonzero_Is_True);
6780 pragma Inline (Set_Normalized_First_Bit);
6781 pragma Inline (Set_Normalized_Position);
6782 pragma Inline (Set_Normalized_Position_Max);
6783 pragma Inline (Set_Object_Ref);
6784 pragma Inline (Set_Obsolescent_Warning);
6785 pragma Inline (Set_Original_Access_Type);
6786 pragma Inline (Set_Original_Array_Type);
6787 pragma Inline (Set_Original_Record_Component);
6788 pragma Inline (Set_Overridden_Operation);
6789 pragma Inline (Set_Packed_Array_Type);
6790 pragma Inline (Set_Parent_Subtype);
6791 pragma Inline (Set_Primitive_Operations);
6792 pragma Inline (Set_Prival);
6793 pragma Inline (Set_Privals_Chain);
6794 pragma Inline (Set_Private_Dependents);
6795 pragma Inline (Set_Private_View);
6796 pragma Inline (Set_Protected_Body_Subprogram);
6797 pragma Inline (Set_Protected_Formal);
6798 pragma Inline (Set_Protected_Operation);
6799 pragma Inline (Set_RM_Size);
6800 pragma Inline (Set_Reachable);
6801 pragma Inline (Set_Referenced);
6802 pragma Inline (Set_Referenced_As_LHS);
6803 pragma Inline (Set_Referenced_Object);
6804 pragma Inline (Set_Register_Exception_Call);
6805 pragma Inline (Set_Related_Array_Object);
6806 pragma Inline (Set_Related_Instance);
6807 pragma Inline (Set_Renamed_Entity);
6808 pragma Inline (Set_Renamed_Object);
6809 pragma Inline (Set_Renaming_Map);
6810 pragma Inline (Set_Return_Present);
6811 pragma Inline (Set_Returns_By_Ref);
6812 pragma Inline (Set_Reverse_Bit_Order);
6813 pragma Inline (Set_Scalar_Range);
6814 pragma Inline (Set_Scale_Value);
6815 pragma Inline (Set_Scope_Depth_Value);
6816 pragma Inline (Set_Sec_Stack_Needed_For_Return);
6817 pragma Inline (Set_Shadow_Entities);
6818 pragma Inline (Set_Shared_Var_Assign_Proc);
6819 pragma Inline (Set_Shared_Var_Read_Proc);
6820 pragma Inline (Set_Size_Check_Code);
6821 pragma Inline (Set_Size_Depends_On_Discriminant);
6822 pragma Inline (Set_Size_Known_At_Compile_Time);
6823 pragma Inline (Set_Small_Value);
6824 pragma Inline (Set_Spec_Entity);
6825 pragma Inline (Set_Storage_Size_Variable);
6826 pragma Inline (Set_Stored_Constraint);
6827 pragma Inline (Set_Strict_Alignment);
6828 pragma Inline (Set_String_Literal_Length);
6829 pragma Inline (Set_String_Literal_Low_Bound);
6830 pragma Inline (Set_Suppress_Elaboration_Warnings);
6831 pragma Inline (Set_Suppress_Init_Proc);
6832 pragma Inline (Set_Suppress_Style_Checks);
6833 pragma Inline (Set_Task_Body_Procedure);
6834 pragma Inline (Set_Treat_As_Volatile);
6835 pragma Inline (Set_Underlying_Full_View);
6836 pragma Inline (Set_Unset_Reference);
6837 pragma Inline (Set_Uses_Sec_Stack);
6838 pragma Inline (Set_Vax_Float);
6839 pragma Inline (Set_Warnings_Off);
6840 pragma Inline (Set_Was_Hidden);
6841 pragma Inline (Set_Wrapped_Entity);
6843 -- END XEINFO INLINES
6845 -- The following Inline pragmas are *not* read by xeinfo when building
6846 -- the C version of this interface automatically (so the C version will
6847 -- end up making out of line calls). The pragma scan in xeinfo will be
6848 -- terminated on encountering the END XEINFO INLINES line. We inline
6849 -- things here which are small, but not of the canonical attribute
6850 -- access/set format that can be handled by xeinfo.
6852 pragma Inline (Is_Package);
6853 pragma Inline (Is_Wrapper_Package);
6854 pragma Inline (Known_RM_Size);
6855 pragma Inline (Known_Static_Component_Bit_Offset);
6856 pragma Inline (Known_Static_RM_Size);
6857 pragma Inline (Scope_Depth);
6858 pragma Inline (Scope_Depth_Set);
6859 pragma Inline (Unknown_RM_Size);
6861 end Einfo;