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