PR testsuite/44195
[official-gcc.git] / gcc / ada / sinfo.ads
blobcb358c4d75b389fe4053c2f024eca674f9fd5b2a
1 ------------------------------------------------------------------------------
2 -- --
3 -- GNAT COMPILER COMPONENTS --
4 -- --
5 -- S I N F O --
6 -- --
7 -- S p e c --
8 -- --
9 -- Copyright (C) 1992-2010, Free Software Foundation, Inc. --
10 -- --
11 -- GNAT is free software; you can redistribute it and/or modify it under --
12 -- terms of the GNU General Public License as published by the Free Soft- --
13 -- ware Foundation; either version 3, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. --
17 -- --
18 -- As a special exception under Section 7 of GPL version 3, you are granted --
19 -- additional permissions described in the GCC Runtime Library Exception, --
20 -- version 3.1, as published by the Free Software Foundation. --
21 -- --
22 -- You should have received a copy of the GNU General Public License and --
23 -- a copy of the GCC Runtime Library Exception along with this program; --
24 -- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
25 -- <http://www.gnu.org/licenses/>. --
26 -- --
27 -- GNAT was originally developed by the GNAT team at New York University. --
28 -- Extensive contributions were provided by Ada Core Technologies Inc. --
29 -- --
30 ------------------------------------------------------------------------------
32 -- This package defines the structure of the abstract syntax tree. The Tree
33 -- package provides a basic tree structure. Sinfo describes how this structure
34 -- is used to represent the syntax of an Ada program.
36 -- The grammar in the RM is followed very closely in the tree design, and is
37 -- repeated as part of this source file.
39 -- The tree contains not only the full syntactic representation of the
40 -- program, but also the results of semantic analysis. In particular, the
41 -- nodes for defining identifiers, defining character literals and defining
42 -- operator symbols, collectively referred to as entities, represent what
43 -- would normally be regarded as the symbol table information. In addition a
44 -- number of the tree nodes contain semantic information.
46 -- WARNING: Several files are automatically generated from this package.
47 -- See below for details.
49 with Namet; use Namet;
50 with Types; use Types;
51 with Uintp; use Uintp;
52 with Urealp; use Urealp;
54 package Sinfo is
56 ---------------------------------
57 -- Making Changes to This File --
58 ---------------------------------
60 -- If changes are made to this file, a number of related steps must be
61 -- carried out to ensure consistency. First, if a field access function is
62 -- added, it appears in seven places:
64 -- The documentation associated with the node
65 -- The spec of the access function in sinfo.ads
66 -- The body of the access function in sinfo.adb
67 -- The pragma Inline at the end of sinfo.ads for the access function
68 -- The spec of the set procedure in sinfo.ads
69 -- The body of the set procedure in sinfo.adb
70 -- The pragma Inline at the end of sinfo.ads for the set procedure
72 -- The field chosen must be consistent in all places, and, for a node that
73 -- is a subexpression, must not overlap any of the standard expression
74 -- fields.
76 -- In addition, if any of the standard expression fields is changed, then
77 -- the utility program which creates the Treeprs spec (in file treeprs.ads)
78 -- must be updated appropriately, since it special cases expression fields.
80 -- If a new tree node is added, then the following changes are made
82 -- Add it to the documentation in the appropriate place
83 -- Add its fields to this documentation section
84 -- Define it in the appropriate classification in Node_Kind
85 -- In the body (sinfo), add entries to the access functions for all
86 -- its fields (except standard expression fields) to include the new
87 -- node in the checks.
88 -- Add an appropriate section to the case statement in sprint.adb
89 -- Add an appropriate section to the case statement in sem.adb
90 -- Add an appropriate section to the case statement in exp_util.adb
91 -- (Insert_Actions procedure)
92 -- For a subexpression, add an appropriate section to the case
93 -- statement in sem_eval.adb
94 -- For a subexpression, add an appropriate section to the case
95 -- statement in sem_res.adb
97 -- Finally, four utility programs must be run:
99 -- Run CSinfo to check that you have made the changes consistently. It
100 -- checks most of the rules given above, with clear error messages. This
101 -- utility reads sinfo.ads and sinfo.adb and generates a report to
102 -- standard output.
104 -- Run XSinfo to create sinfo.h, the corresponding C header. This
105 -- utility reads sinfo.ads and generates sinfo.h. Note that it does
106 -- not need to read sinfo.adb, since the contents of the body are
107 -- algorithmically determinable from the spec.
109 -- Run XTreeprs to create treeprs.ads, an updated version of the module
110 -- that is used to drive the tree print routine. This utility reads (but
111 -- does not modify) treeprs.adt, the template that provides the basic
112 -- structure of the file, and then fills in the data from the comments
113 -- in sinfo.ads.
115 -- Run XNmake to create nmake.ads and nmake.adb, the package body and
116 -- spec of the Nmake package which contains functions for constructing
117 -- nodes.
119 -- All of the above steps except CSinfo are done automatically by the
120 -- build scripts when you do a full bootstrap.
122 -- Note: sometime we could write a utility that actually generated the body
123 -- of sinfo from the spec instead of simply checking it, since, as noted
124 -- above, the contents of the body can be determined from the spec.
126 --------------------------------
127 -- Implicit Nodes in the Tree --
128 --------------------------------
130 -- Generally the structure of the tree very closely follows the grammar as
131 -- defined in the RM. However, certain nodes are omitted to save space and
132 -- simplify semantic processing. Two general classes of such omitted nodes
133 -- are as follows:
135 -- If the only possibilities for a non-terminal are one or more other
136 -- non-terminals (i.e. the rule is a "skinny" rule), then usually the
137 -- corresponding node is omitted from the tree, and the target construct
138 -- appears directly. For example, a real type definition is either
139 -- floating point definition or a fixed point definition. No explicit node
140 -- appears for real type definition. Instead either the floating point
141 -- definition or fixed point definition appears directly.
143 -- If a non-terminal corresponds to a list of some other non-terminal
144 -- (possibly with separating punctuation), then usually it is omitted from
145 -- the tree, and a list of components appears instead. For example,
146 -- sequence of statements does not appear explicitly in the tree. Instead
147 -- a list of statements appears directly.
149 -- Some additional cases of omitted nodes occur and are documented
150 -- individually. In particular, many nodes are omitted in the tree
151 -- generated for an expression.
153 -------------------------------------------
154 -- Handling of Defining Identifier Lists --
155 -------------------------------------------
157 -- In several declarative forms in the syntax, lists of defining
158 -- identifiers appear (object declarations, component declarations, number
159 -- declarations etc.)
161 -- The semantics of such statements are equivalent to a series of identical
162 -- declarations of single defining identifiers (except that conformance
163 -- checks require the same grouping of identifiers in the parameter case).
165 -- To simplify semantic processing, the parser breaks down such multiple
166 -- declaration cases into sequences of single declarations, duplicating
167 -- type and initialization information as required. The flags More_Ids and
168 -- Prev_Ids are used to record the original form of the source in the case
169 -- where the original source used a list of names, More_Ids being set on
170 -- all but the last name and Prev_Ids being set on all but the first name.
171 -- These flags are used to reconstruct the original source (e.g. in the
172 -- Sprint package), and also are included in the conformance checks, but
173 -- otherwise have no semantic significance.
175 -- Note: the reason that we use More_Ids and Prev_Ids rather than
176 -- First_Name and Last_Name flags is so that the flags are off in the
177 -- normal one identifier case, which minimizes tree print output.
179 -----------------------
180 -- Use of Node Lists --
181 -----------------------
183 -- With a few exceptions, if a construction of the form {non-terminal}
184 -- appears in the tree, lists are used in the corresponding tree node (see
185 -- package Nlists for handling of node lists). In this case a field of the
186 -- parent node points to a list of nodes for the non-terminal. The field
187 -- name for such fields has a plural name which always ends in "s". For
188 -- example, a case statement has a field Alternatives pointing to list of
189 -- case statement alternative nodes.
191 -- Only fields pointing to lists have names ending in "s", so generally the
192 -- structure is strongly typed, fields not ending in s point to single
193 -- nodes, and fields ending in s point to lists.
195 -- The following example shows how a traversal of a list is written. We
196 -- suppose here that Stmt points to a N_Case_Statement node which has a
197 -- list field called Alternatives:
199 -- Alt := First (Alternatives (Stmt));
200 -- while Present (Alt) loop
201 -- ..
202 -- -- processing for case statement alternative Alt
203 -- ..
204 -- Alt := Next (Alt);
205 -- end loop;
207 -- The Present function tests for Empty, which in this case signals the end
208 -- of the list. First returns Empty immediately if the list is empty.
209 -- Present is defined in Atree, First and Next are defined in Nlists.
211 -- The exceptions to this rule occur with {DEFINING_IDENTIFIERS} in all
212 -- contexts, which is handled as described in the previous section, and
213 -- with {,library_unit_NAME} in the N_With_Clause mode, which is handled
214 -- using the First_Name and Last_Name flags, as further detailed in the
215 -- description of the N_With_Clause node.
217 -------------
218 -- Pragmas --
219 -------------
221 -- Pragmas can appear in many different context, but are not included in
222 -- the grammar. Still they must appear in the tree, so they can be properly
223 -- processed.
225 -- Two approaches are used. In some cases, an extra field is defined in an
226 -- appropriate node that contains a list of pragmas appearing in the
227 -- expected context. For example pragmas can appear before an
228 -- Accept_Alternative in a Selective_Accept_Statement, and these pragmas
229 -- appear in the Pragmas_Before field of the N_Accept_Alternative node.
231 -- The other approach is to simply allow pragmas to appear in syntactic
232 -- lists where the grammar (of course) does not include the possibility.
233 -- For example, the Variants field of an N_Variant_Part node points to a
234 -- list that can contain both N_Pragma and N_Variant nodes.
236 -- To make processing easier in the latter case, the Nlists package
237 -- provides a set of routines (First_Non_Pragma, Last_Non_Pragma,
238 -- Next_Non_Pragma, Prev_Non_Pragma) that allow such lists to be handled
239 -- ignoring all pragmas.
241 -- In the case of the variants list, we can either write:
243 -- Variant := First (Variants (N));
244 -- while Present (Variant) loop
245 -- ...
246 -- Variant := Next (Variant);
247 -- end loop;
249 -- or
251 -- Variant := First_Non_Pragma (Variants (N));
252 -- while Present (Variant) loop
253 -- ...
254 -- Variant := Next_Non_Pragma (Variant);
255 -- end loop;
257 -- In the first form of the loop, Variant can either be an N_Pragma or an
258 -- N_Variant node. In the second form, Variant can only be N_Variant since
259 -- all pragmas are skipped.
261 ---------------------
262 -- Optional Fields --
263 ---------------------
265 -- Fields which correspond to a section of the syntax enclosed in square
266 -- brackets are generally omitted (and the corresponding field set to Empty
267 -- for a node, or No_List for a list). The documentation of such fields
268 -- notes these cases. One exception to this rule occurs in the case of
269 -- possibly empty statement sequences (such as the sequence of statements
270 -- in an entry call alternative). Such cases appear in the syntax rules as
271 -- [SEQUENCE_OF_STATEMENTS] and the fields corresponding to such optional
272 -- statement sequences always contain an empty list (not No_List) if no
273 -- statements are present.
275 -- Note: the utility program that constructs the body and spec of the Nmake
276 -- package relies on the format of the comments to determine if a field
277 -- should have a default value in the corresponding make routine. The rule
278 -- is that if the first line of the description of the field contains the
279 -- string "(set to xxx if", then a default value of xxx is provided for
280 -- this field in the corresponding Make_yyy routine.
282 -----------------------------------
283 -- Note on Body/Spec Terminology --
284 -----------------------------------
286 -- In informal discussions about Ada, it is customary to refer to package
287 -- and subprogram specs and bodies. However, this is not technically
288 -- correct, what is normally referred to as a spec or specification is in
289 -- fact a package declaration or subprogram declaration. We are careful in
290 -- GNAT to use the correct terminology and in particular, the full word
291 -- specification is never used as an incorrect substitute for declaration.
292 -- The structure and terminology used in the tree also reflects the grammar
293 -- and thus uses declaration and specification in the technically correct
294 -- manner.
296 -- However, there are contexts in which the informal terminology is useful.
297 -- We have the word "body" to refer to the Interp_Etype declared by the
298 -- declaration of a unit body, and in some contexts we need similar term to
299 -- refer to the entity declared by the package or subprogram declaration,
300 -- and simply using declaration can be confusing since the body also has a
301 -- declaration.
303 -- An example of such a context is the link between the package body and
304 -- its declaration. With_Declaration is confusing, since the package body
305 -- itself is a declaration.
307 -- To deal with this problem, we reserve the informal term Spec, i.e. the
308 -- popular abbreviation used in this context, to refer to the entity
309 -- declared by the package or subprogram declaration. So in the above
310 -- example case, the field in the body is called With_Spec.
312 -- Another important context for the use of the word Spec is in error
313 -- messages, where a hyper-correct use of declaration would be confusing to
314 -- a typical Ada programmer, and even for an expert programmer can cause
315 -- confusion since the body has a declaration as well.
317 -- So, to summarize:
319 -- Declaration always refers to the syntactic entity that is called
320 -- a declaration. In particular, subprogram declaration
321 -- and package declaration are used to describe the
322 -- syntactic entity that includes the semicolon.
324 -- Specification always refers to the syntactic entity that is called
325 -- a specification. In particular, the terms procedure
326 -- specification, function specification, package
327 -- specification, subprogram specification always refer
328 -- to the syntactic entity that has no semicolon.
330 -- Spec is an informal term, used to refer to the entity
331 -- that is declared by a task declaration, protected
332 -- declaration, generic declaration, subprogram
333 -- declaration or package declaration.
335 -- This convention is followed throughout the GNAT documentation
336 -- both internal and external, and in all error message text.
338 ------------------------
339 -- Internal Use Nodes --
340 ------------------------
342 -- These are Node_Kind settings used in the internal implementation which
343 -- are not logically part of the specification.
345 -- N_Unused_At_Start
346 -- Completely unused entry at the start of the enumeration type. This
347 -- is inserted so that no legitimate value is zero, which helps to get
348 -- better debugging behavior, since zero is a likely uninitialized value).
350 -- N_Unused_At_End
351 -- Completely unused entry at the end of the enumeration type. This is
352 -- handy so that arrays with Node_Kind as the index type have an extra
353 -- entry at the end (see for example the use of the Pchar_Pos_Array in
354 -- Treepr, where the extra entry provides the limit value when dealing with
355 -- the last used entry in the array).
357 -----------------------------------------
358 -- Note on the settings of Sloc fields --
359 -----------------------------------------
361 -- The Sloc field of nodes that come from the source is set by the parser.
362 -- For internal nodes, and nodes generated during expansion the Sloc is
363 -- usually set in the call to the constructor for the node. In general the
364 -- Sloc value chosen for an internal node is the Sloc of the source node
365 -- whose processing is responsible for the expansion. For example, the Sloc
366 -- of an inherited primitive operation is the Sloc of the corresponding
367 -- derived type declaration.
369 -- For the nodes of a generic instantiation, the Sloc value is encoded to
370 -- represent both the original Sloc in the generic unit, and the Sloc of
371 -- the instantiation itself. See Sinput.ads for details.
373 -- Subprogram instances create two callable entities: one is the visible
374 -- subprogram instance, and the other is an anonymous subprogram nested
375 -- within a wrapper package that contains the renamings for the actuals.
376 -- Both of these entities have the Sloc of the defining entity in the
377 -- instantiation node. This simplifies some ASIS queries.
379 -----------------------
380 -- Field Definitions --
381 -----------------------
383 -- In the following node definitions, all fields, both syntactic and
384 -- semantic, are documented. The one exception is in the case of entities
385 -- (defining identifiers, character literals and operator symbols), where
386 -- the usage of the fields depends on the entity kind. Entity fields are
387 -- fully documented in the separate package Einfo.
389 -- In the node definitions, three common sets of fields are abbreviated to
390 -- save both space in the documentation, and also space in the string
391 -- (defined in Tree_Print_Strings) used to print trees. The following
392 -- abbreviations are used:
394 -- Note: the utility program that creates the Treeprs spec (in the file
395 -- xtreeprs.adb) knows about the special fields here, so it must be
396 -- modified if any change is made to these fields.
398 -- "plus fields for binary operator"
399 -- Chars (Name1) Name_Id for the operator
400 -- Left_Opnd (Node2) left operand expression
401 -- Right_Opnd (Node3) right operand expression
402 -- Entity (Node4-Sem) defining entity for operator
403 -- Associated_Node (Node4-Sem) for generic processing
404 -- Do_Overflow_Check (Flag17-Sem) set if overflow check needed
405 -- Has_Private_View (Flag11-Sem) set in generic units.
407 -- "plus fields for unary operator"
408 -- Chars (Name1) Name_Id for the operator
409 -- Right_Opnd (Node3) right operand expression
410 -- Entity (Node4-Sem) defining entity for operator
411 -- Associated_Node (Node4-Sem) for generic processing
412 -- Do_Overflow_Check (Flag17-Sem) set if overflow check needed
413 -- Has_Private_View (Flag11-Sem) set in generic units.
415 -- "plus fields for expression"
416 -- Paren_Count number of parentheses levels
417 -- Etype (Node5-Sem) type of the expression
418 -- Is_Overloaded (Flag5-Sem) >1 type interpretation exists
419 -- Is_Static_Expression (Flag6-Sem) set for static expression
420 -- Raises_Constraint_Error (Flag7-Sem) evaluation raises CE
421 -- Must_Not_Freeze (Flag8-Sem) set if must not freeze
422 -- Do_Range_Check (Flag9-Sem) set if a range check needed
423 -- Assignment_OK (Flag15-Sem) set if modification is OK
424 -- Is_Controlling_Actual (Flag16-Sem) set for controlling argument
426 -- Note: see under (EXPRESSION) for further details on the use of
427 -- the Paren_Count field to record the number of parentheses levels.
429 -- Node_Kind is the type used in the Nkind field to indicate the node kind.
430 -- The actual definition of this type is given later (the reason for this
431 -- is that we want the descriptions ordered by logical chapter in the RM,
432 -- but the type definition is reordered to facilitate the definition of
433 -- some subtype ranges. The individual descriptions of the nodes show how
434 -- the various fields are used in each node kind, as well as providing
435 -- logical names for the fields. Functions and procedures are provided for
436 -- accessing and setting these fields using these logical names.
438 -----------------------
439 -- Gigi Restrictions --
440 -----------------------
442 -- The tree passed to Gigi is more restricted than the general tree form.
443 -- For example, as a result of expansion, most of the tasking nodes can
444 -- never appear. For each node to which either a complete or partial
445 -- restriction applies, a note entitled "Gigi restriction" appears which
446 -- documents the restriction.
448 -- Note that most of these restrictions apply only to trees generated when
449 -- code is being generated, since they involved expander actions that
450 -- destroy the tree.
452 ------------------------
453 -- Common Flag Fields --
454 ------------------------
456 -- The following flag fields appear in all nodes
458 -- Analyzed (Flag1)
459 -- This flag is used to indicate that a node (and all its children have
460 -- been analyzed. It is used to avoid reanalysis of a node that has
461 -- already been analyzed, both for efficiency and functional correctness
462 -- reasons.
464 -- Comes_From_Source (Flag2)
465 -- This flag is set if the node comes directly from an explicit construct
466 -- in the source. It is normally on for any nodes built by the scanner or
467 -- parser from the source program, with the exception that in a few cases
468 -- the parser adds nodes to normalize the representation (in particular
469 -- a null statement is added to a package body if there is no begin/end
470 -- initialization section.
472 -- Most nodes inserted by the analyzer or expander are not considered
473 -- as coming from source, so the flag is off for such nodes. In a few
474 -- cases, the expander constructs nodes closely equivalent to nodes
475 -- from the source program (e.g. the allocator built for build-in-place
476 -- case), and the Comes_From_Source flag is deliberately set.
478 -- Error_Posted (Flag3)
479 -- This flag is used to avoid multiple error messages being posted on or
480 -- referring to the same node. This flag is set if an error message
481 -- refers to a node or is posted on its source location, and has the
482 -- effect of inhibiting further messages involving this same node.
484 -- Has_Dynamic_Length_Check (Flag10-Sem)
485 -- This flag is present on all nodes. It is set to indicate that one of
486 -- the routines in unit Checks has generated a length check action which
487 -- has been inserted at the flagged node. This is used to avoid the
488 -- generation of duplicate checks.
490 -- Has_Dynamic_Range_Check (Flag12-Sem)
491 -- This flag is present on all nodes. It is set to indicate that one of
492 -- the routines in unit Checks has generated a range check action which
493 -- has been inserted at the flagged node. This is used to avoid the
494 -- generation of duplicate checks.
496 -- Has_Local_Raise (Flag8-Sem)
497 -- Present in exception handler nodes. Set if the handler can be entered
498 -- via a local raise that gets transformed to a goto statement. This will
499 -- always be set if Local_Raise_Statements is non-empty, but can also be
500 -- set as a result of generation of N_Raise_xxx nodes, or flags set in
501 -- nodes requiring generation of back end checks.
503 ------------------------------------
504 -- Description of Semantic Fields --
505 ------------------------------------
507 -- The meaning of the syntactic fields is generally clear from their names
508 -- without any further description, since the names are chosen to
509 -- correspond very closely to the syntax in the reference manual. This
510 -- section describes the usage of the semantic fields, which are used to
511 -- contain additional information determined during semantic analysis.
513 -- ABE_Is_Certain (Flag18-Sem)
514 -- This flag is set in an instantiation node or a call node is determined
515 -- to be sure to raise an ABE. This is used to trigger special handling
516 -- of such cases, particularly in the instantiation case where we avoid
517 -- instantiating the body if this flag is set. This flag is also present
518 -- in an N_Formal_Package_Declaration_Node since formal package
519 -- declarations are treated like instantiations, but it is always set to
520 -- False in this context.
522 -- Accept_Handler_Records (List5-Sem)
523 -- This field is present only in an N_Accept_Alternative node. It is used
524 -- to temporarily hold the exception handler records from an accept
525 -- statement in a selective accept. These exception handlers will
526 -- eventually be placed in the Handler_Records list of the procedure
527 -- built for this accept (see Expand_N_Selective_Accept procedure in
528 -- Exp_Ch9 for further details).
530 -- Access_Types_To_Process (Elist2-Sem)
531 -- Present in N_Freeze_Entity nodes for Incomplete or private types.
532 -- Contains the list of access types which may require specific treatment
533 -- when the nature of the type completion is completely known. An example
534 -- of such treatment is the generation of the associated_final_chain.
536 -- Actions (List1-Sem)
537 -- This field contains a sequence of actions that are associated with the
538 -- node holding the field. See the individual node types for details of
539 -- how this field is used, as well as the description of the specific use
540 -- for a particular node type.
542 -- Activation_Chain_Entity (Node3-Sem)
543 -- This is used in tree nodes representing task activators (blocks,
544 -- subprogram bodies, package declarations, and task bodies). It is
545 -- initially Empty, and then gets set to point to the entity for the
546 -- declared Activation_Chain variable when the first task is declared.
547 -- When tasks are declared in the corresponding declarative region this
548 -- entity is located by name (its name is always _Chain) and the declared
549 -- tasks are added to the chain. Note that N_Extended_Return_Statement
550 -- does not have this attribute, although it does have an activation
551 -- chain. This chain is used to store the tasks temporarily, and is not
552 -- used for activating them. On successful completion of the return
553 -- statement, the tasks are moved to the caller's chain, and the caller
554 -- activates them.
556 -- Acts_As_Spec (Flag4-Sem)
557 -- A flag set in the N_Subprogram_Body node for a subprogram body which
558 -- is acting as its own spec, except in the case of a library level
559 -- subprogram, in which case the flag is set on the parent compilation
560 -- unit node instead (see further description in spec of Lib package).
561 -- ??? Above note about Lib is dubious since lib.ads does not mention
562 -- Acts_As_Spec at all.
564 -- Actual_Designated_Subtype (Node4-Sem)
565 -- Present in N_Free_Statement and N_Explicit_Dereference nodes. If gigi
566 -- needs to known the dynamic constrained subtype of the designated
567 -- object, this attribute is set to that type. This is done for
568 -- N_Free_Statements for access-to-classwide types and access to
569 -- unconstrained packed array types, and for N_Explicit_Dereference when
570 -- the designated type is an unconstrained packed array and the
571 -- dereference is the prefix of a 'Size attribute reference.
573 -- Address_Warning_Posted (Flag18-Sem)
574 -- Present in N_Attribute_Definition nodes. Set to indicate that we have
575 -- posted a warning for the address clause regarding size or alignment
576 -- issues. Used to inhibit multiple redundant messages.
578 -- Aggregate_Bounds (Node3-Sem)
579 -- Present in array N_Aggregate nodes. If the bounds of the aggregate are
580 -- known at compile time, this field points to an N_Range node with those
581 -- bounds. Otherwise Empty.
583 -- All_Others (Flag11-Sem)
584 -- Present in an N_Others_Choice node. This flag is set for an others
585 -- exception where all exceptions are to be caught, even those that are
586 -- not normally handled (in particular the tasking abort signal). This
587 -- is used for translation of the at end handler into a normal exception
588 -- handler.
590 -- Assignment_OK (Flag15-Sem)
591 -- This flag is set in a subexpression node for an object, indicating
592 -- that the associated object can be modified, even if this would not
593 -- normally be permissible (either by direct assignment, or by being
594 -- passed as an out or in-out parameter). This is used by the expander
595 -- for a number of purposes, including initialization of constants and
596 -- limited type objects (such as tasks), setting discriminant fields,
597 -- setting tag values, etc. N_Object_Declaration nodes also have this
598 -- flag defined. Here it is used to indicate that an initialization
599 -- expression is valid, even where it would normally not be allowed
600 -- (e.g. where the type involved is limited).
602 -- Associated_Node (Node4-Sem)
603 -- Present in nodes that can denote an entity: identifiers, character
604 -- literals, operator symbols, expanded names, operator nodes, and
605 -- attribute reference nodes (all these nodes have an Entity field).
606 -- This field is also present in N_Aggregate, N_Selected_Component, and
607 -- N_Extension_Aggregate nodes. This field is used in generic processing
608 -- to create links between the generic template and the generic copy.
609 -- See Sem_Ch12.Get_Associated_Node for full details. Note that this
610 -- field overlaps Entity, which is fine, since, as explained in Sem_Ch12,
611 -- the normal function of Entity is not required at the point where the
612 -- Associated_Node is set. Note also, that in generic templates, this
613 -- means that the Entity field does not necessarily point to an Entity.
614 -- Since the back end is expected to ignore generic templates, this is
615 -- harmless.
617 -- At_End_Proc (Node1)
618 -- This field is present in an N_Handled_Sequence_Of_Statements node.
619 -- It contains an identifier reference for the cleanup procedure to be
620 -- called. See description of this node for further details.
622 -- Backwards_OK (Flag6-Sem)
623 -- A flag present in the N_Assignment_Statement node. It is used only
624 -- if the type being assigned is an array type, and is set if analysis
625 -- determines that it is definitely safe to do the copy backwards, i.e.
626 -- starting at the highest addressed element. This is the case if either
627 -- the operands do not overlap, or they may overlap, but if they do,
628 -- then the left operand is at a higher address than the right operand.
630 -- Note: If neither of the flags Forwards_OK or Backwards_OK is set, it
631 -- means that the front end could not determine that either direction is
632 -- definitely safe, and a runtime check may be required if the backend
633 -- cannot figure it out. If both flags Forwards_OK and Backwards_OK are
634 -- set, it means that the front end can assure no overlap of operands.
636 -- Body_To_Inline (Node3-Sem)
637 -- present in subprogram declarations. Denotes analyzed but unexpanded
638 -- body of subprogram, to be used when inlining calls. Present when the
639 -- subprogram has an Inline pragma and inlining is enabled. If the
640 -- declaration is completed by a renaming_as_body, and the renamed en-
641 -- tity is a subprogram, the Body_To_Inline is the name of that entity,
642 -- which is used directly in later calls to the original subprogram.
644 -- Body_Required (Flag13-Sem)
645 -- A flag that appears in the N_Compilation_Unit node indicating that
646 -- the corresponding unit requires a body. For the package case, this
647 -- indicates that a completion is required. In Ada 95, if the flag is not
648 -- set for the package case, then a body may not be present. In Ada 83,
649 -- if the flag is not set for the package case, then body is optional.
650 -- For a subprogram declaration, the flag is set except in the case where
651 -- a pragma Import or Interface applies, in which case no body is
652 -- permitted (in Ada 83 or Ada 95).
654 -- By_Ref (Flag5-Sem)
655 -- Present in N_Simple_Return_Statement and N_Extended_Return_Statement,
656 -- this flag is set when the returned expression is already allocated on
657 -- the secondary stack and thus the result is passed by reference rather
658 -- than copied another time.
660 -- Check_Address_Alignment (Flag11-Sem)
661 -- A flag present in N_Attribute_Definition clause for a 'Address
662 -- attribute definition. This flag is set if a dynamic check should be
663 -- generated at the freeze point for the entity to which this address
664 -- clause applies. The reason that we need this flag is that we want to
665 -- check for range checks being suppressed at the point where the
666 -- attribute definition clause is given, rather than testing this at the
667 -- freeze point.
669 -- Coextensions (Elist4-Sem)
670 -- Present in allocators nodes. Points to list of allocators for the
671 -- access discriminants of the allocated object.
673 -- Comes_From_Extended_Return_Statement (Flag18-Sem)
674 -- Present in N_Simple_Return_Statement nodes. True if this node was
675 -- constructed as part of the N_Extended_Return_Statement expansion.
677 -- Compile_Time_Known_Aggregate (Flag18-Sem)
678 -- Present in N_Aggregate nodes. Set for aggregates which can be fully
679 -- evaluated at compile time without raising constraint error. Such
680 -- aggregates can be passed as is to Gigi without any expansion. See
681 -- Sem_Aggr for the specific conditions under which an aggregate has this
682 -- flag set. See also the flag Static_Processing_OK.
684 -- Componentwise_Assignment (Flag14-Sem)
685 -- Present in N_Assignment_Statement nodes. Set for a record assignment
686 -- where all that needs doing is to expand it into component-by-component
687 -- assignments. This is used internally for the case of tagged types with
688 -- rep clauses, where we need to avoid recursion (we don't want to try to
689 -- generate a call to the primitive operation, because this is the case
690 -- where we are compiling the primitive operation). Note that when we are
691 -- expanding component assignments in this case, we never assign the _tag
692 -- field, but we recursively assign components of the parent type.
694 -- Condition_Actions (List3-Sem)
695 -- This field appears in else-if nodes and in the iteration scheme node
696 -- for while loops. This field is only used during semantic processing to
697 -- temporarily hold actions inserted into the tree. In the tree passed
698 -- to gigi, the condition actions field is always set to No_List. For
699 -- details on how this field is used, see the routine Insert_Actions in
700 -- package Exp_Util, and also the expansion routines for the relevant
701 -- nodes.
703 -- Context_Pending (Flag16-Sem)
704 -- This field appears in Compilation_Unit nodes, to indicate that the
705 -- context of the unit is being compiled. Used to detect circularities
706 -- that are not otherwise detected by the loading mechanism. Such
707 -- circularities can occur in the presence of limited and non-limited
708 -- with_clauses that mention the same units.
710 -- Controlling_Argument (Node1-Sem)
711 -- This field is set in procedure and function call nodes if the call
712 -- is a dispatching call (it is Empty for a non-dispatching call). It
713 -- indicates the source of the call's controlling tag. For procedure
714 -- calls, the Controlling_Argument is one of the actuals. For function
715 -- that has a dispatching result, it is an entity in the context of the
716 -- call that can provide a tag, or else it is the tag of the root type
717 -- of the class. It can also specify a tag directly rather than being a
718 -- tagged object. The latter is needed by the implementations of AI-239
719 -- and AI-260.
721 -- Conversion_OK (Flag14-Sem)
722 -- A flag set on type conversion nodes to indicate that the conversion
723 -- is to be considered as being valid, even though it is the case that
724 -- the conversion is not valid Ada. This is used for attributes Enum_Rep,
725 -- Fixed_Value and Integer_Value, for internal conversions done for
726 -- fixed-point operations, and for certain conversions for calls to
727 -- initialization procedures. If Conversion_OK is set, then Etype must be
728 -- set (the analyzer assumes that Etype has been set). For the case of
729 -- fixed-point operands, it also indicates that the conversion is to be
730 -- direct conversion of the underlying integer result, with no regard to
731 -- the small operand.
733 -- Corresponding_Body (Node5-Sem)
734 -- This field is set in subprogram declarations, package declarations,
735 -- entry declarations of protected types, and in generic units. It
736 -- points to the defining entity for the corresponding body (NOT the
737 -- node for the body itself).
739 -- Corresponding_Formal_Spec (Node3-Sem)
740 -- This field is set in subprogram renaming declarations, where it points
741 -- to the defining entity for a formal subprogram in the case where the
742 -- renaming corresponds to a generic formal subprogram association in an
743 -- instantiation. The field is Empty if the renaming does not correspond
744 -- to such a formal association.
746 -- Corresponding_Generic_Association (Node5-Sem)
747 -- This field is defined for object declarations and object renaming
748 -- declarations. It is set for the declarations within an instance that
749 -- map generic formals to their actuals. If set, the field points to
750 -- a generic_association which is the original parent of the expression
751 -- or name appearing in the declaration. This simplifies ASIS queries.
753 -- Corresponding_Integer_Value (Uint4-Sem)
754 -- This field is set in real literals of fixed-point types (it is not
755 -- used for floating-point types). It contains the integer value used
756 -- to represent the fixed-point value. It is also set on the universal
757 -- real literals used to represent bounds of fixed-point base types
758 -- and their first named subtypes.
760 -- Corresponding_Spec (Node5-Sem)
761 -- This field is set in subprogram, package, task, and protected body
762 -- nodes, where it points to the defining entity in the corresponding
763 -- spec. The attribute is also set in N_With_Clause nodes where it points
764 -- to the defining entity for the with'ed spec, and in a subprogram
765 -- renaming declaration when it is a Renaming_As_Body. The field is Empty
766 -- if there is no corresponding spec, as in the case of a subprogram body
767 -- that serves as its own spec.
769 -- Corresponding_Stub (Node3-Sem)
770 -- This field is present in an N_Subunit node. It holds the node in
771 -- the parent unit that is the stub declaration for the subunit. It is
772 -- set when analysis of the stub forces loading of the proper body. If
773 -- expansion of the proper body creates new declarative nodes, they are
774 -- inserted at the point of the corresponding_stub.
776 -- Dcheck_Function (Node5-Sem)
777 -- This field is present in an N_Variant node, It references the entity
778 -- for the discriminant checking function for the variant.
780 -- Debug_Statement (Node3)
781 -- This field is present in an N_Pragma node. It is used only for a Debug
782 -- pragma. The parameter is of the form of an expression, as required by
783 -- the pragma syntax, but is actually a procedure call. To simplify
784 -- semantic processing, the parser creates a copy of the argument
785 -- rearranged into a procedure call statement and places it in the
786 -- Debug_Statement field. Note that this field is considered syntactic
787 -- field, since it is created by the parser.
789 -- Default_Expression (Node5-Sem)
790 -- This field is Empty if there is no default expression. If there is a
791 -- simple default expression (one with no side effects), then this field
792 -- simply contains a copy of the Expression field (both point to the tree
793 -- for the default expression). Default_Expression is used for
794 -- conformance checking.
796 -- Discr_Check_Funcs_Built (Flag11-Sem)
797 -- This flag is present in N_Full_Type_Declaration nodes. It is set when
798 -- discriminant checking functions are constructed. The purpose is to
799 -- avoid attempting to set these functions more than once.
801 -- Do_Accessibility_Check (Flag13-Sem)
802 -- This flag is set on N_Parameter_Specification nodes to indicate
803 -- that an accessibility check is required for the parameter. It is
804 -- not yet decided who takes care of this check (TBD ???).
806 -- Do_Discriminant_Check (Flag13-Sem)
807 -- This flag is set on N_Selected_Component nodes to indicate that a
808 -- discriminant check is required using the discriminant check routine
809 -- associated with the selector. The actual check is generated by the
810 -- expander when processing selected components.
812 -- Do_Division_Check (Flag13-Sem)
813 -- This flag is set on a division operator (/ mod rem) to indicate
814 -- that a zero divide check is required. The actual check is dealt
815 -- with by the backend (all the front end does is to set the flag).
817 -- Do_Length_Check (Flag4-Sem)
818 -- This flag is set in an N_Assignment_Statement, N_Op_And, N_Op_Or,
819 -- N_Op_Xor, or N_Type_Conversion node to indicate that a length check
820 -- is required. It is not determined who deals with this flag (???).
822 -- Do_Overflow_Check (Flag17-Sem)
823 -- This flag is set on an operator where an overflow check is required on
824 -- the operation. The actual check is dealt with by the backend (all the
825 -- front end does is to set the flag). The other cases where this flag is
826 -- used is on a Type_Conversion node and for attribute reference nodes.
827 -- For a type conversion, it means that the conversion is from one base
828 -- type to another, and the value may not fit in the target base type.
829 -- See also the description of Do_Range_Check for this case. The only
830 -- attribute references which use this flag are Pred and Succ, where it
831 -- means that the result should be checked for going outside the base
832 -- range. Note that this flag is not set for modular types.
834 -- Do_Range_Check (Flag9-Sem)
835 -- This flag is set on an expression which appears in a context where a
836 -- range check is required. The target type is clear from the context.
837 -- The contexts in which this flag can appear are the following:
839 -- Right side of an assignment. In this case the target type is
840 -- taken from the left side of the assignment, which is referenced
841 -- by the Name of the N_Assignment_Statement node.
843 -- Subscript expressions in an indexed component. In this case the
844 -- target type is determined from the type of the array, which is
845 -- referenced by the Prefix of the N_Indexed_Component node.
847 -- Argument expression for a parameter, appearing either directly in
848 -- the Parameter_Associations list of a call or as the Expression of an
849 -- N_Parameter_Association node that appears in this list. In either
850 -- case, the check is against the type of the formal. Note that the
851 -- flag is relevant only in IN and IN OUT parameters, and will be
852 -- ignored for OUT parameters, where no check is required in the call,
853 -- and if a check is required on the return, it is generated explicitly
854 -- with a type conversion.
856 -- Initialization expression for the initial value in an object
857 -- declaration. In this case the Do_Range_Check flag is set on
858 -- the initialization expression, and the check is against the
859 -- range of the type of the object being declared.
861 -- The expression of a type conversion. In this case the range check is
862 -- against the target type of the conversion. See also the use of
863 -- Do_Overflow_Check on a type conversion. The distinction is that the
864 -- overflow check protects against a value that is outside the range of
865 -- the target base type, whereas a range check checks that the
866 -- resulting value (which is a value of the base type of the target
867 -- type), satisfies the range constraint of the target type.
869 -- Note: when a range check is required in contexts other than those
870 -- listed above (e.g. in a return statement), an additional type
871 -- conversion node is introduced to represent the required check.
873 -- Do_Storage_Check (Flag17-Sem)
874 -- This flag is set in an N_Allocator node to indicate that a storage
875 -- check is required for the allocation, or in an N_Subprogram_Body node
876 -- to indicate that a stack check is required in the subprogram prolog.
877 -- The N_Allocator case is handled by the routine that expands the call
878 -- to the runtime routine. The N_Subprogram_Body case is handled by the
879 -- backend, and all the semantics does is set the flag.
881 -- Do_Tag_Check (Flag13-Sem)
882 -- This flag is set on an N_Assignment_Statement, N_Function_Call,
883 -- N_Procedure_Call_Statement, N_Type_Conversion,
884 -- N_Simple_Return_Statement, or N_Extended_Return_Statement
885 -- node to indicate that the tag check can be suppressed. It is not
886 -- yet decided how this flag is used (TBD ???).
888 -- Elaborate_Present (Flag4-Sem)
889 -- This flag is set in the N_With_Clause node to indicate that pragma
890 -- Elaborate pragma appears for the with'ed units.
892 -- Elaborate_All_Desirable (Flag9-Sem)
893 -- This flag is set in the N_With_Clause mode to indicate that the static
894 -- elaboration processing has determined that an Elaborate_All pragma is
895 -- desirable for correct elaboration for this unit.
897 -- Elaborate_All_Present (Flag14-Sem)
898 -- This flag is set in the N_With_Clause node to indicate that a
899 -- pragma Elaborate_All pragma appears for the with'ed units.
901 -- Elaborate_Desirable (Flag11-Sem)
902 -- This flag is set in the N_With_Clause mode to indicate that the static
903 -- elaboration processing has determined that an Elaborate pragma is
904 -- desirable for correct elaboration for this unit.
906 -- Elaboration_Boolean (Node2-Sem)
907 -- This field is present in function and procedure specification nodes.
908 -- If set, it points to the entity for a Boolean flag that must be tested
909 -- for certain calls to check for access before elaboration. See body of
910 -- Sem_Elab for further details. This field is Empty if no elaboration
911 -- boolean is required.
913 -- Else_Actions (List3-Sem)
914 -- This field is present in conditional expression nodes. During code
915 -- expansion we use the Insert_Actions procedure (in Exp_Util) to insert
916 -- actions at an appropriate place in the tree to get elaborated at the
917 -- right time. For conditional expressions, we have to be sure that the
918 -- actions for the Else branch are only elaborated if the condition is
919 -- False. The Else_Actions field is used as a temporary parking place for
920 -- these actions. The final tree is always rewritten to eliminate the
921 -- need for this field, so in the tree passed to Gigi, this field is
922 -- always set to No_List.
924 -- Enclosing_Variant (Node2-Sem)
925 -- This field is present in the N_Variant node and identifies the Node_Id
926 -- corresponding to the immediately enclosing variant when the variant is
927 -- nested, and N_Empty otherwise. Set during semantic processing of the
928 -- variant part of a record type.
930 -- Entity (Node4-Sem)
931 -- Appears in all direct names (identifiers, character literals, and
932 -- operator symbols), as well as expanded names, and attributes that
933 -- denote entities, such as 'Class. Points to entity for corresponding
934 -- defining occurrence. Set after name resolution. For identifiers in a
935 -- WITH list, the corresponding defining occurrence is in a separately
936 -- compiled file, and Entity must be set by the library Load procedure.
938 -- Note: During name resolution, the value in Entity may be temporarily
939 -- incorrect (e.g. during overload resolution, Entity is initially set to
940 -- the first possible correct interpretation, and then later modified if
941 -- necessary to contain the correct value after resolution).
943 -- Note: This field overlaps Associated_Node, which is used during
944 -- generic processing (see Sem_Ch12 for details). Note also that in
945 -- generic templates, this means that the Entity field does not always
946 -- point to an Entity. Since the back end is expected to ignore generic
947 -- templates, this is harmless.
949 -- Note: This field also appears in N_Attribute_Definition_Clause nodes.
950 -- It is used only for stream attributes definition clauses. In this
951 -- case, it denotes a (possibly dummy) subprogram entity that is declared
952 -- conceptually at the point of the clause. Thus the visibility of the
953 -- attribute definition clause (in the sense of 8.3(23) as amended by
954 -- AI-195) can be checked by testing the visibility of that subprogram.
956 -- Note: Normally the Entity field of an identifier points to the entity
957 -- for the corresponding defining identifier, and hence the Chars field
958 -- of an identifier will match the Chars field of the entity. However,
959 -- there is no requirement that these match, and there are obscure cases
960 -- of generated code where they do not match.
962 -- Entity_Or_Associated_Node (Node4-Sem)
963 -- A synonym for both Entity and Associated_Node. Used by convention in
964 -- the code when referencing this field in cases where it is not known
965 -- whether the field contains an Entity or an Associated_Node.
967 -- Etype (Node5-Sem)
968 -- Appears in all expression nodes, all direct names, and all entities.
969 -- Points to the entity for the related type. Set after type resolution.
970 -- Normally this is the actual subtype of the expression. However, in
971 -- certain contexts such as the right side of an assignment, subscripts,
972 -- arguments to calls, returned value in a function, initial value etc.
973 -- it is the desired target type. In the event that this is different
974 -- from the actual type, the Do_Range_Check flag will be set if a range
975 -- check is required. Note: if the Is_Overloaded flag is set, then Etype
976 -- points to an essentially arbitrary choice from the possible set of
977 -- types.
979 -- Exception_Junk (Flag8-Sem)
980 -- This flag is set in a various nodes appearing in a statement sequence
981 -- to indicate that the corresponding node is an artifact of the
982 -- generated code for exception handling, and should be ignored when
983 -- analyzing the control flow of the relevant sequence of statements
984 -- (e.g. to check that it does not end with a bad return statement).
986 -- Exception_Label (Node5-Sem)
987 -- Appears in N_Push_xxx_Label nodes. Points to the entity of the label
988 -- to be used for transforming the corresponding exception into a goto,
989 -- or contains Empty, if this exception is not to be transformed. Also
990 -- appears in N_Exception_Handler nodes, where, if set, it indicates
991 -- that there may be a local raise for the handler, so that expansion
992 -- to allow a goto is required (and this field contains the label for
993 -- this goto). See Exp_Ch11.Expand_Local_Exception_Handlers for details.
995 -- Expansion_Delayed (Flag11-Sem)
996 -- Set on aggregates and extension aggregates that need a top-down rather
997 -- than bottom-up expansion. Typically aggregate expansion happens bottom
998 -- up. For nested aggregates the expansion is delayed until the enclosing
999 -- aggregate itself is expanded, e.g. in the context of a declaration. To
1000 -- delay it we set this flag. This is done to avoid creating a temporary
1001 -- for each level of a nested aggregates, and also to prevent the
1002 -- premature generation of constraint checks. This is also a requirement
1003 -- if we want to generate the proper attachment to the internal
1004 -- finalization lists (for record with controlled components). Top down
1005 -- expansion of aggregates is also used for in-place array aggregate
1006 -- assignment or initialization. When the full context is known, the
1007 -- target of the assignment or initialization is used to generate the
1008 -- left-hand side of individual assignment to each sub-component.
1010 -- First_Inlined_Subprogram (Node3-Sem)
1011 -- Present in the N_Compilation_Unit node for the main program. Points
1012 -- to a chain of entities for subprograms that are to be inlined. The
1013 -- Next_Inlined_Subprogram field of these entities is used as a link
1014 -- pointer with Empty marking the end of the list. This field is Empty
1015 -- if there are no inlined subprograms or inlining is not active.
1017 -- First_Named_Actual (Node4-Sem)
1018 -- Present in procedure call statement and function call nodes, and also
1019 -- in Intrinsic nodes. Set during semantic analysis to point to the first
1020 -- named parameter where parameters are ordered by declaration order (as
1021 -- opposed to the actual order in the call which may be different due to
1022 -- named associations). Note: this field points to the explicit actual
1023 -- parameter itself, not the N_Parameter_Association node (its parent).
1025 -- First_Real_Statement (Node2-Sem)
1026 -- Present in N_Handled_Sequence_Of_Statements node. Normally set to
1027 -- Empty. Used only when declarations are moved into the statement part
1028 -- of a construct as a result of wrapping an AT END handler that is
1029 -- required to cover the declarations. In this case, this field is used
1030 -- to remember the location in the statements list of the first real
1031 -- statement, i.e. the statement that used to be first in the statement
1032 -- list before the declarations were prepended.
1034 -- First_Subtype_Link (Node5-Sem)
1035 -- Present in N_Freeze_Entity node for an anonymous base type that is
1036 -- implicitly created by the declaration of a first subtype. It points
1037 -- to the entity for the first subtype.
1039 -- Float_Truncate (Flag11-Sem)
1040 -- A flag present in type conversion nodes. This is used for float to
1041 -- integer conversions where truncation is required rather than rounding.
1042 -- Note that Gigi does not handle type conversions from real to integer
1043 -- with rounding (see Expand_N_Type_Conversion).
1045 -- Forwards_OK (Flag5-Sem)
1046 -- A flag present in the N_Assignment_Statement node. It is used only
1047 -- if the type being assigned is an array type, and is set if analysis
1048 -- determines that it is definitely safe to do the copy forwards, i.e.
1049 -- starting at the lowest addressed element. This is the case if either
1050 -- the operands do not overlap, or they may overlap, but if they do,
1051 -- then the left operand is at a lower address than the right operand.
1053 -- Note: If neither of the flags Forwards_OK or Backwards_OK is set, it
1054 -- means that the front end could not determine that either direction is
1055 -- definitely safe, and a runtime check may be required if the backend
1056 -- cannot figure it out. If both flags Forwards_OK and Backwards_OK are
1057 -- set, it means that the front end can assure no overlap of operands.
1059 -- From_At_End (Flag4-Sem)
1060 -- This flag is set on an N_Raise_Statement node if it corresponds to
1061 -- the reraise statement generated as the last statement of an AT END
1062 -- handler when SJLJ exception handling is active. It is used to stop
1063 -- a bogus violation of restriction (No_Exception_Propagation), bogus
1064 -- because if the restriction is set, the reraise is not generated.
1066 -- From_At_Mod (Flag4-Sem)
1067 -- This flag is set on the attribute definition clause node that is
1068 -- generated by a transformation of an at mod phrase in a record
1069 -- representation clause. This is used to give slightly different (Ada 83
1070 -- compatible) semantics to such a clause, namely it is used to specify a
1071 -- minimum acceptable alignment for the base type and all subtypes. In
1072 -- Ada 95 terms, the actual alignment of the base type and all subtypes
1073 -- must be a multiple of the given value, and the representation clause
1074 -- is considered to be type specific instead of subtype specific.
1076 -- From_Default (Flag6-Sem)
1077 -- This flag is set on the subprogram renaming declaration created in an
1078 -- instance for a formal subprogram, when the formal is declared with a
1079 -- box, and there is no explicit actual. If the flag is present, the
1080 -- declaration is treated as an implicit reference to the formal in the
1081 -- ali file.
1083 -- Generic_Parent (Node5-Sem)
1084 -- Generic_Parent is defined on declaration nodes that are instances. The
1085 -- value of Generic_Parent is the generic entity from which the instance
1086 -- is obtained. Generic_Parent is also defined for the renaming
1087 -- declarations and object declarations created for the actuals in an
1088 -- instantiation. The generic parent of such a declaration is the
1089 -- corresponding generic association in the Instantiation node.
1091 -- Generic_Parent_Type (Node4-Sem)
1092 -- Generic_Parent_Type is defined on Subtype_Declaration nodes for the
1093 -- actuals of formal private and derived types. Within the instance, the
1094 -- operations on the actual are those inherited from the parent. For a
1095 -- formal private type, the parent type is the generic type itself. The
1096 -- Generic_Parent_Type is also used in an instance to determine whether a
1097 -- private operation overrides an inherited one.
1099 -- Handler_List_Entry (Node2-Sem)
1100 -- This field is present in N_Object_Declaration nodes. It is set only
1101 -- for the Handler_Record entry generated for an exception in zero cost
1102 -- exception handling mode. It references the corresponding item in the
1103 -- handler list, and is used to delete this entry if the corresponding
1104 -- handler is deleted during optimization. For further details on why
1105 -- this is required, see Exp_Ch11.Remove_Handler_Entries.
1107 -- Has_No_Elaboration_Code (Flag17-Sem)
1108 -- A flag that appears in the N_Compilation_Unit node to indicate whether
1109 -- or not elaboration code is present for this unit. It is initially set
1110 -- true for subprogram specs and bodies and for all generic units and
1111 -- false for non-generic package specs and bodies. Gigi may set the flag
1112 -- in the non-generic package case if it determines that no elaboration
1113 -- code is generated. Note that this flag is not related to the
1114 -- Is_Preelaborated status, there can be preelaborated packages that
1115 -- generate elaboration code, and non-preelaborated packages which do
1116 -- not generate elaboration code.
1118 -- Has_Priority_Pragma (Flag6-Sem)
1119 -- A flag present in N_Subprogram_Body, N_Task_Definition and
1120 -- N_Protected_Definition nodes to flag the presence of either a Priority
1121 -- or Interrupt_Priority pragma in the declaration sequence (public or
1122 -- private in the task and protected cases)
1124 -- Has_Private_View (Flag11-Sem)
1125 -- A flag present in generic nodes that have an entity, to indicate that
1126 -- the node has a private type. Used to exchange private and full
1127 -- declarations if the visibility at instantiation is different from the
1128 -- visibility at generic definition.
1130 -- Has_Relative_Deadline_Pragma (Flag9-Sem)
1131 -- A flag present in N_Subprogram_Body and N_Task_Definition nodes to
1132 -- flag the presence of a pragma Relative_Deadline.
1134 -- Has_Self_Reference (Flag13-Sem)
1135 -- Present in N_Aggregate and N_Extension_Aggregate. Indicates that one
1136 -- of the expressions contains an access attribute reference to the
1137 -- enclosing type. Such a self-reference can only appear in default-
1138 -- initialized aggregate for a record type.
1140 -- Has_Storage_Size_Pragma (Flag5-Sem)
1141 -- A flag present in an N_Task_Definition node to flag the presence of a
1142 -- Storage_Size pragma.
1144 -- Has_Task_Info_Pragma (Flag7-Sem)
1145 -- A flag present in an N_Task_Definition node to flag the presence of a
1146 -- Task_Info pragma. Used to detect duplicate pragmas.
1148 -- Has_Task_Name_Pragma (Flag8-Sem)
1149 -- A flag present in N_Task_Definition nodes to flag the presence of a
1150 -- Task_Name pragma in the declaration sequence for the task.
1152 -- Has_Wide_Character (Flag11-Sem)
1153 -- Present in string literals, set if any wide character (i.e. character
1154 -- code outside the Character range but within Wide_Character range)
1155 -- appears in the string. Used to implement pragma preference rules.
1157 -- Has_Wide_Wide_Character (Flag13-Sem)
1158 -- Present in string literals, set if any wide character (i.e. character
1159 -- code outside the Wide_Character range) appears in the string. Used to
1160 -- implement pragma preference rules.
1162 -- Hidden_By_Use_Clause (Elist4-Sem)
1163 -- An entity list present in use clauses that appear within
1164 -- instantiations. For the resolution of local entities, entities
1165 -- introduced by these use clauses have priority over global ones, and
1166 -- outer entities must be explicitly hidden/restored on exit.
1168 -- Implicit_With (Flag16-Sem)
1169 -- This flag is set in the N_With_Clause node that is implicitly
1170 -- generated for runtime units that are loaded by the expander, and also
1171 -- for package System, if it is loaded implicitly by a use of the
1172 -- 'Address or 'Tag attribute. ???There are other implicit with clauses
1173 -- as well.
1175 -- Import_Interface_Present (Flag16-Sem)
1176 -- This flag is set in an Interface or Import pragma if a matching
1177 -- pragma of the other kind is also present. This is used to avoid
1178 -- generating some unwanted error messages.
1180 -- Includes_Infinities (Flag11-Sem)
1181 -- This flag is present in N_Range nodes. It is set for the range of
1182 -- unconstrained float types defined in Standard, which include not only
1183 -- the given range of values, but also legitimately can include infinite
1184 -- values. This flag is false for any float type for which an explicit
1185 -- range is given by the programmer, even if that range is identical to
1186 -- the range for Float.
1188 -- Inherited_Discriminant (Flag13-Sem)
1189 -- This flag is present in N_Component_Association nodes. It indicates
1190 -- that a given component association in an extension aggregate is the
1191 -- value obtained from a constraint on an ancestor. Used to prevent
1192 -- double expansion when the aggregate has expansion delayed.
1194 -- Instance_Spec (Node5-Sem)
1195 -- This field is present in generic instantiation nodes, and also in
1196 -- formal package declaration nodes (formal package declarations are
1197 -- treated in a manner very similar to package instantiations). It points
1198 -- to the node for the spec of the instance, inserted as part of the
1199 -- semantic processing for instantiations in Sem_Ch12.
1201 -- Is_Accessibility_Actual (Flag12-Sem)
1202 -- Present in N_Parameter_Association nodes. True if the parameter is
1203 -- an extra actual that carries the accessibility level of the actual
1204 -- for an access parameter, in a function that dispatches on result and
1205 -- is called in a dispatching context. Used to prevent a formal/actual
1206 -- mismatch when the call is rewritten as a dispatching call.
1208 -- Is_Asynchronous_Call_Block (Flag7-Sem)
1209 -- A flag set in a Block_Statement node to indicate that it is the
1210 -- expansion of an asynchronous entry call. Such a block needs cleanup
1211 -- handler to assure that the call is cancelled.
1213 -- Is_Component_Left_Opnd (Flag13-Sem)
1214 -- Is_Component_Right_Opnd (Flag14-Sem)
1215 -- Present in concatenation nodes, to indicate that the corresponding
1216 -- operand is of the component type of the result. Used in resolving
1217 -- concatenation nodes in instances.
1219 -- Is_Controlling_Actual (Flag16-Sem)
1220 -- This flag is set on in an expression that is a controlling argument in
1221 -- a dispatching call. It is off in all other cases. See Sem_Disp for
1222 -- details of its use.
1224 -- Is_Dynamic_Coextension (Flag18-Sem)
1225 -- Present in allocator nodes, to indicate that this is an allocator
1226 -- for an access discriminant of a dynamically allocated object. The
1227 -- coextension must be deallocated and finalized at the same time as
1228 -- the enclosing object.
1230 -- Is_Entry_Barrier_Function (Flag8-Sem)
1231 -- This flag is set in an N_Subprogram_Body node which is the expansion
1232 -- of an entry barrier from a protected entry body. It is used for the
1233 -- circuitry checking for incorrect use of Current_Task.
1235 -- Is_Expanded_Build_In_Place_Call (Flag11-Sem)
1236 -- This flag is set in an N_Function_Call node to indicate that the extra
1237 -- actuals to support a build-in-place style of call have been added to
1238 -- the call.
1240 -- Is_In_Discriminant_Check (Flag11-Sem)
1241 -- This flag is present in a selected component, and is used to indicate
1242 -- that the reference occurs within a discriminant check. The
1243 -- significance is that optimizations based on assuming that the
1244 -- discriminant check has a correct value cannot be performed in this
1245 -- case (or the discriminant check may be optimized away!)
1247 -- Is_Machine_Number (Flag11-Sem)
1248 -- This flag is set in an N_Real_Literal node to indicate that the value
1249 -- is a machine number. This avoids some unnecessary cases of converting
1250 -- real literals to machine numbers.
1252 -- Is_Null_Loop (Flag16-Sem)
1253 -- This flag is set in an N_Loop_Statement node if the corresponding loop
1254 -- can be determined to be null at compile time. This is used to remove
1255 -- the loop entirely at expansion time.
1257 -- Is_Overloaded (Flag5-Sem)
1258 -- A flag present in all expression nodes. Used temporarily during
1259 -- overloading determination. The setting of this flag is not relevant
1260 -- once overloading analysis is complete.
1262 -- Is_Power_Of_2_For_Shift (Flag13-Sem)
1263 -- A flag present only in N_Op_Expon nodes. It is set when the
1264 -- exponentiation is of the form 2 ** N, where the type of N is an
1265 -- unsigned integral subtype whose size does not exceed the size of
1266 -- Standard_Integer (i.e. a type that can be safely converted to
1267 -- Natural), and the exponentiation appears as the right operand of an
1268 -- integer multiplication or an integer division where the dividend is
1269 -- unsigned. It is also required that overflow checking is off for both
1270 -- the exponentiation and the multiply/divide node. If this set of
1271 -- conditions holds, and the flag is set, then the division or
1272 -- multiplication can be (and is) converted to a shift.
1274 -- Is_Protected_Subprogram_Body (Flag7-Sem)
1275 -- A flag set in a Subprogram_Body block to indicate that it is the
1276 -- implementation of a protected subprogram. Such a body needs cleanup
1277 -- handler to make sure that the associated protected object is unlocked
1278 -- when the subprogram completes.
1280 -- Is_Static_Coextension (Flag14-Sem)
1281 -- Present in N_Allocator nodes. Set if the allocator is a coextension
1282 -- of an object allocated on the stack rather than the heap.
1284 -- Is_Static_Expression (Flag6-Sem)
1285 -- Indicates that an expression is a static expression (RM 4.9). See spec
1286 -- of package Sem_Eval for full details on the use of this flag.
1288 -- Is_Subprogram_Descriptor (Flag16-Sem)
1289 -- Present in N_Object_Declaration, and set only for the object
1290 -- declaration generated for a subprogram descriptor in fast exception
1291 -- mode. See Exp_Ch11 for details of use.
1293 -- Is_Task_Allocation_Block (Flag6-Sem)
1294 -- A flag set in a Block_Statement node to indicate that it is the
1295 -- expansion of a task allocator, or the allocator of an object
1296 -- containing tasks. Such a block requires a cleanup handler to call
1297 -- Expunge_Unactivated_Tasks to complete any tasks that have been
1298 -- allocated but not activated when the allocator completes abnormally.
1300 -- Is_Task_Master (Flag5-Sem)
1301 -- A flag set in a Subprogram_Body, Block_Statement or Task_Body node to
1302 -- indicate that the construct is a task master (i.e. has declared tasks
1303 -- or declares an access to a task type).
1305 -- Itype (Node1-Sem)
1306 -- Used in N_Itype_Reference node to reference an itype for which it is
1307 -- important to ensure that it is defined. See description of this node
1308 -- for further details.
1310 -- Kill_Range_Check (Flag11-Sem)
1311 -- Used in an N_Unchecked_Type_Conversion node to indicate that the
1312 -- result should not be subjected to range checks. This is used for the
1313 -- implementation of Normalize_Scalars.
1315 -- Label_Construct (Node2-Sem)
1316 -- Used in an N_Implicit_Label_Declaration node. Refers to an N_Label,
1317 -- N_Block_Statement or N_Loop_Statement node to which the label
1318 -- declaration applies. This is not currently used in the compiler
1319 -- itself, but it is useful in the implementation of ASIS queries.
1320 -- This field is left empty for the special labels generated as part
1321 -- of expanding raise statements with a local exception handler.
1323 -- Library_Unit (Node4-Sem)
1324 -- In a stub node, Library_Unit points to the compilation unit node of
1325 -- the corresponding subunit.
1327 -- In a with clause node, Library_Unit points to the spec of the with'ed
1328 -- unit.
1330 -- In a compilation unit node, the usage depends on the unit type:
1332 -- For a library unit body, Library_Unit points to the compilation unit
1333 -- node of the corresponding spec, unless it's a subprogram body with
1334 -- Acts_As_Spec set, in which case it points to itself.
1336 -- For a spec, Library_Unit points to the compilation unit node of the
1337 -- corresponding body, if present. The body will be present if the spec
1338 -- is or contains generics that we needed to instantiate. Similarly, the
1339 -- body will be present if we needed it for inlining purposes. Thus, if
1340 -- we have a spec/body pair, both of which are present, they point to
1341 -- each other via Library_Unit.
1343 -- For a subunit, Library_Unit points to the compilation unit node of
1344 -- the parent body.
1346 -- Note that this field is not used to hold the parent pointer for child
1347 -- unit (which might in any case need to use it for some other purpose as
1348 -- described above). Instead for a child unit, implicit with's are
1349 -- generated for all parents.
1351 -- Local_Raise_Statements (Elist1)
1352 -- This field is present in exception handler nodes. It is set to
1353 -- No_Elist in the normal case. If there is at least one raise statement
1354 -- which can potentially be handled as a local raise, then this field
1355 -- points to a list of raise nodes, which are calls to a routine to raise
1356 -- an exception. These are raise nodes which can be optimized into gotos
1357 -- if the handler turns out to meet the conditions which permit this
1358 -- transformation. Note that this does NOT include instances of the
1359 -- N_Raise_xxx_Error nodes since the transformation of these nodes is
1360 -- handled by the back end (using the N_Push/N_Pop mechanism).
1362 -- Loop_Actions (List2-Sem)
1363 -- A list present in Component_Association nodes in array aggregates.
1364 -- Used to collect actions that must be executed within the loop because
1365 -- they may need to be evaluated anew each time through.
1367 -- Limited_View_Installed (Flag18-Sem)
1368 -- Present in With_Clauses and in package specifications. If set on
1369 -- with_clause, it indicates that this clause has created the current
1370 -- limited view of the designated package. On a package specification, it
1371 -- indicates that the limited view has already been created because the
1372 -- package is mentioned in a limited_with_clause in the closure of the
1373 -- unit being compiled.
1375 -- Local_Raise_Not_OK (Flag7-Sem)
1376 -- Present in N_Exception_Handler nodes. Set if the handler contains
1377 -- a construct (reraise statement, or call to subprogram in package
1378 -- GNAT.Current_Exception) that makes the handler unsuitable as a target
1379 -- for a local raise (one that could otherwise be converted to a goto).
1381 -- Must_Be_Byte_Aligned (Flag14-Sem)
1382 -- This flag is present in N_Attribute_Reference nodes. It can be set
1383 -- only for the Address and Unrestricted_Access attributes. If set it
1384 -- means that the object for which the address/access is given must be on
1385 -- a byte (more accurately a storage unit) boundary. If necessary, a copy
1386 -- of the object is to be made before taking the address (this copy is in
1387 -- the current scope on the stack frame). This is used for certain cases
1388 -- of code generated by the expander that passes parameters by address.
1390 -- The reason the copy is not made by the front end is that the back end
1391 -- has more information about type layout and may be able to (but is not
1392 -- guaranteed to) prevent making unnecessary copies.
1394 -- Must_Not_Freeze (Flag8-Sem)
1395 -- A flag present in all expression nodes. Normally expressions cause
1396 -- freezing as described in the RM. If this flag is set, then this is
1397 -- inhibited. This is used by the analyzer and expander to label nodes
1398 -- that are created by semantic analysis or expansion and which must not
1399 -- cause freezing even though they normally would. This flag is also
1400 -- present in an N_Subtype_Indication node, since we also use these in
1401 -- calls to Freeze_Expression.
1403 -- Next_Entity (Node2-Sem)
1404 -- Present in defining identifiers, defining character literals and
1405 -- defining operator symbols (i.e. in all entities). The entities of a
1406 -- scope are chained, and this field is used as the forward pointer for
1407 -- this list. See Einfo for further details.
1409 -- Next_Exit_Statement (Node3-Sem)
1410 -- Present in N_Exit_Statement nodes. The exit statements for a loop are
1411 -- chained (in reverse order of appearence) from the First_Exit_Statement
1412 -- field of the E_Loop entity for the loop. Next_Exit_Statement points to
1413 -- the next entry on this chain (Empty = end of list).
1415 -- Next_Implicit_With (Node3-Sem)
1416 -- Present in N_With_Clause. Part of a chain of with_clauses generated
1417 -- in rtsfind to indicate implicit dependencies on predefined units. Used
1418 -- to prevent multiple with_clauses for the same unit in a given context.
1419 -- A postorder traversal of the tree whose nodes are units and whose
1420 -- links are with_clauses defines the order in which Inspector must
1421 -- examine a compiled unit and its full context. This ordering ensures
1422 -- that any subprogram call is examined after the subprogram declartion
1423 -- has been seen.
1425 -- Next_Named_Actual (Node4-Sem)
1426 -- Present in parameter association node. Set during semantic analysis to
1427 -- point to the next named parameter, where parameters are ordered by
1428 -- declaration order (as opposed to the actual order in the call, which
1429 -- may be different due to named associations). Not that this field
1430 -- points to the explicit actual parameter itself, not to the
1431 -- N_Parameter_Association node (its parent).
1433 -- Next_Pragma (Node1-Sem)
1434 -- Present in N_Pragma nodes. Used to create a linked list of pragma
1435 -- nodes. Currently used for two purposes:
1437 -- Create a list of linked Check_Policy pragmas. The head of this list
1438 -- is stored in Opt.Check_Policy_List (which has further details).
1440 -- Used by processing for Pre/Postcondition pragmas to store a list of
1441 -- pragmas associated with the spec of a subprogram (see Sem_Prag for
1442 -- details).
1444 -- Next_Rep_Item (Node5-Sem)
1445 -- Present in pragma nodes and attribute definition nodes. Used to link
1446 -- representation items that apply to an entity. See description of
1447 -- First_Rep_Item field in Einfo for full details.
1449 -- Next_Use_Clause (Node3-Sem)
1450 -- While use clauses are active during semantic processing, they are
1451 -- chained from the scope stack entry, using Next_Use_Clause as a link
1452 -- pointer, with Empty marking the end of the list. The head pointer is
1453 -- in the scope stack entry (First_Use_Clause). At the end of semantic
1454 -- processing (i.e. when Gigi sees the tree, the contents of this field
1455 -- is undefined and should not be read).
1457 -- No_Ctrl_Actions (Flag7-Sem)
1458 -- Present in N_Assignment_Statement to indicate that no finalize nor
1459 -- adjust should take place on this assignment even though the rhs is
1460 -- controlled. This is used in init procs and aggregate expansions where
1461 -- the generated assignments are more initialisations than real
1462 -- assignments.
1464 -- No_Elaboration_Check (Flag14-Sem)
1465 -- Present in N_Function_Call and N_Procedure_Call_Statement. Indicates
1466 -- that no elaboration check is needed on the call, because it appears in
1467 -- the context of a local Suppress pragma. This is used on calls within
1468 -- task bodies, where the actual elaboration checks are applied after
1469 -- analysis, when the local scope stack is not present.
1471 -- No_Entities_Ref_In_Spec (Flag8-Sem)
1472 -- Present in N_With_Clause nodes. Set if the with clause is on the
1473 -- package or subprogram spec where the main unit is the corresponding
1474 -- body, and no entities of the with'ed unit are referenced by the spec
1475 -- (an entity may still be referenced in the body, so this flag is used
1476 -- to generate the proper message (see Sem_Util.Check_Unused_Withs for
1477 -- full details)
1479 -- No_Initialization (Flag13-Sem)
1480 -- Present in N_Object_Declaration and N_Allocator to indicate that the
1481 -- object must not be initialized (by Initialize or call to an init
1482 -- proc). This is needed for controlled aggregates. When the Object
1483 -- declaration has an expression, this flag means that this expression
1484 -- should not be taken into account (needed for in place initialization
1485 -- with aggregates).
1487 -- No_Truncation (Flag17-Sem)
1488 -- Present in N_Unchecked_Type_Conversion node. This flag has an effect
1489 -- only if the RM_Size of the source is greater than the RM_Size of the
1490 -- target for scalar operands. Normally in such a case we truncate some
1491 -- higher order bits of the source, and then sign/zero extend the result
1492 -- to form the output value. But if this flag is set, then we do not do
1493 -- any truncation, so for example, if an 8 bit input is converted to 5
1494 -- bit result which is in fact stored in 8 bits, then the high order
1495 -- three bits of the target result will be copied from the source. This
1496 -- is used for properly setting out of range values for use by pragmas
1497 -- Initialize_Scalars and Normalize_Scalars.
1499 -- Original_Discriminant (Node2-Sem)
1500 -- Present in identifiers. Used in references to discriminants that
1501 -- appear in generic units. Because the names of the discriminants may be
1502 -- different in an instance, we use this field to recover the position of
1503 -- the discriminant in the original type, and replace it with the
1504 -- discriminant at the same position in the instantiated type.
1506 -- Original_Entity (Node2-Sem)
1507 -- Present in numeric literals. Used to denote the named number that has
1508 -- been constant-folded into the given literal. If literal is from
1509 -- source, or the result of some other constant-folding operation, then
1510 -- Original_Entity is empty. This field is needed to handle properly
1511 -- named numbers in generic units, where the Associated_Node field
1512 -- interferes with the Entity field, making it impossible to preserve the
1513 -- original entity at the point of instantiation (ASIS problem).
1515 -- Others_Discrete_Choices (List1-Sem)
1516 -- When a case statement or variant is analyzed, the semantic checks
1517 -- determine the actual list of choices that correspond to an others
1518 -- choice. This list is materialized for later use by the expander and
1519 -- the Others_Discrete_Choices field of an N_Others_Choice node points to
1520 -- this materialized list of choices, which is in standard format for a
1521 -- list of discrete choices, except that of course it cannot contain an
1522 -- N_Others_Choice entry.
1524 -- Parameter_List_Truncated (Flag17-Sem)
1525 -- Present in N_Function_Call and N_Procedure_Call_Statement nodes. Set
1526 -- (for OpenVMS ports of GNAT only) if the parameter list is truncated as
1527 -- a result of a First_Optional_Parameter specification in an
1528 -- Import_Function, Import_Procedure, or Import_Valued_Procedure pragma.
1529 -- The truncation is done by the expander by removing trailing parameters
1530 -- from the argument list, in accordance with the set of rules allowing
1531 -- such parameter removal. In particular, parameters can be removed
1532 -- working from the end of the parameter list backwards up to and
1533 -- including the entry designated by First_Optional_Parameter in the
1534 -- Import pragma. Parameters can be removed if they are implicit and the
1535 -- default value is a known-at-compile-time value, including the use of
1536 -- the Null_Parameter attribute, or if explicit parameter values are
1537 -- present that match the corresponding defaults.
1539 -- Parent_Spec (Node4-Sem)
1540 -- For a library unit that is a child unit spec (package or subprogram
1541 -- declaration, generic declaration or instantiation, or library level
1542 -- rename, this field points to the compilation unit node for the parent
1543 -- package specification. This field is Empty for library bodies (the
1544 -- parent spec in this case can be found from the corresponding spec).
1546 -- Pragma_Enabled (Flag5-Sem)
1547 -- Present in N_Pragma nodes. This flag is relevant only for pragmas
1548 -- Assert, Check, Precondition, and Postcondition. It is true if the
1549 -- check corresponding to the pragma type is enabled at the point where
1550 -- the pragma appears.
1552 -- Present_Expr (Uint3-Sem)
1553 -- Present in an N_Variant node. This has a meaningful value only after
1554 -- Gigi has back annotated the tree with representation information. At
1555 -- this point, it contains a reference to a gcc expression that depends
1556 -- on the values of one or more discriminants. Give a set of discriminant
1557 -- values, this expression evaluates to False (zero) if variant is not
1558 -- present, and True (non-zero) if it is present. See unit Repinfo for
1559 -- further details on gigi back annotation. This field is used during
1560 -- ASIS processing (data decomposition annex) to determine if a field is
1561 -- present or not.
1563 -- Print_In_Hex (Flag13-Sem)
1564 -- Set on an N_Integer_Literal node to indicate that the value should be
1565 -- printed in hexadecimal in the sprint listing. Has no effect on
1566 -- legality or semantics of program, only on the displayed output. This
1567 -- is used to clarify output from the packed array cases.
1569 -- Procedure_To_Call (Node2-Sem)
1570 -- Present in N_Allocator, N_Free_Statement, N_Simple_Return_Statement,
1571 -- and N_Extended_Return_Statement nodes. References the entity for the
1572 -- declaration of the procedure to be called to accomplish the required
1573 -- operation (i.e. for the Allocate procedure in the case of N_Allocator
1574 -- and N_Simple_Return_Statement and N_Extended_Return_Statement (for
1575 -- allocating the return value), and for the Deallocate procedure in the
1576 -- case of N_Free_Statement.
1578 -- Raises_Constraint_Error (Flag7-Sem)
1579 -- Set on an expression whose evaluation will definitely fail constraint
1580 -- error check. In the case of static expressions, this flag must be set
1581 -- accurately (and if it is set, the expression is typically illegal
1582 -- unless it appears as a non-elaborated branch of a short-circuit form).
1583 -- For a non-static expression, this flag may be set whenever an
1584 -- expression (e.g. an aggregate) is known to raise constraint error. If
1585 -- set, the expression definitely will raise CE if elaborated at runtime.
1586 -- If not set, the expression may or may not raise CE. In other words, on
1587 -- static expressions, the flag is set accurately, on non-static
1588 -- expressions it is set conservatively.
1590 -- Redundant_Use (Flag13-Sem)
1591 -- Present in nodes that can appear as an operand in a use clause or use
1592 -- type clause (identifiers, expanded names, attribute references). Set
1593 -- to indicate that a use is redundant (and therefore need not be undone
1594 -- on scope exit).
1596 -- Renaming_Exception (Node2-Sem)
1597 -- Present in N_Exception_Declaration node. Used to point back to the
1598 -- exception renaming for an exception declared within a subprogram.
1599 -- What happens is that an exception declared in a subprogram is moved
1600 -- to the library level with a unique name, and the original exception
1601 -- becomes a renaming. This link from the library level exception to the
1602 -- renaming declaration allows registering of the proper exception name.
1604 -- Return_Statement_Entity (Node5-Sem)
1605 -- Present in N_Simple_Return_Statement and N_Extended_Return_Statement.
1606 -- Points to an E_Return_Statement representing the return statement.
1608 -- Return_Object_Declarations (List3)
1609 -- Present in N_Extended_Return_Statement.
1610 -- Points to a list initially containing a single
1611 -- N_Object_Declaration representing the return object.
1612 -- We use a list (instead of just a pointer to the object decl)
1613 -- because Analyze wants to insert extra actions on this list.
1615 -- Rounded_Result (Flag18-Sem)
1616 -- Present in N_Type_Conversion, N_Op_Divide and N_Op_Multiply nodes.
1617 -- Used in the fixed-point cases to indicate that the result must be
1618 -- rounded as a result of the use of the 'Round attribute. Also used for
1619 -- integer N_Op_Divide nodes to indicate that the result should be
1620 -- rounded to the nearest integer (breaking ties away from zero), rather
1621 -- than truncated towards zero as usual. These rounded integer operations
1622 -- are the result of expansion of rounded fixed-point divide, conversion
1623 -- and multiplication operations.
1625 -- SCIL_Entity (Node4-Sem)
1626 -- Present in SCIL nodes. Used to reference the tagged type associated
1627 -- with the SCIL node.
1629 -- SCIL_Controlling_Tag (Node5-Sem)
1630 -- Present in N_SCIL_Dispatching_Call nodes. Used to reference the
1631 -- controlling tag of a dispatching call.
1633 -- SCIL_Tag_Value (Node5-Sem)
1634 -- Present in N_SCIL_Membership_Test nodes. Used to reference the tag
1635 -- value that is being tested.
1637 -- SCIL_Target_Prim (Node2-Sem)
1638 -- Present in N_SCIL_Dispatching_Call nodes. Used to reference the tagged
1639 -- type primitive associated with the SCIL node.
1641 -- Scope (Node3-Sem)
1642 -- Present in defining identifiers, defining character literals and
1643 -- defining operator symbols (i.e. in all entities). The entities of a
1644 -- scope all use this field to reference the corresponding scope entity.
1645 -- See Einfo for further details.
1647 -- Shift_Count_OK (Flag4-Sem)
1648 -- A flag present in shift nodes to indicate that the shift count is
1649 -- known to be in range, i.e. is in the range from zero to word length
1650 -- minus one. If this flag is not set, then the shift count may be
1651 -- outside this range, i.e. larger than the word length, and the code
1652 -- must ensure that such shift counts give the appropriate result.
1654 -- Source_Type (Node1-Sem)
1655 -- Used in an N_Validate_Unchecked_Conversion node to point to the
1656 -- source type entity for the unchecked conversion instantiation
1657 -- which gigi must do size validation for.
1659 -- Static_Processing_OK (Flag4-Sem)
1660 -- Present in N_Aggregate nodes. When the Compile_Time_Known_Aggregate
1661 -- flag is set, the full value of the aggregate can be determined at
1662 -- compile time and the aggregate can be passed as is to the back-end.
1663 -- In this event it is irrelevant whether this flag is set or not.
1664 -- However, if the flag Compile_Time_Known_Aggregate is not set but
1665 -- Static_Processing_OK is set, the aggregate can (but need not) be
1666 -- converted into a compile time known aggregate by the expander. See
1667 -- Sem_Aggr for the specific conditions under which an aggregate has its
1668 -- Static_Processing_OK flag set.
1670 -- Storage_Pool (Node1-Sem)
1671 -- Present in N_Allocator, N_Free_Statement, N_Simple_Return_Statement,
1672 -- and N_Extended_Return_Statement nodes. References the entity for the
1673 -- storage pool to be used for the allocate or free call or for the
1674 -- allocation of the returned value from function. Empty indicates that
1675 -- the global default pool is to be used. Note that in the case
1676 -- of a return statement, this field is set only if the function returns
1677 -- value of a type whose size is not known at compile time on the
1678 -- secondary stack.
1680 -- Suppress_Loop_Warnings (Flag17-Sem)
1681 -- Used in N_Loop_Statement node to indicate that warnings within the
1682 -- body of the loop should be suppressed. This is set when the range
1683 -- of a FOR loop is known to be null, or is probably null (loop would
1684 -- only execute if invalid values are present).
1686 -- Target_Type (Node2-Sem)
1687 -- Used in an N_Validate_Unchecked_Conversion node to point to the target
1688 -- type entity for the unchecked conversion instantiation which gigi must
1689 -- do size validation for.
1691 -- Then_Actions (List3-Sem)
1692 -- This field is present in conditional expression nodes. During code
1693 -- expansion we use the Insert_Actions procedure (in Exp_Util) to insert
1694 -- actions at an appropriate place in the tree to get elaborated at the
1695 -- right time. For conditional expressions, we have to be sure that the
1696 -- actions for the Then branch are only elaborated if the condition is
1697 -- True. The Then_Actions field is used as a temporary parking place for
1698 -- these actions. The final tree is always rewritten to eliminate the
1699 -- need for this field, so in the tree passed to Gigi, this field is
1700 -- always set to No_List.
1702 -- Treat_Fixed_As_Integer (Flag14-Sem)
1703 -- This flag appears in operator nodes for divide, multiply, mod and rem
1704 -- on fixed-point operands. It indicates that the operands are to be
1705 -- treated as integer values, ignoring small values. This flag is only
1706 -- set as a result of expansion of fixed-point operations. Typically a
1707 -- fixed-point multiplication in the source generates subsidiary
1708 -- multiplication and division operations that work with the underlying
1709 -- integer values and have this flag set. Note that this flag is not
1710 -- needed on other arithmetic operations (add, neg, subtract etc.) since
1711 -- in these cases it is always the case that fixed is treated as integer.
1712 -- The Etype field MUST be set if this flag is set. The analyzer knows to
1713 -- leave such nodes alone, and whoever makes them must set the correct
1714 -- Etype value.
1716 -- TSS_Elist (Elist3-Sem)
1717 -- Present in N_Freeze_Entity nodes. Holds an element list containing
1718 -- entries for each TSS (type support subprogram) associated with the
1719 -- frozen type. The elements of the list are the entities for the
1720 -- subprograms (see package Exp_TSS for further details). Set to No_Elist
1721 -- if there are no type support subprograms for the type or if the freeze
1722 -- node is not for a type.
1724 -- Unreferenced_In_Spec (Flag7-Sem)
1725 -- Present in N_With_Clause nodes. Set if the with clause is on the
1726 -- package or subprogram spec where the main unit is the corresponding
1727 -- body, and is not referenced by the spec (it may still be referenced by
1728 -- the body, so this flag is used to generate the proper message (see
1729 -- Sem_Util.Check_Unused_Withs for details)
1731 -- Was_Originally_Stub (Flag13-Sem)
1732 -- This flag is set in the node for a proper body that replaces stub.
1733 -- During the analysis procedure, stubs in some situations get rewritten
1734 -- by the corresponding bodies, and we set this flag to remember that
1735 -- this happened. Note that it is not good enough to rely on the use of
1736 -- Original_Node here because of the case of nested instantiations where
1737 -- the substituted node can be copied.
1739 -- Withed_Body (Node1-Sem)
1740 -- Present in N_With_Clause nodes. Set if the unit in whose context
1741 -- the with_clause appears instantiates a generic contained in the
1742 -- library unit of the with_clause and as a result loads its body.
1743 -- Used for a more precise unit traversal for CodePeer.
1745 -- Zero_Cost_Handling (Flag5-Sem)
1746 -- This flag is set in all handled sequence of statement and exception
1747 -- handler nodes if exceptions are to be handled using the zero-cost
1748 -- mechanism (see Ada.Exceptions and System.Exceptions in files
1749 -- a-except.ads/adb and s-except.ads for full details). What gigi needs
1750 -- to do for such a handler is simply to put the code in the handler
1751 -- somewhere. The front end has generated all necessary labels.
1753 --------------------------------------------------
1754 -- Note on Use of End_Label and End_Span Fields --
1755 --------------------------------------------------
1757 -- Several constructs have end lines:
1759 -- Loop Statement end loop [loop_IDENTIFIER];
1760 -- Package Specification end [[PARENT_UNIT_NAME .] IDENTIFIER]
1761 -- Task Definition end [task_IDENTIFIER]
1762 -- Protected Definition end [protected_IDENTIFIER]
1763 -- Protected Body end [protected_IDENTIFIER]
1765 -- Block Statement end [block_IDENTIFIER];
1766 -- Subprogram Body end [DESIGNATOR];
1767 -- Package Body end [[PARENT_UNIT_NAME .] IDENTIFIER];
1768 -- Task Body end [task_IDENTIFIER];
1769 -- Accept Statement end [entry_IDENTIFIER]];
1770 -- Entry Body end [entry_IDENTIFIER];
1772 -- If Statement end if;
1773 -- Case Statement end case;
1775 -- Record Definition end record;
1776 -- Enumeration Definition );
1778 -- The End_Label and End_Span fields are used to mark the locations of
1779 -- these lines, and also keep track of the label in the case where a label
1780 -- is present.
1782 -- For the first group above, the End_Label field of the corresponding node
1783 -- is used to point to the label identifier. In the case where there is no
1784 -- label in the source, the parser supplies a dummy identifier (with
1785 -- Comes_From_Source set to False), and the Sloc of this dummy identifier
1786 -- marks the location of the token following the END token.
1788 -- For the second group, the use of End_Label is similar, but the End_Label
1789 -- is found in the N_Handled_Sequence_Of_Statements node. This is done
1790 -- simply because in some cases there is no room in the parent node.
1792 -- For the third group, there is never any label, and instead of using
1793 -- End_Label, we use the End_Span field which gives the location of the
1794 -- token following END, relative to the starting Sloc of the construct,
1795 -- i.e. add Sloc (Node) + End_Span (Node) to get the Sloc of the IF or CASE
1796 -- following the End_Label.
1798 -- The record definition case is handled specially, we treat it as though
1799 -- it required an optional label which is never present, and so the parser
1800 -- always builds a dummy identifier with Comes From Source set False. The
1801 -- reason we do this, rather than using End_Span in this case, is that we
1802 -- want to generate a cross-ref entry for the end of a record, since it
1803 -- represents a scope for name declaration purposes.
1805 -- The enumeration definition case is handled in an exactly similar manner,
1806 -- building a dummy identifier to get a cross-reference.
1808 -- Note: the reason we store the difference as a Uint, instead of storing
1809 -- the Source_Ptr value directly, is that Source_Ptr values cannot be
1810 -- distinguished from other types of values, and we count on all general
1811 -- use fields being self describing. To make things easier for clients,
1812 -- note that we provide function End_Location, and procedure
1813 -- Set_End_Location to allow access to the logical value (which is the
1814 -- Source_Ptr value for the end token).
1816 ---------------------
1817 -- Syntactic Nodes --
1818 ---------------------
1820 ---------------------
1821 -- 2.3 Identifier --
1822 ---------------------
1824 -- IDENTIFIER ::= IDENTIFIER_LETTER {[UNDERLINE] LETTER_OR_DIGIT}
1825 -- LETTER_OR_DIGIT ::= IDENTIFIER_LETTER | DIGIT
1827 -- An IDENTIFIER shall not be a reserved word
1829 -- In the Ada grammar identifiers are the bottom level tokens which have
1830 -- very few semantics. Actual program identifiers are direct names. If
1831 -- we were being 100% honest with the grammar, then we would have a node
1832 -- called N_Direct_Name which would point to an identifier. However,
1833 -- that's too many extra nodes, so we just use the N_Identifier node
1834 -- directly as a direct name, and it contains the expression fields and
1835 -- Entity field that correspond to its use as a direct name. In those
1836 -- few cases where identifiers appear in contexts where they are not
1837 -- direct names (pragmas, pragma argument associations, attribute
1838 -- references and attribute definition clauses), the Chars field of the
1839 -- node contains the Name_Id for the identifier name.
1841 -- Note: in GNAT, a reserved word can be treated as an identifier in two
1842 -- cases. First, an incorrect use of a reserved word as an identifier is
1843 -- diagnosed and then treated as a normal identifier. Second, an
1844 -- attribute designator of the form of a reserved word (access, delta,
1845 -- digits, range) is treated as an identifier.
1847 -- Note: The set of letters that is permitted in an identifier depends
1848 -- on the character set in use. See package Csets for full details.
1850 -- N_Identifier
1851 -- Sloc points to identifier
1852 -- Chars (Name1) contains the Name_Id for the identifier
1853 -- Entity (Node4-Sem)
1854 -- Associated_Node (Node4-Sem)
1855 -- Original_Discriminant (Node2-Sem)
1856 -- Redundant_Use (Flag13-Sem)
1857 -- Has_Private_View (Flag11-Sem) (set in generic units)
1858 -- plus fields for expression
1860 --------------------------
1861 -- 2.4 Numeric Literal --
1862 --------------------------
1864 -- NUMERIC_LITERAL ::= DECIMAL_LITERAL | BASED_LITERAL
1866 ----------------------------
1867 -- 2.4.1 Decimal Literal --
1868 ----------------------------
1870 -- DECIMAL_LITERAL ::= NUMERAL [.NUMERAL] [EXPONENT]
1872 -- NUMERAL ::= DIGIT {[UNDERLINE] DIGIT}
1874 -- EXPONENT ::= E [+] NUMERAL | E - NUMERAL
1876 -- Decimal literals appear in the tree as either integer literal nodes
1877 -- or real literal nodes, depending on whether a period is present.
1879 -- Note: literal nodes appear as a result of direct use of literals
1880 -- in the source program, and also as the result of evaluating
1881 -- expressions at compile time. In the latter case, it is possible
1882 -- to construct real literals that have no syntactic representation
1883 -- using the standard literal format. Such literals are listed by
1884 -- Sprint using the notation [numerator / denominator].
1886 -- Note: the value of an integer literal node created by the front end
1887 -- is never outside the range of values of the base type. However, it
1888 -- can be the case that the value is outside the range of the
1889 -- particular subtype. This happens in the case of integer overflows
1890 -- with checks suppressed.
1892 -- N_Integer_Literal
1893 -- Sloc points to literal
1894 -- Original_Entity (Node2-Sem) If not Empty, holds Named_Number that
1895 -- has been constant-folded into its literal value.
1896 -- Intval (Uint3) contains integer value of literal
1897 -- plus fields for expression
1898 -- Print_In_Hex (Flag13-Sem)
1900 -- N_Real_Literal
1901 -- Sloc points to literal
1902 -- Original_Entity (Node2-Sem) If not Empty, holds Named_Number that
1903 -- has been constant-folded into its literal value.
1904 -- Realval (Ureal3) contains real value of literal
1905 -- Corresponding_Integer_Value (Uint4-Sem)
1906 -- Is_Machine_Number (Flag11-Sem)
1907 -- plus fields for expression
1909 --------------------------
1910 -- 2.4.2 Based Literal --
1911 --------------------------
1913 -- BASED_LITERAL ::=
1914 -- BASE # BASED_NUMERAL [.BASED_NUMERAL] # [EXPONENT]
1916 -- BASE ::= NUMERAL
1918 -- BASED_NUMERAL ::=
1919 -- EXTENDED_DIGIT {[UNDERLINE] EXTENDED_DIGIT}
1921 -- EXTENDED_DIGIT ::= DIGIT | A | B | C | D | E | F
1923 -- Based literals appear in the tree as either integer literal nodes
1924 -- or real literal nodes, depending on whether a period is present.
1926 ----------------------------
1927 -- 2.5 Character Literal --
1928 ----------------------------
1930 -- CHARACTER_LITERAL ::= ' GRAPHIC_CHARACTER '
1932 -- N_Character_Literal
1933 -- Sloc points to literal
1934 -- Chars (Name1) contains the Name_Id for the identifier
1935 -- Char_Literal_Value (Uint2) contains the literal value
1936 -- Entity (Node4-Sem)
1937 -- Associated_Node (Node4-Sem)
1938 -- Has_Private_View (Flag11-Sem) set in generic units.
1939 -- plus fields for expression
1941 -- Note: the Entity field will be missing (set to Empty) for character
1942 -- literals whose type is Standard.Wide_Character or Standard.Character
1943 -- or a type derived from one of these two. In this case the character
1944 -- literal stands for its own coding. The reason we take this irregular
1945 -- short cut is to avoid the need to build lots of junk defining
1946 -- character literal nodes.
1948 -------------------------
1949 -- 2.6 String Literal --
1950 -------------------------
1952 -- STRING LITERAL ::= "{STRING_ELEMENT}"
1954 -- A STRING_ELEMENT is either a pair of quotation marks ("), or a
1955 -- single GRAPHIC_CHARACTER other than a quotation mark.
1957 -- Is_Folded_In_Parser is True if the parser created this literal by
1958 -- folding a sequence of "&" operators. For example, if the source code
1959 -- says "aaa" & "bbb" & "ccc", and this produces "aaabbbccc", the flag
1960 -- is set. This flag is needed because the parser doesn't know about
1961 -- visibility, so the folded result might be wrong, and semantic
1962 -- analysis needs to check for that.
1964 -- N_String_Literal
1965 -- Sloc points to literal
1966 -- Strval (Str3) contains Id of string value
1967 -- Has_Wide_Character (Flag11-Sem)
1968 -- Has_Wide_Wide_Character (Flag13-Sem)
1969 -- Is_Folded_In_Parser (Flag4)
1970 -- plus fields for expression
1972 ------------------
1973 -- 2.7 Comment --
1974 ------------------
1976 -- A COMMENT starts with two adjacent hyphens and extends up to the
1977 -- end of the line. A COMMENT may appear on any line of a program.
1979 -- Comments are skipped by the scanner and do not appear in the tree.
1980 -- It is possible to reconstruct the position of comments with respect
1981 -- to the elements of the tree by using the source position (Sloc)
1982 -- pointers that appear in every tree node.
1984 -----------------
1985 -- 2.8 Pragma --
1986 -----------------
1988 -- PRAGMA ::= pragma IDENTIFIER
1989 -- [(PRAGMA_ARGUMENT_ASSOCIATION {, PRAGMA_ARGUMENT_ASSOCIATION})];
1991 -- Note that a pragma may appear in the tree anywhere a declaration
1992 -- or a statement may appear, as well as in some other situations
1993 -- which are explicitly documented.
1995 -- N_Pragma
1996 -- Sloc points to PRAGMA
1997 -- Next_Pragma (Node1-Sem)
1998 -- Pragma_Argument_Associations (List2) (set to No_List if none)
1999 -- Debug_Statement (Node3) (set to Empty if not Debug, Assert)
2000 -- Pragma_Identifier (Node4)
2001 -- Next_Rep_Item (Node5-Sem)
2002 -- Pragma_Enabled (Flag5-Sem)
2003 -- Import_Interface_Present (Flag16-Sem)
2005 -- Note: we should have a section on what pragmas are passed on to
2006 -- the back end to be processed. This section should note that pragma
2007 -- Psect_Object is always converted to Common_Object, but there are
2008 -- undoubtedly many other similar notes required ???
2010 -- Note: a utility function Pragma_Name may be applied to pragma nodes
2011 -- to conveniently obtain the Chars field of the Pragma_Identifier.
2013 --------------------------------------
2014 -- 2.8 Pragma Argument Association --
2015 --------------------------------------
2017 -- PRAGMA_ARGUMENT_ASSOCIATION ::=
2018 -- [pragma_argument_IDENTIFIER =>] NAME
2019 -- | [pragma_argument_IDENTIFIER =>] EXPRESSION
2021 -- N_Pragma_Argument_Association
2022 -- Sloc points to first token in association
2023 -- Chars (Name1) (set to No_Name if no pragma argument identifier)
2024 -- Expression (Node3)
2026 ------------------------
2027 -- 2.9 Reserved Word --
2028 ------------------------
2030 -- Reserved words are parsed by the scanner, and returned as the
2031 -- corresponding token types (e.g. PACKAGE is returned as Tok_Package)
2033 ----------------------------
2034 -- 3.1 Basic Declaration --
2035 ----------------------------
2037 -- BASIC_DECLARATION ::=
2038 -- TYPE_DECLARATION | SUBTYPE_DECLARATION
2039 -- | OBJECT_DECLARATION | NUMBER_DECLARATION
2040 -- | SUBPROGRAM_DECLARATION | ABSTRACT_SUBPROGRAM_DECLARATION
2041 -- | PACKAGE_DECLARATION | RENAMING_DECLARATION
2042 -- | EXCEPTION_DECLARATION | GENERIC_DECLARATION
2043 -- | GENERIC_INSTANTIATION
2045 -- Basic declaration also includes IMPLICIT_LABEL_DECLARATION
2046 -- see further description in section on semantic nodes.
2048 -- Also, in the tree that is constructed, a pragma may appear
2049 -- anywhere that a declaration may appear.
2051 ------------------------------
2052 -- 3.1 Defining Identifier --
2053 ------------------------------
2055 -- DEFINING_IDENTIFIER ::= IDENTIFIER
2057 -- A defining identifier is an entity, which has additional fields
2058 -- depending on the setting of the Ekind field. These additional
2059 -- fields are defined (and access subprograms declared) in package
2060 -- Einfo.
2062 -- Note: N_Defining_Identifier is an extended node whose fields are
2063 -- deliberate layed out to match the layout of fields in an ordinary
2064 -- N_Identifier node allowing for easy alteration of an identifier
2065 -- node into a defining identifier node. For details, see procedure
2066 -- Sinfo.CN.Change_Identifier_To_Defining_Identifier.
2068 -- N_Defining_Identifier
2069 -- Sloc points to identifier
2070 -- Chars (Name1) contains the Name_Id for the identifier
2071 -- Next_Entity (Node2-Sem)
2072 -- Scope (Node3-Sem)
2073 -- Etype (Node5-Sem)
2075 -----------------------------
2076 -- 3.2.1 Type Declaration --
2077 -----------------------------
2079 -- TYPE_DECLARATION ::=
2080 -- FULL_TYPE_DECLARATION
2081 -- | INCOMPLETE_TYPE_DECLARATION
2082 -- | PRIVATE_TYPE_DECLARATION
2083 -- | PRIVATE_EXTENSION_DECLARATION
2085 ----------------------------------
2086 -- 3.2.1 Full Type Declaration --
2087 ----------------------------------
2089 -- FULL_TYPE_DECLARATION ::=
2090 -- type DEFINING_IDENTIFIER [KNOWN_DISCRIMINANT_PART]
2091 -- is TYPE_DEFINITION;
2092 -- | TASK_TYPE_DECLARATION
2093 -- | PROTECTED_TYPE_DECLARATION
2095 -- The full type declaration node is used only for the first case. The
2096 -- second case (concurrent type declaration), is represented directly
2097 -- by a task type declaration or a protected type declaration.
2099 -- N_Full_Type_Declaration
2100 -- Sloc points to TYPE
2101 -- Defining_Identifier (Node1)
2102 -- Discriminant_Specifications (List4) (set to No_List if none)
2103 -- Type_Definition (Node3)
2104 -- Discr_Check_Funcs_Built (Flag11-Sem)
2106 ----------------------------
2107 -- 3.2.1 Type Definition --
2108 ----------------------------
2110 -- TYPE_DEFINITION ::=
2111 -- ENUMERATION_TYPE_DEFINITION | INTEGER_TYPE_DEFINITION
2112 -- | REAL_TYPE_DEFINITION | ARRAY_TYPE_DEFINITION
2113 -- | RECORD_TYPE_DEFINITION | ACCESS_TYPE_DEFINITION
2114 -- | DERIVED_TYPE_DEFINITION | INTERFACE_TYPE_DEFINITION
2116 --------------------------------
2117 -- 3.2.2 Subtype Declaration --
2118 --------------------------------
2120 -- SUBTYPE_DECLARATION ::=
2121 -- subtype DEFINING_IDENTIFIER is [NULL_EXCLUSION] SUBTYPE_INDICATION;
2123 -- The subtype indication field is set to Empty for subtypes
2124 -- declared in package Standard (Positive, Natural).
2126 -- N_Subtype_Declaration
2127 -- Sloc points to SUBTYPE
2128 -- Defining_Identifier (Node1)
2129 -- Null_Exclusion_Present (Flag11)
2130 -- Subtype_Indication (Node5)
2131 -- Generic_Parent_Type (Node4-Sem) (set for an actual derived type).
2132 -- Exception_Junk (Flag8-Sem)
2134 -------------------------------
2135 -- 3.2.2 Subtype Indication --
2136 -------------------------------
2138 -- SUBTYPE_INDICATION ::= SUBTYPE_MARK [CONSTRAINT]
2140 -- Note: if no constraint is present, the subtype indication appears
2141 -- directly in the tree as a subtype mark. The N_Subtype_Indication
2142 -- node is used only if a constraint is present.
2144 -- Note: [For Ada 2005 (AI-231)]: Because Ada 2005 extends this rule
2145 -- with the null-exclusion part (see AI-231), we had to introduce a new
2146 -- attribute in all the parents of subtype_indication nodes to indicate
2147 -- if the null-exclusion is present.
2149 -- Note: the reason that this node has expression fields is that a
2150 -- subtype indication can appear as an operand of a membership test.
2152 -- N_Subtype_Indication
2153 -- Sloc points to first token of subtype mark
2154 -- Subtype_Mark (Node4)
2155 -- Constraint (Node3)
2156 -- Etype (Node5-Sem)
2157 -- Must_Not_Freeze (Flag8-Sem)
2159 -- Note: Etype is a copy of the Etype field of the Subtype_Mark. The
2160 -- reason for this redundancy is so that in a list of array index types,
2161 -- the Etype can be uniformly accessed to determine the subscript type.
2162 -- This means that no Itype is constructed for the actual subtype that
2163 -- is created by the subtype indication. If such an Itype is required,
2164 -- it is constructed in the context in which the indication appears.
2166 -------------------------
2167 -- 3.2.2 Subtype Mark --
2168 -------------------------
2170 -- SUBTYPE_MARK ::= subtype_NAME
2172 -----------------------
2173 -- 3.2.2 Constraint --
2174 -----------------------
2176 -- CONSTRAINT ::= SCALAR_CONSTRAINT | COMPOSITE_CONSTRAINT
2178 ------------------------------
2179 -- 3.2.2 Scalar Constraint --
2180 ------------------------------
2182 -- SCALAR_CONSTRAINT ::=
2183 -- RANGE_CONSTRAINT | DIGITS_CONSTRAINT | DELTA_CONSTRAINT
2185 ---------------------------------
2186 -- 3.2.2 Composite Constraint --
2187 ---------------------------------
2189 -- COMPOSITE_CONSTRAINT ::=
2190 -- INDEX_CONSTRAINT | DISCRIMINANT_CONSTRAINT
2192 -------------------------------
2193 -- 3.3.1 Object Declaration --
2194 -------------------------------
2196 -- OBJECT_DECLARATION ::=
2197 -- DEFINING_IDENTIFIER_LIST : [aliased] [constant]
2198 -- [NULL_EXCLUSION] SUBTYPE_INDICATION [:= EXPRESSION];
2199 -- | DEFINING_IDENTIFIER_LIST : [aliased] [constant]
2200 -- ACCESS_DEFINITION [:= EXPRESSION];
2201 -- | DEFINING_IDENTIFIER_LIST : [aliased] [constant]
2202 -- ARRAY_TYPE_DEFINITION [:= EXPRESSION];
2203 -- | SINGLE_TASK_DECLARATION
2204 -- | SINGLE_PROTECTED_DECLARATION
2206 -- Note: aliased is not permitted in Ada 83 mode
2208 -- The N_Object_Declaration node is only for the first two cases.
2209 -- Single task declaration is handled by P_Task (9.1)
2210 -- Single protected declaration is handled by P_protected (9.5)
2212 -- Although the syntax allows multiple identifiers in the list, the
2213 -- semantics is as though successive declarations were given with
2214 -- identical type definition and expression components. To simplify
2215 -- semantic processing, the parser represents a multiple declaration
2216 -- case as a sequence of single declarations, using the More_Ids and
2217 -- Prev_Ids flags to preserve the original source form as described
2218 -- in the section on "Handling of Defining Identifier Lists".
2220 -- The flag Has_Init_Expression is set if an initializing expression
2221 -- is present. Normally it is set if and only if Expression contains
2222 -- a non-empty value, but there is an exception to this. When the
2223 -- initializing expression is an aggregate which requires explicit
2224 -- assignments, the Expression field gets set to Empty, but this flag
2225 -- is still set, so we don't forget we had an initializing expression.
2227 -- Note: if a range check is required for the initialization
2228 -- expression then the Do_Range_Check flag is set in the Expression,
2229 -- with the check being done against the type given by the object
2230 -- definition, which is also the Etype of the defining identifier.
2232 -- Note: the contents of the Expression field must be ignored (i.e.
2233 -- treated as though it were Empty) if No_Initialization is set True.
2235 -- Note: the back end places some restrictions on the form of the
2236 -- Expression field. If the object being declared is Atomic, then
2237 -- the Expression may not have the form of an aggregate (since this
2238 -- might cause the back end to generate separate assignments). In this
2239 -- case the front end must generate an extra temporary and initialize
2240 -- this temporary as required (the temporary itself is not atomic).
2242 -- Note: there is not node kind for object definition. Instead, the
2243 -- corresponding field holds a subtype indication, an array type
2244 -- definition, or (Ada 2005, AI-406) an access definition.
2246 -- N_Object_Declaration
2247 -- Sloc points to first identifier
2248 -- Defining_Identifier (Node1)
2249 -- Aliased_Present (Flag4) set if ALIASED appears
2250 -- Constant_Present (Flag17) set if CONSTANT appears
2251 -- Null_Exclusion_Present (Flag11)
2252 -- Object_Definition (Node4) subtype indic./array type def./access def.
2253 -- Expression (Node3) (set to Empty if not present)
2254 -- Handler_List_Entry (Node2-Sem)
2255 -- Corresponding_Generic_Association (Node5-Sem)
2256 -- More_Ids (Flag5) (set to False if no more identifiers in list)
2257 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
2258 -- No_Initialization (Flag13-Sem)
2259 -- Assignment_OK (Flag15-Sem)
2260 -- Exception_Junk (Flag8-Sem)
2261 -- Is_Subprogram_Descriptor (Flag16-Sem)
2262 -- Has_Init_Expression (Flag14)
2264 -------------------------------------
2265 -- 3.3.1 Defining Identifier List --
2266 -------------------------------------
2268 -- DEFINING_IDENTIFIER_LIST ::=
2269 -- DEFINING_IDENTIFIER {, DEFINING_IDENTIFIER}
2271 -------------------------------
2272 -- 3.3.2 Number Declaration --
2273 -------------------------------
2275 -- NUMBER_DECLARATION ::=
2276 -- DEFINING_IDENTIFIER_LIST : constant := static_EXPRESSION;
2278 -- Although the syntax allows multiple identifiers in the list, the
2279 -- semantics is as though successive declarations were given with
2280 -- identical expressions. To simplify semantic processing, the parser
2281 -- represents a multiple declaration case as a sequence of single
2282 -- declarations, using the More_Ids and Prev_Ids flags to preserve
2283 -- the original source form as described in the section on "Handling
2284 -- of Defining Identifier Lists".
2286 -- N_Number_Declaration
2287 -- Sloc points to first identifier
2288 -- Defining_Identifier (Node1)
2289 -- Expression (Node3)
2290 -- More_Ids (Flag5) (set to False if no more identifiers in list)
2291 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
2293 ----------------------------------
2294 -- 3.4 Derived Type Definition --
2295 ----------------------------------
2297 -- DERIVED_TYPE_DEFINITION ::=
2298 -- [abstract] [limited] new [NULL_EXCLUSION] parent_SUBTYPE_INDICATION
2299 -- [[and INTERFACE_LIST] RECORD_EXTENSION_PART]
2301 -- Note: ABSTRACT, LIMITED and record extension part are not permitted
2302 -- in Ada 83 mode
2304 -- Note: a record extension part is required if ABSTRACT is present
2306 -- N_Derived_Type_Definition
2307 -- Sloc points to NEW
2308 -- Abstract_Present (Flag4)
2309 -- Null_Exclusion_Present (Flag11) (set to False if not present)
2310 -- Subtype_Indication (Node5)
2311 -- Record_Extension_Part (Node3) (set to Empty if not present)
2312 -- Limited_Present (Flag17)
2313 -- Task_Present (Flag5) set in task interfaces
2314 -- Protected_Present (Flag6) set in protected interfaces
2315 -- Synchronized_Present (Flag7) set in interfaces
2316 -- Interface_List (List2) (set to No_List if none)
2317 -- Interface_Present (Flag16) set in abstract interfaces
2319 -- Note: Task_Present, Protected_Present, Synchronized_Present,
2320 -- Interface_List, and Interface_Present are used for abstract
2321 -- interfaces (see comments for INTERFACE_TYPE_DEFINITION).
2323 ---------------------------
2324 -- 3.5 Range Constraint --
2325 ---------------------------
2327 -- RANGE_CONSTRAINT ::= range RANGE
2329 -- N_Range_Constraint
2330 -- Sloc points to RANGE
2331 -- Range_Expression (Node4)
2333 ----------------
2334 -- 3.5 Range --
2335 ----------------
2337 -- RANGE ::=
2338 -- RANGE_ATTRIBUTE_REFERENCE
2339 -- | SIMPLE_EXPRESSION .. SIMPLE_EXPRESSION
2341 -- Note: the case of a range given as a range attribute reference
2342 -- appears directly in the tree as an attribute reference.
2344 -- Note: the field name for a reference to a range is Range_Expression
2345 -- rather than Range, because range is a reserved keyword in Ada!
2347 -- Note: the reason that this node has expression fields is that a
2348 -- range can appear as an operand of a membership test. The Etype
2349 -- field is the type of the range (we do NOT construct an implicit
2350 -- subtype to represent the range exactly).
2352 -- N_Range
2353 -- Sloc points to ..
2354 -- Low_Bound (Node1)
2355 -- High_Bound (Node2)
2356 -- Includes_Infinities (Flag11)
2357 -- plus fields for expression
2359 -- Note: if the range appears in a context, such as a subtype
2360 -- declaration, where range checks are required on one or both of
2361 -- the expression fields, then type conversion nodes are inserted
2362 -- to represent the required checks.
2364 ----------------------------------------
2365 -- 3.5.1 Enumeration Type Definition --
2366 ----------------------------------------
2368 -- ENUMERATION_TYPE_DEFINITION ::=
2369 -- (ENUMERATION_LITERAL_SPECIFICATION
2370 -- {, ENUMERATION_LITERAL_SPECIFICATION})
2372 -- Note: the Literals field in the node described below is null for
2373 -- the case of the standard types CHARACTER and WIDE_CHARACTER, for
2374 -- which special processing handles these types as special cases.
2376 -- N_Enumeration_Type_Definition
2377 -- Sloc points to left parenthesis
2378 -- Literals (List1) (Empty for CHARACTER or WIDE_CHARACTER)
2379 -- End_Label (Node4) (set to Empty if internally generated record)
2381 ----------------------------------------------
2382 -- 3.5.1 Enumeration Literal Specification --
2383 ----------------------------------------------
2385 -- ENUMERATION_LITERAL_SPECIFICATION ::=
2386 -- DEFINING_IDENTIFIER | DEFINING_CHARACTER_LITERAL
2388 ---------------------------------------
2389 -- 3.5.1 Defining Character Literal --
2390 ---------------------------------------
2392 -- DEFINING_CHARACTER_LITERAL ::= CHARACTER_LITERAL
2394 -- A defining character literal is an entity, which has additional
2395 -- fields depending on the setting of the Ekind field. These
2396 -- additional fields are defined (and access subprograms declared)
2397 -- in package Einfo.
2399 -- Note: N_Defining_Character_Literal is an extended node whose fields
2400 -- are deliberate layed out to match the layout of fields in an ordinary
2401 -- N_Character_Literal node allowing for easy alteration of a character
2402 -- literal node into a defining character literal node. For details, see
2403 -- Sinfo.CN.Change_Character_Literal_To_Defining_Character_Literal.
2405 -- N_Defining_Character_Literal
2406 -- Sloc points to literal
2407 -- Chars (Name1) contains the Name_Id for the identifier
2408 -- Next_Entity (Node2-Sem)
2409 -- Scope (Node3-Sem)
2410 -- Etype (Node5-Sem)
2412 ------------------------------------
2413 -- 3.5.4 Integer Type Definition --
2414 ------------------------------------
2416 -- Note: there is an error in this rule in the latest version of the
2417 -- grammar, so we have retained the old rule pending clarification.
2419 -- INTEGER_TYPE_DEFINITION ::=
2420 -- SIGNED_INTEGER_TYPE_DEFINITION
2421 -- | MODULAR_TYPE_DEFINITION
2423 -------------------------------------------
2424 -- 3.5.4 Signed Integer Type Definition --
2425 -------------------------------------------
2427 -- SIGNED_INTEGER_TYPE_DEFINITION ::=
2428 -- range static_SIMPLE_EXPRESSION .. static_SIMPLE_EXPRESSION
2430 -- Note: the Low_Bound and High_Bound fields are set to Empty
2431 -- for integer types defined in package Standard.
2433 -- N_Signed_Integer_Type_Definition
2434 -- Sloc points to RANGE
2435 -- Low_Bound (Node1)
2436 -- High_Bound (Node2)
2438 ------------------------------------
2439 -- 3.5.4 Modular Type Definition --
2440 ------------------------------------
2442 -- MODULAR_TYPE_DEFINITION ::= mod static_EXPRESSION
2444 -- N_Modular_Type_Definition
2445 -- Sloc points to MOD
2446 -- Expression (Node3)
2448 ---------------------------------
2449 -- 3.5.6 Real Type Definition --
2450 ---------------------------------
2452 -- REAL_TYPE_DEFINITION ::=
2453 -- FLOATING_POINT_DEFINITION | FIXED_POINT_DEFINITION
2455 --------------------------------------
2456 -- 3.5.7 Floating Point Definition --
2457 --------------------------------------
2459 -- FLOATING_POINT_DEFINITION ::=
2460 -- digits static_SIMPLE_EXPRESSION [REAL_RANGE_SPECIFICATION]
2462 -- Note: The Digits_Expression and Real_Range_Specifications fields
2463 -- are set to Empty for floating-point types declared in Standard.
2465 -- N_Floating_Point_Definition
2466 -- Sloc points to DIGITS
2467 -- Digits_Expression (Node2)
2468 -- Real_Range_Specification (Node4) (set to Empty if not present)
2470 -------------------------------------
2471 -- 3.5.7 Real Range Specification --
2472 -------------------------------------
2474 -- REAL_RANGE_SPECIFICATION ::=
2475 -- range static_SIMPLE_EXPRESSION .. static_SIMPLE_EXPRESSION
2477 -- N_Real_Range_Specification
2478 -- Sloc points to RANGE
2479 -- Low_Bound (Node1)
2480 -- High_Bound (Node2)
2482 -----------------------------------
2483 -- 3.5.9 Fixed Point Definition --
2484 -----------------------------------
2486 -- FIXED_POINT_DEFINITION ::=
2487 -- ORDINARY_FIXED_POINT_DEFINITION | DECIMAL_FIXED_POINT_DEFINITION
2489 --------------------------------------------
2490 -- 3.5.9 Ordinary Fixed Point Definition --
2491 --------------------------------------------
2493 -- ORDINARY_FIXED_POINT_DEFINITION ::=
2494 -- delta static_EXPRESSION REAL_RANGE_SPECIFICATION
2496 -- Note: In Ada 83, the EXPRESSION must be a SIMPLE_EXPRESSION
2498 -- N_Ordinary_Fixed_Point_Definition
2499 -- Sloc points to DELTA
2500 -- Delta_Expression (Node3)
2501 -- Real_Range_Specification (Node4)
2503 -------------------------------------------
2504 -- 3.5.9 Decimal Fixed Point Definition --
2505 -------------------------------------------
2507 -- DECIMAL_FIXED_POINT_DEFINITION ::=
2508 -- delta static_EXPRESSION
2509 -- digits static_EXPRESSION [REAL_RANGE_SPECIFICATION]
2511 -- Note: decimal types are not permitted in Ada 83 mode
2513 -- N_Decimal_Fixed_Point_Definition
2514 -- Sloc points to DELTA
2515 -- Delta_Expression (Node3)
2516 -- Digits_Expression (Node2)
2517 -- Real_Range_Specification (Node4) (set to Empty if not present)
2519 ------------------------------
2520 -- 3.5.9 Digits Constraint --
2521 ------------------------------
2523 -- DIGITS_CONSTRAINT ::=
2524 -- digits static_EXPRESSION [RANGE_CONSTRAINT]
2526 -- Note: in Ada 83, the EXPRESSION must be a SIMPLE_EXPRESSION
2527 -- Note: in Ada 95, reduced accuracy subtypes are obsolescent
2529 -- N_Digits_Constraint
2530 -- Sloc points to DIGITS
2531 -- Digits_Expression (Node2)
2532 -- Range_Constraint (Node4) (set to Empty if not present)
2534 --------------------------------
2535 -- 3.6 Array Type Definition --
2536 --------------------------------
2538 -- ARRAY_TYPE_DEFINITION ::=
2539 -- UNCONSTRAINED_ARRAY_DEFINITION | CONSTRAINED_ARRAY_DEFINITION
2541 -----------------------------------------
2542 -- 3.6 Unconstrained Array Definition --
2543 -----------------------------------------
2545 -- UNCONSTRAINED_ARRAY_DEFINITION ::=
2546 -- array (INDEX_SUBTYPE_DEFINITION {, INDEX_SUBTYPE_DEFINITION}) of
2547 -- COMPONENT_DEFINITION
2549 -- Note: dimensionality of array is indicated by number of entries in
2550 -- the Subtype_Marks list, which has one entry for each dimension.
2552 -- N_Unconstrained_Array_Definition
2553 -- Sloc points to ARRAY
2554 -- Subtype_Marks (List2)
2555 -- Component_Definition (Node4)
2557 -----------------------------------
2558 -- 3.6 Index Subtype Definition --
2559 -----------------------------------
2561 -- INDEX_SUBTYPE_DEFINITION ::= SUBTYPE_MARK range <>
2563 -- There is no explicit node in the tree for an index subtype
2564 -- definition since the N_Unconstrained_Array_Definition node
2565 -- incorporates the type marks which appear in this context.
2567 ---------------------------------------
2568 -- 3.6 Constrained Array Definition --
2569 ---------------------------------------
2571 -- CONSTRAINED_ARRAY_DEFINITION ::=
2572 -- array (DISCRETE_SUBTYPE_DEFINITION
2573 -- {, DISCRETE_SUBTYPE_DEFINITION})
2574 -- of COMPONENT_DEFINITION
2576 -- Note: dimensionality of array is indicated by number of entries
2577 -- in the Discrete_Subtype_Definitions list, which has one entry
2578 -- for each dimension.
2580 -- N_Constrained_Array_Definition
2581 -- Sloc points to ARRAY
2582 -- Discrete_Subtype_Definitions (List2)
2583 -- Component_Definition (Node4)
2585 --------------------------------------
2586 -- 3.6 Discrete Subtype Definition --
2587 --------------------------------------
2589 -- DISCRETE_SUBTYPE_DEFINITION ::=
2590 -- discrete_SUBTYPE_INDICATION | RANGE
2592 -------------------------------
2593 -- 3.6 Component Definition --
2594 -------------------------------
2596 -- COMPONENT_DEFINITION ::=
2597 -- [aliased] [NULL_EXCLUSION] SUBTYPE_INDICATION | ACCESS_DEFINITION
2599 -- Note: although the syntax does not permit a component definition to
2600 -- be an anonymous array (and the parser will diagnose such an attempt
2601 -- with an appropriate message), it is possible for anonymous arrays
2602 -- to appear as component definitions. The semantics and back end handle
2603 -- this case properly, and the expander in fact generates such cases.
2604 -- Access_Definition is an optional field that gives support to
2605 -- Ada 2005 (AI-230). The parser generates nodes that have either the
2606 -- Subtype_Indication field or else the Access_Definition field.
2608 -- N_Component_Definition
2609 -- Sloc points to ALIASED, ACCESS or to first token of subtype mark
2610 -- Aliased_Present (Flag4)
2611 -- Null_Exclusion_Present (Flag11)
2612 -- Subtype_Indication (Node5) (set to Empty if not present)
2613 -- Access_Definition (Node3) (set to Empty if not present)
2615 -----------------------------
2616 -- 3.6.1 Index Constraint --
2617 -----------------------------
2619 -- INDEX_CONSTRAINT ::= (DISCRETE_RANGE {, DISCRETE_RANGE})
2621 -- It is not in general possible to distinguish between discriminant
2622 -- constraints and index constraints at parse time, since a simple
2623 -- name could be either the subtype mark of a discrete range, or an
2624 -- expression in a discriminant association with no name. Either
2625 -- entry appears simply as the name, and the semantic parse must
2626 -- distinguish between the two cases. Thus we use a common tree
2627 -- node format for both of these constraint types.
2629 -- See Discriminant_Constraint for format of node
2631 ---------------------------
2632 -- 3.6.1 Discrete Range --
2633 ---------------------------
2635 -- DISCRETE_RANGE ::= discrete_SUBTYPE_INDICATION | RANGE
2637 ----------------------------
2638 -- 3.7 Discriminant Part --
2639 ----------------------------
2641 -- DISCRIMINANT_PART ::=
2642 -- UNKNOWN_DISCRIMINANT_PART | KNOWN_DISCRIMINANT_PART
2644 ------------------------------------
2645 -- 3.7 Unknown Discriminant Part --
2646 ------------------------------------
2648 -- UNKNOWN_DISCRIMINANT_PART ::= (<>)
2650 -- Note: unknown discriminant parts are not permitted in Ada 83 mode
2652 -- There is no explicit node in the tree for an unknown discriminant
2653 -- part. Instead the Unknown_Discriminants_Present flag is set in the
2654 -- parent node.
2656 ----------------------------------
2657 -- 3.7 Known Discriminant Part --
2658 ----------------------------------
2660 -- KNOWN_DISCRIMINANT_PART ::=
2661 -- (DISCRIMINANT_SPECIFICATION {; DISCRIMINANT_SPECIFICATION})
2663 -------------------------------------
2664 -- 3.7 Discriminant Specification --
2665 -------------------------------------
2667 -- DISCRIMINANT_SPECIFICATION ::=
2668 -- DEFINING_IDENTIFIER_LIST : [NULL_EXCLUSION] SUBTYPE_MARK
2669 -- [:= DEFAULT_EXPRESSION]
2670 -- | DEFINING_IDENTIFIER_LIST : ACCESS_DEFINITION
2671 -- [:= DEFAULT_EXPRESSION]
2673 -- Although the syntax allows multiple identifiers in the list, the
2674 -- semantics is as though successive specifications were given with
2675 -- identical type definition and expression components. To simplify
2676 -- semantic processing, the parser represents a multiple declaration
2677 -- case as a sequence of single specifications, using the More_Ids and
2678 -- Prev_Ids flags to preserve the original source form as described
2679 -- in the section on "Handling of Defining Identifier Lists".
2681 -- N_Discriminant_Specification
2682 -- Sloc points to first identifier
2683 -- Defining_Identifier (Node1)
2684 -- Null_Exclusion_Present (Flag11)
2685 -- Discriminant_Type (Node5) subtype mark or access parameter definition
2686 -- Expression (Node3) (set to Empty if no default expression)
2687 -- More_Ids (Flag5) (set to False if no more identifiers in list)
2688 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
2690 -----------------------------
2691 -- 3.7 Default Expression --
2692 -----------------------------
2694 -- DEFAULT_EXPRESSION ::= EXPRESSION
2696 ------------------------------------
2697 -- 3.7.1 Discriminant Constraint --
2698 ------------------------------------
2700 -- DISCRIMINANT_CONSTRAINT ::=
2701 -- (DISCRIMINANT_ASSOCIATION {, DISCRIMINANT_ASSOCIATION})
2703 -- It is not in general possible to distinguish between discriminant
2704 -- constraints and index constraints at parse time, since a simple
2705 -- name could be either the subtype mark of a discrete range, or an
2706 -- expression in a discriminant association with no name. Either
2707 -- entry appears simply as the name, and the semantic parse must
2708 -- distinguish between the two cases. Thus we use a common tree
2709 -- node format for both of these constraint types.
2711 -- N_Index_Or_Discriminant_Constraint
2712 -- Sloc points to left paren
2713 -- Constraints (List1) points to list of discrete ranges or
2714 -- discriminant associations
2716 -------------------------------------
2717 -- 3.7.1 Discriminant Association --
2718 -------------------------------------
2720 -- DISCRIMINANT_ASSOCIATION ::=
2721 -- [discriminant_SELECTOR_NAME
2722 -- {| discriminant_SELECTOR_NAME} =>] EXPRESSION
2724 -- Note: a discriminant association that has no selector name list
2725 -- appears directly as an expression in the tree.
2727 -- N_Discriminant_Association
2728 -- Sloc points to first token of discriminant association
2729 -- Selector_Names (List1) (always non-empty, since if no selector
2730 -- names are present, this node is not used, see comment above)
2731 -- Expression (Node3)
2733 ---------------------------------
2734 -- 3.8 Record Type Definition --
2735 ---------------------------------
2737 -- RECORD_TYPE_DEFINITION ::=
2738 -- [[abstract] tagged] [limited] RECORD_DEFINITION
2740 -- Note: ABSTRACT, TAGGED, LIMITED are not permitted in Ada 83 mode
2742 -- There is no explicit node in the tree for a record type definition.
2743 -- Instead the flags for Tagged_Present and Limited_Present appear in
2744 -- the N_Record_Definition node for a record definition appearing in
2745 -- the context of a record type definition.
2747 ----------------------------
2748 -- 3.8 Record Definition --
2749 ----------------------------
2751 -- RECORD_DEFINITION ::=
2752 -- record
2753 -- COMPONENT_LIST
2754 -- end record
2755 -- | null record
2757 -- Note: the Abstract_Present, Tagged_Present and Limited_Present
2758 -- flags appear only for a record definition appearing in a record
2759 -- type definition.
2761 -- Note: the NULL RECORD case is not permitted in Ada 83
2763 -- N_Record_Definition
2764 -- Sloc points to RECORD or NULL
2765 -- End_Label (Node4) (set to Empty if internally generated record)
2766 -- Abstract_Present (Flag4)
2767 -- Tagged_Present (Flag15)
2768 -- Limited_Present (Flag17)
2769 -- Component_List (Node1) empty in null record case
2770 -- Null_Present (Flag13) set in null record case
2771 -- Task_Present (Flag5) set in task interfaces
2772 -- Protected_Present (Flag6) set in protected interfaces
2773 -- Synchronized_Present (Flag7) set in interfaces
2774 -- Interface_Present (Flag16) set in abstract interfaces
2775 -- Interface_List (List2) (set to No_List if none)
2777 -- Note: Task_Present, Protected_Present, Synchronized _Present,
2778 -- Interface_List and Interface_Present are used for abstract
2779 -- interfaces (see comments for INTERFACE_TYPE_DEFINITION).
2781 -------------------------
2782 -- 3.8 Component List --
2783 -------------------------
2785 -- COMPONENT_LIST ::=
2786 -- COMPONENT_ITEM {COMPONENT_ITEM}
2787 -- | {COMPONENT_ITEM} VARIANT_PART
2788 -- | null;
2790 -- N_Component_List
2791 -- Sloc points to first token of component list
2792 -- Component_Items (List3)
2793 -- Variant_Part (Node4) (set to Empty if no variant part)
2794 -- Null_Present (Flag13)
2796 -------------------------
2797 -- 3.8 Component Item --
2798 -------------------------
2800 -- COMPONENT_ITEM ::= COMPONENT_DECLARATION | REPRESENTATION_CLAUSE
2802 -- Note: A component item can also be a pragma, and in the tree
2803 -- that is obtained after semantic processing, a component item
2804 -- can be an N_Null node resulting from a non-recognized pragma.
2806 --------------------------------
2807 -- 3.8 Component Declaration --
2808 --------------------------------
2810 -- COMPONENT_DECLARATION ::=
2811 -- DEFINING_IDENTIFIER_LIST : COMPONENT_DEFINITION
2812 -- [:= DEFAULT_EXPRESSION]
2814 -- Note: although the syntax does not permit a component definition to
2815 -- be an anonymous array (and the parser will diagnose such an attempt
2816 -- with an appropriate message), it is possible for anonymous arrays
2817 -- to appear as component definitions. The semantics and back end handle
2818 -- this case properly, and the expander in fact generates such cases.
2820 -- Although the syntax allows multiple identifiers in the list, the
2821 -- semantics is as though successive declarations were given with the
2822 -- same component definition and expression components. To simplify
2823 -- semantic processing, the parser represents a multiple declaration
2824 -- case as a sequence of single declarations, using the More_Ids and
2825 -- Prev_Ids flags to preserve the original source form as described
2826 -- in the section on "Handling of Defining Identifier Lists".
2828 -- N_Component_Declaration
2829 -- Sloc points to first identifier
2830 -- Defining_Identifier (Node1)
2831 -- Component_Definition (Node4)
2832 -- Expression (Node3) (set to Empty if no default expression)
2833 -- More_Ids (Flag5) (set to False if no more identifiers in list)
2834 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
2836 -------------------------
2837 -- 3.8.1 Variant Part --
2838 -------------------------
2840 -- VARIANT_PART ::=
2841 -- case discriminant_DIRECT_NAME is
2842 -- VARIANT
2843 -- {VARIANT}
2844 -- end case;
2846 -- Note: the variants list can contain pragmas as well as variants.
2847 -- In a properly formed program there is at least one variant.
2849 -- N_Variant_Part
2850 -- Sloc points to CASE
2851 -- Name (Node2)
2852 -- Variants (List1)
2854 --------------------
2855 -- 3.8.1 Variant --
2856 --------------------
2858 -- VARIANT ::=
2859 -- when DISCRETE_CHOICE_LIST =>
2860 -- COMPONENT_LIST
2862 -- N_Variant
2863 -- Sloc points to WHEN
2864 -- Discrete_Choices (List4)
2865 -- Component_List (Node1)
2866 -- Enclosing_Variant (Node2-Sem)
2867 -- Present_Expr (Uint3-Sem)
2868 -- Dcheck_Function (Node5-Sem)
2870 ---------------------------------
2871 -- 3.8.1 Discrete Choice List --
2872 ---------------------------------
2874 -- DISCRETE_CHOICE_LIST ::= DISCRETE_CHOICE {| DISCRETE_CHOICE}
2876 ----------------------------
2877 -- 3.8.1 Discrete Choice --
2878 ----------------------------
2880 -- DISCRETE_CHOICE ::= EXPRESSION | DISCRETE_RANGE | others
2882 -- Note: in Ada 83 mode, the expression must be a simple expression
2884 -- The only choice that appears explicitly is the OTHERS choice, as
2885 -- defined here. Other cases of discrete choice (expression and
2886 -- discrete range) appear directly. This production is also used
2887 -- for the OTHERS possibility of an exception choice.
2889 -- Note: in accordance with the syntax, the parser does not check that
2890 -- OTHERS appears at the end on its own in a choice list context. This
2891 -- is a semantic check.
2893 -- N_Others_Choice
2894 -- Sloc points to OTHERS
2895 -- Others_Discrete_Choices (List1-Sem)
2896 -- All_Others (Flag11-Sem)
2898 ----------------------------------
2899 -- 3.9.1 Record Extension Part --
2900 ----------------------------------
2902 -- RECORD_EXTENSION_PART ::= with RECORD_DEFINITION
2904 -- Note: record extension parts are not permitted in Ada 83 mode
2906 --------------------------------------
2907 -- 3.9.4 Interface Type Definition --
2908 --------------------------------------
2910 -- INTERFACE_TYPE_DEFINITION ::=
2911 -- [limited | task | protected | synchronized]
2912 -- interface [interface_list]
2914 -- Note: Interfaces are implemented with N_Record_Definition and
2915 -- N_Derived_Type_Definition nodes because most of the support
2916 -- for the analysis of abstract types has been reused to
2917 -- analyze abstract interfaces.
2919 ----------------------------------
2920 -- 3.10 Access Type Definition --
2921 ----------------------------------
2923 -- ACCESS_TYPE_DEFINITION ::=
2924 -- ACCESS_TO_OBJECT_DEFINITION
2925 -- | ACCESS_TO_SUBPROGRAM_DEFINITION
2927 --------------------------
2928 -- 3.10 Null Exclusion --
2929 --------------------------
2931 -- NULL_EXCLUSION ::= not null
2933 ---------------------------------------
2934 -- 3.10 Access To Object Definition --
2935 ---------------------------------------
2937 -- ACCESS_TO_OBJECT_DEFINITION ::=
2938 -- [NULL_EXCLUSION] access [GENERAL_ACCESS_MODIFIER]
2939 -- SUBTYPE_INDICATION
2941 -- N_Access_To_Object_Definition
2942 -- Sloc points to ACCESS
2943 -- All_Present (Flag15)
2944 -- Null_Exclusion_Present (Flag11)
2945 -- Subtype_Indication (Node5)
2946 -- Constant_Present (Flag17)
2948 -----------------------------------
2949 -- 3.10 General Access Modifier --
2950 -----------------------------------
2952 -- GENERAL_ACCESS_MODIFIER ::= all | constant
2954 -- Note: general access modifiers are not permitted in Ada 83 mode
2956 -- There is no explicit node in the tree for general access modifier.
2957 -- Instead the All_Present or Constant_Present flags are set in the
2958 -- parent node.
2960 -------------------------------------------
2961 -- 3.10 Access To Subprogram Definition --
2962 -------------------------------------------
2964 -- ACCESS_TO_SUBPROGRAM_DEFINITION
2965 -- [NULL_EXCLUSION] access [protected] procedure PARAMETER_PROFILE
2966 -- | [NULL_EXCLUSION] access [protected] function
2967 -- PARAMETER_AND_RESULT_PROFILE
2969 -- Note: access to subprograms are not permitted in Ada 83 mode
2971 -- N_Access_Function_Definition
2972 -- Sloc points to ACCESS
2973 -- Null_Exclusion_Present (Flag11)
2974 -- Null_Exclusion_In_Return_Present (Flag14)
2975 -- Protected_Present (Flag6)
2976 -- Parameter_Specifications (List3) (set to No_List if no formal part)
2977 -- Result_Definition (Node4) result subtype (subtype mark or access def)
2979 -- N_Access_Procedure_Definition
2980 -- Sloc points to ACCESS
2981 -- Null_Exclusion_Present (Flag11)
2982 -- Protected_Present (Flag6)
2983 -- Parameter_Specifications (List3) (set to No_List if no formal part)
2985 -----------------------------
2986 -- 3.10 Access Definition --
2987 -----------------------------
2989 -- ACCESS_DEFINITION ::=
2990 -- [NULL_EXCLUSION] access [GENERAL_ACCESS_MODIFIER] SUBTYPE_MARK
2991 -- | ACCESS_TO_SUBPROGRAM_DEFINITION
2993 -- Note: access to subprograms are an Ada 2005 (AI-254) extension
2995 -- N_Access_Definition
2996 -- Sloc points to ACCESS
2997 -- Null_Exclusion_Present (Flag11)
2998 -- All_Present (Flag15)
2999 -- Constant_Present (Flag17)
3000 -- Subtype_Mark (Node4)
3001 -- Access_To_Subprogram_Definition (Node3) (set to Empty if not present)
3003 -----------------------------------------
3004 -- 3.10.1 Incomplete Type Declaration --
3005 -----------------------------------------
3007 -- INCOMPLETE_TYPE_DECLARATION ::=
3008 -- type DEFINING_IDENTIFIER [DISCRIMINANT_PART] [IS TAGGED];
3010 -- N_Incomplete_Type_Declaration
3011 -- Sloc points to TYPE
3012 -- Defining_Identifier (Node1)
3013 -- Discriminant_Specifications (List4) (set to No_List if no
3014 -- discriminant part, or if the discriminant part is an
3015 -- unknown discriminant part)
3016 -- Unknown_Discriminants_Present (Flag13) set if (<>) discriminant
3017 -- Tagged_Present (Flag15)
3019 ----------------------------
3020 -- 3.11 Declarative Part --
3021 ----------------------------
3023 -- DECLARATIVE_PART ::= {DECLARATIVE_ITEM}
3025 -- Note: although the parser enforces the syntactic requirement that
3026 -- a declarative part can contain only declarations, the semantic
3027 -- processing may add statements to the list of actions in a
3028 -- declarative part, so the code generator should be prepared
3029 -- to accept a statement in this position.
3031 ----------------------------
3032 -- 3.11 Declarative Item --
3033 ----------------------------
3035 -- DECLARATIVE_ITEM ::= BASIC_DECLARATIVE_ITEM | BODY
3037 ----------------------------------
3038 -- 3.11 Basic Declarative Item --
3039 ----------------------------------
3041 -- BASIC_DECLARATIVE_ITEM ::=
3042 -- BASIC_DECLARATION | REPRESENTATION_CLAUSE | USE_CLAUSE
3044 ----------------
3045 -- 3.11 Body --
3046 ----------------
3048 -- BODY ::= PROPER_BODY | BODY_STUB
3050 -----------------------
3051 -- 3.11 Proper Body --
3052 -----------------------
3054 -- PROPER_BODY ::=
3055 -- SUBPROGRAM_BODY | PACKAGE_BODY | TASK_BODY | PROTECTED_BODY
3057 ---------------
3058 -- 4.1 Name --
3059 ---------------
3061 -- NAME ::=
3062 -- DIRECT_NAME | EXPLICIT_DEREFERENCE
3063 -- | INDEXED_COMPONENT | SLICE
3064 -- | SELECTED_COMPONENT | ATTRIBUTE_REFERENCE
3065 -- | TYPE_CONVERSION | FUNCTION_CALL
3066 -- | CHARACTER_LITERAL
3068 ----------------------
3069 -- 4.1 Direct Name --
3070 ----------------------
3072 -- DIRECT_NAME ::= IDENTIFIER | OPERATOR_SYMBOL
3074 -----------------
3075 -- 4.1 Prefix --
3076 -----------------
3078 -- PREFIX ::= NAME | IMPLICIT_DEREFERENCE
3080 -------------------------------
3081 -- 4.1 Explicit Dereference --
3082 -------------------------------
3084 -- EXPLICIT_DEREFERENCE ::= NAME . all
3086 -- N_Explicit_Dereference
3087 -- Sloc points to ALL
3088 -- Prefix (Node3)
3089 -- Actual_Designated_Subtype (Node4-Sem)
3090 -- plus fields for expression
3092 -------------------------------
3093 -- 4.1 Implicit Dereference --
3094 -------------------------------
3096 -- IMPLICIT_DEREFERENCE ::= NAME
3098 ------------------------------
3099 -- 4.1.1 Indexed Component --
3100 ------------------------------
3102 -- INDEXED_COMPONENT ::= PREFIX (EXPRESSION {, EXPRESSION})
3104 -- Note: the parser may generate this node in some situations where it
3105 -- should be a function call. The semantic pass must correct this
3106 -- misidentification (which is inevitable at the parser level).
3108 -- N_Indexed_Component
3109 -- Sloc contains a copy of the Sloc value of the Prefix
3110 -- Prefix (Node3)
3111 -- Expressions (List1)
3112 -- plus fields for expression
3114 -- Note: if any of the subscripts requires a range check, then the
3115 -- Do_Range_Check flag is set on the corresponding expression, with
3116 -- the index type being determined from the type of the Prefix, which
3117 -- references the array being indexed.
3119 -- Note: in a fully analyzed and expanded indexed component node, and
3120 -- hence in any such node that gigi sees, if the prefix is an access
3121 -- type, then an explicit dereference operation has been inserted.
3123 ------------------
3124 -- 4.1.2 Slice --
3125 ------------------
3127 -- SLICE ::= PREFIX (DISCRETE_RANGE)
3129 -- Note: an implicit subtype is created to describe the resulting
3130 -- type, so that the bounds of this type are the bounds of the slice.
3132 -- N_Slice
3133 -- Sloc points to first token of prefix
3134 -- Prefix (Node3)
3135 -- Discrete_Range (Node4)
3136 -- plus fields for expression
3138 -------------------------------
3139 -- 4.1.3 Selected Component --
3140 -------------------------------
3142 -- SELECTED_COMPONENT ::= PREFIX . SELECTOR_NAME
3144 -- Note: selected components that are semantically expanded names get
3145 -- changed during semantic processing into the separate N_Expanded_Name
3146 -- node. See description of this node in the section on semantic nodes.
3148 -- N_Selected_Component
3149 -- Sloc points to period
3150 -- Prefix (Node3)
3151 -- Selector_Name (Node2)
3152 -- Associated_Node (Node4-Sem)
3153 -- Do_Discriminant_Check (Flag13-Sem)
3154 -- Is_In_Discriminant_Check (Flag11-Sem)
3155 -- plus fields for expression
3157 --------------------------
3158 -- 4.1.3 Selector Name --
3159 --------------------------
3161 -- SELECTOR_NAME ::= IDENTIFIER | CHARACTER_LITERAL | OPERATOR_SYMBOL
3163 --------------------------------
3164 -- 4.1.4 Attribute Reference --
3165 --------------------------------
3167 -- ATTRIBUTE_REFERENCE ::= PREFIX ' ATTRIBUTE_DESIGNATOR
3169 -- Note: the syntax is quite ambiguous at this point. Consider:
3171 -- A'Length (X) X is part of the attribute designator
3172 -- A'Pos (X) X is an explicit actual parameter of function A'Pos
3173 -- A'Class (X) X is the expression of a type conversion
3175 -- It would be possible for the parser to distinguish these cases
3176 -- by looking at the attribute identifier. However, that would mean
3177 -- more work in introducing new implementation defined attributes,
3178 -- and also it would mean that special processing for attributes
3179 -- would be scattered around, instead of being centralized in the
3180 -- semantic routine that handles an N_Attribute_Reference node.
3181 -- Consequently, the parser in all the above cases stores the
3182 -- expression (X in these examples) as a single element list in
3183 -- in the Expressions field of the N_Attribute_Reference node.
3185 -- Similarly, for attributes like Max which take two arguments,
3186 -- we store the two arguments as a two element list in the
3187 -- Expressions field. Of course it is clear at parse time that
3188 -- this case is really a function call with an attribute as the
3189 -- prefix, but it turns out to be convenient to handle the two
3190 -- argument case in a similar manner to the one argument case,
3191 -- and indeed in general the parser will accept any number of
3192 -- expressions in this position and store them as a list in the
3193 -- attribute reference node. This allows for future addition of
3194 -- attributes that take more than two arguments.
3196 -- Note: named associates are not permitted in function calls where
3197 -- the function is an attribute (see RM 6.4(3)) so it is legitimate
3198 -- to skip the normal subprogram argument processing.
3200 -- Note: for the attributes whose designators are technically keywords,
3201 -- i.e. digits, access, delta, range, the Attribute_Name field contains
3202 -- the corresponding name, even though no identifier is involved.
3204 -- Note: the generated code may contain stream attributes applied to
3205 -- limited types for which no stream routines exist officially. In such
3206 -- case, the result is to use the stream attribute for the underlying
3207 -- full type, or in the case of a protected type, the components
3208 -- (including any discriminants) are merely streamed in order.
3210 -- See Exp_Attr for a complete description of which attributes are
3211 -- passed onto Gigi, and which are handled entirely by the front end.
3213 -- Gigi restriction: For the Pos attribute, the prefix cannot be
3214 -- a non-standard enumeration type or a nonzero/zero semantics
3215 -- boolean type, so the value is simply the stored representation.
3217 -- Gigi requirement: For the Mechanism_Code attribute, if the prefix
3218 -- references a subprogram that is a renaming, then the front end must
3219 -- rewrite the attribute to refer directly to the renamed entity.
3221 -- Note: In generated code, the Address and Unrestricted_Access
3222 -- attributes can be applied to any expression, and the meaning is
3223 -- to create an object containing the value (the object is in the
3224 -- current stack frame), and pass the address of this value. If the
3225 -- Must_Be_Byte_Aligned flag is set, then the object whose address
3226 -- is taken must be on a byte (storage unit) boundary, and if it is
3227 -- not (or may not be), then the generated code must create a copy
3228 -- that is byte aligned, and pass the address of this copy.
3230 -- N_Attribute_Reference
3231 -- Sloc points to apostrophe
3232 -- Prefix (Node3)
3233 -- Attribute_Name (Name2) identifier name from attribute designator
3234 -- Expressions (List1) (set to No_List if no associated expressions)
3235 -- Entity (Node4-Sem) used if the attribute yields a type
3236 -- Associated_Node (Node4-Sem)
3237 -- Do_Overflow_Check (Flag17-Sem)
3238 -- Redundant_Use (Flag13-Sem)
3239 -- Must_Be_Byte_Aligned (Flag14)
3240 -- plus fields for expression
3242 ---------------------------------
3243 -- 4.1.4 Attribute Designator --
3244 ---------------------------------
3246 -- ATTRIBUTE_DESIGNATOR ::=
3247 -- IDENTIFIER [(static_EXPRESSION)]
3248 -- | access | delta | digits
3250 -- There is no explicit node in the tree for an attribute designator.
3251 -- Instead the Attribute_Name and Expressions fields of the parent
3252 -- node (N_Attribute_Reference node) hold the information.
3254 -- Note: if ACCESS, DELTA or DIGITS appears in an attribute
3255 -- designator, then they are treated as identifiers internally
3256 -- rather than the keywords of the same name.
3258 --------------------------------------
3259 -- 4.1.4 Range Attribute Reference --
3260 --------------------------------------
3262 -- RANGE_ATTRIBUTE_REFERENCE ::= PREFIX ' RANGE_ATTRIBUTE_DESIGNATOR
3264 -- A range attribute reference is represented in the tree using the
3265 -- normal N_Attribute_Reference node.
3267 ---------------------------------------
3268 -- 4.1.4 Range Attribute Designator --
3269 ---------------------------------------
3271 -- RANGE_ATTRIBUTE_DESIGNATOR ::= Range [(static_EXPRESSION)]
3273 -- A range attribute designator is represented in the tree using the
3274 -- normal N_Attribute_Reference node.
3276 --------------------
3277 -- 4.3 Aggregate --
3278 --------------------
3280 -- AGGREGATE ::=
3281 -- RECORD_AGGREGATE | EXTENSION_AGGREGATE | ARRAY_AGGREGATE
3283 -----------------------------
3284 -- 4.3.1 Record Aggregate --
3285 -----------------------------
3287 -- RECORD_AGGREGATE ::= (RECORD_COMPONENT_ASSOCIATION_LIST)
3289 -- N_Aggregate
3290 -- Sloc points to left parenthesis
3291 -- Expressions (List1) (set to No_List if none or null record case)
3292 -- Component_Associations (List2) (set to No_List if none)
3293 -- Null_Record_Present (Flag17)
3294 -- Aggregate_Bounds (Node3-Sem)
3295 -- Associated_Node (Node4-Sem)
3296 -- Static_Processing_OK (Flag4-Sem)
3297 -- Compile_Time_Known_Aggregate (Flag18-Sem)
3298 -- Expansion_Delayed (Flag11-Sem)
3299 -- Has_Self_Reference (Flag13-Sem)
3300 -- plus fields for expression
3302 -- Note: this structure is used for both record and array aggregates
3303 -- since the two cases are not separable by the parser. The parser
3304 -- makes no attempt to enforce consistency here, so it is up to the
3305 -- semantic phase to make sure that the aggregate is consistent (i.e.
3306 -- that it is not a "half-and-half" case that mixes record and array
3307 -- syntax. In particular, for a record aggregate, the expressions
3308 -- field will be set if there are positional associations.
3310 -- Note: N_Aggregate is not used for all aggregates; in particular,
3311 -- there is a separate node kind for extension aggregates.
3313 -- Note: gigi/gcc can handle array aggregates correctly providing that
3314 -- they are entirely positional, and the array subtype involved has a
3315 -- known at compile time length and is not bit packed, or a convention
3316 -- Fortran array with more than one dimension. If these conditions
3317 -- are not met, then the front end must translate the aggregate into
3318 -- an appropriate set of assignments into a temporary.
3320 -- Note: for the record aggregate case, gigi/gcc can handle all cases of
3321 -- record aggregates, including those for packed, and rep-claused
3322 -- records, and also variant records, providing that there are no
3323 -- variable length fields whose size is not known at compile time, and
3324 -- providing that the aggregate is presented in fully named form.
3326 ----------------------------------------------
3327 -- 4.3.1 Record Component Association List --
3328 ----------------------------------------------
3330 -- RECORD_COMPONENT_ASSOCIATION_LIST ::=
3331 -- RECORD_COMPONENT_ASSOCIATION {, RECORD_COMPONENT_ASSOCIATION}
3332 -- | null record
3334 -- There is no explicit node in the tree for a record component
3335 -- association list. Instead the Null_Record_Present flag is set in
3336 -- the parent node for the NULL RECORD case.
3338 ------------------------------------------------------
3339 -- 4.3.1 Record Component Association (also 4.3.3) --
3340 ------------------------------------------------------
3342 -- RECORD_COMPONENT_ASSOCIATION ::=
3343 -- [COMPONENT_CHOICE_LIST =>] EXPRESSION
3345 -- N_Component_Association
3346 -- Sloc points to first selector name
3347 -- Choices (List1)
3348 -- Loop_Actions (List2-Sem)
3349 -- Expression (Node3)
3350 -- Box_Present (Flag15)
3351 -- Inherited_Discriminant (Flag13)
3353 -- Note: this structure is used for both record component associations
3354 -- and array component associations, since the two cases aren't always
3355 -- separable by the parser. The choices list may represent either a
3356 -- list of selector names in the record aggregate case, or a list of
3357 -- discrete choices in the array aggregate case or an N_Others_Choice
3358 -- node (which appears as a singleton list). Box_Present gives support
3359 -- to Ada 2005 (AI-287).
3361 ----------------------------------
3362 -- 4.3.1 Component Choice List --
3363 ----------------------------------
3365 -- COMPONENT_CHOICE_LIST ::=
3366 -- component_SELECTOR_NAME {| component_SELECTOR_NAME}
3367 -- | others
3369 -- The entries of a component choice list appear in the Choices list of
3370 -- the associated N_Component_Association, as either selector names, or
3371 -- as an N_Others_Choice node.
3373 --------------------------------
3374 -- 4.3.2 Extension Aggregate --
3375 --------------------------------
3377 -- EXTENSION_AGGREGATE ::=
3378 -- (ANCESTOR_PART with RECORD_COMPONENT_ASSOCIATION_LIST)
3380 -- Note: extension aggregates are not permitted in Ada 83 mode
3382 -- N_Extension_Aggregate
3383 -- Sloc points to left parenthesis
3384 -- Ancestor_Part (Node3)
3385 -- Associated_Node (Node4-Sem)
3386 -- Expressions (List1) (set to No_List if none or null record case)
3387 -- Component_Associations (List2) (set to No_List if none)
3388 -- Null_Record_Present (Flag17)
3389 -- Expansion_Delayed (Flag11-Sem)
3390 -- Has_Self_Reference (Flag13-Sem)
3391 -- plus fields for expression
3393 --------------------------
3394 -- 4.3.2 Ancestor Part --
3395 --------------------------
3397 -- ANCESTOR_PART ::= EXPRESSION | SUBTYPE_MARK
3399 ----------------------------
3400 -- 4.3.3 Array Aggregate --
3401 ----------------------------
3403 -- ARRAY_AGGREGATE ::=
3404 -- POSITIONAL_ARRAY_AGGREGATE | NAMED_ARRAY_AGGREGATE
3406 ---------------------------------------
3407 -- 4.3.3 Positional Array Aggregate --
3408 ---------------------------------------
3410 -- POSITIONAL_ARRAY_AGGREGATE ::=
3411 -- (EXPRESSION, EXPRESSION {, EXPRESSION})
3412 -- | (EXPRESSION {, EXPRESSION}, others => EXPRESSION)
3414 -- See Record_Aggregate (4.3.1) for node structure
3416 ----------------------------------
3417 -- 4.3.3 Named Array Aggregate --
3418 ----------------------------------
3420 -- NAMED_ARRAY_AGGREGATE ::=
3421 -- | (ARRAY_COMPONENT_ASSOCIATION {, ARRAY_COMPONENT_ASSOCIATION})
3423 -- See Record_Aggregate (4.3.1) for node structure
3425 ----------------------------------------
3426 -- 4.3.3 Array Component Association --
3427 ----------------------------------------
3429 -- ARRAY_COMPONENT_ASSOCIATION ::=
3430 -- DISCRETE_CHOICE_LIST => EXPRESSION
3432 -- See Record_Component_Association (4.3.1) for node structure
3434 --------------------------------------------------
3435 -- 4.4 Expression/Relation/Term/Factor/Primary --
3436 --------------------------------------------------
3438 -- EXPRESSION ::=
3439 -- RELATION {and RELATION} | RELATION {and then RELATION}
3440 -- | RELATION {or RELATION} | RELATION {or else RELATION}
3441 -- | RELATION {xor RELATION}
3443 -- RELATION ::=
3444 -- SIMPLE_EXPRESSION [RELATIONAL_OPERATOR SIMPLE_EXPRESSION]
3445 -- | SIMPLE_EXPRESSION [not] in RANGE
3446 -- | SIMPLE_EXPRESSION [not] in SUBTYPE_MARK
3448 -- SIMPLE_EXPRESSION ::=
3449 -- [UNARY_ADDING_OPERATOR] TERM {BINARY_ADDING_OPERATOR TERM}
3451 -- TERM ::= FACTOR {MULTIPLYING_OPERATOR FACTOR}
3453 -- FACTOR ::= PRIMARY [** PRIMARY] | abs PRIMARY | not PRIMARY
3455 -- No nodes are generated for any of these constructs. Instead, the
3456 -- node for the operator appears directly. When we refer to an
3457 -- expression in this description, we mean any of the possible
3458 -- constituent components of an expression (e.g. identifier is
3459 -- an example of an expression).
3461 ------------------
3462 -- 4.4 Primary --
3463 ------------------
3465 -- PRIMARY ::=
3466 -- NUMERIC_LITERAL | null
3467 -- | STRING_LITERAL | AGGREGATE
3468 -- | NAME | QUALIFIED_EXPRESSION
3469 -- | ALLOCATOR | (EXPRESSION)
3471 -- Usually there is no explicit node in the tree for primary. Instead
3472 -- the constituent (e.g. AGGREGATE) appears directly. There are two
3473 -- exceptions. First, there is an explicit node for a null primary.
3475 -- N_Null
3476 -- Sloc points to NULL
3477 -- plus fields for expression
3479 -- Second, the case of (EXPRESSION) is handled specially. Ada requires
3480 -- that the parser keep track of which subexpressions are enclosed
3481 -- in parentheses, and how many levels of parentheses are used. This
3482 -- information is required for optimization purposes, and also for
3483 -- some semantic checks (e.g. (((1))) in a procedure spec does not
3484 -- conform with ((((1)))) in the body).
3486 -- The parentheses are recorded by keeping a Paren_Count field in every
3487 -- subexpression node (it is actually present in all nodes, but only
3488 -- used in subexpression nodes). This count records the number of
3489 -- levels of parentheses. If the number of levels in the source exceeds
3490 -- the maximum accommodated by this count, then the count is simply left
3491 -- at the maximum value. This means that there are some pathological
3492 -- cases of failure to detect conformance failures (e.g. an expression
3493 -- with 500 levels of parens will conform with one with 501 levels),
3494 -- but we do not need to lose sleep over this.
3496 -- Historical note: in versions of GNAT prior to 1.75, there was a node
3497 -- type N_Parenthesized_Expression used to accurately record unlimited
3498 -- numbers of levels of parentheses. However, it turned out to be a
3499 -- real nuisance to have to take into account the possible presence of
3500 -- this node during semantic analysis, since basically parentheses have
3501 -- zero relevance to semantic analysis.
3503 -- Note: the level of parentheses always present in things like
3504 -- aggregates does not count, only the parentheses in the primary
3505 -- (EXPRESSION) affect the setting of the Paren_Count field.
3507 -- 2nd Note: the contents of the Expression field must be ignored (i.e.
3508 -- treated as though it were Empty) if No_Initialization is set True.
3510 --------------------------------------
3511 -- 4.5 Short Circuit Control Forms --
3512 --------------------------------------
3514 -- EXPRESSION ::=
3515 -- RELATION {and then RELATION} | RELATION {or else RELATION}
3517 -- Gigi restriction: For both these control forms, the operand and
3518 -- result types are always Standard.Boolean. The expander inserts the
3519 -- required conversion operations where needed to ensure this is the
3520 -- case.
3522 -- N_And_Then
3523 -- Sloc points to AND of AND THEN
3524 -- Left_Opnd (Node2)
3525 -- Right_Opnd (Node3)
3526 -- Actions (List1-Sem)
3527 -- plus fields for expression
3529 -- N_Or_Else
3530 -- Sloc points to OR of OR ELSE
3531 -- Left_Opnd (Node2)
3532 -- Right_Opnd (Node3)
3533 -- Actions (List1-Sem)
3534 -- plus fields for expression
3536 -- Note: The Actions field is used to hold actions associated with
3537 -- the right hand operand. These have to be treated specially since
3538 -- they are not unconditionally executed. See Insert_Actions for a
3539 -- more detailed description of how these actions are handled.
3541 ---------------------------
3542 -- 4.5 Membership Tests --
3543 ---------------------------
3545 -- RELATION ::=
3546 -- SIMPLE_EXPRESSION [not] in RANGE
3547 -- | SIMPLE_EXPRESSION [not] in SUBTYPE_MARK
3549 -- Note: although the grammar above allows only a range or a subtype
3550 -- mark, the parser in fact will accept any simple expression in place
3551 -- of a subtype mark. This means that the semantic analyzer must be able
3552 -- to deal with, and diagnose a simple expression other than a name for
3553 -- the right operand. This simplifies error recovery in the parser.
3555 -- If extensions are enabled, the grammar is as follows:
3557 -- RELATION ::=
3558 -- SIMPLE_EXPRESSION [not] in SET_ALTERNATIVE {| SET_ALTERNATIVE}
3560 -- SET_ALTERNATIVE ::= RANGE | SUBTYPE_MARK
3562 -- The Alternatives field below is present only if there is more than
3563 -- one Set_Alternative present, in which case Right_Opnd is set to
3564 -- Empty, and Alternatives contains the list of alternatives. In the
3565 -- tree passed to the back end, Alternatives is always No_List, and
3566 -- Right_Opnd is set (i.e. the expansion circuitry expands out the
3567 -- complex set membership case using simple membership operations).
3569 -- N_In
3570 -- Sloc points to IN
3571 -- Left_Opnd (Node2)
3572 -- Right_Opnd (Node3)
3573 -- Alternatives (List4) (set to No_List if only one set alternative)
3574 -- plus fields for expression
3576 -- N_Not_In
3577 -- Sloc points to NOT of NOT IN
3578 -- Left_Opnd (Node2)
3579 -- Right_Opnd (Node3)
3580 -- Alternatives (List4) (set to No_List if only one set alternative)
3581 -- plus fields for expression
3583 --------------------
3584 -- 4.5 Operators --
3585 --------------------
3587 -- LOGICAL_OPERATOR ::= and | or | xor
3589 -- RELATIONAL_OPERATOR ::= = | /= | < | <= | > | >=
3591 -- BINARY_ADDING_OPERATOR ::= + | - | &
3593 -- UNARY_ADDING_OPERATOR ::= + | -
3595 -- MULTIPLYING_OPERATOR ::= * | / | mod | rem
3597 -- HIGHEST_PRECEDENCE_OPERATOR ::= ** | abs | not
3599 -- Sprint syntax if Treat_Fixed_As_Integer is set:
3601 -- x #* y
3602 -- x #/ y
3603 -- x #mod y
3604 -- x #rem y
3606 -- Gigi restriction: For * / mod rem with fixed-point operands, Gigi
3607 -- will only be given nodes with the Treat_Fixed_As_Integer flag set.
3608 -- All handling of smalls for multiplication and division is handled
3609 -- by the front end (mod and rem result only from expansion). Gigi
3610 -- thus never needs to worry about small values (for other operators
3611 -- operating on fixed-point, e.g. addition, the small value does not
3612 -- have any semantic effect anyway, these are always integer operations.
3614 -- Gigi restriction: For all operators taking Boolean operands, the
3615 -- type is always Standard.Boolean. The expander inserts the required
3616 -- conversion operations where needed to ensure this is the case.
3618 -- N_Op_And
3619 -- Sloc points to AND
3620 -- Do_Length_Check (Flag4-Sem)
3621 -- plus fields for binary operator
3622 -- plus fields for expression
3624 -- N_Op_Or
3625 -- Sloc points to OR
3626 -- Do_Length_Check (Flag4-Sem)
3627 -- plus fields for binary operator
3628 -- plus fields for expression
3630 -- N_Op_Xor
3631 -- Sloc points to XOR
3632 -- Do_Length_Check (Flag4-Sem)
3633 -- plus fields for binary operator
3634 -- plus fields for expression
3636 -- N_Op_Eq
3637 -- Sloc points to =
3638 -- plus fields for binary operator
3639 -- plus fields for expression
3641 -- N_Op_Ne
3642 -- Sloc points to /=
3643 -- plus fields for binary operator
3644 -- plus fields for expression
3646 -- N_Op_Lt
3647 -- Sloc points to <
3648 -- plus fields for binary operator
3649 -- plus fields for expression
3651 -- N_Op_Le
3652 -- Sloc points to <=
3653 -- plus fields for binary operator
3654 -- plus fields for expression
3656 -- N_Op_Gt
3657 -- Sloc points to >
3658 -- plus fields for binary operator
3659 -- plus fields for expression
3661 -- N_Op_Ge
3662 -- Sloc points to >=
3663 -- plus fields for binary operator
3664 -- plus fields for expression
3666 -- N_Op_Add
3667 -- Sloc points to + (binary)
3668 -- plus fields for binary operator
3669 -- plus fields for expression
3671 -- N_Op_Subtract
3672 -- Sloc points to - (binary)
3673 -- plus fields for binary operator
3674 -- plus fields for expression
3676 -- N_Op_Concat
3677 -- Sloc points to &
3678 -- Is_Component_Left_Opnd (Flag13-Sem)
3679 -- Is_Component_Right_Opnd (Flag14-Sem)
3680 -- plus fields for binary operator
3681 -- plus fields for expression
3683 -- N_Op_Multiply
3684 -- Sloc points to *
3685 -- Treat_Fixed_As_Integer (Flag14-Sem)
3686 -- Rounded_Result (Flag18-Sem)
3687 -- plus fields for binary operator
3688 -- plus fields for expression
3690 -- N_Op_Divide
3691 -- Sloc points to /
3692 -- Treat_Fixed_As_Integer (Flag14-Sem)
3693 -- Do_Division_Check (Flag13-Sem)
3694 -- Rounded_Result (Flag18-Sem)
3695 -- plus fields for binary operator
3696 -- plus fields for expression
3698 -- N_Op_Mod
3699 -- Sloc points to MOD
3700 -- Treat_Fixed_As_Integer (Flag14-Sem)
3701 -- Do_Division_Check (Flag13-Sem)
3702 -- plus fields for binary operator
3703 -- plus fields for expression
3705 -- N_Op_Rem
3706 -- Sloc points to REM
3707 -- Treat_Fixed_As_Integer (Flag14-Sem)
3708 -- Do_Division_Check (Flag13-Sem)
3709 -- plus fields for binary operator
3710 -- plus fields for expression
3712 -- N_Op_Expon
3713 -- Is_Power_Of_2_For_Shift (Flag13-Sem)
3714 -- Sloc points to **
3715 -- plus fields for binary operator
3716 -- plus fields for expression
3718 -- N_Op_Plus
3719 -- Sloc points to + (unary)
3720 -- plus fields for unary operator
3721 -- plus fields for expression
3723 -- N_Op_Minus
3724 -- Sloc points to - (unary)
3725 -- plus fields for unary operator
3726 -- plus fields for expression
3728 -- N_Op_Abs
3729 -- Sloc points to ABS
3730 -- plus fields for unary operator
3731 -- plus fields for expression
3733 -- N_Op_Not
3734 -- Sloc points to NOT
3735 -- plus fields for unary operator
3736 -- plus fields for expression
3738 -- See also shift operators in section B.2
3740 -- Note on fixed-point operations passed to Gigi: For adding operators,
3741 -- the semantics is to treat these simply as integer operations, with
3742 -- the small values being ignored (the bounds are already stored in
3743 -- units of small, so that constraint checking works as usual). For the
3744 -- case of multiply/divide/rem/mod operations, Gigi will only see fixed
3745 -- point operands if the Treat_Fixed_As_Integer flag is set and will
3746 -- thus treat these nodes in identical manner, ignoring small values.
3748 --------------------------
3749 -- 4.6 Type Conversion --
3750 --------------------------
3752 -- TYPE_CONVERSION ::=
3753 -- SUBTYPE_MARK (EXPRESSION) | SUBTYPE_MARK (NAME)
3755 -- In the (NAME) case, the name is stored as the expression
3757 -- Note: the parser never generates a type conversion node, since it
3758 -- looks like an indexed component which is generated by preference.
3759 -- The semantic pass must correct this misidentification.
3761 -- Gigi handles conversions that involve no change in the root type,
3762 -- and also all conversions from integer to floating-point types.
3763 -- Conversions from floating-point to integer are only handled in
3764 -- the case where Float_Truncate flag set. Other conversions from
3765 -- floating-point to integer (involving rounding) and all conversions
3766 -- involving fixed-point types are handled by the expander.
3768 -- Sprint syntax if Float_Truncate set: X^(Y)
3769 -- Sprint syntax if Conversion_OK set X?(Y)
3770 -- Sprint syntax if both flags set X?^(Y)
3772 -- Note: If either the operand or result type is fixed-point, Gigi will
3773 -- only see a type conversion node with Conversion_OK set. The front end
3774 -- takes care of all handling of small's for fixed-point conversions.
3776 -- N_Type_Conversion
3777 -- Sloc points to first token of subtype mark
3778 -- Subtype_Mark (Node4)
3779 -- Expression (Node3)
3780 -- Do_Tag_Check (Flag13-Sem)
3781 -- Do_Length_Check (Flag4-Sem)
3782 -- Do_Overflow_Check (Flag17-Sem)
3783 -- Float_Truncate (Flag11-Sem)
3784 -- Rounded_Result (Flag18-Sem)
3785 -- Conversion_OK (Flag14-Sem)
3786 -- plus fields for expression
3788 -- Note: if a range check is required, then the Do_Range_Check flag
3789 -- is set in the Expression with the check being done against the
3790 -- target type range (after the base type conversion, if any).
3792 -------------------------------
3793 -- 4.7 Qualified Expression --
3794 -------------------------------
3796 -- QUALIFIED_EXPRESSION ::=
3797 -- SUBTYPE_MARK ' (EXPRESSION) | SUBTYPE_MARK ' AGGREGATE
3799 -- Note: the parentheses in the (EXPRESSION) case are deemed to enclose
3800 -- the expression, so the Expression field of this node always points
3801 -- to a parenthesized expression in this case (i.e. Paren_Count will
3802 -- always be non-zero for the referenced expression if it is not an
3803 -- aggregate).
3805 -- N_Qualified_Expression
3806 -- Sloc points to apostrophe
3807 -- Subtype_Mark (Node4)
3808 -- Expression (Node3) expression or aggregate
3809 -- plus fields for expression
3811 --------------------
3812 -- 4.8 Allocator --
3813 --------------------
3815 -- ALLOCATOR ::=
3816 -- new [NULL_EXCLUSION] SUBTYPE_INDICATION | new QUALIFIED_EXPRESSION
3818 -- Sprint syntax (when storage pool present)
3819 -- new xxx (storage_pool = pool)
3821 -- N_Allocator
3822 -- Sloc points to NEW
3823 -- Expression (Node3) subtype indication or qualified expression
3824 -- Storage_Pool (Node1-Sem)
3825 -- Procedure_To_Call (Node2-Sem)
3826 -- Coextensions (Elist4-Sem)
3827 -- Null_Exclusion_Present (Flag11)
3828 -- No_Initialization (Flag13-Sem)
3829 -- Is_Static_Coextension (Flag14-Sem)
3830 -- Do_Storage_Check (Flag17-Sem)
3831 -- Is_Dynamic_Coextension (Flag18-Sem)
3832 -- plus fields for expression
3834 -- Note: like all nodes, the N_Allocator has the Comes_From_Source flag.
3835 -- This flag has a special function in conjunction with the restriction
3836 -- No_Implicit_Heap_Allocations, which will be triggered if this flag
3837 -- is not set. This means that if a source allocator is replaced with
3838 -- a constructed allocator, the Comes_From_Source flag should be copied
3839 -- to the newly created allocator.
3841 ---------------------------------
3842 -- 5.1 Sequence Of Statements --
3843 ---------------------------------
3845 -- SEQUENCE_OF_STATEMENTS ::= STATEMENT {STATEMENT}
3847 -- Note: Although the parser will not accept a declaration as a
3848 -- statement, the semantic analyzer may insert declarations (e.g.
3849 -- declarations of implicit types needed for execution of other
3850 -- statements) into a sequence of statements, so the code generator
3851 -- should be prepared to accept a declaration where a statement is
3852 -- expected. Note also that pragmas can appear as statements.
3854 --------------------
3855 -- 5.1 Statement --
3856 --------------------
3858 -- STATEMENT ::=
3859 -- {LABEL} SIMPLE_STATEMENT | {LABEL} COMPOUND_STATEMENT
3861 -- There is no explicit node in the tree for a statement. Instead, the
3862 -- individual statement appears directly. Labels are treated as a
3863 -- kind of statement, i.e. they are linked into a statement list at
3864 -- the point they appear, so the labeled statement appears following
3865 -- the label or labels in the statement list.
3867 ---------------------------
3868 -- 5.1 Simple Statement --
3869 ---------------------------
3871 -- SIMPLE_STATEMENT ::= NULL_STATEMENT
3872 -- | ASSIGNMENT_STATEMENT | EXIT_STATEMENT
3873 -- | GOTO_STATEMENT | PROCEDURE_CALL_STATEMENT
3874 -- | SIMPLE_RETURN_STATEMENT | ENTRY_CALL_STATEMENT
3875 -- | REQUEUE_STATEMENT | DELAY_STATEMENT
3876 -- | ABORT_STATEMENT | RAISE_STATEMENT
3877 -- | CODE_STATEMENT
3879 -----------------------------
3880 -- 5.1 Compound Statement --
3881 -----------------------------
3883 -- COMPOUND_STATEMENT ::=
3884 -- IF_STATEMENT | CASE_STATEMENT
3885 -- | LOOP_STATEMENT | BLOCK_STATEMENT
3886 -- | EXTENDED_RETURN_STATEMENT
3887 -- | ACCEPT_STATEMENT | SELECT_STATEMENT
3889 -------------------------
3890 -- 5.1 Null Statement --
3891 -------------------------
3893 -- NULL_STATEMENT ::= null;
3895 -- N_Null_Statement
3896 -- Sloc points to NULL
3898 ----------------
3899 -- 5.1 Label --
3900 ----------------
3902 -- LABEL ::= <<label_STATEMENT_IDENTIFIER>>
3904 -- Note that the occurrence of a label is not a defining identifier,
3905 -- but rather a referencing occurrence. The defining occurrence is
3906 -- in the implicit label declaration which occurs in the innermost
3907 -- enclosing block.
3909 -- N_Label
3910 -- Sloc points to <<
3911 -- Identifier (Node1) direct name of statement identifier
3912 -- Exception_Junk (Flag8-Sem)
3914 -------------------------------
3915 -- 5.1 Statement Identifier --
3916 -------------------------------
3918 -- STATEMENT_IDENTIFIER ::= DIRECT_NAME
3920 -- The IDENTIFIER of a STATEMENT_IDENTIFIER shall be an identifier
3921 -- (not an OPERATOR_SYMBOL)
3923 -------------------------------
3924 -- 5.2 Assignment Statement --
3925 -------------------------------
3927 -- ASSIGNMENT_STATEMENT ::=
3928 -- variable_NAME := EXPRESSION;
3930 -- N_Assignment_Statement
3931 -- Sloc points to :=
3932 -- Name (Node2)
3933 -- Expression (Node3)
3934 -- Do_Tag_Check (Flag13-Sem)
3935 -- Do_Length_Check (Flag4-Sem)
3936 -- Forwards_OK (Flag5-Sem)
3937 -- Backwards_OK (Flag6-Sem)
3938 -- No_Ctrl_Actions (Flag7-Sem)
3939 -- Componentwise_Assignment (Flag14-Sem)
3941 -- Note: if a range check is required, then the Do_Range_Check flag
3942 -- is set in the Expression (right hand side), with the check being
3943 -- done against the type of the Name (left hand side).
3945 -- Note: the back end places some restrictions on the form of the
3946 -- Expression field. If the object being assigned to is Atomic, then
3947 -- the Expression may not have the form of an aggregate (since this
3948 -- might cause the back end to generate separate assignments). In this
3949 -- case the front end must generate an extra temporary and initialize
3950 -- this temporary as required (the temporary itself is not atomic).
3952 -----------------------
3953 -- 5.3 If Statement --
3954 -----------------------
3956 -- IF_STATEMENT ::=
3957 -- if CONDITION then
3958 -- SEQUENCE_OF_STATEMENTS
3959 -- {elsif CONDITION then
3960 -- SEQUENCE_OF_STATEMENTS}
3961 -- [else
3962 -- SEQUENCE_OF_STATEMENTS]
3963 -- end if;
3965 -- Gigi restriction: This expander ensures that the type of the
3966 -- Condition fields is always Standard.Boolean, even if the type
3967 -- in the source is some non-standard boolean type.
3969 -- N_If_Statement
3970 -- Sloc points to IF
3971 -- Condition (Node1)
3972 -- Then_Statements (List2)
3973 -- Elsif_Parts (List3) (set to No_List if none present)
3974 -- Else_Statements (List4) (set to No_List if no else part present)
3975 -- End_Span (Uint5) (set to No_Uint if expander generated)
3977 -- N_Elsif_Part
3978 -- Sloc points to ELSIF
3979 -- Condition (Node1)
3980 -- Then_Statements (List2)
3981 -- Condition_Actions (List3-Sem)
3983 --------------------
3984 -- 5.3 Condition --
3985 --------------------
3987 -- CONDITION ::= boolean_EXPRESSION
3989 -------------------------
3990 -- 5.4 Case Statement --
3991 -------------------------
3993 -- CASE_STATEMENT ::=
3994 -- case EXPRESSION is
3995 -- CASE_STATEMENT_ALTERNATIVE
3996 -- {CASE_STATEMENT_ALTERNATIVE}
3997 -- end case;
3999 -- Note: the Alternatives can contain pragmas. These only occur at
4000 -- the start of the list, since any pragmas occurring after the first
4001 -- alternative are absorbed into the corresponding statement sequence.
4003 -- N_Case_Statement
4004 -- Sloc points to CASE
4005 -- Expression (Node3)
4006 -- Alternatives (List4)
4007 -- End_Span (Uint5) (set to No_Uint if expander generated)
4009 -------------------------------------
4010 -- 5.4 Case Statement Alternative --
4011 -------------------------------------
4013 -- CASE_STATEMENT_ALTERNATIVE ::=
4014 -- when DISCRETE_CHOICE_LIST =>
4015 -- SEQUENCE_OF_STATEMENTS
4017 -- N_Case_Statement_Alternative
4018 -- Sloc points to WHEN
4019 -- Discrete_Choices (List4)
4020 -- Statements (List3)
4022 -------------------------
4023 -- 5.5 Loop Statement --
4024 -------------------------
4026 -- LOOP_STATEMENT ::=
4027 -- [loop_STATEMENT_IDENTIFIER :]
4028 -- [ITERATION_SCHEME] loop
4029 -- SEQUENCE_OF_STATEMENTS
4030 -- end loop [loop_IDENTIFIER];
4032 -- Note: The occurrence of a loop label is not a defining identifier
4033 -- but rather a referencing occurrence. The defining occurrence is in
4034 -- the implicit label declaration which occurs in the innermost
4035 -- enclosing block.
4037 -- Note: there is always a loop statement identifier present in
4038 -- the tree, even if none was given in the source. In the case where
4039 -- no loop identifier is given in the source, the parser creates
4040 -- a name of the form _Loop_n, where n is a decimal integer (the
4041 -- two underlines ensure that the loop names created in this manner
4042 -- do not conflict with any user defined identifiers), and the flag
4043 -- Has_Created_Identifier is set to True. The only exception to the
4044 -- rule that all loop statement nodes have identifiers occurs for
4045 -- loops constructed by the expander, and the semantic analyzer will
4046 -- create and supply dummy loop identifiers in these cases.
4048 -- N_Loop_Statement
4049 -- Sloc points to LOOP
4050 -- Identifier (Node1) loop identifier (set to Empty if no identifier)
4051 -- Iteration_Scheme (Node2) (set to Empty if no iteration scheme)
4052 -- Statements (List3)
4053 -- End_Label (Node4)
4054 -- Has_Created_Identifier (Flag15)
4055 -- Is_Null_Loop (Flag16)
4056 -- Suppress_Loop_Warnings (Flag17)
4058 -- Note: the parser fills in the Identifier field if there is an
4059 -- explicit loop identifier. Otherwise the parser leaves this field
4060 -- set to Empty, and then the semantic processing for a loop statement
4061 -- creates an identifier, setting the Has_Created_Identifier flag to
4062 -- True. So after semantic anlaysis, the Identifier is always set,
4063 -- referencing an identifier whose entity has an Ekind of E_Loop.
4065 --------------------------
4066 -- 5.5 Iteration Scheme --
4067 --------------------------
4069 -- ITERATION_SCHEME ::=
4070 -- while CONDITION | for LOOP_PARAMETER_SPECIFICATION
4072 -- Gigi restriction: This expander ensures that the type of the
4073 -- Condition field is always Standard.Boolean, even if the type
4074 -- in the source is some non-standard boolean type.
4076 -- N_Iteration_Scheme
4077 -- Sloc points to WHILE or FOR
4078 -- Condition (Node1) (set to Empty if FOR case)
4079 -- Condition_Actions (List3-Sem)
4080 -- Loop_Parameter_Specification (Node4) (set to Empty if WHILE case)
4082 ---------------------------------------
4083 -- 5.5 Loop parameter specification --
4084 ---------------------------------------
4086 -- LOOP_PARAMETER_SPECIFICATION ::=
4087 -- DEFINING_IDENTIFIER in [reverse] DISCRETE_SUBTYPE_DEFINITION
4089 -- N_Loop_Parameter_Specification
4090 -- Sloc points to first identifier
4091 -- Defining_Identifier (Node1)
4092 -- Reverse_Present (Flag15)
4093 -- Discrete_Subtype_Definition (Node4)
4095 --------------------------
4096 -- 5.6 Block Statement --
4097 --------------------------
4099 -- BLOCK_STATEMENT ::=
4100 -- [block_STATEMENT_IDENTIFIER:]
4101 -- [declare
4102 -- DECLARATIVE_PART]
4103 -- begin
4104 -- HANDLED_SEQUENCE_OF_STATEMENTS
4105 -- end [block_IDENTIFIER];
4107 -- Note that the occurrence of a block identifier is not a defining
4108 -- identifier, but rather a referencing occurrence. The defining
4109 -- occurrence is an E_Block entity declared by the implicit label
4110 -- declaration which occurs in the innermost enclosing block statement
4111 -- or body; the block identifier denotes that E_Block.
4113 -- For block statements that come from source code, there is always a
4114 -- block statement identifier present in the tree, denoting an
4115 -- E_Block. In the case where no block identifier is given in the
4116 -- source, the parser creates a name of the form B_n, where n is a
4117 -- decimal integer, and the flag Has_Created_Identifier is set to
4118 -- True. Blocks constructed by the expander usually have no identifier,
4119 -- and no corresponding entity.
4121 -- Note: the block statement created for an extended return statement
4122 -- has an entity, and this entity is an E_Return_Statement, rather than
4123 -- the usual E_Block.
4125 -- Note: Exception_Junk is set for the wrapping blocks created during
4126 -- local raise optimization (Exp_Ch11.Expand_Local_Exception_Handlers).
4128 -- N_Block_Statement
4129 -- Sloc points to DECLARE or BEGIN
4130 -- Identifier (Node1) block direct name (set to Empty if not present)
4131 -- Declarations (List2) (set to No_List if no DECLARE part)
4132 -- Handled_Statement_Sequence (Node4)
4133 -- Is_Task_Master (Flag5-Sem)
4134 -- Activation_Chain_Entity (Node3-Sem)
4135 -- Has_Created_Identifier (Flag15)
4136 -- Is_Task_Allocation_Block (Flag6)
4137 -- Is_Asynchronous_Call_Block (Flag7)
4138 -- Exception_Junk (Flag8-Sem)
4140 -------------------------
4141 -- 5.7 Exit Statement --
4142 -------------------------
4144 -- EXIT_STATEMENT ::= exit [loop_NAME] [when CONDITION];
4146 -- Gigi restriction: This expander ensures that the type of the
4147 -- Condition field is always Standard.Boolean, even if the type
4148 -- in the source is some non-standard boolean type.
4150 -- N_Exit_Statement
4151 -- Sloc points to EXIT
4152 -- Name (Node2) (set to Empty if no loop name present)
4153 -- Condition (Node1) (set to Empty if no WHEN part present)
4154 -- Next_Exit_Statement (Node3-Sem): Next exit on chain
4156 -------------------------
4157 -- 5.9 Goto Statement --
4158 -------------------------
4160 -- GOTO_STATEMENT ::= goto label_NAME;
4162 -- N_Goto_Statement
4163 -- Sloc points to GOTO
4164 -- Name (Node2)
4165 -- Exception_Junk (Flag8-Sem)
4167 ---------------------------------
4168 -- 6.1 Subprogram Declaration --
4169 ---------------------------------
4171 -- SUBPROGRAM_DECLARATION ::= SUBPROGRAM_SPECIFICATION;
4173 -- N_Subprogram_Declaration
4174 -- Sloc points to FUNCTION or PROCEDURE
4175 -- Specification (Node1)
4176 -- Body_To_Inline (Node3-Sem)
4177 -- Corresponding_Body (Node5-Sem)
4178 -- Parent_Spec (Node4-Sem)
4180 ------------------------------------------
4181 -- 6.1 Abstract Subprogram Declaration --
4182 ------------------------------------------
4184 -- ABSTRACT_SUBPROGRAM_DECLARATION ::=
4185 -- SUBPROGRAM_SPECIFICATION is abstract;
4187 -- N_Abstract_Subprogram_Declaration
4188 -- Sloc points to ABSTRACT
4189 -- Specification (Node1)
4191 -----------------------------------
4192 -- 6.1 Subprogram Specification --
4193 -----------------------------------
4195 -- SUBPROGRAM_SPECIFICATION ::=
4196 -- [[not] overriding]
4197 -- procedure DEFINING_PROGRAM_UNIT_NAME PARAMETER_PROFILE
4198 -- | [[not] overriding]
4199 -- function DEFINING_DESIGNATOR PARAMETER_AND_RESULT_PROFILE
4201 -- Note: there are no separate nodes for the profiles, instead the
4202 -- information appears directly in the following nodes.
4204 -- N_Function_Specification
4205 -- Sloc points to FUNCTION
4206 -- Defining_Unit_Name (Node1) (the designator)
4207 -- Elaboration_Boolean (Node2-Sem)
4208 -- Parameter_Specifications (List3) (set to No_List if no formal part)
4209 -- Null_Exclusion_Present (Flag11)
4210 -- Result_Definition (Node4) for result subtype
4211 -- Generic_Parent (Node5-Sem)
4212 -- Must_Override (Flag14) set if overriding indicator present
4213 -- Must_Not_Override (Flag15) set if not_overriding indicator present
4215 -- N_Procedure_Specification
4216 -- Sloc points to PROCEDURE
4217 -- Defining_Unit_Name (Node1)
4218 -- Elaboration_Boolean (Node2-Sem)
4219 -- Parameter_Specifications (List3) (set to No_List if no formal part)
4220 -- Generic_Parent (Node5-Sem)
4221 -- Null_Present (Flag13) set for null procedure case (Ada 2005 feature)
4222 -- Must_Override (Flag14) set if overriding indicator present
4223 -- Must_Not_Override (Flag15) set if not_overriding indicator present
4225 -- Note: overriding indicator is an Ada 2005 feature
4227 ---------------------
4228 -- 6.1 Designator --
4229 ---------------------
4231 -- DESIGNATOR ::=
4232 -- [PARENT_UNIT_NAME .] IDENTIFIER | OPERATOR_SYMBOL
4234 -- Designators that are simply identifiers or operator symbols appear
4235 -- directly in the tree in this form. The following node is used only
4236 -- in the case where the designator has a parent unit name component.
4238 -- N_Designator
4239 -- Sloc points to period
4240 -- Name (Node2) holds the parent unit name. Note that this is always
4241 -- non-Empty, since this node is only used for the case where a
4242 -- parent library unit package name is present.
4243 -- Identifier (Node1)
4245 -- Note that the identifier can also be an operator symbol here
4247 ------------------------------
4248 -- 6.1 Defining Designator --
4249 ------------------------------
4251 -- DEFINING_DESIGNATOR ::=
4252 -- DEFINING_PROGRAM_UNIT_NAME | DEFINING_OPERATOR_SYMBOL
4254 -------------------------------------
4255 -- 6.1 Defining Program Unit Name --
4256 -------------------------------------
4258 -- DEFINING_PROGRAM_UNIT_NAME ::=
4259 -- [PARENT_UNIT_NAME .] DEFINING_IDENTIFIER
4261 -- The parent unit name is present only in the case of a child unit
4262 -- name (permissible only for Ada 95 for a library level unit, i.e.
4263 -- a unit at scope level one). If no such name is present, the defining
4264 -- program unit name is represented simply as the defining identifier.
4265 -- In the child unit case, the following node is used to represent the
4266 -- child unit name.
4268 -- N_Defining_Program_Unit_Name
4269 -- Sloc points to period
4270 -- Name (Node2) holds the parent unit name. Note that this is always
4271 -- non-Empty, since this node is only used for the case where a
4272 -- parent unit name is present.
4273 -- Defining_Identifier (Node1)
4275 --------------------------
4276 -- 6.1 Operator Symbol --
4277 --------------------------
4279 -- OPERATOR_SYMBOL ::= STRING_LITERAL
4281 -- Note: the fields of the N_Operator_Symbol node are laid out to
4282 -- match the corresponding fields of an N_Character_Literal node. This
4283 -- allows easy conversion of the operator symbol node into a character
4284 -- literal node in the case where a string constant of the form of an
4285 -- operator symbol is scanned out as such, but turns out semantically
4286 -- to be a string literal that is not an operator. For details see
4287 -- Sinfo.CN.Change_Operator_Symbol_To_String_Literal.
4289 -- N_Operator_Symbol
4290 -- Sloc points to literal
4291 -- Chars (Name1) contains the Name_Id for the operator symbol
4292 -- Strval (Str3) Id of string value. This is used if the operator
4293 -- symbol turns out to be a normal string after all.
4294 -- Entity (Node4-Sem)
4295 -- Associated_Node (Node4-Sem)
4296 -- Has_Private_View (Flag11-Sem) set in generic units.
4297 -- Etype (Node5-Sem)
4299 -- Note: the Strval field may be set to No_String for generated
4300 -- operator symbols that are known not to be string literals
4301 -- semantically.
4303 -----------------------------------
4304 -- 6.1 Defining Operator Symbol --
4305 -----------------------------------
4307 -- DEFINING_OPERATOR_SYMBOL ::= OPERATOR_SYMBOL
4309 -- A defining operator symbol is an entity, which has additional
4310 -- fields depending on the setting of the Ekind field. These
4311 -- additional fields are defined (and access subprograms declared)
4312 -- in package Einfo.
4314 -- Note: N_Defining_Operator_Symbol is an extended node whose fields
4315 -- are deliberately layed out to match the layout of fields in an
4316 -- ordinary N_Operator_Symbol node allowing for easy alteration of
4317 -- an operator symbol node into a defining operator symbol node.
4318 -- See Sinfo.CN.Change_Operator_Symbol_To_Defining_Operator_Symbol
4319 -- for further details.
4321 -- N_Defining_Operator_Symbol
4322 -- Sloc points to literal
4323 -- Chars (Name1) contains the Name_Id for the operator symbol
4324 -- Next_Entity (Node2-Sem)
4325 -- Scope (Node3-Sem)
4326 -- Etype (Node5-Sem)
4328 ----------------------------
4329 -- 6.1 Parameter Profile --
4330 ----------------------------
4332 -- PARAMETER_PROFILE ::= [FORMAL_PART]
4334 ---------------------------------------
4335 -- 6.1 Parameter and Result Profile --
4336 ---------------------------------------
4338 -- PARAMETER_AND_RESULT_PROFILE ::=
4339 -- [FORMAL_PART] return [NULL_EXCLUSION] SUBTYPE_MARK
4340 -- | [FORMAL_PART] return ACCESS_DEFINITION
4342 -- There is no explicit node in the tree for a parameter and result
4343 -- profile. Instead the information appears directly in the parent.
4345 ----------------------
4346 -- 6.1 Formal part --
4347 ----------------------
4349 -- FORMAL_PART ::=
4350 -- (PARAMETER_SPECIFICATION {; PARAMETER_SPECIFICATION})
4352 ----------------------------------
4353 -- 6.1 Parameter specification --
4354 ----------------------------------
4356 -- PARAMETER_SPECIFICATION ::=
4357 -- DEFINING_IDENTIFIER_LIST : MODE [NULL_EXCLUSION] SUBTYPE_MARK
4358 -- [:= DEFAULT_EXPRESSION]
4359 -- | DEFINING_IDENTIFIER_LIST : ACCESS_DEFINITION
4360 -- [:= DEFAULT_EXPRESSION]
4362 -- Although the syntax allows multiple identifiers in the list, the
4363 -- semantics is as though successive specifications were given with
4364 -- identical type definition and expression components. To simplify
4365 -- semantic processing, the parser represents a multiple declaration
4366 -- case as a sequence of single Specifications, using the More_Ids and
4367 -- Prev_Ids flags to preserve the original source form as described
4368 -- in the section on "Handling of Defining Identifier Lists".
4370 -- N_Parameter_Specification
4371 -- Sloc points to first identifier
4372 -- Defining_Identifier (Node1)
4373 -- In_Present (Flag15)
4374 -- Out_Present (Flag17)
4375 -- Null_Exclusion_Present (Flag11)
4376 -- Parameter_Type (Node2) subtype mark or access definition
4377 -- Expression (Node3) (set to Empty if no default expression present)
4378 -- Do_Accessibility_Check (Flag13-Sem)
4379 -- More_Ids (Flag5) (set to False if no more identifiers in list)
4380 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
4381 -- Default_Expression (Node5-Sem)
4383 ---------------
4384 -- 6.1 Mode --
4385 ---------------
4387 -- MODE ::= [in] | in out | out
4389 -- There is no explicit node in the tree for the Mode. Instead the
4390 -- In_Present and Out_Present flags are set in the parent node to
4391 -- record the presence of keywords specifying the mode.
4393 --------------------------
4394 -- 6.3 Subprogram Body --
4395 --------------------------
4397 -- SUBPROGRAM_BODY ::=
4398 -- SUBPROGRAM_SPECIFICATION is
4399 -- DECLARATIVE_PART
4400 -- begin
4401 -- HANDLED_SEQUENCE_OF_STATEMENTS
4402 -- end [DESIGNATOR];
4404 -- N_Subprogram_Body
4405 -- Sloc points to FUNCTION or PROCEDURE
4406 -- Specification (Node1)
4407 -- Declarations (List2)
4408 -- Handled_Statement_Sequence (Node4)
4409 -- Activation_Chain_Entity (Node3-Sem)
4410 -- Corresponding_Spec (Node5-Sem)
4411 -- Acts_As_Spec (Flag4-Sem)
4412 -- Bad_Is_Detected (Flag15) used only by parser
4413 -- Do_Storage_Check (Flag17-Sem)
4414 -- Has_Priority_Pragma (Flag6-Sem)
4415 -- Is_Protected_Subprogram_Body (Flag7-Sem)
4416 -- Is_Entry_Barrier_Function (Flag8-Sem)
4417 -- Is_Task_Master (Flag5-Sem)
4418 -- Was_Originally_Stub (Flag13-Sem)
4419 -- Has_Relative_Deadline_Pragma (Flag9-Sem)
4421 -----------------------------------
4422 -- 6.4 Procedure Call Statement --
4423 -----------------------------------
4425 -- PROCEDURE_CALL_STATEMENT ::=
4426 -- procedure_NAME; | procedure_PREFIX ACTUAL_PARAMETER_PART;
4428 -- Note: the reason that a procedure call has expression fields is
4429 -- that it semantically resembles an expression, e.g. overloading is
4430 -- allowed and a type is concocted for semantic processing purposes.
4431 -- Certain of these fields, such as Parens are not relevant, but it
4432 -- is easier to just supply all of them together!
4434 -- N_Procedure_Call_Statement
4435 -- Sloc points to first token of name or prefix
4436 -- Name (Node2) stores name or prefix
4437 -- Parameter_Associations (List3) (set to No_List if no
4438 -- actual parameter part)
4439 -- First_Named_Actual (Node4-Sem)
4440 -- Controlling_Argument (Node1-Sem) (set to Empty if not dispatching)
4441 -- Do_Tag_Check (Flag13-Sem)
4442 -- No_Elaboration_Check (Flag14-Sem)
4443 -- Parameter_List_Truncated (Flag17-Sem)
4444 -- ABE_Is_Certain (Flag18-Sem)
4445 -- plus fields for expression
4447 -- If any IN parameter requires a range check, then the corresponding
4448 -- argument expression has the Do_Range_Check flag set, and the range
4449 -- check is done against the formal type. Note that this argument
4450 -- expression may appear directly in the Parameter_Associations list,
4451 -- or may be a descendent of an N_Parameter_Association node that
4452 -- appears in this list.
4454 ------------------------
4455 -- 6.4 Function Call --
4456 ------------------------
4458 -- FUNCTION_CALL ::=
4459 -- function_NAME | function_PREFIX ACTUAL_PARAMETER_PART
4461 -- Note: the parser may generate an indexed component node or simply
4462 -- a name node instead of a function call node. The semantic pass must
4463 -- correct this misidentification.
4465 -- N_Function_Call
4466 -- Sloc points to first token of name or prefix
4467 -- Name (Node2) stores name or prefix
4468 -- Parameter_Associations (List3) (set to No_List if no
4469 -- actual parameter part)
4470 -- First_Named_Actual (Node4-Sem)
4471 -- Controlling_Argument (Node1-Sem) (set to Empty if not dispatching)
4472 -- Is_Expanded_Build_In_Place_Call (Flag11-Sem)
4473 -- Do_Tag_Check (Flag13-Sem)
4474 -- No_Elaboration_Check (Flag14-Sem)
4475 -- Parameter_List_Truncated (Flag17-Sem)
4476 -- ABE_Is_Certain (Flag18-Sem)
4477 -- plus fields for expression
4479 --------------------------------
4480 -- 6.4 Actual Parameter Part --
4481 --------------------------------
4483 -- ACTUAL_PARAMETER_PART ::=
4484 -- (PARAMETER_ASSOCIATION {,PARAMETER_ASSOCIATION})
4486 --------------------------------
4487 -- 6.4 Parameter Association --
4488 --------------------------------
4490 -- PARAMETER_ASSOCIATION ::=
4491 -- [formal_parameter_SELECTOR_NAME =>] EXPLICIT_ACTUAL_PARAMETER
4493 -- Note: the N_Parameter_Association node is built only if a formal
4494 -- parameter selector name is present, otherwise the parameter
4495 -- association appears in the tree simply as the node for the
4496 -- explicit actual parameter.
4498 -- N_Parameter_Association
4499 -- Sloc points to formal parameter
4500 -- Selector_Name (Node2) (always non-Empty)
4501 -- Explicit_Actual_Parameter (Node3)
4502 -- Next_Named_Actual (Node4-Sem)
4503 -- Is_Accessibility_Actual (Flag13-Sem)
4505 ---------------------------
4506 -- 6.4 Actual Parameter --
4507 ---------------------------
4509 -- EXPLICIT_ACTUAL_PARAMETER ::= EXPRESSION | variable_NAME
4511 ---------------------------
4512 -- 6.5 Return Statement --
4513 ---------------------------
4515 -- RETURN_STATEMENT ::= return [EXPRESSION]; -- Ada 95
4517 -- In Ada 2005, we have:
4519 -- SIMPLE_RETURN_STATEMENT ::= return [EXPRESSION];
4521 -- EXTENDED_RETURN_STATEMENT ::=
4522 -- return DEFINING_IDENTIFIER : [aliased] RETURN_SUBTYPE_INDICATION
4523 -- [:= EXPRESSION] [do
4524 -- HANDLED_SEQUENCE_OF_STATEMENTS
4525 -- end return];
4527 -- RETURN_SUBTYPE_INDICATION ::= SUBTYPE_INDICATION | ACCESS_DEFINITION
4529 -- So in Ada 2005, RETURN_STATEMENT is no longer a nonterminal, but
4530 -- "return statement" is defined in 6.5 to mean a
4531 -- SIMPLE_RETURN_STATEMENT or an EXTENDED_RETURN_STATEMENT.
4533 -- N_Return_Statement
4534 -- Sloc points to RETURN
4535 -- Return_Statement_Entity (Node5-Sem)
4536 -- Expression (Node3) (set to Empty if no expression present)
4537 -- Storage_Pool (Node1-Sem)
4538 -- Procedure_To_Call (Node2-Sem)
4539 -- Do_Tag_Check (Flag13-Sem)
4540 -- By_Ref (Flag5-Sem)
4541 -- Comes_From_Extended_Return_Statement (Flag18-Sem)
4543 -- N_Return_Statement represents a simple_return_statement, and is
4544 -- renamed to be N_Simple_Return_Statement below. Clients should refer
4545 -- to N_Simple_Return_Statement. We retain N_Return_Statement because
4546 -- that's how gigi knows it. See also renaming of Make_Return_Statement
4547 -- as Make_Simple_Return_Statement in Sem_Util.
4549 -- Note: Return_Statement_Entity points to an E_Return_Statement
4551 -- If a range check is required, then Do_Range_Check is set on the
4552 -- Expression. The check is against the return subtype of the function.
4554 -- N_Extended_Return_Statement
4555 -- Sloc points to RETURN
4556 -- Return_Statement_Entity (Node5-Sem)
4557 -- Return_Object_Declarations (List3)
4558 -- Handled_Statement_Sequence (Node4) (set to Empty if not present)
4559 -- Storage_Pool (Node1-Sem)
4560 -- Procedure_To_Call (Node2-Sem)
4561 -- Do_Tag_Check (Flag13-Sem)
4562 -- By_Ref (Flag5-Sem)
4564 -- Note: Return_Statement_Entity points to an E_Return_Statement.
4565 -- Note that Return_Object_Declarations is a list containing the
4566 -- N_Object_Declaration -- see comment on this field above.
4567 -- The declared object will have Is_Return_Object = True.
4568 -- There is no such syntactic category as return_object_declaration
4569 -- in the RM. Return_Object_Declarations represents this portion of
4570 -- the syntax for EXTENDED_RETURN_STATEMENT:
4571 -- DEFINING_IDENTIFIER : [aliased] RETURN_SUBTYPE_INDICATION
4572 -- [:= EXPRESSION]
4574 -- There are two entities associated with an extended_return_statement:
4575 -- the Return_Statement_Entity represents the statement itself, and the
4576 -- Defining_Identifier of the Object_Declaration in
4577 -- Return_Object_Declarations represents the object being
4578 -- returned. N_Simple_Return_Statement has only the former.
4580 ------------------------------
4581 -- 7.1 Package Declaration --
4582 ------------------------------
4584 -- PACKAGE_DECLARATION ::= PACKAGE_SPECIFICATION;
4586 -- Note: the activation chain entity for a package spec is used for
4587 -- all tasks declared in the package spec, or in the package body.
4589 -- N_Package_Declaration
4590 -- Sloc points to PACKAGE
4591 -- Specification (Node1)
4592 -- Corresponding_Body (Node5-Sem)
4593 -- Parent_Spec (Node4-Sem)
4594 -- Activation_Chain_Entity (Node3-Sem)
4596 --------------------------------
4597 -- 7.1 Package Specification --
4598 --------------------------------
4600 -- PACKAGE_SPECIFICATION ::=
4601 -- package DEFINING_PROGRAM_UNIT_NAME is
4602 -- {BASIC_DECLARATIVE_ITEM}
4603 -- [private
4604 -- {BASIC_DECLARATIVE_ITEM}]
4605 -- end [[PARENT_UNIT_NAME .] IDENTIFIER]
4607 -- N_Package_Specification
4608 -- Sloc points to PACKAGE
4609 -- Defining_Unit_Name (Node1)
4610 -- Visible_Declarations (List2)
4611 -- Private_Declarations (List3) (set to No_List if no private
4612 -- part present)
4613 -- End_Label (Node4)
4614 -- Generic_Parent (Node5-Sem)
4615 -- Limited_View_Installed (Flag18-Sem)
4617 -----------------------
4618 -- 7.1 Package Body --
4619 -----------------------
4621 -- PACKAGE_BODY ::=
4622 -- package body DEFINING_PROGRAM_UNIT_NAME is
4623 -- DECLARATIVE_PART
4624 -- [begin
4625 -- HANDLED_SEQUENCE_OF_STATEMENTS]
4626 -- end [[PARENT_UNIT_NAME .] IDENTIFIER];
4628 -- N_Package_Body
4629 -- Sloc points to PACKAGE
4630 -- Defining_Unit_Name (Node1)
4631 -- Declarations (List2)
4632 -- Handled_Statement_Sequence (Node4) (set to Empty if no HSS present)
4633 -- Corresponding_Spec (Node5-Sem)
4634 -- Was_Originally_Stub (Flag13-Sem)
4636 -- Note: if a source level package does not contain a handled sequence
4637 -- of statements, then the parser supplies a dummy one with a null
4638 -- sequence of statements. Comes_From_Source will be False in this
4639 -- constructed sequence. The reason we need this is for the End_Label
4640 -- field in the HSS.
4642 -----------------------------------
4643 -- 7.4 Private Type Declaration --
4644 -----------------------------------
4646 -- PRIVATE_TYPE_DECLARATION ::=
4647 -- type DEFINING_IDENTIFIER [DISCRIMINANT_PART]
4648 -- is [[abstract] tagged] [limited] private;
4650 -- Note: TAGGED is not permitted in Ada 83 mode
4652 -- N_Private_Type_Declaration
4653 -- Sloc points to TYPE
4654 -- Defining_Identifier (Node1)
4655 -- Discriminant_Specifications (List4) (set to No_List if no
4656 -- discriminant part)
4657 -- Unknown_Discriminants_Present (Flag13) set if (<>) discriminant
4658 -- Abstract_Present (Flag4)
4659 -- Tagged_Present (Flag15)
4660 -- Limited_Present (Flag17)
4662 ----------------------------------------
4663 -- 7.4 Private Extension Declaration --
4664 ----------------------------------------
4666 -- PRIVATE_EXTENSION_DECLARATION ::=
4667 -- type DEFINING_IDENTIFIER [DISCRIMINANT_PART] is
4668 -- [abstract] [limited | synchronized]
4669 -- new ancestor_SUBTYPE_INDICATION [and INTERFACE_LIST]
4670 -- with private;
4672 -- Note: LIMITED, and private extension declarations are not allowed
4673 -- in Ada 83 mode.
4675 -- N_Private_Extension_Declaration
4676 -- Sloc points to TYPE
4677 -- Defining_Identifier (Node1)
4678 -- Discriminant_Specifications (List4) (set to No_List if no
4679 -- discriminant part)
4680 -- Unknown_Discriminants_Present (Flag13) set if (<>) discriminant
4681 -- Abstract_Present (Flag4)
4682 -- Limited_Present (Flag17)
4683 -- Synchronized_Present (Flag7)
4684 -- Subtype_Indication (Node5)
4685 -- Interface_List (List2) (set to No_List if none)
4687 ---------------------
4688 -- 8.4 Use Clause --
4689 ---------------------
4691 -- USE_CLAUSE ::= USE_PACKAGE_CLAUSE | USE_TYPE_CLAUSE
4693 -----------------------------
4694 -- 8.4 Use Package Clause --
4695 -----------------------------
4697 -- USE_PACKAGE_CLAUSE ::= use package_NAME {, package_NAME};
4699 -- N_Use_Package_Clause
4700 -- Sloc points to USE
4701 -- Names (List2)
4702 -- Next_Use_Clause (Node3-Sem)
4703 -- Hidden_By_Use_Clause (Elist4-Sem)
4705 --------------------------
4706 -- 8.4 Use Type Clause --
4707 --------------------------
4709 -- USE_TYPE_CLAUSE ::= use type SUBTYPE_MARK {, SUBTYPE_MARK};
4711 -- Note: use type clause is not permitted in Ada 83 mode
4713 -- N_Use_Type_Clause
4714 -- Sloc points to USE
4715 -- Subtype_Marks (List2)
4716 -- Next_Use_Clause (Node3-Sem)
4717 -- Hidden_By_Use_Clause (Elist4-Sem)
4719 -------------------------------
4720 -- 8.5 Renaming Declaration --
4721 -------------------------------
4723 -- RENAMING_DECLARATION ::=
4724 -- OBJECT_RENAMING_DECLARATION
4725 -- | EXCEPTION_RENAMING_DECLARATION
4726 -- | PACKAGE_RENAMING_DECLARATION
4727 -- | SUBPROGRAM_RENAMING_DECLARATION
4728 -- | GENERIC_RENAMING_DECLARATION
4730 --------------------------------------
4731 -- 8.5 Object Renaming Declaration --
4732 --------------------------------------
4734 -- OBJECT_RENAMING_DECLARATION ::=
4735 -- DEFINING_IDENTIFIER :
4736 -- [NULL_EXCLUSION] SUBTYPE_MARK renames object_NAME;
4737 -- | DEFINING_IDENTIFIER :
4738 -- ACCESS_DEFINITION renames object_NAME;
4740 -- Note: Access_Definition is an optional field that gives support to
4741 -- Ada 2005 (AI-230). The parser generates nodes that have either the
4742 -- Subtype_Indication field or else the Access_Definition field.
4744 -- N_Object_Renaming_Declaration
4745 -- Sloc points to first identifier
4746 -- Defining_Identifier (Node1)
4747 -- Null_Exclusion_Present (Flag11) (set to False if not present)
4748 -- Subtype_Mark (Node4) (set to Empty if not present)
4749 -- Access_Definition (Node3) (set to Empty if not present)
4750 -- Name (Node2)
4751 -- Corresponding_Generic_Association (Node5-Sem)
4753 -----------------------------------------
4754 -- 8.5 Exception Renaming Declaration --
4755 -----------------------------------------
4757 -- EXCEPTION_RENAMING_DECLARATION ::=
4758 -- DEFINING_IDENTIFIER : exception renames exception_NAME;
4760 -- N_Exception_Renaming_Declaration
4761 -- Sloc points to first identifier
4762 -- Defining_Identifier (Node1)
4763 -- Name (Node2)
4765 ---------------------------------------
4766 -- 8.5 Package Renaming Declaration --
4767 ---------------------------------------
4769 -- PACKAGE_RENAMING_DECLARATION ::=
4770 -- package DEFINING_PROGRAM_UNIT_NAME renames package_NAME;
4772 -- N_Package_Renaming_Declaration
4773 -- Sloc points to PACKAGE
4774 -- Defining_Unit_Name (Node1)
4775 -- Name (Node2)
4776 -- Parent_Spec (Node4-Sem)
4778 ------------------------------------------
4779 -- 8.5 Subprogram Renaming Declaration --
4780 ------------------------------------------
4782 -- SUBPROGRAM_RENAMING_DECLARATION ::=
4783 -- SUBPROGRAM_SPECIFICATION renames callable_entity_NAME;
4785 -- N_Subprogram_Renaming_Declaration
4786 -- Sloc points to RENAMES
4787 -- Specification (Node1)
4788 -- Name (Node2)
4789 -- Parent_Spec (Node4-Sem)
4790 -- Corresponding_Spec (Node5-Sem)
4791 -- Corresponding_Formal_Spec (Node3-Sem)
4792 -- From_Default (Flag6-Sem)
4794 -----------------------------------------
4795 -- 8.5.5 Generic Renaming Declaration --
4796 -----------------------------------------
4798 -- GENERIC_RENAMING_DECLARATION ::=
4799 -- generic package DEFINING_PROGRAM_UNIT_NAME
4800 -- renames generic_package_NAME
4801 -- | generic procedure DEFINING_PROGRAM_UNIT_NAME
4802 -- renames generic_procedure_NAME
4803 -- | generic function DEFINING_PROGRAM_UNIT_NAME
4804 -- renames generic_function_NAME
4806 -- N_Generic_Package_Renaming_Declaration
4807 -- Sloc points to GENERIC
4808 -- Defining_Unit_Name (Node1)
4809 -- Name (Node2)
4810 -- Parent_Spec (Node4-Sem)
4812 -- N_Generic_Procedure_Renaming_Declaration
4813 -- Sloc points to GENERIC
4814 -- Defining_Unit_Name (Node1)
4815 -- Name (Node2)
4816 -- Parent_Spec (Node4-Sem)
4818 -- N_Generic_Function_Renaming_Declaration
4819 -- Sloc points to GENERIC
4820 -- Defining_Unit_Name (Node1)
4821 -- Name (Node2)
4822 -- Parent_Spec (Node4-Sem)
4824 --------------------------------
4825 -- 9.1 Task Type Declaration --
4826 --------------------------------
4828 -- TASK_TYPE_DECLARATION ::=
4829 -- task type DEFINING_IDENTIFIER [KNOWN_DISCRIMINANT_PART]
4830 -- [is [new INTERFACE_LIST with] TASK_DEFINITION];
4832 -- N_Task_Type_Declaration
4833 -- Sloc points to TASK
4834 -- Defining_Identifier (Node1)
4835 -- Discriminant_Specifications (List4) (set to No_List if no
4836 -- discriminant part)
4837 -- Interface_List (List2) (set to No_List if none)
4838 -- Task_Definition (Node3) (set to Empty if not present)
4839 -- Corresponding_Body (Node5-Sem)
4841 ----------------------------------
4842 -- 9.1 Single Task Declaration --
4843 ----------------------------------
4845 -- SINGLE_TASK_DECLARATION ::=
4846 -- task DEFINING_IDENTIFIER
4847 -- [is [new INTERFACE_LIST with] TASK_DEFINITION];
4849 -- N_Single_Task_Declaration
4850 -- Sloc points to TASK
4851 -- Defining_Identifier (Node1)
4852 -- Interface_List (List2) (set to No_List if none)
4853 -- Task_Definition (Node3) (set to Empty if not present)
4855 --------------------------
4856 -- 9.1 Task Definition --
4857 --------------------------
4859 -- TASK_DEFINITION ::=
4860 -- {TASK_ITEM}
4861 -- [private
4862 -- {TASK_ITEM}]
4863 -- end [task_IDENTIFIER]
4865 -- Note: as a result of semantic analysis, the list of task items can
4866 -- include implicit type declarations resulting from entry families.
4868 -- N_Task_Definition
4869 -- Sloc points to first token of task definition
4870 -- Visible_Declarations (List2)
4871 -- Private_Declarations (List3) (set to No_List if no private part)
4872 -- End_Label (Node4)
4873 -- Has_Priority_Pragma (Flag6-Sem)
4874 -- Has_Storage_Size_Pragma (Flag5-Sem)
4875 -- Has_Task_Info_Pragma (Flag7-Sem)
4876 -- Has_Task_Name_Pragma (Flag8-Sem)
4877 -- Has_Relative_Deadline_Pragma (Flag9-Sem)
4879 --------------------
4880 -- 9.1 Task Item --
4881 --------------------
4883 -- TASK_ITEM ::= ENTRY_DECLARATION | REPRESENTATION_CLAUSE
4885 --------------------
4886 -- 9.1 Task Body --
4887 --------------------
4889 -- TASK_BODY ::=
4890 -- task body task_DEFINING_IDENTIFIER is
4891 -- DECLARATIVE_PART
4892 -- begin
4893 -- HANDLED_SEQUENCE_OF_STATEMENTS
4894 -- end [task_IDENTIFIER];
4896 -- Gigi restriction: This node never appears
4898 -- N_Task_Body
4899 -- Sloc points to TASK
4900 -- Defining_Identifier (Node1)
4901 -- Declarations (List2)
4902 -- Handled_Statement_Sequence (Node4)
4903 -- Is_Task_Master (Flag5-Sem)
4904 -- Activation_Chain_Entity (Node3-Sem)
4905 -- Corresponding_Spec (Node5-Sem)
4906 -- Was_Originally_Stub (Flag13-Sem)
4908 -------------------------------------
4909 -- 9.4 Protected Type Declaration --
4910 -------------------------------------
4912 -- PROTECTED_TYPE_DECLARATION ::=
4913 -- protected type DEFINING_IDENTIFIER [KNOWN_DISCRIMINANT_PART]
4914 -- is [new INTERFACE_LIST with] PROTECTED_DEFINITION;
4916 -- Note: protected type declarations are not permitted in Ada 83 mode
4918 -- N_Protected_Type_Declaration
4919 -- Sloc points to PROTECTED
4920 -- Defining_Identifier (Node1)
4921 -- Discriminant_Specifications (List4) (set to No_List if no
4922 -- discriminant part)
4923 -- Interface_List (List2) (set to No_List if none)
4924 -- Protected_Definition (Node3)
4925 -- Corresponding_Body (Node5-Sem)
4927 ---------------------------------------
4928 -- 9.4 Single Protected Declaration --
4929 ---------------------------------------
4931 -- SINGLE_PROTECTED_DECLARATION ::=
4932 -- protected DEFINING_IDENTIFIER
4933 -- is [new INTERFACE_LIST with] PROTECTED_DEFINITION;
4935 -- Note: single protected declarations are not allowed in Ada 83 mode
4937 -- N_Single_Protected_Declaration
4938 -- Sloc points to PROTECTED
4939 -- Defining_Identifier (Node1)
4940 -- Interface_List (List2) (set to No_List if none)
4941 -- Protected_Definition (Node3)
4943 -------------------------------
4944 -- 9.4 Protected Definition --
4945 -------------------------------
4947 -- PROTECTED_DEFINITION ::=
4948 -- {PROTECTED_OPERATION_DECLARATION}
4949 -- [private
4950 -- {PROTECTED_ELEMENT_DECLARATION}]
4951 -- end [protected_IDENTIFIER]
4953 -- N_Protected_Definition
4954 -- Sloc points to first token of protected definition
4955 -- Visible_Declarations (List2)
4956 -- Private_Declarations (List3) (set to No_List if no private part)
4957 -- End_Label (Node4)
4958 -- Has_Priority_Pragma (Flag6-Sem)
4960 ------------------------------------------
4961 -- 9.4 Protected Operation Declaration --
4962 ------------------------------------------
4964 -- PROTECTED_OPERATION_DECLARATION ::=
4965 -- SUBPROGRAM_DECLARATION
4966 -- | ENTRY_DECLARATION
4967 -- | REPRESENTATION_CLAUSE
4969 ----------------------------------------
4970 -- 9.4 Protected Element Declaration --
4971 ----------------------------------------
4973 -- PROTECTED_ELEMENT_DECLARATION ::=
4974 -- PROTECTED_OPERATION_DECLARATION | COMPONENT_DECLARATION
4976 -------------------------
4977 -- 9.4 Protected Body --
4978 -------------------------
4980 -- PROTECTED_BODY ::=
4981 -- protected body DEFINING_IDENTIFIER is
4982 -- {PROTECTED_OPERATION_ITEM}
4983 -- end [protected_IDENTIFIER];
4985 -- Note: protected bodies are not allowed in Ada 83 mode
4987 -- Gigi restriction: This node never appears
4989 -- N_Protected_Body
4990 -- Sloc points to PROTECTED
4991 -- Defining_Identifier (Node1)
4992 -- Declarations (List2) protected operation items (and pragmas)
4993 -- End_Label (Node4)
4994 -- Corresponding_Spec (Node5-Sem)
4995 -- Was_Originally_Stub (Flag13-Sem)
4997 -----------------------------------
4998 -- 9.4 Protected Operation Item --
4999 -----------------------------------
5001 -- PROTECTED_OPERATION_ITEM ::=
5002 -- SUBPROGRAM_DECLARATION
5003 -- | SUBPROGRAM_BODY
5004 -- | ENTRY_BODY
5005 -- | REPRESENTATION_CLAUSE
5007 ------------------------------
5008 -- 9.5.2 Entry Declaration --
5009 ------------------------------
5011 -- ENTRY_DECLARATION ::=
5012 -- [[not] overriding]
5013 -- entry DEFINING_IDENTIFIER
5014 -- [(DISCRETE_SUBTYPE_DEFINITION)] PARAMETER_PROFILE;
5016 -- N_Entry_Declaration
5017 -- Sloc points to ENTRY
5018 -- Defining_Identifier (Node1)
5019 -- Discrete_Subtype_Definition (Node4) (set to Empty if not present)
5020 -- Parameter_Specifications (List3) (set to No_List if no formal part)
5021 -- Corresponding_Body (Node5-Sem)
5022 -- Must_Override (Flag14) set if overriding indicator present
5023 -- Must_Not_Override (Flag15) set if not_overriding indicator present
5025 -- Note: overriding indicator is an Ada 2005 feature
5027 -----------------------------
5028 -- 9.5.2 Accept statement --
5029 -----------------------------
5031 -- ACCEPT_STATEMENT ::=
5032 -- accept entry_DIRECT_NAME
5033 -- [(ENTRY_INDEX)] PARAMETER_PROFILE [do
5034 -- HANDLED_SEQUENCE_OF_STATEMENTS
5035 -- end [entry_IDENTIFIER]];
5037 -- Gigi restriction: This node never appears
5039 -- Note: there are no explicit declarations allowed in an accept
5040 -- statement. However, the implicit declarations for any statement
5041 -- identifiers (labels and block/loop identifiers) are declarations
5042 -- that belong logically to the accept statement, and that is why
5043 -- there is a Declarations field in this node.
5045 -- N_Accept_Statement
5046 -- Sloc points to ACCEPT
5047 -- Entry_Direct_Name (Node1)
5048 -- Entry_Index (Node5) (set to Empty if not present)
5049 -- Parameter_Specifications (List3) (set to No_List if no formal part)
5050 -- Handled_Statement_Sequence (Node4)
5051 -- Declarations (List2) (set to No_List if no declarations)
5053 ------------------------
5054 -- 9.5.2 Entry Index --
5055 ------------------------
5057 -- ENTRY_INDEX ::= EXPRESSION
5059 -----------------------
5060 -- 9.5.2 Entry Body --
5061 -----------------------
5063 -- ENTRY_BODY ::=
5064 -- entry DEFINING_IDENTIFIER ENTRY_BODY_FORMAL_PART ENTRY_BARRIER is
5065 -- DECLARATIVE_PART
5066 -- begin
5067 -- HANDLED_SEQUENCE_OF_STATEMENTS
5068 -- end [entry_IDENTIFIER];
5070 -- ENTRY_BARRIER ::= when CONDITION
5072 -- Note: we store the CONDITION of the ENTRY_BARRIER in the node for
5073 -- the ENTRY_BODY_FORMAL_PART to avoid the N_Entry_Body node getting
5074 -- too full (it would otherwise have too many fields)
5076 -- Gigi restriction: This node never appears
5078 -- N_Entry_Body
5079 -- Sloc points to ENTRY
5080 -- Defining_Identifier (Node1)
5081 -- Entry_Body_Formal_Part (Node5)
5082 -- Declarations (List2)
5083 -- Handled_Statement_Sequence (Node4)
5084 -- Activation_Chain_Entity (Node3-Sem)
5086 -----------------------------------
5087 -- 9.5.2 Entry Body Formal Part --
5088 -----------------------------------
5090 -- ENTRY_BODY_FORMAL_PART ::=
5091 -- [(ENTRY_INDEX_SPECIFICATION)] PARAMETER_PROFILE
5093 -- Note that an entry body formal part node is present even if it is
5094 -- empty. This reflects the grammar, in which it is the components of
5095 -- the entry body formal part that are optional, not the entry body
5096 -- formal part itself. Also this means that the barrier condition
5097 -- always has somewhere to be stored.
5099 -- Gigi restriction: This node never appears
5101 -- N_Entry_Body_Formal_Part
5102 -- Sloc points to first token
5103 -- Entry_Index_Specification (Node4) (set to Empty if not present)
5104 -- Parameter_Specifications (List3) (set to No_List if no formal part)
5105 -- Condition (Node1) from entry barrier of entry body
5107 --------------------------
5108 -- 9.5.2 Entry Barrier --
5109 --------------------------
5111 -- ENTRY_BARRIER ::= when CONDITION
5113 --------------------------------------
5114 -- 9.5.2 Entry Index Specification --
5115 --------------------------------------
5117 -- ENTRY_INDEX_SPECIFICATION ::=
5118 -- for DEFINING_IDENTIFIER in DISCRETE_SUBTYPE_DEFINITION
5120 -- Gigi restriction: This node never appears
5122 -- N_Entry_Index_Specification
5123 -- Sloc points to FOR
5124 -- Defining_Identifier (Node1)
5125 -- Discrete_Subtype_Definition (Node4)
5127 ---------------------------------
5128 -- 9.5.3 Entry Call Statement --
5129 ---------------------------------
5131 -- ENTRY_CALL_STATEMENT ::= entry_NAME [ACTUAL_PARAMETER_PART];
5133 -- The parser may generate a procedure call for this construct. The
5134 -- semantic pass must correct this misidentification where needed.
5136 -- Gigi restriction: This node never appears
5138 -- N_Entry_Call_Statement
5139 -- Sloc points to first token of name
5140 -- Name (Node2)
5141 -- Parameter_Associations (List3) (set to No_List if no
5142 -- actual parameter part)
5143 -- First_Named_Actual (Node4-Sem)
5145 ------------------------------
5146 -- 9.5.4 Requeue Statement --
5147 ------------------------------
5149 -- REQUEUE_STATEMENT ::= requeue entry_NAME [with abort];
5151 -- Note: requeue statements are not permitted in Ada 83 mode
5153 -- Gigi restriction: This node never appears
5155 -- N_Requeue_Statement
5156 -- Sloc points to REQUEUE
5157 -- Name (Node2)
5158 -- Abort_Present (Flag15)
5160 --------------------------
5161 -- 9.6 Delay Statement --
5162 --------------------------
5164 -- DELAY_STATEMENT ::=
5165 -- DELAY_UNTIL_STATEMENT
5166 -- | DELAY_RELATIVE_STATEMENT
5168 --------------------------------
5169 -- 9.6 Delay Until Statement --
5170 --------------------------------
5172 -- DELAY_UNTIL_STATEMENT ::= delay until delay_EXPRESSION;
5174 -- Note: delay until statements are not permitted in Ada 83 mode
5176 -- Gigi restriction: This node never appears
5178 -- N_Delay_Until_Statement
5179 -- Sloc points to DELAY
5180 -- Expression (Node3)
5182 -----------------------------------
5183 -- 9.6 Delay Relative Statement --
5184 -----------------------------------
5186 -- DELAY_RELATIVE_STATEMENT ::= delay delay_EXPRESSION;
5188 -- Gigi restriction: This node never appears
5190 -- N_Delay_Relative_Statement
5191 -- Sloc points to DELAY
5192 -- Expression (Node3)
5194 ---------------------------
5195 -- 9.7 Select Statement --
5196 ---------------------------
5198 -- SELECT_STATEMENT ::=
5199 -- SELECTIVE_ACCEPT
5200 -- | TIMED_ENTRY_CALL
5201 -- | CONDITIONAL_ENTRY_CALL
5202 -- | ASYNCHRONOUS_SELECT
5204 -----------------------------
5205 -- 9.7.1 Selective Accept --
5206 -----------------------------
5208 -- SELECTIVE_ACCEPT ::=
5209 -- select
5210 -- [GUARD]
5211 -- SELECT_ALTERNATIVE
5212 -- {or
5213 -- [GUARD]
5214 -- SELECT_ALTERNATIVE}
5215 -- [else
5216 -- SEQUENCE_OF_STATEMENTS]
5217 -- end select;
5219 -- Gigi restriction: This node never appears
5221 -- Note: the guard expression, if present, appears in the node for
5222 -- the select alternative.
5224 -- N_Selective_Accept
5225 -- Sloc points to SELECT
5226 -- Select_Alternatives (List1)
5227 -- Else_Statements (List4) (set to No_List if no else part)
5229 ------------------
5230 -- 9.7.1 Guard --
5231 ------------------
5233 -- GUARD ::= when CONDITION =>
5235 -- As noted above, the CONDITION that is part of a GUARD is included
5236 -- in the node for the select alternative for convenience.
5238 -------------------------------
5239 -- 9.7.1 Select Alternative --
5240 -------------------------------
5242 -- SELECT_ALTERNATIVE ::=
5243 -- ACCEPT_ALTERNATIVE
5244 -- | DELAY_ALTERNATIVE
5245 -- | TERMINATE_ALTERNATIVE
5247 -------------------------------
5248 -- 9.7.1 Accept Alternative --
5249 -------------------------------
5251 -- ACCEPT_ALTERNATIVE ::=
5252 -- ACCEPT_STATEMENT [SEQUENCE_OF_STATEMENTS]
5254 -- Gigi restriction: This node never appears
5256 -- N_Accept_Alternative
5257 -- Sloc points to ACCEPT
5258 -- Accept_Statement (Node2)
5259 -- Condition (Node1) from the guard (set to Empty if no guard present)
5260 -- Statements (List3) (set to Empty_List if no statements)
5261 -- Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5262 -- Accept_Handler_Records (List5-Sem)
5264 ------------------------------
5265 -- 9.7.1 Delay Alternative --
5266 ------------------------------
5268 -- DELAY_ALTERNATIVE ::=
5269 -- DELAY_STATEMENT [SEQUENCE_OF_STATEMENTS]
5271 -- Gigi restriction: This node never appears
5273 -- N_Delay_Alternative
5274 -- Sloc points to DELAY
5275 -- Delay_Statement (Node2)
5276 -- Condition (Node1) from the guard (set to Empty if no guard present)
5277 -- Statements (List3) (set to Empty_List if no statements)
5278 -- Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5280 ----------------------------------
5281 -- 9.7.1 Terminate Alternative --
5282 ----------------------------------
5284 -- TERMINATE_ALTERNATIVE ::= terminate;
5286 -- Gigi restriction: This node never appears
5288 -- N_Terminate_Alternative
5289 -- Sloc points to TERMINATE
5290 -- Condition (Node1) from the guard (set to Empty if no guard present)
5291 -- Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5292 -- Pragmas_After (List5) pragmas after alt (set to No_List if none)
5294 -----------------------------
5295 -- 9.7.2 Timed Entry Call --
5296 -----------------------------
5298 -- TIMED_ENTRY_CALL ::=
5299 -- select
5300 -- ENTRY_CALL_ALTERNATIVE
5301 -- or
5302 -- DELAY_ALTERNATIVE
5303 -- end select;
5305 -- Gigi restriction: This node never appears
5307 -- N_Timed_Entry_Call
5308 -- Sloc points to SELECT
5309 -- Entry_Call_Alternative (Node1)
5310 -- Delay_Alternative (Node4)
5312 -----------------------------------
5313 -- 9.7.2 Entry Call Alternative --
5314 -----------------------------------
5316 -- ENTRY_CALL_ALTERNATIVE ::=
5317 -- PROCEDURE_OR_ENTRY_CALL [SEQUENCE_OF_STATEMENTS]
5319 -- PROCEDURE_OR_ENTRY_CALL ::=
5320 -- PROCEDURE_CALL_STATEMENT | ENTRY_CALL_STATEMENT
5322 -- Gigi restriction: This node never appears
5324 -- N_Entry_Call_Alternative
5325 -- Sloc points to first token of entry call statement
5326 -- Entry_Call_Statement (Node1)
5327 -- Statements (List3) (set to Empty_List if no statements)
5328 -- Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5330 -----------------------------------
5331 -- 9.7.3 Conditional Entry Call --
5332 -----------------------------------
5334 -- CONDITIONAL_ENTRY_CALL ::=
5335 -- select
5336 -- ENTRY_CALL_ALTERNATIVE
5337 -- else
5338 -- SEQUENCE_OF_STATEMENTS
5339 -- end select;
5341 -- Gigi restriction: This node never appears
5343 -- N_Conditional_Entry_Call
5344 -- Sloc points to SELECT
5345 -- Entry_Call_Alternative (Node1)
5346 -- Else_Statements (List4)
5348 --------------------------------
5349 -- 9.7.4 Asynchronous Select --
5350 --------------------------------
5352 -- ASYNCHRONOUS_SELECT ::=
5353 -- select
5354 -- TRIGGERING_ALTERNATIVE
5355 -- then abort
5356 -- ABORTABLE_PART
5357 -- end select;
5359 -- Note: asynchronous select is not permitted in Ada 83 mode
5361 -- Gigi restriction: This node never appears
5363 -- N_Asynchronous_Select
5364 -- Sloc points to SELECT
5365 -- Triggering_Alternative (Node1)
5366 -- Abortable_Part (Node2)
5368 -----------------------------------
5369 -- 9.7.4 Triggering Alternative --
5370 -----------------------------------
5372 -- TRIGGERING_ALTERNATIVE ::=
5373 -- TRIGGERING_STATEMENT [SEQUENCE_OF_STATEMENTS]
5375 -- Gigi restriction: This node never appears
5377 -- N_Triggering_Alternative
5378 -- Sloc points to first token of triggering statement
5379 -- Triggering_Statement (Node1)
5380 -- Statements (List3) (set to Empty_List if no statements)
5381 -- Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5383 ---------------------------------
5384 -- 9.7.4 Triggering Statement --
5385 ---------------------------------
5387 -- TRIGGERING_STATEMENT ::= PROCEDURE_OR_ENTRY_CALL | DELAY_STATEMENT
5389 ---------------------------
5390 -- 9.7.4 Abortable Part --
5391 ---------------------------
5393 -- ABORTABLE_PART ::= SEQUENCE_OF_STATEMENTS
5395 -- Gigi restriction: This node never appears
5397 -- N_Abortable_Part
5398 -- Sloc points to ABORT
5399 -- Statements (List3)
5401 --------------------------
5402 -- 9.8 Abort Statement --
5403 --------------------------
5405 -- ABORT_STATEMENT ::= abort task_NAME {, task_NAME};
5407 -- Gigi restriction: This node never appears
5409 -- N_Abort_Statement
5410 -- Sloc points to ABORT
5411 -- Names (List2)
5413 -------------------------
5414 -- 10.1.1 Compilation --
5415 -------------------------
5417 -- COMPILATION ::= {COMPILATION_UNIT}
5419 -- There is no explicit node in the tree for a compilation, since in
5420 -- general the compiler is processing only a single compilation unit
5421 -- at a time. It is possible to parse multiple units in syntax check
5422 -- only mode, but the trees are discarded in that case.
5424 ------------------------------
5425 -- 10.1.1 Compilation Unit --
5426 ------------------------------
5428 -- COMPILATION_UNIT ::=
5429 -- CONTEXT_CLAUSE LIBRARY_ITEM
5430 -- | CONTEXT_CLAUSE SUBUNIT
5432 -- The N_Compilation_Unit node itself represents the above syntax.
5433 -- However, there are two additional items not reflected in the above
5434 -- syntax. First we have the global declarations that are added by the
5435 -- code generator. These are outer level declarations (so they cannot
5436 -- be represented as being inside the units). An example is the wrapper
5437 -- subprograms that are created to do ABE checking. As always a list of
5438 -- declarations can contain actions as well (i.e. statements), and such
5439 -- statements are executed as part of the elaboration of the unit. Note
5440 -- that all such declarations are elaborated before the library unit.
5442 -- Similarly, certain actions need to be elaborated at the completion
5443 -- of elaboration of the library unit (notably the statement that sets
5444 -- the Boolean flag indicating that elaboration is complete).
5446 -- The third item not reflected in the syntax is pragmas that appear
5447 -- after the compilation unit. As always pragmas are a problem since
5448 -- they are not part of the formal syntax, but can be stuck into the
5449 -- source following a set of ad hoc rules, and we have to find an ad
5450 -- hoc way of sticking them into the tree. For pragmas that appear
5451 -- before the library unit, we just consider them to be part of the
5452 -- context clause, and pragmas can appear in the Context_Items list
5453 -- of the compilation unit. However, pragmas can also appear after
5454 -- the library item.
5456 -- To deal with all these problems, we create an auxiliary node for
5457 -- a compilation unit, referenced from the N_Compilation_Unit node
5458 -- that contains these three items.
5460 -- N_Compilation_Unit
5461 -- Sloc points to first token of defining unit name
5462 -- Library_Unit (Node4-Sem) corresponding/parent spec/body
5463 -- Context_Items (List1) context items and pragmas preceding unit
5464 -- Private_Present (Flag15) set if library unit has private keyword
5465 -- Unit (Node2) library item or subunit
5466 -- Aux_Decls_Node (Node5) points to the N_Compilation_Unit_Aux node
5467 -- Has_No_Elaboration_Code (Flag17-Sem)
5468 -- Body_Required (Flag13-Sem) set for spec if body is required
5469 -- Acts_As_Spec (Flag4-Sem) flag for subprogram body with no spec
5470 -- Context_Pending (Flag16-Sem)
5471 -- First_Inlined_Subprogram (Node3-Sem)
5473 -- N_Compilation_Unit_Aux
5474 -- Sloc is a copy of the Sloc from the N_Compilation_Unit node
5475 -- Declarations (List2) (set to No_List if no global declarations)
5476 -- Actions (List1) (set to No_List if no actions)
5477 -- Pragmas_After (List5) pragmas after unit (set to No_List if none)
5478 -- Config_Pragmas (List4) config pragmas (set to Empty_List if none)
5480 --------------------------
5481 -- 10.1.1 Library Item --
5482 --------------------------
5484 -- LIBRARY_ITEM ::=
5485 -- [private] LIBRARY_UNIT_DECLARATION
5486 -- | LIBRARY_UNIT_BODY
5487 -- | [private] LIBRARY_UNIT_RENAMING_DECLARATION
5489 -- Note: PRIVATE is not allowed in Ada 83 mode
5491 -- There is no explicit node in the tree for library item, instead
5492 -- the declaration or body, and the flag for private if present,
5493 -- appear in the N_Compilation_Unit node.
5495 --------------------------------------
5496 -- 10.1.1 Library Unit Declaration --
5497 --------------------------------------
5499 -- LIBRARY_UNIT_DECLARATION ::=
5500 -- SUBPROGRAM_DECLARATION | PACKAGE_DECLARATION
5501 -- | GENERIC_DECLARATION | GENERIC_INSTANTIATION
5503 -----------------------------------------------
5504 -- 10.1.1 Library Unit Renaming Declaration --
5505 -----------------------------------------------
5507 -- LIBRARY_UNIT_RENAMING_DECLARATION ::=
5508 -- PACKAGE_RENAMING_DECLARATION
5509 -- | GENERIC_RENAMING_DECLARATION
5510 -- | SUBPROGRAM_RENAMING_DECLARATION
5512 -------------------------------
5513 -- 10.1.1 Library unit body --
5514 -------------------------------
5516 -- LIBRARY_UNIT_BODY ::= SUBPROGRAM_BODY | PACKAGE_BODY
5518 ------------------------------
5519 -- 10.1.1 Parent Unit Name --
5520 ------------------------------
5522 -- PARENT_UNIT_NAME ::= NAME
5524 ----------------------------
5525 -- 10.1.2 Context clause --
5526 ----------------------------
5528 -- CONTEXT_CLAUSE ::= {CONTEXT_ITEM}
5530 -- The context clause can include pragmas, and any pragmas that appear
5531 -- before the context clause proper (i.e. all configuration pragmas,
5532 -- also appear at the front of this list).
5534 --------------------------
5535 -- 10.1.2 Context_Item --
5536 --------------------------
5538 -- CONTEXT_ITEM ::= WITH_CLAUSE | USE_CLAUSE | WITH_TYPE_CLAUSE
5540 -------------------------
5541 -- 10.1.2 With clause --
5542 -------------------------
5544 -- WITH_CLAUSE ::=
5545 -- with library_unit_NAME {,library_unit_NAME};
5547 -- A separate With clause is built for each name, so that we have
5548 -- a Corresponding_Spec field for each with'ed spec. The flags
5549 -- First_Name and Last_Name are used to reconstruct the exact
5550 -- source form. When a list of names appears in one with clause,
5551 -- the first name in the list has First_Name set, and the last
5552 -- has Last_Name set. If the with clause has only one name, then
5553 -- both of the flags First_Name and Last_Name are set in this name.
5555 -- Note: in the case of implicit with's that are installed by the
5556 -- Rtsfind routine, Implicit_With is set, and the Sloc is typically
5557 -- set to Standard_Location, but it is incorrect to test the Sloc
5558 -- to find out if a with clause is implicit, test the flag instead.
5560 -- N_With_Clause
5561 -- Sloc points to first token of library unit name
5562 -- Withed_Body (Node1-Sem)
5563 -- Name (Node2)
5564 -- Next_Implicit_With (Node3-Sem)
5565 -- Library_Unit (Node4-Sem)
5566 -- Corresponding_Spec (Node5-Sem)
5567 -- First_Name (Flag5) (set to True if first name or only one name)
5568 -- Last_Name (Flag6) (set to True if last name or only one name)
5569 -- Context_Installed (Flag13-Sem)
5570 -- Elaborate_Present (Flag4-Sem)
5571 -- Elaborate_All_Present (Flag14-Sem)
5572 -- Elaborate_All_Desirable (Flag9-Sem)
5573 -- Elaborate_Desirable (Flag11-Sem)
5574 -- Private_Present (Flag15) set if with_clause has private keyword
5575 -- Implicit_With (Flag16-Sem)
5576 -- Limited_Present (Flag17) set if LIMITED is present
5577 -- Limited_View_Installed (Flag18-Sem)
5578 -- Unreferenced_In_Spec (Flag7-Sem)
5579 -- No_Entities_Ref_In_Spec (Flag8-Sem)
5581 -- Note: Limited_Present and Limited_View_Installed give support to
5582 -- Ada 2005 (AI-50217).
5583 -- Similarly, Private_Present gives support to AI-50262.
5585 ----------------------
5586 -- With_Type clause --
5587 ----------------------
5589 -- This is a GNAT extension, used to implement mutually recursive
5590 -- types declared in different packages.
5591 -- Note: this is now obsolete. The functionality of this construct
5592 -- is now implemented by the Ada 2005 Limited_with_Clause.
5594 ---------------------
5595 -- 10.2 Body stub --
5596 ---------------------
5598 -- BODY_STUB ::=
5599 -- SUBPROGRAM_BODY_STUB
5600 -- | PACKAGE_BODY_STUB
5601 -- | TASK_BODY_STUB
5602 -- | PROTECTED_BODY_STUB
5604 ----------------------------------
5605 -- 10.1.3 Subprogram Body Stub --
5606 ----------------------------------
5608 -- SUBPROGRAM_BODY_STUB ::=
5609 -- SUBPROGRAM_SPECIFICATION is separate;
5611 -- N_Subprogram_Body_Stub
5612 -- Sloc points to FUNCTION or PROCEDURE
5613 -- Specification (Node1)
5614 -- Library_Unit (Node4-Sem) points to the subunit
5615 -- Corresponding_Body (Node5-Sem)
5617 -------------------------------
5618 -- 10.1.3 Package Body Stub --
5619 -------------------------------
5621 -- PACKAGE_BODY_STUB ::=
5622 -- package body DEFINING_IDENTIFIER is separate;
5624 -- N_Package_Body_Stub
5625 -- Sloc points to PACKAGE
5626 -- Defining_Identifier (Node1)
5627 -- Library_Unit (Node4-Sem) points to the subunit
5628 -- Corresponding_Body (Node5-Sem)
5630 ----------------------------
5631 -- 10.1.3 Task Body Stub --
5632 ----------------------------
5634 -- TASK_BODY_STUB ::=
5635 -- task body DEFINING_IDENTIFIER is separate;
5637 -- N_Task_Body_Stub
5638 -- Sloc points to TASK
5639 -- Defining_Identifier (Node1)
5640 -- Library_Unit (Node4-Sem) points to the subunit
5641 -- Corresponding_Body (Node5-Sem)
5643 ---------------------------------
5644 -- 10.1.3 Protected Body Stub --
5645 ---------------------------------
5647 -- PROTECTED_BODY_STUB ::=
5648 -- protected body DEFINING_IDENTIFIER is separate;
5650 -- Note: protected body stubs are not allowed in Ada 83 mode
5652 -- N_Protected_Body_Stub
5653 -- Sloc points to PROTECTED
5654 -- Defining_Identifier (Node1)
5655 -- Library_Unit (Node4-Sem) points to the subunit
5656 -- Corresponding_Body (Node5-Sem)
5658 ---------------------
5659 -- 10.1.3 Subunit --
5660 ---------------------
5662 -- SUBUNIT ::= separate (PARENT_UNIT_NAME) PROPER_BODY
5664 -- N_Subunit
5665 -- Sloc points to SEPARATE
5666 -- Name (Node2) is the name of the parent unit
5667 -- Proper_Body (Node1) is the subunit body
5668 -- Corresponding_Stub (Node3-Sem) is the stub declaration for the unit.
5670 ---------------------------------
5671 -- 11.1 Exception Declaration --
5672 ---------------------------------
5674 -- EXCEPTION_DECLARATION ::= DEFINING_IDENTIFIER_LIST : exception;
5676 -- For consistency with object declarations etc., the parser converts
5677 -- the case of multiple identifiers being declared to a series of
5678 -- declarations in which the expression is copied, using the More_Ids
5679 -- and Prev_Ids flags to remember the source form as described in the
5680 -- section on "Handling of Defining Identifier Lists".
5682 -- N_Exception_Declaration
5683 -- Sloc points to EXCEPTION
5684 -- Defining_Identifier (Node1)
5685 -- Expression (Node3-Sem)
5686 -- Renaming_Exception (Node2-Sem)
5687 -- More_Ids (Flag5) (set to False if no more identifiers in list)
5688 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
5690 ------------------------------------------
5691 -- 11.2 Handled Sequence Of Statements --
5692 ------------------------------------------
5694 -- HANDLED_SEQUENCE_OF_STATEMENTS ::=
5695 -- SEQUENCE_OF_STATEMENTS
5696 -- [exception
5697 -- EXCEPTION_HANDLER
5698 -- {EXCEPTION_HANDLER}]
5699 -- [at end
5700 -- cleanup_procedure_call (param, param, param, ...);]
5702 -- The AT END phrase is a GNAT extension to provide for cleanups. It is
5703 -- used only internally currently, but is considered to be syntactic.
5704 -- At the moment, the only cleanup action allowed is a single call to
5705 -- a parameterless procedure, and the Identifier field of the node is
5706 -- the procedure to be called. Also there is a current restriction
5707 -- that exception handles and a cleanup cannot be present in the same
5708 -- frame, so at least one of Exception_Handlers or the Identifier must
5709 -- be missing.
5711 -- Actually, more accurately, this restriction applies to the original
5712 -- source program. In the expanded tree, if the At_End_Proc field is
5713 -- present, then there will also be an exception handler of the form:
5715 -- when all others =>
5716 -- cleanup;
5717 -- raise;
5719 -- where cleanup is the procedure to be generated. The reason we do
5720 -- this is so that the front end can handle the necessary entries in
5721 -- the exception tables, and other exception handler actions required
5722 -- as part of the normal handling for exception handlers.
5724 -- The AT END cleanup handler protects only the sequence of statements
5725 -- (not the associated declarations of the parent), just like exception
5726 -- handlers. The big difference is that the cleanup procedure is called
5727 -- on either a normal or an abnormal exit from the statement sequence.
5729 -- Note: the list of Exception_Handlers can contain pragmas as well
5730 -- as actual handlers. In practice these pragmas can only occur at
5731 -- the start of the list, since any pragmas occurring later on will
5732 -- be included in the statement list of the corresponding handler.
5734 -- Note: although in the Ada syntax, the sequence of statements in
5735 -- a handled sequence of statements can only contain statements, we
5736 -- allow free mixing of declarations and statements in the resulting
5737 -- expanded tree. This is for example used to deal with the case of
5738 -- a cleanup procedure that must handle declarations as well as the
5739 -- statements of a block.
5741 -- N_Handled_Sequence_Of_Statements
5742 -- Sloc points to first token of first statement
5743 -- Statements (List3)
5744 -- End_Label (Node4) (set to Empty if expander generated)
5745 -- Exception_Handlers (List5) (set to No_List if none present)
5746 -- At_End_Proc (Node1) (set to Empty if no clean up procedure)
5747 -- First_Real_Statement (Node2-Sem)
5748 -- Zero_Cost_Handling (Flag5-Sem)
5750 -- Note: the parent always contains a Declarations field which contains
5751 -- declarations associated with the handled sequence of statements. This
5752 -- is true even in the case of an accept statement (see description of
5753 -- the N_Accept_Statement node).
5755 -- End_Label refers to the containing construct
5757 -----------------------------
5758 -- 11.2 Exception Handler --
5759 -----------------------------
5761 -- EXCEPTION_HANDLER ::=
5762 -- when [CHOICE_PARAMETER_SPECIFICATION :]
5763 -- EXCEPTION_CHOICE {| EXCEPTION_CHOICE} =>
5764 -- SEQUENCE_OF_STATEMENTS
5766 -- Note: choice parameter specification is not allowed in Ada 83 mode
5768 -- N_Exception_Handler
5769 -- Sloc points to WHEN
5770 -- Choice_Parameter (Node2) (set to Empty if not present)
5771 -- Exception_Choices (List4)
5772 -- Statements (List3)
5773 -- Exception_Label (Node5-Sem) (set to Empty of not present)
5774 -- Zero_Cost_Handling (Flag5-Sem)
5775 -- Local_Raise_Statements (Elist1-Sem) (set to No_Elist if not present)
5776 -- Local_Raise_Not_OK (Flag7-Sem)
5777 -- Has_Local_Raise (Flag8-Sem)
5779 ------------------------------------------
5780 -- 11.2 Choice parameter specification --
5781 ------------------------------------------
5783 -- CHOICE_PARAMETER_SPECIFICATION ::= DEFINING_IDENTIFIER
5785 ----------------------------
5786 -- 11.2 Exception Choice --
5787 ----------------------------
5789 -- EXCEPTION_CHOICE ::= exception_NAME | others
5791 -- Except in the case of OTHERS, no explicit node appears in the tree
5792 -- for exception choice. Instead the exception name appears directly.
5793 -- An OTHERS choice is represented by a N_Others_Choice node (see
5794 -- section 3.8.1.
5796 -- Note: for the exception choice created for an at end handler, the
5797 -- exception choice is an N_Others_Choice node with All_Others set.
5799 ---------------------------
5800 -- 11.3 Raise Statement --
5801 ---------------------------
5803 -- RAISE_STATEMENT ::= raise [exception_NAME];
5805 -- In Ada 2005, we have
5807 -- RAISE_STATEMENT ::= raise; | raise exception_NAME [with EXPRESSION];
5809 -- N_Raise_Statement
5810 -- Sloc points to RAISE
5811 -- Name (Node2) (set to Empty if no exception name present)
5812 -- Expression (Node3) (set to Empty if no expression present)
5813 -- From_At_End (Flag4-Sem)
5815 -------------------------------
5816 -- 12.1 Generic Declaration --
5817 -------------------------------
5819 -- GENERIC_DECLARATION ::=
5820 -- GENERIC_SUBPROGRAM_DECLARATION | GENERIC_PACKAGE_DECLARATION
5822 ------------------------------------------
5823 -- 12.1 Generic Subprogram Declaration --
5824 ------------------------------------------
5826 -- GENERIC_SUBPROGRAM_DECLARATION ::=
5827 -- GENERIC_FORMAL_PART SUBPROGRAM_SPECIFICATION;
5829 -- Note: Generic_Formal_Declarations can include pragmas
5831 -- N_Generic_Subprogram_Declaration
5832 -- Sloc points to GENERIC
5833 -- Specification (Node1) subprogram specification
5834 -- Corresponding_Body (Node5-Sem)
5835 -- Generic_Formal_Declarations (List2) from generic formal part
5836 -- Parent_Spec (Node4-Sem)
5838 ---------------------------------------
5839 -- 12.1 Generic Package Declaration --
5840 ---------------------------------------
5842 -- GENERIC_PACKAGE_DECLARATION ::=
5843 -- GENERIC_FORMAL_PART PACKAGE_SPECIFICATION;
5845 -- Note: when we do generics right, the Activation_Chain_Entity entry
5846 -- for this node can be removed (since the expander won't see generic
5847 -- units any more)???.
5849 -- Note: Generic_Formal_Declarations can include pragmas
5851 -- N_Generic_Package_Declaration
5852 -- Sloc points to GENERIC
5853 -- Specification (Node1) package specification
5854 -- Corresponding_Body (Node5-Sem)
5855 -- Generic_Formal_Declarations (List2) from generic formal part
5856 -- Parent_Spec (Node4-Sem)
5857 -- Activation_Chain_Entity (Node3-Sem)
5859 -------------------------------
5860 -- 12.1 Generic Formal Part --
5861 -------------------------------
5863 -- GENERIC_FORMAL_PART ::=
5864 -- generic {GENERIC_FORMAL_PARAMETER_DECLARATION | USE_CLAUSE}
5866 ------------------------------------------------
5867 -- 12.1 Generic Formal Parameter Declaration --
5868 ------------------------------------------------
5870 -- GENERIC_FORMAL_PARAMETER_DECLARATION ::=
5871 -- FORMAL_OBJECT_DECLARATION
5872 -- | FORMAL_TYPE_DECLARATION
5873 -- | FORMAL_SUBPROGRAM_DECLARATION
5874 -- | FORMAL_PACKAGE_DECLARATION
5876 ---------------------------------
5877 -- 12.3 Generic Instantiation --
5878 ---------------------------------
5880 -- GENERIC_INSTANTIATION ::=
5881 -- package DEFINING_PROGRAM_UNIT_NAME is
5882 -- new generic_package_NAME [GENERIC_ACTUAL_PART];
5883 -- | [[not] overriding]
5884 -- procedure DEFINING_PROGRAM_UNIT_NAME is
5885 -- new generic_procedure_NAME [GENERIC_ACTUAL_PART];
5886 -- | [[not] overriding]
5887 -- function DEFINING_DESIGNATOR is
5888 -- new generic_function_NAME [GENERIC_ACTUAL_PART];
5890 -- N_Package_Instantiation
5891 -- Sloc points to PACKAGE
5892 -- Defining_Unit_Name (Node1)
5893 -- Name (Node2)
5894 -- Generic_Associations (List3) (set to No_List if no
5895 -- generic actual part)
5896 -- Parent_Spec (Node4-Sem)
5897 -- Instance_Spec (Node5-Sem)
5898 -- ABE_Is_Certain (Flag18-Sem)
5900 -- N_Procedure_Instantiation
5901 -- Sloc points to PROCEDURE
5902 -- Defining_Unit_Name (Node1)
5903 -- Name (Node2)
5904 -- Parent_Spec (Node4-Sem)
5905 -- Generic_Associations (List3) (set to No_List if no
5906 -- generic actual part)
5907 -- Instance_Spec (Node5-Sem)
5908 -- Must_Override (Flag14) set if overriding indicator present
5909 -- Must_Not_Override (Flag15) set if not_overriding indicator present
5910 -- ABE_Is_Certain (Flag18-Sem)
5912 -- N_Function_Instantiation
5913 -- Sloc points to FUNCTION
5914 -- Defining_Unit_Name (Node1)
5915 -- Name (Node2)
5916 -- Generic_Associations (List3) (set to No_List if no
5917 -- generic actual part)
5918 -- Parent_Spec (Node4-Sem)
5919 -- Instance_Spec (Node5-Sem)
5920 -- Must_Override (Flag14) set if overriding indicator present
5921 -- Must_Not_Override (Flag15) set if not_overriding indicator present
5922 -- ABE_Is_Certain (Flag18-Sem)
5924 -- Note: overriding indicator is an Ada 2005 feature
5926 -------------------------------
5927 -- 12.3 Generic Actual Part --
5928 -------------------------------
5930 -- GENERIC_ACTUAL_PART ::=
5931 -- (GENERIC_ASSOCIATION {, GENERIC_ASSOCIATION})
5933 -------------------------------
5934 -- 12.3 Generic Association --
5935 -------------------------------
5937 -- GENERIC_ASSOCIATION ::=
5938 -- [generic_formal_parameter_SELECTOR_NAME =>]
5940 -- Note: unlike the procedure call case, a generic association node
5941 -- is generated for every association, even if no formal parameter
5942 -- selector name is present. In this case the parser will leave the
5943 -- Selector_Name field set to Empty, to be filled in later by the
5944 -- semantic pass.
5946 -- In Ada 2005, a formal may be associated with a box, if the
5947 -- association is part of the list of actuals for a formal package.
5948 -- If the association is given by OTHERS => <>, the association is
5949 -- an N_Others_Choice.
5951 -- N_Generic_Association
5952 -- Sloc points to first token of generic association
5953 -- Selector_Name (Node2) (set to Empty if no formal
5954 -- parameter selector name)
5955 -- Explicit_Generic_Actual_Parameter (Node1) (Empty if box present)
5956 -- Box_Present (Flag15) (for formal_package associations with a box)
5958 ---------------------------------------------
5959 -- 12.3 Explicit Generic Actual Parameter --
5960 ---------------------------------------------
5962 -- EXPLICIT_GENERIC_ACTUAL_PARAMETER ::=
5963 -- EXPRESSION | variable_NAME | subprogram_NAME
5964 -- | entry_NAME | SUBTYPE_MARK | package_instance_NAME
5966 -------------------------------------
5967 -- 12.4 Formal Object Declaration --
5968 -------------------------------------
5970 -- FORMAL_OBJECT_DECLARATION ::=
5971 -- DEFINING_IDENTIFIER_LIST :
5972 -- MODE [NULL_EXCLUSION] SUBTYPE_MARK [:= DEFAULT_EXPRESSION];
5973 -- | DEFINING_IDENTIFIER_LIST :
5974 -- MODE ACCESS_DEFINITION [:= DEFAULT_EXPRESSION];
5976 -- Although the syntax allows multiple identifiers in the list, the
5977 -- semantics is as though successive declarations were given with
5978 -- identical type definition and expression components. To simplify
5979 -- semantic processing, the parser represents a multiple declaration
5980 -- case as a sequence of single declarations, using the More_Ids and
5981 -- Prev_Ids flags to preserve the original source form as described
5982 -- in the section on "Handling of Defining Identifier Lists".
5984 -- N_Formal_Object_Declaration
5985 -- Sloc points to first identifier
5986 -- Defining_Identifier (Node1)
5987 -- In_Present (Flag15)
5988 -- Out_Present (Flag17)
5989 -- Null_Exclusion_Present (Flag11) (set to False if not present)
5990 -- Subtype_Mark (Node4) (set to Empty if not present)
5991 -- Access_Definition (Node3) (set to Empty if not present)
5992 -- Default_Expression (Node5) (set to Empty if no default expression)
5993 -- More_Ids (Flag5) (set to False if no more identifiers in list)
5994 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
5996 -----------------------------------
5997 -- 12.5 Formal Type Declaration --
5998 -----------------------------------
6000 -- FORMAL_TYPE_DECLARATION ::=
6001 -- type DEFINING_IDENTIFIER [DISCRIMINANT_PART]
6002 -- is FORMAL_TYPE_DEFINITION;
6004 -- N_Formal_Type_Declaration
6005 -- Sloc points to TYPE
6006 -- Defining_Identifier (Node1)
6007 -- Formal_Type_Definition (Node3)
6008 -- Discriminant_Specifications (List4) (set to No_List if no
6009 -- discriminant part)
6010 -- Unknown_Discriminants_Present (Flag13) set if (<>) discriminant
6012 ----------------------------------
6013 -- 12.5 Formal type definition --
6014 ----------------------------------
6016 -- FORMAL_TYPE_DEFINITION ::=
6017 -- FORMAL_PRIVATE_TYPE_DEFINITION
6018 -- | FORMAL_DERIVED_TYPE_DEFINITION
6019 -- | FORMAL_DISCRETE_TYPE_DEFINITION
6020 -- | FORMAL_SIGNED_INTEGER_TYPE_DEFINITION
6021 -- | FORMAL_MODULAR_TYPE_DEFINITION
6022 -- | FORMAL_FLOATING_POINT_DEFINITION
6023 -- | FORMAL_ORDINARY_FIXED_POINT_DEFINITION
6024 -- | FORMAL_DECIMAL_FIXED_POINT_DEFINITION
6025 -- | FORMAL_ARRAY_TYPE_DEFINITION
6026 -- | FORMAL_ACCESS_TYPE_DEFINITION
6027 -- | FORMAL_INTERFACE_TYPE_DEFINITION
6029 ---------------------------------------------
6030 -- 12.5.1 Formal Private Type Definition --
6031 ---------------------------------------------
6033 -- FORMAL_PRIVATE_TYPE_DEFINITION ::=
6034 -- [[abstract] tagged] [limited] private
6036 -- Note: TAGGED is not allowed in Ada 83 mode
6038 -- N_Formal_Private_Type_Definition
6039 -- Sloc points to PRIVATE
6040 -- Abstract_Present (Flag4)
6041 -- Tagged_Present (Flag15)
6042 -- Limited_Present (Flag17)
6044 --------------------------------------------
6045 -- 12.5.1 Formal Derived Type Definition --
6046 --------------------------------------------
6048 -- FORMAL_DERIVED_TYPE_DEFINITION ::=
6049 -- [abstract] [limited | synchronized]
6050 -- new SUBTYPE_MARK [[and INTERFACE_LIST] with private]
6051 -- Note: this construct is not allowed in Ada 83 mode
6053 -- N_Formal_Derived_Type_Definition
6054 -- Sloc points to NEW
6055 -- Subtype_Mark (Node4)
6056 -- Private_Present (Flag15)
6057 -- Abstract_Present (Flag4)
6058 -- Limited_Present (Flag17)
6059 -- Synchronized_Present (Flag7)
6060 -- Interface_List (List2) (set to No_List if none)
6062 ---------------------------------------------
6063 -- 12.5.2 Formal Discrete Type Definition --
6064 ---------------------------------------------
6066 -- FORMAL_DISCRETE_TYPE_DEFINITION ::= (<>)
6068 -- N_Formal_Discrete_Type_Definition
6069 -- Sloc points to (
6071 ---------------------------------------------------
6072 -- 12.5.2 Formal Signed Integer Type Definition --
6073 ---------------------------------------------------
6075 -- FORMAL_SIGNED_INTEGER_TYPE_DEFINITION ::= range <>
6077 -- N_Formal_Signed_Integer_Type_Definition
6078 -- Sloc points to RANGE
6080 --------------------------------------------
6081 -- 12.5.2 Formal Modular Type Definition --
6082 --------------------------------------------
6084 -- FORMAL_MODULAR_TYPE_DEFINITION ::= mod <>
6086 -- N_Formal_Modular_Type_Definition
6087 -- Sloc points to MOD
6089 ----------------------------------------------
6090 -- 12.5.2 Formal Floating Point Definition --
6091 ----------------------------------------------
6093 -- FORMAL_FLOATING_POINT_DEFINITION ::= digits <>
6095 -- N_Formal_Floating_Point_Definition
6096 -- Sloc points to DIGITS
6098 ----------------------------------------------------
6099 -- 12.5.2 Formal Ordinary Fixed Point Definition --
6100 ----------------------------------------------------
6102 -- FORMAL_ORDINARY_FIXED_POINT_DEFINITION ::= delta <>
6104 -- N_Formal_Ordinary_Fixed_Point_Definition
6105 -- Sloc points to DELTA
6107 ---------------------------------------------------
6108 -- 12.5.2 Formal Decimal Fixed Point Definition --
6109 ---------------------------------------------------
6111 -- FORMAL_DECIMAL_FIXED_POINT_DEFINITION ::= delta <> digits <>
6113 -- Note: formal decimal fixed point definition not allowed in Ada 83
6115 -- N_Formal_Decimal_Fixed_Point_Definition
6116 -- Sloc points to DELTA
6118 ------------------------------------------
6119 -- 12.5.3 Formal Array Type Definition --
6120 ------------------------------------------
6122 -- FORMAL_ARRAY_TYPE_DEFINITION ::= ARRAY_TYPE_DEFINITION
6124 -------------------------------------------
6125 -- 12.5.4 Formal Access Type Definition --
6126 -------------------------------------------
6128 -- FORMAL_ACCESS_TYPE_DEFINITION ::= ACCESS_TYPE_DEFINITION
6130 ----------------------------------------------
6131 -- 12.5.5 Formal Interface Type Definition --
6132 ----------------------------------------------
6134 -- FORMAL_INTERFACE_TYPE_DEFINITION ::= INTERFACE_TYPE_DEFINITION
6136 -----------------------------------------
6137 -- 12.6 Formal Subprogram Declaration --
6138 -----------------------------------------
6140 -- FORMAL_SUBPROGRAM_DECLARATION ::=
6141 -- FORMAL_CONCRETE_SUBPROGRAM_DECLARATION
6142 -- | FORMAL_ABSTRACT_SUBPROGRAM_DECLARATION
6144 --------------------------------------------------
6145 -- 12.6 Formal Concrete Subprogram Declaration --
6146 --------------------------------------------------
6148 -- FORMAL_CONCRETE_SUBPROGRAM_DECLARATION ::=
6149 -- with SUBPROGRAM_SPECIFICATION [is SUBPROGRAM_DEFAULT];
6151 -- N_Formal_Concrete_Subprogram_Declaration
6152 -- Sloc points to WITH
6153 -- Specification (Node1)
6154 -- Default_Name (Node2) (set to Empty if no subprogram default)
6155 -- Box_Present (Flag15)
6157 -- Note: if no subprogram default is present, then Name is set
6158 -- to Empty, and Box_Present is False.
6160 --------------------------------------------------
6161 -- 12.6 Formal Abstract Subprogram Declaration --
6162 --------------------------------------------------
6164 -- FORMAL_ABSTRACT_SUBPROGRAM_DECLARATION ::=
6165 -- with SUBPROGRAM_SPECIFICATION is abstract [SUBPROGRAM_DEFAULT];
6167 -- N_Formal_Abstract_Subprogram_Declaration
6168 -- Sloc points to WITH
6169 -- Specification (Node1)
6170 -- Default_Name (Node2) (set to Empty if no subprogram default)
6171 -- Box_Present (Flag15)
6173 -- Note: if no subprogram default is present, then Name is set
6174 -- to Empty, and Box_Present is False.
6176 ------------------------------
6177 -- 12.6 Subprogram Default --
6178 ------------------------------
6180 -- SUBPROGRAM_DEFAULT ::= DEFAULT_NAME | <>
6182 -- There is no separate node in the tree for a subprogram default.
6183 -- Instead the parent (N_Formal_Concrete_Subprogram_Declaration
6184 -- or N_Formal_Abstract_Subprogram_Declaration) node contains the
6185 -- default name or box indication, as needed.
6187 ------------------------
6188 -- 12.6 Default Name --
6189 ------------------------
6191 -- DEFAULT_NAME ::= NAME
6193 --------------------------------------
6194 -- 12.7 Formal Package Declaration --
6195 --------------------------------------
6197 -- FORMAL_PACKAGE_DECLARATION ::=
6198 -- with package DEFINING_IDENTIFIER
6199 -- is new generic_package_NAME FORMAL_PACKAGE_ACTUAL_PART;
6201 -- Note: formal package declarations not allowed in Ada 83 mode
6203 -- N_Formal_Package_Declaration
6204 -- Sloc points to WITH
6205 -- Defining_Identifier (Node1)
6206 -- Name (Node2)
6207 -- Generic_Associations (List3) (set to No_List if (<>) case or
6208 -- empty generic actual part)
6209 -- Box_Present (Flag15)
6210 -- Instance_Spec (Node5-Sem)
6211 -- ABE_Is_Certain (Flag18-Sem)
6213 --------------------------------------
6214 -- 12.7 Formal Package Actual Part --
6215 --------------------------------------
6217 -- FORMAL_PACKAGE_ACTUAL_PART ::=
6218 -- ([OTHERS] => <>)
6219 -- | [GENERIC_ACTUAL_PART]
6220 -- (FORMAL_PACKAGE_ASSOCIATION {. FORMAL_PACKAGE_ASSOCIATION}
6222 -- FORMAL_PACKAGE_ASSOCIATION ::=
6223 -- GENERIC_ASSOCIATION
6224 -- | GENERIC_FORMAL_PARAMETER_SELECTOR_NAME => <>
6226 -- There is no explicit node in the tree for a formal package actual
6227 -- part. Instead the information appears in the parent node (i.e. the
6228 -- formal package declaration node itself).
6230 -- There is no explicit node for a formal package association. All of
6231 -- them are represented either by a generic association, possibly with
6232 -- Box_Present, or by an N_Others_Choice.
6234 ---------------------------------
6235 -- 13.1 Representation clause --
6236 ---------------------------------
6238 -- REPRESENTATION_CLAUSE ::=
6239 -- ATTRIBUTE_DEFINITION_CLAUSE
6240 -- | ENUMERATION_REPRESENTATION_CLAUSE
6241 -- | RECORD_REPRESENTATION_CLAUSE
6242 -- | AT_CLAUSE
6244 ----------------------
6245 -- 13.1 Local Name --
6246 ----------------------
6248 -- LOCAL_NAME :=
6249 -- DIRECT_NAME
6250 -- | DIRECT_NAME'ATTRIBUTE_DESIGNATOR
6251 -- | library_unit_NAME
6253 -- The construct DIRECT_NAME'ATTRIBUTE_DESIGNATOR appears in the tree
6254 -- as an attribute reference, which has essentially the same form.
6256 ---------------------------------------
6257 -- 13.3 Attribute definition clause --
6258 ---------------------------------------
6260 -- ATTRIBUTE_DEFINITION_CLAUSE ::=
6261 -- for LOCAL_NAME'ATTRIBUTE_DESIGNATOR use EXPRESSION;
6262 -- | for LOCAL_NAME'ATTRIBUTE_DESIGNATOR use NAME;
6264 -- In Ada 83, the expression must be a simple expression and the
6265 -- local name must be a direct name.
6267 -- Note: the only attribute definition clause that is processed by
6268 -- gigi is an address clause. For all other cases, the information
6269 -- is extracted by the front end and either results in setting entity
6270 -- information, e.g. Esize for the Size clause, or in appropriate
6271 -- expansion actions (e.g. in the case of Storage_Size).
6273 -- For an address clause, Gigi constructs the appropriate addressing
6274 -- code. It also ensures that no aliasing optimizations are made
6275 -- for the object for which the address clause appears.
6277 -- Note: for an address clause used to achieve an overlay:
6279 -- A : Integer;
6280 -- B : Integer;
6281 -- for B'Address use A'Address;
6283 -- the above rule means that Gigi will ensure that no optimizations
6284 -- will be made for B that would violate the implementation advice
6285 -- of RM 13.3(19). However, this advice applies only to B and not
6286 -- to A, which seems unfortunate. The GNAT front end will mark the
6287 -- object A as volatile to also prevent unwanted optimization
6288 -- assumptions based on no aliasing being made for B.
6290 -- N_Attribute_Definition_Clause
6291 -- Sloc points to FOR
6292 -- Name (Node2) the local name
6293 -- Chars (Name1) the identifier name from the attribute designator
6294 -- Expression (Node3) the expression or name
6295 -- Entity (Node4-Sem)
6296 -- Next_Rep_Item (Node5-Sem)
6297 -- From_At_Mod (Flag4-Sem)
6298 -- Check_Address_Alignment (Flag11-Sem)
6299 -- Address_Warning_Posted (Flag18-Sem)
6301 ---------------------------------------------
6302 -- 13.4 Enumeration representation clause --
6303 ---------------------------------------------
6305 -- ENUMERATION_REPRESENTATION_CLAUSE ::=
6306 -- for first_subtype_LOCAL_NAME use ENUMERATION_AGGREGATE;
6308 -- In Ada 83, the name must be a direct name
6310 -- N_Enumeration_Representation_Clause
6311 -- Sloc points to FOR
6312 -- Identifier (Node1) direct name
6313 -- Array_Aggregate (Node3)
6314 -- Next_Rep_Item (Node5-Sem)
6316 ---------------------------------
6317 -- 13.4 Enumeration aggregate --
6318 ---------------------------------
6320 -- ENUMERATION_AGGREGATE ::= ARRAY_AGGREGATE
6322 ------------------------------------------
6323 -- 13.5.1 Record representation clause --
6324 ------------------------------------------
6326 -- RECORD_REPRESENTATION_CLAUSE ::=
6327 -- for first_subtype_LOCAL_NAME use
6328 -- record [MOD_CLAUSE]
6329 -- {COMPONENT_CLAUSE}
6330 -- end record;
6332 -- Gigi restriction: Mod_Clause is always Empty (if present it is
6333 -- replaced by a corresponding Alignment attribute definition clause).
6335 -- Note: Component_Clauses can include pragmas
6337 -- N_Record_Representation_Clause
6338 -- Sloc points to FOR
6339 -- Identifier (Node1) direct name
6340 -- Mod_Clause (Node2) (set to Empty if no mod clause present)
6341 -- Component_Clauses (List3)
6342 -- Next_Rep_Item (Node5-Sem)
6344 ------------------------------
6345 -- 13.5.1 Component clause --
6346 ------------------------------
6348 -- COMPONENT_CLAUSE ::=
6349 -- component_LOCAL_NAME at POSITION
6350 -- range FIRST_BIT .. LAST_BIT;
6352 -- N_Component_Clause
6353 -- Sloc points to AT
6354 -- Component_Name (Node1) points to Name or Attribute_Reference
6355 -- Position (Node2)
6356 -- First_Bit (Node3)
6357 -- Last_Bit (Node4)
6359 ----------------------
6360 -- 13.5.1 Position --
6361 ----------------------
6363 -- POSITION ::= static_EXPRESSION
6365 -----------------------
6366 -- 13.5.1 First_Bit --
6367 -----------------------
6369 -- FIRST_BIT ::= static_SIMPLE_EXPRESSION
6371 ----------------------
6372 -- 13.5.1 Last_Bit --
6373 ----------------------
6375 -- LAST_BIT ::= static_SIMPLE_EXPRESSION
6377 --------------------------
6378 -- 13.8 Code statement --
6379 --------------------------
6381 -- CODE_STATEMENT ::= QUALIFIED_EXPRESSION;
6383 -- Note: in GNAT, the qualified expression has the form
6385 -- Asm_Insn'(Asm (...));
6387 -- See package System.Machine_Code in file s-maccod.ads for details on
6388 -- the allowed parameters to Asm. There are two ways this node can
6389 -- arise, as a code statement, in which case the expression is the
6390 -- qualified expression, or as a result of the expansion of an intrinsic
6391 -- call to the Asm or Asm_Input procedure.
6393 -- N_Code_Statement
6394 -- Sloc points to first token of the expression
6395 -- Expression (Node3)
6397 -- Note: package Exp_Code contains an abstract functional interface
6398 -- for use by Gigi in accessing the data from N_Code_Statement nodes.
6400 ------------------------
6401 -- 13.12 Restriction --
6402 ------------------------
6404 -- RESTRICTION ::=
6405 -- restriction_IDENTIFIER
6406 -- | restriction_parameter_IDENTIFIER => EXPRESSION
6408 -- There is no explicit node for restrictions. Instead the restriction
6409 -- appears in normal pragma syntax as a pragma argument association,
6410 -- which has the same syntactic form.
6412 --------------------------
6413 -- B.2 Shift Operators --
6414 --------------------------
6416 -- Calls to the intrinsic shift functions are converted to one of
6417 -- the following shift nodes, which have the form of normal binary
6418 -- operator names. Note that for a given shift operation, one node
6419 -- covers all possible types, as for normal operators.
6421 -- Note: it is perfectly permissible for the expander to generate
6422 -- shift operation nodes directly, in which case they will be analyzed
6423 -- and parsed in the usual manner.
6425 -- Sprint syntax: shift-function-name!(expr, count)
6427 -- Note: the Left_Opnd field holds the first argument (the value to
6428 -- be shifted). The Right_Opnd field holds the second argument (the
6429 -- shift count). The Chars field is the name of the intrinsic function.
6431 -- N_Op_Rotate_Left
6432 -- Sloc points to the function name
6433 -- plus fields for binary operator
6434 -- plus fields for expression
6435 -- Shift_Count_OK (Flag4-Sem)
6437 -- N_Op_Rotate_Right
6438 -- Sloc points to the function name
6439 -- plus fields for binary operator
6440 -- plus fields for expression
6441 -- Shift_Count_OK (Flag4-Sem)
6443 -- N_Op_Shift_Left
6444 -- Sloc points to the function name
6445 -- plus fields for binary operator
6446 -- plus fields for expression
6447 -- Shift_Count_OK (Flag4-Sem)
6449 -- N_Op_Shift_Right_Arithmetic
6450 -- Sloc points to the function name
6451 -- plus fields for binary operator
6452 -- plus fields for expression
6453 -- Shift_Count_OK (Flag4-Sem)
6455 -- N_Op_Shift_Right
6456 -- Sloc points to the function name
6457 -- plus fields for binary operator
6458 -- plus fields for expression
6459 -- Shift_Count_OK (Flag4-Sem)
6461 --------------------------
6462 -- Obsolescent Features --
6463 --------------------------
6465 -- The syntax descriptions and tree nodes for obsolescent features are
6466 -- grouped together, corresponding to their location in appendix I in
6467 -- the RM. However, parsing and semantic analysis for these constructs
6468 -- is located in an appropriate chapter (see individual notes).
6470 ---------------------------
6471 -- J.3 Delta Constraint --
6472 ---------------------------
6474 -- Note: the parse routine for this construct is located in section
6475 -- 3.5.9 of Par-Ch3, and semantic analysis is in Sem_Ch3, which is
6476 -- where delta constraint logically belongs.
6478 -- DELTA_CONSTRAINT ::= DELTA static_EXPRESSION [RANGE_CONSTRAINT]
6480 -- N_Delta_Constraint
6481 -- Sloc points to DELTA
6482 -- Delta_Expression (Node3)
6483 -- Range_Constraint (Node4) (set to Empty if not present)
6485 --------------------
6486 -- J.7 At Clause --
6487 --------------------
6489 -- AT_CLAUSE ::= for DIRECT_NAME use at EXPRESSION;
6491 -- Note: the parse routine for this construct is located in Par-Ch13,
6492 -- and the semantic analysis is in Sem_Ch13, where at clause logically
6493 -- belongs if it were not obsolescent.
6495 -- Note: in Ada 83 the expression must be a simple expression
6497 -- Gigi restriction: This node never appears, it is rewritten as an
6498 -- address attribute definition clause.
6500 -- N_At_Clause
6501 -- Sloc points to FOR
6502 -- Identifier (Node1)
6503 -- Expression (Node3)
6505 ---------------------
6506 -- J.8 Mod clause --
6507 ---------------------
6509 -- MOD_CLAUSE ::= at mod static_EXPRESSION;
6511 -- Note: the parse routine for this construct is located in Par-Ch13,
6512 -- and the semantic analysis is in Sem_Ch13, where mod clause logically
6513 -- belongs if it were not obsolescent.
6515 -- Note: in Ada 83, the expression must be a simple expression
6517 -- Gigi restriction: this node never appears. It is replaced
6518 -- by a corresponding Alignment attribute definition clause.
6520 -- Note: pragmas can appear before and after the MOD_CLAUSE since
6521 -- its name has "clause" in it. This is rather strange, but is quite
6522 -- definitely specified. The pragmas before are collected in the
6523 -- Pragmas_Before field of the mod clause node itself, and pragmas
6524 -- after are simply swallowed up in the list of component clauses.
6526 -- N_Mod_Clause
6527 -- Sloc points to AT
6528 -- Expression (Node3)
6529 -- Pragmas_Before (List4) Pragmas before mod clause (No_List if none)
6531 --------------------
6532 -- Semantic Nodes --
6533 --------------------
6535 -- These semantic nodes are used to hold additional semantic information.
6536 -- They are inserted into the tree as a result of semantic processing.
6537 -- Although there are no legitimate source syntax constructions that
6538 -- correspond directly to these nodes, we need a source syntax for the
6539 -- reconstructed tree printed by Sprint, and the node descriptions here
6540 -- show this syntax.
6542 -- Note: Case_Expression and Conditional_Expression is in this section for
6543 -- now, since they are extensions. We will move them to their appropriate
6544 -- places when they are officially approved as extensions (and then we will
6545 -- know what the exact grammar and place in the Reference Manual is!)
6547 ---------------------
6548 -- Case Expression --
6549 ---------------------
6551 -- CASE_EXPRESSION ::=
6552 -- case EXPRESSION is
6553 -- CASE_EXPRESSION_ALTERNATIVE
6554 -- {CASE_EXPRESSION_ALTERNATIVE}
6556 -- Note that the Alternatives cannot include pragmas (this constrasts
6557 -- with the situation of case statements where pragmas are allowed).
6559 -- N_Case_Expression
6560 -- Sloc points to CASE
6561 -- Expression (Node3)
6562 -- Alternatives (List4)
6564 ---------------------------------
6565 -- Case Expression Alternative --
6566 ---------------------------------
6568 -- CASE_STATEMENT_ALTERNATIVE ::=
6569 -- when DISCRETE_CHOICE_LIST =>
6570 -- EXPRESSION
6572 -- N_Case_Expression_Alternative
6573 -- Sloc points to WHEN
6574 -- Actions (List1)
6575 -- Discrete_Choices (List4)
6576 -- Expression (Node3)
6578 -- Note: The Actions field temporarily holds any actions associated with
6579 -- evaluation of the Expression. During expansion of the case expression
6580 -- these actions are wrapped into the an N_Expressions_With_Actions node
6581 -- replacing the original expression.
6583 ----------------------------
6584 -- Conditional Expression --
6585 ----------------------------
6587 -- This node is used to represent an expression corresponding to the
6588 -- C construct (condition ? then-expression : else_expression), where
6589 -- Expressions is a three element list, whose first expression is the
6590 -- condition, and whose second and third expressions are the then and
6591 -- else expressions respectively.
6593 -- Note: the Then_Actions and Else_Actions fields are always set to
6594 -- No_List in the tree passed to Gigi. These fields are used only
6595 -- for temporary processing purposes in the expander.
6597 -- The Ada language does not permit conditional expressions, however
6598 -- this is under discussion as a possible extension by the ARG, and we
6599 -- have implemented a form of this capability in GNAT under control of
6600 -- the -gnatX switch. The syntax is:
6602 -- CONDITIONAL_EXPRESSION ::=
6603 -- if EXPRESSION then EXPRESSION
6604 -- {elsif EXPRESSION then EXPRESSION}
6605 -- [else EXPRESSION]
6607 -- And we add the additional constructs
6609 -- PRIMARY ::= ( CONDITIONAL_EXPRESION )
6610 -- PRAGMA_ARGUMENT_ASSOCIATION ::= CONDITIONAL_EXPRESSION
6612 -- Note: if we have (IF x1 THEN x2 ELSIF x3 THEN x4 ELSE x5) then it
6613 -- is represented as (IF x1 THEN x2 ELSE (IF x3 THEN x4 ELSE x5)) and
6614 -- the Is_Elsif flag is set on the inner conditional expression.
6616 -- N_Conditional_Expression
6617 -- Sloc points to IF or ELSIF keyword
6618 -- Expressions (List1)
6619 -- Then_Actions (List2-Sem)
6620 -- Else_Actions (List3-Sem)
6621 -- Is_Elsif (Flag13) (set if comes from ELSIF)
6622 -- plus fields for expression
6624 -------------------
6625 -- Expanded_Name --
6626 -------------------
6628 -- The N_Expanded_Name node is used to represent a selected component
6629 -- name that has been resolved to an expanded name. The semantic phase
6630 -- replaces N_Selected_Component nodes that represent names by the use
6631 -- of this node, leaving the N_Selected_Component node used only when
6632 -- the prefix is a record or protected type.
6634 -- The fields of the N_Expanded_Name node are layed out identically
6635 -- to those of the N_Selected_Component node, allowing conversion of
6636 -- an expanded name node to a selected component node to be done
6637 -- easily, see Sinfo.CN.Change_Selected_Component_To_Expanded_Name.
6639 -- There is no special sprint syntax for an expanded name
6641 -- N_Expanded_Name
6642 -- Sloc points to the period
6643 -- Chars (Name1) copy of Chars field of selector name
6644 -- Prefix (Node3)
6645 -- Selector_Name (Node2)
6646 -- Entity (Node4-Sem)
6647 -- Associated_Node (Node4-Sem)
6648 -- Redundant_Use (Flag13-Sem)
6649 -- Has_Private_View (Flag11-Sem) set in generic units.
6650 -- plus fields for expression
6652 -----------------------------
6653 -- Expression with Actions --
6654 -----------------------------
6656 -- This node is created by the analyzer/expander to handle some
6657 -- expansion cases, notably short circuit forms where there are
6658 -- actions associated with the right hand operand.
6660 -- The N_Expression_With_Actions node represents an expression with
6661 -- an associated set of actions (which are executable statements and
6662 -- declarations, as might occur in a handled statement sequence).
6664 -- The required semantics is that the set of actions is executed in
6665 -- the order in which it appears just before the expression is
6666 -- evaluated (and these actions must only be executed if the value
6667 -- of the expression is evaluated). The node is considered to be
6668 -- a subexpression, whose value is the value of the Expression after
6669 -- executing all the actions.
6671 -- Note: if the actions contain declarations, then these declarations
6672 -- maybe referenced with in the expression. It is thus appropriate for
6673 -- the back end to create a scope that encompasses the construct (any
6674 -- declarations within the actions will definitely not be referenced
6675 -- once elaboration of the construct is completed).
6677 -- Sprint syntax: do
6678 -- action;
6679 -- action;
6680 -- ...
6681 -- action;
6682 -- in expression end
6684 -- N_Expression_With_Actions
6685 -- Actions (List1)
6686 -- Expression (Node3)
6687 -- plus fields for expression
6689 -- Note: the actions list is always non-null, since we would
6690 -- never have created this node if there weren't some actions.
6692 --------------------
6693 -- Free Statement --
6694 --------------------
6696 -- The N_Free_Statement node is generated as a result of a call to an
6697 -- instantiation of Unchecked_Deallocation. The instantiation of this
6698 -- generic is handled specially and generates this node directly.
6700 -- Sprint syntax: free expression
6702 -- N_Free_Statement
6703 -- Sloc is copied from the unchecked deallocation call
6704 -- Expression (Node3) argument to unchecked deallocation call
6705 -- Storage_Pool (Node1-Sem)
6706 -- Procedure_To_Call (Node2-Sem)
6707 -- Actual_Designated_Subtype (Node4-Sem)
6709 -- Note: in the case where a debug source file is generated, the Sloc
6710 -- for this node points to the FREE keyword in the Sprint file output.
6712 -------------------
6713 -- Freeze Entity --
6714 -------------------
6716 -- This node marks the point in a declarative part at which an entity
6717 -- declared therein becomes frozen. The expander places initialization
6718 -- procedures for types at those points. Gigi uses the freezing point
6719 -- to elaborate entities that may depend on previous private types.
6721 -- See the section in Einfo "Delayed Freezing and Elaboration" for
6722 -- a full description of the use of this node.
6724 -- The Entity field points back to the entity for the type (whose
6725 -- Freeze_Node field points back to this freeze node).
6727 -- The Actions field contains a list of declarations and statements
6728 -- generated by the expander which are associated with the freeze
6729 -- node, and are elaborated as though the freeze node were replaced
6730 -- by this sequence of actions.
6732 -- Note: the Sloc field in the freeze node references a construct
6733 -- associated with the freezing point. This is used for posting
6734 -- messages in some error/warning situations, e.g. the case where
6735 -- a primitive operation of a tagged type is declared too late.
6737 -- Sprint syntax: freeze entity-name [
6738 -- freeze actions
6739 -- ]
6741 -- N_Freeze_Entity
6742 -- Sloc points near freeze point (see above special note)
6743 -- Entity (Node4-Sem)
6744 -- Access_Types_To_Process (Elist2-Sem) (set to No_Elist if none)
6745 -- TSS_Elist (Elist3-Sem) (set to No_Elist if no associated TSS's)
6746 -- Actions (List1) (set to No_List if no freeze actions)
6747 -- First_Subtype_Link (Node5-Sem) (set to Empty if no link)
6749 -- The Actions field holds actions associated with the freeze. These
6750 -- actions are elaborated at the point where the type is frozen.
6752 -- Note: in the case where a debug source file is generated, the Sloc
6753 -- for this node points to the FREEZE keyword in the Sprint file output.
6755 --------------------------------
6756 -- Implicit Label Declaration --
6757 --------------------------------
6759 -- An implicit label declaration is created for every occurrence of a
6760 -- label on a statement or a label on a block or loop. It is chained
6761 -- in the declarations of the innermost enclosing block as specified
6762 -- in RM section 5.1 (3).
6764 -- The Defining_Identifier is the actual identifier for the statement
6765 -- identifier. Note that the occurrence of the label is a reference, NOT
6766 -- the defining occurrence. The defining occurrence occurs at the head
6767 -- of the innermost enclosing block, and is represented by this node.
6769 -- Note: from the grammar, this might better be called an implicit
6770 -- statement identifier declaration, but the term we choose seems
6771 -- friendlier, since at least informally statement identifiers are
6772 -- called labels in both cases (i.e. when used in labels, and when
6773 -- used as the identifiers of blocks and loops).
6775 -- Note: although this is logically a semantic node, since it does not
6776 -- correspond directly to a source syntax construction, these nodes are
6777 -- actually created by the parser in a post pass done just after parsing
6778 -- is complete, before semantic analysis is started (see Par.Labl).
6780 -- Sprint syntax: labelname : label;
6782 -- N_Implicit_Label_Declaration
6783 -- Sloc points to the << of the label
6784 -- Defining_Identifier (Node1)
6785 -- Label_Construct (Node2-Sem)
6787 -- Note: in the case where a debug source file is generated, the Sloc
6788 -- for this node points to the label name in the generated declaration.
6790 ---------------------
6791 -- Itype_Reference --
6792 ---------------------
6794 -- This node is used to create a reference to an Itype. The only purpose
6795 -- is to make sure the Itype is defined if this is the first reference.
6797 -- A typical use of this node is when an Itype is to be referenced in
6798 -- two branches of an IF statement. In this case it is important that
6799 -- the first use of the Itype not be inside the conditional, since then
6800 -- it might not be defined if the other branch of the IF is taken, in
6801 -- the case where the definition generates elaboration code.
6803 -- The Itype field points to the referenced Itype
6805 -- Sprint syntax: reference itype-name
6807 -- N_Itype_Reference
6808 -- Sloc points to the node generating the reference
6809 -- Itype (Node1-Sem)
6811 -- Note: in the case where a debug source file is generated, the Sloc
6812 -- for this node points to the REFERENCE keyword in the file output.
6814 ---------------------
6815 -- Raise_xxx_Error --
6816 ---------------------
6818 -- One of these nodes is created during semantic analysis to replace
6819 -- a node for an expression that is determined to definitely raise
6820 -- the corresponding exception.
6822 -- The N_Raise_xxx_Error node may also stand alone in place
6823 -- of a declaration or statement, in which case it simply causes
6824 -- the exception to be raised (i.e. it is equivalent to a raise
6825 -- statement that raises the corresponding exception). This use
6826 -- is distinguished by the fact that the Etype in this case is
6827 -- Standard_Void_Type, In the subexpression case, the Etype is the
6828 -- same as the type of the subexpression which it replaces.
6830 -- If Condition is empty, then the raise is unconditional. If the
6831 -- Condition field is non-empty, it is a boolean expression which
6832 -- is first evaluated, and the exception is raised only if the
6833 -- value of the expression is True. In the unconditional case, the
6834 -- creation of this node is usually accompanied by a warning message
6835 -- error. The creation of this node will usually be accompanied by a
6836 -- message (unless it appears within the right operand of a short
6837 -- circuit form whose left argument is static and decisively
6838 -- eliminates elaboration of the raise operation. The condition field
6839 -- can ONLY be present when the node is used as a statement form, it
6840 -- may NOT be present in the case where the node appears within an
6841 -- expression.
6843 -- The exception is generated with a message that contains the
6844 -- file name and line number, and then appended text. The Reason
6845 -- code shows the text to be added. The Reason code is an element
6846 -- of the type Types.RT_Exception_Code, and indicates both the
6847 -- message to be added, and the exception to be raised (which must
6848 -- match the node type). The value is stored by storing a Uint which
6849 -- is the Pos value of the enumeration element in this type.
6851 -- Gigi restriction: This expander ensures that the type of the
6852 -- Condition field is always Standard.Boolean, even if the type
6853 -- in the source is some non-standard boolean type.
6855 -- Sprint syntax: [xxx_error "msg"]
6856 -- or: [xxx_error when condition "msg"]
6858 -- N_Raise_Constraint_Error
6859 -- Sloc references related construct
6860 -- Condition (Node1) (set to Empty if no condition)
6861 -- Reason (Uint3)
6862 -- plus fields for expression
6864 -- N_Raise_Program_Error
6865 -- Sloc references related construct
6866 -- Condition (Node1) (set to Empty if no condition)
6867 -- Reason (Uint3)
6868 -- plus fields for expression
6870 -- N_Raise_Storage_Error
6871 -- Sloc references related construct
6872 -- Condition (Node1) (set to Empty if no condition)
6873 -- Reason (Uint3)
6874 -- plus fields for expression
6876 -- Note: Sloc is copied from the expression generating the exception.
6877 -- In the case where a debug source file is generated, the Sloc for
6878 -- this node points to the left bracket in the Sprint file output.
6880 -- Note: the back end may be required to translate these nodes into
6881 -- appropriate goto statements. See description of N_Push/Pop_xxx_Label.
6883 ---------------------------------------------
6884 -- Optimization of Exception Raise to Goto --
6885 ---------------------------------------------
6887 -- In some cases, the front end will determine that any exception raised
6888 -- by the back end for a certain exception should be transformed into a
6889 -- goto statement.
6891 -- There are three kinds of exceptions raised by the back end (note that
6892 -- for this purpose we consider gigi to be part of the back end in the
6893 -- gcc case):
6895 -- 1. Exceptions resulting from N_Raise_xxx_Error nodes
6896 -- 2. Exceptions from checks triggered by Do_xxx_Check flags
6897 -- 3. Other cases not specifically marked by the front end
6899 -- Normally all such exceptions are translated into calls to the proper
6900 -- Rcheck_xx procedure, where xx encodes both the exception to be raised
6901 -- and the exception message.
6903 -- The front end may determine that for a particular sequence of code,
6904 -- exceptions in any of these three categories for a particular builtin
6905 -- exception should result in a goto, rather than a call to Rcheck_xx.
6906 -- The exact sequence to be generated is:
6908 -- Local_Raise (exception'Identity);
6909 -- goto Label
6911 -- The front end marks such a sequence of code by bracketing it with
6912 -- push and pop nodes:
6914 -- N_Push_xxx_Label (referencing the label)
6915 -- ...
6916 -- (code where transformation is expected for exception xxx)
6917 -- ...
6918 -- N_Pop_xxx_Label
6920 -- The use of push/pop reflects the fact that such regions can properly
6921 -- nest, and one special case is a subregion in which no transformation
6922 -- is allowed. Such a region is marked by a N_Push_xxx_Label node whose
6923 -- Exception_Label field is Empty.
6925 -- N_Push_Constraint_Error_Label
6926 -- Sloc references first statement in region covered
6927 -- Exception_Label (Node5-Sem)
6929 -- N_Push_Program_Error_Label
6930 -- Sloc references first statement in region covered
6931 -- Exception_Label (Node5-Sem)
6933 -- N_Push_Storage_Error_Label
6934 -- Sloc references first statement in region covered
6935 -- Exception_Label (Node5-Sem)
6937 -- N_Pop_Constraint_Error_Label
6938 -- Sloc references last statement in region covered
6940 -- N_Pop_Program_Error_Label
6941 -- Sloc references last statement in region covered
6943 -- N_Pop_Storage_Error_Label
6944 -- Sloc references last statement in region covered
6946 ---------------
6947 -- Reference --
6948 ---------------
6950 -- For a number of purposes, we need to construct references to objects.
6951 -- These references are subsequently treated as normal access values.
6952 -- An example is the construction of the parameter block passed to a
6953 -- task entry. The N_Reference node is provided for this purpose. It is
6954 -- similar in effect to the use of the Unrestricted_Access attribute,
6955 -- and like Unrestricted_Access can be applied to objects which would
6956 -- not be valid prefixes for the Unchecked_Access attribute (e.g.
6957 -- objects which are not aliased, and slices). In addition it can be
6958 -- applied to composite type values as well as objects, including string
6959 -- values and aggregates.
6961 -- Note: we use the Prefix field for this expression so that the
6962 -- resulting node can be treated using common code with the attribute
6963 -- nodes for the 'Access and related attributes. Logically it would make
6964 -- more sense to call it an Expression field, but then we would have to
6965 -- special case the treatment of the N_Reference node.
6967 -- Sprint syntax: prefix'reference
6969 -- N_Reference
6970 -- Sloc is copied from the expression
6971 -- Prefix (Node3)
6972 -- plus fields for expression
6974 -- Note: in the case where a debug source file is generated, the Sloc
6975 -- for this node points to the quote in the Sprint file output.
6977 -----------------
6978 -- SCIL Nodes --
6979 -----------------
6981 -- SCIL nodes are special nodes added to the tree when the CodePeer
6982 -- mode is active. They help the CodePeer backend to locate nodes that
6983 -- require special processing.
6985 -- Major documentation on the general design of the SCIL interface, and
6986 -- in particular detailed description of these nodes is missing and is
6987 -- to be supplied in the future, when the design has finalized ???
6989 -- Meanwhile these nodes should be considered in experimental form, and
6990 -- should be ignored by all code generating back ends. ???
6992 -- N_SCIL_Dispatch_Table_Tag_Init
6993 -- Sloc references a node for a tag initialization
6994 -- SCIL_Entity (Node4-Sem)
6996 -- N_SCIL_Dispatching_Call
6997 -- Sloc references the node of a dispatching call
6998 -- SCIL_Target_Prim (Node2-Sem)
6999 -- SCIL_Entity (Node4-Sem)
7000 -- SCIL_Controlling_Tag (Node5-Sem)
7002 -- N_SCIL_Membership_Test
7003 -- Sloc references the node of a membership test
7004 -- SCIL_Tag_Value (Node5-Sem)
7005 -- SCIL_Entity (Node4-Sem)
7007 ---------------------
7008 -- Subprogram_Info --
7009 ---------------------
7011 -- This node generates the appropriate Subprogram_Info value for a
7012 -- given procedure. See Ada.Exceptions for further details
7014 -- Sprint syntax: subprog'subprogram_info
7016 -- N_Subprogram_Info
7017 -- Sloc points to the entity for the procedure
7018 -- Identifier (Node1) identifier referencing the procedure
7019 -- Etype (Node5-Sem) type (always set to Ada.Exceptions.Code_Loc
7021 -- Note: in the case where a debug source file is generated, the Sloc
7022 -- for this node points to the quote in the Sprint file output.
7024 --------------------------
7025 -- Unchecked Expression --
7026 --------------------------
7028 -- An unchecked expression is one that must be analyzed and resolved
7029 -- with all checks off, regardless of the current setting of scope
7030 -- suppress flags.
7032 -- Sprint syntax: `(expression)
7034 -- Note: this node is always removed from the tree (and replaced by
7035 -- its constituent expression) on completion of analysis, so it only
7036 -- appears in intermediate trees, and will never be seen by Gigi.
7038 -- N_Unchecked_Expression
7039 -- Sloc is a copy of the Sloc of the expression
7040 -- Expression (Node3)
7041 -- plus fields for expression
7043 -- Note: in the case where a debug source file is generated, the Sloc
7044 -- for this node points to the back quote in the Sprint file output.
7046 -------------------------------
7047 -- Unchecked Type Conversion --
7048 -------------------------------
7050 -- An unchecked type conversion node represents the semantic action
7051 -- corresponding to a call to an instantiation of Unchecked_Conversion.
7052 -- It is generated as a result of actual use of Unchecked_Conversion
7053 -- and also the expander generates unchecked type conversion nodes
7054 -- directly for expansion of complex semantic actions.
7056 -- Note: an unchecked type conversion is a variable as far as the
7057 -- semantics are concerned, which is convenient for the expander.
7058 -- This does not change what Ada source programs are legal, since
7059 -- clearly a function call to an instantiation of Unchecked_Conversion
7060 -- is not a variable in any case.
7062 -- Sprint syntax: subtype-mark!(expression)
7064 -- N_Unchecked_Type_Conversion
7065 -- Sloc points to related node in source
7066 -- Subtype_Mark (Node4)
7067 -- Expression (Node3)
7068 -- Kill_Range_Check (Flag11-Sem)
7069 -- No_Truncation (Flag17-Sem)
7070 -- plus fields for expression
7072 -- Note: in the case where a debug source file is generated, the Sloc
7073 -- for this node points to the exclamation in the Sprint file output.
7075 -----------------------------------
7076 -- Validate_Unchecked_Conversion --
7077 -----------------------------------
7079 -- The front end does most of the validation of unchecked conversion,
7080 -- including checking sizes (this is done after the back end is called
7081 -- to take advantage of back-annotation of calculated sizes).
7083 -- The front end also deals with specific cases that are not allowed
7084 -- e.g. involving unconstrained array types.
7086 -- For the case of the standard gigi backend, this means that all
7087 -- checks are done in the front-end.
7089 -- However, in the case of specialized back-ends, notably the JVM
7090 -- backend for JGNAT, additional requirements and restrictions apply
7091 -- to unchecked conversion, and these are most conveniently performed
7092 -- in the specialized back-end.
7094 -- To accommodate this requirement, for such back ends, the following
7095 -- special node is generated recording an unchecked conversion that
7096 -- needs to be validated. The back end should post an appropriate
7097 -- error message if the unchecked conversion is invalid or warrants
7098 -- a special warning message.
7100 -- Source_Type and Target_Type point to the entities for the two
7101 -- types involved in the unchecked conversion instantiation that
7102 -- is to be validated.
7104 -- Sprint syntax: validate Unchecked_Conversion (source, target);
7106 -- N_Validate_Unchecked_Conversion
7107 -- Sloc points to instantiation (location for warning message)
7108 -- Source_Type (Node1-Sem)
7109 -- Target_Type (Node2-Sem)
7111 -- Note: in the case where a debug source file is generated, the Sloc
7112 -- for this node points to the VALIDATE keyword in the file output.
7114 -----------
7115 -- Empty --
7116 -----------
7118 -- Used as the contents of the Nkind field of the dummy Empty node
7119 -- and in some other situations to indicate an uninitialized value.
7121 -- N_Empty
7122 -- Chars (Name1) is set to No_Name
7124 -----------
7125 -- Error --
7126 -----------
7128 -- Used as the contents of the Nkind field of the dummy Error node.
7129 -- Has an Etype field, which gets set to Any_Type later on, to help
7130 -- error recovery (Error_Posted is also set in the Error node).
7132 -- N_Error
7133 -- Chars (Name1) is set to Error_Name
7134 -- Etype (Node5-Sem)
7136 --------------------------
7137 -- Node Type Definition --
7138 --------------------------
7140 -- The following is the definition of the Node_Kind type. As previously
7141 -- discussed, this is separated off to allow rearrangement of the order
7142 -- to facilitate definition of subtype ranges. The comments show the
7143 -- subtype classes which apply to each set of node kinds. The first
7144 -- entry in the comment characterizes the following list of nodes.
7146 type Node_Kind is (
7147 N_Unused_At_Start,
7149 -- N_Representation_Clause
7151 N_At_Clause,
7152 N_Component_Clause,
7153 N_Enumeration_Representation_Clause,
7154 N_Mod_Clause,
7155 N_Record_Representation_Clause,
7157 -- N_Representation_Clause, N_Has_Chars
7159 N_Attribute_Definition_Clause,
7161 -- N_Has_Chars
7163 N_Empty,
7164 N_Pragma_Argument_Association,
7166 -- N_Has_Etype
7168 N_Error,
7170 -- N_Entity, N_Has_Etype, N_Has_Chars
7172 N_Defining_Character_Literal,
7173 N_Defining_Identifier,
7174 N_Defining_Operator_Symbol,
7176 -- N_Subexpr, N_Has_Etype, N_Has_Chars, N_Has_Entity
7178 N_Expanded_Name,
7180 -- N_Direct_Name, N_Subexpr, N_Has_Etype,
7181 -- N_Has_Chars, N_Has_Entity
7183 N_Identifier,
7184 N_Operator_Symbol,
7186 -- N_Direct_Name, N_Subexpr, N_Has_Etype,
7187 -- N_Has_Chars, N_Has_Entity
7189 N_Character_Literal,
7191 -- N_Binary_Op, N_Op, N_Subexpr,
7192 -- N_Has_Etype, N_Has_Chars, N_Has_Entity
7194 N_Op_Add,
7195 N_Op_Concat,
7196 N_Op_Expon,
7197 N_Op_Subtract,
7199 -- N_Binary_Op, N_Op, N_Subexpr, N_Has_Treat_Fixed_As_Integer
7200 -- N_Has_Etype, N_Has_Chars, N_Has_Entity, N_Multiplying_Operator
7202 N_Op_Divide,
7203 N_Op_Mod,
7204 N_Op_Multiply,
7205 N_Op_Rem,
7207 -- N_Binary_Op, N_Op, N_Subexpr, N_Has_Etype
7208 -- N_Has_Entity, N_Has_Chars, N_Op_Boolean
7210 N_Op_And,
7212 -- N_Binary_Op, N_Op, N_Subexpr, N_Has_Etype
7213 -- N_Has_Entity, N_Has_Chars, N_Op_Boolean, N_Op_Compare
7215 N_Op_Eq,
7216 N_Op_Ge,
7217 N_Op_Gt,
7218 N_Op_Le,
7219 N_Op_Lt,
7220 N_Op_Ne,
7222 -- N_Binary_Op, N_Op, N_Subexpr, N_Has_Etype
7223 -- N_Has_Entity, N_Has_Chars, N_Op_Boolean
7225 N_Op_Or,
7226 N_Op_Xor,
7228 -- N_Binary_Op, N_Op, N_Subexpr, N_Has_Etype,
7229 -- N_Op_Shift, N_Has_Chars, N_Has_Entity
7231 N_Op_Rotate_Left,
7232 N_Op_Rotate_Right,
7233 N_Op_Shift_Left,
7234 N_Op_Shift_Right,
7235 N_Op_Shift_Right_Arithmetic,
7237 -- N_Unary_Op, N_Op, N_Subexpr, N_Has_Etype,
7238 -- N_Has_Chars, N_Has_Entity
7240 N_Op_Abs,
7241 N_Op_Minus,
7242 N_Op_Not,
7243 N_Op_Plus,
7245 -- N_Subexpr, N_Has_Etype, N_Has_Entity
7247 N_Attribute_Reference,
7249 -- N_Subexpr, N_Has_Etype, N_Membership_Test
7251 N_In,
7252 N_Not_In,
7254 -- N_Subexpr, N_Has_Etype, N_Short_Circuit
7256 N_And_Then,
7257 N_Or_Else,
7259 -- N_Subexpr, N_Has_Etype
7261 N_Conditional_Expression,
7262 N_Explicit_Dereference,
7263 N_Expression_With_Actions,
7264 N_Function_Call,
7265 N_Indexed_Component,
7266 N_Integer_Literal,
7267 N_Null,
7268 N_Procedure_Call_Statement,
7269 N_Qualified_Expression,
7271 -- N_Raise_xxx_Error, N_Subexpr, N_Has_Etype
7273 N_Raise_Constraint_Error,
7274 N_Raise_Program_Error,
7275 N_Raise_Storage_Error,
7277 -- N_Subexpr, N_Has_Etype
7279 N_Aggregate,
7280 N_Allocator,
7281 N_Case_Expression,
7282 N_Extension_Aggregate,
7283 N_Range,
7284 N_Real_Literal,
7285 N_Reference,
7286 N_Selected_Component,
7287 N_Slice,
7288 N_String_Literal,
7289 N_Subprogram_Info,
7290 N_Type_Conversion,
7291 N_Unchecked_Expression,
7292 N_Unchecked_Type_Conversion,
7294 -- N_Has_Etype
7296 N_Subtype_Indication,
7298 -- N_Declaration
7300 N_Component_Declaration,
7301 N_Entry_Declaration,
7302 N_Formal_Object_Declaration,
7303 N_Formal_Type_Declaration,
7304 N_Full_Type_Declaration,
7305 N_Incomplete_Type_Declaration,
7306 N_Loop_Parameter_Specification,
7307 N_Object_Declaration,
7308 N_Protected_Type_Declaration,
7309 N_Private_Extension_Declaration,
7310 N_Private_Type_Declaration,
7311 N_Subtype_Declaration,
7313 -- N_Subprogram_Specification, N_Declaration
7315 N_Function_Specification,
7316 N_Procedure_Specification,
7318 -- N_Access_To_Subprogram_Definition
7320 N_Access_Function_Definition,
7321 N_Access_Procedure_Definition,
7323 -- N_Later_Decl_Item
7325 N_Task_Type_Declaration,
7327 -- N_Body_Stub, N_Later_Decl_Item
7329 N_Package_Body_Stub,
7330 N_Protected_Body_Stub,
7331 N_Subprogram_Body_Stub,
7332 N_Task_Body_Stub,
7334 -- N_Generic_Instantiation, N_Later_Decl_Item
7335 -- N_Subprogram_Instantiation
7337 N_Function_Instantiation,
7338 N_Procedure_Instantiation,
7340 -- N_Generic_Instantiation, N_Later_Decl_Item
7342 N_Package_Instantiation,
7344 -- N_Unit_Body, N_Later_Decl_Item, N_Proper_Body
7346 N_Package_Body,
7347 N_Subprogram_Body,
7349 -- N_Later_Decl_Item, N_Proper_Body
7351 N_Protected_Body,
7352 N_Task_Body,
7354 -- N_Later_Decl_Item
7356 N_Implicit_Label_Declaration,
7357 N_Package_Declaration,
7358 N_Single_Task_Declaration,
7359 N_Subprogram_Declaration,
7360 N_Use_Package_Clause,
7362 -- N_Generic_Declaration, N_Later_Decl_Item
7364 N_Generic_Package_Declaration,
7365 N_Generic_Subprogram_Declaration,
7367 -- N_Array_Type_Definition
7369 N_Constrained_Array_Definition,
7370 N_Unconstrained_Array_Definition,
7372 -- N_Renaming_Declaration
7374 N_Exception_Renaming_Declaration,
7375 N_Object_Renaming_Declaration,
7376 N_Package_Renaming_Declaration,
7377 N_Subprogram_Renaming_Declaration,
7379 -- N_Generic_Renaming_Declaration, N_Renaming_Declaration
7381 N_Generic_Function_Renaming_Declaration,
7382 N_Generic_Package_Renaming_Declaration,
7383 N_Generic_Procedure_Renaming_Declaration,
7385 -- N_Statement_Other_Than_Procedure_Call
7387 N_Abort_Statement,
7388 N_Accept_Statement,
7389 N_Assignment_Statement,
7390 N_Asynchronous_Select,
7391 N_Block_Statement,
7392 N_Case_Statement,
7393 N_Code_Statement,
7394 N_Conditional_Entry_Call,
7396 -- N_Statement_Other_Than_Procedure_Call. N_Delay_Statement
7398 N_Delay_Relative_Statement,
7399 N_Delay_Until_Statement,
7401 -- N_Statement_Other_Than_Procedure_Call
7403 N_Entry_Call_Statement,
7404 N_Free_Statement,
7405 N_Goto_Statement,
7406 N_Loop_Statement,
7407 N_Null_Statement,
7408 N_Raise_Statement,
7409 N_Requeue_Statement,
7410 N_Return_Statement, -- renamed as N_Simple_Return_Statement below
7411 N_Extended_Return_Statement,
7412 N_Selective_Accept,
7413 N_Timed_Entry_Call,
7415 -- N_Statement_Other_Than_Procedure_Call, N_Has_Condition
7417 N_Exit_Statement,
7418 N_If_Statement,
7420 -- N_Has_Condition
7422 N_Accept_Alternative,
7423 N_Delay_Alternative,
7424 N_Elsif_Part,
7425 N_Entry_Body_Formal_Part,
7426 N_Iteration_Scheme,
7427 N_Terminate_Alternative,
7429 -- N_Formal_Subprogram_Declaration
7431 N_Formal_Abstract_Subprogram_Declaration,
7432 N_Formal_Concrete_Subprogram_Declaration,
7434 -- N_Push_xxx_Label, N_Push_Pop_xxx_Label
7436 N_Push_Constraint_Error_Label,
7437 N_Push_Program_Error_Label,
7438 N_Push_Storage_Error_Label,
7440 -- N_Pop_xxx_Label, N_Push_Pop_xxx_Label
7442 N_Pop_Constraint_Error_Label,
7443 N_Pop_Program_Error_Label,
7444 N_Pop_Storage_Error_Label,
7446 -- SCIL nodes
7448 N_SCIL_Dispatch_Table_Tag_Init,
7449 N_SCIL_Dispatching_Call,
7450 N_SCIL_Membership_Test,
7452 -- Other nodes (not part of any subtype class)
7454 N_Abortable_Part,
7455 N_Abstract_Subprogram_Declaration,
7456 N_Access_Definition,
7457 N_Access_To_Object_Definition,
7458 N_Case_Expression_Alternative,
7459 N_Case_Statement_Alternative,
7460 N_Compilation_Unit,
7461 N_Compilation_Unit_Aux,
7462 N_Component_Association,
7463 N_Component_Definition,
7464 N_Component_List,
7465 N_Derived_Type_Definition,
7466 N_Decimal_Fixed_Point_Definition,
7467 N_Defining_Program_Unit_Name,
7468 N_Delta_Constraint,
7469 N_Designator,
7470 N_Digits_Constraint,
7471 N_Discriminant_Association,
7472 N_Discriminant_Specification,
7473 N_Enumeration_Type_Definition,
7474 N_Entry_Body,
7475 N_Entry_Call_Alternative,
7476 N_Entry_Index_Specification,
7477 N_Exception_Declaration,
7478 N_Exception_Handler,
7479 N_Floating_Point_Definition,
7480 N_Formal_Decimal_Fixed_Point_Definition,
7481 N_Formal_Derived_Type_Definition,
7482 N_Formal_Discrete_Type_Definition,
7483 N_Formal_Floating_Point_Definition,
7484 N_Formal_Modular_Type_Definition,
7485 N_Formal_Ordinary_Fixed_Point_Definition,
7486 N_Formal_Package_Declaration,
7487 N_Formal_Private_Type_Definition,
7488 N_Formal_Signed_Integer_Type_Definition,
7489 N_Freeze_Entity,
7490 N_Generic_Association,
7491 N_Handled_Sequence_Of_Statements,
7492 N_Index_Or_Discriminant_Constraint,
7493 N_Itype_Reference,
7494 N_Label,
7495 N_Modular_Type_Definition,
7496 N_Number_Declaration,
7497 N_Ordinary_Fixed_Point_Definition,
7498 N_Others_Choice,
7499 N_Package_Specification,
7500 N_Parameter_Association,
7501 N_Parameter_Specification,
7502 N_Pragma,
7503 N_Protected_Definition,
7504 N_Range_Constraint,
7505 N_Real_Range_Specification,
7506 N_Record_Definition,
7507 N_Signed_Integer_Type_Definition,
7508 N_Single_Protected_Declaration,
7509 N_Subunit,
7510 N_Task_Definition,
7511 N_Triggering_Alternative,
7512 N_Use_Type_Clause,
7513 N_Validate_Unchecked_Conversion,
7514 N_Variant,
7515 N_Variant_Part,
7516 N_With_Clause,
7517 N_Unused_At_End);
7519 for Node_Kind'Size use 8;
7520 -- The data structures in Atree assume this!
7522 ----------------------------
7523 -- Node Class Definitions --
7524 ----------------------------
7526 subtype N_Access_To_Subprogram_Definition is Node_Kind range
7527 N_Access_Function_Definition ..
7528 N_Access_Procedure_Definition;
7530 subtype N_Array_Type_Definition is Node_Kind range
7531 N_Constrained_Array_Definition ..
7532 N_Unconstrained_Array_Definition;
7534 subtype N_Binary_Op is Node_Kind range
7535 N_Op_Add ..
7536 N_Op_Shift_Right_Arithmetic;
7538 subtype N_Body_Stub is Node_Kind range
7539 N_Package_Body_Stub ..
7540 N_Task_Body_Stub;
7542 subtype N_Declaration is Node_Kind range
7543 N_Component_Declaration ..
7544 N_Procedure_Specification;
7545 -- Note: this includes all constructs normally thought of as declarations
7546 -- except those which are separately grouped as later declarations.
7548 subtype N_Delay_Statement is Node_Kind range
7549 N_Delay_Relative_Statement ..
7550 N_Delay_Until_Statement;
7552 subtype N_Direct_Name is Node_Kind range
7553 N_Identifier ..
7554 N_Character_Literal;
7556 subtype N_Entity is Node_Kind range
7557 N_Defining_Character_Literal ..
7558 N_Defining_Operator_Symbol;
7560 subtype N_Formal_Subprogram_Declaration is Node_Kind range
7561 N_Formal_Abstract_Subprogram_Declaration ..
7562 N_Formal_Concrete_Subprogram_Declaration;
7564 subtype N_Generic_Declaration is Node_Kind range
7565 N_Generic_Package_Declaration ..
7566 N_Generic_Subprogram_Declaration;
7568 subtype N_Generic_Instantiation is Node_Kind range
7569 N_Function_Instantiation ..
7570 N_Package_Instantiation;
7572 subtype N_Generic_Renaming_Declaration is Node_Kind range
7573 N_Generic_Function_Renaming_Declaration ..
7574 N_Generic_Procedure_Renaming_Declaration;
7576 subtype N_Has_Chars is Node_Kind range
7577 N_Attribute_Definition_Clause ..
7578 N_Op_Plus;
7580 subtype N_Has_Entity is Node_Kind range
7581 N_Expanded_Name ..
7582 N_Attribute_Reference;
7583 -- Nodes that have Entity fields
7584 -- Warning: DOES NOT INCLUDE N_Freeze_Entity!
7586 subtype N_Has_Etype is Node_Kind range
7587 N_Error ..
7588 N_Subtype_Indication;
7590 subtype N_Has_Treat_Fixed_As_Integer is Node_Kind range
7591 N_Op_Divide ..
7592 N_Op_Rem;
7594 subtype N_Multiplying_Operator is Node_Kind range
7595 N_Op_Divide ..
7596 N_Op_Rem;
7598 subtype N_Later_Decl_Item is Node_Kind range
7599 N_Task_Type_Declaration ..
7600 N_Generic_Subprogram_Declaration;
7601 -- Note: this is Ada 83 relevant only (see Ada 83 RM 3.9 (2)) and includes
7602 -- only those items which can appear as later declarative items. This also
7603 -- includes N_Implicit_Label_Declaration which is not specifically in the
7604 -- grammar but may appear as a valid later declarative items. It does NOT
7605 -- include N_Pragma which can also appear among later declarative items.
7606 -- It does however include N_Protected_Body, which is a bit peculiar, but
7607 -- harmless since this cannot appear in Ada 83 mode anyway.
7609 subtype N_Membership_Test is Node_Kind range
7610 N_In ..
7611 N_Not_In;
7613 subtype N_Op is Node_Kind range
7614 N_Op_Add ..
7615 N_Op_Plus;
7617 subtype N_Op_Boolean is Node_Kind range
7618 N_Op_And ..
7619 N_Op_Xor;
7620 -- Binary operators which take operands of a boolean type, and yield
7621 -- a result of a boolean type.
7623 subtype N_Op_Compare is Node_Kind range
7624 N_Op_Eq ..
7625 N_Op_Ne;
7627 subtype N_Op_Shift is Node_Kind range
7628 N_Op_Rotate_Left ..
7629 N_Op_Shift_Right_Arithmetic;
7631 subtype N_Proper_Body is Node_Kind range
7632 N_Package_Body ..
7633 N_Task_Body;
7635 subtype N_Push_xxx_Label is Node_Kind range
7636 N_Push_Constraint_Error_Label ..
7637 N_Push_Storage_Error_Label;
7639 subtype N_Pop_xxx_Label is Node_Kind range
7640 N_Pop_Constraint_Error_Label ..
7641 N_Pop_Storage_Error_Label;
7643 subtype N_Push_Pop_xxx_Label is Node_Kind range
7644 N_Push_Constraint_Error_Label ..
7645 N_Pop_Storage_Error_Label;
7647 subtype N_Raise_xxx_Error is Node_Kind range
7648 N_Raise_Constraint_Error ..
7649 N_Raise_Storage_Error;
7651 subtype N_Renaming_Declaration is Node_Kind range
7652 N_Exception_Renaming_Declaration ..
7653 N_Generic_Procedure_Renaming_Declaration;
7655 subtype N_Representation_Clause is Node_Kind range
7656 N_At_Clause ..
7657 N_Attribute_Definition_Clause;
7659 subtype N_Short_Circuit is Node_Kind range
7660 N_And_Then ..
7661 N_Or_Else;
7663 subtype N_SCIL_Node is Node_Kind range
7664 N_SCIL_Dispatch_Table_Tag_Init ..
7665 N_SCIL_Membership_Test;
7667 subtype N_Statement_Other_Than_Procedure_Call is Node_Kind range
7668 N_Abort_Statement ..
7669 N_If_Statement;
7670 -- Note that this includes all statement types except for the cases of the
7671 -- N_Procedure_Call_Statement which is considered to be a subexpression
7672 -- (since overloading is possible, so it needs to go through the normal
7673 -- overloading resolution for expressions).
7675 subtype N_Subprogram_Instantiation is Node_Kind range
7676 N_Function_Instantiation ..
7677 N_Procedure_Instantiation;
7679 subtype N_Has_Condition is Node_Kind range
7680 N_Exit_Statement ..
7681 N_Terminate_Alternative;
7682 -- Nodes with condition fields (does not include N_Raise_xxx_Error)
7684 subtype N_Subexpr is Node_Kind range
7685 N_Expanded_Name ..
7686 N_Unchecked_Type_Conversion;
7687 -- Nodes with expression fields
7689 subtype N_Subprogram_Specification is Node_Kind range
7690 N_Function_Specification ..
7691 N_Procedure_Specification;
7693 subtype N_Unary_Op is Node_Kind range
7694 N_Op_Abs ..
7695 N_Op_Plus;
7697 subtype N_Unit_Body is Node_Kind range
7698 N_Package_Body ..
7699 N_Subprogram_Body;
7701 ---------------------------
7702 -- Node Access Functions --
7703 ---------------------------
7705 -- The following functions return the contents of the indicated field of
7706 -- the node referenced by the argument, which is a Node_Id. They provide
7707 -- logical access to fields in the node which could be accessed using the
7708 -- Atree.Unchecked_Access package, but the idea is always to use these
7709 -- higher level routines which preserve strong typing. In debug mode,
7710 -- these routines check that they are being applied to an appropriate
7711 -- node, as well as checking that the node is in range.
7713 function ABE_Is_Certain
7714 (N : Node_Id) return Boolean; -- Flag18
7716 function Abort_Present
7717 (N : Node_Id) return Boolean; -- Flag15
7719 function Abortable_Part
7720 (N : Node_Id) return Node_Id; -- Node2
7722 function Abstract_Present
7723 (N : Node_Id) return Boolean; -- Flag4
7725 function Accept_Handler_Records
7726 (N : Node_Id) return List_Id; -- List5
7728 function Accept_Statement
7729 (N : Node_Id) return Node_Id; -- Node2
7731 function Access_Definition
7732 (N : Node_Id) return Node_Id; -- Node3
7734 function Access_To_Subprogram_Definition
7735 (N : Node_Id) return Node_Id; -- Node3
7737 function Access_Types_To_Process
7738 (N : Node_Id) return Elist_Id; -- Elist2
7740 function Actions
7741 (N : Node_Id) return List_Id; -- List1
7743 function Activation_Chain_Entity
7744 (N : Node_Id) return Node_Id; -- Node3
7746 function Acts_As_Spec
7747 (N : Node_Id) return Boolean; -- Flag4
7749 function Actual_Designated_Subtype
7750 (N : Node_Id) return Node_Id; -- Node4
7752 function Address_Warning_Posted
7753 (N : Node_Id) return Boolean; -- Flag18
7755 function Aggregate_Bounds
7756 (N : Node_Id) return Node_Id; -- Node3
7758 function Aliased_Present
7759 (N : Node_Id) return Boolean; -- Flag4
7761 function All_Others
7762 (N : Node_Id) return Boolean; -- Flag11
7764 function All_Present
7765 (N : Node_Id) return Boolean; -- Flag15
7767 function Alternatives
7768 (N : Node_Id) return List_Id; -- List4
7770 function Ancestor_Part
7771 (N : Node_Id) return Node_Id; -- Node3
7773 function Array_Aggregate
7774 (N : Node_Id) return Node_Id; -- Node3
7776 function Assignment_OK
7777 (N : Node_Id) return Boolean; -- Flag15
7779 function Associated_Node
7780 (N : Node_Id) return Node_Id; -- Node4
7782 function At_End_Proc
7783 (N : Node_Id) return Node_Id; -- Node1
7785 function Attribute_Name
7786 (N : Node_Id) return Name_Id; -- Name2
7788 function Aux_Decls_Node
7789 (N : Node_Id) return Node_Id; -- Node5
7791 function Backwards_OK
7792 (N : Node_Id) return Boolean; -- Flag6
7794 function Bad_Is_Detected
7795 (N : Node_Id) return Boolean; -- Flag15
7797 function By_Ref
7798 (N : Node_Id) return Boolean; -- Flag5
7800 function Body_Required
7801 (N : Node_Id) return Boolean; -- Flag13
7803 function Body_To_Inline
7804 (N : Node_Id) return Node_Id; -- Node3
7806 function Box_Present
7807 (N : Node_Id) return Boolean; -- Flag15
7809 function Char_Literal_Value
7810 (N : Node_Id) return Uint; -- Uint2
7812 function Chars
7813 (N : Node_Id) return Name_Id; -- Name1
7815 function Check_Address_Alignment
7816 (N : Node_Id) return Boolean; -- Flag11
7818 function Choice_Parameter
7819 (N : Node_Id) return Node_Id; -- Node2
7821 function Choices
7822 (N : Node_Id) return List_Id; -- List1
7824 function Coextensions
7825 (N : Node_Id) return Elist_Id; -- Elist4
7827 function Comes_From_Extended_Return_Statement
7828 (N : Node_Id) return Boolean; -- Flag18
7830 function Compile_Time_Known_Aggregate
7831 (N : Node_Id) return Boolean; -- Flag18
7833 function Component_Associations
7834 (N : Node_Id) return List_Id; -- List2
7836 function Component_Clauses
7837 (N : Node_Id) return List_Id; -- List3
7839 function Component_Definition
7840 (N : Node_Id) return Node_Id; -- Node4
7842 function Component_Items
7843 (N : Node_Id) return List_Id; -- List3
7845 function Component_List
7846 (N : Node_Id) return Node_Id; -- Node1
7848 function Component_Name
7849 (N : Node_Id) return Node_Id; -- Node1
7851 function Componentwise_Assignment
7852 (N : Node_Id) return Boolean; -- Flag14
7854 function Condition
7855 (N : Node_Id) return Node_Id; -- Node1
7857 function Condition_Actions
7858 (N : Node_Id) return List_Id; -- List3
7860 function Config_Pragmas
7861 (N : Node_Id) return List_Id; -- List4
7863 function Constant_Present
7864 (N : Node_Id) return Boolean; -- Flag17
7866 function Constraint
7867 (N : Node_Id) return Node_Id; -- Node3
7869 function Constraints
7870 (N : Node_Id) return List_Id; -- List1
7872 function Context_Installed
7873 (N : Node_Id) return Boolean; -- Flag13
7875 function Context_Pending
7876 (N : Node_Id) return Boolean; -- Flag16
7878 function Context_Items
7879 (N : Node_Id) return List_Id; -- List1
7881 function Controlling_Argument
7882 (N : Node_Id) return Node_Id; -- Node1
7884 function Conversion_OK
7885 (N : Node_Id) return Boolean; -- Flag14
7887 function Corresponding_Body
7888 (N : Node_Id) return Node_Id; -- Node5
7890 function Corresponding_Formal_Spec
7891 (N : Node_Id) return Node_Id; -- Node3
7893 function Corresponding_Generic_Association
7894 (N : Node_Id) return Node_Id; -- Node5
7896 function Corresponding_Integer_Value
7897 (N : Node_Id) return Uint; -- Uint4
7899 function Corresponding_Spec
7900 (N : Node_Id) return Node_Id; -- Node5
7902 function Corresponding_Stub
7903 (N : Node_Id) return Node_Id; -- Node3
7905 function Dcheck_Function
7906 (N : Node_Id) return Entity_Id; -- Node5
7908 function Debug_Statement
7909 (N : Node_Id) return Node_Id; -- Node3
7911 function Declarations
7912 (N : Node_Id) return List_Id; -- List2
7914 function Default_Expression
7915 (N : Node_Id) return Node_Id; -- Node5
7917 function Default_Name
7918 (N : Node_Id) return Node_Id; -- Node2
7920 function Defining_Identifier
7921 (N : Node_Id) return Entity_Id; -- Node1
7923 function Defining_Unit_Name
7924 (N : Node_Id) return Node_Id; -- Node1
7926 function Delay_Alternative
7927 (N : Node_Id) return Node_Id; -- Node4
7929 function Delay_Statement
7930 (N : Node_Id) return Node_Id; -- Node2
7932 function Delta_Expression
7933 (N : Node_Id) return Node_Id; -- Node3
7935 function Digits_Expression
7936 (N : Node_Id) return Node_Id; -- Node2
7938 function Discr_Check_Funcs_Built
7939 (N : Node_Id) return Boolean; -- Flag11
7941 function Discrete_Choices
7942 (N : Node_Id) return List_Id; -- List4
7944 function Discrete_Range
7945 (N : Node_Id) return Node_Id; -- Node4
7947 function Discrete_Subtype_Definition
7948 (N : Node_Id) return Node_Id; -- Node4
7950 function Discrete_Subtype_Definitions
7951 (N : Node_Id) return List_Id; -- List2
7953 function Discriminant_Specifications
7954 (N : Node_Id) return List_Id; -- List4
7956 function Discriminant_Type
7957 (N : Node_Id) return Node_Id; -- Node5
7959 function Do_Accessibility_Check
7960 (N : Node_Id) return Boolean; -- Flag13
7962 function Do_Discriminant_Check
7963 (N : Node_Id) return Boolean; -- Flag13
7965 function Do_Division_Check
7966 (N : Node_Id) return Boolean; -- Flag13
7968 function Do_Length_Check
7969 (N : Node_Id) return Boolean; -- Flag4
7971 function Do_Overflow_Check
7972 (N : Node_Id) return Boolean; -- Flag17
7974 function Do_Range_Check
7975 (N : Node_Id) return Boolean; -- Flag9
7977 function Do_Storage_Check
7978 (N : Node_Id) return Boolean; -- Flag17
7980 function Do_Tag_Check
7981 (N : Node_Id) return Boolean; -- Flag13
7983 function Elaborate_All_Desirable
7984 (N : Node_Id) return Boolean; -- Flag9
7986 function Elaborate_All_Present
7987 (N : Node_Id) return Boolean; -- Flag14
7989 function Elaborate_Desirable
7990 (N : Node_Id) return Boolean; -- Flag11
7992 function Elaborate_Present
7993 (N : Node_Id) return Boolean; -- Flag4
7995 function Elaboration_Boolean
7996 (N : Node_Id) return Node_Id; -- Node2
7998 function Else_Actions
7999 (N : Node_Id) return List_Id; -- List3
8001 function Else_Statements
8002 (N : Node_Id) return List_Id; -- List4
8004 function Elsif_Parts
8005 (N : Node_Id) return List_Id; -- List3
8007 function Enclosing_Variant
8008 (N : Node_Id) return Node_Id; -- Node2
8010 function End_Label
8011 (N : Node_Id) return Node_Id; -- Node4
8013 function End_Span
8014 (N : Node_Id) return Uint; -- Uint5
8016 function Entity
8017 (N : Node_Id) return Node_Id; -- Node4
8019 function Entity_Or_Associated_Node
8020 (N : Node_Id) return Node_Id; -- Node4
8022 function Entry_Body_Formal_Part
8023 (N : Node_Id) return Node_Id; -- Node5
8025 function Entry_Call_Alternative
8026 (N : Node_Id) return Node_Id; -- Node1
8028 function Entry_Call_Statement
8029 (N : Node_Id) return Node_Id; -- Node1
8031 function Entry_Direct_Name
8032 (N : Node_Id) return Node_Id; -- Node1
8034 function Entry_Index
8035 (N : Node_Id) return Node_Id; -- Node5
8037 function Entry_Index_Specification
8038 (N : Node_Id) return Node_Id; -- Node4
8040 function Etype
8041 (N : Node_Id) return Node_Id; -- Node5
8043 function Exception_Choices
8044 (N : Node_Id) return List_Id; -- List4
8046 function Exception_Handlers
8047 (N : Node_Id) return List_Id; -- List5
8049 function Exception_Junk
8050 (N : Node_Id) return Boolean; -- Flag8
8052 function Exception_Label
8053 (N : Node_Id) return Node_Id; -- Node5
8055 function Explicit_Actual_Parameter
8056 (N : Node_Id) return Node_Id; -- Node3
8058 function Expansion_Delayed
8059 (N : Node_Id) return Boolean; -- Flag11
8061 function Explicit_Generic_Actual_Parameter
8062 (N : Node_Id) return Node_Id; -- Node1
8064 function Expression
8065 (N : Node_Id) return Node_Id; -- Node3
8067 function Expressions
8068 (N : Node_Id) return List_Id; -- List1
8070 function First_Bit
8071 (N : Node_Id) return Node_Id; -- Node3
8073 function First_Inlined_Subprogram
8074 (N : Node_Id) return Entity_Id; -- Node3
8076 function First_Name
8077 (N : Node_Id) return Boolean; -- Flag5
8079 function First_Named_Actual
8080 (N : Node_Id) return Node_Id; -- Node4
8082 function First_Real_Statement
8083 (N : Node_Id) return Node_Id; -- Node2
8085 function First_Subtype_Link
8086 (N : Node_Id) return Entity_Id; -- Node5
8088 function Float_Truncate
8089 (N : Node_Id) return Boolean; -- Flag11
8091 function Formal_Type_Definition
8092 (N : Node_Id) return Node_Id; -- Node3
8094 function Forwards_OK
8095 (N : Node_Id) return Boolean; -- Flag5
8097 function From_At_End
8098 (N : Node_Id) return Boolean; -- Flag4
8100 function From_At_Mod
8101 (N : Node_Id) return Boolean; -- Flag4
8103 function From_Default
8104 (N : Node_Id) return Boolean; -- Flag6
8106 function Generic_Associations
8107 (N : Node_Id) return List_Id; -- List3
8109 function Generic_Formal_Declarations
8110 (N : Node_Id) return List_Id; -- List2
8112 function Generic_Parent
8113 (N : Node_Id) return Node_Id; -- Node5
8115 function Generic_Parent_Type
8116 (N : Node_Id) return Node_Id; -- Node4
8118 function Handled_Statement_Sequence
8119 (N : Node_Id) return Node_Id; -- Node4
8121 function Handler_List_Entry
8122 (N : Node_Id) return Node_Id; -- Node2
8124 function Has_Created_Identifier
8125 (N : Node_Id) return Boolean; -- Flag15
8127 function Has_Dynamic_Length_Check
8128 (N : Node_Id) return Boolean; -- Flag10
8130 function Has_Dynamic_Range_Check
8131 (N : Node_Id) return Boolean; -- Flag12
8133 function Has_Init_Expression
8134 (N : Node_Id) return Boolean; -- Flag14
8136 function Has_Local_Raise
8137 (N : Node_Id) return Boolean; -- Flag8
8139 function Has_No_Elaboration_Code
8140 (N : Node_Id) return Boolean; -- Flag17
8142 function Has_Priority_Pragma
8143 (N : Node_Id) return Boolean; -- Flag6
8145 function Has_Private_View
8146 (N : Node_Id) return Boolean; -- Flag11
8148 function Has_Relative_Deadline_Pragma
8149 (N : Node_Id) return Boolean; -- Flag9
8151 function Has_Self_Reference
8152 (N : Node_Id) return Boolean; -- Flag13
8154 function Has_Storage_Size_Pragma
8155 (N : Node_Id) return Boolean; -- Flag5
8157 function Has_Task_Info_Pragma
8158 (N : Node_Id) return Boolean; -- Flag7
8160 function Has_Task_Name_Pragma
8161 (N : Node_Id) return Boolean; -- Flag8
8163 function Has_Wide_Character
8164 (N : Node_Id) return Boolean; -- Flag11
8166 function Has_Wide_Wide_Character
8167 (N : Node_Id) return Boolean; -- Flag13
8169 function Hidden_By_Use_Clause
8170 (N : Node_Id) return Elist_Id; -- Elist4
8172 function High_Bound
8173 (N : Node_Id) return Node_Id; -- Node2
8175 function Identifier
8176 (N : Node_Id) return Node_Id; -- Node1
8178 function Interface_List
8179 (N : Node_Id) return List_Id; -- List2
8181 function Interface_Present
8182 (N : Node_Id) return Boolean; -- Flag16
8184 function Implicit_With
8185 (N : Node_Id) return Boolean; -- Flag16
8187 function Import_Interface_Present
8188 (N : Node_Id) return Boolean; -- Flag16
8190 function In_Present
8191 (N : Node_Id) return Boolean; -- Flag15
8193 function Includes_Infinities
8194 (N : Node_Id) return Boolean; -- Flag11
8196 function Inherited_Discriminant
8197 (N : Node_Id) return Boolean; -- Flag13
8199 function Instance_Spec
8200 (N : Node_Id) return Node_Id; -- Node5
8202 function Intval
8203 (N : Node_Id) return Uint; -- Uint3
8205 function Is_Accessibility_Actual
8206 (N : Node_Id) return Boolean; -- Flag13
8208 function Is_Asynchronous_Call_Block
8209 (N : Node_Id) return Boolean; -- Flag7
8211 function Is_Component_Left_Opnd
8212 (N : Node_Id) return Boolean; -- Flag13
8214 function Is_Component_Right_Opnd
8215 (N : Node_Id) return Boolean; -- Flag14
8217 function Is_Controlling_Actual
8218 (N : Node_Id) return Boolean; -- Flag16
8220 function Is_Dynamic_Coextension
8221 (N : Node_Id) return Boolean; -- Flag18
8223 function Is_Elsif
8224 (N : Node_Id) return Boolean; -- Flag13
8226 function Is_Entry_Barrier_Function
8227 (N : Node_Id) return Boolean; -- Flag8
8229 function Is_Expanded_Build_In_Place_Call
8230 (N : Node_Id) return Boolean; -- Flag11
8232 function Is_Folded_In_Parser
8233 (N : Node_Id) return Boolean; -- Flag4
8235 function Is_In_Discriminant_Check
8236 (N : Node_Id) return Boolean; -- Flag11
8238 function Is_Machine_Number
8239 (N : Node_Id) return Boolean; -- Flag11
8241 function Is_Null_Loop
8242 (N : Node_Id) return Boolean; -- Flag16
8244 function Is_Overloaded
8245 (N : Node_Id) return Boolean; -- Flag5
8247 function Is_Power_Of_2_For_Shift
8248 (N : Node_Id) return Boolean; -- Flag13
8250 function Is_Protected_Subprogram_Body
8251 (N : Node_Id) return Boolean; -- Flag7
8253 function Is_Static_Coextension
8254 (N : Node_Id) return Boolean; -- Flag14
8256 function Is_Static_Expression
8257 (N : Node_Id) return Boolean; -- Flag6
8259 function Is_Subprogram_Descriptor
8260 (N : Node_Id) return Boolean; -- Flag16
8262 function Is_Task_Allocation_Block
8263 (N : Node_Id) return Boolean; -- Flag6
8265 function Is_Task_Master
8266 (N : Node_Id) return Boolean; -- Flag5
8268 function Iteration_Scheme
8269 (N : Node_Id) return Node_Id; -- Node2
8271 function Itype
8272 (N : Node_Id) return Entity_Id; -- Node1
8274 function Kill_Range_Check
8275 (N : Node_Id) return Boolean; -- Flag11
8277 function Label_Construct
8278 (N : Node_Id) return Node_Id; -- Node2
8280 function Left_Opnd
8281 (N : Node_Id) return Node_Id; -- Node2
8283 function Last_Bit
8284 (N : Node_Id) return Node_Id; -- Node4
8286 function Last_Name
8287 (N : Node_Id) return Boolean; -- Flag6
8289 function Library_Unit
8290 (N : Node_Id) return Node_Id; -- Node4
8292 function Limited_View_Installed
8293 (N : Node_Id) return Boolean; -- Flag18
8295 function Limited_Present
8296 (N : Node_Id) return Boolean; -- Flag17
8298 function Literals
8299 (N : Node_Id) return List_Id; -- List1
8301 function Local_Raise_Not_OK
8302 (N : Node_Id) return Boolean; -- Flag7
8304 function Local_Raise_Statements
8305 (N : Node_Id) return Elist_Id; -- Elist1
8307 function Loop_Actions
8308 (N : Node_Id) return List_Id; -- List2
8310 function Loop_Parameter_Specification
8311 (N : Node_Id) return Node_Id; -- Node4
8313 function Low_Bound
8314 (N : Node_Id) return Node_Id; -- Node1
8316 function Mod_Clause
8317 (N : Node_Id) return Node_Id; -- Node2
8319 function More_Ids
8320 (N : Node_Id) return Boolean; -- Flag5
8322 function Must_Be_Byte_Aligned
8323 (N : Node_Id) return Boolean; -- Flag14
8325 function Must_Not_Freeze
8326 (N : Node_Id) return Boolean; -- Flag8
8328 function Must_Not_Override
8329 (N : Node_Id) return Boolean; -- Flag15
8331 function Must_Override
8332 (N : Node_Id) return Boolean; -- Flag14
8334 function Name
8335 (N : Node_Id) return Node_Id; -- Node2
8337 function Names
8338 (N : Node_Id) return List_Id; -- List2
8340 function Next_Entity
8341 (N : Node_Id) return Node_Id; -- Node2
8343 function Next_Exit_Statement
8344 (N : Node_Id) return Node_Id; -- Node3
8346 function Next_Implicit_With
8347 (N : Node_Id) return Node_Id; -- Node3
8349 function Next_Named_Actual
8350 (N : Node_Id) return Node_Id; -- Node4
8352 function Next_Pragma
8353 (N : Node_Id) return Node_Id; -- Node1
8355 function Next_Rep_Item
8356 (N : Node_Id) return Node_Id; -- Node5
8358 function Next_Use_Clause
8359 (N : Node_Id) return Node_Id; -- Node3
8361 function No_Ctrl_Actions
8362 (N : Node_Id) return Boolean; -- Flag7
8364 function No_Elaboration_Check
8365 (N : Node_Id) return Boolean; -- Flag14
8367 function No_Entities_Ref_In_Spec
8368 (N : Node_Id) return Boolean; -- Flag8
8370 function No_Initialization
8371 (N : Node_Id) return Boolean; -- Flag13
8373 function No_Truncation
8374 (N : Node_Id) return Boolean; -- Flag17
8376 function Null_Present
8377 (N : Node_Id) return Boolean; -- Flag13
8379 function Null_Exclusion_Present
8380 (N : Node_Id) return Boolean; -- Flag11
8382 function Null_Exclusion_In_Return_Present
8383 (N : Node_Id) return Boolean; -- Flag14
8385 function Null_Record_Present
8386 (N : Node_Id) return Boolean; -- Flag17
8388 function Object_Definition
8389 (N : Node_Id) return Node_Id; -- Node4
8391 function Original_Discriminant
8392 (N : Node_Id) return Node_Id; -- Node2
8394 function Original_Entity
8395 (N : Node_Id) return Entity_Id; -- Node2
8397 function Others_Discrete_Choices
8398 (N : Node_Id) return List_Id; -- List1
8400 function Out_Present
8401 (N : Node_Id) return Boolean; -- Flag17
8403 function Parameter_Associations
8404 (N : Node_Id) return List_Id; -- List3
8406 function Parameter_List_Truncated
8407 (N : Node_Id) return Boolean; -- Flag17
8409 function Parameter_Specifications
8410 (N : Node_Id) return List_Id; -- List3
8412 function Parameter_Type
8413 (N : Node_Id) return Node_Id; -- Node2
8415 function Parent_Spec
8416 (N : Node_Id) return Node_Id; -- Node4
8418 function Position
8419 (N : Node_Id) return Node_Id; -- Node2
8421 function Pragma_Argument_Associations
8422 (N : Node_Id) return List_Id; -- List2
8424 function Pragma_Enabled
8425 (N : Node_Id) return Boolean; -- Flag5
8427 function Pragma_Identifier
8428 (N : Node_Id) return Node_Id; -- Node4
8430 function Pragmas_After
8431 (N : Node_Id) return List_Id; -- List5
8433 function Pragmas_Before
8434 (N : Node_Id) return List_Id; -- List4
8436 function Prefix
8437 (N : Node_Id) return Node_Id; -- Node3
8439 function Present_Expr
8440 (N : Node_Id) return Uint; -- Uint3
8442 function Prev_Ids
8443 (N : Node_Id) return Boolean; -- Flag6
8445 function Print_In_Hex
8446 (N : Node_Id) return Boolean; -- Flag13
8448 function Private_Declarations
8449 (N : Node_Id) return List_Id; -- List3
8451 function Private_Present
8452 (N : Node_Id) return Boolean; -- Flag15
8454 function Procedure_To_Call
8455 (N : Node_Id) return Node_Id; -- Node2
8457 function Proper_Body
8458 (N : Node_Id) return Node_Id; -- Node1
8460 function Protected_Definition
8461 (N : Node_Id) return Node_Id; -- Node3
8463 function Protected_Present
8464 (N : Node_Id) return Boolean; -- Flag6
8466 function Raises_Constraint_Error
8467 (N : Node_Id) return Boolean; -- Flag7
8469 function Range_Constraint
8470 (N : Node_Id) return Node_Id; -- Node4
8472 function Range_Expression
8473 (N : Node_Id) return Node_Id; -- Node4
8475 function Real_Range_Specification
8476 (N : Node_Id) return Node_Id; -- Node4
8478 function Realval
8479 (N : Node_Id) return Ureal; -- Ureal3
8481 function Reason
8482 (N : Node_Id) return Uint; -- Uint3
8484 function Record_Extension_Part
8485 (N : Node_Id) return Node_Id; -- Node3
8487 function Redundant_Use
8488 (N : Node_Id) return Boolean; -- Flag13
8490 function Renaming_Exception
8491 (N : Node_Id) return Node_Id; -- Node2
8493 function Result_Definition
8494 (N : Node_Id) return Node_Id; -- Node4
8496 function Return_Object_Declarations
8497 (N : Node_Id) return List_Id; -- List3
8499 function Return_Statement_Entity
8500 (N : Node_Id) return Node_Id; -- Node5
8502 function Reverse_Present
8503 (N : Node_Id) return Boolean; -- Flag15
8505 function Right_Opnd
8506 (N : Node_Id) return Node_Id; -- Node3
8508 function Rounded_Result
8509 (N : Node_Id) return Boolean; -- Flag18
8511 function SCIL_Controlling_Tag
8512 (N : Node_Id) return Node_Id; -- Node5
8514 function SCIL_Entity
8515 (N : Node_Id) return Node_Id; -- Node4
8517 function SCIL_Tag_Value
8518 (N : Node_Id) return Node_Id; -- Node5
8520 function SCIL_Target_Prim
8521 (N : Node_Id) return Node_Id; -- Node2
8523 function Scope
8524 (N : Node_Id) return Node_Id; -- Node3
8526 function Select_Alternatives
8527 (N : Node_Id) return List_Id; -- List1
8529 function Selector_Name
8530 (N : Node_Id) return Node_Id; -- Node2
8532 function Selector_Names
8533 (N : Node_Id) return List_Id; -- List1
8535 function Shift_Count_OK
8536 (N : Node_Id) return Boolean; -- Flag4
8538 function Source_Type
8539 (N : Node_Id) return Entity_Id; -- Node1
8541 function Specification
8542 (N : Node_Id) return Node_Id; -- Node1
8544 function Statements
8545 (N : Node_Id) return List_Id; -- List3
8547 function Static_Processing_OK
8548 (N : Node_Id) return Boolean; -- Flag4
8550 function Storage_Pool
8551 (N : Node_Id) return Node_Id; -- Node1
8553 function Strval
8554 (N : Node_Id) return String_Id; -- Str3
8556 function Subtype_Indication
8557 (N : Node_Id) return Node_Id; -- Node5
8559 function Subtype_Mark
8560 (N : Node_Id) return Node_Id; -- Node4
8562 function Subtype_Marks
8563 (N : Node_Id) return List_Id; -- List2
8565 function Suppress_Loop_Warnings
8566 (N : Node_Id) return Boolean; -- Flag17
8568 function Synchronized_Present
8569 (N : Node_Id) return Boolean; -- Flag7
8571 function Tagged_Present
8572 (N : Node_Id) return Boolean; -- Flag15
8574 function Target_Type
8575 (N : Node_Id) return Entity_Id; -- Node2
8577 function Task_Definition
8578 (N : Node_Id) return Node_Id; -- Node3
8580 function Task_Present
8581 (N : Node_Id) return Boolean; -- Flag5
8583 function Then_Actions
8584 (N : Node_Id) return List_Id; -- List2
8586 function Then_Statements
8587 (N : Node_Id) return List_Id; -- List2
8589 function Treat_Fixed_As_Integer
8590 (N : Node_Id) return Boolean; -- Flag14
8592 function Triggering_Alternative
8593 (N : Node_Id) return Node_Id; -- Node1
8595 function Triggering_Statement
8596 (N : Node_Id) return Node_Id; -- Node1
8598 function TSS_Elist
8599 (N : Node_Id) return Elist_Id; -- Elist3
8601 function Type_Definition
8602 (N : Node_Id) return Node_Id; -- Node3
8604 function Unit
8605 (N : Node_Id) return Node_Id; -- Node2
8607 function Unknown_Discriminants_Present
8608 (N : Node_Id) return Boolean; -- Flag13
8610 function Unreferenced_In_Spec
8611 (N : Node_Id) return Boolean; -- Flag7
8613 function Variant_Part
8614 (N : Node_Id) return Node_Id; -- Node4
8616 function Variants
8617 (N : Node_Id) return List_Id; -- List1
8619 function Visible_Declarations
8620 (N : Node_Id) return List_Id; -- List2
8622 function Was_Originally_Stub
8623 (N : Node_Id) return Boolean; -- Flag13
8625 function Withed_Body
8626 (N : Node_Id) return Node_Id; -- Node1
8628 function Zero_Cost_Handling
8629 (N : Node_Id) return Boolean; -- Flag5
8631 -- End functions (note used by xsinfo utility program to end processing)
8633 ----------------------------
8634 -- Node Update Procedures --
8635 ----------------------------
8637 -- These are the corresponding node update routines, which again provide
8638 -- a high level logical access with type checking. In addition to setting
8639 -- the indicated field of the node N to the given Val, in the case of
8640 -- tree pointers (List1-4), the parent pointer of the Val node is set to
8641 -- point back to node N. This automates the setting of the parent pointer.
8643 procedure Set_ABE_Is_Certain
8644 (N : Node_Id; Val : Boolean := True); -- Flag18
8646 procedure Set_Abort_Present
8647 (N : Node_Id; Val : Boolean := True); -- Flag15
8649 procedure Set_Abortable_Part
8650 (N : Node_Id; Val : Node_Id); -- Node2
8652 procedure Set_Abstract_Present
8653 (N : Node_Id; Val : Boolean := True); -- Flag4
8655 procedure Set_Accept_Handler_Records
8656 (N : Node_Id; Val : List_Id); -- List5
8658 procedure Set_Accept_Statement
8659 (N : Node_Id; Val : Node_Id); -- Node2
8661 procedure Set_Access_Definition
8662 (N : Node_Id; Val : Node_Id); -- Node3
8664 procedure Set_Access_To_Subprogram_Definition
8665 (N : Node_Id; Val : Node_Id); -- Node3
8667 procedure Set_Access_Types_To_Process
8668 (N : Node_Id; Val : Elist_Id); -- Elist2
8670 procedure Set_Actions
8671 (N : Node_Id; Val : List_Id); -- List1
8673 procedure Set_Activation_Chain_Entity
8674 (N : Node_Id; Val : Node_Id); -- Node3
8676 procedure Set_Acts_As_Spec
8677 (N : Node_Id; Val : Boolean := True); -- Flag4
8679 procedure Set_Actual_Designated_Subtype
8680 (N : Node_Id; Val : Node_Id); -- Node4
8682 procedure Set_Address_Warning_Posted
8683 (N : Node_Id; Val : Boolean := True); -- Flag18
8685 procedure Set_Aggregate_Bounds
8686 (N : Node_Id; Val : Node_Id); -- Node3
8688 procedure Set_Aliased_Present
8689 (N : Node_Id; Val : Boolean := True); -- Flag4
8691 procedure Set_All_Others
8692 (N : Node_Id; Val : Boolean := True); -- Flag11
8694 procedure Set_All_Present
8695 (N : Node_Id; Val : Boolean := True); -- Flag15
8697 procedure Set_Alternatives
8698 (N : Node_Id; Val : List_Id); -- List4
8700 procedure Set_Ancestor_Part
8701 (N : Node_Id; Val : Node_Id); -- Node3
8703 procedure Set_Array_Aggregate
8704 (N : Node_Id; Val : Node_Id); -- Node3
8706 procedure Set_Assignment_OK
8707 (N : Node_Id; Val : Boolean := True); -- Flag15
8709 procedure Set_Associated_Node
8710 (N : Node_Id; Val : Node_Id); -- Node4
8712 procedure Set_Attribute_Name
8713 (N : Node_Id; Val : Name_Id); -- Name2
8715 procedure Set_At_End_Proc
8716 (N : Node_Id; Val : Node_Id); -- Node1
8718 procedure Set_Aux_Decls_Node
8719 (N : Node_Id; Val : Node_Id); -- Node5
8721 procedure Set_Backwards_OK
8722 (N : Node_Id; Val : Boolean := True); -- Flag6
8724 procedure Set_Bad_Is_Detected
8725 (N : Node_Id; Val : Boolean := True); -- Flag15
8727 procedure Set_Body_Required
8728 (N : Node_Id; Val : Boolean := True); -- Flag13
8730 procedure Set_Body_To_Inline
8731 (N : Node_Id; Val : Node_Id); -- Node3
8733 procedure Set_Box_Present
8734 (N : Node_Id; Val : Boolean := True); -- Flag15
8736 procedure Set_By_Ref
8737 (N : Node_Id; Val : Boolean := True); -- Flag5
8739 procedure Set_Char_Literal_Value
8740 (N : Node_Id; Val : Uint); -- Uint2
8742 procedure Set_Chars
8743 (N : Node_Id; Val : Name_Id); -- Name1
8745 procedure Set_Check_Address_Alignment
8746 (N : Node_Id; Val : Boolean := True); -- Flag11
8748 procedure Set_Choice_Parameter
8749 (N : Node_Id; Val : Node_Id); -- Node2
8751 procedure Set_Coextensions
8752 (N : Node_Id; Val : Elist_Id); -- Elist4
8754 procedure Set_Choices
8755 (N : Node_Id; Val : List_Id); -- List1
8757 procedure Set_Comes_From_Extended_Return_Statement
8758 (N : Node_Id; Val : Boolean := True); -- Flag18
8760 procedure Set_Compile_Time_Known_Aggregate
8761 (N : Node_Id; Val : Boolean := True); -- Flag18
8763 procedure Set_Component_Associations
8764 (N : Node_Id; Val : List_Id); -- List2
8766 procedure Set_Component_Clauses
8767 (N : Node_Id; Val : List_Id); -- List3
8769 procedure Set_Component_Definition
8770 (N : Node_Id; Val : Node_Id); -- Node4
8772 procedure Set_Component_Items
8773 (N : Node_Id; Val : List_Id); -- List3
8775 procedure Set_Component_List
8776 (N : Node_Id; Val : Node_Id); -- Node1
8778 procedure Set_Component_Name
8779 (N : Node_Id; Val : Node_Id); -- Node1
8781 procedure Set_Componentwise_Assignment
8782 (N : Node_Id; Val : Boolean := True); -- Flag14
8784 procedure Set_Condition
8785 (N : Node_Id; Val : Node_Id); -- Node1
8787 procedure Set_Condition_Actions
8788 (N : Node_Id; Val : List_Id); -- List3
8790 procedure Set_Config_Pragmas
8791 (N : Node_Id; Val : List_Id); -- List4
8793 procedure Set_Constant_Present
8794 (N : Node_Id; Val : Boolean := True); -- Flag17
8796 procedure Set_Constraint
8797 (N : Node_Id; Val : Node_Id); -- Node3
8799 procedure Set_Constraints
8800 (N : Node_Id; Val : List_Id); -- List1
8802 procedure Set_Context_Installed
8803 (N : Node_Id; Val : Boolean := True); -- Flag13
8805 procedure Set_Context_Items
8806 (N : Node_Id; Val : List_Id); -- List1
8808 procedure Set_Context_Pending
8809 (N : Node_Id; Val : Boolean := True); -- Flag16
8811 procedure Set_Controlling_Argument
8812 (N : Node_Id; Val : Node_Id); -- Node1
8814 procedure Set_Conversion_OK
8815 (N : Node_Id; Val : Boolean := True); -- Flag14
8817 procedure Set_Corresponding_Body
8818 (N : Node_Id; Val : Node_Id); -- Node5
8820 procedure Set_Corresponding_Formal_Spec
8821 (N : Node_Id; Val : Node_Id); -- Node3
8823 procedure Set_Corresponding_Generic_Association
8824 (N : Node_Id; Val : Node_Id); -- Node5
8826 procedure Set_Corresponding_Integer_Value
8827 (N : Node_Id; Val : Uint); -- Uint4
8829 procedure Set_Corresponding_Spec
8830 (N : Node_Id; Val : Node_Id); -- Node5
8832 procedure Set_Corresponding_Stub
8833 (N : Node_Id; Val : Node_Id); -- Node3
8835 procedure Set_Dcheck_Function
8836 (N : Node_Id; Val : Entity_Id); -- Node5
8838 procedure Set_Debug_Statement
8839 (N : Node_Id; Val : Node_Id); -- Node3
8841 procedure Set_Declarations
8842 (N : Node_Id; Val : List_Id); -- List2
8844 procedure Set_Default_Expression
8845 (N : Node_Id; Val : Node_Id); -- Node5
8847 procedure Set_Default_Name
8848 (N : Node_Id; Val : Node_Id); -- Node2
8850 procedure Set_Defining_Identifier
8851 (N : Node_Id; Val : Entity_Id); -- Node1
8853 procedure Set_Defining_Unit_Name
8854 (N : Node_Id; Val : Node_Id); -- Node1
8856 procedure Set_Delay_Alternative
8857 (N : Node_Id; Val : Node_Id); -- Node4
8859 procedure Set_Delay_Statement
8860 (N : Node_Id; Val : Node_Id); -- Node2
8862 procedure Set_Delta_Expression
8863 (N : Node_Id; Val : Node_Id); -- Node3
8865 procedure Set_Digits_Expression
8866 (N : Node_Id; Val : Node_Id); -- Node2
8868 procedure Set_Discr_Check_Funcs_Built
8869 (N : Node_Id; Val : Boolean := True); -- Flag11
8871 procedure Set_Discrete_Choices
8872 (N : Node_Id; Val : List_Id); -- List4
8874 procedure Set_Discrete_Range
8875 (N : Node_Id; Val : Node_Id); -- Node4
8877 procedure Set_Discrete_Subtype_Definition
8878 (N : Node_Id; Val : Node_Id); -- Node4
8880 procedure Set_Discrete_Subtype_Definitions
8881 (N : Node_Id; Val : List_Id); -- List2
8883 procedure Set_Discriminant_Specifications
8884 (N : Node_Id; Val : List_Id); -- List4
8886 procedure Set_Discriminant_Type
8887 (N : Node_Id; Val : Node_Id); -- Node5
8889 procedure Set_Do_Accessibility_Check
8890 (N : Node_Id; Val : Boolean := True); -- Flag13
8892 procedure Set_Do_Discriminant_Check
8893 (N : Node_Id; Val : Boolean := True); -- Flag13
8895 procedure Set_Do_Division_Check
8896 (N : Node_Id; Val : Boolean := True); -- Flag13
8898 procedure Set_Do_Length_Check
8899 (N : Node_Id; Val : Boolean := True); -- Flag4
8901 procedure Set_Do_Overflow_Check
8902 (N : Node_Id; Val : Boolean := True); -- Flag17
8904 procedure Set_Do_Range_Check
8905 (N : Node_Id; Val : Boolean := True); -- Flag9
8907 procedure Set_Do_Storage_Check
8908 (N : Node_Id; Val : Boolean := True); -- Flag17
8910 procedure Set_Do_Tag_Check
8911 (N : Node_Id; Val : Boolean := True); -- Flag13
8913 procedure Set_Elaborate_All_Desirable
8914 (N : Node_Id; Val : Boolean := True); -- Flag9
8916 procedure Set_Elaborate_All_Present
8917 (N : Node_Id; Val : Boolean := True); -- Flag14
8919 procedure Set_Elaborate_Desirable
8920 (N : Node_Id; Val : Boolean := True); -- Flag11
8922 procedure Set_Elaborate_Present
8923 (N : Node_Id; Val : Boolean := True); -- Flag4
8925 procedure Set_Elaboration_Boolean
8926 (N : Node_Id; Val : Node_Id); -- Node2
8928 procedure Set_Else_Actions
8929 (N : Node_Id; Val : List_Id); -- List3
8931 procedure Set_Else_Statements
8932 (N : Node_Id; Val : List_Id); -- List4
8934 procedure Set_Elsif_Parts
8935 (N : Node_Id; Val : List_Id); -- List3
8937 procedure Set_Enclosing_Variant
8938 (N : Node_Id; Val : Node_Id); -- Node2
8940 procedure Set_End_Label
8941 (N : Node_Id; Val : Node_Id); -- Node4
8943 procedure Set_End_Span
8944 (N : Node_Id; Val : Uint); -- Uint5
8946 procedure Set_Entity
8947 (N : Node_Id; Val : Node_Id); -- Node4
8949 procedure Set_Entry_Body_Formal_Part
8950 (N : Node_Id; Val : Node_Id); -- Node5
8952 procedure Set_Entry_Call_Alternative
8953 (N : Node_Id; Val : Node_Id); -- Node1
8955 procedure Set_Entry_Call_Statement
8956 (N : Node_Id; Val : Node_Id); -- Node1
8958 procedure Set_Entry_Direct_Name
8959 (N : Node_Id; Val : Node_Id); -- Node1
8961 procedure Set_Entry_Index
8962 (N : Node_Id; Val : Node_Id); -- Node5
8964 procedure Set_Entry_Index_Specification
8965 (N : Node_Id; Val : Node_Id); -- Node4
8967 procedure Set_Etype
8968 (N : Node_Id; Val : Node_Id); -- Node5
8970 procedure Set_Exception_Choices
8971 (N : Node_Id; Val : List_Id); -- List4
8973 procedure Set_Exception_Handlers
8974 (N : Node_Id; Val : List_Id); -- List5
8976 procedure Set_Exception_Junk
8977 (N : Node_Id; Val : Boolean := True); -- Flag8
8979 procedure Set_Exception_Label
8980 (N : Node_Id; Val : Node_Id); -- Node5
8982 procedure Set_Expansion_Delayed
8983 (N : Node_Id; Val : Boolean := True); -- Flag11
8985 procedure Set_Explicit_Actual_Parameter
8986 (N : Node_Id; Val : Node_Id); -- Node3
8988 procedure Set_Explicit_Generic_Actual_Parameter
8989 (N : Node_Id; Val : Node_Id); -- Node1
8991 procedure Set_Expression
8992 (N : Node_Id; Val : Node_Id); -- Node3
8994 procedure Set_Expressions
8995 (N : Node_Id; Val : List_Id); -- List1
8997 procedure Set_First_Bit
8998 (N : Node_Id; Val : Node_Id); -- Node3
9000 procedure Set_First_Inlined_Subprogram
9001 (N : Node_Id; Val : Entity_Id); -- Node3
9003 procedure Set_First_Name
9004 (N : Node_Id; Val : Boolean := True); -- Flag5
9006 procedure Set_First_Named_Actual
9007 (N : Node_Id; Val : Node_Id); -- Node4
9009 procedure Set_First_Real_Statement
9010 (N : Node_Id; Val : Node_Id); -- Node2
9012 procedure Set_First_Subtype_Link
9013 (N : Node_Id; Val : Entity_Id); -- Node5
9015 procedure Set_Float_Truncate
9016 (N : Node_Id; Val : Boolean := True); -- Flag11
9018 procedure Set_Formal_Type_Definition
9019 (N : Node_Id; Val : Node_Id); -- Node3
9021 procedure Set_Forwards_OK
9022 (N : Node_Id; Val : Boolean := True); -- Flag5
9024 procedure Set_From_At_Mod
9025 (N : Node_Id; Val : Boolean := True); -- Flag4
9027 procedure Set_From_At_End
9028 (N : Node_Id; Val : Boolean := True); -- Flag4
9030 procedure Set_From_Default
9031 (N : Node_Id; Val : Boolean := True); -- Flag6
9033 procedure Set_Generic_Associations
9034 (N : Node_Id; Val : List_Id); -- List3
9036 procedure Set_Generic_Formal_Declarations
9037 (N : Node_Id; Val : List_Id); -- List2
9039 procedure Set_Generic_Parent
9040 (N : Node_Id; Val : Node_Id); -- Node5
9042 procedure Set_Generic_Parent_Type
9043 (N : Node_Id; Val : Node_Id); -- Node4
9045 procedure Set_Handled_Statement_Sequence
9046 (N : Node_Id; Val : Node_Id); -- Node4
9048 procedure Set_Handler_List_Entry
9049 (N : Node_Id; Val : Node_Id); -- Node2
9051 procedure Set_Has_Created_Identifier
9052 (N : Node_Id; Val : Boolean := True); -- Flag15
9054 procedure Set_Has_Dynamic_Length_Check
9055 (N : Node_Id; Val : Boolean := True); -- Flag10
9057 procedure Set_Has_Dynamic_Range_Check
9058 (N : Node_Id; Val : Boolean := True); -- Flag12
9060 procedure Set_Has_Init_Expression
9061 (N : Node_Id; Val : Boolean := True); -- Flag14
9063 procedure Set_Has_Local_Raise
9064 (N : Node_Id; Val : Boolean := True); -- Flag8
9066 procedure Set_Has_No_Elaboration_Code
9067 (N : Node_Id; Val : Boolean := True); -- Flag17
9069 procedure Set_Has_Priority_Pragma
9070 (N : Node_Id; Val : Boolean := True); -- Flag6
9072 procedure Set_Has_Private_View
9073 (N : Node_Id; Val : Boolean := True); -- Flag11
9075 procedure Set_Has_Relative_Deadline_Pragma
9076 (N : Node_Id; Val : Boolean := True); -- Flag9
9078 procedure Set_Has_Self_Reference
9079 (N : Node_Id; Val : Boolean := True); -- Flag13
9081 procedure Set_Has_Storage_Size_Pragma
9082 (N : Node_Id; Val : Boolean := True); -- Flag5
9084 procedure Set_Has_Task_Info_Pragma
9085 (N : Node_Id; Val : Boolean := True); -- Flag7
9087 procedure Set_Has_Task_Name_Pragma
9088 (N : Node_Id; Val : Boolean := True); -- Flag8
9090 procedure Set_Has_Wide_Character
9091 (N : Node_Id; Val : Boolean := True); -- Flag11
9093 procedure Set_Has_Wide_Wide_Character
9094 (N : Node_Id; Val : Boolean := True); -- Flag13
9096 procedure Set_Hidden_By_Use_Clause
9097 (N : Node_Id; Val : Elist_Id); -- Elist4
9099 procedure Set_High_Bound
9100 (N : Node_Id; Val : Node_Id); -- Node2
9102 procedure Set_Identifier
9103 (N : Node_Id; Val : Node_Id); -- Node1
9105 procedure Set_Interface_List
9106 (N : Node_Id; Val : List_Id); -- List2
9108 procedure Set_Interface_Present
9109 (N : Node_Id; Val : Boolean := True); -- Flag16
9111 procedure Set_Implicit_With
9112 (N : Node_Id; Val : Boolean := True); -- Flag16
9114 procedure Set_Import_Interface_Present
9115 (N : Node_Id; Val : Boolean := True); -- Flag16
9117 procedure Set_In_Present
9118 (N : Node_Id; Val : Boolean := True); -- Flag15
9120 procedure Set_Includes_Infinities
9121 (N : Node_Id; Val : Boolean := True); -- Flag11
9123 procedure Set_Inherited_Discriminant
9124 (N : Node_Id; Val : Boolean := True); -- Flag13
9126 procedure Set_Instance_Spec
9127 (N : Node_Id; Val : Node_Id); -- Node5
9129 procedure Set_Intval
9130 (N : Node_Id; Val : Uint); -- Uint3
9132 procedure Set_Is_Accessibility_Actual
9133 (N : Node_Id; Val : Boolean := True); -- Flag13
9135 procedure Set_Is_Asynchronous_Call_Block
9136 (N : Node_Id; Val : Boolean := True); -- Flag7
9138 procedure Set_Is_Component_Left_Opnd
9139 (N : Node_Id; Val : Boolean := True); -- Flag13
9141 procedure Set_Is_Component_Right_Opnd
9142 (N : Node_Id; Val : Boolean := True); -- Flag14
9144 procedure Set_Is_Controlling_Actual
9145 (N : Node_Id; Val : Boolean := True); -- Flag16
9147 procedure Set_Is_Dynamic_Coextension
9148 (N : Node_Id; Val : Boolean := True); -- Flag18
9150 procedure Set_Is_Elsif
9151 (N : Node_Id; Val : Boolean := True); -- Flag13
9153 procedure Set_Is_Entry_Barrier_Function
9154 (N : Node_Id; Val : Boolean := True); -- Flag8
9156 procedure Set_Is_Expanded_Build_In_Place_Call
9157 (N : Node_Id; Val : Boolean := True); -- Flag11
9159 procedure Set_Is_Folded_In_Parser
9160 (N : Node_Id; Val : Boolean := True); -- Flag4
9162 procedure Set_Is_In_Discriminant_Check
9163 (N : Node_Id; Val : Boolean := True); -- Flag11
9165 procedure Set_Is_Machine_Number
9166 (N : Node_Id; Val : Boolean := True); -- Flag11
9168 procedure Set_Is_Null_Loop
9169 (N : Node_Id; Val : Boolean := True); -- Flag16
9171 procedure Set_Is_Overloaded
9172 (N : Node_Id; Val : Boolean := True); -- Flag5
9174 procedure Set_Is_Power_Of_2_For_Shift
9175 (N : Node_Id; Val : Boolean := True); -- Flag13
9177 procedure Set_Is_Protected_Subprogram_Body
9178 (N : Node_Id; Val : Boolean := True); -- Flag7
9180 procedure Set_Is_Static_Coextension
9181 (N : Node_Id; Val : Boolean := True); -- Flag14
9183 procedure Set_Is_Static_Expression
9184 (N : Node_Id; Val : Boolean := True); -- Flag6
9186 procedure Set_Is_Subprogram_Descriptor
9187 (N : Node_Id; Val : Boolean := True); -- Flag16
9189 procedure Set_Is_Task_Allocation_Block
9190 (N : Node_Id; Val : Boolean := True); -- Flag6
9192 procedure Set_Is_Task_Master
9193 (N : Node_Id; Val : Boolean := True); -- Flag5
9195 procedure Set_Iteration_Scheme
9196 (N : Node_Id; Val : Node_Id); -- Node2
9198 procedure Set_Itype
9199 (N : Node_Id; Val : Entity_Id); -- Node1
9201 procedure Set_Kill_Range_Check
9202 (N : Node_Id; Val : Boolean := True); -- Flag11
9204 procedure Set_Last_Bit
9205 (N : Node_Id; Val : Node_Id); -- Node4
9207 procedure Set_Last_Name
9208 (N : Node_Id; Val : Boolean := True); -- Flag6
9210 procedure Set_Library_Unit
9211 (N : Node_Id; Val : Node_Id); -- Node4
9213 procedure Set_Label_Construct
9214 (N : Node_Id; Val : Node_Id); -- Node2
9216 procedure Set_Left_Opnd
9217 (N : Node_Id; Val : Node_Id); -- Node2
9219 procedure Set_Limited_View_Installed
9220 (N : Node_Id; Val : Boolean := True); -- Flag18
9222 procedure Set_Limited_Present
9223 (N : Node_Id; Val : Boolean := True); -- Flag17
9225 procedure Set_Literals
9226 (N : Node_Id; Val : List_Id); -- List1
9228 procedure Set_Local_Raise_Not_OK
9229 (N : Node_Id; Val : Boolean := True); -- Flag7
9231 procedure Set_Local_Raise_Statements
9232 (N : Node_Id; Val : Elist_Id); -- Elist1
9234 procedure Set_Loop_Actions
9235 (N : Node_Id; Val : List_Id); -- List2
9237 procedure Set_Loop_Parameter_Specification
9238 (N : Node_Id; Val : Node_Id); -- Node4
9240 procedure Set_Low_Bound
9241 (N : Node_Id; Val : Node_Id); -- Node1
9243 procedure Set_Mod_Clause
9244 (N : Node_Id; Val : Node_Id); -- Node2
9246 procedure Set_More_Ids
9247 (N : Node_Id; Val : Boolean := True); -- Flag5
9249 procedure Set_Must_Be_Byte_Aligned
9250 (N : Node_Id; Val : Boolean := True); -- Flag14
9252 procedure Set_Must_Not_Freeze
9253 (N : Node_Id; Val : Boolean := True); -- Flag8
9255 procedure Set_Must_Not_Override
9256 (N : Node_Id; Val : Boolean := True); -- Flag15
9258 procedure Set_Must_Override
9259 (N : Node_Id; Val : Boolean := True); -- Flag14
9261 procedure Set_Name
9262 (N : Node_Id; Val : Node_Id); -- Node2
9264 procedure Set_Names
9265 (N : Node_Id; Val : List_Id); -- List2
9267 procedure Set_Next_Entity
9268 (N : Node_Id; Val : Node_Id); -- Node2
9270 procedure Set_Next_Exit_Statement
9271 (N : Node_Id; Val : Node_Id); -- Node3
9273 procedure Set_Next_Implicit_With
9274 (N : Node_Id; Val : Node_Id); -- Node3
9276 procedure Set_Next_Named_Actual
9277 (N : Node_Id; Val : Node_Id); -- Node4
9279 procedure Set_Next_Pragma
9280 (N : Node_Id; Val : Node_Id); -- Node1
9282 procedure Set_Next_Rep_Item
9283 (N : Node_Id; Val : Node_Id); -- Node5
9285 procedure Set_Next_Use_Clause
9286 (N : Node_Id; Val : Node_Id); -- Node3
9288 procedure Set_No_Ctrl_Actions
9289 (N : Node_Id; Val : Boolean := True); -- Flag7
9291 procedure Set_No_Elaboration_Check
9292 (N : Node_Id; Val : Boolean := True); -- Flag14
9294 procedure Set_No_Entities_Ref_In_Spec
9295 (N : Node_Id; Val : Boolean := True); -- Flag8
9297 procedure Set_No_Initialization
9298 (N : Node_Id; Val : Boolean := True); -- Flag13
9300 procedure Set_No_Truncation
9301 (N : Node_Id; Val : Boolean := True); -- Flag17
9303 procedure Set_Null_Present
9304 (N : Node_Id; Val : Boolean := True); -- Flag13
9306 procedure Set_Null_Exclusion_Present
9307 (N : Node_Id; Val : Boolean := True); -- Flag11
9309 procedure Set_Null_Exclusion_In_Return_Present
9310 (N : Node_Id; Val : Boolean := True); -- Flag14
9312 procedure Set_Null_Record_Present
9313 (N : Node_Id; Val : Boolean := True); -- Flag17
9315 procedure Set_Object_Definition
9316 (N : Node_Id; Val : Node_Id); -- Node4
9318 procedure Set_Original_Discriminant
9319 (N : Node_Id; Val : Node_Id); -- Node2
9321 procedure Set_Original_Entity
9322 (N : Node_Id; Val : Entity_Id); -- Node2
9324 procedure Set_Others_Discrete_Choices
9325 (N : Node_Id; Val : List_Id); -- List1
9327 procedure Set_Out_Present
9328 (N : Node_Id; Val : Boolean := True); -- Flag17
9330 procedure Set_Parameter_Associations
9331 (N : Node_Id; Val : List_Id); -- List3
9333 procedure Set_Parameter_List_Truncated
9334 (N : Node_Id; Val : Boolean := True); -- Flag17
9336 procedure Set_Parameter_Specifications
9337 (N : Node_Id; Val : List_Id); -- List3
9339 procedure Set_Parameter_Type
9340 (N : Node_Id; Val : Node_Id); -- Node2
9342 procedure Set_Parent_Spec
9343 (N : Node_Id; Val : Node_Id); -- Node4
9345 procedure Set_Position
9346 (N : Node_Id; Val : Node_Id); -- Node2
9348 procedure Set_Pragma_Argument_Associations
9349 (N : Node_Id; Val : List_Id); -- List2
9351 procedure Set_Pragma_Enabled
9352 (N : Node_Id; Val : Boolean := True); -- Flag5
9354 procedure Set_Pragma_Identifier
9355 (N : Node_Id; Val : Node_Id); -- Node4
9357 procedure Set_Pragmas_After
9358 (N : Node_Id; Val : List_Id); -- List5
9360 procedure Set_Pragmas_Before
9361 (N : Node_Id; Val : List_Id); -- List4
9363 procedure Set_Prefix
9364 (N : Node_Id; Val : Node_Id); -- Node3
9366 procedure Set_Present_Expr
9367 (N : Node_Id; Val : Uint); -- Uint3
9369 procedure Set_Prev_Ids
9370 (N : Node_Id; Val : Boolean := True); -- Flag6
9372 procedure Set_Print_In_Hex
9373 (N : Node_Id; Val : Boolean := True); -- Flag13
9375 procedure Set_Private_Declarations
9376 (N : Node_Id; Val : List_Id); -- List3
9378 procedure Set_Private_Present
9379 (N : Node_Id; Val : Boolean := True); -- Flag15
9381 procedure Set_Procedure_To_Call
9382 (N : Node_Id; Val : Node_Id); -- Node2
9384 procedure Set_Proper_Body
9385 (N : Node_Id; Val : Node_Id); -- Node1
9387 procedure Set_Protected_Definition
9388 (N : Node_Id; Val : Node_Id); -- Node3
9390 procedure Set_Protected_Present
9391 (N : Node_Id; Val : Boolean := True); -- Flag6
9393 procedure Set_Raises_Constraint_Error
9394 (N : Node_Id; Val : Boolean := True); -- Flag7
9396 procedure Set_Range_Constraint
9397 (N : Node_Id; Val : Node_Id); -- Node4
9399 procedure Set_Range_Expression
9400 (N : Node_Id; Val : Node_Id); -- Node4
9402 procedure Set_Real_Range_Specification
9403 (N : Node_Id; Val : Node_Id); -- Node4
9405 procedure Set_Realval
9406 (N : Node_Id; Val : Ureal); -- Ureal3
9408 procedure Set_Reason
9409 (N : Node_Id; Val : Uint); -- Uint3
9411 procedure Set_Record_Extension_Part
9412 (N : Node_Id; Val : Node_Id); -- Node3
9414 procedure Set_Redundant_Use
9415 (N : Node_Id; Val : Boolean := True); -- Flag13
9417 procedure Set_Renaming_Exception
9418 (N : Node_Id; Val : Node_Id); -- Node2
9420 procedure Set_Result_Definition
9421 (N : Node_Id; Val : Node_Id); -- Node4
9423 procedure Set_Return_Object_Declarations
9424 (N : Node_Id; Val : List_Id); -- List3
9426 procedure Set_Return_Statement_Entity
9427 (N : Node_Id; Val : Node_Id); -- Node5
9429 procedure Set_Reverse_Present
9430 (N : Node_Id; Val : Boolean := True); -- Flag15
9432 procedure Set_Right_Opnd
9433 (N : Node_Id; Val : Node_Id); -- Node3
9435 procedure Set_Rounded_Result
9436 (N : Node_Id; Val : Boolean := True); -- Flag18
9438 procedure Set_SCIL_Controlling_Tag
9439 (N : Node_Id; Val : Node_Id); -- Node5
9441 procedure Set_SCIL_Entity
9442 (N : Node_Id; Val : Node_Id); -- Node4
9444 procedure Set_SCIL_Tag_Value
9445 (N : Node_Id; Val : Node_Id); -- Node5
9447 procedure Set_SCIL_Target_Prim
9448 (N : Node_Id; Val : Node_Id); -- Node2
9450 procedure Set_Scope
9451 (N : Node_Id; Val : Node_Id); -- Node3
9453 procedure Set_Select_Alternatives
9454 (N : Node_Id; Val : List_Id); -- List1
9456 procedure Set_Selector_Name
9457 (N : Node_Id; Val : Node_Id); -- Node2
9459 procedure Set_Selector_Names
9460 (N : Node_Id; Val : List_Id); -- List1
9462 procedure Set_Shift_Count_OK
9463 (N : Node_Id; Val : Boolean := True); -- Flag4
9465 procedure Set_Source_Type
9466 (N : Node_Id; Val : Entity_Id); -- Node1
9468 procedure Set_Specification
9469 (N : Node_Id; Val : Node_Id); -- Node1
9471 procedure Set_Statements
9472 (N : Node_Id; Val : List_Id); -- List3
9474 procedure Set_Static_Processing_OK
9475 (N : Node_Id; Val : Boolean); -- Flag4
9477 procedure Set_Storage_Pool
9478 (N : Node_Id; Val : Node_Id); -- Node1
9480 procedure Set_Strval
9481 (N : Node_Id; Val : String_Id); -- Str3
9483 procedure Set_Subtype_Indication
9484 (N : Node_Id; Val : Node_Id); -- Node5
9486 procedure Set_Subtype_Mark
9487 (N : Node_Id; Val : Node_Id); -- Node4
9489 procedure Set_Subtype_Marks
9490 (N : Node_Id; Val : List_Id); -- List2
9492 procedure Set_Suppress_Loop_Warnings
9493 (N : Node_Id; Val : Boolean := True); -- Flag17
9495 procedure Set_Synchronized_Present
9496 (N : Node_Id; Val : Boolean := True); -- Flag7
9498 procedure Set_Tagged_Present
9499 (N : Node_Id; Val : Boolean := True); -- Flag15
9501 procedure Set_Target_Type
9502 (N : Node_Id; Val : Entity_Id); -- Node2
9504 procedure Set_Task_Definition
9505 (N : Node_Id; Val : Node_Id); -- Node3
9507 procedure Set_Task_Present
9508 (N : Node_Id; Val : Boolean := True); -- Flag5
9510 procedure Set_Then_Actions
9511 (N : Node_Id; Val : List_Id); -- List2
9513 procedure Set_Then_Statements
9514 (N : Node_Id; Val : List_Id); -- List2
9516 procedure Set_Treat_Fixed_As_Integer
9517 (N : Node_Id; Val : Boolean := True); -- Flag14
9519 procedure Set_Triggering_Alternative
9520 (N : Node_Id; Val : Node_Id); -- Node1
9522 procedure Set_Triggering_Statement
9523 (N : Node_Id; Val : Node_Id); -- Node1
9525 procedure Set_TSS_Elist
9526 (N : Node_Id; Val : Elist_Id); -- Elist3
9528 procedure Set_Type_Definition
9529 (N : Node_Id; Val : Node_Id); -- Node3
9531 procedure Set_Unit
9532 (N : Node_Id; Val : Node_Id); -- Node2
9534 procedure Set_Unknown_Discriminants_Present
9535 (N : Node_Id; Val : Boolean := True); -- Flag13
9537 procedure Set_Unreferenced_In_Spec
9538 (N : Node_Id; Val : Boolean := True); -- Flag7
9540 procedure Set_Variant_Part
9541 (N : Node_Id; Val : Node_Id); -- Node4
9543 procedure Set_Variants
9544 (N : Node_Id; Val : List_Id); -- List1
9546 procedure Set_Visible_Declarations
9547 (N : Node_Id; Val : List_Id); -- List2
9549 procedure Set_Was_Originally_Stub
9550 (N : Node_Id; Val : Boolean := True); -- Flag13
9552 procedure Set_Withed_Body
9553 (N : Node_Id; Val : Node_Id); -- Node1
9555 procedure Set_Zero_Cost_Handling
9556 (N : Node_Id; Val : Boolean := True); -- Flag5
9558 -------------------------
9559 -- Iterator Procedures --
9560 -------------------------
9562 -- The call to Next_xxx (N) is equivalent to N := Next_xxx (N)
9564 procedure Next_Entity (N : in out Node_Id);
9565 procedure Next_Named_Actual (N : in out Node_Id);
9566 procedure Next_Rep_Item (N : in out Node_Id);
9567 procedure Next_Use_Clause (N : in out Node_Id);
9569 --------------------------------------
9570 -- Logical Access to End_Span Field --
9571 --------------------------------------
9573 function End_Location (N : Node_Id) return Source_Ptr;
9574 -- N is an N_If_Statement or N_Case_Statement node, and this
9575 -- function returns the location of the IF token in the END IF
9576 -- sequence by translating the value of the End_Span field.
9578 procedure Set_End_Location (N : Node_Id; S : Source_Ptr);
9579 -- N is an N_If_Statement or N_Case_Statement node. This procedure
9580 -- sets the End_Span field to correspond to the given value S. In
9581 -- other words, End_Span is set to the difference between S and
9582 -- Sloc (N), the starting location.
9584 --------------------------------
9585 -- Node_Kind Membership Tests --
9586 --------------------------------
9588 -- The following functions allow a convenient notation for testing whether
9589 -- a Node_Kind value matches any one of a list of possible values. In each
9590 -- case True is returned if the given T argument is equal to any of the V
9591 -- arguments. Note that there is a similar set of functions defined in
9592 -- Atree where the first argument is a Node_Id whose Nkind field is tested.
9594 function Nkind_In
9595 (T : Node_Kind;
9596 V1 : Node_Kind;
9597 V2 : Node_Kind) return Boolean;
9599 function Nkind_In
9600 (T : Node_Kind;
9601 V1 : Node_Kind;
9602 V2 : Node_Kind;
9603 V3 : Node_Kind) return Boolean;
9605 function Nkind_In
9606 (T : Node_Kind;
9607 V1 : Node_Kind;
9608 V2 : Node_Kind;
9609 V3 : Node_Kind;
9610 V4 : Node_Kind) return Boolean;
9612 function Nkind_In
9613 (T : Node_Kind;
9614 V1 : Node_Kind;
9615 V2 : Node_Kind;
9616 V3 : Node_Kind;
9617 V4 : Node_Kind;
9618 V5 : Node_Kind) return Boolean;
9620 function Nkind_In
9621 (T : Node_Kind;
9622 V1 : Node_Kind;
9623 V2 : Node_Kind;
9624 V3 : Node_Kind;
9625 V4 : Node_Kind;
9626 V5 : Node_Kind;
9627 V6 : Node_Kind) return Boolean;
9629 function Nkind_In
9630 (T : Node_Kind;
9631 V1 : Node_Kind;
9632 V2 : Node_Kind;
9633 V3 : Node_Kind;
9634 V4 : Node_Kind;
9635 V5 : Node_Kind;
9636 V6 : Node_Kind;
9637 V7 : Node_Kind) return Boolean;
9639 function Nkind_In
9640 (T : Node_Kind;
9641 V1 : Node_Kind;
9642 V2 : Node_Kind;
9643 V3 : Node_Kind;
9644 V4 : Node_Kind;
9645 V5 : Node_Kind;
9646 V6 : Node_Kind;
9647 V7 : Node_Kind;
9648 V8 : Node_Kind) return Boolean;
9650 function Nkind_In
9651 (T : Node_Kind;
9652 V1 : Node_Kind;
9653 V2 : Node_Kind;
9654 V3 : Node_Kind;
9655 V4 : Node_Kind;
9656 V5 : Node_Kind;
9657 V6 : Node_Kind;
9658 V7 : Node_Kind;
9659 V8 : Node_Kind;
9660 V9 : Node_Kind) return Boolean;
9662 pragma Inline (Nkind_In);
9663 -- Inline all above functions
9665 -----------------------
9666 -- Utility Functions --
9667 -----------------------
9669 function Pragma_Name (N : Node_Id) return Name_Id;
9670 pragma Inline (Pragma_Name);
9671 -- Convenient function to obtain Chars field of Pragma_Identifier
9673 -----------------------------
9674 -- Syntactic Parent Tables --
9675 -----------------------------
9677 -- These tables show for each node, and for each of the five fields,
9678 -- whether the corresponding field is syntactic (True) or semantic (False).
9679 -- Unused entries are also set to False.
9681 subtype Field_Num is Natural range 1 .. 5;
9683 Is_Syntactic_Field : constant array (Node_Kind, Field_Num) of Boolean := (
9685 -- Following entries can be built automatically from the sinfo sources
9686 -- using the makeisf utility (currently this program is in spitbol).
9688 N_Identifier =>
9689 (1 => True, -- Chars (Name1)
9690 2 => False, -- Original_Discriminant (Node2-Sem)
9691 3 => False, -- unused
9692 4 => False, -- Entity (Node4-Sem)
9693 5 => False), -- Etype (Node5-Sem)
9695 N_Integer_Literal =>
9696 (1 => False, -- unused
9697 2 => False, -- Original_Entity (Node2-Sem)
9698 3 => True, -- Intval (Uint3)
9699 4 => False, -- unused
9700 5 => False), -- Etype (Node5-Sem)
9702 N_Real_Literal =>
9703 (1 => False, -- unused
9704 2 => False, -- Original_Entity (Node2-Sem)
9705 3 => True, -- Realval (Ureal3)
9706 4 => False, -- Corresponding_Integer_Value (Uint4-Sem)
9707 5 => False), -- Etype (Node5-Sem)
9709 N_Character_Literal =>
9710 (1 => True, -- Chars (Name1)
9711 2 => True, -- Char_Literal_Value (Uint2)
9712 3 => False, -- unused
9713 4 => False, -- Entity (Node4-Sem)
9714 5 => False), -- Etype (Node5-Sem)
9716 N_String_Literal =>
9717 (1 => False, -- unused
9718 2 => False, -- unused
9719 3 => True, -- Strval (Str3)
9720 4 => False, -- unused
9721 5 => False), -- Etype (Node5-Sem)
9723 N_Pragma =>
9724 (1 => False, -- Next_Pragma (Node1-Sem)
9725 2 => True, -- Pragma_Argument_Associations (List2)
9726 3 => True, -- Debug_Statement (Node3)
9727 4 => True, -- Pragma_Identifier (Node4)
9728 5 => False), -- Next_Rep_Item (Node5-Sem)
9730 N_Pragma_Argument_Association =>
9731 (1 => True, -- Chars (Name1)
9732 2 => False, -- unused
9733 3 => True, -- Expression (Node3)
9734 4 => False, -- unused
9735 5 => False), -- unused
9737 N_Defining_Identifier =>
9738 (1 => True, -- Chars (Name1)
9739 2 => False, -- Next_Entity (Node2-Sem)
9740 3 => False, -- Scope (Node3-Sem)
9741 4 => False, -- unused
9742 5 => False), -- Etype (Node5-Sem)
9744 N_Full_Type_Declaration =>
9745 (1 => True, -- Defining_Identifier (Node1)
9746 2 => False, -- unused
9747 3 => True, -- Type_Definition (Node3)
9748 4 => True, -- Discriminant_Specifications (List4)
9749 5 => False), -- unused
9751 N_Subtype_Declaration =>
9752 (1 => True, -- Defining_Identifier (Node1)
9753 2 => False, -- unused
9754 3 => False, -- unused
9755 4 => False, -- Generic_Parent_Type (Node4-Sem)
9756 5 => True), -- Subtype_Indication (Node5)
9758 N_Subtype_Indication =>
9759 (1 => False, -- unused
9760 2 => False, -- unused
9761 3 => True, -- Constraint (Node3)
9762 4 => True, -- Subtype_Mark (Node4)
9763 5 => False), -- Etype (Node5-Sem)
9765 N_Object_Declaration =>
9766 (1 => True, -- Defining_Identifier (Node1)
9767 2 => False, -- Handler_List_Entry (Node2-Sem)
9768 3 => True, -- Expression (Node3)
9769 4 => True, -- Object_Definition (Node4)
9770 5 => False), -- Corresponding_Generic_Association (Node5-Sem)
9772 N_Number_Declaration =>
9773 (1 => True, -- Defining_Identifier (Node1)
9774 2 => False, -- unused
9775 3 => True, -- Expression (Node3)
9776 4 => False, -- unused
9777 5 => False), -- unused
9779 N_Derived_Type_Definition =>
9780 (1 => False, -- unused
9781 2 => True, -- Interface_List (List2)
9782 3 => True, -- Record_Extension_Part (Node3)
9783 4 => False, -- unused
9784 5 => True), -- Subtype_Indication (Node5)
9786 N_Range_Constraint =>
9787 (1 => False, -- unused
9788 2 => False, -- unused
9789 3 => False, -- unused
9790 4 => True, -- Range_Expression (Node4)
9791 5 => False), -- unused
9793 N_Range =>
9794 (1 => True, -- Low_Bound (Node1)
9795 2 => True, -- High_Bound (Node2)
9796 3 => False, -- unused
9797 4 => False, -- unused
9798 5 => False), -- Etype (Node5-Sem)
9800 N_Enumeration_Type_Definition =>
9801 (1 => True, -- Literals (List1)
9802 2 => False, -- unused
9803 3 => False, -- unused
9804 4 => True, -- End_Label (Node4)
9805 5 => False), -- unused
9807 N_Defining_Character_Literal =>
9808 (1 => True, -- Chars (Name1)
9809 2 => False, -- Next_Entity (Node2-Sem)
9810 3 => False, -- Scope (Node3-Sem)
9811 4 => False, -- unused
9812 5 => False), -- Etype (Node5-Sem)
9814 N_Signed_Integer_Type_Definition =>
9815 (1 => True, -- Low_Bound (Node1)
9816 2 => True, -- High_Bound (Node2)
9817 3 => False, -- unused
9818 4 => False, -- unused
9819 5 => False), -- unused
9821 N_Modular_Type_Definition =>
9822 (1 => False, -- unused
9823 2 => False, -- unused
9824 3 => True, -- Expression (Node3)
9825 4 => False, -- unused
9826 5 => False), -- unused
9828 N_Floating_Point_Definition =>
9829 (1 => False, -- unused
9830 2 => True, -- Digits_Expression (Node2)
9831 3 => False, -- unused
9832 4 => True, -- Real_Range_Specification (Node4)
9833 5 => False), -- unused
9835 N_Real_Range_Specification =>
9836 (1 => True, -- Low_Bound (Node1)
9837 2 => True, -- High_Bound (Node2)
9838 3 => False, -- unused
9839 4 => False, -- unused
9840 5 => False), -- unused
9842 N_Ordinary_Fixed_Point_Definition =>
9843 (1 => False, -- unused
9844 2 => False, -- unused
9845 3 => True, -- Delta_Expression (Node3)
9846 4 => True, -- Real_Range_Specification (Node4)
9847 5 => False), -- unused
9849 N_Decimal_Fixed_Point_Definition =>
9850 (1 => False, -- unused
9851 2 => True, -- Digits_Expression (Node2)
9852 3 => True, -- Delta_Expression (Node3)
9853 4 => True, -- Real_Range_Specification (Node4)
9854 5 => False), -- unused
9856 N_Digits_Constraint =>
9857 (1 => False, -- unused
9858 2 => True, -- Digits_Expression (Node2)
9859 3 => False, -- unused
9860 4 => True, -- Range_Constraint (Node4)
9861 5 => False), -- unused
9863 N_Unconstrained_Array_Definition =>
9864 (1 => False, -- unused
9865 2 => True, -- Subtype_Marks (List2)
9866 3 => False, -- unused
9867 4 => True, -- Component_Definition (Node4)
9868 5 => False), -- unused
9870 N_Constrained_Array_Definition =>
9871 (1 => False, -- unused
9872 2 => True, -- Discrete_Subtype_Definitions (List2)
9873 3 => False, -- unused
9874 4 => True, -- Component_Definition (Node4)
9875 5 => False), -- unused
9877 N_Component_Definition =>
9878 (1 => False, -- unused
9879 2 => False, -- unused
9880 3 => True, -- Access_Definition (Node3)
9881 4 => False, -- unused
9882 5 => True), -- Subtype_Indication (Node5)
9884 N_Discriminant_Specification =>
9885 (1 => True, -- Defining_Identifier (Node1)
9886 2 => False, -- unused
9887 3 => True, -- Expression (Node3)
9888 4 => False, -- unused
9889 5 => True), -- Discriminant_Type (Node5)
9891 N_Index_Or_Discriminant_Constraint =>
9892 (1 => True, -- Constraints (List1)
9893 2 => False, -- unused
9894 3 => False, -- unused
9895 4 => False, -- unused
9896 5 => False), -- unused
9898 N_Discriminant_Association =>
9899 (1 => True, -- Selector_Names (List1)
9900 2 => False, -- unused
9901 3 => True, -- Expression (Node3)
9902 4 => False, -- unused
9903 5 => False), -- unused
9905 N_Record_Definition =>
9906 (1 => True, -- Component_List (Node1)
9907 2 => True, -- Interface_List (List2)
9908 3 => False, -- unused
9909 4 => True, -- End_Label (Node4)
9910 5 => False), -- unused
9912 N_Component_List =>
9913 (1 => False, -- unused
9914 2 => False, -- unused
9915 3 => True, -- Component_Items (List3)
9916 4 => True, -- Variant_Part (Node4)
9917 5 => False), -- unused
9919 N_Component_Declaration =>
9920 (1 => True, -- Defining_Identifier (Node1)
9921 2 => False, -- unused
9922 3 => True, -- Expression (Node3)
9923 4 => True, -- Component_Definition (Node4)
9924 5 => False), -- unused
9926 N_Variant_Part =>
9927 (1 => True, -- Variants (List1)
9928 2 => True, -- Name (Node2)
9929 3 => False, -- unused
9930 4 => False, -- unused
9931 5 => False), -- unused
9933 N_Variant =>
9934 (1 => True, -- Component_List (Node1)
9935 2 => False, -- Enclosing_Variant (Node2-Sem)
9936 3 => False, -- Present_Expr (Uint3-Sem)
9937 4 => True, -- Discrete_Choices (List4)
9938 5 => False), -- Dcheck_Function (Node5-Sem)
9940 N_Others_Choice =>
9941 (1 => False, -- Others_Discrete_Choices (List1-Sem)
9942 2 => False, -- unused
9943 3 => False, -- unused
9944 4 => False, -- unused
9945 5 => False), -- unused
9947 N_Access_To_Object_Definition =>
9948 (1 => False, -- unused
9949 2 => False, -- unused
9950 3 => False, -- unused
9951 4 => False, -- unused
9952 5 => True), -- Subtype_Indication (Node5)
9954 N_Access_Function_Definition =>
9955 (1 => False, -- unused
9956 2 => False, -- unused
9957 3 => True, -- Parameter_Specifications (List3)
9958 4 => True, -- Result_Definition (Node4)
9959 5 => False), -- unused
9961 N_Access_Procedure_Definition =>
9962 (1 => False, -- unused
9963 2 => False, -- unused
9964 3 => True, -- Parameter_Specifications (List3)
9965 4 => False, -- unused
9966 5 => False), -- unused
9968 N_Access_Definition =>
9969 (1 => False, -- unused
9970 2 => False, -- unused
9971 3 => True, -- Access_To_Subprogram_Definition (Node3)
9972 4 => True, -- Subtype_Mark (Node4)
9973 5 => False), -- unused
9975 N_Incomplete_Type_Declaration =>
9976 (1 => True, -- Defining_Identifier (Node1)
9977 2 => False, -- unused
9978 3 => False, -- unused
9979 4 => True, -- Discriminant_Specifications (List4)
9980 5 => False), -- unused
9982 N_Explicit_Dereference =>
9983 (1 => False, -- unused
9984 2 => False, -- unused
9985 3 => True, -- Prefix (Node3)
9986 4 => False, -- Actual_Designated_Subtype (Node4-Sem)
9987 5 => False), -- Etype (Node5-Sem)
9989 N_Indexed_Component =>
9990 (1 => True, -- Expressions (List1)
9991 2 => False, -- unused
9992 3 => True, -- Prefix (Node3)
9993 4 => False, -- unused
9994 5 => False), -- Etype (Node5-Sem)
9996 N_Slice =>
9997 (1 => False, -- unused
9998 2 => False, -- unused
9999 3 => True, -- Prefix (Node3)
10000 4 => True, -- Discrete_Range (Node4)
10001 5 => False), -- Etype (Node5-Sem)
10003 N_Selected_Component =>
10004 (1 => False, -- unused
10005 2 => True, -- Selector_Name (Node2)
10006 3 => True, -- Prefix (Node3)
10007 4 => False, -- unused
10008 5 => False), -- Etype (Node5-Sem)
10010 N_Attribute_Reference =>
10011 (1 => True, -- Expressions (List1)
10012 2 => True, -- Attribute_Name (Name2)
10013 3 => True, -- Prefix (Node3)
10014 4 => False, -- Entity (Node4-Sem)
10015 5 => False), -- Etype (Node5-Sem)
10017 N_Aggregate =>
10018 (1 => True, -- Expressions (List1)
10019 2 => True, -- Component_Associations (List2)
10020 3 => False, -- Aggregate_Bounds (Node3-Sem)
10021 4 => False, -- unused
10022 5 => False), -- Etype (Node5-Sem)
10024 N_Component_Association =>
10025 (1 => True, -- Choices (List1)
10026 2 => False, -- Loop_Actions (List2-Sem)
10027 3 => True, -- Expression (Node3)
10028 4 => False, -- unused
10029 5 => False), -- unused
10031 N_Extension_Aggregate =>
10032 (1 => True, -- Expressions (List1)
10033 2 => True, -- Component_Associations (List2)
10034 3 => True, -- Ancestor_Part (Node3)
10035 4 => False, -- unused
10036 5 => False), -- Etype (Node5-Sem)
10038 N_Null =>
10039 (1 => False, -- unused
10040 2 => False, -- unused
10041 3 => False, -- unused
10042 4 => False, -- unused
10043 5 => False), -- Etype (Node5-Sem)
10045 N_And_Then =>
10046 (1 => False, -- Actions (List1-Sem)
10047 2 => True, -- Left_Opnd (Node2)
10048 3 => True, -- Right_Opnd (Node3)
10049 4 => False, -- unused
10050 5 => False), -- Etype (Node5-Sem)
10052 N_Or_Else =>
10053 (1 => False, -- Actions (List1-Sem)
10054 2 => True, -- Left_Opnd (Node2)
10055 3 => True, -- Right_Opnd (Node3)
10056 4 => False, -- unused
10057 5 => False), -- Etype (Node5-Sem)
10059 N_In =>
10060 (1 => False, -- unused
10061 2 => True, -- Left_Opnd (Node2)
10062 3 => True, -- Right_Opnd (Node3)
10063 4 => True, -- Alternatives (List4)
10064 5 => False), -- Etype (Node5-Sem)
10066 N_Not_In =>
10067 (1 => False, -- unused
10068 2 => True, -- Left_Opnd (Node2)
10069 3 => True, -- Right_Opnd (Node3)
10070 4 => True, -- Alternatives (List4)
10071 5 => False), -- Etype (Node5-Sem)
10073 N_Op_And =>
10074 (1 => True, -- Chars (Name1)
10075 2 => True, -- Left_Opnd (Node2)
10076 3 => True, -- Right_Opnd (Node3)
10077 4 => False, -- Entity (Node4-Sem)
10078 5 => False), -- Etype (Node5-Sem)
10080 N_Op_Or =>
10081 (1 => True, -- Chars (Name1)
10082 2 => True, -- Left_Opnd (Node2)
10083 3 => True, -- Right_Opnd (Node3)
10084 4 => False, -- Entity (Node4-Sem)
10085 5 => False), -- Etype (Node5-Sem)
10087 N_Op_Xor =>
10088 (1 => True, -- Chars (Name1)
10089 2 => True, -- Left_Opnd (Node2)
10090 3 => True, -- Right_Opnd (Node3)
10091 4 => False, -- Entity (Node4-Sem)
10092 5 => False), -- Etype (Node5-Sem)
10094 N_Op_Eq =>
10095 (1 => True, -- Chars (Name1)
10096 2 => True, -- Left_Opnd (Node2)
10097 3 => True, -- Right_Opnd (Node3)
10098 4 => False, -- Entity (Node4-Sem)
10099 5 => False), -- Etype (Node5-Sem)
10101 N_Op_Ne =>
10102 (1 => True, -- Chars (Name1)
10103 2 => True, -- Left_Opnd (Node2)
10104 3 => True, -- Right_Opnd (Node3)
10105 4 => False, -- Entity (Node4-Sem)
10106 5 => False), -- Etype (Node5-Sem)
10108 N_Op_Lt =>
10109 (1 => True, -- Chars (Name1)
10110 2 => True, -- Left_Opnd (Node2)
10111 3 => True, -- Right_Opnd (Node3)
10112 4 => False, -- Entity (Node4-Sem)
10113 5 => False), -- Etype (Node5-Sem)
10115 N_Op_Le =>
10116 (1 => True, -- Chars (Name1)
10117 2 => True, -- Left_Opnd (Node2)
10118 3 => True, -- Right_Opnd (Node3)
10119 4 => False, -- Entity (Node4-Sem)
10120 5 => False), -- Etype (Node5-Sem)
10122 N_Op_Gt =>
10123 (1 => True, -- Chars (Name1)
10124 2 => True, -- Left_Opnd (Node2)
10125 3 => True, -- Right_Opnd (Node3)
10126 4 => False, -- Entity (Node4-Sem)
10127 5 => False), -- Etype (Node5-Sem)
10129 N_Op_Ge =>
10130 (1 => True, -- Chars (Name1)
10131 2 => True, -- Left_Opnd (Node2)
10132 3 => True, -- Right_Opnd (Node3)
10133 4 => False, -- Entity (Node4-Sem)
10134 5 => False), -- Etype (Node5-Sem)
10136 N_Op_Add =>
10137 (1 => True, -- Chars (Name1)
10138 2 => True, -- Left_Opnd (Node2)
10139 3 => True, -- Right_Opnd (Node3)
10140 4 => False, -- Entity (Node4-Sem)
10141 5 => False), -- Etype (Node5-Sem)
10143 N_Op_Subtract =>
10144 (1 => True, -- Chars (Name1)
10145 2 => True, -- Left_Opnd (Node2)
10146 3 => True, -- Right_Opnd (Node3)
10147 4 => False, -- Entity (Node4-Sem)
10148 5 => False), -- Etype (Node5-Sem)
10150 N_Op_Concat =>
10151 (1 => True, -- Chars (Name1)
10152 2 => True, -- Left_Opnd (Node2)
10153 3 => True, -- Right_Opnd (Node3)
10154 4 => False, -- Entity (Node4-Sem)
10155 5 => False), -- Etype (Node5-Sem)
10157 N_Op_Multiply =>
10158 (1 => True, -- Chars (Name1)
10159 2 => True, -- Left_Opnd (Node2)
10160 3 => True, -- Right_Opnd (Node3)
10161 4 => False, -- Entity (Node4-Sem)
10162 5 => False), -- Etype (Node5-Sem)
10164 N_Op_Divide =>
10165 (1 => True, -- Chars (Name1)
10166 2 => True, -- Left_Opnd (Node2)
10167 3 => True, -- Right_Opnd (Node3)
10168 4 => False, -- Entity (Node4-Sem)
10169 5 => False), -- Etype (Node5-Sem)
10171 N_Op_Mod =>
10172 (1 => True, -- Chars (Name1)
10173 2 => True, -- Left_Opnd (Node2)
10174 3 => True, -- Right_Opnd (Node3)
10175 4 => False, -- Entity (Node4-Sem)
10176 5 => False), -- Etype (Node5-Sem)
10178 N_Op_Rem =>
10179 (1 => True, -- Chars (Name1)
10180 2 => True, -- Left_Opnd (Node2)
10181 3 => True, -- Right_Opnd (Node3)
10182 4 => False, -- Entity (Node4-Sem)
10183 5 => False), -- Etype (Node5-Sem)
10185 N_Op_Expon =>
10186 (1 => True, -- Chars (Name1)
10187 2 => True, -- Left_Opnd (Node2)
10188 3 => True, -- Right_Opnd (Node3)
10189 4 => False, -- Entity (Node4-Sem)
10190 5 => False), -- Etype (Node5-Sem)
10192 N_Op_Plus =>
10193 (1 => True, -- Chars (Name1)
10194 2 => False, -- unused
10195 3 => True, -- Right_Opnd (Node3)
10196 4 => False, -- Entity (Node4-Sem)
10197 5 => False), -- Etype (Node5-Sem)
10199 N_Op_Minus =>
10200 (1 => True, -- Chars (Name1)
10201 2 => False, -- unused
10202 3 => True, -- Right_Opnd (Node3)
10203 4 => False, -- Entity (Node4-Sem)
10204 5 => False), -- Etype (Node5-Sem)
10206 N_Op_Abs =>
10207 (1 => True, -- Chars (Name1)
10208 2 => False, -- unused
10209 3 => True, -- Right_Opnd (Node3)
10210 4 => False, -- Entity (Node4-Sem)
10211 5 => False), -- Etype (Node5-Sem)
10213 N_Op_Not =>
10214 (1 => True, -- Chars (Name1)
10215 2 => False, -- unused
10216 3 => True, -- Right_Opnd (Node3)
10217 4 => False, -- Entity (Node4-Sem)
10218 5 => False), -- Etype (Node5-Sem)
10220 N_Type_Conversion =>
10221 (1 => False, -- unused
10222 2 => False, -- unused
10223 3 => True, -- Expression (Node3)
10224 4 => True, -- Subtype_Mark (Node4)
10225 5 => False), -- Etype (Node5-Sem)
10227 N_Qualified_Expression =>
10228 (1 => False, -- unused
10229 2 => False, -- unused
10230 3 => True, -- Expression (Node3)
10231 4 => True, -- Subtype_Mark (Node4)
10232 5 => False), -- Etype (Node5-Sem)
10234 N_Allocator =>
10235 (1 => False, -- Storage_Pool (Node1-Sem)
10236 2 => False, -- Procedure_To_Call (Node2-Sem)
10237 3 => True, -- Expression (Node3)
10238 4 => False, -- Coextensions (Elist4-Sem)
10239 5 => False), -- Etype (Node5-Sem)
10241 N_Null_Statement =>
10242 (1 => False, -- unused
10243 2 => False, -- unused
10244 3 => False, -- unused
10245 4 => False, -- unused
10246 5 => False), -- unused
10248 N_Label =>
10249 (1 => True, -- Identifier (Node1)
10250 2 => False, -- unused
10251 3 => False, -- unused
10252 4 => False, -- unused
10253 5 => False), -- unused
10255 N_Assignment_Statement =>
10256 (1 => False, -- unused
10257 2 => True, -- Name (Node2)
10258 3 => True, -- Expression (Node3)
10259 4 => False, -- unused
10260 5 => False), -- unused
10262 N_If_Statement =>
10263 (1 => True, -- Condition (Node1)
10264 2 => True, -- Then_Statements (List2)
10265 3 => True, -- Elsif_Parts (List3)
10266 4 => True, -- Else_Statements (List4)
10267 5 => True), -- End_Span (Uint5)
10269 N_Elsif_Part =>
10270 (1 => True, -- Condition (Node1)
10271 2 => True, -- Then_Statements (List2)
10272 3 => False, -- Condition_Actions (List3-Sem)
10273 4 => False, -- unused
10274 5 => False), -- unused
10276 N_Case_Expression =>
10277 (1 => False, -- unused
10278 2 => False, -- unused
10279 3 => True, -- Expression (Node3)
10280 4 => True, -- Alternatives (List4)
10281 5 => False), -- unused
10283 N_Case_Expression_Alternative =>
10284 (1 => False, -- Actions (List1-Sem)
10285 2 => False, -- unused
10286 3 => True, -- Statements (List3)
10287 4 => True, -- Expression (Node4)
10288 5 => False), -- unused
10290 N_Case_Statement =>
10291 (1 => False, -- unused
10292 2 => False, -- unused
10293 3 => True, -- Expression (Node3)
10294 4 => True, -- Alternatives (List4)
10295 5 => True), -- End_Span (Uint5)
10297 N_Case_Statement_Alternative =>
10298 (1 => False, -- unused
10299 2 => False, -- unused
10300 3 => True, -- Statements (List3)
10301 4 => True, -- Discrete_Choices (List4)
10302 5 => False), -- unused
10304 N_Loop_Statement =>
10305 (1 => True, -- Identifier (Node1)
10306 2 => True, -- Iteration_Scheme (Node2)
10307 3 => True, -- Statements (List3)
10308 4 => True, -- End_Label (Node4)
10309 5 => False), -- unused
10311 N_Iteration_Scheme =>
10312 (1 => True, -- Condition (Node1)
10313 2 => False, -- unused
10314 3 => False, -- Condition_Actions (List3-Sem)
10315 4 => True, -- Loop_Parameter_Specification (Node4)
10316 5 => False), -- unused
10318 N_Loop_Parameter_Specification =>
10319 (1 => True, -- Defining_Identifier (Node1)
10320 2 => False, -- unused
10321 3 => False, -- unused
10322 4 => True, -- Discrete_Subtype_Definition (Node4)
10323 5 => False), -- unused
10325 N_Block_Statement =>
10326 (1 => True, -- Identifier (Node1)
10327 2 => True, -- Declarations (List2)
10328 3 => False, -- Activation_Chain_Entity (Node3-Sem)
10329 4 => True, -- Handled_Statement_Sequence (Node4)
10330 5 => False), -- unused
10332 N_Exit_Statement =>
10333 (1 => True, -- Condition (Node1)
10334 2 => True, -- Name (Node2)
10335 3 => False, -- unused
10336 4 => False, -- unused
10337 5 => False), -- unused
10339 N_Goto_Statement =>
10340 (1 => False, -- unused
10341 2 => True, -- Name (Node2)
10342 3 => False, -- unused
10343 4 => False, -- unused
10344 5 => False), -- unused
10346 N_Subprogram_Declaration =>
10347 (1 => True, -- Specification (Node1)
10348 2 => False, -- unused
10349 3 => False, -- Body_To_Inline (Node3-Sem)
10350 4 => False, -- Parent_Spec (Node4-Sem)
10351 5 => False), -- Corresponding_Body (Node5-Sem)
10353 N_Abstract_Subprogram_Declaration =>
10354 (1 => True, -- Specification (Node1)
10355 2 => False, -- unused
10356 3 => False, -- unused
10357 4 => False, -- unused
10358 5 => False), -- unused
10360 N_Function_Specification =>
10361 (1 => True, -- Defining_Unit_Name (Node1)
10362 2 => False, -- Elaboration_Boolean (Node2-Sem)
10363 3 => True, -- Parameter_Specifications (List3)
10364 4 => True, -- Result_Definition (Node4)
10365 5 => False), -- Generic_Parent (Node5-Sem)
10367 N_Procedure_Specification =>
10368 (1 => True, -- Defining_Unit_Name (Node1)
10369 2 => False, -- Elaboration_Boolean (Node2-Sem)
10370 3 => True, -- Parameter_Specifications (List3)
10371 4 => False, -- unused
10372 5 => False), -- Generic_Parent (Node5-Sem)
10374 N_Designator =>
10375 (1 => True, -- Identifier (Node1)
10376 2 => True, -- Name (Node2)
10377 3 => False, -- unused
10378 4 => False, -- unused
10379 5 => False), -- unused
10381 N_Defining_Program_Unit_Name =>
10382 (1 => True, -- Defining_Identifier (Node1)
10383 2 => True, -- Name (Node2)
10384 3 => False, -- unused
10385 4 => False, -- unused
10386 5 => False), -- unused
10388 N_Operator_Symbol =>
10389 (1 => True, -- Chars (Name1)
10390 2 => False, -- unused
10391 3 => True, -- Strval (Str3)
10392 4 => False, -- Entity (Node4-Sem)
10393 5 => False), -- Etype (Node5-Sem)
10395 N_Defining_Operator_Symbol =>
10396 (1 => True, -- Chars (Name1)
10397 2 => False, -- Next_Entity (Node2-Sem)
10398 3 => False, -- Scope (Node3-Sem)
10399 4 => False, -- unused
10400 5 => False), -- Etype (Node5-Sem)
10402 N_Parameter_Specification =>
10403 (1 => True, -- Defining_Identifier (Node1)
10404 2 => True, -- Parameter_Type (Node2)
10405 3 => True, -- Expression (Node3)
10406 4 => False, -- unused
10407 5 => False), -- Default_Expression (Node5-Sem)
10409 N_Subprogram_Body =>
10410 (1 => True, -- Specification (Node1)
10411 2 => True, -- Declarations (List2)
10412 3 => False, -- Activation_Chain_Entity (Node3-Sem)
10413 4 => True, -- Handled_Statement_Sequence (Node4)
10414 5 => False), -- Corresponding_Spec (Node5-Sem)
10416 N_Procedure_Call_Statement =>
10417 (1 => False, -- Controlling_Argument (Node1-Sem)
10418 2 => True, -- Name (Node2)
10419 3 => True, -- Parameter_Associations (List3)
10420 4 => False, -- First_Named_Actual (Node4-Sem)
10421 5 => False), -- Etype (Node5-Sem)
10423 N_Function_Call =>
10424 (1 => False, -- Controlling_Argument (Node1-Sem)
10425 2 => True, -- Name (Node2)
10426 3 => True, -- Parameter_Associations (List3)
10427 4 => False, -- First_Named_Actual (Node4-Sem)
10428 5 => False), -- Etype (Node5-Sem)
10430 N_Parameter_Association =>
10431 (1 => False, -- unused
10432 2 => True, -- Selector_Name (Node2)
10433 3 => True, -- Explicit_Actual_Parameter (Node3)
10434 4 => False, -- Next_Named_Actual (Node4-Sem)
10435 5 => False), -- unused
10437 N_Return_Statement =>
10438 (1 => False, -- Storage_Pool (Node1-Sem)
10439 2 => False, -- Procedure_To_Call (Node2-Sem)
10440 3 => True, -- Expression (Node3)
10441 4 => False, -- unused
10442 5 => False), -- Return_Statement_Entity (Node5-Sem)
10444 N_Extended_Return_Statement =>
10445 (1 => False, -- Storage_Pool (Node1-Sem)
10446 2 => False, -- Procedure_To_Call (Node2-Sem)
10447 3 => True, -- Return_Object_Declarations (List3)
10448 4 => True, -- Handled_Statement_Sequence (Node4)
10449 5 => False), -- Return_Statement_Entity (Node5-Sem)
10451 N_Package_Declaration =>
10452 (1 => True, -- Specification (Node1)
10453 2 => False, -- unused
10454 3 => False, -- Activation_Chain_Entity (Node3-Sem)
10455 4 => False, -- Parent_Spec (Node4-Sem)
10456 5 => False), -- Corresponding_Body (Node5-Sem)
10458 N_Package_Specification =>
10459 (1 => True, -- Defining_Unit_Name (Node1)
10460 2 => True, -- Visible_Declarations (List2)
10461 3 => True, -- Private_Declarations (List3)
10462 4 => True, -- End_Label (Node4)
10463 5 => False), -- Generic_Parent (Node5-Sem)
10465 N_Package_Body =>
10466 (1 => True, -- Defining_Unit_Name (Node1)
10467 2 => True, -- Declarations (List2)
10468 3 => False, -- unused
10469 4 => True, -- Handled_Statement_Sequence (Node4)
10470 5 => False), -- Corresponding_Spec (Node5-Sem)
10472 N_Private_Type_Declaration =>
10473 (1 => True, -- Defining_Identifier (Node1)
10474 2 => False, -- unused
10475 3 => False, -- unused
10476 4 => True, -- Discriminant_Specifications (List4)
10477 5 => False), -- unused
10479 N_Private_Extension_Declaration =>
10480 (1 => True, -- Defining_Identifier (Node1)
10481 2 => True, -- Interface_List (List2)
10482 3 => False, -- unused
10483 4 => True, -- Discriminant_Specifications (List4)
10484 5 => True), -- Subtype_Indication (Node5)
10486 N_Use_Package_Clause =>
10487 (1 => False, -- unused
10488 2 => True, -- Names (List2)
10489 3 => False, -- Next_Use_Clause (Node3-Sem)
10490 4 => False, -- Hidden_By_Use_Clause (Elist4-Sem)
10491 5 => False), -- unused
10493 N_Use_Type_Clause =>
10494 (1 => False, -- unused
10495 2 => True, -- Subtype_Marks (List2)
10496 3 => False, -- Next_Use_Clause (Node3-Sem)
10497 4 => False, -- Hidden_By_Use_Clause (Elist4-Sem)
10498 5 => False), -- unused
10500 N_Object_Renaming_Declaration =>
10501 (1 => True, -- Defining_Identifier (Node1)
10502 2 => True, -- Name (Node2)
10503 3 => True, -- Access_Definition (Node3)
10504 4 => True, -- Subtype_Mark (Node4)
10505 5 => False), -- Corresponding_Generic_Association (Node5-Sem)
10507 N_Exception_Renaming_Declaration =>
10508 (1 => True, -- Defining_Identifier (Node1)
10509 2 => True, -- Name (Node2)
10510 3 => False, -- unused
10511 4 => False, -- unused
10512 5 => False), -- unused
10514 N_Package_Renaming_Declaration =>
10515 (1 => True, -- Defining_Unit_Name (Node1)
10516 2 => True, -- Name (Node2)
10517 3 => False, -- unused
10518 4 => False, -- Parent_Spec (Node4-Sem)
10519 5 => False), -- unused
10521 N_Subprogram_Renaming_Declaration =>
10522 (1 => True, -- Specification (Node1)
10523 2 => True, -- Name (Node2)
10524 3 => False, -- Corresponding_Formal_Spec (Node3-Sem)
10525 4 => False, -- Parent_Spec (Node4-Sem)
10526 5 => False), -- Corresponding_Spec (Node5-Sem)
10528 N_Generic_Package_Renaming_Declaration =>
10529 (1 => True, -- Defining_Unit_Name (Node1)
10530 2 => True, -- Name (Node2)
10531 3 => False, -- unused
10532 4 => False, -- Parent_Spec (Node4-Sem)
10533 5 => False), -- unused
10535 N_Generic_Procedure_Renaming_Declaration =>
10536 (1 => True, -- Defining_Unit_Name (Node1)
10537 2 => True, -- Name (Node2)
10538 3 => False, -- unused
10539 4 => False, -- Parent_Spec (Node4-Sem)
10540 5 => False), -- unused
10542 N_Generic_Function_Renaming_Declaration =>
10543 (1 => True, -- Defining_Unit_Name (Node1)
10544 2 => True, -- Name (Node2)
10545 3 => False, -- unused
10546 4 => False, -- Parent_Spec (Node4-Sem)
10547 5 => False), -- unused
10549 N_Task_Type_Declaration =>
10550 (1 => True, -- Defining_Identifier (Node1)
10551 2 => True, -- Interface_List (List2)
10552 3 => True, -- Task_Definition (Node3)
10553 4 => True, -- Discriminant_Specifications (List4)
10554 5 => False), -- Corresponding_Body (Node5-Sem)
10556 N_Single_Task_Declaration =>
10557 (1 => True, -- Defining_Identifier (Node1)
10558 2 => True, -- Interface_List (List2)
10559 3 => True, -- Task_Definition (Node3)
10560 4 => False, -- unused
10561 5 => False), -- unused
10563 N_Task_Definition =>
10564 (1 => False, -- unused
10565 2 => True, -- Visible_Declarations (List2)
10566 3 => True, -- Private_Declarations (List3)
10567 4 => True, -- End_Label (Node4)
10568 5 => False), -- unused
10570 N_Task_Body =>
10571 (1 => True, -- Defining_Identifier (Node1)
10572 2 => True, -- Declarations (List2)
10573 3 => False, -- Activation_Chain_Entity (Node3-Sem)
10574 4 => True, -- Handled_Statement_Sequence (Node4)
10575 5 => False), -- Corresponding_Spec (Node5-Sem)
10577 N_Protected_Type_Declaration =>
10578 (1 => True, -- Defining_Identifier (Node1)
10579 2 => True, -- Interface_List (List2)
10580 3 => True, -- Protected_Definition (Node3)
10581 4 => True, -- Discriminant_Specifications (List4)
10582 5 => False), -- Corresponding_Body (Node5-Sem)
10584 N_Single_Protected_Declaration =>
10585 (1 => True, -- Defining_Identifier (Node1)
10586 2 => True, -- Interface_List (List2)
10587 3 => True, -- Protected_Definition (Node3)
10588 4 => False, -- unused
10589 5 => False), -- unused
10591 N_Protected_Definition =>
10592 (1 => False, -- unused
10593 2 => True, -- Visible_Declarations (List2)
10594 3 => True, -- Private_Declarations (List3)
10595 4 => True, -- End_Label (Node4)
10596 5 => False), -- unused
10598 N_Protected_Body =>
10599 (1 => True, -- Defining_Identifier (Node1)
10600 2 => True, -- Declarations (List2)
10601 3 => False, -- unused
10602 4 => True, -- End_Label (Node4)
10603 5 => False), -- Corresponding_Spec (Node5-Sem)
10605 N_Entry_Declaration =>
10606 (1 => True, -- Defining_Identifier (Node1)
10607 2 => False, -- unused
10608 3 => True, -- Parameter_Specifications (List3)
10609 4 => True, -- Discrete_Subtype_Definition (Node4)
10610 5 => False), -- Corresponding_Body (Node5-Sem)
10612 N_Accept_Statement =>
10613 (1 => True, -- Entry_Direct_Name (Node1)
10614 2 => True, -- Declarations (List2)
10615 3 => True, -- Parameter_Specifications (List3)
10616 4 => True, -- Handled_Statement_Sequence (Node4)
10617 5 => True), -- Entry_Index (Node5)
10619 N_Entry_Body =>
10620 (1 => True, -- Defining_Identifier (Node1)
10621 2 => True, -- Declarations (List2)
10622 3 => False, -- Activation_Chain_Entity (Node3-Sem)
10623 4 => True, -- Handled_Statement_Sequence (Node4)
10624 5 => True), -- Entry_Body_Formal_Part (Node5)
10626 N_Entry_Body_Formal_Part =>
10627 (1 => True, -- Condition (Node1)
10628 2 => False, -- unused
10629 3 => True, -- Parameter_Specifications (List3)
10630 4 => True, -- Entry_Index_Specification (Node4)
10631 5 => False), -- unused
10633 N_Entry_Index_Specification =>
10634 (1 => True, -- Defining_Identifier (Node1)
10635 2 => False, -- unused
10636 3 => False, -- unused
10637 4 => True, -- Discrete_Subtype_Definition (Node4)
10638 5 => False), -- unused
10640 N_Entry_Call_Statement =>
10641 (1 => False, -- unused
10642 2 => True, -- Name (Node2)
10643 3 => True, -- Parameter_Associations (List3)
10644 4 => False, -- First_Named_Actual (Node4-Sem)
10645 5 => False), -- unused
10647 N_Requeue_Statement =>
10648 (1 => False, -- unused
10649 2 => True, -- Name (Node2)
10650 3 => False, -- unused
10651 4 => False, -- unused
10652 5 => False), -- unused
10654 N_Delay_Until_Statement =>
10655 (1 => False, -- unused
10656 2 => False, -- unused
10657 3 => True, -- Expression (Node3)
10658 4 => False, -- unused
10659 5 => False), -- unused
10661 N_Delay_Relative_Statement =>
10662 (1 => False, -- unused
10663 2 => False, -- unused
10664 3 => True, -- Expression (Node3)
10665 4 => False, -- unused
10666 5 => False), -- unused
10668 N_Selective_Accept =>
10669 (1 => True, -- Select_Alternatives (List1)
10670 2 => False, -- unused
10671 3 => False, -- unused
10672 4 => True, -- Else_Statements (List4)
10673 5 => False), -- unused
10675 N_Accept_Alternative =>
10676 (1 => True, -- Condition (Node1)
10677 2 => True, -- Accept_Statement (Node2)
10678 3 => True, -- Statements (List3)
10679 4 => True, -- Pragmas_Before (List4)
10680 5 => False), -- Accept_Handler_Records (List5-Sem)
10682 N_Delay_Alternative =>
10683 (1 => True, -- Condition (Node1)
10684 2 => True, -- Delay_Statement (Node2)
10685 3 => True, -- Statements (List3)
10686 4 => True, -- Pragmas_Before (List4)
10687 5 => False), -- unused
10689 N_Terminate_Alternative =>
10690 (1 => True, -- Condition (Node1)
10691 2 => False, -- unused
10692 3 => False, -- unused
10693 4 => True, -- Pragmas_Before (List4)
10694 5 => True), -- Pragmas_After (List5)
10696 N_Timed_Entry_Call =>
10697 (1 => True, -- Entry_Call_Alternative (Node1)
10698 2 => False, -- unused
10699 3 => False, -- unused
10700 4 => True, -- Delay_Alternative (Node4)
10701 5 => False), -- unused
10703 N_Entry_Call_Alternative =>
10704 (1 => True, -- Entry_Call_Statement (Node1)
10705 2 => False, -- unused
10706 3 => True, -- Statements (List3)
10707 4 => True, -- Pragmas_Before (List4)
10708 5 => False), -- unused
10710 N_Conditional_Entry_Call =>
10711 (1 => True, -- Entry_Call_Alternative (Node1)
10712 2 => False, -- unused
10713 3 => False, -- unused
10714 4 => True, -- Else_Statements (List4)
10715 5 => False), -- unused
10717 N_Asynchronous_Select =>
10718 (1 => True, -- Triggering_Alternative (Node1)
10719 2 => True, -- Abortable_Part (Node2)
10720 3 => False, -- unused
10721 4 => False, -- unused
10722 5 => False), -- unused
10724 N_Triggering_Alternative =>
10725 (1 => True, -- Triggering_Statement (Node1)
10726 2 => False, -- unused
10727 3 => True, -- Statements (List3)
10728 4 => True, -- Pragmas_Before (List4)
10729 5 => False), -- unused
10731 N_Abortable_Part =>
10732 (1 => False, -- unused
10733 2 => False, -- unused
10734 3 => True, -- Statements (List3)
10735 4 => False, -- unused
10736 5 => False), -- unused
10738 N_Abort_Statement =>
10739 (1 => False, -- unused
10740 2 => True, -- Names (List2)
10741 3 => False, -- unused
10742 4 => False, -- unused
10743 5 => False), -- unused
10745 N_Compilation_Unit =>
10746 (1 => True, -- Context_Items (List1)
10747 2 => True, -- Unit (Node2)
10748 3 => False, -- First_Inlined_Subprogram (Node3-Sem)
10749 4 => False, -- Library_Unit (Node4-Sem)
10750 5 => True), -- Aux_Decls_Node (Node5)
10752 N_Compilation_Unit_Aux =>
10753 (1 => True, -- Actions (List1)
10754 2 => True, -- Declarations (List2)
10755 3 => False, -- unused
10756 4 => True, -- Config_Pragmas (List4)
10757 5 => True), -- Pragmas_After (List5)
10759 N_With_Clause =>
10760 (1 => False, -- unused
10761 2 => True, -- Name (Node2)
10762 3 => False, -- unused
10763 4 => False, -- Library_Unit (Node4-Sem)
10764 5 => False), -- Corresponding_Spec (Node5-Sem)
10766 N_Subprogram_Body_Stub =>
10767 (1 => True, -- Specification (Node1)
10768 2 => False, -- unused
10769 3 => False, -- unused
10770 4 => False, -- Library_Unit (Node4-Sem)
10771 5 => False), -- Corresponding_Body (Node5-Sem)
10773 N_Package_Body_Stub =>
10774 (1 => True, -- Defining_Identifier (Node1)
10775 2 => False, -- unused
10776 3 => False, -- unused
10777 4 => False, -- Library_Unit (Node4-Sem)
10778 5 => False), -- Corresponding_Body (Node5-Sem)
10780 N_Task_Body_Stub =>
10781 (1 => True, -- Defining_Identifier (Node1)
10782 2 => False, -- unused
10783 3 => False, -- unused
10784 4 => False, -- Library_Unit (Node4-Sem)
10785 5 => False), -- Corresponding_Body (Node5-Sem)
10787 N_Protected_Body_Stub =>
10788 (1 => True, -- Defining_Identifier (Node1)
10789 2 => False, -- unused
10790 3 => False, -- unused
10791 4 => False, -- Library_Unit (Node4-Sem)
10792 5 => False), -- Corresponding_Body (Node5-Sem)
10794 N_Subunit =>
10795 (1 => True, -- Proper_Body (Node1)
10796 2 => True, -- Name (Node2)
10797 3 => False, -- Corresponding_Stub (Node3-Sem)
10798 4 => False, -- unused
10799 5 => False), -- unused
10801 N_Exception_Declaration =>
10802 (1 => True, -- Defining_Identifier (Node1)
10803 2 => False, -- unused
10804 3 => False, -- Expression (Node3-Sem)
10805 4 => False, -- unused
10806 5 => False), -- unused
10808 N_Handled_Sequence_Of_Statements =>
10809 (1 => True, -- At_End_Proc (Node1)
10810 2 => False, -- First_Real_Statement (Node2-Sem)
10811 3 => True, -- Statements (List3)
10812 4 => True, -- End_Label (Node4)
10813 5 => True), -- Exception_Handlers (List5)
10815 N_Exception_Handler =>
10816 (1 => False, -- Local_Raise_Statements (Elist1)
10817 2 => True, -- Choice_Parameter (Node2)
10818 3 => True, -- Statements (List3)
10819 4 => True, -- Exception_Choices (List4)
10820 5 => False), -- Exception_Label (Node5)
10822 N_Raise_Statement =>
10823 (1 => False, -- unused
10824 2 => True, -- Name (Node2)
10825 3 => True, -- Expression (Node3)
10826 4 => False, -- unused
10827 5 => False), -- unused
10829 N_Generic_Subprogram_Declaration =>
10830 (1 => True, -- Specification (Node1)
10831 2 => True, -- Generic_Formal_Declarations (List2)
10832 3 => False, -- unused
10833 4 => False, -- Parent_Spec (Node4-Sem)
10834 5 => False), -- Corresponding_Body (Node5-Sem)
10836 N_Generic_Package_Declaration =>
10837 (1 => True, -- Specification (Node1)
10838 2 => True, -- Generic_Formal_Declarations (List2)
10839 3 => False, -- Activation_Chain_Entity (Node3-Sem)
10840 4 => False, -- Parent_Spec (Node4-Sem)
10841 5 => False), -- Corresponding_Body (Node5-Sem)
10843 N_Package_Instantiation =>
10844 (1 => True, -- Defining_Unit_Name (Node1)
10845 2 => True, -- Name (Node2)
10846 3 => True, -- Generic_Associations (List3)
10847 4 => False, -- Parent_Spec (Node4-Sem)
10848 5 => False), -- Instance_Spec (Node5-Sem)
10850 N_Procedure_Instantiation =>
10851 (1 => True, -- Defining_Unit_Name (Node1)
10852 2 => True, -- Name (Node2)
10853 3 => True, -- Generic_Associations (List3)
10854 4 => False, -- Parent_Spec (Node4-Sem)
10855 5 => False), -- Instance_Spec (Node5-Sem)
10857 N_Function_Instantiation =>
10858 (1 => True, -- Defining_Unit_Name (Node1)
10859 2 => True, -- Name (Node2)
10860 3 => True, -- Generic_Associations (List3)
10861 4 => False, -- Parent_Spec (Node4-Sem)
10862 5 => False), -- Instance_Spec (Node5-Sem)
10864 N_Generic_Association =>
10865 (1 => True, -- Explicit_Generic_Actual_Parameter (Node1)
10866 2 => True, -- Selector_Name (Node2)
10867 3 => False, -- unused
10868 4 => False, -- unused
10869 5 => False), -- unused
10871 N_Formal_Object_Declaration =>
10872 (1 => True, -- Defining_Identifier (Node1)
10873 2 => False, -- unused
10874 3 => True, -- Access_Definition (Node3)
10875 4 => True, -- Subtype_Mark (Node4)
10876 5 => True), -- Default_Expression (Node5)
10878 N_Formal_Type_Declaration =>
10879 (1 => True, -- Defining_Identifier (Node1)
10880 2 => False, -- unused
10881 3 => True, -- Formal_Type_Definition (Node3)
10882 4 => True, -- Discriminant_Specifications (List4)
10883 5 => False), -- unused
10885 N_Formal_Private_Type_Definition =>
10886 (1 => False, -- unused
10887 2 => False, -- unused
10888 3 => False, -- unused
10889 4 => False, -- unused
10890 5 => False), -- unused
10892 N_Formal_Derived_Type_Definition =>
10893 (1 => False, -- unused
10894 2 => True, -- Interface_List (List2)
10895 3 => False, -- unused
10896 4 => True, -- Subtype_Mark (Node4)
10897 5 => False), -- unused
10899 N_Formal_Discrete_Type_Definition =>
10900 (1 => False, -- unused
10901 2 => False, -- unused
10902 3 => False, -- unused
10903 4 => False, -- unused
10904 5 => False), -- unused
10906 N_Formal_Signed_Integer_Type_Definition =>
10907 (1 => False, -- unused
10908 2 => False, -- unused
10909 3 => False, -- unused
10910 4 => False, -- unused
10911 5 => False), -- unused
10913 N_Formal_Modular_Type_Definition =>
10914 (1 => False, -- unused
10915 2 => False, -- unused
10916 3 => False, -- unused
10917 4 => False, -- unused
10918 5 => False), -- unused
10920 N_Formal_Floating_Point_Definition =>
10921 (1 => False, -- unused
10922 2 => False, -- unused
10923 3 => False, -- unused
10924 4 => False, -- unused
10925 5 => False), -- unused
10927 N_Formal_Ordinary_Fixed_Point_Definition =>
10928 (1 => False, -- unused
10929 2 => False, -- unused
10930 3 => False, -- unused
10931 4 => False, -- unused
10932 5 => False), -- unused
10934 N_Formal_Decimal_Fixed_Point_Definition =>
10935 (1 => False, -- unused
10936 2 => False, -- unused
10937 3 => False, -- unused
10938 4 => False, -- unused
10939 5 => False), -- unused
10941 N_Formal_Concrete_Subprogram_Declaration =>
10942 (1 => True, -- Specification (Node1)
10943 2 => True, -- Default_Name (Node2)
10944 3 => False, -- unused
10945 4 => False, -- unused
10946 5 => False), -- unused
10948 N_Formal_Abstract_Subprogram_Declaration =>
10949 (1 => True, -- Specification (Node1)
10950 2 => True, -- Default_Name (Node2)
10951 3 => False, -- unused
10952 4 => False, -- unused
10953 5 => False), -- unused
10955 N_Formal_Package_Declaration =>
10956 (1 => True, -- Defining_Identifier (Node1)
10957 2 => True, -- Name (Node2)
10958 3 => True, -- Generic_Associations (List3)
10959 4 => False, -- unused
10960 5 => False), -- Instance_Spec (Node5-Sem)
10962 N_Attribute_Definition_Clause =>
10963 (1 => True, -- Chars (Name1)
10964 2 => True, -- Name (Node2)
10965 3 => True, -- Expression (Node3)
10966 4 => False, -- unused
10967 5 => False), -- Next_Rep_Item (Node5-Sem)
10969 N_Enumeration_Representation_Clause =>
10970 (1 => True, -- Identifier (Node1)
10971 2 => False, -- unused
10972 3 => True, -- Array_Aggregate (Node3)
10973 4 => False, -- unused
10974 5 => False), -- Next_Rep_Item (Node5-Sem)
10976 N_Record_Representation_Clause =>
10977 (1 => True, -- Identifier (Node1)
10978 2 => True, -- Mod_Clause (Node2)
10979 3 => True, -- Component_Clauses (List3)
10980 4 => False, -- unused
10981 5 => False), -- Next_Rep_Item (Node5-Sem)
10983 N_Component_Clause =>
10984 (1 => True, -- Component_Name (Node1)
10985 2 => True, -- Position (Node2)
10986 3 => True, -- First_Bit (Node3)
10987 4 => True, -- Last_Bit (Node4)
10988 5 => False), -- unused
10990 N_Code_Statement =>
10991 (1 => False, -- unused
10992 2 => False, -- unused
10993 3 => True, -- Expression (Node3)
10994 4 => False, -- unused
10995 5 => False), -- unused
10997 N_Op_Rotate_Left =>
10998 (1 => True, -- Chars (Name1)
10999 2 => True, -- Left_Opnd (Node2)
11000 3 => True, -- Right_Opnd (Node3)
11001 4 => False, -- Entity (Node4-Sem)
11002 5 => False), -- Etype (Node5-Sem)
11004 N_Op_Rotate_Right =>
11005 (1 => True, -- Chars (Name1)
11006 2 => True, -- Left_Opnd (Node2)
11007 3 => True, -- Right_Opnd (Node3)
11008 4 => False, -- Entity (Node4-Sem)
11009 5 => False), -- Etype (Node5-Sem)
11011 N_Op_Shift_Left =>
11012 (1 => True, -- Chars (Name1)
11013 2 => True, -- Left_Opnd (Node2)
11014 3 => True, -- Right_Opnd (Node3)
11015 4 => False, -- Entity (Node4-Sem)
11016 5 => False), -- Etype (Node5-Sem)
11018 N_Op_Shift_Right_Arithmetic =>
11019 (1 => True, -- Chars (Name1)
11020 2 => True, -- Left_Opnd (Node2)
11021 3 => True, -- Right_Opnd (Node3)
11022 4 => False, -- Entity (Node4-Sem)
11023 5 => False), -- Etype (Node5-Sem)
11025 N_Op_Shift_Right =>
11026 (1 => True, -- Chars (Name1)
11027 2 => True, -- Left_Opnd (Node2)
11028 3 => True, -- Right_Opnd (Node3)
11029 4 => False, -- Entity (Node4-Sem)
11030 5 => False), -- Etype (Node5-Sem)
11032 N_Delta_Constraint =>
11033 (1 => False, -- unused
11034 2 => False, -- unused
11035 3 => True, -- Delta_Expression (Node3)
11036 4 => True, -- Range_Constraint (Node4)
11037 5 => False), -- unused
11039 N_At_Clause =>
11040 (1 => True, -- Identifier (Node1)
11041 2 => False, -- unused
11042 3 => True, -- Expression (Node3)
11043 4 => False, -- unused
11044 5 => False), -- unused
11046 N_Mod_Clause =>
11047 (1 => False, -- unused
11048 2 => False, -- unused
11049 3 => True, -- Expression (Node3)
11050 4 => True, -- Pragmas_Before (List4)
11051 5 => False), -- unused
11053 N_Conditional_Expression =>
11054 (1 => True, -- Expressions (List1)
11055 2 => False, -- Then_Actions (List2-Sem)
11056 3 => False, -- Else_Actions (List3-Sem)
11057 4 => False, -- unused
11058 5 => False), -- Etype (Node5-Sem)
11060 N_Expanded_Name =>
11061 (1 => True, -- Chars (Name1)
11062 2 => True, -- Selector_Name (Node2)
11063 3 => True, -- Prefix (Node3)
11064 4 => False, -- Entity (Node4-Sem)
11065 5 => False), -- Etype (Node5-Sem)
11067 N_Expression_With_Actions =>
11068 (1 => True, -- Actions (List1)
11069 2 => False, -- unused
11070 3 => True, -- Expression (Node3)
11071 4 => False, -- unused
11072 5 => False), -- unused
11074 N_Free_Statement =>
11075 (1 => False, -- Storage_Pool (Node1-Sem)
11076 2 => False, -- Procedure_To_Call (Node2-Sem)
11077 3 => True, -- Expression (Node3)
11078 4 => False, -- Actual_Designated_Subtype (Node4-Sem)
11079 5 => False), -- unused
11081 N_Freeze_Entity =>
11082 (1 => True, -- Actions (List1)
11083 2 => False, -- Access_Types_To_Process (Elist2-Sem)
11084 3 => False, -- TSS_Elist (Elist3-Sem)
11085 4 => False, -- Entity (Node4-Sem)
11086 5 => False), -- First_Subtype_Link (Node5-Sem)
11088 N_Implicit_Label_Declaration =>
11089 (1 => True, -- Defining_Identifier (Node1)
11090 2 => False, -- Label_Construct (Node2-Sem)
11091 3 => False, -- unused
11092 4 => False, -- unused
11093 5 => False), -- unused
11095 N_Itype_Reference =>
11096 (1 => False, -- Itype (Node1-Sem)
11097 2 => False, -- unused
11098 3 => False, -- unused
11099 4 => False, -- unused
11100 5 => False), -- unused
11102 N_Raise_Constraint_Error =>
11103 (1 => True, -- Condition (Node1)
11104 2 => False, -- unused
11105 3 => True, -- Reason (Uint3)
11106 4 => False, -- unused
11107 5 => False), -- Etype (Node5-Sem)
11109 N_Raise_Program_Error =>
11110 (1 => True, -- Condition (Node1)
11111 2 => False, -- unused
11112 3 => True, -- Reason (Uint3)
11113 4 => False, -- unused
11114 5 => False), -- Etype (Node5-Sem)
11116 N_Raise_Storage_Error =>
11117 (1 => True, -- Condition (Node1)
11118 2 => False, -- unused
11119 3 => True, -- Reason (Uint3)
11120 4 => False, -- unused
11121 5 => False), -- Etype (Node5-Sem)
11123 N_Push_Constraint_Error_Label =>
11124 (1 => False, -- unused
11125 2 => False, -- unused
11126 3 => False, -- unused
11127 4 => False, -- unused
11128 5 => False), -- unused
11130 N_Push_Program_Error_Label =>
11131 (1 => False, -- Exception_Label
11132 2 => False, -- unused
11133 3 => False, -- unused
11134 4 => False, -- unused
11135 5 => False), -- Exception_Label
11137 N_Push_Storage_Error_Label =>
11138 (1 => False, -- Exception_Label
11139 2 => False, -- unused
11140 3 => False, -- unused
11141 4 => False, -- unused
11142 5 => False), -- Exception_Label
11144 N_Pop_Constraint_Error_Label =>
11145 (1 => False, -- unused
11146 2 => False, -- unused
11147 3 => False, -- unused
11148 4 => False, -- unused
11149 5 => False), -- unused
11151 N_Pop_Program_Error_Label =>
11152 (1 => False, -- unused
11153 2 => False, -- unused
11154 3 => False, -- unused
11155 4 => False, -- unused
11156 5 => False), -- unused
11158 N_Pop_Storage_Error_Label =>
11159 (1 => False, -- unused
11160 2 => False, -- unused
11161 3 => False, -- unused
11162 4 => False, -- unused
11163 5 => False), -- unused
11165 N_Reference =>
11166 (1 => False, -- unused
11167 2 => False, -- unused
11168 3 => True, -- Prefix (Node3)
11169 4 => False, -- unused
11170 5 => False), -- Etype (Node5-Sem)
11172 N_Subprogram_Info =>
11173 (1 => True, -- Identifier (Node1)
11174 2 => False, -- unused
11175 3 => False, -- unused
11176 4 => False, -- unused
11177 5 => False), -- Etype (Node5-Sem)
11179 N_Unchecked_Expression =>
11180 (1 => False, -- unused
11181 2 => False, -- unused
11182 3 => True, -- Expression (Node3)
11183 4 => False, -- unused
11184 5 => False), -- Etype (Node5-Sem)
11186 N_Unchecked_Type_Conversion =>
11187 (1 => False, -- unused
11188 2 => False, -- unused
11189 3 => True, -- Expression (Node3)
11190 4 => True, -- Subtype_Mark (Node4)
11191 5 => False), -- Etype (Node5-Sem)
11193 N_Validate_Unchecked_Conversion =>
11194 (1 => False, -- Source_Type (Node1-Sem)
11195 2 => False, -- Target_Type (Node2-Sem)
11196 3 => False, -- unused
11197 4 => False, -- unused
11198 5 => False), -- unused
11200 -- End of inserted output from makeisf program
11202 -- Entries for SCIL nodes
11204 N_SCIL_Dispatch_Table_Tag_Init =>
11205 (1 => False, -- unused
11206 2 => False, -- unused
11207 3 => False, -- unused
11208 4 => False, -- SCIL_Entity (Node4-Sem)
11209 5 => False), -- unused
11211 N_SCIL_Dispatching_Call =>
11212 (1 => False, -- unused
11213 2 => False, -- SCIL_Target_Prim (Node2-Sem)
11214 3 => False, -- unused
11215 4 => False, -- SCIL_Entity (Node4-Sem)
11216 5 => False), -- SCIL_Controlling_Tag (Node5-Sem)
11218 N_SCIL_Membership_Test =>
11219 (1 => False, -- unused
11220 2 => False, -- unused
11221 3 => False, -- unused
11222 4 => False, -- SCIL_Entity (Node4-Sem)
11223 5 => False), -- SCIL_Tag_Value (Node5-Sem)
11225 -- Entries for Empty, Error and Unused. Even thought these have a Chars
11226 -- field for debugging purposes, they are not really syntactic fields, so
11227 -- we mark all fields as unused.
11229 N_Empty =>
11230 (1 => False, -- unused
11231 2 => False, -- unused
11232 3 => False, -- unused
11233 4 => False, -- unused
11234 5 => False), -- unused
11236 N_Error =>
11237 (1 => False, -- unused
11238 2 => False, -- unused
11239 3 => False, -- unused
11240 4 => False, -- unused
11241 5 => False), -- unused
11243 N_Unused_At_Start =>
11244 (1 => False, -- unused
11245 2 => False, -- unused
11246 3 => False, -- unused
11247 4 => False, -- unused
11248 5 => False), -- unused
11250 N_Unused_At_End =>
11251 (1 => False, -- unused
11252 2 => False, -- unused
11253 3 => False, -- unused
11254 4 => False, -- unused
11255 5 => False)); -- unused
11257 --------------------
11258 -- Inline Pragmas --
11259 --------------------
11261 pragma Inline (ABE_Is_Certain);
11262 pragma Inline (Abort_Present);
11263 pragma Inline (Abortable_Part);
11264 pragma Inline (Abstract_Present);
11265 pragma Inline (Accept_Handler_Records);
11266 pragma Inline (Accept_Statement);
11267 pragma Inline (Access_Definition);
11268 pragma Inline (Access_To_Subprogram_Definition);
11269 pragma Inline (Access_Types_To_Process);
11270 pragma Inline (Actions);
11271 pragma Inline (Activation_Chain_Entity);
11272 pragma Inline (Acts_As_Spec);
11273 pragma Inline (Actual_Designated_Subtype);
11274 pragma Inline (Address_Warning_Posted);
11275 pragma Inline (Aggregate_Bounds);
11276 pragma Inline (Aliased_Present);
11277 pragma Inline (All_Others);
11278 pragma Inline (All_Present);
11279 pragma Inline (Alternatives);
11280 pragma Inline (Ancestor_Part);
11281 pragma Inline (Array_Aggregate);
11282 pragma Inline (Assignment_OK);
11283 pragma Inline (Associated_Node);
11284 pragma Inline (At_End_Proc);
11285 pragma Inline (Attribute_Name);
11286 pragma Inline (Aux_Decls_Node);
11287 pragma Inline (Backwards_OK);
11288 pragma Inline (Bad_Is_Detected);
11289 pragma Inline (Body_To_Inline);
11290 pragma Inline (Body_Required);
11291 pragma Inline (By_Ref);
11292 pragma Inline (Box_Present);
11293 pragma Inline (Char_Literal_Value);
11294 pragma Inline (Chars);
11295 pragma Inline (Check_Address_Alignment);
11296 pragma Inline (Choice_Parameter);
11297 pragma Inline (Choices);
11298 pragma Inline (Coextensions);
11299 pragma Inline (Comes_From_Extended_Return_Statement);
11300 pragma Inline (Compile_Time_Known_Aggregate);
11301 pragma Inline (Component_Associations);
11302 pragma Inline (Component_Clauses);
11303 pragma Inline (Component_Definition);
11304 pragma Inline (Component_Items);
11305 pragma Inline (Component_List);
11306 pragma Inline (Component_Name);
11307 pragma Inline (Componentwise_Assignment);
11308 pragma Inline (Condition);
11309 pragma Inline (Condition_Actions);
11310 pragma Inline (Config_Pragmas);
11311 pragma Inline (Constant_Present);
11312 pragma Inline (Constraint);
11313 pragma Inline (Constraints);
11314 pragma Inline (Context_Installed);
11315 pragma Inline (Context_Items);
11316 pragma Inline (Context_Pending);
11317 pragma Inline (Controlling_Argument);
11318 pragma Inline (Conversion_OK);
11319 pragma Inline (Corresponding_Body);
11320 pragma Inline (Corresponding_Formal_Spec);
11321 pragma Inline (Corresponding_Generic_Association);
11322 pragma Inline (Corresponding_Integer_Value);
11323 pragma Inline (Corresponding_Spec);
11324 pragma Inline (Corresponding_Stub);
11325 pragma Inline (Dcheck_Function);
11326 pragma Inline (Debug_Statement);
11327 pragma Inline (Declarations);
11328 pragma Inline (Default_Expression);
11329 pragma Inline (Default_Name);
11330 pragma Inline (Defining_Identifier);
11331 pragma Inline (Defining_Unit_Name);
11332 pragma Inline (Delay_Alternative);
11333 pragma Inline (Delay_Statement);
11334 pragma Inline (Delta_Expression);
11335 pragma Inline (Digits_Expression);
11336 pragma Inline (Discr_Check_Funcs_Built);
11337 pragma Inline (Discrete_Choices);
11338 pragma Inline (Discrete_Range);
11339 pragma Inline (Discrete_Subtype_Definition);
11340 pragma Inline (Discrete_Subtype_Definitions);
11341 pragma Inline (Discriminant_Specifications);
11342 pragma Inline (Discriminant_Type);
11343 pragma Inline (Do_Accessibility_Check);
11344 pragma Inline (Do_Discriminant_Check);
11345 pragma Inline (Do_Length_Check);
11346 pragma Inline (Do_Division_Check);
11347 pragma Inline (Do_Overflow_Check);
11348 pragma Inline (Do_Range_Check);
11349 pragma Inline (Do_Storage_Check);
11350 pragma Inline (Do_Tag_Check);
11351 pragma Inline (Elaborate_Present);
11352 pragma Inline (Elaborate_All_Desirable);
11353 pragma Inline (Elaborate_All_Present);
11354 pragma Inline (Elaborate_Desirable);
11355 pragma Inline (Elaboration_Boolean);
11356 pragma Inline (Else_Actions);
11357 pragma Inline (Else_Statements);
11358 pragma Inline (Elsif_Parts);
11359 pragma Inline (Enclosing_Variant);
11360 pragma Inline (End_Label);
11361 pragma Inline (End_Span);
11362 pragma Inline (Entity);
11363 pragma Inline (Entity_Or_Associated_Node);
11364 pragma Inline (Entry_Body_Formal_Part);
11365 pragma Inline (Entry_Call_Alternative);
11366 pragma Inline (Entry_Call_Statement);
11367 pragma Inline (Entry_Direct_Name);
11368 pragma Inline (Entry_Index);
11369 pragma Inline (Entry_Index_Specification);
11370 pragma Inline (Etype);
11371 pragma Inline (Exception_Choices);
11372 pragma Inline (Exception_Handlers);
11373 pragma Inline (Exception_Junk);
11374 pragma Inline (Exception_Label);
11375 pragma Inline (Expansion_Delayed);
11376 pragma Inline (Explicit_Actual_Parameter);
11377 pragma Inline (Explicit_Generic_Actual_Parameter);
11378 pragma Inline (Expression);
11379 pragma Inline (Expressions);
11380 pragma Inline (First_Bit);
11381 pragma Inline (First_Inlined_Subprogram);
11382 pragma Inline (First_Name);
11383 pragma Inline (First_Named_Actual);
11384 pragma Inline (First_Real_Statement);
11385 pragma Inline (First_Subtype_Link);
11386 pragma Inline (Float_Truncate);
11387 pragma Inline (Formal_Type_Definition);
11388 pragma Inline (Forwards_OK);
11389 pragma Inline (From_At_End);
11390 pragma Inline (From_At_Mod);
11391 pragma Inline (From_Default);
11392 pragma Inline (Generic_Associations);
11393 pragma Inline (Generic_Formal_Declarations);
11394 pragma Inline (Generic_Parent);
11395 pragma Inline (Generic_Parent_Type);
11396 pragma Inline (Handled_Statement_Sequence);
11397 pragma Inline (Handler_List_Entry);
11398 pragma Inline (Has_Created_Identifier);
11399 pragma Inline (Has_Dynamic_Length_Check);
11400 pragma Inline (Has_Dynamic_Range_Check);
11401 pragma Inline (Has_Init_Expression);
11402 pragma Inline (Has_Local_Raise);
11403 pragma Inline (Has_Self_Reference);
11404 pragma Inline (Has_No_Elaboration_Code);
11405 pragma Inline (Has_Priority_Pragma);
11406 pragma Inline (Has_Private_View);
11407 pragma Inline (Has_Relative_Deadline_Pragma);
11408 pragma Inline (Has_Storage_Size_Pragma);
11409 pragma Inline (Has_Task_Info_Pragma);
11410 pragma Inline (Has_Task_Name_Pragma);
11411 pragma Inline (Has_Wide_Character);
11412 pragma Inline (Has_Wide_Wide_Character);
11413 pragma Inline (Hidden_By_Use_Clause);
11414 pragma Inline (High_Bound);
11415 pragma Inline (Identifier);
11416 pragma Inline (Implicit_With);
11417 pragma Inline (Interface_List);
11418 pragma Inline (Interface_Present);
11419 pragma Inline (Includes_Infinities);
11420 pragma Inline (Import_Interface_Present);
11421 pragma Inline (In_Present);
11422 pragma Inline (Inherited_Discriminant);
11423 pragma Inline (Instance_Spec);
11424 pragma Inline (Intval);
11425 pragma Inline (Is_Accessibility_Actual);
11426 pragma Inline (Is_Asynchronous_Call_Block);
11427 pragma Inline (Is_Component_Left_Opnd);
11428 pragma Inline (Is_Component_Right_Opnd);
11429 pragma Inline (Is_Controlling_Actual);
11430 pragma Inline (Is_Dynamic_Coextension);
11431 pragma Inline (Is_Elsif);
11432 pragma Inline (Is_Entry_Barrier_Function);
11433 pragma Inline (Is_Expanded_Build_In_Place_Call);
11434 pragma Inline (Is_Folded_In_Parser);
11435 pragma Inline (Is_In_Discriminant_Check);
11436 pragma Inline (Is_Machine_Number);
11437 pragma Inline (Is_Null_Loop);
11438 pragma Inline (Is_Overloaded);
11439 pragma Inline (Is_Power_Of_2_For_Shift);
11440 pragma Inline (Is_Protected_Subprogram_Body);
11441 pragma Inline (Is_Static_Coextension);
11442 pragma Inline (Is_Static_Expression);
11443 pragma Inline (Is_Subprogram_Descriptor);
11444 pragma Inline (Is_Task_Allocation_Block);
11445 pragma Inline (Is_Task_Master);
11446 pragma Inline (Iteration_Scheme);
11447 pragma Inline (Itype);
11448 pragma Inline (Kill_Range_Check);
11449 pragma Inline (Last_Bit);
11450 pragma Inline (Last_Name);
11451 pragma Inline (Library_Unit);
11452 pragma Inline (Label_Construct);
11453 pragma Inline (Left_Opnd);
11454 pragma Inline (Limited_View_Installed);
11455 pragma Inline (Limited_Present);
11456 pragma Inline (Literals);
11457 pragma Inline (Local_Raise_Not_OK);
11458 pragma Inline (Local_Raise_Statements);
11459 pragma Inline (Loop_Actions);
11460 pragma Inline (Loop_Parameter_Specification);
11461 pragma Inline (Low_Bound);
11462 pragma Inline (Mod_Clause);
11463 pragma Inline (More_Ids);
11464 pragma Inline (Must_Be_Byte_Aligned);
11465 pragma Inline (Must_Not_Freeze);
11466 pragma Inline (Must_Not_Override);
11467 pragma Inline (Must_Override);
11468 pragma Inline (Name);
11469 pragma Inline (Names);
11470 pragma Inline (Next_Entity);
11471 pragma Inline (Next_Exit_Statement);
11472 pragma Inline (Next_Implicit_With);
11473 pragma Inline (Next_Named_Actual);
11474 pragma Inline (Next_Pragma);
11475 pragma Inline (Next_Rep_Item);
11476 pragma Inline (Next_Use_Clause);
11477 pragma Inline (No_Ctrl_Actions);
11478 pragma Inline (No_Elaboration_Check);
11479 pragma Inline (No_Entities_Ref_In_Spec);
11480 pragma Inline (No_Initialization);
11481 pragma Inline (No_Truncation);
11482 pragma Inline (Null_Present);
11483 pragma Inline (Null_Exclusion_Present);
11484 pragma Inline (Null_Exclusion_In_Return_Present);
11485 pragma Inline (Null_Record_Present);
11486 pragma Inline (Object_Definition);
11487 pragma Inline (Original_Discriminant);
11488 pragma Inline (Original_Entity);
11489 pragma Inline (Others_Discrete_Choices);
11490 pragma Inline (Out_Present);
11491 pragma Inline (Parameter_Associations);
11492 pragma Inline (Parameter_Specifications);
11493 pragma Inline (Parameter_List_Truncated);
11494 pragma Inline (Parameter_Type);
11495 pragma Inline (Parent_Spec);
11496 pragma Inline (Position);
11497 pragma Inline (Pragma_Argument_Associations);
11498 pragma Inline (Pragma_Enabled);
11499 pragma Inline (Pragma_Identifier);
11500 pragma Inline (Pragmas_After);
11501 pragma Inline (Pragmas_Before);
11502 pragma Inline (Prefix);
11503 pragma Inline (Present_Expr);
11504 pragma Inline (Prev_Ids);
11505 pragma Inline (Print_In_Hex);
11506 pragma Inline (Private_Declarations);
11507 pragma Inline (Private_Present);
11508 pragma Inline (Procedure_To_Call);
11509 pragma Inline (Proper_Body);
11510 pragma Inline (Protected_Definition);
11511 pragma Inline (Protected_Present);
11512 pragma Inline (Raises_Constraint_Error);
11513 pragma Inline (Range_Constraint);
11514 pragma Inline (Range_Expression);
11515 pragma Inline (Real_Range_Specification);
11516 pragma Inline (Realval);
11517 pragma Inline (Reason);
11518 pragma Inline (Record_Extension_Part);
11519 pragma Inline (Redundant_Use);
11520 pragma Inline (Renaming_Exception);
11521 pragma Inline (Result_Definition);
11522 pragma Inline (Return_Object_Declarations);
11523 pragma Inline (Return_Statement_Entity);
11524 pragma Inline (Reverse_Present);
11525 pragma Inline (Right_Opnd);
11526 pragma Inline (Rounded_Result);
11527 pragma Inline (SCIL_Controlling_Tag);
11528 pragma Inline (SCIL_Entity);
11529 pragma Inline (SCIL_Tag_Value);
11530 pragma Inline (SCIL_Target_Prim);
11531 pragma Inline (Scope);
11532 pragma Inline (Select_Alternatives);
11533 pragma Inline (Selector_Name);
11534 pragma Inline (Selector_Names);
11535 pragma Inline (Shift_Count_OK);
11536 pragma Inline (Source_Type);
11537 pragma Inline (Specification);
11538 pragma Inline (Statements);
11539 pragma Inline (Static_Processing_OK);
11540 pragma Inline (Storage_Pool);
11541 pragma Inline (Strval);
11542 pragma Inline (Subtype_Indication);
11543 pragma Inline (Subtype_Mark);
11544 pragma Inline (Subtype_Marks);
11545 pragma Inline (Suppress_Loop_Warnings);
11546 pragma Inline (Synchronized_Present);
11547 pragma Inline (Tagged_Present);
11548 pragma Inline (Target_Type);
11549 pragma Inline (Task_Definition);
11550 pragma Inline (Task_Present);
11551 pragma Inline (Then_Actions);
11552 pragma Inline (Then_Statements);
11553 pragma Inline (Triggering_Alternative);
11554 pragma Inline (Triggering_Statement);
11555 pragma Inline (Treat_Fixed_As_Integer);
11556 pragma Inline (TSS_Elist);
11557 pragma Inline (Type_Definition);
11558 pragma Inline (Unit);
11559 pragma Inline (Unknown_Discriminants_Present);
11560 pragma Inline (Unreferenced_In_Spec);
11561 pragma Inline (Variant_Part);
11562 pragma Inline (Variants);
11563 pragma Inline (Visible_Declarations);
11564 pragma Inline (Was_Originally_Stub);
11565 pragma Inline (Withed_Body);
11566 pragma Inline (Zero_Cost_Handling);
11568 pragma Inline (Set_ABE_Is_Certain);
11569 pragma Inline (Set_Abort_Present);
11570 pragma Inline (Set_Abortable_Part);
11571 pragma Inline (Set_Abstract_Present);
11572 pragma Inline (Set_Accept_Handler_Records);
11573 pragma Inline (Set_Accept_Statement);
11574 pragma Inline (Set_Access_Definition);
11575 pragma Inline (Set_Access_To_Subprogram_Definition);
11576 pragma Inline (Set_Access_Types_To_Process);
11577 pragma Inline (Set_Actions);
11578 pragma Inline (Set_Activation_Chain_Entity);
11579 pragma Inline (Set_Acts_As_Spec);
11580 pragma Inline (Set_Actual_Designated_Subtype);
11581 pragma Inline (Set_Address_Warning_Posted);
11582 pragma Inline (Set_Aggregate_Bounds);
11583 pragma Inline (Set_Aliased_Present);
11584 pragma Inline (Set_All_Others);
11585 pragma Inline (Set_All_Present);
11586 pragma Inline (Set_Alternatives);
11587 pragma Inline (Set_Ancestor_Part);
11588 pragma Inline (Set_Array_Aggregate);
11589 pragma Inline (Set_Assignment_OK);
11590 pragma Inline (Set_Associated_Node);
11591 pragma Inline (Set_At_End_Proc);
11592 pragma Inline (Set_Attribute_Name);
11593 pragma Inline (Set_Aux_Decls_Node);
11594 pragma Inline (Set_Backwards_OK);
11595 pragma Inline (Set_Bad_Is_Detected);
11596 pragma Inline (Set_Body_To_Inline);
11597 pragma Inline (Set_Body_Required);
11598 pragma Inline (Set_By_Ref);
11599 pragma Inline (Set_Box_Present);
11600 pragma Inline (Set_Char_Literal_Value);
11601 pragma Inline (Set_Chars);
11602 pragma Inline (Set_Check_Address_Alignment);
11603 pragma Inline (Set_Choice_Parameter);
11604 pragma Inline (Set_Choices);
11605 pragma Inline (Set_Coextensions);
11606 pragma Inline (Set_Comes_From_Extended_Return_Statement);
11607 pragma Inline (Set_Compile_Time_Known_Aggregate);
11608 pragma Inline (Set_Component_Associations);
11609 pragma Inline (Set_Component_Clauses);
11610 pragma Inline (Set_Component_Definition);
11611 pragma Inline (Set_Component_Items);
11612 pragma Inline (Set_Component_List);
11613 pragma Inline (Set_Component_Name);
11614 pragma Inline (Set_Componentwise_Assignment);
11615 pragma Inline (Set_Condition);
11616 pragma Inline (Set_Condition_Actions);
11617 pragma Inline (Set_Config_Pragmas);
11618 pragma Inline (Set_Constant_Present);
11619 pragma Inline (Set_Constraint);
11620 pragma Inline (Set_Constraints);
11621 pragma Inline (Set_Context_Installed);
11622 pragma Inline (Set_Context_Items);
11623 pragma Inline (Set_Context_Pending);
11624 pragma Inline (Set_Controlling_Argument);
11625 pragma Inline (Set_Conversion_OK);
11626 pragma Inline (Set_Corresponding_Body);
11627 pragma Inline (Set_Corresponding_Formal_Spec);
11628 pragma Inline (Set_Corresponding_Generic_Association);
11629 pragma Inline (Set_Corresponding_Integer_Value);
11630 pragma Inline (Set_Corresponding_Spec);
11631 pragma Inline (Set_Corresponding_Stub);
11632 pragma Inline (Set_Dcheck_Function);
11633 pragma Inline (Set_Debug_Statement);
11634 pragma Inline (Set_Declarations);
11635 pragma Inline (Set_Default_Expression);
11636 pragma Inline (Set_Default_Name);
11637 pragma Inline (Set_Defining_Identifier);
11638 pragma Inline (Set_Defining_Unit_Name);
11639 pragma Inline (Set_Delay_Alternative);
11640 pragma Inline (Set_Delay_Statement);
11641 pragma Inline (Set_Delta_Expression);
11642 pragma Inline (Set_Digits_Expression);
11643 pragma Inline (Set_Discr_Check_Funcs_Built);
11644 pragma Inline (Set_Discrete_Choices);
11645 pragma Inline (Set_Discrete_Range);
11646 pragma Inline (Set_Discrete_Subtype_Definition);
11647 pragma Inline (Set_Discrete_Subtype_Definitions);
11648 pragma Inline (Set_Discriminant_Specifications);
11649 pragma Inline (Set_Discriminant_Type);
11650 pragma Inline (Set_Do_Accessibility_Check);
11651 pragma Inline (Set_Do_Discriminant_Check);
11652 pragma Inline (Set_Do_Length_Check);
11653 pragma Inline (Set_Do_Division_Check);
11654 pragma Inline (Set_Do_Overflow_Check);
11655 pragma Inline (Set_Do_Range_Check);
11656 pragma Inline (Set_Do_Storage_Check);
11657 pragma Inline (Set_Do_Tag_Check);
11658 pragma Inline (Set_Elaborate_Present);
11659 pragma Inline (Set_Elaborate_All_Desirable);
11660 pragma Inline (Set_Elaborate_All_Present);
11661 pragma Inline (Set_Elaborate_Desirable);
11662 pragma Inline (Set_Elaboration_Boolean);
11663 pragma Inline (Set_Else_Actions);
11664 pragma Inline (Set_Else_Statements);
11665 pragma Inline (Set_Elsif_Parts);
11666 pragma Inline (Set_Enclosing_Variant);
11667 pragma Inline (Set_End_Label);
11668 pragma Inline (Set_End_Span);
11669 pragma Inline (Set_Entity);
11670 pragma Inline (Set_Entry_Body_Formal_Part);
11671 pragma Inline (Set_Entry_Call_Alternative);
11672 pragma Inline (Set_Entry_Call_Statement);
11673 pragma Inline (Set_Entry_Direct_Name);
11674 pragma Inline (Set_Entry_Index);
11675 pragma Inline (Set_Entry_Index_Specification);
11676 pragma Inline (Set_Etype);
11677 pragma Inline (Set_Exception_Choices);
11678 pragma Inline (Set_Exception_Handlers);
11679 pragma Inline (Set_Exception_Junk);
11680 pragma Inline (Set_Exception_Label);
11681 pragma Inline (Set_Expansion_Delayed);
11682 pragma Inline (Set_Explicit_Actual_Parameter);
11683 pragma Inline (Set_Explicit_Generic_Actual_Parameter);
11684 pragma Inline (Set_Expression);
11685 pragma Inline (Set_Expressions);
11686 pragma Inline (Set_First_Bit);
11687 pragma Inline (Set_First_Inlined_Subprogram);
11688 pragma Inline (Set_First_Name);
11689 pragma Inline (Set_First_Named_Actual);
11690 pragma Inline (Set_First_Real_Statement);
11691 pragma Inline (Set_First_Subtype_Link);
11692 pragma Inline (Set_Float_Truncate);
11693 pragma Inline (Set_Formal_Type_Definition);
11694 pragma Inline (Set_Forwards_OK);
11695 pragma Inline (Set_From_At_End);
11696 pragma Inline (Set_From_At_Mod);
11697 pragma Inline (Set_From_Default);
11698 pragma Inline (Set_Generic_Associations);
11699 pragma Inline (Set_Generic_Formal_Declarations);
11700 pragma Inline (Set_Generic_Parent);
11701 pragma Inline (Set_Generic_Parent_Type);
11702 pragma Inline (Set_Handled_Statement_Sequence);
11703 pragma Inline (Set_Handler_List_Entry);
11704 pragma Inline (Set_Has_Created_Identifier);
11705 pragma Inline (Set_Has_Dynamic_Length_Check);
11706 pragma Inline (Set_Has_Init_Expression);
11707 pragma Inline (Set_Has_Local_Raise);
11708 pragma Inline (Set_Has_Dynamic_Range_Check);
11709 pragma Inline (Set_Has_No_Elaboration_Code);
11710 pragma Inline (Set_Has_Priority_Pragma);
11711 pragma Inline (Set_Has_Private_View);
11712 pragma Inline (Set_Has_Relative_Deadline_Pragma);
11713 pragma Inline (Set_Has_Storage_Size_Pragma);
11714 pragma Inline (Set_Has_Task_Info_Pragma);
11715 pragma Inline (Set_Has_Task_Name_Pragma);
11716 pragma Inline (Set_Has_Wide_Character);
11717 pragma Inline (Set_Has_Wide_Wide_Character);
11718 pragma Inline (Set_Hidden_By_Use_Clause);
11719 pragma Inline (Set_High_Bound);
11720 pragma Inline (Set_Identifier);
11721 pragma Inline (Set_Implicit_With);
11722 pragma Inline (Set_Includes_Infinities);
11723 pragma Inline (Set_Interface_List);
11724 pragma Inline (Set_Interface_Present);
11725 pragma Inline (Set_Import_Interface_Present);
11726 pragma Inline (Set_In_Present);
11727 pragma Inline (Set_Inherited_Discriminant);
11728 pragma Inline (Set_Instance_Spec);
11729 pragma Inline (Set_Intval);
11730 pragma Inline (Set_Is_Accessibility_Actual);
11731 pragma Inline (Set_Is_Asynchronous_Call_Block);
11732 pragma Inline (Set_Is_Component_Left_Opnd);
11733 pragma Inline (Set_Is_Component_Right_Opnd);
11734 pragma Inline (Set_Is_Controlling_Actual);
11735 pragma Inline (Set_Is_Dynamic_Coextension);
11736 pragma Inline (Set_Is_Elsif);
11737 pragma Inline (Set_Is_Entry_Barrier_Function);
11738 pragma Inline (Set_Is_Expanded_Build_In_Place_Call);
11739 pragma Inline (Set_Is_Folded_In_Parser);
11740 pragma Inline (Set_Is_In_Discriminant_Check);
11741 pragma Inline (Set_Is_Machine_Number);
11742 pragma Inline (Set_Is_Null_Loop);
11743 pragma Inline (Set_Is_Overloaded);
11744 pragma Inline (Set_Is_Power_Of_2_For_Shift);
11745 pragma Inline (Set_Is_Protected_Subprogram_Body);
11746 pragma Inline (Set_Has_Self_Reference);
11747 pragma Inline (Set_Is_Static_Coextension);
11748 pragma Inline (Set_Is_Static_Expression);
11749 pragma Inline (Set_Is_Subprogram_Descriptor);
11750 pragma Inline (Set_Is_Task_Allocation_Block);
11751 pragma Inline (Set_Is_Task_Master);
11752 pragma Inline (Set_Iteration_Scheme);
11753 pragma Inline (Set_Itype);
11754 pragma Inline (Set_Kill_Range_Check);
11755 pragma Inline (Set_Last_Bit);
11756 pragma Inline (Set_Last_Name);
11757 pragma Inline (Set_Library_Unit);
11758 pragma Inline (Set_Label_Construct);
11759 pragma Inline (Set_Left_Opnd);
11760 pragma Inline (Set_Limited_View_Installed);
11761 pragma Inline (Set_Limited_Present);
11762 pragma Inline (Set_Literals);
11763 pragma Inline (Set_Local_Raise_Not_OK);
11764 pragma Inline (Set_Local_Raise_Statements);
11765 pragma Inline (Set_Loop_Actions);
11766 pragma Inline (Set_Loop_Parameter_Specification);
11767 pragma Inline (Set_Low_Bound);
11768 pragma Inline (Set_Mod_Clause);
11769 pragma Inline (Set_More_Ids);
11770 pragma Inline (Set_Must_Be_Byte_Aligned);
11771 pragma Inline (Set_Must_Not_Freeze);
11772 pragma Inline (Set_Must_Not_Override);
11773 pragma Inline (Set_Must_Override);
11774 pragma Inline (Set_Name);
11775 pragma Inline (Set_Names);
11776 pragma Inline (Set_Next_Entity);
11777 pragma Inline (Set_Next_Exit_Statement);
11778 pragma Inline (Set_Next_Implicit_With);
11779 pragma Inline (Set_Next_Named_Actual);
11780 pragma Inline (Set_Next_Pragma);
11781 pragma Inline (Set_Next_Rep_Item);
11782 pragma Inline (Set_Next_Use_Clause);
11783 pragma Inline (Set_No_Ctrl_Actions);
11784 pragma Inline (Set_No_Elaboration_Check);
11785 pragma Inline (Set_No_Entities_Ref_In_Spec);
11786 pragma Inline (Set_No_Initialization);
11787 pragma Inline (Set_No_Truncation);
11788 pragma Inline (Set_Null_Present);
11789 pragma Inline (Set_Null_Exclusion_Present);
11790 pragma Inline (Set_Null_Exclusion_In_Return_Present);
11791 pragma Inline (Set_Null_Record_Present);
11792 pragma Inline (Set_Object_Definition);
11793 pragma Inline (Set_Original_Discriminant);
11794 pragma Inline (Set_Original_Entity);
11795 pragma Inline (Set_Others_Discrete_Choices);
11796 pragma Inline (Set_Out_Present);
11797 pragma Inline (Set_Parameter_Associations);
11798 pragma Inline (Set_Parameter_Specifications);
11799 pragma Inline (Set_Parameter_List_Truncated);
11800 pragma Inline (Set_Parameter_Type);
11801 pragma Inline (Set_Parent_Spec);
11802 pragma Inline (Set_Position);
11803 pragma Inline (Set_Pragma_Argument_Associations);
11804 pragma Inline (Set_Pragma_Enabled);
11805 pragma Inline (Set_Pragma_Identifier);
11806 pragma Inline (Set_Pragmas_After);
11807 pragma Inline (Set_Pragmas_Before);
11808 pragma Inline (Set_Prefix);
11809 pragma Inline (Set_Present_Expr);
11810 pragma Inline (Set_Prev_Ids);
11811 pragma Inline (Set_Print_In_Hex);
11812 pragma Inline (Set_Private_Declarations);
11813 pragma Inline (Set_Private_Present);
11814 pragma Inline (Set_Procedure_To_Call);
11815 pragma Inline (Set_Proper_Body);
11816 pragma Inline (Set_Protected_Definition);
11817 pragma Inline (Set_Protected_Present);
11818 pragma Inline (Set_Raises_Constraint_Error);
11819 pragma Inline (Set_Range_Constraint);
11820 pragma Inline (Set_Range_Expression);
11821 pragma Inline (Set_Real_Range_Specification);
11822 pragma Inline (Set_Realval);
11823 pragma Inline (Set_Reason);
11824 pragma Inline (Set_Record_Extension_Part);
11825 pragma Inline (Set_Redundant_Use);
11826 pragma Inline (Set_Renaming_Exception);
11827 pragma Inline (Set_Result_Definition);
11828 pragma Inline (Set_Return_Object_Declarations);
11829 pragma Inline (Set_Reverse_Present);
11830 pragma Inline (Set_Right_Opnd);
11831 pragma Inline (Set_Rounded_Result);
11832 pragma Inline (Set_SCIL_Controlling_Tag);
11833 pragma Inline (Set_SCIL_Entity);
11834 pragma Inline (Set_SCIL_Tag_Value);
11835 pragma Inline (Set_SCIL_Target_Prim);
11836 pragma Inline (Set_Scope);
11837 pragma Inline (Set_Select_Alternatives);
11838 pragma Inline (Set_Selector_Name);
11839 pragma Inline (Set_Selector_Names);
11840 pragma Inline (Set_Shift_Count_OK);
11841 pragma Inline (Set_Source_Type);
11842 pragma Inline (Set_Specification);
11843 pragma Inline (Set_Statements);
11844 pragma Inline (Set_Static_Processing_OK);
11845 pragma Inline (Set_Storage_Pool);
11846 pragma Inline (Set_Strval);
11847 pragma Inline (Set_Subtype_Indication);
11848 pragma Inline (Set_Subtype_Mark);
11849 pragma Inline (Set_Subtype_Marks);
11850 pragma Inline (Set_Suppress_Loop_Warnings);
11851 pragma Inline (Set_Synchronized_Present);
11852 pragma Inline (Set_Tagged_Present);
11853 pragma Inline (Set_Target_Type);
11854 pragma Inline (Set_Task_Definition);
11855 pragma Inline (Set_Task_Present);
11856 pragma Inline (Set_Then_Actions);
11857 pragma Inline (Set_Then_Statements);
11858 pragma Inline (Set_Triggering_Alternative);
11859 pragma Inline (Set_Triggering_Statement);
11860 pragma Inline (Set_Treat_Fixed_As_Integer);
11861 pragma Inline (Set_TSS_Elist);
11862 pragma Inline (Set_Type_Definition);
11863 pragma Inline (Set_Unit);
11864 pragma Inline (Set_Unknown_Discriminants_Present);
11865 pragma Inline (Set_Unreferenced_In_Spec);
11866 pragma Inline (Set_Variant_Part);
11867 pragma Inline (Set_Variants);
11868 pragma Inline (Set_Visible_Declarations);
11869 pragma Inline (Set_Was_Originally_Stub);
11870 pragma Inline (Set_Withed_Body);
11871 pragma Inline (Set_Zero_Cost_Handling);
11873 N_Simple_Return_Statement : constant Node_Kind := N_Return_Statement;
11874 -- Rename N_Return_Statement to be N_Simple_Return_Statement. Clients
11875 -- should refer to N_Simple_Return_Statement.
11877 end Sinfo;