OpenCores
URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [gnu-stable/] [gcc-4.5.1/] [gcc/] [ada/] [einfo.ads] - Blame information for rev 826

Details | Compare with Previous | View Log

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

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.